Update OpenAPI 3.1 schemas

Author: jdesrosiers

openapi-3-1/dialect/base.js

@@ -1,5 +1,4 @@
 export default {
-  "$id": "https://spec.openapis.org/oas/3.1/dialect/base",
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$vocabulary": {
     "https://json-schema.org/draft/2020-12/vocab/core": true,
@@ -14,6 +13,8 @@ export default {
   "$dynamicAnchor": "meta",
 
   "title": "OpenAPI 3.1 Schema Object Dialect",
+  "description": "A JSON Schema dialect describing schemas found in OpenAPI v3.1 Descriptions",
+
   "allOf": [
     { "$ref": "https://json-schema.org/draft/2020-12/schema" },
     { "$ref": "https://spec.openapis.org/oas/3.1/meta/base" }

openapi-3-1/index.d.ts

@@ -3,7 +3,7 @@ import type { JsonSchemaType } from "../lib/common.js";
 
 
 export type OasSchema31 = boolean | {
-  $schema?: "https://json-schema.org/draft/2020-12/schema";
+  $schema?: "https://spec.openapis.org/oas/3.1/dialect/base";
   $id?: string;
   $anchor?: string;
   $ref?: string;

openapi-3-1/index.js

@@ -32,8 +32,8 @@ defineVocabulary("https://spec.openapis.org/oas/3.1/vocab/base", {
   "xml": "https://spec.openapis.org/oas/3.0/keyword/xml"
 });
 
-registerSchema(vocabularySchema);
-registerSchema(dialectSchema);
+registerSchema(vocabularySchema, "https://spec.openapis.org/oas/3.1/meta/base");
+registerSchema(dialectSchema, "https://spec.openapis.org/oas/3.1/dialect/base");
 
 // Current Schemas
 registerSchema(schema, "https://spec.openapis.org/oas/3.1/schema");

openapi-3-1/meta/base.js

@@ -1,8 +1,9 @@
 export default {
-  "$id": "https://spec.openapis.org/oas/3.1/meta/base",
   "$schema": "https://json-schema.org/draft/2020-12/schema",
   "$dynamicAnchor": "meta",
-  "title": "OAS Base vocabulary",
+
+  "title": "OAS Base Vocabulary",
+  "description": "A JSON Schema Vocabulary used in the OpenAPI Schema Dialect",
 
   "type": ["object", "boolean"],
   "properties": {

openapi-3-1/schema-base.js

@@ -12,7 +12,7 @@ export default {
     "https://spec.openapis.org/oas/3.1/vocab/base": false
   },
 
-  "description": "The description of OpenAPI v3.1.x documents using the OpenAPI JSON Schema dialect, as defined by https://spec.openapis.org/oas/v3.1.0",
+  "description": "The description of OpenAPI v3.1.x Documents using the OpenAPI JSON Schema dialect",
 
   "$ref": "https://spec.openapis.org/oas/3.1/schema",
   "properties": {