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

package/dist/fields/builtin/calculation.js

@@ -1,144 +1,199 @@
 import { keys } from "../../translations/keys.js";
 import { asTranslate, labelFor } from "../../translations/server.js";
+import { localizedIf } from "../localizedIf.js";
 import { CALC_FNS, CALC_OPS } from "../../calc/types.js";
+import { formatCalcValue } from "../../calc/formatCalcValue.js";
 import { normalizeCalc } from "../../calc/normalizeCalc.js";
 import { defineFormField } from "../defineFormField.js";
 //#region src/fields/builtin/calculation.ts
 /**
 * Editor-facing JSON schema for `CalcExpression` (src/calc/types.ts), used by the admin JSON
-* field's Monaco editor for autocomplete and inline diagnostics. The real validity gate is
-* `validateExpression`/`normalizeCalc`; this schema is a convenience, not the source of truth.
+* field's Monaco editor for autocomplete and inline diagnostics. Built per boot so registered
+* extension names (custom functions, source keys) autocomplete too. The real validity gate is
+* `buildValidateExpression`/`normalizeCalc`; this schema is a convenience, not the source of truth.
 */
-const calcExpressionSchema = {
-	uri: "https://10xmedia.de/schemas/form-builder/calc-expression.json",
-	fileMatch: ["https://10xmedia.de/schemas/form-builder/calc-expression.json"],
-	schema: {
-		$ref: "#/definitions/expr",
-		definitions: {
-			expr: { oneOf: [
-				{ $ref: "#/definitions/lit" },
-				{ $ref: "#/definitions/ref" },
-				{ $ref: "#/definitions/op" },
-				{ $ref: "#/definitions/neg" },
-				{ $ref: "#/definitions/fn" },
-				{ $ref: "#/definitions/weight" }
-			] },
-			lit: {
-				type: "object",
-				properties: {
-					type: { enum: ["lit"] },
-					value: { type: "number" }
+const buildCalcExpressionSchema = (allowed) => {
+	const sourceKeys = [...allowed?.sources ?? []];
+	const fnNames = [...CALC_FNS, ...allowed?.functions ?? []];
+	return {
+		uri: "https://10xmedia.de/schemas/form-builder/calc-expression.json",
+		fileMatch: ["https://10xmedia.de/schemas/form-builder/calc-expression.json"],
+		schema: {
+			$ref: "#/definitions/expr",
+			definitions: {
+				expr: { oneOf: [
+					{ $ref: "#/definitions/lit" },
+					{ $ref: "#/definitions/ref" },
+					{ $ref: "#/definitions/op" },
+					{ $ref: "#/definitions/neg" },
+					{ $ref: "#/definitions/fn" },
+					{ $ref: "#/definitions/weight" },
+					...sourceKeys.length > 0 ? [{ $ref: "#/definitions/source" }] : []
+				] },
+				lit: {
+					type: "object",
+					properties: {
+						type: { enum: ["lit"] },
+						value: { type: "number" }
+					},
+					required: ["type", "value"],
+					additionalProperties: false
 				},
-				required: ["type", "value"],
-				additionalProperties: false
-			},
-			ref: {
-				type: "object",
-				properties: {
-					type: { enum: ["ref"] },
-					field: { type: "string" }
-				},
-				required: ["type", "field"],
-				additionalProperties: false
-			},
-			op: {
-				type: "object",
-				properties: {
-					type: { enum: ["op"] },
-					op: { enum: [...CALC_OPS] },
-					left: { $ref: "#/definitions/expr" },
-					right: { $ref: "#/definitions/expr" }
+				ref: {
+					type: "object",
+					properties: {
+						type: { enum: ["ref"] },
+						field: { type: "string" }
+					},
+					required: ["type", "field"],
+					additionalProperties: false
 				},
-				required: [
-					"type",
-					"op",
-					"left",
-					"right"
-				],
-				additionalProperties: false
-			},
-			neg: {
-				type: "object",
-				properties: {
-					type: { enum: ["neg"] },
-					operand: { $ref: "#/definitions/expr" }
+				op: {
+					type: "object",
+					properties: {
+						type: { enum: ["op"] },
+						op: { enum: [...CALC_OPS] },
+						left: { $ref: "#/definitions/expr" },
+						right: { $ref: "#/definitions/expr" }
+					},
+					required: [
+						"type",
+						"op",
+						"left",
+						"right"
+					],
+					additionalProperties: false
 				},
-				required: ["type", "operand"],
-				additionalProperties: false
-			},
-			fn: {
-				type: "object",
-				properties: {
-					type: { enum: ["fn"] },
-					fn: { enum: [...CALC_FNS] },
-					args: {
-						type: "array",
-						items: { $ref: "#/definitions/expr" }
-					}
+				neg: {
+					type: "object",
+					properties: {
+						type: { enum: ["neg"] },
+						operand: { $ref: "#/definitions/expr" }
+					},
+					required: ["type", "operand"],
+					additionalProperties: false
 				},
-				required: [
-					"type",
-					"fn",
-					"args"
-				],
-				additionalProperties: false
-			},
-			weight: {
-				type: "object",
-				properties: {
-					type: { enum: ["weight"] },
-					field: { type: "string" },
-					weights: {
-						type: "object",
-						additionalProperties: { type: "number" }
-					}
+				fn: {
+					type: "object",
+					properties: {
+						type: { enum: ["fn"] },
+						fn: { enum: fnNames },
+						args: {
+							type: "array",
+							items: { $ref: "#/definitions/expr" }
+						}
+					},
+					required: [
+						"type",
+						"fn",
+						"args"
+					],
+					additionalProperties: false
 				},
-				required: [
-					"type",
-					"field",
-					"weights"
-				],
-				additionalProperties: false
+				...sourceKeys.length > 0 ? { source: {
+					type: "object",
+					properties: {
+						type: { enum: ["source"] },
+						source: { enum: sourceKeys }
+					},
+					required: ["type", "source"],
+					additionalProperties: false
+				} } : {},
+				weight: {
+					type: "object",
+					properties: {
+						type: { enum: ["weight"] },
+						field: { type: "string" },
+						weights: {
+							type: "object",
+							additionalProperties: { type: "number" }
+						},
+						...sourceKeys.length > 0 ? { source: { enum: sourceKeys } } : {}
+					},
+					required: sourceKeys.length > 0 ? ["type", "field"] : [
+						"type",
+						"field",
+						"weights"
+					],
+					additionalProperties: false
+				}
 			}
 		}
-	}
+	};
 };
 /**
-* Validates the calculation field's `expression`: unset/empty is fine, otherwise it must
-* normalize into a well-formed `CalcExpression` tree. Exported for unit testing.
+* Validates the calculation field's `expression` against the registered extension names: unset/empty
+* is fine, otherwise it must normalize into a well-formed `CalcExpression` tree.
 */
-const validateExpression = (value, { req }) => {
+const buildValidateExpression = (allowed) => (value, { req }) => {
 	if (value == null || value === "") return true;
-	return normalizeCalc(value) !== void 0 ? true : asTranslate(req.t)(keys.validationCalcExpressionInvalid);
+	return normalizeCalc(value, allowed) !== void 0 ? true : asTranslate(req.t)(keys.validationCalcExpressionInvalid);
 };
 /**
 * A calculation is derived and read-only: it renders disabled with no text affordance (no
 * `placeholder`), and it is never validated (`runSubmission` stores its computed value and skips
 * `runValidation` entirely), so an authored `required` could never fire. Both are omitted rather
-* than offered as settings that do nothing.
+* than offered as settings that do nothing. `allowed` threads the registered calc extension names
+* (plugin option `calc`) into the expression validate and the editor schema; `extras.sources`
+* carries serializable source metadata to the builder component as clientProps (custom function
+* names travel too, so the client-side normalize accepts every expression the server accepts).
 */
-const calculationField = defineFormField({
-	type: "calculation",
-	label: keys.fieldTypeCalculation,
-	value: "number",
-	omitShared: ["placeholder", "required"],
-	config: [{
-		name: "expression",
-		type: "json",
-		label: labelFor(keys.configExpression),
-		admin: { description: labelFor(keys.configExpressionDescription) },
-		jsonSchema: calcExpressionSchema,
-		typescriptSchema: [() => ({ type: "object" })],
-		validate: validateExpression
-	}, {
-		name: "calcDisplay",
-		type: "checkbox",
-		defaultValue: true,
-		label: labelFor(keys.configCalcDisplay)
-	}],
-	format: ({ value }) => value == null ? "" : String(value)
-});
+const buildCalculationField = (allowed, extras) => {
+	const sources = extras?.sources ?? [];
+	const functions = [...allowed?.functions ?? []];
+	const builderRef = "@10x-media/form-builder/client#CalcExpressionBuilder";
+	return defineFormField({
+		type: "calculation",
+		label: keys.fieldTypeCalculation,
+		value: "number",
+		omitShared: ["placeholder", "required"],
+		config: [
+			{
+				name: "expression",
+				type: "json",
+				label: labelFor(keys.configExpression),
+				admin: { components: { Field: sources.length > 0 || functions.length > 0 ? {
+					path: builderRef,
+					clientProps: {
+						sources,
+						functions
+					}
+				} : builderRef } },
+				jsonSchema: buildCalcExpressionSchema(allowed),
+				typescriptSchema: [() => ({ type: "object" })],
+				validate: buildValidateExpression(allowed)
+			},
+			{
+				name: "calcDisplay",
+				type: "checkbox",
+				defaultValue: true,
+				label: labelFor(keys.configCalcDisplay)
+			},
+			{
+				name: "decimals",
+				type: "number",
+				min: 0,
+				max: 6,
+				label: labelFor(keys.calcConfigDecimals)
+			},
+			{
+				name: "prefix",
+				type: "text",
+				label: labelFor(keys.calcConfigPrefix),
+				...localizedIf(extras?.localize === true)
+			},
+			{
+				name: "suffix",
+				type: "text",
+				label: labelFor(keys.calcConfigSuffix),
+				...localizedIf(extras?.localize === true)
+			}
+		],
+		format: ({ value, config }) => value == null ? "" : formatCalcValue(value, config)
+	});
+};
+buildCalculationField();
 //#endregion
-export { calculationField };
+export { buildCalculationField };
 
 //# sourceMappingURL=calculation.js.map

package/dist/fields/builtin/calculation.js.map

@@ -1 +1 @@
-{"version":3,"file":"calculation.js","names":[],"sources":["../../../src/fields/builtin/calculation.ts"],"sourcesContent":["import type { JSONField, PayloadRequest } from 'payload'\nimport { normalizeCalc } from '../../calc/normalizeCalc'\nimport { CALC_FNS, CALC_OPS } from '../../calc/types'\nimport { keys } from '../../translations/keys'\nimport { asTranslate, labelFor } from '../../translations/server'\nimport { defineFormField } from '../defineFormField'\n\ntype CalcExpressionSchema = NonNullable<JSONField['jsonSchema']>\n\n/**\n * Editor-facing JSON schema for `CalcExpression` (src/calc/types.ts), used by the admin JSON\n * field's Monaco editor for autocomplete and inline diagnostics. The real validity gate is\n * `validateExpression`/`normalizeCalc`; this schema is a convenience, not the source of truth.\n */\nconst calcExpressionSchema: CalcExpressionSchema = {\n\turi: 'https://10xmedia.de/schemas/form-builder/calc-expression.json',\n\tfileMatch: ['https://10xmedia.de/schemas/form-builder/calc-expression.json'],\n\tschema: {\n\t\t$ref: '#/definitions/expr',\n\t\tdefinitions: {\n\t\t\texpr: {\n\t\t\t\toneOf: [\n\t\t\t\t\t{ $ref: '#/definitions/lit' },\n\t\t\t\t\t{ $ref: '#/definitions/ref' },\n\t\t\t\t\t{ $ref: '#/definitions/op' },\n\t\t\t\t\t{ $ref: '#/definitions/neg' },\n\t\t\t\t\t{ $ref: '#/definitions/fn' },\n\t\t\t\t\t{ $ref: '#/definitions/weight' },\n\t\t\t\t],\n\t\t\t},\n\t\t\tlit: {\n\t\t\t\ttype: 'object',\n\t\t\t\tproperties: { type: { enum: ['lit'] }, value: { type: 'number' } },\n\t\t\t\trequired: ['type', 'value'],\n\t\t\t\tadditionalProperties: false,\n\t\t\t},\n\t\t\tref: {\n\t\t\t\ttype: 'object',\n\t\t\t\tproperties: { type: { enum: ['ref'] }, field: { type: 'string' } },\n\t\t\t\trequired: ['type', 'field'],\n\t\t\t\tadditionalProperties: false,\n\t\t\t},\n\t\t\top: {\n\t\t\t\ttype: 'object',\n\t\t\t\tproperties: {\n\t\t\t\t\ttype: { enum: ['op'] },\n\t\t\t\t\top: { enum: [...CALC_OPS] },\n\t\t\t\t\tleft: { $ref: '#/definitions/expr' },\n\t\t\t\t\tright: { $ref: '#/definitions/expr' },\n\t\t\t\t},\n\t\t\t\trequired: ['type', 'op', 'left', 'right'],\n\t\t\t\tadditionalProperties: false,\n\t\t\t},\n\t\t\tneg: {\n\t\t\t\ttype: 'object',\n\t\t\t\tproperties: { type: { enum: ['neg'] }, operand: { $ref: '#/definitions/expr' } },\n\t\t\t\trequired: ['type', 'operand'],\n\t\t\t\tadditionalProperties: false,\n\t\t\t},\n\t\t\tfn: {\n\t\t\t\ttype: 'object',\n\t\t\t\tproperties: {\n\t\t\t\t\ttype: { enum: ['fn'] },\n\t\t\t\t\tfn: { enum: [...CALC_FNS] },\n\t\t\t\t\targs: { type: 'array', items: { $ref: '#/definitions/expr' } },\n\t\t\t\t},\n\t\t\t\trequired: ['type', 'fn', 'args'],\n\t\t\t\tadditionalProperties: false,\n\t\t\t},\n\t\t\tweight: {\n\t\t\t\ttype: 'object',\n\t\t\t\tproperties: {\n\t\t\t\t\ttype: { enum: ['weight'] },\n\t\t\t\t\tfield: { type: 'string' },\n\t\t\t\t\tweights: { type: 'object', additionalProperties: { type: 'number' } },\n\t\t\t\t},\n\t\t\t\trequired: ['type', 'field', 'weights'],\n\t\t\t\tadditionalProperties: false,\n\t\t\t},\n\t\t},\n\t},\n}\n\n/**\n * Validates the calculation field's `expression`: unset/empty is fine, otherwise it must\n * normalize into a well-formed `CalcExpression` tree. Exported for unit testing.\n */\nexport const validateExpression = (\n\tvalue: unknown,\n\t{ req }: { data?: unknown; req: PayloadRequest }\n): string | true => {\n\tif (value == null || value === '') {\n\t\treturn true\n\t}\n\treturn normalizeCalc(value) !== undefined\n\t\t? true\n\t\t: asTranslate(req.t)(keys.validationCalcExpressionInvalid)\n}\n\n/**\n * A calculation is derived and read-only: it renders disabled with no text affordance (no\n * `placeholder`), and it is never validated (`runSubmission` stores its computed value and skips\n * `runValidation` entirely), so an authored `required` could never fire. Both are omitted rather\n * than offered as settings that do nothing.\n */\nexport const calculationField = defineFormField<'number'>({\n\ttype: 'calculation',\n\tlabel: keys.fieldTypeCalculation,\n\tvalue: 'number',\n\tomitShared: ['placeholder', 'required'],\n\tconfig: [\n\t\t{\n\t\t\tname: 'expression',\n\t\t\ttype: 'json',\n\t\t\tlabel: labelFor(keys.configExpression),\n\t\t\tadmin: { description: labelFor(keys.configExpressionDescription) },\n\t\t\tjsonSchema: calcExpressionSchema,\n\t\t\t// generate:types embeds jsonSchema.schema into the config-level schema, where its\n\t\t\t// document-root-relative $refs cannot resolve; hand type generation a flat shape instead.\n\t\t\ttypescriptSchema: [() => ({ type: 'object' })],\n\t\t\tvalidate: validateExpression,\n\t\t},\n\t\t{\n\t\t\tname: 'calcDisplay',\n\t\t\ttype: 'checkbox',\n\t\t\tdefaultValue: true,\n\t\t\tlabel: labelFor(keys.configCalcDisplay),\n\t\t},\n\t],\n\tformat: ({ value }) => (value == null ? '' : String(value)),\n})\n"],"mappings":";;;;;;;;;;;AAcA,MAAM,uBAA6C;CAClD,KAAK;CACL,WAAW,CAAC,+DAA+D;CAC3E,QAAQ;EACP,MAAM;EACN,aAAa;GACZ,MAAM,EACL,OAAO;IACN,EAAE,MAAM,oBAAoB;IAC5B,EAAE,MAAM,oBAAoB;IAC5B,EAAE,MAAM,mBAAmB;IAC3B,EAAE,MAAM,oBAAoB;IAC5B,EAAE,MAAM,mBAAmB;IAC3B,EAAE,MAAM,uBAAuB;GAChC,EACD;GACA,KAAK;IACJ,MAAM;IACN,YAAY;KAAE,MAAM,EAAE,MAAM,CAAC,KAAK,EAAE;KAAG,OAAO,EAAE,MAAM,SAAS;IAAE;IACjE,UAAU,CAAC,QAAQ,OAAO;IAC1B,sBAAsB;GACvB;GACA,KAAK;IACJ,MAAM;IACN,YAAY;KAAE,MAAM,EAAE,MAAM,CAAC,KAAK,EAAE;KAAG,OAAO,EAAE,MAAM,SAAS;IAAE;IACjE,UAAU,CAAC,QAAQ,OAAO;IAC1B,sBAAsB;GACvB;GACA,IAAI;IACH,MAAM;IACN,YAAY;KACX,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE;KACrB,IAAI,EAAE,MAAM,CAAC,GAAG,QAAQ,EAAE;KAC1B,MAAM,EAAE,MAAM,qBAAqB;KACnC,OAAO,EAAE,MAAM,qBAAqB;IACrC;IACA,UAAU;KAAC;KAAQ;KAAM;KAAQ;IAAO;IACxC,sBAAsB;GACvB;GACA,KAAK;IACJ,MAAM;IACN,YAAY;KAAE,MAAM,EAAE,MAAM,CAAC,KAAK,EAAE;KAAG,SAAS,EAAE,MAAM,qBAAqB;IAAE;IAC/E,UAAU,CAAC,QAAQ,SAAS;IAC5B,sBAAsB;GACvB;GACA,IAAI;IACH,MAAM;IACN,YAAY;KACX,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE;KACrB,IAAI,EAAE,MAAM,CAAC,GAAG,QAAQ,EAAE;KAC1B,MAAM;MAAE,MAAM;MAAS,OAAO,EAAE,MAAM,qBAAqB;KAAE;IAC9D;IACA,UAAU;KAAC;KAAQ;KAAM;IAAM;IAC/B,sBAAsB;GACvB;GACA,QAAQ;IACP,MAAM;IACN,YAAY;KACX,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE;KACzB,OAAO,EAAE,MAAM,SAAS;KACxB,SAAS;MAAE,MAAM;MAAU,sBAAsB,EAAE,MAAM,SAAS;KAAE;IACrE;IACA,UAAU;KAAC;KAAQ;KAAS;IAAS;IACrC,sBAAsB;GACvB;EACD;CACD;AACD;;;;;AAMA,MAAa,sBACZ,OACA,EAAE,UACiB;CACnB,IAAI,SAAS,QAAQ,UAAU,IAC9B,OAAO;CAER,OAAO,cAAc,KAAK,MAAM,KAAA,IAC7B,OACA,YAAY,IAAI,CAAC,EAAE,KAAK,+BAA+B;AAC3D;;;;;;;AAQA,MAAa,mBAAmB,gBAA0B;CACzD,MAAM;CACN,OAAO,KAAK;CACZ,OAAO;CACP,YAAY,CAAC,eAAe,UAAU;CACtC,QAAQ,CACP;EACC,MAAM;EACN,MAAM;EACN,OAAO,SAAS,KAAK,gBAAgB;EACrC,OAAO,EAAE,aAAa,SAAS,KAAK,2BAA2B,EAAE;EACjE,YAAY;EAGZ,kBAAkB,QAAQ,EAAE,MAAM,SAAS,EAAE;EAC7C,UAAU;CACX,GACA;EACC,MAAM;EACN,MAAM;EACN,cAAc;EACd,OAAO,SAAS,KAAK,iBAAiB;CACvC,CACD;CACA,SAAS,EAAE,YAAa,SAAS,OAAO,KAAK,OAAO,KAAK;AAC1D,CAAC"}
+{"version":3,"file":"calculation.js","names":[],"sources":["../../../src/fields/builtin/calculation.ts"],"sourcesContent":["import type { JSONField, PayloadRequest } from 'payload'\nimport { formatCalcValue } from '../../calc/formatCalcValue'\nimport { type CalcAllowed, normalizeCalc } from '../../calc/normalizeCalc'\nimport { CALC_FNS, CALC_OPS } from '../../calc/types'\nimport { keys } from '../../translations/keys'\nimport { asTranslate, labelFor } from '../../translations/server'\nimport { defineFormField } from '../defineFormField'\nimport { localizedIf } from '../localizedIf'\n\n/**\n * Serializable calc-source metadata for the admin builder (threaded as clientProps): key, display\n * label, and which modes the source implements (`scalar` = has `resolve`, `weights` = has\n * `resolveWeights`). Derived where the registry is resolved; resolver functions never serialize.\n */\nexport type CalcSourceClientMeta = {\n\tkey: string\n\tlabel: string | Record<string, string>\n\tscalar: boolean\n\tweights: boolean\n}\n\ntype BuildCalculationFieldExtras = {\n\t/** Whether content-bearing display config (`prefix`, `suffix`) is localized. */\n\tlocalize?: boolean\n\t/** Registered calc-source metadata for the builder UI. */\n\tsources?: CalcSourceClientMeta[]\n}\n\n/** The calculation field's own config values (display settings; `expression` is handled separately). */\ntype CalculationConfig = {\n\tdecimals?: number\n\tprefix?: string\n\tsuffix?: string\n}\n\ntype CalcExpressionSchema = NonNullable<JSONField['jsonSchema']>\n\n/**\n * Editor-facing JSON schema for `CalcExpression` (src/calc/types.ts), used by the admin JSON\n * field's Monaco editor for autocomplete and inline diagnostics. Built per boot so registered\n * extension names (custom functions, source keys) autocomplete too. The real validity gate is\n * `buildValidateExpression`/`normalizeCalc`; this schema is a convenience, not the source of truth.\n */\nconst buildCalcExpressionSchema = (allowed?: CalcAllowed): CalcExpressionSchema => {\n\tconst sourceKeys = [...(allowed?.sources ?? [])]\n\tconst fnNames = [...CALC_FNS, ...(allowed?.functions ?? [])]\n\treturn {\n\t\turi: 'https://10xmedia.de/schemas/form-builder/calc-expression.json',\n\t\tfileMatch: ['https://10xmedia.de/schemas/form-builder/calc-expression.json'],\n\t\tschema: {\n\t\t\t$ref: '#/definitions/expr',\n\t\t\tdefinitions: {\n\t\t\t\texpr: {\n\t\t\t\t\toneOf: [\n\t\t\t\t\t\t{ $ref: '#/definitions/lit' },\n\t\t\t\t\t\t{ $ref: '#/definitions/ref' },\n\t\t\t\t\t\t{ $ref: '#/definitions/op' },\n\t\t\t\t\t\t{ $ref: '#/definitions/neg' },\n\t\t\t\t\t\t{ $ref: '#/definitions/fn' },\n\t\t\t\t\t\t{ $ref: '#/definitions/weight' },\n\t\t\t\t\t\t...(sourceKeys.length > 0 ? [{ $ref: '#/definitions/source' }] : []),\n\t\t\t\t\t],\n\t\t\t\t},\n\t\t\t\tlit: {\n\t\t\t\t\ttype: 'object',\n\t\t\t\t\tproperties: { type: { enum: ['lit'] }, value: { type: 'number' } },\n\t\t\t\t\trequired: ['type', 'value'],\n\t\t\t\t\tadditionalProperties: false,\n\t\t\t\t},\n\t\t\t\tref: {\n\t\t\t\t\ttype: 'object',\n\t\t\t\t\tproperties: { type: { enum: ['ref'] }, field: { type: 'string' } },\n\t\t\t\t\trequired: ['type', 'field'],\n\t\t\t\t\tadditionalProperties: false,\n\t\t\t\t},\n\t\t\t\top: {\n\t\t\t\t\ttype: 'object',\n\t\t\t\t\tproperties: {\n\t\t\t\t\t\ttype: { enum: ['op'] },\n\t\t\t\t\t\top: { enum: [...CALC_OPS] },\n\t\t\t\t\t\tleft: { $ref: '#/definitions/expr' },\n\t\t\t\t\t\tright: { $ref: '#/definitions/expr' },\n\t\t\t\t\t},\n\t\t\t\t\trequired: ['type', 'op', 'left', 'right'],\n\t\t\t\t\tadditionalProperties: false,\n\t\t\t\t},\n\t\t\t\tneg: {\n\t\t\t\t\ttype: 'object',\n\t\t\t\t\tproperties: { type: { enum: ['neg'] }, operand: { $ref: '#/definitions/expr' } },\n\t\t\t\t\trequired: ['type', 'operand'],\n\t\t\t\t\tadditionalProperties: false,\n\t\t\t\t},\n\t\t\t\tfn: {\n\t\t\t\t\ttype: 'object',\n\t\t\t\t\tproperties: {\n\t\t\t\t\t\ttype: { enum: ['fn'] },\n\t\t\t\t\t\tfn: { enum: fnNames },\n\t\t\t\t\t\targs: { type: 'array', items: { $ref: '#/definitions/expr' } },\n\t\t\t\t\t},\n\t\t\t\t\trequired: ['type', 'fn', 'args'],\n\t\t\t\t\tadditionalProperties: false,\n\t\t\t\t},\n\t\t\t\t...(sourceKeys.length > 0\n\t\t\t\t\t? {\n\t\t\t\t\t\t\tsource: {\n\t\t\t\t\t\t\t\ttype: 'object',\n\t\t\t\t\t\t\t\tproperties: { type: { enum: ['source'] }, source: { enum: sourceKeys } },\n\t\t\t\t\t\t\t\trequired: ['type', 'source'],\n\t\t\t\t\t\t\t\tadditionalProperties: false,\n\t\t\t\t\t\t\t},\n\t\t\t\t\t\t}\n\t\t\t\t\t: {}),\n\t\t\t\tweight: {\n\t\t\t\t\ttype: 'object',\n\t\t\t\t\tproperties: {\n\t\t\t\t\t\ttype: { enum: ['weight'] },\n\t\t\t\t\t\tfield: { type: 'string' },\n\t\t\t\t\t\tweights: { type: 'object', additionalProperties: { type: 'number' } },\n\t\t\t\t\t\t...(sourceKeys.length > 0 ? { source: { enum: sourceKeys } } : {}),\n\t\t\t\t\t},\n\t\t\t\t\t// With sources registered a weight may carry `source` instead of inline weights; the\n\t\t\t\t\t// either-or itself is enforced by normalizeCalc, not this convenience schema.\n\t\t\t\t\trequired: sourceKeys.length > 0 ? ['type', 'field'] : ['type', 'field', 'weights'],\n\t\t\t\t\tadditionalProperties: false,\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t}\n}\n\n/**\n * Validates the calculation field's `expression` against the registered extension names: unset/empty\n * is fine, otherwise it must normalize into a well-formed `CalcExpression` tree.\n */\nexport const buildValidateExpression =\n\t(allowed?: CalcAllowed) =>\n\t(value: unknown, { req }: { data?: unknown; req: PayloadRequest }): string | true => {\n\t\tif (value == null || value === '') {\n\t\t\treturn true\n\t\t}\n\t\treturn normalizeCalc(value, allowed) !== undefined\n\t\t\t? true\n\t\t\t: asTranslate(req.t)(keys.validationCalcExpressionInvalid)\n\t}\n\n/** The no-extensions validate (built-in grammar only). Exported for unit testing and spread consumers. */\nexport const validateExpression = buildValidateExpression()\n\n/**\n * A calculation is derived and read-only: it renders disabled with no text affordance (no\n * `placeholder`), and it is never validated (`runSubmission` stores its computed value and skips\n * `runValidation` entirely), so an authored `required` could never fire. Both are omitted rather\n * than offered as settings that do nothing. `allowed` threads the registered calc extension names\n * (plugin option `calc`) into the expression validate and the editor schema; `extras.sources`\n * carries serializable source metadata to the builder component as clientProps (custom function\n * names travel too, so the client-side normalize accepts every expression the server accepts).\n */\nexport const buildCalculationField = (\n\tallowed?: CalcAllowed,\n\textras?: BuildCalculationFieldExtras\n) => {\n\tconst sources = extras?.sources ?? []\n\tconst functions = [...(allowed?.functions ?? [])]\n\tconst builderRef = '@10x-media/form-builder/client#CalcExpressionBuilder'\n\treturn defineFormField<'number', CalculationConfig>({\n\t\ttype: 'calculation',\n\t\tlabel: keys.fieldTypeCalculation,\n\t\tvalue: 'number',\n\t\tomitShared: ['placeholder', 'required'],\n\t\tconfig: [\n\t\t\t{\n\t\t\t\tname: 'expression',\n\t\t\t\ttype: 'json',\n\t\t\t\tlabel: labelFor(keys.configExpression),\n\t\t\t\tadmin: {\n\t\t\t\t\tcomponents: {\n\t\t\t\t\t\tField:\n\t\t\t\t\t\t\tsources.length > 0 || functions.length > 0\n\t\t\t\t\t\t\t\t? { path: builderRef, clientProps: { sources, functions } }\n\t\t\t\t\t\t\t\t: builderRef,\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t\tjsonSchema: buildCalcExpressionSchema(allowed),\n\t\t\t\t// generate:types embeds jsonSchema.schema into the config-level schema, where its\n\t\t\t\t// document-root-relative $refs cannot resolve; hand type generation a flat shape instead.\n\t\t\t\ttypescriptSchema: [() => ({ type: 'object' })],\n\t\t\t\tvalidate: buildValidateExpression(allowed),\n\t\t\t},\n\t\t\t{\n\t\t\t\tname: 'calcDisplay',\n\t\t\t\ttype: 'checkbox',\n\t\t\t\tdefaultValue: true,\n\t\t\t\tlabel: labelFor(keys.configCalcDisplay),\n\t\t\t},\n\t\t\t{\n\t\t\t\tname: 'decimals',\n\t\t\t\ttype: 'number',\n\t\t\t\tmin: 0,\n\t\t\t\tmax: 6,\n\t\t\t\tlabel: labelFor(keys.calcConfigDecimals),\n\t\t\t},\n\t\t\t{\n\t\t\t\tname: 'prefix',\n\t\t\t\ttype: 'text',\n\t\t\t\tlabel: labelFor(keys.calcConfigPrefix),\n\t\t\t\t...localizedIf(extras?.localize === true),\n\t\t\t},\n\t\t\t{\n\t\t\t\tname: 'suffix',\n\t\t\t\ttype: 'text',\n\t\t\t\tlabel: labelFor(keys.calcConfigSuffix),\n\t\t\t\t...localizedIf(extras?.localize === true),\n\t\t\t},\n\t\t],\n\t\tformat: ({ value, config }) => (value == null ? '' : formatCalcValue(value, config)),\n\t})\n}\n\n/** The no-extensions definition, for definition-spread consumers (the `buildSelectField`/`selectField` precedent). */\nexport const calculationField = buildCalculationField()\n"],"mappings":"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"}

package/dist/fields/builtin/checkbox.js

@@ -1,4 +1,5 @@
 import { keys } from "../../translations/keys.js";
+import { labelFor } from "../../translations/server.js";
 import { defineFormField } from "../defineFormField.js";
 //#region src/fields/builtin/checkbox.ts
 /**
@@ -12,6 +13,20 @@ const checkboxField = defineFormField({
 	label: keys.fieldTypeCheckbox,
 	value: "boolean",
 	omitShared: ["placeholder"],
+	config: [{
+		name: "display",
+		type: "select",
+		defaultValue: "checkbox",
+		label: labelFor(keys.configCheckboxDisplay),
+		admin: { isClearable: false },
+		options: [{
+			label: labelFor(keys.checkboxDisplayCheckbox),
+			value: "checkbox"
+		}, {
+			label: labelFor(keys.checkboxDisplaySwitch),
+			value: "switch"
+		}]
+	}],
 	validate: ({ value, config, t }) => config.required === true && value !== true ? t(keys.validationRequired) : true,
 	format: ({ value, t }) => value ? t(keys.formatYes) : t(keys.formatNo)
 });

package/dist/fields/builtin/checkbox.js.map

@@ -1 +1 @@
-{"version":3,"file":"checkbox.js","names":[],"sources":["../../../src/fields/builtin/checkbox.ts"],"sourcesContent":["import { keys } from '../../translations/keys'\nimport { defineFormField } from '../defineFormField'\n\ntype CheckboxConfig = { required?: boolean }\n\n/**\n * A checkbox renders as a lone box with no free-text affordance, so `placeholder` is never read.\n * The intrinsic validator owns `required`: the engine's shared required guard only fires on an\n * empty value, and `false` (checked, then unchecked) is a present one, so without this a required\n * checkbox would accept an explicit refusal.\n */\nexport const checkboxField = defineFormField<'boolean', CheckboxConfig>({\n\ttype: 'checkbox',\n\tlabel: keys.fieldTypeCheckbox,\n\tvalue: 'boolean',\n\tomitShared: ['placeholder'],\n\tvalidate: ({ value, config, t }) =>\n\t\tconfig.required === true && value !== true ? t(keys.validationRequired) : true,\n\tformat: ({ value, t }) => (value ? t(keys.formatYes) : t(keys.formatNo)),\n})\n"],"mappings":";;;;;;;;;AAWA,MAAa,gBAAgB,gBAA2C;CACvE,MAAM;CACN,OAAO,KAAK;CACZ,OAAO;CACP,YAAY,CAAC,aAAa;CAC1B,WAAW,EAAE,OAAO,QAAQ,QAC3B,OAAO,aAAa,QAAQ,UAAU,OAAO,EAAE,KAAK,kBAAkB,IAAI;CAC3E,SAAS,EAAE,OAAO,QAAS,QAAQ,EAAE,KAAK,SAAS,IAAI,EAAE,KAAK,QAAQ;AACvE,CAAC"}
+{"version":3,"file":"checkbox.js","names":[],"sources":["../../../src/fields/builtin/checkbox.ts"],"sourcesContent":["import { keys } from '../../translations/keys'\nimport { labelFor } from '../../translations/server'\nimport { defineFormField } from '../defineFormField'\n\ntype CheckboxConfig = { required?: boolean; display?: 'checkbox' | 'switch' }\n\n/**\n * A checkbox renders as a lone box with no free-text affordance, so `placeholder` is never read.\n * The intrinsic validator owns `required`: the engine's shared required guard only fires on an\n * empty value, and `false` (checked, then unchecked) is a present one, so without this a required\n * checkbox would accept an explicit refusal.\n */\nexport const checkboxField = defineFormField<'boolean', CheckboxConfig>({\n\ttype: 'checkbox',\n\tlabel: keys.fieldTypeCheckbox,\n\tvalue: 'boolean',\n\tomitShared: ['placeholder'],\n\tconfig: [\n\t\t{\n\t\t\tname: 'display',\n\t\t\ttype: 'select',\n\t\t\tdefaultValue: 'checkbox',\n\t\t\tlabel: labelFor(keys.configCheckboxDisplay),\n\t\t\tadmin: { isClearable: false },\n\t\t\toptions: [\n\t\t\t\t{ label: labelFor(keys.checkboxDisplayCheckbox), value: 'checkbox' },\n\t\t\t\t{ label: labelFor(keys.checkboxDisplaySwitch), value: 'switch' },\n\t\t\t],\n\t\t},\n\t],\n\tvalidate: ({ value, config, t }) =>\n\t\tconfig.required === true && value !== true ? t(keys.validationRequired) : true,\n\tformat: ({ value, t }) => (value ? t(keys.formatYes) : t(keys.formatNo)),\n})\n"],"mappings":";;;;;;;;;;AAYA,MAAa,gBAAgB,gBAA2C;CACvE,MAAM;CACN,OAAO,KAAK;CACZ,OAAO;CACP,YAAY,CAAC,aAAa;CAC1B,QAAQ,CACP;EACC,MAAM;EACN,MAAM;EACN,cAAc;EACd,OAAO,SAAS,KAAK,qBAAqB;EAC1C,OAAO,EAAE,aAAa,MAAM;EAC5B,SAAS,CACR;GAAE,OAAO,SAAS,KAAK,uBAAuB;GAAG,OAAO;EAAW,GACnE;GAAE,OAAO,SAAS,KAAK,qBAAqB;GAAG,OAAO;EAAS,CAChE;CACD,CACD;CACA,WAAW,EAAE,OAAO,QAAQ,QAC3B,OAAO,aAAa,QAAQ,UAAU,OAAO,EAAE,KAAK,kBAAkB,IAAI;CAC3E,SAAS,EAAE,OAAO,QAAS,QAAQ,EAAE,KAAK,SAAS,IAAI,EAAE,KAAK,QAAQ;AACvE,CAAC"}

package/dist/fields/builtin/email.js

@@ -1,4 +1,5 @@
 import { keys } from "../../translations/keys.js";
+import { labelFor } from "../../translations/server.js";
 import { defineFormField } from "../defineFormField.js";
 import { EMAIL_PATTERN } from "../../validation/emailPattern.js";
 //#region src/fields/builtin/email.ts
@@ -6,6 +7,12 @@ const emailField = defineFormField({
 	type: "email",
 	label: keys.fieldTypeEmail,
 	value: "text",
+	advancedConfig: [{
+		name: "autocomplete",
+		type: "text",
+		label: labelFor(keys.configAutocomplete),
+		admin: { description: labelFor(keys.configAutocompleteDescription) }
+	}],
 	validate: ({ value, t }) => {
 		if (value == null || value === "") return true;
 		return EMAIL_PATTERN.test(value) ? true : t(keys.validationEmail);

package/dist/fields/builtin/email.js.map

@@ -1 +1 @@
-{"version":3,"file":"email.js","names":[],"sources":["../../../src/fields/builtin/email.ts"],"sourcesContent":["import { keys } from '../../translations/keys'\nimport { EMAIL_PATTERN } from '../../validation/emailPattern'\nimport { defineFormField } from '../defineFormField'\n\nexport const emailField = defineFormField<'text'>({\n\ttype: 'email',\n\tlabel: keys.fieldTypeEmail,\n\tvalue: 'text',\n\tvalidate: ({ value, t }) => {\n\t\tif (value == null || value === '') {\n\t\t\treturn true\n\t\t}\n\t\treturn EMAIL_PATTERN.test(value) ? true : t(keys.validationEmail)\n\t},\n\tformat: ({ value }) => (value == null ? '' : String(value)),\n})\n"],"mappings":";;;;AAIA,MAAa,aAAa,gBAAwB;CACjD,MAAM;CACN,OAAO,KAAK;CACZ,OAAO;CACP,WAAW,EAAE,OAAO,QAAQ;EAC3B,IAAI,SAAS,QAAQ,UAAU,IAC9B,OAAO;EAER,OAAO,cAAc,KAAK,KAAK,IAAI,OAAO,EAAE,KAAK,eAAe;CACjE;CACA,SAAS,EAAE,YAAa,SAAS,OAAO,KAAK,OAAO,KAAK;AAC1D,CAAC"}
+{"version":3,"file":"email.js","names":[],"sources":["../../../src/fields/builtin/email.ts"],"sourcesContent":["import { keys } from '../../translations/keys'\nimport { labelFor } from '../../translations/server'\nimport { EMAIL_PATTERN } from '../../validation/emailPattern'\nimport { defineFormField } from '../defineFormField'\n\nexport const emailField = defineFormField<'text'>({\n\ttype: 'email',\n\tlabel: keys.fieldTypeEmail,\n\tvalue: 'text',\n\tadvancedConfig: [\n\t\t{\n\t\t\tname: 'autocomplete',\n\t\t\ttype: 'text',\n\t\t\tlabel: labelFor(keys.configAutocomplete),\n\t\t\tadmin: { description: labelFor(keys.configAutocompleteDescription) },\n\t\t},\n\t],\n\tvalidate: ({ value, t }) => {\n\t\tif (value == null || value === '') {\n\t\t\treturn true\n\t\t}\n\t\treturn EMAIL_PATTERN.test(value) ? true : t(keys.validationEmail)\n\t},\n\tformat: ({ value }) => (value == null ? '' : String(value)),\n})\n"],"mappings":";;;;;AAKA,MAAa,aAAa,gBAAwB;CACjD,MAAM;CACN,OAAO,KAAK;CACZ,OAAO;CACP,gBAAgB,CACf;EACC,MAAM;EACN,MAAM;EACN,OAAO,SAAS,KAAK,kBAAkB;EACvC,OAAO,EAAE,aAAa,SAAS,KAAK,6BAA6B,EAAE;CACpE,CACD;CACA,WAAW,EAAE,OAAO,QAAQ;EAC3B,IAAI,SAAS,QAAQ,UAAU,IAC9B,OAAO;EAER,OAAO,cAAc,KAAK,KAAK,IAAI,OAAO,EAAE,KAAK,eAAe;CACjE;CACA,SAAS,EAAE,YAAa,SAAS,OAAO,KAAK,OAAO,KAAK;AAC1D,CAAC"}

package/dist/fields/builtin/index.d.ts

@@ -1,4 +1,6 @@
 import { AnyFormFieldDefinition } from "../types.js";
+import { CalcAllowed } from "../../calc/normalizeCalc.js";
+import { CalcSourceClientMeta } from "./calculation.js";
 import { RichTextField } from "payload";
 
 //#region src/fields/builtin/index.d.ts
@@ -8,9 +10,11 @@ import { RichTextField } from "payload";
  * richText editor on the message content field (from the plugin's `richText.editor` option). Field
  * types without content config are shared static definitions. Definitions are authored with precise
  * value/config generics; the registry stores them erased (config is re-narrowed per matched type at
- * execution), hence one cast per built-in, no `any`.
+ * execution), hence one cast per built-in, no `any`. `calcAllowed` threads the registered calc
+ * extension names into the calculation field's expression validate and editor schema;
+ * `calcSources` carries the serializable source metadata the builder UI renders from.
  */
-declare const buildDefaultFieldDefinitions: (localize: boolean, editor?: RichTextField["editor"], uploadMimeTypes?: string[]) => AnyFormFieldDefinition[];
+declare const buildDefaultFieldDefinitions: (localize: boolean, editor?: RichTextField["editor"], uploadMimeTypes?: string[], calcAllowed?: CalcAllowed, calcSources?: CalcSourceClientMeta[]) => AnyFormFieldDefinition[];
 declare const defaultFieldDefinitions: AnyFormFieldDefinition[];
 /**
  * `defaultFieldDefinitions` indexed by `type`, so a single built-in can be spread and tweaked

package/dist/fields/builtin/index.js

@@ -1,4 +1,4 @@
-import { calculationField } from "./calculation.js";
+import { buildCalculationField } from "./calculation.js";
 import { checkboxField } from "./checkbox.js";
 import { consentField } from "./consent.js";
 import { dateField } from "./date.js";
@@ -17,16 +17,21 @@ import { textareaField } from "./textarea.js";
 * richText editor on the message content field (from the plugin's `richText.editor` option). Field
 * types without content config are shared static definitions. Definitions are authored with precise
 * value/config generics; the registry stores them erased (config is re-narrowed per matched type at
-* execution), hence one cast per built-in, no `any`.
+* execution), hence one cast per built-in, no `any`. `calcAllowed` threads the registered calc
+* extension names into the calculation field's expression validate and editor schema;
+* `calcSources` carries the serializable source metadata the builder UI renders from.
 */
-const buildDefaultFieldDefinitions = (localize, editor, uploadMimeTypes) => [
+const buildDefaultFieldDefinitions = (localize, editor, uploadMimeTypes, calcAllowed, calcSources) => [
 	textField,
 	textareaField,
 	emailField,
 	numberField,
 	buildSelectField(localize),
 	checkboxField,
-	calculationField,
+	buildCalculationField(calcAllowed, {
+		localize,
+		sources: calcSources
+	}),
 	consentField,
 	buildFileField(uploadMimeTypes),
 	buildRepeaterField(localize),

package/dist/fields/builtin/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","names":[],"sources":["../../../src/fields/builtin/index.ts"],"sourcesContent":["import type { RichTextField } from 'payload'\nimport type { AnyFormFieldDefinition } from '../types'\nimport { calculationField } from './calculation'\nimport { checkboxField } from './checkbox'\nimport { consentField } from './consent'\nimport { dateField } from './date'\nimport { emailField } from './email'\nimport { buildFileField } from './file'\nimport { buildMessageField } from './message'\nimport { numberField } from './number'\nimport { buildRepeaterField } from './repeater'\nimport { buildSelectField } from './select'\nimport { textField } from './text'\nimport { textareaField } from './textarea'\n\n/**\n * Built-in field definitions with content-bearing config fields (select option labels, repeater add\n * label) carrying `localized: true` when `localize` is true. `editor`, when given, overrides the\n * richText editor on the message content field (from the plugin's `richText.editor` option). Field\n * types without content config are shared static definitions. Definitions are authored with precise\n * value/config generics; the registry stores them erased (config is re-narrowed per matched type at\n * execution), hence one cast per built-in, no `any`.\n */\nexport const buildDefaultFieldDefinitions = (\n\tlocalize: boolean,\n\teditor?: RichTextField['editor'],\n\tuploadMimeTypes?: string[]\n): AnyFormFieldDefinition[] => [\n\ttextField as AnyFormFieldDefinition,\n\ttextareaField as AnyFormFieldDefinition,\n\temailField as AnyFormFieldDefinition,\n\tnumberField as AnyFormFieldDefinition,\n\tbuildSelectField(localize) as AnyFormFieldDefinition,\n\tcheckboxField as AnyFormFieldDefinition,\n\tcalculationField as AnyFormFieldDefinition,\n\tconsentField as AnyFormFieldDefinition,\n\tbuildFileField(uploadMimeTypes) as AnyFormFieldDefinition,\n\tbuildRepeaterField(localize) as AnyFormFieldDefinition,\n\tdateField as AnyFormFieldDefinition,\n\tbuildMessageField(localize, editor) as AnyFormFieldDefinition,\n]\n\nexport const defaultFieldDefinitions: AnyFormFieldDefinition[] = buildDefaultFieldDefinitions(true)\n\n/**\n * `defaultFieldDefinitions` indexed by `type`, so a single built-in can be spread and tweaked\n * without hand-rolling a `.find()`, e.g.\n * `fields: { text: { ...defaultFieldDefinitionsByType.text, validate: myValidate } }`. The\n * `fields` plugin option replaces a built-in of the same `type`; `false` removes it, `true` keeps it.\n * Prebuilt with content localization on; with `localizeContent: false`, derive overrides from\n * `buildDefaultFieldDefinitions(false)` instead so the spread does not reintroduce `localized`.\n */\nexport const defaultFieldDefinitionsByType: Record<string, AnyFormFieldDefinition> =\n\tObject.fromEntries(defaultFieldDefinitions.map((definition) => [definition.type, definition]))\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AAuBA,MAAa,gCACZ,UACA,QACA,oBAC8B;CAC9B;CACA;CACA;CACA;CACA,iBAAiB,QAAQ;CACzB;CACA;CACA;CACA,eAAe,eAAe;CAC9B,mBAAmB,QAAQ;CAC3B;CACA,kBAAkB,UAAU,MAAM;AACnC;AAEA,MAAa,0BAAoD,6BAA6B,IAAI;;;;;;;;;AAUlG,MAAa,gCACZ,OAAO,YAAY,wBAAwB,KAAK,eAAe,CAAC,WAAW,MAAM,UAAU,CAAC,CAAC"}
+{"version":3,"file":"index.js","names":[],"sources":["../../../src/fields/builtin/index.ts"],"sourcesContent":["import type { RichTextField } from 'payload'\nimport type { CalcAllowed } from '../../calc/normalizeCalc'\nimport type { AnyFormFieldDefinition } from '../types'\nimport { buildCalculationField, type CalcSourceClientMeta } from './calculation'\nimport { checkboxField } from './checkbox'\nimport { consentField } from './consent'\nimport { dateField } from './date'\nimport { emailField } from './email'\nimport { buildFileField } from './file'\nimport { buildMessageField } from './message'\nimport { numberField } from './number'\nimport { buildRepeaterField } from './repeater'\nimport { buildSelectField } from './select'\nimport { textField } from './text'\nimport { textareaField } from './textarea'\n\n/**\n * Built-in field definitions with content-bearing config fields (select option labels, repeater add\n * label) carrying `localized: true` when `localize` is true. `editor`, when given, overrides the\n * richText editor on the message content field (from the plugin's `richText.editor` option). Field\n * types without content config are shared static definitions. Definitions are authored with precise\n * value/config generics; the registry stores them erased (config is re-narrowed per matched type at\n * execution), hence one cast per built-in, no `any`. `calcAllowed` threads the registered calc\n * extension names into the calculation field's expression validate and editor schema;\n * `calcSources` carries the serializable source metadata the builder UI renders from.\n */\n// biome-ignore lint/complexity/useMaxParams: the documented positional surface (localize, editor, uploadMimeTypes) plus the calc allowed sets and source metadata; an options object would break existing callers\nexport const buildDefaultFieldDefinitions = (\n\tlocalize: boolean,\n\teditor?: RichTextField['editor'],\n\tuploadMimeTypes?: string[],\n\tcalcAllowed?: CalcAllowed,\n\tcalcSources?: CalcSourceClientMeta[]\n): AnyFormFieldDefinition[] => [\n\ttextField as AnyFormFieldDefinition,\n\ttextareaField as AnyFormFieldDefinition,\n\temailField as AnyFormFieldDefinition,\n\tnumberField as AnyFormFieldDefinition,\n\tbuildSelectField(localize) as AnyFormFieldDefinition,\n\tcheckboxField as AnyFormFieldDefinition,\n\tbuildCalculationField(calcAllowed, { localize, sources: calcSources }) as AnyFormFieldDefinition,\n\tconsentField as AnyFormFieldDefinition,\n\tbuildFileField(uploadMimeTypes) as AnyFormFieldDefinition,\n\tbuildRepeaterField(localize) as AnyFormFieldDefinition,\n\tdateField as AnyFormFieldDefinition,\n\tbuildMessageField(localize, editor) as AnyFormFieldDefinition,\n]\n\nexport const defaultFieldDefinitions: AnyFormFieldDefinition[] = buildDefaultFieldDefinitions(true)\n\n/**\n * `defaultFieldDefinitions` indexed by `type`, so a single built-in can be spread and tweaked\n * without hand-rolling a `.find()`, e.g.\n * `fields: { text: { ...defaultFieldDefinitionsByType.text, validate: myValidate } }`. The\n * `fields` plugin option replaces a built-in of the same `type`; `false` removes it, `true` keeps it.\n * Prebuilt with content localization on; with `localizeContent: false`, derive overrides from\n * `buildDefaultFieldDefinitions(false)` instead so the spread does not reintroduce `localized`.\n */\nexport const defaultFieldDefinitionsByType: Record<string, AnyFormFieldDefinition> =\n\tObject.fromEntries(defaultFieldDefinitions.map((definition) => [definition.type, definition]))\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;AA2BA,MAAa,gCACZ,UACA,QACA,iBACA,aACA,gBAC8B;CAC9B;CACA;CACA;CACA;CACA,iBAAiB,QAAQ;CACzB;CACA,sBAAsB,aAAa;EAAE;EAAU,SAAS;CAAY,CAAC;CACrE;CACA,eAAe,eAAe;CAC9B,mBAAmB,QAAQ;CAC3B;CACA,kBAAkB,UAAU,MAAM;AACnC;AAEA,MAAa,0BAAoD,6BAA6B,IAAI;;;;;;;;;AAUlG,MAAa,gCACZ,OAAO,YAAY,wBAAwB,KAAK,eAAe,CAAC,WAAW,MAAM,UAAU,CAAC,CAAC"}

package/dist/fields/builtin/select.js

@@ -21,7 +21,6 @@ const buildSelectField = (localize) => defineFormField({
 		fields: [{
 			name: "label",
 			type: "text",
-			required: true,
 			label: labelFor(keys.configOptionLabel),
 			...localizedIf(localize)
 		}, {
@@ -30,6 +29,26 @@ const buildSelectField = (localize) => defineFormField({
 			required: true,
 			label: labelFor(keys.configOptionValue)
 		}]
+	}, {
+		name: "display",
+		type: "select",
+		defaultValue: "dropdown",
+		label: labelFor(keys.configSelectDisplay),
+		admin: { isClearable: false },
+		options: [
+			{
+				label: labelFor(keys.selectDisplayDropdown),
+				value: "dropdown"
+			},
+			{
+				label: labelFor(keys.selectDisplayRadio),
+				value: "radio"
+			},
+			{
+				label: labelFor(keys.selectDisplayButtons),
+				value: "buttons"
+			}
+		]
 	}],
 	validate: ({ value, config, t }) => {
 		if (value == null || value === "") return true;

package/dist/fields/builtin/select.js.map

@@ -1 +1 @@
-{"version":3,"file":"select.js","names":[],"sources":["../../../src/fields/builtin/select.ts"],"sourcesContent":["import { keys } from '../../translations/keys'\nimport { labelFor } from '../../translations/server'\nimport { defineFormField } from '../defineFormField'\nimport { localizedIf } from '../localizedIf'\n\ntype SelectOption = { label: string; value: string }\ntype SelectConfig = { options?: SelectOption[] }\n\n/** Option `label` is author-facing content and follows `localize`; `value` is an identifier and never does. */\nexport const buildSelectField = (localize: boolean) =>\n\tdefineFormField<'text', SelectConfig>({\n\t\ttype: 'select',\n\t\tlabel: keys.fieldTypeSelect,\n\t\tvalue: 'text',\n\t\tconditionType: 'select',\n\t\tpollEligible: true,\n\t\tconfig: [\n\t\t\t{\n\t\t\t\tname: 'options',\n\t\t\t\ttype: 'array',\n\t\t\t\tlabel: labelFor(keys.configOptions),\n\t\t\t\tlabels: { singular: labelFor(keys.configOption), plural: labelFor(keys.configOptions) },\n\t\t\t\tfields: [\n\t\t\t\t\t{\n\t\t\t\t\t\tname: 'label',\n\t\t\t\t\t\ttype: 'text',\n\t\t\t\t\t\trequired: true,\n\t\t\t\t\t\tlabel: labelFor(keys.configOptionLabel),\n\t\t\t\t\t\t...localizedIf(localize),\n\t\t\t\t\t},\n\t\t\t\t\t{ name: 'value', type: 'text', required: true, label: labelFor(keys.configOptionValue) },\n\t\t\t\t],\n\t\t\t},\n\t\t],\n\t\tvalidate: ({ value, config, t }) => {\n\t\t\tif (value == null || value === '') {\n\t\t\t\treturn true\n\t\t\t}\n\t\t\tconst options = config.options ?? []\n\t\t\tif (options.length === 0) {\n\t\t\t\treturn true\n\t\t\t}\n\t\t\treturn options.some((option) => option.value === value) ? true : t(keys.validationSelect)\n\t\t},\n\t\tformat: ({ value, optionLabels }) => {\n\t\t\tif (value == null || value === '') {\n\t\t\t\treturn ''\n\t\t\t}\n\t\t\treturn optionLabels?.[value] ?? String(value)\n\t\t},\n\t})\n\nexport const selectField = buildSelectField(true)\n"],"mappings":";;;;;;AASA,MAAa,oBAAoB,aAChC,gBAAsC;CACrC,MAAM;CACN,OAAO,KAAK;CACZ,OAAO;CACP,eAAe;CACf,cAAc;CACd,QAAQ,CACP;EACC,MAAM;EACN,MAAM;EACN,OAAO,SAAS,KAAK,aAAa;EAClC,QAAQ;GAAE,UAAU,SAAS,KAAK,YAAY;GAAG,QAAQ,SAAS,KAAK,aAAa;EAAE;EACtF,QAAQ,CACP;GACC,MAAM;GACN,MAAM;GACN,UAAU;GACV,OAAO,SAAS,KAAK,iBAAiB;GACtC,GAAG,YAAY,QAAQ;EACxB,GACA;GAAE,MAAM;GAAS,MAAM;GAAQ,UAAU;GAAM,OAAO,SAAS,KAAK,iBAAiB;EAAE,CACxF;CACD,CACD;CACA,WAAW,EAAE,OAAO,QAAQ,QAAQ;EACnC,IAAI,SAAS,QAAQ,UAAU,IAC9B,OAAO;EAER,MAAM,UAAU,OAAO,WAAW,CAAC;EACnC,IAAI,QAAQ,WAAW,GACtB,OAAO;EAER,OAAO,QAAQ,MAAM,WAAW,OAAO,UAAU,KAAK,IAAI,OAAO,EAAE,KAAK,gBAAgB;CACzF;CACA,SAAS,EAAE,OAAO,mBAAmB;EACpC,IAAI,SAAS,QAAQ,UAAU,IAC9B,OAAO;EAER,OAAO,eAAe,UAAU,OAAO,KAAK;CAC7C;AACD,CAAC;AAEyB,iBAAiB,IAAI"}
+{"version":3,"file":"select.js","names":[],"sources":["../../../src/fields/builtin/select.ts"],"sourcesContent":["import { keys } from '../../translations/keys'\nimport { labelFor } from '../../translations/server'\nimport { defineFormField } from '../defineFormField'\nimport { localizedIf } from '../localizedIf'\n\ntype SelectOption = { label?: string; value: string }\ntype SelectConfig = { options?: SelectOption[]; display?: 'dropdown' | 'radio' | 'buttons' }\n\n/** Option `label` is author-facing content and follows `localize`; `value` is an identifier and never does. */\nexport const buildSelectField = (localize: boolean) =>\n\tdefineFormField<'text', SelectConfig>({\n\t\ttype: 'select',\n\t\tlabel: keys.fieldTypeSelect,\n\t\tvalue: 'text',\n\t\tconditionType: 'select',\n\t\tpollEligible: true,\n\t\tconfig: [\n\t\t\t{\n\t\t\t\tname: 'options',\n\t\t\t\ttype: 'array',\n\t\t\t\tlabel: labelFor(keys.configOptions),\n\t\t\t\tlabels: { singular: labelFor(keys.configOption), plural: labelFor(keys.configOptions) },\n\t\t\t\tfields: [\n\t\t\t\t\t{\n\t\t\t\t\t\tname: 'label',\n\t\t\t\t\t\ttype: 'text',\n\t\t\t\t\t\tlabel: labelFor(keys.configOptionLabel),\n\t\t\t\t\t\t...localizedIf(localize),\n\t\t\t\t\t},\n\t\t\t\t\t{ name: 'value', type: 'text', required: true, label: labelFor(keys.configOptionValue) },\n\t\t\t\t],\n\t\t\t},\n\t\t\t{\n\t\t\t\tname: 'display',\n\t\t\t\ttype: 'select',\n\t\t\t\tdefaultValue: 'dropdown',\n\t\t\t\tlabel: labelFor(keys.configSelectDisplay),\n\t\t\t\tadmin: { isClearable: false },\n\t\t\t\toptions: [\n\t\t\t\t\t{ label: labelFor(keys.selectDisplayDropdown), value: 'dropdown' },\n\t\t\t\t\t{ label: labelFor(keys.selectDisplayRadio), value: 'radio' },\n\t\t\t\t\t{ label: labelFor(keys.selectDisplayButtons), value: 'buttons' },\n\t\t\t\t],\n\t\t\t},\n\t\t],\n\t\tvalidate: ({ value, config, t }) => {\n\t\t\tif (value == null || value === '') {\n\t\t\t\treturn true\n\t\t\t}\n\t\t\tconst options = config.options ?? []\n\t\t\tif (options.length === 0) {\n\t\t\t\treturn true\n\t\t\t}\n\t\t\treturn options.some((option) => option.value === value) ? true : t(keys.validationSelect)\n\t\t},\n\t\tformat: ({ value, optionLabels }) => {\n\t\t\tif (value == null || value === '') {\n\t\t\t\treturn ''\n\t\t\t}\n\t\t\treturn optionLabels?.[value] ?? String(value)\n\t\t},\n\t})\n\nexport const selectField = buildSelectField(true)\n"],"mappings":";;;;;;AASA,MAAa,oBAAoB,aAChC,gBAAsC;CACrC,MAAM;CACN,OAAO,KAAK;CACZ,OAAO;CACP,eAAe;CACf,cAAc;CACd,QAAQ,CACP;EACC,MAAM;EACN,MAAM;EACN,OAAO,SAAS,KAAK,aAAa;EAClC,QAAQ;GAAE,UAAU,SAAS,KAAK,YAAY;GAAG,QAAQ,SAAS,KAAK,aAAa;EAAE;EACtF,QAAQ,CACP;GACC,MAAM;GACN,MAAM;GACN,OAAO,SAAS,KAAK,iBAAiB;GACtC,GAAG,YAAY,QAAQ;EACxB,GACA;GAAE,MAAM;GAAS,MAAM;GAAQ,UAAU;GAAM,OAAO,SAAS,KAAK,iBAAiB;EAAE,CACxF;CACD,GACA;EACC,MAAM;EACN,MAAM;EACN,cAAc;EACd,OAAO,SAAS,KAAK,mBAAmB;EACxC,OAAO,EAAE,aAAa,MAAM;EAC5B,SAAS;GACR;IAAE,OAAO,SAAS,KAAK,qBAAqB;IAAG,OAAO;GAAW;GACjE;IAAE,OAAO,SAAS,KAAK,kBAAkB;IAAG,OAAO;GAAQ;GAC3D;IAAE,OAAO,SAAS,KAAK,oBAAoB;IAAG,OAAO;GAAU;EAChE;CACD,CACD;CACA,WAAW,EAAE,OAAO,QAAQ,QAAQ;EACnC,IAAI,SAAS,QAAQ,UAAU,IAC9B,OAAO;EAER,MAAM,UAAU,OAAO,WAAW,CAAC;EACnC,IAAI,QAAQ,WAAW,GACtB,OAAO;EAER,OAAO,QAAQ,MAAM,WAAW,OAAO,UAAU,KAAK,IAAI,OAAO,EAAE,KAAK,gBAAgB;CACzF;CACA,SAAS,EAAE,OAAO,mBAAmB;EACpC,IAAI,SAAS,QAAQ,UAAU,IAC9B,OAAO;EAER,OAAO,eAAe,UAAU,OAAO,KAAK;CAC7C;AACD,CAAC;AAEyB,iBAAiB,IAAI"}

package/dist/fields/builtin/text.js

@@ -1,10 +1,17 @@
 import { keys } from "../../translations/keys.js";
+import { labelFor } from "../../translations/server.js";
 import { defineFormField } from "../defineFormField.js";
 //#region src/fields/builtin/text.ts
 const textField = defineFormField({
 	type: "text",
 	label: keys.fieldTypeText,
 	value: "text",
+	advancedConfig: [{
+		name: "autocomplete",
+		type: "text",
+		label: labelFor(keys.configAutocomplete),
+		admin: { description: labelFor(keys.configAutocompleteDescription) }
+	}],
 	format: ({ value }) => value == null ? "" : String(value)
 });
 //#endregion

package/dist/fields/builtin/text.js.map

@@ -1 +1 @@
-{"version":3,"file":"text.js","names":[],"sources":["../../../src/fields/builtin/text.ts"],"sourcesContent":["import { keys } from '../../translations/keys'\nimport { defineFormField } from '../defineFormField'\n\nexport const textField = defineFormField<'text'>({\n\ttype: 'text',\n\tlabel: keys.fieldTypeText,\n\tvalue: 'text',\n\tformat: ({ value }) => (value == null ? '' : String(value)),\n})\n"],"mappings":";;;AAGA,MAAa,YAAY,gBAAwB;CAChD,MAAM;CACN,OAAO,KAAK;CACZ,OAAO;CACP,SAAS,EAAE,YAAa,SAAS,OAAO,KAAK,OAAO,KAAK;AAC1D,CAAC"}
+{"version":3,"file":"text.js","names":[],"sources":["../../../src/fields/builtin/text.ts"],"sourcesContent":["import { keys } from '../../translations/keys'\nimport { labelFor } from '../../translations/server'\nimport { defineFormField } from '../defineFormField'\n\nexport const textField = defineFormField<'text'>({\n\ttype: 'text',\n\tlabel: keys.fieldTypeText,\n\tvalue: 'text',\n\tadvancedConfig: [\n\t\t{\n\t\t\tname: 'autocomplete',\n\t\t\ttype: 'text',\n\t\t\tlabel: labelFor(keys.configAutocomplete),\n\t\t\tadmin: { description: labelFor(keys.configAutocompleteDescription) },\n\t\t},\n\t],\n\tformat: ({ value }) => (value == null ? '' : String(value)),\n})\n"],"mappings":";;;;AAIA,MAAa,YAAY,gBAAwB;CAChD,MAAM;CACN,OAAO,KAAK;CACZ,OAAO;CACP,gBAAgB,CACf;EACC,MAAM;EACN,MAAM;EACN,OAAO,SAAS,KAAK,kBAAkB;EACvC,OAAO,EAAE,aAAa,SAAS,KAAK,6BAA6B,EAAE;CACpE,CACD;CACA,SAAS,EAAE,YAAa,SAAS,OAAO,KAAK,OAAO,KAAK;AAC1D,CAAC"}

package/dist/fields/instanceOptions.js

@@ -10,7 +10,7 @@ const instanceOptionsOf = (field) => {
 	if (!Array.isArray(field.options)) return;
 	const options = field.options.filter((option) => typeof option?.value === "string").map((option) => ({
 		value: String(option.value),
-		label: option.label ?? String(option.value)
+		label: option.label?.trim() ? option.label : String(option.value)
 	}));
 	return options.length > 0 ? options : void 0;
 };

package/dist/fields/instanceOptions.js.map

@@ -1 +1 @@
-{"version":3,"file":"instanceOptions.js","names":[],"sources":["../../src/fields/instanceOptions.ts"],"sourcesContent":["import type { FormFieldInstance } from '../submissions/types'\n\n/**\n * Normalize a field instance's authored options to `{ value, label }` pairs, dropping entries\n * without a string value and falling back to the value as label. Returns `undefined` when the\n * instance declares no usable options, so callers can distinguish \"not a choice field\" from an\n * empty choice set. Shared by response aggregation and poll outcome resolution so both read the\n * same choice set from a form document.\n */\nexport const instanceOptionsOf = (\n\tfield: FormFieldInstance\n): { value: string; label: string }[] | undefined => {\n\tif (!Array.isArray(field.options)) {\n\t\treturn undefined\n\t}\n\tconst options = (field.options as Array<{ label?: string; value?: string }>)\n\t\t.filter((option) => typeof option?.value === 'string')\n\t\t.map((option) => ({ value: String(option.value), label: option.label ?? String(option.value) }))\n\treturn options.length > 0 ? options : undefined\n}\n"],"mappings":";;;;;;;;AASA,MAAa,qBACZ,UACoD;CACpD,IAAI,CAAC,MAAM,QAAQ,MAAM,OAAO,GAC/B;CAED,MAAM,UAAW,MAAM,QACrB,QAAQ,WAAW,OAAO,QAAQ,UAAU,QAAQ,EACpD,KAAK,YAAY;EAAE,OAAO,OAAO,OAAO,KAAK;EAAG,OAAO,OAAO,SAAS,OAAO,OAAO,KAAK;CAAE,EAAE;CAChG,OAAO,QAAQ,SAAS,IAAI,UAAU,KAAA;AACvC"}
+{"version":3,"file":"instanceOptions.js","names":[],"sources":["../../src/fields/instanceOptions.ts"],"sourcesContent":["import type { FormFieldInstance } from '../submissions/types'\n\n/**\n * Normalize a field instance's authored options to `{ value, label }` pairs, dropping entries\n * without a string value and falling back to the value as label. Returns `undefined` when the\n * instance declares no usable options, so callers can distinguish \"not a choice field\" from an\n * empty choice set. Shared by response aggregation and poll outcome resolution so both read the\n * same choice set from a form document.\n */\nexport const instanceOptionsOf = (\n\tfield: FormFieldInstance\n): { value: string; label: string }[] | undefined => {\n\tif (!Array.isArray(field.options)) {\n\t\treturn undefined\n\t}\n\tconst options = (field.options as Array<{ label?: string; value?: string }>)\n\t\t.filter((option) => typeof option?.value === 'string')\n\t\t.map((option) => ({\n\t\t\tvalue: String(option.value),\n\t\t\tlabel: option.label?.trim() ? option.label : String(option.value),\n\t\t}))\n\treturn options.length > 0 ? options : undefined\n}\n"],"mappings":";;;;;;;;AASA,MAAa,qBACZ,UACoD;CACpD,IAAI,CAAC,MAAM,QAAQ,MAAM,OAAO,GAC/B;CAED,MAAM,UAAW,MAAM,QACrB,QAAQ,WAAW,OAAO,QAAQ,UAAU,QAAQ,EACpD,KAAK,YAAY;EACjB,OAAO,OAAO,OAAO,KAAK;EAC1B,OAAO,OAAO,OAAO,KAAK,IAAI,OAAO,QAAQ,OAAO,OAAO,KAAK;CACjE,EAAE;CACH,OAAO,QAAQ,SAAS,IAAI,UAAU,KAAA;AACvC"}