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

package/toolkit/dist/react/client.js

@@ -0,0 +1,95 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ApiError = void 0;
+exports.createClient = createClient;
+exports.getDefaultApiBaseUrl = getDefaultApiBaseUrl;
+const instance_1 = require("../api/instance");
+class ApiError extends Error {
+    constructor(code, message) {
+        super(message);
+        this.name = 'ApiError';
+        this.code = code;
+    }
+}
+exports.ApiError = ApiError;
+function readApiMessage(value) {
+    if (typeof value === 'string') {
+        const trimmed = value.trim();
+        return trimmed ? trimmed : null;
+    }
+    if (Array.isArray(value)) {
+        const parts = value
+            .map((item) => readApiMessage(item))
+            .filter((item) => Boolean(item));
+        return parts.length ? parts.join(', ') : null;
+    }
+    if (value && typeof value === 'object') {
+        const payload = value;
+        return readApiMessage(payload.message) ?? readApiMessage(payload.msg);
+    }
+    return null;
+}
+function rejectApiError(status, payload) {
+    if (typeof payload.code === 'number' && payload.code !== 0) {
+        return Promise.reject(new ApiError(payload.code, readApiMessage(payload.message) ?? 'Request failed'));
+    }
+    const message = readApiMessage(payload.msg) ?? readApiMessage(payload.message);
+    if (message) {
+        return Promise.reject(new ApiError(Number(payload.statusCode ?? status ?? 500), message));
+    }
+    return null;
+}
+function attachInterceptors(http, options) {
+    http.instance.interceptors.request.use((config) => {
+        const token = options.getAccessToken?.();
+        if (token && config.headers) {
+            config.headers.Authorization = `Bearer ${token}`;
+        }
+        return config;
+    });
+    http.instance.interceptors.response.use((response) => {
+        const body = response.data;
+        if (!body || typeof body !== 'object')
+            return response;
+        if (typeof body.code === 'number') {
+            if (body.code !== 0) {
+                throw new ApiError(body.code, readApiMessage(body.message) ?? 'Request failed');
+            }
+            response.data = body.data;
+            return response;
+        }
+        if (typeof body.success === 'boolean') {
+            if (!body.success) {
+                throw new ApiError(Number(body.statusCode ?? 500), readApiMessage(body.msg) ?? 'Request failed');
+            }
+            response.data = body.data;
+            return response;
+        }
+        return response;
+    }, (error) => {
+        const status = error?.response?.status;
+        if (status === 401) {
+            options.onUnauthorized?.();
+        }
+        const body = error?.response?.data;
+        if (body && typeof body === 'object') {
+            const rejected = rejectApiError(status, body);
+            if (rejected)
+                return rejected;
+        }
+        return Promise.reject(error);
+    });
+}
+/** Single factory for web / theme / plugins — wraps generated API modules. */
+function createClient(options = {}) {
+    const baseURL = options.baseURL ?? 'http://localhost:3002/api';
+    const client = (0, instance_1.createApiInstance)({ baseURL });
+    attachInterceptors(client.article.http, options);
+    return client;
+}
+function getDefaultApiBaseUrl() {
+    if (typeof process !== 'undefined' && process.env?.SERVER_API_URL) {
+        return process.env.SERVER_API_URL;
+    }
+    return 'http://localhost:3002/api';
+}

package/toolkit/dist/react/index.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveApiBaseUrl = exports.getRuntime = exports.getDesktopApi = exports.getDefaultApiBaseUrl = exports.createClient = exports.ApiError = void 0;
+var client_1 = require("./client");
+Object.defineProperty(exports, "ApiError", { enumerable: true, get: function () { return client_1.ApiError; } });
+Object.defineProperty(exports, "createClient", { enumerable: true, get: function () { return client_1.createClient; } });
+Object.defineProperty(exports, "getDefaultApiBaseUrl", { enumerable: true, get: function () { return client_1.getDefaultApiBaseUrl; } });
+var runtime_1 = require("./runtime");
+Object.defineProperty(exports, "getDesktopApi", { enumerable: true, get: function () { return runtime_1.getDesktopApi; } });
+Object.defineProperty(exports, "getRuntime", { enumerable: true, get: function () { return runtime_1.getRuntime; } });
+Object.defineProperty(exports, "resolveApiBaseUrl", { enumerable: true, get: function () { return runtime_1.resolveApiBaseUrl; } });

