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

package/dist/poll/votes/votesCollection.js

@@ -0,0 +1,89 @@
+import { keys } from "../../translations/keys.js";
+import { labelForKey } from "../../translations/server.js";
+import { isLoggedIn } from "../../plugin/access.js";
+//#region src/poll/votes/votesCollection.ts
+const POLL_VOTES_SLUG = "form-poll-votes";
+/** Reserved tally `value` marking the per-field respondents counter (empty answers are never counted, so '' is free). */
+const RESPONDENTS_VALUE = "";
+/**
+* Shard count for hot tally counters. Mongo aborts one of two transactions that write the same
+* document (WriteConflict/TransientTransactionError), so concurrent transactional votes for the
+* same (form, field, value) would deterministically fail one submission. Spreading each
+* transactional bump across VOTE_SHARDS rows makes concurrent bumps land on different shards
+* with high probability, so transactions stop contending. Postgres row locks serialize
+* ON CONFLICT updates without aborting and non-transactional Mongo $inc is conflict-free, so
+* both always use shard 0. Reads sum counts across shards.
+*/
+const VOTE_SHARDS = 8;
+/**
+* Append-only aggregate tallies: up to VOTE_SHARDS rows per (form, field, value) with running
+* counts that readers sum, plus respondents rows per (form, field) under RESPONDENTS_VALUE.
+* Rows carry no per-voter data and are written via atomic upsert-increments (see bumpPollVote),
+* made concurrency-safe by the unique compound index. Ids are stored as strings for cross-DB
+* parity.
+*
+* `indexes` is intentionally not part of the override surface: the unique compound index is
+* load-bearing for the atomic upsert-increment, so it is fixed rather than spread with the rest.
+*/
+const buildPollVotesCollection = (args) => {
+	const defaultFields = [
+		{
+			name: "form",
+			type: "text",
+			required: true,
+			index: true
+		},
+		{
+			name: "field",
+			type: "text",
+			required: true
+		},
+		{
+			name: "value",
+			type: "text"
+		},
+		{
+			name: "shard",
+			type: "number",
+			required: true,
+			defaultValue: 0
+		},
+		{
+			name: "count",
+			type: "number",
+			required: true,
+			defaultValue: 0
+		}
+	];
+	return {
+		...args.overrides ?? {},
+		slug: POLL_VOTES_SLUG,
+		labels: {
+			singular: labelForKey(keys.collectionPollVoteSingular),
+			plural: labelForKey(keys.collectionPollVotePlural),
+			...args.overrides?.labels ?? {}
+		},
+		admin: {
+			hidden: true,
+			...args.overrides?.admin ?? {}
+		},
+		access: {
+			read: isLoggedIn,
+			...args.overrides?.access ?? {}
+		},
+		indexes: [{
+			fields: [
+				"form",
+				"field",
+				"value",
+				"shard"
+			],
+			unique: true
+		}],
+		fields: args.overrides?.fields ? args.overrides.fields({ defaultFields }) : defaultFields
+	};
+};
+//#endregion
+export { POLL_VOTES_SLUG, RESPONDENTS_VALUE, VOTE_SHARDS, buildPollVotesCollection };
+
+//# sourceMappingURL=votesCollection.js.map

