schema-components 1.29.0 → 2.0.0

package/dist/html/a11y.mjs

@@ -1,3 +1,4 @@
+import { constraintHint } from "../core/constraintHint.mjs";
 import { fieldDomId, hintIdFor } from "../core/idPath.mjs";
 import { h } from "./html.mjs";
 //#region src/html/a11y.ts
@@ -35,22 +36,6 @@ function buildHintId(inputId) {
 	return hintIdFor(inputId);
 }
 /**
-* Build a human-readable constraint description string.
-* Returns undefined if no constraints are present.
-*/
-function constraintHint(c) {
-	const parts = [];
-	if (c.minLength !== void 0) parts.push(`Minimum ${String(c.minLength)} characters`);
-	if (c.maxLength !== void 0) parts.push(`Maximum ${String(c.maxLength)} characters`);
-	if (c.minimum !== void 0) parts.push(`Minimum ${String(c.minimum)}`);
-	if (c.maximum !== void 0) parts.push(`Maximum ${String(c.maximum)}`);
-	if (c.pattern !== void 0 && c.format === void 0) parts.push("Must match pattern");
-	if (c.minItems !== void 0) parts.push(`Minimum ${String(c.minItems)} items`);
-	if (c.maxItems !== void 0) parts.push(`Maximum ${String(c.maxItems)} items`);
-	if (parts.length === 0) return void 0;
-	return parts.join(". ");
-}
-/**
 * Build `aria-required` attribute for required fields.
 * Returns an object to spread into `h()` attributes, or empty object.
 */

package/dist/html/renderToHtml.d.mts

@@ -1,5 +1,8 @@
-import { w as SchemaMeta } from "../types-C2Ay1FEh.mjs";
-import { o as HtmlResolver } from "../renderer-OaOz-n6-.mjs";
+import { w as SchemaMeta } from "../types-BrYbjC7_.mjs";
+import { SchemaIoSide } from "../core/adapter.mjs";
+import { HtmlResolver } from "../core/renderer.mjs";
+import { RejectUnrepresentableZod } from "../core/typeInference.mjs";
+import { a as InferredValue, t as InferFields } from "../inferValue-PPXWJpbN.mjs";
 
 //#region src/html/renderToHtml.d.ts
 /**
@@ -15,15 +18,25 @@ declare function recursionSentinelHtml(label: string): string;
 /**
  * Options accepted by {@link renderToHtml}.
  *
+ * The generic parameters mirror `<SchemaComponent>` so a typed
+ * `schema` argument drives typed `value`, `ref`, and `fields` options.
+ *
  * @group HTML
  */