package/toolkit/dist/react/runtime.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getRuntime = getRuntime;
+exports.getDesktopApi = getDesktopApi;
+exports.resolveApiBaseUrl = resolveApiBaseUrl;
+function getRuntime() {
+    if (typeof window !== 'undefined' && window.reactpressDesktop) {
+        return 'electron';
+    }
+    return 'web';
+}
+function getDesktopApi() {
+    if (typeof window === 'undefined')
+        return undefined;
+    return window.reactpressDesktop;
+}
+async function resolveApiBaseUrl(fallback) {
+    const desktop = getDesktopApi();
+    if (desktop) {
+        try {
+            const url = await desktop.getApiBaseUrl();
+            if (url)
+                return url;
+        }
+        catch {
+            // fall through
+        }
+    }
+    return fallback;
+}

package/toolkit/dist/theme/antdDocument.js

@@ -0,0 +1,59 @@
+"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.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 colorMode_1 = require("./colorMode");
+function createAntdThemeDocument(options = {}) {
+    const { resolveLocale, colorModeScript = colorMode_1.colorModeInitScript, defaultLocale = 'zh', } = options;
+    const ThemeDocument = ({ locale }) => ((0, jsx_runtime_1.jsxs)(document_1.Html, { lang: locale || defaultLocale, suppressHydrationWarning: true, children: [(0, jsx_runtime_1.jsx)(document_1.Head, {}), (0, jsx_runtime_1.jsxs)("body", { suppressHydrationWarning: true, children: [colorModeScript ? ((0, jsx_runtime_1.jsx)("script", { dangerouslySetInnerHTML: { __html: colorModeScript } })) : null, (0, jsx_runtime_1.jsx)(document_1.Main, {}), (0, jsx_runtime_1.jsx)(document_1.NextScript, {})] })] }));
+    ThemeDocument.getInitialProps = async (ctx) => {
+        const cache = (0, cssinjs_1.createCache)();
+        const originalRenderPage = ctx.renderPage;
+        ctx.renderPage = () => originalRenderPage({
+            enhanceApp: (App) => (props) => ((0, jsx_runtime_1.jsx)(cssinjs_1.StyleProvider, { cache: cache, children: (0, jsx_runtime_1.jsx)(App, { ...props }) })),
+        });
+        const initialProps = await document_1.default.getInitialProps(ctx);
+        const style = (0, cssinjs_1.extractStyle)(cache, true);
+        return {
+            ...initialProps,
+            locale: resolveLocale?.(ctx.req) ?? defaultLocale,
+            styles: ((0, jsx_runtime_1.jsxs)(jsx_runtime_1.Fragment, { children: [initialProps.styles, (0, jsx_runtime_1.jsx)("style", { dangerouslySetInnerHTML: { __html: style } })] })),
+        };
+    };
+    return ThemeDocument;
+}

package/toolkit/dist/theme/api/api-data.js

@@ -0,0 +1,8 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.unpackPaginatedPair = exports.unpackPaginated = exports.unpackOne = exports.unpackList = void 0;
+var api_envelope_1 = require("../../utils/api-envelope");
+Object.defineProperty(exports, "unpackList", { enumerable: true, get: function () { return api_envelope_1.unpackList; } });
+Object.defineProperty(exports, "unpackOne", { enumerable: true, get: function () { return api_envelope_1.unpackOne; } });
+Object.defineProperty(exports, "unpackPaginated", { enumerable: true, get: function () { return api_envelope_1.unpackPaginated; } });
+Object.defineProperty(exports, "unpackPaginatedPair", { enumerable: true, get: function () { return api_envelope_1.unpackPaginatedPair; } });

