schema-components 1.20.0 → 1.22.0

package/dist/react/SchemaComponent.mjs

@@ -1,5 +1,6 @@
 "use client";
 import { isObject, toRecordOrUndefined } from "../core/guards.mjs";
+import "../core/limits.mjs";
 import { SchemaFieldError, SchemaNormalisationError, SchemaRenderError } from "../core/errors.mjs";
 import { normaliseSchema } from "../core/adapter.mjs";
 import { buildRenderProps, getRenderFunction, mergeResolvers } from "../core/renderer.mjs";
@@ -46,7 +47,8 @@ const globalWidgets = /* @__PURE__ */ new Map();
 function registerWidget(name, render) {
 	globalWidgets.set(name, render);
 }
-function SchemaComponent({ schema: schemaInput, ref: refInput, value, onChange, validate, onValidationError, onError, onDiagnostic, strict, fields, meta: componentMeta, readOnly, writeOnly, description, widgets: instanceWidgets, idPrefix }) {
+function SchemaComponent(props) {
+	const { schema: schemaInput, ref: refInput, value, onChange, validate, onValidationError, onError, onDiagnostic, strict, fields, meta: componentMeta, readOnly, writeOnly, description, widgets: instanceWidgets, idPrefix } = props;
 	const userResolver = useContext(UserResolverContext);
 	const contextWidgets = useContext(WidgetsContext);
 	const generatedId = useId();
@@ -87,7 +89,17 @@ function SchemaComponent({ schema: schemaInput, ref: refInput, value, onChange,
 	}
 	const handleChange = useCallback((nextValue) => {
 		if (validate) {
-			const error = runValidation(zodSchema, jsonSchema, nextValue);
+			let error;
+			try {
+				error = runValidation(zodSchema, jsonSchema, nextValue, onDiagnostic);
+			} catch (err) {
+				const normalised = err instanceof SchemaNormalisationError ? err : new SchemaNormalisationError(err instanceof Error ? err.message : "Fallback validation failed", schemaInput, "zod-conversion-failed", void 0, err);
+				if (onError !== void 0) {
+					onError(normalised);
+					return;
+				}
+				throw normalised;
+			}
 			if (error !== void 0) {
 				onValidationError?.(error);
 				dispatchFieldErrors(fields, error);
@@ -100,7 +112,10 @@ function SchemaComponent({ schema: schemaInput, ref: refInput, value, onChange,
 		jsonSchema,
 		onChange,
 		onValidationError,
-		fields
+		fields,
+		onDiagnostic,
+		onError,
+		schemaInput
 	]);
 	const walkOptions = {
 		componentMeta: mergedMeta,
@@ -118,13 +133,6 @@ function SchemaComponent({ schema: schemaInput, ref: refInput, value, onChange,
 	return renderField(tree, value ?? tree.defaultValue, handleChange, userResolver, renderChild, rootPath, instanceWidgets, contextWidgets, 0);
 }
 /**
-* Default root-path sentinel used when no `idPrefix` is supplied AND the
-* component is rendered outside a React tree (e.g. server-side bundling
-* test harnesses). Production callers receive a `useId()`-derived prefix
-* that is unique per instance.
-*/
-const ROOT_PATH = "root";
-/**
 * Append a child path suffix to a parent path. When the suffix is omitted
 * (e.g. transparent wrappers like union options), the parent path is
 * returned unchanged so the child inherits the parent's id.
@@ -145,7 +153,22 @@ function sanitisePrefix(value) {
 	if (sanitised.length === 0) throw new Error(`Cannot derive a DOM-safe id prefix from "${value}". Pass an explicit idPrefix prop.`);
 	return sanitised;
 }
-function runValidation(zodSchema, jsonSchema, value) {
+/**
+* Run validation against the supplied value.
+*
+* Returns the validation error (Zod error or equivalent) on failure, or
+* `undefined` when the value is valid OR when the fallback validation
+* path was skipped because a diagnostic sink absorbed the conversion
+* failure.
+*
+* Throws `SchemaNormalisationError` (kind `zod-conversion-failed`) when
+* the JSON-Schema → Zod fallback is taken AND no diagnostic sink is
+* wired up. The project's no-silent-fallback rule requires the failure
+* to surface somewhere — diagnostics if the consumer opted in, an error
+* otherwise — so the caller can route it through `onError` / an error
+* boundary rather than have validation quietly disappear.
+*/
+function runValidation(zodSchema, jsonSchema, value, onDiagnostic) {
 	if (zodSchema !== void 0 && isObject(zodSchema)) {
 		const safeParseFn = zodSchema.safeParse;
 		if (isCallable(safeParseFn)) {
@@ -154,7 +177,21 @@ function runValidation(zodSchema, jsonSchema, value) {
 			return;
 		}
 	}
-	const parsed = z.fromJSONSchema(jsonSchema);
+	let parsed;
+	try {
+		parsed = z.fromJSONSchema(jsonSchema);
+	} catch (err) {
+		if (onDiagnostic !== void 0) {
+			onDiagnostic({
+				code: "unsupported-type",
+				message: `Skipping fallback validation: z.fromJSONSchema could not round-trip the normalised JSON Schema. Original message: ${err instanceof Error ? err.message : "z.fromJSONSchema threw a non-Error value"}`,
+				pointer: "",
+				detail: { source: "z.fromJSONSchema" }
+			});
+			return;
+		}
+		throw new SchemaNormalisationError(`Fallback validation failed: z.fromJSONSchema could not round-trip the normalised JSON Schema. Original message: ${err instanceof Error ? err.message : "z.fromJSONSchema threw a non-Error value"}`, jsonSchema, "zod-conversion-failed", void 0, err);
+	}
 	if (isObject(parsed)) {
 		const safeParseFn = parsed.safeParse;
 		if (isCallable(safeParseFn)) {
@@ -163,18 +200,13 @@ function runValidation(zodSchema, jsonSchema, value) {
 		}
 	}
 }
-/** Maximum rendering depth before treating a field as recursive. */
-const MAX_RENDER_DEPTH = 10;
 function renderField(tree, value, onChange, userResolver, renderChild, path, instanceWidgets, contextWidgets, depth = 0) {
-	if (path.length === 0) throw new Error("renderField requires a non-empty path. Pass ROOT_PATH for the root field and use renderChild's pathSuffix to derive child paths.");
-	if (depth >= MAX_RENDER_DEPTH) {
-		const refTarget = tree.type === "recursive" ? tree.refTarget : "";
-		return /* @__PURE__ */ jsx("fieldset", { children: /* @__PURE__ */ jsxs("em", { children: [
-			"↻ ",
-			(typeof tree.meta.description === "string" ? tree.meta.description : refTarget) || "schema",
-			" (recursive)"
-		] }) });
-	}
+	if (path.length === 0) throw new Error("renderField requires a non-empty path. Pass the root path (derived from `idPrefix` or `useId()`) for the root field, and use renderChild's pathSuffix to derive child paths.");
+	if (depth >= 10) return /* @__PURE__ */ jsx("fieldset", { children: /* @__PURE__ */ jsxs("em", { children: [
+		"↻ ",
+		typeof tree.meta.description === "string" ? tree.meta.description : "schema",
+		" (recursive)"
+	] }) });
 	const componentHint = tree.meta.component;
 	if (typeof componentHint === "string") {
 		const widget = instanceWidgets?.get(componentHint) ?? contextWidgets?.get(componentHint) ?? globalWidgets.get(componentHint);
@@ -255,6 +287,16 @@ function SchemaField({ path, schema: schemaInput, ref: refInput, value, onChange
 /**
 * Dispatch Zod errors to per-field onValidationError callbacks.
 * Walks the fields override tree and matches errors by path prefix.
+*
+* The `fields` parameter mirrors the runtime shape produced by
+* `InferFields<T, Ref>` at the props boundary — either a typed
+* `FieldOverrides<...>` tree (for narrowable schemas) or the loose
+* `Record<string, FieldOverride>` fallback. Both reduce to the same
+* runtime shape, and the runtime narrowing below
+* (`toRecordOrUndefined`) handles `undefined` and non-object inputs
+* defensively. Typing the parameter as the union — rather than the
+* `unknown` that earlier revisions used — keeps the type contract
+* visible to readers without changing runtime behaviour.
 */
 function dispatchFieldErrors(fields, error) {
 	if (fields === void 0 || !isObject(error)) return;
@@ -286,4 +328,4 @@ function isCallable(value) {
 	return typeof value === "function";
 }
 //#endregion
-export { ROOT_PATH, SchemaComponent, SchemaField, SchemaProvider, joinPath, registerWidget, renderField, sanitisePrefix };
+export { SchemaComponent, SchemaField, SchemaProvider, joinPath, registerWidget, renderField, sanitisePrefix };

package/dist/react/SchemaView.d.mts

@@ -1,6 +1,6 @@
-import { T as SchemaMeta } from "../types-C9zw9wbX.mjs";
-import { t as Diagnostic } from "../diagnostics-CbBPsxSt.mjs";
-import { r as ComponentResolver } from "../renderer-SOIbJBtk.mjs";
+import { w as SchemaMeta } from "../types-BrRMV0en.mjs";
+import { t as Diagnostic } from "../diagnostics-D0QCYGv0.mjs";
+import { r as ComponentResolver } from "../renderer-BaRlQIuN.mjs";
 import { WidgetMap } from "./SchemaComponent.mjs";
 import { ReactNode } from "react";
 

package/dist/react/SchemaView.mjs

@@ -1,3 +1,4 @@
+import "../core/limits.mjs";
 import { SchemaNormalisationError, SchemaRenderError } from "../core/errors.mjs";
 import { normaliseSchema } from "../core/adapter.mjs";
 import { buildRenderProps, getRenderFunction, mergeResolvers } from "../core/renderer.mjs";
@@ -74,10 +75,9 @@ function SchemaView({ schema: schemaInput, ref: refInput, value, fields, meta: c
 	};
 	const tree = walk(jsonSchema, walkOptions);
 	const userResolver = resolver !== void 0 ? mergeResolvers(resolver, headlessResolver) : headlessResolver;
-	const MAX_SERVER_DEPTH = 10;
 	const makeRenderChild = (currentDepth, parentPath) => (childTree, childValue, pathSuffix) => {
 		const childPath = joinPath(parentPath, pathSuffix);
-		if (currentDepth >= MAX_SERVER_DEPTH) return createElement("fieldset", null, createElement("em", null, `\u21bb ${typeof childTree.meta.description === "string" ? childTree.meta.description : childTree.type === "recursive" ? childTree.refTarget : "schema"} (recursive)`));
+		if (currentDepth >= 10) return createElement("fieldset", null, createElement("em", null, `\u21bb ${typeof childTree.meta.description === "string" ? childTree.meta.description : "schema"} (recursive)`));
 		return renderFieldServer(childTree, childValue, userResolver, makeRenderChild(currentDepth + 1, childPath), childPath, widgets);
 	};
 	const renderChild = makeRenderChild(0, rootPath);

package/dist/react/fieldPath.d.mts

@@ -1,4 +1,4 @@
-import { M as WalkedField } from "../types-C9zw9wbX.mjs";
+import { j as WalkedField } from "../types-BrRMV0en.mjs";
 
 //#region src/react/fieldPath.d.ts
 /**

package/dist/react/headless.d.mts

@@ -1,4 +1,4 @@
-import { r as ComponentResolver } from "../renderer-SOIbJBtk.mjs";
+import { r as ComponentResolver } from "../renderer-BaRlQIuN.mjs";
 
 //#region src/react/headless.d.ts
 /**

package/dist/react/headless.mjs

@@ -1,4 +1,4 @@
-import { renderArray, renderBoolean, renderConditional, renderDiscriminatedUnion, renderEnum, renderFile, renderLiteral, renderNegation, renderNever, renderNull, renderNumber, renderObject, renderRecord, renderRecursive, renderString, renderTuple, renderUnion, renderUnknown } from "./headlessRenderers.mjs";
+import { renderArray, renderBoolean, renderConditional, renderDiscriminatedUnion, renderEnum, renderFile, renderLiteral, renderNegation, renderNever, renderNull, renderNumber, renderObject, renderRecord, renderString, renderTuple, renderUnion, renderUnknown } from "./headlessRenderers.mjs";
 //#region src/react/headless.tsx
 /**
 * The headless resolver uses props.renderChild for recursive rendering.
@@ -27,7 +27,6 @@ const headlessResolver = {
 	negation: renderNegation,
 	literal: renderLiteral,
 	file: renderFile,
-	recursive: renderRecursive,
 	never: renderNever,
 	unknown: renderUnknown
 };

package/dist/react/headlessRenderers.d.mts

@@ -1,5 +1,5 @@
-import { M as WalkedField } from "../types-C9zw9wbX.mjs";
-import { l as RenderProps } from "../renderer-SOIbJBtk.mjs";
+import { j as WalkedField } from "../types-BrRMV0en.mjs";
+import { l as RenderProps } from "../renderer-BaRlQIuN.mjs";
 import { ReactNode } from "react";
 
 //#region src/react/headlessRenderers.d.ts
@@ -56,7 +56,6 @@ declare function renderDiscriminatedUnion(props: RenderProps): ReactNode;
  */
 declare function discriminatedUnionValueForTab(optionLabels: readonly string[], discKey: string, newIndex: number): Record<string, string> | undefined;
 declare function renderFile(props: RenderProps): ReactNode;
-declare function renderRecursive(props: RenderProps): ReactNode;
 /**
  * Render a literal field — `z.literal("a")` or `{ const: 5 }`.
  *
@@ -110,4 +109,4 @@ declare function renderConditional(props: RenderProps): ReactNode;
 declare function renderNegation(props: RenderProps): ReactNode;
 declare function renderUnknown(props: RenderProps): ReactNode;
 //#endregion
-export { defaultRecordValue, discriminatedUnionValueForTab, inputId, nextRecordKey, renameRecordKey, renderArray, renderBoolean, renderConditional, renderDiscriminatedUnion, renderEnum, renderFile, renderLiteral, renderNegation, renderNever, renderNull, renderNumber, renderObject, renderRecord, renderRecursive, renderString, renderTuple, renderUnion, renderUnknown, toReactNode };
+export { defaultRecordValue, discriminatedUnionValueForTab, inputId, nextRecordKey, renameRecordKey, renderArray, renderBoolean, renderConditional, renderDiscriminatedUnion, renderEnum, renderFile, renderLiteral, renderNegation, renderNever, renderNull, renderNumber, renderObject, renderRecord, renderString, renderTuple, renderUnion, renderUnknown, toReactNode };

package/dist/react/headlessRenderers.mjs

@@ -1,6 +1,6 @@
 import { isObject } from "../core/guards.mjs";
-import { sortFieldsByOrder } from "../core/fieldOrder.mjs";
 import { isSafeHyperlink, isSafeMailtoAddress } from "../core/uri.mjs";
+import { sortFieldsByOrder } from "../core/fieldOrder.mjs";
 import { jsx, jsxs } from "react/jsx-runtime";
 import { isValidElement, useCallback, useEffect, useRef } from "react";
 //#region src/react/headlessRenderers.tsx
@@ -25,33 +25,21 @@ function toReactNode(value) {
 }
 function formatDateTime(value) {
 	if (typeof value !== "string" || value.length === 0) return void 0;
-	try {
-		const date = new Date(value);
-		if (isNaN(date.getTime())) return void 0;
-		return date.toLocaleString();
-	} catch {
-		return;
-	}
+	const date = new Date(value);
+	if (isNaN(date.getTime())) return void 0;
+	return date.toLocaleString();
 }
 function formatDate(value) {
 	if (typeof value !== "string" || value.length === 0) return void 0;
-	try {
-		const date = new Date(value);
-		if (isNaN(date.getTime())) return void 0;
-		return date.toLocaleDateString();
-	} catch {
-		return;
-	}
+	const date = new Date(value);
+	if (isNaN(date.getTime())) return void 0;
+	return date.toLocaleDateString();
 }
 function formatTime(value) {
 	if (typeof value !== "string" || value.length === 0) return void 0;
-	try {
-		const date = new Date(value);
-		if (isNaN(date.getTime())) return void 0;
-		return date.toLocaleTimeString();
-	} catch {
-		return;
-	}
+	const date = new Date(value);
+	if (isNaN(date.getTime())) return void 0;
+	return date.toLocaleTimeString();
 }
 function dateInputType(format) {
 	if (format === "date") return "date";
@@ -588,14 +576,6 @@ function renderFile(props) {
 		...ariaAttrs
 	});
 }
-function renderRecursive(props) {
-	const refTarget = props.tree.type === "recursive" ? props.tree.refTarget : "";
-	return /* @__PURE__ */ jsx("fieldset", { children: /* @__PURE__ */ jsxs("em", { children: [
-		"↻ ",
-		typeof props.meta.description === "string" ? props.meta.description : refTarget,
-		" (recursive)"
-	] }) });
-}
 /**
 * Render a literal field — `z.literal("a")` or `{ const: 5 }`.
 *
@@ -777,4 +757,4 @@ function matchUnionOption(options, value) {
 	if (typeof value === "object" && value !== null) return options.find((o) => o.type === "object");
 }
 //#endregion
-export { defaultRecordValue, discriminatedUnionValueForTab, inputId, nextRecordKey, renameRecordKey, renderArray, renderBoolean, renderConditional, renderDiscriminatedUnion, renderEnum, renderFile, renderLiteral, renderNegation, renderNever, renderNull, renderNumber, renderObject, renderRecord, renderRecursive, renderString, renderTuple, renderUnion, renderUnknown, toReactNode };
+export { defaultRecordValue, discriminatedUnionValueForTab, inputId, nextRecordKey, renameRecordKey, renderArray, renderBoolean, renderConditional, renderDiscriminatedUnion, renderEnum, renderFile, renderLiteral, renderNegation, renderNever, renderNull, renderNumber, renderObject, renderRecord, renderString, renderTuple, renderUnion, renderUnknown, toReactNode };

package/dist/{ref-C8JbwfiS.d.mts → ref-D-_JBZkF.d.mts}

@@ -1,4 +1,4 @@
-import { i as DiagnosticsOptions } from "./diagnostics-CbBPsxSt.mjs";
+import { i as DiagnosticsOptions } from "./diagnostics-D0QCYGv0.mjs";
 
 //#region src/core/ref.d.ts
 /**
@@ -38,7 +38,12 @@ declare function dereference(ref: string, root: Record<string, unknown>): Record
 /**
  * Recursively scan a schema document for a `$anchor` matching the given name.
  * Returns the schema object containing the anchor, or undefined.
+ *
+ * The optional `visited` set guards against shared object references and
+ * cycles introduced by the OpenAPI bundler's `structuredClone`-based
+ * inlining of external refs. Without it a recursive document would stack
+ * overflow before reaching the matching anchor.
  */
-declare function findAnchor(node: unknown, anchorName: string): Record<string, unknown> | undefined;
+declare function findAnchor(node: unknown, anchorName: string, visited?: WeakSet<object>): Record<string, unknown> | undefined;
 //#endregion
 export { findAnchor as a, dereference as i, RefOptions as n, resolveRef as o, countDistinctRefs as r, ExternalResolver as t };

package/dist/{renderer-SOIbJBtk.d.mts → renderer-BaRlQIuN.d.mts}

@@ -1,4 +1,4 @@
-import { D as StringConstraints, M as WalkedField, T as SchemaMeta, f as FileConstraints, t as ArrayConstraints, x as ObjectConstraints, y as NumberConstraints } from "./types-C9zw9wbX.mjs";
+import { E as StringConstraints, f as FileConstraints, j as WalkedField, t as ArrayConstraints, w as SchemaMeta, x as ObjectConstraints, y as NumberConstraints } from "./types-BrRMV0en.mjs";
 
 //#region src/core/renderer.d.ts
 /**
@@ -140,7 +140,7 @@ interface HtmlResolver {
   never?: HtmlRenderFunction;
   unknown?: HtmlRenderFunction;
 }
-declare const RESOLVER_KEYS: readonly ["string", "number", "boolean", "null", "enum", "object", "array", "tuple", "record", "union", "discriminatedUnion", "conditional", "negation", "recursive", "literal", "file", "never", "unknown"];
+declare const RESOLVER_KEYS: readonly ["string", "number", "boolean", "null", "enum", "object", "array", "tuple", "record", "union", "discriminatedUnion", "conditional", "negation", "literal", "file", "never", "unknown"];
 type ResolverKey = (typeof RESOLVER_KEYS)[number];
 /**
  * Map a schema type to the resolver key that handles it.

package/dist/themes/mantine.d.mts

@@ -1,4 +1,4 @@
-import { r as ComponentResolver } from "../renderer-SOIbJBtk.mjs";
+import { r as ComponentResolver } from "../renderer-BaRlQIuN.mjs";
 
 //#region src/themes/mantine.d.ts
 /**

package/dist/themes/mui.d.mts

@@ -1,4 +1,4 @@
-import { r as ComponentResolver } from "../renderer-SOIbJBtk.mjs";
+import { r as ComponentResolver } from "../renderer-BaRlQIuN.mjs";
 
 //#region src/themes/mui.d.ts
 /**

package/dist/themes/radix.d.mts

@@ -1,4 +1,4 @@
-import { r as ComponentResolver } from "../renderer-SOIbJBtk.mjs";
+import { r as ComponentResolver } from "../renderer-BaRlQIuN.mjs";
 
 //#region src/themes/radix.d.ts
 /**

package/dist/themes/shadcn.d.mts

@@ -1,4 +1,4 @@
-import { r as ComponentResolver } from "../renderer-SOIbJBtk.mjs";
+import { r as ComponentResolver } from "../renderer-BaRlQIuN.mjs";
 
 //#region src/themes/shadcn.d.ts
 declare const shadcnResolver: ComponentResolver;