@10x-media/form-builder 0.1.0-beta.0 → 0.1.0-beta.10

package/dist/react/renderers/repeater.js

@@ -0,0 +1,131 @@
+"use client";
+import { keys } from "../../translations/keys.js";
+import { isNamedField } from "../../fields/fieldKey.js";
+import { defineFieldRenderer } from "../contract.js";
+import { useFormContext } from "../FormContext.js";
+import { useField } from "../useField.js";
+import { FieldShell } from "../primitives/FieldShell.js";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { createElement, useId, useRef } from "react";
+//#region src/react/renderers/repeater.tsx
+/** Process-wide counter for stable per-row React keys (rows are plain objects with no id of their own). */
+let rowKeySeq = 0;
+const nextRowKey = () => `fbrow-${rowKeySeq++}`;
+/**
+* Thin wrapper so each sub-field renderer is a proper React component (has stable hook identity
+* per row/field). Reads errors for the composite path `field[row].subField` from
+* form state so server-side validation errors are surfaced inline next to the sub-field input,
+* overriding any static values passed by the parent.
+*/
+const SubFieldWrapper = ({ renderer, name, ...props }) => {
+	const { state } = useFormContext();
+	const errors = state.errors?.[name] ?? [];
+	return renderer({
+		...props,
+		name,
+		errors
+	});
+};
+const repeaterRenderer = defineFieldRenderer(({ field, name, id: rootId, errors, required, t, locale }) => {
+	const { rendererRegistry, dispatch } = useFormContext();
+	const { value, setValue, onBlur } = useField(name);
+	const addId = useId();
+	const rowKeysRef = useRef([]);
+	const rows = Array.isArray(value) ? value : [];
+	if (rowKeysRef.current.length !== rows.length) {
+		const next = rowKeysRef.current.slice(0, rows.length);
+		while (next.length < rows.length) next.push(nextRowKey());
+		rowKeysRef.current = next;
+	}
+	const subFields = (Array.isArray(field.subFields) ? field.subFields : []).filter(isNamedField);
+	const maxRows = typeof field.maxRows === "number" ? field.maxRows : void 0;
+	const minRows = typeof field.minRows === "number" ? field.minRows : 0;
+	const addLabel = typeof field.addLabel === "string" && field.addLabel.length > 0 ? field.addLabel : t(keys.repeaterAddRow);
+	const addRow = () => {
+		if (maxRows != null && rows.length >= maxRows) return;
+		rowKeysRef.current = [...rowKeysRef.current, nextRowKey()];
+		setValue([...rows, {}]);
+		onBlur();
+	};
+	const removeRow = (index) => {
+		rowKeysRef.current = rowKeysRef.current.filter((_, i) => i !== index);
+		dispatch({
+			type: "REMOVE_REPEATER_ROW",
+			name,
+			index
+		});
+		setValue(rows.filter((_, i) => i !== index));
+		onBlur();
+	};
+	const updateRow = (index, fieldName, fieldValue) => {
+		setValue(rows.map((row, i) => i === index ? {
+			...row,
+			[fieldName]: fieldValue
+		} : row));
+		dispatch({
+			type: "SET_FIELD_ISSUES",
+			name: `${name}[${index}].${fieldName}`,
+			errors: []
+		});
+	};
+	return /* @__PURE__ */ jsx(FieldShell, {
+		id: rootId,
+		label: typeof field.label === "string" ? field.label : void 0,
+		description: typeof field.description === "string" ? field.description : void 0,
+		required,
+		errors,
+		describedById: `${rootId}-desc`,
+		children: /* @__PURE__ */ jsxs("div", {
+			className: "fb-repeater",
+			children: [rows.map((row, rowIndex) => {
+				const rowLabel = t(keys.repeaterRow).replace("{n}", String(rowIndex + 1));
+				return /* @__PURE__ */ jsxs("fieldset", {
+					className: "fb-repeater__row",
+					children: [/* @__PURE__ */ jsxs("legend", {
+						className: "fb-repeater__row-legend",
+						children: [rowLabel, rows.length > minRows && /* @__PURE__ */ jsx("button", {
+							type: "button",
+							className: "fb-repeater__remove",
+							onClick: () => removeRow(rowIndex),
+							"aria-label": `${t(keys.repeaterRemoveRow)} ${rowLabel}`,
+							children: t(keys.repeaterRemoveRow)
+						})]
+					}), /* @__PURE__ */ jsx("div", {
+						className: "fb-repeater__row-fields",
+						children: subFields.map((subField) => {
+							const renderer = rendererRegistry.get(subField.blockType);
+							if (!renderer) return null;
+							return /* @__PURE__ */ jsx("div", {
+								className: "fb-repeater__sub-field",
+								children: createElement(SubFieldWrapper, {
+									renderer,
+									field: subField,
+									id: `${rootId}-${rowIndex}-${subField.name}`,
+									name: `${name}[${rowIndex}].${subField.name}`,
+									value: row[subField.name],
+									onChange: (v) => updateRow(rowIndex, subField.name, v),
+									onBlur,
+									errors: [],
+									required: subField.required ?? false,
+									disabled: false,
+									locale,
+									t
+								})
+							}, subField.name);
+						})
+					})]
+				}, rowKeysRef.current[rowIndex]);
+			}), (maxRows == null || rows.length < maxRows) && /* @__PURE__ */ jsx("button", {
+				id: addId,
+				type: "button",
+				className: "fb-repeater__add",
+				onClick: addRow,
+				children: addLabel
+			})]
+		})
+	});
+});
+//#endregion
+export { repeaterRenderer };
+
+//# sourceMappingURL=repeater.js.map

