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

package/dist/exports/react.d.ts

@@ -1,3 +1,4 @@
+import { CalcExpression } from "../calc/types.js";
 import { FormFieldInstance, SubmissionValue } from "../submissions/types.js";
 import { de } from "../translations/de.js";
 import { en } from "../translations/en.js";
@@ -7,9 +8,10 @@ import { BodyConverter, BodyConverterArgs, BodyRender, sanitizeUrl } from "../ac
 import { BodyContext, serializeBody } from "../actions/body/serializeBody.js";
 import { textOfBody } from "../actions/body/textOfBody.js";
 import { AggregationBucket, FieldAggregation } from "../aggregation/types.js";
-import { CalcExpression } from "../calc/types.js";
+import { CalcResolved, evaluateCalc } from "../calc/evaluate.js";
 import { computeCalcFields } from "../calc/computeCalcFields.js";
-import { evaluateCalc } from "../calc/evaluate.js";
+import { formatCalc } from "../calc/formatCalc.js";
+import { CalcDisplayConfig, formatCalcValue } from "../calc/formatCalcValue.js";
 import { evaluateCondition } from "../conditions/evaluate.js";
 import { ConsentStatement, ConsentStatements } from "../consent/resolveConsentStatements.js";
 import { COUNTRIES, US_STATES } from "../fields/data/regions.js";
@@ -47,12 +49,14 @@ import { UseDismissOptions, useDismiss } from "../react/presentation/useDismiss.
 import { useFocusTrap } from "../react/presentation/useFocusTrap.js";
 import { useScrollLock } from "../react/presentation/useScrollLock.js";
 import { Checkbox, CheckboxProps } from "../react/primitives/Checkbox.js";
+import { ChoiceGroup, ChoiceGroupProps, ChoiceOption } from "../react/primitives/ChoiceGroup.js";
 import { FieldShell, FieldShellProps } from "../react/primitives/FieldShell.js";
 import { Input, InputProps } from "../react/primitives/Input.js";
 import { Select, SelectOption, SelectProps } from "../react/primitives/Select.js";
 import { Textarea, TextareaProps } from "../react/primitives/Textarea.js";
 import { defaultRenderers } from "../react/renderers/index.js";
 import { UploadFileInput, UploadFileResult, uploadFile } from "../react/uploadFile.js";
+import { useCalcValues } from "../react/useCalcValues.js";
 import { UseFieldResult, useField } from "../react/useField.js";
 import { useFormState } from "../react/useFormState.js";
 import { useFormStep } from "../react/useFormStep.js";
@@ -60,4 +64,4 @@ import { interpolate } from "../recall/interpolate.js";
 import { CAPTCHA_TOKEN_KEY, DEFAULT_HONEYPOT_FIELD } from "../spam/constants.js";
 import { makeTranslate } from "../translations/makeTranslate.js";
 import { formatBytes } from "../uploads/formatBytes.js";
