@kilivi/payloadcms-theme-management 1.1.1 → 2.0.0

package/dist/fields/themeConfigurationField.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/fields/themeConfigurationField.ts"],"sourcesContent":["import type { Field, TabsField } from 'payload'\nimport {\n  BASE_FONT_SIZE_OPTIONS,\n  BODY_FONT_OPTIONS,\n  HEADING_FONT_OPTIONS,\n  LINE_HEIGHT_OPTIONS,\n} from '../constants/themeFonts.js'\nimport type { ThemePreset } from '../index.js'\nimport { darkModeField, lightModeField } from './colorModeFields.js'\n\ninterface ThemeConfigurationFieldOptions {\n  themePresets: ThemePreset[]\n  defaultTheme: string\n  includeColorModeToggle: boolean\n  includeCustomCSS: boolean\n  includeBrandIdentity: boolean\n  enableAdvancedFeatures?: boolean\n}\n\n// Type for admin.custom property to avoid ts-expect-error\ninterface ThemeAdminCustom {\n  themePresets?: ThemePreset[]\n}\n\n// Type for a single tab (not the full TabsField)\nexport type ThemeTab = NonNullable<TabsField['tabs']>[number]\n\n/**\n * Theme Configuration Field with Theme Selection as default value setter\n * Theme Selection populates lightMode/darkMode colors automatically\n */\nexport function createThemeConfigurationField(options: ThemeConfigurationFieldOptions): ThemeTab {\n  const {\n    themePresets,\n    defaultTheme,\n    includeColorModeToggle,\n    includeCustomCSS,\n    enableAdvancedFeatures = true,\n  } = options\n\n  const fields: Field[] = [\n    {\n      name: 'theme',\n      type: 'text',\n      required: true,\n      defaultValue: defaultTheme,\n      label: {\n        en: '🎨 Theme Selection',\n        cs: '🎨 Výběr tématu',\n      },\n      validate: (value: unknown) => {\n        if (typeof value === 'string' && value.trim().length > 0) {\n          return true\n        }\n        return 'Select a theme'\n      },\n      admin: {\n        description: {\n          en: 'Select a theme to auto-populate color values. You can customize colors after selection.',\n          cs: 'Vyberte téma pro automatické předvyplnění barev. Po výběru můžete barvy upravit.',\n        },\n        components: {\n          Field: '@kilivi/payloadcms-theme-management/fields/ThemePreviewField',\n        },\n        custom: {\n          themePresets,\n        } as ThemeAdminCustom,\n      },\n    },\n  ]\n\n  // Border Radius Configuration - Always visible\n  fields.push({\n    type: 'row',\n    fields: [\n      {\n        name: 'borderRadius',\n        type: 'select',\n        label: {\n          en: '📐 Border Radius',\n          cs: '📐 Zaoblení rohů',\n        },\n        defaultValue: 'medium',\n        options: [\n          { label: { en: 'None (0px)', cs: 'Žádné (0px)' }, value: 'none' },\n          { label: { en: 'Small (0.25rem)', cs: 'Malé (0.25rem)' }, value: 'small' },\n          { label: { en: 'Medium (0.5rem)', cs: 'Střední (0.5rem)' }, value: 'medium' },\n          { label: { en: 'Large (0.75rem)', cs: 'Velké (0.75rem)' }, value: 'large' },\n          { label: { en: 'XL (1rem)', cs: 'XL (1rem)' }, value: 'xl' },\n        ],\n        admin: {\n          description: {\n            en: 'Default corner rounding for UI elements',\n            cs: 'Výchozí zaoblení rohů pro UI prvky',\n          },\n          width: '50%',\n        },\n        dbName: 'border_radius',\n      },\n      {\n        name: 'spacing',\n        type: 'select',\n        label: {\n          en: '📏 Spacing Scale',\n          cs: '📏 Škála rozestupů',\n        },\n        defaultValue: 'medium',\n        options: [\n          { label: { en: 'Compact', cs: 'Kompaktní' }, value: 'compact' },\n          { label: { en: 'Medium', cs: 'Střední' }, value: 'medium' },\n          { label: { en: 'Comfortable', cs: 'Pohodlné' }, value: 'comfortable' },\n        ],\n        admin: {\n          description: {\n            en: 'Global spacing between elements',\n            cs: 'Globální rozestupy mezi prvky',\n          },\n          width: '50%',\n        },\n        dbName: 'spacing',\n      },\n    ],\n  })\n\n  // Color Mode Settings\n  if (includeColorModeToggle) {\n    fields.push({\n      type: 'collapsible',\n      label: {\n        en: '🌗 Color Mode Settings',\n        cs: '🌗 Nastavení barevného režimu',\n      },\n      admin: {\n        initCollapsed: false,\n        description: {\n          en: 'Configure light and dark mode colors. Changes here override theme selection.',\n          cs: 'Nakonfigurujte barvy světlého a tmavého režimu. Změny zde přepíší výběr tématu.',\n        },\n      },\n      fields: [\n        {\n          type: 'row',\n          fields: [\n            {\n              name: 'colorMode',\n              type: 'select',\n              label: {\n                en: 'Default Color Mode',\n                cs: 'Výchozí barevný režim',\n              },\n              defaultValue: 'auto',\n              options: [\n                {\n                  label: {\n                    en: 'Auto (System)',\n                    cs: 'Automaticky (Systém)',\n                  },\n                  value: 'auto',\n                },\n                {\n                  label: { en: 'Light', cs: 'Světlý' },\n                  value: 'light',\n                },\n                {\n                  label: { en: 'Dark', cs: 'Tmavý' },\n                  value: 'dark',\n                },\n              ],\n              admin: {\n                description: {\n                  en: 'Default color mode for visitors',\n                  cs: 'Výchozí barevný režim pro návštěvníky',\n                },\n                width: '50%',\n              },\n              dbName: 'color_mode',\n            },\n            {\n              name: 'allowColorModeToggle',\n              type: 'checkbox',\n              label: {\n                en: 'Enable Mode Toggle',\n                cs: 'Povolit přepínač režimu',\n              },\n              defaultValue: true,\n              admin: {\n                description: {\n                  en: 'Let visitors switch modes',\n                  cs: 'Umožnit návštěvníkům přepínat režimy',\n                },\n                width: '50%',\n              },\n            },\n          ],\n        },\n        lightModeField,\n        darkModeField,\n      ],\n    })\n  }\n\n  // Typography - Always visible\n  fields.push({\n    type: 'collapsible',\n    label: {\n      en: '🅰️ Typography',\n      cs: '🅰️ Typografie',\n    },\n    admin: {\n      initCollapsed: true,\n      description: {\n        en: 'Choose font families and base typography settings. Leave fields on \"Use preset\" to inherit the theme defaults.',\n        cs: 'Zvolte rodiny písem a základní typografické nastavení. Hodnota \"Použít výchozí\" zachová nastavení motivu.',\n      },\n    },\n    fields: [\n      {\n        name: 'typography',\n        type: 'group',\n        fields: [\n          {\n            type: 'row',\n            fields: [\n              {\n                name: 'bodyFont',\n                type: 'select',\n                label: {\n                  en: 'Body font',\n                  cs: 'Písmo pro text',\n                },\n                defaultValue: 'preset',\n                options: [...BODY_FONT_OPTIONS],\n                admin: {\n                  width: '50%',\n                  components: {\n                    Field: '@kilivi/payloadcms-theme-management/fields/FontSelectField',\n                  },\n                },\n                dbName: 'body_font',\n              },\n              {\n                name: 'headingFont',\n                type: 'select',\n                label: {\n                  en: 'Heading font',\n                  cs: 'Písmo pro nadpisy',\n                },\n                defaultValue: 'preset',\n                options: [...HEADING_FONT_OPTIONS],\n                admin: {\n                  width: '50%',\n                  components: {\n                    Field: '@kilivi/payloadcms-theme-management/fields/FontSelectField',\n                  },\n                },\n                dbName: 'heading_font',\n              },\n            ],\n          },\n          {\n            type: 'row',\n            fields: [\n              {\n                name: 'bodyFontCustom',\n                type: 'text',\n                label: {\n                  en: 'Custom body font stack',\n                  cs: 'Vlastní písmo pro text',\n                },\n                admin: {\n                  width: '50%',\n                  placeholder: '\"IBM Plex Sans\", sans-serif',\n                  description: {\n                    en: 'Provide full CSS font-family stack when using a custom font.',\n                    cs: 'Při volbě vlastního písma zadejte celý CSS zápis font-family.',\n                  },\n                  condition: (_, siblingData) => siblingData?.bodyFont === 'custom',\n                },\n              },\n              {\n                name: 'headingFontCustom',\n                type: 'text',\n                label: {\n                  en: 'Custom heading font stack',\n                  cs: 'Vlastní písmo pro nadpisy',\n                },\n                admin: {\n                  width: '50%',\n                  placeholder: '\"Cormorant Garamond\", serif',\n                  description: {\n                    en: 'Provide full CSS font-family stack when using a custom heading font.',\n                    cs: 'Při volbě vlastního nadpisového písma zadejte celý CSS zápis font-family.',\n                  },\n                  condition: (_, siblingData) => siblingData?.headingFont === 'custom',\n                },\n              },\n            ],\n          },\n          {\n            type: 'row',\n            fields: [\n              {\n                name: 'baseFontSize',\n                type: 'select',\n                label: {\n                  en: 'Base font size',\n                  cs: 'Základní velikost písma',\n                },\n                defaultValue: 'preset',\n                options: BASE_FONT_SIZE_OPTIONS.map((option) => ({\n                  label: option.label,\n                  value: option.value,\n                })),\n                admin: {\n                  width: '50%',\n                },\n                dbName: 'base_font_size',\n              },\n              {\n                name: 'lineHeight',\n                type: 'select',\n                label: {\n                  en: 'Line height',\n                  cs: 'Řádkování',\n                },\n                defaultValue: 'preset',\n                options: LINE_HEIGHT_OPTIONS.map((option) => ({\n                  label: option.label,\n                  value: option.value,\n                })),\n                admin: {\n                  width: '50%',\n                },\n                dbName: 'line_height',\n              },\n            ],\n          },\n        ],\n      },\n    ],\n  })\n\n  const customPresetsField: Field = {\n    type: 'collapsible',\n    label: {\n      en: '🧩 Custom Theme Presets',\n      cs: '🧩 Vlastní motivy',\n    },\n    admin: {\n      initCollapsed: true,\n      description: {\n        en: 'Import additional theme presets via JSON to extend or override the defaults. These presets become available instantly in the Theme Selection above.',\n        cs: 'Importujte další motivy pomocí JSONu a rozšiřte nebo přepište výchozí nabídku. Motivy budou ihned k dispozici ve výběru výše.',\n      },\n    },\n    fields: [\n      {\n        name: 'customThemePresets',\n        type: 'json',\n        label: {\n          en: 'Custom Preset JSON',\n          cs: 'JSON s vlastními motivy',\n        },\n        admin: {\n          description: {\n            en: 'Paste or import an array (or object map) of theme presets. Each entry should include at least a unique \"name\" and \"label\" with optional lightMode/darkMode colors.',\n            cs: 'Vložte nebo importujte pole (či objekt) motivů. Každý motiv musí mít unikátní „name“ a „label“ a volitelně barvy pro světly/tmavý režim.',\n          },\n          components: {\n            Field: '@kilivi/payloadcms-theme-management/fields/ThemePresetImportField',\n          },\n        },\n      },\n    ],\n  }\n\n  fields.push(customPresetsField)\n\n  // Advanced Settings (when using extended theme configuration)\n  if (enableAdvancedFeatures) {\n    const advancedFields: Field[] = [\n      {\n        name: 'animationLevel',\n        type: 'select',\n        label: {\n          en: 'Animation Level',\n          cs: 'Úroveň animací',\n        },\n        defaultValue: 'medium',\n        options: [\n          { label: { en: 'None', cs: 'Žádné' }, value: 'none' },\n          { label: { en: 'Reduced', cs: 'Snížené' }, value: 'reduced' },\n          { label: { en: 'Medium', cs: 'Střední' }, value: 'medium' },\n          { label: { en: 'High', cs: 'Vysoké' }, value: 'high' },\n        ],\n        admin: {\n          description: {\n            en: 'Control website animations and transitions',\n            cs: 'Kontrola animací a přechodů na webu',\n          },\n          width: '50%',\n        },\n        dbName: 'animation_level',\n      },\n    ]\n\n    if (includeCustomCSS) {\n      advancedFields.push({\n        name: 'customCSS',\n        type: 'code',\n        label: {\n          en: 'Custom CSS',\n          cs: 'Vlastní CSS',\n        },\n        admin: {\n          language: 'css',\n          description: {\n            en: 'Add custom CSS to override default styles',\n            cs: 'Přidejte vlastní CSS pro přepsání výchozích stylů',\n          },\n          // placeholder:\n          //   ':root {\\n  --primary: #your-color;\\n  --border-radius: 8px;\\n  --font-family: \"Your Font\";\\n}\\n\\n.custom-class {\\n  /* Your custom styles */\\n}',\n          // rows: 8,\n        },\n      })\n    }\n\n    fields.push({\n      type: 'collapsible',\n      label: {\n        en: '⚙️ Advanced Settings',\n        cs: '⚙️ Pokročilé nastavení',\n      },\n      admin: {\n        initCollapsed: true,\n      },\n      fields: advancedFields,\n    })\n  }\n\n  // Return as tab configuration to be injected into tabs structure\n  return {\n    label: {\n      en: '🎨 Appearance Settings',\n      cs: '🎨 Nastavení vzhledu',\n    },\n    fields: [\n      {\n        name: 'themeConfiguration',\n        type: 'group',\n        admin: {\n          description: {\n            en: 'Configure website appearance and styling',\n            cs: 'Nakonfigurujte vzhled a stylování webu',\n          },\n        },\n        fields,\n      },\n    ],\n  }\n}\n"],"names":["BASE_FONT_SIZE_OPTIONS","BODY_FONT_OPTIONS","HEADING_FONT_OPTIONS","LINE_HEIGHT_OPTIONS","darkModeField","lightModeField","createThemeConfigurationField","options","themePresets","defaultTheme","includeColorModeToggle","includeCustomCSS","enableAdvancedFeatures","fields","name","type","required","defaultValue","label","en","cs","validate","value","trim","length","admin","description","components","Field","custom","push","width","dbName","initCollapsed","placeholder","condition","_","siblingData","bodyFont","headingFont","map","option","customPresetsField","advancedFields","language"],"mappings":"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"}
+{"version":3,"sources":["../../src/fields/themeConfigurationField.ts"],"sourcesContent":["import type { Field, TabsField } from 'payload'\nimport {\n  BASE_FONT_SIZE_OPTIONS,\n  BODY_FONT_OPTIONS,\n  HEADING_FONT_OPTIONS,\n  LINE_HEIGHT_OPTIONS,\n} from '../constants/themeFonts.js'\nimport type { ThemePreset } from '../index.js'\nimport { darkModeField, lightModeField } from './colorModeFields.js'\n\ninterface ThemeConfigurationFieldOptions {\n  themePresets: ThemePreset[]\n  defaultTheme: string\n  includeColorModeToggle: boolean\n  includeCustomCSS: boolean\n  includeBrandIdentity: boolean\n  enableAdvancedFeatures?: boolean\n  useThemePreviewField?: boolean\n}\n\n// Type for admin.custom property to avoid ts-expect-error\ninterface ThemeAdminCustom {\n  themePresets?: ThemePreset[]\n  useThemePreviewField?: boolean\n}\n\n// Type for a single tab (not the full TabsField)\nexport type ThemeTab = NonNullable<TabsField['tabs']>[number]\n\n/**\n * Theme Configuration Field with Theme Selection as default value setter\n * Theme Selection populates lightMode/darkMode colors automatically\n */\nexport function createThemeConfigurationField(options: ThemeConfigurationFieldOptions): ThemeTab {\n  const {\n    themePresets,\n    defaultTheme,\n    includeColorModeToggle,\n    includeCustomCSS,\n    enableAdvancedFeatures = true,\n    useThemePreviewField = true,\n  } = options\n\n  const fields: Field[] = [\n    {\n      name: 'theme',\n      type: 'text',\n      required: true,\n      defaultValue: defaultTheme,\n      label: {\n        en: '🎨 Theme Selection',\n        cs: '🎨 Výběr tématu',\n      },\n      validate: (value: unknown) => {\n        if (typeof value === 'string' && value.trim().length > 0) {\n          return true\n        }\n        return 'Select a theme'\n      },\n      admin: {\n        description: {\n          en: 'Select a theme to auto-populate color values. You can customize colors after selection.',\n          cs: 'Vyberte téma pro automatické předvyplnění barev. Po výběru můžete barvy upravit.',\n        },\n        components: {\n          Field: '@kilivi/payloadcms-theme-management/fields/ThemePreviewField',\n        },\n        custom: {\n          themePresets,\n          useThemePreviewField,\n        } as ThemeAdminCustom,\n      },\n    },\n  ]\n\n  // Border Radius Configuration - Always visible\n  fields.push({\n    type: 'row',\n    fields: [\n      {\n        name: 'borderRadius',\n        type: 'select',\n        label: {\n          en: '📐 Border Radius',\n          cs: '📐 Zaoblení rohů',\n        },\n        defaultValue: 'medium',\n        options: [\n          { label: { en: 'None (0px)', cs: 'Žádné (0px)' }, value: 'none' },\n          { label: { en: 'Small (0.25rem)', cs: 'Malé (0.25rem)' }, value: 'small' },\n          { label: { en: 'Medium (0.5rem)', cs: 'Střední (0.5rem)' }, value: 'medium' },\n          { label: { en: 'Large (0.75rem)', cs: 'Velké (0.75rem)' }, value: 'large' },\n          { label: { en: 'XL (1rem)', cs: 'XL (1rem)' }, value: 'xl' },\n        ],\n        admin: {\n          description: {\n            en: 'Default corner rounding for UI elements',\n            cs: 'Výchozí zaoblení rohů pro UI prvky',\n          },\n          width: '50%',\n        },\n        dbName: 'border_radius',\n      },\n      {\n        name: 'spacing',\n        type: 'select',\n        label: {\n          en: '📏 Spacing Scale',\n          cs: '📏 Škála rozestupů',\n        },\n        defaultValue: 'medium',\n        options: [\n          { label: { en: 'Compact', cs: 'Kompaktní' }, value: 'compact' },\n          { label: { en: 'Medium', cs: 'Střední' }, value: 'medium' },\n          { label: { en: 'Comfortable', cs: 'Pohodlné' }, value: 'comfortable' },\n        ],\n        admin: {\n          description: {\n            en: 'Global spacing between elements',\n            cs: 'Globální rozestupy mezi prvky',\n          },\n          width: '50%',\n        },\n        dbName: 'spacing',\n      },\n    ],\n  })\n\n  // Color Mode Settings\n  if (includeColorModeToggle) {\n    fields.push({\n      type: 'collapsible',\n      label: {\n        en: '🌗 Color Mode Settings',\n        cs: '🌗 Nastavení barevného režimu',\n      },\n      admin: {\n        initCollapsed: false,\n        description: {\n          en: 'Configure light and dark mode colors. Changes here override theme selection.',\n          cs: 'Nakonfigurujte barvy světlého a tmavého režimu. Změny zde přepíší výběr tématu.',\n        },\n      },\n      fields: [\n        {\n          type: 'row',\n          fields: [\n            {\n              name: 'colorMode',\n              type: 'select',\n              label: {\n                en: 'Default Color Mode',\n                cs: 'Výchozí barevný režim',\n              },\n              defaultValue: 'auto',\n              options: [\n                {\n                  label: {\n                    en: 'Auto (System)',\n                    cs: 'Automaticky (Systém)',\n                  },\n                  value: 'auto',\n                },\n                {\n                  label: { en: 'Light', cs: 'Světlý' },\n                  value: 'light',\n                },\n                {\n                  label: { en: 'Dark', cs: 'Tmavý' },\n                  value: 'dark',\n                },\n              ],\n              admin: {\n                description: {\n                  en: 'Default color mode for visitors',\n                  cs: 'Výchozí barevný režim pro návštěvníky',\n                },\n                width: '50%',\n              },\n              dbName: 'color_mode',\n            },\n            {\n              name: 'allowColorModeToggle',\n              type: 'checkbox',\n              label: {\n                en: 'Enable Mode Toggle',\n                cs: 'Povolit přepínač režimu',\n              },\n              defaultValue: true,\n              admin: {\n                description: {\n                  en: 'Let visitors switch modes',\n                  cs: 'Umožnit návštěvníkům přepínat režimy',\n                },\n                width: '50%',\n              },\n            },\n          ],\n        },\n        lightModeField,\n        darkModeField,\n      ],\n    })\n  }\n\n  // Typography - Always visible\n  fields.push({\n    type: 'collapsible',\n    label: {\n      en: '🅰️ Typography',\n      cs: '🅰️ Typografie',\n    },\n    admin: {\n      initCollapsed: true,\n      description: {\n        en: 'Choose font families and base typography settings. Leave fields on \"Use preset\" to inherit the theme defaults.',\n        cs: 'Zvolte rodiny písem a základní typografické nastavení. Hodnota \"Použít výchozí\" zachová nastavení motivu.',\n      },\n    },\n    fields: [\n      {\n        name: 'typography',\n        type: 'group',\n        fields: [\n          {\n            type: 'row',\n            fields: [\n              {\n                name: 'bodyFont',\n                type: 'select',\n                label: {\n                  en: 'Body font',\n                  cs: 'Písmo pro text',\n                },\n                defaultValue: 'preset',\n                options: [...BODY_FONT_OPTIONS],\n                admin: {\n                  width: '50%',\n                  components: {\n                    Field: '@kilivi/payloadcms-theme-management/fields/FontSelectField',\n                  },\n                },\n                dbName: 'body_font',\n              },\n              {\n                name: 'headingFont',\n                type: 'select',\n                label: {\n                  en: 'Heading font',\n                  cs: 'Písmo pro nadpisy',\n                },\n                defaultValue: 'preset',\n                options: [...HEADING_FONT_OPTIONS],\n                admin: {\n                  width: '50%',\n                  components: {\n                    Field: '@kilivi/payloadcms-theme-management/fields/FontSelectField',\n                  },\n                },\n                dbName: 'heading_font',\n              },\n            ],\n          },\n          {\n            type: 'row',\n            fields: [\n              {\n                name: 'bodyFontCustom',\n                type: 'text',\n                label: {\n                  en: 'Custom body font stack',\n                  cs: 'Vlastní písmo pro text',\n                },\n                admin: {\n                  width: '50%',\n                  placeholder: '\"IBM Plex Sans\", sans-serif',\n                  description: {\n                    en: 'Provide full CSS font-family stack when using a custom font.',\n                    cs: 'Při volbě vlastního písma zadejte celý CSS zápis font-family.',\n                  },\n                  condition: (_, siblingData) => siblingData?.bodyFont === 'custom',\n                },\n              },\n              {\n                name: 'headingFontCustom',\n                type: 'text',\n                label: {\n                  en: 'Custom heading font stack',\n                  cs: 'Vlastní písmo pro nadpisy',\n                },\n                admin: {\n                  width: '50%',\n                  placeholder: '\"Cormorant Garamond\", serif',\n                  description: {\n                    en: 'Provide full CSS font-family stack when using a custom heading font.',\n                    cs: 'Při volbě vlastního nadpisového písma zadejte celý CSS zápis font-family.',\n                  },\n                  condition: (_, siblingData) => siblingData?.headingFont === 'custom',\n                },\n              },\n            ],\n          },\n          {\n            type: 'row',\n            fields: [\n              {\n                name: 'baseFontSize',\n                type: 'select',\n                label: {\n                  en: 'Base font size',\n                  cs: 'Základní velikost písma',\n                },\n                defaultValue: 'preset',\n                options: BASE_FONT_SIZE_OPTIONS.map((option) => ({\n                  label: option.label,\n                  value: option.value,\n                })),\n                admin: {\n                  width: '50%',\n                },\n                dbName: 'base_font_size',\n              },\n              {\n                name: 'lineHeight',\n                type: 'select',\n                label: {\n                  en: 'Line height',\n                  cs: 'Řádkování',\n                },\n                defaultValue: 'preset',\n                options: LINE_HEIGHT_OPTIONS.map((option) => ({\n                  label: option.label,\n                  value: option.value,\n                })),\n                admin: {\n                  width: '50%',\n                },\n                dbName: 'line_height',\n              },\n            ],\n          },\n        ],\n      },\n    ],\n  })\n\n  const customPresetsField: Field = {\n    type: 'collapsible',\n    label: {\n      en: '🧩 Custom Theme Presets',\n      cs: '🧩 Vlastní motivy',\n    },\n    admin: {\n      initCollapsed: true,\n      description: {\n        en: 'Import additional theme presets via JSON to extend or override the defaults. These presets become available instantly in the Theme Selection above.',\n        cs: 'Importujte další motivy pomocí JSONu a rozšiřte nebo přepište výchozí nabídku. Motivy budou ihned k dispozici ve výběru výše.',\n      },\n    },\n    fields: [\n      {\n        name: 'customThemePresets',\n        type: 'json',\n        label: {\n          en: 'Custom Preset JSON',\n          cs: 'JSON s vlastními motivy',\n        },\n        admin: {\n          description: {\n            en: 'Paste or import an array (or object map) of theme presets. Each entry should include at least a unique \"name\" and \"label\" with optional lightMode/darkMode colors.',\n            cs: 'Vložte nebo importujte pole (či objekt) motivů. Každý motiv musí mít unikátní „name“ a „label“ a volitelně barvy pro světly/tmavý režim.',\n          },\n          components: {\n            Field: '@kilivi/payloadcms-theme-management/fields/ThemePresetImportField',\n          },\n        },\n      },\n    ],\n  }\n\n  fields.push(customPresetsField)\n\n  // Advanced Settings (when using extended theme configuration)\n  if (enableAdvancedFeatures) {\n    const advancedFields: Field[] = [\n      {\n        name: 'animationLevel',\n        type: 'select',\n        label: {\n          en: 'Animation Level',\n          cs: 'Úroveň animací',\n        },\n        defaultValue: 'medium',\n        options: [\n          { label: { en: 'None', cs: 'Žádné' }, value: 'none' },\n          { label: { en: 'Reduced', cs: 'Snížené' }, value: 'reduced' },\n          { label: { en: 'Medium', cs: 'Střední' }, value: 'medium' },\n          { label: { en: 'High', cs: 'Vysoké' }, value: 'high' },\n        ],\n        admin: {\n          description: {\n            en: 'Control website animations and transitions',\n            cs: 'Kontrola animací a přechodů na webu',\n          },\n          width: '50%',\n        },\n        dbName: 'animation_level',\n      },\n    ]\n\n    if (includeCustomCSS) {\n      advancedFields.push({\n        name: 'customCSS',\n        type: 'code',\n        label: {\n          en: 'Custom CSS',\n          cs: 'Vlastní CSS',\n        },\n        admin: {\n          language: 'css',\n          description: {\n            en: 'Add custom CSS to override default styles',\n            cs: 'Přidejte vlastní CSS pro přepsání výchozích stylů',\n          },\n          // placeholder:\n          //   ':root {\\n  --primary: #your-color;\\n  --border-radius: 8px;\\n  --font-family: \"Your Font\";\\n}\\n\\n.custom-class {\\n  /* Your custom styles */\\n}',\n          // rows: 8,\n        },\n      })\n    }\n\n    fields.push({\n      type: 'collapsible',\n      label: {\n        en: '⚙️ Advanced Settings',\n        cs: '⚙️ Pokročilé nastavení',\n      },\n      admin: {\n        initCollapsed: true,\n      },\n      fields: advancedFields,\n    })\n  }\n\n  // Return as tab configuration to be injected into tabs structure\n  return {\n    label: {\n      en: '🎨 Appearance Settings',\n      cs: '🎨 Nastavení vzhledu',\n    },\n    fields: [\n      {\n        name: 'themeConfiguration',\n        type: 'group',\n        admin: {\n          description: {\n            en: 'Configure website appearance and styling',\n            cs: 'Nakonfigurujte vzhled a stylování webu',\n          },\n        },\n        fields,\n      },\n    ],\n  }\n}\n"],"names":["BASE_FONT_SIZE_OPTIONS","BODY_FONT_OPTIONS","HEADING_FONT_OPTIONS","LINE_HEIGHT_OPTIONS","darkModeField","lightModeField","createThemeConfigurationField","options","themePresets","defaultTheme","includeColorModeToggle","includeCustomCSS","enableAdvancedFeatures","useThemePreviewField","fields","name","type","required","defaultValue","label","en","cs","validate","value","trim","length","admin","description","components","Field","custom","push","width","dbName","initCollapsed","placeholder","condition","_","siblingData","bodyFont","headingFont","map","option","customPresetsField","advancedFields","language"],"mappings":"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"}