package/dist/react/renderers/repeater.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"repeater.js","names":[],"sources":["../../../src/react/renderers/repeater.tsx"],"sourcesContent":["'use client'\n\nimport { createElement, useId, useRef } from 'react'\nimport { isNamedField } from '../../fields/fieldKey'\nimport type { FormFieldInstance } from '../../submissions/types'\nimport { keys } from '../../translations/keys'\nimport type { FieldRenderer } from '../contract'\nimport { defineFieldRenderer } from '../contract'\nimport { useFormContext } from '../FormContext'\nimport { FieldShell } from '../primitives/FieldShell'\nimport { useField } from '../useField'\n\ntype RepeaterRow = Record<string, unknown>\n\n/** Process-wide counter for stable per-row React keys (rows are plain objects with no id of their own). */\nlet rowKeySeq = 0\nconst nextRowKey = () => `fbrow-${rowKeySeq++}`\n\n/**\n * Thin wrapper so each sub-field renderer is a proper React component (has stable hook identity\n * per row/field). Reads errors for the composite path `field[row].subField` from\n * form state so server-side validation errors are surfaced inline next to the sub-field input,\n * overriding any static values passed by the parent.\n */\nconst SubFieldWrapper = ({\n\trenderer,\n\tname,\n\t...props\n}: { renderer: FieldRenderer } & Parameters<FieldRenderer>[0]) => {\n\tconst { state } = useFormContext()\n\tconst errors = (state.errors as Record<string, string[]>)?.[name] ?? []\n\treturn renderer({ ...props, name, errors })\n}\n\nexport const repeaterRenderer = defineFieldRenderer<RepeaterRow[]>(\n\t({ field, name, id: rootId, errors, required, t, locale }) => {\n\t\tconst { rendererRegistry, dispatch } = useFormContext()\n\t\tconst { value, setValue, onBlur } = useField<RepeaterRow[]>(name)\n\t\tconst addId = useId()\n\t\tconst rowKeysRef = useRef<string[]>([])\n\n\t\tconst rows = Array.isArray(value) ? value : []\n\t\t// One stable key per row so removing a middle row does not re-index survivors onto each other's\n\t\t// React instances (which would strand a stateful sub-renderer's local state, e.g. the file\n\t\t// renderer's filename). Reconciled to the row count each render; add/remove keep keys aligned.\n\t\tif (rowKeysRef.current.length !== rows.length) {\n\t\t\tconst next = rowKeysRef.current.slice(0, rows.length)\n\t\t\twhile (next.length < rows.length) next.push(nextRowKey())\n\t\t\trowKeysRef.current = next\n\t\t}\n\t\tconst subFields = (\n\t\t\tArray.isArray(field.subFields) ? (field.subFields as FormFieldInstance[]) : []\n\t\t).filter(isNamedField)\n\t\tconst maxRows = typeof field.maxRows === 'number' ? field.maxRows : undefined\n\t\tconst minRows = typeof field.minRows === 'number' ? field.minRows : 0\n\t\tconst addLabel =\n\t\t\ttypeof field.addLabel === 'string' && field.addLabel.length > 0\n\t\t\t\t? field.addLabel\n\t\t\t\t: t(keys.repeaterAddRow)\n\n\t\tconst addRow = () => {\n\t\t\tif (maxRows != null && rows.length >= maxRows) return\n\t\t\trowKeysRef.current = [...rowKeysRef.current, nextRowKey()]\n\t\t\tsetValue([...rows, {}])\n\t\t\tonBlur()\n\t\t}\n\n\t\tconst removeRow = (index: number) => {\n\t\t\trowKeysRef.current = rowKeysRef.current.filter((_, i) => i !== index)\n\t\t\t// setValue removes the row value; SET_VALUE cannot reach the composite sub-field issue keys\n\t\t\t// (`name[i].sub`), so reindex them separately or a deleted row's errors strand on a survivor.\n\t\t\tdispatch({ type: 'REMOVE_REPEATER_ROW', name, index })\n\t\t\tsetValue(rows.filter((_, i) => i !== index))\n\t\t\tonBlur()\n\t\t}\n\n\t\tconst updateRow = (index: number, fieldName: string, fieldValue: unknown) => {\n\t\t\tsetValue(rows.map((row, i) => (i === index ? { ...row, [fieldName]: fieldValue } : row)))\n\t\t\t// SET_VALUE clears only the repeater field's own error key, not composite sub-field keys, so a\n\t\t\t// stale server-side error for this sub-field would linger until the next submit. Clear it now.\n\t\t\tdispatch({ type: 'SET_FIELD_ISSUES', name: `${name}[${index}].${fieldName}`, errors: [] })\n\t\t}\n\n\t\treturn (\n\t\t\t<FieldShell\n\t\t\t\tid={rootId}\n\t\t\t\tlabel={typeof field.label === 'string' ? field.label : undefined}\n\t\t\t\tdescription={typeof field.description === 'string' ? field.description : undefined}\n\t\t\t\trequired={required}\n\t\t\t\terrors={errors}\n\t\t\t\tdescribedById={`${rootId}-desc`}\n\t\t\t>\n\t\t\t\t<div className=\"fb-repeater\">\n\t\t\t\t\t{rows.map((row, rowIndex) => {\n\t\t\t\t\t\tconst rowLabel = t(keys.repeaterRow).replace('{n}', String(rowIndex + 1))\n\t\t\t\t\t\treturn (\n\t\t\t\t\t\t\t<fieldset key={rowKeysRef.current[rowIndex]} className=\"fb-repeater__row\">\n\t\t\t\t\t\t\t\t<legend className=\"fb-repeater__row-legend\">\n\t\t\t\t\t\t\t\t\t{rowLabel}\n\t\t\t\t\t\t\t\t\t{rows.length > minRows && (\n\t\t\t\t\t\t\t\t\t\t<button\n\t\t\t\t\t\t\t\t\t\t\ttype=\"button\"\n\t\t\t\t\t\t\t\t\t\t\tclassName=\"fb-repeater__remove\"\n\t\t\t\t\t\t\t\t\t\t\tonClick={() => removeRow(rowIndex)}\n\t\t\t\t\t\t\t\t\t\t\taria-label={`${t(keys.repeaterRemoveRow)} ${rowLabel}`}\n\t\t\t\t\t\t\t\t\t\t>\n\t\t\t\t\t\t\t\t\t\t\t{t(keys.repeaterRemoveRow)}\n\t\t\t\t\t\t\t\t\t\t</button>\n\t\t\t\t\t\t\t\t\t)}\n\t\t\t\t\t\t\t\t</legend>\n\t\t\t\t\t\t\t\t<div className=\"fb-repeater__row-fields\">\n\t\t\t\t\t\t\t\t\t{subFields.map((subField) => {\n\t\t\t\t\t\t\t\t\t\tconst renderer = rendererRegistry.get(subField.blockType)\n\t\t\t\t\t\t\t\t\t\tif (!renderer) return null\n\t\t\t\t\t\t\t\t\t\tconst subId = `${rootId}-${rowIndex}-${subField.name}`\n\t\t\t\t\t\t\t\t\t\tconst compositeName = `${name}[${rowIndex}].${subField.name}`\n\t\t\t\t\t\t\t\t\t\treturn (\n\t\t\t\t\t\t\t\t\t\t\t<div key={subField.name} className=\"fb-repeater__sub-field\">\n\t\t\t\t\t\t\t\t\t\t\t\t{createElement(SubFieldWrapper, {\n\t\t\t\t\t\t\t\t\t\t\t\t\trenderer,\n\t\t\t\t\t\t\t\t\t\t\t\t\tfield: subField,\n\t\t\t\t\t\t\t\t\t\t\t\t\tid: subId,\n\t\t\t\t\t\t\t\t\t\t\t\t\tname: compositeName,\n\t\t\t\t\t\t\t\t\t\t\t\t\tvalue: row[subField.name],\n\t\t\t\t\t\t\t\t\t\t\t\t\tonChange: (v) => updateRow(rowIndex, subField.name, v),\n\t\t\t\t\t\t\t\t\t\t\t\t\tonBlur,\n\t\t\t\t\t\t\t\t\t\t\t\t\t// SubFieldWrapper overrides these from form state; passed here to satisfy the type\n\t\t\t\t\t\t\t\t\t\t\t\t\terrors: [],\n\t\t\t\t\t\t\t\t\t\t\t\t\trequired: subField.required ?? false,\n\t\t\t\t\t\t\t\t\t\t\t\t\tdisabled: false,\n\t\t\t\t\t\t\t\t\t\t\t\t\tlocale,\n\t\t\t\t\t\t\t\t\t\t\t\t\tt,\n\t\t\t\t\t\t\t\t\t\t\t\t})}\n\t\t\t\t\t\t\t\t\t\t\t</div>\n\t\t\t\t\t\t\t\t\t\t)\n\t\t\t\t\t\t\t\t\t})}\n\t\t\t\t\t\t\t\t</div>\n\t\t\t\t\t\t\t</fieldset>\n\t\t\t\t\t\t)\n\t\t\t\t\t})}\n\t\t\t\t\t{(maxRows == null || rows.length < maxRows) && (\n\t\t\t\t\t\t<button id={addId} type=\"button\" className=\"fb-repeater__add\" onClick={addRow}>\n\t\t\t\t\t\t\t{addLabel}\n\t\t\t\t\t\t</button>\n\t\t\t\t\t)}\n\t\t\t\t</div>\n\t\t\t</FieldShell>\n\t\t)\n\t}\n)\n"],"mappings":"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"}

