schema-components 1.18.1 → 1.20.0

package/dist/{version-B5NV-35j.d.mts → version-D-u7aMfy.d.mts}

@@ -7,6 +7,13 @@
  * before the walker processes the schema.
  */
 type JsonSchemaDraft = "draft-04" | "draft-06" | "draft-07" | "draft-2019-09" | "draft-2020-12";
+/**
+ * Match a `$schema` URI string to a known draft. Returns `undefined`
+ * when the URI matches none of the documented Draft 04 – Draft 2020-12
+ * schema URIs (including the known prefix patterns) — callers can use
+ * this to distinguish an authoritative match from a silent fallback.
+ */
+declare function matchJsonSchemaDraftUri(uri: string): JsonSchemaDraft | undefined;
 /**
  * Detect the JSON Schema draft version from a schema's `$schema` URI.
  * When `$schema` is absent, uses heuristic keyword detection via
@@ -65,5 +72,40 @@ declare function isOpenApi31(version: OpenApiVersionInfo): boolean;
  * Check if a document is Swagger 2.0.
  */
 declare function isSwagger2(version: OpenApiVersionInfo): boolean;
+/**
+ * Result of inspecting a document for the OpenAPI 3.1 `jsonSchemaDialect`
+ * keyword.
+ *
+ * - `kind: "absent"`: the keyword is not declared. The walker assumes
+ *   Draft 2020-12, which is the spec-defined default.
+ * - `kind: "known"`: the declared dialect URI matches one of the
+ *   supported drafts. The corresponding `JsonSchemaDraft` is returned so
+ *   the normaliser can route to the matching per-node transforms.
+ * - `kind: "unknown"`: the keyword is present but its URI does not
+ *   match any supported draft. The caller should emit an
+ *   `unknown-json-schema-dialect` diagnostic and fall back to
+ *   Draft 2020-12.
+ */
+type JsonSchemaDialectInfo = {
+  kind: "absent";
+} | {
+  kind: "known";
+  uri: string;
+  draft: JsonSchemaDraft;
+} | {
+  kind: "unknown";
+  uri: string;
+};
+/**
+ * Inspect an OpenAPI 3.1 document for a `jsonSchemaDialect` declaration.
+ *
+ * Per the OpenAPI 3.1 spec, an OpenAPI document may declare the default
+ * JSON Schema dialect for its Schema Objects via the top-level
+ * `jsonSchemaDialect` URI. Real-world 3.1 documents overwhelmingly omit
+ * the keyword and rely on the spec-defined Draft 2020-12 default — this
+ * helper surfaces the declaration so the normaliser can either honour a
+ * known dialect or emit a diagnostic for an unknown one.
+ */
+declare function readJsonSchemaDialect(doc: Record<string, unknown>): JsonSchemaDialectInfo;
 //#endregion
-export { detectOpenApiVersion as a, isOpenApi30 as c, detectJsonSchemaDraft as i, isOpenApi31 as l, JsonSchemaDraft as n, inferJsonSchemaDraft as o, OpenApiVersionInfo as r, inferJsonSchemaDraftWithReason as s, InferredDraft as t, isSwagger2 as u };
+export { detectJsonSchemaDraft as a, inferJsonSchemaDraftWithReason as c, isSwagger2 as d, matchJsonSchemaDraftUri as f, OpenApiVersionInfo as i, isOpenApi30 as l, JsonSchemaDialectInfo as n, detectOpenApiVersion as o, readJsonSchemaDialect as p, JsonSchemaDraft as r, inferJsonSchemaDraft as s, InferredDraft as t, isOpenApi31 as u };

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "schema-components",
-    "version": "1.18.1",
+    "version": "1.20.0",
     "description": "React components that render UI from Zod schemas, JSON Schema, and OpenAPI documents",
     "type": "module",
     "main": "./dist/index.mjs",