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

package/dist/client/RecipientsSelect.js

@@ -0,0 +1,197 @@
+"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
+/** A source label is a plain string or a per-locale record; resolve it for the admin UI language. */
+const resolveSourceLabel = (label, language) => typeof label === "string" ? label : label[language] ?? label.en ?? Object.values(label)[0] ?? "";
+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, i18n } = useTranslation$1();
+	const sourceOptions = useMemo(() => (props.sources ?? []).map((source) => ({
+		value: source.value,
+		label: resolveSourceLabel(source.label, i18n.language)
+	})), [props.sources, i18n.language]);
+	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" });
+	const scope = props.scope ?? "document";
+	const docId = scope === "request" ? void 0 : id;
+	useEffect(() => {
+		if (!props.endpoint || !collectionSlug || scope === "document" && docId == null) return;
+		const controller = new AbortController();
+		const url = buildEndpointOptionsUrl({
+			apiRoute,
+			collectionSlug,
+			id: docId,
+			scope,
+			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,
+		docId,
+		scope,
+		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,
+			...sourceOptions
+		]) map.set(option.value, option);
+		return map;
+	}, [
+		presetOptions,
+		tokenOptions,
+		sourceOptions
+	]);
+	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
+		});
+		if (sourceOptions.length > 0) groups.push({
+			label: t(keys.recipientsGroupSources),
+			options: sourceOptions
+		});
+		return groups;
+	}, [
+		presetOptions,
+		tokenOptions,
+		sourceOptions,
+		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\ttype EndpointOptionsScope,\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/** What the endpoint's options depend on; see {@link EndpointOptionsScope}. Default `'document'`. */\n\tscope?: EndpointOptionsScope\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\t/** Registered recipient sources, offered as their own option group (labels resolved for the admin locale). */\n\tsources?: { value: string; label: string | Record<string, string> }[]\n\tdescriptionKey?: TranslationKey\n}\n\n/** A source label is a plain string or a per-locale record; resolve it for the admin UI language. */\nconst resolveSourceLabel = (label: string | Record<string, string>, language: string): string =>\n\ttypeof label === 'string' ? label : (label[language] ?? label.en ?? Object.values(label)[0] ?? '')\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, i18n } = useTranslation()\n\tconst sourceOptions: ReactSelectOption[] = useMemo(\n\t\t() =>\n\t\t\t(props.sources ?? []).map((source) => ({\n\t\t\t\tvalue: source.value,\n\t\t\t\tlabel: resolveSourceLabel(source.label, i18n.language),\n\t\t\t})),\n\t\t[props.sources, i18n.language]\n\t)\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\tconst scope = props.scope ?? 'document'\n\t// Request scope never puts the id in the URL; deriving undefined here keeps the effect from\n\t// re-fetching when the first save assigns one.\n\tconst docId = scope === 'request' ? undefined : id\n\n\tuseEffect(() => {\n\t\tif (!props.endpoint || !collectionSlug || (scope === 'document' && docId == null)) {\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: docId,\n\t\t\tscope,\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, docId, scope, 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, ...sourceOptions]) {\n\t\t\tmap.set(option.value as string, option)\n\t\t}\n\t\treturn map\n\t}, [presetOptions, tokenOptions, sourceOptions])\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\tif (sourceOptions.length > 0) {\n\t\t\tgroups.push({ label: t(keys.recipientsGroupSources), options: sourceOptions })\n\t\t}\n\t\treturn groups\n\t}, [presetOptions, tokenOptions, sourceOptions, 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"}