schema-components 3.3.0 → 3.5.0

package/dist/{SchemaComponent-CRgCVDhz.d.mts → SchemaComponent-BWl1psB0.d.mts}

@@ -1,4 +1,4 @@
-import { j as WalkedField, w as SchemaMeta } from "./types-BBQaEPfE.mjs";
+import { w as SchemaMeta } from "./types-BBQaEPfE.mjs";
 import { t as Diagnostic } from "./diagnostics-mftUZI7c.mjs";
 import { r as SchemaIoSide } from "./adapter-ktQaheWB.mjs";
 import { d as WidgetMap, i as ComponentResolver, u as RenderProps } from "./renderer-ab9E52Bp.mjs";
@@ -215,16 +215,9 @@ declare function sanitisePrefix(value: string): string;
  * resolver / headless pipeline. Used internally by
  * {@link SchemaComponent} and {@link SchemaField}, exported so other
  * React-side components (e.g. the OpenAPI renderers) can dispatch
- * into the same fallback chain.
- *
- * Thin React-flavoured wrapper around the framework-agnostic
- * `dispatchRenderField` (from `core/renderField`): it constructs a
- * React-shaped `DispatchConfig` (widget lookup against the
- * instance → context → global chain, recursion sentinel as a React
- * `<fieldset>`, fallback as a `<span>`-wrapped value) and forwards
- * the call.
+ * into the same fallback chain. Implementation lives in `./renderField.tsx`;
+ * re-exported here for the public `react/SchemaComponent` entry point.
  */
-declare function renderField(tree: WalkedField, value: unknown, onChange: (v: unknown) => void, userResolver: ComponentResolver | undefined, renderChild: (tree: WalkedField, value: unknown, onChange: (v: unknown) => void, pathSuffix?: string) => ReactNode, path: string, instanceWidgets?: WidgetMap, contextWidgets?: WidgetMap, depth?: number): ReactNode;
 /**
  * Infer the schema's output type for SchemaField path inference.
  */
@@ -286,4 +279,4 @@ declare function SchemaField<T = unknown, SchemaRef extends string | undefined =
   onValidationError
 }: SchemaFieldProps<T, SchemaRef, P>): ReactNode;
 //#endregion
-export { SchemaProvider as a, registerWidget as c, SchemaFieldProps as i, renderField as l, SchemaComponentProps as n, __clearGlobalWidgets as o, SchemaField as r, joinPath as s, SchemaComponent as t, sanitisePrefix as u };
+export { SchemaProvider as a, registerWidget as c, SchemaFieldProps as i, sanitisePrefix as l, SchemaComponentProps as n, __clearGlobalWidgets as o, SchemaField as r, joinPath as s, SchemaComponent as t };

package/dist/core/idPath.d.mts

@@ -80,5 +80,32 @@ declare function panelIdFor(path: string): string;
  * `id` across all renderers.
  */
 declare function tabIdFor(path: string, index: number): string;
+/**
+ * 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.
+ *
+ * Bracketed array indices like `[0]` append directly so `tags` + `[0]`
+ * becomes `tags[0]` rather than `tags.[0]` — matching the canonical form
+ * used by `core/fieldPath.ts` `resolvePath`, which already parses bracket
+ * notation when navigating WalkedField trees.
+ *
+ * This is the single authoritative implementation. The copies in
+ * `react/SchemaComponent.tsx`, `html/a11y.ts`, `solid/SchemaComponent.tsx`,
+ * and `vue/idPrefix.ts` are kept for backward compatibility but delegate
+ * here.
+ */
+declare function joinPath(parent: string, suffix: string | undefined): string;
+/**
+ * Normalise a framework `useId()`-style value into a DOM-id-safe prefix.
+ * Framework `useId` implementations often return values containing `:` or
+ * other characters that are invalid in CSS selectors. This function replaces
+ * any run of non-alphanumeric characters with a single hyphen and trims
+ * leading/trailing hyphens.
+ *
+ * Throws when the sanitised result is empty so callers receive an actionable
+ * error rather than a silent empty-string id.
+ */
+declare function sanitisePrefix(value: string): string;
 //#endregion
