v3.2-dev: update from dev

.gitignore

@@ -8,5 +8,5 @@ node_modules/
 deploy/
 deploy-preview/
 coverage/
-history
+_site/
 Gemfile.lock

README.md

@@ -19,8 +19,6 @@ This GitHub project is the starting point for OpenAPI. Here you will find the in
 
 This repository contains [the Markdown sources](versions) for [all published OpenAPI Specification versions](https://spec.openapis.org/). For release notes and release candidate versions, refer to the [releases page](releases).
 
-Each folder in this repository, such as [schemas](schemas) and [tests](tests), should contain folders pertaining to the current and previous versions of the specification.
-
 ## See It in Action
 
 If you just want to see it work, check out the [list of current examples](https://learn.openapis.org/examples/).

_archive_/README.md

@@ -0,0 +1,3 @@
+# Archive
+
+This folder contains files that are no longer actively maintained.

_archive_/schemas/README.md

@@ -0,0 +1,9 @@
+# Archive of outdated JSON Schema Files
+
+> [!TIP]
+> JSON Schema files for validating OpenAPI descriptions using current OpenAPI versions are available on https://spec.openapis.org/#openapi-specification-schemas.
+>
+> These schema files are maintained in the `src/schemas` folder of the corresponding `vX.Y-dev` branch in this repository.
+
+> [!CAUTION]
+> Schema files in this folder are not maintained any more and are not intended for productive use.

_archive_/schemas/v1.2/README.md

@@ -0,0 +1,5 @@
+# Swagger Specification JSON Schemas
+
+The work on the JSON Schema for the Swagger Specification was donated to the community by [Francis Galiegue](https://github.com/fge)!
+
+Keep in mind that due to some JSON Schema limitations, not all constraints can be described. The missing constraints will be listed here in the future.

_archive_/schemas/v1.2/apiDeclaration.json

@@ -0,0 +1,61 @@
+{
+    "id": "https://github.com/raw/OAI/OpenAPI-Specification/master/schemas/v1.2/apiDeclaration.json#",
+    "$schema": "http://json-schema.org/draft-04/schema#",
+    "type": "object",
+    "required": [ "swaggerVersion", "basePath", "apis" ],
+    "properties": {
+        "swaggerVersion": { "enum": [ "1.2" ] },
+        "apiVersion": { "type": "string" },
+        "basePath": {
+            "type": "string",
+            "format": "uri",
+            "pattern": "^https?://"
+        },
+        "resourcePath": {
+            "type": "string",
+            "format": "uri",
+            "pattern": "^/"
+        },
+        "apis": {
+            "type": "array",
+            "items": { "$ref": "#/definitions/apiObject" }
+        },
+        "models": {
+            "type": "object",
+            "additionalProperties": {
+                "$ref": "modelsObject.json#"
+            }
+        },
+        "produces": { "$ref": "#/definitions/mimeTypeArray" },
+        "consumes": { "$ref": "#/definitions/mimeTypeArray" },
+        "authorizations": { "$ref": "authorizationObject.json#" }
+    },
+    "additionalProperties": false,
+    "definitions": {
+        "apiObject": {
+            "type": "object",
+            "required": [ "path", "operations" ],
+            "properties": {
+                "path": {
+                    "type": "string",
+                    "format": "uri-template",
+                    "pattern": "^/"
+                },
+                "description": { "type": "string" },
+                "operations": {
+                    "type": "array",
+                    "items": { "$ref": "operationObject.json#" }
+                }
+            },
+            "additionalProperties": false
+        },
+        "mimeTypeArray": {
+            "type": "array",
+            "items": {
+                "type": "string",
+                "format": "mime-type"
+            },
+            "uniqueItems": true
+        }
+    }
+}

_archive_/schemas/v1.2/authorizationObject.json

@@ -0,0 +1,59 @@
+{
+    "id": "https://github.com/raw/OAI/OpenAPI-Specification/master/schemas/v1.2/authorizationObject.json#",
+    "$schema": "http://json-schema.org/draft-04/schema#",
+    "type": "object",
+    "additionalProperties": {
+        "oneOf": [
+            {
+                "$ref": "#/definitions/basicAuth"
+            },
+            {
+                "$ref": "#/definitions/apiKey"
+            },
+            {
+                "$ref": "#/definitions/oauth2"
+            }
+        ]
+    },
+    "definitions": {
+        "basicAuth": {
+            "required": [ "type" ],
+            "properties": {
+                "type": { "enum": [ "basicAuth" ] }
+            },
+            "additionalProperties": false
+        },
+        "apiKey": {
+            "required": [ "type", "passAs", "keyname" ],
+            "properties": {
+                "type": { "enum": [ "apiKey" ] },
+                "passAs": { "enum": [ "header", "query" ] },
+                "keyname": { "type": "string" }
+            },
+            "additionalProperties": false
+        },
+        "oauth2": {
+            "type": "object",
+            "required": [ "type", "grantTypes" ],
+            "properties": {
+                "type": { "enum": [ "oauth2" ] },
+                "scopes": {
+                    "type": "array",
+                    "items": { "$ref": "#/definitions/oauth2Scope" }
+                },
+                "grantTypes": { "$ref": "oauth2GrantType.json#" }
+            },
+            "additionalProperties": false
+        },
+        "oauth2Scope": {
+            "type": "object",
+            "required": [ "scope" ],
+            "properties": {
+                "scope": { "type": "string" },
+                "description": { "type": "string" }
+            },
+            "additionalProperties": false
+        }
+    }
+}
+

_archive_/schemas/v1.2/dataType.json

@@ -0,0 +1,132 @@
+{
+    "id": "https://github.com/raw/OAI/OpenAPI-Specification/master/schemas/v1.2/dataType.json#",
+    "$schema": "http://json-schema.org/draft-04/schema#",
+    "description": "Data type as described by the specification (version 1.2)",
+    "type": "object",
+    "oneOf": [
+        { "$ref": "#/definitions/refType" },
+        { "$ref": "#/definitions/voidType" },
+        { "$ref": "#/definitions/primitiveType" },
+        { "$ref": "#/definitions/modelType" },
+        { "$ref": "#/definitions/arrayType" }
+    ],
+    "definitions": {
+        "refType": {
+            "required": [ "$ref" ],
+            "properties": {
+                "$ref": { "type": "string" }
+            },
+            "additionalProperties": false
+        },
+        "voidType": {
+            "enum": [ { "type": "void" } ]
+        },
+        "modelType": {
+            "required": [ "type" ],
+            "properties": {
+                "type": {
+                    "type": "string",
+                    "not": {
+                        "enum": [ "boolean", "integer", "number", "string", "array" ]
+                    }
+                }
+            },
+            "additionalProperties": false
+        },
+        "primitiveType": {
+            "required": [ "type" ],
+            "properties": {
+                "type": {
+                    "enum": [ "boolean", "integer", "number", "string" ]
+                },
+                "format": { "type": "string" },
+                "defaultValue": {
+                    "not": { "type": [ "array", "object", "null" ] }
+                },
+                "enum": {
+                    "type": "array",
+                    "items": { "type": "string" },
+                    "minItems": 1,
+                    "uniqueItems": true
+                },
+                "minimum": { "type": "string" },
+                "maximum": { "type": "string" }
+            },
+            "additionalProperties": false,
+            "dependencies": {
+                "format": {
+                    "oneOf": [
+                        {
+                            "properties": {
+                                "type": { "enum": [ "integer" ] },
+                                "format": { "enum": [ "int32", "int64" ] }
+                            }
+                        },
+                        {
+                            "properties": {
+                                "type": { "enum": [ "number" ] },
+                                "format": { "enum": [ "float", "double" ] }
+                            }
+                        },
+                        {
+                            "properties": {
+                                "type": { "enum": [ "string" ] },
+                                "format": {
+                                    "enum": [ "byte", "date", "date-time" ]
+                                }
+                            }
+                        }
+                    ]
+                },
+                "enum": {
+                    "properties": {
+                        "type": { "enum": [ "string" ] }
+                    }
+                },
+                "minimum": {
+                    "properties": {
+                        "type": { "enum": [ "integer", "number" ] }
+                    }
+                },
+                "maximum": {
+                    "properties": {
+                        "type": { "enum": [ "integer", "number" ] }
+                    }
+                }
+            }
+        },
+        "arrayType": {
+            "required": [ "type", "items" ],
+            "properties": {
+                "type": { "enum": [ "array" ] },
+                "items": {
+                    "type": "array",
+                    "items": { "$ref": "#/definitions/itemsObject" }
+                },
+                "uniqueItems": { "type": "boolean" }
+            },
+            "additionalProperties": false
+        },
+        "itemsObject": {
+            "oneOf": [
+                {
+                    "$ref": "#/definitions/refType"
+                },
+                {
+                    "allOf": [
+                        {
+                            "$ref": "#/definitions/primitiveType"
+                        },
+                        {
+                            "properties": {
+                                "type": {},
+                                "format": {}
+                            },
+                            "additionalProperties": false
+                        }
+                    ]
+                }
+            ]
+        }
+    }
+}

_archive_/schemas/v1.2/dataTypeBase.json

@@ -0,0 +1,81 @@
+{
+    "id": "https://github.com/raw/OAI/OpenAPI-Specification/master/schemas/v1.2/dataTypeBase.json#",
+    "$schema": "http://json-schema.org/draft-04/schema#",
+    "description": "Data type fields (section 4.3.3)",
+    "type": "object",
+    "oneOf": [
+        { "required": [ "type" ] },
+        { "required": [ "$ref" ] }
+    ],
+    "properties": {
+        "type": { "type": "string" },
+        "$ref": { "type": "string" },
+        "format": { "type": "string" },
+        "defaultValue": {
+            "not": { "type": [ "array", "object", "null" ] }
+        },
+        "enum": {
+            "type": "array",
+            "items": { "type": "string" },
+            "uniqueItems": true,
+            "minItems": 1
+        },
+        "minimum": { "type": "string" },
+        "maximum": { "type": "string" },
+        "items": { "$ref": "#/definitions/itemsObject" },
+        "uniqueItems": { "type": "boolean" }
+    },
+    "dependencies": {
+        "format": {
+            "oneOf": [
+                {
+                    "properties": {
+                        "type": { "enum": [ "integer" ] },
+                        "format": { "enum": [ "int32", "int64" ] }
+                    }
+                },
+                {
+                    "properties": {
+                        "type": { "enum": [ "number" ] },
+                        "format": { "enum": [ "float", "double" ] }
+                    }
+                },
+                {
+                    "properties": {
+                        "type": { "enum": [ "string" ] },
+                        "format": {
+                            "enum": [ "byte", "date", "date-time" ]
+                        }
+                    }
+                }
+            ]
+        }
+    },
+    "definitions": {
+        "itemsObject": {
+            "oneOf": [
+                {
+                    "type": "object",
+                    "required": [ "$ref" ],
+                    "properties": {
+                        "$ref": { "type": "string" }
+                    },
+                    "additionalProperties": false
+                },
+                {
+                    "allOf": [
+                        { "$ref": "#" },
+                        {
+                            "required": [ "type" ],
+                            "properties": {
+                                "type": {},
+                                "format": {}
+                            },
+                            "additionalProperties": false
+                        }
+                    ]
+                }
+            ]
+        }
+    }
+}

_archive_/schemas/v1.2/infoObject.json

@@ -0,0 +1,16 @@
+{
+    "id": "https://github.com/raw/OAI/OpenAPI-Specification/master/schemas/v1.2/infoObject.json#",
+    "$schema": "http://json-schema.org/draft-04/schema#",
+    "description": "info object (section 5.1.3)",
+    "type": "object",
+    "required": [ "title", "description" ],
+    "properties": {
+        "title": { "type": "string" },
+        "description": { "type": "string" },
+        "termsOfServiceUrl": { "type": "string", "format": "uri" },
+        "contact": { "type": "string", "format": "email" },
+        "license": { "type": "string" },
+        "licenseUrl": { "type": "string", "format": "uri" }
+    },
+    "additionalProperties": false
+}