schema-components 1.23.0 → 1.26.0

package/dist/react/SchemaView.d.mts

@@ -1,37 +1,40 @@
 import { w as SchemaMeta } from "../types-BTB73MB8.mjs";
-import { t as Diagnostic } from "../diagnostics-BS2kaUyE.mjs";
-import { r as ComponentResolver } from "../renderer-CXJ8y0qw.mjs";
+import { t as Diagnostic } from "../diagnostics-Cbwak-ZX.mjs";
+import { i as SchemaIoSide } from "../adapter-MiEFkRVV.mjs";
+import { r as ComponentResolver } from "../renderer-Ul9taFYp.mjs";
 import { RejectUnrepresentableZod } from "../core/typeInference.mjs";
-import { WidgetMap } from "./SchemaComponent.mjs";
+import { InferredValue, WidgetMap } from "./SchemaComponent.mjs";
 import { ReactNode } from "react";
 
 //#region src/react/SchemaView.d.ts
-interface SchemaViewProps<T = unknown, Ref extends string | undefined = undefined> {
+interface SchemaViewProps<T = unknown, Ref extends string | undefined = undefined, Mode extends SchemaIoSide = "output"> {
   /**
    * Zod schema, JSON Schema object, or OpenAPI document.
    *
    * Subject to the same compile-time rejection of unrepresentable
-   * Zod 4 types as {@link SchemaComponentProps.schema} — see
+   * Zod 4 types as the `schema` prop on `<SchemaComponent>` — see
    * {@link RejectUnrepresentableZod}.
    */
   schema: RejectUnrepresentableZod<T>;
   /** For OpenAPI: a ref string like "#/components/schemas/User". */
   ref?: Ref;
   /**
-   * Current value to render.
-   *
-   * TYPE BOUNDARY NOTE: mirrors `SchemaComponentProps.value` — kept
-   * as `unknown` so the same boundary holds for both the editable
-   * (`SchemaComponent`) and read-only (`SchemaView`) entry points.
-   * The {@link InferredOutputValue} alias is the recommended way
-   * for callers to narrow on the consumer side.
-   *
-   * TODO(round7-integration): promote to
-   * `InferSchemaValue<T, Ref, "output">` alongside the matching
-   * `SchemaComponent` change. See the type-boundary note on
-   * `SchemaComponentProps.value` for the migration coordination.
+   * Which side of every transform / pipe / codec to render. Mirrors
+   * `<SchemaComponent io>`. Defaults to `"output"` — the inferred
+   * shape consumers receive from the server. Switch to `"input"`
+   * to render the INPUT side (omits `readOnly` properties for
+   * JSON Schema inputs, picks the input half of a `z.codec(...)`).
+   * Has no effect for plain JSON Schema or OpenAPI inputs without
+   * codec/transform constructs.
+   */
+  io?: Mode;
+  /**
+   * Current value to render. Typed against `InferSchemaValue<T,
+   * Ref, Mode>` so the prop tracks the schema's inferred shape for
+   * the chosen `io` direction. Falls back to `unknown` for runtime
+   * schemas where the value type cannot be statically inferred.
    */
-  value?: unknown;
+  value?: InferredValue<T, Ref, undefined, Mode>;
   /** Per-field meta overrides. */
   fields?: Record<string, unknown>;
   /** Meta overrides applied to the root schema. */
@@ -64,9 +67,10 @@ interface SchemaViewProps<T = unknown, Ref extends string | undefined = undefine
  * Always renders in read-only mode. For editable forms, use
  * `<SchemaComponent>` with `"use client"`.
  */
-declare function SchemaView<T = unknown, Ref extends string | undefined = undefined>({
+declare function SchemaView<T = unknown, Ref extends string | undefined = undefined, Mode extends SchemaIoSide = "output">({
   schema: schemaInput,
   ref: refInput,
+  io,
   value,
   fields,
   meta: componentMeta,
@@ -76,6 +80,6 @@ declare function SchemaView<T = unknown, Ref extends string | undefined = undefi
   onDiagnostic,
   strict,
   idPrefix
-}: SchemaViewProps<T, Ref>): ReactNode;
+}: SchemaViewProps<T, Ref, Mode>): ReactNode;
 //#endregion
 export { SchemaView, SchemaViewProps };

package/dist/react/SchemaView.mjs

@@ -5,8 +5,8 @@ import { buildRenderProps, getRenderFunction, mergeResolvers } from "../core/ren
 import { walk } from "../core/walker.mjs";
 import { headlessResolver } from "./headless.mjs";
 import { joinPath, sanitisePrefix } from "./SchemaComponent.mjs";
-import { jsx } from "react/jsx-runtime";
 import { createElement, isValidElement, useId } from "react";
+import { jsx } from "react/jsx-runtime";
 //#region src/react/SchemaView.tsx
 /**
 * React Server Component for read-only schema rendering.
@@ -42,7 +42,7 @@ import { createElement, isValidElement, useId } from "react";
 * Always renders in read-only mode. For editable forms, use
 * `<SchemaComponent>` with `"use client"`.
 */
-function SchemaView({ schema: schemaInput, ref: refInput, value, fields, meta: componentMeta, description, resolver, widgets, onDiagnostic, strict, idPrefix }) {
+function SchemaView({ schema: schemaInput, ref: refInput, io, value, fields, meta: componentMeta, description, resolver, widgets, onDiagnostic, strict, idPrefix }) {
 	const generatedId = useId();
 	const rootPath = idPrefix ?? sanitisePrefix(generatedId);
 	const mergedMeta = {
@@ -58,7 +58,10 @@ function SchemaView({ schema: schemaInput, ref: refInput, value, fields, meta: c
 	let rootMeta;
 	let rootDocument;
 	try {
-		const normalised = normaliseSchema(schemaInput, refInput, diagnostics !== void 0 ? { diagnostics } : void 0);
+		const normalised = normaliseSchema(schemaInput, refInput, diagnostics !== void 0 || io !== void 0 ? {
+			...diagnostics !== void 0 ? { diagnostics } : {},
+			...io !== void 0 ? { io } : {}
+		} : void 0);
 		jsonSchema = normalised.jsonSchema;
 		rootMeta = normalised.rootMeta;
 		rootDocument = normalised.rootDocument;

package/dist/react/headless.d.mts

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

package/dist/react/headlessRenderers.d.mts

@@ -1,5 +1,5 @@
 import { j as WalkedField } from "../types-BTB73MB8.mjs";
-import { l as RenderProps } from "../renderer-CXJ8y0qw.mjs";
+import { l as RenderProps } from "../renderer-Ul9taFYp.mjs";
 import { ReactNode } from "react";
 
 //#region src/react/headlessRenderers.d.ts

package/dist/react/headlessRenderers.mjs

@@ -7,8 +7,8 @@ import { fieldDomId, panelIdFor, tabIdFor } from "../core/idPath.mjs";
 import { matchUnionOption, resolveDiscriminatedActive } from "../core/unionMatch.mjs";
 import { displayJsonValue } from "../core/walkBuilders.mjs";
 import { buildAriaAttrs } from "./a11y.mjs";
-import { jsx, jsxs } from "react/jsx-runtime";
 import { isValidElement, useCallback, useEffect, useRef } from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
 //#region src/react/headlessRenderers.tsx
 /**
 * Headless renderer functions — one per schema type.

package/dist/{ref-DjLEKa_E.d.mts → ref-TdeMfaV_.d.mts}

@@ -1,4 +1,4 @@
-import { i as DiagnosticsOptions } from "./diagnostics-BS2kaUyE.mjs";
+import { i as DiagnosticsOptions } from "./diagnostics-Cbwak-ZX.mjs";
 
 //#region src/core/ref.d.ts
 /**

package/dist/themes/mantine.d.mts

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

package/dist/themes/mui.d.mts

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

package/dist/themes/mui.mjs

@@ -2,8 +2,8 @@ import { isObject } from "../core/guards.mjs";
 import { sortFieldsByOrder } from "../core/fieldOrder.mjs";
 import { inputId, toReactNode } from "../react/headlessRenderers.mjs";
 import { headlessResolver } from "../react/headless.mjs";
-import { jsx, jsxs } from "react/jsx-runtime";
 import { isValidElement } from "react";
+import { jsx, jsxs } from "react/jsx-runtime";
 //#region src/themes/mui.tsx
 function ariaRequired(tree) {
 	return { required: tree.isOptional === false };

package/dist/themes/radix.d.mts

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

package/dist/themes/shadcn.d.mts

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

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "schema-components",
-    "version": "1.23.0",
+    "version": "1.26.0",
     "description": "React components that render UI from Zod schemas, JSON Schema, and OpenAPI documents",
     "type": "module",
     "exports": {
@@ -40,6 +40,7 @@
         "_test:e2e": "vitest run --project=e2e",
         "_test:coverage": "vitest run --project=unit --coverage",
         "_build": "tsdown && cp src/html/styles.css dist/html/styles.css",
+        "_docs": "typedoc",
         "typecheck": "turbo run _typecheck",
         "lint": "turbo run _lint",
         "lint:fix": "turbo run _lint:fix",
@@ -47,7 +48,8 @@
         "test:coverage": "turbo run _test:coverage",
         "check": "turbo run _check",
         "validate": "turbo run _validate",
-        "build": "turbo run _build"
+        "build": "turbo run _build",
+        "docs": "turbo run _docs"
     },
     "keywords": [
         "react",
@@ -91,6 +93,8 @@
         "react-dom": "19.2.6",
         "tsdown": "0.22.0",
         "tslib": "2.8.1",
+        "typedoc": "0.28.19",
+        "typedoc-plugin-missing-exports": "4.1.3",
         "typescript": "6.0.3",
         "typescript-eslint": "8.59.2",
         "vitest": "4.1.5",