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

package/dist/client/RecipientsSelect.js

@@ -0,0 +1,174 @@
+"use client";
+import { fieldNames, fieldNamesOfType } from "../fields/fieldNamesOfType.js";
+import { keys } from "../translations/keys.js";
+import { isPlausibleEmail } from "../actions/emailRecipients.js";
+import { useTranslation as useTranslation$1 } from "../translations/useTranslation.js";
+import { toStaticLabel } from "./toStaticLabel.js";
+import { buildEndpointOptionsUrl, parseEndpointOptions } from "./endpointOptions.js";
+import { reduceFieldsToValues } from "payload/shared";
+import { FieldDescription, FieldError, FieldLabel, ReactSelect, RenderCustomComponent, useConfig, useDocumentInfo, useField, useFormFields } from "@payloadcms/ui";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { useEffect, useMemo, useState } from "react";
+//#region src/client/RecipientsSelect.tsx
+const tokenOptionsFromData = (data, types) => {
+	const rows = Array.isArray(data.fields) ? data.fields : [];
+	const labels = /* @__PURE__ */ new Map();
+	for (const row of rows) {
+		if (!row || typeof row !== "object") continue;
+		const { name, label } = row;
+		if (typeof name === "string" && typeof label === "string" && label.length > 0) labels.set(name.trim(), label);
+	}
+	return (types && types.length > 0 ? fieldNamesOfType(data.fields, types) : fieldNames(data.fields)).map((name) => ({
+		label: labels.get(name) ?? name,
+		value: `{{${name}}}`
+	}));
+};
+/**
+* A creatable, multi-value recipient field: pick a department (preset options from `endpoint`), pick a
+* form-field token (`{{field}}`, offered when `fieldTokens`), or type any email and press Enter
+* (`allowCustom`). Renders as native Payload badges (drag-reorderable), stores a `string[]`, honors
+* `admin.width` and the standard field props. Unknown or legacy stored values stay selectable.
+*/
+const RecipientsSelect = (props) => {
+	const allowCustom = props.allowCustom !== false;
+	const fieldTokens = props.fieldTokens !== false;
+	const { customComponents: { Description, Error: ErrorComponent, Label } = {}, disabled, path, setValue, showError, value } = useField({ path: props.path });
+	const { t } = useTranslation$1();
+	const label = toStaticLabel(props.field?.label ?? props.label);
+	const description = props.descriptionKey ? t(props.descriptionKey) : toStaticLabel(props.field?.admin?.description);
+	const { id, collectionSlug } = useDocumentInfo();
+	const { config } = useConfig();
+	const apiRoute = config.routes.api;
+	const readOnly = props.readOnly === true || disabled === true;
+	const [state, setState] = useState({ status: "idle" });
+	useEffect(() => {
+		if (!props.endpoint || id == null || !collectionSlug) return;
+		const controller = new AbortController();
+		const url = buildEndpointOptionsUrl({
+			apiRoute,
+			collectionSlug,
+			id,
+			endpoint: props.endpoint
+		});
+		setState({ status: "loading" });
+		fetch(url, {
+			credentials: "include",
+			headers: { Accept: "application/json" },
+			signal: controller.signal
+		}).then(async (response) => {
+			if (!response.ok) throw new Error(`Options request failed with ${response.status}`);
+			setState({
+				status: "loaded",
+				options: parseEndpointOptions(await response.json())
+			});
+		}).catch(() => {
+			if (!controller.signal.aborted) setState({ status: "error" });
+		});
+		return () => controller.abort();
+	}, [
+		apiRoute,
+		collectionSlug,
+		id,
+		props.endpoint
+	]);
+	const presetOptions = state.status === "loaded" ? state.options : [];
+	const tokenJson = useFormFields(([fields]) => fieldTokens ? JSON.stringify(tokenOptionsFromData(reduceFieldsToValues(fields, true), props.tokenFieldTypes)) : "[]");
+	const tokenOptions = useMemo(() => JSON.parse(tokenJson), [tokenJson]);
+	const stored = Array.isArray(value) ? value.filter((entry) => typeof entry === "string" && entry.length > 0) : typeof value === "string" && value.length > 0 ? [value] : [];
+	const byValue = useMemo(() => {
+		const map = /* @__PURE__ */ new Map();
+		for (const option of [...presetOptions, ...tokenOptions]) map.set(option.value, option);
+		return map;
+	}, [presetOptions, tokenOptions]);
+	const selected = stored.map((entry) => byValue.get(entry) ?? {
+		label: entry,
+		value: entry
+	});
+	const groupedOptions = useMemo(() => {
+		const groups = [];
+		if (presetOptions.length > 0) groups.push({
+			label: t(keys.recipientsGroupDepartments),
+			options: presetOptions
+		});
+		if (tokenOptions.length > 0) groups.push({
+			label: t(keys.recipientsGroupFields),
+			options: tokenOptions
+		});
+		return groups;
+	}, [
+		presetOptions,
+		tokenOptions,
+		t
+	]);
+	const handleChange = (selection) => {
+		if (readOnly) return;
+		const entries = (Array.isArray(selection) ? selection : selection ? [selection] : []).map((option) => String(option.value).trim()).filter((entry) => entry.length > 0 && (isPlausibleEmail(entry) || byValue.has(entry)));
+		const deduped = /* @__PURE__ */ new Map();
+		for (const entry of entries) {
+			const key = entry.toLowerCase();
+			if (!deduped.has(key)) deduped.set(key, entry);
+		}
+		setValue(Array.from(deduped.values()));
+	};
+	const fieldStyle = props.field?.admin?.width ? { "--field-width": props.field.admin.width } : void 0;
+	return /* @__PURE__ */ jsxs("div", {
+		className: [
+			"field-type",
+			showError && "error",
+			readOnly && "read-only"
+		].filter(Boolean).join(" "),
+		id: path ? `field-${path.replace(/\./g, "__")}` : void 0,
+		style: {
+			marginBlockEnd: "1rem",
+			...fieldStyle
+		},
+		children: [
+			/* @__PURE__ */ jsx(RenderCustomComponent, {
+				CustomComponent: Label,
+				Fallback: /* @__PURE__ */ jsx(FieldLabel, {
+					label,
+					path,
+					required: props.field?.required
+				})
+			}),
+			/* @__PURE__ */ jsxs("div", {
+				className: "field-type__wrap",
+				children: [/* @__PURE__ */ jsx(RenderCustomComponent, {
+					CustomComponent: ErrorComponent,
+					Fallback: /* @__PURE__ */ jsx(FieldError, {
+						path,
+						showError
+					})
+				}), /* @__PURE__ */ jsx(ReactSelect, {
+					options: groupedOptions,
+					value: selected,
+					isMulti: true,
+					isSortable: true,
+					isCreatable: allowCustom,
+					isClearable: !readOnly,
+					disabled: readOnly,
+					isLoading: state.status === "loading",
+					showError,
+					placeholder: state.status === "loading" ? t(keys.endpointOptionsLoading) : void 0,
+					onChange: handleChange,
+					filterOption: (option, rawInput) => {
+						if (!option) return allowCustom && isPlausibleEmail(rawInput);
+						const query = rawInput.toLowerCase();
+						return `${option.label} ${option.value}`.toLowerCase().includes(query);
+					}
+				})]
+			}),
+			/* @__PURE__ */ jsx(RenderCustomComponent, {
+				CustomComponent: Description,
+				Fallback: /* @__PURE__ */ jsx(FieldDescription, {
+					description: state.status === "error" ? t(keys.endpointOptionsError) : description,
+					path
+				})
+			})
+		]
+	});
+};
+//#endregion
+export { RecipientsSelect };
+
+//# sourceMappingURL=RecipientsSelect.js.map