-interface RenderToHtmlOptions {
-  /** The data value to render. */
-  value?: unknown;
+interface RenderToHtmlOptions<T = unknown, Ref extends string | undefined = undefined, Mode extends SchemaIoSide = "output"> {
+  /**
+   * The data value to render. Typed against `InferredValue<T, Ref, undefined, Mode>`
+   * so a typed `schema` argument drives the rendered value's shape.
+   */
+  value?: InferredValue<T, Ref, undefined, Mode>;
   /** For OpenAPI: a ref string like "#/components/schemas/User". */
-  ref?: string;
-  /** Per-field meta overrides. */
-  fields?: Record<string, unknown>;
+  ref?: Ref;
+  /**
+   * Per-field meta overrides — nested object mirroring schema shape.
+   * Typed against {@link InferFields} so a typed `schema` argument
+   * drives autocomplete on the override map.
+   */
+  fields?: InferFields<T, Ref>;
   /** Meta overrides applied to the root schema. */
   meta?: SchemaMeta;
   /** Force all fields read-only. */
@@ -54,6 +67,6 @@ interface RenderToHtmlOptions {
  * const html = renderToHtml(userSchema, { value: user, readOnly: true });
  * ```
  */
-declare function renderToHtml(schema: unknown, options?: RenderToHtmlOptions): string;
+declare function renderToHtml<T = unknown, Ref extends string | undefined = undefined, Mode extends SchemaIoSide = "output">(schema: RejectUnrepresentableZod<T>, options?: RenderToHtmlOptions<T, Ref, Mode>): string;
 //#endregion
 export { RenderToHtmlOptions, recursionSentinelHtml, renderToHtml };

package/dist/html/renderToHtml.mjs

@@ -1,3 +1,4 @@
+import { toRecordOrUndefined } from "../core/guards.mjs";
 import "../core/limits.mjs";
 import { normaliseSchema } from "../core/adapter.mjs";
 import { getHtmlRenderFn, mergeHtmlResolvers } from "../core/renderer.mjs";
@@ -66,7 +67,7 @@ function renderToHtml(schema, options = {}) {
 	const tree = walk(jsonSchema, {
 		componentMeta: mergedMeta,
 		rootMeta,
-		fieldOverrides: options.fields,
+		fieldOverrides: toRecordOrUndefined(options.fields),
 		rootDocument
 	});
 	const resolver = options.resolver ?? defaultHtmlResolver;

package/dist/html/renderToHtmlStream.d.mts

@@ -1,5 +1,8 @@
-import { w as SchemaMeta } from "../types-C2Ay1FEh.mjs";
-import { o as HtmlResolver } from "../renderer-OaOz-n6-.mjs";
+import { w as SchemaMeta } from "../types-BrYbjC7_.mjs";
+import { SchemaIoSide } from "../core/adapter.mjs";
+import { HtmlResolver } from "../core/renderer.mjs";
+import { RejectUnrepresentableZod } from "../core/typeInference.mjs";
+import { a as InferredValue, t as InferFields } from "../inferValue-PPXWJpbN.mjs";
 
 //#region src/html/renderToHtmlStream.d.ts
 /**
@@ -7,15 +10,25 @@ import { o as HtmlResolver } from "../renderer-OaOz-n6-.mjs";
  * ({@link renderToHtmlChunks}, {@link renderToHtmlStream},
  * {@link renderToHtmlReadable}).
  *
+ * The generic parameters mirror `<SchemaComponent>` so a typed
+ * `schema` argument drives typed `value`, `ref`, and `fields` options.
+ *
  * @group HTML
  */
-interface StreamRenderOptions {
-  /** The data value to render. */
-  value?: unknown;
+interface StreamRenderOptions<T = unknown, Ref extends string | undefined = undefined, Mode extends SchemaIoSide = "output"> {
+  /**
+   * The data value to render. Typed against `InferredValue<T, Ref, undefined, Mode>`
+   * so a typed `schema` argument drives the rendered value's shape.
+   */
+  value?: InferredValue<T, Ref, undefined, Mode>;
   /** For OpenAPI: a ref string like "#/components/schemas/User". */
-  ref?: string;
-  /** Per-field meta overrides. */
-  fields?: Record<string, unknown>;
+  ref?: Ref;
+  /**
+   * Per-field meta overrides — nested object mirroring schema shape.
+   * Typed against {@link InferFields} so a typed `schema` argument
+   * drives autocomplete on the override map.
+   */
+  fields?: InferFields<T, Ref>;
   /** Meta overrides applied to the root schema. */
   meta?: SchemaMeta;
   /** Force all fields read-only. */
@@ -43,7 +56,7 @@ interface StreamRenderOptions {
  * }
  * ```
  */
-declare function renderToHtmlChunks(schema: unknown, options?: StreamRenderOptions): Iterable<string>;
+declare function renderToHtmlChunks<T = unknown, Ref extends string | undefined = undefined, Mode extends SchemaIoSide = "output">(schema: RejectUnrepresentableZod<T>, options?: StreamRenderOptions<T, Ref, Mode>): Iterable<string>;
 /**
  * Render a schema as an async iterable of HTML string chunks. Yields
  * back to the event loop between chunks via a microtask so other tasks
@@ -51,7 +64,7 @@ declare function renderToHtmlChunks(schema: unknown, options?: StreamRenderOptio
  *
  * @group HTML
  */
-declare function renderToHtmlStream(schema: unknown, options?: StreamRenderOptions): AsyncIterable<string>;
+declare function renderToHtmlStream<T = unknown, Ref extends string | undefined = undefined, Mode extends SchemaIoSide = "output">(schema: RejectUnrepresentableZod<T>, options?: StreamRenderOptions<T, Ref, Mode>): AsyncIterable<string>;
 /**
  * Render a schema as a web `ReadableStream<string>` so it can be piped
  * into a `Response` body. Pulls chunks lazily from the synchronous
@@ -67,6 +80,6 @@ declare function renderToHtmlStream(schema: unknown, options?: StreamRenderOptio
  * });
  * ```
  */
-declare function renderToHtmlReadable(schema: unknown, options?: StreamRenderOptions): ReadableStream<string>;
+declare function renderToHtmlReadable<T = unknown, Ref extends string | undefined = undefined, Mode extends SchemaIoSide = "output">(schema: RejectUnrepresentableZod<T>, options?: StreamRenderOptions<T, Ref, Mode>): ReadableStream<string>;
 //#endregion
 export { StreamRenderOptions, renderToHtmlChunks, renderToHtmlReadable, renderToHtmlStream };

package/dist/html/renderToHtmlStream.mjs

@@ -1,3 +1,4 @@
+import { toRecordOrUndefined } from "../core/guards.mjs";
 import { normaliseSchema } from "../core/adapter.mjs";
 import { mergeHtmlResolvers } from "../core/renderer.mjs";
 import { walk } from "../core/walker.mjs";
@@ -88,7 +89,7 @@ function prepareTree(schema, options) {
 		tree: walk(jsonSchema, {
 			componentMeta: mergedMeta,
 			rootMeta,
-			fieldOverrides: options.fields,
+			fieldOverrides: toRecordOrUndefined(options.fields),
 			rootDocument
 		}),
 		resolver: options.resolver ?? defaultHtmlResolver

package/dist/html/renderers.d.mts

@@ -1,39 +1,8 @@
+import { HtmlResolver } from "../core/renderer.mjs";
 import { dateInputType } from "../core/formats.mjs";
-import { o as HtmlResolver } from "../renderer-OaOz-n6-.mjs";
 import { matchUnionOption } from "../core/unionMatch.mjs";
 
 //#region src/html/renderers.d.ts
-/**
- * Thin wrapper over `fieldDomId` from `core/idPath.ts`. Every render
- * pipeline must derive ids from the same canonical normaliser so that
- * `aria-controls`, `aria-labelledby`, and `htmlFor` references resolve
- * consistently across the React, sync-HTML, and streaming-HTML outputs.
- *
- * The wrapper tolerates an empty path here (returning `sc-`) so that
- * a leaf renderer at the schema root — `renderToHtml(z.string())` — has
- * a usable id without throwing. Container renderers always thread a
- * non-empty path through `renderChild`, so the empty-id fallback can
- * never produce sibling collisions inside a structured form.
- */
-declare function fieldId(path: string): string;
-/**
- * Tab-panel id for a discriminated union at `path`. Delegates to the
- * canonical `panelIdFor` from `core/idPath.ts` for the normal case so
- * the sync, streaming, and React renderers all emit identical ids; falls
- * back to a structurally-equivalent string when the renderer is invoked
- * with an empty root path (a discriminated union at the schema root —
- * see the `fieldId` doc comment for the wider context).
- *
- * Exported because `streamRenderers.ts` needs to derive identical ids
- * — the panel id on the `<div role="tabpanel">` must match the
- * `aria-controls` on every tab regardless of which pipeline rendered it.
- */
-declare function panelId(path: string): string;
-/**
- * Tab id for tab `i` within a discriminated union at `path`. Mirror of
- * `panelId` above — see its comment.
- */
-declare function tabId(path: string, i: number): string;
 /**
  * Default HTML resolver used by `renderToHtml` and the streaming
  * renderers when the consumer does not pass a custom resolver. Maps
@@ -42,4 +11,4 @@ declare function tabId(path: string, i: number): string;
  */
 declare const defaultHtmlResolver: HtmlResolver;
 //#endregion
-export { dateInputType, defaultHtmlResolver, fieldId, matchUnionOption, panelId, tabId };
+export { dateInputType, defaultHtmlResolver, matchUnionOption };

package/dist/html/renderers.mjs

@@ -9,56 +9,13 @@ import { displayJsonValue } from "../core/walkBuilders.mjs";
 import { h, raw, serialize } from "./html.mjs";
 import { ariaDescribedByAttrs, ariaLabelAttrs, ariaReadonlyAttrs, ariaRequiredAttrs, buildHintElement, buildInputId, requiredIndicator } from "./a11y.mjs";
 //#region src/html/renderers.ts
-/**
-* Thin wrapper over `fieldDomId` from `core/idPath.ts`. Every render
-* pipeline must derive ids from the same canonical normaliser so that
-* `aria-controls`, `aria-labelledby`, and `htmlFor` references resolve
-* consistently across the React, sync-HTML, and streaming-HTML outputs.
-*
-* The wrapper tolerates an empty path here (returning `sc-`) so that
-* a leaf renderer at the schema root — `renderToHtml(z.string())` — has
-* a usable id without throwing. Container renderers always thread a
-* non-empty path through `renderChild`, so the empty-id fallback can
-* never produce sibling collisions inside a structured form.
-*/
-function fieldId(path) {
-	if (path.length === 0) return "sc-";
-	return fieldDomId(path);
-}
-/**
-* Tab-panel id for a discriminated union at `path`. Delegates to the
-* canonical `panelIdFor` from `core/idPath.ts` for the normal case so
-* the sync, streaming, and React renderers all emit identical ids; falls
-* back to a structurally-equivalent string when the renderer is invoked
-* with an empty root path (a discriminated union at the schema root —
-* see the `fieldId` doc comment for the wider context).
-*
-* Exported because `streamRenderers.ts` needs to derive identical ids
-* — the panel id on the `<div role="tabpanel">` must match the
-* `aria-controls` on every tab regardless of which pipeline rendered it.
-*/
-function panelId(path) {
-	if (path.length === 0) return `${fieldId(path)}-panel`;
-	return panelIdFor(path);
-}
-/**
-* Tab id for tab `i` within a discriminated union at `path`. Mirror of
-* `panelId` above — see its comment.
-*/
-function tabId(path, i) {
-	if (path.length === 0) return `${fieldId(path)}-tab-${String(i)}`;
-	return tabIdFor(path, i);
-}
 function renderStringHtml(props) {
 	if (props.readOnly) return serialize(renderStringReadOnly(props));
 	return serialize(renderStringEditable(props));
 }
 function renderStringReadOnly(props) {
 	const strValue = typeof props.value === "string" ? props.value : void 0;
-	if (strValue === void 0 || strValue.length === 0) return h("span", {
-		class: SC_CLASSES.valueEmpty,
-		...ariaReadonlyAttrs()
-	}, "—");
+	if (strValue === void 0 || strValue.length === 0) return h("span", { class: SC_CLASSES.valueEmpty }, "—");
 	const format = props.constraints.format;
 	if (format === "email" && isSafeMailtoAddress(strValue)) return h("a", {
 		class: SC_CLASSES.value,
@@ -70,22 +27,22 @@ function renderStringReadOnly(props) {
 		href: strValue,
 		...ariaReadonlyAttrs()
 	}, strValue);
-	return h("span", {
-		class: SC_CLASSES.value,
-		...ariaReadonlyAttrs()
-	}, strValue);
+	return h("span", { class: SC_CLASSES.value }, strValue);
 }
 function renderStringEditable(props) {
 	const strValue = typeof props.value === "string" ? props.value : "";
 	const format = props.constraints.format;
-	const inputType = dateInputType(format) ?? (format === "email" ? "email" : format === "uri" ? "url" : "text");
-	const id = fieldId(props.path);
+	const dateType = dateInputType(format);
+	const isCredential = props.writeOnly && format === "password";
+	const inputType = dateType ?? (isCredential ? "password" : format === "email" ? "email" : format === "uri" ? "url" : "text");
+	const id = fieldDomId(props.path);
 	const attrs = {
 		class: SC_CLASSES.input,
 		id,
 		type: inputType,
 		name: id
 	};
+	if (isCredential) attrs.autocomplete = strValue.length > 0 ? "current-password" : "new-password";
 	if (!props.writeOnly) attrs.value = strValue;
 	if (typeof props.meta.description === "string") attrs.placeholder = props.meta.description;
 	if (props.constraints.minLength !== void 0) attrs.minlength = String(props.constraints.minLength);
@@ -99,24 +56,24 @@ function renderNumberHtml(props) {
 	return serialize(renderNumberEditable(props));
 }
 function renderNumberReadOnly(props) {
-	if (typeof props.value !== "number") return h("span", {
-		class: SC_CLASSES.valueEmpty,
-		...ariaReadonlyAttrs()
-	}, "—");
-	return h("span", {
-		class: SC_CLASSES.value,
-		...ariaReadonlyAttrs()
-	}, props.value.toLocaleString());
+	if (typeof props.value !== "number") return h("span", { class: SC_CLASSES.valueEmpty }, "—");
+	return h("span", { class: SC_CLASSES.value }, props.value.toLocaleString());
 }
 function renderNumberEditable(props) {
 	const numValue = typeof props.value === "number" ? String(props.value) : "";
-	const id = fieldId(props.path);
+	const id = fieldDomId(props.path);
+	const isInteger = props.tree.type === "number" ? props.tree.isInteger : false;
+	const inputMode = isInteger ? "numeric" : "decimal";
+	const multipleOf = props.constraints.multipleOf;
 	const attrs = {
 		class: SC_CLASSES.input,
 		id,
 		type: "number",
-		name: id
+		name: id,
+		inputmode: inputMode
 	};
+	if (multipleOf !== void 0) attrs.step = String(multipleOf);
+	else if (isInteger) attrs.step = "1";
 	if (!props.writeOnly) attrs.value = numValue;
 	if (props.constraints.minimum !== void 0) attrs.min = String(props.constraints.minimum);
 	if (props.constraints.maximum !== void 0) attrs.max = String(props.constraints.maximum);
@@ -129,17 +86,11 @@ function renderBooleanHtml(props) {
 	return serialize(renderBooleanEditable(props));
 }
 function renderBooleanReadOnly(props) {
-	if (typeof props.value !== "boolean") return h("span", {
-		class: SC_CLASSES.valueEmpty,
-		...ariaReadonlyAttrs()
-	}, "—");
-	return h("span", {
-		class: "sc-value sc-value--boolean",
-		...ariaReadonlyAttrs()
-	}, props.value ? "Yes" : "No");
+	if (typeof props.value !== "boolean") return h("span", { class: SC_CLASSES.valueEmpty }, "—");
+	return h("span", { class: "sc-value sc-value--boolean" }, props.value ? "Yes" : "No");
 }
 function renderBooleanEditable(props) {
-	const id = fieldId(props.path);
+	const id = fieldDomId(props.path);
 	const attrs = {
 		class: SC_CLASSES.input,
 		id,
@@ -157,18 +108,12 @@ function renderEnumHtml(props) {
 }
 function renderEnumReadOnly(props) {
 	const enumValue = typeof props.value === "string" ? props.value : "";
-	if (enumValue.length === 0) return h("span", {
-		class: SC_CLASSES.valueEmpty,
-		...ariaReadonlyAttrs()
-	}, "—");
-	return h("span", {
-		class: SC_CLASSES.value,
-		...ariaReadonlyAttrs()
-	}, enumValue);
+	if (enumValue.length === 0) return h("span", { class: SC_CLASSES.valueEmpty }, "—");
+	return h("span", { class: SC_CLASSES.value }, enumValue);
 }
 function renderEnumEditable(props) {
 	const enumValue = typeof props.value === "string" ? props.value : "";
-	const id = fieldId(props.path);
+	const id = fieldDomId(props.path);
 	const selectedValue = props.writeOnly ? "" : enumValue;
 	const enumValues = props.tree.type === "enum" ? props.tree.enumValues : [];
 	const optionNodes = [h("option", { value: "" }, `Select…`), ...enumValues.map((v) => {
@@ -268,8 +213,12 @@ function renderRecordNode(props) {
 	}
 	const children = [];
 	for (const [key, val] of Object.entries(obj)) {
+		const childInputId = buildInputId(props.path, key);
 		const childHtml = props.renderChild(valueType, val, key);
-		children.push(h("div", { class: SC_CLASSES.field }, h("label", { class: SC_CLASSES.label }, key), raw(childHtml)));
+		children.push(h("div", { class: SC_CLASSES.field }, h("label", {
+			class: SC_CLASSES.label,
+			for: childInputId
+		}, key), raw(childHtml)));
 	}
 	return h("div", attrs, ...children);
 }
@@ -307,14 +256,14 @@ function renderDiscriminatedUnionHtml(props) {
 		if (activeOption !== void 0) return props.renderChild(activeOption, props.value);
 		return serialize(h("span", { class: SC_CLASSES.valueEmpty }, "—"));
 	}
-	const tabPanelId = panelId(props.path);
+	const tabPanelId = panelIdFor(props.path);
 	const tabButtons = options.map((_opt, i) => {
 		return h("button", {
 			type: "button",
 			role: "tab",
 			class: i === activeIndex ? SC_CLASSES.tabActive : SC_CLASSES.tab,
-			id: tabId(props.path, i),
-			"aria-selected": i === activeIndex ? "true" : void 0,
+			id: tabIdFor(props.path, i),
+			"aria-selected": i === activeIndex ? "true" : "false",
 			"aria-controls": tabPanelId,
 			tabindex: i === activeIndex ? "0" : "-1"
 		}, optionLabels[i]);
@@ -322,25 +271,25 @@ function renderDiscriminatedUnionHtml(props) {
 	const children = [h("div", {
 		role: "tablist",
 		class: SC_CLASSES.tabs,
-		"aria-label": "Select variant"
+		"aria-label": "Select variant",
+		"aria-orientation": "horizontal"
 	}, ...tabButtons)];
 	if (activeOption !== void 0) {
 		const childHtml = props.renderChild(activeOption, props.value);
 		children.push(h("div", {
 			role: "tabpanel",
 			id: tabPanelId,
-			"aria-labelledby": tabId(props.path, activeIndex)
+			"aria-labelledby": tabIdFor(props.path, activeIndex)
 		}, raw(childHtml)));
 	}
 	return serialize(h("div", { class: SC_CLASSES.discriminatedUnion }, ...children));
 }
 function renderFileHtml(props) {
-	const id = fieldId(props.path);
+	const id = fieldDomId(props.path);
 	const accept = props.constraints.mimeTypes?.join(",");
 	if (props.readOnly) return serialize(h("span", {
 		class: SC_CLASSES.value,
-		id,
-		...ariaReadonlyAttrs()
+		id
 	}, "File field"));
 	const attrs = {
 		class: SC_CLASSES.input,
@@ -407,7 +356,7 @@ function renderNegationHtml(props) {
 * The only valid value is `null`, so render an em-dash placeholder.
 */
 function renderNullHtml(props) {
-	const id = fieldId(props.path);
+	const id = fieldDomId(props.path);
 	return serialize(h("span", {
 		class: SC_CLASSES.valueEmpty,
 		id,
@@ -424,8 +373,7 @@ function renderNullHtml(props) {
 function renderNeverHtml(props) {
 	return serialize(h("span", {
 		class: "sc-value sc-never",
-		id: fieldId(props.path),
-		...ariaReadonlyAttrs()
+		id: fieldDomId(props.path)
 	}, h("em", {}, "never matches")));
 }
 /**
@@ -454,4 +402,4 @@ const defaultHtmlResolver = {
 	unknown: renderUnknownHtml
 };
 //#endregion
-export { dateInputType, defaultHtmlResolver, fieldId, matchUnionOption, panelId, tabId };
+export { dateInputType, defaultHtmlResolver, matchUnionOption };

package/dist/html/streamRenderers.d.mts

@@ -1,6 +1,6 @@
-import { j as WalkedField } from "../types-C2Ay1FEh.mjs";
-import { i as DiagnosticsOptions } from "../diagnostics-ByEzkjrA.mjs";
-import { o as HtmlResolver } from "../renderer-OaOz-n6-.mjs";
+import { j as WalkedField } from "../types-BrYbjC7_.mjs";
+import { i as DiagnosticsOptions } from "../diagnostics-BTrm3O6J.mjs";
+import { HtmlResolver } from "../core/renderer.mjs";
 import { HtmlElement } from "./html.mjs";
 
 //#region src/html/streamRenderers.d.ts

package/dist/html/streamRenderers.mjs

@@ -2,11 +2,11 @@ import { isObject } from "../core/guards.mjs";
 import "../core/limits.mjs";
 import { emitDiagnostic } from "../core/diagnostics.mjs";
 import { SC_CLASSES } from "../core/cssClasses.mjs";
+import { panelIdFor, tabIdFor } from "../core/idPath.mjs";
 import { getHtmlRenderFn } from "../core/renderer.mjs";
 import { matchUnionOption, resolveDiscriminatedActive } from "../core/unionMatch.mjs";
 import { VOID_ELEMENTS, h, raw, serialize, serializeAttributes } from "./html.mjs";
 import { ariaLabelAttrs, buildHintElement, buildInputId, joinPath, requiredIndicator } from "./a11y.mjs";
-import { panelId, tabId } from "./renderers.mjs";
 import { recursionSentinelHtml } from "./renderToHtml.mjs";
 //#region src/html/streamRenderers.ts
 /**
@@ -164,7 +164,7 @@ function* streamObject(tree, value, mergedResolver, path, rawResolver, currentDe
 				class: SC_CLASSES.label,
 				for: fieldId
 			}, ...labelContent), raw(childChunks)];
-			const hint = buildHintElement(key, field.constraints);
+			const hint = buildHintElement(fieldId, field.constraints);
 			if (hint !== void 0) fieldChildren.push(hint);
 			yield serialize(h("div", { class: SC_CLASSES.field }, ...fieldChildren));
 		}
@@ -237,8 +237,12 @@ function* streamRecord(tree, value, mergedResolver, path, rawResolver, currentDe
 		const container = h("div", attrs);
 		yield yieldOpen(container);
 		for (const [key, val] of Object.entries(obj)) {
+			const childInputId = buildInputId(path, key);
 			const childHtml = renderFieldSync(valueType, val, mergedResolver, joinPath(path, key), rawResolver, currentDepth + 1, diagnostics);
-			yield serialize(h("div", { class: SC_CLASSES.field }, h("label", { class: SC_CLASSES.label }, key), raw(childHtml)));
+			yield serialize(h("div", { class: SC_CLASSES.field }, h("label", {
+				class: SC_CLASSES.label,
+				for: childInputId
+			}, key), raw(childHtml)));
 		}
 		yield yieldClose(container);
 	}
@@ -267,7 +271,7 @@ function* streamDiscriminatedUnion(tree, value, mergedResolver, path, rawResolve
 		if (activeOption !== void 0) yield* streamField(activeOption, value, mergedResolver, path, rawResolver, currentDepth + 1, diagnostics);
 		return;
 	}
-	const tabPanelId = panelId(path);
+	const tabPanelId = panelIdFor(path);
 	const wrapper = h("div", { class: SC_CLASSES.discriminatedUnion });
 	yield yieldOpen(wrapper);
 	const tabButtons = options.map((_opt, i) => {
@@ -275,8 +279,8 @@ function* streamDiscriminatedUnion(tree, value, mergedResolver, path, rawResolve
 			type: "button",
 			role: "tab",
 			class: i === activeIndex ? SC_CLASSES.tabActive : SC_CLASSES.tab,
-			id: tabId(path, i),
-			"aria-selected": i === activeIndex ? "true" : void 0,
+			id: tabIdFor(path, i),
+			"aria-selected": i === activeIndex ? "true" : "false",
 			"aria-controls": tabPanelId,
 			tabindex: i === activeIndex ? "0" : "-1"
 		}, optionLabels[i]);
@@ -284,12 +288,13 @@ function* streamDiscriminatedUnion(tree, value, mergedResolver, path, rawResolve
 	yield serialize(h("div", {
 		role: "tablist",
 		class: SC_CLASSES.tabs,
-		"aria-label": "Select variant"
+		"aria-label": "Select variant",
+		"aria-orientation": "horizontal"
 	}, ...tabButtons));
 	const panelOpen = h("div", {
 		role: "tabpanel",
 		id: tabPanelId,
-		"aria-labelledby": tabId(path, activeIndex)
+		"aria-labelledby": tabIdFor(path, activeIndex)
 	});
 	yield yieldOpen(panelOpen);
 	if (activeOption !== void 0) yield* streamField(activeOption, value, mergedResolver, path, rawResolver, currentDepth + 1, diagnostics);

package/dist/inferValue-PPXWJpbN.d.mts

@@ -0,0 +1,77 @@
+import { d as FieldOverrides, u as FieldOverride } from "./types-BrYbjC7_.mjs";
+import { SchemaIoSide } from "./core/adapter.mjs";
+import { FromJSONSchema, FromJSONSchemaMode, IsSwagger2Doc, ResolveOpenAPIRef, TypeAtPath, __SchemaInferenceFellBack } from "./core/typeInference.mjs";
+import { z } from "zod";
+
+//#region src/core/inferValue.d.ts
+/**
+ * Recursive mapped type that mirrors a schema's shape for per-field
+ * overrides. Dispatches on the schema kind in the same order as
+ * {@link InferSchemaValue} so the inferred override map tracks the
+ * inferred value shape.
+ *
+ * Exported so `<SchemaView>` and other consumers can type their
+ * `fields` prop against the same machinery `<SchemaComponent>` uses.
+ *
+ * @group Components
+ */
+type InferFields<T, Ref extends string | undefined> = IsSwagger2Doc<T> extends true ? __SchemaInferenceFellBack : T extends z.ZodType ? FieldOverrides<z.infer<T>> : T extends {
+  openapi: unknown;
+} ? Ref extends string ? FieldOverrides<ResolveOpenAPIRef<T & Record<string, unknown>, Ref>> : Record<string, FieldOverride> : T extends object ? unknown extends FromJSONSchema<T> ? Record<string, FieldOverride> : FieldOverrides<FromJSONSchema<T>> : Record<string, FieldOverride>;
+/**
+ * Infer the data type carried by the schema input.
+ *
+ * Mirrors {@link InferFields}'s dispatch order: Zod schema → `z.infer`,
+ * OpenAPI doc + ref → `ResolveOpenAPIRef`, plain JSON Schema object →
+ * `FromJSONSchema`, everything else → `unknown`. The `Mode` parameter
+ * is plumbed through to `FromJSONSchema` / `ResolveOpenAPIRef` so
+ * `readOnly` / `writeOnly` keywords participate in the inferred
+ * object shape — `"output"` for the rendered value, `"input"` for the
+ * `onChange` argument.
+ *
+ * When the schema's value type cannot be statically determined (e.g.
+ * a runtime `Record<string, unknown>` JSON Schema, or an OpenAPI doc
+ * without a ref), the result falls back to `unknown` so callers can
+ * still supply arbitrary values.
+ */
+type InferSchemaValue<T, Ref extends string | undefined, Mode extends FromJSONSchemaMode> = IsSwagger2Doc<T> extends true ? __SchemaInferenceFellBack : T extends z.ZodType ? Mode extends "input" ? z.input<T> : z.output<T> : T extends {
+  openapi: unknown;
+} ? Ref extends string ? ResolveOpenAPIRef<T & Record<string, unknown>, Ref, [], Mode> : unknown : T extends object ? FromJSONSchema<T, Record<string, never>, [], Mode> | (unknown extends FromJSONSchema<T> ? unknown : never) extends infer V ? V : unknown : unknown;
+/**
+ * Narrow an inferred value type to the sub-shape at `P`, or return
+ * the original value type when `P` is `undefined` (no path supplied).
+ */
+type NarrowAtPath<V, P extends string | undefined> = P extends string ? TypeAtPath<V, P> : V;
+/**
+ * Public alias mapping a schema input to the rendered value type.
+ *
+ * Picks the OUTPUT side (server → client) of every transform / pipe /
+ * codec. For an `<SchemaComponent io="output">` or `<SchemaView
+ * io="output">` (both defaults), this is the inferred shape of
+ * `value` and the parameter of `onChange`.
+ */
+type InferredOutputValue<T, Ref extends string | undefined = undefined, P extends string | undefined = undefined> = NarrowAtPath<InferSchemaValue<T, Ref, "output">, P>;
+/**
+ * Companion to {@link InferredOutputValue} for `"input"`-mode shapes.
+ *
+ * Picks the INPUT side (client → server) of every transform / pipe /
+ * codec. Surfaces as the inferred shape of `value` / `onChange` when
+ * a consumer renders `<SchemaComponent io="input">`. For JSON Schema
+ * inputs with `readOnly`/`writeOnly` annotations, the INPUT mode
+ * omits properties marked `readOnly: true`.
+ */
+type InferredInputValue<T, Ref extends string | undefined = undefined, P extends string | undefined = undefined> = NarrowAtPath<InferSchemaValue<T, Ref, "input">, P>;
+/**
+ * Resolve the schema-driven value type for either I/O direction.
+ *
+ * Thin convenience over {@link InferredOutputValue} /
+ * {@link InferredInputValue} so consumers that decide between the
+ * two at the type level (e.g. a generic wrapper component) can pass
+ * the chosen direction as a type argument rather than branch on it
+ * with conditional types. Falls back to `unknown` when the schema's
+ * value type cannot be statically inferred, identical to the
+ * underlying helpers.
+ */
+type InferredValue<T, Ref extends string | undefined = undefined, P extends string | undefined = undefined, Mode extends SchemaIoSide = "output"> = NarrowAtPath<InferSchemaValue<T, Ref, Mode>, P>;
+//#endregion
+export { InferredValue as a, InferredOutputValue as i, InferSchemaValue as n, InferredInputValue as r, InferFields as t };

package/dist/{limits-DswmqWuy.d.mts → limits-x4OiyJxh.d.mts}

@@ -24,6 +24,11 @@ declare const MAX_REF_DEPTH: MaxRefDepth;
  * Maximum number of `$ref` hops permitted when walking a chain of
  * OpenAPI Path Item Object references. Beyond this a
  * `path-item-ref-too-deep` diagnostic is emitted and resolution stops.
+ *
+ * Also the default `maxHops` for the generic `resolveRefChain` helper
+ * in `core/refChain.ts`, so every ref-chain walker — Path Item refs,
+ * Parameter / Response refs, Reference Object chains, etc. — shares
+ * the same hop cap.
  */
 declare const MAX_PATH_ITEM_REF_HOPS = 8;
 //#endregion