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

package/dist/fields/builtin/file.js

@@ -1,40 +1,127 @@
 import { keys } from "../../translations/keys.js";
 import { labelFor } from "../../translations/server.js";
 import { defineFormField } from "../defineFormField.js";
+import { mimeAllowed } from "../../uploads/resolveFileRef.js";
 //#region src/fields/builtin/file.ts
 const isFileRef = (value) => typeof value === "object" && value !== null && "filename" in value;
+const MAX_SIZE_REF = "@10x-media/form-builder/client#ByteSizeField";
+/**
+* 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.
+*/
+const fileMimeTypeOptions = [
+	{
+		label: "Any image",
+		value: "image/*"
+	},
+	{
+		label: "PNG image",
+		value: "image/png"
+	},
+	{
+		label: "JPEG image",
+		value: "image/jpeg"
+	},
+	{
+		label: "WebP image",
+		value: "image/webp"
+	},
+	{
+		label: "GIF image",
+		value: "image/gif"
+	},
+	{
+		label: "SVG image",
+		value: "image/svg+xml"
+	},
+	{
+		label: "PDF",
+		value: "application/pdf"
+	},
+	{
+		label: "Plain text",
+		value: "text/plain"
+	},
+	{
+		label: "CSV",
+		value: "text/csv"
+	},
+	{
+		label: "ZIP archive",
+		value: "application/zip"
+	},
+	{
+		label: "Word document (.doc)",
+		value: "application/msword"
+	},
+	{
+		label: "Excel spreadsheet (.xls)",
+		value: "application/vnd.ms-excel"
+	},
+	{
+		label: "Office documents (docx, xlsx, pptx)",
+		value: "application/vnd.openxmlformats-officedocument.*"
+	},
+	{
+		label: "Any audio",
+		value: "audio/*"
+	},
+	{
+		label: "Any video",
+		value: "video/*"
+	}
+];
 /**
 * The `file` field type. Its stored value is a server-captured {@link FileRef}; the client only ever submits
 * the upload id, and `runSubmission` re-reads filename/mimeType/filesize from the upload doc at the trust
 * boundary (see `captureFileRef`). The intrinsic validator is intentionally a no-op: MIME/size/existence are
-* enforced authoritatively server-side against the stored doc, never against client metadata. `relationTo`,
-* `mimeTypes`, and `maxSize` persist on the block so the capture can enforce them.
+* enforced authoritatively server-side against the stored doc, never against client metadata. `mimeTypes`
+* and `maxSize` persist on the block so the capture can enforce them. `uploadsCollection` is not
+* author-editable: a forms hook stamps the plugin-configured uploads collection slug onto it on every save
+* so the client renderer knows where to POST; the server never trusts it at submit time (plugin config
+* stays the source of truth). Named `uploadsCollection` because `collection` is a mongoose-reserved
+* schema pathname.
+*
+* `allowedMimeTypes` (the host upload collection's `upload.mimeTypes`, threaded from the plugin
+* factory) constrains the picker's MIME options to what the collection actually accepts; omitted
+* keeps the full list. Admin-time only: the collection and `captureFileRef` remain authoritative.
 */
