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

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.0",
   "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": {