@fecommunity/reactpress-toolkit 3.1.0 → 3.7.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+ 
+Copyright (c) 2024–2026 fecommunity
+ 
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+ 
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+ 
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/.source-fingerprint-toolkit

@@ -0,0 +1 @@
+fd5270adee7bc50a2dc021d6042bae6d01a27818a2f651724412ac8c6e1ecc14

package/dist/app/createReactPressApp.d.ts

@@ -1,88 +1,8 @@
 /**
  * Full-featured theme `_app` factory (UI-framework agnostic).
  * Alias: `createCatalogThemeApp` (deprecated name).
+ * @param {Record<string, unknown>} manifest
+ * @param {Record<string, unknown>} [options]
+ * @returns {unknown}
  */
-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");
+export function createReactPressApp(manifest: Record<string, unknown>, options?: Record<string, unknown>): unknown;

package/dist/app/createReactPressApp.js

@@ -44,6 +44,9 @@ function ViewStatisticsBridge() {
 /**
  * Full-featured theme `_app` factory (UI-framework agnostic).
  * Alias: `createCatalogThemeApp` (deprecated name).
+ * @param {Record<string, unknown>} manifest
+ * @param {Record<string, unknown>} [options]
+ * @returns {unknown}
  */
 function createReactPressApp(manifest, options = {}) {
     var _a;

package/dist/app/createThemeApp.d.ts

@@ -1,6 +1,8 @@
-/** 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");
+/**
+ * Minimal theme `_app` — hello-world style, ReactPressProvider + ThemeCssVars only.
+ * @param {{ id: string }} manifest
+ * @returns {unknown}
+ */
+export function createThemeApp(manifest: {
+    id: string;
+}): unknown;

package/dist/app/createThemeApp.js

@@ -12,7 +12,11 @@ function readPreviewTokenFromBrowser() {
         return '';
     return new URLSearchParams(window.location.search).get(PREVIEW_TOKEN_QUERY_KEY)?.trim() ?? '';
 }
-/** Minimal theme `_app` — hello-world style, ReactPressProvider + ThemeCssVars only. */
+/**
+ * Minimal theme `_app` — hello-world style, ReactPressProvider + ThemeCssVars only.
+ * @param {{ id: string }} manifest
+ * @returns {unknown}
+ */
 function createThemeApp(manifest) {
     function ThemeApp({ Component, pageProps }) {
         const { reactPress, ...rest } = pageProps;

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

@@ -0,0 +1,37 @@
+import type { AdminSlotId } from './slots';
+export interface PluginAdminContext {
+    id: string;
+    config: Record<string, unknown>;
+}
+/** Plugin admin entry — called once per active plugin when admin shell loads. */
+export interface PluginAdminModule {
+    registerAdmin(registry: PluginAdminRegistry, ctx: PluginAdminContext): void | Promise<void>;
+}
+/** Opaque component type — React `ComponentType` lives in `@fecommunity/reactpress-toolkit/plugin/react`. */
+export type PluginAdminSlotComponent = (props: PluginAdminSlotComponentProps<unknown>) => unknown;
+export interface PluginAdminSlotComponentProps<TContext = unknown> {
+    context: TContext;
+    pluginId: string;
+    config: Record<string, unknown>;
+}
+export interface PluginAdminSlotContribution {
+    pluginId: string;
+    slot: AdminSlotId;
+    priority: number;
+    Component: PluginAdminSlotComponent;
+}
+export interface PluginAdminRegistry {
+    registerSlot<TContext = unknown>(slot: AdminSlotId, component: (props: PluginAdminSlotComponentProps<TContext>) => unknown, options?: {
+        priority?: number;
+    }): void;
+}
+export interface PluginAdminSlotHost {
+    registerSlot<TContext = unknown>(pluginId: string, slot: AdminSlotId, component: (props: PluginAdminSlotComponentProps<TContext>) => unknown, options?: {
+        priority?: number;
+    }): void;
+    getContributions(slot: AdminSlotId): PluginAdminSlotContribution[];
+    reset(): void;
+}
+export declare function createPluginAdminSlotHost(): PluginAdminSlotHost;
+/** Registry passed to `registerAdmin` — scopes contributions to one plugin id. */
+export declare function createPluginAdminRegistry(pluginId: string, host: PluginAdminSlotHost): PluginAdminRegistry;

package/dist/plugin/admin/plugin-admin.js

@@ -0,0 +1,41 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createPluginAdminSlotHost = createPluginAdminSlotHost;
+exports.createPluginAdminRegistry = createPluginAdminRegistry;
+function createPluginAdminSlotHost() {
+    const contributions = [];
+    return {
+        registerSlot(pluginId, slot, component, options) {
+            const priority = options?.priority ?? 10;
+            const existing = contributions.findIndex((item) => item.pluginId === pluginId && item.slot === slot);
+            const entry = {
+                pluginId,
+                slot,
+                Component: component,
+                priority,
+            };
+            if (existing >= 0) {
+                contributions[existing] = entry;
+            }
+            else {
+                contributions.push(entry);
+            }
+        },
+        getContributions(slot) {
+            return contributions
+                .filter((item) => item.slot === slot)
+                .sort((a, b) => a.priority - b.priority);
+        },
+        reset() {
+            contributions.length = 0;
+        },
+    };
+}
+/** Registry passed to `registerAdmin` — scopes contributions to one plugin id. */
+function createPluginAdminRegistry(pluginId, host) {
+    return {
+        registerSlot(slot, component, options) {
+            host.registerSlot(pluginId, slot, component, options);
+        },
+    };
+}

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

@@ -0,0 +1,36 @@
+/** Built-in admin UI slot identifiers. Plugins register React components against these ids. */
+export declare const AdminSlotIds: {
+    /** 文章编辑器 · 摘要面板下方（SEO、自定义 meta 等） */
+    readonly ARTICLE_EDITOR_META_AFTER_SUMMARY: "article.editor.meta.afterSummary";
+    /** 文章编辑器 · 右侧发布框下方 */
+    readonly ARTICLE_EDITOR_SIDEBAR_AFTER_PUBLISH: "article.editor.sidebar.afterPublish";
+};
+export type AdminSlotId = (typeof AdminSlotIds)[keyof typeof AdminSlotIds];
+/** All built-in slot ids — used for manifest validation and JSON Schema enum. */
+export declare const ALL_ADMIN_SLOT_IDS: readonly AdminSlotId[];
+export declare function isAdminSlotId(value: string): value is AdminSlotId;
+export interface AdminSlotDefinition {
+    id: AdminSlotId;
+    /** Human-readable label for plugin authors / docs */
+    title: string;
+    /** Core module that owns the host surface */
+    module: string;
+    description?: string;
+}
+/** Draft fields exposed to article editor slots. Host pages may extend via `context`. */
+export interface ArticleEditorDraftFields {
+    title: string;
+    summary: string;
+    slug: string;
+    seoKeywords: string;
+    seoDescription: string;
+    status: 'draft' | 'publish';
+}
+/** Context passed to `article.editor.*` slot components from the article editor page. */
+export interface ArticleEditorAdminSlotContext {
+    articleId?: string;
+    draft: ArticleEditorDraftFields;
+    patch: <K extends keyof ArticleEditorDraftFields>(key: K, value: ArticleEditorDraftFields[K]) => void;
+    /** Host-provided i18n helper (typically `react-i18next` `t`). */
+    translate: (key: string) => string;
+}

package/dist/plugin/admin/slots.js

@@ -0,0 +1,16 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ALL_ADMIN_SLOT_IDS = exports.AdminSlotIds = void 0;
+exports.isAdminSlotId = isAdminSlotId;
+/** Built-in admin UI slot identifiers. Plugins register React components against these ids. */
+exports.AdminSlotIds = {
+    /** 文章编辑器 · 摘要面板下方（SEO、自定义 meta 等） */
+    ARTICLE_EDITOR_META_AFTER_SUMMARY: 'article.editor.meta.afterSummary',
+    /** 文章编辑器 · 右侧发布框下方 */
+    ARTICLE_EDITOR_SIDEBAR_AFTER_PUBLISH: 'article.editor.sidebar.afterPublish',
+};
+/** All built-in slot ids — used for manifest validation and JSON Schema enum. */
+exports.ALL_ADMIN_SLOT_IDS = Object.values(exports.AdminSlotIds);
+function isAdminSlotId(value) {
+    return exports.ALL_ADMIN_SLOT_IDS.includes(value);
+}

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

@@ -0,0 +1,4 @@
+export * from './plugin';
+export * from './plugin-admin-locale';
+export * from './security';
+export * from './validate';

package/dist/plugin/extension/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __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 });
+__exportStar(require("./plugin"), exports);
+__exportStar(require("./plugin-admin-locale"), exports);
+__exportStar(require("./security"), exports);
+__exportStar(require("./validate"), exports);

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

@@ -0,0 +1,21 @@
+import { getNestedLocaleString, getNestedLocaleValue } from '../../utils/object';
+/** Admin copy shipped with the plugin (`locales/{locale}.json`). */
+export type PluginAdminLocaleMessages = Record<string, unknown>;
+export declare const PLUGIN_LOCALE_DIR = "locales";
+export { getNestedLocaleString, getNestedLocaleValue };
+type PluginSchemaProperty = {
+    type?: string;
+    title?: string;
+    description?: string;
+    properties?: Record<string, PluginSchemaProperty>;
+    items?: PluginSchemaProperty | PluginSchemaProperty[];
+};
+export type PluginSettingsSchema = Record<string, unknown> & {
+    title?: string;
+    description?: string;
+    properties?: Record<string, PluginSchemaProperty>;
+};
+/** Resolve admin copy from plugin locale bundle; falls back to manifest text. */
+export declare function resolvePluginAdminLocaleText(messages: PluginAdminLocaleMessages | null | undefined, dotPath: string, fallback?: string): string;
+/** Apply plugin admin locale messages to settings JSON Schema titles/descriptions. */
+export declare function localizePluginSettingsSchemaWithLocale(schema: PluginSettingsSchema | null | undefined, messages: PluginAdminLocaleMessages | null | undefined): PluginSettingsSchema | null;

package/dist/plugin/extension/plugin-admin-locale.io.d.ts

@@ -0,0 +1,2 @@
+import { type PluginAdminLocaleMessages } from './plugin-admin-locale';
+export declare function readPluginAdminLocaleFile(pluginDir: string, locale: string): PluginAdminLocaleMessages | null;

package/dist/plugin/extension/plugin-admin-locale.io.js

@@ -0,0 +1,54 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readPluginAdminLocaleFile = readPluginAdminLocaleFile;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const plugin_admin_locale_1 = require("./plugin-admin-locale");
+function readPluginAdminLocaleFile(pluginDir, locale) {
+    const safeLocale = /^[a-z]{2}(?:-[a-z]{2})?$/i.test(locale) ? locale : 'en';
+    const filePath = path.join(pluginDir, plugin_admin_locale_1.PLUGIN_LOCALE_DIR, `${safeLocale}.json`);
+    if (!fs.existsSync(filePath))
+        return null;
+    try {
+        const raw = JSON.parse(fs.readFileSync(filePath, 'utf8'));
+        return raw && typeof raw === 'object' && !Array.isArray(raw)
+            ? raw
+            : null;
+    }
+    catch {
+        return null;
+    }
+}

package/dist/plugin/extension/plugin-admin-locale.js

@@ -0,0 +1,60 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getNestedLocaleValue = exports.getNestedLocaleString = exports.PLUGIN_LOCALE_DIR = void 0;
+exports.resolvePluginAdminLocaleText = resolvePluginAdminLocaleText;
+exports.localizePluginSettingsSchemaWithLocale = localizePluginSettingsSchemaWithLocale;
+const object_1 = require("../../utils/object");
+Object.defineProperty(exports, "getNestedLocaleString", { enumerable: true, get: function () { return object_1.getNestedLocaleString; } });
+Object.defineProperty(exports, "getNestedLocaleValue", { enumerable: true, get: function () { return object_1.getNestedLocaleValue; } });
+exports.PLUGIN_LOCALE_DIR = 'locales';
+/** Resolve admin copy from plugin locale bundle; falls back to manifest text. */
+function resolvePluginAdminLocaleText(messages, dotPath, fallback) {
+    const fromLocale = messages ? (0, object_1.getNestedLocaleString)(messages, dotPath) : undefined;
+    if (fromLocale)
+        return fromLocale;
+    return fallback?.trim() ?? '';
+}
+function localizeSchemaField(field, pathParts, resolve) {
+    if (typeof field.title === 'string') {
+        field.title = resolve([...pathParts, 'title'].join('.'), field.title);
+    }
+    if (typeof field.description === 'string') {
+        field.description = resolve([...pathParts, 'description'].join('.'), field.description);
+    }
+    if (field.properties) {
+        for (const [key, child] of Object.entries(field.properties)) {
+            localizeSchemaField(child, [...pathParts, key], resolve);
+        }
+    }
+    const items = field.items;
+    if (items && typeof items === 'object' && !Array.isArray(items)) {
+        const itemSchema = items;
+        if (itemSchema.properties) {
+            for (const [key, child] of Object.entries(itemSchema.properties)) {
+                localizeSchemaField(child, [...pathParts, 'items', key], resolve);
+            }
+        }
+        else {
+            localizeSchemaField(itemSchema, [...pathParts, 'items'], resolve);
+        }
+    }
+}
+/** Apply plugin admin locale messages to settings JSON Schema titles/descriptions. */
+function localizePluginSettingsSchemaWithLocale(schema, messages) {
+    if (!schema)
+        return null;
+    const out = structuredClone(schema);
+    const resolve = (dotPath, fallback) => resolvePluginAdminLocaleText(messages, `settings.${dotPath}`, fallback);
+    if (typeof out.title === 'string') {
+        out.title = resolve('title', out.title);
+    }
+    if (typeof out.description === 'string') {
+        out.description = resolve('description', out.description);
+    }
+    if (out.properties) {
+        for (const [key, field] of Object.entries(out.properties)) {
+            localizeSchemaField(field, [key], resolve);
+        }
+    }
+    return out;
+}

package/dist/plugin/extension/plugin.d.ts

@@ -0,0 +1,82 @@
+/** WordPress-style plugin manifest and site plugin state (shared by server / web). */
+import type { AdminSlotId } from '../admin/slots';
+export interface PluginServerManifest {
+    module: string;
+    hooks?: {
+        subscribe?: string[];
+        provide?: string[];
+    };
+}
+export interface PluginAdminMenuManifest {
+    parent?: string;
+    title: string;
+    path: string;
+    permission?: string;
+    sort?: number;
+}
+/** Declarative admin UI — mirrors `server.hooks.subscribe` for Admin slots. */
+export interface PluginAdminSlotsManifest {
+    /** Built-in slot ids this plugin mounts UI into (see `AdminSlotIds`). */
+    subscribe?: AdminSlotId[];
+}
+export interface PluginAdminManifest {
+    /** @deprecated Use convention `admin/index.ts`; declared slots drive loading. */
+    entry?: string;
+    slots?: PluginAdminSlotsManifest;
+    menu?: PluginAdminMenuManifest;
+}
+export interface PluginSettingsManifest {
+    schema?: Record<string, unknown>;
+}
+export interface PluginCapabilities {
+    headless?: boolean;
+    network?: boolean;
+    filesystem?: boolean;
+    database?: boolean;
+}
+export interface PluginManifest {
+    id: string;
+    name: string;
+    version: string;
+    description?: string;
+    author?: string;
+    requires?: string;
+    requiresPlugins?: string[];
+    server?: PluginServerManifest;
+    admin?: PluginAdminManifest;
+    settings?: PluginSettingsManifest;
+    permissions?: string[];
+    capabilities?: PluginCapabilities;
+}
+export interface PluginEntryMeta {
+    version: string;
+    source: 'local' | 'npm';
+    config?: Record<string, unknown>;
+    activatedAt?: string;
+    npm?: {
+        spec: string;
+        resolvedVersion?: string;
+        packageName?: string;
+        installedAt?: string;
+    };
+    loadError?: string;
+}
+export interface SitePluginState {
+    installedPlugins: string[];
+    activePlugins: string[];
+    entries: Record<string, PluginEntryMeta>;
+}
+export declare const defaultSitePluginState: SitePluginState;
+export interface GlobalSettingWithPlugins {
+    theme?: unknown;
+    plugins?: SitePluginState;
+    [key: string]: unknown;
+}
+export declare function isValidPluginId(id: string): boolean;
+export declare function parsePluginManifest(raw: unknown): PluginManifest | null;
+export declare function getPluginStateFromGlobalSetting(raw: unknown): SitePluginState;
+export declare function mergePluginStateIntoGlobalSetting(raw: unknown, patch: Partial<SitePluginState>): GlobalSettingWithPlugins;
+/** Conventional admin module path relative to plugin package root. */
+export declare const PLUGIN_ADMIN_MODULE_CONVENTION = "admin/index";
+/** Whether manifest declares admin UI (slot and/or settings menu). */
+export declare function pluginManifestHasAdminUI(admin: PluginAdminManifest | undefined): boolean;