@fecommunity/reactpress-toolkit 3.0.4 → 3.7.0

package/dist/theme/ssr/templates.d.ts

@@ -0,0 +1,35 @@
+/**
+ * WordPress-style template hierarchy → Next.js Pages Router paths.
+ * @see https://developer.wordpress.org/themes/basics/template-hierarchy/
+ */
+export declare const ThemeTemplate: {
+    /** Site front page / blog index */
+    readonly HOME: "home";
+    /** Single post */
+    readonly SINGLE: "single";
+    /** Static page */
+    readonly PAGE: "page";
+    /** Category archive */
+    readonly ARCHIVE_CATEGORY: "archive-category";
+    /** Tag archive */
+    readonly ARCHIVE_TAG: "archive-tag";
+    /** Search results */
+    readonly SEARCH: "search";
+    /** Post archives by date */
+    readonly ARCHIVES: "archives";
+    /** Knowledge base index */
+    readonly KNOWLEDGE: "knowledge";
+    /** URL navigation hub */
+    readonly NAV: "nav";
+    /** Login page */
+    readonly LOGIN: "login";
+    /** 404 */
+    readonly NOT_FOUND: "404";
+};
+export type ThemeTemplateSlug = (typeof ThemeTemplate)[keyof typeof ThemeTemplate];
+/** Default file mapping (override in `theme.json` → `templates`). */
+export declare const DEFAULT_TEMPLATE_FILES: Record<ThemeTemplateSlug, string>;
+export interface ThemeManifestLike {
+    templates?: Partial<Record<string, string>>;
+}
+export declare function resolveTemplateFiles(manifest?: ThemeManifestLike | null): Record<ThemeTemplateSlug, string>;

package/dist/theme/ssr/templates.js

@@ -0,0 +1,50 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_TEMPLATE_FILES = exports.ThemeTemplate = void 0;
+exports.resolveTemplateFiles = resolveTemplateFiles;
+/**
+ * WordPress-style template hierarchy → Next.js Pages Router paths.
+ * @see https://developer.wordpress.org/themes/basics/template-hierarchy/
+ */
+exports.ThemeTemplate = {
+    /** Site front page / blog index */
+    HOME: 'home',
+    /** Single post */
+    SINGLE: 'single',
+    /** Static page */
+    PAGE: 'page',
+    /** Category archive */
+    ARCHIVE_CATEGORY: 'archive-category',
+    /** Tag archive */
+    ARCHIVE_TAG: 'archive-tag',
+    /** Search results */
+    SEARCH: 'search',
+    /** Post archives by date */
+    ARCHIVES: 'archives',
+    /** Knowledge base index */
+    KNOWLEDGE: 'knowledge',
+    /** URL navigation hub */
+    NAV: 'nav',
+    /** Login page */
+    LOGIN: 'login',
+    /** 404 */
+    NOT_FOUND: '404',
+};
+/** Default file mapping (override in `theme.json` → `templates`). */
+exports.DEFAULT_TEMPLATE_FILES = {
+    [exports.ThemeTemplate.HOME]: 'pages/index.tsx',
+    [exports.ThemeTemplate.SINGLE]: 'pages/article/[id].tsx',
+    [exports.ThemeTemplate.PAGE]: 'pages/about.tsx',
+    [exports.ThemeTemplate.ARCHIVE_CATEGORY]: 'pages/category/[category].tsx',
+    [exports.ThemeTemplate.ARCHIVE_TAG]: 'pages/tag/[tag].tsx',
+    [exports.ThemeTemplate.SEARCH]: 'pages/search.tsx',
+    [exports.ThemeTemplate.ARCHIVES]: 'pages/archives/index.tsx',
+    [exports.ThemeTemplate.KNOWLEDGE]: 'pages/knowledge/index.tsx',
+    [exports.ThemeTemplate.NAV]: 'pages/nav/index.tsx',
+    [exports.ThemeTemplate.LOGIN]: 'pages/login/index.tsx',
+    [exports.ThemeTemplate.NOT_FOUND]: 'pages/404.tsx',
+};
+function resolveTemplateFiles(manifest) {
+    const custom = manifest?.templates ?? {};
+    return { ...exports.DEFAULT_TEMPLATE_FILES, ...custom };
+}

