@fecommunity/reactpress-toolkit 3.7.0 → 4.0.0-beta.1

package/README.md

@@ -1,89 +1,89 @@
 # @fecommunity/reactpress-toolkit
 
-ReactPress 的 TypeScript 工具包：从 OpenAPI/Swagger 生成的 API 客户端、站点配置类型、Next.js 主题 SSR 辅助，以及管理后台插件注册。
+TypeScript toolkit for ReactPress: OpenAPI/Swagger-generated API clients, site config types, Next.js theme SSR helpers, and admin plugin registry.
 
-## 包导出（`package.json` → `exports`）
+## Package exports (`package.json` → `exports`)
 
-| 子路径 | 用途 |
+| Subpath | Purpose |
 |--------|------|
-| `.` | 根入口：`api`、`config`、`theme`、`ui`、`plugin` 命名空间及常用 re-export |
-| `./api` | 各资源 HTTP 客户端类 |
-| `./api/instance` | 默认 `api` 实例与 `createApiInstance` |
-| `./types` | Swagger 生成的请求/响应类型 |
-| `./utils` | 与业务无关的纯工具（见下方模块表） |
-| `./config` | 环境变量、全局默认、`i18n` 文案（`config/locales/*.json`） |
-| `./theme` | 访客主题：SSR 拉数、运行时、扩展配置类型，并 re-export `./ui` |
+| `.` | Root entry: `api`, `config`, `theme`, `ui`, `plugin` namespaces and common re-exports |
+| `./api` | HTTP client classes per resource |
+| `./api/instance` | Default `api` instance and `createApiInstance` |
+| `./types` | Swagger-generated request/response types |
+| `./utils` | Framework-agnostic utilities (see module table below) |
+| `./config` | Env vars, global defaults, `i18n` strings (`config/locales/*.json`) |
+| `./theme` | Visitor themes: SSR data fetch, runtime, extension config types; re-exports `./ui` |
 | `./theme/next-config` | `createReactPressNextConfig()` |
-| `./theme/node` | Node 专用（如读取主题管理端 locale 文件） |
-| `./ui` | 无样式主题组件与 hooks |
-| `./plugin` | 管理端插件聚合入口 |
-| `./plugin/admin` | 菜单注册、权限常量 |
-| `./plugin/client` | Web/Electron API 客户端工厂（推荐） |
-| `./plugin/react` | 与 `./plugin/client` 相同（兼容旧路径） |
-| `./plugin/dev` | Vite 开发端口重定向等 |
+| `./theme/node` | Node-only helpers (e.g. read theme admin locale files) |
+| `./ui` | Unstyled theme components and hooks |
+| `./plugin` | Admin plugin aggregate entry |
+| `./plugin/admin` | Menu registration, permission constants |
+| `./plugin/client` | Web/Electron API client factory (recommended) |
+| `./plugin/react` | Same as `./plugin/client` (legacy path) |
+| `./plugin/dev` | Vite dev port redirect, etc. |
 
-**约定：** `src/` 下仅保留与上述导出对应的一级目录；实现细节放在子目录中，根目录用薄 shim 保持对外路径稳定（例如 `theme/node.ts` → `theme/build/node.ts`）。
+**Convention:** Only top-level directories under `src/` match the exports above; implementation details live in subdirectories with thin shims at the root (e.g. `theme/node.ts` → `theme/build/node.ts`).
 
-## 源码结构
+## Source layout
 
 ```
 src/
-├── api/              # OpenAPI 生成（勿手改业务逻辑）
-├── config/           # env、global、i18n + locales/
-├── types/            # Swagger 生成类型
-├── utils/            # 纯函数工具（theme/plugin 共用）
+├── api/              # OpenAPI generated (do not hand-edit business logic)
+├── config/           # env, global, i18n + locales/
+├── types/            # Swagger generated types
+├── utils/            # Pure utilities (shared by theme/plugin)
 │   ├── api-envelope.ts   # unpackList / unpackOne / unpackPaginated
 │   ├── cookie.ts         # readRequestCookie
-│   ├── date.ts           # formatDate、formatPublishDate*
-│   ├── email.ts          # 评论邮箱校验
-│   ├── error.ts          # ApiError、isApiError
+│   ├── date.ts           # formatDate, formatPublishDate*
+│   ├── email.ts          # Comment email validation
+│   ├── error.ts          # ApiError, isApiError
 │   ├── json.ts           # safeJsonParse
-│   ├── jsonp.ts          # 浏览器 JSONP
-│   ├── object.ts         # deepMerge、getByPath、deepClone
+│   ├── jsonp.ts          # Browser JSONP
+│   ├── object.ts         # deepMerge, getByPath, deepClone
 │   ├── setting.ts        # pickSiteSettings
-│   └── string.ts         # stripHtml、truncateWords
+│   └── string.ts         # stripHtml, truncateWords
 ├── plugin/
-│   ├── admin/        # AdminModule、菜单注册、权限
-│   ├── client/       # createClient、resolveApiBaseUrl
-│   ├── dev/          # devPortRedirectPlugin 等
-│   └── react/        # 仅 re-export client（兼容）
+│   ├── admin/        # AdminModule, menu registration, permissions
+│   ├── client/       # createClient, resolveApiBaseUrl
+│   ├── dev/          # devPortRedirectPlugin, etc.
+│   └── react/        # Re-export client only (compat)
 ├── theme/
-│   ├── api/          # themeApi、axios 封装（JSON/解包 re-export utils）
-│   ├── ssr/          # fetch、static props、站点 meta
-│   ├── visitor/      # 语言、会话、配色、运行时 mods
-│   ├── content/      # SEO、导航路径、摘要、静态资源 URL
-│   ├── preview/      # 预览 token / mods / config 查询参数
-│   ├── createCatalogApp.js  # 完整主题 _app 工厂（无 UI 框架依赖）
-│   ├── createApp.js  # Next `_app` 工厂（allowJs，随 tsc 输出到 dist）
-│   ├── extension/    # theme.json  schema、站点配置、与服务端共享的类型
+│   ├── api/          # themeApi, axios wrapper
+│   ├── ssr/          # fetch, static props, site meta
+│   ├── visitor/      # Language, session, colors, runtime mods
+│   ├── content/      # SEO, nav paths, excerpts, static asset URLs
+│   ├── preview/      # Preview token / mods / config query params
+│   ├── createCatalogApp.js  # Full theme _app factory (no UI framework)
+│   ├── createApp.js  # Next `_app` factory (allowJs, emitted to dist)
+│   ├── extension/    # theme.json schema, site config, shared server types
 │   ├── node.ts       # → build/node
 │   ├── next-config.ts
-│   └── index.ts      # 对外 barrel
+│   └── index.ts      # Public barrel
 └── ui/
-    ├── components/   # 无样式 React 组件
-    ├── context/      # ReactPressProvider、locale、runtime
-    └── hooks/        # 通用 React hooks（与具体页面无关）
+    ├── components/   # Unstyled React components
+    ├── context/      # ReactPressProvider, locale, runtime
+    └── hooks/        # Generic React hooks
 ```
 
