@pro-laico/payload-icons 0.0.0

package/dist/lib/mergeHooks.d.ts

@@ -0,0 +1,8 @@
+import type { CollectionConfig } from 'payload';
+type Hooks = NonNullable<CollectionConfig['hooks']>;
+/** Append the user's collection hooks AFTER the built-ins, per phase. The built-ins always run
+ *  first, so a user `beforeChange` hook sees the already-optimized SVG. Phases with no built-in
+ *  just carry the user's hooks. */
+export declare const mergeHooks: (base: Hooks, extra?: CollectionConfig["hooks"]) => Hooks;
+export {};
+//# sourceMappingURL=mergeHooks.d.ts.map

package/dist/lib/mergeHooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mergeHooks.d.ts","sourceRoot":"","sources":["../../src/lib/mergeHooks.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAA;AAE/C,KAAK,KAAK,GAAG,WAAW,CAAC,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAA;AAEnD;;mCAEmC;AACnC,eAAO,MAAM,UAAU,GAAI,MAAM,KAAK,EAAE,QAAQ,gBAAgB,CAAC,OAAO,CAAC,KAAG,KAS3E,CAAA"}

package/dist/lib/mergeHooks.js

@@ -0,0 +1,19 @@
+/** Append the user's collection hooks AFTER the built-ins, per phase. The built-ins always run
+ *  first, so a user `beforeChange` hook sees the already-optimized SVG. Phases with no built-in
+ *  just carry the user's hooks. */ export const mergeHooks = (base, extra)=>{
+    if (!extra) return base;
+    const out = {
+        ...base
+    };
+    for (const phase of Object.keys(extra)){
+        const basePhase = base[phase] ?? [];
+        const extraPhase = extra[phase] ?? [];
+        out[phase] = [
+            ...basePhase,
+            ...extraPhase
+        ];
+    }
+    return out;
+};
+
+//# sourceMappingURL=mergeHooks.js.map

package/dist/lib/mergeHooks.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/mergeHooks.ts"],"sourcesContent":["import type { CollectionConfig } from 'payload'\n\ntype Hooks = NonNullable<CollectionConfig['hooks']>\n\n/** Append the user's collection hooks AFTER the built-ins, per phase. The built-ins always run\n *  first, so a user `beforeChange` hook sees the already-optimized SVG. Phases with no built-in\n *  just carry the user's hooks. */\nexport const mergeHooks = (base: Hooks, extra?: CollectionConfig['hooks']): Hooks => {\n  if (!extra) return base\n  const out: Hooks = { ...base }\n  for (const phase of Object.keys(extra) as Array<keyof Hooks>) {\n    const basePhase = (base[phase] ?? []) as unknown[]\n    const extraPhase = (extra[phase] ?? []) as unknown[]\n    out[phase] = [...basePhase, ...extraPhase] as never\n  }\n  return out\n}\n"],"names":["mergeHooks","base","extra","out","phase","Object","keys","basePhase","extraPhase"],"mappings":"AAIA;;iCAEiC,GACjC,OAAO,MAAMA,aAAa,CAACC,MAAaC;IACtC,IAAI,CAACA,OAAO,OAAOD;IACnB,MAAME,MAAa;QAAE,GAAGF,IAAI;IAAC;IAC7B,KAAK,MAAMG,SAASC,OAAOC,IAAI,CAACJ,OAA8B;QAC5D,MAAMK,YAAaN,IAAI,CAACG,MAAM,IAAI,EAAE;QACpC,MAAMI,aAAcN,KAAK,CAACE,MAAM,IAAI,EAAE;QACtCD,GAAG,CAACC,MAAM,GAAG;eAAIG;eAAcC;SAAW;IAC5C;IACA,OAAOL;AACT,EAAC"}

package/dist/lib/titleCase.d.ts

@@ -0,0 +1,7 @@
+/** Normalize a free-form icon name to kebab-case (`Arrow Right` / `arrowRight` -> `arrow-right`),
+ *  so the name an editor types in an `iconsArray` row matches the name used in `<Icon name>`. */
+export declare const toKebabCase: (input?: string | null) => string;
+/** Humanize a kebab/camel/snake icon name into Title Case for admin labels
+ *  (`arrow-right` -> `Arrow Right`). Pure string work, no deps. */
+export declare const toTitleCase: (input?: string | null) => string;
+//# sourceMappingURL=titleCase.d.ts.map

package/dist/lib/titleCase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"titleCase.d.ts","sourceRoot":"","sources":["../../src/lib/titleCase.ts"],"names":[],"mappings":"AAAA;iGACiG;AACjG,eAAO,MAAM,WAAW,GAAI,QAAQ,MAAM,GAAG,IAAI,KAAG,MASnD,CAAA;AAED;mEACmE;AACnE,eAAO,MAAM,WAAW,GAAI,QAAQ,MAAM,GAAG,IAAI,KAAG,MAenD,CAAA"}

package/dist/lib/titleCase.js