-export { type AggregationBucket, type BackButtonRenderProps, Backdrop, type BackdropProps, type BodyContext, type BodyConverter, type BodyConverterArgs, type BodyRender, CAPTCHA_TOKEN_KEY, COUNTRIES, type CalcExpression, type CaptchaWidgetHandle, Checkbox, type CheckboxProps, type ConsentStatement, type ConsentStatements, DEFAULT_HONEYPOT_FIELD, DialogSurface, type DialogSurfaceProps, type FetchResultsInput, type FetchResultsResult, type FieldAggregation, type FieldErrors, type FieldRenderer, type FieldRendererProps, FieldShell, type FieldShellProps, type FieldWidth, Form, type FormAction, type FormButtonSettings, type FormContextValue, type FormControlLabels, FormControls, type FormControlsProps, type FormDocument, type FormFieldInstance, FormFields, type FormFieldsProps, FormLayout, type FormLayoutProps, type FormPollSettings, type FormPresentation, type FormProps, type FormResponseSettings, FormResults, type FormResultsProps, type FormState, type FormStepInfo, FormSteps, type FormStepsProps, type FormSuccessResponse, type FormSuccessResult, HCAPTCHA_SCRIPT_URL, HcaptchaCaptcha, type HcaptchaCaptchaProps, Honeypot, type HoneypotProps, Input, type InputProps, type NextButtonRenderProps, Poll, type PollProps, type PrefillOptions, type PresentationOption, type PresentationRegistry, type PresentationWrapperProps, type PresentationsConfig, RECAPTCHA_SCRIPT_URL, type RecallResolver, RecaptchaCaptcha, type RecaptchaCaptchaHandle, type RecaptchaCaptchaProps, type RendererOption, type RendererRegistry, type RendererTranslate, type RenderersConfig, Select, type SelectOption, type SelectProps, type SubmissionValue, type SubmitButtonRenderProps, type SubmitFormResult, type SubmitHandler, TURNSTILE_SCRIPT_URL, Textarea, type TextareaProps, type ToFormDocumentOptions, type TranslationBundle, TurnstileCaptcha, type TurnstileCaptchaProps, US_STATES, type UploadFileInput, type UploadFileResult, type UseDismissOptions, type UseFieldResult, buildRecallResolver, bundles, clientRuntimeKeys, cn, computeCalcFields, de, defaultPresentations, defaultRenderers, defineFieldRenderer, en, evaluateCalc, evaluateCondition, fetchFormResults, fieldKey, firstStepId, formatBytes, interpolate, isTerminalStepId, makeTranslate, resolveNextStepId, resolvePresentations, resolveRenderers, sanitizeUrl, serializeBody, stepFieldNames, submitForm, textOfBody, toFormDocument, uploadFile, useDismiss, useField, useFocusTrap, useFormContext, useFormState, useFormStep, useScrollLock, valuesFromSearchParams, widthProps };
+export { type AggregationBucket, type BackButtonRenderProps, Backdrop, type BackdropProps, type BodyContext, type BodyConverter, type BodyConverterArgs, type BodyRender, CAPTCHA_TOKEN_KEY, COUNTRIES, type CalcDisplayConfig, type CalcExpression, type CalcResolved, type CaptchaWidgetHandle, Checkbox, type CheckboxProps, ChoiceGroup, type ChoiceGroupProps, type ChoiceOption, type ConsentStatement, type ConsentStatements, DEFAULT_HONEYPOT_FIELD, DialogSurface, type DialogSurfaceProps, type FetchResultsInput, type FetchResultsResult, type FieldAggregation, type FieldErrors, type FieldRenderer, type FieldRendererProps, FieldShell, type FieldShellProps, type FieldWidth, Form, type FormAction, type FormButtonSettings, type FormContextValue, type FormControlLabels, FormControls, type FormControlsProps, type FormDocument, type FormFieldInstance, FormFields, type FormFieldsProps, FormLayout, type FormLayoutProps, type FormPollSettings, type FormPresentation, type FormProps, type FormResponseSettings, FormResults, type FormResultsProps, type FormState, type FormStepInfo, FormSteps, type FormStepsProps, type FormSuccessResponse, type FormSuccessResult, HCAPTCHA_SCRIPT_URL, HcaptchaCaptcha, type HcaptchaCaptchaProps, Honeypot, type HoneypotProps, Input, type InputProps, type NextButtonRenderProps, Poll, type PollProps, type PrefillOptions, type PresentationOption, type PresentationRegistry, type PresentationWrapperProps, type PresentationsConfig, RECAPTCHA_SCRIPT_URL, type RecallResolver, RecaptchaCaptcha, type RecaptchaCaptchaHandle, type RecaptchaCaptchaProps, type RendererOption, type RendererRegistry, type RendererTranslate, type RenderersConfig, Select, type SelectOption, type SelectProps, type SubmissionValue, type SubmitButtonRenderProps, type SubmitFormResult, type SubmitHandler, TURNSTILE_SCRIPT_URL, Textarea, type TextareaProps, type ToFormDocumentOptions, type TranslationBundle, TurnstileCaptcha, type TurnstileCaptchaProps, US_STATES, type UploadFileInput, type UploadFileResult, type UseDismissOptions, type UseFieldResult, buildRecallResolver, bundles, clientRuntimeKeys, cn, computeCalcFields, de, defaultPresentations, defaultRenderers, defineFieldRenderer, en, evaluateCalc, evaluateCondition, fetchFormResults, fieldKey, firstStepId, formatBytes, formatCalc, formatCalcValue, interpolate, isTerminalStepId, makeTranslate, resolveNextStepId, resolvePresentations, resolveRenderers, sanitizeUrl, serializeBody, stepFieldNames, submitForm, textOfBody, toFormDocument, uploadFile, useCalcValues, useDismiss, useField, useFocusTrap, useFormContext, useFormState, useFormStep, useScrollLock, valuesFromSearchParams, widthProps };