-## 安装
+## Install
 
 ```bash
 pnpm add @fecommunity/reactpress-toolkit
 ```
 
-## 快速开始
+## Quick start
 
-### API 客户端
+### API client
 
 ```typescript
 import { api } from '@fecommunity/reactpress-toolkit';
-// 或
+// or
 import { api, createApiInstance } from '@fecommunity/reactpress-toolkit/api/instance';
 
 const articles = await api.article.findAll();
 ```
 
-自定义 baseURL：
+Custom baseURL:
 
 ```typescript
 import { createApiInstance } from '@fecommunity/reactpress-toolkit/api/instance';
@@ -91,9 +91,9 @@ import { createApiInstance } from '@fecommunity/reactpress-toolkit/api/instance'
 const customApi = createApiInstance({ baseURL: 'https://api.example.com/api' });
 ```
 
-### 通用工具（`./utils`）
+### Utilities (`./utils`)
 
-与 Next/主题无关的逻辑应放在 `utils`，`theme` 仅 re-export 以保持 `@fecommunity/reactpress-toolkit/theme` 路径兼容：
+Framework-agnostic logic belongs in `utils`; `theme` re-exports for `@fecommunity/reactpress-toolkit/theme` compatibility:
 
 ```typescript
 import {
@@ -107,49 +107,49 @@ import {
 } from '@fecommunity/reactpress-toolkit/utils';
 ```
 
-| 模块 | 典型用途 |
+| Module | Typical use |
 |------|----------|
-| `json` | 解析 setting 里的 JSON 字符串 |
-| `api-envelope` | 解包 Nest `TransformInterceptor` 的 `{ data }` |
-| `date` | 文章发布日期展示 |
-| `string` | 归档摘要 HTML 剥离、截断 |
-| `object` | theme.json 配置合并、点路径读写 |
-| `setting` | 把 settings 行映射为 props |
-| `cookie` | SSR 读取 `Cookie` 头 |
-| `email` | 访客评论邮箱格式 |
+| `json` | Parse JSON strings in settings |
+| `api-envelope` | Unwrap Nest `TransformInterceptor` `{ data }` |
+| `date` | Article publish date display |
+| `string` | Strip HTML for archive excerpts, truncate |
+| `object` | Merge theme.json config, dot-path read/write |
+| `setting` | Map settings rows to props |
+| `cookie` | Read `Cookie` header in SSR |
+| `email` | Visitor comment email format |
 
-### 管理后台插件
+### Admin plugins
 
 ```typescript
 import type { AdminModule } from '@fecommunity/reactpress-toolkit/plugin/admin';
 import { permissionsForRole } from '@fecommunity/reactpress-toolkit/plugin/admin';
 ```
 
-### Web / Electron 客户端
+### Web / Electron client
 
 ```typescript
 import { createClient, resolveApiBaseUrl } from '@fecommunity/reactpress-toolkit/plugin/client';
 ```
 
-## App 工厂（`./app`）
+## App factories (`./app`)
 
-主题 `_app.tsx` 的入口工厂，与 UI 框架无关：
+Entry factories for theme `_app.tsx`, UI-framework agnostic:
 
-| 工厂 | 用途 |
+| Factory | Purpose |
 |------|------|
-| `createThemeApp` | 极简主题（hello-world）：`ReactPressProvider` + `ThemeCssVars` |
-| `createReactPressApp` | 完整主题：SSR catalog、i18n、统计、PV；通过 `wrapContent` 注入 Ant Design 等 |
+| `createThemeApp` | Minimal theme (hello-world): `ReactPressProvider` + `ThemeCssVars` |
+| `createReactPressApp` | Full theme: SSR catalog, i18n, analytics, PV; inject Ant Design etc. via `wrapContent` |
 
 ```typescript
 import { createThemeApp } from '@fecommunity/reactpress-toolkit/app';
 import { createReactPressApp } from '@fecommunity/reactpress-toolkit/app';
 ```
 
-也可从 `./theme`  re-export 导入（兼容旧路径）。
+Also re-exported from `./theme` (legacy paths).
 
-## 主题开发（`./theme`）
+## Theme development (`./theme`)
 
-Next.js 访客主题应使用 toolkit 提供的 API 与 SSR 辅助，避免在每个主题里复制 `lib/api.ts`。
+Next.js visitor themes should use toolkit API and SSR helpers instead of copying `lib/api.ts` per theme.
 
 ```typescript
 import {
@@ -175,7 +175,7 @@ import themeManifest from '../theme.json';
 export default createThemeApp(themeManifest);
 ```
 
-**完整功能主题** — 使用 `createReactPressApp`（UI 框架无关），Ant Design 等重型依赖留在主题内：
+**Full-featured themes** — use `createReactPressApp` (UI-framework agnostic); keep Ant Design and heavy deps in the theme:
 
 ```typescript
 import { createReactPressApp } from '@fecommunity/reactpress-toolkit/app';
@@ -193,9 +193,9 @@ export default createReactPressApp(themeManifest, {
 });
 ```
 
-`createReactPressApp` 内置：SSR 站点数据、预览 mods、SiteCatalogProvider、路由进度条、统计脚本、PV 上报。**不含** Ant Design / cssinjs。
+`createReactPressApp` includes: SSR site data, preview mods, SiteCatalogProvider, route progress, analytics scripts, PV reporting. **Does not** include Ant Design / cssinjs.
 
-**REST Provider** — 无需在每个主题复制 14 个 Provider 文件：
+**REST providers** — avoid copying 14 provider files per theme:
 
 ```typescript
 import { createThemeAxiosClient, createThemeProviders } from '@fecommunity/reactpress-toolkit/theme';
@@ -204,68 +204,68 @@ export const httpProvider = createThemeAxiosClient({ onError, onUnauthorized });
 export const { ArticleProvider, CategoryProvider, TagProvider } = createThemeProviders(httpProvider);
 ```
 
-环境变量：`REACTPRESS_API_URL`（SSR）、`NEXT_PUBLIC_REACTPRESS_API_URL`（浏览器），由 `reactpress theme dev` 注入。
+Env: `REACTPRESS_API_URL` (SSR), `NEXT_PUBLIC_REACTPRESS_API_URL` (browser), injected by `reactpress theme dev`.
 
-### 无样式 UI（`./ui`）
+### Headless UI (`./ui`)
 
-也可从 `./theme` 一并导入：
+Also importable from `./theme`:
 
 ```typescript
 import { NavMenu, ArticleList, ReactPressProvider, useLocale } from '@fecommunity/reactpress-toolkit/ui';
 ```
 
