@fecommunity/reactpress-toolkit 3.0.4 → 3.7.0

package/dist/extension/configuration/types.js

@@ -0,0 +1,3 @@
+"use strict";
+/** JSON Schema–driven theme/site configuration (VS Code `contributes.configuration` style). */
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/extension/configuration/validate.d.ts

@@ -0,0 +1,8 @@
+import { type ErrorObject } from 'ajv';
+import type { ThemeConfigurationSchema } from './types';
+export interface ConfigurationValidationResult {
+    valid: boolean;
+    errors: ErrorObject[] | null;
+    message?: string;
+}
+export declare function validateThemeConfiguration(schema: ThemeConfigurationSchema | null | undefined, data: unknown): ConfigurationValidationResult;

package/dist/extension/configuration/validate.js

@@ -0,0 +1,21 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.validateThemeConfiguration = validateThemeConfiguration;
+const ajv_1 = __importDefault(require("ajv"));
+const ajv = new ajv_1.default({ allErrors: true, strict: false, coerceTypes: false });
+function validateThemeConfiguration(schema, data) {
+    if (!schema) {
+        return { valid: true, errors: null };
+    }
+    const validate = ajv.compile(schema);
+    const valid = validate(data) === true;
+    if (valid) {
+        return { valid: true, errors: null };
+    }
+    const errors = validate.errors ?? [];
+    const message = errors.map((e) => `${e.instancePath || '/'} ${e.message ?? ''}`.trim()).join('; ');
+    return { valid: false, errors, message: message || 'Invalid configuration' };
+}

package/dist/extension/index.d.ts

@@ -0,0 +1,9 @@
+export { systemGlobalSettingDefaults } from '../config/global';
+export * from './configuration';
+export { TWENTYTWENTYFIVE_APPEARANCE, TWENTYTWENTYFIVE_APPEARANCE_PANELS, TWENTYTWENTYFIVE_APPEARANCE_SECTIONS, } from './presets/twentytwentyfive-appearance';
+export * from './preview';
+export * from './site-notices';
+export * from './site-settings';
+export * from './theme';
+export * from './theme-admin-locale';
+export { appearanceBackgroundColor, appearanceLinkColor, appearancePrimaryColorForMode, appearanceSecondaryBackgroundColor, buildTwentyTwentyFiveAppearanceCss, } from './twentytwentyfive-vars';

package/dist/extension/index.js

@@ -0,0 +1,35 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.buildTwentyTwentyFiveAppearanceCss = exports.appearanceSecondaryBackgroundColor = exports.appearancePrimaryColorForMode = exports.appearanceLinkColor = exports.appearanceBackgroundColor = exports.TWENTYTWENTYFIVE_APPEARANCE_SECTIONS = exports.TWENTYTWENTYFIVE_APPEARANCE_PANELS = exports.TWENTYTWENTYFIVE_APPEARANCE = exports.systemGlobalSettingDefaults = void 0;
+var global_1 = require("../config/global");
+Object.defineProperty(exports, "systemGlobalSettingDefaults", { enumerable: true, get: function () { return global_1.systemGlobalSettingDefaults; } });
+__exportStar(require("./configuration"), exports);
+var twentytwentyfive_appearance_1 = require("./presets/twentytwentyfive-appearance");
+Object.defineProperty(exports, "TWENTYTWENTYFIVE_APPEARANCE", { enumerable: true, get: function () { return twentytwentyfive_appearance_1.TWENTYTWENTYFIVE_APPEARANCE; } });
+Object.defineProperty(exports, "TWENTYTWENTYFIVE_APPEARANCE_PANELS", { enumerable: true, get: function () { return twentytwentyfive_appearance_1.TWENTYTWENTYFIVE_APPEARANCE_PANELS; } });
+Object.defineProperty(exports, "TWENTYTWENTYFIVE_APPEARANCE_SECTIONS", { enumerable: true, get: function () { return twentytwentyfive_appearance_1.TWENTYTWENTYFIVE_APPEARANCE_SECTIONS; } });
+__exportStar(require("./preview"), exports);
+__exportStar(require("./site-notices"), exports);
+__exportStar(require("./site-settings"), exports);
+__exportStar(require("./theme"), exports);
+__exportStar(require("./theme-admin-locale"), exports);
+var twentytwentyfive_vars_1 = require("./twentytwentyfive-vars");
+Object.defineProperty(exports, "appearanceBackgroundColor", { enumerable: true, get: function () { return twentytwentyfive_vars_1.appearanceBackgroundColor; } });
+Object.defineProperty(exports, "appearanceLinkColor", { enumerable: true, get: function () { return twentytwentyfive_vars_1.appearanceLinkColor; } });
+Object.defineProperty(exports, "appearancePrimaryColorForMode", { enumerable: true, get: function () { return twentytwentyfive_vars_1.appearancePrimaryColorForMode; } });
+Object.defineProperty(exports, "appearanceSecondaryBackgroundColor", { enumerable: true, get: function () { return twentytwentyfive_vars_1.appearanceSecondaryBackgroundColor; } });
+Object.defineProperty(exports, "buildTwentyTwentyFiveAppearanceCss", { enumerable: true, get: function () { return twentytwentyfive_vars_1.buildTwentyTwentyFiveAppearanceCss; } });

