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

package/dist/fields/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","names":[],"sources":["../../src/fields/registry.ts"],"sourcesContent":["import type { AnyFormFieldDefinition } from './types'\n\nexport type FieldTypeRegistry = Map<string, AnyFormFieldDefinition>\n\n/** Per-type opt-in: `false` removes a built-in, `true` keeps it, an object adds a new type or replaces one. */\nexport type FieldTypeOption = boolean | AnyFormFieldDefinition\n\nexport type FieldTypesConfig = Record<string, FieldTypeOption>\n\nexport const buildRegistry = (definitions: AnyFormFieldDefinition[]): FieldTypeRegistry => {\n\tconst registry: FieldTypeRegistry = new Map()\n\tfor (const definition of definitions) {\n\t\tregistry.set(definition.type, definition)\n\t}\n\treturn registry\n}\n\n/**\n * Resolve the active field-type registry from the built-in defaults and the plugin `fields` option.\n * `false` removes a type, `true` keeps the default, an object adds a new type or replaces an existing\n * one (its `type` is forced to the config key so an override cannot rename the slot).\n */\nexport const resolveFieldTypes = (\n\tdefaults: AnyFormFieldDefinition[],\n\tconfig: FieldTypesConfig = {}\n): FieldTypeRegistry => {\n\tconst registry = buildRegistry(defaults)\n\tfor (const [type, option] of Object.entries(config)) {\n\t\tif (option === false) {\n\t\t\tregistry.delete(type)\n\t\t} else if (option === true) {\n\t\t\t// keep the default; a no-op when no default exists for this key\n\t\t} else {\n\t\t\tregistry.set(type, { ...option, type })\n\t\t}\n\t}\n\treturn registry\n}\n"],"mappings":";AASA,MAAa,iBAAiB,gBAA6D;CAC1F,MAAM,2BAA8B,IAAI,IAAI;CAC5C,KAAK,MAAM,cAAc,aACxB,SAAS,IAAI,WAAW,MAAM,UAAU;CAEzC,OAAO;AACR;;;;;;AAOA,MAAa,qBACZ,UACA,SAA2B,CAAC,MACL;CACvB,MAAM,WAAW,cAAc,QAAQ;CACvC,KAAK,MAAM,CAAC,MAAM,WAAW,OAAO,QAAQ,MAAM,GACjD,IAAI,WAAW,OACd,SAAS,OAAO,IAAI;MACd,IAAI,WAAW,MAAM,CAE5B,OACC,SAAS,IAAI,MAAM;EAAE,GAAG;EAAQ;CAAK,CAAC;CAGxC,OAAO;AACR"}

package/dist/fields/sharedConfig.js

@@ -0,0 +1,89 @@
+import { keys } from "../translations/keys.js";
+import { labelFor } from "../translations/server.js";
+//#region src/fields/sharedConfig.ts
+const CONDITION_FIELD_REF = "@10x-media/form-builder/client#FormConditionField";
+const conditionField = (name, labelKey, conditionTypes) => ({
+	name,
+	type: "json",
+	label: labelFor(labelKey),
+	admin: { components: { Field: {
+		path: CONDITION_FIELD_REF,
+		clientProps: { conditionTypes }
+	} } }
+});
+/**
+* Config every field instance carries regardless of type. `name` is the machine key written into
+* submissions; `width` is stored for the layout grid. `visibleWhen`/`validateWhen` store a
+* canonical Payload `Where`, edited by the native condition builder. Field types add their own `config`
+* after these.
+*/
+const sharedFieldConfig = (conditionTypes) => [
+	{
+		name: "name",
+		type: "text",
+		required: true,
+		label: labelFor(keys.configName)
+	},
+	{
+		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"
+			},
+			{
+				label: "Two thirds",
+				value: "twoThirds"
+			}
+		]
+	},
+	{
+		name: "placeholder",
+		type: "text",
+		label: labelFor(keys.configPlaceholder)
+	},
+	{
+		name: "description",
+		type: "textarea",
+		label: labelFor(keys.configDescription)
+	},
+	{
+		type: "collapsible",
+		label: labelFor(keys.configAdvanced),
+		admin: { initCollapsed: true },
+		fields: [
+			conditionField("visibleWhen", keys.configVisibleWhen, conditionTypes),
+			conditionField("validateWhen", keys.configValidateWhen, conditionTypes),
+			{
+				name: "hidden",
+				type: "checkbox",
+				label: labelFor(keys.configHidden)
+			}
+		]
+	}
+];
+//#endregion
+export { sharedFieldConfig };
+
+//# sourceMappingURL=sharedConfig.js.map

package/dist/fields/sharedConfig.js.map

@@ -0,0 +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. `visibleWhen`/`validateWhen` store a\n * canonical Payload `Where`, edited by the native condition builder. Field types add their own `config`\n * after these.\n */\nexport const sharedFieldConfig = (conditionTypes: Record<string, ConditionFieldType>): 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\t{\n\t\ttype: 'collapsible',\n\t\tlabel: labelFor(keys.configAdvanced),\n\t\tadmin: { initCollapsed: true },\n\t\tfields: [\n\t\t\tconditionField('visibleWhen', keys.configVisibleWhen, conditionTypes),\n\t\t\tconditionField('validateWhen', keys.configValidateWhen, conditionTypes),\n\t\t\t{ name: 'hidden', type: 'checkbox', label: labelFor(keys.configHidden) },\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;;;;;;;AAQA,MAAa,qBAAqB,mBAAgE;CACjG;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;CACjF;EACC,MAAM;EACN,OAAO,SAAS,KAAK,cAAc;EACnC,OAAO,EAAE,eAAe,KAAK;EAC7B,QAAQ;GACP,eAAe,eAAe,KAAK,mBAAmB,cAAc;GACpE,eAAe,gBAAgB,KAAK,oBAAoB,cAAc;GACtE;IAAE,MAAM;IAAU,MAAM;IAAY,OAAO,SAAS,KAAK,YAAY;GAAE;EACxE;CACD;AACD"}

package/dist/fields/types.d.ts

@@ -0,0 +1,89 @@
+import { FileRef } from "../uploads/types.js";
+import { ConditionFieldType } from "../conditions/fieldTypes.js";
+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';
+type ValueKindTypeMap = {
+  text: string;
+  number: number;
+  boolean: boolean;
+  date: string;
+  'text[]': string[];
+  file: FileRef;
+  repeater: Array<Record<string, unknown>>;
+};
+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). */
+type FormFieldConfigValues = Record<string, unknown>;
+/** A `t`-like resolver. The engine supplies one from the request i18n; the renderer will supply the client i18n. */
+type Translate = (key: string) => string;
+type FormFieldValidateArgs<K extends FormFieldValueKind, TConfig extends FormFieldConfigValues> = {
+  value: ValueOfKind<K> | null | undefined;
+  config: TConfig;
+  siblingData: Record<string, unknown>;
+  data: Record<string, unknown>;
+  locale: string;
+  t: Translate;
+};
+type FormFieldValidate<K extends FormFieldValueKind, TConfig extends FormFieldConfigValues> = (args: FormFieldValidateArgs<K, TConfig>) => Promise<string | true> | string | true;
+type FormFieldFormatArgs<K extends FormFieldValueKind, TConfig extends FormFieldConfigValues> = {
+  value: ValueOfKind<K> | null | undefined;
+  config: TConfig;
+  optionLabels?: Record<string, string>;
+  locale: string;
+  t: Translate;
+};
+type FormFieldFormat<K extends FormFieldValueKind, TConfig extends FormFieldConfigValues> = (args: FormFieldFormatArgs<K, TConfig>) => string;
+/**
+ * A field type, authored once. `value` drives typed `validate`/`format`; `config` is a Payload
+ * `Field[]` for the add-field drawer; `Field` is the client renderer import-map ref;
+ * `label` is an i18n key or a literal.
+ */
+type FormFieldDefinition<K extends FormFieldValueKind = FormFieldValueKind, TConfig extends FormFieldConfigValues = FormFieldConfigValues> = {
+  type: string;
+  label: string;
+  value: K;
+  config?: Field[];
+  validate?: FormFieldValidate<K, TConfig>;
+  format?: FormFieldFormat<K, TConfig>;
+  Field?: string; /** Optional Standard Schema validator (Zod/Valibot/etc.), run by the engine after the intrinsic validator. */
+  schema?: StandardSchemaV1;
+  icon?: string;
+  group?: string; /** How this field appears in the condition builder. Defaults from `value` (see `defaultConditionType`). */
+  conditionType?: ConditionFieldType;
+};
+/** The erased shape stored in the heterogeneous registry. Value is `unknown`; config re-narrows per matched type at execution. */
+type AnyFormFieldValidate = (args: {
+  value: unknown;
+  config: FormFieldConfigValues;
+  siblingData: Record<string, unknown>;
+  data: Record<string, unknown>;
+  locale: string;
+  t: Translate;
+}) => Promise<string | true> | string | true;
+type AnyFormFieldFormat = (args: {
+  value: unknown;
+  config: FormFieldConfigValues;
+  optionLabels?: Record<string, string>;
+  locale: string;
+  t: Translate;
+}) => string;
+type AnyFormFieldDefinition = {
+  type: string;
+  label: string;
+  value: FormFieldValueKind;
+  config?: Field[];
+  validate?: AnyFormFieldValidate;
+  format?: AnyFormFieldFormat;
+  Field?: string;
+  schema?: StandardSchemaV1;
+  icon?: string;
+  group?: string; /** How this field appears in the condition builder. Defaults from `value` (see `defaultConditionType`). */
+  conditionType?: ConditionFieldType;
+};
+//#endregion
+export { AnyFormFieldDefinition, FormFieldConfigValues, FormFieldDefinition, FormFieldFormat, FormFieldValidate, FormFieldValueKind, Translate };
+//# sourceMappingURL=types.d.ts.map

package/dist/flow/engine.d.ts

@@ -0,0 +1,17 @@
+import { FormFlow } from "./types.js";
+
+//#region src/flow/engine.d.ts
+/** The entry step id (the first step), or `undefined` for an empty flow. */
+declare const firstStepId: (flow: FormFlow) => string | undefined;
+/** The field machine names a step renders (empty for an unknown step). */
+declare const stepFieldNames: (flow: FormFlow, id: string) => string[];
+/**
+ * Resolve the next step id from the current step + answers: the first transition whose `when` matches
+ * (via `evaluateCondition`), else the default `next`, else `undefined` (terminal). Pure + isomorphic.
+ */
+declare const resolveNextStepId: (flow: FormFlow, currentId: string, answers: Record<string, unknown>) => string | undefined;
+/** Whether the current step is terminal (no matching transition + no default next). */
+declare const isTerminalStepId: (flow: FormFlow, currentId: string, answers: Record<string, unknown>) => boolean;
+//#endregion
+export { firstStepId, isTerminalStepId, resolveNextStepId, stepFieldNames };
+//# sourceMappingURL=engine.d.ts.map

package/dist/flow/engine.js

@@ -0,0 +1,24 @@
+import { evaluateCondition } from "../conditions/evaluate.js";
+//#region src/flow/engine.ts
+/** The entry step id (the first step), or `undefined` for an empty flow. */
+const firstStepId = (flow) => flow.steps[0]?.id;
+/** The step with the given id, or `undefined`. */
+const getStep = (flow, id) => flow.steps.find((step) => step.id === id);
+/** The field machine names a step renders (empty for an unknown step). */
+const stepFieldNames = (flow, id) => getStep(flow, id)?.fields ?? [];
+/**
+* Resolve the next step id from the current step + answers: the first transition whose `when` matches
+* (via `evaluateCondition`), else the default `next`, else `undefined` (terminal). Pure + isomorphic.
+*/
+const resolveNextStepId = (flow, currentId, answers) => {
+	const step = getStep(flow, currentId);
+	if (!step) return;
+	for (const transition of step.transitions ?? []) if (evaluateCondition(transition.when, answers)) return transition.to;
+	return step.next;
+};
+/** Whether the current step is terminal (no matching transition + no default next). */
+const isTerminalStepId = (flow, currentId, answers) => resolveNextStepId(flow, currentId, answers) === void 0;
+//#endregion
+export { firstStepId, isTerminalStepId, resolveNextStepId, stepFieldNames };
+
+//# sourceMappingURL=engine.js.map

package/dist/flow/engine.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","names":[],"sources":["../../src/flow/engine.ts"],"sourcesContent":["import { evaluateCondition } from '../conditions/evaluate'\nimport type { FlowStep, FormFlow } from './types'\n\n/** The entry step id (the first step), or `undefined` for an empty flow. */\nexport const firstStepId = (flow: FormFlow): string | undefined => flow.steps[0]?.id\n\n/** The step with the given id, or `undefined`. */\nexport const getStep = (flow: FormFlow, id: string): FlowStep | undefined =>\n\tflow.steps.find((step) => step.id === id)\n\n/** The field machine names a step renders (empty for an unknown step). */\nexport const stepFieldNames = (flow: FormFlow, id: string): string[] =>\n\tgetStep(flow, id)?.fields ?? []\n\n/**\n * Resolve the next step id from the current step + answers: the first transition whose `when` matches\n * (via `evaluateCondition`), else the default `next`, else `undefined` (terminal). Pure + isomorphic.\n */\nexport const resolveNextStepId = (\n\tflow: FormFlow,\n\tcurrentId: string,\n\tanswers: Record<string, unknown>\n): string | undefined => {\n\tconst step = getStep(flow, currentId)\n\tif (!step) {\n\t\treturn undefined\n\t}\n\tfor (const transition of step.transitions ?? []) {\n\t\tif (evaluateCondition(transition.when, answers)) {\n\t\t\treturn transition.to\n\t\t}\n\t}\n\treturn step.next\n}\n\n/** Whether the current step is terminal (no matching transition + no default next). */\nexport const isTerminalStepId = (\n\tflow: FormFlow,\n\tcurrentId: string,\n\tanswers: Record<string, unknown>\n): boolean => resolveNextStepId(flow, currentId, answers) === undefined\n"],"mappings":";;;AAIA,MAAa,eAAe,SAAuC,KAAK,MAAM,IAAI;;AAGlF,MAAa,WAAW,MAAgB,OACvC,KAAK,MAAM,MAAM,SAAS,KAAK,OAAO,EAAE;;AAGzC,MAAa,kBAAkB,MAAgB,OAC9C,QAAQ,MAAM,EAAE,GAAG,UAAU,CAAC;;;;;AAM/B,MAAa,qBACZ,MACA,WACA,YACwB;CACxB,MAAM,OAAO,QAAQ,MAAM,SAAS;CACpC,IAAI,CAAC,MACJ;CAED,KAAK,MAAM,cAAc,KAAK,eAAe,CAAC,GAC7C,IAAI,kBAAkB,WAAW,MAAM,OAAO,GAC7C,OAAO,WAAW;CAGpB,OAAO,KAAK;AACb;;AAGA,MAAa,oBACZ,MACA,WACA,YACa,kBAAkB,MAAM,WAAW,OAAO,MAAM,KAAA"}

package/dist/flow/normalizeFlow.js

@@ -0,0 +1,35 @@
+//#region src/flow/normalizeFlow.ts
+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).
+*/
+const normalizeFlow = (raw, fieldNames) => {
+	if (!isRecord(raw) || !Array.isArray(raw.steps)) return;
+	const knownFields = new Set(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;
+	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 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
+		}));
+		const next = typeof s.next === "string" && knownIds.has(s.next) ? s.next : void 0;
+		const step = {
+			id,
+			fields
+		};
+		if (typeof s.title === "string") step.title = s.title;
+		if (transitions.length > 0) step.transitions = transitions;
+		if (next !== void 0) step.next = next;
+		return step;
+	}) };
+};
+//#endregion
+export { normalizeFlow };
+
+//# sourceMappingURL=normalizeFlow.js.map