@@ -0,0 +1,17 @@
+/** Normalize a free-form icon name to kebab-case (`Arrow Right` / `arrowRight` -> `arrow-right`),
+ *  so the name an editor types in an `iconsArray` row matches the name used in `<Icon name>`. */ export const toKebabCase = (input)=>{
+    if (!input) return '';
+    return input.normalize('NFKD').replace(/[̀-ͯ]/g, '').replace(/([a-z0-9])([A-Z])/g, '$1-$2').replace(/[^A-Za-z0-9]+/g, '-').replace(/^-+|-+$/g, '').toLowerCase();
+};
+/** Humanize a kebab/camel/snake icon name into Title Case for admin labels
+ *  (`arrow-right` -> `Arrow Right`). Pure string work, no deps. */ export const toTitleCase = (input)=>{
+    if (!input) return '';
+    // Strip combining diacritical marks (U+0300-U+036F) left after NFKD decomposition.
+    const stripped = input.normalize('NFKD').replace(/[̀-ͯ]/g, '');
+    const spaced = stripped.replace(/([a-z0-9])([A-Z])/g, '$1 $2').replace(/([A-Z]+)([A-Z][a-z0-9]+)/g, '$1 $2').replace(/[-_]+/g, ' ').replace(/[.\s]+/g, ' ');
+    const words = spaced.split(/\s+/).filter((w)=>w.length > 0);
+    if (words.length === 0) return '';
+    return words.map((w)=>/^[A-Z]+$/.test(w) ? w : /^[A-Z][a-z]+$/.test(w) ? w : w.charAt(0).toUpperCase() + w.slice(1).toLowerCase()).join(' ').trim();
+};
+
+//# sourceMappingURL=titleCase.js.map

