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

package/dist/fields/localizedIf.d.ts

@@ -0,0 +1,13 @@
+//#region src/fields/localizedIf.d.ts
+/**
+ * Spreadable localization flag: `{ localized: true }` when `localize` is true, an empty object
+ * otherwise, so `...localizedIf(flag)` adds the key only when wanted. Payload itself strips
+ * `localized` from fields when the host config has no `localization`, so spreading `true` is
+ * always safe.
+ */
+declare const localizedIf: (localize: boolean) => {
+  localized: true;
+} | Record<string, never>;
+//#endregion
+export { localizedIf };
+//# sourceMappingURL=localizedIf.d.ts.map

package/dist/fields/localizedIf.js

@@ -0,0 +1,12 @@
+//#region src/fields/localizedIf.ts
+/**
+* Spreadable localization flag: `{ localized: true }` when `localize` is true, an empty object
+* otherwise, so `...localizedIf(flag)` adds the key only when wanted. Payload itself strips
+* `localized` from fields when the host config has no `localization`, so spreading `true` is
+* always safe.
+*/
+const localizedIf = (localize) => localize ? { localized: true } : {};
+//#endregion
+export { localizedIf };
+
+//# sourceMappingURL=localizedIf.js.map

package/dist/fields/localizedIf.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"localizedIf.js","names":[],"sources":["../../src/fields/localizedIf.ts"],"sourcesContent":["/**\n * Spreadable localization flag: `{ localized: true }` when `localize` is true, an empty object\n * otherwise, so `...localizedIf(flag)` adds the key only when wanted. Payload itself strips\n * `localized` from fields when the host config has no `localization`, so spreading `true` is\n * always safe.\n */\nexport const localizedIf = (localize: boolean): { localized: true } | Record<string, never> =>\n\tlocalize ? { localized: true } : {}\n"],"mappings":";;;;;;;AAMA,MAAa,eAAe,aAC3B,WAAW,EAAE,WAAW,KAAK,IAAI,CAAC"}

package/dist/fields/sharedConfig.js

@@ -1,3 +1,4 @@
+import { localizedIf } from "./localizedIf.js";
 import { keys } from "../translations/keys.js";
 import { labelFor } from "../translations/server.js";
 //#region src/fields/sharedConfig.ts