package/dist/flow/normalizeFlow.js.map

@@ -0,0 +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"}

package/dist/{types-DsJ_6kGJ.d.ts → flow/types.d.ts}

@@ -19,5 +19,5 @@ type FormFlow = {
   steps: FlowStep[];
 };
 //#endregion
-export { FlowTransition as n, FormFlow as r, FlowStep as t };
-//# sourceMappingURL=types-DsJ_6kGJ.d.ts.map
+export { FlowStep, FlowTransition, FormFlow };
+//# sourceMappingURL=types.d.ts.map

package/dist/index.d.ts

@@ -1,4 +1,93 @@
-import { a as FormFieldFormat, d as FileRefError, i as FormFieldDefinition, l as FileFieldConfig, n as AnyFormFieldDefinition, o as FormFieldValidate, s as FormFieldValueKind, u as FileRef } from "./fieldTypes-B8jkNRob.js";
-import { A as FieldMeta, C as evaluateCalc, D as AggregationBucket, E as CalcExpression, O as AggregationRow, S as evaluateCondition, T as computeCalcFields, _ as PrefillOptions, a as optionLabelsFor, b as FieldTypeRegistry, c as PresentationDescriptor, f as ValidationRuleDefinition, i as buildRecallResolver, j as SubmissionStatusFilter, k as FieldAggregation, l as PresentationSurface, m as ValidationSeverity, n as DEFAULT_HONEYPOT_FIELD, o as interpolate, p as ValidationRuleResult, r as RecallResolver, s as PresentationDensity, t as CAPTCHA_TOKEN_KEY, u as AnyValidationRuleDefinition, v as valuesFromSearchParams, w as calcExpressionOf, x as FieldTypesConfig, y as FieldTypeOption } from "./constants-B-BUfetP.js";
-import { $ as UploadsCollectionConfig, A as RateLimitResult, B as captureConsent, C as ValidationRuleRegistry, D as IdentifyFn, E as CaptchaVerifyArgs, F as PresentationDescriptorOption, G as AnyConsentSource, H as ConsentSourceRegistry, I as PresentationDescriptorRegistry, J as ConsentResolved, K as ConsentLink, L as PresentationsDescriptorConfig, M as SpamConfig, N as SpamMetadataConfig, O as RateLimitCheckArgs, P as SpamOption, Q as FORM_UPLOADS_SLUG, R as resolvePresentationDescriptors, S as ValidationRuleOption, T as CaptchaProvider, U as ConsentSourcesConfig, V as ConsentSourceOption, W as resolveConsentSources, X as defineConsentSource, Y as ConsentSource, Z as FieldCondition, _ as aggregateRowForField, _t as ActionRunArgs, a as resolveFileRef, at as resolveFormResultsRequest, b as signPayload, c as defaultIdentify, ct as aggregateFieldResponses, d as defaultPresentationDescriptors, dt as ActionResult, et as UploadsOption, f as defineFormField, ft as ActionOption, g as normalizeCalc, gt as ActionDefinition, h as defaultConsentSources, ht as resolveActions, i as captureFileRef, it as ResolveResultsRequestResult, j as RateLimiter, k as RateLimitConfig, l as defineCaptchaProvider, lt as aggregateFormResponses, m as resolveConsentLinks, mt as ActionsConfig, n as formBuilder, nt as resolveUploads, o as resolveSpamConfig, ot as AggregateFieldResponsesArgs, p as resolvePublishedVersionRef, pt as ActionRegistry, q as ConsentResolveArgs, r as defineValidationRule, rt as ResolveResultsRequestArgs, s as createKvRateLimiter, st as AggregateFormResponsesArgs, t as FormBuilderPluginOptions, tt as buildUploadsCollection, u as DEFAULT_PRESENTATION_NAME, ut as fieldHasOptions, v as aggregateRowsForFields, vt as AnyActionDefinition, w as ValidationRulesConfig, x as defaultActionDefinitions, y as SIGNATURE_HEADER, yt as defineAction, z as ConsentProof } from "./index-DfFYGbVF.js";
-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 };
+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 { 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 { FieldTypeOption, FieldTypeRegistry, FieldTypesConfig } from "./fields/registry.js";
+import { PrefillOptions, valuesFromSearchParams } from "./prefill/valuesFromSearchParams.js";
+import { FormEventSink } from "./events/types.js";
+import { AnyValidationRuleDefinition, ValidationRuleDefinition, ValidationRuleResult, ValidationSeverity } from "./validation/types.js";
+import { PresentationDensity, PresentationDescriptor, PresentationSurface } from "./presentations/types.js";
+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 { 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 { 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 { CaptchaProvider, CaptchaVerifyArgs, IdentifyFn, RateLimitCheckArgs, RateLimitConfig, RateLimitResult, RateLimiter, SpamConfig, SpamMetadataConfig, SpamOption } from "./spam/types.js";
+import { ValidationRuleOption, ValidationRuleRegistry, ValidationRulesConfig } from "./validation/registry.js";
+import { 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 { resolveConsentLinks } from "./consent/resolveConsentLinks.js";
+import { resolvePublishedVersionRef } from "./consent/resolvePublishedVersionRef.js";
+import { defineFormField } from "./fields/defineFormField.js";
+import { DEFAULT_PRESENTATION_NAME, defaultPresentationDescriptors } from "./presentations/defaults.js";
+import { defineCaptchaProvider } from "./spam/captcha.js";
+import { defaultIdentify } from "./spam/identify.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 { defineValidationRule } from "./validation/defineValidationRule.js";
+
+//#region src/index.d.ts
+type FormBuilderPluginOptions = {
+  disabled?: boolean;
+  /**
+   * Per-locale overrides for this plugin's UI strings, keyed by the typed
+   * translation keys exported from `@10x-media/form-builder/i18n`. Values win
+   * over the built-in locales key-by-key; locales the plugin does not ship are
+   * 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. */
+  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. */
+  uploads?: UploadsOption; /** Honeypot + rate-limiting (on by default) + a captcha adapter seam + upload-ownership scoping. `false` disables the whole subsystem. */
+  spam?: SpamOption;
+  /**
+   * 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
+   * `SubmissionAnswers` UI component and are noisy when shown alongside it.
+   */
+  showSubmissionRawFields?: boolean;
+  /**
+   * Override individual plugin-managed collections using explicit spreads. Each key accepts a
+   * `CollectionOverrides` object: top-level keys are spread with the plugin's defaults (spread
+   * order per key determines who wins), hooks are appended after the plugin's own hooks, and
+   * `fields` is a function that receives the default fields and returns the final array so
+   * additions/removals are always intentional.
+   */
+  overrides?: {
+    forms?: CollectionOverrides;
+    formSubmissions?: CollectionOverrides;
+    uploads?: CollectionOverrides;
+  };
+};
+declare module 'payload' {
+  interface RegisteredPlugins {
+    '@10x-media/form-builder': FormBuilderPluginOptions;
+  }
+}
+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 };
+//# sourceMappingURL=index.d.ts.map