package/dist/client/RecipientsSelect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RecipientsSelect.js","names":["useTranslation"],"sources":["../../src/client/RecipientsSelect.tsx"],"sourcesContent":["'use client'\n\nimport {\n\tFieldDescription,\n\tFieldError,\n\tFieldLabel,\n\tReactSelect,\n\ttype ReactSelectOption,\n\tRenderCustomComponent,\n\tuseConfig,\n\tuseDocumentInfo,\n\tuseField,\n\tuseFormFields,\n} from '@payloadcms/ui'\nimport { reduceFieldsToValues } from 'payload/shared'\nimport { type CSSProperties, useEffect, useMemo, useState } from 'react'\nimport { isPlausibleEmail } from '../actions/emailRecipients'\nimport { fieldNames, fieldNamesOfType } from '../fields/fieldNamesOfType'\nimport { keys, type TranslationKey } from '../translations/keys'\nimport { useTranslation } from '../translations/useTranslation'\nimport {\n\tbuildEndpointOptionsUrl,\n\ttype EndpointOption,\n\tparseEndpointOptions,\n} from './endpointOptions'\nimport type { FieldRow } from './synthesizeClientField'\nimport { toStaticLabel } from './toStaticLabel'\n\nexport type RecipientsSelectProps = {\n\tpath?: string\n\tfield?: { label?: unknown; required?: boolean; admin?: { description?: unknown; width?: string } }\n\tlabel?: unknown\n\treadOnly?: boolean\n\t/** Endpoint subpath supplying preset address options (e.g. `'departments'`); omit for none. */\n\tendpoint?: string\n\t/** Allow free-typed emails (default true). */\n\tallowCustom?: boolean\n\t/** Offer the form's own fields as recipient tokens (default true). */\n\tfieldTokens?: boolean\n\t/** Field types eligible as tokens (default `['email']`). */\n\ttokenFieldTypes?: string[]\n\tdescriptionKey?: TranslationKey\n}\n\ntype FetchState =\n\t| { status: 'error' | 'idle' | 'loading' }\n\t| { status: 'loaded'; options: EndpointOption[] }\n\nconst tokenOptionsFromData = (\n\tdata: Record<string, unknown>,\n\ttypes?: string[]\n): ReactSelectOption[] => {\n\tconst rows = Array.isArray(data.fields) ? (data.fields as unknown[]) : []\n\tconst labels = new Map<string, string>()\n\tfor (const row of rows) {\n\t\tif (!row || typeof row !== 'object') {\n\t\t\tcontinue\n\t\t}\n\t\tconst { name, label } = row as FieldRow\n\t\tif (typeof name === 'string' && typeof label === 'string' && label.length > 0) {\n\t\t\tlabels.set(name.trim(), label)\n\t\t}\n\t}\n\tconst names =\n\t\ttypes && types.length > 0 ? fieldNamesOfType(data.fields, types) : fieldNames(data.fields)\n\treturn names.map((name) => ({ label: labels.get(name) ?? name, value: `{{${name}}}` }))\n}\n\n/**\n * A creatable, multi-value recipient field: pick a department (preset options from `endpoint`), pick a\n * form-field token (`{{field}}`, offered when `fieldTokens`), or type any email and press Enter\n * (`allowCustom`). Renders as native Payload badges (drag-reorderable), stores a `string[]`, honors\n * `admin.width` and the standard field props. Unknown or legacy stored values stay selectable.\n */\nexport const RecipientsSelect = (props: RecipientsSelectProps) => {\n\tconst allowCustom = props.allowCustom !== false\n\tconst fieldTokens = props.fieldTokens !== false\n\tconst {\n\t\tcustomComponents: { Description, Error: ErrorComponent, Label } = {},\n\t\tdisabled,\n\t\tpath,\n\t\tsetValue,\n\t\tshowError,\n\t\tvalue,\n\t} = useField<string[] | string>({ path: props.path })\n\tconst { t } = useTranslation()\n\tconst label = toStaticLabel(props.field?.label ?? props.label)\n\tconst description = props.descriptionKey\n\t\t? t(props.descriptionKey)\n\t\t: toStaticLabel(props.field?.admin?.description)\n\tconst { id, collectionSlug } = useDocumentInfo()\n\tconst { config } = useConfig()\n\tconst apiRoute = config.routes.api\n\tconst readOnly = props.readOnly === true || disabled === true\n\tconst [state, setState] = useState<FetchState>({ status: 'idle' })\n\n\tuseEffect(() => {\n\t\tif (!props.endpoint || id == null || !collectionSlug) {\n\t\t\treturn\n\t\t}\n\t\tconst controller = new AbortController()\n\t\tconst url = buildEndpointOptionsUrl({ apiRoute, collectionSlug, id, endpoint: props.endpoint })\n\t\tsetState({ status: 'loading' })\n\t\tfetch(url, {\n\t\t\tcredentials: 'include',\n\t\t\theaders: { Accept: 'application/json' },\n\t\t\tsignal: controller.signal,\n\t\t})\n\t\t\t.then(async (response) => {\n\t\t\t\tif (!response.ok) {\n\t\t\t\t\tthrow new Error(`Options request failed with ${response.status}`)\n\t\t\t\t}\n\t\t\t\tsetState({ status: 'loaded', options: parseEndpointOptions(await response.json()) })\n\t\t\t})\n\t\t\t.catch(() => {\n\t\t\t\tif (!controller.signal.aborted) {\n\t\t\t\t\tsetState({ status: 'error' })\n\t\t\t\t}\n\t\t\t})\n\t\treturn () => controller.abort()\n\t}, [apiRoute, collectionSlug, id, props.endpoint])\n\n\tconst presetOptions: ReactSelectOption[] = state.status === 'loaded' ? state.options : []\n\n\tconst tokenJson = useFormFields(([fields]) =>\n\t\tfieldTokens\n\t\t\t? JSON.stringify(\n\t\t\t\t\ttokenOptionsFromData(reduceFieldsToValues(fields, true), props.tokenFieldTypes)\n\t\t\t\t)\n\t\t\t: '[]'\n\t)\n\tconst tokenOptions = useMemo(() => JSON.parse(tokenJson) as ReactSelectOption[], [tokenJson])\n\n\tconst stored: string[] = Array.isArray(value)\n\t\t? value.filter((entry): entry is string => typeof entry === 'string' && entry.length > 0)\n\t\t: typeof value === 'string' && value.length > 0\n\t\t\t? [value]\n\t\t\t: []\n\n\tconst byValue = useMemo(() => {\n\t\tconst map = new Map<string, ReactSelectOption>()\n\t\tfor (const option of [...presetOptions, ...tokenOptions]) {\n\t\t\tmap.set(option.value as string, option)\n\t\t}\n\t\treturn map\n\t}, [presetOptions, tokenOptions])\n\n\tconst selected = stored.map((entry) => byValue.get(entry) ?? { label: entry, value: entry })\n\n\tconst groupedOptions = useMemo(() => {\n\t\tconst groups: { label: string; options: ReactSelectOption[] }[] = []\n\t\tif (presetOptions.length > 0) {\n\t\t\tgroups.push({ label: t(keys.recipientsGroupDepartments), options: presetOptions })\n\t\t}\n\t\tif (tokenOptions.length > 0) {\n\t\t\tgroups.push({ label: t(keys.recipientsGroupFields), options: tokenOptions })\n\t\t}\n\t\treturn groups\n\t}, [presetOptions, tokenOptions, t])\n\n\tconst handleChange = (selection: ReactSelectOption | ReactSelectOption[] | null) => {\n\t\tif (readOnly) {\n\t\t\treturn\n\t\t}\n\t\tconst chosen = Array.isArray(selection) ? selection : selection ? [selection] : []\n\t\tconst entries = chosen\n\t\t\t.map((option) => String(option.value).trim())\n\t\t\t.filter((entry) => entry.length > 0 && (isPlausibleEmail(entry) || byValue.has(entry)))\n\t\tconst deduped = new Map<string, string>()\n\t\tfor (const entry of entries) {\n\t\t\tconst key = entry.toLowerCase()\n\t\t\tif (!deduped.has(key)) {\n\t\t\t\tdeduped.set(key, entry)\n\t\t\t}\n\t\t}\n\t\tsetValue(Array.from(deduped.values()))\n\t}\n\n\tconst fieldStyle = props.field?.admin?.width\n\t\t? ({ '--field-width': props.field.admin.width } as CSSProperties)\n\t\t: undefined\n\n\treturn (\n\t\t<div\n\t\t\tclassName={['field-type', showError && 'error', readOnly && 'read-only']\n\t\t\t\t.filter(Boolean)\n\t\t\t\t.join(' ')}\n\t\t\tid={path ? `field-${path.replace(/\\./g, '__')}` : undefined}\n\t\t\tstyle={{ marginBlockEnd: '1rem', ...fieldStyle }}\n\t\t>\n\t\t\t<RenderCustomComponent\n\t\t\t\tCustomComponent={Label}\n\t\t\t\tFallback={<FieldLabel label={label} path={path} required={props.field?.required} />}\n\t\t\t/>\n\t\t\t<div className=\"field-type__wrap\">\n\t\t\t\t<RenderCustomComponent\n\t\t\t\t\tCustomComponent={ErrorComponent}\n\t\t\t\t\tFallback={<FieldError path={path} showError={showError} />}\n\t\t\t\t/>\n\t\t\t\t<ReactSelect\n\t\t\t\t\toptions={groupedOptions}\n\t\t\t\t\tvalue={selected}\n\t\t\t\t\tisMulti\n\t\t\t\t\tisSortable\n\t\t\t\t\tisCreatable={allowCustom}\n\t\t\t\t\tisClearable={!readOnly}\n\t\t\t\t\tdisabled={readOnly}\n\t\t\t\t\tisLoading={state.status === 'loading'}\n\t\t\t\t\tshowError={showError}\n\t\t\t\t\tplaceholder={state.status === 'loading' ? t(keys.endpointOptionsLoading) : undefined}\n\t\t\t\t\tonChange={handleChange}\n\t\t\t\t\tfilterOption={(option, rawInput) => {\n\t\t\t\t\t\tif (!option) {\n\t\t\t\t\t\t\treturn allowCustom && isPlausibleEmail(rawInput)\n\t\t\t\t\t\t}\n\t\t\t\t\t\tconst query = rawInput.toLowerCase()\n\t\t\t\t\t\treturn `${option.label} ${option.value}`.toLowerCase().includes(query)\n\t\t\t\t\t}}\n\t\t\t\t/>\n\t\t\t</div>\n\t\t\t<RenderCustomComponent\n\t\t\t\tCustomComponent={Description}\n\t\t\t\tFallback={\n\t\t\t\t\t<FieldDescription\n\t\t\t\t\t\tdescription={state.status === 'error' ? t(keys.endpointOptionsError) : description}\n\t\t\t\t\t\tpath={path}\n\t\t\t\t\t/>\n\t\t\t\t}\n\t\t\t/>\n\t\t</div>\n\t)\n}\n"],"mappings":"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"}