package/dist/index.d.ts

@@ -13,7 +13,7 @@ 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, FetchThemeConfigurationOptions } from './types.js';
+export type { ThemeManagementPluginOptions, ThemeManagementCacheRevalidationOptions, FetchThemeConfigurationOptions, ThemeManagementLivePreviewOptions, ThemeManagementLivePreviewUrlArgs, } from './types.js';
 export { DEFAULT_THEME_CONFIGURATION, resolveThemeConfiguration, } from './utils/resolveThemeConfiguration.js';
 export type { ResolvedThemeConfiguration } from './utils/resolveThemeConfiguration.js';
 export { generateThemeColorsCss, hexToHsl } from './utils/themeColors.js';

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,EAAE,8BAA8B,EAAE,4BAA4B,EAAE,MAAM,YAAY,CAAA;AAqG9F,eAAO,MAAM,qBAAqB,GAAI,UAAS,4BAAiC,KAAG,MAsMlF,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,EAAE,4BAA4B,EAAE,8BAA8B,EAAE,MAAM,YAAY,CAAA;AAC9F,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,aArVa,4BAA4B,KAAQ,MAqVzB,CAAA;AAC1D,oDAAoD;AACpD,eAAO,MAAM,wBAAwB,aAvVU,4BAA4B,KAAQ,MAuVtB,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":"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"}

