@fecommunity/reactpress 4.0.0-beta.1 → 4.0.0-beta.11

package/toolkit/dist/extension/configuration/index.js

@@ -0,0 +1,28 @@
+"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.twentytwentyfiveConfigSeed = exports.TWENTYTWENTYFIVE_CONFIGURATION_SCHEMA = exports.getThemeConfigurationSeed = exports.getThemeConfigurationSchema = void 0;
+__exportStar(require("./defaults"), exports);
+__exportStar(require("./formily"), exports);
+__exportStar(require("./paths"), exports);
+var twentytwentyfive_1 = require("./presets/twentytwentyfive");
+Object.defineProperty(exports, "getThemeConfigurationSchema", { enumerable: true, get: function () { return twentytwentyfive_1.getThemeConfigurationSchema; } });
+Object.defineProperty(exports, "getThemeConfigurationSeed", { enumerable: true, get: function () { return twentytwentyfive_1.getThemeConfigurationSeed; } });
+Object.defineProperty(exports, "TWENTYTWENTYFIVE_CONFIGURATION_SCHEMA", { enumerable: true, get: function () { return twentytwentyfive_1.TWENTYTWENTYFIVE_CONFIGURATION_SCHEMA; } });
+Object.defineProperty(exports, "twentytwentyfiveConfigSeed", { enumerable: true, get: function () { return twentytwentyfive_1.twentytwentyfiveConfigSeed; } });
+__exportStar(require("./resolve"), exports);
+__exportStar(require("./types"), exports);
+__exportStar(require("./validate"), exports);

package/toolkit/dist/extension/configuration/paths.js

@@ -0,0 +1,50 @@
+"use strict";
+/** Deep get/set for nested configuration objects. */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getByPath = getByPath;
+exports.setByPath = setByPath;
+exports.deepMerge = deepMerge;
+function getByPath(obj, path) {
+    if (!path)
+        return obj;
+    const parts = path.split('.');
+    let cur = obj;
+    for (const part of parts) {
+        if (cur == null || typeof cur !== 'object')
+            return undefined;
+        cur = cur[part];
+    }
+    return cur;
+}
+function setByPath(obj, path, value) {
+    const parts = path.split('.');
+    let cur = obj;
+    for (let i = 0; i < parts.length - 1; i++) {
+        const key = parts[i];
+        const next = cur[key];
+        if (next == null || typeof next !== 'object' || Array.isArray(next)) {
+            cur[key] = {};
+        }
+        cur = cur[key];
+    }
+    cur[parts[parts.length - 1]] = value;
+}
+function deepMerge(target, source) {
+    const out = { ...target };
+    for (const key of Object.keys(source)) {
+        const sv = source[key];
+        const tv = out[key];
+        if (sv &&
+            typeof sv === 'object' &&
+            !Array.isArray(sv) &&
+            tv &&
+            typeof tv === 'object' &&
+            !Array.isArray(tv)) {
+            out[key] = deepMerge(tv, sv);
+        }
+        else if (sv !== undefined) {
+            out[key] = sv;
+        }
+    }
+    return out;
+}

package/toolkit/dist/extension/configuration/presets/twentytwentyfive.js

