@fecommunity/reactpress 4.0.0-beta.0 → 4.0.0-beta.10

package/toolkit/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/toolkit/dist/extension/preview.js

@@ -0,0 +1,92 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.previewDraftApiPath = previewDraftApiPath;
+exports.normalizePreviewDraftData = normalizePreviewDraftData;
+exports.fetchPreviewDraft = fetchPreviewDraft;
+exports.resolveThemePreviewContext = resolveThemePreviewContext;
+const axios_1 = __importDefault(require("axios"));
+const api_1 = require("../theme/api");
+const preview_draft_1 = require("../theme/preview-draft");
+const preview_mods_1 = require("../theme/preview-mods");
+const resolve_1 = require("./configuration/resolve");
+const theme_1 = require("./theme");
+/** Relative API path for a preview draft token. */
+function previewDraftApiPath(token) {
+    return `/extension/themes/preview-draft/${encodeURIComponent(token.trim())}`;
+}
+/**
+ * Normalize API or axios-interceptor output into a preview draft.
+ * Accepts either `{ success, data }` envelopes or plain draft objects.
+ */
+function normalizePreviewDraftData(raw) {
+    if (!raw || typeof raw !== 'object' || Array.isArray(raw)) {
+        return {};
+    }
+    const envelope = raw;
+    if ('success' in envelope && 'data' in envelope) {
+        if (envelope.success === false)
+            return {};
+        return normalizePreviewDraftData(envelope.data);
+    }
+    const draft = raw;
+    return {
+        themeId: typeof draft.themeId === 'string' ? draft.themeId : undefined,
+        mods: draft.mods,
+        configuration: draft.configuration,
+    };
+}
+/** Load short-lived customizer preview payload (public GET by token). */
+async function fetchPreviewDraft(token, options) {
+    const trimmed = token.trim();
+    if (!trimmed)
+        return {};
+    if (options?.fetcher) {
+        return normalizePreviewDraftData(await options.fetcher(trimmed));
+    }
+    const base = (options?.baseURL ?? (0, api_1.resolveThemeApiBaseUrl)()).replace(/\/$/, '');
+    try {
+        const { data } = await axios_1.default.get(`${base}${previewDraftApiPath(trimmed)}`, {
+            timeout: 60000,
+        });
+        return normalizePreviewDraftData(data);
+    }
+    catch {
+        return {};
+    }
+}
+/**
+ * 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.
+ */
+async function resolveThemePreviewContext(input) {
+    const locale = input.locale ?? 'zh';
+    const themeState = (0, theme_1.getThemeStateFromGlobalSetting)(input.globalSettingRaw);
+    const previewToken = input.ctx ? (0, preview_draft_1.parsePreviewTokenFromNextCtx)(input.ctx) : '';
+    let draft = null;
+    if (previewToken) {
+        draft = await fetchPreviewDraft(previewToken, {
+            baseURL: input.apiBaseURL,
+            fetcher: input.fetchDraft,
+        });
+    }
+    const previewConfig = draft?.configuration ?? {};
+    const previewMods = draft?.mods ?? {};
+    const configThemeId = draft?.themeId ?? themeState.activeTheme;
+    const siteConfig = (0, resolve_1.resolveSiteConfig)(input.globalSettingRaw, configThemeId, locale, input.manifest, Object.keys(previewConfig).length > 0 ? previewConfig : undefined);
+    const savedMods = themeState.mods[configThemeId] ?? {};
+    const effectiveMods = (0, preview_mods_1.mergePreviewMods)(savedMods, previewMods);
+    const setting = (0, theme_1.applyThemeModsToSiteSetting)(input.setting, effectiveMods);
+    const colorPrimary = (0, theme_1.appearancePrimaryColor)(effectiveMods);
+    return {
+        siteConfig,
+        setting,
+        colorPrimary,
+        effectiveMods,
+        configThemeId,
+        isPreview: Boolean(previewToken),
+        draft,
+    };
+}

package/toolkit/dist/extension/site-notices.js