package/dist/index.js

@@ -79,10 +79,380 @@ const THEME_FIELD_NAME = 'themeConfiguration';
     return sanitizedFields.map((field)=>field.type === 'tabs' ? updatedTabsField : field);
 };
 const ensureCollectionsArray = (collections)=>Array.isArray(collections) ? collections : [];
+const ensureEndpointsArray = (endpoints)=>Array.isArray(endpoints) ? endpoints : [];
+const normalizeLivePreviewOptions = (livePreview)=>{
+    if (livePreview === false) {
+        return {
+            enabled: false,
+            injectRoute: false,
+            routePath: '/theme/preview',
+            pageCollection: 'pages',
+            pageSlug: 'home',
+            fallbackToFirstPage: true,
+            tenantField: 'tenant',
+            tenantQueryParam: 'tenant',
+            breakpoints: undefined
+        };
+    }
+    const raw = typeof livePreview === 'object' && livePreview ? 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,
+        url: raw.url
+    };
+};
+const dedupeStrings = (values)=>[
+        ...new Set(values.filter((value)=>typeof value === 'string' && value.trim().length > 0))
+    ];
+const normalizeRoutePath = (path)=>{
+    if (!path || !path.trim()) {
+        return '/theme/revalidate';
+    }
+    return path.startsWith('/') ? path : `/${path}`;
+};
+const normalizeCacheRevalidationOptions = (args)=>{
+    const { cacheRevalidation, standaloneCollectionSlug, useStandaloneCollection } = args;
+    if (cacheRevalidation === false) {
+        return {
+            enabled: false,
+            injectRoute: false,
+            routePath: '/theme/revalidate',
+            tags: [],
+            paths: []
+        };
+    }
+    const raw = typeof cacheRevalidation === 'object' && cacheRevalidation ? cacheRevalidation : {};
+    const defaultTag = `global_${standaloneCollectionSlug}`;
+    return {
+        enabled: raw.enabled ?? useStandaloneCollection,
+        injectRoute: raw.injectRoute ?? true,
+        routePath: normalizeRoutePath(raw.routePath),
+        secret: raw.secret,
+        tags: dedupeStrings([
+            defaultTag,
+            ...raw.tags ?? []
+        ]),
+        paths: dedupeStrings(raw.paths ?? [])
+    };
+};
+const asRecord = (value)=>{
+    if (value && typeof value === 'object') {
+        return value;
+    }
+    return undefined;
+};
+const pickString = (value)=>{
+    if (typeof value === 'string' && value.trim()) return value;
+    return undefined;
+};
+const extractTenantValue = (value)=>{
+    if (!value) return undefined;
+    if (typeof value === 'string') return pickString(value);
+    const tenantRecord = asRecord(value);
+    if (!tenantRecord) return undefined;
+    return pickString(tenantRecord.id) ?? pickString(tenantRecord.slug) ?? pickString(tenantRecord.value) ?? pickString(tenantRecord.tenant);
+};
+const resolveTenantSlug = (req, tenantField, data)=>{
+    const fromData = extractTenantValue(data?.[tenantField]);
+    if (fromData) return fromData;
+    const query = req.query;
+    if (query && typeof URLSearchParams !== 'undefined' && query instanceof URLSearchParams) {
+        return pickString(query.get('tenant')) ?? pickString(query.get('tenantSlug')) ?? pickString(query.get('tenantId'));
+    }
+    const queryRecord = asRecord(query);
+    const fromQuery = extractTenantValue(queryRecord?.tenant) ?? extractTenantValue(queryRecord?.tenantSlug) ?? extractTenantValue(queryRecord?.tenantId);
+    if (fromQuery) return fromQuery;
+    const userRecord = asRecord(req.user);
+    const fromUser = extractTenantValue(userRecord?.[tenantField]) ?? extractTenantValue(userRecord?.tenant) ?? extractTenantValue(userRecord?.tenantSlug);
+    if (fromUser) return fromUser;
+    const headers = req.headers;
+    if (headers && typeof Headers !== 'undefined' && headers instanceof Headers) {
+        return pickString(headers.get('x-tenant-id')) ?? pickString(headers.get('x-tenant')) ?? pickString(headers.get('payload-tenant'));
+    }
+    const headerRecord = asRecord(headers);
+    return extractTenantValue(headerRecord?.['x-tenant-id']) ?? extractTenantValue(headerRecord?.['x-tenant']) ?? extractTenantValue(headerRecord?.['payload-tenant']);
+};
+const buildDefaultPreviewPath = (pageSlug, tenantSlug, tenantQueryParam)=>{
+    const normalizedSlug = pageSlug === 'home' ? '' : pageSlug;
+    const basePath = normalizedSlug ? `/${normalizedSlug}` : '/';
+    if (!tenantSlug) {
+        return basePath;
+    }
+    const separator = basePath.includes('?') ? '&' : '?';
+    return `${basePath}${separator}${tenantQueryParam}=${encodeURIComponent(tenantSlug)}`;
+};
+const resolveLivePreviewUrl = async (args)=>{
+    const { req, data, livePreview, enableLogging } = args;
+    const tenantSlug = resolveTenantSlug(req, livePreview.tenantField, data);
+    const tenantWhere = tenantSlug ? {
+        [livePreview.tenantField]: {
+            equals: tenantSlug
+        }
+    } : undefined;
+    const homeWhere = {
+        and: [
+            {
+                slug: {
+                    equals: livePreview.pageSlug
+                }
+            },
+            ...tenantWhere ? [
+                tenantWhere
+            ] : []
+        ]
+    };
+    try {
+        const preferredPageResponse = await req.payload.find({
+            collection: livePreview.pageCollection,
+            where: homeWhere,
+            depth: 0,
+            draft: true,
+            limit: 1,
+            overrideAccess: true,
+            pagination: false
+        });
+        let page = preferredPageResponse?.docs?.[0];
+        if (!page && livePreview.fallbackToFirstPage) {
+            const fallbackResponse = await req.payload.find({
+                collection: livePreview.pageCollection,
+                where: tenantWhere,
+                depth: 0,
+                draft: true,
+                limit: 1,
+                overrideAccess: true,
+                pagination: false
+            });
+            page = fallbackResponse?.docs?.[0];
+        }
+        const pageRecord = asRecord(page);
+        const resolvedPageSlug = pickString(pageRecord?.slug) ?? livePreview.pageSlug;
+        if (livePreview.url) {
+            return await livePreview.url({
+                page: pageRecord,
+                pageSlug: resolvedPageSlug,
+                tenantSlug,
+                req
+            });
+        }
+        return buildDefaultPreviewPath(resolvedPageSlug, tenantSlug, livePreview.tenantQueryParam);
+    } catch (error) {
+        if (enableLogging) {
+            req.payload.logger?.warn?.('🎨 Theme Management Plugin: live preview URL fallback used', error);
+        }
+        return buildDefaultPreviewPath(livePreview.pageSlug, tenantSlug, livePreview.tenantQueryParam);
+    }
+};
+const createPreviewAdminConfig = (normalizedLivePreview, enableLogging)=>{
+    if (!normalizedLivePreview.enabled) {
+        return {};
+    }
+    return {
+        livePreview: {
+            breakpoints: normalizedLivePreview.breakpoints,
+            url: ({ data, req })=>resolveLivePreviewUrl({
+                    req: req,
+                    data: asRecord(data),
+                    livePreview: normalizedLivePreview,
+                    enableLogging
+                })
+        },
+        preview: (data, options)=>{
+            const req = options?.req;
+            if (!req) return null;
+            return resolveLivePreviewUrl({
+                req: req,
+                data,
+                livePreview: normalizedLivePreview,
+                enableLogging
+            });
+        }
+    };
+};
+const readSecretFromRequest = async (req)=>{
+    const requestRecord = asRecord(req);
+    const headersValue = requestRecord?.headers;
+    if (headersValue && typeof Headers !== 'undefined' && headersValue instanceof Headers) {
+        return pickString(headersValue.get('x-theme-revalidate-secret')) ?? pickString(headersValue.get('x-revalidate-secret'));
+    }
+    const headerRecord = asRecord(headersValue);
+    const fromHeaders = pickString(headerRecord?.['x-theme-revalidate-secret']) ?? pickString(headerRecord?.['x-revalidate-secret']);
+    if (fromHeaders) {
+        return fromHeaders;
+    }
+    const requestWithJson = req;
+    const body = typeof requestWithJson?.json === 'function' ? await requestWithJson.json() : undefined;
+    const bodyRecord = asRecord(body);
+    const fromBody = pickString(bodyRecord?.secret);
+    if (fromBody) {
+        return fromBody;
+    }
+    const queryRecord = asRecord(requestRecord?.query);
+    return pickString(queryRecord?.secret);
+};
+const executeThemeRevalidation = async (options)=>{
+    const { tags, paths, enableLogging, logger } = options;
+    try {
+        const { revalidatePath, revalidateTag } = await import('next/cache');
+        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(', ')}]`);
+        }
+    } catch (error) {
+        if (enableLogging) {
+            logger?.error?.('🎨 Theme Management Plugin: cache invalidation failed:', error);
+        }
+        throw error;
+    }
+    return {
+        tags,
+        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) {
+        return null;
+    }
+    return {
+        path: cacheRevalidation.routePath,
+        method: 'post',
+        handler: async (req)=>{
+            const reqRecord = asRecord(req);
+            const payload = asRecord(reqRecord?.payload);
+            const logger = payload?.logger;
+            if (cacheRevalidation.secret) {
+                const providedSecret = await readSecretFromRequest(req);
+                if (providedSecret !== cacheRevalidation.secret) {
+                    return jsonResponse({
+                        error: 'Unauthorized'
+                    }, 401);
+                }
+            }
+            try {
+                const result = await executeThemeRevalidation({
+                    tags: cacheRevalidation.tags,
+                    paths: cacheRevalidation.paths,
+                    enableLogging,
+                    logger
+                });
+                return jsonResponse({
+                    ok: true,
+                    revalidated: result
+                });
+            } catch  {
+                return jsonResponse({
+                    ok: false,
+                    error: 'Revalidation failed'
+                }, 500);
+            }
+        }
+    };
+};
+const mergeEndpoint = (endpoints, endpoint)=>{
+    if (!endpoint) {
+        return endpoints;
+    }
+    const record = endpoint;
+    const withoutExisting = endpoints.filter((candidate)=>{
+        const candidateRecord = candidate;
+        return !(candidateRecord?.path === record?.path && typeof candidateRecord.method === 'string' && typeof record.method === 'string' && candidateRecord.method.toLowerCase() === record.method.toLowerCase());
+    });
+    return [
+        ...withoutExisting,
+        endpoint
+    ];
+};
+const jsonResponse = (body, status = 200)=>{
+    if (typeof Response !== 'undefined' && typeof Response.json === 'function') {
+        return Response.json(body, {
+            status
+        });
+    }
+    return {
+        status,
+        json: async ()=>body
+    };
+};
 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 } = options;
+        standaloneCollectionLabel = getTranslations().standaloneCollectionLabel, themePresets = allThemePresets, defaultTheme = 'cool', includeColorModeToggle = true, includeCustomCSS = true, includeBrandIdentity = false, enableAdvancedFeatures = true, enableLogging = false, livePreview = true, cacheRevalidation } = options;
+        const normalizedLivePreview = normalizeLivePreviewOptions(livePreview);
+        const normalizedCacheRevalidation = normalizeCacheRevalidationOptions({
+            cacheRevalidation,
+            standaloneCollectionSlug,
+            useStandaloneCollection
+        });
         if (!enabled) {
             if (enableLogging) {
                 console.log('🎨 Theme Management Plugin: disabled via options, skipping.');
@@ -95,7 +465,8 @@ export const themeManagementPlugin = (options = {})=>{
             includeColorModeToggle,
             includeCustomCSS,
             includeBrandIdentity: includeBrandIdentity ?? false,
-            enableAdvancedFeatures
+            enableAdvancedFeatures,
+            useThemePreviewField: !normalizedLivePreview.enabled
         });
         // If using standalone collection, create a new global
         if (useStandaloneCollection) {
@@ -139,7 +510,8 @@ export const themeManagementPlugin = (options = {})=>{
                 slug: standaloneCollectionSlug,
                 label: standaloneCollectionLabel,
                 admin: {
-                    group: 'Settings'
+                    group: 'Settings',
+                    ...createPreviewAdminConfig(normalizedLivePreview, enableLogging)
                 },
                 // Provide a broad access object but cast to GlobalConfig['access'] to satisfy types
                 access: (()=>{
@@ -159,19 +531,16 @@ export const themeManagementPlugin = (options = {})=>{
                     afterChange: [
                         async ({ doc, req })=>{
                             // Invalidate cache after appearance settings change
-                            if (!req?.context?.disableRevalidate) {
+                            if (!req?.context?.disableRevalidate && normalizedCacheRevalidation.enabled) {
                                 try {
-                                    const cacheTag = `global_${standaloneCollectionSlug}`;
-                                    // Import revalidateTag dynamically to avoid issues in non-Next.js environments
-                                    const { revalidateTag } = await import('next/cache');
-                                    revalidateTag(cacheTag);
-                                    if (enableLogging) {
-                                        req.payload.logger.info(`🎨 Theme Management Plugin: cache invalidated for tag "${cacheTag}"`);
-                                    }
-                                } catch (error) {
-                                    if (enableLogging) {
-                                        req.payload.logger.error('🎨 Theme Management Plugin: cache invalidation failed:', error);
-                                    }
+                                    await executeThemeRevalidation({
+                                        tags: normalizedCacheRevalidation.tags,
+                                        paths: normalizedCacheRevalidation.paths,
+                                        enableLogging,
+                                        logger: req?.payload?.logger
+                                    });
+                                } catch  {
+                                // no-op: logging is handled in executeThemeRevalidation
                                 }
                             }
                             return doc;
@@ -188,8 +557,20 @@ export const themeManagementPlugin = (options = {})=>{
                 }
                 return config;
             }
+            const currentEndpoints = ensureEndpointsArray(config.endpoints);
+            const livePreviewEndpoint = createLivePreviewEndpoint({
+                livePreview: normalizedLivePreview,
+                enableLogging
+            });
+            let endpoints = mergeEndpoint(currentEndpoints, livePreviewEndpoint);
+            const cacheEndpoint = createCacheRevalidationEndpoint({
+                cacheRevalidation: normalizedCacheRevalidation,
+                enableLogging
+            });
+            endpoints = mergeEndpoint(endpoints, cacheEndpoint);
             return {
                 ...config,
+                endpoints,
                 globals: [
                     ...globals,
                     standaloneGlobal
@@ -208,9 +589,14 @@ export const themeManagementPlugin = (options = {})=>{
             }
             const existingFields = Array.isArray(collection.fields) ? collection.fields : [];
             const fields = injectThemeTab(existingFields, themeTab, enableLogging);
+            const admin = {
+                ...collection.admin,
+                ...createPreviewAdminConfig(normalizedLivePreview, enableLogging)
+            };
             return {
                 ...collection,
-                fields
+                fields,
+                admin
             };
         });
         if (!collectionTouched) {
@@ -219,8 +605,20 @@ export const themeManagementPlugin = (options = {})=>{
             }
             return config;
         }
+        const currentEndpoints = ensureEndpointsArray(config.endpoints);
+        const livePreviewEndpoint = createLivePreviewEndpoint({
+            livePreview: normalizedLivePreview,
+            enableLogging
+        });
+        let endpoints = mergeEndpoint(currentEndpoints, livePreviewEndpoint);
+        const cacheEndpoint = createCacheRevalidationEndpoint({
+            cacheRevalidation: normalizedCacheRevalidation,
+            enableLogging
+        });
+        endpoints = mergeEndpoint(endpoints, cacheEndpoint);
         return {
             ...config,
+            endpoints,
             collections
         };
     };