package/dist/react/renderers/select.js

@@ -0,0 +1,35 @@
+"use client";
+import { defineFieldRenderer } from "../contract.js";
+import { FieldShell } from "../primitives/FieldShell.js";
+import { Select } from "../primitives/Select.js";
+import { jsx } from "react/jsx-runtime";
+//#region src/react/renderers/select.tsx
+const selectRenderer = defineFieldRenderer(({ field, id, name, value, onChange, onBlur, errors, required, disabled }) => {
+	const describedById = `${id}-desc`;
+	const options = Array.isArray(field.options) ? field.options : [];
+	return /* @__PURE__ */ jsx(FieldShell, {
+		id,
+		label: field.label,
+		description: typeof field.description === "string" ? field.description : void 0,
+		required,
+		errors,
+		describedById,
+		children: /* @__PURE__ */ jsx(Select, {
+			id,
+			name,
+			value: value ?? "",
+			options,
+			onChange,
+			onBlur,
+			placeholder: typeof field.placeholder === "string" ? field.placeholder : void 0,
+			required,
+			disabled,
+			invalid: errors.length > 0,
+			describedById
+		})
+	});
+});
+//#endregion
+export { selectRenderer };
+
+//# sourceMappingURL=select.js.map

package/dist/react/renderers/select.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"select.js","names":[],"sources":["../../../src/react/renderers/select.tsx"],"sourcesContent":["'use client'\n\nimport { defineFieldRenderer } from '../contract'\nimport { FieldShell } from '../primitives/FieldShell'\nimport { Select } from '../primitives/Select'\n\nexport const selectRenderer = defineFieldRenderer<string>(\n\t({ field, id, name, value, onChange, onBlur, errors, required, disabled }) => {\n\t\tconst describedById = `${id}-desc`\n\t\tconst options = Array.isArray(field.options)\n\t\t\t? (field.options as { label: string; value: string }[])\n\t\t\t: []\n\t\treturn (\n\t\t\t<FieldShell\n\t\t\t\tid={id}\n\t\t\t\tlabel={field.label}\n\t\t\t\tdescription={typeof field.description === 'string' ? field.description : undefined}\n\t\t\t\trequired={required}\n\t\t\t\terrors={errors}\n\t\t\t\tdescribedById={describedById}\n\t\t\t>\n\t\t\t\t<Select\n\t\t\t\t\tid={id}\n\t\t\t\t\tname={name}\n\t\t\t\t\tvalue={value ?? ''}\n\t\t\t\t\toptions={options}\n\t\t\t\t\tonChange={onChange}\n\t\t\t\t\tonBlur={onBlur}\n\t\t\t\t\tplaceholder={typeof field.placeholder === 'string' ? field.placeholder : undefined}\n\t\t\t\t\trequired={required}\n\t\t\t\t\tdisabled={disabled}\n\t\t\t\t\tinvalid={errors.length > 0}\n\t\t\t\t\tdescribedById={describedById}\n\t\t\t\t/>\n\t\t\t</FieldShell>\n\t\t)\n\t}\n)\n"],"mappings":";;;;;;AAMA,MAAa,iBAAiB,qBAC5B,EAAE,OAAO,IAAI,MAAM,OAAO,UAAU,QAAQ,QAAQ,UAAU,eAAe;CAC7E,MAAM,gBAAgB,GAAG,GAAG;CAC5B,MAAM,UAAU,MAAM,QAAQ,MAAM,OAAO,IACvC,MAAM,UACP,CAAC;CACJ,OACC,oBAAC,YAAD;EACK;EACJ,OAAO,MAAM;EACb,aAAa,OAAO,MAAM,gBAAgB,WAAW,MAAM,cAAc,KAAA;EAC/D;EACF;EACO;YAEf,oBAAC,QAAD;GACK;GACE;GACN,OAAO,SAAS;GACP;GACC;GACF;GACR,aAAa,OAAO,MAAM,gBAAgB,WAAW,MAAM,cAAc,KAAA;GAC/D;GACA;GACV,SAAS,OAAO,SAAS;GACV;EACf,CAAA;CACU,CAAA;AAEd,CACD"}

package/dist/react/renderers/text.js

@@ -0,0 +1,34 @@
+"use client";
+import { defineFieldRenderer } from "../contract.js";
+import { FieldShell } from "../primitives/FieldShell.js";
+import { Input } from "../primitives/Input.js";
+import { jsx } from "react/jsx-runtime";
+//#region src/react/renderers/text.tsx
+const textRenderer = defineFieldRenderer(({ field, id, name, value, onChange, onBlur, errors, required, disabled }) => {
+	const describedById = `${id}-desc`;
+	return /* @__PURE__ */ jsx(FieldShell, {
+		id,
+		label: field.label,
+		description: typeof field.description === "string" ? field.description : void 0,
+		required,
+		errors,
+		describedById,
+		children: /* @__PURE__ */ jsx(Input, {
+			id,
+			name,
+			type: "text",
+			value: value ?? "",
+			onChange,
+			onBlur,
+			placeholder: typeof field.placeholder === "string" ? field.placeholder : void 0,
+			required,
+			disabled,
+			invalid: errors.length > 0,
+			describedById
+		})
+	});
+});
+//#endregion
+export { textRenderer };
+
+//# sourceMappingURL=text.js.map

package/dist/react/renderers/text.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"text.js","names":[],"sources":["../../../src/react/renderers/text.tsx"],"sourcesContent":["'use client'\n\nimport { defineFieldRenderer } from '../contract'\nimport { FieldShell } from '../primitives/FieldShell'\nimport { Input } from '../primitives/Input'\n\nexport const textRenderer = defineFieldRenderer<string>(\n\t({ field, id, name, value, onChange, onBlur, errors, required, disabled }) => {\n\t\tconst describedById = `${id}-desc`\n\t\treturn (\n\t\t\t<FieldShell\n\t\t\t\tid={id}\n\t\t\t\tlabel={field.label}\n\t\t\t\tdescription={typeof field.description === 'string' ? field.description : undefined}\n\t\t\t\trequired={required}\n\t\t\t\terrors={errors}\n\t\t\t\tdescribedById={describedById}\n\t\t\t>\n\t\t\t\t<Input\n\t\t\t\t\tid={id}\n\t\t\t\t\tname={name}\n\t\t\t\t\ttype=\"text\"\n\t\t\t\t\tvalue={value ?? ''}\n\t\t\t\t\tonChange={onChange}\n\t\t\t\t\tonBlur={onBlur}\n\t\t\t\t\tplaceholder={typeof field.placeholder === 'string' ? field.placeholder : undefined}\n\t\t\t\t\trequired={required}\n\t\t\t\t\tdisabled={disabled}\n\t\t\t\t\tinvalid={errors.length > 0}\n\t\t\t\t\tdescribedById={describedById}\n\t\t\t\t/>\n\t\t\t</FieldShell>\n\t\t)\n\t}\n)\n"],"mappings":";;;;;;AAMA,MAAa,eAAe,qBAC1B,EAAE,OAAO,IAAI,MAAM,OAAO,UAAU,QAAQ,QAAQ,UAAU,eAAe;CAC7E,MAAM,gBAAgB,GAAG,GAAG;CAC5B,OACC,oBAAC,YAAD;EACK;EACJ,OAAO,MAAM;EACb,aAAa,OAAO,MAAM,gBAAgB,WAAW,MAAM,cAAc,KAAA;EAC/D;EACF;EACO;YAEf,oBAAC,OAAD;GACK;GACE;GACN,MAAK;GACL,OAAO,SAAS;GACN;GACF;GACR,aAAa,OAAO,MAAM,gBAAgB,WAAW,MAAM,cAAc,KAAA;GAC/D;GACA;GACV,SAAS,OAAO,SAAS;GACV;EACf,CAAA;CACU,CAAA;AAEd,CACD"}