package/dist/extension/manifest-normalize.d.ts

@@ -0,0 +1,5 @@
+import type { ThemeAppearanceManifest, ThemeManifest } from './theme';
+type RawRecord = Record<string, unknown>;
+export declare function normalizeAppearance(raw: unknown): ThemeAppearanceManifest | undefined;
+export declare function normalizePlatformFields(o: RawRecord): Pick<ThemeManifest, 'requires' | 'supports' | 'templates' | 'options'>;
+export {};

package/dist/extension/manifest-normalize.js

@@ -0,0 +1,75 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.normalizeAppearance = normalizeAppearance;
+exports.normalizePlatformFields = normalizePlatformFields;
+function asRecord(value) {
+    return value && typeof value === 'object' && !Array.isArray(value) ? value : undefined;
+}
+function normalizeSetting(raw) {
+    return {
+        id: String(raw.id),
+        type: raw.type,
+        label: String(raw.label),
+        default: typeof raw.default === 'string' ? raw.default : undefined,
+        description: typeof raw.description === 'string' ? raw.description : undefined,
+        choices: Array.isArray(raw.choices)
+            ? raw.choices
+            : undefined,
+        group: typeof raw.group === 'string' ? raw.group : undefined,
+    };
+}
+function normalizeGroup(raw) {
+    return {
+        id: String(raw.id),
+        title: String(raw.title),
+        description: typeof raw.description === 'string' ? raw.description : undefined,
+    };
+}
+function normalizePanel(raw) {
+    return {
+        id: String(raw.id),
+        title: String(raw.title),
+        description: typeof raw.description === 'string' ? raw.description : undefined,
+    };
+}
+function normalizeSection(raw) {
+    return {
+        id: String(raw.id),
+        title: String(raw.title),
+        panel: typeof raw.panel === 'string' ? raw.panel : undefined,
+        embed: raw.embed === 'options' ? 'options' : undefined,
+        description: typeof raw.description === 'string' ? raw.description : undefined,
+        groups: Array.isArray(raw.groups)
+            ? raw.groups.map((item) => normalizeGroup(asRecord(item) ?? {}))
+            : undefined,
+        settings: Array.isArray(raw.settings)
+            ? raw.settings.map((item) => normalizeSetting(asRecord(item) ?? {}))
+            : undefined,
+    };
+}
+function normalizeAppearance(raw) {
+    const source = asRecord(raw);
+    if (!source)
+        return undefined;
+    const panels = Array.isArray(source.panels)
+        ? source.panels.map((item) => normalizePanel(asRecord(item) ?? {}))
+        : undefined;
+    const sections = Array.isArray(source.sections)
+        ? source.sections.map((item) => normalizeSection(asRecord(item) ?? {}))
+        : [];
+    if (panels === undefined && sections.length === 0)
+        return undefined;
+    return { panels, sections };
+}
+function normalizePlatformFields(o) {
+    const requires = typeof o.requires === 'string' ? o.requires : undefined;
+    const supports = o.supports;
+    const templates = o.templates;
+    const options = o.options;
+    return {
+        requires,
+        supports: supports && typeof supports === 'object' ? supports : undefined,
+        templates: templates && typeof templates === 'object' ? templates : undefined,
+        options: options?.type === 'object' ? options : undefined,
+    };
+}

