@10x-media/folder-picker 0.1.0-beta.0

package/dist/folder/useFolderTargets.js

@@ -0,0 +1,126 @@
+"use client";
+import { getTranslation } from "@payloadcms/translations";
+import { toast, useConfig, useFolder, useTranslation } from "@payloadcms/ui";
+import React from "react";
+//#region src/folder/useFolderTargets.ts
+/**
+* `fetch` rejects only on a network failure, so a 401, 403 or 500 arrives as an ordinary response.
+* Left unchecked the caller would clear the selection and reload, presenting a refusal as a
+* success: the same rows, no message, and the user believing the move or the delete happened.
+*/
+const reportFailure = async (response) => {
+	const body = await response.json().catch(() => null);
+	toast.error(body?.errors?.[0]?.message ?? `${response.status} ${response.statusText}`);
+};
+/**
+* What the folder actions operate on, shared by the selection bar and the menu so the two can never
+* disagree.
+*
+* A single click selects a card and a double click opens it, so a selection is the target when
+* there is one and the folder in view is the target otherwise. Editing needs exactly one target,
+* which is why it disappears once several are selected.
+*/
+const useFolderTargets = ({ collectionSlug, currentFolderName, folderCollectionSlug, folderFieldName, onChanged, parentFolderID }) => {
+	const { config, getEntityConfig } = useConfig();
+	const { clearSelections, folderID, getSelectedItems, moveToFolder } = useFolder();
+	const { i18n, t } = useTranslation();
+	const selected = getSelectedItems?.() ?? [];
+	const count = selected.length;
+	const folderLabel = getTranslation(getEntityConfig({ collectionSlug: folderCollectionSlug })?.labels?.singular ?? "", i18n);
+	/**
+	* Editing needs one folder; with none selected that is the folder in view. Read out rather than
+	* indexed twice, so noUncheckedIndexedAccess narrows once for the branch.
+	*
+	* A selected document is not a target. The drawer this feeds is keyed to the folder collection,
+	* so handing it a document's id sends the admin to `?notFound=<id>`, and Payload's own selection
+	* bar hides the action in exactly this case rather than editing the document.
+	*/
+	const [firstSelected] = selected;
+	const editTarget = count === 1 && firstSelected && firstSelected.relationTo === folderCollectionSlug ? {
+		id: firstSelected.value.id,
+		name: String(firstSelected.value._folderOrDocumentTitle ?? "")
+	} : count === 0 && folderID ? {
+		id: folderID,
+		name: currentFolderName
+	} : null;
+	const move = React.useCallback(async (destination) => {
+		const itemsToMove = count > 0 ? selected : [];
+		if (itemsToMove.length > 0) {
+			await moveToFolder({
+				itemsToMove,
+				toFolderID: destination.id ?? void 0
+			});
+			clearSelections();
+			await onChanged(folderID ?? null);
+			return;
+		}
+		if (!folderID) return;
+		const response = await fetch(`${config.routes.api}/${folderCollectionSlug}/${folderID}`, {
+			body: JSON.stringify({ [folderFieldName]: destination.id ?? null }),
+			credentials: "include",
+			headers: { "Content-Type": "application/json" },
+			method: "PATCH"
+		});
+		if (!response.ok) {
+			await reportFailure(response);
+			return;
+		}
+		await onChanged(folderID);
+	}, [
+		clearSelections,
+		config.routes.api,
+		count,
+		folderCollectionSlug,
+		folderFieldName,
+		folderID,
+		moveToFolder,
+		onChanged,
+		selected
+	]);
+	const remove = React.useCallback(async () => {
+		const targets = count > 0 ? selected : folderID ? [{
+			relationTo: folderCollectionSlug,
+			value: { id: folderID }
+		}] : [];
+		if (targets.length === 0) return;
+		for (const item of targets) {
+			const response = await fetch(`${config.routes.api}/${item.relationTo}/${item.value.id}`, {
+				credentials: "include",
+				method: "DELETE"
+			});
+			if (!response.ok) {
+				await reportFailure(response);
+				break;
+			}
+		}
+		clearSelections();
+		await onChanged(count > 0 ? folderID ?? null : parentFolderID ?? null);
+	}, [
+		clearSelections,
+		config.routes.api,
+		count,
+		folderCollectionSlug,
+		folderID,
+		onChanged,
+		parentFolderID,
+		selected
+	]);
+	return {
+		clearSelections,
+		collectionSlug,
+		count,
+		editTarget,
+		folderLabel,
+		hasTarget: count > 0 || Boolean(folderID),
+		move,
+		remove,
+		selected,
+		t,
+		viewFolderID: folderID ?? void 0,
+		viewFolderName: currentFolderName
+	};
+};
+//#endregion
+export { useFolderTargets };
+
+//# sourceMappingURL=useFolderTargets.js.map