package/dist/theme/static.d.ts

@@ -0,0 +1,10 @@
+import type { GetStaticPathsResult } from 'next';
+/** WordPress-style on-demand ISR paths (`fallback: true`). */
+export declare const themeOnDemandPaths: GetStaticPathsResult;
+export declare function themeNotFound(): {
+    notFound: true;
+};
+export declare function themeStaticNotFound(revalidate?: number): {
+    notFound: true;
+    revalidate: number;
+};

package/dist/theme/static.js

@@ -0,0 +1,17 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.themeOnDemandPaths = void 0;
+exports.themeNotFound = themeNotFound;
+exports.themeStaticNotFound = themeStaticNotFound;
+const fetch_1 = require("./fetch");
+/** WordPress-style on-demand ISR paths (`fallback: true`). */
+exports.themeOnDemandPaths = {
+    paths: [],
+    fallback: true,
+};
+function themeNotFound() {
+    return { notFound: true };
+}
+function themeStaticNotFound(revalidate = fetch_1.THEME_ISR_REVALIDATE_SECONDS) {
+    return { notFound: true, revalidate };
+}

package/dist/theme/templates.d.ts

@@ -0,0 +1,27 @@
+/**
+ * WordPress-style template hierarchy → Next.js Pages Router paths.
+ * @see https://developer.wordpress.org/themes/basics/template-hierarchy/
+ */
+export declare const ThemeTemplate: {
+    /** Site front page / blog index */
+    readonly HOME: "home";
+    /** Single post */
+    readonly SINGLE: "single";
+    /** Static page */
+    readonly PAGE: "page";
+    /** Category archive */
+    readonly ARCHIVE_CATEGORY: "archive-category";
+    /** Tag archive */
+    readonly ARCHIVE_TAG: "archive-tag";
+    /** Search results */
+    readonly SEARCH: "search";
+    /** 404 */
+    readonly NOT_FOUND: "404";
+};
+export type ThemeTemplateSlug = (typeof ThemeTemplate)[keyof typeof ThemeTemplate];
+/** Default file mapping (override in `theme.json` → `templates`). */
+export declare const DEFAULT_TEMPLATE_FILES: Record<ThemeTemplateSlug, string>;
+export interface ThemeManifestLike {
+    templates?: Partial<Record<string, string>>;
+}
+export declare function resolveTemplateFiles(manifest?: ThemeManifestLike | null): Record<ThemeTemplateSlug, string>;

package/dist/theme/templates.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_TEMPLATE_FILES = exports.ThemeTemplate = void 0;
+exports.resolveTemplateFiles = resolveTemplateFiles;
+/**
+ * WordPress-style template hierarchy → Next.js Pages Router paths.
+ * @see https://developer.wordpress.org/themes/basics/template-hierarchy/
+ */
+exports.ThemeTemplate = {
+    /** Site front page / blog index */
+    HOME: 'home',
+    /** Single post */
+    SINGLE: 'single',
+    /** Static page */
+    PAGE: 'page',
+    /** Category archive */
+    ARCHIVE_CATEGORY: 'archive-category',
+    /** Tag archive */
+    ARCHIVE_TAG: 'archive-tag',
+    /** Search results */
+    SEARCH: 'search',
+    /** 404 */
+    NOT_FOUND: '404',
+};
+/** Default file mapping (override in `theme.json` → `templates`). */
+exports.DEFAULT_TEMPLATE_FILES = {
+    [exports.ThemeTemplate.HOME]: 'pages/index.tsx',
+    [exports.ThemeTemplate.SINGLE]: 'pages/article/[id].tsx',
+    [exports.ThemeTemplate.PAGE]: 'pages/about.tsx',
+    [exports.ThemeTemplate.ARCHIVE_CATEGORY]: 'pages/category/[category].tsx',
+    [exports.ThemeTemplate.ARCHIVE_TAG]: 'pages/tag/[tag].tsx',
+    [exports.ThemeTemplate.SEARCH]: 'pages/search.tsx',
+    [exports.ThemeTemplate.NOT_FOUND]: 'pages/404.tsx',
+};
+function resolveTemplateFiles(manifest) {
+    const custom = manifest?.templates ?? {};
+    return { ...exports.DEFAULT_TEMPLATE_FILES, ...custom };
+}