package/dist/extension/node.d.ts

@@ -0,0 +1,2 @@
+/** Node-only extension helpers (filesystem, etc.). Do not import from browser bundles. */
+export { readThemeAdminLocaleFile } from './theme-admin-locale.io';

package/dist/extension/node.js

@@ -0,0 +1,6 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readThemeAdminLocaleFile = void 0;
+/** Node-only extension helpers (filesystem, etc.). Do not import from browser bundles. */
+var theme_admin_locale_io_1 = require("./theme-admin-locale.io");
+Object.defineProperty(exports, "readThemeAdminLocaleFile", { enumerable: true, get: function () { return theme_admin_locale_io_1.readThemeAdminLocaleFile; } });

package/dist/extension/presets/twentytwentyfive-appearance.d.ts

@@ -0,0 +1,10 @@
+import type { ThemeAppearancePanel, ThemeAppearanceSection } from '../theme';
+/** Sidebar nav panels for Twenty Twenty-Five appearance editor. */
+export declare const TWENTYTWENTYFIVE_APPEARANCE_PANELS: ThemeAppearancePanel[];
+/** Default appearance sections for Twenty Twenty-Five (also in `themes/.../theme.json`). */
+export declare const TWENTYTWENTYFIVE_APPEARANCE_SECTIONS: ThemeAppearanceSection[];
+/** Full `theme.json` → `appearance` block for Twenty Twenty-Five. */
+export declare const TWENTYTWENTYFIVE_APPEARANCE: {
+    panels: ThemeAppearancePanel[];
+    sections: ThemeAppearanceSection[];
+};

package/dist/extension/presets/twentytwentyfive-appearance.js

