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

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

package/dist/index.d.ts

@@ -1,11 +1,16 @@
 import { FileFieldConfig, FileRef, FileRefError } from "./uploads/types.js";
 import { AnyFormFieldDefinition, FormFieldDefinition, FormFieldFormat, FormFieldValidate, FormFieldValueKind } from "./fields/types.js";
 import { TranslationsOption } from "./translations/index.js";
+import { BodyConverter, BodyConverterArgs, BodyRender, defaultBodyConverters, sanitizeUrl } from "./actions/body/converters.js";
+import { BodyContext, RichTextBodyOption, SerializeBodyArgs, serializeBody } from "./actions/body/serializeBody.js";
 import { AggregationBucket, AggregationRow, FieldAggregation, FieldMeta, SubmissionStatusFilter } from "./aggregation/types.js";
 import { CalcExpression } from "./calc/types.js";
 import { calcExpressionOf, computeCalcFields } from "./calc/computeCalcFields.js";
 import { evaluateCalc } from "./calc/evaluate.js";
 import { evaluateCondition } from "./conditions/evaluate.js";
+import { AnyPollOptionSource, PollOption, PollOptionResolveArgs, PollOptionSource, definePollOptionSource } from "./poll/definePollOptionSource.js";
+import { FormDisplaySettings, FormDocument, FormPollSettings, FormResponseSettings } from "./form/types.js";
+import { ToFormDocumentOptions, toFormDocument } from "./form/toFormDocument.js";
 import { FieldTypeOption, FieldTypeRegistry, FieldTypesConfig } from "./fields/registry.js";
 import { PrefillOptions, valuesFromSearchParams } from "./prefill/valuesFromSearchParams.js";
 import { FormEventSink } from "./events/types.js";
@@ -14,35 +19,49 @@ import { PresentationDensity, PresentationDescriptor, PresentationSurface } from
 import { interpolate } from "./recall/interpolate.js";
 import { RecallResolver, buildRecallResolver, optionLabelsFor } from "./recall/resolver.js";
 import { CAPTCHA_TOKEN_KEY, DEFAULT_HONEYPOT_FIELD } from "./spam/constants.js";
+import { formatBytes } from "./uploads/formatBytes.js";
+import { isPollClosed } from "./form/pollState.js";
+import { PollOptionSourceOption, PollOptionSourceRegistry, PollOptionSourcesConfig, resolvePollOptionSources } from "./poll/registry.js";
+import { ResolvePollOptionsArgs, resolvePollOptions } from "./poll/resolvePollOptions.js";
+import { ResolvePollOutcomeArgs, resolvePollOutcome } from "./poll/resolvePollOutcome.js";
+import { hasVotedCookie, votedCookieName } from "./submissions/votedCookie.js";
 import { ActionDefinition, ActionRunArgs, AnyActionDefinition, defineAction } from "./actions/defineAction.js";
 import { ActionOption, ActionRegistry, ActionsConfig, resolveActions } from "./actions/registry.js";
 import { ActionResult } from "./actions/runActions.js";
 import { AggregateFieldResponsesArgs, AggregateFormResponsesArgs, aggregateFieldResponses, aggregateFormResponses, fieldHasOptions } from "./aggregation/aggregateResponses.js";
-import { ResolveResultsRequestArgs, ResolveResultsRequestResult, resolveFormResultsRequest } from "./aggregation/resolveResultsRequest.js";
-import { CollectionOverrides } from "./plugin/collectionOverrides.js";
-import { FORM_UPLOADS_SLUG, UploadsCollectionConfig, UploadsOption, buildUploadsCollection, resolveUploads } from "./collections/uploads.js";
+import { FormResultsAccess, FormResultsAccessArgs, ResolveResultsRequestArgs, ResolveResultsRequestResult, resolveFormResultsRequest } from "./aggregation/resolveResultsRequest.js";
 import { FieldCondition } from "./conditions/types.js";
 import { AnyConsentSource, ConsentLink, ConsentResolveArgs, ConsentResolved, ConsentSource, defineConsentSource } from "./consent/defineConsentSource.js";
 import { ConsentSourceOption, ConsentSourceRegistry, ConsentSourcesConfig, resolveConsentSources } from "./consent/registry.js";
 import { ConsentProof, captureConsent } from "./consent/captureConsent.js";
