schema-components 1.13.0 → 1.15.0

package/dist/core/swagger2.mjs

@@ -1,294 +1,2 @@
-import { isObject } from "./guards.mjs";
-import { normaliseOpenApi30Combined } from "./openapi30.mjs";
-//#region src/core/swagger2.ts
-/**
-* Swagger 2.0 → OpenAPI 3.1 document normalisation.
-*
-* Transforms a Swagger 2.0 document into an OpenAPI 3.1-compatible
-* structure: host/basePath/schemes → servers, definitions → components,
-* body/formData params → requestBody, response schemas → content.
-*
-* Individual schemas within the document are also normalised for
-* Draft 04 semantics (exclusiveMinimum/exclusiveMaximum booleans).
-*/
-/**
-* Transform a Swagger 2.0 document into an OpenAPI 3.1-compatible
-* structure.
-*/
-function normaliseSwagger2Document(doc, deepNormalise, normaliseDraft04Node) {
-	const result = {
-		openapi: "3.1.0",
-		info: isObject(doc.info) ? { ...doc.info } : {
-			title: "API",
-			version: "0.0.0"
-		}
-	};
-	if (typeof doc.host === "string" || typeof doc.basePath === "string" || Array.isArray(doc.schemes)) {
-		const host = typeof doc.host === "string" ? doc.host : "localhost";
-		const basePath = typeof doc.basePath === "string" ? doc.basePath : "/";
-		const schemes = Array.isArray(doc.schemes) ? doc.schemes : ["https"];
-		result.servers = [{ url: `${typeof schemes[0] === "string" ? schemes[0] : "https"}://${host}${basePath}` }];
-	}
-	const paths = doc.paths;
-	if (isObject(paths)) result.paths = normaliseSwaggerPaths(paths, doc);
-	const components = {};
-	const definitions = doc.definitions;
-	if (isObject(definitions)) {
-		const schemas = {};
-		for (const [name, schema] of Object.entries(definitions)) schemas[name] = isObject(schema) ? deepNormalise(schema, (node) => normaliseOpenApi30Combined(normaliseDraft04Node(node))) : schema;
-		components.schemas = schemas;
-	}
-	const parameters = doc.parameters;
-	if (isObject(parameters)) components.parameters = { ...parameters };
-	const responses = doc.responses;
-	if (isObject(responses)) components.responses = { ...responses };
-	const securityDefinitions = doc.securityDefinitions;
-	if (isObject(securityDefinitions)) components.securitySchemes = { ...securityDefinitions };
-	if (Object.keys(components).length > 0) result.components = components;
-	if (Array.isArray(doc.tags)) result.tags = doc.tags;
-	if (isObject(doc.externalDocs)) result.externalDocs = doc.externalDocs;
-	rewriteSwaggerRefs(result);
-	return result;
-}
-function normaliseSwaggerPaths(paths, doc) {
-	const result = {};
-	const METHODS = [
-		"get",
-		"post",
-		"put",
-		"patch",
-		"delete",
-		"head",
-		"options"
-	];
-	for (const [path, pathItem] of Object.entries(paths)) {
-		if (!isObject(pathItem)) {
-			result[path] = pathItem;
-			continue;
-		}
-		const normalisedPath = {};
-		for (const method of METHODS) {
-			const operation = pathItem[method];
-			if (!isObject(operation)) continue;
-			normalisedPath[method] = normaliseSwaggerOperation(operation, doc);
-		}
-		const pathParams = pathItem.parameters;
-		if (Array.isArray(pathParams)) normalisedPath.parameters = pathParams.map((p) => isObject(p) ? normaliseSwaggerParameter(p, doc) : p);
-		result[path] = normalisedPath;
-	}
-	return result;
-}
-function normaliseSwaggerOperation(operation, doc) {
-	const result = {};
-	const globalProduces = Array.isArray(doc.produces) ? doc.produces : ["application/json"];
-	const globalConsumes = Array.isArray(doc.consumes) ? doc.consumes : ["application/json"];
-	const produces = Array.isArray(operation.produces) ? operation.produces : globalProduces;
-	const consumes = Array.isArray(operation.consumes) ? operation.consumes : globalConsumes;
-	for (const [key, value] of Object.entries(operation)) if (key !== "parameters" && key !== "responses" && key !== "produces" && key !== "consumes") result[key] = value;
-	const params = operation.parameters;
-	if (Array.isArray(params)) {
-		const nonBodyParams = [];
-		let bodyParam;
-		let usesFormData = false;
-		for (const param of params) {
-			if (!isObject(param)) {
-				nonBodyParams.push(param);
-				continue;
-			}
-			const resolvedParam = resolveSwaggerParameter(param, doc);
-			const location = resolvedParam.in;
-			if (location === "body") bodyParam = resolvedParam;
-			else if (location === "formData") {
-				bodyParam = buildFormDataBody(resolvedParam, params);
-				usesFormData = true;
-			} else nonBodyParams.push(normaliseSwaggerParameter(resolvedParam, doc));
-		}
-		if (nonBodyParams.length > 0) result.parameters = nonBodyParams;
-		if (bodyParam !== void 0) result.requestBody = buildRequestBody(bodyParam, usesFormData ? ["multipart/form-data"] : consumes);
-	}
-	const responses = operation.responses;
-	if (isObject(responses)) result.responses = normaliseSwaggerResponses(responses, doc, produces);
-	return result;
-}
-/**
-* Resolve a Swagger parameter that may be a `$ref`.
-*/
-function resolveSwaggerParameter(param, doc, visited = /* @__PURE__ */ new Set()) {
-	const ref = param.$ref;
-	if (typeof ref !== "string" || !ref.startsWith("#/parameters/")) return param;
-	if (visited.has(ref)) return param;
-	const nextVisited = new Set(visited);
-	nextVisited.add(ref);
-	const name = ref.slice(13);
-	const globalParams = doc.parameters;
-	if (isObject(globalParams)) {
-		const resolved = globalParams[name];
-		if (isObject(resolved)) {
-			if (typeof resolved.$ref === "string") return resolveSwaggerParameter(resolved, doc, nextVisited);
-			return resolved;
-		}
-	}
-	return param;
-}
-/**
-* Normalise a single Swagger parameter to OpenAPI 3.x form.
-*/
-function normaliseSwaggerParameter(param, doc) {
-	if (typeof param.$ref === "string") {
-		const resolved = resolveSwaggerParameter(param, doc);
-		if (resolved !== param) return normaliseSwaggerParameter(resolved, doc);
-	}
-	const result = {};
-	for (const [key, value] of Object.entries(param)) {
-		if (key === "type" || key === "format" || key === "collectionFormat") continue;
-		result[key] = value;
-	}
-	if (typeof param.type === "string") {
-		const schema = { type: param.type };
-		if (typeof param.format === "string") schema.format = param.format;
-		if (param.enum !== void 0) schema.enum = param.enum;
-		if (param.default !== void 0) schema.default = param.default;
-		if (param.minimum !== void 0) schema.minimum = param.minimum;
-		if (param.maximum !== void 0) schema.maximum = param.maximum;
-		result.schema = schema;
-	}
-	const cf = param.collectionFormat;
-	if (typeof cf === "string") switch (cf) {
-		case "csv":
-			result.style = "form";
-			result.explode = false;
-			break;
-		case "ssv":
-			result.style = "spaceDelimited";
-			result.explode = false;
-			break;
-		case "tsv":
-			result.style = "tabDelimited";
-			result.explode = false;
-			break;
-		case "pipes":
-			result.style = "pipeDelimited";
-			result.explode = false;
-			break;
-		case "multi":
-			result.style = "form";
-			result.explode = true;
-			break;
-	}
-	return result;
-}
-/**
-* Build a request body from a `formData` parameter.
-*/
-function buildFormDataBody(param, allParams) {
-	const properties = {};
-	const required = [];
-	for (const p of allParams) {
-		if (!isObject(p) || p.in !== "formData") continue;
-		const name = p.name;
-		if (typeof name !== "string") continue;
-		const schema = {};
-		if (p.type === "file") {
-			schema.type = "string";
-			schema.format = "binary";
-		} else {
-			if (typeof p.type === "string") schema.type = p.type;
-			if (typeof p.format === "string") schema.format = p.format;
-			if (p.enum !== void 0) schema.enum = p.enum;
-		}
-		properties[name] = schema;
-		if (p.required === true) required.push(name);
-	}
-	return {
-		name: param.name,
-		in: "body",
-		schema: {
-			type: "object",
-			properties,
-			...required.length > 0 ? { required } : {}
-		}
-	};
-}
-/**
-* Build an OpenAPI 3.x request body from a Swagger 2.0 body parameter.
-*/
-function buildRequestBody(bodyParam, consumes) {
-	const schema = bodyParam.schema;
-	const content = {};
-	const contentTypes = consumes.length > 0 ? consumes : ["application/json"];
-	for (const ct of contentTypes) if (typeof ct === "string") content[ct] = isObject(schema) ? { schema } : {};
-	const result = { content };
-	if (bodyParam.required === true) result.required = true;
-	if (typeof bodyParam.description === "string") result.description = bodyParam.description;
-	return result;
-}
-/**
-* Resolve a Swagger 2.0 response `$ref` (e.g. `#/responses/NotFound`).
-*/
-function resolveSwaggerResponse(response, doc, visited = /* @__PURE__ */ new Set()) {
-	const ref = response.$ref;
-	if (typeof ref !== "string" || !ref.startsWith("#/responses/")) return response;
-	if (visited.has(ref)) return response;
-	const nextVisited = new Set(visited);
-	nextVisited.add(ref);
-	const name = ref.slice(12);
-	const globalResponses = doc.responses;
-	if (isObject(globalResponses)) {
-		const resolved = globalResponses[name];
-		if (isObject(resolved)) {
-			if (typeof resolved.$ref === "string") return resolveSwaggerResponse(resolved, doc, nextVisited);
-			return resolved;
-		}
-	}
-	return response;
-}
-function normaliseSwaggerResponses(responses, doc, produces) {
-	const result = {};
-	for (const [code, response] of Object.entries(responses)) {
-		if (!isObject(response)) {
-			result[code] = response;
-			continue;
-		}
-		const resolved = resolveSwaggerResponse(response, doc);
-		const normalised = {};
-		for (const [key, value] of Object.entries(resolved)) if (key !== "schema") normalised[key] = value;
-		const schema = resolved.schema;
-		if (isObject(schema)) {
-			const content = {};
-			const contentTypes = produces.length > 0 ? produces : ["application/json"];
-			for (const ct of contentTypes) if (typeof ct === "string") content[ct] = { schema };
-			normalised.content = content;
-		}
-		result[code] = normalised;
-	}
-	return result;
-}
-/**
-* Mapping of Swagger 2.0 $ref prefixes to OpenAPI 3.x equivalents.
-* Applied after document restructuring so all $ref strings point
-* to the correct locations in the normalised document.
-*/
-const REF_REWRITES = [
-	["#/definitions/", "#/components/schemas/"],
-	["#/parameters/", "#/components/parameters/"],
-	["#/responses/", "#/components/responses/"]
-];
-/**
-* Deep-rewrite $ref strings in a normalised Swagger 2.0 document
-* from Swagger 2.0 locations to OpenAPI 3.x locations.
-* Mutates the object in place \u2014 called only on the fresh clone
-* produced by normaliseSwagger2Document.
-*/
-function rewriteSwaggerRefs(node) {
-	if (!isObject(node)) return;
-	if (typeof node.$ref === "string") {
-		for (const [from, to] of REF_REWRITES) if (node.$ref.startsWith(from)) {
-			node.$ref = to + node.$ref.slice(from.length);
-			break;
-		}
-	}
-	for (const value of Object.values(node)) if (isObject(value)) rewriteSwaggerRefs(value);
-	else if (Array.isArray(value)) for (const item of value) rewriteSwaggerRefs(item);
-}
-//#endregion
+import { a as normaliseSwagger2Document } from "../normalise-tL9FckAk.mjs";
 export { normaliseSwagger2Document };