@@ -0,0 +1,193 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TWENTYTWENTYFIVE_APPEARANCE = exports.TWENTYTWENTYFIVE_APPEARANCE_SECTIONS = exports.TWENTYTWENTYFIVE_APPEARANCE_PANELS = void 0;
+/** Sidebar nav panels for Twenty Twenty-Five appearance editor. */
+exports.TWENTYTWENTYFIVE_APPEARANCE_PANELS = [
+    {
+        id: 'basic',
+        title: '基础配置',
+        description: '站点信息与页脚',
+    },
+    {
+        id: 'style',
+        title: '样式配置',
+        description: '颜色与背景',
+    },
+    {
+        id: 'layout',
+        title: '布局配置',
+        description: '导航与页面结构',
+    },
+];
+/** Default appearance sections for Twenty Twenty-Five (also in `themes/.../theme.json`). */
+exports.TWENTYTWENTYFIVE_APPEARANCE_SECTIONS = [
+    {
+        id: 'identity',
+        panel: 'basic',
+        title: '站点身份',
+        settings: [
+            {
+                id: 'displayTitle',
+                type: 'text',
+                label: '站点标题',
+                description: '留空则继承「设置 → 常规」中的站点标题',
+            },
+            {
+                id: 'displayTagline',
+                type: 'text',
+                label: '站点副标题',
+                description: '留空则继承「设置 → 常规」中的副标题',
+            },
+            {
+                id: 'siteLogo',
+                type: 'image',
+                label: '站点 Logo',
+                description: '留空则继承「设置 → 常规」中的站点 Logo',
+            },
+            {
+                id: 'siteFavicon',
+                type: 'image',
+                label: '站点图标',
+                description: '留空则继承「设置 → 常规」中的站点图标',
+            },
+            {
+                id: 'siteNotice',
+                type: 'noticeList',
+                label: '站点公告',
+                description: '未自定义时继承「设置 → 常规」；可为本主题单独配置多条公告与顺序',
+            },
+        ],
+    },
+    {
+        id: 'about',
+        panel: 'basic',
+        title: '关于我们与页脚',
+        settings: [
+            {
+                id: 'systemFooterInfo',
+                type: 'textarea',
+                label: '页脚说明',
+                description: '支持 HTML；仅本主题生效',
+            },
+            {
+                id: 'aboutUsGithubUrl',
+                type: 'text',
+                label: 'GitHub 链接',
+                description: '页头与页脚 GitHub 图标；留空不显示',
+            },
+            {
+                id: 'aboutUsCommentQr',
+                type: 'image',
+                label: '社群/评论二维码',
+                description: '悬停展示的图片地址',
+            },
+            {
+                id: 'aboutUsWechatQr',
+                type: 'image',
+                label: '微信二维码',
+                description: '悬停展示的图片地址',
+            },
+        ],
+    },
+    {
+        id: 'colors',
+        panel: 'style',
+        title: '颜色',
+        description: '与访客站顶栏「日 / 夜」切换对应，可分别配置浅色与深色模式',
+        groups: [
+            {
+                id: 'light',
+                title: '浅色模式',
+                description: '访客关闭深色模式时生效',
+            },
+            {
+                id: 'dark',
+                title: '深色模式',
+                description: '访客开启深色模式时生效',
+            },
+        ],
+        settings: [
+            { id: 'primaryColor', group: 'light', type: 'color', label: '主色', default: '#f44336' },
+            {
+                id: 'backgroundColor',
+                group: 'light',
+                type: 'color',
+                label: '背景色',
+                default: '#ffffff',
+                description: '页面与内容区背景；设置背景图后主区域会透明以露出图片',
+            },
+            {
+                id: 'secondaryBackgroundColor',
+                group: 'light',
+                type: 'color',
+                label: '次要背景色',
+                default: '#f3f5f7',
+                description: '卡片间隔、侧栏等次要区域',
+            },
+            {
+                id: 'linkColor',
+                group: 'light',
+                type: 'color',
+                label: '链接色',
+                default: '#4299e1',
+                description: '正文 Markdown 中的链接颜色',
+            },
+            {
+                id: 'darkPrimaryColor',
+                group: 'dark',
+                type: 'color',
+                label: '主色',
+                default: '#f44336',
+            },
+            {
+                id: 'darkBackgroundColor',
+                group: 'dark',
+                type: 'color',
+                label: '背景色',
+                default: '#1e2a36',
+                description: '页面与主内容区背景',
+            },
+            {
+                id: 'darkSecondaryBackgroundColor',
+                group: 'dark',
+                type: 'color',
+                label: '次要背景色',
+                default: '#1a242f',
+                description: '卡片、顶栏、侧栏等次要区域',
+            },
+            {
+                id: 'darkLinkColor',
+                group: 'dark',
+                type: 'color',
+                label: '链接色',
+                default: '#4299e1',
+                description: '正文 Markdown 中的链接颜色',
+            },
+        ],
+    },
+    {
+        id: 'background',
+        panel: 'style',
+        title: '背景图片',
+        settings: [
+            {
+                id: 'backgroundImage',
+                type: 'image',
+                label: '背景图',
+                description: '设置后将覆盖纯色背景（宽屏可见）；仅本主题生效',
+            },
+        ],
+    },
+    {
+        id: 'themeConfiguration',
+        panel: 'layout',
+        title: '顶栏与网址导航',
+        embed: 'options',
+        description: '固定导航、/nav 卡片与聚合搜索',
+    },
+];
+/** Full `theme.json` → `appearance` block for Twenty Twenty-Five. */
+exports.TWENTYTWENTYFIVE_APPEARANCE = {
+    panels: exports.TWENTYTWENTYFIVE_APPEARANCE_PANELS,
+    sections: exports.TWENTYTWENTYFIVE_APPEARANCE_SECTIONS,
+};

