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

package/dist/client/ClosePollButton.js

@@ -0,0 +1,80 @@
+"use client";
+import { keys } from "../translations/keys.js";
+import { useTranslation as useTranslation$1 } from "../translations/useTranslation.js";
+import { Button, useDocumentInfo, useForm, useFormFields } from "@payloadcms/ui";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { useState } from "react";
+//#region src/client/ClosePollButton.tsx
+/** The help line under the button when closing, tailored to the strategy that closing will apply. */
+const closeHintKeyFor = (type) => {
+	if (type === "mostVoted") return keys.pollCloseHintMostVoted;
+	if (type === "source") return keys.pollCloseHintSource;
+	return keys.pollCloseHintManual;
+};
+const strOf = (value) => typeof value === "string" && value.length > 0 ? value : "manual";
+/** True once a `closesAt` is set (scheduled or past): the toggle treats that as closed/finalized. */
+const isClosed = (value) => typeof value === "string" && value.length > 0;
+/** True when the winner set holds at least one non-empty value. */
+const hasWinner = (value) => Array.isArray(value) && value.some((entry) => typeof entry === "string" && entry.length > 0);
+const asRecord = (value) => value != null && typeof value === "object" ? value : {};
+/**
+* The `poll.closePoll` UI field: one button that closes the poll and, once closed, reopens it, by
+* saving the whole document rather than calling the `/:id/close` endpoint. Closing stamps
+* `poll.closesAt` now while keeping the admin's just-picked winner, so both persist together through
+* the normal save (`pollOutcomeBeforeChange` validates the winner and stamps `resolvedAt`; the
+* `afterChange` hook enqueues the close for a `mostVoted`/`source` strategy). Reopening clears both
+* `closesAt` and `winningValues`, since either one keeps a poll finalized. A `manual` poll with no
+* winner selected disables the button (there is nothing to record); `mostVoted`/`source` stay enabled
+* because the winner is server-computed. Disabled on an unsaved document (no id yet).
+*/
+const ClosePollButton = () => {
+	const { t } = useTranslation$1();
+	const { id } = useDocumentInfo();
+	const { getDataByPath, submit } = useForm();
+	const type = useFormFields(([fields]) => strOf(fields?.["poll.type"]?.value));
+	const closed = useFormFields(([fields]) => isClosed(fields?.["poll.closesAt"]?.value));
+	const winnerSet = useFormFields(([fields]) => hasWinner(fields?.["poll.outcome.winningValues"]?.value));
+	const [submitting, setSubmitting] = useState(false);
+	const manualNeedsWinner = !closed && type === "manual" && !winnerSet;
+	const disabled = id == null || submitting || manualNeedsWinner;
+	const save = async (nextPoll) => {
+		if (id == null) return;
+		setSubmitting(true);
+		try {
+			await submit({ overrides: { poll: nextPoll(asRecord(getDataByPath("poll"))) } });
+		} finally {
+			setSubmitting(false);
+		}
+	};
+	const close = () => save((poll) => ({
+		...poll,
+		closesAt: (/* @__PURE__ */ new Date()).toISOString()
+	}));
+	const reopen = () => save((poll) => ({
+		...poll,
+		closesAt: null,
+		outcome: {
+			...asRecord(poll.outcome),
+			winningValues: []
+		}
+	}));
+	const hintKey = closed ? keys.pollReopenHint : manualNeedsWinner ? keys.pollCloseNeedsWinner : closeHintKeyFor(type);
+	return /* @__PURE__ */ jsxs("div", {
+		className: "field-type",
+		style: { marginBlockEnd: "1rem" },
+		children: [/* @__PURE__ */ jsx(Button, {
+			buttonStyle: "secondary",
+			onClick: closed ? reopen : close,
+			disabled,
+			children: t(closed ? keys.pollReopenButton : keys.pollCloseButton)
+		}), /* @__PURE__ */ jsx("p", {
+			className: "field-description",
+			style: { marginBlockStart: "0.5rem" },
+			children: t(hintKey)
+		})]
+	});
+};
+//#endregion
+export { ClosePollButton };
+
+//# sourceMappingURL=ClosePollButton.js.map