package/dist/exports/react.js

@@ -2,15 +2,17 @@
 import { interpolate } from "../recall/interpolate.js";
 import { sanitizeUrl } from "../actions/body/converters.js";
 import { serializeBody } from "../actions/body/serializeBody.js";
-import { CAPTCHA_TOKEN_KEY, DEFAULT_HONEYPOT_FIELD } from "../spam/constants.js";
+import { formatCalcValue } from "../calc/formatCalcValue.js";
 import { fieldKey } from "../fields/fieldKey.js";
 import { evaluateCalc } from "../calc/evaluate.js";
 import { computeCalcFields } from "../calc/computeCalcFields.js";
+import { CAPTCHA_TOKEN_KEY, DEFAULT_HONEYPOT_FIELD } from "../spam/constants.js";
 import { evaluateCondition } from "../conditions/evaluate.js";
 import { textOfBody } from "../actions/body/textOfBody.js";
 import { de } from "../translations/de.js";
 import { en } from "../translations/en.js";
 import { bundles } from "../translations/index.js";
+import { formatCalc } from "../calc/formatCalc.js";
 import { COUNTRIES, US_STATES } from "../fields/data/regions.js";
 import { toFormDocument } from "../form/toFormDocument.js";
 import { valuesFromSearchParams } from "../prefill/valuesFromSearchParams.js";
@@ -42,6 +44,7 @@ import { Checkbox } from "../react/primitives/Checkbox.js";
 import { Input } from "../react/primitives/Input.js";
 import { uploadFile } from "../react/uploadFile.js";
 import { Select } from "../react/primitives/Select.js";
+import { ChoiceGroup } from "../react/primitives/ChoiceGroup.js";
 import { Textarea } from "../react/primitives/Textarea.js";
 import { defaultRenderers } from "../react/renderers/index.js";
 import { submitForm } from "../react/submitForm.js";
@@ -50,7 +53,8 @@ import { FormResults } from "../react/FormResults.js";
 import { FormSteps } from "../react/FormSteps.js";
 import { fetchFormResults } from "../react/fetchResults.js";
 import { Poll } from "../react/Poll.js";
+import { useCalcValues } from "../react/useCalcValues.js";
 import { useFormState } from "../react/useFormState.js";
 import { useFormStep } from "../react/useFormStep.js";
 import { clientRuntimeKeys } from "../translations/clientRuntimeKeys.js";
-export { Backdrop, CAPTCHA_TOKEN_KEY, COUNTRIES, Checkbox, DEFAULT_HONEYPOT_FIELD, DialogSurface, FieldShell, Form, FormControls, FormFields, FormLayout, FormResults, FormSteps, HCAPTCHA_SCRIPT_URL, HcaptchaCaptcha, Honeypot, Input, Poll, RECAPTCHA_SCRIPT_URL, RecaptchaCaptcha, Select, TURNSTILE_SCRIPT_URL, Textarea, TurnstileCaptcha, US_STATES, buildRecallResolver, bundles, clientRuntimeKeys, cn, computeCalcFields, de, defaultPresentations, defaultRenderers, defineFieldRenderer, en, evaluateCalc, evaluateCondition, fetchFormResults, fieldKey, firstStepId, formatBytes, interpolate, isTerminalStepId, makeTranslate, resolveNextStepId, resolvePresentations, resolveRenderers, sanitizeUrl, serializeBody, stepFieldNames, submitForm, textOfBody, toFormDocument, uploadFile, useDismiss, useField, useFocusTrap, useFormContext, useFormState, useFormStep, useScrollLock, valuesFromSearchParams, widthProps };
+export { Backdrop, CAPTCHA_TOKEN_KEY, COUNTRIES, Checkbox, ChoiceGroup, DEFAULT_HONEYPOT_FIELD, DialogSurface, FieldShell, Form, FormControls, FormFields, FormLayout, FormResults, FormSteps, HCAPTCHA_SCRIPT_URL, HcaptchaCaptcha, Honeypot, Input, Poll, RECAPTCHA_SCRIPT_URL, RecaptchaCaptcha, Select, TURNSTILE_SCRIPT_URL, Textarea, TurnstileCaptcha, US_STATES, buildRecallResolver, bundles, clientRuntimeKeys, cn, computeCalcFields, de, defaultPresentations, defaultRenderers, defineFieldRenderer, en, evaluateCalc, evaluateCondition, fetchFormResults, fieldKey, firstStepId, formatBytes, formatCalc, formatCalcValue, interpolate, isTerminalStepId, makeTranslate, resolveNextStepId, resolvePresentations, resolveRenderers, sanitizeUrl, serializeBody, stepFieldNames, submitForm, textOfBody, toFormDocument, uploadFile, useCalcValues, useDismiss, useField, useFocusTrap, useFormContext, useFormState, useFormStep, useScrollLock, valuesFromSearchParams, widthProps };

