@kilivi/payloadcms-theme-management 2.0.0 → 2.2.0

package/dist/hooks/useThemeFonts.js

@@ -0,0 +1,36 @@
+'use client';
+import * as PayloadUI from '@payloadcms/ui';
+import { useEffect } from 'react';
+import { buildThemeFontsHref } from '../constants/themeFonts.js';
+// Tolerate a missing export (older Payload, unit-test mocks): fall back to '/api'.
+const useConfigSafe = PayloadUI.useConfig ?? (()=>undefined);
+/** Payload's REST API route (`routes.api`), '/api' by default. */ export function useApiRoute() {
+    return useConfigSafe()?.config?.routes?.api ?? '/api';
+}
+/**
+ * Load catalog fonts into the admin document through the plugin's self-hosted
+ * font endpoint, so previews render in the real faces without the editor's
+ * browser contacting Google. One `<link>` per distinct font set, shared by every
+ * field that asks for the same set.
+ */ export function useThemeFonts(values) {
+    const apiRoute = useApiRoute();
+    const href = buildThemeFontsHref(values, {
+        apiRoute
+    });
+    useEffect(()=>{
+        if (!href || typeof document === 'undefined') return;
+        const exists = [
+            ...document.querySelectorAll('link[data-tm-fonts]')
+        ].some((link)=>link.getAttribute('href') === href);
+        if (exists) return;
+        const link = document.createElement('link');
+        link.rel = 'stylesheet';
+        link.href = href;
+        link.dataset.tmFonts = '';
+        document.head.appendChild(link);
+    }, [
+        href
+    ]);
+}
+
+//# sourceMappingURL=useThemeFonts.js.map

package/dist/hooks/useThemeFonts.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hooks/useThemeFonts.ts"],"sourcesContent":["'use client'\n\nimport * as PayloadUI from '@payloadcms/ui'\nimport { useEffect } from 'react'\nimport { buildThemeFontsHref } from '../constants/themeFonts.js'\n\ntype UseConfig = () => { config?: { routes?: { api?: string } } } | undefined\n\n// Tolerate a missing export (older Payload, unit-test mocks): fall back to '/api'.\nconst useConfigSafe: UseConfig =\n  (PayloadUI as unknown as { useConfig?: UseConfig }).useConfig ?? (() => undefined)\n\n/** Payload's REST API route (`routes.api`), '/api' by default. */\nexport function useApiRoute(): string {\n  return useConfigSafe()?.config?.routes?.api ?? '/api'\n}\n\n/**\n * Load catalog fonts into the admin document through the plugin's self-hosted\n * font endpoint, so previews render in the real faces without the editor's\n * browser contacting Google. One `<link>` per distinct font set, shared by every\n * field that asks for the same set.\n */\nexport function useThemeFonts(values: Array<string | null | undefined>): void {\n  const apiRoute = useApiRoute()\n  const href = buildThemeFontsHref(values, { apiRoute })\n\n  useEffect(() => {\n    if (!href || typeof document === 'undefined') return\n    const exists = [...document.querySelectorAll<HTMLLinkElement>('link[data-tm-fonts]')].some(\n      (link) => link.getAttribute('href') === href,\n    )\n    if (exists) return\n    const link = document.createElement('link')\n    link.rel = 'stylesheet'\n    link.href = href\n    link.dataset.tmFonts = ''\n    document.head.appendChild(link)\n  }, [href])\n}\n"],"names":["PayloadUI","useEffect","buildThemeFontsHref","useConfigSafe","useConfig","undefined","useApiRoute","config","routes","api","useThemeFonts","values","apiRoute","href","document","exists","querySelectorAll","some","link","getAttribute","createElement","rel","dataset","tmFonts","head","appendChild"],"mappings":"AAAA;AAEA,YAAYA,eAAe,iBAAgB;AAC3C,SAASC,SAAS,QAAQ,QAAO;AACjC,SAASC,mBAAmB,QAAQ,6BAA4B;AAIhE,mFAAmF;AACnF,MAAMC,gBACJ,AAACH,UAAmDI,SAAS,IAAK,CAAA,IAAMC,SAAQ;AAElF,gEAAgE,GAChE,OAAO,SAASC;IACd,OAAOH,iBAAiBI,QAAQC,QAAQC,OAAO;AACjD;AAEA;;;;;CAKC,GACD,OAAO,SAASC,cAAcC,MAAwC;IACpE,MAAMC,WAAWN;IACjB,MAAMO,OAAOX,oBAAoBS,QAAQ;QAAEC;IAAS;IAEpDX,UAAU;QACR,IAAI,CAACY,QAAQ,OAAOC,aAAa,aAAa;QAC9C,MAAMC,SAAS;eAAID,SAASE,gBAAgB,CAAkB;SAAuB,CAACC,IAAI,CACxF,CAACC,OAASA,KAAKC,YAAY,CAAC,YAAYN;QAE1C,IAAIE,QAAQ;QACZ,MAAMG,OAAOJ,SAASM,aAAa,CAAC;QACpCF,KAAKG,GAAG,GAAG;QACXH,KAAKL,IAAI,GAAGA;QACZK,KAAKI,OAAO,CAACC,OAAO,GAAG;QACvBT,SAASU,IAAI,CAACC,WAAW,CAACP;IAC5B,GAAG;QAACL;KAAK;AACX"}

package/dist/hooks/useThemeTranslations.d.ts

