@fecommunity/reactpress-toolkit 3.0.0 → 3.1.0

package/dist/theme/build/antdDocument.d.ts

@@ -0,0 +1,145 @@
+import { type DocumentContext } from 'next/document';
+import React from 'react';
+export interface CreateAntdThemeDocumentOptions {
+    /** Resolve `<html lang>` from the incoming request. */
+    resolveLocale?: (req: DocumentContext['req']) => string;
+    defaultLocale?: string;
+}
+/**
+ * Factory for Next.js `_document.tsx` with Ant Design CSS-in-JS SSR extraction.
+ */
+export declare function createAntdThemeDocument(options?: CreateAntdThemeDocumentOptions): {
+    new (props: import("next/dist/shared/lib/utils").RenderPageResult & {
+        styles?: React.ReactElement[] | React.ReactFragment | JSX.Element;
+    } & import("next/dist/shared/lib/html-context").HtmlProps & {
+        locale?: string;
+    }): {
+        render(): import("react/jsx-runtime").JSX.Element;
+        context: unknown;
+        setState<K extends never>(state: {} | ((prevState: Readonly<{}>, props: Readonly<import("next/dist/shared/lib/utils").RenderPageResult & {
+            styles?: React.ReactElement[] | React.ReactFragment | JSX.Element;
+        } & import("next/dist/shared/lib/html-context").HtmlProps & {
+            locale?: string;
+        }>) => {} | Pick<{}, K> | null) | Pick<{}, K> | null, callback?: (() => void) | undefined): void;
+        forceUpdate(callback?: (() => void) | undefined): void;
+        readonly props: Readonly<import("next/dist/shared/lib/utils").RenderPageResult & {
+            styles?: React.ReactElement[] | React.ReactFragment | JSX.Element;
+        } & import("next/dist/shared/lib/html-context").HtmlProps & {
+            locale?: string;
+        }>;
+        state: Readonly<{}>;
+        refs: {
+            [key: string]: React.ReactInstance;
+        };
+        componentDidMount?(): void;
+        shouldComponentUpdate?(nextProps: Readonly<import("next/dist/shared/lib/utils").RenderPageResult & {
+            styles?: React.ReactElement[] | React.ReactFragment | JSX.Element;
+        } & import("next/dist/shared/lib/html-context").HtmlProps & {
+            locale?: string;
+        }>, nextState: Readonly<{}>, nextContext: any): boolean;
+        componentWillUnmount?(): void;
+        componentDidCatch?(error: Error, errorInfo: React.ErrorInfo): void;
+        getSnapshotBeforeUpdate?(prevProps: Readonly<import("next/dist/shared/lib/utils").RenderPageResult & {
+            styles?: React.ReactElement[] | React.ReactFragment | JSX.Element;
+        } & import("next/dist/shared/lib/html-context").HtmlProps & {
+            locale?: string;
+        }>, prevState: Readonly<{}>): any;
+        componentDidUpdate?(prevProps: Readonly<import("next/dist/shared/lib/utils").RenderPageResult & {
+            styles?: React.ReactElement[] | React.ReactFragment | JSX.Element;
+        } & import("next/dist/shared/lib/html-context").HtmlProps & {
+            locale?: string;
+        }>, prevState: Readonly<{}>, snapshot?: any): void;
+        componentWillMount?(): void;
+        UNSAFE_componentWillMount?(): void;
+        componentWillReceiveProps?(nextProps: Readonly<import("next/dist/shared/lib/utils").RenderPageResult & {
+            styles?: React.ReactElement[] | React.ReactFragment | JSX.Element;
+        } & import("next/dist/shared/lib/html-context").HtmlProps & {
+            locale?: string;
+        }>, nextContext: any): void;
+        UNSAFE_componentWillReceiveProps?(nextProps: Readonly<import("next/dist/shared/lib/utils").RenderPageResult & {
+            styles?: React.ReactElement[] | React.ReactFragment | JSX.Element;
+        } & import("next/dist/shared/lib/html-context").HtmlProps & {
+            locale?: string;
+        }>, nextContext: any): void;
+        componentWillUpdate?(nextProps: Readonly<import("next/dist/shared/lib/utils").RenderPageResult & {
+            styles?: React.ReactElement[] | React.ReactFragment | JSX.Element;
+        } & import("next/dist/shared/lib/html-context").HtmlProps & {
+            locale?: string;
+        }>, nextState: Readonly<{}>, nextContext: any): void;
+        UNSAFE_componentWillUpdate?(nextProps: Readonly<import("next/dist/shared/lib/utils").RenderPageResult & {
+            styles?: React.ReactElement[] | React.ReactFragment | JSX.Element;
+        } & import("next/dist/shared/lib/html-context").HtmlProps & {
+            locale?: string;
+        }>, nextState: Readonly<{}>, nextContext: any): void;
+    };
+    new (props: import("next/dist/shared/lib/utils").RenderPageResult & {
+        styles?: React.ReactElement[] | React.ReactFragment | JSX.Element;
+    } & import("next/dist/shared/lib/html-context").HtmlProps & {
+        locale?: string;
+    }, context: any): {
+        render(): import("react/jsx-runtime").JSX.Element;
+        context: unknown;
+        setState<K extends never>(state: {} | ((prevState: Readonly<{}>, props: Readonly<import("next/dist/shared/lib/utils").RenderPageResult & {
+            styles?: React.ReactElement[] | React.ReactFragment | JSX.Element;
+        } & import("next/dist/shared/lib/html-context").HtmlProps & {
+            locale?: string;
+        }>) => {} | Pick<{}, K> | null) | Pick<{}, K> | null, callback?: (() => void) | undefined): void;
+        forceUpdate(callback?: (() => void) | undefined): void;
+        readonly props: Readonly<import("next/dist/shared/lib/utils").RenderPageResult & {
+            styles?: React.ReactElement[] | React.ReactFragment | JSX.Element;
+        } & import("next/dist/shared/lib/html-context").HtmlProps & {
+            locale?: string;
+        }>;
+        state: Readonly<{}>;
+        refs: {
+            [key: string]: React.ReactInstance;
+        };
+        componentDidMount?(): void;
+        shouldComponentUpdate?(nextProps: Readonly<import("next/dist/shared/lib/utils").RenderPageResult & {
+            styles?: React.ReactElement[] | React.ReactFragment | JSX.Element;
+        } & import("next/dist/shared/lib/html-context").HtmlProps & {
+            locale?: string;
+        }>, nextState: Readonly<{}>, nextContext: any): boolean;
+        componentWillUnmount?(): void;
+        componentDidCatch?(error: Error, errorInfo: React.ErrorInfo): void;
+        getSnapshotBeforeUpdate?(prevProps: Readonly<import("next/dist/shared/lib/utils").RenderPageResult & {
+            styles?: React.ReactElement[] | React.ReactFragment | JSX.Element;
+        } & import("next/dist/shared/lib/html-context").HtmlProps & {
+            locale?: string;
+        }>, prevState: Readonly<{}>): any;
+        componentDidUpdate?(prevProps: Readonly<import("next/dist/shared/lib/utils").RenderPageResult & {
+            styles?: React.ReactElement[] | React.ReactFragment | JSX.Element;
+        } & import("next/dist/shared/lib/html-context").HtmlProps & {
+            locale?: string;
+        }>, prevState: Readonly<{}>, snapshot?: any): void;
+        componentWillMount?(): void;
+        UNSAFE_componentWillMount?(): void;
+        componentWillReceiveProps?(nextProps: Readonly<import("next/dist/shared/lib/utils").RenderPageResult & {
+            styles?: React.ReactElement[] | React.ReactFragment | JSX.Element;
+        } & import("next/dist/shared/lib/html-context").HtmlProps & {
+            locale?: string;
+        }>, nextContext: any): void;
+        UNSAFE_componentWillReceiveProps?(nextProps: Readonly<import("next/dist/shared/lib/utils").RenderPageResult & {
+            styles?: React.ReactElement[] | React.ReactFragment | JSX.Element;
+        } & import("next/dist/shared/lib/html-context").HtmlProps & {
+            locale?: string;
+        }>, nextContext: any): void;
+        componentWillUpdate?(nextProps: Readonly<import("next/dist/shared/lib/utils").RenderPageResult & {
+            styles?: React.ReactElement[] | React.ReactFragment | JSX.Element;
+        } & import("next/dist/shared/lib/html-context").HtmlProps & {
+            locale?: string;
+        }>, nextState: Readonly<{}>, nextContext: any): void;
+        UNSAFE_componentWillUpdate?(nextProps: Readonly<import("next/dist/shared/lib/utils").RenderPageResult & {
+            styles?: React.ReactElement[] | React.ReactFragment | JSX.Element;
+        } & import("next/dist/shared/lib/html-context").HtmlProps & {
+            locale?: string;
+        }>, nextState: Readonly<{}>, nextContext: any): void;
+    };
+    getInitialProps(ctx: DocumentContext): Promise<{
+        locale: string;
+        styles: import("react/jsx-runtime").JSX.Element;
+        html: string;
+        head?: Array<JSX.Element | null>;
+    }>;
+    contextType?: React.Context<any> | undefined;
+};