package/dist/core/typeInference.d.mts

@@ -1,2 +1,2 @@
-import { a as OpenAPIRequestBodyType, c as ResolveOpenAPIRef, i as InferResponseFields, l as TypeAtPath, n as InferParameterOverrides, o as OpenAPIResponseType, r as InferRequestBodyFields, s as PathOfType, t as FromJSONSchema } from "../typeInference-CRPqVwKu.mjs";
-export { FromJSONSchema, InferParameterOverrides, InferRequestBodyFields, InferResponseFields, OpenAPIRequestBodyType, OpenAPIResponseType, PathOfType, ResolveOpenAPIRef, TypeAtPath };
+import { a as OpenAPIRequestBodyType, c as ResolveOpenAPIRef, d as __SchemaInferenceFellBack, i as InferResponseFields, l as TypeAtPath, n as InferParameterOverrides, o as OpenAPIResponseType, r as InferRequestBodyFields, s as PathOfType, t as FromJSONSchema, u as UnsafeFields } from "../typeInference-k7FXfTVO.mjs";
+export { FromJSONSchema, InferParameterOverrides, InferRequestBodyFields, InferResponseFields, OpenAPIRequestBodyType, OpenAPIResponseType, PathOfType, ResolveOpenAPIRef, TypeAtPath, UnsafeFields, __SchemaInferenceFellBack };