package/dist/exports/rsc.js

@@ -1,8 +1,8 @@
 import { resolveConsentStatements } from "../consent/resolveConsentStatements.js";
 import { isPollClosed } from "../form/pollState.js";
 import { resolvePollOptions } from "../poll/resolvePollOptions.js";
-import { resolvePollOutcome } from "../poll/resolvePollOutcome.js";
 import { resolveEffectivePollOptions } from "../poll/effectivePollOptions.js";
+import { resolvePollOutcome } from "../poll/resolvePollOutcome.js";
 import { hasVotedCookie, votedCookieName } from "../submissions/votedCookie.js";
 import { signFormContext, verifyFormContext } from "../context/formContext.js";
 import { toFormDocument } from "../form/toFormDocument.js";

package/dist/exports/types.d.ts

@@ -1,9 +1,9 @@
+import { CalcExpression } from "../calc/types.js";
 import { FormFieldInstance, SubmissionDescriptor, SubmissionFieldError, SubmissionValue, SubmissionWidth } from "../submissions/types.js";
 import { FileFieldConfig, FileRef, FileRefError } from "../uploads/types.js";
 import { AnyFormFieldDefinition, FormFieldDefinition, FormFieldFormat, FormFieldValidate, FormFieldValueKind, OmittableSharedField } from "../fields/types.js";
 import { RichTextBodyOption } from "../actions/body/serializeBody.js";
 import { AggregationBucket, AggregationRow, FieldAggregation, FieldMeta, SubmissionStatusFilter } from "../aggregation/types.js";
-import { CalcExpression } from "../calc/types.js";
 import { ConsentSourceEntry, ConsentSourcePage, ConsentSourcesResolver } from "../consent/types.js";
 import { ConsentStatement, ConsentStatements, ResolveConsentStatementsArgs } from "../consent/resolveConsentStatements.js";
 import { FlowStep, FlowTransition, FormFlow } from "../flow/types.js";

package/dist/fields/buildFieldBlocks.js

@@ -58,7 +58,8 @@ const buildFieldBlocks = ({ registry, ruleRegistry, localize = true }) => {
 					blocks: buildRuleBlocks(ruleRegistry, definition.type)
 				},
 				localize,
-				omitShared: definition.omitShared
+				omitShared: definition.omitShared,
+				advancedConfig: definition.advancedConfig
 			})]
 		});
 	}

package/dist/fields/buildFieldBlocks.js.map

