@fecommunity/reactpress-toolkit 3.0.4 → 3.1.0

package/dist/admin/registry.d.ts

@@ -0,0 +1,62 @@
+import type { Permission } from './permissions';
+export type MenuNodeKind = 'group' | 'item';
+export interface AdminMenuItem {
+    id: string;
+    kind: MenuNodeKind;
+    title: string;
+    path: string | null;
+    icon?: string | null;
+    sort?: number;
+    hidden?: boolean;
+    permissions?: Permission[] | null;
+    children?: AdminMenuItem[];
+}
+export interface MenuRegisterInput {
+    id: string;
+    title: string;
+    path?: string | null;
+    icon?: string | null;
+    sort?: number;
+    hidden?: boolean;
+    permissions?: Permission[] | null;
+    children?: MenuRegisterInput[];
+}
+export interface SettingsTabInput {
+    id: string;
+    title: string;
+    path: string;
+    permission?: Permission;
+    sort?: number;
+}
+export interface RoutePermissionInput {
+    path: string;
+    permission: Permission | null;
+}
+export interface MenuRegistry {
+    register(input: MenuRegisterInput): void;
+    getTree(): AdminMenuItem[];
+}
+export interface SettingsRegistry {
+    registerTab(input: SettingsTabInput): void;
+    getTabs(): SettingsTabInput[];
+}
+export interface PermissionRegistry {
+    register(perms: Permission[]): void;
+    getAll(): Permission[];
+}
+export interface RouteRegistry {
+    registerRoute(input: RoutePermissionInput): void;
+    getRoutePermissions(): RoutePermissionInput[];
+}
+export interface AdminContext {
+    menu: MenuRegistry;
+    settings: SettingsRegistry;
+    permissions: PermissionRegistry;
+    routes: RouteRegistry;
+}
+export interface AdminModule {
+    id: string;
+    register(ctx: AdminContext): void;
+}
+export declare function createAdminRegistry(): AdminContext;
+export declare function filterMenuByPermissions(nodes: AdminMenuItem[], granted: Set<string>): AdminMenuItem[];

package/dist/admin/registry.js

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createAdminRegistry = createAdminRegistry;
+exports.filterMenuByPermissions = filterMenuByPermissions;
+function normalizeMenuInput(input) {
+    const hasChildren = Boolean(input.children?.length);
+    return {
+        id: input.id,
+        kind: hasChildren && !input.path ? 'group' : 'item',
+        title: input.title,
+        path: input.path ?? (hasChildren ? null : '/'),
+        icon: input.icon ?? null,
+        sort: input.sort ?? 0,
+        hidden: input.hidden ?? false,
+        permissions: input.permissions ?? null,
+        children: input.children?.map(normalizeMenuInput),
+    };
+}
+function createAdminRegistry() {
+    const menuItems = [];
+    const settingsTabs = [];
+    const permissions = new Set();
+    const routePermissions = [];
+    const menu = {
+        register(input) {
+            menuItems.push(normalizeMenuInput(input));
+        },
+        getTree() {
+            return [...menuItems].sort((a, b) => (a.sort ?? 0) - (b.sort ?? 0));
+        },
+    };
+    const settings = {
+        registerTab(input) {
+            settingsTabs.push(input);
+        },
+        getTabs() {
+            return [...settingsTabs].sort((a, b) => (a.sort ?? 0) - (b.sort ?? 0));
+        },
+    };
+    const permissionRegistry = {
+        register(perms) {
+            for (const p of perms)
+                permissions.add(p);
+        },
+        getAll() {
+            return [...permissions];
+        },
+    };
+    const routes = {
+        registerRoute(input) {
+            routePermissions.push(input);
+        },
+        getRoutePermissions() {
+            return routePermissions;
+        },
+    };
+    return { menu, settings, permissions: permissionRegistry, routes };
+}
+function filterMenuByPermissions(nodes, granted) {
+    const can = (required) => {
+        if (!required?.length)
+            return true;
+        return required.every((p) => granted.has(p));
+    };
+    const walk = (list) => list
+        .map((node) => {
+        if (!can(node.permissions))
+            return null;
+        if (node.children?.length) {
+            const children = walk(node.children);
+            if (children.length === 0)
+                return null;
+            return { ...node, children };
+        }
+        return node;
+    })
+        .filter((n) => n != null);
+    return walk(nodes);
+}