package/dist/theme/ui-optional.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/theme/ui-optional.js

@@ -0,0 +1,21 @@
+'use strict';
+/**
+ * Lazy UI exports with optional theme peer deps (nprogress, highlight.js, viewerjs).
+ * Kept out of ui/index + theme bulk re-exports so minimal themes do not webpack-load them.
+ */
+function lazyExport(name, loader) {
+    Object.defineProperty(exports, name, {
+        enumerable: true,
+        get() {
+            return loader()[name];
+        },
+    });
+}
+lazyExport('RouteProgress', () => require('../ui/components/RouteProgress'));
+const loadContent = () => require('../ui/components/content');
+lazyExport('ArticleReader', loadContent);
+lazyExport('ArticleToc', loadContent);
+lazyExport('HtmlContent', loadContent);
+lazyExport('ImageViewer', loadContent);
+lazyExport('LocaleTime', loadContent);
+lazyExport('parseArticleToc', loadContent);

package/dist/theme/visitor/appearance.d.ts

@@ -0,0 +1,4 @@
+import type { ThemeManifest } from '../extension/theme';
+import type { ThemeMods } from '../extension/theme';
+/** Build default theme_mod values from `theme.json` → `appearance.sections`. */
+export declare function defaultModsFromManifest(manifest: ThemeManifest | null | undefined): ThemeMods;

package/dist/theme/visitor/appearance.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.defaultModsFromManifest = defaultModsFromManifest;
+/** Build default theme_mod values from `theme.json` → `appearance.sections`. */
+function defaultModsFromManifest(manifest) {
+    const mods = {};
+    const sections = manifest?.appearance?.sections ?? [];
+    for (const section of sections) {
+        for (const setting of section.settings ?? []) {
+            if (setting.id && setting.default != null) {
+                mods[setting.id] = String(setting.default);
+            }
+        }
+    }
+    return mods;
+}

package/dist/theme/visitor/authSession.d.ts

@@ -0,0 +1,16 @@
+/** Zustand persist key used by the ReactPress admin (`web/src/stores/auth.ts`). */
+export declare const ADMIN_AUTH_STORAGE_KEY = "auth-storage";
+export declare const THEME_TOKEN_STORAGE_KEY = "token";
+export declare const THEME_USER_STORAGE_KEY = "user";
+export interface ThemeSessionUser {
+    name: string;
+    email: string;
+    avatar?: string;
+    token: string;
+    role?: string;
+}
+export declare function getStoredAccessToken(): string | null;
+/** Resolve theme user from theme storage, or fall back to admin `auth-storage`. */
+export declare function resolveStoredUser(): ThemeSessionUser | null;
+export declare function persistThemeSession(user: ThemeSessionUser): void;
+export declare function clearThemeSession(): void;

package/dist/theme/visitor/authSession.js

