@fecommunity/reactpress-toolkit 3.0.0 → 3.1.0

package/dist/app/devChunkRecovery.js

@@ -0,0 +1,68 @@
+"use strict";
+const React = require('react');
+/** Dev-only: recover from stale webpack chunks after on-demand page compilation. */
+function DevChunkRecovery() {
+    React.useEffect(() => {
+        if (process.env.NODE_ENV !== 'development')
+            return undefined;
+        const storageKey = '__reactpress_dev_chunk_recover';
+        const maxAttempts = 2;
+        const isChunkMismatch = (message) => {
+            const msg = String(message || '');
+            return (msg.includes("reading 'call'") ||
+                msg.includes('ChunkLoadError') ||
+                msg.includes('Loading chunk') ||
+                msg.includes('__webpack_modules__') ||
+                msg.includes('is not a function') ||
+                msg.includes('/_next/undefined'));
+        };
+        const recover = () => {
+            const attempts = Number(window.sessionStorage.getItem(storageKey) || 0);
+            if (attempts >= maxAttempts)
+                return;
+            window.sessionStorage.setItem(storageKey, String(attempts + 1));
+            window.location.reload();
+        };
+        const onError = (event) => {
+            const msg = event?.message || event?.reason?.message || event?.reason || '';
+            if (!isChunkMismatch(msg))
+                return;
+            if (typeof event.preventDefault === 'function')
+                event.preventDefault();
+            recover();
+        };
+        window.addEventListener('error', onError);
+        window.addEventListener('unhandledrejection', onError);
+        const clearRecoveries = () => window.sessionStorage.removeItem(storageKey);
+        window.addEventListener('load', clearRecoveries);
+        let routerCleanup = () => { };
+        try {
+            const Router = require('next/router').default;
+            if (Router?.events?.on) {
+                const onRouteError = (err) => {
+                    if (err?.cancelled)
+                        return;
+                    if (isChunkMismatch(err?.message))
+                        recover();
+                };
+                Router.events.on('routeChangeComplete', clearRecoveries);
+                Router.events.on('routeChangeError', onRouteError);
+                routerCleanup = () => {
+                    Router.events.off('routeChangeComplete', clearRecoveries);
+                    Router.events.off('routeChangeError', onRouteError);
+                };
+            }
+        }
+        catch {
+            // App Router themes rely on window error listeners only.
+        }
+        return () => {
+            window.removeEventListener('error', onError);
+            window.removeEventListener('unhandledrejection', onError);
+            window.removeEventListener('load', clearRecoveries);
+            routerCleanup();
+        };
+    }, []);
+    return null;
+}
+module.exports = { DevChunkRecovery };

package/dist/app/index.d.ts

@@ -0,0 +1,39 @@
+/** Type declarations for `@fecommunity/reactpress-toolkit/app` JS factories. */
+import type { ComponentType, ReactNode } from 'react';
+import type { ThemeMods } from '../theme/extension/branding-mods';
+export type CreateThemeApp = (manifest: {
+    id: string;
+}) => unknown;
+export type CreateReactPressAppOptions = {
+    Layout: ComponentType<{
+        children?: ReactNode;
+        needFooter?: boolean;
+        hasBg?: boolean;
+        needHeader?: boolean;
+    }>;
+    /** i18n root provider (e.g. next-intl NextIntlProvider). */
+    IntlProvider: ComponentType<Record<string, unknown>>;
+    buildAppearanceCss?: (mods: ThemeMods) => string;
+    httpClientOptions?: Record<string, unknown>;
+    wrapContent?: (content: ReactNode, runtime: {
+        locale: string;
+        isDark: boolean;
+        colorPrimary?: string;
+        themeMods: ThemeMods;
+        colorMode: string;
+    }) => unknown;
+    scrollToTopOnRouteChange?: boolean;
+    transformBootstrap?: (bootstrap: Record<string, unknown>, ctx: {
+        pathname?: string;
+        asPath?: string;
+    }) => Record<string, unknown>;
+};
+export type CreateReactPressApp = (manifest: {
+    id: string;
+    options?: unknown;
+}, options: CreateReactPressAppOptions) => unknown;
+export declare const createThemeApp: CreateThemeApp;
+export declare const DevChunkRecovery: ComponentType;
+export declare const createReactPressApp: CreateReactPressApp;
+/** @deprecated Use `createReactPressApp`. */
+export declare const createCatalogThemeApp: CreateReactPressApp;

package/dist/app/index.js

