@kilivi/payloadcms-theme-management 1.1.0 → 1.1.2

package/dist/server.js

@@ -1,5 +1,47 @@
 import 'server-only';
+import { revalidatePath, revalidateTag, unstable_cache } from 'next/cache';
+import { DEFAULT_THEME_CONFIGURATION, resolveThemeConfiguration } from './utils/resolveThemeConfiguration.js';
 export { ServerThemeInjector } from './components/ServerThemeInjector.js';
 export { createFallbackCriticalCSS, getThemeCriticalCSS, getThemeCSS, generateThemePreloadLinks, getThemeCSSPath } from './utils/themeAssets.js';
+export const getThemeCacheTag = (globalSlug = 'appearance-settings')=>`global_${globalSlug}`;
+export const createCachedThemeFetcher = (options)=>{
+    const { loadAppearanceSettings, globalSlug = 'appearance-settings', cacheKeyParts = [], tags = [], revalidate = 3600 } = options;
+    const defaultTag = getThemeCacheTag(globalSlug);
+    const cacheKey = [
+        `${globalSlug}-theme`,
+        ...cacheKeyParts
+    ];
+    const cacheTags = [
+        ...new Set([
+            defaultTag,
+            ...tags
+        ].filter(Boolean))
+    ];
+    return unstable_cache(async ()=>{
+        const appearanceSettings = await loadAppearanceSettings();
+        return resolveThemeConfiguration(appearanceSettings?.themeConfiguration ?? DEFAULT_THEME_CONFIGURATION);
+    }, cacheKey, {
+        tags: cacheTags,
+        revalidate
+    });
+};
+export const revalidateThemeCache = async (options = {})=>{
+    const { globalSlug = 'appearance-settings', tags = [], paths = [] } = options;
+    const resolvedTags = [
+        ...new Set([
+            getThemeCacheTag(globalSlug),
+            ...tags
+        ].filter(Boolean))
+    ];
+    const resolvedPaths = [
+        ...new Set(paths.filter((value)=>typeof value === 'string' && value))
+    ];
+    resolvedTags.forEach((tag)=>revalidateTag(tag));
+    resolvedPaths.forEach((path)=>revalidatePath(path));
+    return {
+        tags: resolvedTags,
+        paths: resolvedPaths
+    };
+};
 
 //# sourceMappingURL=server.js.map

