fix: update JSON schema for Tombi with improved structure and deprecations (SchemaStore#4747)

Co-authored-by: ya7010 <[email protected]>

Author: ya7010

src/schemas/json/tombi.json

@@ -414,11 +414,40 @@
       "x-tombi-table-keys-order": "schema"
     },
     "SchemaCatalog": {
+      "anyOf": [
+        {
+          "$ref": "#/definitions/NewSchemaCatalog"
+        },
+        {
+          "$ref": "#/definitions/SchemaCatalogOld"
+        }
+      ]
+    },
+    "NewSchemaCatalog": {
+      "type": "object",
+      "properties": {
+        "paths": {
+          "title": "The schema catalog path/url array.",
+          "description": "The catalog is evaluated after the schemas specified by [[schemas]].",
+          "type": ["array", "null"],
+          "items": {
+            "$ref": "#/definitions/SchemaCatalogPath"
+          },
+          "default": ["https://www.schemastore.org/api/json/catalog.json"]
+        }
+      },
+      "additionalProperties": false
+    },
+    "SchemaCatalogPath": {
+      "description": "Generic value that can be either single or multiple",
+      "type": "string"
+    },
+    "SchemaCatalogOld": {
       "type": "object",
       "properties": {
         "path": {
           "title": "The schema catalog path or url.",
-          "description": "The catalog is evaluated after the schemas specified by [[schemas]].\n\n You can specify multiple catalogs by making it an array.\n If you specify an array, the catalogs are searched in order of priority starting from the first catalog.\n If you want to disable the default catalog, specify an empty array.",
+          "description": "**🚧 Deprecated 🚧**\\\n Please use `schema.catalog.paths` instead.",
           "anyOf": [
             {
               "$ref": "#/definitions/OneOrMany_for_SchemaCatalogPath"
@@ -427,6 +456,7 @@
               "type": "null"
             }
           ],
+          "deprecated": true,
           "default": "https://www.schemastore.org/api/json/catalog.json"
         }
       },
@@ -445,10 +475,6 @@
         }
       ]
     },
-    "SchemaCatalogPath": {
-      "description": "Generic value that can be either single or multiple",
-      "type": "string"
-    },
     "Schema": {
       "anyOf": [
         {
@@ -543,7 +569,7 @@
         },
         "root-keys": {
           "title": "The keys to apply the sub schema.",
-          "description": "Please use `root` instead.",
+          "description": "**🚧 Deprecated 🚧**\\\n Please use `schemas[*].root` instead.",
           "type": ["string", "null"],
           "deprecated": true,
           "minLength": 1