@@ -0,0 +1,11 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createCatalogThemeApp = exports.createReactPressApp = exports.DevChunkRecovery = exports.createThemeApp = void 0;
+// eslint-disable-next-line @typescript-eslint/no-var-requires
+exports.createThemeApp = require('./createThemeApp').createThemeApp;
+// eslint-disable-next-line @typescript-eslint/no-var-requires
+exports.DevChunkRecovery = require('./devChunkRecovery').DevChunkRecovery;
+// eslint-disable-next-line @typescript-eslint/no-var-requires
+exports.createReactPressApp = require('./createReactPressApp').createReactPressApp;
+/** @deprecated Use `createReactPressApp`. */
+exports.createCatalogThemeApp = exports.createReactPressApp;

package/dist/config/env.js

@@ -1,7 +1,11 @@
 "use strict";
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
-    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[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];
@@ -11,19 +15,29 @@ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (
 }) : function(o, v) {
     o["default"] = v;
 });
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
+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 _a;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.config = exports.file = void 0;
+const dotenv = __importStar(require("dotenv"));
 const fs = __importStar(require("fs-extra"));
 const path = __importStar(require("path"));
-const dotenv = __importStar(require("dotenv"));
 const isProd = process.env.NODE_ENV === 'production';
 // 获取项目根目录的函数
 function getProjectRoot() {
@@ -39,12 +53,12 @@ function parseEnv() {
     // 使用改进的项目根目录查找
     const projectRoot = getProjectRoot();
     const possibleBasePaths = [
-        projectRoot,
-        path.resolve(__dirname, '../../'),
-        path.resolve(__dirname, '../../../'),
-        path.resolve(__dirname, '../'),
-        process.cwd(),
-        path.resolve(process.cwd(), '../'),
+        projectRoot, // Project root directory
+        path.resolve(__dirname, '../../'), // From config/lib to project root
+        path.resolve(__dirname, '../../../'), // From node_modules to project root
+        path.resolve(__dirname, '../'), // From client directory to project root
+        process.cwd(), // Current working directory
+        path.resolve(process.cwd(), '../'), // From client directory to project root
     ];
     let foundEnvFiles = [];
     // Search for .env files in all possible locations

package/dist/config/global.d.ts

@@ -1,3 +1,4 @@
+import type { SiteThemeState } from '../theme/extension/theme';
 interface NavItem {
     label: string;
     key: string;
@@ -28,7 +29,12 @@ interface LanguageConfig {
 interface GlobalSetting {
     zh: LanguageConfig;
     en: LanguageConfig;
+    theme: SiteThemeState;
 }
 declare const globalSetting: GlobalSetting;
-export type { GlobalSetting, LanguageConfig, GlobalConfig, NavConfig, NavItem, UrlCategory };
+/** Persisted in DB `Setting.globalSetting` — theme runtime only (nav/content lives in `config[themeId]`). */
+export declare const systemGlobalSettingDefaults: {
+    theme: SiteThemeState;
+};
+export type { GlobalConfig, GlobalSetting, LanguageConfig, NavConfig, NavItem, SiteThemeState, UrlCategory };
 export { globalSetting };

package/dist/config/global.js

@@ -1,6 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.globalSetting = void 0;
+exports.globalSetting = exports.systemGlobalSettingDefaults = void 0;
+const theme_1 = require("../theme/extension/theme");
 const navConfig = {
     categories: [
         {
@@ -231,8 +232,8 @@ const urlConfig = [
                 label: 'Excel转换JSON',
                 type: '数据转换工具',
                 description: '用于将Excel文件转换为JSON格式的在线工具，便于在Web应用程序中使用。',
-                icon: 'https://www.convertio.co/favicon.ico',
-                url: 'https://www.convertio.co/zh/excel-json/',
+                icon: 'https://www.convertio.co/favicon.ico', // 假设的图标链接，因为convertio可能支持多种转换，不一定有专门的favicon
+                url: 'https://www.convertio.co/zh/excel-json/', // 真实的Excel转JSON工具网址（convertio可能是一个综合转换工具，但支持Excel到JSON的转换）
             },
             {
                 key: 'chuangkit',
@@ -386,5 +387,10 @@ const en = {
 const globalSetting = {
     zh,
     en,
+    theme: theme_1.defaultSiteThemeState,
 };
 exports.globalSetting = globalSetting;
+/** Persisted in DB `Setting.globalSetting` — theme runtime only (nav/content lives in `config[themeId]`). */
+exports.systemGlobalSettingDefaults = {
+    theme: theme_1.defaultSiteThemeState,
+};

package/dist/config/i18n.js

@@ -1,7 +1,11 @@
 "use strict";
 var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
     if (k2 === undefined) k2 = k;
-    Object.defineProperty(o, k2, { enumerable: true, get: function() { return m[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];
@@ -11,25 +15,37 @@ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (
 }) : function(o, v) {
     o["default"] = v;
 });
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
+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 _a;
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.defaultLocale = exports.locales = exports.messages = void 0;
 const fs = __importStar(require("fs-extra"));
 const path = __importStar(require("path"));
 function parseI18n() {
-    // Locales are now in the dist directory, one level up from config
-    const localesDir = path.join(__dirname, '../locales');
+    const localesDir = path.join(__dirname, 'locales');
     if (!fs.existsSync(localesDir)) {
         return { messages: {}, locales: [], defaultLocale: '' };
     }
-    const files = fs.readdirSync(localesDir);
+    const files = fs.readdirSync(localesDir).filter((file) => {
+        const filePath = path.join(localesDir, file);
+        return file.endsWith('.json') && fs.statSync(filePath).isFile();
+    });
     const messages = files.reduce((i18n, file) => {
         const language = file.replace(path.extname(file), '');
         const json = fs.readJsonSync(path.join(localesDir, file));

package/dist/config/index.d.ts

@@ -2,8 +2,8 @@
  * 环境变量配置
  */
 import { file } from './env';
-import { messages, locales, defaultLocale } from './i18n';
-import { globalSetting } from './global';
+import { globalSetting, systemGlobalSettingDefaults } from './global';
+import { defaultLocale, locales, messages } from './i18n';
 declare const config: {
     locales: string[];
     defaultLocale: string;
@@ -11,5 +11,5 @@ declare const config: {
     globalSetting: import("./global").GlobalSetting;
     file: string;
 };
-export { config, file, messages, locales, defaultLocale, globalSetting };
+export { config, defaultLocale, file, globalSetting, locales, messages, systemGlobalSettingDefaults };
 export default config;

package/dist/config/index.js

@@ -1,17 +1,18 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.globalSetting = exports.defaultLocale = exports.locales = exports.messages = exports.file = exports.config = void 0;
+exports.systemGlobalSettingDefaults = exports.messages = exports.locales = exports.globalSetting = exports.file = exports.defaultLocale = exports.config = void 0;
 /**
  * 环境变量配置
  */
 const env_1 = require("./env");
 Object.defineProperty(exports, "file", { enumerable: true, get: function () { return env_1.file; } });
-const i18n_1 = require("./i18n");
-Object.defineProperty(exports, "messages", { enumerable: true, get: function () { return i18n_1.messages; } });
-Object.defineProperty(exports, "locales", { enumerable: true, get: function () { return i18n_1.locales; } });
-Object.defineProperty(exports, "defaultLocale", { enumerable: true, get: function () { return i18n_1.defaultLocale; } });
 const global_1 = require("./global");
 Object.defineProperty(exports, "globalSetting", { enumerable: true, get: function () { return global_1.globalSetting; } });
+Object.defineProperty(exports, "systemGlobalSettingDefaults", { enumerable: true, get: function () { return global_1.systemGlobalSettingDefaults; } });
+const i18n_1 = require("./i18n");
+Object.defineProperty(exports, "defaultLocale", { enumerable: true, get: function () { return i18n_1.defaultLocale; } });
+Object.defineProperty(exports, "locales", { enumerable: true, get: function () { return i18n_1.locales; } });
+Object.defineProperty(exports, "messages", { enumerable: true, get: function () { return i18n_1.messages; } });
 // Create a unified config object that includes all configuration properties
 const config = {
     ...env_1.config,

package/dist/{locales → config/locales}/en.json

@@ -69,12 +69,17 @@
     "openAuth": "Use third-party login",
     "areYouHasAccount": "Do you already have an account?",
     "loginNow": "Login now",
-    "toggleNeedSetInfo": "Incomplete email information, please complete personal information."
+    "toggleNeedSetInfo": "Incomplete email information, please complete personal information.",
+    "guestCommentLead": "Enter your name and email to comment — no login required.",
+    "commentingAs": "Commenting as {name}"
   },
   "loading": "Loading",
-  "copySuccess": "Copy successfully",
+  "copySuccess": "Copied",
+  "shareLinkCopied": "Share link copied",
   "copy": "copy",
   "article": "Articles",
+  "skipToContent": "Skip to content",
+  "search": "Search",
   "searchArticle": "Search Articles",
   "searchArticlePlaceholder": "Enter keywords, search articles",
   "shareNamespace": {
@@ -93,5 +98,28 @@
   "rssSubscribe": "RSS Subscription",
   "aboutUs": "About Us",
   "nav": "Navigation",
-  "suggestions": "Suggestions"
+  "suggestions": "Suggestions",
+  "theme": {
+    "toggle": "Toggle theme"
+  },
+  "locale": {
+    "switch": "Switch language",
+    "switchToEn": "Switch to English",
+    "switchToZh": "Switch to Chinese"
+  },
+  "pageTitleNavSite": "Site Navigation",
+  "pageTitleLogin": "Login",
+  "pageTitleTag": "Tag: {label}",
+  "pageTitleCategory": "Category: {label}",
+  "pageTitleNavDetail": "Navigation: {label}",
+  "navPreviewDisclaimer": "This site only provides content previews and does not store any information. Please protect your account and property. If content cannot be previewed, click \"Open site\" to view it externally.",
+  "navOpenSite": "Open site ›",
+  "commentShowMore": "Show more ↓",
+  "commentShowLess": "Collapse ↑",
+  "navExpandMenu": "Expand menu",
+  "navCollapseMenu": "Collapse menu",
+  "navCategoryMenu": "Navigation categories",
+  "carouselPrev": "Previous slide, {current} of {total}",
+  "carouselNext": "Next slide, {current} of {total}",
+  "aboutUsFallback": "ReactPress — Modern blog publishing platform"
 }

package/dist/{locales → config/locales}/zh.json

@@ -67,14 +67,19 @@
     "openAuth": "第三方登录",
     "areYouHasAccount": "已有账号？",
     "loginNow": "立即登录",
-    "toggleNeedSetInfo": "邮箱信息不完整，请完善个人资料。"
+    "toggleNeedSetInfo": "邮箱信息不完整，请完善个人资料。",
+    "guestCommentLead": "填写昵称与邮箱即可评论，无需登录。",
+    "commentingAs": "以 {name} 的身份发表评论"
   },
   "loading": "加载中",
-  "copySuccess": "复制成功",
+  "copySuccess": "已复制",
+  "shareLinkCopied": "分享链接复制成功",
   "copy": "复制",
   "article": "文章",
   "home": "首页",
+  "skipToContent": "跳到正文",
   "knowledge": "专辑",
+  "search": "搜索",
   "searchArticle": "文章搜索",
   "searchArticlePlaceholder": "输入关键字，搜索文章",
   "shareNamespace": {
@@ -93,5 +98,28 @@
   "rssSubscribe": "RSS 订阅",
   "aboutUs": "关于我们",
   "nav": "导航",
-  "suggestions": "建议"
+  "suggestions": "建议",
+  "theme": {
+    "toggle": "切换主题"
+  },
+  "locale": {
+    "switch": "切换语言",
+    "switchToEn": "切换到 English",
+    "switchToZh": "切换到中文"
+  },
+  "pageTitleNavSite": "网址导航",
+  "pageTitleLogin": "登录",
+  "pageTitleTag": "标签：{label}",
+  "pageTitleCategory": "分类：{label}",
+  "pageTitleNavDetail": "导航：{label}",
+  "navPreviewDisclaimer": "本站只做内容预览，不做任何信息存储，请注意您的账号和财产安全。如遇内容无法预览，请点击「打开网站」按钮预览。",
+  "navOpenSite": "打开网站 ›",
+  "commentShowMore": "查看更多 ↓",
+  "commentShowLess": "收起 ↑",
+  "navExpandMenu": "展开目录",
+  "navCollapseMenu": "收起目录",
+  "navCategoryMenu": "导航分类",
+  "carouselPrev": "上一张，第 {current} 张，共 {total} 张",
+  "carouselNext": "下一张，第 {current} 张，共 {total} 张",
+  "aboutUsFallback": "ReactPress — 现代化博客发布平台"
 }

package/dist/dev/index.d.ts

@@ -0,0 +1,3 @@
+export type { DevPortRedirectOptions, DevPortRole } from './portRedirect';
+export { buildDevPortRedirectUrl, isDirectDevPortAccess, isNginxDevRedirectEnabled, resolveDevPortRole, resolveNginxEntryUrl, shouldRedirectDevPortToNginx, } from './portRedirect';
+export { devPortRedirectPlugin } from './vitePortRedirectPlugin';

package/dist/dev/index.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.devPortRedirectPlugin = exports.shouldRedirectDevPortToNginx = exports.resolveNginxEntryUrl = exports.resolveDevPortRole = exports.isNginxDevRedirectEnabled = exports.isDirectDevPortAccess = exports.buildDevPortRedirectUrl = void 0;
+var portRedirect_1 = require("./portRedirect");
+Object.defineProperty(exports, "buildDevPortRedirectUrl", { enumerable: true, get: function () { return portRedirect_1.buildDevPortRedirectUrl; } });
+Object.defineProperty(exports, "isDirectDevPortAccess", { enumerable: true, get: function () { return portRedirect_1.isDirectDevPortAccess; } });
+Object.defineProperty(exports, "isNginxDevRedirectEnabled", { enumerable: true, get: function () { return portRedirect_1.isNginxDevRedirectEnabled; } });
+Object.defineProperty(exports, "resolveDevPortRole", { enumerable: true, get: function () { return portRedirect_1.resolveDevPortRole; } });
+Object.defineProperty(exports, "resolveNginxEntryUrl", { enumerable: true, get: function () { return portRedirect_1.resolveNginxEntryUrl; } });
+Object.defineProperty(exports, "shouldRedirectDevPortToNginx", { enumerable: true, get: function () { return portRedirect_1.shouldRedirectDevPortToNginx; } });
+var vitePortRedirectPlugin_1 = require("./vitePortRedirectPlugin");
+Object.defineProperty(exports, "devPortRedirectPlugin", { enumerable: true, get: function () { return vitePortRedirectPlugin_1.devPortRedirectPlugin; } });

package/dist/dev/portRedirect.d.ts

@@ -0,0 +1,20 @@
+export type DevPortRole = 'visitor' | 'admin' | 'api';
+export declare function resolveDevPortRole(directPort: number): DevPortRole;
+export declare function isNginxDevRedirectEnabled(): boolean;
+export declare function resolveNginxEntryUrl(): string;
+export declare function isDirectDevPortAccess(host: string | null | undefined, port: number): boolean;
+export interface DevPortRedirectOptions {
+    host?: string | null;
+    method?: string;
+    accept?: string | null;
+    directPort: number;
+    pathname?: string;
+    skipPathPrefixes?: string[];
+}
+export declare function shouldRedirectDevPortToNginx(options: DevPortRedirectOptions): boolean;
+export declare function buildDevPortRedirectUrl(options: {
+    directPort: number;
+    pathname?: string;
+    search?: string;
+    nginxEntryUrl?: string;
+}): string;

package/dist/dev/portRedirect.js

@@ -0,0 +1,93 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveDevPortRole = resolveDevPortRole;
+exports.isNginxDevRedirectEnabled = isNginxDevRedirectEnabled;
+exports.resolveNginxEntryUrl = resolveNginxEntryUrl;
+exports.isDirectDevPortAccess = isDirectDevPortAccess;
+exports.shouldRedirectDevPortToNginx = shouldRedirectDevPortToNginx;
+exports.buildDevPortRedirectUrl = buildDevPortRedirectUrl;
+const DEFAULT_NGINX_PORT = 80;
+function readPortEnv(key, fallback) {
+    const raw = process.env[key]?.trim();
+    if (!raw)
+        return fallback;
+    const parsed = parseInt(raw, 10);
+    return Number.isFinite(parsed) && parsed > 0 ? parsed : fallback;
+}
+function resolveDevPortRole(directPort) {
+    const apiPort = readPortEnv('SERVER_PORT', 3002);
+    const adminPort = readPortEnv('WEB_ADMIN_PORT', 3000);
+    if (directPort === apiPort)
+        return 'api';
+    if (directPort === adminPort)
+        return 'admin';
+    return 'visitor';
+}
+function isNginxDevRedirectEnabled() {
+    return Boolean(process.env.REACTPRESS_NGINX_ENTRY_URL?.trim());
+}
+function resolveNginxEntryUrl() {
+    const override = process.env.REACTPRESS_NGINX_ENTRY_URL?.trim();
+    if (override) {
+        return override.replace(/\/$/, '');
+    }
+    const rawPort = process.env.NGINX_PORT?.trim();
+    const port = rawPort ? parseInt(rawPort, 10) : DEFAULT_NGINX_PORT;
+    if (Number.isFinite(port) && port > 0 && port !== DEFAULT_NGINX_PORT) {
+        return `http://localhost:${port}`;
+    }
+    return 'http://localhost';
+}
+function isDirectDevPortAccess(host, port) {
+    if (!host || !Number.isFinite(port) || port <= 0)
+        return false;
+    const normalized = host.toLowerCase();
+    return (normalized === `localhost:${port}` ||
+        normalized === `127.0.0.1:${port}` ||
+        normalized === `[::1]:${port}`);
+}
+function acceptsHtmlNavigation(accept) {
+    if (!accept)
+        return false;
+    return accept.includes('text/html');
+}
+function shouldRedirectDevPortToNginx(options) {
+    if (process.env.NODE_ENV === 'production')
+        return false;
+    if (process.env.REACTPRESS_SKIP_DEV_PORT_REDIRECT === '1')
+        return false;
+    if (!isNginxDevRedirectEnabled())
+        return false;
+    const method = (options.method || 'GET').toUpperCase();
+    if (method !== 'GET' && method !== 'HEAD')
+        return false;
+    if (!isDirectDevPortAccess(options.host, options.directPort))
+        return false;
+    if (!acceptsHtmlNavigation(options.accept))
+        return false;
+    const pathname = options.pathname || '/';
+    if (options.skipPathPrefixes?.some((prefix) => pathname.startsWith(prefix))) {
+        return false;
+    }
+    return true;
+}
+function buildDevPortRedirectUrl(options) {
+    const entry = (options.nginxEntryUrl || resolveNginxEntryUrl()).replace(/\/$/, '');
+    const pathname = options.pathname || '/';
+    const search = options.search || '';
+    const role = resolveDevPortRole(options.directPort);
+    if (role === 'api') {
+        if (pathname === '/' || pathname === '') {
+            return `${entry}/api${search}`;
+        }
+        return `${entry}${pathname}${search}`;
+    }
+    if (role === 'admin') {
+        let adminPath = pathname;
+        if (!adminPath.startsWith('/admin')) {
+            adminPath = adminPath === '/' ? '/admin/' : `/admin${adminPath.startsWith('/') ? adminPath : `/${adminPath}`}`;
+        }
+        return `${entry}${adminPath}${search}`;
+    }
+    return `${entry}${pathname}${search}`;
+}

package/dist/dev/vitePortRedirectPlugin.d.ts

@@ -0,0 +1,24 @@
+type DevServer = {
+    middlewares: {
+        use: (handler: (req: DevRequest, res: DevResponse, next: () => void) => void) => void;
+    };
+};
+type DevRequest = {
+    url?: string;
+    method?: string;
+    headers: {
+        host?: string;
+        accept?: string;
+    };
+};
+type DevResponse = {
+    statusCode: number;
+    setHeader: (name: string, value: string) => void;
+    end: () => void;
+};
+/** Redirect direct :3000 browser hits to nginx entry when REACTPRESS_NGINX_ENTRY_URL is set. */
+export declare function devPortRedirectPlugin(port: number): {
+    name: string;
+    configureServer(server: DevServer): void;
+};
+export {};

package/dist/dev/vitePortRedirectPlugin.js

@@ -0,0 +1,40 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.devPortRedirectPlugin = devPortRedirectPlugin;
+const portRedirect_1 = require("./portRedirect");
+const VITE_DEV_SKIP_PREFIXES = ['/@vite', '/@fs', '/@id', '/node_modules'];
+function createRedirectMiddleware(port) {
+    return (req, res, next) => {
+        const url = req.url || '/';
+        const pathname = url.split('?')[0] || '/';
+        const search = url.includes('?') ? url.slice(url.indexOf('?')) : '';
+        if (!(0, portRedirect_1.shouldRedirectDevPortToNginx)({
+            host: req.headers.host,
+            method: req.method,
+            accept: req.headers.accept,
+            directPort: port,
+            pathname,
+            skipPathPrefixes: VITE_DEV_SKIP_PREFIXES,
+        })) {
+            next();
+            return;
+        }
+        const target = (0, portRedirect_1.buildDevPortRedirectUrl)({
+            directPort: port,
+            pathname,
+            search,
+        });
+        res.statusCode = 302;
+        res.setHeader('Location', target);
+        res.end();
+    };
+}
+/** Redirect direct :3000 browser hits to nginx entry when REACTPRESS_NGINX_ENTRY_URL is set. */
+function devPortRedirectPlugin(port) {
+    return {
+        name: 'reactpress-dev-port-redirect',
+        configureServer(server) {
+            server.middlewares.use(createRedirectMiddleware(port));
+        },
+    };
+}