package/dist/theme/build/antdDocument.js

@@ -0,0 +1,70 @@
+"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;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAntdThemeDocument = createAntdThemeDocument;
+const jsx_runtime_1 = require("react/jsx-runtime");
+const cssinjs_1 = require("@ant-design/cssinjs");
+const document_1 = __importStar(require("next/document"));
+const react_1 = __importDefault(require("react"));
+/**
+ * Factory for Next.js `_document.tsx` with Ant Design CSS-in-JS SSR extraction.
+ */
+function createAntdThemeDocument(options = {}) {
+    const defaultLocale = options.defaultLocale ?? 'zh';
+    return class AntdThemeDocument extends document_1.default {
+        static async getInitialProps(ctx) {
+            const cache = (0, cssinjs_1.createCache)();
+            const originalRenderPage = ctx.renderPage;
+            ctx.renderPage = () => originalRenderPage({
+                enhanceApp: (App) => (props) => react_1.default.createElement(cssinjs_1.StyleProvider, { cache }, react_1.default.createElement(App, props)),
+            });
+            const initialProps = await document_1.default.getInitialProps(ctx);
+            const style = (0, cssinjs_1.extractStyle)(cache, true);
+            const locale = options.resolveLocale?.(ctx.req) ?? defaultLocale;
+            return {
+                ...initialProps,
+                locale,
+                styles: ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [initialProps.styles, (0, jsx_runtime_1.jsx)("style", { dangerouslySetInnerHTML: { __html: style } })] })),
+            };
+        }
+        render() {
+            const locale = this.props.locale ?? defaultLocale;
+            return ((0, jsx_runtime_1.jsxs)(document_1.Html, { lang: locale, children: [(0, jsx_runtime_1.jsx)(document_1.Head, {}), (0, jsx_runtime_1.jsxs)("body", { children: [(0, jsx_runtime_1.jsx)(document_1.Main, {}), (0, jsx_runtime_1.jsx)(document_1.NextScript, {})] })] }));
+        }
+    };
+}