@@ -0,0 +1,94 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TWENTYTWENTYFIVE_CONFIGURATION_SCHEMA = void 0;
+exports.twentytwentyfiveConfigSeed = twentytwentyfiveConfigSeed;
+exports.getThemeConfigurationSchema = getThemeConfigurationSchema;
+exports.getThemeConfigurationSeed = getThemeConfigurationSeed;
+const global_1 = require("../../../config/global");
+const defaults_1 = require("../defaults");
+const paths_1 = require("../paths");
+/** Declarative schema shipped with the default blog theme (also embedded in `theme.json`). */
+exports.TWENTYTWENTYFIVE_CONFIGURATION_SCHEMA = {
+    $schema: 'http://json-schema.org/draft-07/schema#',
+    title: 'Twenty Twenty-Five',
+    description: '顶栏导航与 /nav 网址导航、聚合搜索',
+    type: 'object',
+    additionalProperties: false,
+    properties: {
+        header: {
+            type: 'object',
+            title: '顶栏',
+            properties: {
+                navLinks: {
+                    type: 'array',
+                    title: '固定导航链接',
+                    description: '显示在「页面」模块发布的自定义页面之前',
+                    default: [
+                        { path: '/', locale: 'home', icon: 'HomeOutlined', visible: true },
+                        { path: '/nav', locale: 'nav', icon: 'GlobalOutlined', visible: true },
+                        { path: '/knowledge', locale: 'knowledge', icon: 'BookOutlined', visible: false },
+                        { path: '/archives', locale: 'archives', icon: 'HistoryOutlined', visible: true },
+                    ],
+                    items: {
+                        type: 'object',
+                        required: ['path'],
+                        properties: {
+                            path: { type: 'string', title: '路径' },
+                            locale: { type: 'string', title: 'i18n 键' },
+                            label: { type: 'string', title: '覆盖文案' },
+                            icon: { type: 'string', title: 'Ant Design 图标名' },
+                            visible: { type: 'boolean', title: '显示', default: true },
+                        },
+                    },
+                    'x-ui': { widget: 'navLinkList', section: 'header', order: 10 },
+                },
+            },
+        },
+        nav: {
+            type: 'object',
+            title: '网址导航',
+            properties: {
+                urlConfig: {
+                    type: 'array',
+                    title: '导航卡片分组',
+                    'x-ui': { widget: 'urlConfigEditor', section: 'nav', order: 20 },
+                    items: { type: 'object' },
+                },
+                searchCategories: {
+                    type: 'object',
+                    title: '聚合搜索分类',
+                    'x-ui': { widget: 'navSearchEditor', section: 'nav', order: 30 },
+                    properties: {
+                        categories: { type: 'array', items: { type: 'object' } },
+                        subCategories: { type: 'object' },
+                    },
+                },
+            },
+        },
+    },
+};
+/** Seed nav blocks from toolkit `globalSetting` locale bundles (too large for inline schema defaults). */
+function twentytwentyfiveConfigSeed(locale = 'zh') {
+    const gs = global_1.globalSetting;
+    const bundle = locale === 'en' ? gs.en : gs.zh;
+    const gc = bundle?.globalConfig ?? {};
+    return {
+        nav: {
+            urlConfig: gc.urlConfig ?? [],
+            searchCategories: gc.navConfig ?? { categories: [], subCategories: {} },
+        },
+    };
+}
+function getThemeConfigurationSchema(themeId) {
+    if (themeId === 'twentytwentyfive')
+        return exports.TWENTYTWENTYFIVE_CONFIGURATION_SCHEMA;
+    return null;
+}
+function getThemeConfigurationSeed(themeId, locale = 'zh') {
+    const schema = getThemeConfigurationSchema(themeId);
+    if (!schema)
+        return null;
+    const schemaDefaults = (0, defaults_1.defaultsFromSchema)(schema);
+    const navSeed = themeId === 'twentytwentyfive' ? twentytwentyfiveConfigSeed(locale) : {};
+    return (0, paths_1.deepMerge)(schemaDefaults, navSeed);
+}

package/toolkit/dist/extension/configuration/resolve.js

