@kilivi/payloadcms-theme-management 1.1.2 → 2.1.0

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,26 @@ 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 { 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;AA2hBnB,eAAO,MAAM,qBAAqB,GAAI,UAAS,4BAAiC,KAAG,MA+NlF,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,aApXa,4BAA4B,KAAQ,MAoXzB,CAAA;AAC1D,oDAAoD;AACpD,eAAO,MAAM,wBAAwB,aAtXU,4BAA4B,KAAQ,MAsXtB,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,7 @@
+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 +48,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 +70,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,9 +83,12 @@ 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,
+            routePath: '/theme/preview',
             pageCollection: 'pages',
             pageSlug: 'home',
             fallbackToFirstPage: true,
@@ -92,15 +97,17 @@ 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,
+        routePath: normalizeRoutePath(raw.routePath),
         pageCollection: raw.pageCollection ?? 'pages',
         pageSlug: raw.pageSlug ?? 'home',
         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
     };
 };
@@ -240,7 +247,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);
     }
@@ -299,11 +306,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;
     }
@@ -312,6 +319,68 @@ const executeThemeRevalidation = async (options)=>{
         paths
     };
 };
+const readQueryStringFromRequest = (req, paramName)=>{
+    const reqRecord = asRecord(req);
+    // Try URLSearchParams from native fetch/Node.js
+    const queryValue = reqRecord?.query;
+    if (queryValue && typeof URLSearchParams !== 'undefined' && queryValue instanceof URLSearchParams) {
+        return pickString(queryValue.get(paramName));
+    }
+    // Try object form (common in Payload)
+    const queryRecord = asRecord(queryValue);
+    if (queryRecord) {
+        const rawValue = queryRecord[paramName];
+        if (Array.isArray(rawValue)) {
+            return pickString(rawValue[0]);
+        }
+        return pickString(rawValue);
+    }
+    // Try manual URL parsing as fallback
+    const urlValue = pickString(reqRecord?.url) ?? pickString(reqRecord?.originalUrl);
+    if (urlValue) {
+        try {
+            const url = new URL(urlValue, 'http://localhost');
+            return pickString(url.searchParams.get(paramName));
+        } catch  {
+        // Ignore parse errors
+        }
+    }
+    return undefined;
+};
+const createLivePreviewEndpoint = (options)=>{
+    const { livePreview, enableLogging } = options;
+    if (!livePreview.enabled || !livePreview.injectRoute) {
+        return null;
+    }
+    return {
+        path: livePreview.routePath,
+        method: 'get',
+        handler: async (req)=>{
+            const previewSecret = process.env.PREVIEW_SECRET ?? process.env.PAYLOAD_PREVIEW_SECRET;
+            if (previewSecret) {
+                const providedSecret = readQueryStringFromRequest(req, 'previewSecret') ?? readQueryStringFromRequest(req, 'preview');
+                if (providedSecret !== previewSecret) {
+                    return jsonResponse({
+                        error: 'Unauthorized'
+                    }, 401);
+                }
+            }
+            const pageSlug = readQueryStringFromRequest(req, 'pageSlug') ?? livePreview.pageSlug;
+            const tenantSlug = readQueryStringFromRequest(req, 'tenant');
+            // 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);
+            }
+            return {
+                status: 307,
+                headers: {
+                    Location: destination
+                }
+            };
+        }
+    };
+};
 const createCacheRevalidationEndpoint = (options)=>{
     const { cacheRevalidation, enableLogging } = options;
     if (!cacheRevalidation.enabled || !cacheRevalidation.injectRoute) {
@@ -356,9 +425,10 @@ const mergeEndpoint = (endpoints, endpoint)=>{
     if (!endpoint) {
         return endpoints;
     }
+    const record = endpoint;
     const withoutExisting = endpoints.filter((candidate)=>{
-        const record = candidate;
-        return !(record?.path === endpoint.path && typeof record.method === 'string' && record.method.toLowerCase() === endpoint.method);
+        const candidateRecord = candidate;
+        return !(candidateRecord?.path === record?.path && typeof candidateRecord.method === 'string' && typeof record.method === 'string' && candidateRecord.method.toLowerCase() === record.method.toLowerCase());
     });
     return [
         ...withoutExisting,
@@ -379,7 +449,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,
@@ -388,23 +458,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 ?? [];
@@ -481,23 +562,28 @@ 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
+            });
+            let endpoints = mergeEndpoint(currentEndpoints, livePreviewEndpoint);
             const cacheEndpoint = createCacheRevalidationEndpoint({
                 cacheRevalidation: normalizedCacheRevalidation,
                 enableLogging
             });
-            const endpoints = mergeEndpoint(currentEndpoints, cacheEndpoint);
+            endpoints = mergeEndpoint(endpoints, cacheEndpoint);
             return {
-                ...config,
+                ...configWithI18n,
                 endpoints,
                 globals: [
                     ...globals,
@@ -507,13 +593,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);
@@ -529,18 +615,23 @@ 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
+        });
+        let endpoints = mergeEndpoint(currentEndpoints, livePreviewEndpoint);
         const cacheEndpoint = createCacheRevalidationEndpoint({
             cacheRevalidation: normalizedCacheRevalidation,
             enableLogging
         });
-        const endpoints = mergeEndpoint(currentEndpoints, cacheEndpoint);
+        endpoints = mergeEndpoint(endpoints, cacheEndpoint);
         return {
-            ...config,
+            ...configWithI18n,
             endpoints,
             collections
         };
@@ -550,7 +641,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
@@ -567,7 +658,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})`);
             }
@@ -588,7 +681,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})`);
             }
@@ -611,13 +706,14 @@ 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';
 // 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
@@ -626,7 +722,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