@@ -0,0 +1,13 @@
+import { type PluginTranslations } from '../translations.js';
+/**
+ * Resolve the current Payload admin language using Payload's native i18n context
+ * (instead of sniffing `navigator.language`). Falls back to English.
+ */
+export declare function useThemeLanguage(): string;
+/**
+ * Return the plugin's translations for the active admin language, with English
+ * used as the fallback for any missing key. Use this in client field components
+ * so the strings follow the admin's selected locale natively.
+ */
+export declare function useThemeTranslations(): PluginTranslations;
+//# sourceMappingURL=useThemeTranslations.d.ts.map

package/dist/hooks/useThemeTranslations.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useThemeTranslations.d.ts","sourceRoot":"","sources":["../../src/hooks/useThemeTranslations.ts"],"names":[],"mappings":"AAGA,OAAO,EAAmB,KAAK,kBAAkB,EAAE,MAAM,oBAAoB,CAAA;AAE7E;;;GAGG;AACH,wBAAgB,gBAAgB,IAAI,MAAM,CAMzC;AAED;;;;GAIG;AACH,wBAAgB,oBAAoB,IAAI,kBAAkB,CAEzD"}

package/dist/hooks/useThemeTranslations.js

@@ -0,0 +1,22 @@
+'use client';
+import { useTranslation } from '@payloadcms/ui';
+import { getTranslations } from '../translations.js';
+/**
+ * Resolve the current Payload admin language using Payload's native i18n context
+ * (instead of sniffing `navigator.language`). Falls back to English.
+ */ export function useThemeLanguage() {
+    // Tolerate `useTranslation()` returning undefined (e.g. outside an i18n provider
+    // or in unit tests with reset mocks) by falling back to English.
+    const result = useTranslation();
+    const language = result?.i18n?.language;
+    return typeof language === 'string' && language.length >= 2 ? language : 'en';
+}
+/**
+ * Return the plugin's translations for the active admin language, with English
+ * used as the fallback for any missing key. Use this in client field components
+ * so the strings follow the admin's selected locale natively.
+ */ export function useThemeTranslations() {
+    return getTranslations(useThemeLanguage());
+}
+
+//# sourceMappingURL=useThemeTranslations.js.map