-| 符号 | 说明 |
+| Symbol | Description |
 |------|------|
-| `ReactPressProvider` | 在 `_app` 注入站点上下文 |
-| `useLocale` / `useThemeRuntime` / `useThemeMod` | 语言与主题 mods |
-| `useToggle` / `useAsyncLoading` | 布尔切换、防抖 loading（评论/搜索等） |
-| `usePagination` | `[items, total]` 分页列表 |
-| `useReportArticleView` / `useReportPageView` | 文章阅读数、全站 PV 上报 |
-| `useRouteParam` / `useNavActive` | 动态路由参数、导航高亮 |
-| `useWarningOnExit` | 离开页面前确认（Next Router） |
-| `NavMenu` | 配置驱动导航，通过 `renderLink` 接 Next `Link` |
-| `ArticleList` | 列表渲染，通过 `renderArticle` 自定义卡片 |
-| `SiteCatalogProvider` / `useSiteSetting` / `useSiteUser` | 全站 catalog + 用户会话 |
-| `SiteSeo` / `RouteProgress` / `SiteAnalytics` | SEO meta、路由进度条、GA/百度统计 |
-| `ArticleReader` / `HtmlContent` / `ArticleToc` | 文章阅读、HTML 渲染、目录 |
-| `ImageViewer` / `LocaleTime` | 图片预览、本地化时间 |
-| `createReactPressApp` | 完整主题 `_app` 工厂（`@fecommunity/reactpress-toolkit/app`） |
-| `fetchAppBootstrap` | `_app.getInitialProps` SSR 数据（setting / taxonomy / preview） |
-
-### 扩展配置类型
-
-`theme/extension` 中的类型与校验逻辑与 **server**、**web 外观设置** 共用，例如 `ThemeConfigurationSchema`、`resolveSiteConfig`、`PUBLIC_SETTING_KEYS`。服务端可：
+| `ReactPressProvider` | Inject site context in `_app` |
+| `useLocale` / `useThemeRuntime` / `useThemeMod` | Language and theme mods |
+| `useToggle` / `useAsyncLoading` | Boolean toggle, debounced loading |
+| `usePagination` | `[items, total]` paginated lists |
+| `useReportArticleView` / `useReportPageView` | Article views, site PV |
+| `useRouteParam` / `useNavActive` | Dynamic route params, nav highlight |
+| `useWarningOnExit` | Confirm before leaving page (Next Router) |
+| `NavMenu` | Config-driven nav via `renderLink` + Next `Link` |
+| `ArticleList` | List renderer via `renderArticle` |
+| `SiteCatalogProvider` / `useSiteSetting` / `useSiteUser` | Site catalog + user session |
+| `SiteSeo` / `RouteProgress` / `SiteAnalytics` | SEO meta, progress bar, GA/Baidu |
+| `ArticleReader` / `HtmlContent` / `ArticleToc` | Article reading, HTML, TOC |
+| `ImageViewer` / `LocaleTime` | Image preview, localized time |
+| `createReactPressApp` | Full theme `_app` factory |
+| `fetchAppBootstrap` | `_app.getInitialProps` SSR data |
+
+### Extension config types
+
+Types and validation in `theme/extension` are shared with **server** and **web appearance settings**, e.g. `ThemeConfigurationSchema`, `resolveSiteConfig`, `PUBLIC_SETTING_KEYS`. Server example:
 
 ```typescript
 import { PUBLIC_SETTING_KEYS, systemGlobalSettingDefaults } from '@fecommunity/reactpress-toolkit/theme';
 import { readThemeAdminLocaleFile } from '@fecommunity/reactpress-toolkit/theme/node';
 ```
 
-## 从 Swagger 重新生成 API
+## Regenerate API from Swagger
 
-在 monorepo 根目录确保 server 可构建后：
+From monorepo root, ensure server builds:
 
 ```bash
 cd toolkit && pnpm run generate
 ```
 
-将更新 `src/api/*` 与 `src/types/*`。
+Updates `src/api/*` and `src/types/*`.
 
-## 构建
+## Build
 
 ```bash
 cd toolkit && pnpm run build
 ```
 
-输出到 `dist/`；`createApp.js` 随 `tsc`（`allowJs`）写入 `dist/theme/createApp.js`。
+Output in `dist/`; `createApp.js` is emitted via `tsc` (`allowJs`) to `dist/theme/createApp.js`.
 
-## 开发脚本
+## Scripts
 
-| 命令 | 说明 |
+| Command | Description |
 |------|------|
-| `pnpm run generate` | 从 server Swagger 生成 API |
-| `pnpm run build` | `tsc` + 复制 locales |
-| `pnpm run typecheck` | 仅类型检查 |
+| `pnpm run generate` | Generate API from server Swagger |
+| `pnpm run build` | `tsc` + copy locales |
+| `pnpm run typecheck` | Type check only |
 
 ## License
 

package/dist/plugin/admin/index.d.ts

@@ -1,2 +1,4 @@
 export * from './permissions';
+export * from './plugin-admin';
 export * from './registry';
+export * from './slots';

package/dist/plugin/admin/index.js

@@ -15,4 +15,6 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 };
 Object.defineProperty(exports, "__esModule", { value: true });
 __exportStar(require("./permissions"), exports);
+__exportStar(require("./plugin-admin"), exports);
 __exportStar(require("./registry"), exports);
+__exportStar(require("./slots"), exports);

package/dist/plugin/admin/plugin-admin.d.ts

@@ -3,9 +3,15 @@ export interface PluginAdminContext {
     id: string;
     config: Record<string, unknown>;
 }
+export interface PluginSettingsPanelProps {
+    pluginId: string;
+    config: Record<string, unknown>;
+    pluginActive: boolean;
+}
 /** Plugin admin entry — called once per active plugin when admin shell loads. */
 export interface PluginAdminModule {
-    registerAdmin(registry: PluginAdminRegistry, ctx: PluginAdminContext): void | Promise<void>;
+    registerAdmin?(registry: PluginAdminRegistry, ctx: PluginAdminContext): void | Promise<void>;
+    SettingsPanel?: (props: PluginSettingsPanelProps) => unknown;
 }
 /** Opaque component type — React `ComponentType` lives in `@fecommunity/reactpress-toolkit/plugin/react`. */
 export type PluginAdminSlotComponent = (props: PluginAdminSlotComponentProps<unknown>) => unknown;

package/dist/plugin/client/runtime.d.ts

@@ -1,7 +1,12 @@
 export type AppRuntime = 'web' | 'electron';