package/dist/api/HttpClient.d.ts

@@ -1,5 +1,5 @@
 import { AxiosInstance, AxiosRequestConfig, ResponseType } from 'axios';
-export declare type QueryParamsType = Record<string | number, any>;
+export type QueryParamsType = Record<string | number, any>;
 export interface FullRequestParams extends Omit<AxiosRequestConfig, 'data' | 'params' | 'url' | 'responseType'> {
     /** set parameter to `true` for call `securityWorker` for this request */
     secure?: boolean;
@@ -14,7 +14,7 @@ export interface FullRequestParams extends Omit<AxiosRequestConfig, 'data' | 'pa
     /** request body */
     body?: unknown;
 }
-export declare type RequestParams = Omit<FullRequestParams, 'body' | 'method' | 'query' | 'path'>;
+export type RequestParams = Omit<FullRequestParams, 'body' | 'method' | 'query' | 'path'>;
 export interface ApiConfig<SecurityDataType = unknown> extends Omit<AxiosRequestConfig, 'data' | 'cancelToken'> {
     securityWorker?: (securityData: SecurityDataType | null) => Promise<AxiosRequestConfig | void> | AxiosRequestConfig | void;
     secure?: boolean;

package/dist/api/HttpClient.js

@@ -21,7 +21,7 @@ var ContentType;
     ContentType["FormData"] = "multipart/form-data";
     ContentType["UrlEncoded"] = "application/x-www-form-urlencoded";
     ContentType["Text"] = "text/plain";
-})(ContentType = exports.ContentType || (exports.ContentType = {}));
+})(ContentType || (exports.ContentType = ContentType = {}));
 class HttpClient {
     constructor({ securityWorker, secure, format, ...axiosConfig } = {}) {
         this.securityData = null;

package/dist/api/Smtp.d.ts

@@ -30,4 +30,21 @@ export declare class Smtp<SecurityDataType = unknown> {
      * @response `200` `ISmtpControllerDeleteByIdData`
      */
     deleteById: (id: string, params?: RequestParams) => Promise<any>;
+    /**
+     * 发送测试邮件（验证 SMTP 配置）
+     *
+     * @tags Smtp
+     * @name SmtpControllerTestSend
+     * @request POST:/smtp/test
+     */
+    testSend: (data: {
+        to: string;
+        smtpHost?: string;
+        smtpPort?: string;
+        smtpUser?: string;
+        smtpPass?: string;
+        smtpFromUser?: string;
+    }, params?: RequestParams) => Promise<{
+        ok: true;
+    }>;
 }

package/dist/api/Smtp.js

@@ -11,6 +11,7 @@
  */
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Smtp = void 0;
+const HttpClient_1 = require("./HttpClient");
 class Smtp {
     constructor(http) {
         /**
@@ -52,6 +53,20 @@ class Smtp {
             method: 'DELETE',
             ...params,
         });
+        /**
+         * 发送测试邮件（验证 SMTP 配置）
+         *
+         * @tags Smtp
+         * @name SmtpControllerTestSend
+         * @request POST:/smtp/test
+         */
+        this.testSend = (data, params = {}) => this.http.request({
+            path: `/smtp/test`,
+            method: 'POST',
+            body: data,
+            type: HttpClient_1.ContentType.Json,
+            ...params,
+        });
         this.http = http;
     }
 }

package/dist/api/instance.d.ts

@@ -1,9 +1,9 @@
-import { HttpClient } from './HttpClient';
 import { Article } from './Article';
 import { Auth } from './Auth';
 import { Category } from './Category';
 import { Comment } from './Comment';
 import { File } from './File';
+import { HttpClient } from './HttpClient';
 import { Knowledge } from './Knowledge';
 import { Page } from './Page';
 import { Search } from './Search';

package/dist/api/instance.js

@@ -1,7 +1,7 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.View = exports.User = exports.Tag = exports.Smtp = exports.Setting = exports.Search = exports.Page = exports.Knowledge = exports.File = exports.Comment = exports.Category = exports.Auth = exports.Article = exports.createApiInstance = exports.api = exports.http = void 0;
-const HttpClient_1 = require("./HttpClient");
+exports.View = exports.User = exports.Tag = exports.Smtp = exports.Setting = exports.Search = exports.Page = exports.Knowledge = exports.File = exports.Comment = exports.Category = exports.Auth = exports.Article = exports.api = exports.http = void 0;
+exports.createApiInstance = createApiInstance;
 // Auto-generated API instance
 const Article_1 = require("./Article");
 Object.defineProperty(exports, "Article", { enumerable: true, get: function () { return Article_1.Article; } });
@@ -13,6 +13,7 @@ const Comment_1 = require("./Comment");
 Object.defineProperty(exports, "Comment", { enumerable: true, get: function () { return Comment_1.Comment; } });
 const File_1 = require("./File");
 Object.defineProperty(exports, "File", { enumerable: true, get: function () { return File_1.File; } });
+const HttpClient_1 = require("./HttpClient");
 const Knowledge_1 = require("./Knowledge");
 Object.defineProperty(exports, "Knowledge", { enumerable: true, get: function () { return Knowledge_1.Knowledge; } });
 const Page_1 = require("./Page");
@@ -66,6 +67,5 @@ function createApiInstance(config) {
         view: new View_1.View(customHttp),
     };
 }
-exports.createApiInstance = createApiInstance;
 // Export default API instance
 exports.default = exports.api;

package/dist/app/createReactPressApp.d.ts

@@ -0,0 +1,88 @@
+/**
+ * Full-featured theme `_app` factory (UI-framework agnostic).
+ * Alias: `createCatalogThemeApp` (deprecated name).
+ */
+export function createReactPressApp(manifest: any, options?: {}): {
+    new (props: any): {
+        state: {
+            locale: string;
+            user: null;
+            /** Keep SSR and the first client render identical; sync from storage in componentDidMount. */
+            theme: string;
+            collapsed: boolean;
+            setting: null;
+            /** Full locale catalog — SSR may ship only the active locale to shrink `__NEXT_DATA__`. */
+            i18n: null;
+        };
+        prefetchRemainingI18nLocales: () => void;
+        changeLocale: (key: any) => void;
+        setUser: (user: any) => void;
+        removeUser: () => void;
+        changeTheme: (nextTheme: any) => void;
+        getSetting: () => void;
+        toggleCollapse: () => void;
+        componentDidMount(): void;
+        componentDidUpdate(_prevProps: any, prevState: any): void;
+        render(): React.DetailedReactHTMLElement<React.InputHTMLAttributes<HTMLInputElement>, HTMLInputElement>;
+        context: unknown;
+        setState<K extends string | number | symbol>(state: any, callback?: (() => void) | undefined): void;
+        forceUpdate(callback?: (() => void) | undefined): void;
+        readonly props: Readonly<any>;
+        refs: {
+            [key: string]: React.ReactInstance;
+        };
+        shouldComponentUpdate?(nextProps: Readonly<any>, nextState: Readonly<any>, nextContext: any): boolean;
+        componentWillUnmount?(): void;
+        componentDidCatch?(error: Error, errorInfo: React.ErrorInfo): void;
+        getSnapshotBeforeUpdate?(prevProps: Readonly<any>, prevState: Readonly<any>): any;
+        componentWillMount?(): void;
+        UNSAFE_componentWillMount?(): void;
+        componentWillReceiveProps?(nextProps: Readonly<any>, nextContext: any): void;
+        UNSAFE_componentWillReceiveProps?(nextProps: Readonly<any>, nextContext: any): void;
+        componentWillUpdate?(nextProps: Readonly<any>, nextState: Readonly<any>, nextContext: any): void;
+        UNSAFE_componentWillUpdate?(nextProps: Readonly<any>, nextState: Readonly<any>, nextContext: any): void;
+    };
+    new (props: any, context: any): {
+        state: {
+            locale: string;
+            user: null;
+            /** Keep SSR and the first client render identical; sync from storage in componentDidMount. */
+            theme: string;
+            collapsed: boolean;
+            setting: null;
+            /** Full locale catalog — SSR may ship only the active locale to shrink `__NEXT_DATA__`. */
+            i18n: null;
+        };
+        prefetchRemainingI18nLocales: () => void;
+        changeLocale: (key: any) => void;
+        setUser: (user: any) => void;
+        removeUser: () => void;
+        changeTheme: (nextTheme: any) => void;
+        getSetting: () => void;
+        toggleCollapse: () => void;
+        componentDidMount(): void;
+        componentDidUpdate(_prevProps: any, prevState: any): void;
+        render(): React.DetailedReactHTMLElement<React.InputHTMLAttributes<HTMLInputElement>, HTMLInputElement>;
+        context: unknown;
+        setState<K extends string | number | symbol>(state: any, callback?: (() => void) | undefined): void;
+        forceUpdate(callback?: (() => void) | undefined): void;
+        readonly props: Readonly<any>;
+        refs: {
+            [key: string]: React.ReactInstance;
+        };
+        shouldComponentUpdate?(nextProps: Readonly<any>, nextState: Readonly<any>, nextContext: any): boolean;
+        componentWillUnmount?(): void;
+        componentDidCatch?(error: Error, errorInfo: React.ErrorInfo): void;
+        getSnapshotBeforeUpdate?(prevProps: Readonly<any>, prevState: Readonly<any>): any;
+        componentWillMount?(): void;
+        UNSAFE_componentWillMount?(): void;
+        componentWillReceiveProps?(nextProps: Readonly<any>, nextContext: any): void;
+        UNSAFE_componentWillReceiveProps?(nextProps: Readonly<any>, nextContext: any): void;
+        componentWillUpdate?(nextProps: Readonly<any>, nextState: Readonly<any>, nextContext: any): void;
+        UNSAFE_componentWillUpdate?(nextProps: Readonly<any>, nextState: Readonly<any>, nextContext: any): void;
+    };
+    getInitialProps: (appContext: any) => Promise<any>;
+    origGetInitialProps: ({ Component, ctx, }: import("next/app").AppContext) => Promise<import("next/app").AppInitialProps>;
+    contextType?: React.Context<any> | undefined;
+};
+import React = require("react");

package/dist/app/createReactPressApp.js

@@ -0,0 +1,262 @@
+"use strict";
+const React = require('react');
+const App = require('next/app').default;
+const Router = require('next/router').default;
+const { fetchAppBootstrap, createDefaultAppBootstrap } = require('../theme/ssr/bootstrap');
+const { slimAppBootstrapForRoute } = require('../theme/ssr/slimBootstrap');
+const { createThemeAxiosClient } = require('../theme/api/httpClient');
+const { createThemeProviders } = require('../theme/providers');
+const { applyColorModeClass, resolveInitialColorModeState, persistColorMode, } = require('../theme/visitor/colorMode');
+const { persistVisitorLocale, readBrowserCookie, VISITOR_LOCALE_COOKIE, LEGACY_LOCALE_STORAGE_KEY, } = require('../theme/visitor/visitorLocale');
+const { clearThemeSession, persistThemeSession, resolveStoredUser, } = require('../theme/visitor/authSession');
+const { RouteProgress } = require('../ui/components/RouteProgress');
+const { SiteAnalytics } = require('../ui/components/SiteAnalytics');
+const { SiteCatalogProvider } = require('../ui/context/SiteCatalogContext');
+const { useReportPageView } = require('../ui/hooks/useReportPageView');
+const { safeJsonParse } = require('../theme/api/json');
+const { mergeVisitorI18n } = require('../theme/visitor/i18n');
+function resolveGlobalSettingForLocale(setting, locale, fallback) {
+    if (!setting?.globalSetting)
+        return fallback;
+    const raw = setting.globalSetting;
+    const parsed = typeof raw === 'string' ? safeJsonParse(raw, {}) : raw && typeof raw === 'object' ? raw : {};
+    return parsed[locale] ?? fallback;
+}
+function readStoredVisitorLocale(locales) {
+    if (typeof window === 'undefined')
+        return null;
+    try {
+        const supported = Array.isArray(locales) ? locales : [];
+        const stored = window.localStorage.getItem('reactpress-locale') ||
+            window.localStorage.getItem('locale');
+        if (stored && supported.includes(stored))
+            return stored;
+    }
+    catch {
+        // ignore
+    }
+    return null;
+}
+function ViewStatisticsBridge() {
+    useReportPageView();
+    return null;
+}
+/**
+ * Full-featured theme `_app` factory (UI-framework agnostic).
+ * Alias: `createCatalogThemeApp` (deprecated name).
+ */
+function createReactPressApp(manifest, options = {}) {
+    var _a;
+    const { Layout, buildAppearanceCss, httpClientOptions = {}, scrollToTopOnRouteChange = true, IntlProvider, wrapContent, transformBootstrap, 
+    /** When true, apply default catalog-theme SSR payload slimming (nav routes keep full siteConfig). */
+    slimBootstrap = false, } = options;
+    if (!Layout) {
+        throw new Error('createReactPressApp: options.Layout is required');
+    }
+    if (!IntlProvider) {
+        throw new Error('createReactPressApp: options.IntlProvider is required — import { NextIntlProvider } from "next-intl" in your theme');
+    }
+    if (scrollToTopOnRouteChange) {
+        Router.events.on('routeChangeComplete', () => {
+            setTimeout(() => {
+                if (document.documentElement.scrollTop > 0) {
+                    window.scrollTo({ top: 0, behavior: 'smooth' });
+                }
+            }, 0);
+        });
+    }
+    class ReactPressThemeApp extends App {
+        constructor() {
+            super(...arguments);
+            this.state = {
+                locale: '',
+                user: null,
+                /** Keep SSR and the first client render identical; sync from storage in componentDidMount. */
+                theme: 'light',
+                collapsed: false,
+                setting: null,
+                /** Full locale catalog — SSR may ship only the active locale to shrink `__NEXT_DATA__`. */
+                i18n: null,
+            };
+            this.prefetchRemainingI18nLocales = () => {
+                const locales = this.props.locales;
+                if (!Array.isArray(locales) || locales.length <= 1)
+                    return;
+                const current = this.state.i18n ?? this.props.i18n ?? {};
+                if (locales.every((key) => current[key]))
+                    return;
+                const http = createThemeAxiosClient(httpClientOptions);
+                const { SettingProvider } = createThemeProviders(http);
+                SettingProvider.getSetting()
+                    .then((res) => {
+                    const full = mergeVisitorI18n(safeJsonParse(res.i18n, {}));
+                    this.setState((prev) => ({
+                        i18n: { ...(prev.i18n ?? this.props.i18n ?? {}), ...full },
+                    }));
+                })
+                    .catch(() => {
+                    // ignore — active locale messages already available from SSR
+                });
+            };
+            this.changeLocale = (key) => {
+                if (!key)
+                    return;
+                const active = this.state.locale ||
+                    this.props.initialLocale ||
+                    (Array.isArray(this.props.locales) && this.props.locales[0]) ||
+                    'zh';
+                if (key === active)
+                    return;
+                persistVisitorLocale(key);
+                const catalog = this.state.i18n ?? this.props.i18n ?? {};
+                if (!catalog[key]) {
+                    this.prefetchRemainingI18nLocales();
+                }
+                this.setState({ locale: key });
+            };
+            this.setUser = (user) => {
+                persistThemeSession(user);
+                this.setState({ user });
+            };
+            this.removeUser = () => {
+                clearThemeSession();
+                this.setState({ user: null });
+                window.location.reload();
+            };
+            this.changeTheme = (nextTheme) => {
+                const isDark = nextTheme === 'dark';
+                applyColorModeClass(isDark);
+                persistColorMode(isDark);
+                this.setState({ theme: nextTheme });
+            };
+            this.getSetting = () => {
+                const http = createThemeAxiosClient(httpClientOptions);
+                const { SettingProvider } = createThemeProviders(http);
+                SettingProvider.getSetting().then((res) => {
+                    this.setState({ setting: res });
+                });
+            };
+            this.toggleCollapse = () => {
+                this.setState({ collapsed: !this.state.collapsed });
+            };
+        }
+        componentDidMount() {
+            const user = resolveStoredUser();
+            if (user) {
+                persistThemeSession(user);
+                this.setState({ user });
+            }
+            const preferred = resolveInitialColorModeState() ?? 'light';
+            applyColorModeClass(preferred === 'dark');
+            const patches = {};
+            if (this.state.theme !== preferred) {
+                patches.theme = preferred;
+            }
+            const ssrLocale = this.props.initialLocale ||
+                (Array.isArray(this.props.locales) && this.props.locales.length > 0
+                    ? this.props.locales[0]
+                    : 'zh');
+            const cookieLocale = readBrowserCookie(VISITOR_LOCALE_COOKIE) ||
+                readBrowserCookie(LEGACY_LOCALE_STORAGE_KEY);
+            const storedLocale = readStoredVisitorLocale(this.props.locales);
+            if (this.state.locale === '') {
+                if (cookieLocale &&
+                    Array.isArray(this.props.locales) &&
+                    this.props.locales.includes(cookieLocale) &&
+                    cookieLocale !== ssrLocale) {
+                    // Cookie is the source of truth for an explicit prior choice.
+                    patches.locale = cookieLocale;
+                }
+                else if (!cookieLocale) {
+                    // First visit or stale storage — align cookie/storage with SSR locale.
+                    persistVisitorLocale(ssrLocale);
+                }
+                else if (storedLocale && storedLocale !== ssrLocale) {
+                    persistVisitorLocale(ssrLocale);
+                }
+            }
+            if (Object.keys(patches).length > 0) {
+                this.setState(patches);
+            }
+            this.prefetchRemainingI18nLocales();
+        }
+        componentDidUpdate(_prevProps, prevState) {
+            if (prevState.theme !== this.state.theme) {
+                applyColorModeClass(this.state.theme === 'dark');
+            }
+        }
+        render() {
+            const { Component, pageProps, i18n: i18nFromProps, globalSetting, siteConfig, locales, initialLocale, tags, categories, pages, colorPrimary, themeMods = {}, ...rest } = this.props;
+            const i18n = this.state.i18n ?? i18nFromProps;
+            const locale = this.state.locale ||
+                initialLocale ||
+                (Array.isArray(locales) && locales.length > 0 ? locales[0] : null) ||
+                'zh';
+            const { needLayoutFooter = true, hasBg = false } = pageProps;
+            const message = i18n?.[locale] || {};
+            const isDark = this.state.theme === 'dark';
+            const appearanceCss = buildAppearanceCss?.(themeMods);
+            const setting = this.state.setting ?? rest.setting;
+            const catalogValue = {
+                setting,
+                i18n,
+                locale,
+                locales,
+                globalSetting,
+                siteConfig,
+                tags,
+                categories,
+                pages,
+                theme: this.state.theme,
+                collapsed: this.state.collapsed,
+                changeLocale: this.changeLocale,
+                user: this.state.user,
+                setUser: this.setUser,
+                removeUser: this.removeUser,
+                changeTheme: this.changeTheme,
+                getSetting: this.getSetting,
+                toggleCollapse: this.toggleCollapse,
+            };
+            const layout = React.createElement(Layout, {
+                needHeader: true,
+                needFooter: needLayoutFooter,
+                hasBg,
+            }, React.createElement(RouteProgress, null), React.createElement(Component, pageProps));
+            const runtime = { locale, isDark, colorPrimary, themeMods, colorMode: this.state.theme };
+            const content = wrapContent ? wrapContent(layout, runtime) : layout;
+            return React.createElement(SiteCatalogProvider, { value: catalogValue }, React.createElement(IntlProvider, { messages: message, locale }, appearanceCss
+                ? React.createElement('style', {
+                    dangerouslySetInnerHTML: { __html: appearanceCss },
+                })
+                : null, React.createElement(ViewStatisticsBridge, null), React.createElement(SiteAnalytics, null), content));
+        }
+    }
+    _a = ReactPressThemeApp;
+    ReactPressThemeApp.getInitialProps = async (appContext) => {
+        const appProps = await App.getInitialProps(appContext);
+        let bootstrap;
+        try {
+            bootstrap = await fetchAppBootstrap({
+                manifest,
+                ctx: appContext.ctx,
+            });
+        }
+        catch (error) {
+            console.error('[reactpress] fetchAppBootstrap failed, using defaults', error);
+            bootstrap = createDefaultAppBootstrap();
+        }
+        if (typeof transformBootstrap === 'function') {
+            bootstrap = transformBootstrap(bootstrap, appContext.ctx);
+        }
+        else if (slimBootstrap) {
+            bootstrap = slimAppBootstrapForRoute(bootstrap, appContext.ctx.pathname ?? '/', typeof slimBootstrap === 'object' ? slimBootstrap : undefined);
+        }
+        return {
+            ...appProps,
+            ...bootstrap,
+            pageProps: appProps.pageProps,
+        };
+    };
+    return ReactPressThemeApp;
+}
+module.exports = { createReactPressApp };

package/dist/app/createThemeApp.d.ts

@@ -0,0 +1,6 @@
+/** Minimal theme `_app` — hello-world style, ReactPressProvider + ThemeCssVars only. */
+export function createThemeApp(manifest: any): ({ Component, pageProps }: {
+    Component: any;
+    pageProps: any;
+}) => React.FunctionComponentElement<import("../ui").ReactPressProviderProps>;
+import React = require("react");

package/dist/app/createThemeApp.js

@@ -0,0 +1,47 @@
+"use strict";
+const React = require('react');
+const { createDefaultVisitorContext } = require('../theme/ssr/fetch');
+const { ReactPressProvider } = require('../ui/context/ReactPressProvider');
+const { ThemeCssVars } = require('../ui/components/ThemeCssVars');
+const { PREVIEW_TOKEN_QUERY_KEY } = require('../theme/preview/preview-draft');
+const { fetchPreviewDraft } = require('../theme/extension/preview');
+const { mergePreviewMods } = require('../theme/preview/preview-mods');
+const { DevChunkRecovery } = require('./devChunkRecovery');
+function readPreviewTokenFromBrowser() {
+    if (typeof window === 'undefined')
+        return '';
+    return new URLSearchParams(window.location.search).get(PREVIEW_TOKEN_QUERY_KEY)?.trim() ?? '';
+}
+/** Minimal theme `_app` — hello-world style, ReactPressProvider + ThemeCssVars only. */
+function createThemeApp(manifest) {
+    function ThemeApp({ Component, pageProps }) {
+        const { reactPress, ...rest } = pageProps;
+        const visitorContext = reactPress ?? createDefaultVisitorContext(manifest.id);
+        const [mods, setMods] = React.useState(() => visitorContext.mods ?? {});
+        React.useEffect(() => {
+            const base = visitorContext.mods ?? {};
+            const token = readPreviewTokenFromBrowser();
+            if (!token) {
+                setMods(base);
+                return undefined;
+            }
+            let cancelled = false;
+            void fetchPreviewDraft(token).then((draft) => {
+                if (cancelled)
+                    return;
+                setMods(mergePreviewMods(base, draft.mods ?? {}));
+            });
+            return () => {
+                cancelled = true;
+            };
+        }, [reactPress, visitorContext.mods]);
+        const providerProps = {
+            ...visitorContext,
+            mods,
+            isPreview: visitorContext.isPreview || Boolean(readPreviewTokenFromBrowser()),
+        };
+        return React.createElement(ReactPressProvider, providerProps, React.createElement(DevChunkRecovery, null), React.createElement(ThemeCssVars, null), React.createElement(Component, rest));
+    }
+    return ThemeApp;
+}
+module.exports = { createThemeApp };

package/dist/app/devChunkRecovery.d.ts

@@ -0,0 +1,2 @@
+/** Dev-only: recover from stale webpack chunks after on-demand page compilation. */
+export function DevChunkRecovery(): null;