package/dist/client/RuleDescription.d.ts

@@ -0,0 +1,21 @@
+import { TranslationKey } from "../translations/keys.js";
+
+//#region src/client/RuleDescription.d.ts
+type RuleDescriptionProps = {
+  /**
+   * The rule's plain-language description as a translation key, resolved client-side. Payload has no
+   * native `Block` description slot and drops function `admin.description`, so the key travels as a
+   * clientProp and resolves here.
+   */
+  descriptionKey: TranslationKey;
+};
+/**
+ * Leading `field-description` paragraph at the top of a validation rule's config block, explaining in
+ * simple terms what makes the rule fail. Mounted as a `ui` field by `buildRuleBlocks`.
+ */
+declare const RuleDescription: ({
+  descriptionKey
+}: RuleDescriptionProps) => import("react/jsx-runtime").JSX.Element;
+//#endregion
+export { RuleDescription };
+//# sourceMappingURL=RuleDescription.d.ts.map

package/dist/client/RuleDescription.js

@@ -0,0 +1,19 @@
+"use client";
+import { useTranslation } from "../translations/useTranslation.js";
+import { jsx } from "react/jsx-runtime";
+//#region src/client/RuleDescription.tsx
+/**
+* Leading `field-description` paragraph at the top of a validation rule's config block, explaining in
+* simple terms what makes the rule fail. Mounted as a `ui` field by `buildRuleBlocks`.
+*/
+const RuleDescription = ({ descriptionKey }) => {
+	const { t } = useTranslation();
+	return /* @__PURE__ */ jsx("p", {
+		className: "field-description",
+		children: t(descriptionKey)
+	});
+};
+//#endregion
+export { RuleDescription };
+
+//# sourceMappingURL=RuleDescription.js.map

package/dist/client/RuleDescription.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"RuleDescription.js","names":[],"sources":["../../src/client/RuleDescription.tsx"],"sourcesContent":["'use client'\n\nimport type { TranslationKey } from '../translations/keys'\nimport { useTranslation } from '../translations/useTranslation'\n\nexport type RuleDescriptionProps = {\n\t/**\n\t * The rule's plain-language description as a translation key, resolved client-side. Payload has no\n\t * native `Block` description slot and drops function `admin.description`, so the key travels as a\n\t * clientProp and resolves here.\n\t */\n\tdescriptionKey: TranslationKey\n}\n\n/**\n * Leading `field-description` paragraph at the top of a validation rule's config block, explaining in\n * simple terms what makes the rule fail. Mounted as a `ui` field by `buildRuleBlocks`.\n */\nexport const RuleDescription = ({ descriptionKey }: RuleDescriptionProps) => {\n\tconst { t } = useTranslation()\n\treturn <p className=\"field-description\">{t(descriptionKey)}</p>\n}\n"],"mappings":";;;;;;;;AAkBA,MAAa,mBAAmB,EAAE,qBAA2C;CAC5E,MAAM,EAAE,MAAM,eAAe;CAC7B,OAAO,oBAAC,KAAD;EAAG,WAAU;YAAqB,EAAE,cAAc;CAAK,CAAA;AAC/D"}

package/dist/client/admin.css

@@ -232,3 +232,44 @@
 	flex-shrink: 0;
 	align-self: center;
 }
+
+/* Condensed array (host-placed department emails): flat [label, email] rows, no per-row collapsible.
+ * The 50/50 split reuses Payload's own --field-width variable, set from each subfield's admin.width. */
+.fb-condensed-array {
+	display: flex;
+	flex-direction: column;
+	gap: 0.5rem;
+	margin-block-end: 1rem;
+}
+.fb-condensed-array__rows {
+	display: flex;
+	flex-direction: column;
+	gap: 0.5rem;
+}
+.fb-condensed-array__row {
+	display: flex;
+	align-items: flex-end;
+	gap: 0.5rem;
+}
+.fb-condensed-array__fields {
+	flex: 1;
+	min-width: 0;
+	display: flex;
+	flex-wrap: wrap;
+	column-gap: 0.75rem;
+}
+.fb-condensed-array__fields > .field-type {
+	flex: 0 1 calc(var(--field-width, 50%) - 0.375rem);
+	min-width: 0;
+}
+.fb-condensed-array__remove {
+	flex-shrink: 0;
+	display: flex;
+	align-items: center;
+	/* Payload input height, so with the row's flex-end the button centers on the input, not the
+	 * taller label+input stack. */
+	height: 40px;
+}
+.fb-condensed-array__actions {
+	margin-block-start: 0.25rem;
+}

package/dist/client/endpointOptions.js