+export type DesktopApiMode = 'local' | 'remote';
 export interface DesktopApi {
+    getApiMode: () => Promise<DesktopApiMode>;
+    setApiMode: (mode: DesktopApiMode) => Promise<DesktopApiMode>;
     getApiBaseUrl: () => Promise<string>;
-    setApiBaseUrl: (url: string) => Promise<void>;
+    setApiBaseUrl: (url: string) => Promise<string>;
+    getRemoteApiBaseUrl: () => Promise<string>;
+    setRemoteApiBaseUrl: (url: string) => Promise<string>;
     showSaveDialog: (opts: {
         defaultPath?: string;
     }) => Promise<string | undefined>;

package/dist/plugin/index.d.ts

@@ -1,9 +1,13 @@
 export * as admin from './admin';
 export * as client from './client';
 export * as dev from './dev';
+export * as extension from './extension';
+export * as server from './server';
 /** @deprecated Use `plugin/client`; path kept for compatibility. */
 export * as react from './react';
 export * from './admin';
 export * from './client';
 export * from './dev';
+export * from './extension';
+export * from './server';
 export * from './react';

package/dist/plugin/index.js

@@ -36,13 +36,17 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.react = exports.dev = exports.client = exports.admin = void 0;
+exports.react = exports.server = exports.extension = exports.dev = exports.client = exports.admin = void 0;
 exports.admin = __importStar(require("./admin"));
 exports.client = __importStar(require("./client"));
 exports.dev = __importStar(require("./dev"));
+exports.extension = __importStar(require("./extension"));
+exports.server = __importStar(require("./server"));
 /** @deprecated Use `plugin/client`; path kept for compatibility. */
 exports.react = __importStar(require("./react"));
 __exportStar(require("./admin"), exports);
 __exportStar(require("./client"), exports);
 __exportStar(require("./dev"), exports);
+__exportStar(require("./extension"), exports);
+__exportStar(require("./server"), exports);
 __exportStar(require("./react"), exports);

package/dist/plugin/react/index.d.ts

@@ -1,2 +1,3 @@
 /** Stable export path: `@fecommunity/reactpress-toolkit/plugin/react`. */
 export * from '../client';
+export * from './plugin-admin-ui';

package/dist/plugin/react/index.js

@@ -16,3 +16,4 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
 Object.defineProperty(exports, "__esModule", { value: true });
 /** Stable export path: `@fecommunity/reactpress-toolkit/plugin/react`. */
 __exportStar(require("../client"), exports);
+__exportStar(require("./plugin-admin-ui"), exports);

package/dist/theme/content/assets.js

@@ -10,9 +10,18 @@ const PUBLIC_PATH_ALIASES = {
     '/favicon.png': '/public/favicon.png',
     '/favicon.ico': '/public/favicon.ico',
 };
+/** Theme Next rewrites serve alias keys (e.g. `/logo.png`), not `/public/*` API paths. */
+const THEME_LOCAL_PUBLIC_PATHS = Object.fromEntries(Object.entries(PUBLIC_PATH_ALIASES).map(([themePath, apiPath]) => [apiPath, themePath]));
 function normalizePublicAssetPath(path) {
     return PUBLIC_PATH_ALIASES[path] ?? path;
 }
+function toThemeServablePath(apiPath) {
+    return THEME_LOCAL_PUBLIC_PATHS[apiPath] ?? apiPath;
+}
+/** Paths proxied by theme `next.config` rewrites — keep relative, never bake absolute API URLs. */
+function isThemeRewritePath(path) {
+    return path in THEME_LOCAL_PUBLIC_PATHS || path.startsWith('/public/') || path.startsWith('/uploads/');
+}
 /** Whether a configured asset path is likely to resolve (skip broken defaults like `/logo.png`). */
 function isLikelyValidAssetPath(url) {
     const trimmed = (url ?? '').trim();
@@ -44,6 +53,26 @@ function resolvePublicSiteOrigin() {
         'http://localhost:3002/api';
     return serverApi.replace(/\/api\/?$/, '').replace(/\/$/, '');
 }
+/** Visitor site origin — differs from API origin during SSR (theme :3001 vs API :3002). */
+function resolveThemeSiteOrigin() {
+    if (typeof window !== 'undefined') {
+        return window.location.origin;
+    }
+    const clientSite = process.env.CLIENT_SITE_URL?.trim();
+    if (clientSite) {
+        try {
+            return new URL(clientSite).origin;
+        }
+        catch {
+            return clientSite.replace(/\/$/, '');
+        }
+    }
+    const clientPort = process.env.CLIENT_PORT?.trim() || process.env.PORT?.trim();
+    if (clientPort) {
+        return `http://127.0.0.1:${clientPort}`;
+    }
+    return resolvePublicSiteOrigin();
+}
 /** Resolve media / logo URLs for theme pages. */
 function resolvePublicAssetUrl(url) {
     const trimmed = (url ?? '').trim();
@@ -57,8 +86,11 @@ function resolvePublicAssetUrl(url) {
     }
     if (trimmed.startsWith('/')) {
         const normalized = normalizePublicAssetPath(trimmed);
+        if (isThemeRewritePath(normalized)) {
+            return toThemeServablePath(normalized);
+        }
         const origin = resolvePublicSiteOrigin();
-        const themeOrigin = typeof window !== 'undefined' ? window.location.origin : origin;
+        const themeOrigin = resolveThemeSiteOrigin();
         if (origin === themeOrigin) {
             return normalized;
         }

package/dist/theme/extension/theme.d.ts

@@ -71,7 +71,7 @@ export interface SiteThemeState {
     mods: Record<string, ThemeMods>;
     previewThemeId?: string;
 }
-export declare const DEFAULT_ACTIVE_THEME = "twentytwentyfive";
+export declare const DEFAULT_ACTIVE_THEME = "hello-world";
 export declare const defaultSiteThemeState: SiteThemeState;
 export interface GlobalSettingWithTheme {
     zh?: unknown;

package/dist/theme/extension/theme.js

@@ -19,7 +19,7 @@ Object.defineProperty(exports, "appearancePrimaryColorForMode", { enumerable: tr
 function appearancePrimaryColor(mods, fallback = '#f44336') {
     return (0, twentytwentyfive_vars_1.appearancePrimaryColorForMode)(mods, false, fallback);
 }
-exports.DEFAULT_ACTIVE_THEME = 'twentytwentyfive';
+exports.DEFAULT_ACTIVE_THEME = 'hello-world';
 exports.defaultSiteThemeState = {
     activeTheme: exports.DEFAULT_ACTIVE_THEME,
     installedThemes: [exports.DEFAULT_ACTIVE_THEME],

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

@@ -73,7 +73,10 @@ export declare function fetchTagArchive(api: ThemeApi, tag: string): Promise<{
 export type ThemeArticlePage = {
     id: string;
     title: string;
+    slug?: string;
     summary?: string;
+    seoDescription?: string;
+    seoKeywords?: string;
     html?: string;
     cover?: string;
     publishAt?: string;

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

@@ -1,7 +1,7 @@
 import type { ThemeApi } from '../api/api';
 import { type CarouselArticle, type ListArticle } from '../content/articleSlim';
 import { type ArchiveTree } from '../content/archiveSlim';
-import type { IArticle, ICategory, IKnowledge, ITag } from '../../types';
+import type { IArticle, ICategory, IKnowledge, IPage, ITag } from '../../types';
 export type HomePageProps = {
     articles: ListArticle[];
     total: number;
@@ -52,9 +52,10 @@ export declare function fetchKnowledgeChapterPageProps(api: ThemeApi, pId: strin
 }>;
 /** Site search results for `/search?keyword=`. */
 export declare function fetchSearchPageProps(api: ThemeApi, keyword: string): Promise<SearchPageProps>;
-/** CMS static page by id. */
-export declare function fetchCmsPageProps(api: ThemeApi, id: string): Promise<{
-    page: unknown;
+export type CmsPageProps = Pick<IPage, 'id' | 'name' | 'path' | 'html' | 'toc' | 'status' | 'publishAt' | 'views'>;
+/** CMS static page by id or path slug (admin → 页面). */
+export declare function fetchCmsPageProps(api: ThemeApi, idOrPath: string | undefined): Promise<{
+    page: CmsPageProps | null;
 }>;
 /** Single article by id (full entity from API). */
 export declare function fetchArticleDetailProps(api: ThemeApi, id: string): Promise<{

package/dist/theme/ssr/pageProps.js

@@ -15,6 +15,7 @@ const api_data_1 = require("../api/api-data");
 const articleSlim_1 = require("../content/articleSlim");
 const archiveSlim_1 = require("../content/archiveSlim");
 const carouselArticles_1 = require("../content/carouselArticles");
+const assets_1 = require("../content/assets");
 const fetch_1 = require("./fetch");
 const DEFAULT_PAGE_SIZE = 12;
 function fallbackCategory(value) {
@@ -128,9 +129,25 @@ async function fetchSearchPageProps(api, keyword) {
     const articles = (0, api_data_1.unpackList)(response).filter((article) => article.status === 'publish');
     return { keyword: trimmed, articles };
 }
-/** CMS static page by id. */
-async function fetchCmsPageProps(api, id) {
-    return { page: (0, api_data_1.unpackOne)(await api.page.findById(id)) };
+/** CMS static page by id or path slug (admin → 页面). */
+async function fetchCmsPageProps(api, idOrPath) {
+    if (!idOrPath?.trim())
+        return { page: null };
+    const raw = (0, api_data_1.unpackOne)(await api.page.findById(idOrPath.trim()));
+    if (!raw || raw.status !== 'publish')
+        return { page: null };
+    return {
+        page: {
+            id: raw.id,
+            name: raw.name,
+            path: raw.path,
+            html: raw.html ? (0, assets_1.rewriteArticleHtmlAssets)(raw.html) : raw.html,
+            toc: raw.toc,
+            status: raw.status,
+            publishAt: raw.publishAt,
+            views: raw.views,
+        },
+    };
 }
 /** Single article by id (full entity from API). */
 async function fetchArticleDetailProps(api, id) {

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

@@ -3,6 +3,7 @@ export declare function unwrapSetting(response: unknown): Record<string, unknown
 export interface SiteMeta {
     siteName: string;
     siteDescription: string;
+    siteKeywords?: string;
     siteUrl?: string;
     siteLogo?: string;
     siteFavicon?: string;

package/dist/theme/ssr/setting.js

@@ -31,6 +31,9 @@ function parseSiteMeta(row) {
         siteName: String(row.systemTitle ?? 'ReactPress Site').trim() || exports.DEFAULT_SITE_META.siteName,
         siteDescription: String(row.systemSubTitle ?? exports.DEFAULT_SITE_META.siteDescription).trim() ||
             exports.DEFAULT_SITE_META.siteDescription,
+        siteKeywords: row.seoKeyword != null && String(row.seoKeyword).trim()
+            ? String(row.seoKeyword).trim()
+            : undefined,
         siteUrl: row.systemUrl != null ? String(row.systemUrl).trim() || undefined : undefined,
         siteLogo: row.systemLogo != null && String(row.systemLogo).trim()
             ? String(row.systemLogo).trim()

package/dist/theme/ssr/templates.js

@@ -34,7 +34,7 @@ exports.ThemeTemplate = {
 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.PAGE]: 'pages/[path].tsx',
     [exports.ThemeTemplate.ARCHIVE_CATEGORY]: 'pages/category/[category].tsx',
     [exports.ThemeTemplate.ARCHIVE_TAG]: 'pages/tag/[tag].tsx',
     [exports.ThemeTemplate.SEARCH]: 'pages/search.tsx',

package/dist/types/index.d.ts

@@ -94,6 +94,9 @@ export interface IArticle {
     title: string;
     cover: string;
     summary: string;
+    slug?: string | null;
+    seoKeywords?: string | null;
+    seoDescription?: string | null;
     content: string;
     html: string;
     toc: string;

package/dist/ui/components/ArchiveEmptyState.d.ts

@@ -10,4 +10,4 @@ export interface ArchiveEmptyStateProps {
     }) => React.ReactNode;
 }
 /** Headless empty archive/search state with optional back link slot. */
-export declare function ArchiveEmptyState({ message, backHref, backLabel, className, renderBackLink, }: ArchiveEmptyStateProps): React.JSX.Element;
+export declare function ArchiveEmptyState({ message, backHref, backLabel, className, renderBackLink, }: ArchiveEmptyStateProps): import("react/jsx-runtime").JSX.Element;

package/dist/ui/components/ArchivePageLayout.d.ts

@@ -7,4 +7,4 @@ export interface ArchivePageLayoutProps {
     sidebarClassName?: string;
 }
 /** Two-column archive layout (main list + sidebar widgets). */
-export declare function ArchivePageLayout({ main, sidebar, className, mainClassName, sidebarClassName, }: ArchivePageLayoutProps): React.JSX.Element;
+export declare function ArchivePageLayout({ main, sidebar, className, mainClassName, sidebarClassName, }: ArchivePageLayoutProps): import("react/jsx-runtime").JSX.Element;

package/dist/ui/components/ArticleCard.d.ts

@@ -24,4 +24,4 @@ export interface ArticleCardProps {
     renderDate?: (publishAt: string) => React.ReactNode;
 }
 /** Headless article card — theme supplies Link markup and CSS. */
-export declare function ArticleCard({ article, className, titleTag, showCategory, renderTitleLink, renderCategoryLink, renderDate, }: ArticleCardProps): React.JSX.Element;
+export declare function ArticleCard({ article, className, titleTag, showCategory, renderTitleLink, renderCategoryLink, renderDate, }: ArticleCardProps): import("react/jsx-runtime").JSX.Element;

package/dist/ui/components/ArticleList.d.ts

@@ -11,4 +11,4 @@ export interface ArticleListProps<T extends {
 /** Headless article grid/list — theme supplies markup and styles per item. */
 export declare function ArticleList<T extends {
     id: string;
-}>({ articles, limit, className, empty, renderArticle, }: ArticleListProps<T>): React.JSX.Element;
+}>({ articles, limit, className, empty, renderArticle, }: ArticleListProps<T>): import("react/jsx-runtime").JSX.Element;

package/dist/ui/components/BaseGlobalStyles.d.ts

@@ -1,6 +1,5 @@
-import React from 'react';
 export interface BaseGlobalStylesProps {
     extra?: string;
 }
 /** Shared reset used by starter themes (override via `extra` CSS). */
-export declare function BaseGlobalStyles({ extra }: BaseGlobalStylesProps): React.JSX.Element;
+export declare function BaseGlobalStyles({ extra }: BaseGlobalStylesProps): import("react/jsx-runtime").JSX.Element;

package/dist/ui/components/LocaleSwitcher.d.ts

@@ -7,4 +7,4 @@ export interface LocaleSwitcherProps {
     ariaLabel?: string;
 }
 /** Click to cycle locales — same control as admin and theme headers. */
-export declare function LocaleSwitcher({ className, buttonClassName, size, ariaLabel, }: LocaleSwitcherProps): import("react").JSX.Element;
+export declare function LocaleSwitcher({ className, buttonClassName, size, ariaLabel, }: LocaleSwitcherProps): import("react/jsx-runtime").JSX.Element;

package/dist/ui/components/NavMenu.d.ts

@@ -13,4 +13,4 @@ export interface NavMenuProps {
     renderLink: (props: NavMenuRenderLinkProps) => React.ReactNode;
 }
 /** Headless site navigation — styling via theme `renderLink` (e.g. Next.js `Link`). */
-export declare function NavMenu({ items, activeId, className, listClassName, itemClassName, renderLink, }: NavMenuProps): React.JSX.Element;
+export declare function NavMenu({ items, activeId, className, listClassName, itemClassName, renderLink, }: NavMenuProps): import("react/jsx-runtime").JSX.Element;

package/dist/ui/components/NotFoundPanel.d.ts

@@ -8,4 +8,4 @@ export interface NotFoundPanelProps {
     className?: string;
 }
 /** Headless 404 / not-found content block (theme supplies styles). */
-export declare function NotFoundPanel({ title, subtitle, description, illustration, actions, className, }: NotFoundPanelProps): React.JSX.Element;
+export declare function NotFoundPanel({ title, subtitle, description, illustration, actions, className, }: NotFoundPanelProps): import("react/jsx-runtime").JSX.Element;

package/dist/ui/components/PageHeader.d.ts

@@ -7,4 +7,4 @@ export interface PageHeaderProps {
     descriptionClassName?: string;
 }
 /** Unstyled archive / page title block (WP `the_archive_title` pattern). */
-export declare function PageHeader({ title, description, className, titleClassName, descriptionClassName, }: PageHeaderProps): React.JSX.Element;
+export declare function PageHeader({ title, description, className, titleClassName, descriptionClassName, }: PageHeaderProps): import("react/jsx-runtime").JSX.Element;

package/dist/ui/components/SiteAnalytics.d.ts

@@ -2,4 +2,4 @@ export interface SiteAnalyticsProps {
     children?: React.ReactNode;
 }
 /** Inject Google Analytics / Baidu Tongji scripts from site settings. */
-export declare function SiteAnalytics({ children }: SiteAnalyticsProps): string | number | boolean | import("react").ReactElement<any, string | import("react").JSXElementConstructor<any>> | Iterable<import("react").ReactNode> | import("react").ReactPortal | null;
+export declare function SiteAnalytics({ children }: SiteAnalyticsProps): string | number | bigint | boolean | import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | Iterable<import("react").ReactNode> | import("react").ReactPortal | Promise<string | number | bigint | boolean | import("react").ReactPortal | import("react").ReactElement<unknown, string | import("react").JSXElementConstructor<any>> | Iterable<import("react").ReactNode> | null | undefined> | null;

package/dist/ui/components/SiteBranding.d.ts

@@ -1,4 +1,3 @@
-import React from 'react';
 export interface SiteBrandingProps {
     /** Last-resort title when customizer mod and site settings are both empty. */
     fallback?: string;
@@ -8,4 +7,4 @@ export interface SiteBrandingProps {
 /**
  * Site title: customizer `displayTitle` when set, otherwise `systemTitle` from site settings.
  */
-export declare function SiteBranding({ fallback, className, as: Tag }: SiteBrandingProps): React.JSX.Element;
+export declare function SiteBranding({ fallback, className, as: Tag }: SiteBrandingProps): import("react/jsx-runtime").JSX.Element;

package/dist/ui/components/SiteDocument.d.ts

@@ -17,4 +17,4 @@ export interface SiteDocumentProps {
 /**
  * WordPress-style shell: head slot + header + main + footer (like `get_header()` / `get_footer()`).
  */
-export declare function SiteDocument({ head, header, footer, children, className, mainClassName, contentClassName, wrapContent, globalCss, skipBaseStyles, skipCssVars, }: SiteDocumentProps): React.JSX.Element;
+export declare function SiteDocument({ head, header, footer, children, className, mainClassName, contentClassName, wrapContent, globalCss, skipBaseStyles, skipCssVars, }: SiteDocumentProps): import("react/jsx-runtime").JSX.Element;

package/dist/ui/components/SiteDocumentFallback.d.ts

@@ -5,4 +5,4 @@ export interface SiteDocumentFallbackProps extends Omit<SiteDocumentProps, 'chil
     messageClassName?: string;
 }
 /** Standard ISR fallback shell while on-demand pages compile. */
-export declare function SiteDocumentFallback({ message, messageClassName, ...shell }: SiteDocumentFallbackProps): React.JSX.Element;
+export declare function SiteDocumentFallback({ message, messageClassName, ...shell }: SiteDocumentFallbackProps): import("react/jsx-runtime").JSX.Element;

package/dist/ui/components/SiteLogo.d.ts

@@ -1,4 +1,3 @@
-import React from 'react';
 export interface SiteLogoProps {
     className?: string;
     alt?: string;
@@ -6,4 +5,4 @@ export interface SiteLogoProps {
     height?: number;
 }
 /** Site logo: customizer `siteLogo` when set, otherwise `systemLogo` from site settings. */
-export declare function SiteLogo({ className, alt, width, height }: SiteLogoProps): React.JSX.Element | null;
+export declare function SiteLogo({ className, alt, width, height }: SiteLogoProps): import("react/jsx-runtime").JSX.Element | null;

package/dist/ui/components/SiteSeo.d.ts

@@ -10,4 +10,4 @@ export interface SiteSeoProps {
     description?: string;
 }
 /** Inject default site meta tags from catalog `setting`. */
-export declare function SiteSeo({ children, favicon, keywords, description }: SiteSeoProps): React.JSX.Element;
+export declare function SiteSeo({ children, favicon, keywords, description }: SiteSeoProps): import("react/jsx-runtime").JSX.Element;

package/dist/ui/components/SiteTagline.d.ts

@@ -1,8 +1,7 @@
-import React from 'react';
 export interface SiteTaglineProps {
     /** Used when customizer tagline and site subtitle are both empty. */
     fallback?: string;
     className?: string;
 }
 /** Site tagline: customizer `displayTagline` when set, otherwise `systemSubTitle`. */
-export declare function SiteTagline({ fallback, className }: SiteTaglineProps): React.JSX.Element | null;
+export declare function SiteTagline({ fallback, className }: SiteTaglineProps): import("react/jsx-runtime").JSX.Element | null;

package/dist/ui/components/TaxonomyList.d.ts

@@ -22,4 +22,4 @@ export interface TaxonomyListProps {
     renderLink: (props: TaxonomyListRenderLinkProps) => React.ReactNode;
 }
 /** Headless category/tag list (sidebar, footer, tag cloud). */
-export declare function TaxonomyList({ items, kind, variant, currentValue, className, itemClassName, hrefFor, renderLink, }: TaxonomyListProps): React.JSX.Element;
+export declare function TaxonomyList({ items, kind, variant, currentValue, className, itemClassName, hrefFor, renderLink, }: TaxonomyListProps): import("react/jsx-runtime").JSX.Element;

package/dist/ui/components/ThemeCssVars.d.ts

@@ -1,3 +1,2 @@
-import React from 'react';
 /** Injects Customizer colors, background, dark mode, and extra CSS (WP `theme_mod` → `:root`). */
-export declare function ThemeCssVars(): React.JSX.Element;
+export declare function ThemeCssVars(): import("react/jsx-runtime").JSX.Element;

package/dist/ui/components/ThemeLayout.d.ts

@@ -10,4 +10,4 @@ export interface ThemeLayoutProps {
     wrapContent?: boolean;
 }
 /** Unstyled page shell: header + main (+ optional content wrapper) + footer. */
-export declare function ThemeLayout({ header, footer, children, className, mainClassName, contentClassName, wrapContent, }: ThemeLayoutProps): React.JSX.Element;
+export declare function ThemeLayout({ header, footer, children, className, mainClassName, contentClassName, wrapContent, }: ThemeLayoutProps): import("react/jsx-runtime").JSX.Element;

package/dist/ui/components/content/ArticleReader.d.ts

@@ -40,6 +40,6 @@ export interface ArticleReaderProps {
  * Headless single-article reader — meta, cover, HTML body, optional TOC slot.
  * Theme supplies layout shell, comments, and tag links via render props.
  */
-export declare function ArticleReader({ article, className, articleClassName, containerId, locale, copyLabel, onCopy, labels, renderTags, renderFooter, children, }: ArticleReaderProps): React.JSX.Element;
+export declare function ArticleReader({ article, className, articleClassName, containerId, locale, copyLabel, onCopy, labels, renderTags, renderFooter, children, }: ArticleReaderProps): import("react/jsx-runtime").JSX.Element;
 export { ArticleToc, HtmlContent, ImageViewer, LocaleTime, parseArticleToc };
 export type { TocItem };

package/dist/ui/components/content/ArticleToc.d.ts

@@ -16,6 +16,6 @@ export interface ArticleTocProps {
     indentStep?: number;
 }
 /** Headless table-of-contents for article pages. */
-export declare function ArticleToc({ items, className, listClassName, itemClassName, activeClassName, maxHeight, title, showTitle, indentStep, }: ArticleTocProps): React.JSX.Element | null;
+export declare function ArticleToc({ items, className, listClassName, itemClassName, activeClassName, maxHeight, title, showTitle, indentStep, }: ArticleTocProps): import("react/jsx-runtime").JSX.Element | null;
 /** Parse TOC JSON stored on article records. Supports legacy `[level, id, text]` tuples. */
 export declare function parseArticleToc(raw?: string | null): TocItem[];

package/dist/ui/components/content/HtmlContent.d.ts

@@ -1,4 +1,3 @@
-import React from 'react';
 export interface HtmlContentProps {
     /** Server-rendered HTML (article body). */
     content?: string;
@@ -13,4 +12,4 @@ export interface HtmlContentProps {
     highlightCode?: boolean;
 }
 /** Render HTML article body with optional code highlight and copy buttons. */
-export declare function HtmlContent({ content, className, copyLabel, copySuccessLabel, onCopy, highlightCode, }: HtmlContentProps): React.JSX.Element;
+export declare function HtmlContent({ content, className, copyLabel, copySuccessLabel, onCopy, highlightCode, }: HtmlContentProps): import("react/jsx-runtime").JSX.Element;

package/dist/ui/components/content/Image.d.ts

@@ -6,4 +6,4 @@ export interface ImageProps extends Omit<ImgHTMLAttributes<HTMLImageElement>, 's
     size?: ImageVariant;
 }
 /** 按上传变体尺寸渲染 `<img>`，`url` + `size` 外其余属性透传。 */
-export declare function Image({ url, size, alt, ...rest }: ImageProps): import("react").JSX.Element | null;
+export declare function Image({ url, size, alt, ...rest }: ImageProps): import("react/jsx-runtime").JSX.Element | null;

package/dist/ui/components/content/LocaleTime.d.ts

@@ -1,4 +1,3 @@
-import React from 'react';
 export interface LocaleTimeProps {
     date: string | number | Date;
     format?: string;
@@ -7,4 +6,4 @@ export interface LocaleTimeProps {
     locale?: string;
 }
 /** Locale-aware `<time>` — absolute date or relative timeago. */
-export declare function LocaleTime({ date, timeago, format, locale, }: LocaleTimeProps): React.JSX.Element;
+export declare function LocaleTime({ date, timeago, format, locale, }: LocaleTimeProps): import("react/jsx-runtime").JSX.Element;

package/dist/ui/components/toolbar/LocaleToggleButton.d.ts

@@ -5,4 +5,4 @@ export interface LocaleToggleButtonProps extends Omit<ToolbarIconButtonProps, 'c
     onLocaleChange: (locale: string) => void;
 }
 /** Click to cycle locales. Shows zh/en translation bubble icons (like theme sun/moon). */
-export declare function LocaleToggleButton({ locale, locales, onLocaleChange, size, title, ...rest }: LocaleToggleButtonProps): import("react").JSX.Element | null;
+export declare function LocaleToggleButton({ locale, locales, onLocaleChange, size, title, ...rest }: LocaleToggleButtonProps): import("react/jsx-runtime").JSX.Element | null;

package/dist/ui/components/toolbar/ThemeToggleButton.d.ts

@@ -4,4 +4,4 @@ export interface ThemeToggleButtonProps extends Omit<ToolbarIconButtonProps, 'ch
     onToggle: () => void;
 }
 /** Click to switch light/dark. Shows sun in light mode, moon in dark mode. */
-export declare function ThemeToggleButton({ isDark, onToggle, size, ...rest }: ThemeToggleButtonProps): import("react").JSX.Element;
+export declare function ThemeToggleButton({ isDark, onToggle, size, ...rest }: ThemeToggleButtonProps): import("react/jsx-runtime").JSX.Element;

package/dist/ui/components/toolbar/ToolbarIconButton.d.ts

@@ -4,4 +4,4 @@ export interface ToolbarIconButtonProps extends Omit<ButtonHTMLAttributes<HTMLBu
     children: ReactNode;
     size?: number;
 }
-export declare function ToolbarIconButton({ children, className, style, ...rest }: ToolbarIconButtonProps): import("react").JSX.Element;
+export declare function ToolbarIconButton({ children, className, style, ...rest }: ToolbarIconButtonProps): import("react/jsx-runtime").JSX.Element;

package/dist/ui/components/toolbar/icons.d.ts

@@ -2,16 +2,16 @@ import type { SVGProps } from 'react';
 type IconProps = Pick<SVGProps<SVGSVGElement>, 'className'> & {
     size?: number;
 };
-export declare function SunIcon({ size, className }: IconProps): import("react").JSX.Element;
-export declare function MoonIcon({ size, className }: IconProps): import("react").JSX.Element;
-export declare function LanguagesIcon({ size, className }: IconProps): import("react").JSX.Element;
-export declare function SearchIcon({ size, className }: IconProps): import("react").JSX.Element;
+export declare function SunIcon({ size, className }: IconProps): import("react/jsx-runtime").JSX.Element;
+export declare function MoonIcon({ size, className }: IconProps): import("react/jsx-runtime").JSX.Element;
+export declare function LanguagesIcon({ size, className }: IconProps): import("react/jsx-runtime").JSX.Element;
+export declare function SearchIcon({ size, className }: IconProps): import("react/jsx-runtime").JSX.Element;
 /** 中文态：气泡内「中」，右下角「A」。 */
-export declare function LocaleZhToggleIcon(props: IconProps): import("react").JSX.Element;
+export declare function LocaleZhToggleIcon(props: IconProps): import("react/jsx-runtime").JSX.Element;
 /** 英文态：气泡内「A」，右下角「中」。 */
-export declare function LocaleEnToggleIcon(props: IconProps): import("react").JSX.Element;
+export declare function LocaleEnToggleIcon(props: IconProps): import("react/jsx-runtime").JSX.Element;
 /** Active locale — switches between zh/en translation bubble icons. */
 export declare function LocaleActiveIcon({ locale, size, className, }: IconProps & {
     locale: string;
-}): import("react").JSX.Element;
+}): import("react/jsx-runtime").JSX.Element;
 export {};

package/dist/ui/context/LocaleContext.d.ts

@@ -10,6 +10,6 @@ export interface LocaleProviderProps {
     persistLocale?: boolean;
     onLocaleChange?: (locale: string) => void;
 }
-export declare function LocaleProvider({ locale: initialLocale, locales, messages: initialMessages, catalog, children, persistLocale, onLocaleChange, }: LocaleProviderProps): React.JSX.Element;
+export declare function LocaleProvider({ locale: initialLocale, locales, messages: initialMessages, catalog, children, persistLocale, onLocaleChange, }: LocaleProviderProps): import("react/jsx-runtime").JSX.Element;
 export declare function useLocale(): LocaleContextValue;
 export declare function readPersistedLocale(locales: string[], fallback: string): string;

package/dist/ui/context/ReactPressProvider.d.ts

@@ -1,4 +1,3 @@
-import React from 'react';
 import type { ReactPressProviderProps } from './types';
 /** Wraps the theme app with locale + active theme / customizer context. */
-export declare function ReactPressProvider({ locale, locales, messages, catalog, themeId, activeThemeId, mods, isPreview, siteMeta, children, persistLocale, onLocaleChange, }: ReactPressProviderProps): React.JSX.Element;
+export declare function ReactPressProvider({ locale, locales, messages, catalog, themeId, activeThemeId, mods, isPreview, siteMeta, children, persistLocale, onLocaleChange, }: ReactPressProviderProps): import("react/jsx-runtime").JSX.Element;

package/dist/ui/context/SiteCatalogContext.d.ts

@@ -6,7 +6,7 @@ export declare const SiteCatalogContext: React.Context<SiteCatalogContextValue>;
 export declare function SiteCatalogProvider({ value, children, }: {
     value: SiteCatalogContextValue;
     children: React.ReactNode;
-}): React.JSX.Element;
+}): import("react/jsx-runtime").JSX.Element;
 export declare function useSiteCatalog(): {
     categories: import("../..").ICategory[];
     tags: import("../..").ITag[];

package/dist/ui/context/ThemeRuntimeContext.d.ts

@@ -9,7 +9,7 @@ export interface ThemeRuntimeProviderProps {
     siteMeta?: ThemeRuntimeContextValue['siteMeta'];
     children: React.ReactNode;
 }
-export declare function ThemeRuntimeProvider({ themeId, activeThemeId, mods, isPreview, siteMeta, children, }: ThemeRuntimeProviderProps): React.JSX.Element;
+export declare function ThemeRuntimeProvider({ themeId, activeThemeId, mods, isPreview, siteMeta, children, }: ThemeRuntimeProviderProps): import("react/jsx-runtime").JSX.Element;
 export declare function useThemeRuntime(): ThemeRuntimeContextValue;
 /** Read a single customizer mod with optional default (from `theme.json` customizer). */
 export declare function useThemeMod(modId: string, defaultValue?: string): string;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@fecommunity/reactpress-toolkit",
-  "version": "3.7.0",
+  "version": "4.0.0-beta.1",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {
@@ -79,6 +79,18 @@
     "./plugin/dev": {
       "types": "./dist/plugin/dev/index.d.ts",
       "default": "./dist/plugin/dev/index.js"
+    },
+    "./plugin/extension": {
+      "types": "./dist/plugin/extension/index.d.ts",
+      "default": "./dist/plugin/extension/index.js"
+    },
+    "./plugin/server": {
+      "types": "./dist/plugin/server/index.d.ts",
+      "default": "./dist/plugin/server/index.js"
+    },
+    "./plugin/node": {
+      "types": "./dist/plugin/node.d.ts",
+      "default": "./dist/plugin/node.js"
     }
   },
   "peerDependencies": {