package/toolkit/dist/theme/api/api.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.themeApi = void 0;
+exports.resolveThemeApiBaseUrl = resolveThemeApiBaseUrl;
+exports.createThemeApi = createThemeApi;
+exports.getThemeApiBaseUrl = getThemeApiBaseUrl;
+const instance_1 = require("../../api/instance");
+/**
+ * Base URL for theme API calls.
+ * SSR uses REACTPRESS_API_URL (direct :3002); browser uses NEXT_PUBLIC_* (often nginx /api).
+ */
+function resolveThemeApiBaseUrl() {
+    const serverBaseURL = process.env.REACTPRESS_API_URL || 'http://localhost:3002/api';
+    const browserBaseURL = process.env.NEXT_PUBLIC_REACTPRESS_API_URL || serverBaseURL;
+    return typeof window === 'undefined' ? serverBaseURL : browserBaseURL;
+}
+/** Create a theme-scoped API client (override baseURL for tests or multi-tenant). */
+function createThemeApi(config) {
+    return (0, instance_1.createApiInstance)({
+        baseURL: config?.baseURL ?? resolveThemeApiBaseUrl(),
+    });
+}
+/** Default theme API client — same env contract as `reactpress theme dev`. */
+exports.themeApi = createThemeApi();
+function getThemeApiBaseUrl() {
+    return resolveThemeApiBaseUrl();
+}

package/toolkit/dist/theme/api/httpClient.js

@@ -0,0 +1,83 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveThemeAxiosBaseUrl = resolveThemeAxiosBaseUrl;
+exports.encodeAxiosUrlPath = encodeAxiosUrlPath;
+exports.createThemeAxiosClient = createThemeAxiosClient;
+const axios_1 = __importDefault(require("axios"));
+const authSession_1 = require("../visitor/authSession");
+const api_1 = require("./api");
+/**
+ * Theme axios base URL (SSR + client).
+ * Do not read `process.env.SERVER_API_URL` here — Next inlines it from next.config at compile time
+ * and stale values (e.g. localhost:3002) break `--remote-origin` dev.
+ */
+function resolveThemeAxiosBaseUrl() {
+    return (0, api_1.resolveThemeApiBaseUrl)();
+}
+/** Encode dynamic path segments (e.g. Chinese tag names) for Node fetch / axios. */
+function encodeAxiosUrlPath(url) {
+    const qIndex = url.indexOf('?');
+    const pathname = qIndex === -1 ? url : url.slice(0, qIndex);
+    const search = qIndex === -1 ? '' : url.slice(qIndex);
+    const encodedPath = pathname
+        .split('/')
+        .map((segment) => {
+        if (!segment)
+            return segment;
+        try {
+            return encodeURIComponent(decodeURIComponent(segment));
+        }
+        catch {
+            return encodeURIComponent(segment);
+        }
+    })
+        .join('/');
+    return encodedPath + search;
+}
+function createThemeAxiosClient(options = {}) {
+    const isBrowser = typeof window !== 'undefined';
+    const { baseURL = resolveThemeAxiosBaseUrl(), timeout = 60000, getAccessToken = authSession_1.getStoredAccessToken, onError, onUnauthorized, unwrapEnvelope = true, } = options;
+    const client = axios_1.default.create({ baseURL, timeout });
+    client.interceptors.request.use((config) => {
+        if (config.url) {
+            config.url = encodeAxiosUrlPath(config.url);
+        }
+        if (isBrowser) {
+            const token = getAccessToken();
+            if (config.headers && token) {
+                config.headers.Authorization = `Bearer ${token}`;
+            }
+        }
+        return config;
+    }, () => {
+        throw new Error('Failed to send request');
+    });
+    client.interceptors.response.use((response) => {
+        if (!unwrapEnvelope) {
+            return response;
+        }
+        const payload = response.data;
+        if (!payload?.success) {
+            onError?.(payload?.msg || 'Request failed');
+            const message = payload?.msg || `Request failed (${payload?.statusCode ?? 'unknown'})`;
+            return Promise.reject(new Error(message));
+        }
+        return payload.data;
+    }, (err) => {
+        const status = err?.response?.status;
+        const msg = err?.response?.data?.msg;
+        if (status === 401) {
+            onUnauthorized?.();
+            onError?.(msg || 'Unauthorized');
+        }
+        else if (status) {
+            onError?.(msg || 'Server error', status);
+        }
+        const message = msg || err?.message || `HTTP ${status ?? 'error'}`;
+        return Promise.reject(new Error(message));
+    });
+    return client;
+}

