schema-components 1.5.0 → 1.6.0

package/CHANGELOG.md

@@ -1,3 +1,19 @@
+## [1.6.0](https://github.com/Mearman/schema-components/compare/v1.5.1...v1.6.0) (2026-05-14)
+
+### Features
+
+* add per-field onValidationError and writeOnly tests ([bc65589](https://github.com/Mearman/schema-components/commit/bc655893601b8e015dd3c717eccc9bf9dffbbb42))
+
+### Tests
+
+* add writeOnly behaviour tests across all renderers ([abfb293](https://github.com/Mearman/schema-components/commit/abfb293498efc4d4095dec072fd1e5a9c3239035))
+
+## [1.5.1](https://github.com/Mearman/schema-components/compare/v1.5.0...v1.5.1) (2026-05-14)
+
+### Bug Fixes
+
+* blank writeOnly values in boolean and number renderers ([b46ecac](https://github.com/Mearman/schema-components/commit/b46ecac8d997fd4b875d6090d5374cded1143e5d))
+
 ## [1.5.0](https://github.com/Mearman/schema-components/compare/v1.4.0...v1.5.0) (2026-05-14)
 
 ### Features

package/dist/core/adapter.d.mts

@@ -1,4 +1,4 @@
-import { l as JsonObject, m as SchemaMeta } from "../types-DDCD6Xnx.mjs";
+import { l as JsonObject, m as SchemaMeta } from "../types-CnlV7bBK.mjs";
 
 //#region src/core/adapter.d.ts
 type SchemaInput = Record<string, unknown>;

package/dist/core/renderer.d.mts

@@ -1,2 +1,2 @@
-import { A as mergeResolvers, C as HtmlResolver, D as getHtmlRenderFn, E as RenderProps, O as getRenderFunction, S as HtmlRenderProps, T as RenderFunction, b as ComponentResolver, j as typeToKey, k as mergeHtmlResolvers, w as RESOLVER_KEYS, x as HtmlRenderFunction, y as BaseFieldProps } from "../types-DDCD6Xnx.mjs";
+import { A as mergeResolvers, C as HtmlResolver, D as getHtmlRenderFn, E as RenderProps, O as getRenderFunction, S as HtmlRenderProps, T as RenderFunction, b as ComponentResolver, j as typeToKey, k as mergeHtmlResolvers, w as RESOLVER_KEYS, x as HtmlRenderFunction, y as BaseFieldProps } from "../types-CnlV7bBK.mjs";
 export { BaseFieldProps, ComponentResolver, HtmlRenderFunction, HtmlRenderProps, HtmlResolver, RESOLVER_KEYS, RenderFunction, RenderProps, getHtmlRenderFn, getRenderFunction, mergeHtmlResolvers, mergeResolvers, typeToKey };

package/dist/core/types.d.mts

@@ -1,3 +1,3 @@
-import { C as HtmlResolver, E as RenderProps, S as HtmlRenderProps, T as RenderFunction, _ as WalkedField, a as FromJSONSchema, b as ComponentResolver, c as InferResponseFields, d as OpenAPIResponseType, f as PathOfType, g as TypeAtPath, h as SchemaType, i as FieldOverrides, l as JsonObject, m as SchemaMeta, n as FieldConstraints, o as InferParameterOverrides, p as ResolveOpenAPIRef, r as FieldOverride, s as InferRequestBodyFields, t as Editability, u as OpenAPIRequestBodyType, v as resolveEditability, x as HtmlRenderFunction, y as BaseFieldProps } from "../types-DDCD6Xnx.mjs";
+import { C as HtmlResolver, E as RenderProps, S as HtmlRenderProps, T as RenderFunction, _ as WalkedField, a as FromJSONSchema, b as ComponentResolver, c as InferResponseFields, d as OpenAPIResponseType, f as PathOfType, g as TypeAtPath, h as SchemaType, i as FieldOverrides, l as JsonObject, m as SchemaMeta, n as FieldConstraints, o as InferParameterOverrides, p as ResolveOpenAPIRef, r as FieldOverride, s as InferRequestBodyFields, t as Editability, u as OpenAPIRequestBodyType, v as resolveEditability, x as HtmlRenderFunction, y as BaseFieldProps } from "../types-CnlV7bBK.mjs";
 import { i as SchemaRenderError, n as SchemaFieldError, r as SchemaNormalisationError, t as SchemaError } from "../errors-DIKI2C78.mjs";
 export { BaseFieldProps, ComponentResolver, Editability, FieldConstraints, FieldOverride, FieldOverrides, FromJSONSchema, HtmlRenderFunction, HtmlRenderProps, HtmlResolver, InferParameterOverrides, InferRequestBodyFields, InferResponseFields, JsonObject, OpenAPIRequestBodyType, OpenAPIResponseType, PathOfType, RenderFunction, RenderProps, ResolveOpenAPIRef, SchemaError, SchemaFieldError, SchemaMeta, SchemaNormalisationError, SchemaRenderError, SchemaType, TypeAtPath, WalkedField, resolveEditability };

package/dist/core/walker.d.mts

@@ -1,4 +1,4 @@
-import { _ as WalkedField, m as SchemaMeta } from "../types-DDCD6Xnx.mjs";
+import { _ as WalkedField, m as SchemaMeta } from "../types-CnlV7bBK.mjs";
 
 //#region src/core/walker.d.ts
 interface WalkOptions {

package/dist/html/a11y.d.mts

@@ -1,4 +1,4 @@
-import { _ as WalkedField, n as FieldConstraints } from "../types-DDCD6Xnx.mjs";
+import { _ as WalkedField, n as FieldConstraints } from "../types-CnlV7bBK.mjs";
 import { HtmlAttributes, HtmlNode } from "./html.mjs";
 
 //#region src/html/a11y.d.ts

package/dist/html/renderToHtml.d.mts

@@ -1,4 +1,4 @@
-import { C as HtmlResolver, S as HtmlRenderProps, m as SchemaMeta, x as HtmlRenderFunction } from "../types-DDCD6Xnx.mjs";
+import { C as HtmlResolver, S as HtmlRenderProps, m as SchemaMeta, x as HtmlRenderFunction } from "../types-CnlV7bBK.mjs";
 
 //#region src/html/renderToHtml.d.ts
 interface RenderToHtmlOptions {

package/dist/html/renderToHtml.mjs

@@ -133,7 +133,7 @@ function renderBooleanEditable(props) {
 		type: "checkbox",
 		name: id
 	};
-	if (props.value === true) attrs.checked = true;
+	if (!props.writeOnly && props.value === true) attrs.checked = true;
 	Object.assign(attrs, ariaRequiredAttrs(props.tree));
 	Object.assign(attrs, ariaLabelAttrs(props.meta.description));
 	return h("input", attrs);

package/dist/openapi/components.d.mts

@@ -1,4 +1,4 @@
-import { c as InferResponseFields, m as SchemaMeta, o as InferParameterOverrides, r as FieldOverride, s as InferRequestBodyFields } from "../types-DDCD6Xnx.mjs";
+import { c as InferResponseFields, m as SchemaMeta, o as InferParameterOverrides, r as FieldOverride, s as InferRequestBodyFields } from "../types-CnlV7bBK.mjs";
 import { WidgetMap } from "../react/SchemaComponent.mjs";
 import { ReactNode } from "react";
 

package/dist/openapi/parser.d.mts

@@ -1,4 +1,4 @@
-import { l as JsonObject } from "../types-DDCD6Xnx.mjs";
+import { l as JsonObject } from "../types-CnlV7bBK.mjs";
 
 //#region src/openapi/parser.d.ts
 interface OpenApiDocument {

package/dist/react/SchemaComponent.d.mts

@@ -1,4 +1,4 @@
-import { E as RenderProps, _ as WalkedField, a as FromJSONSchema, b as ComponentResolver, f as PathOfType, i as FieldOverrides, m as SchemaMeta, p as ResolveOpenAPIRef, r as FieldOverride } from "../types-DDCD6Xnx.mjs";
+import { E as RenderProps, _ as WalkedField, a as FromJSONSchema, b as ComponentResolver, f as PathOfType, i as FieldOverrides, m as SchemaMeta, p as ResolveOpenAPIRef, r as FieldOverride } from "../types-CnlV7bBK.mjs";
 import { t as SchemaError } from "../errors-DIKI2C78.mjs";
 import { z } from "zod";
 import { ReactNode } from "react";

package/dist/react/SchemaComponent.mjs

@@ -1,5 +1,5 @@
 "use client";
-import { isObject, toRecord } from "../core/guards.mjs";
+import { isObject, toRecord, toRecordOrUndefined } from "../core/guards.mjs";
 import { normaliseSchema } from "../core/adapter.mjs";
 import { SchemaFieldError, SchemaNormalisationError, SchemaRenderError } from "../core/errors.mjs";
 import { getRenderFunction, mergeResolvers } from "../core/renderer.mjs";
@@ -79,14 +79,21 @@ function SchemaComponent({ schema: schemaInput, ref: refInput, value, onChange,
 		throw error;
 	}
 	const handleChange = useCallback((nextValue) => {
-		if (validate) runValidation(zodSchema, jsonSchema, nextValue, onValidationError);
+		if (validate) {
+			const error = runValidation(zodSchema, jsonSchema, nextValue);
+			if (error !== void 0) {
+				onValidationError?.(error);
+				dispatchFieldErrors(fields, error);
+			}
+		}
 		onChange?.(nextValue);
 	}, [
 		validate,
 		zodSchema,
 		jsonSchema,
 		onChange,
-		onValidationError
+		onValidationError,
+		fields
 	]);
 	const tree = walk(jsonSchema, {
 		componentMeta: mergedMeta,
@@ -99,15 +106,12 @@ function SchemaComponent({ schema: schemaInput, ref: refInput, value, onChange,
 	};
 	return renderField(tree, value ?? tree.defaultValue, handleChange, userResolver, renderChild, instanceWidgets, contextWidgets);
 }
-function runValidation(zodSchema, jsonSchema, value, onError) {
+function runValidation(zodSchema, jsonSchema, value) {
 	if (zodSchema !== void 0 && isObject(zodSchema)) {
 		const safeParseFn = zodSchema.safeParse;
 		if (isCallable(safeParseFn)) {
 			const result = safeParseFn(value);
-			if (isObject(result) && "success" in result && result.success !== true) {
-				onError?.(result.error);
-				return;
-			}
+			if (isObject(result) && "success" in result && result.success !== true) return result.error;
 			return;
 		}
 	}
@@ -116,7 +120,7 @@ function runValidation(zodSchema, jsonSchema, value, onError) {
 		const safeParseFn = parsed.safeParse;
 		if (isCallable(safeParseFn)) {
 			const result = safeParseFn(value);
-			if (isObject(result) && "success" in result && result.success !== true) onError?.(result.error);
+			if (isObject(result) && "success" in result && result.success !== true) return result.error;
 		}
 	}
 }
@@ -197,7 +201,8 @@ function SchemaField({ path, schema: schemaInput, ref: refInput, value, onChange
 	const handleChange = useCallback((nextFieldValue) => {
 		if (validate) {
 			const newRootValue = setNestedValue(value, path, nextFieldValue);
-			runValidation(zodSchema, jsonSchema, newRootValue, onValidationError);
+			const error = runValidation(zodSchema, jsonSchema, newRootValue);
+			if (error !== void 0) onValidationError?.(error);
 		}
 		const newRootValue = setNestedValue(value, path, nextFieldValue);
 		onChange?.(newRootValue);
@@ -280,6 +285,36 @@ function setNestedValue(root, path, leafValue) {
 	}
 	return result;
 }
+function isFieldErrorCallback(value) {
+	return typeof value === "function";
+}
+/**
+* Dispatch Zod errors to per-field onValidationError callbacks.
+* Walks the fields override tree and matches errors by path prefix.
+*/
+function dispatchFieldErrors(fields, error) {
+	if (fields === void 0 || !isObject(error)) return;
+	if (!("issues" in error)) return;
+	const issues = error.issues;
+	if (!Array.isArray(issues)) return;
+	const overrides = toRecordOrUndefined(fields);
+	if (overrides === void 0) return;
+	for (const [key, override] of Object.entries(overrides)) {
+		if (override === void 0 || typeof override !== "object") continue;
+		if (override === null) continue;
+		if (!("onValidationError" in override)) continue;
+		const fieldCallback = override.onValidationError;
+		if (typeof fieldCallback !== "function") continue;
+		const fieldErrors = issues.filter((issue) => {
+			if (!isObject(issue)) return false;
+			if (!("path" in issue)) return false;
+			const path = issue.path;
+			if (!Array.isArray(path)) return false;
+			return path[0] === key;
+		});
+		if (fieldErrors.length > 0 && isFieldErrorCallback(fieldCallback)) fieldCallback({ issues: fieldErrors });
+	}
+}
 function isCallable(value) {
 	return typeof value === "function";
 }

package/dist/react/SchemaView.d.mts

@@ -1,4 +1,4 @@
-import { b as ComponentResolver, m as SchemaMeta } from "../types-DDCD6Xnx.mjs";
+import { b as ComponentResolver, m as SchemaMeta } from "../types-CnlV7bBK.mjs";
 import { WidgetMap } from "./SchemaComponent.mjs";
 import { ReactNode } from "react";
 

package/dist/react/headless.d.mts

@@ -1,4 +1,4 @@
-import { b as ComponentResolver } from "../types-DDCD6Xnx.mjs";
+import { b as ComponentResolver } from "../types-CnlV7bBK.mjs";
 import { ReactNode } from "react";
 
 //#region src/react/headless.d.ts

package/dist/react/headless.mjs

@@ -200,7 +200,7 @@ function renderBoolean(props) {
 	return /* @__PURE__ */ jsx("input", {
 		id,
 		type: "checkbox",
-		checked: props.value === true,
+		checked: props.writeOnly ? false : props.value === true,
 		onChange: (e) => {
 			props.onChange(e.target.checked);
 		},

package/dist/themes/mui.d.mts

@@ -1,4 +1,4 @@
-import { b as ComponentResolver } from "../types-DDCD6Xnx.mjs";
+import { b as ComponentResolver } from "../types-CnlV7bBK.mjs";
 
 //#region src/themes/mui.d.ts
 /**

package/dist/themes/mui.mjs

@@ -45,7 +45,7 @@ function renderNumberInput(props) {
 	return /* @__PURE__ */ jsx(MuiTextField, {
 		label,
 		type: "number",
-		value: typeof props.value === "number" ? props.value : "",
+		value: props.writeOnly ? "" : typeof props.value === "number" ? props.value : "",
 		onChange: (e) => {
 			props.onChange(Number(e.target.value));
 		},
@@ -73,7 +73,7 @@ function renderBooleanInput(props) {
 	}
 	return /* @__PURE__ */ jsx(MuiFormControlLabel, {
 		control: /* @__PURE__ */ jsx(MuiCheckbox, {
-			checked: props.value === true,
+			checked: props.writeOnly ? false : props.value === true,
 			onChange: (e) => {
 				props.onChange(e.target.checked);
 			}

package/dist/themes/shadcn.d.mts

@@ -1,4 +1,4 @@
-import { b as ComponentResolver } from "../types-DDCD6Xnx.mjs";
+import { b as ComponentResolver } from "../types-CnlV7bBK.mjs";
 
 //#region src/themes/shadcn.d.ts
 declare const shadcnResolver: ComponentResolver;

package/dist/themes/shadcn.mjs

@@ -51,7 +51,7 @@ function renderNumberInput(props) {
 	return /* @__PURE__ */ jsx("input", {
 		type: "number",
 		className,
-		value: typeof props.value === "number" ? props.value : "",
+		value: props.writeOnly ? "" : typeof props.value === "number" ? props.value : "",
 		onChange: (e) => {
 			props.onChange(Number(e.target.value));
 		},
@@ -74,7 +74,7 @@ function renderBooleanInput(props) {
 	return /* @__PURE__ */ jsx("input", {
 		type: "checkbox",
 		className,
-		checked: props.value === true,
+		checked: props.writeOnly ? false : props.value === true,
 		onChange: (e) => {
 			props.onChange(e.target.checked);
 		}

package/dist/{types-DDCD6Xnx.d.mts → types-CnlV7bBK.d.mts}

@@ -166,14 +166,18 @@ type Editability = "presentation" | "input" | "editable";
 declare function resolveEditability(propertyMeta: SchemaMeta | undefined, componentMeta: SchemaMeta | undefined, rootMeta: SchemaMeta | undefined): Editability;
 /**
  * Recursive mapped type that mirrors a schema's shape for per-field
- * meta overrides. Each leaf is `Partial<SchemaMeta>`, objects recurse
- * and also accept their own `SchemaMeta`.
+ * overrides. Each leaf accepts schema meta overrides and an optional
+ * per-field validation error callback. Objects recurse and also accept
+ * their own overrides.
  */
-type FieldOverrides<T> = { [K in keyof T]?: T[K] extends object ? FieldOverrides<T[K]> & Partial<SchemaMeta> : Partial<SchemaMeta> };
+type FieldOverrides<T> = { [K in keyof T]?: T[K] extends object ? FieldOverrides<T[K]> & FieldOverride : FieldOverride };
 /**
- * Fallback type for runtime schemas (no compile-time shape).
+ * Per-field override. Extends SchemaMeta with a React-layer callback
+ * for per-field validation errors.
  */
-type FieldOverride = Partial<SchemaMeta>;
+type FieldOverride = Partial<SchemaMeta> & {
+  /** Called with the ZodError when this field fails validation. */onValidationError?: (error: unknown) => void;
+};
 type SchemaType = "string" | "number" | "boolean" | "null" | "enum" | "literal" | "object" | "array" | "record" | "union" | "discriminatedUnion" | "optional" | "nullable" | "default" | "readonly" | "pipe" | "lazy" | "file" | "unknown";
 interface WalkedField {
   type: SchemaType;

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "schema-components",
-    "version": "1.5.0",
+    "version": "1.6.0",
     "description": "React components that render UI from Zod schemas, JSON Schema, and OpenAPI documents",
     "type": "module",
     "main": "./dist/index.mjs",