package/dist/core/types.d.mts

@@ -1,2 +1,2 @@
-import { A as UnknownField, B as isNullField, C as RecursiveField, D as StringField, E as StringConstraints, F as isDiscriminatedUnionField, G as isStringField, H as isObjectField, I as isEnumField, J as isUnknownField, K as isTupleField, L as isFileField, M as isArrayField, N as isBooleanField, O as TupleField, P as isConditionalField, R as isLiteralField, S as RecordField, T as SchemaType, U as isRecordField, V as isNumberField, W as isRecursiveField, Y as resolveEditability, _ as NullField, a as DiscriminatedUnionField, b as ObjectConstraints, c as FieldBase, d as FieldOverrides, f as FileConstraints, g as NegationField, h as LiteralField, i as ConditionalField, j as WalkedField, k as UnionField, l as FieldConstraints, m as JsonObject, n as ArrayField, o as Editability, p as FileField, q as isUnionField, r as BooleanField, s as EnumField, t as ArrayConstraints, u as FieldOverride, v as NumberConstraints, w as SchemaMeta, x as ObjectField, y as NumberField, z as isNegationField } from "../types-ag2jYLqQ.mjs";
-export { ArrayConstraints, ArrayField, BooleanField, ConditionalField, DiscriminatedUnionField, Editability, EnumField, FieldBase, FieldConstraints, FieldOverride, FieldOverrides, FileConstraints, FileField, JsonObject, LiteralField, NegationField, NullField, NumberConstraints, NumberField, ObjectConstraints, ObjectField, RecordField, RecursiveField, SchemaMeta, SchemaType, StringConstraints, StringField, TupleField, UnionField, UnknownField, WalkedField, isArrayField, isBooleanField, isConditionalField, isDiscriminatedUnionField, isEnumField, isFileField, isLiteralField, isNegationField, isNullField, isNumberField, isObjectField, isRecordField, isRecursiveField, isStringField, isTupleField, isUnionField, isUnknownField, resolveEditability };
+import { A as UnionField, B as isNegationField, C as RecordField, D as StringConstraints, E as SchemaType, F as isConditionalField, G as isRecordField, H as isNullField, I as isDiscriminatedUnionField, J as isTupleField, K as isRecursiveField, L as isEnumField, M as WalkedField, N as isArrayField, O as StringField, P as isBooleanField, R as isFileField, S as ObjectField, T as SchemaMeta, U as isNumberField, V as isNeverField, W as isObjectField, X as isUnknownField, Y as isUnionField, Z as resolveEditability, _ as NeverField, a as DiscriminatedUnionField, b as NumberField, c as FieldBase, d as FieldOverrides, f as FileConstraints, g as NegationField, h as LiteralField, i as ConditionalField, j as UnknownField, k as TupleField, l as FieldConstraints, m as JsonObject, n as ArrayField, o as Editability, p as FileField, q as isStringField, r as BooleanField, s as EnumField, t as ArrayConstraints, u as FieldOverride, v as NullField, w as RecursiveField, x as ObjectConstraints, y as NumberConstraints, z as isLiteralField } from "../types-D_5ST7SS.mjs";
+export { ArrayConstraints, ArrayField, BooleanField, ConditionalField, DiscriminatedUnionField, Editability, EnumField, FieldBase, FieldConstraints, FieldOverride, FieldOverrides, FileConstraints, FileField, JsonObject, LiteralField, NegationField, NeverField, NullField, NumberConstraints, NumberField, ObjectConstraints, ObjectField, RecordField, RecursiveField, SchemaMeta, SchemaType, StringConstraints, StringField, TupleField, UnionField, UnknownField, WalkedField, isArrayField, isBooleanField, isConditionalField, isDiscriminatedUnionField, isEnumField, isFileField, isLiteralField, isNegationField, isNeverField, isNullField, isNumberField, isObjectField, isRecordField, isRecursiveField, isStringField, isTupleField, isUnionField, isUnknownField, resolveEditability };