package/dist/poll/votes/votesCollection.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"votesCollection.js","names":[],"sources":["../../../src/poll/votes/votesCollection.ts"],"sourcesContent":["import type { CollectionConfig } from 'payload'\nimport { isLoggedIn } from '../../plugin/access'\nimport type { CollectionOverrides } from '../../plugin/collectionOverrides'\nimport { keys } from '../../translations/keys'\nimport { labelForKey } from '../../translations/server'\n\nexport const POLL_VOTES_SLUG = 'form-poll-votes'\n\n/** Reserved tally `value` marking the per-field respondents counter (empty answers are never counted, so '' is free). */\nexport const RESPONDENTS_VALUE = ''\n\n/**\n * Shard count for hot tally counters. Mongo aborts one of two transactions that write the same\n * document (WriteConflict/TransientTransactionError), so concurrent transactional votes for the\n * same (form, field, value) would deterministically fail one submission. Spreading each\n * transactional bump across VOTE_SHARDS rows makes concurrent bumps land on different shards\n * with high probability, so transactions stop contending. Postgres row locks serialize\n * ON CONFLICT updates without aborting and non-transactional Mongo $inc is conflict-free, so\n * both always use shard 0. Reads sum counts across shards.\n */\nexport const VOTE_SHARDS = 8\n\n/**\n * Append-only aggregate tallies: up to VOTE_SHARDS rows per (form, field, value) with running\n * counts that readers sum, plus respondents rows per (form, field) under RESPONDENTS_VALUE.\n * Rows carry no per-voter data and are written via atomic upsert-increments (see bumpPollVote),\n * made concurrency-safe by the unique compound index. Ids are stored as strings for cross-DB\n * parity.\n *\n * `indexes` is intentionally not part of the override surface: the unique compound index is\n * load-bearing for the atomic upsert-increment, so it is fixed rather than spread with the rest.\n */\nexport const buildPollVotesCollection = (args: {\n\toverrides?: CollectionOverrides\n}): CollectionConfig => {\n\tconst defaultFields: CollectionConfig['fields'] = [\n\t\t{ name: 'form', type: 'text', required: true, index: true },\n\t\t{ name: 'field', type: 'text', required: true },\n\t\t{ name: 'value', type: 'text' },\n\t\t{ name: 'shard', type: 'number', required: true, defaultValue: 0 },\n\t\t{ name: 'count', type: 'number', required: true, defaultValue: 0 },\n\t]\n\n\treturn {\n\t\t...(args.overrides ?? {}),\n\t\tslug: POLL_VOTES_SLUG,\n\t\tlabels: {\n\t\t\tsingular: labelForKey(keys.collectionPollVoteSingular),\n\t\t\tplural: labelForKey(keys.collectionPollVotePlural),\n\t\t\t...(args.overrides?.labels ?? {}),\n\t\t},\n\t\tadmin: { hidden: true, ...(args.overrides?.admin ?? {}) },\n\t\taccess: { read: isLoggedIn, ...(args.overrides?.access ?? {}) },\n\t\tindexes: [{ fields: ['form', 'field', 'value', 'shard'], unique: true }],\n\t\tfields: args.overrides?.fields ? args.overrides.fields({ defaultFields }) : defaultFields,\n\t}\n}\n"],"mappings":";;;;AAMA,MAAa,kBAAkB;;AAG/B,MAAa,oBAAoB;;;;;;;;;;AAWjC,MAAa,cAAc;;;;;;;;;;;AAY3B,MAAa,4BAA4B,SAEjB;CACvB,MAAM,gBAA4C;EACjD;GAAE,MAAM;GAAQ,MAAM;GAAQ,UAAU;GAAM,OAAO;EAAK;EAC1D;GAAE,MAAM;GAAS,MAAM;GAAQ,UAAU;EAAK;EAC9C;GAAE,MAAM;GAAS,MAAM;EAAO;EAC9B;GAAE,MAAM;GAAS,MAAM;GAAU,UAAU;GAAM,cAAc;EAAE;EACjE;GAAE,MAAM;GAAS,MAAM;GAAU,UAAU;GAAM,cAAc;EAAE;CAClE;CAEA,OAAO;EACN,GAAI,KAAK,aAAa,CAAC;EACvB,MAAM;EACN,QAAQ;GACP,UAAU,YAAY,KAAK,0BAA0B;GACrD,QAAQ,YAAY,KAAK,wBAAwB;GACjD,GAAI,KAAK,WAAW,UAAU,CAAC;EAChC;EACA,OAAO;GAAE,QAAQ;GAAM,GAAI,KAAK,WAAW,SAAS,CAAC;EAAG;EACxD,QAAQ;GAAE,MAAM;GAAY,GAAI,KAAK,WAAW,UAAU,CAAC;EAAG;EAC9D,SAAS,CAAC;GAAE,QAAQ;IAAC;IAAQ;IAAS;IAAS;GAAO;GAAG,QAAQ;EAAK,CAAC;EACvE,QAAQ,KAAK,WAAW,SAAS,KAAK,UAAU,OAAO,EAAE,cAAc,CAAC,IAAI;CAC7E;AACD"}