package/dist/server.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/server.ts"],"sourcesContent":["import 'server-only'\n\nexport { ServerThemeInjector } from './components/ServerThemeInjector.js'\n\nexport {\n  createFallbackCriticalCSS,\n  getThemeCriticalCSS,\n  getThemeCSS,\n  generateThemePreloadLinks,\n  getThemeCSSPath,\n} from './utils/themeAssets.js'\n"],"names":["ServerThemeInjector","createFallbackCriticalCSS","getThemeCriticalCSS","getThemeCSS","generateThemePreloadLinks","getThemeCSSPath"],"mappings":"AAAA,OAAO,cAAa;AAEpB,SAASA,mBAAmB,QAAQ,sCAAqC;AAEzE,SACEC,yBAAyB,EACzBC,mBAAmB,EACnBC,WAAW,EACXC,yBAAyB,EACzBC,eAAe,QACV,yBAAwB"}
+{"version":3,"sources":["../src/server.ts"],"sourcesContent":["import 'server-only'\nimport { revalidatePath, revalidateTag, unstable_cache } from 'next/cache'\nimport type { SiteThemeConfiguration } from './payload-types.js'\nimport {\n  DEFAULT_THEME_CONFIGURATION,\n  resolveThemeConfiguration,\n} from './utils/resolveThemeConfiguration.js'\n\nexport { ServerThemeInjector } from './components/ServerThemeInjector.js'\n\nexport {\n  createFallbackCriticalCSS,\n  getThemeCriticalCSS,\n  getThemeCSS,\n  generateThemePreloadLinks,\n  getThemeCSSPath,\n} from './utils/themeAssets.js'\n\nexport const getThemeCacheTag = (globalSlug = 'appearance-settings'): string =>\n  `global_${globalSlug}`\n\ninterface ThemeGlobalLike {\n  themeConfiguration?: SiteThemeConfiguration | null\n}\n\ninterface CreateCachedThemeFetcherOptions {\n  /** Function that loads the appearance global document. */\n  loadAppearanceSettings: () => Promise<ThemeGlobalLike | null | undefined>\n  /** Optional global slug used for default cache tag and key (default: 'appearance-settings'). */\n  globalSlug?: string\n  /** Additional cache key parts passed to unstable_cache. */\n  cacheKeyParts?: string[]\n  /** Additional tags to include besides the default `global_{slug}` tag. */\n  tags?: string[]\n  /** Next.js revalidate interval in seconds (default: 3600). */\n  revalidate?: number | false\n}\n\nexport const createCachedThemeFetcher = (options: CreateCachedThemeFetcherOptions) => {\n  const {\n    loadAppearanceSettings,\n    globalSlug = 'appearance-settings',\n    cacheKeyParts = [],\n    tags = [],\n    revalidate = 3600,\n  } = options\n\n  const defaultTag = getThemeCacheTag(globalSlug)\n  const cacheKey = [`${globalSlug}-theme`, ...cacheKeyParts]\n  const cacheTags = [...new Set([defaultTag, ...tags].filter(Boolean))]\n\n  return unstable_cache(\n    async () => {\n      const appearanceSettings = await loadAppearanceSettings()\n      return resolveThemeConfiguration(\n        appearanceSettings?.themeConfiguration ?? DEFAULT_THEME_CONFIGURATION,\n      )\n    },\n    cacheKey,\n    {\n      tags: cacheTags,\n      revalidate,\n    },\n  )\n}\n\ninterface RevalidateThemeCacheOptions {\n  /** Optional global slug for default tag (default: 'appearance-settings'). */\n  globalSlug?: string\n  /** Extra cache tags to invalidate. */\n  tags?: string[]\n  /** Optional paths to invalidate with revalidatePath. */\n  paths?: string[]\n}\n\nexport const revalidateThemeCache = async (\n  options: RevalidateThemeCacheOptions = {},\n): Promise<{ tags: string[]; paths: string[] }> => {\n  const { globalSlug = 'appearance-settings', tags = [], paths = [] } = options\n\n  const resolvedTags = [...new Set([getThemeCacheTag(globalSlug), ...tags].filter(Boolean))]\n  const resolvedPaths = [...new Set(paths.filter((value) => typeof value === 'string' && value))]\n\n  resolvedTags.forEach((tag) => revalidateTag(tag))\n  resolvedPaths.forEach((path) => revalidatePath(path))\n\n  return {\n    tags: resolvedTags,\n    paths: resolvedPaths,\n  }\n}\n"],"names":["revalidatePath","revalidateTag","unstable_cache","DEFAULT_THEME_CONFIGURATION","resolveThemeConfiguration","ServerThemeInjector","createFallbackCriticalCSS","getThemeCriticalCSS","getThemeCSS","generateThemePreloadLinks","getThemeCSSPath","getThemeCacheTag","globalSlug","createCachedThemeFetcher","options","loadAppearanceSettings","cacheKeyParts","tags","revalidate","defaultTag","cacheKey","cacheTags","Set","filter","Boolean","appearanceSettings","themeConfiguration","revalidateThemeCache","paths","resolvedTags","resolvedPaths","value","forEach","tag","path"],"mappings":"AAAA,OAAO,cAAa;AACpB,SAASA,cAAc,EAAEC,aAAa,EAAEC,cAAc,QAAQ,aAAY;AAE1E,SACEC,2BAA2B,EAC3BC,yBAAyB,QACpB,uCAAsC;AAE7C,SAASC,mBAAmB,QAAQ,sCAAqC;AAEzE,SACEC,yBAAyB,EACzBC,mBAAmB,EACnBC,WAAW,EACXC,yBAAyB,EACzBC,eAAe,QACV,yBAAwB;AAE/B,OAAO,MAAMC,mBAAmB,CAACC,aAAa,qBAAqB,GACjE,CAAC,OAAO,EAAEA,YAAY,CAAA;AAmBxB,OAAO,MAAMC,2BAA2B,CAACC;IACvC,MAAM,EACJC,sBAAsB,EACtBH,aAAa,qBAAqB,EAClCI,gBAAgB,EAAE,EAClBC,OAAO,EAAE,EACTC,aAAa,IAAI,EAClB,GAAGJ;IAEJ,MAAMK,aAAaR,iBAAiBC;IACpC,MAAMQ,WAAW;QAAC,GAAGR,WAAW,MAAM,CAAC;WAAKI;KAAc;IAC1D,MAAMK,YAAY;WAAI,IAAIC,IAAI;YAACH;eAAeF;SAAK,CAACM,MAAM,CAACC;KAAU;IAErE,OAAOtB,eACL;QACE,MAAMuB,qBAAqB,MAAMV;QACjC,OAAOX,0BACLqB,oBAAoBC,sBAAsBvB;IAE9C,GACAiB,UACA;QACEH,MAAMI;QACNH;IACF;AAEJ,EAAC;AAWD,OAAO,MAAMS,uBAAuB,OAClCb,UAAuC,CAAC,CAAC;IAEzC,MAAM,EAAEF,aAAa,qBAAqB,EAAEK,OAAO,EAAE,EAAEW,QAAQ,EAAE,EAAE,GAAGd;IAEtE,MAAMe,eAAe;WAAI,IAAIP,IAAI;YAACX,iBAAiBC;eAAgBK;SAAK,CAACM,MAAM,CAACC;KAAU;IAC1F,MAAMM,gBAAgB;WAAI,IAAIR,IAAIM,MAAML,MAAM,CAAC,CAACQ,QAAU,OAAOA,UAAU,YAAYA;KAAQ;IAE/FF,aAAaG,OAAO,CAAC,CAACC,MAAQhC,cAAcgC;IAC5CH,cAAcE,OAAO,CAAC,CAACE,OAASlC,eAAekC;IAE/C,OAAO;QACLjB,MAAMY;QACND,OAAOE;IACT;AACF,EAAC"}

package/dist/types/color.d.js