@@ -0,0 +1,92 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.THEME_USER_STORAGE_KEY = exports.THEME_TOKEN_STORAGE_KEY = exports.ADMIN_AUTH_STORAGE_KEY = void 0;
+exports.getStoredAccessToken = getStoredAccessToken;
+exports.resolveStoredUser = resolveStoredUser;
+exports.persistThemeSession = persistThemeSession;
+exports.clearThemeSession = clearThemeSession;
+const json_1 = require("../api/json");
+/** Zustand persist key used by the ReactPress admin (`web/src/stores/auth.ts`). */
+exports.ADMIN_AUTH_STORAGE_KEY = 'auth-storage';
+exports.THEME_TOKEN_STORAGE_KEY = 'token';
+exports.THEME_USER_STORAGE_KEY = 'user';
+function getStoredAccessToken() {
+    if (typeof window === 'undefined')
+        return null;
+    const themeToken = window.localStorage.getItem(exports.THEME_TOKEN_STORAGE_KEY);
+    if (themeToken)
+        return themeToken;
+    try {
+        const raw = window.localStorage.getItem(exports.ADMIN_AUTH_STORAGE_KEY);
+        if (!raw)
+            return null;
+        const parsed = JSON.parse(raw);
+        return parsed.state?.tokens?.accessToken ?? null;
+    }
+    catch {
+        return null;
+    }
+}
+function mapAdminUserToThemeUser(adminUser, token) {
+    if (!adminUser || !token)
+        return null;
+    const name = (adminUser.username || adminUser.name || '').trim();
+    if (!name)
+        return null;
+    return {
+        name,
+        email: adminUser.email ?? '',
+        avatar: adminUser.avatar ?? '',
+        token,
+    };
+}
+/** Resolve theme user from theme storage, or fall back to admin `auth-storage`. */
+function resolveStoredUser() {
+    if (typeof window === 'undefined')
+        return null;
+    const userStr = window.localStorage.getItem(exports.THEME_USER_STORAGE_KEY);
+    if (userStr) {
+        const parsed = (0, json_1.safeJsonParse)(userStr, {});
+        if (parsed?.name) {
+            const token = getStoredAccessToken();
+            return {
+                name: parsed.name,
+                email: parsed.email ?? '',
+                avatar: parsed.avatar ?? '',
+                token: parsed.token ?? token ?? '',
+                role: parsed.role,
+            };
+        }
+    }
+    try {
+        const raw = window.localStorage.getItem(exports.ADMIN_AUTH_STORAGE_KEY);
+        if (!raw)
+            return null;
+        const parsed = JSON.parse(raw);
+        const { state } = parsed;
+        if (!state?.isAuthenticated)
+            return null;
+        const token = state.tokens?.accessToken;
+        if (!token)
+            return null;
+        return mapAdminUserToThemeUser(state.user, token);
+    }
+    catch {
+        return null;
+    }
+}
+function persistThemeSession(user) {
+    if (typeof window === 'undefined')
+        return;
+    if (user.token) {
+        window.localStorage.setItem(exports.THEME_TOKEN_STORAGE_KEY, user.token);
+    }
+    window.localStorage.setItem(exports.THEME_USER_STORAGE_KEY, JSON.stringify(user));
+}
+function clearThemeSession() {
+    if (typeof window === 'undefined')
+        return;
+    window.localStorage.removeItem(exports.THEME_USER_STORAGE_KEY);
+    window.localStorage.removeItem(exports.THEME_TOKEN_STORAGE_KEY);
+    window.localStorage.removeItem(exports.ADMIN_AUTH_STORAGE_KEY);
+}

package/dist/theme/visitor/colorMode.d.ts

@@ -0,0 +1,17 @@
+export declare const COLOR_MODE_STORAGE_KEY = "dark";
+export type ThemeColorMode = 'dark' | 'light';
+export declare function resolvePreferredColorMode(): boolean;
+export declare function applyColorModeClass(isDark: boolean, className?: string): void;
+export declare function persistColorMode(isDark: boolean): void;
+export declare function resolveInitialColorModeState(): ThemeColorMode | null;
+/**
+ * Theme mode for the first client render (after `_document` color-mode script).
+ * SSR should use `'light'`; call only in browser or via `typeof window` guard.
+ */
+export declare function resolveClientThemeMode(): ThemeColorMode;
+/** Runs before paint to avoid light-mode flash on first visit. */
+export declare function buildColorModeInitScript(options?: {
+    storageKey?: string;
+    className?: string;
+}): string;
+export declare const colorModeInitScript: string;

package/dist/theme/visitor/colorMode.js