@@ -1 +1 @@
-{"version":3,"file":"buildFieldBlocks.js","names":[],"sources":["../../src/fields/buildFieldBlocks.ts"],"sourcesContent":["import type { Block, Field, TabsField } from 'payload'\nimport { buildConditionTypeMap } from '../conditions/conditionType'\nimport { keys } from '../translations/keys'\nimport { labelFor } from '../translations/server'\nimport { buildRuleBlocks } from '../validation/buildRuleBlocks'\nimport type { ValidationRuleRegistry } from '../validation/registry'\nimport type { FieldTypeRegistry } from './registry'\nimport { fieldBlockTabs } from './sharedConfig'\n\nconst FIELD_BLOCK_LABEL_REF = '@10x-media/form-builder/client#FieldBlockLabel'\n\n/**\n * Replace Payload's default `blockName` row header (which reads \"Untitled\" until filled) with the\n * field's own `label`, keyed to the type label as fallback. See `FieldBlockLabel`.\n */\nconst blockLabelAdmin = (\n\ttypeLabelKey: string,\n\tref: string = FIELD_BLOCK_LABEL_REF\n): NonNullable<Block['admin']> => ({\n\tcomponents: { Label: { path: ref, clientProps: { typeLabelKey } } },\n})\n\n/** Whether `fields` contains a field named `name`, descending into presentational rows. */\nconst hasNameField = (fields: Field[]): boolean =>\n\tfields.some((f) => {\n\t\tif ('name' in f && f.name === 'name') {\n\t\t\treturn true\n\t\t}\n\t\treturn f.type === 'row' && hasNameField(f.fields)\n\t})\n\n/** The tab whose fields hold the shared basics and type config, found by the `name` field it carries. */\nconst fieldTabOf = (block: Block): Field[] | undefined => {\n\tconst tabsField = block.fields.find((f): f is TabsField => f.type === 'tabs')\n\treturn tabsField?.tabs.find((tab) => hasNameField(tab.fields))?.fields\n}\n\n/**\n * One add-field block per registered type: tabs holding shared config, type config, and\n * validations. Bare definitions (e.g. `message`) skip all of that: their block is the\n * definition's `config` alone, no name/shared basics/tabs. `localize` controls whether the\n * shared content fields carry `localized: true`; per-type config fields carry their own flag\n * from the registry definitions.\n */\ntype BuildFieldBlocksArgs = {\n\tregistry: FieldTypeRegistry\n\truleRegistry: ValidationRuleRegistry\n\tlocalize?: boolean\n}\n\nexport const buildFieldBlocks = ({\n\tregistry,\n\truleRegistry,\n\tlocalize = true,\n}: BuildFieldBlocksArgs): Block[] => {\n\tconst conditionTypes = buildConditionTypeMap(registry)\n\tconst blocks: Block[] = []\n\tconst bareSlugs = new Set<string>()\n\tfor (const definition of registry.values()) {\n\t\tconst typeConfig: Field[] = definition.config ?? []\n\n\t\tif (definition.bare === true) {\n\t\t\tbareSlugs.add(definition.type)\n\t\t\tblocks.push({\n\t\t\t\tslug: definition.type,\n\t\t\t\tlabels: { singular: labelFor(definition.label), plural: labelFor(definition.label) },\n\t\t\t\tadmin: blockLabelAdmin(definition.label, definition.blockLabel),\n\t\t\t\tfields: typeConfig,\n\t\t\t})\n\t\t\tcontinue\n\t\t}\n\n\t\tblocks.push({\n\t\t\tslug: definition.type,\n\t\t\tlabels: { singular: labelFor(definition.label), plural: labelFor(definition.label) },\n\t\t\tadmin: blockLabelAdmin(definition.label, definition.blockLabel),\n\t\t\tfields: [\n\t\t\t\tfieldBlockTabs({\n\t\t\t\t\tconditionTypes,\n\t\t\t\t\ttypeConfig,\n\t\t\t\t\tvalidations: {\n\t\t\t\t\t\tname: 'validations',\n\t\t\t\t\t\ttype: 'blocks',\n\t\t\t\t\t\tlabel: labelFor(keys.validationsLabel),\n\t\t\t\t\t\tblocks: buildRuleBlocks(ruleRegistry, definition.type),\n\t\t\t\t\t},\n\t\t\t\t\tlocalize,\n\t\t\t\t\tomitShared: definition.omitShared,\n\t\t\t\t}),\n\t\t\t],\n\t\t})\n\t}\n\n\t// Second pass: inject subFields into the repeater block using all non-repeater blocks.\n\t// Done after the main loop so every sibling block is already built.\n\t// Repeater-in-repeater is not supported in v1; the repeater block is excluded from subFields.\n\t// Bare blocks are excluded too: repeater row plumbing (values, composite error paths) is name-keyed.\n\tconst repeaterBlock = blocks.find((b) => b.slug === 'repeater')\n\tif (repeaterBlock) {\n\t\tconst subFieldsField: Field = {\n\t\t\tname: 'subFields',\n\t\t\ttype: 'blocks',\n\t\t\tlabel: labelFor(keys.configSubFields),\n\t\t\tblocks: blocks.filter((b) => b.slug !== 'repeater' && !bareSlugs.has(b.slug)),\n\t\t}\n\t\tconst fieldTabFields = fieldTabOf(repeaterBlock)\n\t\t;(fieldTabFields ?? (repeaterBlock.fields as Field[])).push(subFieldsField)\n\t}\n\n\treturn blocks\n}\n"],"mappings":";;;;;;AASA,MAAM,wBAAwB;;;;;AAM9B,MAAM,mBACL,cACA,MAAc,2BACoB,EAClC,YAAY,EAAE,OAAO;CAAE,MAAM;CAAK,aAAa,EAAE,aAAa;AAAE,EAAE,EACnE;;AAGA,MAAM,gBAAgB,WACrB,OAAO,MAAM,MAAM;CAClB,IAAI,UAAU,KAAK,EAAE,SAAS,QAC7B,OAAO;CAER,OAAO,EAAE,SAAS,SAAS,aAAa,EAAE,MAAM;AACjD,CAAC;;AAGF,MAAM,cAAc,UAAsC;CAEzD,OADkB,MAAM,OAAO,MAAM,MAAsB,EAAE,SAAS,MACvD,GAAG,KAAK,MAAM,QAAQ,aAAa,IAAI,MAAM,CAAC,GAAG;AACjE;AAeA,MAAa,oBAAoB,EAChC,UACA,cACA,WAAW,WACyB;CACpC,MAAM,iBAAiB,sBAAsB,QAAQ;CACrD,MAAM,SAAkB,CAAC;CACzB,MAAM,4BAAY,IAAI,IAAY;CAClC,KAAK,MAAM,cAAc,SAAS,OAAO,GAAG;EAC3C,MAAM,aAAsB,WAAW,UAAU,CAAC;EAElD,IAAI,WAAW,SAAS,MAAM;GAC7B,UAAU,IAAI,WAAW,IAAI;GAC7B,OAAO,KAAK;IACX,MAAM,WAAW;IACjB,QAAQ;KAAE,UAAU,SAAS,WAAW,KAAK;KAAG,QAAQ,SAAS,WAAW,KAAK;IAAE;IACnF,OAAO,gBAAgB,WAAW,OAAO,WAAW,UAAU;IAC9D,QAAQ;GACT,CAAC;GACD;EACD;EAEA,OAAO,KAAK;GACX,MAAM,WAAW;GACjB,QAAQ;IAAE,UAAU,SAAS,WAAW,KAAK;IAAG,QAAQ,SAAS,WAAW,KAAK;GAAE;GACnF,OAAO,gBAAgB,WAAW,OAAO,WAAW,UAAU;GAC9D,QAAQ,CACP,eAAe;IACd;IACA;IACA,aAAa;KACZ,MAAM;KACN,MAAM;KACN,OAAO,SAAS,KAAK,gBAAgB;KACrC,QAAQ,gBAAgB,cAAc,WAAW,IAAI;IACtD;IACA;IACA,YAAY,WAAW;GACxB,CAAC,CACF;EACD,CAAC;CACF;CAMA,MAAM,gBAAgB,OAAO,MAAM,MAAM,EAAE,SAAS,UAAU;CAC9D,IAAI,eAAe;EAClB,MAAM,iBAAwB;GAC7B,MAAM;GACN,MAAM;GACN,OAAO,SAAS,KAAK,eAAe;GACpC,QAAQ,OAAO,QAAQ,MAAM,EAAE,SAAS,cAAc,CAAC,UAAU,IAAI,EAAE,IAAI,CAAC;EAC7E;EAEC,CADsB,WAAW,aACnB,KAAM,cAAc,QAAoB,KAAK,cAAc;CAC3E;CAEA,OAAO;AACR"}
+{"version":3,"file":"buildFieldBlocks.js","names":[],"sources":["../../src/fields/buildFieldBlocks.ts"],"sourcesContent":["import type { Block, Field, TabsField } from 'payload'\nimport { buildConditionTypeMap } from '../conditions/conditionType'\nimport { keys } from '../translations/keys'\nimport { labelFor } from '../translations/server'\nimport { buildRuleBlocks } from '../validation/buildRuleBlocks'\nimport type { ValidationRuleRegistry } from '../validation/registry'\nimport type { FieldTypeRegistry } from './registry'\nimport { fieldBlockTabs } from './sharedConfig'\n\nconst FIELD_BLOCK_LABEL_REF = '@10x-media/form-builder/client#FieldBlockLabel'\n\n/**\n * Replace Payload's default `blockName` row header (which reads \"Untitled\" until filled) with the\n * field's own `label`, keyed to the type label as fallback. See `FieldBlockLabel`.\n */\nconst blockLabelAdmin = (\n\ttypeLabelKey: string,\n\tref: string = FIELD_BLOCK_LABEL_REF\n): NonNullable<Block['admin']> => ({\n\tcomponents: { Label: { path: ref, clientProps: { typeLabelKey } } },\n})\n\n/** Whether `fields` contains a field named `name`, descending into presentational rows. */\nconst hasNameField = (fields: Field[]): boolean =>\n\tfields.some((f) => {\n\t\tif ('name' in f && f.name === 'name') {\n\t\t\treturn true\n\t\t}\n\t\treturn f.type === 'row' && hasNameField(f.fields)\n\t})\n\n/** The tab whose fields hold the shared basics and type config, found by the `name` field it carries. */\nconst fieldTabOf = (block: Block): Field[] | undefined => {\n\tconst tabsField = block.fields.find((f): f is TabsField => f.type === 'tabs')\n\treturn tabsField?.tabs.find((tab) => hasNameField(tab.fields))?.fields\n}\n\n/**\n * One add-field block per registered type: tabs holding shared config, type config, and\n * validations. Bare definitions (e.g. `message`) skip all of that: their block is the\n * definition's `config` alone, no name/shared basics/tabs. `localize` controls whether the\n * shared content fields carry `localized: true`; per-type config fields carry their own flag\n * from the registry definitions.\n */\ntype BuildFieldBlocksArgs = {\n\tregistry: FieldTypeRegistry\n\truleRegistry: ValidationRuleRegistry\n\tlocalize?: boolean\n}\n\nexport const buildFieldBlocks = ({\n\tregistry,\n\truleRegistry,\n\tlocalize = true,\n}: BuildFieldBlocksArgs): Block[] => {\n\tconst conditionTypes = buildConditionTypeMap(registry)\n\tconst blocks: Block[] = []\n\tconst bareSlugs = new Set<string>()\n\tfor (const definition of registry.values()) {\n\t\tconst typeConfig: Field[] = definition.config ?? []\n\n\t\tif (definition.bare === true) {\n\t\t\tbareSlugs.add(definition.type)\n\t\t\tblocks.push({\n\t\t\t\tslug: definition.type,\n\t\t\t\tlabels: { singular: labelFor(definition.label), plural: labelFor(definition.label) },\n\t\t\t\tadmin: blockLabelAdmin(definition.label, definition.blockLabel),\n\t\t\t\tfields: typeConfig,\n\t\t\t})\n\t\t\tcontinue\n\t\t}\n\n\t\tblocks.push({\n\t\t\tslug: definition.type,\n\t\t\tlabels: { singular: labelFor(definition.label), plural: labelFor(definition.label) },\n\t\t\tadmin: blockLabelAdmin(definition.label, definition.blockLabel),\n\t\t\tfields: [\n\t\t\t\tfieldBlockTabs({\n\t\t\t\t\tconditionTypes,\n\t\t\t\t\ttypeConfig,\n\t\t\t\t\tvalidations: {\n\t\t\t\t\t\tname: 'validations',\n\t\t\t\t\t\ttype: 'blocks',\n\t\t\t\t\t\tlabel: labelFor(keys.validationsLabel),\n\t\t\t\t\t\tblocks: buildRuleBlocks(ruleRegistry, definition.type),\n\t\t\t\t\t},\n\t\t\t\t\tlocalize,\n\t\t\t\t\tomitShared: definition.omitShared,\n\t\t\t\t\tadvancedConfig: definition.advancedConfig,\n\t\t\t\t}),\n\t\t\t],\n\t\t})\n\t}\n\n\t// Second pass: inject subFields into the repeater block using all non-repeater blocks.\n\t// Done after the main loop so every sibling block is already built.\n\t// Repeater-in-repeater is not supported in v1; the repeater block is excluded from subFields.\n\t// Bare blocks are excluded too: repeater row plumbing (values, composite error paths) is name-keyed.\n\tconst repeaterBlock = blocks.find((b) => b.slug === 'repeater')\n\tif (repeaterBlock) {\n\t\tconst subFieldsField: Field = {\n\t\t\tname: 'subFields',\n\t\t\ttype: 'blocks',\n\t\t\tlabel: labelFor(keys.configSubFields),\n\t\t\tblocks: blocks.filter((b) => b.slug !== 'repeater' && !bareSlugs.has(b.slug)),\n\t\t}\n\t\tconst fieldTabFields = fieldTabOf(repeaterBlock)\n\t\t;(fieldTabFields ?? (repeaterBlock.fields as Field[])).push(subFieldsField)\n\t}\n\n\treturn blocks\n}\n"],"mappings":";;;;;;AASA,MAAM,wBAAwB;;;;;AAM9B,MAAM,mBACL,cACA,MAAc,2BACoB,EAClC,YAAY,EAAE,OAAO;CAAE,MAAM;CAAK,aAAa,EAAE,aAAa;AAAE,EAAE,EACnE;;AAGA,MAAM,gBAAgB,WACrB,OAAO,MAAM,MAAM;CAClB,IAAI,UAAU,KAAK,EAAE,SAAS,QAC7B,OAAO;CAER,OAAO,EAAE,SAAS,SAAS,aAAa,EAAE,MAAM;AACjD,CAAC;;AAGF,MAAM,cAAc,UAAsC;CAEzD,OADkB,MAAM,OAAO,MAAM,MAAsB,EAAE,SAAS,MACvD,GAAG,KAAK,MAAM,QAAQ,aAAa,IAAI,MAAM,CAAC,GAAG;AACjE;AAeA,MAAa,oBAAoB,EAChC,UACA,cACA,WAAW,WACyB;CACpC,MAAM,iBAAiB,sBAAsB,QAAQ;CACrD,MAAM,SAAkB,CAAC;CACzB,MAAM,4BAAY,IAAI,IAAY;CAClC,KAAK,MAAM,cAAc,SAAS,OAAO,GAAG;EAC3C,MAAM,aAAsB,WAAW,UAAU,CAAC;EAElD,IAAI,WAAW,SAAS,MAAM;GAC7B,UAAU,IAAI,WAAW,IAAI;GAC7B,OAAO,KAAK;IACX,MAAM,WAAW;IACjB,QAAQ;KAAE,UAAU,SAAS,WAAW,KAAK;KAAG,QAAQ,SAAS,WAAW,KAAK;IAAE;IACnF,OAAO,gBAAgB,WAAW,OAAO,WAAW,UAAU;IAC9D,QAAQ;GACT,CAAC;GACD;EACD;EAEA,OAAO,KAAK;GACX,MAAM,WAAW;GACjB,QAAQ;IAAE,UAAU,SAAS,WAAW,KAAK;IAAG,QAAQ,SAAS,WAAW,KAAK;GAAE;GACnF,OAAO,gBAAgB,WAAW,OAAO,WAAW,UAAU;GAC9D,QAAQ,CACP,eAAe;IACd;IACA;IACA,aAAa;KACZ,MAAM;KACN,MAAM;KACN,OAAO,SAAS,KAAK,gBAAgB;KACrC,QAAQ,gBAAgB,cAAc,WAAW,IAAI;IACtD;IACA;IACA,YAAY,WAAW;IACvB,gBAAgB,WAAW;GAC5B,CAAC,CACF;EACD,CAAC;CACF;CAMA,MAAM,gBAAgB,OAAO,MAAM,MAAM,EAAE,SAAS,UAAU;CAC9D,IAAI,eAAe;EAClB,MAAM,iBAAwB;GAC7B,MAAM;GACN,MAAM;GACN,OAAO,SAAS,KAAK,eAAe;GACpC,QAAQ,OAAO,QAAQ,MAAM,EAAE,SAAS,cAAc,CAAC,UAAU,IAAI,EAAE,IAAI,CAAC;EAC7E;EAEC,CADsB,WAAW,aACnB,KAAM,cAAc,QAAoB,KAAK,cAAc;CAC3E;CAEA,OAAO;AACR"}

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

@@ -0,0 +1,17 @@
+import { PayloadRequest } from "payload";
+
+//#region src/fields/builtin/calculation.d.ts
+/**
+ * Serializable calc-source metadata for the admin builder (threaded as clientProps): key, display
+ * label, and which modes the source implements (`scalar` = has `resolve`, `weights` = has
+ * `resolveWeights`). Derived where the registry is resolved; resolver functions never serialize.
+ */
+type CalcSourceClientMeta = {
+  key: string;
+  label: string | Record<string, string>;
+  scalar: boolean;
+  weights: boolean;
+};
+//#endregion
+export { CalcSourceClientMeta };
+//# sourceMappingURL=calculation.d.ts.map

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