@@ -0,0 +1,2 @@
+
+//# sourceMappingURL=color.d.js.map

package/dist/types/color.d.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/types/color.d.ts"],"names":[],"mappings":""}

package/dist/types.d.ts

@@ -1,4 +1,69 @@
 import type { ThemePreset } from './presets.js';
+export interface ThemeManagementLivePreviewUrlArgs {
+    /** Resolved preview page document (if found) */
+    page?: Record<string, unknown>;
+    /** Resolved preview page slug */
+    pageSlug: string;
+    /** Inferred tenant identifier (if available) */
+    tenantSlug?: string;
+    /** Current Payload request */
+    req: {
+        payload: {
+            find: (args: Record<string, unknown>) => Promise<{
+                docs?: Array<Record<string, unknown>>;
+            }>;
+            logger?: {
+                warn?: (...args: unknown[]) => void;
+            };
+        };
+        query?: unknown;
+        headers?: unknown;
+        user?: unknown;
+    };
+}
+export interface ThemeManagementLivePreviewOptions {
+    /** Enable Payload admin live preview for the target config (default: true) */
+    enabled?: boolean;
+    /** Collection slug containing preview pages (default: 'pages') */
+    pageCollection?: string;
+    /** Preferred page slug for preview (default: 'home') */
+    pageSlug?: string;
+    /** Fallback to first page if preferred slug does not exist (default: true) */
+    fallbackToFirstPage?: boolean;
+    /** Tenant field name used for filtering in multi-tenant setups (default: 'tenant') */
+    tenantField?: string;
+    /** Query param name appended to default URL when tenant is resolved (default: 'tenant') */
+    tenantQueryParam?: string;
+    /**
+     * Device breakpoints shown in Payload's Live Preview toolbar (iframe size presets).
+     * Use this to make preview sizing more practical for your editors.
+     */
+    breakpoints?: Array<{
+        name: string;
+        label: string;
+        width: number | string;
+        height: number | string;
+    }>;
+    /**
+     * Custom URL resolver for Payload live preview.
+     * Defaults to `/${slug}` (or `/` for `home`) with optional tenant query param.
+     */
+    url?: (args: ThemeManagementLivePreviewUrlArgs) => string | Promise<string>;
+}
+export interface ThemeManagementCacheRevalidationOptions {
+    /** Enable cache revalidation support (default: true for standalone mode, false for tab mode) */
+    enabled?: boolean;
+    /** Inject a Payload endpoint for manual/external revalidation triggers (default: true) */
+    injectRoute?: boolean;
+    /** Endpoint path under Payload API (default: '/theme/revalidate') */
+    routePath?: string;
+    /** Optional shared secret checked against header/body/query before revalidation */
+    secret?: string;
+    /** Additional tags to revalidate together with the default global tag */
+    tags?: string[];
+    /** Optional paths to revalidate together with tags */
+    paths?: string[];
+}
 export interface ThemeManagementPluginOptions {
     /** Whether the plugin should register itself */
     enabled?: boolean;
@@ -24,6 +89,10 @@ export interface ThemeManagementPluginOptions {
     enableAdvancedFeatures?: boolean;
     /** Log helpful messages during config mutation */
     enableLogging?: boolean;
+    /** Configure Payload admin live preview URL generation */
+    livePreview?: boolean | ThemeManagementLivePreviewOptions;
+    /** Configure cache revalidation route and tags for Next.js `unstable_cache` usage */
+    cacheRevalidation?: boolean | ThemeManagementCacheRevalidationOptions;
 }
 export interface FetchThemeConfigurationOptions {
     /** Optional tenant identifier if your project is multi-tenant */

package/dist/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,cAAc,CAAA;AAE/C,MAAM,WAAW,4BAA4B;IAC3C,gDAAgD;IAChD,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,iFAAiF;IACjF,gBAAgB,CAAC,EAAE,MAAM,CAAA;IACzB,iFAAiF;IACjF,uBAAuB,CAAC,EAAE,OAAO,CAAA;IACjC,yEAAyE;IACzE,wBAAwB,CAAC,EAAE,MAAM,CAAA;IACjC,2EAA2E;IAC3E,yBAAyB,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC3D,yCAAyC;IACzC,YAAY,CAAC,EAAE,WAAW,EAAE,CAAA;IAC5B,kDAAkD;IAClD,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,gEAAgE;IAChE,sBAAsB,CAAC,EAAE,OAAO,CAAA;IAChC,+BAA+B;IAC/B,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,gDAAgD;IAChD,oBAAoB,CAAC,EAAE,OAAO,CAAA;IAC9B,uDAAuD;IACvD,sBAAsB,CAAC,EAAE,OAAO,CAAA;IAChC,kDAAkD;IAClD,aAAa,CAAC,EAAE,OAAO,CAAA;CACxB;AAED,MAAM,WAAW,8BAA8B;IAC7C,iEAAiE;IACjE,UAAU,CAAC,EAAE,MAAM,CAAA;IACnB,iEAAiE;IACjE,cAAc,CAAC,EAAE,MAAM,CAAA;IACvB,iDAAiD;IACjD,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,kDAAkD;IAClD,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,8BAA8B;IAC9B,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,sDAAsD;IACtD,WAAW,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAA;IACvD,oFAAoF;IACpF,SAAS,CAAC,EAAE,OAAO,CAAA;CACpB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"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"}

package/dist/types.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/types.ts"],"sourcesContent":["import type { ThemePreset } from './presets.js'\n\nexport interface ThemeManagementPluginOptions {\n  /** Whether the plugin should register itself */\n  enabled?: boolean\n  /** Collection slug that stores site-level settings (default: `site-settings`) */\n  targetCollection?: string\n  /** Create a standalone collection instead of adding as a tab (default: false) */\n  useStandaloneCollection?: boolean\n  /** Name of the standalone collection (default: 'appearance-settings') */\n  standaloneCollectionSlug?: string\n  /** Label for the standalone collection (default: 'Appearance Settings') */\n  standaloneCollectionLabel?: string | Record<string, string>\n  /** Theme presets available to editors */\n  themePresets?: ThemePreset[]\n  /** Default preset name when no value is stored */\n  defaultTheme?: string\n  /** Allow editors to toggle between light / dark / auto modes */\n  includeColorModeToggle?: boolean\n  /** Expose custom CSS editor */\n  includeCustomCSS?: boolean\n  /** Reserved for future use, keeps API parity */\n  includeBrandIdentity?: boolean\n  /** Enable advanced controls such as animation level */\n  enableAdvancedFeatures?: boolean\n  /** Log helpful messages during config mutation */\n  enableLogging?: boolean\n}\n\nexport interface FetchThemeConfigurationOptions {\n  /** Optional tenant identifier if your project is multi-tenant */\n  tenantSlug?: string\n  /** Collection/Global slug override (default: `site-settings`) */\n  collectionSlug?: string\n  /** Depth parameter passed to Payload REST API */\n  depth?: number\n  /** Locale parameter passed to Payload REST API */\n  locale?: string\n  /** Include draft documents */\n  draft?: boolean\n  /** Extra query parameters to append to the request */\n  queryParams?: Record<string, string | number | boolean>\n  /** Set to true if using standalone global instead of collection (default: false) */\n  useGlobal?: boolean\n}\n"],"names":[],"mappings":"AA6BA,WAeC"}
+{"version":3,"sources":["../src/types.ts"],"sourcesContent":["import type { ThemePreset } from './presets.js'\n\nexport interface ThemeManagementLivePreviewUrlArgs {\n  /** Resolved preview page document (if found) */\n  page?: Record<string, unknown>\n  /** Resolved preview page slug */\n  pageSlug: string\n  /** Inferred tenant identifier (if available) */\n  tenantSlug?: string\n  /** Current Payload request */\n  req: {\n    payload: {\n      find: (args: Record<string, unknown>) => Promise<{ docs?: Array<Record<string, unknown>> }>\n      logger?: {\n        warn?: (...args: unknown[]) => void\n      }\n    }\n    query?: unknown\n    headers?: unknown\n    user?: unknown\n  }\n}\n\nexport interface ThemeManagementLivePreviewOptions {\n  /** Enable Payload admin live preview for the target config (default: true) */\n  enabled?: boolean\n  /** Collection slug containing preview pages (default: 'pages') */\n  pageCollection?: string\n  /** Preferred page slug for preview (default: 'home') */\n  pageSlug?: string\n  /** Fallback to first page if preferred slug does not exist (default: true) */\n  fallbackToFirstPage?: boolean\n  /** Tenant field name used for filtering in multi-tenant setups (default: 'tenant') */\n  tenantField?: string\n  /** Query param name appended to default URL when tenant is resolved (default: 'tenant') */\n  tenantQueryParam?: string\n  /**\n   * Device breakpoints shown in Payload's Live Preview toolbar (iframe size presets).\n   * Use this to make preview sizing more practical for your editors.\n   */\n  breakpoints?: Array<{\n    name: string\n    label: string\n    width: number | string\n    height: number | string\n  }>\n  /**\n   * Custom URL resolver for Payload live preview.\n   * Defaults to `/${slug}` (or `/` for `home`) with optional tenant query param.\n   */\n  url?: (args: ThemeManagementLivePreviewUrlArgs) => string | Promise<string>\n}\n\nexport interface ThemeManagementCacheRevalidationOptions {\n  /** Enable cache revalidation support (default: true for standalone mode, false for tab mode) */\n  enabled?: boolean\n  /** Inject a Payload endpoint for manual/external revalidation triggers (default: true) */\n  injectRoute?: boolean\n  /** Endpoint path under Payload API (default: '/theme/revalidate') */\n  routePath?: string\n  /** Optional shared secret checked against header/body/query before revalidation */\n  secret?: string\n  /** Additional tags to revalidate together with the default global tag */\n  tags?: string[]\n  /** Optional paths to revalidate together with tags */\n  paths?: string[]\n}\n\nexport interface ThemeManagementPluginOptions {\n  /** Whether the plugin should register itself */\n  enabled?: boolean\n  /** Collection slug that stores site-level settings (default: `site-settings`) */\n  targetCollection?: string\n  /** Create a standalone collection instead of adding as a tab (default: false) */\n  useStandaloneCollection?: boolean\n  /** Name of the standalone collection (default: 'appearance-settings') */\n  standaloneCollectionSlug?: string\n  /** Label for the standalone collection (default: 'Appearance Settings') */\n  standaloneCollectionLabel?: string | Record<string, string>\n  /** Theme presets available to editors */\n  themePresets?: ThemePreset[]\n  /** Default preset name when no value is stored */\n  defaultTheme?: string\n  /** Allow editors to toggle between light / dark / auto modes */\n  includeColorModeToggle?: boolean\n  /** Expose custom CSS editor */\n  includeCustomCSS?: boolean\n  /** Reserved for future use, keeps API parity */\n  includeBrandIdentity?: boolean\n  /** Enable advanced controls such as animation level */\n  enableAdvancedFeatures?: boolean\n  /** Log helpful messages during config mutation */\n  enableLogging?: boolean\n  /** Configure Payload admin live preview URL generation */\n  livePreview?: boolean | ThemeManagementLivePreviewOptions\n  /** Configure cache revalidation route and tags for Next.js `unstable_cache` usage */\n  cacheRevalidation?: boolean | ThemeManagementCacheRevalidationOptions\n}\n\nexport interface FetchThemeConfigurationOptions {\n  /** Optional tenant identifier if your project is multi-tenant */\n  tenantSlug?: string\n  /** Collection/Global slug override (default: `site-settings`) */\n  collectionSlug?: string\n  /** Depth parameter passed to Payload REST API */\n  depth?: number\n  /** Locale parameter passed to Payload REST API */\n  locale?: string\n  /** Include draft documents */\n  draft?: boolean\n  /** Extra query parameters to append to the request */\n  queryParams?: Record<string, string | number | boolean>\n  /** Set to true if using standalone global instead of collection (default: false) */\n  useGlobal?: boolean\n}\n"],"names":[],"mappings":"AAmGA,WAeC"}

package/dist/utils/livePreviewRefresh.d.ts

@@ -0,0 +1,17 @@
+export interface CreateThemeLivePreviewRefreshOptions {
+    /** Endpoint exposed by theme-management plugin for cache revalidation. */
+    endpoint?: string;
+    /** Optional secret sent as x-theme-revalidate-secret header. */
+    secret?: string;
+    /** Request credentials mode (default: include). */
+    credentials?: RequestCredentials;
+    /** Optional callback triggered when revalidation request fails. */
+    onError?: (error: unknown) => void;
+    /** Optional callback executed after revalidation attempt (typically router.refresh). */
+    onAfterRevalidate?: () => void | Promise<void>;
+    /** Test hook to override fetch implementation. */
+    fetchImpl?: typeof fetch;
+}
+export declare const DEFAULT_THEME_REVALIDATE_ENDPOINT = "/api/theme/revalidate";
+export declare const createThemeLivePreviewRefresh: (options?: CreateThemeLivePreviewRefreshOptions) => (() => Promise<void>);
+//# sourceMappingURL=livePreviewRefresh.d.ts.map

package/dist/utils/livePreviewRefresh.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"livePreviewRefresh.d.ts","sourceRoot":"","sources":["../../src/utils/livePreviewRefresh.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,oCAAoC;IACnD,0EAA0E;IAC1E,QAAQ,CAAC,EAAE,MAAM,CAAA;IACjB,gEAAgE;IAChE,MAAM,CAAC,EAAE,MAAM,CAAA;IACf,mDAAmD;IACnD,WAAW,CAAC,EAAE,kBAAkB,CAAA;IAChC,mEAAmE;IACnE,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAA;IAClC,wFAAwF;IACxF,iBAAiB,CAAC,EAAE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;IAC9C,kDAAkD;IAClD,SAAS,CAAC,EAAE,OAAO,KAAK,CAAA;CACzB;AAED,eAAO,MAAM,iCAAiC,0BAA0B,CAAA;AAExE,eAAO,MAAM,6BAA6B,GACxC,UAAS,oCAAyC,KACjD,CAAC,MAAM,OAAO,CAAC,IAAI,CAAC,CA4BtB,CAAA"}

package/dist/utils/livePreviewRefresh.js

@@ -0,0 +1,20 @@
+export const DEFAULT_THEME_REVALIDATE_ENDPOINT = '/api/theme/revalidate';
+export const createThemeLivePreviewRefresh = (options = {})=>{
+    const { endpoint = process.env.NEXT_PUBLIC_THEME_REVALIDATE_ENDPOINT || DEFAULT_THEME_REVALIDATE_ENDPOINT, secret = process.env.NEXT_PUBLIC_THEME_REVALIDATE_SECRET, credentials = 'include', onError, onAfterRevalidate, fetchImpl = fetch } = options;
+    return async ()=>{
+        try {
+            await fetchImpl(endpoint, {
+                method: 'POST',
+                credentials,
+                headers: secret ? {
+                    'x-theme-revalidate-secret': secret
+                } : undefined
+            });
+        } catch (error) {
+            onError?.(error);
+        }
+        await onAfterRevalidate?.();
+    };
+};
+
+//# sourceMappingURL=livePreviewRefresh.js.map

package/dist/utils/livePreviewRefresh.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/livePreviewRefresh.ts"],"sourcesContent":["export interface CreateThemeLivePreviewRefreshOptions {\n  /** Endpoint exposed by theme-management plugin for cache revalidation. */\n  endpoint?: string\n  /** Optional secret sent as x-theme-revalidate-secret header. */\n  secret?: string\n  /** Request credentials mode (default: include). */\n  credentials?: RequestCredentials\n  /** Optional callback triggered when revalidation request fails. */\n  onError?: (error: unknown) => void\n  /** Optional callback executed after revalidation attempt (typically router.refresh). */\n  onAfterRevalidate?: () => void | Promise<void>\n  /** Test hook to override fetch implementation. */\n  fetchImpl?: typeof fetch\n}\n\nexport const DEFAULT_THEME_REVALIDATE_ENDPOINT = '/api/theme/revalidate'\n\nexport const createThemeLivePreviewRefresh = (\n  options: CreateThemeLivePreviewRefreshOptions = {},\n): (() => Promise<void>) => {\n  const {\n    endpoint = process.env.NEXT_PUBLIC_THEME_REVALIDATE_ENDPOINT ||\n      DEFAULT_THEME_REVALIDATE_ENDPOINT,\n    secret = process.env.NEXT_PUBLIC_THEME_REVALIDATE_SECRET,\n    credentials = 'include',\n    onError,\n    onAfterRevalidate,\n    fetchImpl = fetch,\n  } = options\n\n  return async () => {\n    try {\n      await fetchImpl(endpoint, {\n        method: 'POST',\n        credentials,\n        headers: secret\n          ? {\n              'x-theme-revalidate-secret': secret,\n            }\n          : undefined,\n      })\n    } catch (error) {\n      onError?.(error)\n    }\n\n    await onAfterRevalidate?.()\n  }\n}\n"],"names":["DEFAULT_THEME_REVALIDATE_ENDPOINT","createThemeLivePreviewRefresh","options","endpoint","process","env","NEXT_PUBLIC_THEME_REVALIDATE_ENDPOINT","secret","NEXT_PUBLIC_THEME_REVALIDATE_SECRET","credentials","onError","onAfterRevalidate","fetchImpl","fetch","method","headers","undefined","error"],"mappings":"AAeA,OAAO,MAAMA,oCAAoC,wBAAuB;AAExE,OAAO,MAAMC,gCAAgC,CAC3CC,UAAgD,CAAC,CAAC;IAElD,MAAM,EACJC,WAAWC,QAAQC,GAAG,CAACC,qCAAqC,IAC1DN,iCAAiC,EACnCO,SAASH,QAAQC,GAAG,CAACG,mCAAmC,EACxDC,cAAc,SAAS,EACvBC,OAAO,EACPC,iBAAiB,EACjBC,YAAYC,KAAK,EAClB,GAAGX;IAEJ,OAAO;QACL,IAAI;YACF,MAAMU,UAAUT,UAAU;gBACxBW,QAAQ;gBACRL;gBACAM,SAASR,SACL;oBACE,6BAA6BA;gBAC/B,IACAS;YACN;QACF,EAAE,OAAOC,OAAO;YACdP,UAAUO;QACZ;QAEA,MAAMN;IACR;AACF,EAAC"}

package/dist/utils/livePreviewThemeRuntime.d.ts

@@ -0,0 +1,7 @@
+export declare const extractThemeConfigurationFromLiveData: (liveData: Record<string, unknown>, themeConfigurationKey?: string) => unknown;
+export declare const buildLivePreviewThemeRuntime: (themeConfiguration: unknown) => {
+    theme: "cyberpunk" | "minimal" | "retro" | "brutal" | "pastel" | "ocean" | "forest" | "sunset" | "lavender" | "neutral" | "blue" | "green" | "red" | "orange" | "rose" | "violet" | "zinc" | "slate" | "stone" | "gray" | "cool" | "neon" | "solar" | "dealership" | "real-estate" | "real-estate-gold" | "real-estate-neutral";
+    mode: "light" | "dark";
+    css: string;
+};
+//# sourceMappingURL=livePreviewThemeRuntime.d.ts.map

package/dist/utils/livePreviewThemeRuntime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"livePreviewThemeRuntime.d.ts","sourceRoot":"","sources":["../../src/utils/livePreviewThemeRuntime.ts"],"names":[],"mappings":"AAKA,eAAO,MAAM,qCAAqC,GAChD,UAAU,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EACjC,8BAA4C,KAC3C,OAOF,CAAA;AAkBD,eAAO,MAAM,4BAA4B,GAAI,oBAAoB,OAAO;;;;CA0CvE,CAAA"}