package/dist/client/ClosePollButton.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ClosePollButton.js","names":["useTranslation"],"sources":["../../src/client/ClosePollButton.tsx"],"sourcesContent":["'use client'\n\nimport { Button, useDocumentInfo, useForm, useFormFields } from '@payloadcms/ui'\nimport { useState } from 'react'\nimport { keys, type TranslationKey } from '../translations/keys'\nimport { useTranslation } from '../translations/useTranslation'\n\n/** The help line under the button when closing, tailored to the strategy that closing will apply. */\nconst closeHintKeyFor = (type: string): TranslationKey => {\n\tif (type === 'mostVoted') {\n\t\treturn keys.pollCloseHintMostVoted\n\t}\n\tif (type === 'source') {\n\t\treturn keys.pollCloseHintSource\n\t}\n\treturn keys.pollCloseHintManual\n}\n\nconst strOf = (value: unknown): string =>\n\ttypeof value === 'string' && value.length > 0 ? value : 'manual'\n\n/** True once a `closesAt` is set (scheduled or past): the toggle treats that as closed/finalized. */\nconst isClosed = (value: unknown): boolean => typeof value === 'string' && value.length > 0\n\n/** True when the winner set holds at least one non-empty value. */\nconst hasWinner = (value: unknown): boolean =>\n\tArray.isArray(value) && value.some((entry) => typeof entry === 'string' && entry.length > 0)\n\nconst asRecord = (value: unknown): Record<string, unknown> =>\n\tvalue != null && typeof value === 'object' ? (value as Record<string, unknown>) : {}\n\n/**\n * The `poll.closePoll` UI field: one button that closes the poll and, once closed, reopens it, by\n * saving the whole document rather than calling the `/:id/close` endpoint. Closing stamps\n * `poll.closesAt` now while keeping the admin's just-picked winner, so both persist together through\n * the normal save (`pollOutcomeBeforeChange` validates the winner and stamps `resolvedAt`; the\n * `afterChange` hook enqueues the close for a `mostVoted`/`source` strategy). Reopening clears both\n * `closesAt` and `winningValues`, since either one keeps a poll finalized. A `manual` poll with no\n * winner selected disables the button (there is nothing to record); `mostVoted`/`source` stay enabled\n * because the winner is server-computed. Disabled on an unsaved document (no id yet).\n */\nexport const ClosePollButton = () => {\n\tconst { t } = useTranslation()\n\tconst { id } = useDocumentInfo()\n\tconst { getDataByPath, submit } = useForm()\n\tconst type = useFormFields(([fields]) => strOf(fields?.['poll.type']?.value))\n\tconst closed = useFormFields(([fields]) => isClosed(fields?.['poll.closesAt']?.value))\n\tconst winnerSet = useFormFields(([fields]) =>\n\t\thasWinner(fields?.['poll.outcome.winningValues']?.value)\n\t)\n\tconst [submitting, setSubmitting] = useState(false)\n\n\tconst manualNeedsWinner = !closed && type === 'manual' && !winnerSet\n\tconst disabled = id == null || submitting || manualNeedsWinner\n\n\tconst save = async (nextPoll: (poll: Record<string, unknown>) => Record<string, unknown>) => {\n\t\tif (id == null) {\n\t\t\treturn\n\t\t}\n\t\tsetSubmitting(true)\n\t\ttry {\n\t\t\t// Rebuild the whole poll group from live form state and override it in one shot: a shallow\n\t\t\t// top-level override, so the winner and every other poll field are preserved (a dotted\n\t\t\t// `poll.closesAt` override key never reaches the nested field on the server).\n\t\t\tconst poll = asRecord(getDataByPath('poll'))\n\t\t\tawait submit({ overrides: { poll: nextPoll(poll) } })\n\t\t} finally {\n\t\t\tsetSubmitting(false)\n\t\t}\n\t}\n\n\tconst close = () => save((poll) => ({ ...poll, closesAt: new Date().toISOString() }))\n\tconst reopen = () =>\n\t\tsave((poll) => ({\n\t\t\t...poll,\n\t\t\tclosesAt: null,\n\t\t\toutcome: { ...asRecord(poll.outcome), winningValues: [] },\n\t\t}))\n\n\tconst hintKey: TranslationKey = closed\n\t\t? keys.pollReopenHint\n\t\t: manualNeedsWinner\n\t\t\t? keys.pollCloseNeedsWinner\n\t\t\t: closeHintKeyFor(type)\n\n\treturn (\n\t\t<div className=\"field-type\" style={{ marginBlockEnd: '1rem' }}>\n\t\t\t<Button buttonStyle=\"secondary\" onClick={closed ? reopen : close} disabled={disabled}>\n\t\t\t\t{t(closed ? keys.pollReopenButton : keys.pollCloseButton)}\n\t\t\t</Button>\n\t\t\t<p className=\"field-description\" style={{ marginBlockStart: '0.5rem' }}>\n\t\t\t\t{t(hintKey)}\n\t\t\t</p>\n\t\t</div>\n\t)\n}\n"],"mappings":";;;;;;;;AAQA,MAAM,mBAAmB,SAAiC;CACzD,IAAI,SAAS,aACZ,OAAO,KAAK;CAEb,IAAI,SAAS,UACZ,OAAO,KAAK;CAEb,OAAO,KAAK;AACb;AAEA,MAAM,SAAS,UACd,OAAO,UAAU,YAAY,MAAM,SAAS,IAAI,QAAQ;;AAGzD,MAAM,YAAY,UAA4B,OAAO,UAAU,YAAY,MAAM,SAAS;;AAG1F,MAAM,aAAa,UAClB,MAAM,QAAQ,KAAK,KAAK,MAAM,MAAM,UAAU,OAAO,UAAU,YAAY,MAAM,SAAS,CAAC;AAE5F,MAAM,YAAY,UACjB,SAAS,QAAQ,OAAO,UAAU,WAAY,QAAoC,CAAC;;;;;;;;;;;AAYpF,MAAa,wBAAwB;CACpC,MAAM,EAAE,MAAMA,iBAAe;CAC7B,MAAM,EAAE,OAAO,gBAAgB;CAC/B,MAAM,EAAE,eAAe,WAAW,QAAQ;CAC1C,MAAM,OAAO,eAAe,CAAC,YAAY,MAAM,SAAS,cAAc,KAAK,CAAC;CAC5E,MAAM,SAAS,eAAe,CAAC,YAAY,SAAS,SAAS,kBAAkB,KAAK,CAAC;CACrF,MAAM,YAAY,eAAe,CAAC,YACjC,UAAU,SAAS,+BAA+B,KAAK,CACxD;CACA,MAAM,CAAC,YAAY,iBAAiB,SAAS,KAAK;CAElD,MAAM,oBAAoB,CAAC,UAAU,SAAS,YAAY,CAAC;CAC3D,MAAM,WAAW,MAAM,QAAQ,cAAc;CAE7C,MAAM,OAAO,OAAO,aAAyE;EAC5F,IAAI,MAAM,MACT;EAED,cAAc,IAAI;EAClB,IAAI;GAKH,MAAM,OAAO,EAAE,WAAW,EAAE,MAAM,SADrB,SAAS,cAAc,MAAM,CACI,CAAC,EAAE,EAAE,CAAC;EACrD,UAAU;GACT,cAAc,KAAK;EACpB;CACD;CAEA,MAAM,cAAc,MAAM,UAAU;EAAE,GAAG;EAAM,2BAAU,IAAI,KAAK,GAAE,YAAY;CAAE,EAAE;CACpF,MAAM,eACL,MAAM,UAAU;EACf,GAAG;EACH,UAAU;EACV,SAAS;GAAE,GAAG,SAAS,KAAK,OAAO;GAAG,eAAe,CAAC;EAAE;CACzD,EAAE;CAEH,MAAM,UAA0B,SAC7B,KAAK,iBACL,oBACC,KAAK,uBACL,gBAAgB,IAAI;CAExB,OACC,qBAAC,OAAD;EAAK,WAAU;EAAa,OAAO,EAAE,gBAAgB,OAAO;YAA5D,CACC,oBAAC,QAAD;GAAQ,aAAY;GAAY,SAAS,SAAS,SAAS;GAAiB;aAC1E,EAAE,SAAS,KAAK,mBAAmB,KAAK,eAAe;EACjD,CAAA,GACR,oBAAC,KAAD;GAAG,WAAU;GAAoB,OAAO,EAAE,kBAAkB,SAAS;aACnE,EAAE,OAAO;EACR,CAAA,CACC;;AAEP"}

package/dist/client/CondensedArray.d.ts

@@ -0,0 +1,15 @@
+import { ArrayFieldClientComponent } from "payload";
+//#region src/client/CondensedArray.d.ts
+/**
+ * A custom `Field` for a real Payload `array` that renders its rows flat: each row is `[label, email]`
+ * laid out at 50% width with a remove control, added by a footer button, and never wrapped in the
+ * per-row `Collapsible` that Payload's native array applies unconditionally. Row ids and per-locale
+ * storage stay Payload's: rows come from `useField({ hasRows: true })`, mutations go through
+ * `useForm`'s `addFieldRow`/`removeFieldRow`, and each row's subfields render through `RenderFields`
+ * at `{path}.{index}` exactly as the native array does, so localization, validation, and descriptions
+ * work natively. Placed by {@link departmentsField}.
+ */
+declare const CondensedArray: ArrayFieldClientComponent;
+//#endregion
+export { CondensedArray };
+//# sourceMappingURL=CondensedArray.d.ts.map

package/dist/client/CondensedArray.js

@@ -0,0 +1,97 @@
+"use client";
+import { keys } from "../translations/keys.js";
+import { useTranslation as useTranslation$1 } from "../translations/useTranslation.js";
+import { Button, FieldDescription, FieldLabel, RenderCustomComponent, RenderFields, useField, useForm } from "@payloadcms/ui";
+import { jsx, jsxs } from "react/jsx-runtime";
+import "./admin.css";
+//#region src/client/CondensedArray.tsx
+const baseClass = "fb-condensed-array";
+/**
+* A custom `Field` for a real Payload `array` that renders its rows flat: each row is `[label, email]`
+* laid out at 50% width with a remove control, added by a footer button, and never wrapped in the
+* per-row `Collapsible` that Payload's native array applies unconditionally. Row ids and per-locale
+* storage stay Payload's: rows come from `useField({ hasRows: true })`, mutations go through
+* `useForm`'s `addFieldRow`/`removeFieldRow`, and each row's subfields render through `RenderFields`
+* at `{path}.{index}` exactly as the native array does, so localization, validation, and descriptions
+* work natively. Placed by {@link departmentsField}.
+*/
+const CondensedArray = (props) => {
+	const { field: { name, admin: { description } = {}, fields, label, localized }, forceRender = false, path: pathFromProps, permissions, readOnly, schemaPath: schemaPathFromProps } = props;
+	const schemaPath = schemaPathFromProps ?? name;
+	const { t } = useTranslation$1();
+	const { addFieldRow, removeFieldRow } = useForm();
+	const { customComponents: { Description, Label } = {}, path, rows = [] } = useField({
+		hasRows: true,
+		potentiallyStalePath: pathFromProps
+	});
+	return /* @__PURE__ */ jsxs("div", {
+		className: `field-type ${baseClass}`,
+		id: `field-${path.replace(/\./g, "__")}`,
+		children: [
+			/* @__PURE__ */ jsx(RenderCustomComponent, {
+				CustomComponent: Label,
+				Fallback: /* @__PURE__ */ jsx(FieldLabel, {
+					label,
+					localized,
+					path
+				})
+			}),
+			/* @__PURE__ */ jsx(RenderCustomComponent, {
+				CustomComponent: Description,
+				Fallback: /* @__PURE__ */ jsx(FieldDescription, {
+					description,
+					path
+				})
+			}),
+			rows.length > 0 ? /* @__PURE__ */ jsx("div", {
+				className: `${baseClass}__rows`,
+				children: rows.map((row, index) => /* @__PURE__ */ jsxs("div", {
+					className: `${baseClass}__row`,
+					children: [/* @__PURE__ */ jsx(RenderFields, {
+						className: `${baseClass}__fields`,
+						fields,
+						forceRender,
+						margins: false,
+						parentIndexPath: "",
+						parentPath: `${path}.${index}`,
+						parentSchemaPath: schemaPath,
+						permissions: permissions === true ? permissions : permissions?.fields ?? {},
+						readOnly
+					}), !readOnly ? /* @__PURE__ */ jsx("div", {
+						className: `${baseClass}__remove`,
+						children: /* @__PURE__ */ jsx(Button, {
+							buttonStyle: "icon-label",
+							icon: "x",
+							onClick: () => removeFieldRow({
+								path,
+								rowIndex: index
+							}),
+							"aria-label": t(keys.departmentRemoveRow),
+							margin: false
+						})
+					}) : null]
+				}, row.id))
+			}) : null,
+			!readOnly ? /* @__PURE__ */ jsx("div", {
+				className: `${baseClass}__actions`,
+				children: /* @__PURE__ */ jsx(Button, {
+					buttonStyle: "icon-label",
+					icon: "plus",
+					iconStyle: "with-border",
+					iconPosition: "left",
+					onClick: () => addFieldRow({
+						path,
+						rowIndex: rows.length,
+						schemaPath
+					}),
+					margin: false,
+					children: t(keys.departmentAddRow)
+				})
+			}) : null
+		]
+	});
+};
+//#endregion
+export { CondensedArray };
+
+//# sourceMappingURL=CondensedArray.js.map

package/dist/client/CondensedArray.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"CondensedArray.js","names":["useTranslation"],"sources":["../../src/client/CondensedArray.tsx"],"sourcesContent":["'use client'\n\nimport {\n\tButton,\n\tFieldDescription,\n\tFieldLabel,\n\tRenderCustomComponent,\n\tRenderFields,\n\tuseField,\n\tuseForm,\n} from '@payloadcms/ui'\nimport type { ArrayFieldClientComponent } from 'payload'\nimport { keys } from '../translations/keys'\nimport { useTranslation } from '../translations/useTranslation'\nimport './admin.css'\n\nconst baseClass = 'fb-condensed-array'\n\n/**\n * A custom `Field` for a real Payload `array` that renders its rows flat: each row is `[label, email]`\n * laid out at 50% width with a remove control, added by a footer button, and never wrapped in the\n * per-row `Collapsible` that Payload's native array applies unconditionally. Row ids and per-locale\n * storage stay Payload's: rows come from `useField({ hasRows: true })`, mutations go through\n * `useForm`'s `addFieldRow`/`removeFieldRow`, and each row's subfields render through `RenderFields`\n * at `{path}.{index}` exactly as the native array does, so localization, validation, and descriptions\n * work natively. Placed by {@link departmentsField}.\n */\nexport const CondensedArray: ArrayFieldClientComponent = (props) => {\n\tconst {\n\t\tfield: { name, admin: { description } = {}, fields, label, localized },\n\t\tforceRender = false,\n\t\tpath: pathFromProps,\n\t\tpermissions,\n\t\treadOnly,\n\t\tschemaPath: schemaPathFromProps,\n\t} = props\n\tconst schemaPath = schemaPathFromProps ?? name\n\n\tconst { t } = useTranslation()\n\tconst { addFieldRow, removeFieldRow } = useForm()\n\tconst {\n\t\tcustomComponents: { Description, Label } = {},\n\t\tpath,\n\t\trows = [],\n\t} = useField<number>({ hasRows: true, potentiallyStalePath: pathFromProps })\n\n\treturn (\n\t\t<div className={`field-type ${baseClass}`} id={`field-${path.replace(/\\./g, '__')}`}>\n\t\t\t<RenderCustomComponent\n\t\t\t\tCustomComponent={Label}\n\t\t\t\tFallback={<FieldLabel label={label} localized={localized} path={path} />}\n\t\t\t/>\n\t\t\t<RenderCustomComponent\n\t\t\t\tCustomComponent={Description}\n\t\t\t\tFallback={<FieldDescription description={description} path={path} />}\n\t\t\t/>\n\t\t\t{rows.length > 0 ? (\n\t\t\t\t<div className={`${baseClass}__rows`}>\n\t\t\t\t\t{rows.map((row, index) => (\n\t\t\t\t\t\t<div key={row.id} className={`${baseClass}__row`}>\n\t\t\t\t\t\t\t<RenderFields\n\t\t\t\t\t\t\t\tclassName={`${baseClass}__fields`}\n\t\t\t\t\t\t\t\tfields={fields}\n\t\t\t\t\t\t\t\tforceRender={forceRender}\n\t\t\t\t\t\t\t\tmargins={false}\n\t\t\t\t\t\t\t\tparentIndexPath=\"\"\n\t\t\t\t\t\t\t\tparentPath={`${path}.${index}`}\n\t\t\t\t\t\t\t\tparentSchemaPath={schemaPath}\n\t\t\t\t\t\t\t\tpermissions={permissions === true ? permissions : (permissions?.fields ?? {})}\n\t\t\t\t\t\t\t\treadOnly={readOnly}\n\t\t\t\t\t\t\t/>\n\t\t\t\t\t\t\t{!readOnly ? (\n\t\t\t\t\t\t\t\t<div className={`${baseClass}__remove`}>\n\t\t\t\t\t\t\t\t\t<Button\n\t\t\t\t\t\t\t\t\t\tbuttonStyle=\"icon-label\"\n\t\t\t\t\t\t\t\t\t\ticon=\"x\"\n\t\t\t\t\t\t\t\t\t\tonClick={() => removeFieldRow({ path, rowIndex: index })}\n\t\t\t\t\t\t\t\t\t\taria-label={t(keys.departmentRemoveRow)}\n\t\t\t\t\t\t\t\t\t\tmargin={false}\n\t\t\t\t\t\t\t\t\t/>\n\t\t\t\t\t\t\t\t</div>\n\t\t\t\t\t\t\t) : null}\n\t\t\t\t\t\t</div>\n\t\t\t\t\t))}\n\t\t\t\t</div>\n\t\t\t) : null}\n\t\t\t{!readOnly ? (\n\t\t\t\t<div className={`${baseClass}__actions`}>\n\t\t\t\t\t<Button\n\t\t\t\t\t\tbuttonStyle=\"icon-label\"\n\t\t\t\t\t\ticon=\"plus\"\n\t\t\t\t\t\ticonStyle=\"with-border\"\n\t\t\t\t\t\ticonPosition=\"left\"\n\t\t\t\t\t\tonClick={() => addFieldRow({ path, rowIndex: rows.length, schemaPath })}\n\t\t\t\t\t\tmargin={false}\n\t\t\t\t\t>\n\t\t\t\t\t\t{t(keys.departmentAddRow)}\n\t\t\t\t\t</Button>\n\t\t\t\t</div>\n\t\t\t) : null}\n\t\t</div>\n\t)\n}\n"],"mappings":";;;;;;;AAgBA,MAAM,YAAY;;;;;;;;;;AAWlB,MAAa,kBAA6C,UAAU;CACnE,MAAM,EACL,OAAO,EAAE,MAAM,OAAO,EAAE,gBAAgB,CAAC,GAAG,QAAQ,OAAO,aAC3D,cAAc,OACd,MAAM,eACN,aACA,UACA,YAAY,wBACT;CACJ,MAAM,aAAa,uBAAuB;CAE1C,MAAM,EAAE,MAAMA,iBAAe;CAC7B,MAAM,EAAE,aAAa,mBAAmB,QAAQ;CAChD,MAAM,EACL,kBAAkB,EAAE,aAAa,UAAU,CAAC,GAC5C,MACA,OAAO,CAAC,MACL,SAAiB;EAAE,SAAS;EAAM,sBAAsB;CAAc,CAAC;CAE3E,OACC,qBAAC,OAAD;EAAK,WAAW,cAAc;EAAa,IAAI,SAAS,KAAK,QAAQ,OAAO,IAAI;YAAhF;GACC,oBAAC,uBAAD;IACC,iBAAiB;IACjB,UAAU,oBAAC,YAAD;KAAmB;KAAkB;KAAiB;IAAO,CAAA;GACvE,CAAA;GACD,oBAAC,uBAAD;IACC,iBAAiB;IACjB,UAAU,oBAAC,kBAAD;KAA+B;KAAmB;IAAO,CAAA;GACnE,CAAA;GACA,KAAK,SAAS,IACd,oBAAC,OAAD;IAAK,WAAW,GAAG,UAAU;cAC3B,KAAK,KAAK,KAAK,UACf,qBAAC,OAAD;KAAkB,WAAW,GAAG,UAAU;eAA1C,CACC,oBAAC,cAAD;MACC,WAAW,GAAG,UAAU;MAChB;MACK;MACb,SAAS;MACT,iBAAgB;MAChB,YAAY,GAAG,KAAK,GAAG;MACvB,kBAAkB;MAClB,aAAa,gBAAgB,OAAO,cAAe,aAAa,UAAU,CAAC;MACjE;KACV,CAAA,GACA,CAAC,WACD,oBAAC,OAAD;MAAK,WAAW,GAAG,UAAU;gBAC5B,oBAAC,QAAD;OACC,aAAY;OACZ,MAAK;OACL,eAAe,eAAe;QAAE;QAAM,UAAU;OAAM,CAAC;OACvD,cAAY,EAAE,KAAK,mBAAmB;OACtC,QAAQ;MACR,CAAA;KACG,CAAA,IACF,IACA;OAvBK,IAAI,EAuBT,CACL;GACG,CAAA,IACF;GACH,CAAC,WACD,oBAAC,OAAD;IAAK,WAAW,GAAG,UAAU;cAC5B,oBAAC,QAAD;KACC,aAAY;KACZ,MAAK;KACL,WAAU;KACV,cAAa;KACb,eAAe,YAAY;MAAE;MAAM,UAAU,KAAK;MAAQ;KAAW,CAAC;KACtE,QAAQ;eAEP,EAAE,KAAK,gBAAgB;IACjB,CAAA;GACJ,CAAA,IACF;EACA;;AAEP"}

package/dist/client/EndpointOptionsSelect.d.ts

@@ -0,0 +1,45 @@
+import { TranslationKey } from "../translations/keys.js";
+
+//#region src/client/EndpointOptionsSelect.d.ts
+/** Standard text-field client props plus this component's `clientProps`. */
+type EndpointOptionsSelectProps = {
+  /** The field path within the document (Payload-injected, not the endpoint path). */path?: string;
+  field?: {
+    label?: unknown;
+    admin?: {
+      description?: unknown;
+    };
+  };
+  label?: unknown;
+  /**
+   * Endpoint subpath under the current document's collection API route; `'poll-options'` fetches
+   * `GET {routes.api}/{collectionSlug}/{id}/poll-options`. The endpoint must return
+   * `{ options: { label, value }[] }`.
+   */
+  endpoint: string;
+  /**
+   * Field description as a translation key, resolved client-side. Payload drops `admin.description`
+   * functions from client fields, so a translated description must travel as a key; a static
+   * `admin.description` string still renders when this is unset.
+   */
+  descriptionKey?: TranslationKey; /** Mirrors ReactSelect's `isClearable`; defaults to true. */
+  isClearable?: boolean;
+  /**
+   * Render a multi-value select bound to a `string[]`, for a `hasMany` field (e.g. a poll outcome
+   * with tied winners). Default false: a single-value select bound to a `string`.
+   */
+  isMulti?: boolean;
+};
+/**
+ * A select whose options load from a document-scoped plugin endpoint, for stored values whose
+ * valid choices only the server knows (e.g. a poll's source-resolved options). The pattern: pass
+ * `endpoint` via `clientProps`, the component reads the document id from `useDocumentInfo` and the
+ * API route from `useConfig`, fetches once per document with the admin cookie, and renders
+ * translated loading/error states. The stored value stays selectable even when it is missing from
+ * the fetched options (or the fetch failed), so opening an old document never silently drops data;
+ * unsaved documents skip the fetch since the server cannot resolve options for them yet.
+ */
+declare const EndpointOptionsSelect: (props: EndpointOptionsSelectProps) => import("react/jsx-runtime").JSX.Element;
+//#endregion
+export { EndpointOptionsSelect };
+//# sourceMappingURL=EndpointOptionsSelect.d.ts.map

package/dist/client/EndpointOptionsSelect.js

@@ -0,0 +1,103 @@
+"use client";
+import { keys } from "../translations/keys.js";
+import { useTranslation as useTranslation$1 } from "../translations/useTranslation.js";
+import { toStaticLabel } from "./toStaticLabel.js";
+import { buildEndpointOptionsUrl, parseEndpointOptions } from "./endpointOptions.js";
+import { FieldDescription, FieldLabel, ReactSelect, useConfig, useDocumentInfo, useField } from "@payloadcms/ui";
+import { jsx, jsxs } from "react/jsx-runtime";
+import { useEffect, useState } from "react";
+//#region src/client/EndpointOptionsSelect.tsx
+/**
+* A select whose options load from a document-scoped plugin endpoint, for stored values whose
+* valid choices only the server knows (e.g. a poll's source-resolved options). The pattern: pass
+* `endpoint` via `clientProps`, the component reads the document id from `useDocumentInfo` and the
+* API route from `useConfig`, fetches once per document with the admin cookie, and renders
+* translated loading/error states. The stored value stays selectable even when it is missing from
+* the fetched options (or the fetch failed), so opening an old document never silently drops data;
+* unsaved documents skip the fetch since the server cannot resolve options for them yet.
+*/
+const EndpointOptionsSelect = (props) => {
+	const isMulti = props.isMulti === true;
+	const { path, setValue, value } = useField({ path: props.path });
+	const label = toStaticLabel(props.field?.label ?? props.label);
+	const { t } = useTranslation$1();
+	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 [state, setState] = useState({ status: "idle" });
+	useEffect(() => {
+		if (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 selectedValues = isMulti ? Array.isArray(value) ? value.filter((entry) => typeof entry === "string" && entry.length > 0) : [] : typeof value === "string" && value.length > 0 ? [value] : [];
+	const options = state.status === "loaded" ? state.options : [];
+	const missing = selectedValues.filter((selected) => !options.some((option) => option.value === selected)).map((selected) => ({
+		label: selected,
+		value: selected
+	}));
+	const allOptions = missing.length > 0 ? [...options, ...missing] : options;
+	const selectedOptions = selectedValues.map((selected) => allOptions.find((option) => option.value === selected)).filter((option) => option !== void 0);
+	const handleChange = (selected) => {
+		if (isMulti) {
+			setValue((Array.isArray(selected) ? selected : selected ? [selected] : []).map((option) => option.value));
+			return;
+		}
+		const chosen = Array.isArray(selected) ? selected[0] : selected;
+		setValue(chosen ? chosen.value : "");
+	};
+	return /* @__PURE__ */ jsxs("div", {
+		className: "field-type",
+		style: { marginBlockEnd: "1rem" },
+		children: [
+			/* @__PURE__ */ jsx(FieldLabel, {
+				label,
+				path
+			}),
+			/* @__PURE__ */ jsx(ReactSelect, {
+				options: allOptions,
+				value: isMulti ? selectedOptions : selectedOptions[0] ?? void 0,
+				isMulti,
+				isClearable: props.isClearable !== false,
+				isLoading: state.status === "loading",
+				placeholder: state.status === "loading" ? t(keys.endpointOptionsLoading) : void 0,
+				showError: state.status === "error",
+				onChange: handleChange
+			}),
+			/* @__PURE__ */ jsx(FieldDescription, {
+				description: state.status === "error" ? t(keys.endpointOptionsError) : description,
+				path
+			})
+		]
+	});
+};
+//#endregion
+export { EndpointOptionsSelect };
+
+//# sourceMappingURL=EndpointOptionsSelect.js.map

package/dist/client/EndpointOptionsSelect.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EndpointOptionsSelect.js","names":["useTranslation"],"sources":["../../src/client/EndpointOptionsSelect.tsx"],"sourcesContent":["'use client'\n\nimport {\n\tFieldDescription,\n\tFieldLabel,\n\tReactSelect,\n\ttype ReactSelectOption,\n\tuseConfig,\n\tuseDocumentInfo,\n\tuseField,\n} from '@payloadcms/ui'\nimport { useEffect, useState } from 'react'\nimport { keys, type TranslationKey } from '../translations/keys'\nimport { useTranslation } from '../translations/useTranslation'\nimport {\n\tbuildEndpointOptionsUrl,\n\ttype EndpointOption,\n\tparseEndpointOptions,\n} from './endpointOptions'\nimport { toStaticLabel } from './toStaticLabel'\n\n/** Standard text-field client props plus this component's `clientProps`. */\nexport type EndpointOptionsSelectProps = {\n\t/** The field path within the document (Payload-injected, not the endpoint path). */\n\tpath?: string\n\tfield?: { label?: unknown; admin?: { description?: unknown } }\n\tlabel?: unknown\n\t/**\n\t * Endpoint subpath under the current document's collection API route; `'poll-options'` fetches\n\t * `GET {routes.api}/{collectionSlug}/{id}/poll-options`. The endpoint must return\n\t * `{ options: { label, value }[] }`.\n\t */\n\tendpoint: string\n\t/**\n\t * Field description as a translation key, resolved client-side. Payload drops `admin.description`\n\t * functions from client fields, so a translated description must travel as a key; a static\n\t * `admin.description` string still renders when this is unset.\n\t */\n\tdescriptionKey?: TranslationKey\n\t/** Mirrors ReactSelect's `isClearable`; defaults to true. */\n\tisClearable?: boolean\n\t/**\n\t * Render a multi-value select bound to a `string[]`, for a `hasMany` field (e.g. a poll outcome\n\t * with tied winners). Default false: a single-value select bound to a `string`.\n\t */\n\tisMulti?: boolean\n}\n\ntype FetchState =\n\t| { status: 'error' | 'idle' | 'loading'; options?: never }\n\t| { status: 'loaded'; options: EndpointOption[] }\n\n/**\n * A select whose options load from a document-scoped plugin endpoint, for stored values whose\n * valid choices only the server knows (e.g. a poll's source-resolved options). The pattern: pass\n * `endpoint` via `clientProps`, the component reads the document id from `useDocumentInfo` and the\n * API route from `useConfig`, fetches once per document with the admin cookie, and renders\n * translated loading/error states. The stored value stays selectable even when it is missing from\n * the fetched options (or the fetch failed), so opening an old document never silently drops data;\n * unsaved documents skip the fetch since the server cannot resolve options for them yet.\n */\nexport const EndpointOptionsSelect = (props: EndpointOptionsSelectProps) => {\n\tconst isMulti = props.isMulti === true\n\tconst { path, setValue, value } = useField<string | string[]>({ path: props.path })\n\tconst label = toStaticLabel(props.field?.label ?? props.label)\n\tconst { t } = useTranslation()\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 [state, setState] = useState<FetchState>({ status: 'idle' })\n\n\tuseEffect(() => {\n\t\tif (id == null || !collectionSlug) {\n\t\t\treturn\n\t\t}\n\t\tconst controller = new AbortController()\n\t\tconst url = buildEndpointOptionsUrl({\n\t\t\tapiRoute,\n\t\t\tcollectionSlug,\n\t\t\tid,\n\t\t\tendpoint: props.endpoint,\n\t\t})\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\t// A missing fetched option (or a failed fetch) must never silently drop a stored value, so every\n\t// selected value the options don't cover is kept selectable by its own label.\n\tconst selectedValues: string[] = isMulti\n\t\t? Array.isArray(value)\n\t\t\t? value.filter((entry): entry is string => typeof entry === 'string' && entry.length > 0)\n\t\t\t: []\n\t\t: typeof value === 'string' && value.length > 0\n\t\t\t? [value]\n\t\t\t: []\n\tconst options: ReactSelectOption[] = state.status === 'loaded' ? state.options : []\n\tconst missing = selectedValues\n\t\t.filter((selected) => !options.some((option) => option.value === selected))\n\t\t.map((selected) => ({ label: selected, value: selected }))\n\tconst allOptions = missing.length > 0 ? [...options, ...missing] : options\n\tconst selectedOptions = selectedValues\n\t\t.map((selected) => allOptions.find((option) => option.value === selected))\n\t\t.filter((option): option is ReactSelectOption => option !== undefined)\n\n\tconst handleChange = (selected: ReactSelectOption | ReactSelectOption[] | null) => {\n\t\tif (isMulti) {\n\t\t\tconst chosen = Array.isArray(selected) ? selected : selected ? [selected] : []\n\t\t\tsetValue(chosen.map((option) => option.value as string))\n\t\t\treturn\n\t\t}\n\t\tconst chosen = Array.isArray(selected) ? selected[0] : selected\n\t\tsetValue(chosen ? (chosen.value as string) : '')\n\t}\n\n\treturn (\n\t\t<div className=\"field-type\" style={{ marginBlockEnd: '1rem' }}>\n\t\t\t<FieldLabel label={label} path={path} />\n\t\t\t<ReactSelect\n\t\t\t\toptions={allOptions}\n\t\t\t\tvalue={isMulti ? selectedOptions : (selectedOptions[0] ?? undefined)}\n\t\t\t\tisMulti={isMulti}\n\t\t\t\tisClearable={props.isClearable !== false}\n\t\t\t\tisLoading={state.status === 'loading'}\n\t\t\t\tplaceholder={state.status === 'loading' ? t(keys.endpointOptionsLoading) : undefined}\n\t\t\t\tshowError={state.status === 'error'}\n\t\t\t\tonChange={handleChange}\n\t\t\t/>\n\t\t\t<FieldDescription\n\t\t\t\tdescription={state.status === 'error' ? t(keys.endpointOptionsError) : description}\n\t\t\t\tpath={path}\n\t\t\t/>\n\t\t</div>\n\t)\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AA6DA,MAAa,yBAAyB,UAAsC;CAC3E,MAAM,UAAU,MAAM,YAAY;CAClC,MAAM,EAAE,MAAM,UAAU,UAAU,SAA4B,EAAE,MAAM,MAAM,KAAK,CAAC;CAClF,MAAM,QAAQ,cAAc,MAAM,OAAO,SAAS,MAAM,KAAK;CAC7D,MAAM,EAAE,MAAMA,iBAAe;CAC7B,MAAM,cAAc,MAAM,iBACvB,EAAE,MAAM,cAAc,IACtB,cAAc,MAAM,OAAO,OAAO,WAAW;CAChD,MAAM,EAAE,IAAI,mBAAmB,gBAAgB;CAC/C,MAAM,EAAE,WAAW,UAAU;CAC7B,MAAM,WAAW,OAAO,OAAO;CAC/B,MAAM,CAAC,OAAO,YAAY,SAAqB,EAAE,QAAQ,OAAO,CAAC;CAEjE,gBAAgB;EACf,IAAI,MAAM,QAAQ,CAAC,gBAClB;EAED,MAAM,aAAa,IAAI,gBAAgB;EACvC,MAAM,MAAM,wBAAwB;GACnC;GACA;GACA;GACA,UAAU,MAAM;EACjB,CAAC;EACD,SAAS,EAAE,QAAQ,UAAU,CAAC;EAC9B,MAAM,KAAK;GACV,aAAa;GACb,SAAS,EAAE,QAAQ,mBAAmB;GACtC,QAAQ,WAAW;EACpB,CAAC,EACC,KAAK,OAAO,aAAa;GACzB,IAAI,CAAC,SAAS,IACb,MAAM,IAAI,MAAM,+BAA+B,SAAS,QAAQ;GAEjE,SAAS;IAAE,QAAQ;IAAU,SAAS,qBAAqB,MAAM,SAAS,KAAK,CAAC;GAAE,CAAC;EACpF,CAAC,EACA,YAAY;GACZ,IAAI,CAAC,WAAW,OAAO,SACtB,SAAS,EAAE,QAAQ,QAAQ,CAAC;EAE9B,CAAC;EACF,aAAa,WAAW,MAAM;CAC/B,GAAG;EAAC;EAAU;EAAgB;EAAI,MAAM;CAAQ,CAAC;CAIjD,MAAM,iBAA2B,UAC9B,MAAM,QAAQ,KAAK,IAClB,MAAM,QAAQ,UAA2B,OAAO,UAAU,YAAY,MAAM,SAAS,CAAC,IACtF,CAAC,IACF,OAAO,UAAU,YAAY,MAAM,SAAS,IAC3C,CAAC,KAAK,IACN,CAAC;CACL,MAAM,UAA+B,MAAM,WAAW,WAAW,MAAM,UAAU,CAAC;CAClF,MAAM,UAAU,eACd,QAAQ,aAAa,CAAC,QAAQ,MAAM,WAAW,OAAO,UAAU,QAAQ,CAAC,EACzE,KAAK,cAAc;EAAE,OAAO;EAAU,OAAO;CAAS,EAAE;CAC1D,MAAM,aAAa,QAAQ,SAAS,IAAI,CAAC,GAAG,SAAS,GAAG,OAAO,IAAI;CACnE,MAAM,kBAAkB,eACtB,KAAK,aAAa,WAAW,MAAM,WAAW,OAAO,UAAU,QAAQ,CAAC,EACxE,QAAQ,WAAwC,WAAW,KAAA,CAAS;CAEtE,MAAM,gBAAgB,aAA6D;EAClF,IAAI,SAAS;GAEZ,UADe,MAAM,QAAQ,QAAQ,IAAI,WAAW,WAAW,CAAC,QAAQ,IAAI,CAAC,GAC7D,KAAK,WAAW,OAAO,KAAe,CAAC;GACvD;EACD;EACA,MAAM,SAAS,MAAM,QAAQ,QAAQ,IAAI,SAAS,KAAK;EACvD,SAAS,SAAU,OAAO,QAAmB,EAAE;CAChD;CAEA,OACC,qBAAC,OAAD;EAAK,WAAU;EAAa,OAAO,EAAE,gBAAgB,OAAO;YAA5D;GACC,oBAAC,YAAD;IAAmB;IAAa;GAAO,CAAA;GACvC,oBAAC,aAAD;IACC,SAAS;IACT,OAAO,UAAU,kBAAmB,gBAAgB,MAAM,KAAA;IACjD;IACT,aAAa,MAAM,gBAAgB;IACnC,WAAW,MAAM,WAAW;IAC5B,aAAa,MAAM,WAAW,YAAY,EAAE,KAAK,sBAAsB,IAAI,KAAA;IAC3E,WAAW,MAAM,WAAW;IAC5B,UAAU;GACV,CAAA;GACD,oBAAC,kBAAD;IACC,aAAa,MAAM,WAAW,UAAU,EAAE,KAAK,oBAAoB,IAAI;IACjE;GACN,CAAA;EACG;;AAEP"}

package/dist/client/FieldBlockLabel.d.ts

@@ -0,0 +1,18 @@
+//#region src/client/FieldBlockLabel.d.ts
+/** Props threaded from each field block's `admin.components.Label` clientProps. */
+type FieldBlockLabelProps = {
+  /** The block's type-label key (e.g. `keys.fieldTypeText`), shown while the field has no label. */typeLabelKey?: string;
+};
+/**
+ * Row header for a field block. Payload's native collapsed-row header ends in the editable
+ * `blockName`, which reads "Untitled" until someone fills it; a field already carries a `label`, so
+ * this shows that instead, giving each row a "01 Text Full name" heading. Falls back to the block's
+ * type label while the field is still unnamed. Because a custom block label replaces the whole native
+ * header, it re-emits the row number and type the default would otherwise render.
+ */
+declare const FieldBlockLabel: ({
+  typeLabelKey
+}: FieldBlockLabelProps) => import("react/jsx-runtime").JSX.Element;
+//#endregion
+export { FieldBlockLabel };
+//# sourceMappingURL=FieldBlockLabel.d.ts.map

package/dist/client/FieldBlockLabel.js

@@ -0,0 +1,34 @@
+"use client";
+import { useTranslation as useTranslation$1 } from "../translations/useTranslation.js";
+import { useRowLabel } from "@payloadcms/ui";
+import { jsx, jsxs } from "react/jsx-runtime";
+//#region src/client/FieldBlockLabel.tsx
+/**
+* Row header for a field block. Payload's native collapsed-row header ends in the editable
+* `blockName`, which reads "Untitled" until someone fills it; a field already carries a `label`, so
+* this shows that instead, giving each row a "01 Text Full name" heading. Falls back to the block's
+* type label while the field is still unnamed. Because a custom block label replaces the whole native
+* header, it re-emits the row number and type the default would otherwise render.
+*/
+const FieldBlockLabel = ({ typeLabelKey }) => {
+	const { data, rowNumber } = useRowLabel();
+	const { t } = useTranslation$1();
+	const typeLabel = typeLabelKey ? t(typeLabelKey) : "";
+	const fieldLabel = typeof data?.label === "string" && data.label.trim().length > 0 ? data.label.trim() : "";
+	const number = String((rowNumber ?? 0) + 1).padStart(2, "0");
+	return /* @__PURE__ */ jsxs("span", {
+		style: {
+			alignItems: "center",
+			display: "inline-flex",
+			gap: "0.5rem"
+		},
+		children: [/* @__PURE__ */ jsx("span", {
+			style: { color: "var(--theme-elevation-500)" },
+			children: typeLabel ? `${number} ${typeLabel}` : number
+		}), fieldLabel ? /* @__PURE__ */ jsx("span", { children: fieldLabel }) : null]
+	});
+};
+//#endregion
+export { FieldBlockLabel };
+
+//# sourceMappingURL=FieldBlockLabel.js.map

package/dist/client/FieldBlockLabel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"FieldBlockLabel.js","names":["useTranslation"],"sources":["../../src/client/FieldBlockLabel.tsx"],"sourcesContent":["'use client'\n\nimport { useRowLabel } from '@payloadcms/ui'\nimport type { TranslationKey } from '../translations/keys'\nimport { useTranslation } from '../translations/useTranslation'\n\n/** Props threaded from each field block's `admin.components.Label` clientProps. */\nexport type FieldBlockLabelProps = {\n\t/** The block's type-label key (e.g. `keys.fieldTypeText`), shown while the field has no label. */\n\ttypeLabelKey?: string\n}\n\ntype RowData = { label?: unknown }\n\n/**\n * Row header for a field block. Payload's native collapsed-row header ends in the editable\n * `blockName`, which reads \"Untitled\" until someone fills it; a field already carries a `label`, so\n * this shows that instead, giving each row a \"01 Text Full name\" heading. Falls back to the block's\n * type label while the field is still unnamed. Because a custom block label replaces the whole native\n * header, it re-emits the row number and type the default would otherwise render.\n */\nexport const FieldBlockLabel = ({ typeLabelKey }: FieldBlockLabelProps) => {\n\tconst { data, rowNumber } = useRowLabel<RowData>()\n\tconst { t } = useTranslation()\n\tconst typeLabel = typeLabelKey ? t(typeLabelKey as TranslationKey) : ''\n\tconst fieldLabel =\n\t\ttypeof data?.label === 'string' && data.label.trim().length > 0 ? data.label.trim() : ''\n\tconst number = String((rowNumber ?? 0) + 1).padStart(2, '0')\n\treturn (\n\t\t<span style={{ alignItems: 'center', display: 'inline-flex', gap: '0.5rem' }}>\n\t\t\t<span style={{ color: 'var(--theme-elevation-500)' }}>\n\t\t\t\t{typeLabel ? `${number} ${typeLabel}` : number}\n\t\t\t</span>\n\t\t\t{fieldLabel ? <span>{fieldLabel}</span> : null}\n\t\t</span>\n\t)\n}\n"],"mappings":";;;;;;;;;;;;AAqBA,MAAa,mBAAmB,EAAE,mBAAyC;CAC1E,MAAM,EAAE,MAAM,cAAc,YAAqB;CACjD,MAAM,EAAE,MAAMA,iBAAe;CAC7B,MAAM,YAAY,eAAe,EAAE,YAA8B,IAAI;CACrE,MAAM,aACL,OAAO,MAAM,UAAU,YAAY,KAAK,MAAM,KAAK,EAAE,SAAS,IAAI,KAAK,MAAM,KAAK,IAAI;CACvF,MAAM,SAAS,QAAQ,aAAa,KAAK,CAAC,EAAE,SAAS,GAAG,GAAG;CAC3D,OACC,qBAAC,QAAD;EAAM,OAAO;GAAE,YAAY;GAAU,SAAS;GAAe,KAAK;EAAS;YAA3E,CACC,oBAAC,QAAD;GAAM,OAAO,EAAE,OAAO,6BAA6B;aACjD,YAAY,GAAG,OAAO,GAAG,cAAc;EACnC,CAAA,GACL,aAAa,oBAAC,QAAD,EAAA,UAAO,WAAiB,CAAA,IAAI,IACrC;;AAER"}

package/dist/client/FieldNameSelect.d.ts

@@ -1,18 +1,34 @@
+import { TranslationKey } from "../translations/keys.js";
+
 //#region src/client/FieldNameSelect.d.ts
 /** Props: standard JSON/text field client props plus the `types` allow-list we pass via clientProps. */
 type FieldNameSelectProps = {
   path?: string;
   field?: {
     label?: unknown;
+    admin?: {
+      description?: unknown;
+    };
   };
-  label?: unknown; /** Sibling `fields` blocks whose `blockType` is in this list populate the select's options. */
-  types: string[];
+  label?: unknown;
+  /**
+   * Sibling `fields` blocks whose `blockType` is in this list populate the select's options. Omit to
+   * offer every named field regardless of type (a general field-target picker).
+   */
+  types?: string[];
+  /**
+   * Field description as a translation key, resolved client-side. Payload drops `admin.description`
+   * functions from client fields, so a translated description must travel as a key; a static
+   * `admin.description` string still renders when this is unset.
+   */
+  descriptionKey?: TranslationKey;
 };
 /**
  * The `Field` mounted on a text config field (e.g. an action's `toField`) that should be authored
  * by picking from the form's own fields rather than free-typing a name. Options come from the
- * sibling `fields` blocks array, filtered to `types`; the stored value is kept selectable even if
- * it no longer matches any field, so switching to this component never silently drops data.
+ * sibling `fields` blocks array, filtered to `types` when given (every named field otherwise); the
+ * stored value is kept selectable even if it no longer matches any field, so switching to this
+ * component never silently drops data.
  */
 declare const FieldNameSelect: (props: FieldNameSelectProps) => import("react/jsx-runtime").JSX.Element;
 //#endregion

package/dist/client/FieldNameSelect.js

@@ -1,8 +1,9 @@
 "use client";
-import { fieldNamesOfType } from "../fields/fieldNamesOfType.js";
+import { fieldNames, fieldNamesOfType } from "../fields/fieldNamesOfType.js";
+import { useTranslation as useTranslation$1 } from "../translations/useTranslation.js";
 import { toStaticLabel } from "./toStaticLabel.js";
 import { reduceFieldsToValues } from "payload/shared";
-import { FieldLabel, ReactSelect, useField, useFormFields } from "@payloadcms/ui";
+import { FieldDescription, FieldLabel, ReactSelect, useField, useFormFields } from "@payloadcms/ui";
 import { jsx, jsxs } from "react/jsx-runtime";
 import { useMemo } from "react";
 //#region src/client/FieldNameSelect.tsx
@@ -14,7 +15,7 @@ const optionsFromData = (data, types) => {
 		const { name, label } = row;
 		if (typeof name === "string" && typeof label === "string" && label.length > 0) labels.set(name.trim(), label);
 	}
-	return fieldNamesOfType(data.fields, types).map((name) => ({
+	return (types ? fieldNamesOfType(data.fields, types) : fieldNames(data.fields)).map((name) => ({
 		label: labels.get(name) ?? name,
 		value: name
 	}));
@@ -22,12 +23,15 @@ const optionsFromData = (data, types) => {
 /**
 * The `Field` mounted on a text config field (e.g. an action's `toField`) that should be authored
 * by picking from the form's own fields rather than free-typing a name. Options come from the
-* sibling `fields` blocks array, filtered to `types`; the stored value is kept selectable even if
-* it no longer matches any field, so switching to this component never silently drops data.
+* sibling `fields` blocks array, filtered to `types` when given (every named field otherwise); the
+* stored value is kept selectable even if it no longer matches any field, so switching to this
+* component never silently drops data.
 */
 const FieldNameSelect = (props) => {
 	const { path, setValue, value } = useField({ path: props.path });
 	const label = toStaticLabel(props.field?.label ?? props.label);
+	const { t } = useTranslation$1();
+	const description = props.descriptionKey ? t(props.descriptionKey) : toStaticLabel(props.field?.admin?.description);
 	const optionsJson = useFormFields(([fields]) => JSON.stringify(optionsFromData(reduceFieldsToValues(fields, true), props.types)));
 	const options = useMemo(() => JSON.parse(optionsJson), [optionsJson]);
 	const allOptions = value && !options.some((option) => option.value === value) ? [...options, {
@@ -41,15 +45,22 @@ const FieldNameSelect = (props) => {
 	return /* @__PURE__ */ jsxs("div", {
 		className: "field-type",
 		style: { marginBlockEnd: "1rem" },
-		children: [/* @__PURE__ */ jsx(FieldLabel, {
-			label,
-			path
-		}), /* @__PURE__ */ jsx(ReactSelect, {
-			options: allOptions,
-			value: allOptions.find((option) => option.value === value) ?? void 0,
-			isClearable: true,
-			onChange: handleChange
-		})]
+		children: [
+			/* @__PURE__ */ jsx(FieldLabel, {
+				label,
+				path
+			}),
+			/* @__PURE__ */ jsx(ReactSelect, {
+				options: allOptions,
+				value: allOptions.find((option) => option.value === value) ?? void 0,
+				isClearable: true,
+				onChange: handleChange
+			}),
+			/* @__PURE__ */ jsx(FieldDescription, {
+				description,
+				path
+			})
+		]
 	});
 };
 //#endregion

package/dist/client/FieldNameSelect.js.map

@@ -1 +1 @@
-{"version":3,"file":"FieldNameSelect.js","names":[],"sources":["../../src/client/FieldNameSelect.tsx"],"sourcesContent":["'use client'\n\nimport {\n\tFieldLabel,\n\tReactSelect,\n\ttype ReactSelectOption,\n\tuseField,\n\tuseFormFields,\n} from '@payloadcms/ui'\nimport { reduceFieldsToValues } from 'payload/shared'\nimport { useMemo } from 'react'\nimport { fieldNamesOfType } from '../fields/fieldNamesOfType'\nimport type { FieldRow } from './synthesizeClientField'\nimport { toStaticLabel } from './toStaticLabel'\n\n/** Props: standard JSON/text field client props plus the `types` allow-list we pass via clientProps. */\nexport type FieldNameSelectProps = {\n\tpath?: string\n\tfield?: { label?: unknown }\n\tlabel?: unknown\n\t/** Sibling `fields` blocks whose `blockType` is in this list populate the select's options. */\n\ttypes: string[]\n}\n\nconst optionsFromData = (data: Record<string, unknown>, types: string[]): 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\treturn fieldNamesOfType(data.fields, types).map((name) => ({\n\t\tlabel: labels.get(name) ?? name,\n\t\tvalue: name,\n\t}))\n}\n\n/**\n * The `Field` mounted on a text config field (e.g. an action's `toField`) that should be authored\n * by picking from the form's own fields rather than free-typing a name. Options come from the\n * sibling `fields` blocks array, filtered to `types`; the stored value is kept selectable even if\n * it no longer matches any field, so switching to this component never silently drops data.\n */\nexport const FieldNameSelect = (props: FieldNameSelectProps) => {\n\tconst { path, setValue, value } = useField<string>({ path: props.path })\n\tconst label = toStaticLabel(props.field?.label ?? props.label)\n\n\tconst optionsJson = useFormFields(([fields]) =>\n\t\tJSON.stringify(optionsFromData(reduceFieldsToValues(fields, true), props.types))\n\t)\n\tconst options = useMemo(() => JSON.parse(optionsJson) as ReactSelectOption[], [optionsJson])\n\n\tconst allOptions =\n\t\tvalue && !options.some((option) => option.value === value)\n\t\t\t? [...options, { label: value, value }]\n\t\t\t: options\n\n\tconst handleChange = (selected: ReactSelectOption | ReactSelectOption[] | null) => {\n\t\tconst chosen = Array.isArray(selected) ? selected[0] : selected\n\t\tsetValue(chosen ? (chosen.value as string) : '')\n\t}\n\n\treturn (\n\t\t<div className=\"field-type\" style={{ marginBlockEnd: '1rem' }}>\n\t\t\t<FieldLabel label={label} path={path} />\n\t\t\t<ReactSelect\n\t\t\t\toptions={allOptions}\n\t\t\t\tvalue={allOptions.find((option) => option.value === value) ?? undefined}\n\t\t\t\tisClearable\n\t\t\t\tonChange={handleChange}\n\t\t\t/>\n\t\t</div>\n\t)\n}\n"],"mappings":";;;;;;;;AAwBA,MAAM,mBAAmB,MAA+B,UAAyC;CAChG,MAAM,OAAO,MAAM,QAAQ,KAAK,MAAM,IAAK,KAAK,SAAuB,CAAC;CACxE,MAAM,yBAAS,IAAI,IAAoB;CACvC,KAAK,MAAM,OAAO,MAAM;EACvB,IAAI,CAAC,OAAO,OAAO,QAAQ,UAC1B;EAED,MAAM,EAAE,MAAM,UAAU;EACxB,IAAI,OAAO,SAAS,YAAY,OAAO,UAAU,YAAY,MAAM,SAAS,GAC3E,OAAO,IAAI,KAAK,KAAK,GAAG,KAAK;CAE/B;CACA,OAAO,iBAAiB,KAAK,QAAQ,KAAK,EAAE,KAAK,UAAU;EAC1D,OAAO,OAAO,IAAI,IAAI,KAAK;EAC3B,OAAO;CACR,EAAE;AACH;;;;;;;AAQA,MAAa,mBAAmB,UAAgC;CAC/D,MAAM,EAAE,MAAM,UAAU,UAAU,SAAiB,EAAE,MAAM,MAAM,KAAK,CAAC;CACvE,MAAM,QAAQ,cAAc,MAAM,OAAO,SAAS,MAAM,KAAK;CAE7D,MAAM,cAAc,eAAe,CAAC,YACnC,KAAK,UAAU,gBAAgB,qBAAqB,QAAQ,IAAI,GAAG,MAAM,KAAK,CAAC,CAChF;CACA,MAAM,UAAU,cAAc,KAAK,MAAM,WAAW,GAA0B,CAAC,WAAW,CAAC;CAE3F,MAAM,aACL,SAAS,CAAC,QAAQ,MAAM,WAAW,OAAO,UAAU,KAAK,IACtD,CAAC,GAAG,SAAS;EAAE,OAAO;EAAO;CAAM,CAAC,IACpC;CAEJ,MAAM,gBAAgB,aAA6D;EAClF,MAAM,SAAS,MAAM,QAAQ,QAAQ,IAAI,SAAS,KAAK;EACvD,SAAS,SAAU,OAAO,QAAmB,EAAE;CAChD;CAEA,OACC,qBAAC,OAAD;EAAK,WAAU;EAAa,OAAO,EAAE,gBAAgB,OAAO;YAA5D,CACC,oBAAC,YAAD;GAAmB;GAAa;EAAO,CAAA,GACvC,oBAAC,aAAD;GACC,SAAS;GACT,OAAO,WAAW,MAAM,WAAW,OAAO,UAAU,KAAK,KAAK,KAAA;GAC9D,aAAA;GACA,UAAU;EACV,CAAA,CACG;;AAEP"}
+{"version":3,"file":"FieldNameSelect.js","names":["useTranslation"],"sources":["../../src/client/FieldNameSelect.tsx"],"sourcesContent":["'use client'\n\nimport {\n\tFieldDescription,\n\tFieldLabel,\n\tReactSelect,\n\ttype ReactSelectOption,\n\tuseField,\n\tuseFormFields,\n} from '@payloadcms/ui'\nimport { reduceFieldsToValues } from 'payload/shared'\nimport { useMemo } from 'react'\nimport { fieldNames, fieldNamesOfType } from '../fields/fieldNamesOfType'\nimport type { TranslationKey } from '../translations/keys'\nimport { useTranslation } from '../translations/useTranslation'\nimport type { FieldRow } from './synthesizeClientField'\nimport { toStaticLabel } from './toStaticLabel'\n\n/** Props: standard JSON/text field client props plus the `types` allow-list we pass via clientProps. */\nexport type FieldNameSelectProps = {\n\tpath?: string\n\tfield?: { label?: unknown; admin?: { description?: unknown } }\n\tlabel?: unknown\n\t/**\n\t * Sibling `fields` blocks whose `blockType` is in this list populate the select's options. Omit to\n\t * offer every named field regardless of type (a general field-target picker).\n\t */\n\ttypes?: string[]\n\t/**\n\t * Field description as a translation key, resolved client-side. Payload drops `admin.description`\n\t * functions from client fields, so a translated description must travel as a key; a static\n\t * `admin.description` string still renders when this is unset.\n\t */\n\tdescriptionKey?: TranslationKey\n}\n\nconst optionsFromData = (data: Record<string, unknown>, types?: string[]): 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 = types ? fieldNamesOfType(data.fields, types) : fieldNames(data.fields)\n\treturn names.map((name) => ({\n\t\tlabel: labels.get(name) ?? name,\n\t\tvalue: name,\n\t}))\n}\n\n/**\n * The `Field` mounted on a text config field (e.g. an action's `toField`) that should be authored\n * by picking from the form's own fields rather than free-typing a name. Options come from the\n * sibling `fields` blocks array, filtered to `types` when given (every named field otherwise); the\n * stored value is kept selectable even if it no longer matches any field, so switching to this\n * component never silently drops data.\n */\nexport const FieldNameSelect = (props: FieldNameSelectProps) => {\n\tconst { path, setValue, value } = useField<string>({ path: props.path })\n\tconst label = toStaticLabel(props.field?.label ?? props.label)\n\tconst { t } = useTranslation()\n\tconst description = props.descriptionKey\n\t\t? t(props.descriptionKey)\n\t\t: toStaticLabel(props.field?.admin?.description)\n\n\tconst optionsJson = useFormFields(([fields]) =>\n\t\tJSON.stringify(optionsFromData(reduceFieldsToValues(fields, true), props.types))\n\t)\n\tconst options = useMemo(() => JSON.parse(optionsJson) as ReactSelectOption[], [optionsJson])\n\n\tconst allOptions =\n\t\tvalue && !options.some((option) => option.value === value)\n\t\t\t? [...options, { label: value, value }]\n\t\t\t: options\n\n\tconst handleChange = (selected: ReactSelectOption | ReactSelectOption[] | null) => {\n\t\tconst chosen = Array.isArray(selected) ? selected[0] : selected\n\t\tsetValue(chosen ? (chosen.value as string) : '')\n\t}\n\n\treturn (\n\t\t<div className=\"field-type\" style={{ marginBlockEnd: '1rem' }}>\n\t\t\t<FieldLabel label={label} path={path} />\n\t\t\t<ReactSelect\n\t\t\t\toptions={allOptions}\n\t\t\t\tvalue={allOptions.find((option) => option.value === value) ?? undefined}\n\t\t\t\tisClearable\n\t\t\t\tonChange={handleChange}\n\t\t\t/>\n\t\t\t<FieldDescription description={description} path={path} />\n\t\t</div>\n\t)\n}\n"],"mappings":";;;;;;;;;AAoCA,MAAM,mBAAmB,MAA+B,UAA0C;CACjG,MAAM,OAAO,MAAM,QAAQ,KAAK,MAAM,IAAK,KAAK,SAAuB,CAAC;CACxE,MAAM,yBAAS,IAAI,IAAoB;CACvC,KAAK,MAAM,OAAO,MAAM;EACvB,IAAI,CAAC,OAAO,OAAO,QAAQ,UAC1B;EAED,MAAM,EAAE,MAAM,UAAU;EACxB,IAAI,OAAO,SAAS,YAAY,OAAO,UAAU,YAAY,MAAM,SAAS,GAC3E,OAAO,IAAI,KAAK,KAAK,GAAG,KAAK;CAE/B;CAEA,QADc,QAAQ,iBAAiB,KAAK,QAAQ,KAAK,IAAI,WAAW,KAAK,MAAM,GACtE,KAAK,UAAU;EAC3B,OAAO,OAAO,IAAI,IAAI,KAAK;EAC3B,OAAO;CACR,EAAE;AACH;;;;;;;;AASA,MAAa,mBAAmB,UAAgC;CAC/D,MAAM,EAAE,MAAM,UAAU,UAAU,SAAiB,EAAE,MAAM,MAAM,KAAK,CAAC;CACvE,MAAM,QAAQ,cAAc,MAAM,OAAO,SAAS,MAAM,KAAK;CAC7D,MAAM,EAAE,MAAMA,iBAAe;CAC7B,MAAM,cAAc,MAAM,iBACvB,EAAE,MAAM,cAAc,IACtB,cAAc,MAAM,OAAO,OAAO,WAAW;CAEhD,MAAM,cAAc,eAAe,CAAC,YACnC,KAAK,UAAU,gBAAgB,qBAAqB,QAAQ,IAAI,GAAG,MAAM,KAAK,CAAC,CAChF;CACA,MAAM,UAAU,cAAc,KAAK,MAAM,WAAW,GAA0B,CAAC,WAAW,CAAC;CAE3F,MAAM,aACL,SAAS,CAAC,QAAQ,MAAM,WAAW,OAAO,UAAU,KAAK,IACtD,CAAC,GAAG,SAAS;EAAE,OAAO;EAAO;CAAM,CAAC,IACpC;CAEJ,MAAM,gBAAgB,aAA6D;EAClF,MAAM,SAAS,MAAM,QAAQ,QAAQ,IAAI,SAAS,KAAK;EACvD,SAAS,SAAU,OAAO,QAAmB,EAAE;CAChD;CAEA,OACC,qBAAC,OAAD;EAAK,WAAU;EAAa,OAAO,EAAE,gBAAgB,OAAO;YAA5D;GACC,oBAAC,YAAD;IAAmB;IAAa;GAAO,CAAA;GACvC,oBAAC,aAAD;IACC,SAAS;IACT,OAAO,WAAW,MAAM,WAAW,OAAO,UAAU,KAAK,KAAK,KAAA;IAC9D,aAAA;IACA,UAAU;GACV,CAAA;GACD,oBAAC,kBAAD;IAA+B;IAAmB;GAAO,CAAA;EACrD;;AAEP"}

package/dist/client/FlowBuilder.d.ts

@@ -6,7 +6,8 @@ type FlowBuilderProps = {
     label?: unknown;
   };
   label?: unknown;
-  conditionTypes: Record<string, ConditionFieldType>;
+  conditionTypes: Record<string, ConditionFieldType>; /** Bare (nameless) block slugs to their display label: an i18n key or a literal. */
+  bareTypeLabels?: Record<string, string>;
 };
 declare const FlowBuilder: (props: FlowBuilderProps) => import("react/jsx-runtime").JSX.Element;
 //#endregion