@@ -0,0 +1,29 @@
+import { formatAdminURL } from "payload/shared";
+//#region src/client/endpointOptions.ts
+/**
+* URL for a document-scoped collection endpoint (`{api}/{collection}/{id}/{endpoint}`), built the
+* way Payload's own admin components build fetch URLs: `formatAdminURL` over `config.routes.api`,
+* which handles a Next `basePath` and returns a same-origin relative URL so the admin cookie rides
+* along without CORS concerns.
+*/
+const buildEndpointOptionsUrl = (args) => formatAdminURL({
+	apiRoute: args.apiRoute,
+	path: `/${args.collectionSlug}/${encodeURIComponent(String(args.id))}/${args.endpoint.replace(/^\/+/, "")}`
+});
+/**
+* Narrow an endpoint response to `{ options }`. Entries without a string value are dropped and
+* labels fall back to the value; a body without an options array throws so the select surfaces its
+* error state instead of silently rendering empty.
+*/
+const parseEndpointOptions = (body) => {
+	const options = body != null && typeof body === "object" ? body.options : void 0;
+	if (!Array.isArray(options)) throw new Error("Malformed options response: expected { options: [] }");
+	return options.filter((option) => option != null && typeof option === "object" && typeof option.value === "string").map((option) => ({
+		value: option.value,
+		label: typeof option.label === "string" && option.label.length > 0 ? option.label : option.value
+	}));
+};
+//#endregion
+export { buildEndpointOptionsUrl, parseEndpointOptions };
+
+//# sourceMappingURL=endpointOptions.js.map

package/dist/client/endpointOptions.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"endpointOptions.js","names":[],"sources":["../../src/client/endpointOptions.ts"],"sourcesContent":["import { formatAdminURL } from 'payload/shared'\n\nexport type EndpointOption = { label: string; value: string }\n\n/**\n * URL for a document-scoped collection endpoint (`{api}/{collection}/{id}/{endpoint}`), built the\n * way Payload's own admin components build fetch URLs: `formatAdminURL` over `config.routes.api`,\n * which handles a Next `basePath` and returns a same-origin relative URL so the admin cookie rides\n * along without CORS concerns.\n */\nexport const buildEndpointOptionsUrl = (args: {\n\tapiRoute: string\n\tcollectionSlug: string\n\tid: number | string\n\tendpoint: string\n}): string =>\n\tformatAdminURL({\n\t\tapiRoute: args.apiRoute,\n\t\tpath: `/${args.collectionSlug}/${encodeURIComponent(String(args.id))}/${args.endpoint.replace(/^\\/+/, '')}`,\n\t})\n\n/**\n * Narrow an endpoint response to `{ options }`. Entries without a string value are dropped and\n * labels fall back to the value; a body without an options array throws so the select surfaces its\n * error state instead of silently rendering empty.\n */\nexport const parseEndpointOptions = (body: unknown): EndpointOption[] => {\n\tconst options =\n\t\tbody != null && typeof body === 'object' ? (body as { options?: unknown }).options : undefined\n\tif (!Array.isArray(options)) {\n\t\tthrow new Error('Malformed options response: expected { options: [] }')\n\t}\n\treturn options\n\t\t.filter(\n\t\t\t(option): option is { label?: unknown; value: string } =>\n\t\t\t\toption != null && typeof option === 'object' && typeof option.value === 'string'\n\t\t)\n\t\t.map((option) => ({\n\t\t\tvalue: option.value,\n\t\t\tlabel:\n\t\t\t\ttypeof option.label === 'string' && option.label.length > 0 ? option.label : option.value,\n\t\t}))\n}\n"],"mappings":";;;;;;;;AAUA,MAAa,2BAA2B,SAMvC,eAAe;CACd,UAAU,KAAK;CACf,MAAM,IAAI,KAAK,eAAe,GAAG,mBAAmB,OAAO,KAAK,EAAE,CAAC,EAAE,GAAG,KAAK,SAAS,QAAQ,QAAQ,EAAE;AACzG,CAAC;;;;;;AAOF,MAAa,wBAAwB,SAAoC;CACxE,MAAM,UACL,QAAQ,QAAQ,OAAO,SAAS,WAAY,KAA+B,UAAU,KAAA;CACtF,IAAI,CAAC,MAAM,QAAQ,OAAO,GACzB,MAAM,IAAI,MAAM,sDAAsD;CAEvE,OAAO,QACL,QACC,WACA,UAAU,QAAQ,OAAO,WAAW,YAAY,OAAO,OAAO,UAAU,QAC1E,EACC,KAAK,YAAY;EACjB,OAAO,OAAO;EACd,OACC,OAAO,OAAO,UAAU,YAAY,OAAO,MAAM,SAAS,IAAI,OAAO,QAAQ,OAAO;CACtF,EAAE;AACJ"}

package/dist/client/flowAuthoring.js

@@ -1,6 +1,92 @@
+import { END_OF_FORM } from "../flow/types.js";
 import "../flow/stepLabel.js";
 //#region src/client/flowAuthoring.ts