package/dist/react/renderers/textarea.js

@@ -0,0 +1,33 @@
+"use client";
+import { defineFieldRenderer } from "../contract.js";
+import { FieldShell } from "../primitives/FieldShell.js";
+import { Textarea } from "../primitives/Textarea.js";
+import { jsx } from "react/jsx-runtime";
+//#region src/react/renderers/textarea.tsx
+const textareaRenderer = defineFieldRenderer(({ field, id, name, value, onChange, onBlur, errors, required, disabled }) => {
+	const describedById = `${id}-desc`;
+	return /* @__PURE__ */ jsx(FieldShell, {
+		id,
+		label: field.label,
+		description: typeof field.description === "string" ? field.description : void 0,
+		required,
+		errors,
+		describedById,
+		children: /* @__PURE__ */ jsx(Textarea, {
+			id,
+			name,
+			value: value ?? "",
+			onChange,
+			onBlur,
+			placeholder: typeof field.placeholder === "string" ? field.placeholder : void 0,
+			required,
+			disabled,
+			invalid: errors.length > 0,
+			describedById
+		})
+	});
+});
+//#endregion
+export { textareaRenderer };
+
+//# sourceMappingURL=textarea.js.map

package/dist/react/renderers/textarea.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"textarea.js","names":[],"sources":["../../../src/react/renderers/textarea.tsx"],"sourcesContent":["'use client'\n\nimport { defineFieldRenderer } from '../contract'\nimport { FieldShell } from '../primitives/FieldShell'\nimport { Textarea } from '../primitives/Textarea'\n\nexport const textareaRenderer = defineFieldRenderer<string>(\n\t({ field, id, name, value, onChange, onBlur, errors, required, disabled }) => {\n\t\tconst describedById = `${id}-desc`\n\t\treturn (\n\t\t\t<FieldShell\n\t\t\t\tid={id}\n\t\t\t\tlabel={field.label}\n\t\t\t\tdescription={typeof field.description === 'string' ? field.description : undefined}\n\t\t\t\trequired={required}\n\t\t\t\terrors={errors}\n\t\t\t\tdescribedById={describedById}\n\t\t\t>\n\t\t\t\t<Textarea\n\t\t\t\t\tid={id}\n\t\t\t\t\tname={name}\n\t\t\t\t\tvalue={value ?? ''}\n\t\t\t\t\tonChange={onChange}\n\t\t\t\t\tonBlur={onBlur}\n\t\t\t\t\tplaceholder={typeof field.placeholder === 'string' ? field.placeholder : undefined}\n\t\t\t\t\trequired={required}\n\t\t\t\t\tdisabled={disabled}\n\t\t\t\t\tinvalid={errors.length > 0}\n\t\t\t\t\tdescribedById={describedById}\n\t\t\t\t/>\n\t\t\t</FieldShell>\n\t\t)\n\t}\n)\n"],"mappings":";;;;;;AAMA,MAAa,mBAAmB,qBAC9B,EAAE,OAAO,IAAI,MAAM,OAAO,UAAU,QAAQ,QAAQ,UAAU,eAAe;CAC7E,MAAM,gBAAgB,GAAG,GAAG;CAC5B,OACC,oBAAC,YAAD;EACK;EACJ,OAAO,MAAM;EACb,aAAa,OAAO,MAAM,gBAAgB,WAAW,MAAM,cAAc,KAAA;EAC/D;EACF;EACO;YAEf,oBAAC,UAAD;GACK;GACE;GACN,OAAO,SAAS;GACN;GACF;GACR,aAAa,OAAO,MAAM,gBAAgB,WAAW,MAAM,cAAc,KAAA;GAC/D;GACA;GACV,SAAS,OAAO,SAAS;GACV;EACf,CAAA;CACU,CAAA;AAEd,CACD"}

package/dist/react/resolveForm.js

@@ -0,0 +1,16 @@
+import { defaultFieldDefinitions } from "../fields/builtin/index.js";
+import { buildRegistry } from "../fields/registry.js";
+import { evaluateCondition } from "../conditions/evaluate.js";
+import { defaultValidationRules } from "../validation/builtin/index.js";
+import { buildRuleRegistry } from "../validation/registry.js";
+//#region src/react/resolveForm.ts
+/** Build the field-type registry from the bundled defaults plus any consumer-supplied extra definitions. */
+const buildFieldTypeRegistry = (extra = []) => buildRegistry([...defaultFieldDefinitions, ...extra]);
+/** Build the validation-rule registry from the bundled defaults plus consumer extras. */
+const buildValidationRuleRegistry = (extra = []) => buildRuleRegistry([...defaultValidationRules, ...extra]);
+/** The subset of fields currently visible, evaluating each field's `visibleWhen` against the answers. */
+const visibleFields = (fields, values) => fields.filter((field) => evaluateCondition(field.visibleWhen, values));
+//#endregion
+export { buildFieldTypeRegistry, buildValidationRuleRegistry, visibleFields };
+
+//# sourceMappingURL=resolveForm.js.map

package/dist/react/resolveForm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolveForm.js","names":[],"sources":["../../src/react/resolveForm.ts"],"sourcesContent":["import { evaluateCondition } from '../conditions/evaluate'\nimport { defaultFieldDefinitions } from '../fields/builtin'\nimport { buildRegistry, type FieldTypeRegistry } from '../fields/registry'\nimport type { AnyFormFieldDefinition } from '../fields/types'\nimport type { FormFieldInstance } from '../submissions/types'\nimport { defaultValidationRules } from '../validation/builtin'\nimport { buildRuleRegistry, type ValidationRuleRegistry } from '../validation/registry'\nimport type { AnyValidationRuleDefinition } from '../validation/types'\n\n/** Build the field-type registry from the bundled defaults plus any consumer-supplied extra definitions. */\nexport const buildFieldTypeRegistry = (extra: AnyFormFieldDefinition[] = []): FieldTypeRegistry =>\n\tbuildRegistry([...defaultFieldDefinitions, ...extra])\n\n/** Build the validation-rule registry from the bundled defaults plus consumer extras. */\nexport const buildValidationRuleRegistry = (\n\textra: AnyValidationRuleDefinition[] = []\n): ValidationRuleRegistry => buildRuleRegistry([...defaultValidationRules, ...extra])\n\n/** The subset of fields currently visible, evaluating each field's `visibleWhen` against the answers. */\nexport const visibleFields = (\n\tfields: FormFieldInstance[],\n\tvalues: Record<string, unknown>\n): FormFieldInstance[] => fields.filter((field) => evaluateCondition(field.visibleWhen, values))\n"],"mappings":";;;;;;;AAUA,MAAa,0BAA0B,QAAkC,CAAC,MACzE,cAAc,CAAC,GAAG,yBAAyB,GAAG,KAAK,CAAC;;AAGrD,MAAa,+BACZ,QAAuC,CAAC,MACZ,kBAAkB,CAAC,GAAG,wBAAwB,GAAG,KAAK,CAAC;;AAGpF,MAAa,iBACZ,QACA,WACyB,OAAO,QAAQ,UAAU,kBAAkB,MAAM,aAAa,MAAM,CAAC"}

