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

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 { useId } from 'react'\nimport { defineFieldRenderer } from '../contract'\nimport { FieldShell } from '../primitives/FieldShell'\nimport { Textarea } from '../primitives/Textarea'\n\nexport const textareaRenderer = defineFieldRenderer<string>(\n\t({ field, name, value, onChange, onBlur, errors, warnings, required, disabled }) => {\n\t\tconst id = useId()\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\twarnings={warnings}\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":";;;;;;;AAOA,MAAa,mBAAmB,qBAC9B,EAAE,OAAO,MAAM,OAAO,UAAU,QAAQ,QAAQ,UAAU,UAAU,eAAe;CACnF,MAAM,KAAK,MAAM;CACjB,MAAM,gBAAgB,GAAG,GAAG;CAC5B,OACC,oBAAC,YAAD;EACK;EACJ,OAAO,MAAM;EACb,aAAa,OAAO,MAAM,gBAAgB,WAAW,MAAM,cAAc,KAAA;EAC/D;EACF;EACE;EACK;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,15 @@
+//#region src/react/state.d.ts
+type FieldErrors = Record<string, string[]>;
+type FormState = {
+  values: Record<string, unknown>;
+  errors: FieldErrors;
+  warnings: FieldErrors;
+  touched: Record<string, boolean>;
+  submitting: boolean;
+  submitted: boolean;
+  submitAttempted: boolean;
+  submitError?: string;
+};
+//#endregion
+export { FormState };
+//# sourceMappingURL=state.d.ts.map

package/dist/react/state.js

@@ -0,0 +1,70 @@
+//#region src/react/state.ts
+const initialFormState = (values) => ({
+	values,
+	errors: {},
+	warnings: {},
+	touched: {},
+	submitting: false,
+	submitted: false,
+	submitAttempted: false
+});
+/** 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
+			},
+			warnings: {
+				...state.warnings,
+				[action.name]: action.warnings
+			}
+		};
+		case "SET_ALL_ISSUES": return {
+			...state,
+			errors: action.errors,
+			warnings: action.warnings,
+			submitAttempted: true
+		};
+		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
+		};
+		default: return state;
+	}
+};
+//#endregion
+export { formReducer, initialFormState };
+
+//# 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":["export type FieldErrors = Record<string, string[]>\n\nexport type FormState = {\n\tvalues: Record<string, unknown>\n\terrors: FieldErrors\n\twarnings: FieldErrors\n\ttouched: Record<string, boolean>\n\tsubmitting: boolean\n\tsubmitted: boolean\n\tsubmitAttempted: boolean\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[]; warnings: string[] }\n\t| { type: 'SET_ALL_ISSUES'; errors: FieldErrors; warnings: FieldErrors }\n\t| { type: 'SUBMIT_START' }\n\t| { type: 'SUBMIT_SUCCESS' }\n\t| { type: 'SUBMIT_ERROR'; message: string }\n\nexport const initialFormState = (values: Record<string, unknown>): FormState => ({\n\tvalues,\n\terrors: {},\n\twarnings: {},\n\ttouched: {},\n\tsubmitting: false,\n\tsubmitted: false,\n\tsubmitAttempted: false,\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\twarnings: { ...state.warnings, [action.name]: action.warnings },\n\t\t\t}\n\t\tcase 'SET_ALL_ISSUES':\n\t\t\treturn { ...state, errors: action.errors, warnings: action.warnings, submitAttempted: true }\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\tdefault:\n\t\t\treturn state\n\t}\n}\n"],"mappings":";AAsBA,MAAa,oBAAoB,YAAgD;CAChF;CACA,QAAQ,CAAC;CACT,UAAU,CAAC;CACX,SAAS,CAAC;CACV,YAAY;CACZ,WAAW;CACX,iBAAiB;AAClB;;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;GACxD,UAAU;IAAE,GAAG,MAAM;KAAW,OAAO,OAAO,OAAO;GAAS;EAC/D;EACD,KAAK,kBACJ,OAAO;GAAE,GAAG;GAAO,QAAQ,OAAO;GAAQ,UAAU,OAAO;GAAU,iBAAiB;EAAK;EAC5F,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,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/toFormDocument.d.ts

@@ -0,0 +1,24 @@
+import { FormDocument } from "./Form.js";
+
+//#region src/react/toFormDocument.d.ts
+/**
+ * Narrows a Payload-generated form document (from `getPayload().findByID()` or `fetch`) to
+ * `FormDocument` without an unsafe `as` cast. Handles the small structural mismatches between
+ * the auto-generated collection types and what `<Form>` expects:
+ * - `fields` may be a typed blocks-union array or null; normalized to `FormFieldInstance[]`
+ * - `flow` is stored as opaque JSON; typed as `FormFlow | undefined`
+ * - `defaultPresentation` may be null; coerced to `undefined`
+ */
+declare function toFormDocument(form: {
+  id: number | string;
+  fields?: {
+    blockType: string;
+    name: string;
+    [key: string]: unknown;
+  }[] | null;
+  flow?: unknown;
+  defaultPresentation?: string | null;
+}): FormDocument;
+//#endregion
+export { toFormDocument };
+//# sourceMappingURL=toFormDocument.d.ts.map

package/dist/react/toFormDocument.js

@@ -0,0 +1,22 @@
+"use client";
+//#region src/react/toFormDocument.ts
+/**
+* Narrows a Payload-generated form document (from `getPayload().findByID()` or `fetch`) to
+* `FormDocument` without an unsafe `as` cast. Handles the small structural mismatches between
+* the auto-generated collection types and what `<Form>` expects:
+* - `fields` may be a typed blocks-union array or null; normalized to `FormFieldInstance[]`
+* - `flow` is stored as opaque JSON; typed as `FormFlow | undefined`
+* - `defaultPresentation` may be null; coerced to `undefined`
+*/
+function toFormDocument(form) {
+	return {
+		id: form.id,
+		fields: form.fields ?? [],
+		flow: form.flow,
+		defaultPresentation: form.defaultPresentation ?? void 0
+	};
+}
+//#endregion
+export { toFormDocument };
+
+//# sourceMappingURL=toFormDocument.js.map

package/dist/react/toFormDocument.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toFormDocument.js","names":[],"sources":["../../src/react/toFormDocument.ts"],"sourcesContent":["'use client'\n\nimport type { FormFlow } from '../flow/types'\nimport type { FormFieldInstance } from '../submissions/types'\nimport type { FormDocument } from './Form'\n\n/**\n * Narrows a Payload-generated form document (from `getPayload().findByID()` or `fetch`) to\n * `FormDocument` without an unsafe `as` cast. Handles the small structural mismatches between\n * the auto-generated collection types and what `<Form>` expects:\n * - `fields` may be a typed blocks-union array or null; normalized to `FormFieldInstance[]`\n * - `flow` is stored as opaque JSON; typed as `FormFlow | undefined`\n * - `defaultPresentation` may be null; coerced to `undefined`\n */\nexport function toFormDocument(form: {\n\tid: number | string\n\tfields?: { blockType: string; name: string; [key: string]: unknown }[] | null\n\tflow?: unknown\n\tdefaultPresentation?: string | null\n}): FormDocument {\n\treturn {\n\t\tid: form.id,\n\t\tfields: (form.fields ?? []) as FormFieldInstance[],\n\t\tflow: form.flow as FormFlow | undefined,\n\t\tdefaultPresentation: form.defaultPresentation ?? undefined,\n\t}\n}\n"],"mappings":";;;;;;;;;;AAcA,SAAgB,eAAe,MAKd;CAChB,OAAO;EACN,IAAI,KAAK;EACT,QAAS,KAAK,UAAU,CAAC;EACzB,MAAM,KAAK;EACX,qBAAqB,KAAK,uBAAuB,KAAA;CAClD;AACD"}

package/dist/react/uploadFile.d.ts

@@ -0,0 +1,23 @@
+//#region src/react/uploadFile.d.ts
+type UploadFileInput = {
+  file: File; /** Upload collection slug. Defaults to `form-uploads`. */
+  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

package/dist/react/uploadFile.js

@@ -0,0 +1,39 @@
+//#region src/react/uploadFile.ts
+/**
+* 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.
+*/
+const uploadFile = async (input) => {
+	const { file, collection = "form-uploads", apiRoute = "/api", fetchImpl = fetch } = input;
+	const body = new FormData();
+	body.append("file", file);
+	let response;
+	try {
+		response = await fetchImpl(`${apiRoute}/${collection}`, {
+			method: "POST",
+			body
+		});
+	} catch (error) {
+		return {
+			ok: false,
+			message: error instanceof Error ? error.message : "Network error"
+		};
+	}
+	if (!response.ok) return {
+		ok: false,
+		message: `Upload failed (${response.status})`
+	};
+	const id = (await response.json().catch(() => ({}))).doc?.id;
+	return id == null ? {
+		ok: false,
+		message: "No id returned"
+	} : {
+		ok: true,
+		id
+	};
+};
+//#endregion
+export { uploadFile };
+
+//# sourceMappingURL=uploadFile.js.map

package/dist/react/uploadFile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uploadFile.js","names":[],"sources":["../../src/react/uploadFile.ts"],"sourcesContent":["export type UploadFileInput = {\n\tfile: File\n\t/** Upload collection slug. Defaults to `form-uploads`. */\n\tcollection?: string\n\tapiRoute?: string\n\tfetchImpl?: typeof fetch\n}\n\nexport type UploadFileResult = { ok: true; id: string | number } | { ok: false; message?: string }\n\n/**\n * Upload one file to a Payload upload collection (`POST {apiRoute}/{collection}`, multipart) and return its\n * id, which the file field stores as its value. The server re-derives the file metadata from the stored doc\n * at submit, so the client is never trusted for it. Pure: inject `fetchImpl` in tests.\n */\nexport const uploadFile = async (input: UploadFileInput): Promise<UploadFileResult> => {\n\tconst { file, collection = 'form-uploads', apiRoute = '/api', fetchImpl = fetch } = input\n\tconst body = new FormData()\n\tbody.append('file', file)\n\tlet response: Response\n\ttry {\n\t\tresponse = await fetchImpl(`${apiRoute}/${collection}`, { method: 'POST', body })\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\treturn { ok: false, message: `Upload failed (${response.status})` }\n\t}\n\tconst data = (await response.json().catch(() => ({}))) as { doc?: { id?: string | number } }\n\tconst id = data.doc?.id\n\treturn id == null ? { ok: false, message: 'No id returned' } : { ok: true, id }\n}\n"],"mappings":";;;;;;AAeA,MAAa,aAAa,OAAO,UAAsD;CACtF,MAAM,EAAE,MAAM,aAAa,gBAAgB,WAAW,QAAQ,YAAY,UAAU;CACpF,MAAM,OAAO,IAAI,SAAS;CAC1B,KAAK,OAAO,QAAQ,IAAI;CACxB,IAAI;CACJ,IAAI;EACH,WAAW,MAAM,UAAU,GAAG,SAAS,GAAG,cAAc;GAAE,QAAQ;GAAQ;EAAK,CAAC;CACjF,SAAS,OAAO;EACf,OAAO;GAAE,IAAI;GAAO,SAAS,iBAAiB,QAAQ,MAAM,UAAU;EAAgB;CACvF;CACA,IAAI,CAAC,SAAS,IACb,OAAO;EAAE,IAAI;EAAO,SAAS,kBAAkB,SAAS,OAAO;CAAG;CAGnE,MAAM,MAAK,MADS,SAAS,KAAK,EAAE,aAAa,CAAC,EAAE,GACpC,KAAK;CACrB,OAAO,MAAM,OAAO;EAAE,IAAI;EAAO,SAAS;CAAiB,IAAI;EAAE,IAAI;EAAM;CAAG;AAC/E"}

package/dist/react/useField.d.ts

@@ -0,0 +1,14 @@
+//#region src/react/useField.d.ts
+type UseFieldResult<TValue = unknown> = {
+  value: TValue | undefined;
+  errors: string[];
+  warnings: string[];
+  touched: boolean;
+  setValue: (value: TValue) => void; /** Mark touched and validate now (call on blur). */
+  onBlur: () => void;
+};
+/** Bind one field by name to the form controller: its value, issues, and change/blur handlers. */
+declare const useField: <TValue = unknown>(name: string) => UseFieldResult<TValue>;
+//#endregion
+export { UseFieldResult, useField };
+//# sourceMappingURL=useField.d.ts.map

package/dist/react/useField.js

@@ -0,0 +1,49 @@
+"use client";
+import { useFormContext } from "./FormContext.js";
+import { useCallback } from "react";
+//#region src/react/useField.ts
+/** Bind one field by name to the form controller: its value, issues, and change/blur handlers. */
+const useField = (name) => {
+	const { state, dispatch, validateField } = useFormContext();
+	const touched = state.touched[name] ?? false;
+	const showIssues = touched || state.submitAttempted;
+	const value = state.values[name];
+	const setValue = useCallback((next) => {
+		dispatch({
+			type: "SET_VALUE",
+			name,
+			value: next
+		});
+		if (touched || state.submitAttempted) validateField(name, next);
+	}, [
+		dispatch,
+		name,
+		touched,
+		state.submitAttempted,
+		validateField
+	]);
+	const onBlur = useCallback(() => {
+		dispatch({
+			type: "TOUCH",
+			name
+		});
+		validateField(name, value);
+	}, [
+		dispatch,
+		name,
+		validateField,
+		value
+	]);
+	return {
+		value,
+		errors: showIssues ? state.errors[name] ?? [] : [],
+		warnings: showIssues ? state.warnings[name] ?? [] : [],
+		touched,
+		setValue,
+		onBlur
+	};
+};
+//#endregion
+export { useField };
+
+//# sourceMappingURL=useField.js.map

package/dist/react/useField.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useField.js","names":[],"sources":["../../src/react/useField.ts"],"sourcesContent":["'use client'\n\nimport { useCallback } from 'react'\nimport { useFormContext } from './FormContext'\n\nexport type UseFieldResult<TValue = unknown> = {\n\tvalue: TValue | undefined\n\terrors: string[]\n\twarnings: string[]\n\ttouched: boolean\n\tsetValue: (value: TValue) => void\n\t/** Mark touched and validate now (call on blur). */\n\tonBlur: () => void\n}\n\n/** Bind one field by name to the form controller: its value, issues, and change/blur handlers. */\nexport const useField = <TValue = unknown>(name: string): UseFieldResult<TValue> => {\n\tconst { state, dispatch, validateField } = useFormContext()\n\tconst touched = state.touched[name] ?? false\n\tconst showIssues = touched || state.submitAttempted\n\tconst value = state.values[name] as TValue | undefined\n\n\tconst setValue = useCallback(\n\t\t(next: TValue) => {\n\t\t\tdispatch({ type: 'SET_VALUE', name, value: next })\n\t\t\tif (touched || state.submitAttempted) {\n\t\t\t\tvalidateField(name, next)\n\t\t\t}\n\t\t},\n\t\t[dispatch, name, touched, state.submitAttempted, validateField]\n\t)\n\n\tconst onBlur = useCallback(() => {\n\t\tdispatch({ type: 'TOUCH', name })\n\t\tvalidateField(name, value)\n\t}, [dispatch, name, validateField, value])\n\n\treturn {\n\t\tvalue,\n\t\terrors: showIssues ? (state.errors[name] ?? []) : [],\n\t\twarnings: showIssues ? (state.warnings[name] ?? []) : [],\n\t\ttouched,\n\t\tsetValue,\n\t\tonBlur,\n\t}\n}\n"],"mappings":";;;;;AAgBA,MAAa,YAA8B,SAAyC;CACnF,MAAM,EAAE,OAAO,UAAU,kBAAkB,eAAe;CAC1D,MAAM,UAAU,MAAM,QAAQ,SAAS;CACvC,MAAM,aAAa,WAAW,MAAM;CACpC,MAAM,QAAQ,MAAM,OAAO;CAE3B,MAAM,WAAW,aACf,SAAiB;EACjB,SAAS;GAAE,MAAM;GAAa;GAAM,OAAO;EAAK,CAAC;EACjD,IAAI,WAAW,MAAM,iBACpB,cAAc,MAAM,IAAI;CAE1B,GACA;EAAC;EAAU;EAAM;EAAS,MAAM;EAAiB;CAAa,CAC/D;CAEA,MAAM,SAAS,kBAAkB;EAChC,SAAS;GAAE,MAAM;GAAS;EAAK,CAAC;EAChC,cAAc,MAAM,KAAK;CAC1B,GAAG;EAAC;EAAU;EAAM;EAAe;CAAK,CAAC;CAEzC,OAAO;EACN;EACA,QAAQ,aAAc,MAAM,OAAO,SAAS,CAAC,IAAK,CAAC;EACnD,UAAU,aAAc,MAAM,SAAS,SAAS,CAAC,IAAK,CAAC;EACvD;EACA;EACA;CACD;AACD"}

package/dist/react/useFormState.d.ts

@@ -0,0 +1,8 @@
+import { FormState } from "./state.js";
+
+//#region src/react/useFormState.d.ts
+/** The whole form state (values, errors, warnings, touched, submitting, submitted, submitError). */
+declare const useFormState: () => FormState;
+//#endregion
+export { useFormState };
+//# sourceMappingURL=useFormState.d.ts.map

package/dist/react/useFormState.js

@@ -0,0 +1,9 @@
+"use client";
+import { useFormContext } from "./FormContext.js";
+//#region src/react/useFormState.ts
+/** The whole form state (values, errors, warnings, touched, submitting, submitted, submitError). */
+const useFormState = () => useFormContext().state;
+//#endregion
+export { useFormState };
+
+//# sourceMappingURL=useFormState.js.map

package/dist/react/useFormState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFormState.js","names":[],"sources":["../../src/react/useFormState.ts"],"sourcesContent":["'use client'\n\nimport { useFormContext } from './FormContext'\nimport type { FormState } from './state'\n\n/** The whole form state (values, errors, warnings, touched, submitting, submitted, submitError). */\nexport const useFormState = (): FormState => useFormContext().state\n"],"mappings":";;;;AAMA,MAAa,qBAAgC,eAAe,EAAE"}

package/dist/react/useFormStep.d.ts

@@ -0,0 +1,8 @@
+import { FormStepInfo } from "./FormContext.js";
+
+//#region src/react/useFormStep.d.ts
+/** Multi-step navigation state for the current form (single-step default when the form has no flow). */
+declare const useFormStep: () => FormStepInfo;
+//#endregion
+export { useFormStep };
+//# sourceMappingURL=useFormStep.d.ts.map

package/dist/react/useFormStep.js

@@ -0,0 +1,9 @@
+"use client";
+import { useFormContext } from "./FormContext.js";
+//#region src/react/useFormStep.ts
+/** Multi-step navigation state for the current form (single-step default when the form has no flow). */
+const useFormStep = () => useFormContext().step;
+//#endregion
+export { useFormStep };
+
+//# sourceMappingURL=useFormStep.js.map

package/dist/react/useFormStep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFormStep.js","names":[],"sources":["../../src/react/useFormStep.ts"],"sourcesContent":["'use client'\n\nimport type { FormStepInfo } from './FormContext'\nimport { useFormContext } from './FormContext'\n\n/** Multi-step navigation state for the current form (single-step default when the form has no flow). */\nexport const useFormStep = (): FormStepInfo => useFormContext().step\n"],"mappings":";;;;AAMA,MAAa,oBAAkC,eAAe,EAAE"}

package/dist/react/validateField.js

@@ -0,0 +1,30 @@
+import { runValidation } from "../validation/runValidation.js";
+//#region src/react/validateField.ts
+/**
+* Run client-side validation for one field, reusing the shared engine in `mode: 'client'` (server-only
+* rules are skipped, no `req`/`payload`). Splits issues into blocking errors and advisory warnings.
+*/
+const validateFieldValue = async (input) => {
+	const { field, value, registry, ruleRegistry, answers, locale, t } = input;
+	const { errors: issues } = await runValidation({
+		field,
+		fieldDefinition: registry.get(field.blockType),
+		value,
+		fieldType: field.blockType,
+		ruleRegistry,
+		answers,
+		locale,
+		t,
+		operation: "create",
+		event: "onChange",
+		mode: "client"
+	});
+	return {
+		errors: issues.filter((issue) => issue.severity === "error").map((issue) => issue.message),
+		warnings: issues.filter((issue) => issue.severity === "warning").map((issue) => issue.message)
+	};
+};
+//#endregion
+export { validateFieldValue };
+
+//# sourceMappingURL=validateField.js.map

package/dist/react/validateField.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validateField.js","names":[],"sources":["../../src/react/validateField.ts"],"sourcesContent":["import type { FieldTypeRegistry } from '../fields/registry'\nimport type { Translate } from '../fields/types'\nimport type { FormFieldInstance } from '../submissions/types'\nimport type { ValidationRuleRegistry } from '../validation/registry'\nimport { runValidation } from '../validation/runValidation'\n\nexport type ValidateFieldInput = {\n\tfield: FormFieldInstance\n\tvalue: unknown\n\tregistry: FieldTypeRegistry\n\truleRegistry: ValidationRuleRegistry\n\tanswers: Record<string, unknown>\n\tlocale: string\n\tt: Translate\n}\n\nexport type ValidateFieldResult = { errors: string[]; warnings: string[] }\n\n/**\n * Run client-side validation for one field, reusing the shared engine in `mode: 'client'` (server-only\n * rules are skipped, no `req`/`payload`). Splits issues into blocking errors and advisory warnings.\n */\nexport const validateFieldValue = async (\n\tinput: ValidateFieldInput\n): Promise<ValidateFieldResult> => {\n\tconst { field, value, registry, ruleRegistry, answers, locale, t } = input\n\tconst { errors: issues } = await runValidation({\n\t\tfield,\n\t\tfieldDefinition: registry.get(field.blockType),\n\t\tvalue,\n\t\tfieldType: field.blockType,\n\t\truleRegistry,\n\t\tanswers,\n\t\tlocale,\n\t\tt,\n\t\toperation: 'create',\n\t\tevent: 'onChange',\n\t\tmode: 'client',\n\t})\n\treturn {\n\t\terrors: issues.filter((issue) => issue.severity === 'error').map((issue) => issue.message),\n\t\twarnings: issues.filter((issue) => issue.severity === 'warning').map((issue) => issue.message),\n\t}\n}\n"],"mappings":";;;;;;AAsBA,MAAa,qBAAqB,OACjC,UACkC;CAClC,MAAM,EAAE,OAAO,OAAO,UAAU,cAAc,SAAS,QAAQ,MAAM;CACrE,MAAM,EAAE,QAAQ,WAAW,MAAM,cAAc;EAC9C;EACA,iBAAiB,SAAS,IAAI,MAAM,SAAS;EAC7C;EACA,WAAW,MAAM;EACjB;EACA;EACA;EACA;EACA,WAAW;EACX,OAAO;EACP,MAAM;CACP,CAAC;CACD,OAAO;EACN,QAAQ,OAAO,QAAQ,UAAU,MAAM,aAAa,OAAO,EAAE,KAAK,UAAU,MAAM,OAAO;EACzF,UAAU,OAAO,QAAQ,UAAU,MAAM,aAAa,SAAS,EAAE,KAAK,UAAU,MAAM,OAAO;CAC9F;AACD"}

package/dist/recall/interpolate.d.ts

@@ -0,0 +1,10 @@
+//#region src/recall/interpolate.d.ts
+/**
+ * Replace `{{ name }}` and `{{ name|fallback }}` tokens. `resolve` returns the recalled value (''
+ * when absent); the fallback (or '') is substituted when `resolve` yields ''. Token-free input is
+ * returned unchanged, so this is a no-op for ordinary text.
+ */
+declare const interpolate: (template: string, resolve: (name: string) => string) => string;
+//#endregion
+export { interpolate };
+//# sourceMappingURL=interpolate.d.ts.map

package/dist/recall/interpolate.js

@@ -0,0 +1,16 @@
+//#region src/recall/interpolate.ts
+const TOKEN = /\{\{\s*([^{}|]+?)\s*(?:\|([^{}]*?))?\}\}/g;
+/**
+* Replace `{{ name }}` and `{{ name|fallback }}` tokens. `resolve` returns the recalled value (''
+* when absent); the fallback (or '') is substituted when `resolve` yields ''. Token-free input is
+* returned unchanged, so this is a no-op for ordinary text.
+*/
+const interpolate = (template, resolve) => template.replace(TOKEN, (_match, rawName, rawFallback) => {
+	const value = resolve(rawName.trim());
+	if (value !== "") return value;
+	return rawFallback === void 0 ? "" : rawFallback.trim();
+});
+//#endregion
+export { interpolate };
+
+//# sourceMappingURL=interpolate.js.map

package/dist/recall/interpolate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"interpolate.js","names":[],"sources":["../../src/recall/interpolate.ts"],"sourcesContent":["const TOKEN = /\\{\\{\\s*([^{}|]+?)\\s*(?:\\|([^{}]*?))?\\}\\}/g\n\n/**\n * Replace `{{ name }}` and `{{ name|fallback }}` tokens. `resolve` returns the recalled value (''\n * when absent); the fallback (or '') is substituted when `resolve` yields ''. Token-free input is\n * returned unchanged, so this is a no-op for ordinary text.\n */\nexport const interpolate = (template: string, resolve: (name: string) => string): string =>\n\ttemplate.replace(TOKEN, (_match, rawName: string, rawFallback?: string) => {\n\t\tconst value = resolve(rawName.trim())\n\t\tif (value !== '') {\n\t\t\treturn value\n\t\t}\n\t\treturn rawFallback === undefined ? '' : rawFallback.trim()\n\t})\n"],"mappings":";AAAA,MAAM,QAAQ;;;;;;AAOd,MAAa,eAAe,UAAkB,YAC7C,SAAS,QAAQ,QAAQ,QAAQ,SAAiB,gBAAyB;CAC1E,MAAM,QAAQ,QAAQ,QAAQ,KAAK,CAAC;CACpC,IAAI,UAAU,IACb,OAAO;CAER,OAAO,gBAAgB,KAAA,IAAY,KAAK,YAAY,KAAK;AAC1D,CAAC"}

package/dist/recall/resolver.d.ts

@@ -0,0 +1,22 @@
+import { AnyFormFieldDefinition } from "../fields/types.js";
+import { FormFieldInstance } from "../submissions/types.js";
+
+//#region src/recall/resolver.d.ts
+type RecallResolver = (name: string) => string;
+/** Derive a value->label map from a select-like field instance's `options`. */
+declare const optionLabelsFor: (field: FormFieldInstance) => Record<string, string> | undefined;
+/**
+ * Build a recall resolver: `{{name}}` -> the field's current value, formatted via its type's `format`
+ * (so a select shows its option label, a checkbox Yes/No, a date localized). Missing field or empty
+ * value -> ''. Pure and isomorphic; the renderer and server templates share it.
+ */
+declare const buildRecallResolver: (args: {
+  fields: FormFieldInstance[];
+  values: Record<string, unknown>;
+  registry: Map<string, AnyFormFieldDefinition>;
+  locale: string;
+  t: (key: string) => string;
+}) => RecallResolver;
+//#endregion
+export { RecallResolver, buildRecallResolver, optionLabelsFor };
+//# sourceMappingURL=resolver.d.ts.map

package/dist/recall/resolver.js

@@ -0,0 +1,36 @@
+//#region src/recall/resolver.ts
+/** Derive a value->label map from a select-like field instance's `options`. */
+const optionLabelsFor = (field) => {
+	const options = field.options;
+	if (!Array.isArray(options)) return;
+	const map = {};
+	for (const option of options) if (option && typeof option.value === "string") map[option.value] = option.label ?? option.value;
+	return Object.keys(map).length > 0 ? map : void 0;
+};
+/**
+* Build a recall resolver: `{{name}}` -> the field's current value, formatted via its type's `format`
+* (so a select shows its option label, a checkbox Yes/No, a date localized). Missing field or empty
+* value -> ''. Pure and isomorphic; the renderer and server templates share it.
+*/
+const buildRecallResolver = (args) => {
+	const byName = new Map(args.fields.map((field) => [field.name, field]));
+	return (name) => {
+		const field = byName.get(name);
+		if (!field) return "";
+		const value = args.values[name];
+		if (value == null || value === "" || Array.isArray(value) && value.length === 0) return "";
+		const definition = args.registry.get(field.blockType);
+		if (definition?.format) return definition.format({
+			value,
+			config: {},
+			optionLabels: optionLabelsFor(field),
+			locale: args.locale,
+			t: args.t
+		});
+		return Array.isArray(value) ? value.join(", ") : String(value);
+	};
+};
+//#endregion
+export { buildRecallResolver, optionLabelsFor };
+
+//# sourceMappingURL=resolver.js.map

package/dist/recall/resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolver.js","names":[],"sources":["../../src/recall/resolver.ts"],"sourcesContent":["import type { AnyFormFieldDefinition } from '../fields/types'\nimport type { FormFieldInstance } from '../submissions/types'\n\nexport type RecallResolver = (name: string) => string\n\ntype Option = { label?: string; value?: string }\n\n/** Derive a value->label map from a select-like field instance's `options`. */\nexport const optionLabelsFor = (field: FormFieldInstance): Record<string, string> | undefined => {\n\tconst options = field.options\n\tif (!Array.isArray(options)) {\n\t\treturn undefined\n\t}\n\tconst map: Record<string, string> = {}\n\tfor (const option of options as Option[]) {\n\t\tif (option && typeof option.value === 'string') {\n\t\t\tmap[option.value] = option.label ?? option.value\n\t\t}\n\t}\n\treturn Object.keys(map).length > 0 ? map : undefined\n}\n\n/**\n * Build a recall resolver: `{{name}}` -> the field's current value, formatted via its type's `format`\n * (so a select shows its option label, a checkbox Yes/No, a date localized). Missing field or empty\n * value -> ''. Pure and isomorphic; the renderer and server templates share it.\n */\nexport const buildRecallResolver = (args: {\n\tfields: FormFieldInstance[]\n\tvalues: Record<string, unknown>\n\tregistry: Map<string, AnyFormFieldDefinition>\n\tlocale: string\n\tt: (key: string) => string\n}): RecallResolver => {\n\tconst byName = new Map(args.fields.map((field) => [field.name, field]))\n\treturn (name) => {\n\t\tconst field = byName.get(name)\n\t\tif (!field) {\n\t\t\treturn ''\n\t\t}\n\t\tconst value = args.values[name]\n\t\tif (value == null || value === '' || (Array.isArray(value) && value.length === 0)) {\n\t\t\treturn ''\n\t\t}\n\t\tconst definition = args.registry.get(field.blockType)\n\t\tif (definition?.format) {\n\t\t\treturn definition.format({\n\t\t\t\tvalue,\n\t\t\t\tconfig: {},\n\t\t\t\toptionLabels: optionLabelsFor(field),\n\t\t\t\tlocale: args.locale,\n\t\t\t\tt: args.t,\n\t\t\t})\n\t\t}\n\t\treturn Array.isArray(value) ? value.join(', ') : String(value)\n\t}\n}\n"],"mappings":";;AAQA,MAAa,mBAAmB,UAAiE;CAChG,MAAM,UAAU,MAAM;CACtB,IAAI,CAAC,MAAM,QAAQ,OAAO,GACzB;CAED,MAAM,MAA8B,CAAC;CACrC,KAAK,MAAM,UAAU,SACpB,IAAI,UAAU,OAAO,OAAO,UAAU,UACrC,IAAI,OAAO,SAAS,OAAO,SAAS,OAAO;CAG7C,OAAO,OAAO,KAAK,GAAG,EAAE,SAAS,IAAI,MAAM,KAAA;AAC5C;;;;;;AAOA,MAAa,uBAAuB,SAMd;CACrB,MAAM,SAAS,IAAI,IAAI,KAAK,OAAO,KAAK,UAAU,CAAC,MAAM,MAAM,KAAK,CAAC,CAAC;CACtE,QAAQ,SAAS;EAChB,MAAM,QAAQ,OAAO,IAAI,IAAI;EAC7B,IAAI,CAAC,OACJ,OAAO;EAER,MAAM,QAAQ,KAAK,OAAO;EAC1B,IAAI,SAAS,QAAQ,UAAU,MAAO,MAAM,QAAQ,KAAK,KAAK,MAAM,WAAW,GAC9E,OAAO;EAER,MAAM,aAAa,KAAK,SAAS,IAAI,MAAM,SAAS;EACpD,IAAI,YAAY,QACf,OAAO,WAAW,OAAO;GACxB;GACA,QAAQ,CAAC;GACT,cAAc,gBAAgB,KAAK;GACnC,QAAQ,KAAK;GACb,GAAG,KAAK;EACT,CAAC;EAEF,OAAO,MAAM,QAAQ,KAAK,IAAI,MAAM,KAAK,IAAI,IAAI,OAAO,KAAK;CAC9D;AACD"}

package/dist/spam/captcha.d.ts

@@ -0,0 +1,12 @@
+import { CaptchaProvider } from "./types.js";
+
+//#region src/spam/captcha.d.ts
+/**
+ * Identity helper for authoring a captcha provider (mirrors `defineAction`/`defineConsentSource`).
+ * v1 ships no built-in provider; a project supplies one (Turnstile/reCAPTCHA/hCaptcha) and the submit
+ * path verifies a token carried on the submission. Prebuilt providers are a v1.x addition.
+ */
+declare const defineCaptchaProvider: (provider: CaptchaProvider) => CaptchaProvider;
+//#endregion
+export { defineCaptchaProvider };
+//# sourceMappingURL=captcha.d.ts.map