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

package/dist/fields/builtin/calculation.js

@@ -1,24 +1,199 @@
 import { keys } from "../../translations/keys.js";
-import { labelFor } from "../../translations/server.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
-const calculationField = defineFormField({
-	type: "calculation",
-	label: keys.fieldTypeCalculation,
-	value: "number",
-	config: [{
-		name: "expression",
-		type: "json",
-		label: labelFor(keys.configExpression)
-	}, {
-		name: "calcDisplay",
-		type: "checkbox",
-		defaultValue: true,
-		label: labelFor(keys.configCalcDisplay)
-	}],
-	format: ({ value }) => value == null ? "" : String(value)
-});
+/**
+* Editor-facing JSON schema for `CalcExpression` (src/calc/types.ts), used by the admin JSON
+* 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 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
+				},
+				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" }
+					},
+					required: [
+						"type",
+						"op",
+						"left",
+						"right"
+					],
+					additionalProperties: false
+				},
+				neg: {
+					type: "object",
+					properties: {
+						type: { enum: ["neg"] },
+						operand: { $ref: "#/definitions/expr" }
+					},
+					required: ["type", "operand"],
+					additionalProperties: false
+				},
+				fn: {
+					type: "object",
+					properties: {
+						type: { enum: ["fn"] },
+						fn: { enum: fnNames },
+						args: {
+							type: "array",
+							items: { $ref: "#/definitions/expr" }
+						}
+					},
+					required: [
+						"type",
+						"fn",
+						"args"
+					],
+					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` against the registered extension names: unset/empty
+* is fine, otherwise it must normalize into a well-formed `CalcExpression` tree.
+*/
+const buildValidateExpression = (allowed) => (value, { req }) => {
+	if (value == null || value === "") return true;
+	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. `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 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 { keys } from '../../translations/keys'\nimport { labelFor } from '../../translations/server'\nimport { defineFormField } from '../defineFormField'\n\nexport const calculationField = defineFormField<'number'>({\n\ttype: 'calculation',\n\tlabel: keys.fieldTypeCalculation,\n\tvalue: 'number',\n\tconfig: [\n\t\t{ name: 'expression', type: 'json', label: labelFor(keys.configExpression) },\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":";;;;AAIA,MAAa,mBAAmB,gBAA0B;CACzD,MAAM;CACN,OAAO,KAAK;CACZ,OAAO;CACP,QAAQ,CACP;EAAE,MAAM;EAAc,MAAM;EAAQ,OAAO,SAAS,KAAK,gBAAgB;CAAE,GAC3E;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":";;;;;;;;;;;;;;AA2CA,MAAM,6BAA6B,YAAgD;CAClF,MAAM,aAAa,CAAC,GAAI,SAAS,WAAW,CAAC,CAAE;CAC/C,MAAM,UAAU,CAAC,GAAG,UAAU,GAAI,SAAS,aAAa,CAAC,CAAE;CAC3D,OAAO;EACN,KAAK;EACL,WAAW,CAAC,+DAA+D;EAC3E,QAAQ;GACP,MAAM;GACN,aAAa;IACZ,MAAM,EACL,OAAO;KACN,EAAE,MAAM,oBAAoB;KAC5B,EAAE,MAAM,oBAAoB;KAC5B,EAAE,MAAM,mBAAmB;KAC3B,EAAE,MAAM,oBAAoB;KAC5B,EAAE,MAAM,mBAAmB;KAC3B,EAAE,MAAM,uBAAuB;KAC/B,GAAI,WAAW,SAAS,IAAI,CAAC,EAAE,MAAM,uBAAuB,CAAC,IAAI,CAAC;IACnE,EACD;IACA,KAAK;KACJ,MAAM;KACN,YAAY;MAAE,MAAM,EAAE,MAAM,CAAC,KAAK,EAAE;MAAG,OAAO,EAAE,MAAM,SAAS;KAAE;KACjE,UAAU,CAAC,QAAQ,OAAO;KAC1B,sBAAsB;IACvB;IACA,KAAK;KACJ,MAAM;KACN,YAAY;MAAE,MAAM,EAAE,MAAM,CAAC,KAAK,EAAE;MAAG,OAAO,EAAE,MAAM,SAAS;KAAE;KACjE,UAAU,CAAC,QAAQ,OAAO;KAC1B,sBAAsB;IACvB;IACA,IAAI;KACH,MAAM;KACN,YAAY;MACX,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE;MACrB,IAAI,EAAE,MAAM,CAAC,GAAG,QAAQ,EAAE;MAC1B,MAAM,EAAE,MAAM,qBAAqB;MACnC,OAAO,EAAE,MAAM,qBAAqB;KACrC;KACA,UAAU;MAAC;MAAQ;MAAM;MAAQ;KAAO;KACxC,sBAAsB;IACvB;IACA,KAAK;KACJ,MAAM;KACN,YAAY;MAAE,MAAM,EAAE,MAAM,CAAC,KAAK,EAAE;MAAG,SAAS,EAAE,MAAM,qBAAqB;KAAE;KAC/E,UAAU,CAAC,QAAQ,SAAS;KAC5B,sBAAsB;IACvB;IACA,IAAI;KACH,MAAM;KACN,YAAY;MACX,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE;MACrB,IAAI,EAAE,MAAM,QAAQ;MACpB,MAAM;OAAE,MAAM;OAAS,OAAO,EAAE,MAAM,qBAAqB;MAAE;KAC9D;KACA,UAAU;MAAC;MAAQ;MAAM;KAAM;KAC/B,sBAAsB;IACvB;IACA,GAAI,WAAW,SAAS,IACrB,EACA,QAAQ;KACP,MAAM;KACN,YAAY;MAAE,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE;MAAG,QAAQ,EAAE,MAAM,WAAW;KAAE;KACvE,UAAU,CAAC,QAAQ,QAAQ;KAC3B,sBAAsB;IACvB,EACD,IACC,CAAC;IACJ,QAAQ;KACP,MAAM;KACN,YAAY;MACX,MAAM,EAAE,MAAM,CAAC,QAAQ,EAAE;MACzB,OAAO,EAAE,MAAM,SAAS;MACxB,SAAS;OAAE,MAAM;OAAU,sBAAsB,EAAE,MAAM,SAAS;MAAE;MACpE,GAAI,WAAW,SAAS,IAAI,EAAE,QAAQ,EAAE,MAAM,WAAW,EAAE,IAAI,CAAC;KACjE;KAGA,UAAU,WAAW,SAAS,IAAI,CAAC,QAAQ,OAAO,IAAI;MAAC;MAAQ;MAAS;KAAS;KACjF,sBAAsB;IACvB;GACD;EACD;CACD;AACD;;;;;AAMA,MAAa,2BACX,aACA,OAAgB,EAAE,UAAkE;CACpF,IAAI,SAAS,QAAQ,UAAU,IAC9B,OAAO;CAER,OAAO,cAAc,OAAO,OAAO,MAAM,KAAA,IACtC,OACA,YAAY,IAAI,CAAC,EAAE,KAAK,+BAA+B;AAC3D;;;;;;;;;;AAcD,MAAa,yBACZ,SACA,WACI;CACJ,MAAM,UAAU,QAAQ,WAAW,CAAC;CACpC,MAAM,YAAY,CAAC,GAAI,SAAS,aAAa,CAAC,CAAE;CAChD,MAAM,aAAa;CACnB,OAAO,gBAA6C;EACnD,MAAM;EACN,OAAO,KAAK;EACZ,OAAO;EACP,YAAY,CAAC,eAAe,UAAU;EACtC,QAAQ;GACP;IACC,MAAM;IACN,MAAM;IACN,OAAO,SAAS,KAAK,gBAAgB;IACrC,OAAO,EACN,YAAY,EACX,OACC,QAAQ,SAAS,KAAK,UAAU,SAAS,IACtC;KAAE,MAAM;KAAY,aAAa;MAAE;MAAS;KAAU;IAAE,IACxD,WACL,EACD;IACA,YAAY,0BAA0B,OAAO;IAG7C,kBAAkB,QAAQ,EAAE,MAAM,SAAS,EAAE;IAC7C,UAAU,wBAAwB,OAAO;GAC1C;GACA;IACC,MAAM;IACN,MAAM;IACN,cAAc;IACd,OAAO,SAAS,KAAK,iBAAiB;GACvC;GACA;IACC,MAAM;IACN,MAAM;IACN,KAAK;IACL,KAAK;IACL,OAAO,SAAS,KAAK,kBAAkB;GACxC;GACA;IACC,MAAM;IACN,MAAM;IACN,OAAO,SAAS,KAAK,gBAAgB;IACrC,GAAG,YAAY,QAAQ,aAAa,IAAI;GACzC;GACA;IACC,MAAM;IACN,MAAM;IACN,OAAO,SAAS,KAAK,gBAAgB;IACrC,GAAG,YAAY,QAAQ,aAAa,IAAI;GACzC;EACD;EACA,SAAS,EAAE,OAAO,aAAc,SAAS,OAAO,KAAK,gBAAgB,OAAO,MAAM;CACnF,CAAC;AACF;AAGgC,sBAAsB"}

package/dist/fields/builtin/checkbox.js

@@ -1,10 +1,33 @@
 import { keys } from "../../translations/keys.js";
+import { labelFor } from "../../translations/server.js";
 import { defineFormField } from "../defineFormField.js";
 //#region src/fields/builtin/checkbox.ts
+/**
+* A checkbox renders as a lone box with no free-text affordance, so `placeholder` is never read.
+* The intrinsic validator owns `required`: the engine's shared required guard only fires on an
+* empty value, and `false` (checked, then unchecked) is a present one, so without this a required
+* checkbox would accept an explicit refusal.
+*/
 const checkboxField = defineFormField({
 	type: "checkbox",
 	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)
 });
 //#endregion

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\nexport const checkboxField = defineFormField<'boolean'>({\n\ttype: 'checkbox',\n\tlabel: keys.fieldTypeCheckbox,\n\tvalue: 'boolean',\n\tformat: ({ value, t }) => (value ? t(keys.formatYes) : t(keys.formatNo)),\n})\n"],"mappings":";;;AAGA,MAAa,gBAAgB,gBAA2B;CACvD,MAAM;CACN,OAAO,KAAK;CACZ,OAAO;CACP,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/consent.js

@@ -1,29 +1,64 @@
 import { keys } from "../../translations/keys.js";
-import { labelFor } from "../../translations/server.js";
+import { labelForKey } from "../../translations/server.js";
 import { defineFormField } from "../defineFormField.js";
-//#region src/fields/builtin/consent.ts
 /**
-* Base consent field definition. `source` select and `sourceConfig` group are injected
-* by `buildFieldBlocks` from the live `consentRegistry`, so only the selected source's
-* fields are visible in the admin UI via `admin.condition`.
+* Consent is a reference, so the field is a reference: the author picks a source and nothing else.
+* The statement, the policy page, and its version all live with the source (see
+* `consentSourcesField`), so there is no wording to copy per form, no URL to paste, and no version
+* to type; correcting a statement corrects every form pointing at it. `label` and `placeholder` are
+* dropped for the same reason: the statement is the visible text and the checkbox's accessible name.
+*
+* Registered only when the plugin's `consent.sources` resolver is set, since a consent field with
+* no source to reference has nothing to say and nothing to prove.
+*
+* The intrinsic validator owns `required`: the engine's shared required guard only fires on an
+* empty value, and `false` (the coerced state of both an unchecked box and an absent answer) is a
+* present one, so without this a required consent would accept an explicit refusal.
+*
+* `display: 'notice'` renders the statement as prose with no control: the submit itself is the
+* consent, so there is no value for `required` to gate and validation always passes; the server
+* records `agreed: true` on the proof regardless of what the client sent.
 */
 const consentField = defineFormField({
 	type: "consent",
 	label: keys.fieldTypeConsent,
 	value: "boolean",
+	omitShared: [
+		"label",
+		"placeholder",
+		"description"
+	],
+	blockLabel: "@10x-media/form-builder/client#ConsentBlockLabel",
 	config: [{
-		name: "statement",
+		name: "source",
 		type: "text",
-		label: labelFor(keys.consentConfigStatement)
+		label: labelForKey(keys.consentConfigSource),
+		admin: { components: { Field: {
+			path: "@10x-media/form-builder/client#EndpointOptionsSelect",
+			clientProps: {
+				endpoint: "consent-sources",
+				descriptionKey: keys.consentConfigSourceDescription,
+				isClearable: false
+			}
+		} } }
 	}, {
-		name: "optional",
-		type: "checkbox",
-		label: labelFor(keys.consentConfigOptional)
+		name: "display",
+		type: "select",
+		defaultValue: "checkbox",
+		label: labelForKey(keys.consentConfigDisplay),
+		admin: {
+			isClearable: false,
+			description: labelForKey(keys.consentConfigDisplayDescription)
+		},
+		options: [{
+			label: labelForKey(keys.consentDisplayCheckbox),
+			value: "checkbox"
+		}, {
+			label: labelForKey(keys.consentDisplayNotice),
+			value: "notice"
+		}]
 	}],
-	validate: ({ value, config, t }) => {
-		if (!(config.optional === true) && value !== true) return t(keys.validationRequired);
-		return true;
-	},
+	validate: ({ value, config, t }) => config.display !== "notice" && config.required === true && value !== true ? t(keys.validationRequired) : true,
 	format: ({ value, t }) => t(value === true ? keys.formatYes : keys.formatNo)
 });
 //#endregion

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

@@ -1 +1 @@
-{"version":3,"file":"consent.js","names":[],"sources":["../../../src/fields/builtin/consent.ts"],"sourcesContent":["import { keys } from '../../translations/keys'\nimport { labelFor } from '../../translations/server'\nimport { defineFormField } from '../defineFormField'\n\ntype ConsentConfig = {\n\tstatement?: string\n\tsource?: string\n\tsourceConfig?: Record<string, unknown>\n\toptional?: boolean\n}\n\n/**\n * Base consent field definition. `source` select and `sourceConfig` group are injected\n * by `buildFieldBlocks` from the live `consentRegistry`, so only the selected source's\n * fields are visible in the admin UI via `admin.condition`.\n */\nexport const consentField = defineFormField<'boolean', ConsentConfig>({\n\ttype: 'consent',\n\tlabel: keys.fieldTypeConsent,\n\tvalue: 'boolean',\n\tconfig: [\n\t\t{ name: 'statement', type: 'text', label: labelFor(keys.consentConfigStatement) },\n\t\t// source select and sourceConfig group are injected by buildFieldBlocks at plugin boot\n\t\t// so the options reflect the live consentRegistry rather than this static list.\n\t\t{ name: 'optional', type: 'checkbox', label: labelFor(keys.consentConfigOptional) },\n\t],\n\tvalidate: ({ value, config, t }) => {\n\t\tconst optional = (config as ConsentConfig).optional === true\n\t\tif (!optional && value !== true) {\n\t\t\treturn t(keys.validationRequired)\n\t\t}\n\t\treturn true\n\t},\n\tformat: ({ value, t }) => t(value === true ? keys.formatYes : keys.formatNo),\n})\n"],"mappings":";;;;;;;;;AAgBA,MAAa,eAAe,gBAA0C;CACrE,MAAM;CACN,OAAO,KAAK;CACZ,OAAO;CACP,QAAQ,CACP;EAAE,MAAM;EAAa,MAAM;EAAQ,OAAO,SAAS,KAAK,sBAAsB;CAAE,GAGhF;EAAE,MAAM;EAAY,MAAM;EAAY,OAAO,SAAS,KAAK,qBAAqB;CAAE,CACnF;CACA,WAAW,EAAE,OAAO,QAAQ,QAAQ;EAEnC,IAAI,EADc,OAAyB,aAAa,SACvC,UAAU,MAC1B,OAAO,EAAE,KAAK,kBAAkB;EAEjC,OAAO;CACR;CACA,SAAS,EAAE,OAAO,QAAQ,EAAE,UAAU,OAAO,KAAK,YAAY,KAAK,QAAQ;AAC5E,CAAC"}
+{"version":3,"file":"consent.js","names":[],"sources":["../../../src/fields/builtin/consent.ts"],"sourcesContent":["import type { ConsentDisplay } from '../../consent/effectiveStatement'\nimport { keys } from '../../translations/keys'\nimport { labelForKey } from '../../translations/server'\nimport { defineFormField } from '../defineFormField'\n\ntype ConsentConfig = { source?: string; required?: boolean; display?: ConsentDisplay }\n\nconst SOURCE_FIELD_REF = '@10x-media/form-builder/client#EndpointOptionsSelect'\n\n/**\n * Consent is a reference, so the field is a reference: the author picks a source and nothing else.\n * The statement, the policy page, and its version all live with the source (see\n * `consentSourcesField`), so there is no wording to copy per form, no URL to paste, and no version\n * to type; correcting a statement corrects every form pointing at it. `label` and `placeholder` are\n * dropped for the same reason: the statement is the visible text and the checkbox's accessible name.\n *\n * Registered only when the plugin's `consent.sources` resolver is set, since a consent field with\n * no source to reference has nothing to say and nothing to prove.\n *\n * The intrinsic validator owns `required`: the engine's shared required guard only fires on an\n * empty value, and `false` (the coerced state of both an unchecked box and an absent answer) is a\n * present one, so without this a required consent would accept an explicit refusal.\n *\n * `display: 'notice'` renders the statement as prose with no control: the submit itself is the\n * consent, so there is no value for `required` to gate and validation always passes; the server\n * records `agreed: true` on the proof regardless of what the client sent.\n */\nexport const consentField = defineFormField<'boolean', ConsentConfig>({\n\ttype: 'consent',\n\tlabel: keys.fieldTypeConsent,\n\tvalue: 'boolean',\n\tomitShared: ['label', 'placeholder', 'description'],\n\tblockLabel: '@10x-media/form-builder/client#ConsentBlockLabel',\n\tconfig: [\n\t\t{\n\t\t\tname: 'source',\n\t\t\ttype: 'text',\n\t\t\tlabel: labelForKey(keys.consentConfigSource),\n\t\t\tadmin: {\n\t\t\t\tcomponents: {\n\t\t\t\t\tField: {\n\t\t\t\t\t\tpath: SOURCE_FIELD_REF,\n\t\t\t\t\t\tclientProps: {\n\t\t\t\t\t\t\tendpoint: 'consent-sources',\n\t\t\t\t\t\t\tdescriptionKey: keys.consentConfigSourceDescription,\n\t\t\t\t\t\t\tisClearable: false,\n\t\t\t\t\t\t},\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t},\n\t\t},\n\t\t{\n\t\t\tname: 'display',\n\t\t\ttype: 'select',\n\t\t\tdefaultValue: 'checkbox',\n\t\t\tlabel: labelForKey(keys.consentConfigDisplay),\n\t\t\tadmin: { isClearable: false, description: labelForKey(keys.consentConfigDisplayDescription) },\n\t\t\toptions: [\n\t\t\t\t{ label: labelForKey(keys.consentDisplayCheckbox), value: 'checkbox' },\n\t\t\t\t{ label: labelForKey(keys.consentDisplayNotice), value: 'notice' },\n\t\t\t],\n\t\t},\n\t],\n\tvalidate: ({ value, config, t }) =>\n\t\tconfig.display !== 'notice' && config.required === true && value !== true\n\t\t\t? t(keys.validationRequired)\n\t\t\t: true,\n\tformat: ({ value, t }) => t(value === true ? keys.formatYes : keys.formatNo),\n})\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;AA2BA,MAAa,eAAe,gBAA0C;CACrE,MAAM;CACN,OAAO,KAAK;CACZ,OAAO;CACP,YAAY;EAAC;EAAS;EAAe;CAAa;CAClD,YAAY;CACZ,QAAQ,CACP;EACC,MAAM;EACN,MAAM;EACN,OAAO,YAAY,KAAK,mBAAmB;EAC3C,OAAO,EACN,YAAY,EACX,OAAO;GACN,MAAM;GACN,aAAa;IACZ,UAAU;IACV,gBAAgB,KAAK;IACrB,aAAa;GACd;EACD,EACD,EACD;CACD,GACA;EACC,MAAM;EACN,MAAM;EACN,cAAc;EACd,OAAO,YAAY,KAAK,oBAAoB;EAC5C,OAAO;GAAE,aAAa;GAAO,aAAa,YAAY,KAAK,+BAA+B;EAAE;EAC5F,SAAS,CACR;GAAE,OAAO,YAAY,KAAK,sBAAsB;GAAG,OAAO;EAAW,GACrE;GAAE,OAAO,YAAY,KAAK,oBAAoB;GAAG,OAAO;EAAS,CAClE;CACD,CACD;CACA,WAAW,EAAE,OAAO,QAAQ,QAC3B,OAAO,YAAY,YAAY,OAAO,aAAa,QAAQ,UAAU,OAClE,EAAE,KAAK,kBAAkB,IACzB;CACJ,SAAS,EAAE,OAAO,QAAQ,EAAE,UAAU,OAAO,KAAK,YAAY,KAAK,QAAQ;AAC5E,CAAC"}

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

@@ -0,0 +1,13 @@
+import { FormFieldConfigValues, FormFieldDefinition } from "../types.js";
+
+//#region src/fields/builtin/country.d.ts
+/**
+ * A country picker fronted by the fixed ISO 3166-1 alpha-2 set (see {@link COUNTRIES}). Unlike
+ * `select` the author does not author options, so there is no `config`; the stored value is the
+ * two-letter code and `format` resolves it to the English name. `resolveOptions` exposes the same
+ * set as poll choices so a country field can back a poll despite carrying no authored options.
+ */
+declare const countryField: FormFieldDefinition<"text", FormFieldConfigValues>;
+//#endregion
+export { countryField };
+//# sourceMappingURL=country.d.ts.map

package/dist/fields/builtin/country.js

@@ -0,0 +1,30 @@
+import { keys } from "../../translations/keys.js";
+import { defineFormField } from "../defineFormField.js";
+import { COUNTRIES, countryLabel, isCountryCode } from "../data/regions.js";
+//#region src/fields/builtin/country.ts
+/**
+* A country picker fronted by the fixed ISO 3166-1 alpha-2 set (see {@link COUNTRIES}). Unlike
+* `select` the author does not author options, so there is no `config`; the stored value is the
+* two-letter code and `format` resolves it to the English name. `resolveOptions` exposes the same
+* set as poll choices so a country field can back a poll despite carrying no authored options.
+*/
+const countryField = defineFormField({
+	type: "country",
+	label: keys.fieldTypeCountry,
+	value: "text",
+	conditionType: "select",
+	pollEligible: true,
+	resolveOptions: () => COUNTRIES,
+	validate: ({ value, t }) => {
+		if (value == null || value === "") return true;
+		return isCountryCode(value) ? true : t(keys.validationCountry);
+	},
+	format: ({ value }) => {
+		if (value == null || value === "") return "";
+		return countryLabel(value) ?? String(value);
+	}
+});
+//#endregion
+export { countryField };
+
+//# sourceMappingURL=country.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"country.js","names":[],"sources":["../../../src/fields/builtin/country.ts"],"sourcesContent":["import { keys } from '../../translations/keys'\nimport { COUNTRIES, countryLabel, isCountryCode } from '../data/regions'\nimport { defineFormField } from '../defineFormField'\n\n/**\n * A country picker fronted by the fixed ISO 3166-1 alpha-2 set (see {@link COUNTRIES}). Unlike\n * `select` the author does not author options, so there is no `config`; the stored value is the\n * two-letter code and `format` resolves it to the English name. `resolveOptions` exposes the same\n * set as poll choices so a country field can back a poll despite carrying no authored options.\n */\nexport const countryField = defineFormField<'text'>({\n\ttype: 'country',\n\tlabel: keys.fieldTypeCountry,\n\tvalue: 'text',\n\tconditionType: 'select',\n\tpollEligible: true,\n\tresolveOptions: () => COUNTRIES,\n\tvalidate: ({ value, t }) => {\n\t\tif (value == null || value === '') {\n\t\t\treturn true\n\t\t}\n\t\treturn isCountryCode(value) ? true : t(keys.validationCountry)\n\t},\n\tformat: ({ value }) => {\n\t\tif (value == null || value === '') {\n\t\t\treturn ''\n\t\t}\n\t\treturn countryLabel(value) ?? String(value)\n\t},\n})\n"],"mappings":";;;;;;;;;;AAUA,MAAa,eAAe,gBAAwB;CACnD,MAAM;CACN,OAAO,KAAK;CACZ,OAAO;CACP,eAAe;CACf,cAAc;CACd,sBAAsB;CACtB,WAAW,EAAE,OAAO,QAAQ;EAC3B,IAAI,SAAS,QAAQ,UAAU,IAC9B,OAAO;EAER,OAAO,cAAc,KAAK,IAAI,OAAO,EAAE,KAAK,iBAAiB;CAC9D;CACA,SAAS,EAAE,YAAY;EACtB,IAAI,SAAS,QAAQ,UAAU,IAC9B,OAAO;EAER,OAAO,aAAa,KAAK,KAAK,OAAO,KAAK;CAC3C;AACD,CAAC"}

package/dist/fields/builtin/date.js

@@ -0,0 +1,31 @@
+import { keys } from "../../translations/keys.js";
+import { defineFormField } from "../defineFormField.js";
+//#region src/fields/builtin/date.ts
+const DATE_PATTERN = /^(\d{4})-(\d{2})-(\d{2})$/;
+/** True calendar-date check for `YYYY-MM-DD` strings (rejects e.g. `2024-02-30`). */
+const isValidCalendarDate = (value) => {
+	const match = DATE_PATTERN.exec(value);
+	if (!match) return false;
+	const [, yearStr, monthStr, dayStr] = match;
+	const year = Number(yearStr);
+	const month = Number(monthStr);
+	const day = Number(dayStr);
+	const date = new Date(Date.UTC(year, month - 1, day));
+	return date.getUTCFullYear() === year && date.getUTCMonth() === month - 1 && date.getUTCDate() === day;
+};
+/** `placeholder` is omitted: browsers ignore it on `<input type="date">`, which renders its own picker. */
+const dateField = defineFormField({
+	type: "date",
+	label: keys.fieldTypeDate,
+	value: "date",
+	omitShared: ["placeholder"],
+	validate: ({ value, t }) => {
+		if (value == null || value === "") return true;
+		return isValidCalendarDate(value) ? true : t(keys.validationDate);
+	},
+	format: ({ value }) => value == null ? "" : String(value)
+});
+//#endregion
+export { dateField, isValidCalendarDate };
+
+//# sourceMappingURL=date.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"date.js","names":[],"sources":["../../../src/fields/builtin/date.ts"],"sourcesContent":["import { keys } from '../../translations/keys'\nimport { defineFormField } from '../defineFormField'\n\nconst DATE_PATTERN = /^(\\d{4})-(\\d{2})-(\\d{2})$/\n\n/** True calendar-date check for `YYYY-MM-DD` strings (rejects e.g. `2024-02-30`). */\nexport const isValidCalendarDate = (value: string): boolean => {\n\tconst match = DATE_PATTERN.exec(value)\n\tif (!match) {\n\t\treturn false\n\t}\n\tconst [, yearStr, monthStr, dayStr] = match\n\tconst year = Number(yearStr)\n\tconst month = Number(monthStr)\n\tconst day = Number(dayStr)\n\tconst date = new Date(Date.UTC(year, month - 1, day))\n\treturn (\n\t\tdate.getUTCFullYear() === year && date.getUTCMonth() === month - 1 && date.getUTCDate() === day\n\t)\n}\n\n/** `placeholder` is omitted: browsers ignore it on `<input type=\"date\">`, which renders its own picker. */\nexport const dateField = defineFormField<'date'>({\n\ttype: 'date',\n\tlabel: keys.fieldTypeDate,\n\tvalue: 'date',\n\tomitShared: ['placeholder'],\n\tvalidate: ({ value, t }) => {\n\t\tif (value == null || value === '') {\n\t\t\treturn true\n\t\t}\n\t\treturn isValidCalendarDate(value) ? true : t(keys.validationDate)\n\t},\n\tformat: ({ value }) => (value == null ? '' : String(value)),\n})\n"],"mappings":";;;AAGA,MAAM,eAAe;;AAGrB,MAAa,uBAAuB,UAA2B;CAC9D,MAAM,QAAQ,aAAa,KAAK,KAAK;CACrC,IAAI,CAAC,OACJ,OAAO;CAER,MAAM,GAAG,SAAS,UAAU,UAAU;CACtC,MAAM,OAAO,OAAO,OAAO;CAC3B,MAAM,QAAQ,OAAO,QAAQ;CAC7B,MAAM,MAAM,OAAO,MAAM;CACzB,MAAM,OAAO,IAAI,KAAK,KAAK,IAAI,MAAM,QAAQ,GAAG,GAAG,CAAC;CACpD,OACC,KAAK,eAAe,MAAM,QAAQ,KAAK,YAAY,MAAM,QAAQ,KAAK,KAAK,WAAW,MAAM;AAE9F;;AAGA,MAAa,YAAY,gBAAwB;CAChD,MAAM;CACN,OAAO,KAAK;CACZ,OAAO;CACP,YAAY,CAAC,aAAa;CAC1B,WAAW,EAAE,OAAO,QAAQ;EAC3B,IAAI,SAAS,QAAQ,UAAU,IAC9B,OAAO;EAER,OAAO,oBAAoB,KAAK,IAAI,OAAO,EAAE,KAAK,cAAc;CACjE;CACA,SAAS,EAAE,YAAa,SAAS,OAAO,KAAK,OAAO,KAAK;AAC1D,CAAC"}

package/dist/fields/builtin/email.js

@@ -1,11 +1,18 @@
 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
-const EMAIL_PATTERN = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
 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 { defineFormField } from '../defineFormField'\n\nconst EMAIL_PATTERN = /^[^\\s@]+@[^\\s@]+\\.[^\\s@]+$/\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":";;;AAGA,MAAM,gBAAgB;AAEtB,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/file.d.ts

@@ -0,0 +1,15 @@
+//#region src/fields/builtin/file.d.ts
+/**
+ * Curated MIME type choices for the file field's `mimeTypes` select. Values are raw MIME strings or
+ * trailing-`*` prefix wildcards, exactly the patterns `resolveFileRef` matches server-side; `type/*`
+ * values double as the file input's `accept` attribute (browsers ignore other prefix patterns, which
+ * is fine since the server stays authoritative). Every value must be 63 bytes or less: Payload's
+ * db-postgres adapter stores select options as a pg enum, and pg enum labels cap at 63 bytes.
+ */
+declare const fileMimeTypeOptions: {
+  label: string;
+  value: string;
+}[];
+//#endregion
+export { fileMimeTypeOptions };
+//# sourceMappingURL=file.d.ts.map