package/dist/folder/useFolderTargets.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useFolderTargets.js","names":[],"sources":["../../src/folder/useFolderTargets.ts"],"sourcesContent":["'use client'\n\nimport { getTranslation } from '@payloadcms/translations'\nimport { toast, useConfig, useFolder, useTranslation } from '@payloadcms/ui'\nimport type { CollectionSlug } from 'payload'\nimport type { FolderOrDocument } from 'payload/shared'\nimport React from 'react'\n\n/**\n * `fetch` rejects only on a network failure, so a 401, 403 or 500 arrives as an ordinary response.\n * Left unchecked the caller would clear the selection and reload, presenting a refusal as a\n * success: the same rows, no message, and the user believing the move or the delete happened.\n */\nconst reportFailure = async (response: Response): Promise<void> => {\n\tconst body = (await response.json().catch(() => null)) as null | {\n\t\terrors?: { message?: string }[]\n\t}\n\n\ttoast.error(body?.errors?.[0]?.message ?? `${response.status} ${response.statusText}`)\n}\n\ntype Args = {\n\tcollectionSlug: CollectionSlug\n\tcurrentFolderName: string\n\tfolderCollectionSlug: CollectionSlug\n\t/** `config.folders.fieldName`, which a host is free to rename away from the default `folder`. */\n\tfolderFieldName: string\n\tonChanged: (nextFolderID: null | number | string) => Promise<void> | void\n\tparentFolderID?: number | string\n}\n\n/**\n * What the folder actions operate on, shared by the selection bar and the menu so the two can never\n * disagree.\n *\n * A single click selects a card and a double click opens it, so a selection is the target when\n * there is one and the folder in view is the target otherwise. Editing needs exactly one target,\n * which is why it disappears once several are selected.\n */\nexport const useFolderTargets = ({\n\tcollectionSlug,\n\tcurrentFolderName,\n\tfolderCollectionSlug,\n\tfolderFieldName,\n\tonChanged,\n\tparentFolderID,\n}: Args) => {\n\tconst { config, getEntityConfig } = useConfig()\n\tconst { clearSelections, folderID, getSelectedItems, moveToFolder } = useFolder()\n\tconst { i18n, t } = useTranslation()\n\n\tconst selected: FolderOrDocument[] = getSelectedItems?.() ?? []\n\tconst count = selected.length\n\tconst folderLabel = getTranslation(\n\t\tgetEntityConfig({ collectionSlug: folderCollectionSlug })?.labels?.singular ?? '',\n\t\ti18n\n\t)\n\n\t/**\n\t * Editing needs one folder; with none selected that is the folder in view. Read out rather than\n\t * indexed twice, so noUncheckedIndexedAccess narrows once for the branch.\n\t *\n\t * A selected document is not a target. The drawer this feeds is keyed to the folder collection,\n\t * so handing it a document's id sends the admin to `?notFound=<id>`, and Payload's own selection\n\t * bar hides the action in exactly this case rather than editing the document.\n\t */\n\tconst [firstSelected] = selected\n\tconst editTarget =\n\t\tcount === 1 && firstSelected && firstSelected.relationTo === folderCollectionSlug\n\t\t\t? {\n\t\t\t\t\tid: firstSelected.value.id,\n\t\t\t\t\tname: String(firstSelected.value._folderOrDocumentTitle ?? ''),\n\t\t\t\t}\n\t\t\t: count === 0 && folderID\n\t\t\t\t? { id: folderID, name: currentFolderName }\n\t\t\t\t: null\n\n\tconst move = React.useCallback(\n\t\tasync (destination: { id: null | number | string }) => {\n\t\t\tconst itemsToMove = count > 0 ? selected : []\n\t\t\tif (itemsToMove.length > 0) {\n\t\t\t\tawait moveToFolder({ itemsToMove, toFolderID: destination.id ?? undefined })\n\t\t\t\tclearSelections()\n\t\t\t\tawait onChanged(folderID ?? null)\n\t\t\t\treturn\n\t\t\t}\n\n\t\t\t// Nothing selected: the folder in view is being moved, so follow it. A folder's parent is\n\t\t\t// held in the same configured field its documents use, which the host may have renamed.\n\t\t\tif (!folderID) return\n\t\t\tconst response = await fetch(`${config.routes.api}/${folderCollectionSlug}/${folderID}`, {\n\t\t\t\tbody: JSON.stringify({ [folderFieldName]: destination.id ?? null }),\n\t\t\t\tcredentials: 'include',\n\t\t\t\theaders: { 'Content-Type': 'application/json' },\n\t\t\t\tmethod: 'PATCH',\n\t\t\t})\n\n\t\t\tif (!response.ok) {\n\t\t\t\tawait reportFailure(response)\n\t\t\t\treturn\n\t\t\t}\n\n\t\t\tawait onChanged(folderID)\n\t\t},\n\t\t[\n\t\t\tclearSelections,\n\t\t\tconfig.routes.api,\n\t\t\tcount,\n\t\t\tfolderCollectionSlug,\n\t\t\tfolderFieldName,\n\t\t\tfolderID,\n\t\t\tmoveToFolder,\n\t\t\tonChanged,\n\t\t\tselected,\n\t\t]\n\t)\n\n\tconst remove = React.useCallback(async () => {\n\t\tconst targets =\n\t\t\tcount > 0\n\t\t\t\t? selected\n\t\t\t\t: folderID\n\t\t\t\t\t? [{ relationTo: folderCollectionSlug, value: { id: folderID } }]\n\t\t\t\t\t: []\n\t\tif (targets.length === 0) return\n\n\t\tfor (const item of targets) {\n\t\t\tconst response = await fetch(`${config.routes.api}/${item.relationTo}/${item.value.id}`, {\n\t\t\t\tcredentials: 'include',\n\t\t\t\tmethod: 'DELETE',\n\t\t\t})\n\n\t\t\t// Stopping on the first refusal rather than carrying on: whatever denied one delete, a\n\t\t\t// permission or a relationship, will deny the rest, and the ones already gone still need\n\t\t\t// the view refreshed below.\n\t\t\tif (!response.ok) {\n\t\t\t\tawait reportFailure(response)\n\t\t\t\tbreak\n\t\t\t}\n\t\t}\n\n\t\tclearSelections()\n\t\t// Deleting the folder in view leaves nowhere to stand, so fall back to its parent.\n\t\tawait onChanged(count > 0 ? (folderID ?? null) : (parentFolderID ?? null))\n\t}, [\n\t\tclearSelections,\n\t\tconfig.routes.api,\n\t\tcount,\n\t\tfolderCollectionSlug,\n\t\tfolderID,\n\t\tonChanged,\n\t\tparentFolderID,\n\t\tselected,\n\t])\n\n\treturn {\n\t\tclearSelections,\n\t\tcollectionSlug,\n\t\tcount,\n\t\teditTarget,\n\t\tfolderLabel,\n\t\thasTarget: count > 0 || Boolean(folderID),\n\t\tmove,\n\t\tremove,\n\t\tselected,\n\t\tt,\n\t\tviewFolderID: folderID ?? undefined,\n\t\tviewFolderName: currentFolderName,\n\t}\n}\n"],"mappings":";;;;;;;;;;AAaA,MAAM,gBAAgB,OAAO,aAAsC;CAClE,MAAM,OAAQ,MAAM,SAAS,KAAK,EAAE,YAAY,IAAI;CAIpD,MAAM,MAAM,MAAM,SAAS,IAAI,WAAW,GAAG,SAAS,OAAO,GAAG,SAAS,YAAY;AACtF;;;;;;;;;AAoBA,MAAa,oBAAoB,EAChC,gBACA,mBACA,sBACA,iBACA,WACA,qBACW;CACX,MAAM,EAAE,QAAQ,oBAAoB,UAAU;CAC9C,MAAM,EAAE,iBAAiB,UAAU,kBAAkB,iBAAiB,UAAU;CAChF,MAAM,EAAE,MAAM,MAAM,eAAe;CAEnC,MAAM,WAA+B,mBAAmB,KAAK,CAAC;CAC9D,MAAM,QAAQ,SAAS;CACvB,MAAM,cAAc,eACnB,gBAAgB,EAAE,gBAAgB,qBAAqB,CAAC,GAAG,QAAQ,YAAY,IAC/E,IACD;;;;;;;;;CAUA,MAAM,CAAC,iBAAiB;CACxB,MAAM,aACL,UAAU,KAAK,iBAAiB,cAAc,eAAe,uBAC1D;EACA,IAAI,cAAc,MAAM;EACxB,MAAM,OAAO,cAAc,MAAM,0BAA0B,EAAE;CAC9D,IACC,UAAU,KAAK,WACd;EAAE,IAAI;EAAU,MAAM;CAAkB,IACxC;CAEL,MAAM,OAAO,MAAM,YAClB,OAAO,gBAAgD;EACtD,MAAM,cAAc,QAAQ,IAAI,WAAW,CAAC;EAC5C,IAAI,YAAY,SAAS,GAAG;GAC3B,MAAM,aAAa;IAAE;IAAa,YAAY,YAAY,MAAM,KAAA;GAAU,CAAC;GAC3E,gBAAgB;GAChB,MAAM,UAAU,YAAY,IAAI;GAChC;EACD;EAIA,IAAI,CAAC,UAAU;EACf,MAAM,WAAW,MAAM,MAAM,GAAG,OAAO,OAAO,IAAI,GAAG,qBAAqB,GAAG,YAAY;GACxF,MAAM,KAAK,UAAU,GAAG,kBAAkB,YAAY,MAAM,KAAK,CAAC;GAClE,aAAa;GACb,SAAS,EAAE,gBAAgB,mBAAmB;GAC9C,QAAQ;EACT,CAAC;EAED,IAAI,CAAC,SAAS,IAAI;GACjB,MAAM,cAAc,QAAQ;GAC5B;EACD;EAEA,MAAM,UAAU,QAAQ;CACzB,GACA;EACC;EACA,OAAO,OAAO;EACd;EACA;EACA;EACA;EACA;EACA;EACA;CACD,CACD;CAEA,MAAM,SAAS,MAAM,YAAY,YAAY;EAC5C,MAAM,UACL,QAAQ,IACL,WACA,WACC,CAAC;GAAE,YAAY;GAAsB,OAAO,EAAE,IAAI,SAAS;EAAE,CAAC,IAC9D,CAAC;EACN,IAAI,QAAQ,WAAW,GAAG;EAE1B,KAAK,MAAM,QAAQ,SAAS;GAC3B,MAAM,WAAW,MAAM,MAAM,GAAG,OAAO,OAAO,IAAI,GAAG,KAAK,WAAW,GAAG,KAAK,MAAM,MAAM;IACxF,aAAa;IACb,QAAQ;GACT,CAAC;GAKD,IAAI,CAAC,SAAS,IAAI;IACjB,MAAM,cAAc,QAAQ;IAC5B;GACD;EACD;EAEA,gBAAgB;EAEhB,MAAM,UAAU,QAAQ,IAAK,YAAY,OAAS,kBAAkB,IAAK;CAC1E,GAAG;EACF;EACA,OAAO,OAAO;EACd;EACA;EACA;EACA;EACA;EACA;CACD,CAAC;CAED,OAAO;EACN;EACA;EACA;EACA;EACA;EACA,WAAW,QAAQ,KAAK,QAAQ,QAAQ;EACxC;EACA;EACA;EACA;EACA,cAAc,YAAY,KAAA;EAC1B,gBAAgB;CACjB;AACD"}

package/dist/index.d.ts

@@ -0,0 +1,33 @@
+import { TranslationsOption } from "./translations/index.js";
+
+//#region src/index.d.ts
+type FolderPickerPluginOptions = {
+  /**
+   * Disable the plugin entirely (incoming config returned untouched).
+   * Useful for opting out per environment without removing the plugin call.
+   */
+  disabled?: boolean;
+  /**
+   * Per-locale overrides for this plugin's UI strings, keyed by the typed
+   * translation keys exported from `@10x-media/folder-picker/i18n`. Values win
+   * over the built-in locales key-by-key; locales the plugin does not ship are
+   * added whole. App-level `i18n.translations` still wins over both.
+   */
+  translations?: TranslationsOption;
+};
+declare module 'payload' {
+  interface RegisteredPlugins {
+    '@10x-media/folder-picker': FolderPickerPluginOptions;
+  }
+}
+/**
+ * Folder Picker plugin for Payload v3. Swaps the list view of every folder-enabled
+ * collection so the list drawer browses folders instead of a flat list. Payload
+ * resolves that one component for both the collection route and the drawer, so upload
+ * fields, relationship fields and the lexical upload node are covered without patching
+ * a single field. Authored with `definePlugin` so sibling plugins can detect it by slug.
+ */
+declare const folderPicker: (options: FolderPickerPluginOptions) => import("payload").Plugin;
+//#endregion
+export { FolderPickerPluginOptions, type FolderPickerPluginOptions as PluginOptions, folderPicker };
+//# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -0,0 +1,24 @@
+import { registerFolderListView } from "./plugin/registerFolderListView.js";
+import { registerTranslations } from "./plugin/registerTranslations.js";
+import { definePlugin } from "payload";
+//#region src/index.ts
+/**
+* Folder Picker plugin for Payload v3. Swaps the list view of every folder-enabled
+* collection so the list drawer browses folders instead of a flat list. Payload
+* resolves that one component for both the collection route and the drawer, so upload
+* fields, relationship fields and the lexical upload node are covered without patching
+* a single field. Authored with `definePlugin` so sibling plugins can detect it by slug.
+*/
+const folderPicker = definePlugin({
+	slug: "@10x-media/folder-picker",
+	plugin: ({ config, plugins: _plugins, ...options }) => {
+		if (options.disabled === true) return config;
+		registerTranslations(config, options.translations);
+		registerFolderListView(config);
+		return config;
+	}
+});
+//#endregion
+export { folderPicker };
+
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../src/index.ts"],"sourcesContent":["import { type Config, definePlugin } from 'payload'\nimport { registerFolderListView } from './plugin/registerFolderListView'\nimport { registerTranslations } from './plugin/registerTranslations'\nimport type { TranslationsOption } from './translations'\nexport type FolderPickerPluginOptions = {\n\t/**\n\t * Disable the plugin entirely (incoming config returned untouched).\n\t * Useful for opting out per environment without removing the plugin call.\n\t */\n\tdisabled?: boolean\n\t/**\n\t * Per-locale overrides for this plugin's UI strings, keyed by the typed\n\t * translation keys exported from `@10x-media/folder-picker/i18n`. Values win\n\t * over the built-in locales key-by-key; locales the plugin does not ship are\n\t * added whole. App-level `i18n.translations` still wins over both.\n\t */\n\ttranslations?: TranslationsOption\n}\n\ndeclare module 'payload' {\n\tinterface RegisteredPlugins {\n\t\t'@10x-media/folder-picker': FolderPickerPluginOptions\n\t}\n}\n\n/**\n * Folder Picker plugin for Payload v3. Swaps the list view of every folder-enabled\n * collection so the list drawer browses folders instead of a flat list. Payload\n * resolves that one component for both the collection route and the drawer, so upload\n * fields, relationship fields and the lexical upload node are covered without patching\n * a single field. Authored with `definePlugin` so sibling plugins can detect it by slug.\n */\nexport const folderPicker = definePlugin<FolderPickerPluginOptions>({\n\tslug: '@10x-media/folder-picker',\n\tplugin: ({ config, plugins: _plugins, ...options }): Config => {\n\t\tif (options.disabled === true) {\n\t\t\treturn config\n\t\t}\n\t\tregisterTranslations(config, options.translations)\n\n\t\tregisterFolderListView(config)\n\t\treturn config\n\t},\n})\n\nexport type { FolderPickerPluginOptions as PluginOptions }\n"],"mappings":";;;;;;;;;;;AAgCA,MAAa,eAAe,aAAwC;CACnE,MAAM;CACN,SAAS,EAAE,QAAQ,SAAS,UAAU,GAAG,cAAsB;EAC9D,IAAI,QAAQ,aAAa,MACxB,OAAO;EAER,qBAAqB,QAAQ,QAAQ,YAAY;EAEjD,uBAAuB,MAAM;EAC7B,OAAO;CACR;AACD,CAAC"}

package/dist/plugin/registerFolderListView.js

@@ -0,0 +1,36 @@
+//#region src/plugin/registerFolderListView.ts
+const LIST_VIEW = "@10x-media/folder-picker/client#FolderListView";
+/**
+* Gives every folder-enabled collection a list view that offers folder browsing inside a list
+* drawer. Payload renders `admin.components.views.list.Component` for both the list route and the
+* drawer, so one component covers the upload field's "choose from existing" without touching the
+* upload field itself. Collections that already declare a custom list view are left alone.
+*/
+const registerFolderListView = (config) => {
+	if (!config.folders) return;
+	config.collections = config.collections?.map((collection) => {
+		if (!collection.folders) return collection;
+		const views = collection.admin?.components?.views;
+		if (views?.list?.Component) return collection;
+		return {
+			...collection,
+			admin: {
+				...collection.admin,
+				components: {
+					...collection.admin?.components,
+					views: {
+						...views,
+						list: {
+							...views?.list,
+							Component: LIST_VIEW
+						}
+					}
+				}
+			}
+		};
+	});
+};
+//#endregion
+export { registerFolderListView };
+
+//# sourceMappingURL=registerFolderListView.js.map

package/dist/plugin/registerFolderListView.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registerFolderListView.js","names":[],"sources":["../../src/plugin/registerFolderListView.ts"],"sourcesContent":["import type { Config } from 'payload'\n\nconst LIST_VIEW = '@10x-media/folder-picker/client#FolderListView'\n\n/**\n * Gives every folder-enabled collection a list view that offers folder browsing inside a list\n * drawer. Payload renders `admin.components.views.list.Component` for both the list route and the\n * drawer, so one component covers the upload field's \"choose from existing\" without touching the\n * upload field itself. Collections that already declare a custom list view are left alone.\n */\nexport const registerFolderListView = (config: Config): void => {\n\tif (!config.folders) {\n\t\treturn\n\t}\n\n\tconfig.collections = config.collections?.map((collection) => {\n\t\tif (!collection.folders) {\n\t\t\treturn collection\n\t\t}\n\n\t\tconst views = collection.admin?.components?.views\n\t\tif (views?.list?.Component) {\n\t\t\treturn collection\n\t\t}\n\n\t\treturn {\n\t\t\t...collection,\n\t\t\tadmin: {\n\t\t\t\t...collection.admin,\n\t\t\t\tcomponents: {\n\t\t\t\t\t...collection.admin?.components,\n\t\t\t\t\tviews: {\n\t\t\t\t\t\t...views,\n\t\t\t\t\t\tlist: { ...views?.list, Component: LIST_VIEW },\n\t\t\t\t\t},\n\t\t\t\t},\n\t\t\t},\n\t\t}\n\t})\n}\n"],"mappings":";AAEA,MAAM,YAAY;;;;;;;AAQlB,MAAa,0BAA0B,WAAyB;CAC/D,IAAI,CAAC,OAAO,SACX;CAGD,OAAO,cAAc,OAAO,aAAa,KAAK,eAAe;EAC5D,IAAI,CAAC,WAAW,SACf,OAAO;EAGR,MAAM,QAAQ,WAAW,OAAO,YAAY;EAC5C,IAAI,OAAO,MAAM,WAChB,OAAO;EAGR,OAAO;GACN,GAAG;GACH,OAAO;IACN,GAAG,WAAW;IACd,YAAY;KACX,GAAG,WAAW,OAAO;KACrB,OAAO;MACN,GAAG;MACH,MAAM;OAAE,GAAG,OAAO;OAAM,WAAW;MAAU;KAC9C;IACD;GACD;EACD;CACD,CAAC;AACF"}

package/dist/plugin/registerTranslations.js

@@ -0,0 +1,19 @@
+import { toNested, translations } from "../translations/index.js";
+import { deepMergeSimple } from "payload/shared";
+//#region src/plugin/registerTranslations.ts
+/**
+* Merge this plugin's translations into the host config. Plugin-level
+* `overrides` win over the built-ins key-by-key and may add locales the plugin
+* does not ship. A host value wins over both (`deepMergeSimple` lets the second
+* argument override), so projects can override any string.
+*/
+const registerTranslations = (config, overrides) => {
+	const nested = {};
+	for (const [locale, flat] of Object.entries(overrides ?? {})) nested[locale] = toNested(flat);
+	config.i18n ??= {};
+	config.i18n.translations = deepMergeSimple(deepMergeSimple(translations, nested), config.i18n.translations ?? {});
+};
+//#endregion
+export { registerTranslations };
+
+//# sourceMappingURL=registerTranslations.js.map

package/dist/plugin/registerTranslations.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registerTranslations.js","names":[],"sources":["../../src/plugin/registerTranslations.ts"],"sourcesContent":["import type { Config } from 'payload'\nimport { deepMergeSimple } from 'payload/shared'\n\nimport { type TranslationsOption, toNested, translations } from '../translations'\n\ntype Translations = NonNullable<NonNullable<Config['i18n']>['translations']>\n\n/**\n * Merge this plugin's translations into the host config. Plugin-level\n * `overrides` win over the built-ins key-by-key and may add locales the plugin\n * does not ship. A host value wins over both (`deepMergeSimple` lets the second\n * argument override), so projects can override any string.\n */\nexport const registerTranslations = (config: Config, overrides?: TranslationsOption): void => {\n\tconst nested: Record<string, Record<string, Record<string, string>>> = {}\n\tfor (const [locale, flat] of Object.entries(overrides ?? {})) {\n\t\tnested[locale] = toNested(flat)\n\t}\n\tconfig.i18n ??= {}\n\tconfig.i18n.translations = deepMergeSimple<Translations>(\n\t\tdeepMergeSimple(translations, nested),\n\t\tconfig.i18n.translations ?? {}\n\t)\n}\n"],"mappings":";;;;;;;;;AAaA,MAAa,wBAAwB,QAAgB,cAAyC;CAC7F,MAAM,SAAiE,CAAC;CACxE,KAAK,MAAM,CAAC,QAAQ,SAAS,OAAO,QAAQ,aAAa,CAAC,CAAC,GAC1D,OAAO,UAAU,SAAS,IAAI;CAE/B,OAAO,SAAS,CAAC;CACjB,OAAO,KAAK,eAAe,gBAC1B,gBAAgB,cAAc,MAAM,GACpC,OAAO,KAAK,gBAAgB,CAAC,CAC9B;AACD"}

package/dist/translations/de.js

@@ -0,0 +1,15 @@
+import { keys } from "./keys.js";
+//#region src/translations/de.ts
+const de = {
+	[keys.gridView]: "Als Raster anzeigen",
+	[keys.listView]: "Als Liste anzeigen",
+	[keys.orderLabel]: "Reihenfolge",
+	[keys.pickManyHint]: "{{modifier}} halten, um mehrere auszuwählen, {{range}} für einen Bereich.",
+	[keys.pluginName]: "Ordnerauswahl",
+	[keys.retry]: "Erneut versuchen",
+	[keys.sortByLabel]: "Sortieren nach"
+};
+//#endregion
+export { de };
+
+//# sourceMappingURL=de.js.map

package/dist/translations/de.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"de.js","names":[],"sources":["../../src/translations/de.ts"],"sourcesContent":["import { keys, type TranslationKey } from './keys'\n\nexport const de: Record<TranslationKey, string> = {\n\t[keys.gridView]: 'Als Raster anzeigen',\n\t[keys.listView]: 'Als Liste anzeigen',\n\t[keys.orderLabel]: 'Reihenfolge',\n\t[keys.pickManyHint]: '{{modifier}} halten, um mehrere auszuwählen, {{range}} für einen Bereich.',\n\t[keys.pluginName]: 'Ordnerauswahl',\n\t[keys.retry]: 'Erneut versuchen',\n\t[keys.sortByLabel]: 'Sortieren nach',\n}\n"],"mappings":";;AAEA,MAAa,KAAqC;EAChD,KAAK,WAAW;EAChB,KAAK,WAAW;EAChB,KAAK,aAAa;EAClB,KAAK,eAAe;EACpB,KAAK,aAAa;EAClB,KAAK,QAAQ;EACb,KAAK,cAAc;AACrB"}

package/dist/translations/en.js

@@ -0,0 +1,20 @@
+import { keys } from "./keys.js";
+//#region src/translations/en.ts
+/**
+* English values, keyed by the typed constants in `keys.ts` so the two stay in
+* lockstep. The `Record<TranslationKey, string>` annotation makes a missing or
+* unknown key a type error. `translations/index.ts` nests these for Payload.
+*/
+const en = {
+	[keys.gridView]: "Show as grid",
+	[keys.listView]: "Show as list",
+	[keys.orderLabel]: "Order",
+	[keys.pickManyHint]: "Hold {{modifier}} to pick more than one, {{range}} to pick a range.",
+	[keys.pluginName]: "Folder Picker",
+	[keys.retry]: "Try again",
+	[keys.sortByLabel]: "Sort by"
+};
+//#endregion
+export { en };
+
+//# sourceMappingURL=en.js.map

package/dist/translations/en.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"en.js","names":[],"sources":["../../src/translations/en.ts"],"sourcesContent":["import { keys, type TranslationKey } from './keys'\n\n/**\n * English values, keyed by the typed constants in `keys.ts` so the two stay in\n * lockstep. The `Record<TranslationKey, string>` annotation makes a missing or\n * unknown key a type error. `translations/index.ts` nests these for Payload.\n */\nexport const en: Record<TranslationKey, string> = {\n\t[keys.gridView]: 'Show as grid',\n\t[keys.listView]: 'Show as list',\n\t[keys.orderLabel]: 'Order',\n\t[keys.pickManyHint]: 'Hold {{modifier}} to pick more than one, {{range}} to pick a range.',\n\t[keys.pluginName]: 'Folder Picker',\n\t[keys.retry]: 'Try again',\n\t[keys.sortByLabel]: 'Sort by',\n}\n"],"mappings":";;;;;;;AAOA,MAAa,KAAqC;EAChD,KAAK,WAAW;EAChB,KAAK,WAAW;EAChB,KAAK,aAAa;EAClB,KAAK,eAAe;EACpB,KAAK,aAAa;EAClB,KAAK,QAAQ;EACb,KAAK,cAAc;AACrB"}

package/dist/translations/index.d.ts

@@ -0,0 +1,16 @@
+import { TranslationKey, keys } from "./keys.js";
+
+//#region src/translations/index.d.ts
+/** Per-locale string overrides keyed by this plugin's typed translation keys. */
+type TranslationsOption = {
+  [locale: string]: Partial<Record<TranslationKey, string>>;
+};
+/** Per-locale messages merged into `config.i18n.translations`. */
+declare const translations: {
+  de: Record<string, Record<string, string>>;
+  en: Record<string, Record<string, string>>;
+  uk: Record<string, Record<string, string>>;
+};
+//#endregion
+export { TranslationsOption, translations };
+//# sourceMappingURL=index.d.ts.map

package/dist/translations/index.js

@@ -0,0 +1,35 @@
+import "./keys.js";
+import { de } from "./de.js";
+import { en } from "./en.js";
+import { uk } from "./uk.js";
+//#region src/translations/index.ts
+/**
+* Flat `folderPicker:foo` entries to the nested `{ folderPicker: { foo } }`
+* shape Payload resolves `t('folderPicker:foo')` against (it splits on `:`).
+* Undefined values are skipped so `Partial` override maps pass through.
+* A key with no `:` has no namespace to nest under, so it is dropped rather than
+* split at -1, which would file it under the key with its last character shaved off.
+*/
+const toNested = (flat) => {
+	const out = {};
+	for (const [fullKey, value] of Object.entries(flat)) {
+		if (typeof value !== "string") continue;
+		const separator = fullKey.indexOf(":");
+		if (separator < 1) continue;
+		const namespace = fullKey.slice(0, separator);
+		const bucket = out[namespace] ?? {};
+		bucket[fullKey.slice(separator + 1)] = value;
+		out[namespace] = bucket;
+	}
+	return out;
+};
+/** Per-locale messages merged into `config.i18n.translations`. */
+const translations = {
+	de: toNested(de),
+	en: toNested(en),
+	uk: toNested(uk)
+};
+//#endregion
+export { toNested, translations };
+
+//# sourceMappingURL=index.js.map

package/dist/translations/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","names":[],"sources":["../../src/translations/index.ts"],"sourcesContent":["import { de } from './de'\nimport { en } from './en'\nimport type { TranslationKey } from './keys'\nimport { uk } from './uk'\n\nexport type { TranslationKey } from './keys'\nexport { keys } from './keys'\n\n/** Per-locale string overrides keyed by this plugin's typed translation keys. */\nexport type TranslationsOption = {\n\t[locale: string]: Partial<Record<TranslationKey, string>>\n}\n\n/**\n * Flat `folderPicker:foo` entries to the nested `{ folderPicker: { foo } }`\n * shape Payload resolves `t('folderPicker:foo')` against (it splits on `:`).\n * Undefined values are skipped so `Partial` override maps pass through.\n * A key with no `:` has no namespace to nest under, so it is dropped rather than\n * split at -1, which would file it under the key with its last character shaved off.\n */\nexport const toNested = (flat: {\n\t[key: string]: string | undefined\n}): Record<string, Record<string, string>> => {\n\tconst out: Record<string, Record<string, string>> = {}\n\tfor (const [fullKey, value] of Object.entries(flat)) {\n\t\tif (typeof value !== 'string') {\n\t\t\tcontinue\n\t\t}\n\t\tconst separator = fullKey.indexOf(':')\n\t\tif (separator < 1) {\n\t\t\tcontinue\n\t\t}\n\t\tconst namespace = fullKey.slice(0, separator)\n\t\tconst bucket = out[namespace] ?? {}\n\t\tbucket[fullKey.slice(separator + 1)] = value\n\t\tout[namespace] = bucket\n\t}\n\treturn out\n}\n\n/** Per-locale messages merged into `config.i18n.translations`. */\nexport const translations = {\n\tde: toNested(de),\n\ten: toNested(en),\n\tuk: toNested(uk),\n}\n"],"mappings":";;;;;;;;;;;;AAoBA,MAAa,YAAY,SAEqB;CAC7C,MAAM,MAA8C,CAAC;CACrD,KAAK,MAAM,CAAC,SAAS,UAAU,OAAO,QAAQ,IAAI,GAAG;EACpD,IAAI,OAAO,UAAU,UACpB;EAED,MAAM,YAAY,QAAQ,QAAQ,GAAG;EACrC,IAAI,YAAY,GACf;EAED,MAAM,YAAY,QAAQ,MAAM,GAAG,SAAS;EAC5C,MAAM,SAAS,IAAI,cAAc,CAAC;EAClC,OAAO,QAAQ,MAAM,YAAY,CAAC,KAAK;EACvC,IAAI,aAAa;CAClB;CACA,OAAO;AACR;;AAGA,MAAa,eAAe;CAC3B,IAAI,SAAS,EAAE;CACf,IAAI,SAAS,EAAE;CACf,IAAI,SAAS,EAAE;AAChB"}

package/dist/translations/keys.d.ts

@@ -0,0 +1,19 @@
+//#region src/translations/keys.d.ts
+/**
+ * Typed translation keys. Lookups must go through these constants, not string
+ * literals (enforced by requireI18nKeysTyped.grit). Every key here must have a
+ * value in every locale (`en.ts`), or it is a type error.
+ */
+declare const keys: {
+  readonly gridView: "folderPicker:gridView";
+  readonly listView: "folderPicker:listView";
+  readonly orderLabel: "folderPicker:orderLabel";
+  readonly pickManyHint: "folderPicker:pickManyHint";
+  readonly pluginName: "folderPicker:pluginName";
+  readonly retry: "folderPicker:retry";
+  readonly sortByLabel: "folderPicker:sortByLabel";
+};
+type TranslationKey = (typeof keys)[keyof typeof keys];
+//#endregion
+export { TranslationKey, keys };
+//# sourceMappingURL=keys.d.ts.map

package/dist/translations/keys.js

@@ -0,0 +1,19 @@
+//#region src/translations/keys.ts
+/**
+* Typed translation keys. Lookups must go through these constants, not string
+* literals (enforced by requireI18nKeysTyped.grit). Every key here must have a
+* value in every locale (`en.ts`), or it is a type error.
+*/
+const keys = {
+	gridView: "folderPicker:gridView",
+	listView: "folderPicker:listView",
+	orderLabel: "folderPicker:orderLabel",
+	pickManyHint: "folderPicker:pickManyHint",
+	pluginName: "folderPicker:pluginName",
+	retry: "folderPicker:retry",
+	sortByLabel: "folderPicker:sortByLabel"
+};
+//#endregion
+export { keys };
+
+//# sourceMappingURL=keys.js.map

package/dist/translations/keys.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.js","names":[],"sources":["../../src/translations/keys.ts"],"sourcesContent":["/**\n * Typed translation keys. Lookups must go through these constants, not string\n * literals (enforced by requireI18nKeysTyped.grit). Every key here must have a\n * value in every locale (`en.ts`), or it is a type error.\n */\nexport const keys = {\n\tgridView: 'folderPicker:gridView',\n\tlistView: 'folderPicker:listView',\n\torderLabel: 'folderPicker:orderLabel',\n\tpickManyHint: 'folderPicker:pickManyHint',\n\tpluginName: 'folderPicker:pluginName',\n\tretry: 'folderPicker:retry',\n\tsortByLabel: 'folderPicker:sortByLabel',\n} as const\n\nexport type TranslationKey = (typeof keys)[keyof typeof keys]\n"],"mappings":";;;;;;AAKA,MAAa,OAAO;CACnB,UAAU;CACV,UAAU;CACV,YAAY;CACZ,cAAc;CACd,YAAY;CACZ,OAAO;CACP,aAAa;AACd"}

package/dist/translations/uk.js

@@ -0,0 +1,15 @@
+import { keys } from "./keys.js";
+//#region src/translations/uk.ts
+const uk = {
+	[keys.gridView]: "Показати сіткою",
+	[keys.listView]: "Показати списком",
+	[keys.orderLabel]: "Порядок",
+	[keys.pickManyHint]: "Утримуйте {{modifier}}, щоб вибрати кілька, {{range}} для діапазону.",
+	[keys.pluginName]: "Вибір теки",
+	[keys.retry]: "Спробувати ще раз",
+	[keys.sortByLabel]: "Сортувати за"
+};
+//#endregion
+export { uk };
+
+//# sourceMappingURL=uk.js.map

package/dist/translations/uk.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"uk.js","names":[],"sources":["../../src/translations/uk.ts"],"sourcesContent":["import { keys, type TranslationKey } from './keys'\n\nexport const uk: Record<TranslationKey, string> = {\n\t[keys.gridView]: 'Показати сіткою',\n\t[keys.listView]: 'Показати списком',\n\t[keys.orderLabel]: 'Порядок',\n\t[keys.pickManyHint]: 'Утримуйте {{modifier}}, щоб вибрати кілька, {{range}} для діапазону.',\n\t[keys.pluginName]: 'Вибір теки',\n\t[keys.retry]: 'Спробувати ще раз',\n\t[keys.sortByLabel]: 'Сортувати за',\n}\n"],"mappings":";;AAEA,MAAa,KAAqC;EAChD,KAAK,WAAW;EAChB,KAAK,WAAW;EAChB,KAAK,aAAa;EAClB,KAAK,eAAe;EACpB,KAAK,aAAa;EAClB,KAAK,QAAQ;EACb,KAAK,cAAc;AACrB"}