package/dist/core/types.mjs

@@ -86,8 +86,11 @@ function isFileField(field) {
 function isRecursiveField(field) {
 	return isField(field, "recursive");
 }
+function isNeverField(field) {
+	return isField(field, "never");
+}
 function isUnknownField(field) {
 	return isField(field, "unknown");
 }
 //#endregion
-export { isArrayField, isBooleanField, isConditionalField, isDiscriminatedUnionField, isEnumField, isFileField, isLiteralField, isNegationField, isNullField, isNumberField, isObjectField, isRecordField, isRecursiveField, isStringField, isTupleField, isUnionField, isUnknownField, resolveEditability };
+export { isArrayField, isBooleanField, isConditionalField, isDiscriminatedUnionField, isEnumField, isFileField, isLiteralField, isNegationField, isNeverField, isNullField, isNumberField, isObjectField, isRecordField, isRecursiveField, isStringField, isTupleField, isUnionField, isUnknownField, resolveEditability };

package/dist/core/version.d.mts

@@ -1,2 +1,2 @@
-import { a as isOpenApi30, i as detectOpenApiVersion, n as OpenApiVersionInfo, o as isOpenApi31, r as detectJsonSchemaDraft, s as isSwagger2, t as JsonSchemaDraft } from "../version-CLchheaH.mjs";
-export { JsonSchemaDraft, OpenApiVersionInfo, detectJsonSchemaDraft, detectOpenApiVersion, isOpenApi30, isOpenApi31, isSwagger2 };
+import { a as detectOpenApiVersion, c as isOpenApi30, i as detectJsonSchemaDraft, l as isOpenApi31, n as JsonSchemaDraft, o as inferJsonSchemaDraft, r as OpenApiVersionInfo, s as inferJsonSchemaDraftWithReason, t as InferredDraft, u as isSwagger2 } from "../version-B5NV-35j.mjs";
+export { InferredDraft, JsonSchemaDraft, OpenApiVersionInfo, detectJsonSchemaDraft, detectOpenApiVersion, inferJsonSchemaDraft, inferJsonSchemaDraftWithReason, isOpenApi30, isOpenApi31, isSwagger2 };

package/dist/core/version.mjs

@@ -16,23 +16,95 @@ const DRAFT_URIS = new Map([
 ]);
 /**
 * Detect the JSON Schema draft version from a schema's `$schema` URI.
-* Returns `"draft-2020-12"` as the default when `$schema` is absent —
-* this is the most compatible assumption for modern schemas.
+* When `$schema` is absent, uses heuristic keyword detection via
+* `inferJsonSchemaDraft` to guess the draft version.
+* Returns `"draft-2020-12"` as the final fallback when no heuristic
+* matches either.
 */
 function detectJsonSchemaDraft(schema) {
 	const $schema = schema.$schema;
-	if (typeof $schema !== "string") return "draft-2020-12";
-	const exact = DRAFT_URIS.get($schema);
-	if (exact !== void 0) return exact;
-	for (const [uri, draft] of DRAFT_URIS) if ($schema.startsWith(uri) || $schema === uri) return draft;
-	if ($schema.includes("/draft/2020-12/")) return "draft-2020-12";
-	if ($schema.includes("/draft/2019-09/")) return "draft-2019-09";
-	if ($schema.includes("/draft-07")) return "draft-07";
-	if ($schema.includes("/draft-06")) return "draft-06";
-	if ($schema.includes("/draft-04")) return "draft-04";
+	if (typeof $schema === "string") {
+		const exact = DRAFT_URIS.get($schema);
+		if (exact !== void 0) return exact;
+		for (const [uri, draft] of DRAFT_URIS) if ($schema.startsWith(uri) || $schema === uri) return draft;
+		if ($schema.includes("/draft/2020-12/")) return "draft-2020-12";
+		if ($schema.includes("/draft/2019-09/")) return "draft-2019-09";
+		if ($schema.includes("/draft-07")) return "draft-07";
+		if ($schema.includes("/draft-06")) return "draft-06";
+		if ($schema.includes("/draft-04")) return "draft-04";
+		return "draft-2020-12";
+	}
+	return inferJsonSchemaDraft(schema);
+}
+/**
+* Infer the JSON Schema draft from keyword presence when `$schema`
+* is absent. Examined from highest-confidence to lowest.
+*
+* Heuristics:
+* 1. `$dynamicRef` / `$dynamicAnchor` / `prefixItems` → Draft 2020-12
+* 2. `$recursiveRef` / `$recursiveAnchor` / `unevaluatedProperties` /
+*    `dependentSchemas` → Draft 2019-09
+* 3. `if` / `then` / `else`, `contentEncoding` / `contentMediaType` → Draft 07
+* 4. `const`, `examples` (array), `propertyNames` → Draft 06
+* 5. Boolean `exclusiveMinimum`, `id` (no `$`), `definitions` only → Draft 04
+* 6. No signal → Draft 2020-12
+*/
+function inferJsonSchemaDraft(schema) {
+	if ("$dynamicRef" in schema || "$dynamicAnchor" in schema || "prefixItems" in schema) return "draft-2020-12";
+	if ("$recursiveRef" in schema || "$recursiveAnchor" in schema || "unevaluatedProperties" in schema || "unevaluatedItems" in schema) return "draft-2019-09";
+	if ("if" in schema || "then" in schema || "else" in schema) return "draft-07";
+	if ("contentEncoding" in schema || "contentMediaType" in schema) return "draft-07";
+	if ("const" in schema || "propertyNames" in schema) return "draft-06";
+	const examples = schema.examples;
+	if (Array.isArray(examples)) return "draft-06";
+	if (typeof schema.exclusiveMinimum === "boolean" || typeof schema.exclusiveMaximum === "boolean") return "draft-04";
+	if ("id" in schema && !("$id" in schema)) return "draft-04";
 	return "draft-2020-12";
 }
 /**
+* Like `inferJsonSchemaDraft` but also returns the heuristic that
+* triggered the inference, for diagnostic emission.
+*/
+function inferJsonSchemaDraftWithReason(schema) {
+	if ("$dynamicRef" in schema || "$dynamicAnchor" in schema || "prefixItems" in schema) return {
+		draft: "draft-2020-12",
+		inferredFrom: "dynamic-ref-or-anchor-or-prefixItems"
+	};
+	if ("$recursiveRef" in schema || "$recursiveAnchor" in schema || "unevaluatedProperties" in schema || "unevaluatedItems" in schema) return {
+		draft: "draft-2019-09",
+		inferredFrom: "recursive-ref-or-anchor-or-unevaluated"
+	};
+	if ("if" in schema || "then" in schema || "else" in schema) return {
+		draft: "draft-07",
+		inferredFrom: "if-then-else"
+	};
+	if ("contentEncoding" in schema || "contentMediaType" in schema) return {
+		draft: "draft-07",
+		inferredFrom: "content-encoding-or-media-type"
+	};
+	if ("const" in schema || "propertyNames" in schema) return {
+		draft: "draft-06",
+		inferredFrom: "const-or-propertyNames"
+	};
+	const examples = schema.examples;
+	if (Array.isArray(examples)) return {
+		draft: "draft-06",
+		inferredFrom: "examples"
+	};
+	if (typeof schema.exclusiveMinimum === "boolean" || typeof schema.exclusiveMaximum === "boolean") return {
+		draft: "draft-04",
+		inferredFrom: "boolean-exclusive-min-max"
+	};
+	if ("id" in schema && !("$id" in schema)) return {
+		draft: "draft-04",
+		inferredFrom: "id-without-dollar"
+	};
+	return {
+		draft: "draft-2020-12",
+		inferredFrom: "no-signal"
+	};
+}
+/**
 * Detect the OpenAPI/Swagger version from a document.
 * Returns `undefined` for documents that are not OpenAPI or Swagger.
 */
@@ -76,4 +148,4 @@ function isSwagger2(version) {
 	return version.major === 2;
 }
 //#endregion
-export { detectJsonSchemaDraft, detectOpenApiVersion, isOpenApi30, isOpenApi31, isSwagger2 };
+export { detectJsonSchemaDraft, detectOpenApiVersion, inferJsonSchemaDraft, inferJsonSchemaDraftWithReason, isOpenApi30, isOpenApi31, isSwagger2 };

package/dist/core/walkBuilders.d.mts

@@ -1,4 +1,6 @@
-import { A as UnknownField, D as StringField, _ as NullField, c as FieldBase, j as WalkedField, o as Editability, p as FileField, r as BooleanField, w as SchemaMeta, y as NumberField } from "../types-ag2jYLqQ.mjs";
+import { M as WalkedField, O as StringField, T as SchemaMeta, b as NumberField, c as FieldBase, j as UnknownField, o as Editability, p as FileField, r as BooleanField, v as NullField } from "../types-D_5ST7SS.mjs";
+import { i as DiagnosticsOptions } from "../diagnostics-DzbZmcLI.mjs";
+import { t as ExternalResolver } from "../ref-DvWoULcy.mjs";
 
 //#region src/core/walkBuilders.d.ts
 declare function getString(obj: Record<string, unknown>, key: string): string | undefined;
@@ -11,6 +13,10 @@ interface WalkOptions {
   fieldOverrides?: Record<string, unknown> | undefined;
   /** The root document for $ref resolution. */
   rootDocument?: Record<string, unknown> | undefined;
+  /** Diagnostics channel for surfacing silent fallbacks. */
+  diagnostics?: DiagnosticsOptions;
+  /** Sync resolver for external $ref URIs. */
+  externalResolver?: ExternalResolver;
 }
 declare function extractMetaFromJson(schema: Record<string, unknown>): SchemaMeta;
 declare function extractSchemaMetaFields(overrides: Record<string, unknown> | undefined): SchemaMeta | undefined;
@@ -25,6 +31,14 @@ interface WalkContext {
   defaultValue: unknown;
   /** Cache of $ref → WalkedField for recursive schema support. */
   refResults: Map<string, WalkedField>;
+  /** JSON Pointer tracking for diagnostics. */
+  pointer: string;
+  /** Diagnostics channel for surfacing silent fallbacks. */
+  diagnostics: DiagnosticsOptions | undefined;
+  /** Derived $ref depth bound from the root document. */
+  maxRefDepth: number;
+  /** Sync resolver for external $ref URIs. */
+  externalResolver: ExternalResolver | undefined;
 }
 /**
  * Build the common base shared by every field variant.

package/dist/core/walkBuilders.mjs

@@ -86,7 +86,7 @@ function buildStringField(schema, ctx) {
 	return {
 		...buildBase(schema, ctx),
 		type: "string",
-		constraints: extractStringConstraints(schema)
+		constraints: extractStringConstraints(schema, ctx.diagnostics, ctx.pointer)
 	};
 }
 function buildNumberField(schema, ctx) {

package/dist/core/walker.d.mts

@@ -1,4 +1,4 @@
-import { j as WalkedField } from "../types-ag2jYLqQ.mjs";
+import { M as WalkedField } from "../types-D_5ST7SS.mjs";
 import { WalkOptions } from "./walkBuilders.mjs";
 
 //#region src/core/walker.d.ts