package/dist/react/state.d.ts

@@ -0,0 +1,52 @@
+//#region src/react/state.d.ts
+type FieldErrors = Record<string, string[]>;
+type FormState = {
+  values: Record<string, unknown>;
+  errors: FieldErrors;
+  touched: Record<string, boolean>;
+  submitting: boolean;
+  submitted: boolean;
+  /**
+   * The step ids whose validation the user has attempted (a blocked advance, or a submit). A field
+   * reveals its error when it is touched or its own step is in this set, never via a single global flag,
+   * so a submit attempt cannot pre-reveal errors on a step the visitor has not reached.
+   */
+  attemptedSteps: Set<string>;
+  submitError?: string;
+};
+type FormAction = {
+  type: 'SET_VALUE';
+  name: string;
+  value: unknown;
+} | {
+  type: 'TOUCH';
+  name: string;
+} | {
+  type: 'SET_FIELD_ISSUES';
+  name: string;
+  errors: string[];
+} | {
+  type: 'SET_ALL_ISSUES';
+  errors: FieldErrors;
+  steps: string[];
+} | {
+  type: 'MARK_STEP_ATTEMPTED';
+  stepId: string;
+} | {
+  type: 'REMOVE_REPEATER_ROW';
+  name: string;
+  index: number;
+} | {
+  type: 'SUBMIT_START';
+} | {
+  type: 'SUBMIT_SUCCESS';
+} | {
+  type: 'SUBMIT_ERROR';
+  message: string;
+} | {
+  type: 'RESET';
+  values: Record<string, unknown>;
+};
+//#endregion
+export { FieldErrors, FormAction, FormState };
+//# sourceMappingURL=state.d.ts.map

package/dist/react/state.js

@@ -0,0 +1,125 @@
+import { isNamedField } from "../fields/fieldKey.js";
+//#region src/react/state.ts
+/**
+* The step a field's error reveal is keyed to when the form has no flow, or the field belongs to no
+* step. A single-step form has exactly this one step, so its reveal collapses to the old global one.
+*/
+const DEFAULT_STEP_ID = "__form__";
+/**
+* Per-field defaults for the reducer's initial state. Nameless (bare) blocks carry no value and
+* are skipped. A repeater with a positive `minRows` starts pre-seeded with that many empty rows,
+* matching the schema's own floor. Computed once, ahead of the reducer, so seeding is never an
+* action: it can't touch a field, trigger validation, or (via `Form`'s dispatch wrapper) be
+* mistaken for the user's first edit and fire `form.started`.
+*/
+const seedFieldValues = (fields) => Object.fromEntries(fields.filter(isNamedField).map((field) => {
+	if (field.blockType === "repeater") {
+		const minRows = typeof field.minRows === "number" ? field.minRows : 0;
+		if (minRows > 0) return [field.name, Array.from({ length: minRows }, () => ({}))];
+	}
+	return [field.name, void 0];
+}));
+const initialFormState = (values) => ({
+	values,
+	errors: {},
+	touched: {},
+	submitting: false,
+	submitted: false,
+	attemptedSteps: /* @__PURE__ */ new Set()
+});
+/**
+* Re-key composite entries (`name[i].sub`) after repeater row `removed` is deleted: drop the removed
+* index and shift every higher index down by one, so surviving rows keep their own errors/touched
+* flags instead of inheriting a deleted or shifted neighbour's. Matches on the `name[<int>]` prefix,
+* so it is agnostic to the sub-key shape after `]` and needs no sub-field list. Returns the same
+* reference when nothing changed, so an unrelated dispatch does not churn state identity.
+*/
+const reindexRepeaterKeys = (map, name, removed) => {
+	const prefix = `${name}[`;
+	let changed = false;
+	const next = {};
+	for (const [key, value] of Object.entries(map)) {
+		if (!key.startsWith(prefix)) {
+			next[key] = value;
+			continue;
+		}
+		const close = key.indexOf("]", prefix.length);
+		const idx = close === -1 ? NaN : Number(key.slice(prefix.length, close));
+		if (!Number.isInteger(idx) || idx < removed) {
+			next[key] = value;
+			continue;
+		}
+		if (idx === removed) {
+			changed = true;
+			continue;
+		}
+		next[`${name}[${idx - 1}]${key.slice(close + 1)}`] = value;
+		changed = true;
+	}
+	return changed ? next : map;
+};
+/** Changing a value clears that field's prior errors (re-validated by the caller). */
+const formReducer = (state, action) => {
+	switch (action.type) {
+		case "SET_VALUE": {
+			const { [action.name]: _removed, ...restErrors } = state.errors;
+			return {
+				...state,
+				values: {
+					...state.values,
+					[action.name]: action.value
+				},
+				errors: restErrors
+			};
+		}
+		case "TOUCH": return state.touched[action.name] ? state : {
+			...state,
+			touched: {
+				...state.touched,
+				[action.name]: true
+			}
+		};
+		case "SET_FIELD_ISSUES": return {
+			...state,
+			errors: {
+				...state.errors,
+				[action.name]: action.errors
+			}
+		};
+		case "SET_ALL_ISSUES": return {
+			...state,
+			errors: action.errors,
+			attemptedSteps: new Set([...state.attemptedSteps, ...action.steps])
+		};
+		case "MARK_STEP_ATTEMPTED": return state.attemptedSteps.has(action.stepId) ? state : {
+			...state,
+			attemptedSteps: new Set([...state.attemptedSteps, action.stepId])
+		};
+		case "REMOVE_REPEATER_ROW": return {
+			...state,
+			errors: reindexRepeaterKeys(state.errors, action.name, action.index),
+			touched: reindexRepeaterKeys(state.touched, action.name, action.index)
+		};
+		case "SUBMIT_START": return {
+			...state,
+			submitting: true,
+			submitError: void 0
+		};
+		case "SUBMIT_SUCCESS": return {
+			...state,
+			submitting: false,
+			submitted: true
+		};
+		case "SUBMIT_ERROR": return {
+			...state,
+			submitting: false,
+			submitError: action.message
+		};
+		case "RESET": return initialFormState(action.values);
+		default: return state;
+	}
+};
+//#endregion
+export { DEFAULT_STEP_ID, formReducer, initialFormState, seedFieldValues };
+
+//# sourceMappingURL=state.js.map