package/dist/extension/presets/twentytwentyfive-customizer.d.ts

@@ -0,0 +1,19 @@
+import type { ThemeAppearancePanel, ThemeAppearanceSection } from '../theme';
+/** Sidebar nav panels for Twenty Twenty-Five appearance editor. */
+export declare const TWENTYTWENTYFIVE_APPEARANCE_PANELS: ThemeAppearancePanel[];
+/** Default appearance sections for Twenty Twenty-Five (also in `themes/.../theme.json`). */
+export declare const TWENTYTWENTYFIVE_APPEARANCE_SECTIONS: ThemeAppearanceSection[];
+/** Full `theme.json` → `appearance` block for Twenty Twenty-Five. */
+export declare const TWENTYTWENTYFIVE_APPEARANCE: {
+    panels: ThemeAppearancePanel[];
+    sections: ThemeAppearanceSection[];
+};
+/** @deprecated Use `TWENTYTWENTYFIVE_APPEARANCE_PANELS` */
+export declare const TWENTYTWENTYFIVE_CUSTOMIZER_GROUPS: ThemeAppearancePanel[];
+/** @deprecated Use `TWENTYTWENTYFIVE_APPEARANCE_SECTIONS` */
+export declare const TWENTYTWENTYFIVE_CUSTOMIZER_SECTIONS: ThemeAppearanceSection[];
+/** @deprecated Use `TWENTYTWENTYFIVE_APPEARANCE` */
+export declare const TWENTYTWENTYFIVE_CUSTOMIZER: {
+    panels: ThemeAppearancePanel[];
+    sections: ThemeAppearanceSection[];
+};

package/dist/extension/presets/twentytwentyfive-customizer.js