-export { fieldDomId, hintIdFor, normaliseIdSegment, panelIdFor, tabIdFor };
+export { fieldDomId, hintIdFor, joinPath, normaliseIdSegment, panelIdFor, sanitisePrefix, tabIdFor };

package/dist/core/idPath.mjs

@@ -134,5 +134,41 @@ function panelIdFor(path) {
 function tabIdFor(path, index) {
 	return `${fieldDomId(path)}-tab-${String(index)}`;
 }
+/**
+* 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.
+*
+* Bracketed array indices like `[0]` append directly so `tags` + `[0]`
+* becomes `tags[0]` rather than `tags.[0]` — matching the canonical form
+* used by `core/fieldPath.ts` `resolvePath`, which already parses bracket
+* notation when navigating WalkedField trees.
+*
+* This is the single authoritative implementation. The copies in
+* `react/SchemaComponent.tsx`, `html/a11y.ts`, `solid/SchemaComponent.tsx`,
+* and `vue/idPrefix.ts` are kept for backward compatibility but delegate
+* here.
+*/
+function joinPath(parent, suffix) {
+	if (suffix === void 0 || suffix.length === 0) return parent;
+	if (parent.length === 0) return suffix;
+	if (suffix.startsWith("[")) return `${parent}${suffix}`;
+	return `${parent}.${suffix}`;
+}
+/**
+* Normalise a framework `useId()`-style value into a DOM-id-safe prefix.
+* Framework `useId` implementations often return values containing `:` or
+* other characters that are invalid in CSS selectors. This function replaces
+* any run of non-alphanumeric characters with a single hyphen and trims
+* leading/trailing hyphens.
+*
+* Throws when the sanitised result is empty so callers receive an actionable
+* error rather than a silent empty-string id.
+*/
+function sanitisePrefix(value) {
+	const sanitised = value.replace(/[^a-zA-Z0-9_]+/g, "-").replace(/^-+|-+$/g, "");
+	if (sanitised.length === 0) throw new Error(`Cannot derive a DOM-safe id prefix from "${value}". Pass an explicit idPrefix prop.`);
+	return sanitised;
+}
 //#endregion
-export { fieldDomId, hintIdFor, normaliseIdSegment, panelIdFor, tabIdFor };
+export { fieldDomId, hintIdFor, joinPath, normaliseIdSegment, panelIdFor, sanitisePrefix, tabIdFor };

package/dist/openapi/components.mjs

@@ -2,13 +2,14 @@ import { isObject, toRecordOrUndefined } from "../core/guards.mjs";
 import { emitDiagnostic } from "../core/diagnostics.mjs";
 import { isSafeHyperlink } from "../core/uri.mjs";
 import { extractRootMetaFromJson } from "../core/adapter.mjs";
+import { joinPath, sanitisePrefix } from "../core/idPath.mjs";
 import { walk } from "../core/walker.mjs";
 import { ApiCallbacks } from "./ApiCallbacks.mjs";
 import { ApiLinks } from "./ApiLinks.mjs";
 import { ApiResponseHeaders } from "./ApiResponseHeaders.mjs";
 import { ApiSecurity } from "./ApiSecurity.mjs";
 import { extractExternalDocs, extractLinks, extractSecurityRequirements, extractSecuritySchemes, extractXmlInfo, listCallbacks, listWebhooks } from "./parser.mjs";
-import { joinPath, renderField, sanitisePrefix } from "../react/SchemaComponent.mjs";
+import { renderField } from "../react/renderField.mjs";
 import { getParsed, resolveOperation, resolveParameters, resolveRequestBody, resolveResponse, toDoc } from "./resolve.mjs";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import { useId } from "react";

package/dist/preact/SchemaComponent.d.mts

@@ -1,3 +1,3 @@
 import { a as InferredValue, i as InferredOutputValue, r as InferredInputValue, t as InferFields } from "../inferValue-eAnh50EM.mjs";
-import { a as SchemaProvider, c as registerWidget, i as SchemaFieldProps, n as SchemaComponentProps, r as SchemaField, t as SchemaComponent } from "../SchemaComponent-CRgCVDhz.mjs";
+import { a as SchemaProvider, c as registerWidget, i as SchemaFieldProps, n as SchemaComponentProps, r as SchemaField, t as SchemaComponent } from "../SchemaComponent-BWl1psB0.mjs";
 export { type InferFields, type InferredInputValue, type InferredOutputValue, type InferredValue, SchemaComponent, type SchemaComponentProps, SchemaField, type SchemaFieldProps, SchemaProvider, registerWidget };

package/dist/react/SchemaComponent.d.mts

@@ -1,3 +1,3 @@
 import { a as InferredValue, i as InferredOutputValue, r as InferredInputValue, t as InferFields } from "../inferValue-eAnh50EM.mjs";
-import { a as SchemaProvider, c as registerWidget, i as SchemaFieldProps, l as renderField, n as SchemaComponentProps, o as __clearGlobalWidgets, r as SchemaField, s as joinPath, t as SchemaComponent, u as sanitisePrefix } from "../SchemaComponent-CRgCVDhz.mjs";
-export { InferFields, InferredInputValue, InferredOutputValue, InferredValue, SchemaComponent, SchemaComponentProps, SchemaField, SchemaFieldProps, SchemaProvider, __clearGlobalWidgets, joinPath, registerWidget, renderField, sanitisePrefix };
+import { a as SchemaProvider, c as registerWidget, i as SchemaFieldProps, l as sanitisePrefix, n as SchemaComponentProps, o as __clearGlobalWidgets, r as SchemaField, s as joinPath, t as SchemaComponent } from "../SchemaComponent-BWl1psB0.mjs";
+export { InferFields, InferredInputValue, InferredOutputValue, InferredValue, SchemaComponent, SchemaComponentProps, SchemaField, SchemaFieldProps, SchemaProvider, __clearGlobalWidgets, joinPath, registerWidget, sanitisePrefix };

package/dist/react/SchemaComponent.mjs

@@ -3,13 +3,11 @@ import { isObject, toRecordOrUndefined } from "../core/guards.mjs";
 import { SchemaFieldError, SchemaNormalisationError } from "../core/errors.mjs";
 import { isCodecSchema, normaliseSchema } from "../core/adapter.mjs";
 import { resolvePath, resolveValue, setNestedValue } from "../core/fieldPath.mjs";
-import { dispatchRenderField } from "../core/renderField.mjs";
-import { buildRenderProps, getRenderFunction, mergeResolvers } from "../core/renderer.mjs";
 import { walk } from "../core/walker.mjs";
-import { headlessResolver } from "./headless.mjs";
+import { globalWidgets, renderField } from "./renderField.mjs";
 import { z } from "zod";
-import { jsx, jsxs } from "react/jsx-runtime";
-import { createContext, isValidElement, useCallback, useContext, useId, useMemo } from "react";
+import { jsx } from "react/jsx-runtime";
+import { createContext, useCallback, useContext, useId, useMemo } from "react";
 //#region src/react/SchemaComponent.tsx
 /**
 * <SchemaComponent> — renders UI from Zod, JSON Schema, or OpenAPI schemas.
@@ -56,8 +54,6 @@ function SchemaProvider({ resolver, widgets, children }) {
 		})
 	});
 }
-/** Global widget registry — app-wide defaults. */
-const globalWidgets = /* @__PURE__ */ new Map();
 /**
 * Register a widget globally. The widget is resolved when a schema field
 * has `.meta({ component: name })`.
@@ -276,57 +272,6 @@ function runValidation(zodSchema, jsonSchema, value, io, onDiagnostic) {
 	}
 }
 /**
-* Render a single walked field through the resolved widget /
-* resolver / headless pipeline. Used internally by
-* {@link SchemaComponent} and {@link SchemaField}, exported so other
-* React-side components (e.g. the OpenAPI renderers) can dispatch
-* into the same fallback chain.
-*
-* Thin React-flavoured wrapper around the framework-agnostic
-* `dispatchRenderField` (from `core/renderField`): it constructs a
-* React-shaped `DispatchConfig` (widget lookup against the
-* instance → context → global chain, recursion sentinel as a React
-* `<fieldset>`, fallback as a `<span>`-wrapped value) and forwards
-* the call.
-*/
-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 the root path (derived from `idPrefix` or `useId()`) for the root field, and use renderChild's pathSuffix to derive child paths.");
-	return dispatchRenderField({
-		tree,
-		value,
-		path,
-		depth,
-		resolver: userResolver !== void 0 ? mergeResolvers(userResolver, headlessResolver) : headlessResolver,
-		config: {
-			buildProps: (fieldTree, fieldPath) => buildRenderProps(fieldTree, value, onChange, renderChild, fieldPath),
-			lookupRenderFn: (type, mergedResolver) => getRenderFunction(type, mergedResolver),
-			lookupWidget: (name) => instanceWidgets?.get(name) ?? contextWidgets?.get(name) ?? globalWidgets.get(name),
-			recursionSentinel: (fieldTree) => {
-				return /* @__PURE__ */ jsx("fieldset", { children: /* @__PURE__ */ jsxs("em", { children: [
-					"↻ ",
-					typeof fieldTree.meta.description === "string" ? fieldTree.meta.description : "schema",
-					" (recursive)"
-				] }) });
-			},
-			fallback: (_fieldTree, fieldValue) => {
-				if (fieldValue === void 0 || fieldValue === null) return /* @__PURE__ */ jsx("span", { children: "—" });
-				return /* @__PURE__ */ jsx("span", { children: typeof fieldValue === "string" ? fieldValue : JSON.stringify(fieldValue) });
-			},
-			coerceResult: (result, step) => {
-				if (step === "widget") {
-					if (result === void 0 || result === null) return void 0;
-					if (isValidElement(result)) return result;
-					if (typeof result === "string" || typeof result === "number") return result;
-					return null;
-				}
-				if (result === void 0 || result === null) return null;
-				if (isValidElement(result)) return result;
-				if (typeof result === "string" || typeof result === "number") return result;
-			}
-		}
-	});
-}
-/**
 * Render a single field from a schema by dot-separated `path`.
 *
 * Walks the full schema tree and resolves the field at the supplied
@@ -425,4 +370,4 @@ function isCallable(value) {
 	return typeof value === "function";
 }
 //#endregion
-export { SchemaComponent, SchemaField, SchemaProvider, __clearGlobalWidgets, joinPath, registerWidget, renderField, sanitisePrefix };
+export { SchemaComponent, SchemaField, SchemaProvider, __clearGlobalWidgets, joinPath, registerWidget, sanitisePrefix };

package/dist/react/headlessRenderers.mjs

@@ -74,13 +74,11 @@ function renderString(props) {
 		if (format === "email" && isSafeMailtoAddress(strValue)) return /* @__PURE__ */ jsx("a", {
 			href: `mailto:${strValue}`,
 			id,
-			"aria-readonly": "true",
 			children: strValue
 		});
 		if ((format === "uri" || format === "url") && isSafeHyperlink(strValue)) return /* @__PURE__ */ jsx("a", {
 			href: strValue,
 			id,
-			"aria-readonly": "true",
 			children: strValue
 		});
 		if (format === "date") return /* @__PURE__ */ jsx("span", {
@@ -573,6 +571,7 @@ function DiscriminatedUnionTabs({ options, optionLabels, activeIndex, path, disc
 		role: "tablist",
 		"aria-label": "Select variant",
 		"aria-orientation": "horizontal",
+		tabIndex: -1,
 		style: {
 			display: "flex",
 			gap: "0.25rem",

package/dist/react/renderField.d.mts

@@ -0,0 +1,33 @@
+import { j as WalkedField } from "../types-BBQaEPfE.mjs";
+import { d as WidgetMap, i as ComponentResolver, u as RenderProps } from "../renderer-ab9E52Bp.mjs";
+import { ReactNode } from "react";
+
+//#region src/react/renderField.d.ts
+/**
+ * Global widget registry — app-wide defaults.
+ *
+ * Exported so `react/SchemaComponent.tsx` can define `registerWidget` and
+ * `__clearGlobalWidgets` as direct exports (not re-exports, which the
+ * `custom/no-re-exports` rule bans in non-index files) while sharing the
+ * same Map with `renderField`.
+ *
+ * @internal — callers outside this module should use `registerWidget`.
+ */
+declare const globalWidgets: Map<string, (props: RenderProps) => unknown>;
+/**
+ * Render a single walked field through the resolved widget /
+ * resolver / headless pipeline. Used internally by
+ * {@link SchemaComponent} and {@link SchemaField}, exported so other
+ * React-side components (e.g. the OpenAPI renderers) can dispatch
+ * into the same fallback chain.
+ *
+ * Thin React-flavoured wrapper around the framework-agnostic
+ * `dispatchRenderField` (from `core/renderField`): it constructs a
+ * React-shaped `DispatchConfig` (widget lookup against the
+ * instance → context → global chain, recursion sentinel as a React
+ * `<fieldset>`, fallback as a `<span>`-wrapped value) and forwards
+ * the call.
+ */
+declare function renderField(tree: WalkedField, value: unknown, onChange: (v: unknown) => void, userResolver: ComponentResolver | undefined, renderChild: (tree: WalkedField, value: unknown, onChange: (v: unknown) => void, pathSuffix?: string) => ReactNode, path: string, instanceWidgets?: WidgetMap, contextWidgets?: WidgetMap, depth?: number): ReactNode;
+//#endregion
+export { globalWidgets, renderField };

package/dist/react/renderField.mjs

@@ -0,0 +1,79 @@
+import { dispatchRenderField } from "../core/renderField.mjs";
+import { buildRenderProps, getRenderFunction, mergeResolvers } from "../core/renderer.mjs";
+import { headlessResolver } from "./headless.mjs";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { isValidElement } from "react";
+//#region src/react/renderField.tsx
+/**
+* React-side `renderField` dispatcher and global widget registry.
+*
+* Extracted from `react/SchemaComponent.tsx` so that `openapi/components.tsx`
+* can import the dispatcher without depending on the full SchemaComponent
+* module (which includes React context, hooks, and the component tree). The
+* public API at `react/SchemaComponent` re-exports everything here so
+* consumers importing via the historic path continue to work unchanged.
+*/
+/**
+* Global widget registry — app-wide defaults.
+*
+* Exported so `react/SchemaComponent.tsx` can define `registerWidget` and
+* `__clearGlobalWidgets` as direct exports (not re-exports, which the
+* `custom/no-re-exports` rule bans in non-index files) while sharing the
+* same Map with `renderField`.
+*
+* @internal — callers outside this module should use `registerWidget`.
+*/
+const globalWidgets = /* @__PURE__ */ new Map();
+/**
+* Render a single walked field through the resolved widget /
+* resolver / headless pipeline. Used internally by
+* {@link SchemaComponent} and {@link SchemaField}, exported so other
+* React-side components (e.g. the OpenAPI renderers) can dispatch
+* into the same fallback chain.
+*
+* Thin React-flavoured wrapper around the framework-agnostic
+* `dispatchRenderField` (from `core/renderField`): it constructs a
+* React-shaped `DispatchConfig` (widget lookup against the
+* instance → context → global chain, recursion sentinel as a React
+* `<fieldset>`, fallback as a `<span>`-wrapped value) and forwards
+* the call.
+*/
+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 the root path (derived from `idPrefix` or `useId()`) for the root field, and use renderChild's pathSuffix to derive child paths.");
+	return dispatchRenderField({
+		tree,
+		value,
+		path,
+		depth,
+		resolver: userResolver !== void 0 ? mergeResolvers(userResolver, headlessResolver) : headlessResolver,
+		config: {
+			buildProps: (fieldTree, fieldPath) => buildRenderProps(fieldTree, value, onChange, renderChild, fieldPath),
+			lookupRenderFn: (type, mergedResolver) => getRenderFunction(type, mergedResolver),
+			lookupWidget: (name) => instanceWidgets?.get(name) ?? contextWidgets?.get(name) ?? globalWidgets.get(name),
+			recursionSentinel: (fieldTree) => {
+				return /* @__PURE__ */ jsx("fieldset", { children: /* @__PURE__ */ jsxs("em", { children: [
+					"↻ ",
+					typeof fieldTree.meta.description === "string" ? fieldTree.meta.description : "schema",
+					" (recursive)"
+				] }) });
+			},
+			fallback: (_fieldTree, fieldValue) => {
+				if (fieldValue === void 0 || fieldValue === null) return /* @__PURE__ */ jsx("span", { children: "—" });
+				return /* @__PURE__ */ jsx("span", { children: typeof fieldValue === "string" ? fieldValue : JSON.stringify(fieldValue) });
+			},
+			coerceResult: (result, step) => {
+				if (step === "widget") {
+					if (result === void 0 || result === null) return void 0;
+					if (isValidElement(result)) return result;
+					if (typeof result === "string" || typeof result === "number") return result;
+					return null;
+				}
+				if (result === void 0 || result === null) return null;
+				if (isValidElement(result)) return result;
+				if (typeof result === "string" || typeof result === "number") return result;
+			}
+		}
+	});
+}
+//#endregion
+export { globalWidgets, renderField };

package/dist/solid/renderers.mjs

@@ -80,13 +80,11 @@ function renderString(props) {
 		if (format === "email" && isSafeMailtoAddress(strValue)) return /* @__PURE__ */ jsx("a", {
 			href: `mailto:${strValue}`,
 			id,
-			"aria-readonly": "true",
 			children: strValue
 		});
 		if ((format === "uri" || format === "url") && isSafeHyperlink(strValue)) return /* @__PURE__ */ jsx("a", {
 			href: strValue,
 			id,
-			"aria-readonly": "true",
 			children: strValue
 		});
 		if (format === "date") return /* @__PURE__ */ jsx("span", {
@@ -608,6 +606,7 @@ function DiscriminatedUnionTabs(props) {
 		role: "tablist",
 		"aria-label": "Select variant",
 		"aria-orientation": "horizontal",
+		tabIndex: -1,
 		style: {
 			display: "flex",
 			gap: "0.25rem",

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "schema-components",
-    "version": "3.3.0",
+    "version": "3.5.0",
     "description": "React components that render UI from Zod schemas, JSON Schema, and OpenAPI documents",
     "type": "module",
     "exports": {
@@ -73,7 +73,6 @@
         "_build": "tsdown && cp src/html/styles.css dist/html/styles.css",
         "_typedoc": "typedoc",
         "_api-urls": "node scripts/build-api-urls.mjs",
-        "_readme": "node scripts/build-readme-inventory.mjs",
         "typecheck": "turbo run _typecheck",
         "lint": "turbo run _lint",
         "lint:fix": "turbo run _lint:fix",
@@ -87,8 +86,7 @@
         "validate": "turbo run _validate",
         "build": "turbo run _build",
         "typedoc": "turbo run _typedoc",
-        "api-urls": "turbo run _api-urls",
-        "readme": "turbo run _readme"
+        "api-urls": "turbo run _api-urls"
     },
     "keywords": [
         "react",