-import { PresentationDescriptorOption, PresentationDescriptorRegistry, PresentationsDescriptorConfig, resolvePresentationDescriptors } from "./presentations/registry.js";
+import { CollectionOverrides } from "./plugin/collectionOverrides.js";
 import { CaptchaProvider, CaptchaVerifyArgs, IdentifyFn, RateLimitCheckArgs, RateLimitConfig, RateLimitResult, RateLimiter, SpamConfig, SpamMetadataConfig, SpamOption } from "./spam/types.js";
+import { UploadsOption } from "./plugin/uploadsCollection.js";
 import { ValidationRuleOption, ValidationRuleRegistry, ValidationRulesConfig } from "./validation/registry.js";
-import { defaultActionDefinitions } from "./actions/builtin/index.js";
+import { escapeHtml } from "./actions/body/escapeHtml.js";
+import { renderAllValues, renderAllValuesTable } from "./actions/body/wildcards.js";
+import { buildDefaultActionDefinitions, defaultActionDefinitions } from "./actions/builtin/index.js";
 import { SIGNATURE_HEADER, signPayload } from "./actions/sign.js";
 import { aggregateRowForField, aggregateRowsForFields } from "./aggregation/aggregateRows.js";
 import { normalizeCalc } from "./calc/normalizeCalc.js";
-import { defaultConsentSources } from "./consent/builtin/index.js";
+import { buildDefaultConsentSources, defaultConsentSources } from "./consent/builtin/index.js";
 import { resolveConsentLinks } from "./consent/resolveConsentLinks.js";
 import { resolvePublishedVersionRef } from "./consent/resolvePublishedVersionRef.js";
+import { buildDefaultFieldDefinitions, defaultFieldDefinitions, defaultFieldDefinitionsByType } from "./fields/builtin/index.js";
+import { fileMimeTypeOptions } from "./fields/builtin/file.js";
 import { defineFormField } from "./fields/defineFormField.js";
+import { localizedIf } from "./fields/localizedIf.js";
 import { DEFAULT_PRESENTATION_NAME, defaultPresentationDescriptors } from "./presentations/defaults.js";
 import { defineCaptchaProvider } from "./spam/captcha.js";
 import { defaultIdentify } from "./spam/identify.js";
+import { HcaptchaProviderOptions, hcaptchaProvider } from "./spam/providers/hcaptcha.js";
+import { RecaptchaProviderOptions, recaptchaProvider } from "./spam/providers/recaptcha.js";
+import { TurnstileProviderOptions, turnstileProvider } from "./spam/providers/turnstile.js";
 import { createKvRateLimiter } from "./spam/rateLimiter.js";
 import { resolveSpamConfig } from "./spam/resolveSpam.js";
 import { resolveFileRef } from "./uploads/resolveFileRef.js";
 import { captureFileRef } from "./uploads/captureFileRef.js";
+import { defaultValidationRules, defaultValidationRulesByType } from "./validation/builtin/index.js";
 import { defineValidationRule } from "./validation/defineValidationRule.js";
 
 //#region src/index.d.ts