package/dist/theme/build/next-config.d.ts

@@ -0,0 +1,17 @@
+/** Shared Next.js defaults for ReactPress theme packages (Pages Router). */
+export interface ReactPressNextConfig {
+    reactStrictMode?: boolean;
+    eslint?: {
+        ignoreDuringBuilds?: boolean;
+    };
+    transpilePackages?: string[];
+    webpack?: (config: Record<string, unknown>, context: unknown) => Record<string, unknown>;
+    [key: string]: unknown;
+}
+/** API + admin URLs for Next `env` (read at theme build / dev startup). */
+export declare function resolveThemeNextEnv(): {
+    SERVER_API_URL: string;
+    NEXT_PUBLIC_REACTPRESS_API_URL: string;
+    NEXT_PUBLIC_REACTPRESS_ADMIN_URL: string;
+};
+export declare function createReactPressNextConfig(overrides?: ReactPressNextConfig): ReactPressNextConfig;

package/dist/theme/build/next-config.js

@@ -0,0 +1,100 @@
+"use strict";
+/** Shared Next.js defaults for ReactPress theme packages (Pages Router). */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveThemeNextEnv = resolveThemeNextEnv;
+exports.createReactPressNextConfig = createReactPressNextConfig;
+const path_1 = __importDefault(require("path"));
+function resolveFromApp(appDir, spec) {
+    return require.resolve(spec, { paths: [appDir] });
+}
+/** Pin React to one copy so lazy-loaded page chunks share the same runtime (pnpm monorepo). */
+function applyThemeWebpackResolve(config, appDir) {
+    const nextConfig = config;
+    nextConfig.resolve = nextConfig.resolve || {};
+    const reactDir = path_1.default.dirname(resolveFromApp(appDir, 'react/package.json'));
+    const reactDomDir = path_1.default.dirname(resolveFromApp(appDir, 'react-dom/package.json'));
+    const themeNodeModules = path_1.default.join(appDir, 'node_modules');
+    nextConfig.resolve.modules = [
+        themeNodeModules,
+        ...(Array.isArray(nextConfig.resolve.modules)
+            ? nextConfig.resolve.modules
+            : nextConfig.resolve.modules
+                ? [nextConfig.resolve.modules]
+                : []),
+        'node_modules',
+    ];
+    nextConfig.resolve.alias = {
+        ...nextConfig.resolve.alias,
+        // axios → follow-redirects → debug optional peer supports-color@9 (ESM-only)
+        'supports-color': false,
+        react: reactDir,
+        'react-dom': reactDomDir,
+        'react/jsx-runtime': resolveFromApp(appDir, 'react/jsx-runtime'),
+        'react/jsx-dev-runtime': resolveFromApp(appDir, 'react/jsx-dev-runtime'),
+    };
+    return config;
+}
+/**
+ * Baseline Next config for themes: strict mode, eslint relaxed in CI, axios webpack alias.
+ * Pass overrides to extend (your `webpack` runs after the supports-color alias).
+ */
+function resolveNginxEntryUrl() {
+    const raw = process.env.REACTPRESS_NGINX_ENTRY_URL?.trim() ||
+        process.env.NGINX_ENTRY_URL?.trim();
+    return raw ? raw.replace(/\/$/, '') : undefined;
+}
+/** API + admin URLs for Next `env` (read at theme build / dev startup). */
+function resolveThemeNextEnv() {
+    const nginxEntry = resolveNginxEntryUrl();
+    const serverApi = process.env.REACTPRESS_API_URL?.trim() ||
+        process.env.SERVER_API_URL?.trim() ||
+        (process.env.SERVER_SITE_URL
+            ? `${process.env.SERVER_SITE_URL.replace(/\/$/, '')}/api`
+            : 'http://localhost:3002/api');
+    const publicApi = process.env.NEXT_PUBLIC_REACTPRESS_API_URL?.trim() ||
+        (nginxEntry ? `${nginxEntry}/api` : serverApi);
+    const adminUrl = process.env.NEXT_PUBLIC_REACTPRESS_ADMIN_URL?.trim() ||
+        (nginxEntry ? `${nginxEntry}/admin` : 'http://localhost:3000');
+    return {
+        SERVER_API_URL: serverApi.replace(/\/$/, ''),
+        NEXT_PUBLIC_REACTPRESS_API_URL: publicApi.replace(/\/$/, ''),
+        NEXT_PUBLIC_REACTPRESS_ADMIN_URL: adminUrl.replace(/\/$/, ''),
+    };
+}
+function createReactPressNextConfig(overrides = {}) {
+    const { webpack: userWebpack, eslint, transpilePackages, ...rest } = overrides;
+    const nginxEntry = resolveNginxEntryUrl();
+    return {
+        reactStrictMode: true,
+        env: resolveThemeNextEnv(),
+        transpilePackages: ['@fecommunity/reactpress-toolkit', ...(transpilePackages ?? [])],
+        eslint: {
+            ignoreDuringBuilds: true,
+            ...(eslint || {}),
+        },
+        typescript: {
+            ignoreBuildErrors: true,
+            ...(typeof overrides.typescript === 'object' ? overrides.typescript : {}),
+        },
+        ...(nginxEntry
+            ? {
+                async rewrites() {
+                    return [{ source: '/api/:path*', destination: `${nginxEntry}/api/:path*` }];
+                },
+            }
+            : {}),
+        ...rest,
+        webpack: (config, context) => {
+            const ctx = context;
+            const appDir = ctx.dir ?? process.cwd();
+            applyThemeWebpackResolve(config, appDir);
+            if (typeof userWebpack === 'function') {
+                return userWebpack(config, context);
+            }
+            return config;
+        },
+    };
+}