package/toolkit/dist/theme/api/json.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.safeJsonParse = void 0;
+var json_1 = require("../../utils/json");
+Object.defineProperty(exports, "safeJsonParse", { enumerable: true, get: function () { return json_1.safeJsonParse; } });

package/toolkit/dist/theme/api/jsonp.js

@@ -0,0 +1,5 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.jsonp = void 0;
+var jsonp_1 = require("../../utils/jsonp");
+Object.defineProperty(exports, "jsonp", { enumerable: true, get: function () { return jsonp_1.jsonp; } });

package/toolkit/dist/theme/api-data.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.unpackPaginated = unpackPaginated;
+exports.unpackList = unpackList;
+exports.unpackOne = unpackOne;
+/** Paginated endpoints: `data` is `[items, total]`. */
+function unpackPaginated(res) {
+    const payload = res?.data;
+    if (Array.isArray(payload) && Array.isArray(payload[0])) {
+        return payload[0];
+    }
+    return [];
+}
+/** List or single entity wrapped in `data`. */
+function unpackList(res) {
+    const data = res?.data;
+    return Array.isArray(data) ? data : [];
+}
+function unpackOne(res) {
+    const data = res?.data;
+    return data != null ? data : null;
+}

package/toolkit/dist/theme/api.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.themeApi = void 0;
+exports.resolveThemeApiBaseUrl = resolveThemeApiBaseUrl;
+exports.createThemeApi = createThemeApi;
+exports.getThemeApiBaseUrl = getThemeApiBaseUrl;
+const instance_1 = require("../api/instance");
+/**
+ * Base URL for theme API calls.
+ * SSR uses REACTPRESS_API_URL (direct :3002); browser uses NEXT_PUBLIC_* (often nginx /api).
+ */
+function resolveThemeApiBaseUrl() {
+    const serverBaseURL = process.env.REACTPRESS_API_URL || 'http://localhost:3002/api';
+    const browserBaseURL = process.env.NEXT_PUBLIC_REACTPRESS_API_URL || serverBaseURL;
+    return typeof window === 'undefined' ? serverBaseURL : browserBaseURL;
+}
+/** Create a theme-scoped API client (override baseURL for tests or multi-tenant). */
+function createThemeApi(config) {
+    return (0, instance_1.createApiInstance)({
+        baseURL: config?.baseURL ?? resolveThemeApiBaseUrl(),
+    });
+}
+/** Default theme API client — same env contract as `reactpress theme dev`. */
+exports.themeApi = createThemeApi();
+function getThemeApiBaseUrl() {
+    return resolveThemeApiBaseUrl();
+}

package/toolkit/dist/theme/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/toolkit/dist/theme/assets.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolvePublicAssetUrl = resolvePublicAssetUrl;
+const api_1 = require("./api");
+/** Resolve media / logo URLs for theme pages (relative `/api/...` → public API origin). */
+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}`;
+    }
+    const apiBase = (0, api_1.resolveThemeApiBaseUrl)().replace(/\/$/, '');
+    const siteOrigin = typeof window !== 'undefined'
+        ? window.location.origin
+        : apiBase.replace(/\/api\/?$/, '');
+    if (trimmed.startsWith('/api/')) {
+        return `${siteOrigin}${trimmed}`;
+    }
+    if (trimmed.startsWith('/')) {
+        return `${siteOrigin}${trimmed}`;
+    }
+    return trimmed;
+}

package/toolkit/dist/theme/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("./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/toolkit/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/toolkit/dist/theme/build/next-config.js

@@ -0,0 +1,63 @@
+"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.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 createReactPressNextConfig(overrides = {}) {
+    const { webpack: userWebpack, eslint, transpilePackages, ...rest } = overrides;
+    return {
+        reactStrictMode: true,
+        transpilePackages: ['@fecommunity/reactpress-toolkit', ...(transpilePackages ?? [])],
+        eslint: {
+            ignoreDuringBuilds: true,
+            ...(eslint || {}),
+        },
+        ...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/toolkit/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 I/O). */
+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; } });