@@ -0,0 +1,98 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseGlobalSettingRaw = parseGlobalSettingRaw;
+exports.getConfigurationSchemaFromManifest = getConfigurationSchemaFromManifest;
+exports.getMergedThemeConfiguration = getMergedThemeConfiguration;
+exports.getConfig = getConfig;
+exports.patchConfiguration = patchConfiguration;
+exports.mergeConfigIntoGlobalSetting = mergeConfigIntoGlobalSetting;
+exports.resolveSiteConfig = resolveSiteConfig;
+exports.validateAndMergeThemeConfiguration = validateAndMergeThemeConfiguration;
+const defaults_1 = require("./defaults");
+const paths_1 = require("./paths");
+const twentytwentyfive_1 = require("./presets/twentytwentyfive");
+const validate_1 = require("./validate");
+const FALLBACK_HEADER_NAV = [
+    { path: '/', locale: 'home', icon: 'HomeOutlined', visible: true },
+    { path: '/nav', locale: 'nav', icon: 'GlobalOutlined', visible: true },
+    { path: '/archives', locale: 'archives', icon: 'HistoryOutlined', visible: true },
+];
+function parseGlobalSettingRaw(raw) {
+    if (!raw)
+        return {};
+    if (typeof raw === 'string') {
+        try {
+            return JSON.parse(raw);
+        }
+        catch {
+            return {};
+        }
+    }
+    if (typeof raw === 'object')
+        return raw;
+    return {};
+}
+function getConfigurationSchemaFromManifest(manifest, themeId) {
+    const fromManifest = manifest?.options;
+    if (fromManifest && fromManifest.type === 'object')
+        return fromManifest;
+    return (0, twentytwentyfive_1.getThemeConfigurationSchema)(themeId);
+}
+function getMergedThemeConfiguration(globalRaw, themeId, options) {
+    const gs = parseGlobalSettingRaw(globalRaw);
+    const schema = getConfigurationSchemaFromManifest(options?.manifest ?? null, themeId) ??
+        (0, twentytwentyfive_1.getThemeConfigurationSchema)(themeId);
+    const seed = (0, twentytwentyfive_1.getThemeConfigurationSeed)(themeId, options?.locale ?? 'zh') ??
+        (schema ? (0, defaults_1.defaultsFromSchema)(schema) : {});
+    const store = gs.config && typeof gs.config === 'object' ? gs.config : {};
+    const stored = store[themeId];
+    const storedObj = stored && typeof stored === 'object' && !Array.isArray(stored)
+        ? stored
+        : {};
+    return (0, paths_1.deepMerge)((0, paths_1.deepMerge)({}, seed), storedObj);
+}
+function getConfig(configuration, path) {
+    return (0, paths_1.getByPath)(configuration, path);
+}
+function patchConfiguration(current, patch) {
+    return (0, paths_1.deepMerge)({ ...current }, patch);
+}
+function mergeConfigIntoGlobalSetting(globalRaw, themeId, themeConfig) {
+    const gs = parseGlobalSettingRaw(globalRaw);
+    const config = gs.config && typeof gs.config === 'object' ? { ...gs.config } : {};
+    config[themeId] = themeConfig;
+    return { ...gs, config };
+}
+function resolveSiteConfig(globalRaw, themeId, locale = 'zh', manifest, 
+/** Draft theme config from appearance preview query (not persisted). */
+configOverride) {
+    const merged = getMergedThemeConfiguration(globalRaw, themeId, { locale, manifest });
+    const effective = configOverride && Object.keys(configOverride).length > 0
+        ? patchConfiguration(merged, configOverride)
+        : merged;
+    const gs = parseGlobalSettingRaw(globalRaw);
+    const legacyBundle = (gs[locale] ?? gs.zh);
+    const legacy = legacyBundle?.globalConfig;
+    const headerNav = getConfig(effective, 'header.navLinks');
+    const urlConfig = getConfig(effective, 'nav.urlConfig');
+    const searchCategories = getConfig(effective, 'nav.searchCategories');
+    const navLinks = (headerNav ?? FALLBACK_HEADER_NAV).filter((item) => item.visible !== false);
+    return {
+        header: { navLinks },
+        nav: {
+            urlConfig: urlConfig ?? legacy?.urlConfig ?? [],
+            searchCategories: searchCategories ??
+                legacy?.navConfig ?? { categories: [], subCategories: {} },
+        },
+    };
+}
+function validateAndMergeThemeConfiguration(themeId, globalRaw, patch, manifest) {
+    const schema = getConfigurationSchemaFromManifest(manifest ?? null, themeId);
+    const current = getMergedThemeConfiguration(globalRaw, themeId, { manifest });
+    const next = patchConfiguration(current, patch);
+    const result = (0, validate_1.validateThemeConfiguration)(schema, next);
+    if (!result.valid) {
+        return { ok: false, message: result.message ?? 'Invalid configuration' };
+    }
+    return { ok: true, config: next };
+}

package/toolkit/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/toolkit/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/toolkit/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/toolkit/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/toolkit/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/toolkit/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,
+};