feat: adds overlay documents to the store (SchemaStore#5234)

* feat: adds overlay documents to the store

Signed-off-by: Vincent Biret <[email protected]>

* [pre-commit.ci] auto fixes from pre-commit.com hooks

for more information, see https://pre-commit.ci

---------

Signed-off-by: Vincent Biret <[email protected]>
Co-authored-by: pre-commit-ci[bot] <66853113+pre-commit-ci[bot]@users.noreply.github.com>

Author: baywet

src/api/json/catalog.json

@@ -4445,6 +4445,19 @@
       "fileMatch": ["openapi.json", "openapi.yml", "openapi.yaml"],
       "url": "https://www.schemastore.org/openapi-3.X.json"
     },
+    {
+      "name": "overlay.json",
+      "description": "An OpenAPI Overlay document",
+      "fileMatch": [
+        "overlay.json",
+        "overlay.yml",
+        "overlay.yaml",
+        "*.overlay.json",
+        "*.overlay.yml",
+        "*.overlay.yaml"
+      ],
+      "url": "https://www.schemastore.org/openapi-overlay-1.X.json"
+    },
     {
       "name": "openrpc.json",
       "description": "An OpenRPC document. Documentation: https://open-rpc.org for more information",

src/schema-validation.jsonc

@@ -392,7 +392,8 @@
     "lazygit.json",
     "circleciconfig.json",
     "ogen.json",
-    "openapi-3.X.json" // uses external references
+    "openapi-3.X.json", // uses external references
+    "openapi-overlay-1.X.json" // uses external references
   ],
   "catalogEntryNoLintNameOrDescription": [
     "https://json-schema.org/draft-04/schema",

src/schemas/json/openapi-overlay-1.X.json

@@ -0,0 +1,28 @@
+{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "$id": "https://www.schemastore.org/openapi-overlay-1.X.json",
+  "title": "OpenAPI Overlay Document v1.X",
+  "type": "object",
+  "required": ["overlay"],
+  "properties": {
+    "overlay": {
+      "pattern": "^1\\.0\\.",
+      "type": "string"
+    }
+  },
+  "allOf": [
+    {
+      "if": {
+        "properties": {
+          "overlay": {
+            "pattern": "^1\\.0\\.",
+            "type": "string"
+          }
+        }
+      },
+      "then": {
+        "$ref": "https://spec.openapis.org/overlay/1.0/schema/2024-10-22"
+      }
+    }
+  ]
+}