-const fileField = defineFormField({
+const buildFileField = (allowedMimeTypes) => defineFormField({
 	type: "file",
 	label: keys.fieldTypeFile,
 	value: "file",
+	omitShared: ["placeholder"],
 	config: [
 		{
-			name: "relationTo",
+			name: "uploadsCollection",
 			type: "text",
-			label: labelFor(keys.fileConfigRelationTo)
+			admin: { hidden: true }
 		},
 		{
 			name: "mimeTypes",
-			type: "text",
+			type: "select",
 			hasMany: true,
+			options: fileMimeTypeOptions.filter((option) => mimeAllowed(option.value, allowedMimeTypes)),
 			label: labelFor(keys.fileConfigMimeTypes)
 		},
 		{
 			name: "maxSize",
 			type: "number",
-			label: labelFor(keys.fileConfigMaxSize)
+			min: 0,
+			label: labelFor(keys.fileConfigMaxSize),
+			admin: { components: { Field: {
+				path: MAX_SIZE_REF,
+				clientProps: { descriptionKey: keys.fileConfigMaxSizeDescription }
+			} } }
 		}
 	],
 	format: ({ value }) => isFileRef(value) ? value.filename : ""
 });
+buildFileField();
 //#endregion
-export { fileField };
+export { buildFileField, fileMimeTypeOptions };
 
 //# sourceMappingURL=file.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"file.js","names":[],"sources":["../../../src/fields/builtin/file.ts"],"sourcesContent":["import { keys } from '../../translations/keys'\nimport { labelFor } from '../../translations/server'\nimport type { FileRef } from '../../uploads/types'\nimport { defineFormField } from '../defineFormField'\n\ntype FileConfig = {\n\trelationTo?: string\n\tmimeTypes?: string[]\n\tmaxSize?: number\n}\n\nconst isFileRef = (value: unknown): value is FileRef =>\n\ttypeof value === 'object' && value !== null && 'filename' in value\n\n/**\n * The `file` field type. Its stored value is a server-captured {@link FileRef}; the client only ever submits\n * the upload id, and `runSubmission` re-reads filename/mimeType/filesize from the upload doc at the trust\n * boundary (see `captureFileRef`). The intrinsic validator is intentionally a no-op: MIME/size/existence are\n * enforced authoritatively server-side against the stored doc, never against client metadata. `relationTo`,\n * `mimeTypes`, and `maxSize` persist on the block so the capture can enforce them.\n */\nexport const fileField = defineFormField<'file', FileConfig>({\n\ttype: 'file',\n\tlabel: keys.fieldTypeFile,\n\tvalue: 'file',\n\tconfig: [\n\t\t{ name: 'relationTo', type: 'text', label: labelFor(keys.fileConfigRelationTo) },\n\t\t{ name: 'mimeTypes', type: 'text', hasMany: true, label: labelFor(keys.fileConfigMimeTypes) },\n\t\t{ name: 'maxSize', type: 'number', label: labelFor(keys.fileConfigMaxSize) },\n\t],\n\tformat: ({ value }) => (isFileRef(value) ? value.filename : ''),\n})\n"],"mappings":";;;;AAWA,MAAM,aAAa,UAClB,OAAO,UAAU,YAAY,UAAU,QAAQ,cAAc;;;;;;;;AAS9D,MAAa,YAAY,gBAAoC;CAC5D,MAAM;CACN,OAAO,KAAK;CACZ,OAAO;CACP,QAAQ;EACP;GAAE,MAAM;GAAc,MAAM;GAAQ,OAAO,SAAS,KAAK,oBAAoB;EAAE;EAC/E;GAAE,MAAM;GAAa,MAAM;GAAQ,SAAS;GAAM,OAAO,SAAS,KAAK,mBAAmB;EAAE;EAC5F;GAAE,MAAM;GAAW,MAAM;GAAU,OAAO,SAAS,KAAK,iBAAiB;EAAE;CAC5E;CACA,SAAS,EAAE,YAAa,UAAU,KAAK,IAAI,MAAM,WAAW;AAC7D,CAAC"}
+{"version":3,"file":"file.js","names":[],"sources":["../../../src/fields/builtin/file.ts"],"sourcesContent":["import { keys } from '../../translations/keys'\nimport { labelFor } from '../../translations/server'\nimport { mimeAllowed } from '../../uploads/resolveFileRef'\nimport type { FileRef } from '../../uploads/types'\nimport { defineFormField } from '../defineFormField'\n\ntype FileConfig = {\n\tuploadsCollection?: string\n\tmimeTypes?: string[]\n\tmaxSize?: number\n}\n\nconst isFileRef = (value: unknown): value is FileRef =>\n\ttypeof value === 'object' && value !== null && 'filename' in value\n\nconst MAX_SIZE_REF = '@10x-media/form-builder/client#ByteSizeField'\n\n/**\n * Curated MIME type choices for the file field's `mimeTypes` select. Values are raw MIME strings or\n * trailing-`*` prefix wildcards, exactly the patterns `resolveFileRef` matches server-side; `type/*`\n * values double as the file input's `accept` attribute (browsers ignore other prefix patterns, which\n * is fine since the server stays authoritative). Every value must be 63 bytes or less: Payload's\n * db-postgres adapter stores select options as a pg enum, and pg enum labels cap at 63 bytes.\n */\nexport const fileMimeTypeOptions = [\n\t{ label: 'Any image', value: 'image/*' },\n\t{ label: 'PNG image', value: 'image/png' },\n\t{ label: 'JPEG image', value: 'image/jpeg' },\n\t{ label: 'WebP image', value: 'image/webp' },\n\t{ label: 'GIF image', value: 'image/gif' },\n\t{ label: 'SVG image', value: 'image/svg+xml' },\n\t{ label: 'PDF', value: 'application/pdf' },\n\t{ label: 'Plain text', value: 'text/plain' },\n\t{ label: 'CSV', value: 'text/csv' },\n\t{ label: 'ZIP archive', value: 'application/zip' },\n\t{ label: 'Word document (.doc)', value: 'application/msword' },\n\t{ label: 'Excel spreadsheet (.xls)', value: 'application/vnd.ms-excel' },\n\t{\n\t\tlabel: 'Office documents (docx, xlsx, pptx)',\n\t\tvalue: 'application/vnd.openxmlformats-officedocument.*',\n\t},\n\t{ label: 'Any audio', value: 'audio/*' },\n\t{ label: 'Any video', value: 'video/*' },\n]\n\n/**\n * The `file` field type. Its stored value is a server-captured {@link FileRef}; the client only ever submits\n * the upload id, and `runSubmission` re-reads filename/mimeType/filesize from the upload doc at the trust\n * boundary (see `captureFileRef`). The intrinsic validator is intentionally a no-op: MIME/size/existence are\n * enforced authoritatively server-side against the stored doc, never against client metadata. `mimeTypes`\n * and `maxSize` persist on the block so the capture can enforce them. `uploadsCollection` is not\n * author-editable: a forms hook stamps the plugin-configured uploads collection slug onto it on every save\n * so the client renderer knows where to POST; the server never trusts it at submit time (plugin config\n * stays the source of truth). Named `uploadsCollection` because `collection` is a mongoose-reserved\n * schema pathname.\n *\n * `allowedMimeTypes` (the host upload collection's `upload.mimeTypes`, threaded from the plugin\n * factory) constrains the picker's MIME options to what the collection actually accepts; omitted\n * keeps the full list. Admin-time only: the collection and `captureFileRef` remain authoritative.\n */\nexport const buildFileField = (allowedMimeTypes?: string[]) =>\n\tdefineFormField<'file', FileConfig>({\n\t\ttype: 'file',\n\t\tlabel: keys.fieldTypeFile,\n\t\tvalue: 'file',\n\t\tomitShared: ['placeholder'],\n\t\tconfig: [\n\t\t\t{ name: 'uploadsCollection', type: 'text', admin: { hidden: true } },\n\t\t\t{\n\t\t\t\tname: 'mimeTypes',\n\t\t\t\ttype: 'select',\n\t\t\t\thasMany: true,\n\t\t\t\toptions: fileMimeTypeOptions.filter((option) =>\n\t\t\t\t\tmimeAllowed(option.value, allowedMimeTypes)\n\t\t\t\t),\n\t\t\t\tlabel: labelFor(keys.fileConfigMimeTypes),\n\t\t\t},\n\t\t\t{\n\t\t\t\tname: 'maxSize',\n\t\t\t\ttype: 'number',\n\t\t\t\tmin: 0,\n\t\t\t\tlabel: labelFor(keys.fileConfigMaxSize),\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\tpath: MAX_SIZE_REF,\n\t\t\t\t\t\t\tclientProps: { descriptionKey: keys.fileConfigMaxSizeDescription },\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\tformat: ({ value }) => (isFileRef(value) ? value.filename : ''),\n\t})\n\n/** The file field with the full MIME option list, for consumers spreading a default definition. */\nexport const fileField = buildFileField()\n"],"mappings":";;;;;AAYA,MAAM,aAAa,UAClB,OAAO,UAAU,YAAY,UAAU,QAAQ,cAAc;AAE9D,MAAM,eAAe;;;;;;;;AASrB,MAAa,sBAAsB;CAClC;EAAE,OAAO;EAAa,OAAO;CAAU;CACvC;EAAE,OAAO;EAAa,OAAO;CAAY;CACzC;EAAE,OAAO;EAAc,OAAO;CAAa;CAC3C;EAAE,OAAO;EAAc,OAAO;CAAa;CAC3C;EAAE,OAAO;EAAa,OAAO;CAAY;CACzC;EAAE,OAAO;EAAa,OAAO;CAAgB;CAC7C;EAAE,OAAO;EAAO,OAAO;CAAkB;CACzC;EAAE,OAAO;EAAc,OAAO;CAAa;CAC3C;EAAE,OAAO;EAAO,OAAO;CAAW;CAClC;EAAE,OAAO;EAAe,OAAO;CAAkB;CACjD;EAAE,OAAO;EAAwB,OAAO;CAAqB;CAC7D;EAAE,OAAO;EAA4B,OAAO;CAA2B;CACvE;EACC,OAAO;EACP,OAAO;CACR;CACA;EAAE,OAAO;EAAa,OAAO;CAAU;CACvC;EAAE,OAAO;EAAa,OAAO;CAAU;AACxC;;;;;;;;;;;;;;;;AAiBA,MAAa,kBAAkB,qBAC9B,gBAAoC;CACnC,MAAM;CACN,OAAO,KAAK;CACZ,OAAO;CACP,YAAY,CAAC,aAAa;CAC1B,QAAQ;EACP;GAAE,MAAM;GAAqB,MAAM;GAAQ,OAAO,EAAE,QAAQ,KAAK;EAAE;EACnE;GACC,MAAM;GACN,MAAM;GACN,SAAS;GACT,SAAS,oBAAoB,QAAQ,WACpC,YAAY,OAAO,OAAO,gBAAgB,CAC3C;GACA,OAAO,SAAS,KAAK,mBAAmB;EACzC;EACA;GACC,MAAM;GACN,MAAM;GACN,KAAK;GACL,OAAO,SAAS,KAAK,iBAAiB;GACtC,OAAO,EACN,YAAY,EACX,OAAO;IACN,MAAM;IACN,aAAa,EAAE,gBAAgB,KAAK,6BAA6B;GAClE,EACD,EACD;EACD;CACD;CACA,SAAS,EAAE,YAAa,UAAU,KAAK,IAAI,MAAM,WAAW;AAC7D,CAAC;AAGuB,eAAe"}

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

@@ -0,0 +1,30 @@
+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
+/**
+ * Built-in field definitions with content-bearing config fields (select option labels, repeater add
+ * label) carrying `localized: true` when `localize` is true. `editor`, when given, overrides the
+ * 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`. `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[], calcAllowed?: CalcAllowed, calcSources?: CalcSourceClientMeta[]) => AnyFormFieldDefinition[];
+declare const defaultFieldDefinitions: AnyFormFieldDefinition[];
+/**
+ * `defaultFieldDefinitions` indexed by `type`, so a single built-in can be spread and tweaked
+ * without hand-rolling a `.find()`, e.g.
+ * `fields: { text: { ...defaultFieldDefinitionsByType.text, validate: myValidate } }`. The
+ * `fields` plugin option replaces a built-in of the same `type`; `false` removes it, `true` keeps it.
+ * Prebuilt with content localization on; with `localizeContent: false`, derive overrides from
+ * `buildDefaultFieldDefinitions(false)` instead so the spread does not reintroduce `localized`.
+ */
+declare const defaultFieldDefinitionsByType: Record<string, AnyFormFieldDefinition>;
+//#endregion
+export { buildDefaultFieldDefinitions, defaultFieldDefinitions, defaultFieldDefinitionsByType };
+//# sourceMappingURL=index.d.ts.map

package/dist/fields/builtin/index.js

@@ -1,27 +1,54 @@
-import { calculationField } from "./calculation.js";
+import { buildCalculationField } from "./calculation.js";
 import { checkboxField } from "./checkbox.js";
 import { consentField } from "./consent.js";
+import { dateField } from "./date.js";
 import { emailField } from "./email.js";
-import { fileField } from "./file.js";
+import { buildFileField } from "./file.js";
+import { buildMessageField } from "./message.js";
 import { numberField } from "./number.js";
-import { repeaterField } from "./repeater.js";
-import { selectField } from "./select.js";
+import { buildRepeaterField } from "./repeater.js";
+import { buildSelectField } from "./select.js";
 import { textField } from "./text.js";
 import { textareaField } from "./textarea.js";
 //#region src/fields/builtin/index.ts
-const defaultFieldDefinitions = [
+/**
+* Built-in field definitions with content-bearing config fields (select option labels, repeater add
+* label) carrying `localized: true` when `localize` is true. `editor`, when given, overrides the
+* 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`. `calcAllowed` threads the registered calc
+* extension names into the calculation field's expression validate and editor schema;
+* `calcSources` carries the serializable source metadata the builder UI renders from.
+*/
+const buildDefaultFieldDefinitions = (localize, editor, uploadMimeTypes, calcAllowed, calcSources) => [
 	textField,
 	textareaField,
 	emailField,
 	numberField,
-	selectField,
+	buildSelectField(localize),
 	checkboxField,
-	calculationField,
+	buildCalculationField(calcAllowed, {
+		localize,
+		sources: calcSources
+	}),
 	consentField,
-	fileField,
-	repeaterField
+	buildFileField(uploadMimeTypes),
+	buildRepeaterField(localize),
+	dateField,
+	buildMessageField(localize, editor)
 ];
+const defaultFieldDefinitions = buildDefaultFieldDefinitions(true);
+/**
+* `defaultFieldDefinitions` indexed by `type`, so a single built-in can be spread and tweaked
+* without hand-rolling a `.find()`, e.g.
+* `fields: { text: { ...defaultFieldDefinitionsByType.text, validate: myValidate } }`. The
+* `fields` plugin option replaces a built-in of the same `type`; `false` removes it, `true` keeps it.
+* Prebuilt with content localization on; with `localizeContent: false`, derive overrides from
+* `buildDefaultFieldDefinitions(false)` instead so the spread does not reintroduce `localized`.
+*/
+const defaultFieldDefinitionsByType = Object.fromEntries(defaultFieldDefinitions.map((definition) => [definition.type, definition]));
 //#endregion
-export { defaultFieldDefinitions };
+export { buildDefaultFieldDefinitions, defaultFieldDefinitions, defaultFieldDefinitionsByType };
 
 //# sourceMappingURL=index.js.map

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

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

package/dist/fields/builtin/message.js

@@ -0,0 +1,30 @@
+import { keys } from "../../translations/keys.js";
+import { labelFor } from "../../translations/server.js";
+import { localizedIf } from "../localizedIf.js";
+import { defineFormField } from "../defineFormField.js";
+//#region src/fields/builtin/message.ts
+/**
+* Display-only inline rich text rendered between fields. Bare: the block is just the `content`
+* richText, no name/label/width/validation chrome, and instances are identified by their block
+* row id (see `fieldKey`). Value kind `'none'`: the engine never validates it and never writes it
+* to submissions. `content` is authored copy and follows `localize`; `editor`, when given,
+* overrides the host config's default richText editor (from the plugin's `richText.editor`).
+*/
+const buildMessageField = (localize, editor) => defineFormField({
+	type: "message",
+	label: keys.fieldTypeMessage,
+	value: "none",
+	bare: true,
+	config: [{
+		name: "content",
+		type: "richText",
+		label: labelFor(keys.configContent),
+		...editor ? { editor } : {},
+		...localizedIf(localize)
+	}]
+});
+buildMessageField(true);
+//#endregion
+export { buildMessageField };
+
+//# sourceMappingURL=message.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"message.js","names":[],"sources":["../../../src/fields/builtin/message.ts"],"sourcesContent":["import type { RichTextField } from 'payload'\nimport { keys } from '../../translations/keys'\nimport { labelFor } from '../../translations/server'\nimport { defineFormField } from '../defineFormField'\nimport { localizedIf } from '../localizedIf'\n\n/**\n * Display-only inline rich text rendered between fields. Bare: the block is just the `content`\n * richText, no name/label/width/validation chrome, and instances are identified by their block\n * row id (see `fieldKey`). Value kind `'none'`: the engine never validates it and never writes it\n * to submissions. `content` is authored copy and follows `localize`; `editor`, when given,\n * overrides the host config's default richText editor (from the plugin's `richText.editor`).\n */\nexport const buildMessageField = (localize: boolean, editor?: RichTextField['editor']) =>\n\tdefineFormField<'none'>({\n\t\ttype: 'message',\n\t\tlabel: keys.fieldTypeMessage,\n\t\tvalue: 'none',\n\t\tbare: true,\n\t\tconfig: [\n\t\t\t{\n\t\t\t\tname: 'content',\n\t\t\t\ttype: 'richText',\n\t\t\t\tlabel: labelFor(keys.configContent),\n\t\t\t\t...(editor ? { editor } : {}),\n\t\t\t\t...localizedIf(localize),\n\t\t\t},\n\t\t],\n\t})\n\nexport const messageField = buildMessageField(true)\n"],"mappings":";;;;;;;;;;;;AAaA,MAAa,qBAAqB,UAAmB,WACpD,gBAAwB;CACvB,MAAM;CACN,OAAO,KAAK;CACZ,OAAO;CACP,MAAM;CACN,QAAQ,CACP;EACC,MAAM;EACN,MAAM;EACN,OAAO,SAAS,KAAK,aAAa;EAClC,GAAI,SAAS,EAAE,OAAO,IAAI,CAAC;EAC3B,GAAG,YAAY,QAAQ;CACxB,CACD;AACD,CAAC;AAE0B,kBAAkB,IAAI"}

package/dist/fields/builtin/repeater.js

@@ -1,11 +1,14 @@
 import { keys } from "../../translations/keys.js";
 import { labelFor } from "../../translations/server.js";
+import { localizedIf } from "../localizedIf.js";
 import { defineFormField } from "../defineFormField.js";
 //#region src/fields/builtin/repeater.ts
-const repeaterField = defineFormField({
+/** `addLabel` is the visitor-facing add-row button text and follows `localize`; row bounds never do. */
+const buildRepeaterField = (localize) => defineFormField({
 	type: "repeater",
 	label: keys.fieldTypeRepeater,
 	value: "repeater",
+	omitShared: ["placeholder"],
 	config: [
 		{
 			name: "minRows",
@@ -22,7 +25,8 @@ const repeaterField = defineFormField({
 		{
 			name: "addLabel",
 			type: "text",
-			label: labelFor(keys.configAddLabel)
+			label: labelFor(keys.configAddLabel),
+			...localizedIf(localize)
 		}
 	],
 	validate: ({ value, config, t }) => {
@@ -38,7 +42,8 @@ const repeaterField = defineFormField({
 		return t(keys.repeaterRowCount).replace("{count}", String(count));
 	}
 });
+buildRepeaterField(true);
 //#endregion
-export { repeaterField };
+export { buildRepeaterField };
 
 //# sourceMappingURL=repeater.js.map

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

@@ -1 +1 @@
-{"version":3,"file":"repeater.js","names":[],"sources":["../../../src/fields/builtin/repeater.ts"],"sourcesContent":["import { keys } from '../../translations/keys'\nimport { labelFor } from '../../translations/server'\nimport { defineFormField } from '../defineFormField'\n\ntype RepeaterConfig = {\n\tminRows?: number\n\tmaxRows?: number\n\taddLabel?: string\n}\n\nexport const repeaterField = defineFormField<'repeater', RepeaterConfig>({\n\ttype: 'repeater',\n\tlabel: keys.fieldTypeRepeater,\n\tvalue: 'repeater',\n\tconfig: [\n\t\t{\n\t\t\tname: 'minRows',\n\t\t\ttype: 'number',\n\t\t\tmin: 0,\n\t\t\tlabel: labelFor(keys.configMinRows),\n\t\t},\n\t\t{\n\t\t\tname: 'maxRows',\n\t\t\ttype: 'number',\n\t\t\tmin: 1,\n\t\t\tlabel: labelFor(keys.configMaxRows),\n\t\t},\n\t\t{\n\t\t\tname: 'addLabel',\n\t\t\ttype: 'text',\n\t\t\tlabel: labelFor(keys.configAddLabel),\n\t\t},\n\t\t// subFields blocks field is injected by buildFieldBlocks after the main loop,\n\t\t// so all non-repeater blocks are available and repeater-in-repeater is excluded.\n\t],\n\tvalidate: ({ value, config, t }) => {\n\t\tconst rows = Array.isArray(value) ? value : []\n\t\tconst min = typeof config.minRows === 'number' ? config.minRows : 0\n\t\tif (rows.length < min) {\n\t\t\treturn t(keys.validationRepeaterMin).replace('{min}', String(min))\n\t\t}\n\t\tconst max = typeof config.maxRows === 'number' ? config.maxRows : undefined\n\t\tif (max != null && rows.length > max) {\n\t\t\treturn t(keys.validationRepeaterMax).replace('{max}', String(max))\n\t\t}\n\t\treturn true\n\t},\n\tformat: ({ value, t }) => {\n\t\tconst count = Array.isArray(value) ? value.length : 0\n\t\treturn t(keys.repeaterRowCount).replace('{count}', String(count))\n\t},\n})\n"],"mappings":";;;;AAUA,MAAa,gBAAgB,gBAA4C;CACxE,MAAM;CACN,OAAO,KAAK;CACZ,OAAO;CACP,QAAQ;EACP;GACC,MAAM;GACN,MAAM;GACN,KAAK;GACL,OAAO,SAAS,KAAK,aAAa;EACnC;EACA;GACC,MAAM;GACN,MAAM;GACN,KAAK;GACL,OAAO,SAAS,KAAK,aAAa;EACnC;EACA;GACC,MAAM;GACN,MAAM;GACN,OAAO,SAAS,KAAK,cAAc;EACpC;CAGD;CACA,WAAW,EAAE,OAAO,QAAQ,QAAQ;EACnC,MAAM,OAAO,MAAM,QAAQ,KAAK,IAAI,QAAQ,CAAC;EAC7C,MAAM,MAAM,OAAO,OAAO,YAAY,WAAW,OAAO,UAAU;EAClE,IAAI,KAAK,SAAS,KACjB,OAAO,EAAE,KAAK,qBAAqB,EAAE,QAAQ,SAAS,OAAO,GAAG,CAAC;EAElE,MAAM,MAAM,OAAO,OAAO,YAAY,WAAW,OAAO,UAAU,KAAA;EAClE,IAAI,OAAO,QAAQ,KAAK,SAAS,KAChC,OAAO,EAAE,KAAK,qBAAqB,EAAE,QAAQ,SAAS,OAAO,GAAG,CAAC;EAElE,OAAO;CACR;CACA,SAAS,EAAE,OAAO,QAAQ;EACzB,MAAM,QAAQ,MAAM,QAAQ,KAAK,IAAI,MAAM,SAAS;EACpD,OAAO,EAAE,KAAK,gBAAgB,EAAE,QAAQ,WAAW,OAAO,KAAK,CAAC;CACjE;AACD,CAAC"}
+{"version":3,"file":"repeater.js","names":[],"sources":["../../../src/fields/builtin/repeater.ts"],"sourcesContent":["import { keys } from '../../translations/keys'\nimport { labelFor } from '../../translations/server'\nimport { defineFormField } from '../defineFormField'\nimport { localizedIf } from '../localizedIf'\n\ntype RepeaterConfig = {\n\tminRows?: number\n\tmaxRows?: number\n\taddLabel?: string\n}\n\n/** `addLabel` is the visitor-facing add-row button text and follows `localize`; row bounds never do. */\nexport const buildRepeaterField = (localize: boolean) =>\n\tdefineFormField<'repeater', RepeaterConfig>({\n\t\ttype: 'repeater',\n\t\tlabel: keys.fieldTypeRepeater,\n\t\tvalue: 'repeater',\n\t\tomitShared: ['placeholder'],\n\t\tconfig: [\n\t\t\t{\n\t\t\t\tname: 'minRows',\n\t\t\t\ttype: 'number',\n\t\t\t\tmin: 0,\n\t\t\t\tlabel: labelFor(keys.configMinRows),\n\t\t\t},\n\t\t\t{\n\t\t\t\tname: 'maxRows',\n\t\t\t\ttype: 'number',\n\t\t\t\tmin: 1,\n\t\t\t\tlabel: labelFor(keys.configMaxRows),\n\t\t\t},\n\t\t\t{\n\t\t\t\tname: 'addLabel',\n\t\t\t\ttype: 'text',\n\t\t\t\tlabel: labelFor(keys.configAddLabel),\n\t\t\t\t...localizedIf(localize),\n\t\t\t},\n\t\t\t// subFields blocks field is injected by buildFieldBlocks after the main loop,\n\t\t\t// so all non-repeater blocks are available and repeater-in-repeater is excluded.\n\t\t],\n\t\tvalidate: ({ value, config, t }) => {\n\t\t\tconst rows = Array.isArray(value) ? value : []\n\t\t\tconst min = typeof config.minRows === 'number' ? config.minRows : 0\n\t\t\tif (rows.length < min) {\n\t\t\t\treturn t(keys.validationRepeaterMin).replace('{min}', String(min))\n\t\t\t}\n\t\t\tconst max = typeof config.maxRows === 'number' ? config.maxRows : undefined\n\t\t\tif (max != null && rows.length > max) {\n\t\t\t\treturn t(keys.validationRepeaterMax).replace('{max}', String(max))\n\t\t\t}\n\t\t\treturn true\n\t\t},\n\t\tformat: ({ value, t }) => {\n\t\t\tconst count = Array.isArray(value) ? value.length : 0\n\t\t\treturn t(keys.repeaterRowCount).replace('{count}', String(count))\n\t\t},\n\t})\n\nexport const repeaterField = buildRepeaterField(true)\n"],"mappings":";;;;;;AAYA,MAAa,sBAAsB,aAClC,gBAA4C;CAC3C,MAAM;CACN,OAAO,KAAK;CACZ,OAAO;CACP,YAAY,CAAC,aAAa;CAC1B,QAAQ;EACP;GACC,MAAM;GACN,MAAM;GACN,KAAK;GACL,OAAO,SAAS,KAAK,aAAa;EACnC;EACA;GACC,MAAM;GACN,MAAM;GACN,KAAK;GACL,OAAO,SAAS,KAAK,aAAa;EACnC;EACA;GACC,MAAM;GACN,MAAM;GACN,OAAO,SAAS,KAAK,cAAc;GACnC,GAAG,YAAY,QAAQ;EACxB;CAGD;CACA,WAAW,EAAE,OAAO,QAAQ,QAAQ;EACnC,MAAM,OAAO,MAAM,QAAQ,KAAK,IAAI,QAAQ,CAAC;EAC7C,MAAM,MAAM,OAAO,OAAO,YAAY,WAAW,OAAO,UAAU;EAClE,IAAI,KAAK,SAAS,KACjB,OAAO,EAAE,KAAK,qBAAqB,EAAE,QAAQ,SAAS,OAAO,GAAG,CAAC;EAElE,MAAM,MAAM,OAAO,OAAO,YAAY,WAAW,OAAO,UAAU,KAAA;EAClE,IAAI,OAAO,QAAQ,KAAK,SAAS,KAChC,OAAO,EAAE,KAAK,qBAAqB,EAAE,QAAQ,SAAS,OAAO,GAAG,CAAC;EAElE,OAAO;CACR;CACA,SAAS,EAAE,OAAO,QAAQ;EACzB,MAAM,QAAQ,MAAM,QAAQ,KAAK,IAAI,MAAM,SAAS;EACpD,OAAO,EAAE,KAAK,gBAAgB,EAAE,QAAQ,WAAW,OAAO,KAAK,CAAC;CACjE;AACD,CAAC;AAE2B,mBAAmB,IAAI"}

package/dist/fields/builtin/select.js

@@ -1,12 +1,15 @@
 import { keys } from "../../translations/keys.js";
 import { labelFor } from "../../translations/server.js";
+import { localizedIf } from "../localizedIf.js";
 import { defineFormField } from "../defineFormField.js";
 //#region src/fields/builtin/select.ts
-const selectField = defineFormField({
+/** Option `label` is author-facing content and follows `localize`; `value` is an identifier and never does. */
+const buildSelectField = (localize) => defineFormField({
 	type: "select",
 	label: keys.fieldTypeSelect,
 	value: "text",
 	conditionType: "select",
+	pollEligible: true,
 	config: [{
 		name: "options",
 		type: "array",
@@ -18,14 +21,34 @@ const selectField = defineFormField({
 		fields: [{
 			name: "label",
 			type: "text",
-			required: true,
-			label: labelFor(keys.configOptionLabel)
+			label: labelFor(keys.configOptionLabel),
+			...localizedIf(localize)
 		}, {
 			name: "value",
 			type: "text",
 			required: true,
 			label: labelFor(keys.configOptionValue)
 		}]
+	}, {
+		name: "display",
+		type: "select",
+		defaultValue: "dropdown",
+		label: labelFor(keys.configSelectDisplay),
+		admin: { isClearable: false },
+		options: [
+			{
+				label: labelFor(keys.selectDisplayDropdown),
+				value: "dropdown"
+			},
+			{
+				label: labelFor(keys.selectDisplayRadio),
+				value: "radio"
+			},
+			{
+				label: labelFor(keys.selectDisplayButtons),
+				value: "buttons"
+			}
+		]
 	}],
 	validate: ({ value, config, t }) => {
 		if (value == null || value === "") return true;
@@ -38,7 +61,8 @@ const selectField = defineFormField({
 		return optionLabels?.[value] ?? String(value);
 	}
 });
+buildSelectField(true);
 //#endregion
-export { selectField };
+export { buildSelectField };
 
 //# sourceMappingURL=select.js.map

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

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

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

@@ -0,0 +1,13 @@
+import { FormFieldConfigValues, FormFieldDefinition } from "../types.js";
+
+//#region src/fields/builtin/state.d.ts
+/**
+ * A US state/DC picker fronted by the fixed USPS-code set (see {@link US_STATES}), scoped US-only to
+ * match native's `state` block. Like `country` the author authors no options; the stored value is the
+ * state code and `format` resolves it to the state name. `resolveOptions` exposes the set as poll
+ * choices so a state field can back a poll despite carrying no authored options.
+ */
+declare const stateField: FormFieldDefinition<"text", FormFieldConfigValues>;
+//#endregion
+export { stateField };
+//# sourceMappingURL=state.d.ts.map

package/dist/fields/builtin/state.js

@@ -0,0 +1,30 @@
+import { keys } from "../../translations/keys.js";
+import { defineFormField } from "../defineFormField.js";
+import { US_STATES, isUsStateCode, usStateLabel } from "../data/regions.js";
+//#region src/fields/builtin/state.ts
+/**
+* A US state/DC picker fronted by the fixed USPS-code set (see {@link US_STATES}), scoped US-only to
+* match native's `state` block. Like `country` the author authors no options; the stored value is the
+* state code and `format` resolves it to the state name. `resolveOptions` exposes the set as poll
+* choices so a state field can back a poll despite carrying no authored options.
+*/
+const stateField = defineFormField({
+	type: "state",
+	label: keys.fieldTypeState,
+	value: "text",
+	conditionType: "select",
+	pollEligible: true,
+	resolveOptions: () => US_STATES,
+	validate: ({ value, t }) => {
+		if (value == null || value === "") return true;
+		return isUsStateCode(value) ? true : t(keys.validationState);
+	},
+	format: ({ value }) => {
+		if (value == null || value === "") return "";
+		return usStateLabel(value) ?? String(value);
+	}
+});
+//#endregion
+export { stateField };
+
+//# sourceMappingURL=state.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"state.js","names":[],"sources":["../../../src/fields/builtin/state.ts"],"sourcesContent":["import { keys } from '../../translations/keys'\nimport { isUsStateCode, US_STATES, usStateLabel } from '../data/regions'\nimport { defineFormField } from '../defineFormField'\n\n/**\n * A US state/DC picker fronted by the fixed USPS-code set (see {@link US_STATES}), scoped US-only to\n * match native's `state` block. Like `country` the author authors no options; the stored value is the\n * state code and `format` resolves it to the state name. `resolveOptions` exposes the set as poll\n * choices so a state field can back a poll despite carrying no authored options.\n */\nexport const stateField = defineFormField<'text'>({\n\ttype: 'state',\n\tlabel: keys.fieldTypeState,\n\tvalue: 'text',\n\tconditionType: 'select',\n\tpollEligible: true,\n\tresolveOptions: () => US_STATES,\n\tvalidate: ({ value, t }) => {\n\t\tif (value == null || value === '') {\n\t\t\treturn true\n\t\t}\n\t\treturn isUsStateCode(value) ? true : t(keys.validationState)\n\t},\n\tformat: ({ value }) => {\n\t\tif (value == null || value === '') {\n\t\t\treturn ''\n\t\t}\n\t\treturn usStateLabel(value) ?? String(value)\n\t},\n})\n"],"mappings":";;;;;;;;;;AAUA,MAAa,aAAa,gBAAwB;CACjD,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,eAAe;CAC5D;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/text.js

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

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

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

package/dist/fields/data/regions.d.ts

@@ -0,0 +1,21 @@
+//#region src/fields/data/regions.d.ts
+/**
+ * Fixed option sets for the built-in `country` and `state` field types: the author never authors
+ * these, so unlike `select` they live in code, not per-instance config. A plain data module with no
+ * dependencies, imported on both the server (validation, `format`, poll options) and the client (the
+ * frontend renderer, the condition builder), so it must stay isomorphic. `value` is the stored code
+ * and is the stable identity contract (never localize it); `label` is the English display name.
+ */
+/** ISO 3166-1 alpha-2 codes with their English short names (every officially assigned code). */
+declare const COUNTRIES: {
+  label: string;
+  value: string;
+}[];
+/** The 50 US states plus the District of Columbia, keyed by USPS code. Matches native's US-only `state` block. */
+declare const US_STATES: {
+  label: string;
+  value: string;
+}[];
+//#endregion
+export { COUNTRIES, US_STATES };
+//# sourceMappingURL=regions.d.ts.map