@@ -0,0 +1,88 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseSiteNotices = parseSiteNotices;
+exports.serializeSiteNotices = serializeSiteNotices;
+exports.siteNoticeDisplayLines = siteNoticeDisplayLines;
+exports.createEmptySiteNotice = createEmptySiteNotice;
+exports.siteNoticeModInheritsSystem = siteNoticeModInheritsSystem;
+function newNoticeId() {
+    if (typeof crypto !== 'undefined' && crypto.randomUUID) {
+        return crypto.randomUUID();
+    }
+    return `notice-${Date.now()}-${Math.random().toString(36).slice(2, 9)}`;
+}
+function normalizeItem(raw, index) {
+    if (typeof raw === 'string') {
+        const content = raw.trim();
+        if (!content)
+            return null;
+        return { id: `legacy-${index}`, content, enabled: true };
+    }
+    if (!raw || typeof raw !== 'object')
+        return null;
+    const o = raw;
+    const content = typeof o.content === 'string' ? o.content : typeof o.text === 'string' ? o.text : '';
+    if (!content.trim())
+        return null;
+    const id = typeof o.id === 'string' && o.id.trim() ? o.id.trim() : newNoticeId();
+    const enabled = o.enabled === false ? false : true;
+    return { id, content, enabled };
+}
+/**
+ * Parse `systemNoticeInfo` from DB / API.
+ * Supports JSON array, legacy newline-separated text, or plain string.
+ */
+function parseSiteNotices(raw) {
+    if (raw == null)
+        return [];
+    if (Array.isArray(raw)) {
+        return raw.map((item, i) => normalizeItem(item, i)).filter((x) => x != null);
+    }
+    const text = String(raw).trim();
+    if (!text)
+        return [];
+    if (text.startsWith('[')) {
+        try {
+            const parsed = JSON.parse(text);
+            if (Array.isArray(parsed)) {
+                return parsed.map((item, i) => normalizeItem(item, i)).filter((x) => x != null);
+            }
+        }
+        catch {
+            /* fall through */
+        }
+    }
+    return text
+        .split(/\r?\n/)
+        .map((line) => line.trim())
+        .filter(Boolean)
+        .map((content, i) => ({ id: `legacy-${i}`, content, enabled: true }));
+}
+/** Persist notices for `Setting.systemNoticeInfo`. */
+function serializeSiteNotices(items) {
+    const cleaned = items
+        .map((item) => ({
+        id: item.id?.trim() || newNoticeId(),
+        content: item.content?.trim() ?? '',
+        enabled: item.enabled !== false,
+    }))
+        .filter((item) => item.content.length > 0);
+    return JSON.stringify(cleaned);
+}
+/** Ordered notice HTML/text lines for the visitor banner (enabled only). */
+function siteNoticeDisplayLines(raw) {
+    return parseSiteNotices(raw)
+        .filter((n) => n.enabled !== false)
+        .map((n) => n.content);
+}
+function createEmptySiteNotice() {
+    return { id: newNoticeId(), content: '', enabled: true };
+}
+/** Whether theme mod `siteNotice` is empty or identical to system `systemNoticeInfo`. */
+function siteNoticeModInheritsSystem(modRaw, systemRaw) {
+    if (!modRaw?.trim())
+        return true;
+    const modSerialized = serializeSiteNotices(parseSiteNotices(modRaw));
+    const sysSerialized = serializeSiteNotices(parseSiteNotices(systemRaw));
+    return modSerialized === sysSerialized;
+}

package/toolkit/dist/extension/site-settings.js