-/** Field name to index of the step holding it (first occurrence wins). */
+/** Project a step's stored `next` onto its select option value ('' = sequential fall-through). */
+const nextToSelectValue = (next) => next === null ? END_OF_FORM : next ?? "";
+/** Parse a select option value back into a stored `next` (undefined = sequential fall-through). */
+const nextFromSelectValue = (value) => value === "__end__" ? null : value.length > 0 ? value : void 0;
+/**
+* One option per step, labeled like its step card. A step whose id is empty is dropped: the id is
+* the option's value, so such a step cannot be routed to and an empty value would collide with the
+* next select's sequential option.
+*/
+const stepSelectOptions = (steps, labels) => steps.map((step, index) => ({
+	label: labels[index] ?? "",
+	value: step.id
+})).filter((option) => option.value.length > 0);
+/** Every step but `stepId`, so a step's own next/transition selects cannot route it to itself. */
+const otherStepSelectOptions = (options, stepId) => options.filter((option) => option.value !== stepId);
+/**
+* The `next` select's options: sequential fall-through first (the default, and what an absent
+* `next` maps to), then explicit end of form, then every other step. Values round-trip through
+* `nextFromSelectValue`.
+*/
+const nextSelectOptions = (args) => [
+	{
+		label: args.sequentialLabel,
+		value: ""
+	},
+	{
+		label: args.terminalLabel,
+		value: END_OF_FORM
+	},
+	...args.otherSteps
+];
+const isRecord = (value) => value != null && typeof value === "object" && !Array.isArray(value);
+/** Chars kept before truncating a `messageSnippet` result, plus a trailing ellipsis. */
+const MESSAGE_SNIPPET_LENGTH = 40;
+/**
+* Short plain-text preview of a bare message block's richText content, for the flow step list.
+* Reads only the shallow lexical shape (`root.children[].children[].text`), which is all a short
+* authored message needs; a legacy Slate body or other non-lexical shape yields `undefined`, same
+* as empty content, so the caller falls back to the block type's display label.
+*/
+const messageSnippet = (content) => {
+	const root = isRecord(content) ? content.root : void 0;
+	const text = (isRecord(root) && Array.isArray(root.children) ? root.children : []).map((block) => {
+		return (isRecord(block) && Array.isArray(block.children) ? block.children : []).map((leaf) => isRecord(leaf) && typeof leaf.text === "string" ? leaf.text : "").join("");
+	}).join(" ").replace(/\s+/g, " ").trim();
+	if (text.length === 0) return;
+	return text.length > MESSAGE_SNIPPET_LENGTH ? `${text.slice(0, MESSAGE_SNIPPET_LENGTH).trimEnd()}…` : text;
+};
+/**
+* Project the form's field rows into flow entries. Named rows are keyed by their trimmed name and
+* labeled with their configured `label`, falling back to the name when unset. Nameless rows of a
+* bare type are keyed by their block row id and labeled with a snippet of their content when they
+* have any (see `messageSnippet`), else the type's display label (numbered in form order when the
+* type occurs more than once). Rows with neither a usable name nor a bare-type row id are not
+* addressable and are skipped.
+*/
+const flowFieldEntries = (rows, bareTypeLabels) => {
+	const isBareRow = (row) => bareTypeLabels[row.blockType] !== void 0 && row.id != null;
+	const nameOf = (row) => typeof row.name === "string" ? row.name.trim() : "";
+	const bareTotals = /* @__PURE__ */ new Map();
+	for (const row of rows) if (nameOf(row).length === 0 && isBareRow(row)) bareTotals.set(row.blockType, (bareTotals.get(row.blockType) ?? 0) + 1);
+	const bareSeen = /* @__PURE__ */ new Map();
+	const entries = [];
+	for (const row of rows) {
+		const name = nameOf(row);
+		if (name.length > 0) {
+			const label = typeof row.label === "string" && row.label.trim().length > 0 ? row.label : name;
+			entries.push({
+				key: name,
+				label
+			});
+			continue;
+		}
+		if (!isBareRow(row)) continue;
+		const typeLabel = bareTypeLabels[row.blockType] ?? row.blockType;
+		const n = (bareSeen.get(row.blockType) ?? 0) + 1;
+		bareSeen.set(row.blockType, n);
+		const fallback = (bareTotals.get(row.blockType) ?? 0) > 1 ? `${typeLabel} ${n}` : typeLabel;
+		entries.push({
+			key: String(row.id),
+			label: messageSnippet(row.content) ?? fallback
+		});
+	}
+	return entries;
+};
+/** Field key to index of the step holding it (first occurrence wins). */
 const fieldHolders = (steps) => {
 	const holders = /* @__PURE__ */ new Map();
 	steps.forEach((step, index) => {
@@ -8,12 +94,12 @@ const fieldHolders = (steps) => {
 	});
 	return holders;
 };
-/** Form fields not assigned to any step, in form order. */
-const unassignedFields = (fieldNames, steps) => {
+/** Entries not assigned to any step, in form order. */
+const unassignedEntries = (entries, steps) => {
 	const assigned = new Set(steps.flatMap((step) => step.fields));
-	return fieldNames.filter((name) => !assigned.has(name));
+	return entries.filter((entry) => !assigned.has(entry.key));
 };
-/** Assign a field to the step at `targetIndex`, stripping it from every other step. */
+/** Assign a field key to the step at `targetIndex`, stripping it from every other step. */
 const assignFieldToStep = (steps, targetIndex, field) => steps.map((step, index) => {
 	if (index === targetIndex) return step.fields.includes(field) ? step : {
 		...step,
@@ -24,12 +110,33 @@ const assignFieldToStep = (steps, targetIndex, field) => steps.map((step, index)
 		fields: step.fields.filter((f) => f !== field)
 	} : step;
 });
-/** Remove a field from the step at `targetIndex`, leaving other steps untouched. */
+/** Remove a field key from the step at `targetIndex`, leaving other steps untouched. */
 const removeFieldFromStep = (steps, targetIndex, field) => steps.map((step, index) => index === targetIndex && step.fields.includes(field) ? {
 	...step,
 	fields: step.fields.filter((f) => f !== field)
 } : step);
+/**
+* Remove the step at `index` and every reference to it: another step's `next` pointing at it
+* returns to absent (sequential fall-through), and transitions targeting it are dropped. Without
+* the cascade a dangling `next` would silently route into whatever step follows it in the array.
+*/
+const removeStepCascade = (steps, index) => {
+	const removed = steps[index];
+	const rest = steps.filter((_, i) => i !== index);
+	if (!removed) return rest;
+	return rest.map((step) => {
+		const keptTransitions = (step.transitions ?? []).filter((t) => t.to !== removed.id);
+		const dropsNext = step.next === removed.id;
+		const dropsTransitions = keptTransitions.length !== (step.transitions?.length ?? 0);
+		if (!dropsNext && !dropsTransitions) return step;
+		const { next, transitions, ...base } = step;
+		const cleaned = { ...base };
+		if (!dropsNext && next !== void 0) cleaned.next = next;
+		if (keptTransitions.length > 0) cleaned.transitions = keptTransitions;
+		return cleaned;
+	});
+};
 //#endregion
-export { assignFieldToStep, fieldHolders, removeFieldFromStep, unassignedFields };
+export { assignFieldToStep, fieldHolders, flowFieldEntries, nextFromSelectValue, nextSelectOptions, nextToSelectValue, otherStepSelectOptions, removeFieldFromStep, removeStepCascade, stepSelectOptions, unassignedEntries };
 
 //# sourceMappingURL=flowAuthoring.js.map

package/dist/client/flowAuthoring.js.map

@@ -1 +1 @@
-{"version":3,"file":"flowAuthoring.js","names":[],"sources":["../../src/client/flowAuthoring.ts"],"sourcesContent":["import type { FlowStep } from '../flow/types'\n\nexport { stepLabel } from '../flow/stepLabel'\n\n/** Field name to index of the step holding it (first occurrence wins). */\nexport const fieldHolders = (steps: Pick<FlowStep, 'fields'>[]): Map<string, number> => {\n\tconst holders = new Map<string, number>()\n\tsteps.forEach((step, index) => {\n\t\tfor (const field of step.fields) {\n\t\t\tif (!holders.has(field)) holders.set(field, index)\n\t\t}\n\t})\n\treturn holders\n}\n\n/** Form fields not assigned to any step, in form order. */\nexport const unassignedFields = (\n\tfieldNames: string[],\n\tsteps: Pick<FlowStep, 'fields'>[]\n): string[] => {\n\tconst assigned = new Set(steps.flatMap((step) => step.fields))\n\treturn fieldNames.filter((name) => !assigned.has(name))\n}\n\n/** Assign a field to the step at `targetIndex`, stripping it from every other step. */\nexport const assignFieldToStep = (\n\tsteps: FlowStep[],\n\ttargetIndex: number,\n\tfield: string\n): FlowStep[] =>\n\tsteps.map((step, index) => {\n\t\tif (index === targetIndex) {\n\t\t\treturn step.fields.includes(field) ? step : { ...step, fields: [...step.fields, field] }\n\t\t}\n\t\treturn step.fields.includes(field)\n\t\t\t? { ...step, fields: step.fields.filter((f) => f !== field) }\n\t\t\t: step\n\t})\n\n/** Remove a field from the step at `targetIndex`, leaving other steps untouched. */\nexport const removeFieldFromStep = (\n\tsteps: FlowStep[],\n\ttargetIndex: number,\n\tfield: string\n): FlowStep[] =>\n\tsteps.map((step, index) =>\n\t\tindex === targetIndex && step.fields.includes(field)\n\t\t\t? { ...step, fields: step.fields.filter((f) => f !== field) }\n\t\t\t: step\n\t)\n"],"mappings":";;;AAKA,MAAa,gBAAgB,UAA2D;CACvF,MAAM,0BAAU,IAAI,IAAoB;CACxC,MAAM,SAAS,MAAM,UAAU;EAC9B,KAAK,MAAM,SAAS,KAAK,QACxB,IAAI,CAAC,QAAQ,IAAI,KAAK,GAAG,QAAQ,IAAI,OAAO,KAAK;CAEnD,CAAC;CACD,OAAO;AACR;;AAGA,MAAa,oBACZ,YACA,UACc;CACd,MAAM,WAAW,IAAI,IAAI,MAAM,SAAS,SAAS,KAAK,MAAM,CAAC;CAC7D,OAAO,WAAW,QAAQ,SAAS,CAAC,SAAS,IAAI,IAAI,CAAC;AACvD;;AAGA,MAAa,qBACZ,OACA,aACA,UAEA,MAAM,KAAK,MAAM,UAAU;CAC1B,IAAI,UAAU,aACb,OAAO,KAAK,OAAO,SAAS,KAAK,IAAI,OAAO;EAAE,GAAG;EAAM,QAAQ,CAAC,GAAG,KAAK,QAAQ,KAAK;CAAE;CAExF,OAAO,KAAK,OAAO,SAAS,KAAK,IAC9B;EAAE,GAAG;EAAM,QAAQ,KAAK,OAAO,QAAQ,MAAM,MAAM,KAAK;CAAE,IAC1D;AACJ,CAAC;;AAGF,MAAa,uBACZ,OACA,aACA,UAEA,MAAM,KAAK,MAAM,UAChB,UAAU,eAAe,KAAK,OAAO,SAAS,KAAK,IAChD;CAAE,GAAG;CAAM,QAAQ,KAAK,OAAO,QAAQ,MAAM,MAAM,KAAK;AAAE,IAC1D,IACJ"}
+{"version":3,"file":"flowAuthoring.js","names":[],"sources":["../../src/client/flowAuthoring.ts"],"sourcesContent":["import { END_OF_FORM, type FlowStep } from '../flow/types'\nimport type { FieldRow } from './synthesizeClientField'\n\nexport { stepLabel } from '../flow/stepLabel'\nexport { END_OF_FORM }\n\n/** Project a step's stored `next` onto its select option value ('' = sequential fall-through). */\nexport const nextToSelectValue = (next: FlowStep['next']): string =>\n\tnext === null ? END_OF_FORM : (next ?? '')\n\n/** Parse a select option value back into a stored `next` (undefined = sequential fall-through). */\nexport const nextFromSelectValue = (value: string): FlowStep['next'] =>\n\tvalue === END_OF_FORM ? null : value.length > 0 ? value : undefined\n\n/** A form field as the flow builder addresses it: its stable key plus a display label. */\nexport type FlowFieldEntry = { key: string; label: string }\n\n/** A flow builder select option. Structurally a `ReactSelectOption`, without the client-only import. */\nexport type FlowSelectOption = { label: string; value: string }\n\n/**\n * One option per step, labeled like its step card. A step whose id is empty is dropped: the id is\n * the option's value, so such a step cannot be routed to and an empty value would collide with the\n * next select's sequential option.\n */\nexport const stepSelectOptions = (\n\tsteps: Pick<FlowStep, 'id'>[],\n\tlabels: string[]\n): FlowSelectOption[] =>\n\tsteps\n\t\t.map((step, index) => ({ label: labels[index] ?? '', value: step.id }))\n\t\t.filter((option) => option.value.length > 0)\n\n/** Every step but `stepId`, so a step's own next/transition selects cannot route it to itself. */\nexport const otherStepSelectOptions = (\n\toptions: FlowSelectOption[],\n\tstepId: string\n): FlowSelectOption[] => options.filter((option) => option.value !== stepId)\n\n/**\n * The `next` select's options: sequential fall-through first (the default, and what an absent\n * `next` maps to), then explicit end of form, then every other step. Values round-trip through\n * `nextFromSelectValue`.\n */\nexport const nextSelectOptions = (args: {\n\tsequentialLabel: string\n\tterminalLabel: string\n\totherSteps: FlowSelectOption[]\n}): FlowSelectOption[] => [\n\t{ label: args.sequentialLabel, value: '' },\n\t{ label: args.terminalLabel, value: END_OF_FORM },\n\t...args.otherSteps,\n]\n\nconst isRecord = (value: unknown): value is Record<string, unknown> =>\n\tvalue != null && typeof value === 'object' && !Array.isArray(value)\n\n/** Chars kept before truncating a `messageSnippet` result, plus a trailing ellipsis. */\nconst MESSAGE_SNIPPET_LENGTH = 40\n\n/**\n * Short plain-text preview of a bare message block's richText content, for the flow step list.\n * Reads only the shallow lexical shape (`root.children[].children[].text`), which is all a short\n * authored message needs; a legacy Slate body or other non-lexical shape yields `undefined`, same\n * as empty content, so the caller falls back to the block type's display label.\n */\nexport const messageSnippet = (content: unknown): string | undefined => {\n\tconst root = isRecord(content) ? content.root : undefined\n\tconst blockNodes = isRecord(root) && Array.isArray(root.children) ? root.children : []\n\tconst text = blockNodes\n\t\t.map((block) => {\n\t\t\tconst leaves = isRecord(block) && Array.isArray(block.children) ? block.children : []\n\t\t\treturn leaves\n\t\t\t\t.map((leaf) => (isRecord(leaf) && typeof leaf.text === 'string' ? leaf.text : ''))\n\t\t\t\t.join('')\n\t\t})\n\t\t.join(' ')\n\t\t.replace(/\\s+/g, ' ')\n\t\t.trim()\n\tif (text.length === 0) {\n\t\treturn undefined\n\t}\n\treturn text.length > MESSAGE_SNIPPET_LENGTH\n\t\t? `${text.slice(0, MESSAGE_SNIPPET_LENGTH).trimEnd()}…`\n\t\t: text\n}\n\n/**\n * Project the form's field rows into flow entries. Named rows are keyed by their trimmed name and\n * labeled with their configured `label`, falling back to the name when unset. Nameless rows of a\n * bare type are keyed by their block row id and labeled with a snippet of their content when they\n * have any (see `messageSnippet`), else the type's display label (numbered in form order when the\n * type occurs more than once). Rows with neither a usable name nor a bare-type row id are not\n * addressable and are skipped.\n */\nexport const flowFieldEntries = (\n\trows: FieldRow[],\n\tbareTypeLabels: Record<string, string>\n): FlowFieldEntry[] => {\n\tconst isBareRow = (row: FieldRow): boolean =>\n\t\tbareTypeLabels[row.blockType] !== undefined && row.id != null\n\tconst nameOf = (row: FieldRow): string => (typeof row.name === 'string' ? row.name.trim() : '')\n\n\tconst bareTotals = new Map<string, number>()\n\tfor (const row of rows) {\n\t\tif (nameOf(row).length === 0 && isBareRow(row)) {\n\t\t\tbareTotals.set(row.blockType, (bareTotals.get(row.blockType) ?? 0) + 1)\n\t\t}\n\t}\n\n\tconst bareSeen = new Map<string, number>()\n\tconst entries: FlowFieldEntry[] = []\n\tfor (const row of rows) {\n\t\tconst name = nameOf(row)\n\t\tif (name.length > 0) {\n\t\t\tconst label = typeof row.label === 'string' && row.label.trim().length > 0 ? row.label : name\n\t\t\tentries.push({ key: name, label })\n\t\t\tcontinue\n\t\t}\n\t\tif (!isBareRow(row)) {\n\t\t\tcontinue\n\t\t}\n\t\tconst typeLabel = bareTypeLabels[row.blockType] ?? row.blockType\n\t\tconst n = (bareSeen.get(row.blockType) ?? 0) + 1\n\t\tbareSeen.set(row.blockType, n)\n\t\tconst fallback = (bareTotals.get(row.blockType) ?? 0) > 1 ? `${typeLabel} ${n}` : typeLabel\n\t\tentries.push({ key: String(row.id), label: messageSnippet(row.content) ?? fallback })\n\t}\n\treturn entries\n}\n\n/** Field key to index of the step holding it (first occurrence wins). */\nexport const fieldHolders = (steps: Pick<FlowStep, 'fields'>[]): Map<string, number> => {\n\tconst holders = new Map<string, number>()\n\tsteps.forEach((step, index) => {\n\t\tfor (const field of step.fields) {\n\t\t\tif (!holders.has(field)) holders.set(field, index)\n\t\t}\n\t})\n\treturn holders\n}\n\n/** Entries not assigned to any step, in form order. */\nexport const unassignedEntries = (\n\tentries: FlowFieldEntry[],\n\tsteps: Pick<FlowStep, 'fields'>[]\n): FlowFieldEntry[] => {\n\tconst assigned = new Set(steps.flatMap((step) => step.fields))\n\treturn entries.filter((entry) => !assigned.has(entry.key))\n}\n\n/** Assign a field key to the step at `targetIndex`, stripping it from every other step. */\nexport const assignFieldToStep = (\n\tsteps: FlowStep[],\n\ttargetIndex: number,\n\tfield: string\n): FlowStep[] =>\n\tsteps.map((step, index) => {\n\t\tif (index === targetIndex) {\n\t\t\treturn step.fields.includes(field) ? step : { ...step, fields: [...step.fields, field] }\n\t\t}\n\t\treturn step.fields.includes(field)\n\t\t\t? { ...step, fields: step.fields.filter((f) => f !== field) }\n\t\t\t: step\n\t})\n\n/** Remove a field key from the step at `targetIndex`, leaving other steps untouched. */\nexport const removeFieldFromStep = (\n\tsteps: FlowStep[],\n\ttargetIndex: number,\n\tfield: string\n): FlowStep[] =>\n\tsteps.map((step, index) =>\n\t\tindex === targetIndex && step.fields.includes(field)\n\t\t\t? { ...step, fields: step.fields.filter((f) => f !== field) }\n\t\t\t: step\n\t)\n\n/**\n * Remove the step at `index` and every reference to it: another step's `next` pointing at it\n * returns to absent (sequential fall-through), and transitions targeting it are dropped. Without\n * the cascade a dangling `next` would silently route into whatever step follows it in the array.\n */\nexport const removeStepCascade = (steps: FlowStep[], index: number): FlowStep[] => {\n\tconst removed = steps[index]\n\tconst rest = steps.filter((_, i) => i !== index)\n\tif (!removed) {\n\t\treturn rest\n\t}\n\treturn rest.map((step) => {\n\t\tconst keptTransitions = (step.transitions ?? []).filter((t) => t.to !== removed.id)\n\t\tconst dropsNext = step.next === removed.id\n\t\tconst dropsTransitions = keptTransitions.length !== (step.transitions?.length ?? 0)\n\t\tif (!dropsNext && !dropsTransitions) {\n\t\t\treturn step\n\t\t}\n\t\tconst { next, transitions, ...base } = step\n\t\tconst cleaned: FlowStep = { ...base }\n\t\tif (!dropsNext && next !== undefined) cleaned.next = next\n\t\tif (keptTransitions.length > 0) cleaned.transitions = keptTransitions\n\t\treturn cleaned\n\t})\n}\n"],"mappings":"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"}

package/dist/client/synthesizeClientField.js

@@ -1,3 +1,4 @@
+import { fixedFieldOptions } from "../fields/data/regions.js";
 //#region src/client/synthesizeClientField.ts
 /**
 * Project a stored field row into a condition operand, or `null` when the row has no usable name or
@@ -12,37 +13,43 @@ const operandFromRow = (row, conditionTypes) => {
 		name,
 		label: typeof row.label === "string" && row.label.length > 0 ? row.label : name,
 		conditionType,
-		options: Array.isArray(row.options) ? row.options : void 0
+		options: Array.isArray(row.options) ? row.options : fixedFieldOptions(row.blockType)
 	};
 };
 /**
 * Build the minimal `*FieldClient` a Payload leaf condition input requires for a given operand. Casts
 * are localized to these four synths and nowhere else: `FieldBaseClient` requires only `name`, and each
 * leaf is `FieldBaseClient & Pick<…, 'type' | …>` where every picked member but `type` (and `select`'s
-* required `options`) is optional, so the literals are structurally complete. `dateClientField` omits
-* `admin.date`, so `DateCondition` falls back to its default date format. Each synth returns a single
-* concrete client type so leaf `field` props need no narrowing.
+* required `options`) is optional, so the literals are structurally complete. Every synth carries an
+* `admin: {}` because Payload's `Select` and `Date` leaf inputs read `field.admin.placeholder`
+* unguarded and throw on a missing `admin`; the empty object also leaves `admin.date` unset, so
+* `DateCondition` still falls back to its default date format. Each synth returns a single concrete
+* client type so leaf `field` props need no narrowing.
 */
 const textClientField = (operand) => ({
 	name: operand.name,
 	label: operand.label,
-	type: "text"
+	type: "text",
+	admin: {}
 });
 const numberClientField = (operand) => ({
 	name: operand.name,
 	label: operand.label,
-	type: "number"
+	type: "number",
+	admin: {}
 });
 const dateClientField = (operand) => ({
 	name: operand.name,
 	label: operand.label,
-	type: "date"
+	type: "date",
+	admin: {}
 });
 const selectClientField = (operand) => ({
 	name: operand.name,
 	label: operand.label,
 	type: "select",
-	options: operand.options ?? []
+	options: operand.options ?? [],
+	admin: {}
 });
 //#endregion
 export { dateClientField, numberClientField, operandFromRow, selectClientField, textClientField };

package/dist/client/synthesizeClientField.js.map

@@ -1 +1 @@
-{"version":3,"file":"synthesizeClientField.js","names":[],"sources":["../../src/client/synthesizeClientField.ts"],"sourcesContent":["import type {\n\tDateFieldClient,\n\tNumberFieldClient,\n\tOption,\n\tSelectFieldClient,\n\tTextFieldClient,\n} from 'payload'\nimport type { ConditionFieldType } from '../conditions/fieldTypes'\n\n/** A field row as stored in the form's `fields` blocks array (only the keys the builder reads). */\nexport type FieldRow = {\n\tblockType: string\n\tname?: string\n\tlabel?: string\n\toptions?: Option[]\n\t[key: string]: unknown\n}\n\n/** A condition operand: a selectable form field the builder can compare against. */\nexport type ConditionOperand = {\n\tname: string\n\tlabel: string\n\tconditionType: ConditionFieldType\n\toptions?: Option[]\n}\n\n/**\n * Project a stored field row into a condition operand, or `null` when the row has no usable name or\n * its type is absent from the condition-type map (not conditionable, e.g. a display-only message).\n */\nexport const operandFromRow = (\n\trow: FieldRow,\n\tconditionTypes: Record<string, ConditionFieldType>\n): ConditionOperand | null => {\n\tconst name = typeof row.name === 'string' ? row.name.trim() : ''\n\tif (name.length === 0) {\n\t\treturn null\n\t}\n\tconst conditionType = conditionTypes[row.blockType]\n\tif (!conditionType) {\n\t\treturn null\n\t}\n\treturn {\n\t\tname,\n\t\tlabel: typeof row.label === 'string' && row.label.length > 0 ? row.label : name,\n\t\tconditionType,\n\t\toptions: Array.isArray(row.options) ? row.options : undefined,\n\t}\n}\n\n/**\n * Build the minimal `*FieldClient` a Payload leaf condition input requires for a given operand. Casts\n * are localized to these four synths and nowhere else: `FieldBaseClient` requires only `name`, and each\n * leaf is `FieldBaseClient & Pick<…, 'type' | …>` where every picked member but `type` (and `select`'s\n * required `options`) is optional, so the literals are structurally complete. `dateClientField` omits\n * `admin.date`, so `DateCondition` falls back to its default date format. Each synth returns a single\n * concrete client type so leaf `field` props need no narrowing.\n */\nexport const textClientField = (operand: ConditionOperand): TextFieldClient =>\n\t({ name: operand.name, label: operand.label, type: 'text' }) as TextFieldClient\n\nexport const numberClientField = (operand: ConditionOperand): NumberFieldClient =>\n\t({ name: operand.name, label: operand.label, type: 'number' }) as NumberFieldClient\n\nexport const dateClientField = (operand: ConditionOperand): DateFieldClient =>\n\t({ name: operand.name, label: operand.label, type: 'date' }) as DateFieldClient\n\nexport const selectClientField = (operand: ConditionOperand): SelectFieldClient =>\n\t({\n\t\tname: operand.name,\n\t\tlabel: operand.label,\n\t\ttype: 'select',\n\t\toptions: operand.options ?? [],\n\t}) as SelectFieldClient\n"],"mappings":";;;;;AA8BA,MAAa,kBACZ,KACA,mBAC6B;CAC7B,MAAM,OAAO,OAAO,IAAI,SAAS,WAAW,IAAI,KAAK,KAAK,IAAI;CAC9D,IAAI,KAAK,WAAW,GACnB,OAAO;CAER,MAAM,gBAAgB,eAAe,IAAI;CACzC,IAAI,CAAC,eACJ,OAAO;CAER,OAAO;EACN;EACA,OAAO,OAAO,IAAI,UAAU,YAAY,IAAI,MAAM,SAAS,IAAI,IAAI,QAAQ;EAC3E;EACA,SAAS,MAAM,QAAQ,IAAI,OAAO,IAAI,IAAI,UAAU,KAAA;CACrD;AACD;;;;;;;;;AAUA,MAAa,mBAAmB,aAC9B;CAAE,MAAM,QAAQ;CAAM,OAAO,QAAQ;CAAO,MAAM;AAAO;AAE3D,MAAa,qBAAqB,aAChC;CAAE,MAAM,QAAQ;CAAM,OAAO,QAAQ;CAAO,MAAM;AAAS;AAE7D,MAAa,mBAAmB,aAC9B;CAAE,MAAM,QAAQ;CAAM,OAAO,QAAQ;CAAO,MAAM;AAAO;AAE3D,MAAa,qBAAqB,aAChC;CACA,MAAM,QAAQ;CACd,OAAO,QAAQ;CACf,MAAM;CACN,SAAS,QAAQ,WAAW,CAAC;AAC9B"}
+{"version":3,"file":"synthesizeClientField.js","names":[],"sources":["../../src/client/synthesizeClientField.ts"],"sourcesContent":["import type {\n\tDateFieldClient,\n\tNumberFieldClient,\n\tOption,\n\tSelectFieldClient,\n\tTextFieldClient,\n} from 'payload'\nimport type { ConditionFieldType } from '../conditions/fieldTypes'\nimport { fixedFieldOptions } from '../fields/data/regions'\n\n/** A field row as stored in the form's `fields` blocks array (only the keys the builder reads). */\nexport type FieldRow = {\n\tblockType: string\n\tname?: string\n\tlabel?: string\n\toptions?: Option[]\n\t/** A bare message block's richText body; see `messageSnippet`. */\n\tcontent?: unknown\n\t[key: string]: unknown\n}\n\n/** A condition operand: a selectable form field the builder can compare against. */\nexport type ConditionOperand = {\n\tname: string\n\tlabel: string\n\tconditionType: ConditionFieldType\n\toptions?: Option[]\n}\n\n/**\n * Project a stored field row into a condition operand, or `null` when the row has no usable name or\n * its type is absent from the condition-type map (not conditionable, e.g. a display-only message).\n */\nexport const operandFromRow = (\n\trow: FieldRow,\n\tconditionTypes: Record<string, ConditionFieldType>\n): ConditionOperand | null => {\n\tconst name = typeof row.name === 'string' ? row.name.trim() : ''\n\tif (name.length === 0) {\n\t\treturn null\n\t}\n\tconst conditionType = conditionTypes[row.blockType]\n\tif (!conditionType) {\n\t\treturn null\n\t}\n\treturn {\n\t\tname,\n\t\tlabel: typeof row.label === 'string' && row.label.length > 0 ? row.label : name,\n\t\tconditionType,\n\t\t// Country/state author no options but are `select`-typed conditions, so offer their fixed set.\n\t\toptions: Array.isArray(row.options) ? row.options : fixedFieldOptions(row.blockType),\n\t}\n}\n\n/**\n * Build the minimal `*FieldClient` a Payload leaf condition input requires for a given operand. Casts\n * are localized to these four synths and nowhere else: `FieldBaseClient` requires only `name`, and each\n * leaf is `FieldBaseClient & Pick<…, 'type' | …>` where every picked member but `type` (and `select`'s\n * required `options`) is optional, so the literals are structurally complete. Every synth carries an\n * `admin: {}` because Payload's `Select` and `Date` leaf inputs read `field.admin.placeholder`\n * unguarded and throw on a missing `admin`; the empty object also leaves `admin.date` unset, so\n * `DateCondition` still falls back to its default date format. Each synth returns a single concrete\n * client type so leaf `field` props need no narrowing.\n */\nexport const textClientField = (operand: ConditionOperand): TextFieldClient =>\n\t({ name: operand.name, label: operand.label, type: 'text', admin: {} }) as TextFieldClient\n\nexport const numberClientField = (operand: ConditionOperand): NumberFieldClient =>\n\t({ name: operand.name, label: operand.label, type: 'number', admin: {} }) as NumberFieldClient\n\nexport const dateClientField = (operand: ConditionOperand): DateFieldClient =>\n\t({ name: operand.name, label: operand.label, type: 'date', admin: {} }) as DateFieldClient\n\nexport const selectClientField = (operand: ConditionOperand): SelectFieldClient =>\n\t({\n\t\tname: operand.name,\n\t\tlabel: operand.label,\n\t\ttype: 'select',\n\t\toptions: operand.options ?? [],\n\t\tadmin: {},\n\t}) as SelectFieldClient\n"],"mappings":";;;;;;AAiCA,MAAa,kBACZ,KACA,mBAC6B;CAC7B,MAAM,OAAO,OAAO,IAAI,SAAS,WAAW,IAAI,KAAK,KAAK,IAAI;CAC9D,IAAI,KAAK,WAAW,GACnB,OAAO;CAER,MAAM,gBAAgB,eAAe,IAAI;CACzC,IAAI,CAAC,eACJ,OAAO;CAER,OAAO;EACN;EACA,OAAO,OAAO,IAAI,UAAU,YAAY,IAAI,MAAM,SAAS,IAAI,IAAI,QAAQ;EAC3E;EAEA,SAAS,MAAM,QAAQ,IAAI,OAAO,IAAI,IAAI,UAAU,kBAAkB,IAAI,SAAS;CACpF;AACD;;;;;;;;;;;AAYA,MAAa,mBAAmB,aAC9B;CAAE,MAAM,QAAQ;CAAM,OAAO,QAAQ;CAAO,MAAM;CAAQ,OAAO,CAAC;AAAE;AAEtE,MAAa,qBAAqB,aAChC;CAAE,MAAM,QAAQ;CAAM,OAAO,QAAQ;CAAO,MAAM;CAAU,OAAO,CAAC;AAAE;AAExE,MAAa,mBAAmB,aAC9B;CAAE,MAAM,QAAQ;CAAM,OAAO,QAAQ;CAAO,MAAM;CAAQ,OAAO,CAAC;AAAE;AAEtE,MAAa,qBAAqB,aAChC;CACA,MAAM,QAAQ;CACd,OAAO,QAAQ;CACf,MAAM;CACN,SAAS,QAAQ,WAAW,CAAC;CAC7B,OAAO,CAAC;AACT"}

package/dist/collections/buttonFields.d.ts

@@ -0,0 +1,34 @@
+import { Field } from "payload";
+
+//#region src/collections/buttonFields.d.ts
+/** The default button-label fields, keyed by button. What the `buttons.fields` seam receives. */
+type DefaultButtonFields = {
+  submit: Field;
+  prev: Field;
+  next: Field;
+};
+/**
+ * Composes the three form-level button fields. Receives the defaults with the content localization
+ * flag already applied and returns the field for each slot; the collection places `submit` at the
+ * bottom of the Fields tab and `prev`/`next` in a row on the Flow tab. Any slot may return the
+ * default, a replacement, or the default wrapped in a `row` alongside a host field (e.g. an icon
+ * select), so adjacent fields ride along in the same slot.
+ */
+type ButtonFieldsOverride = (args: {
+  defaultFields: DefaultButtonFields;
+}) => DefaultButtonFields;
+/** The plugin `buttons` option: form-level button labels and the group's composition seam. */
+type ButtonsOption = {
+  fields?: ButtonFieldsOverride;
+};
+/** The default submit button label field (`buttons.submitLabel`), localized when `localize` is true. */
+declare const buildSubmitLabelField: (localize: boolean) => Field;
+/** The default "Next" button label field (`buttons.nextLabel`); applies to multi-step forms. */
+declare const buildNextLabelField: (localize: boolean) => Field;
+/** The default "Previous" button label field (`buttons.prevLabel`); applies to multi-step forms. */
+declare const buildPrevLabelField: (localize: boolean) => Field;
+/** All three defaults with the localization flag applied: exactly what the seam is handed. */
+declare const buildDefaultButtonFields: (localize: boolean) => DefaultButtonFields;
+//#endregion
+export { ButtonFieldsOverride, ButtonsOption, DefaultButtonFields, buildDefaultButtonFields, buildNextLabelField, buildPrevLabelField, buildSubmitLabelField };
+//# sourceMappingURL=buttonFields.d.ts.map