@@ -14,72 +15,84 @@ const conditionField = (name, labelKey, conditionTypes) => ({
 /**
 * Config every field instance carries regardless of type. `name` is the machine key written into
 * submissions; `width` is stored for the layout grid. Field types add their own `config` after
-* these inside the Field tab (see `fieldBlockTabs`).
+* these inside the Field tab (see `fieldBlockTabs`). Content-bearing fields (`label`,
+* `placeholder`, `description`) are localized unless `localize` is false; identifiers and
+* behavior flags never are. The rows below are presentational only (unnamed, data paths stay
+* flat); `required` sits last, under `description`, per the admin layout.
 */
-const sharedFieldConfig = () => [
+const sharedFieldConfig = (localize = true) => [
 	{
-		name: "name",
-		type: "text",
-		required: true,
-		label: labelFor(keys.configName)
+		type: "row",
+		fields: [{
+			name: "name",
+			type: "text",
+			required: true,
+			label: labelFor(keys.configName),
+			admin: { width: "50%" }
+		}, {
+			name: "label",
+			type: "text",
+			label: labelFor(keys.configLabel),
+			admin: { width: "50%" },
+			...localizedIf(localize)
+		}]
 	},
 	{
-		name: "label",
-		type: "text",
-		label: labelFor(keys.configLabel)
-	},
-	{
-		name: "required",
-		type: "checkbox",
-		label: labelFor(keys.configRequired)
-	},
-	{
-		name: "width",
-		type: "select",
-		defaultValue: "full",
-		label: labelFor(keys.configWidth),
-		options: [
-			{
-				label: "Full",
-				value: "full"
-			},
-			{
-				label: "Half",
-				value: "half"
-			},
-			{
-				label: "Third",
-				value: "third"
+		type: "row",
+		fields: [{
+			name: "width",
+			type: "select",
+			required: true,
+			defaultValue: "full",
+			label: labelFor(keys.configWidth),
+			admin: {
+				width: "50%",
+				isClearable: false
 			},
-			{
-				label: "Two thirds",
-				value: "twoThirds"
-			}
-		]
-	},
-	{
-		name: "placeholder",
-		type: "text",
-		label: labelFor(keys.configPlaceholder)
+			options: [
+				{
+					label: "Full",
+					value: "full"
+				},
+				{
+					label: "Half",
+					value: "half"
+				},
+				{
+					label: "Third",
+					value: "third"
+				},
+				{
+					label: "Two thirds",
+					value: "twoThirds"
+				}
+			]
+		}, {
+			name: "placeholder",
+			type: "text",
+			label: labelFor(keys.configPlaceholder),
+			admin: { width: "50%" },
+			...localizedIf(localize)
+		}]
 	},
 	{
 		name: "description",
 		type: "textarea",
-		label: labelFor(keys.configDescription)
+		label: labelFor(keys.configDescription),
+		...localizedIf(localize)
+	},
+	{
+		name: "required",
+		type: "checkbox",
+		label: labelFor(keys.configRequired)
 	}
 ];
-/**
-* The single field of every field block: unnamed tabs (presentational only, data paths stay flat).
-* Field tab holds the shared basics plus the type's own config; Validation holds the rule blocks and
-* `validateWhen`; Advanced holds `visibleWhen` and `hidden`. `visibleWhen`/`validateWhen` store a
-* canonical Payload `Where`, edited by the native condition builder.
-*/
-const fieldBlockTabs = (conditionTypes, typeConfig, validations) => ({
+const fieldBlockTabs = ({ conditionTypes, typeConfig, validations, localize = true }) => ({
 	type: "tabs",
 	tabs: [
 		{
 			label: labelFor(keys.tabField),
-			fields: [...sharedFieldConfig(), ...typeConfig]
+			fields: [...sharedFieldConfig(localize), ...typeConfig]
 		},
 		{
 			label: labelFor(keys.tabValidation),

package/dist/fields/sharedConfig.js.map

@@ -1 +1 @@
-{"version":3,"file":"sharedConfig.js","names":[],"sources":["../../src/fields/sharedConfig.ts"],"sourcesContent":["import type { Field } from 'payload'\nimport type { ConditionFieldType } from '../conditions/fieldTypes'\nimport { keys } from '../translations/keys'\nimport { labelFor } from '../translations/server'\n\nconst CONDITION_FIELD_REF = '@10x-media/form-builder/client#FormConditionField'\n\nconst conditionField = (\n\tname: 'visibleWhen' | 'validateWhen',\n\tlabelKey: string,\n\tconditionTypes: Record<string, ConditionFieldType>\n): Field => ({\n\tname,\n\ttype: 'json',\n\tlabel: labelFor(labelKey),\n\tadmin: {\n\t\tcomponents: {\n\t\t\tField: { path: CONDITION_FIELD_REF, clientProps: { conditionTypes } },\n\t\t},\n\t},\n})\n\n/**\n * Config every field instance carries regardless of type. `name` is the machine key written into\n * submissions; `width` is stored for the layout grid. Field types add their own `config` after\n * these inside the Field tab (see `fieldBlockTabs`).\n */\nexport const sharedFieldConfig = (): Field[] => [\n\t{ name: 'name', type: 'text', required: true, label: labelFor(keys.configName) },\n\t{ name: 'label', type: 'text', label: labelFor(keys.configLabel) },\n\t{ name: 'required', type: 'checkbox', label: labelFor(keys.configRequired) },\n\t{\n\t\tname: 'width',\n\t\ttype: 'select',\n\t\tdefaultValue: 'full',\n\t\tlabel: labelFor(keys.configWidth),\n\t\toptions: [\n\t\t\t{ label: 'Full', value: 'full' },\n\t\t\t{ label: 'Half', value: 'half' },\n\t\t\t{ label: 'Third', value: 'third' },\n\t\t\t{ label: 'Two thirds', value: 'twoThirds' },\n\t\t],\n\t},\n\t{ name: 'placeholder', type: 'text', label: labelFor(keys.configPlaceholder) },\n\t{ name: 'description', type: 'textarea', label: labelFor(keys.configDescription) },\n]\n\n/**\n * The single field of every field block: unnamed tabs (presentational only, data paths stay flat).\n * Field tab holds the shared basics plus the type's own config; Validation holds the rule blocks and\n * `validateWhen`; Advanced holds `visibleWhen` and `hidden`. `visibleWhen`/`validateWhen` store a\n * canonical Payload `Where`, edited by the native condition builder.\n */\nexport const fieldBlockTabs = (\n\tconditionTypes: Record<string, ConditionFieldType>,\n\ttypeConfig: Field[],\n\tvalidations: Field\n): Field => ({\n\ttype: 'tabs',\n\ttabs: [\n\t\t{\n\t\t\tlabel: labelFor(keys.tabField),\n\t\t\tfields: [...sharedFieldConfig(), ...typeConfig],\n\t\t},\n\t\t{\n\t\t\tlabel: labelFor(keys.tabValidation),\n\t\t\tfields: [\n\t\t\t\tvalidations,\n\t\t\t\tconditionField('validateWhen', keys.configValidateWhen, conditionTypes),\n\t\t\t],\n\t\t},\n\t\t{\n\t\t\tlabel: labelFor(keys.tabAdvanced),\n\t\t\tfields: [\n\t\t\t\tconditionField('visibleWhen', keys.configVisibleWhen, conditionTypes),\n\t\t\t\t{ name: 'hidden', type: 'checkbox', label: labelFor(keys.configHidden) },\n\t\t\t],\n\t\t},\n\t],\n})\n"],"mappings":";;;AAKA,MAAM,sBAAsB;AAE5B,MAAM,kBACL,MACA,UACA,oBACY;CACZ;CACA,MAAM;CACN,OAAO,SAAS,QAAQ;CACxB,OAAO,EACN,YAAY,EACX,OAAO;EAAE,MAAM;EAAqB,aAAa,EAAE,eAAe;CAAE,EACrE,EACD;AACD;;;;;;AAOA,MAAa,0BAAmC;CAC/C;EAAE,MAAM;EAAQ,MAAM;EAAQ,UAAU;EAAM,OAAO,SAAS,KAAK,UAAU;CAAE;CAC/E;EAAE,MAAM;EAAS,MAAM;EAAQ,OAAO,SAAS,KAAK,WAAW;CAAE;CACjE;EAAE,MAAM;EAAY,MAAM;EAAY,OAAO,SAAS,KAAK,cAAc;CAAE;CAC3E;EACC,MAAM;EACN,MAAM;EACN,cAAc;EACd,OAAO,SAAS,KAAK,WAAW;EAChC,SAAS;GACR;IAAE,OAAO;IAAQ,OAAO;GAAO;GAC/B;IAAE,OAAO;IAAQ,OAAO;GAAO;GAC/B;IAAE,OAAO;IAAS,OAAO;GAAQ;GACjC;IAAE,OAAO;IAAc,OAAO;GAAY;EAC3C;CACD;CACA;EAAE,MAAM;EAAe,MAAM;EAAQ,OAAO,SAAS,KAAK,iBAAiB;CAAE;CAC7E;EAAE,MAAM;EAAe,MAAM;EAAY,OAAO,SAAS,KAAK,iBAAiB;CAAE;AAClF;;;;;;;AAQA,MAAa,kBACZ,gBACA,YACA,iBACY;CACZ,MAAM;CACN,MAAM;EACL;GACC,OAAO,SAAS,KAAK,QAAQ;GAC7B,QAAQ,CAAC,GAAG,kBAAkB,GAAG,GAAG,UAAU;EAC/C;EACA;GACC,OAAO,SAAS,KAAK,aAAa;GAClC,QAAQ,CACP,aACA,eAAe,gBAAgB,KAAK,oBAAoB,cAAc,CACvE;EACD;EACA;GACC,OAAO,SAAS,KAAK,WAAW;GAChC,QAAQ,CACP,eAAe,eAAe,KAAK,mBAAmB,cAAc,GACpE;IAAE,MAAM;IAAU,MAAM;IAAY,OAAO,SAAS,KAAK,YAAY;GAAE,CACxE;EACD;CACD;AACD"}
+{"version":3,"file":"sharedConfig.js","names":[],"sources":["../../src/fields/sharedConfig.ts"],"sourcesContent":["import type { Field } from 'payload'\nimport type { ConditionFieldType } from '../conditions/fieldTypes'\nimport { keys } from '../translations/keys'\nimport { labelFor } from '../translations/server'\nimport { localizedIf } from './localizedIf'\n\nconst CONDITION_FIELD_REF = '@10x-media/form-builder/client#FormConditionField'\n\nconst conditionField = (\n\tname: 'visibleWhen' | 'validateWhen',\n\tlabelKey: string,\n\tconditionTypes: Record<string, ConditionFieldType>\n): Field => ({\n\tname,\n\ttype: 'json',\n\tlabel: labelFor(labelKey),\n\tadmin: {\n\t\tcomponents: {\n\t\t\tField: { path: CONDITION_FIELD_REF, clientProps: { conditionTypes } },\n\t\t},\n\t},\n})\n\n/**\n * Config every field instance carries regardless of type. `name` is the machine key written into\n * submissions; `width` is stored for the layout grid. Field types add their own `config` after\n * these inside the Field tab (see `fieldBlockTabs`). Content-bearing fields (`label`,\n * `placeholder`, `description`) are localized unless `localize` is false; identifiers and\n * behavior flags never are. The rows below are presentational only (unnamed, data paths stay\n * flat); `required` sits last, under `description`, per the admin layout.\n */\nexport const sharedFieldConfig = (localize = true): Field[] => [\n\t{\n\t\ttype: 'row',\n\t\tfields: [\n\t\t\t{\n\t\t\t\tname: 'name',\n\t\t\t\ttype: 'text',\n\t\t\t\trequired: true,\n\t\t\t\tlabel: labelFor(keys.configName),\n\t\t\t\tadmin: { width: '50%' },\n\t\t\t},\n\t\t\t{\n\t\t\t\tname: 'label',\n\t\t\t\ttype: 'text',\n\t\t\t\tlabel: labelFor(keys.configLabel),\n\t\t\t\tadmin: { width: '50%' },\n\t\t\t\t...localizedIf(localize),\n\t\t\t},\n\t\t],\n\t},\n\t{\n\t\ttype: 'row',\n\t\tfields: [\n\t\t\t{\n\t\t\t\tname: 'width',\n\t\t\t\ttype: 'select',\n\t\t\t\trequired: true,\n\t\t\t\tdefaultValue: 'full',\n\t\t\t\tlabel: labelFor(keys.configWidth),\n\t\t\t\tadmin: { width: '50%', isClearable: false },\n\t\t\t\toptions: [\n\t\t\t\t\t{ label: 'Full', value: 'full' },\n\t\t\t\t\t{ label: 'Half', value: 'half' },\n\t\t\t\t\t{ label: 'Third', value: 'third' },\n\t\t\t\t\t{ label: 'Two thirds', value: 'twoThirds' },\n\t\t\t\t],\n\t\t\t},\n\t\t\t{\n\t\t\t\tname: 'placeholder',\n\t\t\t\ttype: 'text',\n\t\t\t\tlabel: labelFor(keys.configPlaceholder),\n\t\t\t\tadmin: { width: '50%' },\n\t\t\t\t...localizedIf(localize),\n\t\t\t},\n\t\t],\n\t},\n\t{\n\t\tname: 'description',\n\t\ttype: 'textarea',\n\t\tlabel: labelFor(keys.configDescription),\n\t\t...localizedIf(localize),\n\t},\n\t{ name: 'required', type: 'checkbox', label: labelFor(keys.configRequired) },\n]\n\n/**\n * The single field of every field block: unnamed tabs (presentational only, data paths stay flat).\n * Field tab holds the shared basics plus the type's own config; Validation holds the rule blocks and\n * `validateWhen`; Advanced holds `visibleWhen` and `hidden`. `visibleWhen`/`validateWhen` store a\n * canonical Payload `Where`, edited by the native condition builder.\n */\ntype FieldBlockTabsArgs = {\n\tconditionTypes: Record<string, ConditionFieldType>\n\ttypeConfig: Field[]\n\tvalidations: Field\n\tlocalize?: boolean\n}\n\nexport const fieldBlockTabs = ({\n\tconditionTypes,\n\ttypeConfig,\n\tvalidations,\n\tlocalize = true,\n}: FieldBlockTabsArgs): Field => ({\n\ttype: 'tabs',\n\ttabs: [\n\t\t{\n\t\t\tlabel: labelFor(keys.tabField),\n\t\t\tfields: [...sharedFieldConfig(localize), ...typeConfig],\n\t\t},\n\t\t{\n\t\t\tlabel: labelFor(keys.tabValidation),\n\t\t\tfields: [\n\t\t\t\tvalidations,\n\t\t\t\tconditionField('validateWhen', keys.configValidateWhen, conditionTypes),\n\t\t\t],\n\t\t},\n\t\t{\n\t\t\tlabel: labelFor(keys.tabAdvanced),\n\t\t\tfields: [\n\t\t\t\tconditionField('visibleWhen', keys.configVisibleWhen, conditionTypes),\n\t\t\t\t{ name: 'hidden', type: 'checkbox', label: labelFor(keys.configHidden) },\n\t\t\t],\n\t\t},\n\t],\n})\n"],"mappings":";;;;AAMA,MAAM,sBAAsB;AAE5B,MAAM,kBACL,MACA,UACA,oBACY;CACZ;CACA,MAAM;CACN,OAAO,SAAS,QAAQ;CACxB,OAAO,EACN,YAAY,EACX,OAAO;EAAE,MAAM;EAAqB,aAAa,EAAE,eAAe;CAAE,EACrE,EACD;AACD;;;;;;;;;AAUA,MAAa,qBAAqB,WAAW,SAAkB;CAC9D;EACC,MAAM;EACN,QAAQ,CACP;GACC,MAAM;GACN,MAAM;GACN,UAAU;GACV,OAAO,SAAS,KAAK,UAAU;GAC/B,OAAO,EAAE,OAAO,MAAM;EACvB,GACA;GACC,MAAM;GACN,MAAM;GACN,OAAO,SAAS,KAAK,WAAW;GAChC,OAAO,EAAE,OAAO,MAAM;GACtB,GAAG,YAAY,QAAQ;EACxB,CACD;CACD;CACA;EACC,MAAM;EACN,QAAQ,CACP;GACC,MAAM;GACN,MAAM;GACN,UAAU;GACV,cAAc;GACd,OAAO,SAAS,KAAK,WAAW;GAChC,OAAO;IAAE,OAAO;IAAO,aAAa;GAAM;GAC1C,SAAS;IACR;KAAE,OAAO;KAAQ,OAAO;IAAO;IAC/B;KAAE,OAAO;KAAQ,OAAO;IAAO;IAC/B;KAAE,OAAO;KAAS,OAAO;IAAQ;IACjC;KAAE,OAAO;KAAc,OAAO;IAAY;GAC3C;EACD,GACA;GACC,MAAM;GACN,MAAM;GACN,OAAO,SAAS,KAAK,iBAAiB;GACtC,OAAO,EAAE,OAAO,MAAM;GACtB,GAAG,YAAY,QAAQ;EACxB,CACD;CACD;CACA;EACC,MAAM;EACN,MAAM;EACN,OAAO,SAAS,KAAK,iBAAiB;EACtC,GAAG,YAAY,QAAQ;CACxB;CACA;EAAE,MAAM;EAAY,MAAM;EAAY,OAAO,SAAS,KAAK,cAAc;CAAE;AAC5E;AAeA,MAAa,kBAAkB,EAC9B,gBACA,YACA,aACA,WAAW,YACsB;CACjC,MAAM;CACN,MAAM;EACL;GACC,OAAO,SAAS,KAAK,QAAQ;GAC7B,QAAQ,CAAC,GAAG,kBAAkB,QAAQ,GAAG,GAAG,UAAU;EACvD;EACA;GACC,OAAO,SAAS,KAAK,aAAa;GAClC,QAAQ,CACP,aACA,eAAe,gBAAgB,KAAK,oBAAoB,cAAc,CACvE;EACD;EACA;GACC,OAAO,SAAS,KAAK,WAAW;GAChC,QAAQ,CACP,eAAe,eAAe,KAAK,mBAAmB,cAAc,GACpE;IAAE,MAAM;IAAU,MAAM;IAAY,OAAO,SAAS,KAAK,YAAY;GAAE,CACxE;EACD;CACD;AACD"}

package/dist/fields/types.d.ts

@@ -4,8 +4,12 @@ import { Field } from "payload";
 import { StandardSchemaV1 } from "@standard-schema/spec";
 
 //#region src/fields/types.d.ts
-/** The stored value shapes a field type can declare. Drives `validate`/`format` typing and value coercion. */
-type FormFieldValueKind = 'text' | 'number' | 'boolean' | 'date' | 'text[]' | 'file' | 'repeater';
+/**
+ * The stored value shapes a field type can declare. Drives `validate`/`format` typing and value
+ * coercion. `'none'` marks a display-only type (e.g. `message`): the engine never seeds, validates,
+ * or stores a value for it, and a client-sent value under its name is dropped.
+ */
+type FormFieldValueKind = 'text' | 'number' | 'boolean' | 'date' | 'text[]' | 'file' | 'repeater' | 'none';
 type ValueKindTypeMap = {
   text: string;
   number: number;
@@ -14,6 +18,7 @@ type ValueKindTypeMap = {
   'text[]': string[];
   file: FileRef;
   repeater: Array<Record<string, unknown>>;
+  none: never;
 };
 type ValueOfKind<K extends FormFieldValueKind> = ValueKindTypeMap[K];
 /** Resolved per-instance config values for a field type (loose at the DB boundary, narrowed by the author's generic). */

package/dist/flow/normalizeFlow.js

@@ -4,6 +4,7 @@ const isRecord = (v) => v !== null && typeof v === "object" && !Array.isArray(v)
 * Pure guard that normalizes a raw (possibly untrusted) flow value against the
 * form's current field list. Returns `undefined` when the flow is absent, empty,
 * or resolves to fewer than two steps (a single step is an ordinary form).
+* A field assigned to multiple steps keeps only its first occurrence in step order.
 */
 const normalizeFlow = (raw, fieldNames) => {
 	if (!isRecord(raw) || !Array.isArray(raw.steps)) return;
@@ -11,9 +12,14 @@ const normalizeFlow = (raw, fieldNames) => {
 	const rawSteps = raw.steps.filter((s) => isRecord(s) && typeof s.id === "string");
 	const knownIds = new Set(rawSteps.map((s) => s.id));
 	if (knownIds.size < 2) return;
+	const seenFields = /* @__PURE__ */ new Set();
 	return { steps: rawSteps.map((s) => {
 		const id = s.id;
-		const fields = Array.isArray(s.fields) ? s.fields.filter((f) => typeof f === "string" && knownFields.has(f)) : [];
+		const fields = Array.isArray(s.fields) ? s.fields.filter((f) => {
+			if (typeof f !== "string" || !knownFields.has(f) || seenFields.has(f)) return false;
+			seenFields.add(f);
+			return true;
+		}) : [];
 		const transitions = (Array.isArray(s.transitions) ? s.transitions : []).filter((t) => isRecord(t) && typeof t.to === "string" && knownIds.has(t.to) && isRecord(t.when)).map((t) => ({
 			when: t.when,
 			to: t.to

package/dist/flow/normalizeFlow.js.map

@@ -1 +1 @@
-{"version":3,"file":"normalizeFlow.js","names":[],"sources":["../../src/flow/normalizeFlow.ts"],"sourcesContent":["import type { Where } from 'payload'\nimport type { FlowStep, FormFlow } from './types'\n\nconst isRecord = (v: unknown): v is Record<string, unknown> =>\n\tv !== null && typeof v === 'object' && !Array.isArray(v)\n\n/**\n * Pure guard that normalizes a raw (possibly untrusted) flow value against the\n * form's current field list. Returns `undefined` when the flow is absent, empty,\n * or resolves to fewer than two steps (a single step is an ordinary form).\n */\nexport const normalizeFlow = (raw: unknown, fieldNames: string[]): FormFlow | undefined => {\n\tif (!isRecord(raw) || !Array.isArray(raw.steps)) {\n\t\treturn undefined\n\t}\n\n\tconst knownFields = new Set(fieldNames)\n\n\tconst rawSteps = raw.steps.filter(\n\t\t(s): s is Record<string, unknown> => isRecord(s) && typeof s.id === 'string'\n\t)\n\n\tconst knownIds = new Set(rawSteps.map((s) => s.id as string))\n\n\tif (knownIds.size < 2) {\n\t\treturn undefined\n\t}\n\n\tconst steps: FlowStep[] = rawSteps.map((s) => {\n\t\tconst id = s.id as string\n\n\t\tconst fields = Array.isArray(s.fields)\n\t\t\t? s.fields.filter((f): f is string => typeof f === 'string' && knownFields.has(f))\n\t\t\t: []\n\n\t\tconst rawTransitions = Array.isArray(s.transitions) ? s.transitions : []\n\t\tconst transitions = rawTransitions\n\t\t\t.filter(\n\t\t\t\t(t): t is Record<string, unknown> =>\n\t\t\t\t\tisRecord(t) &&\n\t\t\t\t\ttypeof t.to === 'string' &&\n\t\t\t\t\tknownIds.has(t.to as string) &&\n\t\t\t\t\tisRecord(t.when)\n\t\t\t)\n\t\t\t.map((t) => ({ when: t.when as Where, to: t.to as string }))\n\n\t\tconst next = typeof s.next === 'string' && knownIds.has(s.next) ? (s.next as string) : undefined\n\n\t\tconst step: FlowStep = { id, fields }\n\t\tif (typeof s.title === 'string') step.title = s.title\n\t\tif (transitions.length > 0) step.transitions = transitions\n\t\tif (next !== undefined) step.next = next\n\n\t\treturn step\n\t})\n\n\treturn { steps }\n}\n"],"mappings":";AAGA,MAAM,YAAY,MACjB,MAAM,QAAQ,OAAO,MAAM,YAAY,CAAC,MAAM,QAAQ,CAAC;;;;;;AAOxD,MAAa,iBAAiB,KAAc,eAA+C;CAC1F,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,MAAM,QAAQ,IAAI,KAAK,GAC7C;CAGD,MAAM,cAAc,IAAI,IAAI,UAAU;CAEtC,MAAM,WAAW,IAAI,MAAM,QACzB,MAAoC,SAAS,CAAC,KAAK,OAAO,EAAE,OAAO,QACrE;CAEA,MAAM,WAAW,IAAI,IAAI,SAAS,KAAK,MAAM,EAAE,EAAY,CAAC;CAE5D,IAAI,SAAS,OAAO,GACnB;CA+BD,OAAO,EAAE,OA5BiB,SAAS,KAAK,MAAM;EAC7C,MAAM,KAAK,EAAE;EAEb,MAAM,SAAS,MAAM,QAAQ,EAAE,MAAM,IAClC,EAAE,OAAO,QAAQ,MAAmB,OAAO,MAAM,YAAY,YAAY,IAAI,CAAC,CAAC,IAC/E,CAAC;EAGJ,MAAM,eADiB,MAAM,QAAQ,EAAE,WAAW,IAAI,EAAE,cAAc,CAAC,GAErE,QACC,MACA,SAAS,CAAC,KACV,OAAO,EAAE,OAAO,YAChB,SAAS,IAAI,EAAE,EAAY,KAC3B,SAAS,EAAE,IAAI,CACjB,EACC,KAAK,OAAO;GAAE,MAAM,EAAE;GAAe,IAAI,EAAE;EAAa,EAAE;EAE5D,MAAM,OAAO,OAAO,EAAE,SAAS,YAAY,SAAS,IAAI,EAAE,IAAI,IAAK,EAAE,OAAkB,KAAA;EAEvF,MAAM,OAAiB;GAAE;GAAI;EAAO;EACpC,IAAI,OAAO,EAAE,UAAU,UAAU,KAAK,QAAQ,EAAE;EAChD,IAAI,YAAY,SAAS,GAAG,KAAK,cAAc;EAC/C,IAAI,SAAS,KAAA,GAAW,KAAK,OAAO;EAEpC,OAAO;CACR,CAEa,EAAE;AAChB"}
+{"version":3,"file":"normalizeFlow.js","names":[],"sources":["../../src/flow/normalizeFlow.ts"],"sourcesContent":["import type { Where } from 'payload'\nimport type { FlowStep, FormFlow } from './types'\n\nconst isRecord = (v: unknown): v is Record<string, unknown> =>\n\tv !== null && typeof v === 'object' && !Array.isArray(v)\n\n/**\n * Pure guard that normalizes a raw (possibly untrusted) flow value against the\n * form's current field list. Returns `undefined` when the flow is absent, empty,\n * or resolves to fewer than two steps (a single step is an ordinary form).\n * A field assigned to multiple steps keeps only its first occurrence in step order.\n */\nexport const normalizeFlow = (raw: unknown, fieldNames: string[]): FormFlow | undefined => {\n\tif (!isRecord(raw) || !Array.isArray(raw.steps)) {\n\t\treturn undefined\n\t}\n\n\tconst knownFields = new Set(fieldNames)\n\n\tconst rawSteps = raw.steps.filter(\n\t\t(s): s is Record<string, unknown> => isRecord(s) && typeof s.id === 'string'\n\t)\n\n\tconst knownIds = new Set(rawSteps.map((s) => s.id as string))\n\n\tif (knownIds.size < 2) {\n\t\treturn undefined\n\t}\n\n\tconst seenFields = new Set<string>()\n\n\tconst steps: FlowStep[] = rawSteps.map((s) => {\n\t\tconst id = s.id as string\n\n\t\tconst fields = Array.isArray(s.fields)\n\t\t\t? s.fields.filter((f): f is string => {\n\t\t\t\t\tif (typeof f !== 'string' || !knownFields.has(f) || seenFields.has(f)) return false\n\t\t\t\t\tseenFields.add(f)\n\t\t\t\t\treturn true\n\t\t\t\t})\n\t\t\t: []\n\n\t\tconst rawTransitions = Array.isArray(s.transitions) ? s.transitions : []\n\t\tconst transitions = rawTransitions\n\t\t\t.filter(\n\t\t\t\t(t): t is Record<string, unknown> =>\n\t\t\t\t\tisRecord(t) &&\n\t\t\t\t\ttypeof t.to === 'string' &&\n\t\t\t\t\tknownIds.has(t.to as string) &&\n\t\t\t\t\tisRecord(t.when)\n\t\t\t)\n\t\t\t.map((t) => ({ when: t.when as Where, to: t.to as string }))\n\n\t\tconst next = typeof s.next === 'string' && knownIds.has(s.next) ? (s.next as string) : undefined\n\n\t\tconst step: FlowStep = { id, fields }\n\t\tif (typeof s.title === 'string') step.title = s.title\n\t\tif (transitions.length > 0) step.transitions = transitions\n\t\tif (next !== undefined) step.next = next\n\n\t\treturn step\n\t})\n\n\treturn { steps }\n}\n"],"mappings":";AAGA,MAAM,YAAY,MACjB,MAAM,QAAQ,OAAO,MAAM,YAAY,CAAC,MAAM,QAAQ,CAAC;;;;;;;AAQxD,MAAa,iBAAiB,KAAc,eAA+C;CAC1F,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,MAAM,QAAQ,IAAI,KAAK,GAC7C;CAGD,MAAM,cAAc,IAAI,IAAI,UAAU;CAEtC,MAAM,WAAW,IAAI,MAAM,QACzB,MAAoC,SAAS,CAAC,KAAK,OAAO,EAAE,OAAO,QACrE;CAEA,MAAM,WAAW,IAAI,IAAI,SAAS,KAAK,MAAM,EAAE,EAAY,CAAC;CAE5D,IAAI,SAAS,OAAO,GACnB;CAGD,MAAM,6BAAa,IAAI,IAAY;CAkCnC,OAAO,EAAE,OAhCiB,SAAS,KAAK,MAAM;EAC7C,MAAM,KAAK,EAAE;EAEb,MAAM,SAAS,MAAM,QAAQ,EAAE,MAAM,IAClC,EAAE,OAAO,QAAQ,MAAmB;GACpC,IAAI,OAAO,MAAM,YAAY,CAAC,YAAY,IAAI,CAAC,KAAK,WAAW,IAAI,CAAC,GAAG,OAAO;GAC9E,WAAW,IAAI,CAAC;GAChB,OAAO;EACR,CAAC,IACA,CAAC;EAGJ,MAAM,eADiB,MAAM,QAAQ,EAAE,WAAW,IAAI,EAAE,cAAc,CAAC,GAErE,QACC,MACA,SAAS,CAAC,KACV,OAAO,EAAE,OAAO,YAChB,SAAS,IAAI,EAAE,EAAY,KAC3B,SAAS,EAAE,IAAI,CACjB,EACC,KAAK,OAAO;GAAE,MAAM,EAAE;GAAe,IAAI,EAAE;EAAa,EAAE;EAE5D,MAAM,OAAO,OAAO,EAAE,SAAS,YAAY,SAAS,IAAI,EAAE,IAAI,IAAK,EAAE,OAAkB,KAAA;EAEvF,MAAM,OAAiB;GAAE;GAAI;EAAO;EACpC,IAAI,OAAO,EAAE,UAAU,UAAU,KAAK,QAAQ,EAAE;EAChD,IAAI,YAAY,SAAS,GAAG,KAAK,cAAc;EAC/C,IAAI,SAAS,KAAA,GAAW,KAAK,OAAO;EAEpC,OAAO;CACR,CAEa,EAAE;AAChB"}

package/dist/flow/stepLabel.js

@@ -0,0 +1,15 @@
+//#region src/flow/stepLabel.ts
+/**
+* Display label for a step: its trimmed title, else the fallback template with
+* `{n}` replaced by the 1-based index. Step ids never surface in the UI.
+* Lives with the flow engine (not the admin client module) because the frontend
+* `<FormSteps>` indicator resolves labels with the same semantics.
+*/
+const stepLabel = (step, index, fallbackTemplate) => {
+	const title = step.title?.trim();
+	return title !== void 0 && title.length > 0 ? title : fallbackTemplate.replace("{n}", String(index + 1));
+};
+//#endregion
+export { stepLabel };
+
+//# sourceMappingURL=stepLabel.js.map

package/dist/flow/stepLabel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stepLabel.js","names":[],"sources":["../../src/flow/stepLabel.ts"],"sourcesContent":["import type { FlowStep } from './types'\n\n/**\n * Display label for a step: its trimmed title, else the fallback template with\n * `{n}` replaced by the 1-based index. Step ids never surface in the UI.\n * Lives with the flow engine (not the admin client module) because the frontend\n * `<FormSteps>` indicator resolves labels with the same semantics.\n */\nexport const stepLabel = (\n\tstep: Pick<FlowStep, 'title'>,\n\tindex: number,\n\tfallbackTemplate: string\n): string => {\n\tconst title = step.title?.trim()\n\treturn title !== undefined && title.length > 0\n\t\t? title\n\t\t: fallbackTemplate.replace('{n}', String(index + 1))\n}\n"],"mappings":";;;;;;;AAQA,MAAa,aACZ,MACA,OACA,qBACY;CACZ,MAAM,QAAQ,KAAK,OAAO,KAAK;CAC/B,OAAO,UAAU,KAAA,KAAa,MAAM,SAAS,IAC1C,QACA,iBAAiB,QAAQ,OAAO,OAAO,QAAQ,CAAC,CAAC;AACrD"}

package/dist/form/pollState.d.ts

@@ -0,0 +1,22 @@
+//#region src/form/pollState.d.ts
+/** Poll settings as loaded from a forms document (server) or a `FormDocument` (client). */
+type PollConfigLike = {
+  enabled?: boolean | null;
+  resultsField?: string | null;
+  resultsVisibility?: string | null;
+  closesAt?: string | null;
+  optionSource?: string | null;
+  sourceConfig?: Record<string, unknown> | null;
+  outcome?: {
+    winningValue?: string | null;
+    resolvedAt?: string | null;
+  } | null;
+};
+/**
+ * Whether the poll's `closesAt` has passed. An unset or unparseable `closesAt` never closes;
+ * framework-agnostic so the server guard, the results gate, and the client `<Poll>` agree.
+ */
+declare const isPollClosed: (poll: PollConfigLike | null | undefined, now?: number) => boolean;
+//#endregion
+export { isPollClosed };
+//# sourceMappingURL=pollState.d.ts.map

package/dist/form/pollState.js

@@ -0,0 +1,17 @@
+//#region src/form/pollState.ts
+/** Narrow a forms document's untyped `poll` member. */
+const pollConfigOf = (poll) => poll != null && typeof poll === "object" ? poll : void 0;
+/**
+* Whether the poll's `closesAt` has passed. An unset or unparseable `closesAt` never closes;
+* framework-agnostic so the server guard, the results gate, and the client `<Poll>` agree.
+*/
+const isPollClosed = (poll, now = Date.now()) => {
+	const closesAt = poll?.closesAt;
+	if (typeof closesAt !== "string" || closesAt.length === 0) return false;
+	const ts = Date.parse(closesAt);
+	return Number.isFinite(ts) && ts <= now;
+};
+//#endregion
+export { isPollClosed, pollConfigOf };
+
+//# sourceMappingURL=pollState.js.map

package/dist/form/pollState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pollState.js","names":[],"sources":["../../src/form/pollState.ts"],"sourcesContent":["/** Poll settings as loaded from a forms document (server) or a `FormDocument` (client). */\nexport type PollConfigLike = {\n\tenabled?: boolean | null\n\tresultsField?: string | null\n\tresultsVisibility?: string | null\n\tclosesAt?: string | null\n\toptionSource?: string | null\n\tsourceConfig?: Record<string, unknown> | null\n\toutcome?: { winningValue?: string | null; resolvedAt?: string | null } | null\n}\n\n/** Narrow a forms document's untyped `poll` member. */\nexport const pollConfigOf = (poll: unknown): PollConfigLike | undefined =>\n\tpoll != null && typeof poll === 'object' ? (poll as PollConfigLike) : undefined\n\n/**\n * Whether the poll's `closesAt` has passed. An unset or unparseable `closesAt` never closes;\n * framework-agnostic so the server guard, the results gate, and the client `<Poll>` agree.\n */\nexport const isPollClosed = (\n\tpoll: PollConfigLike | null | undefined,\n\tnow: number = Date.now()\n): boolean => {\n\tconst closesAt = poll?.closesAt\n\tif (typeof closesAt !== 'string' || closesAt.length === 0) {\n\t\treturn false\n\t}\n\tconst ts = Date.parse(closesAt)\n\treturn Number.isFinite(ts) && ts <= now\n}\n"],"mappings":";;AAYA,MAAa,gBAAgB,SAC5B,QAAQ,QAAQ,OAAO,SAAS,WAAY,OAA0B,KAAA;;;;;AAMvE,MAAa,gBACZ,MACA,MAAc,KAAK,IAAI,MACV;CACb,MAAM,WAAW,MAAM;CACvB,IAAI,OAAO,aAAa,YAAY,SAAS,WAAW,GACvD,OAAO;CAER,MAAM,KAAK,KAAK,MAAM,QAAQ;CAC9B,OAAO,OAAO,SAAS,EAAE,KAAK,MAAM;AACrC"}

package/dist/form/toFormDocument.d.ts

@@ -0,0 +1,60 @@
+import { PollOption } from "../poll/definePollOptionSource.js";
+import { FormDocument } from "./types.js";
+
+//#region src/form/toFormDocument.d.ts
+type ToFormDocumentOptions = {
+  /**
+   * Source-resolved poll options (from `resolvePollOptions`), injected as the options of the
+   * field instance named by the form's `poll.resultsField` so the client renders the host's
+   * current choices instead of hand-authored ones.
+   */
+  pollOptions?: PollOption[];
+};
+/**
+ * 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`
+ * - `response` may be null; coerced to `undefined`
+ * - `display` may be null; coerced to `undefined`
+ * - `poll` may be null; coerced to `undefined` (`resultsField`, `optionSource`, and
+ *   `sourceConfig` are dropped: server-side only; `outcome` passes through `winningValue` only)
+ *
+ * Pure and framework-agnostic (no 'use client'): safe to call from a Server Component or any
+ * other server-side code before handing the result to the client `<Form>`.
+ */
+declare function toFormDocument(form: {
+  id: number | string;
+  fields?: {
+    blockType: string;
+    name: string;
+    [key: string]: unknown;
+  }[] | null;
+  flow?: unknown;
+  response?: {
+    type?: string | null;
+    message?: unknown;
+    redirect?: {
+      url?: string | null;
+    } | null;
+    submitLabel?: string | null;
+  } | null;
+  display?: {
+    showTitle?: boolean | null;
+    title?: string | null;
+    intro?: unknown;
+  } | null;
+  poll?: {
+    enabled?: boolean | null;
+    resultsField?: string | null;
+    resultsVisibility?: string | null;
+    closesAt?: string | null;
+    outcome?: {
+      winningValue?: string | null;
+    } | null;
+  } | null;
+}, options?: ToFormDocumentOptions): FormDocument;
+//#endregion
+export { ToFormDocumentOptions, toFormDocument };
+//# sourceMappingURL=toFormDocument.d.ts.map

package/dist/form/toFormDocument.js

@@ -0,0 +1,39 @@
+import { applyPollOptions } from "../poll/applyPollOptions.js";
+//#region src/form/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`
+* - `response` may be null; coerced to `undefined`
+* - `display` may be null; coerced to `undefined`
+* - `poll` may be null; coerced to `undefined` (`resultsField`, `optionSource`, and
+*   `sourceConfig` are dropped: server-side only; `outcome` passes through `winningValue` only)
+*
+* Pure and framework-agnostic (no 'use client'): safe to call from a Server Component or any
+* other server-side code before handing the result to the client `<Form>`.
+*/
+function toFormDocument(form, options) {
+	const winningValue = form.poll?.outcome?.winningValue;
+	const poll = form.poll ? {
+		enabled: form.poll.enabled ?? void 0,
+		resultsVisibility: form.poll.resultsVisibility ?? void 0,
+		closesAt: form.poll.closesAt ?? void 0,
+		...typeof winningValue === "string" && winningValue.length > 0 ? { outcome: { winningValue } } : {}
+	} : void 0;
+	let fields = form.fields ?? [];
+	if (options?.pollOptions) fields = applyPollOptions(fields, form.poll?.resultsField, options.pollOptions);
+	return {
+		id: form.id,
+		fields,
+		flow: form.flow,
+		response: form.response ?? void 0,
+		display: form.display ?? void 0,
+		poll
+	};
+}
+//#endregion
+export { toFormDocument };
+
+//# sourceMappingURL=toFormDocument.js.map

package/dist/form/toFormDocument.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"toFormDocument.js","names":[],"sources":["../../src/form/toFormDocument.ts"],"sourcesContent":["import type { FormFlow } from '../flow/types'\nimport { applyPollOptions } from '../poll/applyPollOptions'\nimport type { PollOption } from '../poll/definePollOptionSource'\nimport type { FormFieldInstance } from '../submissions/types'\nimport type { FormDisplaySettings, FormDocument, FormResponseSettings } from './types'\n\nexport type ToFormDocumentOptions = {\n\t/**\n\t * Source-resolved poll options (from `resolvePollOptions`), injected as the options of the\n\t * field instance named by the form's `poll.resultsField` so the client renders the host's\n\t * current choices instead of hand-authored ones.\n\t */\n\tpollOptions?: PollOption[]\n}\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 * - `response` may be null; coerced to `undefined`\n * - `display` may be null; coerced to `undefined`\n * - `poll` may be null; coerced to `undefined` (`resultsField`, `optionSource`, and\n *   `sourceConfig` are dropped: server-side only; `outcome` passes through `winningValue` only)\n *\n * Pure and framework-agnostic (no 'use client'): safe to call from a Server Component or any\n * other server-side code before handing the result to the client `<Form>`.\n */\nexport function toFormDocument(\n\tform: {\n\t\tid: number | string\n\t\tfields?: { blockType: string; name: string; [key: string]: unknown }[] | null\n\t\tflow?: unknown\n\t\tresponse?: {\n\t\t\ttype?: string | null\n\t\t\tmessage?: unknown\n\t\t\tredirect?: { url?: string | null } | null\n\t\t\tsubmitLabel?: string | null\n\t\t} | null\n\t\tdisplay?: {\n\t\t\tshowTitle?: boolean | null\n\t\t\ttitle?: string | null\n\t\t\tintro?: unknown\n\t\t} | null\n\t\tpoll?: {\n\t\t\tenabled?: boolean | null\n\t\t\tresultsField?: string | null\n\t\t\tresultsVisibility?: string | null\n\t\t\tclosesAt?: string | null\n\t\t\toutcome?: { winningValue?: string | null } | null\n\t\t} | null\n\t},\n\toptions?: ToFormDocumentOptions\n): FormDocument {\n\tconst winningValue = form.poll?.outcome?.winningValue\n\tconst poll = form.poll\n\t\t? {\n\t\t\t\tenabled: form.poll.enabled ?? undefined,\n\t\t\t\tresultsVisibility: (form.poll.resultsVisibility ?? undefined) as\n\t\t\t\t\t| 'afterVote'\n\t\t\t\t\t| 'afterClose'\n\t\t\t\t\t| undefined,\n\t\t\t\tclosesAt: form.poll.closesAt ?? undefined,\n\t\t\t\t...(typeof winningValue === 'string' && winningValue.length > 0\n\t\t\t\t\t? { outcome: { winningValue } }\n\t\t\t\t\t: {}),\n\t\t\t}\n\t\t: undefined\n\tlet fields = (form.fields ?? []) as FormFieldInstance[]\n\tif (options?.pollOptions) {\n\t\tfields = applyPollOptions(fields, form.poll?.resultsField, options.pollOptions)\n\t}\n\treturn {\n\t\tid: form.id,\n\t\tfields,\n\t\tflow: form.flow as FormFlow | undefined,\n\t\tresponse: (form.response as FormResponseSettings | null | undefined) ?? undefined,\n\t\tdisplay: (form.display as FormDisplaySettings | null | undefined) ?? undefined,\n\t\tpoll,\n\t}\n}\n"],"mappings":";;;;;;;;;;;;;;;;AA6BA,SAAgB,eACf,MAuBA,SACe;CACf,MAAM,eAAe,KAAK,MAAM,SAAS;CACzC,MAAM,OAAO,KAAK,OACf;EACA,SAAS,KAAK,KAAK,WAAW,KAAA;EAC9B,mBAAoB,KAAK,KAAK,qBAAqB,KAAA;EAInD,UAAU,KAAK,KAAK,YAAY,KAAA;EAChC,GAAI,OAAO,iBAAiB,YAAY,aAAa,SAAS,IAC3D,EAAE,SAAS,EAAE,aAAa,EAAE,IAC5B,CAAC;CACL,IACC,KAAA;CACH,IAAI,SAAU,KAAK,UAAU,CAAC;CAC9B,IAAI,SAAS,aACZ,SAAS,iBAAiB,QAAQ,KAAK,MAAM,cAAc,QAAQ,WAAW;CAE/E,OAAO;EACN,IAAI,KAAK;EACT;EACA,MAAM,KAAK;EACX,UAAW,KAAK,YAAwD,KAAA;EACxE,SAAU,KAAK,WAAsD,KAAA;EACrE;CACD;AACD"}

package/dist/form/types.d.ts

@@ -0,0 +1,48 @@
+import { FormFieldInstance } from "../submissions/types.js";
+import { FormFlow } from "../flow/types.js";
+
+//#region src/form/types.d.ts
+/** Serializable per-form response settings: what the visitor gets after a successful submit. */
+type FormResponseSettings = {
+  type?: 'message' | 'redirect' | null; /** Rich text state serialized via `serializeBody`; shown instead of the plain `successMessage`. */
+  message?: unknown; /** Applies on the custom-`children` path too (part of submit handling); `message`/`submitLabel` only affect default rendering. */
+  redirect?: {
+    url?: string | null;
+  } | null;
+  submitLabel?: string | null;
+};
+/** Serializable per-form display settings: what the visitor sees above the fields, before submit. */
+type FormDisplaySettings = {
+  showTitle?: boolean;
+  title?: string; /** Rich text state serialized via `serializeBody`; rendered above the fields when non-empty. */
+  intro?: unknown;
+};
+/**
+ * Serializable per-form poll settings the client needs for lifecycle rendering (open/voted/closed).
+ * `resultsField` intentionally stays server-side: the results endpoint resolves the public field
+ * itself, so the client never needs it from the document.
+ */
+type FormPollSettings = {
+  enabled?: boolean; /** When anonymous callers may read aggregate results. Default 'afterVote'. */
+  resultsVisibility?: 'afterVote' | 'afterClose' | null; /** ISO date after which submissions are rejected and the poll renders as closed. */
+  closesAt?: string | null; /** Present once the host recorded a final outcome via `resolvePollOutcome`; `<Poll>` renders the final state. */
+  outcome?: {
+    winningValue?: string;
+  };
+};
+/**
+ * Serializable shape `<Form>` expects, and what `toFormDocument` narrows a Payload-generated
+ * document to. Framework-agnostic (no React, no 'use client') so it can be constructed and
+ * consumed on the server, e.g. in a Server Component before handing it to the client `<Form>`.
+ */
+type FormDocument = {
+  id: number | string;
+  fields: FormFieldInstance[];
+  flow?: FormFlow;
+  response?: FormResponseSettings;
+  display?: FormDisplaySettings;
+  poll?: FormPollSettings;
+};
+//#endregion
+export { FormDisplaySettings, FormDocument, FormPollSettings, FormResponseSettings };
+//# sourceMappingURL=types.d.ts.map