package/dist/hooks/useThemeTranslations.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/hooks/useThemeTranslations.ts"],"sourcesContent":["'use client'\n\nimport { useTranslation } from '@payloadcms/ui'\nimport { getTranslations, type PluginTranslations } from '../translations.js'\n\n/**\n * Resolve the current Payload admin language using Payload's native i18n context\n * (instead of sniffing `navigator.language`). Falls back to English.\n */\nexport function useThemeLanguage(): string {\n  // Tolerate `useTranslation()` returning undefined (e.g. outside an i18n provider\n  // or in unit tests with reset mocks) by falling back to English.\n  const result = useTranslation() as { i18n?: { language?: string } } | undefined\n  const language = result?.i18n?.language\n  return typeof language === 'string' && language.length >= 2 ? language : 'en'\n}\n\n/**\n * Return the plugin's translations for the active admin language, with English\n * used as the fallback for any missing key. Use this in client field components\n * so the strings follow the admin's selected locale natively.\n */\nexport function useThemeTranslations(): PluginTranslations {\n  return getTranslations(useThemeLanguage())\n}\n"],"names":["useTranslation","getTranslations","useThemeLanguage","result","language","i18n","length","useThemeTranslations"],"mappings":"AAAA;AAEA,SAASA,cAAc,QAAQ,iBAAgB;AAC/C,SAASC,eAAe,QAAiC,qBAAoB;AAE7E;;;CAGC,GACD,OAAO,SAASC;IACd,iFAAiF;IACjF,iEAAiE;IACjE,MAAMC,SAASH;IACf,MAAMI,WAAWD,QAAQE,MAAMD;IAC/B,OAAO,OAAOA,aAAa,YAAYA,SAASE,MAAM,IAAI,IAAIF,WAAW;AAC3E;AAEA;;;;CAIC,GACD,OAAO,SAASG;IACd,OAAON,gBAAgBC;AACzB"}

package/dist/i18n.d.ts

@@ -0,0 +1,53 @@
+import type { Config } from 'payload';
+import { type DeepPartial, type PluginTranslations } from './translations.js';
+/**
+ * Additional or overriding translations, keyed by language code.
+ * Each entry is deep-merged over the built-in English/Czech translations, so you
+ * only need to provide the keys you want to add or change.
+ */
+export type ThemeManagementI18nTranslations = Record<string, DeepPartial<PluginTranslations>>;
+export interface ThemeManagementI18nOptions {
+    /**
+     * Extra languages or per-key overrides for the plugin admin UI strings.
+     *
+     * @example
+     * i18n: {
+     *   translations: {
+     *     de: { tabLabel: 'Darstellung', ui: { lightMode: 'Heller Modus' } },
+     *     en: { tabLabel: 'Theme' }, // override a built-in string
+     *   },
+     * }
+     */
+    translations?: ThemeManagementI18nTranslations;
+    /**
+     * Pass-through to `config.i18n.supportedLanguages`. Provide language objects from
+     * `@payloadcms/translations/languages/*` when you want the Payload admin to offer a
+     * brand-new admin language (beyond the project defaults).
+     *
+     * @example
+     * import { de } from '@payloadcms/translations/languages/de'
+     * i18n: { supportedLanguages: { de } }
+     */
+    supportedLanguages?: Record<string, unknown>;
+}
+type PayloadTranslationsByLang = Record<string, Record<string, unknown>>;
+/**
+ * Build the plugin's translations in Payload's native `config.i18n.translations`
+ * shape: `{ [lang]: { 'theme-management': { ...keys } } }`.
+ *
+ * Every language is filled out via `getTranslations`, so English acts as the
+ * fallback for any missing key in another language.
+ */
+export declare function getThemeManagementI18nTranslations(): PayloadTranslationsByLang;
+/**
+ * Merge the plugin's translations into an existing `config.i18n`, following the
+ * official Payload plugin i18n pattern. Translations already present on the
+ * incoming config win over the plugin defaults, so apps can freely override.
+ *
+ * Any `options.translations` are registered first so they participate in the
+ * merge (and are visible to `getTranslations` at runtime), and any
+ * `options.supportedLanguages` are passed straight through.
+ */
+export declare function mergeThemeManagementI18n(existing: Config['i18n'], options?: ThemeManagementI18nOptions): NonNullable<Config['i18n']>;
+export {};
+//# sourceMappingURL=i18n.d.ts.map

package/dist/i18n.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"i18n.d.ts","sourceRoot":"","sources":["../src/i18n.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,SAAS,CAAA;AACrC,OAAO,EAML,KAAK,WAAW,EAChB,KAAK,kBAAkB,EACxB,MAAM,mBAAmB,CAAA;AAE1B;;;;GAIG;AACH,MAAM,MAAM,+BAA+B,GAAG,MAAM,CAAC,MAAM,EAAE,WAAW,CAAC,kBAAkB,CAAC,CAAC,CAAA;AAE7F,MAAM,WAAW,0BAA0B;IACzC;;;;;;;;;;OAUG;IACH,YAAY,CAAC,EAAE,+BAA+B,CAAA;IAC9C;;;;;;;;OAQG;IACH,kBAAkB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CAC7C;AAED,KAAK,yBAAyB,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAA;AAExE;;;;;;GAMG;AACH,wBAAgB,kCAAkC,IAAI,yBAAyB,CAM9E;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CACtC,QAAQ,EAAE,MAAM,CAAC,MAAM,CAAC,EACxB,OAAO,CAAC,EAAE,0BAA0B,GACnC,WAAW,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAgC7B"}

package/dist/i18n.js

@@ -0,0 +1,53 @@
+import { THEME_MANAGEMENT_I18N_NAMESPACE, availableLanguages, deepMerge, getTranslations, registerTranslations } from './translations.js';
+/**
+ * Build the plugin's translations in Payload's native `config.i18n.translations`
+ * shape: `{ [lang]: { 'theme-management': { ...keys } } }`.
+ *
+ * Every language is filled out via `getTranslations`, so English acts as the
+ * fallback for any missing key in another language.
+ */ export function getThemeManagementI18nTranslations() {
+    const out = {};
+    for (const lang of availableLanguages()){
+        out[lang] = {
+            [THEME_MANAGEMENT_I18N_NAMESPACE]: getTranslations(lang)
+        };
+    }
+    return out;
+}
+/**
+ * Merge the plugin's translations into an existing `config.i18n`, following the
+ * official Payload plugin i18n pattern. Translations already present on the
+ * incoming config win over the plugin defaults, so apps can freely override.
+ *
+ * Any `options.translations` are registered first so they participate in the
+ * merge (and are visible to `getTranslations` at runtime), and any
+ * `options.supportedLanguages` are passed straight through.
+ */ export function mergeThemeManagementI18n(existing, options) {
+    if (options?.translations) {
+        registerTranslations(options.translations);
+    }
+    const pluginTranslations = getThemeManagementI18nTranslations();
+    const existingTranslations = existing?.translations ?? {};
+    // Start from existing translations to preserve every other namespace/language,
+    // then layer the plugin namespace underneath the app's own values.
+    const mergedTranslations = {
+        ...existingTranslations
+    };
+    for (const lang of Object.keys(pluginTranslations)){
+        mergedTranslations[lang] = deepMerge(pluginTranslations[lang], existingTranslations[lang] ?? {});
+    }
+    const merged = {
+        ...existing ?? {},
+        translations: mergedTranslations
+    };
+    if (options?.supportedLanguages) {
+        ;
+        merged.supportedLanguages = {
+            ...existing?.supportedLanguages ?? {},
+            ...options.supportedLanguages
+        };
+    }
+    return merged;
+}
+
+//# sourceMappingURL=i18n.js.map

package/dist/i18n.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/i18n.ts"],"sourcesContent":["import type { Config } from 'payload'\nimport {\n  THEME_MANAGEMENT_I18N_NAMESPACE,\n  availableLanguages,\n  deepMerge,\n  getTranslations,\n  registerTranslations,\n  type DeepPartial,\n  type PluginTranslations,\n} from './translations.js'\n\n/**\n * Additional or overriding translations, keyed by language code.\n * Each entry is deep-merged over the built-in English/Czech translations, so you\n * only need to provide the keys you want to add or change.\n */\nexport type ThemeManagementI18nTranslations = Record<string, DeepPartial<PluginTranslations>>\n\nexport interface ThemeManagementI18nOptions {\n  /**\n   * Extra languages or per-key overrides for the plugin admin UI strings.\n   *\n   * @example\n   * i18n: {\n   *   translations: {\n   *     de: { tabLabel: 'Darstellung', ui: { lightMode: 'Heller Modus' } },\n   *     en: { tabLabel: 'Theme' }, // override a built-in string\n   *   },\n   * }\n   */\n  translations?: ThemeManagementI18nTranslations\n  /**\n   * Pass-through to `config.i18n.supportedLanguages`. Provide language objects from\n   * `@payloadcms/translations/languages/*` when you want the Payload admin to offer a\n   * brand-new admin language (beyond the project defaults).\n   *\n   * @example\n   * import { de } from '@payloadcms/translations/languages/de'\n   * i18n: { supportedLanguages: { de } }\n   */\n  supportedLanguages?: Record<string, unknown>\n}\n\ntype PayloadTranslationsByLang = Record<string, Record<string, unknown>>\n\n/**\n * Build the plugin's translations in Payload's native `config.i18n.translations`\n * shape: `{ [lang]: { 'theme-management': { ...keys } } }`.\n *\n * Every language is filled out via `getTranslations`, so English acts as the\n * fallback for any missing key in another language.\n */\nexport function getThemeManagementI18nTranslations(): PayloadTranslationsByLang {\n  const out: PayloadTranslationsByLang = {}\n  for (const lang of availableLanguages()) {\n    out[lang] = { [THEME_MANAGEMENT_I18N_NAMESPACE]: getTranslations(lang) }\n  }\n  return out\n}\n\n/**\n * Merge the plugin's translations into an existing `config.i18n`, following the\n * official Payload plugin i18n pattern. Translations already present on the\n * incoming config win over the plugin defaults, so apps can freely override.\n *\n * Any `options.translations` are registered first so they participate in the\n * merge (and are visible to `getTranslations` at runtime), and any\n * `options.supportedLanguages` are passed straight through.\n */\nexport function mergeThemeManagementI18n(\n  existing: Config['i18n'],\n  options?: ThemeManagementI18nOptions,\n): NonNullable<Config['i18n']> {\n  if (options?.translations) {\n    registerTranslations(options.translations)\n  }\n\n  const pluginTranslations = getThemeManagementI18nTranslations()\n  const existingTranslations = (existing?.translations ?? {}) as PayloadTranslationsByLang\n\n  // Start from existing translations to preserve every other namespace/language,\n  // then layer the plugin namespace underneath the app's own values.\n  const mergedTranslations: PayloadTranslationsByLang = { ...existingTranslations }\n  for (const lang of Object.keys(pluginTranslations)) {\n    mergedTranslations[lang] = deepMerge(\n      pluginTranslations[lang] as Record<string, unknown>,\n      (existingTranslations[lang] ?? {}) as Record<string, unknown>,\n    )\n  }\n\n  const merged = {\n    ...(existing ?? {}),\n    translations: mergedTranslations,\n  } as NonNullable<Config['i18n']>\n\n  if (options?.supportedLanguages) {\n    ;(merged as { supportedLanguages?: Record<string, unknown> }).supportedLanguages = {\n      ...((existing as { supportedLanguages?: Record<string, unknown> } | undefined)\n        ?.supportedLanguages ?? {}),\n      ...options.supportedLanguages,\n    }\n  }\n\n  return merged\n}\n"],"names":["THEME_MANAGEMENT_I18N_NAMESPACE","availableLanguages","deepMerge","getTranslations","registerTranslations","getThemeManagementI18nTranslations","out","lang","mergeThemeManagementI18n","existing","options","translations","pluginTranslations","existingTranslations","mergedTranslations","Object","keys","merged","supportedLanguages"],"mappings":"AACA,SACEA,+BAA+B,EAC/BC,kBAAkB,EAClBC,SAAS,EACTC,eAAe,EACfC,oBAAoB,QAGf,oBAAmB;AAoC1B;;;;;;CAMC,GACD,OAAO,SAASC;IACd,MAAMC,MAAiC,CAAC;IACxC,KAAK,MAAMC,QAAQN,qBAAsB;QACvCK,GAAG,CAACC,KAAK,GAAG;YAAE,CAACP,gCAAgC,EAAEG,gBAAgBI;QAAM;IACzE;IACA,OAAOD;AACT;AAEA;;;;;;;;CAQC,GACD,OAAO,SAASE,yBACdC,QAAwB,EACxBC,OAAoC;IAEpC,IAAIA,SAASC,cAAc;QACzBP,qBAAqBM,QAAQC,YAAY;IAC3C;IAEA,MAAMC,qBAAqBP;IAC3B,MAAMQ,uBAAwBJ,UAAUE,gBAAgB,CAAC;IAEzD,+EAA+E;IAC/E,mEAAmE;IACnE,MAAMG,qBAAgD;QAAE,GAAGD,oBAAoB;IAAC;IAChF,KAAK,MAAMN,QAAQQ,OAAOC,IAAI,CAACJ,oBAAqB;QAClDE,kBAAkB,CAACP,KAAK,GAAGL,UACzBU,kBAAkB,CAACL,KAAK,EACvBM,oBAAoB,CAACN,KAAK,IAAI,CAAC;IAEpC;IAEA,MAAMU,SAAS;QACb,GAAIR,YAAY,CAAC,CAAC;QAClBE,cAAcG;IAChB;IAEA,IAAIJ,SAASQ,oBAAoB;;QAC7BD,OAA4DC,kBAAkB,GAAG;YACjF,GAAI,AAACT,UACDS,sBAAsB,CAAC,CAAC;YAC5B,GAAGR,QAAQQ,kBAAkB;QAC/B;IACF;IAEA,OAAOD;AACT"}

package/dist/index.d.ts

@@ -13,20 +13,29 @@ export type { ThemeTab } from './fields/themeConfigurationField.js';
 export { extendedThemePresets, allExtendedThemePresets, extendedThemeToCSSVariables, } from './extended-presets.js';
 export type { ExtendedThemePreset, ShadcnColorTokens } from './extended-presets.js';
 export { applyExtendedTheme, generateExtendedThemeCSS, resetExtendedTheme, getExtendedThemeTokens, createUseExtendedTheme, getTailwindVarReferences, } from './utils/extendedThemeHelpers.js';
-export type { ThemeManagementPluginOptions, ThemeManagementCacheRevalidationOptions, FetchThemeConfigurationOptions, ThemeManagementLivePreviewOptions, ThemeManagementLivePreviewUrlArgs, } from './types.js';
+export type { ThemeManagementPluginOptions, ThemeManagementCacheRevalidationOptions, FetchThemeConfigurationOptions, ThemeManagementLivePreviewOptions, ThemeManagementLivePreviewUrlArgs, PluginLogger, } from './types.js';
+export type { SiteThemeConfiguration, ThemeColorOverride, ThemeTypographyOverride, ThemeCustomization, ThemeVisualEffects, ThemeComponentStyles, } from './payload-types.js';
 export { DEFAULT_THEME_CONFIGURATION, resolveThemeConfiguration, } from './utils/resolveThemeConfiguration.js';
-export type { ResolvedThemeConfiguration } from './utils/resolveThemeConfiguration.js';
+export type { ResolvedThemeConfiguration, ResolvedVisualEffects, ResolvedComponentStyles, } from './utils/resolveThemeConfiguration.js';
+export { allStylePresets, stylePresetCategories } from './style-presets.js';
+export type { StylePreset } from './style-presets.js';
 export { generateThemeColorsCss, hexToHsl } from './utils/themeColors.js';
 export { generateThemeCSS, getThemeStyles } from './utils/themeUtils.js';
 export { getThemeHtmlAttributes } from './utils/themeHtmlAttributes.js';
+export { FONT_CATALOG, buildThemeFontsHref, getFontCatalogEntry, } from './constants/themeFonts.js';
+export type { FontCatalogEntry, ThemeFontLoading } from './constants/themeFonts.js';
+export { themeFontEndpoints } from './endpoints/themeFonts.js';
 export { generateThemeCSS as generatePresetCSS, generateAllThemesCSS, } from './utils/generateThemeCSS.js';
 export { getThemeDynamicCSS, getAllDynamicThemesCSS } from './utils/themeCSS.js';
 export type { Mode, ThemeDefaults } from './providers/Theme/types.js';
-export { ThemeProvider } from './providers/Theme/index.js';
+export { ThemeProvider, useTheme } from './providers/Theme/index.js';
 export { getFontLoaderCode, getThemeFontFamilies, ThemeFontProvider, useThemeFonts, FONT_IMPORT_MAP, } from './providers/font-loader.js';
 export declare const ThemeManagementPlugin: (options?: ThemeManagementPluginOptions) => Plugin;
 /** @deprecated use {@link themeManagementPlugin} */
 export declare const themeConfigurationPlugin: (options?: ThemeManagementPluginOptions) => Plugin;
-export { translations, getTranslations, registerTranslations, availableLanguages, } from './translations.js';
+export { translations, getTranslations, registerTranslations, availableLanguages, THEME_MANAGEMENT_I18N_NAMESPACE, } from './translations.js';
+export type { PluginTranslations, Language, DeepPartial } from './translations.js';
+export { mergeThemeManagementI18n, getThemeManagementI18nTranslations, } from './i18n.js';
+export type { ThemeManagementI18nOptions, ThemeManagementI18nTranslations, } from './i18n.js';
 export default themeManagementPlugin;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAiD,MAAM,EAAa,MAAM,SAAS,CAAA;AAG/F,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,oBAAoB,CAAA;AAChE,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAG/C,OAAO,KAAK,EACV,8BAA8B,EAG9B,4BAA4B,EAC7B,MAAM,YAAY,CAAA;AA0nBnB,eAAO,MAAM,qBAAqB,GAAI,UAAS,4BAAiC,KAAG,MAyOlF,CAAA;AAED,KAAK,iBAAiB,GAAG,MAAM,GAAG,8BAA8B,CAAA;AAEhE,eAAO,MAAM,uBAAuB,GAClC,UAAU,iBAAiB,KAC1B,OAAO,CAAC,sBAAsB,GAAG,IAAI,CA6EvC,CAAA;AAED,eAAO,MAAM,cAAc,GAAI,WAAW,MAAM,KAAG,WAAW,GAAG,IAEhE,CAAA;AAED,eAAO,MAAM,wBAAwB,QAAO,WAAW,EAEtD,CAAA;AAED,OAAO,EAAE,mBAAmB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAA;AACnE,YAAY,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAA;AACtE,YAAY,EAAE,QAAQ,EAAE,MAAM,qCAAqC,CAAA;AACnE,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,2BAA2B,GAC5B,MAAM,uBAAuB,CAAA;AAC9B,YAAY,EAAE,mBAAmB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AACnF,OAAO,EACL,kBAAkB,EAClB,wBAAwB,EACxB,kBAAkB,EAClB,sBAAsB,EACtB,sBAAsB,EACtB,wBAAwB,GACzB,MAAM,iCAAiC,CAAA;AACxC,YAAY,EACV,4BAA4B,EAC5B,uCAAuC,EACvC,8BAA8B,EAC9B,iCAAiC,EACjC,iCAAiC,GAClC,MAAM,YAAY,CAAA;AACnB,OAAO,EACL,2BAA2B,EAC3B,yBAAyB,GAC1B,MAAM,sCAAsC,CAAA;AAC7C,YAAY,EAAE,0BAA0B,EAAE,MAAM,sCAAsC,CAAA;AACtF,OAAO,EAAE,sBAAsB,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAA;AACzE,OAAO,EAAE,gBAAgB,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAA;AACxE,OAAO,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAA;AAGvE,OAAO,EACL,gBAAgB,IAAI,iBAAiB,EACrC,oBAAoB,GACrB,MAAM,6BAA6B,CAAA;AACpC,OAAO,EAAE,kBAAkB,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAA;AAEhF,YAAY,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAA;AACrE,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAA;AAG1D,OAAO,EACL,iBAAiB,EACjB,oBAAoB,EACpB,iBAAiB,EACjB,aAAa,EACb,eAAe,GAChB,MAAM,4BAA4B,CAAA;AAMnC,eAAO,MAAM,qBAAqB,aA9Xa,4BAA4B,KAAQ,MA8XzB,CAAA;AAC1D,oDAAoD;AACpD,eAAO,MAAM,wBAAwB,aAhYU,4BAA4B,KAAQ,MAgYtB,CAAA;AAG7D,OAAO,EACL,YAAY,EACZ,eAAe,EACf,oBAAoB,EACpB,kBAAkB,GACnB,MAAM,mBAAmB,CAAA;AAE1B,eAAe,qBAAqB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1,5 +1,8 @@
+import { themeFontEndpoints } from './endpoints/themeFonts.js';
+import { DEFAULT_LIVE_PREVIEW_BREAKPOINTS } from './constants/devicePreviews.js';
 import { createThemeConfigurationField } from './fields/themeConfigurationField.js';
 import { allThemePresets } from './presets.js';
+import { mergeThemeManagementI18n } from './i18n.js';
 import { getTranslations, translations } from './translations.js';
 const THEME_FIELD_NAME = 'themeConfiguration';
 /**
@@ -46,7 +49,7 @@ const THEME_FIELD_NAME = 'themeConfiguration';
     const tabsField = findTabsField(sanitizedFields);
     if (!tabsField || !tabsField.tabs) {
         if (enableLogging) {
-            console.warn('🎨 Theme Management Plugin: No tabs field found. Creating a new tabs structure.');
+            console.warn('Theme Management Plugin: No tabs field found. Creating a new tabs structure.');
         }
         // If no tabs exist, create a basic tabs structure with just the theme tab
         const newTabsField = {
@@ -68,7 +71,7 @@ const THEME_FIELD_NAME = 'themeConfiguration';
         themeTab
     ];
     if (enableLogging) {
-        console.log('🎨 Theme Management Plugin: injecting Appearance Settings tab');
+        console.log('Theme Management Plugin: injecting Appearance Settings tab');
     }
     // Update the tabs field
     const updatedTabsField = {
@@ -81,7 +84,8 @@ const THEME_FIELD_NAME = 'themeConfiguration';
 const ensureCollectionsArray = (collections)=>Array.isArray(collections) ? collections : [];
 const ensureEndpointsArray = (endpoints)=>Array.isArray(endpoints) ? endpoints : [];
 const normalizeLivePreviewOptions = (livePreview)=>{
-    if (livePreview === false) {
+    if (!livePreview) {
+        // undefined or false → live preview not configured; show ThemePreviewField instead
         return {
             enabled: false,
             injectRoute: false,
@@ -94,7 +98,7 @@ const normalizeLivePreviewOptions = (livePreview)=>{
             breakpoints: undefined
         };
     }
-    const raw = typeof livePreview === 'object' && livePreview ? livePreview : {};
+    const raw = typeof livePreview === 'object' ? livePreview : {};
     return {
         enabled: raw.enabled ?? true,
         injectRoute: raw.injectRoute ?? false,
@@ -104,7 +108,7 @@ const normalizeLivePreviewOptions = (livePreview)=>{
         fallbackToFirstPage: raw.fallbackToFirstPage ?? true,
         tenantField: raw.tenantField ?? 'tenant',
         tenantQueryParam: raw.tenantQueryParam ?? 'tenant',
-        breakpoints: raw.breakpoints,
+        breakpoints: raw.breakpoints ?? DEFAULT_LIVE_PREVIEW_BREAKPOINTS,
         url: raw.url
     };
 };
@@ -244,7 +248,7 @@ const resolveLivePreviewUrl = async (args)=>{
         return buildDefaultPreviewPath(resolvedPageSlug, tenantSlug, livePreview.tenantQueryParam);
     } catch (error) {
         if (enableLogging) {
-            req.payload.logger?.warn?.('🎨 Theme Management Plugin: live preview URL fallback used', error);
+            req.payload.logger?.warn?.('Theme Management Plugin: live preview URL fallback used', error);
         }
         return buildDefaultPreviewPath(livePreview.pageSlug, tenantSlug, livePreview.tenantQueryParam);
     }
@@ -303,11 +307,11 @@ const executeThemeRevalidation = async (options)=>{
         tags.forEach((tag)=>revalidateTag(tag));
         paths.forEach((path)=>revalidatePath(path));
         if (enableLogging) {
-            logger?.info?.(`🎨 Theme Management Plugin: revalidated cache tags=[${tags.join(', ')}] paths=[${paths.join(', ')}]`);
+            logger?.info?.(`Theme Management Plugin: revalidated cache tags=[${tags.join(', ')}] paths=[${paths.join(', ')}]`);
         }
     } catch (error) {
         if (enableLogging) {
-            logger?.error?.('🎨 Theme Management Plugin: cache invalidation failed:', error);
+            logger?.error?.('Theme Management Plugin: cache invalidation failed:', error);
         }
         throw error;
     }
@@ -367,7 +371,7 @@ const createLivePreviewEndpoint = (options)=>{
             // Redirect to the actual client page (standard Payload live preview behavior)
             const destination = buildDefaultPreviewPath(pageSlug, tenantSlug, livePreview.tenantQueryParam);
             if (enableLogging) {
-                console.log('🎨 Theme Management Plugin: live preview redirect', destination);
+                console.log('Theme Management Plugin: live preview redirect', destination);
             }
             return {
                 status: 307,
@@ -446,7 +450,7 @@ const jsonResponse = (body, status = 200)=>{
 export const themeManagementPlugin = (options = {})=>{
     return (config)=>{
         const { enabled = true, targetCollection = 'site-settings', useStandaloneCollection = false, standaloneCollectionSlug = 'appearance-settings', // Allow either string or localized object; default comes from plugin translations
-        standaloneCollectionLabel = getTranslations().standaloneCollectionLabel, themePresets = allThemePresets, defaultTheme = 'cool', includeColorModeToggle = true, includeCustomCSS = true, includeBrandIdentity = false, enableAdvancedFeatures = true, enableLogging = false, livePreview = true, cacheRevalidation } = options;
+        standaloneCollectionLabel = getTranslations().standaloneCollectionLabel, themePresets = allThemePresets, defaultTheme = 'cool', includeColorModeToggle = true, includeCustomCSS = true, customThemeConfigurationFields, customThemeConfigurationSections, includeBrandIdentity = false, enableAdvancedFeatures = true, enableLogging = false, livePreview = true, cacheRevalidation, i18n } = options;
         const normalizedLivePreview = normalizeLivePreviewOptions(livePreview);
         const normalizedCacheRevalidation = normalizeCacheRevalidationOptions({
             cacheRevalidation,
@@ -455,23 +459,34 @@ export const themeManagementPlugin = (options = {})=>{
         });
         if (!enabled) {
             if (enableLogging) {
-                console.log('🎨 Theme Management Plugin: disabled via options, skipping.');
+                console.log('Theme Management Plugin: disabled via options, skipping.');
             }
             return config;
         }
+        // Register the plugin's translations into Payload's native i18n
+        // (`theme-management` namespace), merging in any user-provided extensions or
+        // overrides. This config is used as the base for every return path below.
+        const configWithI18n = {
+            ...config,
+            i18n: mergeThemeManagementI18n(config.i18n, i18n)
+        };
         const themeTab = createThemeConfigurationField({
             themePresets,
             defaultTheme,
             includeColorModeToggle,
             includeCustomCSS,
+            customThemeConfigurationFields,
+            customThemeConfigurationSections,
             includeBrandIdentity: includeBrandIdentity ?? false,
             enableAdvancedFeatures,
-            useThemePreviewField: !normalizedLivePreview.enabled
+            // Always show the static ModePreview panel; it hides at runtime when the user
+            // actively enters livePreview mode (isLivePreviewing = true in context).
+            useThemePreviewField: true
         });
         // If using standalone collection, create a new global
         if (useStandaloneCollection) {
             if (enableLogging) {
-                console.log(`🎨 Theme Management Plugin: creating standalone global "${standaloneCollectionSlug}"`);
+                console.log(`Theme Management Plugin: creating standalone global "${standaloneCollectionSlug}"`);
             }
             // Extract the fields from the tab directly (no wrapping in group)
             const tabFields = themeTab.fields ?? [];
@@ -548,16 +563,16 @@ export const themeManagementPlugin = (options = {})=>{
                     ]
                 }
             };
-            const globals = Array.isArray(config.globals) ? config.globals : [];
+            const globals = Array.isArray(configWithI18n.globals) ? configWithI18n.globals : [];
             // Check if global already exists
             const existingIndex = globals.findIndex((g)=>g.slug === standaloneCollectionSlug);
             if (existingIndex !== -1) {
                 if (enableLogging) {
-                    console.warn(`🎨 Theme Management Plugin: global "${standaloneCollectionSlug}" already exists, skipping creation.`);
+                    console.warn(`Theme Management Plugin: global "${standaloneCollectionSlug}" already exists, skipping creation.`);
                 }
-                return config;
+                return configWithI18n;
             }
-            const currentEndpoints = ensureEndpointsArray(config.endpoints);
+            const currentEndpoints = ensureEndpointsArray(configWithI18n.endpoints);
             const livePreviewEndpoint = createLivePreviewEndpoint({
                 livePreview: normalizedLivePreview,
                 enableLogging
@@ -568,8 +583,11 @@ export const themeManagementPlugin = (options = {})=>{
                 enableLogging
             });
             endpoints = mergeEndpoint(endpoints, cacheEndpoint);
+            themeFontEndpoints.forEach((endpoint)=>{
+                endpoints = mergeEndpoint(endpoints, endpoint);
+            });
             return {
-                ...config,
+                ...configWithI18n,
                 endpoints,
                 globals: [
                     ...globals,
@@ -579,13 +597,13 @@ export const themeManagementPlugin = (options = {})=>{
         }
         // Otherwise, add as tab to existing collection
         let collectionTouched = false;
-        const collections = ensureCollectionsArray(config.collections).map((collection)=>{
+        const collections = ensureCollectionsArray(configWithI18n.collections).map((collection)=>{
             if (collection.slug !== targetCollection) {
                 return collection;
             }
             collectionTouched = true;
             if (enableLogging) {
-                console.log(`🎨 Theme Management Plugin: enhancing collection "${collection.slug}"`);
+                console.log(`Theme Management Plugin: enhancing collection "${collection.slug}"`);
             }
             const existingFields = Array.isArray(collection.fields) ? collection.fields : [];
             const fields = injectThemeTab(existingFields, themeTab, enableLogging);
@@ -601,11 +619,11 @@ export const themeManagementPlugin = (options = {})=>{
         });
         if (!collectionTouched) {
             if (enableLogging) {
-                console.warn(`🎨 Theme Management Plugin: collection "${targetCollection}" was not found, leaving config untouched.`);
+                console.warn(`Theme Management Plugin: collection "${targetCollection}" was not found, leaving config untouched.`);
             }
-            return config;
+            return configWithI18n;
         }
-        const currentEndpoints = ensureEndpointsArray(config.endpoints);
+        const currentEndpoints = ensureEndpointsArray(configWithI18n.endpoints);
         const livePreviewEndpoint = createLivePreviewEndpoint({
             livePreview: normalizedLivePreview,
             enableLogging
@@ -616,8 +634,11 @@ export const themeManagementPlugin = (options = {})=>{
             enableLogging
         });
         endpoints = mergeEndpoint(endpoints, cacheEndpoint);
+        themeFontEndpoints.forEach((endpoint)=>{
+            endpoints = mergeEndpoint(endpoints, endpoint);
+        });
         return {
-            ...config,
+            ...configWithI18n,
             endpoints,
             collections
         };
@@ -627,7 +648,7 @@ export const fetchThemeConfiguration = async (options)=>{
     const normalizedOptions = typeof options === 'string' ? {
         tenantSlug: options
     } : options ?? {};
-    const { tenantSlug, collectionSlug = 'site-settings', depth, locale, draft, queryParams = {}, useGlobal = false } = normalizedOptions;
+    const { tenantSlug, collectionSlug = 'site-settings', depth, locale, draft, queryParams = {}, useGlobal = false, signal } = normalizedOptions;
     try {
         if (useGlobal) {
             // Fetch from global endpoint
@@ -644,7 +665,9 @@ export const fetchThemeConfiguration = async (options)=>{
             });
             const queryString = params.toString();
             const url = `/api/globals/${collectionSlug}${queryString ? `?${queryString}` : ''}`;
-            const response = await fetch(url);
+            const response = await fetch(url, {
+                signal
+            });
             if (!response.ok) {
                 throw new Error(`Failed to fetch theme global (status ${response.status})`);
             }
@@ -665,7 +688,9 @@ export const fetchThemeConfiguration = async (options)=>{
                 params.set(key, String(value));
             });
             const url = `/api/${collectionSlug}?${params.toString()}`;
-            const response = await fetch(url);
+            const response = await fetch(url, {
+                signal
+            });
             if (!response.ok) {
                 throw new Error(`Failed to fetch theme configuration (status ${response.status})`);
             }
@@ -688,13 +713,16 @@ export { defaultThemePresets, allThemePresets } from './presets.js';
 export { extendedThemePresets, allExtendedThemePresets, extendedThemeToCSSVariables } from './extended-presets.js';
 export { applyExtendedTheme, generateExtendedThemeCSS, resetExtendedTheme, getExtendedThemeTokens, createUseExtendedTheme, getTailwindVarReferences } from './utils/extendedThemeHelpers.js';
 export { DEFAULT_THEME_CONFIGURATION, resolveThemeConfiguration } from './utils/resolveThemeConfiguration.js';
+export { allStylePresets, stylePresetCategories } from './style-presets.js';
 export { generateThemeColorsCss, hexToHsl } from './utils/themeColors.js';
 export { generateThemeCSS, getThemeStyles } from './utils/themeUtils.js';
 export { getThemeHtmlAttributes } from './utils/themeHtmlAttributes.js';
+export { FONT_CATALOG, buildThemeFontsHref, getFontCatalogEntry } from './constants/themeFonts.js';
+export { themeFontEndpoints } from './endpoints/themeFonts.js';
 // Dynamic theme CSS generation
 export { generateThemeCSS as generatePresetCSS, generateAllThemesCSS } from './utils/generateThemeCSS.js';
 export { getThemeDynamicCSS, getAllDynamicThemesCSS } from './utils/themeCSS.js';
-export { ThemeProvider } from './providers/Theme/index.js';
+export { ThemeProvider, useTheme } from './providers/Theme/index.js';
 // Font loading utilities for Next.js integration
 export { getFontLoaderCode, getThemeFontFamilies, ThemeFontProvider, useThemeFonts, FONT_IMPORT_MAP } from './providers/font-loader.js';
 // Note: Do NOT re-export client components from the root entry to avoid
@@ -703,7 +731,9 @@ export { getFontLoaderCode, getThemeFontFamilies, ThemeFontProvider, useThemeFon
 export const ThemeManagementPlugin = themeManagementPlugin;
 /** @deprecated use {@link themeManagementPlugin} */ export const themeConfigurationPlugin = themeManagementPlugin;
 // Export plugin translations for consumers to merge into their payload translations
-export { translations, getTranslations, registerTranslations, availableLanguages } from './translations.js';
+export { translations, getTranslations, registerTranslations, availableLanguages, THEME_MANAGEMENT_I18N_NAMESPACE } from './translations.js';
+// Native Payload i18n helpers (theme-management namespace)
+export { mergeThemeManagementI18n, getThemeManagementI18nTranslations } from './i18n.js';
 export default themeManagementPlugin;
 
 //# sourceMappingURL=index.js.map