@@ -0,0 +1,59 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.colorModeInitScript = exports.COLOR_MODE_STORAGE_KEY = void 0;
+exports.resolvePreferredColorMode = resolvePreferredColorMode;
+exports.applyColorModeClass = applyColorModeClass;
+exports.persistColorMode = persistColorMode;
+exports.resolveInitialColorModeState = resolveInitialColorModeState;
+exports.resolveClientThemeMode = resolveClientThemeMode;
+exports.buildColorModeInitScript = buildColorModeInitScript;
+exports.COLOR_MODE_STORAGE_KEY = 'dark';
+function resolvePreferredColorMode() {
+    if (typeof window === 'undefined') {
+        return false;
+    }
+    const storageTheme = window.localStorage.getItem(exports.COLOR_MODE_STORAGE_KEY);
+    if (storageTheme != null) {
+        return storageTheme === '1';
+    }
+    return window.matchMedia?.('(prefers-color-scheme: dark)').matches ?? false;
+}
+function applyColorModeClass(isDark, className = 'dark') {
+    if (typeof document === 'undefined') {
+        return;
+    }
+    document.body.classList.toggle(className, isDark);
+    document.documentElement.style.colorScheme = isDark ? 'dark' : 'light';
+}
+function persistColorMode(isDark) {
+    if (typeof window === 'undefined') {
+        return;
+    }
+    window.localStorage.setItem(exports.COLOR_MODE_STORAGE_KEY, isDark ? '1' : '-1');
+}
+function resolveInitialColorModeState() {
+    if (typeof window === 'undefined') {
+        return null;
+    }
+    return resolvePreferredColorMode() ? 'dark' : 'light';
+}
+/**
+ * Theme mode for the first client render (after `_document` color-mode script).
+ * SSR should use `'light'`; call only in browser or via `typeof window` guard.
+ */
+function resolveClientThemeMode() {
+    if (typeof window === 'undefined') {
+        return 'light';
+    }
+    if (document.body.classList.contains('dark')) {
+        return 'dark';
+    }
+    return resolveInitialColorModeState() ?? 'light';
+}
+/** Runs before paint to avoid light-mode flash on first visit. */
+function buildColorModeInitScript(options = {}) {
+    const storageKey = options.storageKey ?? exports.COLOR_MODE_STORAGE_KEY;
+    const className = options.className ?? 'dark';
+    return `(function(){try{var k='${storageKey}';var s=localStorage.getItem(k);var d=s==='1'||(s==null&&window.matchMedia('(prefers-color-scheme: dark)').matches);if(d){document.documentElement.style.colorScheme='dark';document.body.classList.add('${className}');}else{document.documentElement.style.colorScheme='light';}}catch(e){}})();`;
+}
+exports.colorModeInitScript = buildColorModeInitScript();

package/dist/theme/visitor/commentAuthor.d.ts

@@ -0,0 +1,16 @@
+import { COMMENT_EMAIL_REGEXP, isValidCommentEmail } from '../../utils/email';
+export declare const COMMENT_AUTHOR_STORAGE_KEY = "reactpress-comment-author";
+export type CommentAuthor = {
+    name: string;
+    email: string;
+};
+export { COMMENT_EMAIL_REGEXP, isValidCommentEmail };
+export declare function isValidCommentAuthor(author: Partial<CommentAuthor> | null | undefined): author is CommentAuthor;
+export declare function getCommentEmailError(email: string | undefined | null, messages: {
+    required: string;
+    invalid: string;
+}, options?: {
+    touched?: boolean;
+}): string;
+export declare function readCommentAuthor(): CommentAuthor | null;
+export declare function persistCommentAuthor(author: CommentAuthor): void;

package/dist/theme/visitor/commentAuthor.js

