OpenAPI 3.2; Configurables; dev

README.md

@@ -11,11 +11,11 @@ Note: The canonical location of this README is on [RubyDoc](https://rubydoc.info
 
 ### OpenAPI specification and OpenAPI documents
 
-To start with, you need an OpenAPI document (an OAD) describing a service you will be consuming. OpenAPI Specification v3.1, v3.0, and v2 (formerly known as Swagger) are supported. An OAD can be written by hand or sometimes generated from other existing sources. The creation of an OpenAPI document describing a given service is outside the scope of Scorpio. Here are several resources on OpenAPI:
+To start with, you need an OpenAPI document (an OAD) describing a service you will be consuming. OpenAPI Specification v3.2, v3.1, v3.0, and v2 (formerly known as Swagger) are supported. An OAD can be written by hand or sometimes generated from other existing sources. The creation of an OpenAPI document describing a given service is outside the scope of Scorpio. Here are several resources on OpenAPI:
 
 - [Learn about OpenAPI](https://learn.openapis.org/)
 - [OpenAPI Specification at Wikipedia](https://en.wikipedia.org/wiki/OpenAPI_Specification)
-- OpenAPI Specifications [v3.1](https://spec.openapis.org/oas/v3.1.html), [v3.0](https://spec.openapis.org/oas/v3.0.html), [v2.0](https://spec.openapis.org/oas/v2.0.html)
+- OpenAPI Specifications [v3.2](https://spec.openapis.org/oas/v3.2.html), [v3.1](https://spec.openapis.org/oas/v3.1.html), [v3.0](https://spec.openapis.org/oas/v3.0.html), [v2.0](https://spec.openapis.org/oas/v2.0.html)
 - [OpenAPI Specification development on GitHub](https://github.com/OAI/OpenAPI-Specification)
 
 ### JSON Schema, JSI

Rakefile

@@ -12,6 +12,7 @@ task 'test:each_format' do
     openapi2
     openapi3_0
     openapi3_1
+    openapi3_2
   )
 
   require 'term/ansicolor'

documents/spec.openapis.org/oas/3.2/dialect.yaml

@@ -0,0 +1,22 @@
+# Scorpio::OpenAPI::V3_2::Ext::MetaSchema
+$id: https://spec.openapis.org/oas/3.2/dialect/2025-09-17
+$schema: https://json-schema.org/draft/2020-12/schema
+
+title: OpenAPI 3.2 Schema Object Dialect
+description: A JSON Schema dialect describing schemas found in OpenAPI v3.2.x Descriptions
+
+$dynamicAnchor: meta
+
+$vocabulary:
+  https://json-schema.org/draft/2020-12/vocab/applicator: true
+  https://json-schema.org/draft/2020-12/vocab/content: true
+  https://json-schema.org/draft/2020-12/vocab/core: true
+  https://json-schema.org/draft/2020-12/vocab/format-annotation: true
+  https://json-schema.org/draft/2020-12/vocab/meta-data: true
+  https://json-schema.org/draft/2020-12/vocab/unevaluated: true
+  https://json-schema.org/draft/2020-12/vocab/validation: true
+  https://spec.openapis.org/oas/3.2/vocab/base: false
+
+allOf:
+  - $ref: https://json-schema.org/draft/2020-12/schema
+  - $ref: https://spec.openapis.org/oas/3.2/meta/2025-09-17

documents/spec.openapis.org/oas/3.2/meta.yaml

@@ -0,0 +1,89 @@
+# Scorpio::OpenAPI::V3_2::Ext::VocabSchema
+$id: https://spec.openapis.org/oas/3.2/meta/2025-09-17
+$schema: https://json-schema.org/draft/2020-12/schema
+
+title: OAS Base Vocabulary
+description: A JSON Schema Vocabulary used in the OpenAPI JSON Schema Dialect
+
+$dynamicAnchor: meta
+
+$vocabulary:
+  https://spec.openapis.org/oas/3.2/vocab/base: true
+
+type:
+  - object
+  - boolean
+properties:
+  discriminator:
+    $ref: '#/$defs/discriminator'
+  example:
+    deprecated: true
+  externalDocs:
+    $ref: '#/$defs/external-docs'
+  xml:
+    $ref: '#/$defs/xml'
+
+$defs:
+  discriminator:
+    $ref: '#/$defs/extensible'
+    properties:
+      mapping:
+        additionalProperties:
+          type: string
+        type: object
+      defaultMapping:
+        type: string
+      propertyName:
+        type: string
+    required:
+      - propertyName
+    type: object
+    unevaluatedProperties: false
+
+  extensible:
+    patternProperties:
+      ^x-: true
+  external-docs:
+    $ref: '#/$defs/extensible'
+    properties:
+      description:
+        type: string
+      url:
+        format: uri-reference
+        type: string
+    required:
+      - url
+    type: object
+    unevaluatedProperties: false
+
+  xml:
+    $ref: '#/$defs/extensible'
+    properties:
+      nodeType:
+        type: string
+        enum:
+          - element
+          - attribute
+          - text
+          - cdata
+          - none
+      name:
+        type: string
+      namespace:
+        format: iri
+        type: string
+      prefix:
+        type: string
+      attribute:
+        type: boolean
+        deprecated: true
+      wrapped:
+        type: boolean
+        deprecated: true
+    type: object
+    dependentSchemas:
+      nodeType:
+        properties:
+          attribute: false
+          wrapped: false
+    unevaluatedProperties: false

documents/spec.openapis.org/oas/3.2/schema-base.yaml

@@ -0,0 +1,21 @@
+# Scorpio::OpenAPI::V3_2::Ext::ExtDocument
+$id: 'https://spec.openapis.org/oas/3.2/schema-base/2025-11-23'
+$schema: 'https://json-schema.org/draft/2020-12/schema'
+
+description: The description of OpenAPI v3.2.x Documents using the OpenAPI JSON Schema dialect
+
+$ref: 'https://spec.openapis.org/oas/3.2/schema/2025-11-23'
+properties:
+  jsonSchemaDialect:
+    $ref: '#/$defs/dialect'
+
+$defs:
+  dialect:
+    const: 'https://spec.openapis.org/oas/3.2/dialect/2025-09-17'
+
+  schema:
+    $dynamicAnchor: meta
+    $ref: 'https://spec.openapis.org/oas/3.2/dialect/2025-09-17'
+    properties:
+      $schema:
+        $ref: '#/$defs/dialect'