package/dist/prefill/valuesFromSearchParams.js

@@ -1,17 +1,13 @@
+import { isNamedField } from "../fields/fieldKey.js";
+import { isTruthyString } from "../submissions/coerceBoolean.js";
 //#region src/prefill/valuesFromSearchParams.ts
-const TRUTHY = new Set([
-	"true",
-	"1",
-	"on",
-	"yes"
-]);
 const coerce = (kind, raw, all) => {
 	switch (kind) {
 		case "number": {
 			const n = Number(raw);
 			return Number.isNaN(n) ? void 0 : n;
 		}
-		case "boolean": return TRUTHY.has(raw.toLowerCase());
+		case "boolean": return isTruthyString(raw);
 		case "text[]": return all;
 		default: return raw;
 	}
@@ -24,7 +20,7 @@ const coerce = (kind, raw, all) => {
 const valuesFromSearchParams = (params, fields, registry, options = {}) => {
 	const isSearch = params instanceof URLSearchParams;
 	const paramKeys = isSearch ? [...new Set(params.keys())] : Object.keys(params);
-	const byName = new Map(fields.map((field) => [field.name, field]));
+	const byName = new Map(fields.filter(isNamedField).map((field) => [field.name, field]));
 	const result = {};
 	for (const param of paramKeys) {
 		const fieldName = options.map?.[param] ?? param;
@@ -32,7 +28,7 @@ const valuesFromSearchParams = (params, fields, registry, options = {}) => {
 		if (options.deny?.includes(fieldName)) continue;
 		const field = byName.get(fieldName);
 		const definition = field && registry.get(field.blockType);
-		if (!field || !definition) continue;
+		if (!field || !definition || definition.value === "none") continue;
 		const all = isSearch ? params.getAll(param) : [params[param]];
 		const value = coerce(definition.value, all[0] ?? "", all);
 		if (value !== void 0) result[fieldName] = value;

package/dist/prefill/valuesFromSearchParams.js.map

@@ -1 +1 @@
-{"version":3,"file":"valuesFromSearchParams.js","names":[],"sources":["../../src/prefill/valuesFromSearchParams.ts"],"sourcesContent":["import type { FieldTypeRegistry } from '../fields/registry'\nimport type { FormFieldValueKind } from '../fields/types'\nimport type { FormFieldInstance } from '../submissions/types'\n\nexport type PrefillOptions = {\n\t/** Map a query-param name to a field name. Unmapped params use their own name. */\n\tmap?: Record<string, string>\n\t/** If set, only these field names may be prefilled. */\n\tallow?: string[]\n\t/** These field names may never be prefilled. */\n\tdeny?: string[]\n}\n\nconst TRUTHY = new Set(['true', '1', 'on', 'yes'])\n\nconst coerce = (kind: FormFieldValueKind, raw: string, all: string[]): unknown => {\n\tswitch (kind) {\n\t\tcase 'number': {\n\t\t\tconst n = Number(raw)\n\t\t\treturn Number.isNaN(n) ? undefined : n\n\t\t}\n\t\tcase 'boolean':\n\t\t\treturn TRUTHY.has(raw.toLowerCase())\n\t\tcase 'text[]':\n\t\t\treturn all\n\t\tdefault:\n\t\t\treturn raw\n\t}\n}\n\n/**\n * Map URL/query params to typed initial values for KNOWN fields only, coerced by each field's value\n * kind. Unknown, denied, or un-allowed params are ignored; invalid numbers are dropped. Prefilled\n * values are never trusted -- they still validate on submit. Pass the result to `<Form initialValues>`.\n */\n// biome-ignore lint/complexity/useMaxParams: four positional args are the minimal surface (params, fields, registry, options)\nexport const valuesFromSearchParams = (\n\tparams: URLSearchParams | Record<string, string>,\n\tfields: FormFieldInstance[],\n\tregistry: FieldTypeRegistry,\n\toptions: PrefillOptions = {}\n): Record<string, unknown> => {\n\tconst isSearch = params instanceof URLSearchParams\n\tconst paramKeys = isSearch ? [...new Set(params.keys())] : Object.keys(params)\n\tconst byName = new Map(fields.map((field) => [field.name, field]))\n\tconst result: Record<string, unknown> = {}\n\n\tfor (const param of paramKeys) {\n\t\tconst fieldName = options.map?.[param] ?? param\n\n\t\tif (options.allow && !options.allow.includes(fieldName)) {\n\t\t\tcontinue\n\t\t}\n\t\tif (options.deny?.includes(fieldName)) {\n\t\t\tcontinue\n\t\t}\n\n\t\tconst field = byName.get(fieldName)\n\t\tconst definition = field && registry.get(field.blockType)\n\t\tif (!field || !definition) {\n\t\t\tcontinue\n\t\t}\n\n\t\tconst all = isSearch ? params.getAll(param) : [params[param] as string]\n\t\tconst value = coerce(definition.value, all[0] ?? '', all)\n\t\tif (value !== undefined) {\n\t\t\tresult[fieldName] = value\n\t\t}\n\t}\n\n\treturn result\n}\n"],"mappings":";AAaA,MAAM,SAAS,IAAI,IAAI;CAAC;CAAQ;CAAK;CAAM;AAAK,CAAC;AAEjD,MAAM,UAAU,MAA0B,KAAa,QAA2B;CACjF,QAAQ,MAAR;EACC,KAAK,UAAU;GACd,MAAM,IAAI,OAAO,GAAG;GACpB,OAAO,OAAO,MAAM,CAAC,IAAI,KAAA,IAAY;EACtC;EACA,KAAK,WACJ,OAAO,OAAO,IAAI,IAAI,YAAY,CAAC;EACpC,KAAK,UACJ,OAAO;EACR,SACC,OAAO;CACT;AACD;;;;;;AAQA,MAAa,0BACZ,QACA,QACA,UACA,UAA0B,CAAC,MACE;CAC7B,MAAM,WAAW,kBAAkB;CACnC,MAAM,YAAY,WAAW,CAAC,GAAG,IAAI,IAAI,OAAO,KAAK,CAAC,CAAC,IAAI,OAAO,KAAK,MAAM;CAC7E,MAAM,SAAS,IAAI,IAAI,OAAO,KAAK,UAAU,CAAC,MAAM,MAAM,KAAK,CAAC,CAAC;CACjE,MAAM,SAAkC,CAAC;CAEzC,KAAK,MAAM,SAAS,WAAW;EAC9B,MAAM,YAAY,QAAQ,MAAM,UAAU;EAE1C,IAAI,QAAQ,SAAS,CAAC,QAAQ,MAAM,SAAS,SAAS,GACrD;EAED,IAAI,QAAQ,MAAM,SAAS,SAAS,GACnC;EAGD,MAAM,QAAQ,OAAO,IAAI,SAAS;EAClC,MAAM,aAAa,SAAS,SAAS,IAAI,MAAM,SAAS;EACxD,IAAI,CAAC,SAAS,CAAC,YACd;EAGD,MAAM,MAAM,WAAW,OAAO,OAAO,KAAK,IAAI,CAAC,OAAO,MAAgB;EACtE,MAAM,QAAQ,OAAO,WAAW,OAAO,IAAI,MAAM,IAAI,GAAG;EACxD,IAAI,UAAU,KAAA,GACb,OAAO,aAAa;CAEtB;CAEA,OAAO;AACR"}
+{"version":3,"file":"valuesFromSearchParams.js","names":[],"sources":["../../src/prefill/valuesFromSearchParams.ts"],"sourcesContent":["import { isNamedField } from '../fields/fieldKey'\nimport type { FieldTypeRegistry } from '../fields/registry'\nimport type { FormFieldValueKind } from '../fields/types'\nimport { isTruthyString } from '../submissions/coerceBoolean'\nimport type { FormFieldInstance } from '../submissions/types'\n\nexport type PrefillOptions = {\n\t/** Map a query-param name to a field name. Unmapped params use their own name. */\n\tmap?: Record<string, string>\n\t/** If set, only these field names may be prefilled. */\n\tallow?: string[]\n\t/** These field names may never be prefilled. */\n\tdeny?: string[]\n}\n\nconst coerce = (kind: FormFieldValueKind, raw: string, all: string[]): unknown => {\n\tswitch (kind) {\n\t\tcase 'number': {\n\t\t\tconst n = Number(raw)\n\t\t\treturn Number.isNaN(n) ? undefined : n\n\t\t}\n\t\tcase 'boolean':\n\t\t\treturn isTruthyString(raw)\n\t\tcase 'text[]':\n\t\t\treturn all\n\t\tdefault:\n\t\t\treturn raw\n\t}\n}\n\n/**\n * Map URL/query params to typed initial values for KNOWN fields only, coerced by each field's value\n * kind. Unknown, denied, or un-allowed params are ignored; invalid numbers are dropped. Prefilled\n * values are never trusted -- they still validate on submit. Pass the result to `<Form initialValues>`.\n */\n// biome-ignore lint/complexity/useMaxParams: four positional args are the minimal surface (params, fields, registry, options)\nexport const valuesFromSearchParams = (\n\tparams: URLSearchParams | Record<string, string>,\n\tfields: FormFieldInstance[],\n\tregistry: FieldTypeRegistry,\n\toptions: PrefillOptions = {}\n): Record<string, unknown> => {\n\tconst isSearch = params instanceof URLSearchParams\n\tconst paramKeys = isSearch ? [...new Set(params.keys())] : Object.keys(params)\n\tconst byName = new Map(fields.filter(isNamedField).map((field) => [field.name, field]))\n\tconst result: Record<string, unknown> = {}\n\n\tfor (const param of paramKeys) {\n\t\tconst fieldName = options.map?.[param] ?? param\n\n\t\tif (options.allow && !options.allow.includes(fieldName)) {\n\t\t\tcontinue\n\t\t}\n\t\tif (options.deny?.includes(fieldName)) {\n\t\t\tcontinue\n\t\t}\n\n\t\tconst field = byName.get(fieldName)\n\t\tconst definition = field && registry.get(field.blockType)\n\t\t// 'none'-kind (display-only) fields carry no value, so a param under their name is ignored.\n\t\tif (!field || !definition || definition.value === 'none') {\n\t\t\tcontinue\n\t\t}\n\n\t\tconst all = isSearch ? params.getAll(param) : [params[param] as string]\n\t\tconst value = coerce(definition.value, all[0] ?? '', all)\n\t\tif (value !== undefined) {\n\t\t\tresult[fieldName] = value\n\t\t}\n\t}\n\n\treturn result\n}\n"],"mappings":";;;AAeA,MAAM,UAAU,MAA0B,KAAa,QAA2B;CACjF,QAAQ,MAAR;EACC,KAAK,UAAU;GACd,MAAM,IAAI,OAAO,GAAG;GACpB,OAAO,OAAO,MAAM,CAAC,IAAI,KAAA,IAAY;EACtC;EACA,KAAK,WACJ,OAAO,eAAe,GAAG;EAC1B,KAAK,UACJ,OAAO;EACR,SACC,OAAO;CACT;AACD;;;;;;AAQA,MAAa,0BACZ,QACA,QACA,UACA,UAA0B,CAAC,MACE;CAC7B,MAAM,WAAW,kBAAkB;CACnC,MAAM,YAAY,WAAW,CAAC,GAAG,IAAI,IAAI,OAAO,KAAK,CAAC,CAAC,IAAI,OAAO,KAAK,MAAM;CAC7E,MAAM,SAAS,IAAI,IAAI,OAAO,OAAO,YAAY,EAAE,KAAK,UAAU,CAAC,MAAM,MAAM,KAAK,CAAC,CAAC;CACtF,MAAM,SAAkC,CAAC;CAEzC,KAAK,MAAM,SAAS,WAAW;EAC9B,MAAM,YAAY,QAAQ,MAAM,UAAU;EAE1C,IAAI,QAAQ,SAAS,CAAC,QAAQ,MAAM,SAAS,SAAS,GACrD;EAED,IAAI,QAAQ,MAAM,SAAS,SAAS,GACnC;EAGD,MAAM,QAAQ,OAAO,IAAI,SAAS;EAClC,MAAM,aAAa,SAAS,SAAS,IAAI,MAAM,SAAS;EAExD,IAAI,CAAC,SAAS,CAAC,cAAc,WAAW,UAAU,QACjD;EAGD,MAAM,MAAM,WAAW,OAAO,OAAO,KAAK,IAAI,CAAC,OAAO,MAAgB;EACtE,MAAM,QAAQ,OAAO,WAAW,OAAO,IAAI,MAAM,IAAI,GAAG;EACxD,IAAI,UAAU,KAAA,GACb,OAAO,aAAa;CAEtB;CAEA,OAAO;AACR"}

package/dist/presentations/types.d.ts

@@ -3,8 +3,9 @@
 type PresentationSurface = 'inline' | 'page' | 'overlay';
 type PresentationDensity = 'comfortable' | 'compact';
 /**
- * Serializable, framework-agnostic description of a presentation. The admin select and the
- * stored `defaultPresentation` use only this; the React `Wrapper` is added in `./react`. No React here.
+ * Serializable, framework-agnostic description of a presentation. `presentations/defaults.ts`
+ * ships the built-ins the React presentation registry wraps with a `Wrapper` (see `./react`). No
+ * React here.
  */
 type PresentationDescriptor = {
   name: string; /** i18n key or literal shown in the admin select. */

package/dist/react/Form.d.ts

@@ -1,9 +1,12 @@
+import { SubmissionValue } from "../submissions/types.js";
 import { AnyFormFieldDefinition } from "../fields/types.js";
-import { FormFieldInstance } from "../submissions/types.js";
-import { FormFlow } from "../flow/types.js";
+import { BodyConverter } from "../actions/body/converters.js";
+import { FormButtonSettings, FormDocument, FormPollSettings, FormResponseSettings } from "../form/types.js";
+import { FormAdapters } from "./adapters.js";
 import { RendererTranslate } from "./contract.js";
 import { FormEventSink } from "../events/types.js";
 import { AnyValidationRuleDefinition } from "../validation/types.js";
+import { BackButtonRenderProps, NextButtonRenderProps, SubmitButtonRenderProps } from "./FormControls.js";
 import { FormPresentation } from "./presentation/types.js";
 import { PresentationsConfig } from "./presentation/registry.js";
 import { RenderersConfig } from "./registry.js";
@@ -11,28 +14,21 @@ import { SubmitHandler } from "./submitForm.js";
 import { ReactNode } from "react";
 
 //#region src/react/Form.d.ts
-type FormDocument = {
-  id: number | string;
-  fields: FormFieldInstance[];
-  flow?: FormFlow; /** Stored presentation name; overridden by the `presentation` prop. */
-  defaultPresentation?: string;
+/**
+ * The success response passed to `onSuccess`, recall-resolved and (for a message) serialized with the
+ * form's active converters, so a host can render or toast the resolved response without re-deriving it.
+ */
+type FormSuccessResponse = {
+  type: 'message';
+  html?: string;
+} | {
+  type: 'redirect';
+  url?: string;
 };
-/** Props passed to `renderSubmit`. */
-type SubmitButtonRenderProps = {
-  label: string;
-  submitting: boolean;
-};
-/** Props passed to `renderNext`. */
-type NextButtonRenderProps = {
-  label: string;
-  submitting: boolean;
-  onClick: () => void;
-};
-/** Props passed to `renderBack`. */
-type BackButtonRenderProps = {
-  label: string;
-  submitting: boolean;
-  onClick: () => void;
+/** The second argument to `onSuccess`: the resolved success response (an object, so it can grow). */
+type FormSuccessResult = {
+  response?: FormSuccessResponse; /** The submitted answers (reserved keys like the honeypot and captcha token excluded), e.g. for `<Poll>` to track the voter's pick. */
+  values?: SubmissionValue[];
 };
 type FormProps = {
   form: FormDocument;
@@ -41,27 +37,61 @@ type FormProps = {
   renderers?: RenderersConfig;
   apiRoute?: string;
   onSubmit?: SubmitHandler;
-  onSuccess?: (submissionId?: string) => void;
+  /**
+   * Called after a successful submission with the submission id and the resolved success response
+   * (recall-applied, serialized with `converters`), so a host can toast or render it. Fires in both
+   * `successBehavior` modes and on the custom-`children` path.
+   */
+  onSuccess?: (submissionId?: string, result?: FormSuccessResult) => void;
   onError?: (message: string) => void;
+  /**
+   * Custom Lexical block converters (e.g. host `icon`/`badge` blocks) spread over the defaults for the
+   * client serializer, so those blocks survive in the success message and in the `onSuccess` response.
+   */
+  converters?: Record<string, BodyConverter>;
+  /**
+   * What happens on a successful submit. `'replace'` (default) swaps the form for the success screen;
+   * `'reset'` clears the fields in place and shows no success screen, so a host can toast via `onSuccess`
+   * and keep the form usable.
+   */
+  successBehavior?: 'replace' | 'reset';
+  /**
+   * Client halves of the plugin's registered `calc.functions` (same keys), used for the live calc
+   * preview only; the server always recomputes authoritatively at submit with the registry's own
+   * functions.
+   */
+  calcFunctions?: Record<string, (args: number[]) => number>;
   events?: FormEventSink;
   t?: RendererTranslate;
   locale?: string;
-  layout?: boolean;
-  submitLabel?: string;
-  nextLabel?: string;
-  backLabel?: string; /** Label for the overlay close control (modal/drawer). */
+  layout?: boolean; /** Submit button label. Precedence: this prop, then the form's `buttons.submitLabel`, then the translated default. */
+  submitLabel?: string; /** "Next" button label for multi-step forms. Precedence: this prop, then the form's `buttons.nextLabel`, then the translated default. */
+  nextLabel?: string; /** "Back" button label for multi-step forms. Precedence: this prop, then the form's `buttons.prevLabel`, then the translated default. */
+  prevLabel?: string; /** Label for the overlay close control (modal/drawer). */
   closeLabel?: string;
-  successMessage?: string; /** Active presentation: a name into the registry or an inline presentation. Overrides the form's stored default. */
+  successMessage?: string; /** Active presentation: a name into the registry or an inline presentation. Defaults to `'page'` when omitted. */
   presentation?: string | FormPresentation; /** Per-render presentation overrides merged onto the defaults (add, replace, or `false` to remove). */
   presentations?: PresentationsConfig; /** Invoked when an overlay presentation dismisses (close button, Escape, outside click, or `dismissOnSuccess`). */
-  onClose?: () => void; /** Accessible name for an overlay surface. */
+  onClose?: () => void;
+  /**
+   * Accessible name for an overlay surface (modal/drawer). Hosts choosing between a trigger
+   * label and the form's own admin title should prefer `form.title` when set, falling back to
+   * their own label otherwise.
+   */
   title?: string; /** Seed initial field values (e.g. from `valuesFromSearchParams`). Still validated on submit. */
   initialValues?: Record<string, unknown>; /** Honeypot decoy (on by default). `false` removes it; `{ name }` matches a customized server `spam.honeypot.fieldName`. */
   honeypot?: false | {
     name?: string;
   }; /** A token from your captcha widget; verified server-side when a captcha provider is configured. */
-  captchaToken?: string; /** Custom layout: render fields with `useField`/`useFormState` instead of the auto-rendered field loop. */
-  children?: ReactNode; /** Additional CSS class names applied to the root `<form>` element (and the success node). */
+  captchaToken?: string;
+  /**
+   * A signed form-context token from `signFormContext` (server/RSC), tying this render to a document
+   * (e.g. the profile page it is on). Carried alongside the answers, verified server-side, and
+   * available to `email.recipientSources`; it is never stored as an answer.
+   */
+  context?: string; /** Custom layout: render fields with `useField`/`useFormState` instead of the auto-rendered field loop. */
+  children?: ReactNode; /** Chrome rendered inside the form, above the fields, in default mode (e.g. `<FormSteps />`). */
+  header?: ReactNode; /** Additional CSS class names applied to the root `<form>` element (and the success node). */
   className?: string; /** Replace the default submit button entirely. Receives the resolved label and submitting state. */
   renderSubmit?: (props: SubmitButtonRenderProps) => ReactNode; /** Replace the default "Next" button in multi-step forms. */
   renderNext?: (props: NextButtonRenderProps) => ReactNode; /** Replace the default "Back" button in multi-step forms. */
@@ -69,6 +99,12 @@ type FormProps = {
   submitButtonClassName?: string; /** CSS class forwarded to the default "Next" `<button>`. Ignored when `renderNext` is provided. */
   nextButtonClassName?: string; /** CSS class forwarded to the default "Back" `<button>`. Ignored when `renderBack` is provided. */
   backButtonClassName?: string;
+  /**
+   * Host-owned effects (navigation, vote persistence, script loading). Each member defaults to
+   * the built-in DOM behavior; see {@link FormAdapters}. Pass a stable reference (module scope or
+   * `useMemo`), matching the other injectable props.
+   */
+  adapters?: FormAdapters;
 };
 /** The headless form controller: state, progressive client validation, conditional visibility, submission, events. */
 declare const Form: ({
@@ -80,13 +116,16 @@ declare const Form: ({
   onSubmit,
   onSuccess,
   onError,
+  converters,
+  successBehavior,
+  calcFunctions,
   events,
   t,
   locale,
   layout,
   submitLabel,
   nextLabel,
-  backLabel,
+  prevLabel,
   closeLabel,
   successMessage,
   presentation,
@@ -96,15 +135,18 @@ declare const Form: ({
   initialValues,
   honeypot,
   captchaToken,
+  context,
   children,
+  header,
   className,
   renderSubmit,
   renderNext,
   renderBack,
   submitButtonClassName,
   nextButtonClassName,
-  backButtonClassName
+  backButtonClassName,
+  adapters
 }: FormProps) => import("react/jsx-runtime").JSX.Element;
 //#endregion
-export { BackButtonRenderProps, Form, FormDocument, FormProps, NextButtonRenderProps, SubmitButtonRenderProps };
+export { Form, FormProps, FormSuccessResponse, FormSuccessResult };
 //# sourceMappingURL=Form.d.ts.map