@@ -0,0 +1,199 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TWENTYTWENTYFIVE_CUSTOMIZER = exports.TWENTYTWENTYFIVE_CUSTOMIZER_SECTIONS = exports.TWENTYTWENTYFIVE_CUSTOMIZER_GROUPS = exports.TWENTYTWENTYFIVE_APPEARANCE = exports.TWENTYTWENTYFIVE_APPEARANCE_SECTIONS = exports.TWENTYTWENTYFIVE_APPEARANCE_PANELS = void 0;
+/** Sidebar nav panels for Twenty Twenty-Five appearance editor. */
+exports.TWENTYTWENTYFIVE_APPEARANCE_PANELS = [
+    {
+        id: 'basic',
+        title: '基础配置',
+        description: '站点信息与页脚',
+    },
+    {
+        id: 'style',
+        title: '样式配置',
+        description: '颜色与背景',
+    },
+    {
+        id: 'layout',
+        title: '布局配置',
+        description: '导航与页面结构',
+    },
+];
+/** Default appearance sections for Twenty Twenty-Five (also in `themes/.../theme.json`). */
+exports.TWENTYTWENTYFIVE_APPEARANCE_SECTIONS = [
+    {
+        id: 'identity',
+        panel: 'basic',
+        title: '站点身份',
+        settings: [
+            {
+                id: 'displayTitle',
+                type: 'text',
+                label: '站点标题',
+                description: '留空则继承「设置 → 常规」中的站点标题',
+            },
+            {
+                id: 'displayTagline',
+                type: 'text',
+                label: '站点副标题',
+                description: '留空则继承「设置 → 常规」中的副标题',
+            },
+            {
+                id: 'siteLogo',
+                type: 'image',
+                label: '站点 Logo',
+                description: '留空则继承「设置 → 常规」中的站点 Logo',
+            },
+            {
+                id: 'siteFavicon',
+                type: 'image',
+                label: '站点图标',
+                description: '留空则继承「设置 → 常规」中的站点图标',
+            },
+            {
+                id: 'siteNotice',
+                type: 'noticeList',
+                label: '站点公告',
+                description: '未自定义时继承「设置 → 常规」；可为本主题单独配置多条公告与顺序',
+            },
+        ],
+    },
+    {
+        id: 'about',
+        panel: 'basic',
+        title: '关于我们与页脚',
+        settings: [
+            {
+                id: 'systemFooterInfo',
+                type: 'textarea',
+                label: '页脚说明',
+                description: '支持 HTML；仅本主题生效',
+            },
+            {
+                id: 'aboutUsGithubUrl',
+                type: 'text',
+                label: 'GitHub 链接',
+                description: '页头与页脚 GitHub 图标；留空不显示',
+            },
+            {
+                id: 'aboutUsCommentQr',
+                type: 'image',
+                label: '社群/评论二维码',
+                description: '悬停展示的图片地址',
+            },
+            {
+                id: 'aboutUsWechatQr',
+                type: 'image',
+                label: '微信二维码',
+                description: '悬停展示的图片地址',
+            },
+        ],
+    },
+    {
+        id: 'colors',
+        panel: 'style',
+        title: '颜色',
+        description: '与访客站顶栏「日 / 夜」切换对应，可分别配置浅色与深色模式',
+        groups: [
+            {
+                id: 'light',
+                title: '浅色模式',
+                description: '访客关闭深色模式时生效',
+            },
+            {
+                id: 'dark',
+                title: '深色模式',
+                description: '访客开启深色模式时生效',
+            },
+        ],
+        settings: [
+            { id: 'primaryColor', group: 'light', type: 'color', label: '主色', default: '#f44336' },
+            {
+                id: 'backgroundColor',
+                group: 'light',
+                type: 'color',
+                label: '背景色',
+                default: '#ffffff',
+                description: '页面与内容区背景；设置背景图后主区域会透明以露出图片',
+            },
+            {
+                id: 'secondaryBackgroundColor',
+                group: 'light',
+                type: 'color',
+                label: '次要背景色',
+                default: '#f3f5f7',
+                description: '卡片间隔、侧栏等次要区域',
+            },
+            {
+                id: 'linkColor',
+                group: 'light',
+                type: 'color',
+                label: '链接色',
+                default: '#4299e1',
+                description: '正文 Markdown 中的链接颜色',
+            },
+            {
+                id: 'darkPrimaryColor',
+                group: 'dark',
+                type: 'color',
+                label: '主色',
+                default: '#f44336',
+            },
+            {
+                id: 'darkBackgroundColor',
+                group: 'dark',
+                type: 'color',
+                label: '背景色',
+                default: '#1e2a36',
+                description: '页面与主内容区背景',
+            },
+            {
+                id: 'darkSecondaryBackgroundColor',
+                group: 'dark',
+                type: 'color',
+                label: '次要背景色',
+                default: '#1a242f',
+                description: '卡片、顶栏、侧栏等次要区域',
+            },
+            {
+                id: 'darkLinkColor',
+                group: 'dark',
+                type: 'color',
+                label: '链接色',
+                default: '#4299e1',
+                description: '正文 Markdown 中的链接颜色',
+            },
+        ],
+    },
+    {
+        id: 'background',
+        panel: 'style',
+        title: '背景图片',
+        settings: [
+            {
+                id: 'backgroundImage',
+                type: 'image',
+                label: '背景图',
+                description: '设置后将覆盖纯色背景（宽屏可见）；仅本主题生效',
+            },
+        ],
+    },
+    {
+        id: 'themeConfiguration',
+        panel: 'layout',
+        title: '顶栏与网址导航',
+        embed: 'options',
+        description: '固定导航、/nav 卡片与聚合搜索',
+    },
+];
+/** Full `theme.json` → `appearance` block for Twenty Twenty-Five. */
+exports.TWENTYTWENTYFIVE_APPEARANCE = {
+    panels: exports.TWENTYTWENTYFIVE_APPEARANCE_PANELS,
+    sections: exports.TWENTYTWENTYFIVE_APPEARANCE_SECTIONS,
+};
+/** @deprecated Use `TWENTYTWENTYFIVE_APPEARANCE_PANELS` */
+exports.TWENTYTWENTYFIVE_CUSTOMIZER_GROUPS = exports.TWENTYTWENTYFIVE_APPEARANCE_PANELS;
+/** @deprecated Use `TWENTYTWENTYFIVE_APPEARANCE_SECTIONS` */
+exports.TWENTYTWENTYFIVE_CUSTOMIZER_SECTIONS = exports.TWENTYTWENTYFIVE_APPEARANCE_SECTIONS;
+/** @deprecated Use `TWENTYTWENTYFIVE_APPEARANCE` */
+exports.TWENTYTWENTYFIVE_CUSTOMIZER = exports.TWENTYTWENTYFIVE_APPEARANCE;