@@ -0,0 +1,45 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isValidCommentEmail = exports.COMMENT_EMAIL_REGEXP = exports.COMMENT_AUTHOR_STORAGE_KEY = void 0;
+exports.isValidCommentAuthor = isValidCommentAuthor;
+exports.getCommentEmailError = getCommentEmailError;
+exports.readCommentAuthor = readCommentAuthor;
+exports.persistCommentAuthor = persistCommentAuthor;
+const email_1 = require("../../utils/email");
+Object.defineProperty(exports, "COMMENT_EMAIL_REGEXP", { enumerable: true, get: function () { return email_1.COMMENT_EMAIL_REGEXP; } });
+Object.defineProperty(exports, "isValidCommentEmail", { enumerable: true, get: function () { return email_1.isValidCommentEmail; } });
+exports.COMMENT_AUTHOR_STORAGE_KEY = 'reactpress-comment-author';
+function isValidCommentAuthor(author) {
+    return Boolean(author?.name?.trim() && (0, email_1.isValidCommentEmail)(author.email));
+}
+function getCommentEmailError(email, messages, options = {}) {
+    const trimmed = email?.trim() ?? '';
+    if (!options.touched)
+        return '';
+    if (!trimmed)
+        return messages.required;
+    if (!(0, email_1.isValidCommentEmail)(trimmed))
+        return messages.invalid;
+    return '';
+}
+function readCommentAuthor() {
+    if (typeof window === 'undefined')
+        return null;
+    try {
+        const raw = window.localStorage.getItem(exports.COMMENT_AUTHOR_STORAGE_KEY);
+        if (!raw)
+            return null;
+        const parsed = JSON.parse(raw);
+        if (!isValidCommentAuthor(parsed))
+            return null;
+        return { name: parsed.name.trim(), email: parsed.email.trim() };
+    }
+    catch {
+        return null;
+    }
+}
+function persistCommentAuthor(author) {
+    if (typeof window === 'undefined')
+        return;
+    window.localStorage.setItem(exports.COMMENT_AUTHOR_STORAGE_KEY, JSON.stringify({ name: author.name.trim(), email: author.email.trim() }));
+}

package/dist/theme/visitor/i18n.d.ts

@@ -0,0 +1,4 @@
+/** Remote CMS i18n may omit newer keys — fill from toolkit defaults. */
+export declare function mergeVisitorI18n(apiI18n: Record<string, unknown>): Record<string, unknown>;
+/** Keep only the active locale in SSR payload; other locales load client-side. */
+export declare function slimVisitorI18nForSsr(i18n: Record<string, unknown>, locale: string): Record<string, unknown>;

package/dist/theme/visitor/i18n.js

@@ -0,0 +1,28 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mergeVisitorI18n = mergeVisitorI18n;
+exports.slimVisitorI18nForSsr = slimVisitorI18nForSsr;
+const object_1 = require("../../utils/object");
+const en_json_1 = __importDefault(require("../../config/locales/en.json"));
+const zh_json_1 = __importDefault(require("../../config/locales/zh.json"));
+const BUILTIN_VISITOR_LOCALES = {
+    en: en_json_1.default,
+    zh: zh_json_1.default,
+};
+/** Remote CMS i18n may omit newer keys — fill from toolkit defaults. */
+function mergeVisitorI18n(apiI18n) {
+    const merged = { ...apiI18n };
+    for (const [locale, defaults] of Object.entries(BUILTIN_VISITOR_LOCALES)) {
+        const fromApi = apiI18n[locale] || {};
+        merged[locale] = (0, object_1.deepMerge)((0, object_1.deepMerge)({}, defaults), fromApi);
+    }
+    return merged;
+}
+/** Keep only the active locale in SSR payload; other locales load client-side. */
+function slimVisitorI18nForSsr(i18n, locale) {
+    const messages = i18n[locale];
+    return messages && typeof messages === 'object' ? { [locale]: messages } : {};
+}

package/dist/theme/visitor/locale.d.ts

@@ -0,0 +1,23 @@
+export type LocaleMessages = Record<string, string>;
+export type LocaleCatalog = Record<string, LocaleMessages>;
+export interface SiteLocaleState {
+    locale: string;
+    locales: string[];
+    messages: LocaleMessages;
+    /** Full `{ zh: {...}, en: {...} }` catalog when available. */
+    catalog: LocaleCatalog;
+}
+export interface ParseSiteLocaleOptions {
+    locale?: string;
+    fallbackLocale?: string;
+    /** Cookie / query hint (checked before fallback). */
+    preferredLocale?: string;
+    acceptLanguage?: string;
+}
+export declare function resolveRequestLocale(supported: string[], options?: {
+    preferred?: string;
+    fallback?: string;
+    acceptLanguage?: string;
+}): string;
+export declare function parseSiteLocale(i18nRaw: unknown, options?: ParseSiteLocaleOptions): SiteLocaleState;
+export declare function createTranslator(messages: LocaleMessages): (key: string, fallback?: string) => string;

package/dist/theme/visitor/locale.js