@@ -55,14 +74,64 @@ type FormBuilderPluginOptions = {
    * added whole. App-level `i18n.translations` still wins over both.
    */
   translations?: TranslationsOption; /** Pluggable sink for form lifecycle events. Defaults to a no-op; analytics adapters or a future analytics plugin subscribe here. */
-  events?: FormEventSink; /** Add, override, or remove field types. `false` removes a built-in, `true` keeps it, an object adds or replaces one. */
-  fields?: FieldTypesConfig; /** Add, override, or remove presentations. `false` removes a built-in, `true` keeps it, an object adds or replaces one. */
-  presentations?: PresentationsDescriptorConfig; /** Add, override, or remove validation rule types. `false` removes a built-in, `true` keeps it, an object adds or replaces one. */
+  events?: FormEventSink;
+  /**
+   * Content-bearing author fields (labels, placeholders, option labels, consent statements,
+   * action subjects and bodies) are localized by default. Payload strips the `localized` flag
+   * on hosts without `localization` configured, so the default is safe everywhere. Set `false`
+   * to keep form content single-locale even on localized hosts. Spread-overrides of the prebuilt
+   * default exports (`defaultFieldDefinitionsByType`, `defaultActionDefinitions`,
+   * `defaultConsentSources`) carry `localized` flags from the default-true set; when opting out,
+   * derive overrides from `buildDefaultFieldDefinitions(false)` /
+   * `buildDefaultActionDefinitions(false)` / `buildDefaultConsentSources(false)` instead.
+   */
+  localizeContent?: boolean; /** Add, override, or remove field types. `false` removes a built-in, `true` keeps it, an object adds or replaces one. */
+  fields?: FieldTypesConfig; /** Add, override, or remove validation rule types. `false` removes a built-in, `true` keeps it, an object adds or replaces one. */
   rules?: ValidationRulesConfig; /** Add, override, or remove post-submit action types. `false` removes a built-in, `true` keeps it, an object adds or replaces one. */
-  actions?: ActionsConfig; /** Add, override, or remove consent source types. `false` removes a built-in, `true` keeps it, an object adds or replaces one. */
-  consentSources?: ConsentSourcesConfig; /** The built-in `form-uploads` collection backing file fields. `false` disables it (bring your own); an object overrides slug/upload/access/fields. */
+  actions?: ActionsConfig;
+  /**
+   * Customize how rich text action bodies are authored and rendered. `editor` overrides the
+   * Lexical/richText editor on both the emailTeam and confirmation action body fields.
+   * `converters` spread over the default Lexical node converters; `serialize` replaces the
+   * whole pipeline (e.g. to target chat or plain-text channels instead of email HTML). A
+   * custom `serialize` receives the submitted `form` (id/title) and `req`, enabling per-tenant
+   * lookups or handing the raw body off to a renderer like react-email.
+   */
+  richText?: RichTextBodyOption; /** Add, override, or remove consent source types. `false` removes a built-in, `true` keeps it, an object adds or replaces one. */
+  consentSources?: ConsentSourcesConfig;
+  /**
+   * File uploads are bring-your-own. Default `false`: no upload collection is involved and the
+   * built-in `file` field type is removed from the registry, so form authors cannot add a field
+   * with nowhere to land (a developer-registered custom `file` type via `fields` still wins).
+   * `{ collection: 'slug' }` points at a host-owned upload collection (created by the app with
+   * its storage adapter); the plugin validates it at boot, appends its hidden `owner` field when
+   * absent, and prepends the spam upload hooks.
+   */
   uploads?: UploadsOption; /** Honeypot + rate-limiting (on by default) + a captcha adapter seam + upload-ownership scoping. `false` disables the whole subsystem. */
   spam?: SpamOption;
+  /**
+   * Aggregate-results endpoint options. `access` gates anonymous reads after the form is loaded
+   * and before anything is served; absent keeps the plugin-default gating (poll opt-in +
+   * visibility + enumerable-field guard). Multi-tenant hosts should compare `form.tenant` against
+   * the tenant derived from `req` so one tenant's poll counts are never readable under another
+   * tenant's id. Authenticated callers bypass this seam.
+   */
+  results?: {
+    access?: FormResultsAccess;
+  };
+  /**
+   * Poll behavior. `votedCookie: true` sets an httpOnly `fb-voted-{formId}=1` cookie on each
+   * successful submission to a poll-enabled form, letting SSR hosts read the voted state via
+   * `hasVotedCookie` and pass it to `<Poll hasVoted>`. Default `false`.
+   * `sources` registers poll option sources (`definePollOptionSource`), letting authors populate
+   * a poll's choices from host domain data with stable values; there are no built-ins. With at
+   * least one source registered, the forms poll group gains an `optionSource` select plus its
+   * per-source `sourceConfig`, and submissions to a sourced poll only accept resolved values.
+   */
+  poll?: {
+    votedCookie?: boolean;
+    sources?: PollOptionSourcesConfig;
+  };
   /**
    * When `true`, the raw `values`, `descriptors`, and `consent` JSON fields are visible in the
    * submission admin view. Default `false` — those fields are fully represented by the
@@ -79,7 +148,6 @@ type FormBuilderPluginOptions = {
   overrides?: {
     forms?: CollectionOverrides;
     formSubmissions?: CollectionOverrides;
-    uploads?: CollectionOverrides;
   };
 };
 declare module 'payload' {
@@ -89,5 +157,5 @@ declare module 'payload' {
 }
 declare const formBuilder: (options: FormBuilderPluginOptions) => import("payload").Plugin;
 //#endregion
-export { type ActionDefinition, type ActionOption, type ActionRegistry, type ActionResult, type ActionRunArgs, type ActionsConfig, type AggregateFieldResponsesArgs, type AggregateFormResponsesArgs, type AggregationBucket, type AggregationRow, type AnyActionDefinition, type AnyConsentSource, type AnyFormFieldDefinition, type AnyValidationRuleDefinition, CAPTCHA_TOKEN_KEY, type CalcExpression, type CaptchaProvider, type CaptchaVerifyArgs, type ConsentLink, type ConsentProof, type ConsentResolveArgs, type ConsentResolved, type ConsentSource, type ConsentSourceOption, type ConsentSourceRegistry, type ConsentSourcesConfig, DEFAULT_HONEYPOT_FIELD, DEFAULT_PRESENTATION_NAME, FORM_UPLOADS_SLUG, type FieldAggregation, type FieldCondition, type FieldMeta, type FieldTypeOption, type FieldTypeRegistry, type FieldTypesConfig, type FileFieldConfig, type FileRef, type FileRefError, FormBuilderPluginOptions, type FormBuilderPluginOptions as PluginOptions, type FormFieldDefinition, type FormFieldFormat, type FormFieldValidate, type FormFieldValueKind, type IdentifyFn, type PrefillOptions, type PresentationDensity, type PresentationDescriptor, type PresentationDescriptorOption, type PresentationDescriptorRegistry, type PresentationSurface, type PresentationsDescriptorConfig, type RateLimitCheckArgs, type RateLimitConfig, type RateLimitResult, type RateLimiter, type RecallResolver, type ResolveResultsRequestArgs, type ResolveResultsRequestResult, SIGNATURE_HEADER, type SpamConfig, type SpamMetadataConfig, type SpamOption, type SubmissionStatusFilter, type UploadsCollectionConfig, type UploadsOption, type ValidationRuleDefinition, type ValidationRuleOption, type ValidationRuleRegistry, type ValidationRuleResult, type ValidationRulesConfig, type ValidationSeverity, aggregateFieldResponses, aggregateFormResponses, aggregateRowForField, aggregateRowsForFields, buildRecallResolver, buildUploadsCollection, calcExpressionOf, captureConsent, captureFileRef, computeCalcFields, createKvRateLimiter, defaultActionDefinitions, defaultConsentSources, defaultIdentify, defaultPresentationDescriptors, defineAction, defineCaptchaProvider, defineConsentSource, defineFormField, defineValidationRule, evaluateCalc, evaluateCondition, fieldHasOptions, formBuilder, interpolate, normalizeCalc, optionLabelsFor, resolveActions, resolveConsentLinks, resolveConsentSources, resolveFileRef, resolveFormResultsRequest, resolvePresentationDescriptors, resolvePublishedVersionRef, resolveSpamConfig, resolveUploads, signPayload, valuesFromSearchParams };
+export { type ActionDefinition, type ActionOption, type ActionRegistry, type ActionResult, type ActionRunArgs, type ActionsConfig, type AggregateFieldResponsesArgs, type AggregateFormResponsesArgs, type AggregationBucket, type AggregationRow, type AnyActionDefinition, type AnyConsentSource, type AnyFormFieldDefinition, type AnyPollOptionSource, type AnyValidationRuleDefinition, type BodyContext, type BodyConverter, type BodyConverterArgs, type BodyRender, CAPTCHA_TOKEN_KEY, type CalcExpression, type CaptchaProvider, type CaptchaVerifyArgs, type ConsentLink, type ConsentProof, type ConsentResolveArgs, type ConsentResolved, type ConsentSource, type ConsentSourceOption, type ConsentSourceRegistry, type ConsentSourcesConfig, DEFAULT_HONEYPOT_FIELD, DEFAULT_PRESENTATION_NAME, type FieldAggregation, type FieldCondition, type FieldMeta, type FieldTypeOption, type FieldTypeRegistry, type FieldTypesConfig, type FileFieldConfig, type FileRef, type FileRefError, FormBuilderPluginOptions, type FormBuilderPluginOptions as PluginOptions, type FormDisplaySettings, type FormDocument, type FormFieldDefinition, type FormFieldFormat, type FormFieldValidate, type FormFieldValueKind, type FormPollSettings, type FormResponseSettings, type FormResultsAccess, type FormResultsAccessArgs, type HcaptchaProviderOptions, type IdentifyFn, type PollOption, type PollOptionResolveArgs, type PollOptionSource, type PollOptionSourceOption, type PollOptionSourceRegistry, type PollOptionSourcesConfig, type PrefillOptions, type PresentationDensity, type PresentationDescriptor, type PresentationSurface, type RateLimitCheckArgs, type RateLimitConfig, type RateLimitResult, type RateLimiter, type RecallResolver, type RecaptchaProviderOptions, type ResolvePollOptionsArgs, type ResolvePollOutcomeArgs, type ResolveResultsRequestArgs, type ResolveResultsRequestResult, type RichTextBodyOption, SIGNATURE_HEADER, type SerializeBodyArgs, type SpamConfig, type SpamMetadataConfig, type SpamOption, type SubmissionStatusFilter, type ToFormDocumentOptions, type TurnstileProviderOptions, type UploadsOption, type ValidationRuleDefinition, type ValidationRuleOption, type ValidationRuleRegistry, type ValidationRuleResult, type ValidationRulesConfig, type ValidationSeverity, aggregateFieldResponses, aggregateFormResponses, aggregateRowForField, aggregateRowsForFields, buildDefaultActionDefinitions, buildDefaultConsentSources, buildDefaultFieldDefinitions, buildRecallResolver, calcExpressionOf, captureConsent, captureFileRef, computeCalcFields, createKvRateLimiter, defaultActionDefinitions, defaultBodyConverters, defaultConsentSources, defaultFieldDefinitions, defaultFieldDefinitionsByType, defaultIdentify, defaultPresentationDescriptors, defaultValidationRules, defaultValidationRulesByType, defineAction, defineCaptchaProvider, defineConsentSource, defineFormField, definePollOptionSource, defineValidationRule, escapeHtml, evaluateCalc, evaluateCondition, fieldHasOptions, fileMimeTypeOptions, formBuilder, formatBytes, hasVotedCookie, hcaptchaProvider, interpolate, isPollClosed, localizedIf, normalizeCalc, optionLabelsFor, recaptchaProvider, renderAllValues, renderAllValuesTable, resolveActions, resolveConsentLinks, resolveConsentSources, resolveFileRef, resolveFormResultsRequest, resolvePollOptionSources, resolvePollOptions, resolvePollOutcome, resolvePublishedVersionRef, resolveSpamConfig, sanitizeUrl, serializeBody, signPayload, toFormDocument, turnstileProvider, valuesFromSearchParams, votedCookieName };
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -1,22 +1,28 @@
+import { localizedIf } from "./fields/localizedIf.js";
 import { interpolate } from "./recall/interpolate.js";
+import { escapeHtml } from "./actions/body/escapeHtml.js";
+import { defaultBodyConverters, sanitizeUrl } from "./actions/body/converters.js";
+import { renderAllValues, renderAllValuesTable } from "./actions/body/wildcards.js";
+import { serializeBody } from "./actions/body/serializeBody.js";
 import { defineAction } from "./actions/defineAction.js";
 import { SIGNATURE_HEADER, signPayload } from "./actions/sign.js";
-import { defaultActionDefinitions } from "./actions/builtin/index.js";
+import { buildDefaultActionDefinitions, defaultActionDefinitions } from "./actions/builtin/index.js";
 import { resolveActions } from "./actions/registry.js";
-import { FORM_UPLOADS_SLUG, buildUploadsCollection, resolveUploads } from "./collections/uploads.js";
 import { defineConsentSource } from "./consent/defineConsentSource.js";
 import { resolvePublishedVersionRef } from "./consent/resolvePublishedVersionRef.js";
-import { defaultConsentSources } from "./consent/builtin/index.js";
+import { buildDefaultConsentSources, defaultConsentSources } from "./consent/builtin/index.js";
 import { resolveConsentSources } from "./consent/registry.js";
+import { normalizeCalc } from "./calc/normalizeCalc.js";
 import { defineFormField } from "./fields/defineFormField.js";
-import { defaultFieldDefinitions } from "./fields/builtin/index.js";
+import { fileMimeTypeOptions } from "./fields/builtin/file.js";
+import { buildDefaultFieldDefinitions, defaultFieldDefinitions, defaultFieldDefinitionsByType } from "./fields/builtin/index.js";
 import { resolveFieldTypes } from "./fields/registry.js";
+import { isPollClosed } from "./form/pollState.js";
 import { CAPTCHA_TOKEN_KEY, DEFAULT_HONEYPOT_FIELD } from "./spam/constants.js";
 import { aggregateRowForField, aggregateRowsForFields } from "./aggregation/aggregateRows.js";
 import { aggregateFieldResponses, aggregateFormResponses, fieldHasOptions } from "./aggregation/aggregateResponses.js";
 import { resolveFormResultsRequest } from "./aggregation/resolveResultsRequest.js";
-import { normalizeCalc } from "./calc/normalizeCalc.js";
-import { DEFAULT_PRESENTATION_NAME, defaultPresentationDescriptors } from "./presentations/defaults.js";
+import { resolvePollOptions, stashPollOptionSources } from "./poll/resolvePollOptions.js";
 import { evaluateCalc } from "./calc/evaluate.js";
 import { calcExpressionOf, computeCalcFields } from "./calc/computeCalcFields.js";
 import { evaluateCondition } from "./conditions/evaluate.js";
@@ -24,18 +30,27 @@ import { resolveConsentLinks } from "./consent/resolveConsentLinks.js";
 import { captureConsent } from "./consent/captureConsent.js";
 import { resolveFileRef } from "./uploads/resolveFileRef.js";
 import { captureFileRef } from "./uploads/captureFileRef.js";
+import { hasVotedCookie, votedCookieName } from "./submissions/votedCookie.js";
 import { registerCollections } from "./plugin/registerCollections.js";
 import { registerTranslations } from "./plugin/registerTranslations.js";
-import { resolvePresentationDescriptors } from "./presentations/registry.js";
+import { resolvePollOptionSources } from "./poll/registry.js";
 import { defaultIdentify } from "./spam/identify.js";
 import { createKvRateLimiter } from "./spam/rateLimiter.js";
 import { resolveSpamConfig } from "./spam/resolveSpam.js";
 import { defineValidationRule } from "./validation/defineValidationRule.js";
-import { defaultValidationRules } from "./validation/builtin/index.js";
+import { defaultValidationRules, defaultValidationRulesByType } from "./validation/builtin/index.js";
 import { resolveValidationRules } from "./validation/registry.js";
+import { toFormDocument } from "./form/toFormDocument.js";
+import { definePollOptionSource } from "./poll/definePollOptionSource.js";
+import { resolvePollOutcome } from "./poll/resolvePollOutcome.js";
 import { valuesFromSearchParams } from "./prefill/valuesFromSearchParams.js";
+import { DEFAULT_PRESENTATION_NAME, defaultPresentationDescriptors } from "./presentations/defaults.js";
 import { buildRecallResolver, optionLabelsFor } from "./recall/resolver.js";
 import { defineCaptchaProvider } from "./spam/captcha.js";
+import { hcaptchaProvider } from "./spam/providers/hcaptcha.js";
+import { recaptchaProvider } from "./spam/providers/recaptcha.js";
+import { turnstileProvider } from "./spam/providers/turnstile.js";
+import { formatBytes } from "./uploads/formatBytes.js";
 import { definePlugin } from "payload";
 //#region src/index.ts
 const formBuilder = definePlugin({
@@ -43,32 +58,38 @@ const formBuilder = definePlugin({
 	order: 50,
 	plugin: ({ config, plugins, ...options }) => {
 		if (options.disabled === true) return config;
-		const registry = resolveFieldTypes(defaultFieldDefinitions, options.fields);
+		const localizeContent = options.localizeContent !== false;
+		const uploads = options.uploads ?? false;
+		const registry = resolveFieldTypes(buildDefaultFieldDefinitions(localizeContent).filter((definition) => uploads !== false || definition.type !== "file"), options.fields);
 		const ruleRegistry = resolveValidationRules(defaultValidationRules, options.rules);
-		const consentRegistry = resolveConsentSources(defaultConsentSources, options.consentSources);
-		const presentationRegistry = resolvePresentationDescriptors(defaultPresentationDescriptors, options.presentations);
-		const actionRegistry = resolveActions(defaultActionDefinitions, options.actions);
-		const uploads = resolveUploads(options.uploads);
+		const consentRegistry = resolveConsentSources(buildDefaultConsentSources(localizeContent), options.consentSources);
+		const actionRegistry = resolveActions(buildDefaultActionDefinitions(localizeContent, options.richText?.editor), options.actions);
 		const spam = resolveSpamConfig(options.spam);
+		const pollSourceRegistry = resolvePollOptionSources(options.poll?.sources);
+		config.custom = stashPollOptionSources(config.custom, pollSourceRegistry);
 		registerTranslations(config, options.translations);
 		registerCollections({
 			config,
 			registry,
 			ruleRegistry,
 			consentRegistry,
-			presentationRegistry,
 			actionRegistry,
+			richText: options.richText,
 			hasJobsPlugin: Boolean(plugins["@10x-media/jobs"]),
 			events: options.events,
 			uploads,
 			spam,
 			showSubmissionRawFields: options.showSubmissionRawFields ?? false,
+			localizeContent,
+			resultsAccess: options.results?.access,
+			votedCookie: options.poll?.votedCookie === true,
+			pollSourceRegistry,
 			overrides: options.overrides
 		});
 		return config;
 	}
 });
 //#endregion
-export { CAPTCHA_TOKEN_KEY, DEFAULT_HONEYPOT_FIELD, DEFAULT_PRESENTATION_NAME, FORM_UPLOADS_SLUG, SIGNATURE_HEADER, aggregateFieldResponses, aggregateFormResponses, aggregateRowForField, aggregateRowsForFields, buildRecallResolver, buildUploadsCollection, calcExpressionOf, captureConsent, captureFileRef, computeCalcFields, createKvRateLimiter, defaultActionDefinitions, defaultConsentSources, defaultIdentify, defaultPresentationDescriptors, defineAction, defineCaptchaProvider, defineConsentSource, defineFormField, defineValidationRule, evaluateCalc, evaluateCondition, fieldHasOptions, formBuilder, interpolate, normalizeCalc, optionLabelsFor, resolveActions, resolveConsentLinks, resolveConsentSources, resolveFileRef, resolveFormResultsRequest, resolvePresentationDescriptors, resolvePublishedVersionRef, resolveSpamConfig, resolveUploads, signPayload, valuesFromSearchParams };
+export { CAPTCHA_TOKEN_KEY, DEFAULT_HONEYPOT_FIELD, DEFAULT_PRESENTATION_NAME, SIGNATURE_HEADER, aggregateFieldResponses, aggregateFormResponses, aggregateRowForField, aggregateRowsForFields, buildDefaultActionDefinitions, buildDefaultConsentSources, buildDefaultFieldDefinitions, buildRecallResolver, calcExpressionOf, captureConsent, captureFileRef, computeCalcFields, createKvRateLimiter, defaultActionDefinitions, defaultBodyConverters, defaultConsentSources, defaultFieldDefinitions, defaultFieldDefinitionsByType, defaultIdentify, defaultPresentationDescriptors, defaultValidationRules, defaultValidationRulesByType, defineAction, defineCaptchaProvider, defineConsentSource, defineFormField, definePollOptionSource, defineValidationRule, escapeHtml, evaluateCalc, evaluateCondition, fieldHasOptions, fileMimeTypeOptions, formBuilder, formatBytes, hasVotedCookie, hcaptchaProvider, interpolate, isPollClosed, localizedIf, normalizeCalc, optionLabelsFor, recaptchaProvider, renderAllValues, renderAllValuesTable, resolveActions, resolveConsentLinks, resolveConsentSources, resolveFileRef, resolveFormResultsRequest, resolvePollOptionSources, resolvePollOptions, resolvePollOutcome, resolvePublishedVersionRef, resolveSpamConfig, sanitizeUrl, serializeBody, signPayload, toFormDocument, turnstileProvider, valuesFromSearchParams, votedCookieName };
 
 //# sourceMappingURL=index.js.map