package/dist/lib/titleCase.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/lib/titleCase.ts"],"sourcesContent":["/** Normalize a free-form icon name to kebab-case (`Arrow Right` / `arrowRight` -> `arrow-right`),\n *  so the name an editor types in an `iconsArray` row matches the name used in `<Icon name>`. */\nexport const toKebabCase = (input?: string | null): string => {\n  if (!input) return ''\n  return input\n    .normalize('NFKD')\n    .replace(/[̀-ͯ]/g, '')\n    .replace(/([a-z0-9])([A-Z])/g, '$1-$2')\n    .replace(/[^A-Za-z0-9]+/g, '-')\n    .replace(/^-+|-+$/g, '')\n    .toLowerCase()\n}\n\n/** Humanize a kebab/camel/snake icon name into Title Case for admin labels\n *  (`arrow-right` -> `Arrow Right`). Pure string work, no deps. */\nexport const toTitleCase = (input?: string | null): string => {\n  if (!input) return ''\n  // Strip combining diacritical marks (U+0300-U+036F) left after NFKD decomposition.\n  const stripped = input.normalize('NFKD').replace(/[̀-ͯ]/g, '')\n  const spaced = stripped\n    .replace(/([a-z0-9])([A-Z])/g, '$1 $2')\n    .replace(/([A-Z]+)([A-Z][a-z0-9]+)/g, '$1 $2')\n    .replace(/[-_]+/g, ' ')\n    .replace(/[.\\s]+/g, ' ')\n  const words = spaced.split(/\\s+/).filter((w) => w.length > 0)\n  if (words.length === 0) return ''\n  return words\n    .map((w) => (/^[A-Z]+$/.test(w) ? w : /^[A-Z][a-z]+$/.test(w) ? w : w.charAt(0).toUpperCase() + w.slice(1).toLowerCase()))\n    .join(' ')\n    .trim()\n}\n"],"names":["toKebabCase","input","normalize","replace","toLowerCase","toTitleCase","stripped","spaced","words","split","filter","w","length","map","test","charAt","toUpperCase","slice","join","trim"],"mappings":"AAAA;+FAC+F,GAC/F,OAAO,MAAMA,cAAc,CAACC;IAC1B,IAAI,CAACA,OAAO,OAAO;IACnB,OAAOA,MACJC,SAAS,CAAC,QACVC,OAAO,CAAC,UAAU,IAClBA,OAAO,CAAC,sBAAsB,SAC9BA,OAAO,CAAC,kBAAkB,KAC1BA,OAAO,CAAC,YAAY,IACpBC,WAAW;AAChB,EAAC;AAED;iEACiE,GACjE,OAAO,MAAMC,cAAc,CAACJ;IAC1B,IAAI,CAACA,OAAO,OAAO;IACnB,mFAAmF;IACnF,MAAMK,WAAWL,MAAMC,SAAS,CAAC,QAAQC,OAAO,CAAC,UAAU;IAC3D,MAAMI,SAASD,SACZH,OAAO,CAAC,sBAAsB,SAC9BA,OAAO,CAAC,6BAA6B,SACrCA,OAAO,CAAC,UAAU,KAClBA,OAAO,CAAC,WAAW;IACtB,MAAMK,QAAQD,OAAOE,KAAK,CAAC,OAAOC,MAAM,CAAC,CAACC,IAAMA,EAAEC,MAAM,GAAG;IAC3D,IAAIJ,MAAMI,MAAM,KAAK,GAAG,OAAO;IAC/B,OAAOJ,MACJK,GAAG,CAAC,CAACF,IAAO,WAAWG,IAAI,CAACH,KAAKA,IAAI,gBAAgBG,IAAI,CAACH,KAAKA,IAAIA,EAAEI,MAAM,CAAC,GAAGC,WAAW,KAAKL,EAAEM,KAAK,CAAC,GAAGb,WAAW,IACrHc,IAAI,CAAC,KACLC,IAAI;AACT,EAAC"}

package/dist/plugin.d.ts

@@ -0,0 +1,91 @@
+import type { Plugin } from 'payload';
+import { type IconRequestCollectionOverrides } from './collections/IconRequest';
+import { type IconSetCollectionOverrides } from './collections/IconSet';
+import type { IconCollectionOverrides } from './types';
+/**
+ * Options for {@link iconsPlugin}. Composes the `icon` upload collection, the
+ * `iconSet` grouping collection, and the `iconRequest` diagnostic collection.
+ * The usage panel and request tracking are on by default.
+ *
+ * @example
+ * ```ts
+ * iconsPlugin({
+ *   iconOverrides: { fields: [{ name: 'note', type: 'text' }] },
+ *   trackRequests: false, // omit the iconRequest collection
+ * })
+ * ```
+ */
+export interface IconsPluginOptions {
+    /**
+     * When `false`, the plugin is a no-op — no collections are registered. Useful
+     * behind a feature flag. @default true
+     */
+    enabled?: boolean;
+    /**
+     * Overrides for the `icon` upload collection — replaces slug, adminGroup, access,
+     * and upload config, and extends `fields` / `hooks`. See {@link IconCollectionOverrides}.
+     */
+    iconOverrides?: IconCollectionOverrides;
+    /**
+     * When `false`, the `iconSet` collection is not registered (only `icon`). Use
+     * when you want icons in the CMS but not the grouping/active-set concept.
+     * @default true
+     */
+    includeIconSet?: boolean;
+    /**
+     * Overrides for the `iconSet` collection — live preview, additive hooks,
+     * set-level fields, per-row fields, a drafts toggle. See
+     * {@link IconSetCollectionOverrides}.
+     */
+    iconSetOverrides?: IconSetCollectionOverrides;
+    /**
+     * The IconSet "Requested icons" panel — shows which icons your code needs
+     * versus what a set provides (scanned live in dev, from the manifest in prod,
+     * plus runtime misses when {@link trackRequests}). Set `false` to omit it.
+     * @default true
+     */
+    usagePanel?: boolean;
+    /**
+     * Registers the `iconRequest` diagnostic collection AND makes the `<Icon>`
+     * server component record every name that fails to resolve at runtime —
+     * throttled, deferred via `after()`, fire-and-forget. These misses (including
+     * dynamic `name={…}` ones a static scan can't see) surface in the usage panel.
+     * Set `false` to omit it, or force-disable only the recorder at runtime with
+     * `ICON_USAGE_TRACKING=false`.
+     * @default true
+     */
+    trackRequests?: boolean;
+    /**
+     * Overrides for the `iconRequest` collection. Only meaningful when
+     * {@link trackRequests} isn't `false`.
+     */
+    iconRequestOverrides?: IconRequestCollectionOverrides;
+}
+/**
+ * Payload plugin that contributes the `icon` upload collection and (by default)
+ * the `iconSet` grouping collection.
+ *
+ * - **`icon`** — single-SVG uploads, optimized + sanitized + themed on save
+ *   (`formatSVGHook`), stored as an inline `svgString`.
+ * - **`iconSet`** — named `name → icon` mappings with a single-active toggle and
+ *   drafts/versions. The frontend renders the active set, so activating a
+ *   different set re-skins every icon at once.
+ * - **`iconRequest`** (on by default; {@link IconsPluginOptions.trackRequests} `false` to omit) —
+ *   runtime miss diagnostics surfaced in the IconSet usage panel.
+ *
+ * Self-contained: no `@pro-laico/core` / `@pro-laico/atomic` dependency. The
+ * single-active invariant is a small status-lane-scoped `beforeChange` hook.
+ * Revalidation is left to the consumer (wire `revalidatePath` / `revalidateTag`
+ * via `iconSetOverrides.hooks`).
+ *
+ * @example
+ * ```ts
+ * import { buildConfig } from 'payload'
+ * import { iconsPlugin } from '@pro-laico/payload-icons'
+ *
+ * export default buildConfig({ plugins: [iconsPlugin()] })
+ * ```
+ */
+export declare const iconsPlugin: (opts?: IconsPluginOptions) => Plugin;
+export default iconsPlugin;
+//# sourceMappingURL=plugin.d.ts.map

package/dist/plugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"plugin.d.ts","sourceRoot":"","sources":["../src/plugin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAA4B,MAAM,EAAE,MAAM,SAAS,CAAA;AAG/D,OAAO,EAAkD,KAAK,8BAA8B,EAAE,MAAM,2BAA2B,CAAA;AAC/H,OAAO,EAA0C,KAAK,0BAA0B,EAAE,MAAM,uBAAuB,CAAA;AAE/G,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,SAAS,CAAA;AAEtD;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,kBAAkB;IACjC;;;OAGG;IACH,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB;;;OAGG;IACH,aAAa,CAAC,EAAE,uBAAuB,CAAA;IACvC;;;;OAIG;IACH,cAAc,CAAC,EAAE,OAAO,CAAA;IACxB;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,0BAA0B,CAAA;IAC7C;;;;;OAKG;IACH,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB;;;;;;;;OAQG;IACH,aAAa,CAAC,EAAE,OAAO,CAAA;IACvB;;;OAGG;IACH,oBAAoB,CAAC,EAAE,8BAA8B,CAAA;CACtD;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,WAAW,GACrB,OAAM,kBAAuB,KAAG,MA2ChC,CAAA;AAEH,eAAe,WAAW,CAAA"}

package/dist/plugin.js

@@ -0,0 +1,72 @@
+import { Icon } from "./collections/Icon.js";
+import { createIconRequestCollection, ICON_REQUEST_SLUG } from "./collections/IconRequest.js";
+import { createIconSetCollection, ICON_SET_SLUG } from "./collections/IconSet.js";
+import { stashConfig, stashIconSetSlug } from "./lib/getPayloadClient.js";
+/**
+ * Payload plugin that contributes the `icon` upload collection and (by default)
+ * the `iconSet` grouping collection.
+ *
+ * - **`icon`** — single-SVG uploads, optimized + sanitized + themed on save
+ *   (`formatSVGHook`), stored as an inline `svgString`.
+ * - **`iconSet`** — named `name → icon` mappings with a single-active toggle and
+ *   drafts/versions. The frontend renders the active set, so activating a
+ *   different set re-skins every icon at once.
+ * - **`iconRequest`** (on by default; {@link IconsPluginOptions.trackRequests} `false` to omit) —
+ *   runtime miss diagnostics surfaced in the IconSet usage panel.
+ *
+ * Self-contained: no `@pro-laico/core` / `@pro-laico/atomic` dependency. The
+ * single-active invariant is a small status-lane-scoped `beforeChange` hook.
+ * Revalidation is left to the consumer (wire `revalidatePath` / `revalidateTag`
+ * via `iconSetOverrides.hooks`).
+ *
+ * @example
+ * ```ts
+ * import { buildConfig } from 'payload'
+ * import { iconsPlugin } from '@pro-laico/payload-icons'
+ *
+ * export default buildConfig({ plugins: [iconsPlugin()] })
+ * ```
+ */ export const iconsPlugin = (opts = {})=>(config)=>{
+        const { enabled = true, iconOverrides, includeIconSet = true, iconSetOverrides, usagePanel = true, trackRequests = true, iconRequestOverrides } = opts;
+        if (!enabled) return config;
+        // Stash the resolved iconSet slug at config-build time so the cache resolver (`./cache`)
+        // honors `iconSetOverrides.slug` — any process that loads the config runs this.
+        stashIconSetSlug(iconSetOverrides?.slug ?? ICON_SET_SLUG);
+        const additions = [
+            Icon(iconOverrides)
+        ];
+        if (includeIconSet) additions.push(createIconSetCollection({
+            iconSlug: iconOverrides?.slug ?? 'icon',
+            usagePanel,
+            ...iconSetOverrides
+        }));
+        if (trackRequests) additions.push(createIconRequestCollection(iconRequestOverrides));
+        return {
+            ...config,
+            collections: [
+                ...config.collections ?? [],
+                ...additions
+            ],
+            // Stash the resolved slugs so decoupled tooling (e.g. @pro-laico/payload-dev-tools) can
+            // discover the plugin and read them from just `payload.config` — no import.
+            custom: {
+                ...config.custom,
+                payloadIcons: {
+                    options: opts,
+                    iconSlug: iconOverrides?.slug ?? 'icon',
+                    iconSetSlug: includeIconSet ? iconSetOverrides?.slug ?? ICON_SET_SLUG : null,
+                    iconRequestSlug: trackRequests ? ICON_REQUEST_SLUG : null
+                }
+            },
+            onInit: async (payload)=>{
+                await config.onInit?.(payload);
+                // Remember the app's config so the server components (<Icon> et al) resolve it from
+                // globalThis — no `@payload-config` alias (and thus no transpilePackages) required
+                // once Payload has booted.
+                stashConfig(payload.config);
+            }
+        };
+    };
+export default iconsPlugin;
+
+//# sourceMappingURL=plugin.js.map

package/dist/plugin.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/plugin.ts"],"sourcesContent":["import type { CollectionConfig, Config, Plugin } from 'payload'\n\nimport { Icon } from './collections/Icon'\nimport { createIconRequestCollection, ICON_REQUEST_SLUG, type IconRequestCollectionOverrides } from './collections/IconRequest'\nimport { createIconSetCollection, ICON_SET_SLUG, type IconSetCollectionOverrides } from './collections/IconSet'\nimport { stashConfig, stashIconSetSlug } from './lib/getPayloadClient'\nimport type { IconCollectionOverrides } from './types'\n\n/**\n * Options for {@link iconsPlugin}. Composes the `icon` upload collection, the\n * `iconSet` grouping collection, and the `iconRequest` diagnostic collection.\n * The usage panel and request tracking are on by default.\n *\n * @example\n * ```ts\n * iconsPlugin({\n *   iconOverrides: { fields: [{ name: 'note', type: 'text' }] },\n *   trackRequests: false, // omit the iconRequest collection\n * })\n * ```\n */\nexport interface IconsPluginOptions {\n  /**\n   * When `false`, the plugin is a no-op — no collections are registered. Useful\n   * behind a feature flag. @default true\n   */\n  enabled?: boolean\n  /**\n   * Overrides for the `icon` upload collection — replaces slug, adminGroup, access,\n   * and upload config, and extends `fields` / `hooks`. See {@link IconCollectionOverrides}.\n   */\n  iconOverrides?: IconCollectionOverrides\n  /**\n   * When `false`, the `iconSet` collection is not registered (only `icon`). Use\n   * when you want icons in the CMS but not the grouping/active-set concept.\n   * @default true\n   */\n  includeIconSet?: boolean\n  /**\n   * Overrides for the `iconSet` collection — live preview, additive hooks,\n   * set-level fields, per-row fields, a drafts toggle. See\n   * {@link IconSetCollectionOverrides}.\n   */\n  iconSetOverrides?: IconSetCollectionOverrides\n  /**\n   * The IconSet \"Requested icons\" panel — shows which icons your code needs\n   * versus what a set provides (scanned live in dev, from the manifest in prod,\n   * plus runtime misses when {@link trackRequests}). Set `false` to omit it.\n   * @default true\n   */\n  usagePanel?: boolean\n  /**\n   * Registers the `iconRequest` diagnostic collection AND makes the `<Icon>`\n   * server component record every name that fails to resolve at runtime —\n   * throttled, deferred via `after()`, fire-and-forget. These misses (including\n   * dynamic `name={…}` ones a static scan can't see) surface in the usage panel.\n   * Set `false` to omit it, or force-disable only the recorder at runtime with\n   * `ICON_USAGE_TRACKING=false`.\n   * @default true\n   */\n  trackRequests?: boolean\n  /**\n   * Overrides for the `iconRequest` collection. Only meaningful when\n   * {@link trackRequests} isn't `false`.\n   */\n  iconRequestOverrides?: IconRequestCollectionOverrides\n}\n\n/**\n * Payload plugin that contributes the `icon` upload collection and (by default)\n * the `iconSet` grouping collection.\n *\n * - **`icon`** — single-SVG uploads, optimized + sanitized + themed on save\n *   (`formatSVGHook`), stored as an inline `svgString`.\n * - **`iconSet`** — named `name → icon` mappings with a single-active toggle and\n *   drafts/versions. The frontend renders the active set, so activating a\n *   different set re-skins every icon at once.\n * - **`iconRequest`** (on by default; {@link IconsPluginOptions.trackRequests} `false` to omit) —\n *   runtime miss diagnostics surfaced in the IconSet usage panel.\n *\n * Self-contained: no `@pro-laico/core` / `@pro-laico/atomic` dependency. The\n * single-active invariant is a small status-lane-scoped `beforeChange` hook.\n * Revalidation is left to the consumer (wire `revalidatePath` / `revalidateTag`\n * via `iconSetOverrides.hooks`).\n *\n * @example\n * ```ts\n * import { buildConfig } from 'payload'\n * import { iconsPlugin } from '@pro-laico/payload-icons'\n *\n * export default buildConfig({ plugins: [iconsPlugin()] })\n * ```\n */\nexport const iconsPlugin =\n  (opts: IconsPluginOptions = {}): Plugin =>\n  (config: Config): Config => {\n    const {\n      enabled = true,\n      iconOverrides,\n      includeIconSet = true,\n      iconSetOverrides,\n      usagePanel = true,\n      trackRequests = true,\n      iconRequestOverrides,\n    } = opts\n    if (!enabled) return config\n\n    // Stash the resolved iconSet slug at config-build time so the cache resolver (`./cache`)\n    // honors `iconSetOverrides.slug` — any process that loads the config runs this.\n    stashIconSetSlug(iconSetOverrides?.slug ?? ICON_SET_SLUG)\n\n    const additions: CollectionConfig[] = [Icon(iconOverrides)]\n    if (includeIconSet) additions.push(createIconSetCollection({ iconSlug: iconOverrides?.slug ?? 'icon', usagePanel, ...iconSetOverrides }))\n    if (trackRequests) additions.push(createIconRequestCollection(iconRequestOverrides))\n\n    return {\n      ...config,\n      collections: [...(config.collections ?? []), ...additions],\n      // Stash the resolved slugs so decoupled tooling (e.g. @pro-laico/payload-dev-tools) can\n      // discover the plugin and read them from just `payload.config` — no import.\n      custom: {\n        ...config.custom,\n        payloadIcons: {\n          options: opts,\n          iconSlug: iconOverrides?.slug ?? 'icon',\n          iconSetSlug: includeIconSet ? (iconSetOverrides?.slug ?? ICON_SET_SLUG) : null,\n          iconRequestSlug: trackRequests ? ICON_REQUEST_SLUG : null,\n        },\n      },\n      onInit: async (payload) => {\n        await config.onInit?.(payload)\n        // Remember the app's config so the server components (<Icon> et al) resolve it from\n        // globalThis — no `@payload-config` alias (and thus no transpilePackages) required\n        // once Payload has booted.\n        stashConfig(payload.config)\n      },\n    }\n  }\n\nexport default iconsPlugin\n"],"names":["Icon","createIconRequestCollection","ICON_REQUEST_SLUG","createIconSetCollection","ICON_SET_SLUG","stashConfig","stashIconSetSlug","iconsPlugin","opts","config","enabled","iconOverrides","includeIconSet","iconSetOverrides","usagePanel","trackRequests","iconRequestOverrides","slug","additions","push","iconSlug","collections","custom","payloadIcons","options","iconSetSlug","iconRequestSlug","onInit","payload"],"mappings":"AAEA,SAASA,IAAI,QAAQ,wBAAoB;AACzC,SAASC,2BAA2B,EAAEC,iBAAiB,QAA6C,+BAA2B;AAC/H,SAASC,uBAAuB,EAAEC,aAAa,QAAyC,2BAAuB;AAC/G,SAASC,WAAW,EAAEC,gBAAgB,QAAQ,4BAAwB;AA+DtE;;;;;;;;;;;;;;;;;;;;;;;;CAwBC,GACD,OAAO,MAAMC,cACX,CAACC,OAA2B,CAAC,CAAC,GAC9B,CAACC;QACC,MAAM,EACJC,UAAU,IAAI,EACdC,aAAa,EACbC,iBAAiB,IAAI,EACrBC,gBAAgB,EAChBC,aAAa,IAAI,EACjBC,gBAAgB,IAAI,EACpBC,oBAAoB,EACrB,GAAGR;QACJ,IAAI,CAACE,SAAS,OAAOD;QAErB,yFAAyF;QACzF,gFAAgF;QAChFH,iBAAiBO,kBAAkBI,QAAQb;QAE3C,MAAMc,YAAgC;YAAClB,KAAKW;SAAe;QAC3D,IAAIC,gBAAgBM,UAAUC,IAAI,CAAChB,wBAAwB;YAAEiB,UAAUT,eAAeM,QAAQ;YAAQH;YAAY,GAAGD,gBAAgB;QAAC;QACtI,IAAIE,eAAeG,UAAUC,IAAI,CAAClB,4BAA4Be;QAE9D,OAAO;YACL,GAAGP,MAAM;YACTY,aAAa;mBAAKZ,OAAOY,WAAW,IAAI,EAAE;mBAAMH;aAAU;YAC1D,wFAAwF;YACxF,4EAA4E;YAC5EI,QAAQ;gBACN,GAAGb,OAAOa,MAAM;gBAChBC,cAAc;oBACZC,SAAShB;oBACTY,UAAUT,eAAeM,QAAQ;oBACjCQ,aAAab,iBAAkBC,kBAAkBI,QAAQb,gBAAiB;oBAC1EsB,iBAAiBX,gBAAgBb,oBAAoB;gBACvD;YACF;YACAyB,QAAQ,OAAOC;gBACb,MAAMnB,OAAOkB,MAAM,GAAGC;gBACtB,oFAAoF;gBACpF,mFAAmF;gBACnF,2BAA2B;gBAC3BvB,YAAYuB,QAAQnB,MAAM;YAC5B;QACF;IACF,EAAC;AAEH,eAAeF,YAAW"}

package/dist/scan/cli.d.ts

@@ -0,0 +1,14 @@
+#!/usr/bin/env node
+/**
+ * `payload-icons-scan` — CLI wrapper around {@link scanIconUsages}. Run it in a
+ * project's build (e.g. a `prebuild` script or CI step) to regenerate the
+ * icon-usage manifest the admin "requested icons" panel reads.
+ *
+ * @example
+ * ```sh
+ * payload-icons-scan src app --out icon-usage-manifest.json
+ * payload-icons-scan --component Icon --component Glyph --ext tsx,jsx
+ * ```
+ */
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/dist/scan/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/scan/cli.ts"],"names":[],"mappings":";AACA;;;;;;;;;;GAUG"}

package/dist/scan/cli.js

@@ -0,0 +1,114 @@
+#!/usr/bin/env node
+/**
+ * `payload-icons-scan` — CLI wrapper around {@link scanIconUsages}. Run it in a
+ * project's build (e.g. a `prebuild` script or CI step) to regenerate the
+ * icon-usage manifest the admin "requested icons" panel reads.
+ *
+ * @example
+ * ```sh
+ * payload-icons-scan src app --out icon-usage-manifest.json
+ * payload-icons-scan --component Icon --component Glyph --ext tsx,jsx
+ * ```
+ */ import { DEFAULT_ROOTS, resolveManifestPath, scanIconUsages, writeIconUsageManifest } from "./index.js";
+const HELP = `payload-icons-scan — scan source for literal <Icon name="…"> usages
+
+Usage:
+  payload-icons-scan [roots...] [options]
+
+Arguments:
+  roots                  Directories/files to scan (default: src app)
+
+Options:
+  -o, --out <path>       Manifest output path
+                         (default: $ICON_USAGE_MANIFEST or icon-usage-manifest.json)
+  -c, --component <name> Component tag to treat as an icon (repeatable; default: Icon)
+  -e, --ext <list>       Comma-separated extensions (default: tsx,jsx,ts,js,mdx)
+  -i, --ignore <list>    Comma-separated dir names to skip
+  -h, --help             Show this help
+`;
+/** Splits a repeated or comma-joined option value into trimmed, non-empty parts. */ const collect = (acc, raw)=>{
+    for (const part of raw.split(',')){
+        const v = part.trim();
+        if (v) acc.push(v);
+    }
+};
+const parseArgs = (argv)=>{
+    const parsed = {
+        roots: [],
+        out: undefined,
+        components: [],
+        extensions: [],
+        ignore: [],
+        help: false,
+        invalid: false
+    };
+    for(let i = 0; i < argv.length; i++){
+        const arg = argv[i];
+        if (arg === undefined) continue;
+        const next = ()=>argv[++i] ?? '';
+        switch(arg){
+            case '-h':
+            case '--help':
+                parsed.help = true;
+                break;
+            case '-o':
+            case '--out':
+                parsed.out = next();
+                break;
+            case '-c':
+            case '--component':
+                collect(parsed.components, next());
+                break;
+            case '-e':
+            case '--ext':
+                collect(parsed.extensions, next());
+                break;
+            case '-i':
+            case '--ignore':
+                collect(parsed.ignore, next());
+                break;
+            default:
+                if (arg.startsWith('-')) {
+                    process.stderr.write(`Unknown option: ${arg}\n`);
+                    parsed.invalid = true;
+                } else {
+                    parsed.roots.push(arg);
+                }
+        }
+    }
+    return parsed;
+};
+const main = ()=>{
+    const args = parseArgs(process.argv.slice(2));
+    if (args.help) {
+        process.stdout.write(HELP);
+        return;
+    }
+    // Unknown options abort BEFORE scanning — a typo'd flag must not silently write a manifest.
+    if (args.invalid) {
+        process.stderr.write('payload-icons-scan: aborting (run with --help for usage)\n');
+        process.exitCode = 1;
+        return;
+    }
+    const roots = args.roots.length ? args.roots : DEFAULT_ROOTS;
+    const { manifest, filesScanned, rootsScanned } = scanIconUsages({
+        roots,
+        components: args.components.length ? args.components : undefined,
+        extensions: args.extensions.length ? args.extensions : undefined,
+        ignore: args.ignore.length ? args.ignore : undefined
+    });
+    // Every root missing means the scan ran in the wrong directory — fail loudly so CI catches it
+    // instead of shipping an empty manifest. Real roots with 0 usages still exit 0.
+    if (rootsScanned === 0) {
+        process.stderr.write(`payload-icons-scan: none of the scan roots exist: ${roots.join(', ')} (wrong directory?)\n`);
+        process.exitCode = 1;
+        return;
+    }
+    const outPath = resolveManifestPath(args.out);
+    const written = writeIconUsageManifest(manifest, outPath);
+    process.stdout.write(`payload-icons-scan: ${manifest.names.length} icon name(s) across ${manifest.usages.length} usage(s) in ${filesScanned} file(s)\n`);
+    process.stdout.write(`payload-icons-scan: wrote ${written}\n`);
+};
+main();
+
+//# sourceMappingURL=cli.js.map

package/dist/scan/cli.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/scan/cli.ts"],"sourcesContent":["#!/usr/bin/env node\n/**\n * `payload-icons-scan` — CLI wrapper around {@link scanIconUsages}. Run it in a\n * project's build (e.g. a `prebuild` script or CI step) to regenerate the\n * icon-usage manifest the admin \"requested icons\" panel reads.\n *\n * @example\n * ```sh\n * payload-icons-scan src app --out icon-usage-manifest.json\n * payload-icons-scan --component Icon --component Glyph --ext tsx,jsx\n * ```\n */\n\nimport { DEFAULT_ROOTS, resolveManifestPath, scanIconUsages, writeIconUsageManifest } from './index.js'\n\ninterface ParsedArgs {\n  roots: string[]\n  out?: string\n  components: string[]\n  extensions: string[]\n  ignore: string[]\n  help: boolean\n  invalid: boolean\n}\n\nconst HELP = `payload-icons-scan — scan source for literal <Icon name=\"…\"> usages\n\nUsage:\n  payload-icons-scan [roots...] [options]\n\nArguments:\n  roots                  Directories/files to scan (default: src app)\n\nOptions:\n  -o, --out <path>       Manifest output path\n                         (default: $ICON_USAGE_MANIFEST or icon-usage-manifest.json)\n  -c, --component <name> Component tag to treat as an icon (repeatable; default: Icon)\n  -e, --ext <list>       Comma-separated extensions (default: tsx,jsx,ts,js,mdx)\n  -i, --ignore <list>    Comma-separated dir names to skip\n  -h, --help             Show this help\n`\n\n/** Splits a repeated or comma-joined option value into trimmed, non-empty parts. */\nconst collect = (acc: string[], raw: string): void => {\n  for (const part of raw.split(',')) {\n    const v = part.trim()\n    if (v) acc.push(v)\n  }\n}\n\nconst parseArgs = (argv: string[]): ParsedArgs => {\n  const parsed: ParsedArgs = { roots: [], out: undefined, components: [], extensions: [], ignore: [], help: false, invalid: false }\n  for (let i = 0; i < argv.length; i++) {\n    const arg = argv[i]\n    if (arg === undefined) continue\n    const next = (): string => argv[++i] ?? ''\n    switch (arg) {\n      case '-h':\n      case '--help':\n        parsed.help = true\n        break\n      case '-o':\n      case '--out':\n        parsed.out = next()\n        break\n      case '-c':\n      case '--component':\n        collect(parsed.components, next())\n        break\n      case '-e':\n      case '--ext':\n        collect(parsed.extensions, next())\n        break\n      case '-i':\n      case '--ignore':\n        collect(parsed.ignore, next())\n        break\n      default:\n        if (arg.startsWith('-')) {\n          process.stderr.write(`Unknown option: ${arg}\\n`)\n          parsed.invalid = true\n        } else {\n          parsed.roots.push(arg)\n        }\n    }\n  }\n  return parsed\n}\n\nconst main = (): void => {\n  const args = parseArgs(process.argv.slice(2))\n  if (args.help) {\n    process.stdout.write(HELP)\n    return\n  }\n  // Unknown options abort BEFORE scanning — a typo'd flag must not silently write a manifest.\n  if (args.invalid) {\n    process.stderr.write('payload-icons-scan: aborting (run with --help for usage)\\n')\n    process.exitCode = 1\n    return\n  }\n\n  const roots = args.roots.length ? args.roots : DEFAULT_ROOTS\n  const { manifest, filesScanned, rootsScanned } = scanIconUsages({\n    roots,\n    components: args.components.length ? args.components : undefined,\n    extensions: args.extensions.length ? args.extensions : undefined,\n    ignore: args.ignore.length ? args.ignore : undefined,\n  })\n  // Every root missing means the scan ran in the wrong directory — fail loudly so CI catches it\n  // instead of shipping an empty manifest. Real roots with 0 usages still exit 0.\n  if (rootsScanned === 0) {\n    process.stderr.write(`payload-icons-scan: none of the scan roots exist: ${roots.join(', ')} (wrong directory?)\\n`)\n    process.exitCode = 1\n    return\n  }\n\n  const outPath = resolveManifestPath(args.out)\n  const written = writeIconUsageManifest(manifest, outPath)\n  process.stdout.write(\n    `payload-icons-scan: ${manifest.names.length} icon name(s) across ${manifest.usages.length} usage(s) in ${filesScanned} file(s)\\n`,\n  )\n  process.stdout.write(`payload-icons-scan: wrote ${written}\\n`)\n}\n\nmain()\n"],"names":["DEFAULT_ROOTS","resolveManifestPath","scanIconUsages","writeIconUsageManifest","HELP","collect","acc","raw","part","split","v","trim","push","parseArgs","argv","parsed","roots","out","undefined","components","extensions","ignore","help","invalid","i","length","arg","next","startsWith","process","stderr","write","main","args","slice","stdout","exitCode","manifest","filesScanned","rootsScanned","join","outPath","written","names","usages"],"mappings":"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"}

package/dist/scan/extract.d.ts

@@ -0,0 +1,58 @@
+/**
+ * Pure, dependency-free extraction of literal icon names from one source file's
+ * text. This is the core of the build-time usage scan that powers the admin
+ * "requested icons" panel — kept side-effect-free (no `fs`) so it is trivially
+ * unit-testable and reusable from any walker.
+ *
+ * It is tag-aware, NOT a naive regex. The scanner walks the file skipping
+ * strings and comments, and for every `<Icon …>` opening tag it parses the
+ * attribute list, so a `>` inside an expression (`check={a > b}`) or a `name`
+ * substring inside a sibling attribute (`iconName`, `data-name`) never trips
+ * it.
+ *
+ * ONLY string-literal names are collected — the value must resolve statically:
+ *   - `name="x"` / `name='x'`            (direct attribute strings)
+ *   - `name={"x"}` / `name={'x'}`        (string literal in an expression slot)
+ *   - `` name={`x`} ``                   (template literal, no interpolation)
+ * Dynamic `name={expr}` (variables, concatenation, interpolated templates) is
+ * intentionally skipped — a static scan cannot know its value.
+ */
+/** A single literal `<Icon name="…">` occurrence found in a file. */
+export interface ExtractedUsage {
+    /** The resolved literal icon name. */
+    name: string;
+    /** 1-based line of the `name` value. */
+    line: number;
+    /** 1-based column of the `name` value. */
+    column: number;
+}
+export interface ExtractOptions {
+    /**
+     * JSX tag names treated as icon usages. Matched exactly against the opening
+     * tag name, so `Icon` matches `<Icon …>` but not `<MyIcon …>`.
+     *
+     * @default ['Icon']
+     */
+    components?: string[];
+}
+/**
+ * Extracts every literal icon-name usage from a single file's source text.
+ * See the module doc for what counts as a literal. Returns occurrences in
+ * source order; de-duplication across files happens in the aggregator.
+ *
+ * The scan looks directly for `<Icon …>` tag starts and parses each opening tag
+ * with full string/brace awareness (so the `name` value and the tag's end are
+ * found correctly). It deliberately does NOT try to mask surrounding strings or
+ * comments: JSX text routinely contains apostrophes (`it's`) and `//` (`http://`)
+ * that a whole-file lexer would mis-read as a string/comment and skip a real
+ * usage past. Instead, two surgical guards keep commentary out without a lexer:
+ * a candidate whose line leads with `//` or `*` (line comments, JSDoc
+ * continuations — real JSX never starts a line that way) is skipped, and
+ * extracted names must look like icon names ({@link PLAUSIBLE_NAME}), so prose
+ * placeholders like `…` are dropped. An `<Icon name="…">` written literally in
+ * a JS string (or a mid-line comment) can still be picked up — a harmless
+ * over-count for an inventory, where missing a real usage would be the worse
+ * failure.
+ */
+export declare const extractIconUsages: (source: string, options?: ExtractOptions) => ExtractedUsage[];
+//# sourceMappingURL=extract.d.ts.map

package/dist/scan/extract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract.d.ts","sourceRoot":"","sources":["../../src/scan/extract.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,qEAAqE;AACrE,MAAM,WAAW,cAAc;IAC7B,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAA;IACZ,wCAAwC;IACxC,IAAI,EAAE,MAAM,CAAA;IACZ,0CAA0C;IAC1C,MAAM,EAAE,MAAM,CAAA;CACf;AAED,MAAM,WAAW,cAAc;IAC7B;;;;;OAKG;IACH,UAAU,CAAC,EAAE,MAAM,EAAE,CAAA;CACtB;AAqND;;;;;;;;;;;;;;;;;;GAkBG;AACH,eAAO,MAAM,iBAAiB,GAAI,QAAQ,MAAM,EAAE,UAAS,cAAmB,KAAG,cAAc,EA0C9F,CAAA"}