@@ -0,0 +1,72 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveRequestLocale = resolveRequestLocale;
+exports.parseSiteLocale = parseSiteLocale;
+exports.createTranslator = createTranslator;
+const json_1 = require("../api/json");
+function resolveRequestLocale(supported, options = {}) {
+    const fallback = options.fallback ?? 'zh';
+    const { preferred, acceptLanguage } = options;
+    if (preferred && supported.includes(preferred)) {
+        return preferred;
+    }
+    if (acceptLanguage) {
+        const parts = acceptLanguage.split(',');
+        for (const part of parts) {
+            const tag = part.split(';')[0]?.trim().toLowerCase();
+            if (!tag)
+                continue;
+            if (supported.includes(tag))
+                return tag;
+            const short = tag.split('-')[0];
+            if (short && supported.includes(short))
+                return short;
+        }
+    }
+    if (supported.includes(fallback))
+        return fallback;
+    return supported[0] ?? 'en';
+}
+function parseSiteLocale(i18nRaw, options = {}) {
+    const catalog = (0, json_1.safeJsonParse)(i18nRaw, {});
+    const locales = Object.keys(catalog).filter((key) => catalog[key] && typeof catalog[key] === 'object');
+    const fallbackLocale = options.fallbackLocale ??
+        (locales.includes('zh') ? 'zh' : locales.includes('en') ? 'en' : locales[0] ?? 'en');
+    const locale = resolveRequestLocale(locales.length ? locales : [fallbackLocale], {
+        preferred: options.locale ?? options.preferredLocale,
+        acceptLanguage: options.acceptLanguage,
+        fallback: fallbackLocale,
+    });
+    const messages = { ...(catalog[locale] ?? {}) };
+    return {
+        locale,
+        locales: locales.length ? locales : [locale],
+        messages,
+        catalog,
+    };
+}
+function resolveLocaleMessage(messages, key) {
+    const flat = messages[key];
+    if (typeof flat === 'string' && flat !== '') {
+        return flat;
+    }
+    const parts = key.split('.');
+    let current = messages;
+    for (const part of parts) {
+        if (!current || typeof current !== 'object') {
+            return undefined;
+        }
+        current = current[part];
+    }
+    return typeof current === 'string' && current !== '' ? current : undefined;
+}
+function createTranslator(messages) {
+    const lookup = messages;
+    return function t(key, fallback) {
+        const resolved = resolveLocaleMessage(lookup, key);
+        if (resolved != null) {
+            return resolved;
+        }
+        return fallback ?? key;
+    };
+}

package/dist/theme/visitor/runtime.d.ts

@@ -0,0 +1,18 @@
+import type { SiteThemeState, ThemeMods } from '../extension/theme';
+export interface ThemeRuntime {
+    /** Theme package id (from `theme.json` or env). */
+    themeId: string;
+    /** Published active theme on the site. */
+    activeThemeId: string;
+    /** Customizer values for `themeId`. */
+    mods: ThemeMods;
+    /** `previewThemeId` differs from `activeThemeId` in customizer preview. */
+    isPreview: boolean;
+    themeState: SiteThemeState;
+}
+export interface ResolveThemeRuntimeOptions {
+    themeId: string;
+    /** When true (default), use `previewThemeId` from global settings when set. */
+    honorPreview?: boolean;
+}
+export declare function resolveThemeRuntime(globalSettingRaw: unknown, options: ResolveThemeRuntimeOptions): ThemeRuntime;

package/dist/theme/visitor/runtime.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveThemeRuntime = resolveThemeRuntime;
+const theme_1 = require("../extension/theme");
+function resolveThemeRuntime(globalSettingRaw, options) {
+    const themeState = (0, theme_1.getThemeStateFromGlobalSetting)(globalSettingRaw);
+    const activeThemeId = themeState.activeTheme;
+    const previewId = themeState.previewThemeId;
+    const honorPreview = options.honorPreview !== false;
+    const effectiveId = honorPreview && previewId ? previewId : options.themeId || activeThemeId;
+    const isPreview = Boolean(previewId && previewId !== activeThemeId);
+    return {
+        themeId: effectiveId,
+        activeThemeId,
+        mods: themeState.mods[effectiveId] ?? {},
+        isPreview,
+        themeState,
+    };
+}