@@ -0,0 +1,144 @@
+"use strict";
+/**
+ * Site-wide vs theme-owned settings.
+ *
+ * - **System settings** (`SYSTEM_SETTING_FIELD_KEYS`): shared defaults (URLs, site identity,
+ *   SEO, i18n, mail). Edited under admin → 设置.
+ * - **Theme mods** (`THEME_BRANDING_*`): per-theme overrides in `globalSetting.theme.mods[themeId]`.
+ *   Empty mod → inherit the matching system setting at runtime.
+ * - **Theme-only** (footer / 关于我们): appearance only, no system setting column.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.PUBLIC_SETTING_KEYS = exports.LEGACY_APPEARANCE_SETTING_KEYS = exports.SYSTEM_SETTING_FIELD_KEYS = exports.THEME_ONLY_APPEARANCE_KEYS = exports.SEO_DEFAULT_SETTING_KEYS = exports.SITE_DEFAULT_SETTING_KEYS = exports.THEME_BRANDING_MOD_TO_SETTING = exports.THEME_BRANDING_DIRECT_MODS = exports.seedThemeModsFromLegacySetting = exports.applyThemeModsToSiteSetting = void 0;
+exports.migrateLegacyAppearanceToThemeMods = migrateLegacyAppearanceToThemeMods;
+exports.pickSystemSettingPatch = pickSystemSettingPatch;
+exports.resolveEffectiveSettingRow = resolveEffectiveSettingRow;
+exports.buildPublicSettingView = buildPublicSettingView;
+const branding_mods_1 = require("./branding-mods");
+const theme_1 = require("./theme");
+var branding_mods_2 = require("./branding-mods");
+Object.defineProperty(exports, "applyThemeModsToSiteSetting", { enumerable: true, get: function () { return branding_mods_2.applyThemeModsToSiteSetting; } });
+Object.defineProperty(exports, "seedThemeModsFromLegacySetting", { enumerable: true, get: function () { return branding_mods_2.seedThemeModsFromLegacySetting; } });
+Object.defineProperty(exports, "THEME_BRANDING_DIRECT_MODS", { enumerable: true, get: function () { return branding_mods_2.THEME_BRANDING_DIRECT_MODS; } });
+Object.defineProperty(exports, "THEME_BRANDING_MOD_TO_SETTING", { enumerable: true, get: function () { return branding_mods_2.THEME_BRANDING_MOD_TO_SETTING; } });
+/** Site identity defaults (admin → 设置 → 常规). Themes may override via customizer mods. */
+exports.SITE_DEFAULT_SETTING_KEYS = [
+    'systemTitle',
+    'systemSubTitle',
+    'systemLogo',
+    'systemFavicon',
+    'systemNoticeInfo',
+];
+/** SEO defaults (admin → 设置 → SEO). Themes may override via customizer mods. */
+exports.SEO_DEFAULT_SETTING_KEYS = [
+    'seoKeyword',
+    'seoDesc',
+    'baiduAnalyticsId',
+    'googleAnalyticsId',
+];
+/** Theme-only appearance (no system setting column). */
+exports.THEME_ONLY_APPEARANCE_KEYS = [
+    'systemFooterInfo',
+    'aboutUsGithubUrl',
+    'aboutUsCommentQr',
+    'aboutUsWechatQr',
+];
+/** DB columns managed as system configuration (admin → 设置). */
+exports.SYSTEM_SETTING_FIELD_KEYS = [
+    'i18n',
+    'systemUrl',
+    'adminSystemUrl',
+    ...exports.SITE_DEFAULT_SETTING_KEYS,
+    ...exports.SEO_DEFAULT_SETTING_KEYS,
+    'smtpHost',
+    'smtpPort',
+    'smtpUser',
+    'smtpPass',
+    'smtpFromUser',
+];
+/** @deprecated Use SITE_DEFAULT_SETTING_KEYS + SEO_DEFAULT_SETTING_KEYS */
+exports.LEGACY_APPEARANCE_SETTING_KEYS = [
+    ...exports.SITE_DEFAULT_SETTING_KEYS,
+    ...exports.SEO_DEFAULT_SETTING_KEYS,
+    ...exports.THEME_ONLY_APPEARANCE_KEYS,
+];
+/** Keys exposed to anonymous theme `setting/get` (plus computed appearance overlay). */
+exports.PUBLIC_SETTING_KEYS = [
+    'i18n',
+    'systemUrl',
+    'adminSystemUrl',
+    'globalSetting',
+    ...exports.LEGACY_APPEARANCE_SETTING_KEYS,
+];
+function modHasValue(mods, modId) {
+    const v = mods[modId];
+    return v != null && String(v).trim() !== '';
+}
+/** Copy legacy appearance columns into theme mods when mods are empty. */
+function migrateLegacyAppearanceToThemeMods(globalRaw, settingRow) {
+    const base = globalRaw && typeof globalRaw === 'object'
+        ? { ...globalRaw }
+        : {};
+    const themeState = (0, theme_1.getThemeStateFromGlobalSetting)(base);
+    const themeIds = new Set([
+        themeState.activeTheme,
+        ...themeState.installedThemes,
+    ]);
+    const mods = themeState.mods && typeof themeState.mods === 'object'
+        ? { ...themeState.mods }
+        : {};
+    let changed = false;
+    for (const themeId of themeIds) {
+        if (!themeId)
+            continue;
+        const current = mods[themeId] ?? {};
+        const seeded = (0, branding_mods_1.seedThemeModsFromLegacySetting)(settingRow, current);
+        const currentHasValues = Object.keys(current).some((k) => modHasValue(current, k));
+        const seededHasValues = Object.keys(seeded).some((k) => modHasValue(seeded, k));
+        if (!currentHasValues && seededHasValues) {
+            mods[themeId] = seeded;
+            changed = true;
+        }
+    }
+    if (!changed) {
+        return { global: base, changed: false };
+    }
+    const next = { ...themeState, mods };
+    return { global: { ...base, theme: next }, changed: true };
+}
+/** Strip non-system fields from admin PATCH payloads. */
+function pickSystemSettingPatch(patch) {
+    const out = {};
+    for (const key of exports.SYSTEM_SETTING_FIELD_KEYS) {
+        if (key in patch)
+            out[key] = patch[key];
+    }
+    return out;
+}
+/** Overlay active theme mods onto a Setting row for runtime (themes, mail templates). */
+function resolveEffectiveSettingRow(row, globalRaw, themeId) {
+    const gs = globalRaw ?? row.globalSetting;
+    const themeState = (0, theme_1.getThemeStateFromGlobalSetting)(typeof gs === 'string'
+        ? (() => {
+            try {
+                return JSON.parse(gs);
+            }
+            catch {
+                return {};
+            }
+        })()
+        : gs);
+    const id = themeId ?? themeState.activeTheme;
+    const mods = themeState.mods[id] ?? {};
+    return (0, branding_mods_1.applyThemeModsToSiteSetting)(row, mods);
+}
+/** Public API view: system keys + branding overlay + globalSetting. */
+function buildPublicSettingView(row) {
+    const effective = resolveEffectiveSettingRow(row);
+    const out = {};
+    for (const key of exports.PUBLIC_SETTING_KEYS) {
+        if (effective[key] !== undefined)
+            out[key] = effective[key];
+    }
+    return out;
+}