package/dist/translations/useTranslation.js

@@ -0,0 +1,12 @@
+"use client";
+import { useTranslation } from "@payloadcms/ui";
+//#region src/translations/useTranslation.ts
+/**
+* `useTranslation` bound to this plugin's keys, so `t(keys.X)` typechecks without
+* a per-call `@ts-expect-error`. Returns Payload's `{ t, i18n }` unchanged.
+*/
+const useTranslation$1 = () => useTranslation();
+//#endregion
+export { useTranslation$1 as useTranslation };
+
+//# sourceMappingURL=useTranslation.js.map

package/dist/translations/useTranslation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useTranslation.js","names":["useTranslation","usePayloadTranslation"],"sources":["../../src/translations/useTranslation.ts"],"sourcesContent":["'use client'\n\nimport { useTranslation as usePayloadTranslation } from '@payloadcms/ui'\n\nimport type { TranslationKey } from './keys'\n\n/**\n * `useTranslation` bound to this plugin's keys, so `t(keys.X)` typechecks without\n * a per-call `@ts-expect-error`. Returns Payload's `{ t, i18n }` unchanged.\n */\nexport const useTranslation = () => usePayloadTranslation<Record<string, never>, TranslationKey>()\n"],"mappings":";;;;;;;AAUA,MAAaA,yBAAuBC,eAA6D"}