package/dist/theme/build/node.d.ts

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

package/dist/theme/build/node.js

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

package/dist/theme/colorMode.d.ts

@@ -0,0 +1,12 @@
+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;
+/** 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/colorMode.js

@@ -0,0 +1,45 @@
+"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.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';
+}
+/** 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/commentAuthor.d.ts

@@ -0,0 +1,17 @@
+export declare const COMMENT_AUTHOR_STORAGE_KEY = "reactpress-comment-author";
+export type CommentAuthor = {
+    name: string;
+    email: string;
+};
+/** Permissive enough for common guest comment emails (qq/163/gmail, subdomains). */
+export declare const COMMENT_EMAIL_REGEXP: RegExp;
+export declare function isValidCommentEmail(email: string | undefined | null): boolean;
+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/commentAuthor.js

@@ -0,0 +1,48 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.COMMENT_EMAIL_REGEXP = exports.COMMENT_AUTHOR_STORAGE_KEY = void 0;
+exports.isValidCommentEmail = isValidCommentEmail;
+exports.isValidCommentAuthor = isValidCommentAuthor;
+exports.getCommentEmailError = getCommentEmailError;
+exports.readCommentAuthor = readCommentAuthor;
+exports.persistCommentAuthor = persistCommentAuthor;
+exports.COMMENT_AUTHOR_STORAGE_KEY = 'reactpress-comment-author';
+/** Permissive enough for common guest comment emails (qq/163/gmail, subdomains). */
+exports.COMMENT_EMAIL_REGEXP = /^[^\s@]+@[^\s@]+\.[^\s@]+$/;
+function isValidCommentEmail(email) {
+    return Boolean(email?.trim() && exports.COMMENT_EMAIL_REGEXP.test(email.trim()));
+}
+function isValidCommentAuthor(author) {
+    return Boolean(author?.name?.trim() && isValidCommentEmail(author.email));
+}
+function getCommentEmailError(email, messages, options = {}) {
+    const trimmed = email?.trim() ?? '';
+    if (!options.touched)
+        return '';
+    if (!trimmed)
+        return messages.required;
+    if (!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/content/archiveSlim.d.ts

@@ -0,0 +1,7 @@
+import type { IArticle } from '../../types';
+export type ArchiveArticle = Pick<IArticle, 'id' | 'title' | 'publishAt'>;
+export type ArchiveTree = Record<string, Record<string, ArchiveArticle[]>>;
+export declare function slimArchiveTree(raw: Record<string, Record<string, IArticle[]>>): ArchiveTree;
+export declare function countArchiveArticles(articles: ArchiveTree): number;
+export declare function formatArchiveDay(publishAt: string): string;
+export declare function sortedArchiveYears(articles: ArchiveTree): string[];

package/dist/theme/content/archiveSlim.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.slimArchiveTree = slimArchiveTree;
+exports.countArchiveArticles = countArchiveArticles;
+exports.formatArchiveDay = formatArchiveDay;
+exports.sortedArchiveYears = sortedArchiveYears;
+function slimArchiveTree(raw) {
+    const out = {};
+    for (const year of Object.keys(raw)) {
+        out[year] = {};
+        for (const month of Object.keys(raw[year])) {
+            out[year][month] = raw[year][month].map(({ id, title, publishAt }) => ({
+                id,
+                title,
+                publishAt,
+            }));
+        }
+    }
+    return out;
+}
+function countArchiveArticles(articles) {
+    let total = 0;
+    for (const year of Object.keys(articles)) {
+        for (const month of Object.keys(articles[year])) {
+            total += articles[year][month].length;
+        }
+    }
+    return total;
+}
+function formatArchiveDay(publishAt) {
+    const date = new Date(publishAt);
+    const month = String(date.getMonth() + 1).padStart(2, '0');
+    const day = String(date.getDate()).padStart(2, '0');
+    return `${month}-${day}`;
+}
+function sortedArchiveYears(articles) {
+    return Object.keys(articles).sort((a, b) => +b - +a);
+}

package/dist/theme/content/articleSlim.d.ts

@@ -0,0 +1,10 @@
+import type { IArticle } from '../../types';
+/** Fields required by article list cards — omit content/html/toc from SSR payload. */
+export type ListArticle = Pick<IArticle, 'id' | 'title' | 'cover' | 'summary' | 'likes' | 'views' | 'publishAt'> & {
+    category?: Pick<NonNullable<IArticle['category']>, 'value' | 'label'>;
+};
+export type CarouselArticle = Pick<IArticle, 'id' | 'title' | 'cover' | 'publishAt' | 'views'>;
+export declare function slimArticleForList(article: IArticle): ListArticle;
+export declare function slimArticlesForList(articles: IArticle[]): ListArticle[];
+export declare function slimArticleForCarousel(article: IArticle): CarouselArticle;
+export declare function slimArticlesForCarousel(articles: IArticle[]): CarouselArticle[];

package/dist/theme/content/articleSlim.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.slimArticleForList = slimArticleForList;
+exports.slimArticlesForList = slimArticlesForList;
+exports.slimArticleForCarousel = slimArticleForCarousel;
+exports.slimArticlesForCarousel = slimArticlesForCarousel;
+function slimArticleForList(article) {
+    return {
+        id: article.id,
+        title: article.title,
+        cover: article.cover,
+        summary: article.summary,
+        likes: article.likes,
+        views: article.views,
+        publishAt: article.publishAt,
+        category: article.category
+            ? { value: article.category.value, label: article.category.label }
+            : undefined,
+    };
+}
+function slimArticlesForList(articles) {
+    return articles.map(slimArticleForList);
+}
+function slimArticleForCarousel(article) {
+    return {
+        id: article.id,
+        title: article.title,
+        cover: article.cover,
+        publishAt: article.publishAt,
+        views: article.views,
+    };
+}
+function slimArticlesForCarousel(articles) {
+    return articles.map(slimArticleForCarousel);
+}

package/dist/theme/content/assets.d.ts

@@ -0,0 +1,8 @@
+/** Whether a configured asset path is likely to resolve (skip broken defaults like `/logo.png`). */
+export declare function isLikelyValidAssetPath(url: string | undefined | null): boolean;
+/** Header logo — uploads only; default wordmark `/logo.png` is shown via `SiteBranding` text instead. */
+export declare function isLikelyValidHeaderLogoPath(url: string | undefined | null): boolean;
+/** Resolve media / logo URLs for theme pages. */
+export declare function resolvePublicAssetUrl(url: string | undefined | null): string;
+/** Rewrite relative asset URLs inside rendered article HTML (`src`, `href`). */
+export declare function rewriteArticleHtmlAssets(html: string | undefined | null): string;

package/dist/theme/content/assets.js

@@ -0,0 +1,74 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.isLikelyValidAssetPath = isLikelyValidAssetPath;
+exports.isLikelyValidHeaderLogoPath = isLikelyValidHeaderLogoPath;
+exports.resolvePublicAssetUrl = resolvePublicAssetUrl;
+exports.rewriteArticleHtmlAssets = rewriteArticleHtmlAssets;
+/** Legacy root paths that live under API `/public` on the server. */
+const PUBLIC_PATH_ALIASES = {
+    '/logo.png': '/public/logo.png',
+    '/favicon.png': '/public/favicon.png',
+    '/favicon.ico': '/public/favicon.ico',
+};
+function normalizePublicAssetPath(path) {
+    return PUBLIC_PATH_ALIASES[path] ?? path;
+}
+/** Whether a configured asset path is likely to resolve (skip broken defaults like `/logo.png`). */
+function isLikelyValidAssetPath(url) {
+    const trimmed = (url ?? '').trim();
+    if (!trimmed)
+        return false;
+    if (/^https?:\/\//i.test(trimmed) || trimmed.startsWith('/api/') || trimmed.startsWith('/uploads/')) {
+        return true;
+    }
+    if (trimmed.startsWith('/public/') && !PUBLIC_PATH_ALIASES[trimmed.replace('/public', '')]) {
+        return true;
+    }
+    return false;
+}
+/** Header logo — uploads only; default wordmark `/logo.png` is shown via `SiteBranding` text instead. */
+function isLikelyValidHeaderLogoPath(url) {
+    return isLikelyValidAssetPath(url);
+}
+/** Stable public site origin for asset URLs — matches on SSR and client when `NEXT_PUBLIC_*` is set. */
+function resolvePublicSiteOrigin() {
+    const publicApi = (typeof process !== 'undefined' && process.env.NEXT_PUBLIC_REACTPRESS_API_URL?.trim()) || '';
+    if (publicApi) {
+        return publicApi.replace(/\/api\/?$/, '').replace(/\/$/, '');
+    }
+    if (typeof window !== 'undefined') {
+        return window.location.origin;
+    }
+    const serverApi = process.env.REACTPRESS_API_URL?.trim() ||
+        process.env.SERVER_API_URL?.trim() ||
+        'http://localhost:3002/api';
+    return serverApi.replace(/\/api\/?$/, '').replace(/\/$/, '');
+}
+/** Resolve media / logo URLs for theme pages. */
+function resolvePublicAssetUrl(url) {
+    const trimmed = (url ?? '').trim();
+    if (!trimmed)
+        return '';
+    if (/^https?:\/\//i.test(trimmed) || trimmed.startsWith('data:'))
+        return trimmed;
+    if (trimmed.startsWith('//')) {
+        const protocol = typeof window !== 'undefined' ? window.location.protocol : 'http:';
+        return `${protocol}${trimmed}`;
+    }
+    if (trimmed.startsWith('/')) {
+        const normalized = normalizePublicAssetPath(trimmed);
+        const origin = resolvePublicSiteOrigin();
+        const themeOrigin = typeof window !== 'undefined' ? window.location.origin : origin;
+        if (origin === themeOrigin) {
+            return normalized;
+        }
+        return `${origin}${normalized}`;
+    }
+    return trimmed;
+}
+/** Rewrite relative asset URLs inside rendered article HTML (`src`, `href`). */
+function rewriteArticleHtmlAssets(html) {
+    if (!html?.trim())
+        return html ?? '';
+    return html.replace(/(\b(?:src|href)\s*=\s*)(["'])([^"']+)\2/gi, (_, prefix, quote, url) => `${prefix}${quote}${resolvePublicAssetUrl(url)}${quote}`);
+}