package/dist/extension/preview.d.ts

@@ -0,0 +1,46 @@
+import { parsePreviewTokenFromNextCtx, type PreviewDraftPayload } from '../theme/preview-draft';
+import type { ResolvedSiteConfig, ThemeConfigurationSchema } from './configuration/types';
+import { type ThemeMods } from './theme';
+/** Draft payload returned by `GET /extension/themes/preview-draft/:token`. */
+export type PreviewDraftResponse = PreviewDraftPayload;
+export type NextPreviewCtx = Parameters<typeof parsePreviewTokenFromNextCtx>[0];
+export type PreviewDraftFetcher = (token: string) => Promise<PreviewDraftResponse>;
+/** Relative API path for a preview draft token. */
+export declare function previewDraftApiPath(token: string): string;
+/**
+ * Normalize API or axios-interceptor output into a preview draft.
+ * Accepts either `{ success, data }` envelopes or plain draft objects.
+ */
+export declare function normalizePreviewDraftData(raw: unknown): PreviewDraftResponse;
+/** Load short-lived customizer preview payload (public GET by token). */
+export declare function fetchPreviewDraft(token: string, options?: {
+    baseURL?: string;
+    fetcher?: PreviewDraftFetcher;
+}): Promise<PreviewDraftResponse>;
+export type ResolveThemePreviewContextInput = {
+    globalSettingRaw: unknown;
+    setting: Record<string, unknown>;
+    locale?: string;
+    ctx?: NextPreviewCtx;
+    manifest?: {
+        options?: ThemeConfigurationSchema;
+    };
+    /** Override draft loader (e.g. theme-local axios with auth interceptors). */
+    fetchDraft?: PreviewDraftFetcher;
+    apiBaseURL?: string;
+};
+/** Fully resolved visitor runtime after applying optional preview draft. */
+export type ResolvedThemePreviewContext = {
+    siteConfig: ResolvedSiteConfig;
+    setting: Record<string, unknown>;
+    colorPrimary: string;
+    effectiveMods: ThemeMods;
+    configThemeId: string;
+    isPreview: boolean;
+    draft: PreviewDraftResponse | null;
+};
+/**
+ * Resolve site config, setting overlays, and customizer mods for a Next.js `_app` request.
+ * Themes should call this once in `getInitialProps` and pass results into their context/provider.
+ */
+export declare function resolveThemePreviewContext(input: ResolveThemePreviewContextInput): Promise<ResolvedThemePreviewContext>;