package/dist/utils/livePreviewThemeRuntime.js

@@ -0,0 +1,58 @@
+import { getBorderRadiusConfig } from '../providers/Theme/themeConfig.js';
+import { resolveThemeConfiguration } from './resolveThemeConfiguration.js';
+import { generateThemeColorsCss } from './themeColors.js';
+import { generateThemeCSS } from './themeUtils.js';
+export const extractThemeConfigurationFromLiveData = (liveData, themeConfigurationKey = 'themeConfiguration')=>{
+    const candidate = liveData?.[themeConfigurationKey];
+    if (candidate && typeof candidate === 'object') {
+        return candidate;
+    }
+    return liveData;
+};
+const resolveColorMode = (mode)=>{
+    if (mode === 'dark') {
+        return 'dark';
+    }
+    if (mode === 'auto' && globalThis.window !== undefined && typeof globalThis.window.matchMedia === 'function') {
+        return globalThis.window.matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light';
+    }
+    return 'light';
+};
+export const buildLivePreviewThemeRuntime = (themeConfiguration)=>{
+    // eslint-disable-next-line @typescript-eslint/no-explicit-any
+    const resolved = resolveThemeConfiguration(themeConfiguration);
+    const borderRadiusMap = {
+        none: 'none',
+        small: 'small',
+        medium: 'medium',
+        large: 'large',
+        xl: 'xl',
+        full: 'xl'
+    };
+    const mappedBorderRadius = borderRadiusMap[resolved.borderRadius ?? 'medium'] ?? 'medium';
+    const borderRadiusConfig = getBorderRadiusConfig(mappedBorderRadius);
+    const cssRecord = typeof borderRadiusConfig?.css === 'string' ? {
+        '--radius-default': borderRadiusConfig.css
+    } : borderRadiusConfig?.css ?? {};
+    const borderRadiusCSS = Object.entries(cssRecord).map(([property, value])=>`  ${property}: ${value};`).join('\n');
+    const borderRadiusBlock = borderRadiusCSS ? `:root {\n${borderRadiusCSS}\n}` : '';
+    const themeConfigurationCSS = generateThemeCSS(resolved);
+    const colorModesCSS = generateThemeColorsCss({
+        themeName: resolved.theme,
+        lightMode: resolved.lightMode,
+        darkMode: resolved.darkMode
+    });
+    const customCSSBlock = typeof resolved.customCSS === 'string' ? resolved.customCSS.trim() : '';
+    return {
+        theme: resolved.theme,
+        mode: resolveColorMode(resolved.colorMode),
+        css: [
+            borderRadiusBlock,
+            themeConfigurationCSS,
+            colorModesCSS,
+            customCSSBlock
+        ].filter((block)=>Boolean(block?.trim?.().length)).join('\n\n')
+    };
+};
+
+//# sourceMappingURL=livePreviewThemeRuntime.js.map