package/package.json

@@ -0,0 +1,110 @@
+{
+  "name": "@10x-media/folder-picker",
+  "version": "0.1.0-beta.0",
+  "description": "Browse and select files through your folder hierarchy directly inside Payload CMS upload fields",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/10x-media/payload-plugins.git",
+    "directory": "packages/folder-picker"
+  },
+  "homepage": "https://github.com/10x-media/payload-plugins/tree/main/packages/folder-picker",
+  "bugs": "https://github.com/10x-media/payload-plugins/issues",
+  "keywords": [
+    "payload",
+    "payloadcms",
+    "plugin"
+  ],
+  "author": "10x-media",
+  "engines": {
+    "node": ">=22.18.0"
+  },
+  "type": "module",
+  "sideEffects": false,
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./types": {
+      "types": "./dist/exports/types.d.ts",
+      "import": "./dist/exports/types.js",
+      "default": "./dist/exports/types.js"
+    },
+    "./client": {
+      "types": "./dist/exports/client.d.ts",
+      "import": "./dist/exports/client.js",
+      "default": "./dist/exports/client.js"
+    },
+    "./i18n": {
+      "types": "./dist/exports/i18n.d.ts",
+      "import": "./dist/exports/i18n.js",
+      "default": "./dist/exports/i18n.js"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "CHANGELOG.md",
+    "LICENSE"
+  ],
+  "peerDependencies": {
+    "@dnd-kit/core": "6.3.1",
+    "@payloadcms/translations": "^3.83.0",
+    "@payloadcms/ui": "^3.83.0",
+    "payload": "^3.83.0",
+    "react": "^19.0.0",
+    "react-dom": "^19.0.0"
+  },
+  "devDependencies": {
+    "@dnd-kit/core": "6.3.1",
+    "@payloadcms/db-mongodb": "3.85.0",
+    "@payloadcms/db-postgres": "3.85.0",
+    "@payloadcms/ui": "3.85.0",
+    "@playwright/test": "1.60.0",
+    "@payloadcms/translations": "3.85.0",
+    "@types/node": "22.19.19",
+    "@types/react": "19.2.15",
+    "@types/react-dom": "19.2.3",
+    "payload": "3.85.0",
+    "playwright": "1.60.0",
+    "react": "19.2.6",
+    "react-dom": "19.2.6",
+    "tsdown": "0.22.1",
+    "typescript": "5.9.3",
+    "vitest": "4.1.7",
+    "@10x-media/tsdown-config": "0.0.0",
+    "@10x-media/payload-test-harness": "0.0.0",
+    "@10x-media/tsconfig": "0.0.0",
+    "@10x-media/vitest-config": "0.0.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsdown",
+    "lint": "biome check src tests dev",
+    "lint:fix": "biome check --write src tests dev",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "test:unit": "vitest run src",
+    "test:int": "vitest run tests/int",
+    "test:matrix": "DB_MATRIX=mongo vitest run tests/int/matrix.int.spec.ts && DB_MATRIX=postgres vitest run tests/int/matrix.int.spec.ts",
+    "test:container": "TEST_DB=container DB_MATRIX=mongo vitest run tests/int/matrix.int.spec.ts && TEST_DB=container DB_MATRIX=postgres vitest run tests/int/matrix.int.spec.ts",
+    "test:e2e": "bash scripts/e2e.sh",
+    "dev": "pnpm --filter @10x-media/folder-picker-dev dev",
+    "start": "pnpm --filter @10x-media/folder-picker-dev start",
+    "generate": "pnpm --filter @10x-media/folder-picker-dev generate",
+    "generate:types": "pnpm --filter @10x-media/folder-picker-dev generate:types",
+    "generate:importmap": "pnpm --filter @10x-media/folder-picker-dev generate:importmap",
+    "migrate": "pnpm --filter @10x-media/folder-picker-dev migrate",
+    "migrate:create": "pnpm --filter @10x-media/folder-picker-dev migrate:create",
+    "migrate:down": "pnpm --filter @10x-media/folder-picker-dev migrate:down",
+    "migrate:refresh": "pnpm --filter @10x-media/folder-picker-dev migrate:refresh",
+    "migrate:reset": "pnpm --filter @10x-media/folder-picker-dev migrate:reset",
+    "migrate:status": "pnpm --filter @10x-media/folder-picker-dev migrate:status",
+    "migrate:fresh": "pnpm --filter @10x-media/folder-picker-dev migrate:fresh",
+    "clean": "rm -rf dist *.tsbuildinfo dev/.next"
+  }
+}