package/toolkit/dist/extension/theme-admin-locale.io.js

@@ -0,0 +1,54 @@
+"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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readThemeAdminLocaleFile = readThemeAdminLocaleFile;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const theme_admin_locale_1 = require("./theme-admin-locale");
+function readThemeAdminLocaleFile(themeDir, locale) {
+    const safeLocale = /^[a-z]{2}(?:-[a-z]{2})?$/i.test(locale) ? locale : 'en';
+    const filePath = path.join(themeDir, theme_admin_locale_1.THEME_LOCALE_DIR, `${safeLocale}.json`);
+    if (!fs.existsSync(filePath))
+        return null;
+    try {
+        const raw = JSON.parse(fs.readFileSync(filePath, 'utf8'));
+        return raw && typeof raw === 'object' && !Array.isArray(raw)
+            ? raw
+            : null;
+    }
+    catch {
+        return null;
+    }
+}

package/toolkit/dist/extension/theme-admin-locale.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.THEME_LOCALE_DIR = void 0;
+exports.getNestedLocaleValue = getNestedLocaleValue;
+exports.getNestedLocaleString = getNestedLocaleString;
+exports.resolveThemeAdminLocaleText = resolveThemeAdminLocaleText;
+exports.resolveThemeAdminLocaleTags = resolveThemeAdminLocaleTags;
+exports.localizeThemeConfigurationSchemaWithLocale = localizeThemeConfigurationSchemaWithLocale;
+exports.THEME_LOCALE_DIR = 'locales';
+function getNestedLocaleValue(obj, dotPath) {
+    const parts = dotPath.split('.').filter(Boolean);
+    let cur = obj;
+    for (const part of parts) {
+        if (!cur || typeof cur !== 'object')
+            return undefined;
+        cur = cur[part];
+    }
+    return cur;
+}
+function getNestedLocaleString(obj, dotPath) {
+    const value = getNestedLocaleValue(obj, dotPath);
+    return typeof value === 'string' && value.trim() ? value : undefined;
+}
+/** Resolve admin copy from theme locale bundle; falls back to manifest text. */
+function resolveThemeAdminLocaleText(messages, dotPath, fallback) {
+    const fromLocale = messages ? getNestedLocaleString(messages, dotPath) : undefined;
+    if (fromLocale)
+        return fromLocale;
+    return fallback?.trim() ?? '';
+}
+function resolveThemeAdminLocaleTags(messages, fallback) {
+    const raw = messages ? getNestedLocaleValue(messages, 'meta.tags') : undefined;
+    if (Array.isArray(raw) && raw.every((item) => typeof item === 'string')) {
+        return raw;
+    }
+    return fallback ?? [];
+}
+function localizeSchemaField(field, pathParts, resolve) {
+    if (typeof field.title === 'string') {
+        field.title = resolve([...pathParts, 'title'].join('.'), field.title);
+    }
+    if (typeof field.description === 'string') {
+        field.description = resolve([...pathParts, 'description'].join('.'), field.description);
+    }
+    if (field.properties) {
+        for (const [key, child] of Object.entries(field.properties)) {
+            localizeSchemaField(child, [...pathParts, key], resolve);
+        }
+    }
+    const items = field.items;
+    if (items && typeof items === 'object' && !Array.isArray(items)) {
+        const itemSchema = items;
+        if (itemSchema.properties) {
+            for (const [key, child] of Object.entries(itemSchema.properties)) {
+                localizeSchemaField(child, [...pathParts, 'items', key], resolve);
+            }
+        }
+        else {
+            localizeSchemaField(itemSchema, [...pathParts, 'items'], resolve);
+        }
+    }
+}
+/** Apply theme admin locale messages to options JSON Schema titles/descriptions. */
+function localizeThemeConfigurationSchemaWithLocale(schema, messages) {
+    if (!schema)
+        return null;
+    const out = structuredClone(schema);
+    const resolve = (dotPath, fallback) => resolveThemeAdminLocaleText(messages, `options.${dotPath}`, fallback);
+    if (typeof out.title === 'string') {
+        out.title = resolve('title', out.title);
+    }
+    if (typeof out.description === 'string') {
+        out.description = resolve('description', out.description);
+    }
+    if (out.properties) {
+        for (const [key, field] of Object.entries(out.properties)) {
+            localizeSchemaField(field, [key], resolve);
+        }
+    }
+    return out;
+}