package/dist/react/state.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","names":[],"sources":["../../src/react/state.ts"],"sourcesContent":["import { isNamedField } from '../fields/fieldKey'\nimport type { FormFieldInstance } from '../submissions/types'\n\nexport type FieldErrors = Record<string, string[]>\n\n/**\n * The step a field's error reveal is keyed to when the form has no flow, or the field belongs to no\n * step. A single-step form has exactly this one step, so its reveal collapses to the old global one.\n */\nexport const DEFAULT_STEP_ID = '__form__'\n\nexport type FormState = {\n\tvalues: Record<string, unknown>\n\terrors: FieldErrors\n\ttouched: Record<string, boolean>\n\tsubmitting: boolean\n\tsubmitted: boolean\n\t/**\n\t * The step ids whose validation the user has attempted (a blocked advance, or a submit). A field\n\t * reveals its error when it is touched or its own step is in this set, never via a single global flag,\n\t * so a submit attempt cannot pre-reveal errors on a step the visitor has not reached.\n\t */\n\tattemptedSteps: Set<string>\n\tsubmitError?: string\n}\n\nexport type FormAction =\n\t| { type: 'SET_VALUE'; name: string; value: unknown }\n\t| { type: 'TOUCH'; name: string }\n\t| { type: 'SET_FIELD_ISSUES'; name: string; errors: string[] }\n\t| { type: 'SET_ALL_ISSUES'; errors: FieldErrors; steps: string[] }\n\t| { type: 'MARK_STEP_ATTEMPTED'; stepId: string }\n\t| { type: 'REMOVE_REPEATER_ROW'; name: string; index: number }\n\t| { type: 'SUBMIT_START' }\n\t| { type: 'SUBMIT_SUCCESS' }\n\t| { type: 'SUBMIT_ERROR'; message: string }\n\t| { type: 'RESET'; values: Record<string, unknown> }\n\n/**\n * Per-field defaults for the reducer's initial state. Nameless (bare) blocks carry no value and\n * are skipped. A repeater with a positive `minRows` starts pre-seeded with that many empty rows,\n * matching the schema's own floor. Computed once, ahead of the reducer, so seeding is never an\n * action: it can't touch a field, trigger validation, or (via `Form`'s dispatch wrapper) be\n * mistaken for the user's first edit and fire `form.started`.\n */\nexport const seedFieldValues = (fields: FormFieldInstance[]): Record<string, unknown> =>\n\tObject.fromEntries(\n\t\tfields.filter(isNamedField).map((field) => {\n\t\t\tif (field.blockType === 'repeater') {\n\t\t\t\tconst minRows = typeof field.minRows === 'number' ? field.minRows : 0\n\t\t\t\tif (minRows > 0) {\n\t\t\t\t\treturn [field.name, Array.from({ length: minRows }, () => ({}))]\n\t\t\t\t}\n\t\t\t}\n\t\t\treturn [field.name, undefined]\n\t\t})\n\t)\n\nexport const initialFormState = (values: Record<string, unknown>): FormState => ({\n\tvalues,\n\terrors: {},\n\ttouched: {},\n\tsubmitting: false,\n\tsubmitted: false,\n\tattemptedSteps: new Set(),\n})\n\n/**\n * Re-key composite entries (`name[i].sub`) after repeater row `removed` is deleted: drop the removed\n * index and shift every higher index down by one, so surviving rows keep their own errors/touched\n * flags instead of inheriting a deleted or shifted neighbour's. Matches on the `name[<int>]` prefix,\n * so it is agnostic to the sub-key shape after `]` and needs no sub-field list. Returns the same\n * reference when nothing changed, so an unrelated dispatch does not churn state identity.\n */\nconst reindexRepeaterKeys = <T>(\n\tmap: Record<string, T>,\n\tname: string,\n\tremoved: number\n): Record<string, T> => {\n\tconst prefix = `${name}[`\n\tlet changed = false\n\tconst next: Record<string, T> = {}\n\tfor (const [key, value] of Object.entries(map)) {\n\t\tif (!key.startsWith(prefix)) {\n\t\t\tnext[key] = value\n\t\t\tcontinue\n\t\t}\n\t\tconst close = key.indexOf(']', prefix.length)\n\t\tconst idx = close === -1 ? Number.NaN : Number(key.slice(prefix.length, close))\n\t\tif (!Number.isInteger(idx) || idx < removed) {\n\t\t\tnext[key] = value\n\t\t\tcontinue\n\t\t}\n\t\tif (idx === removed) {\n\t\t\tchanged = true\n\t\t\tcontinue\n\t\t}\n\t\tnext[`${name}[${idx - 1}]${key.slice(close + 1)}`] = value\n\t\tchanged = true\n\t}\n\treturn changed ? next : map\n}\n\n/** Changing a value clears that field's prior errors (re-validated by the caller). */\nexport const formReducer = (state: FormState, action: FormAction): FormState => {\n\tswitch (action.type) {\n\t\tcase 'SET_VALUE': {\n\t\t\tconst { [action.name]: _removed, ...restErrors } = state.errors\n\t\t\treturn {\n\t\t\t\t...state,\n\t\t\t\tvalues: { ...state.values, [action.name]: action.value },\n\t\t\t\terrors: restErrors,\n\t\t\t}\n\t\t}\n\t\tcase 'TOUCH':\n\t\t\treturn state.touched[action.name]\n\t\t\t\t? state\n\t\t\t\t: { ...state, touched: { ...state.touched, [action.name]: true } }\n\t\tcase 'SET_FIELD_ISSUES':\n\t\t\treturn {\n\t\t\t\t...state,\n\t\t\t\terrors: { ...state.errors, [action.name]: action.errors },\n\t\t\t}\n\t\tcase 'SET_ALL_ISSUES':\n\t\t\treturn {\n\t\t\t\t...state,\n\t\t\t\terrors: action.errors,\n\t\t\t\tattemptedSteps: new Set([...state.attemptedSteps, ...action.steps]),\n\t\t\t}\n\t\tcase 'MARK_STEP_ATTEMPTED':\n\t\t\treturn state.attemptedSteps.has(action.stepId)\n\t\t\t\t? state\n\t\t\t\t: { ...state, attemptedSteps: new Set([...state.attemptedSteps, action.stepId]) }\n\t\tcase 'REMOVE_REPEATER_ROW':\n\t\t\t// The row value is removed by the field's own SET_VALUE; this shifts the composite issue keys\n\t\t\t// (`name[i].sub`) that a plain value array cannot carry, so a deleted row's errors never strand\n\t\t\t// on a survivor or linger unreachably.\n\t\t\treturn {\n\t\t\t\t...state,\n\t\t\t\terrors: reindexRepeaterKeys(state.errors, action.name, action.index),\n\t\t\t\ttouched: reindexRepeaterKeys(state.touched, action.name, action.index),\n\t\t\t}\n\t\tcase 'SUBMIT_START':\n\t\t\treturn { ...state, submitting: true, submitError: undefined }\n\t\tcase 'SUBMIT_SUCCESS':\n\t\t\treturn { ...state, submitting: false, submitted: true }\n\t\tcase 'SUBMIT_ERROR':\n\t\t\treturn { ...state, submitting: false, submitError: action.message }\n\t\tcase 'RESET':\n\t\t\treturn initialFormState(action.values)\n\t\tdefault:\n\t\t\treturn state\n\t}\n}\n"],"mappings":";;;;;;AASA,MAAa,kBAAkB;;;;;;;;AAoC/B,MAAa,mBAAmB,WAC/B,OAAO,YACN,OAAO,OAAO,YAAY,EAAE,KAAK,UAAU;CAC1C,IAAI,MAAM,cAAc,YAAY;EACnC,MAAM,UAAU,OAAO,MAAM,YAAY,WAAW,MAAM,UAAU;EACpE,IAAI,UAAU,GACb,OAAO,CAAC,MAAM,MAAM,MAAM,KAAK,EAAE,QAAQ,QAAQ,UAAU,CAAC,EAAE,CAAC;CAEjE;CACA,OAAO,CAAC,MAAM,MAAM,KAAA,CAAS;AAC9B,CAAC,CACF;AAED,MAAa,oBAAoB,YAAgD;CAChF;CACA,QAAQ,CAAC;CACT,SAAS,CAAC;CACV,YAAY;CACZ,WAAW;CACX,gCAAgB,IAAI,IAAI;AACzB;;;;;;;;AASA,MAAM,uBACL,KACA,MACA,YACuB;CACvB,MAAM,SAAS,GAAG,KAAK;CACvB,IAAI,UAAU;CACd,MAAM,OAA0B,CAAC;CACjC,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,GAAG,GAAG;EAC/C,IAAI,CAAC,IAAI,WAAW,MAAM,GAAG;GAC5B,KAAK,OAAO;GACZ;EACD;EACA,MAAM,QAAQ,IAAI,QAAQ,KAAK,OAAO,MAAM;EAC5C,MAAM,MAAM,UAAU,KAAK,MAAa,OAAO,IAAI,MAAM,OAAO,QAAQ,KAAK,CAAC;EAC9E,IAAI,CAAC,OAAO,UAAU,GAAG,KAAK,MAAM,SAAS;GAC5C,KAAK,OAAO;GACZ;EACD;EACA,IAAI,QAAQ,SAAS;GACpB,UAAU;GACV;EACD;EACA,KAAK,GAAG,KAAK,GAAG,MAAM,EAAE,GAAG,IAAI,MAAM,QAAQ,CAAC,OAAO;EACrD,UAAU;CACX;CACA,OAAO,UAAU,OAAO;AACzB;;AAGA,MAAa,eAAe,OAAkB,WAAkC;CAC/E,QAAQ,OAAO,MAAf;EACC,KAAK,aAAa;GACjB,MAAM,GAAG,OAAO,OAAO,UAAU,GAAG,eAAe,MAAM;GACzD,OAAO;IACN,GAAG;IACH,QAAQ;KAAE,GAAG,MAAM;MAAS,OAAO,OAAO,OAAO;IAAM;IACvD,QAAQ;GACT;EACD;EACA,KAAK,SACJ,OAAO,MAAM,QAAQ,OAAO,QACzB,QACA;GAAE,GAAG;GAAO,SAAS;IAAE,GAAG,MAAM;KAAU,OAAO,OAAO;GAAK;EAAE;EACnE,KAAK,oBACJ,OAAO;GACN,GAAG;GACH,QAAQ;IAAE,GAAG,MAAM;KAAS,OAAO,OAAO,OAAO;GAAO;EACzD;EACD,KAAK,kBACJ,OAAO;GACN,GAAG;GACH,QAAQ,OAAO;GACf,gBAAgB,IAAI,IAAI,CAAC,GAAG,MAAM,gBAAgB,GAAG,OAAO,KAAK,CAAC;EACnE;EACD,KAAK,uBACJ,OAAO,MAAM,eAAe,IAAI,OAAO,MAAM,IAC1C,QACA;GAAE,GAAG;GAAO,gBAAgB,IAAI,IAAI,CAAC,GAAG,MAAM,gBAAgB,OAAO,MAAM,CAAC;EAAE;EAClF,KAAK,uBAIJ,OAAO;GACN,GAAG;GACH,QAAQ,oBAAoB,MAAM,QAAQ,OAAO,MAAM,OAAO,KAAK;GACnE,SAAS,oBAAoB,MAAM,SAAS,OAAO,MAAM,OAAO,KAAK;EACtE;EACD,KAAK,gBACJ,OAAO;GAAE,GAAG;GAAO,YAAY;GAAM,aAAa,KAAA;EAAU;EAC7D,KAAK,kBACJ,OAAO;GAAE,GAAG;GAAO,YAAY;GAAO,WAAW;EAAK;EACvD,KAAK,gBACJ,OAAO;GAAE,GAAG;GAAO,YAAY;GAAO,aAAa,OAAO;EAAQ;EACnE,KAAK,SACJ,OAAO,iBAAiB,OAAO,MAAM;EACtC,SACC,OAAO;CACT;AACD"}

package/dist/react/submitForm.d.ts

@@ -0,0 +1,31 @@
+import { SubmissionValue } from "../submissions/types.js";
+
+//#region src/react/submitForm.d.ts
+type SubmitFormInput = {
+  formId: number | string;
+  values: SubmissionValue[]; /** Payload API route prefix; defaults to `/api`. */
+  apiRoute?: string; /** Injectable for testing; defaults to global `fetch`. */
+  fetchImpl?: typeof fetch;
+};
+type SubmitFormResult = {
+  ok: true;
+  submissionId?: string;
+} | {
+  ok: false;
+  fieldErrors?: Record<string, string[]>;
+  message?: string;
+};
+/**
+ * The default submission transport: POST `{apiRoute}/form-submissions` with `{ form, values }`. On 201
+ * returns the created submission id; on a 400 Payload `ValidationError` maps `data.errors[].path` to
+ * per-field messages; otherwise returns a generic message. Pure: inject `fetchImpl` in tests.
+ */
+declare const submitForm: (input: SubmitFormInput) => Promise<SubmitFormResult>;
+/** A consumer override for the transport: given the form id + values, resolve to a submit result. */
+type SubmitHandler = (input: {
+  formId: number | string;
+  values: SubmissionValue[];
+}) => Promise<SubmitFormResult>;
+//#endregion
+export { SubmitFormResult, SubmitHandler, submitForm };
+//# sourceMappingURL=submitForm.d.ts.map

package/dist/react/submitForm.js

@@ -0,0 +1,58 @@
+//#region src/react/submitForm.ts
+const toFieldErrors = (body) => {
+	const nested = body.errors?.[0]?.data?.errors ?? [];
+	const map = {};
+	for (const entry of nested) if (typeof entry.path === "string" && typeof entry.message === "string") map[entry.path] = [...map[entry.path] ?? [], entry.message];
+	return map;
+};
+/**
+* The default submission transport: POST `{apiRoute}/form-submissions` with `{ form, values }`. On 201
+* returns the created submission id; on a 400 Payload `ValidationError` maps `data.errors[].path` to
+* per-field messages; otherwise returns a generic message. Pure: inject `fetchImpl` in tests.
+*/
+const submitForm = async (input) => {
+	const { formId, values, apiRoute = "/api", fetchImpl = fetch } = input;
+	let response;
+	try {
+		response = await fetchImpl(`${apiRoute}/form-submissions`, {
+			method: "POST",
+			headers: { "Content-Type": "application/json" },
+			body: JSON.stringify({
+				form: formId,
+				values
+			})
+		});
+	} catch (error) {
+		return {
+			ok: false,
+			message: error instanceof Error ? error.message : "Network error"
+		};
+	}
+	if (response.ok) {
+		const id = (await response.json().catch(() => ({}))).doc?.id;
+		return {
+			ok: true,
+			submissionId: id === void 0 ? void 0 : String(id)
+		};
+	}
+	if (response.status === 400) {
+		const body = await response.json().catch(() => ({}));
+		const fieldErrors = toFieldErrors(body);
+		if (Object.keys(fieldErrors).length > 0) return {
+			ok: false,
+			fieldErrors
+		};
+		return {
+			ok: false,
+			message: body.errors?.[0]?.message ?? "Validation failed"
+		};
+	}
+	return {
+		ok: false,
+		message: `Request failed (${response.status})`
+	};
+};
+//#endregion
+export { submitForm };
+
+//# sourceMappingURL=submitForm.js.map

package/dist/react/submitForm.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"submitForm.js","names":[],"sources":["../../src/react/submitForm.ts"],"sourcesContent":["import type { SubmissionValue } from '../submissions/types'\n\nexport type SubmitFormInput = {\n\tformId: number | string\n\tvalues: SubmissionValue[]\n\t/** Payload API route prefix; defaults to `/api`. */\n\tapiRoute?: string\n\t/** Injectable for testing; defaults to global `fetch`. */\n\tfetchImpl?: typeof fetch\n}\n\nexport type SubmitFormResult =\n\t| { ok: true; submissionId?: string }\n\t| { ok: false; fieldErrors?: Record<string, string[]>; message?: string }\n\ntype ValidationErrorBody = {\n\terrors?: Array<{\n\t\tmessage?: string\n\t\tdata?: { errors?: Array<{ path?: string; message?: string }> }\n\t}>\n}\n\nconst toFieldErrors = (body: ValidationErrorBody): Record<string, string[]> => {\n\tconst nested = body.errors?.[0]?.data?.errors ?? []\n\tconst map: Record<string, string[]> = {}\n\tfor (const entry of nested) {\n\t\tif (typeof entry.path === 'string' && typeof entry.message === 'string') {\n\t\t\tmap[entry.path] = [...(map[entry.path] ?? []), entry.message]\n\t\t}\n\t}\n\treturn map\n}\n\n/**\n * The default submission transport: POST `{apiRoute}/form-submissions` with `{ form, values }`. On 201\n * returns the created submission id; on a 400 Payload `ValidationError` maps `data.errors[].path` to\n * per-field messages; otherwise returns a generic message. Pure: inject `fetchImpl` in tests.\n */\nexport const submitForm = async (input: SubmitFormInput): Promise<SubmitFormResult> => {\n\tconst { formId, values, apiRoute = '/api', fetchImpl = fetch } = input\n\tlet response: Response\n\ttry {\n\t\tresponse = await fetchImpl(`${apiRoute}/form-submissions`, {\n\t\t\tmethod: 'POST',\n\t\t\theaders: { 'Content-Type': 'application/json' },\n\t\t\tbody: JSON.stringify({ form: formId, values }),\n\t\t})\n\t} catch (error) {\n\t\treturn { ok: false, message: error instanceof Error ? error.message : 'Network error' }\n\t}\n\tif (response.ok) {\n\t\tconst data = (await response.json().catch(() => ({}))) as { doc?: { id?: number | string } }\n\t\tconst id = data.doc?.id\n\t\treturn { ok: true, submissionId: id === undefined ? undefined : String(id) }\n\t}\n\tif (response.status === 400) {\n\t\tconst body = (await response.json().catch(() => ({}))) as ValidationErrorBody\n\t\tconst fieldErrors = toFieldErrors(body)\n\t\tif (Object.keys(fieldErrors).length > 0) {\n\t\t\treturn { ok: false, fieldErrors }\n\t\t}\n\t\treturn { ok: false, message: body.errors?.[0]?.message ?? 'Validation failed' }\n\t}\n\treturn { ok: false, message: `Request failed (${response.status})` }\n}\n\n/** A consumer override for the transport: given the form id + values, resolve to a submit result. */\nexport type SubmitHandler = (input: {\n\tformId: number | string\n\tvalues: SubmissionValue[]\n}) => Promise<SubmitFormResult>\n"],"mappings":";AAsBA,MAAM,iBAAiB,SAAwD;CAC9E,MAAM,SAAS,KAAK,SAAS,IAAI,MAAM,UAAU,CAAC;CAClD,MAAM,MAAgC,CAAC;CACvC,KAAK,MAAM,SAAS,QACnB,IAAI,OAAO,MAAM,SAAS,YAAY,OAAO,MAAM,YAAY,UAC9D,IAAI,MAAM,QAAQ,CAAC,GAAI,IAAI,MAAM,SAAS,CAAC,GAAI,MAAM,OAAO;CAG9D,OAAO;AACR;;;;;;AAOA,MAAa,aAAa,OAAO,UAAsD;CACtF,MAAM,EAAE,QAAQ,QAAQ,WAAW,QAAQ,YAAY,UAAU;CACjE,IAAI;CACJ,IAAI;EACH,WAAW,MAAM,UAAU,GAAG,SAAS,oBAAoB;GAC1D,QAAQ;GACR,SAAS,EAAE,gBAAgB,mBAAmB;GAC9C,MAAM,KAAK,UAAU;IAAE,MAAM;IAAQ;GAAO,CAAC;EAC9C,CAAC;CACF,SAAS,OAAO;EACf,OAAO;GAAE,IAAI;GAAO,SAAS,iBAAiB,QAAQ,MAAM,UAAU;EAAgB;CACvF;CACA,IAAI,SAAS,IAAI;EAEhB,MAAM,MAAK,MADS,SAAS,KAAK,EAAE,aAAa,CAAC,EAAE,GACpC,KAAK;EACrB,OAAO;GAAE,IAAI;GAAM,cAAc,OAAO,KAAA,IAAY,KAAA,IAAY,OAAO,EAAE;EAAE;CAC5E;CACA,IAAI,SAAS,WAAW,KAAK;EAC5B,MAAM,OAAQ,MAAM,SAAS,KAAK,EAAE,aAAa,CAAC,EAAE;EACpD,MAAM,cAAc,cAAc,IAAI;EACtC,IAAI,OAAO,KAAK,WAAW,EAAE,SAAS,GACrC,OAAO;GAAE,IAAI;GAAO;EAAY;EAEjC,OAAO;GAAE,IAAI;GAAO,SAAS,KAAK,SAAS,IAAI,WAAW;EAAoB;CAC/E;CACA,OAAO;EAAE,IAAI;EAAO,SAAS,mBAAmB,SAAS,OAAO;CAAG;AACpE"}

package/dist/react/uploadFile.d.ts

@@ -0,0 +1,23 @@
+//#region src/react/uploadFile.d.ts
+type UploadFileInput = {
+  file: File; /** Upload collection slug. File fields carry it as the server-stamped `collection` block config. */
+  collection: string;
+  apiRoute?: string;
+  fetchImpl?: typeof fetch;
+};
+type UploadFileResult = {
+  ok: true;
+  id: string | number;
+} | {
+  ok: false;
+  message?: string;
+};
+/**
+ * Upload one file to a Payload upload collection (`POST {apiRoute}/{collection}`, multipart) and return its
+ * id, which the file field stores as its value. The server re-derives the file metadata from the stored doc
+ * at submit, so the client is never trusted for it. Pure: inject `fetchImpl` in tests.
+ */
+declare const uploadFile: (input: UploadFileInput) => Promise<UploadFileResult>;
+//#endregion
+export { UploadFileInput, UploadFileResult, uploadFile };
+//# sourceMappingURL=uploadFile.d.ts.map