package/dist/utils/livePreviewThemeRuntime.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/utils/livePreviewThemeRuntime.ts"],"sourcesContent":["import { getBorderRadiusConfig } from '../providers/Theme/themeConfig.js'\nimport { resolveThemeConfiguration } from './resolveThemeConfiguration.js'\nimport { generateThemeColorsCss } from './themeColors.js'\nimport { generateThemeCSS } from './themeUtils.js'\n\nexport const extractThemeConfigurationFromLiveData = (\n  liveData: Record<string, unknown>,\n  themeConfigurationKey = 'themeConfiguration',\n): unknown => {\n  const candidate = liveData?.[themeConfigurationKey]\n  if (candidate && typeof candidate === 'object') {\n    return candidate\n  }\n\n  return liveData\n}\n\nconst resolveColorMode = (mode: string): 'light' | 'dark' => {\n  if (mode === 'dark') {\n    return 'dark'\n  }\n\n  if (\n    mode === 'auto' &&\n    globalThis.window !== undefined &&\n    typeof globalThis.window.matchMedia === 'function'\n  ) {\n    return globalThis.window.matchMedia('(prefers-color-scheme: dark)').matches ? 'dark' : 'light'\n  }\n\n  return 'light'\n}\n\nexport const buildLivePreviewThemeRuntime = (themeConfiguration: unknown) => {\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  const resolved = resolveThemeConfiguration(themeConfiguration as any)\n\n  const borderRadiusMap: Record<string, 'none' | 'small' | 'medium' | 'large' | 'xl'> = {\n    none: 'none',\n    small: 'small',\n    medium: 'medium',\n    large: 'large',\n    xl: 'xl',\n    full: 'xl',\n  }\n\n  const mappedBorderRadius = borderRadiusMap[resolved.borderRadius ?? 'medium'] ?? 'medium'\n  const borderRadiusConfig = getBorderRadiusConfig(mappedBorderRadius)\n  const cssRecord =\n    typeof borderRadiusConfig?.css === 'string'\n      ? { '--radius-default': borderRadiusConfig.css }\n      : (borderRadiusConfig?.css ?? {})\n\n  const borderRadiusCSS = Object.entries(cssRecord)\n    .map(([property, value]) => `  ${property}: ${value};`)\n    .join('\\n')\n\n  const borderRadiusBlock = borderRadiusCSS ? `:root {\\n${borderRadiusCSS}\\n}` : ''\n\n  const themeConfigurationCSS = generateThemeCSS(resolved)\n  const colorModesCSS = generateThemeColorsCss({\n    themeName: resolved.theme,\n    lightMode: resolved.lightMode,\n    darkMode: resolved.darkMode,\n  })\n\n  const customCSSBlock = typeof resolved.customCSS === 'string' ? resolved.customCSS.trim() : ''\n\n  return {\n    theme: resolved.theme,\n    mode: resolveColorMode(resolved.colorMode),\n    css: [borderRadiusBlock, themeConfigurationCSS, colorModesCSS, customCSSBlock]\n      .filter((block) => Boolean(block?.trim?.().length))\n      .join('\\n\\n'),\n  }\n}\n"],"names":["getBorderRadiusConfig","resolveThemeConfiguration","generateThemeColorsCss","generateThemeCSS","extractThemeConfigurationFromLiveData","liveData","themeConfigurationKey","candidate","resolveColorMode","mode","globalThis","window","undefined","matchMedia","matches","buildLivePreviewThemeRuntime","themeConfiguration","resolved","borderRadiusMap","none","small","medium","large","xl","full","mappedBorderRadius","borderRadius","borderRadiusConfig","cssRecord","css","borderRadiusCSS","Object","entries","map","property","value","join","borderRadiusBlock","themeConfigurationCSS","colorModesCSS","themeName","theme","lightMode","darkMode","customCSSBlock","customCSS","trim","colorMode","filter","block","Boolean","length"],"mappings":"AAAA,SAASA,qBAAqB,QAAQ,oCAAmC;AACzE,SAASC,yBAAyB,QAAQ,iCAAgC;AAC1E,SAASC,sBAAsB,QAAQ,mBAAkB;AACzD,SAASC,gBAAgB,QAAQ,kBAAiB;AAElD,OAAO,MAAMC,wCAAwC,CACnDC,UACAC,wBAAwB,oBAAoB;IAE5C,MAAMC,YAAYF,UAAU,CAACC,sBAAsB;IACnD,IAAIC,aAAa,OAAOA,cAAc,UAAU;QAC9C,OAAOA;IACT;IAEA,OAAOF;AACT,EAAC;AAED,MAAMG,mBAAmB,CAACC;IACxB,IAAIA,SAAS,QAAQ;QACnB,OAAO;IACT;IAEA,IACEA,SAAS,UACTC,WAAWC,MAAM,KAAKC,aACtB,OAAOF,WAAWC,MAAM,CAACE,UAAU,KAAK,YACxC;QACA,OAAOH,WAAWC,MAAM,CAACE,UAAU,CAAC,gCAAgCC,OAAO,GAAG,SAAS;IACzF;IAEA,OAAO;AACT;AAEA,OAAO,MAAMC,+BAA+B,CAACC;IAC3C,8DAA8D;IAC9D,MAAMC,WAAWhB,0BAA0Be;IAE3C,MAAME,kBAAgF;QACpFC,MAAM;QACNC,OAAO;QACPC,QAAQ;QACRC,OAAO;QACPC,IAAI;QACJC,MAAM;IACR;IAEA,MAAMC,qBAAqBP,eAAe,CAACD,SAASS,YAAY,IAAI,SAAS,IAAI;IACjF,MAAMC,qBAAqB3B,sBAAsByB;IACjD,MAAMG,YACJ,OAAOD,oBAAoBE,QAAQ,WAC/B;QAAE,oBAAoBF,mBAAmBE,GAAG;IAAC,IAC5CF,oBAAoBE,OAAO,CAAC;IAEnC,MAAMC,kBAAkBC,OAAOC,OAAO,CAACJ,WACpCK,GAAG,CAAC,CAAC,CAACC,UAAUC,MAAM,GAAK,CAAC,EAAE,EAAED,SAAS,EAAE,EAAEC,MAAM,CAAC,CAAC,EACrDC,IAAI,CAAC;IAER,MAAMC,oBAAoBP,kBAAkB,CAAC,SAAS,EAAEA,gBAAgB,GAAG,CAAC,GAAG;IAE/E,MAAMQ,wBAAwBnC,iBAAiBc;IAC/C,MAAMsB,gBAAgBrC,uBAAuB;QAC3CsC,WAAWvB,SAASwB,KAAK;QACzBC,WAAWzB,SAASyB,SAAS;QAC7BC,UAAU1B,SAAS0B,QAAQ;IAC7B;IAEA,MAAMC,iBAAiB,OAAO3B,SAAS4B,SAAS,KAAK,WAAW5B,SAAS4B,SAAS,CAACC,IAAI,KAAK;IAE5F,OAAO;QACLL,OAAOxB,SAASwB,KAAK;QACrBhC,MAAMD,iBAAiBS,SAAS8B,SAAS;QACzClB,KAAK;YAACQ;YAAmBC;YAAuBC;YAAeK;SAAe,CAC3EI,MAAM,CAAC,CAACC,QAAUC,QAAQD,OAAOH,SAASK,SAC1Cf,IAAI,CAAC;IACV;AACF,EAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@kilivi/payloadcms-theme-management",
-  "version": "1.1.0",
+  "version": "1.1.2",
   "description": "Theme configuration plugin for Payload CMS v3 with 60+ professional themes and standalone collection support",
   "type": "module",
   "main": "./dist/index.js",