@zero-bits/kernel 1.0.0

package/dist/react/index.cjs

@@ -0,0 +1,147 @@
+"use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _interopRequireDefault(obj) { return obj && obj.__esModule ? obj : { default: obj }; } function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
+
+
+var _chunkETCJDJTIcjs = require('../chunk-ETCJDJTI.cjs');
+
+// src/react/PluginSlot.tsx
+var _react = require('react'); var _react2 = _interopRequireDefault(_react);
+var KernelContext = _react2.default.createContext(null);
+function KernelProvider({ kernel, children }) {
+  return /* @__PURE__ */ _react2.default.createElement(KernelContext.Provider, { value: kernel }, children);
+}
+var PluginErrorBoundary = class extends _react2.default.Component {
+  constructor(props) {
+    super(props);
+    this.state = { error: null };
+  }
+  static getDerivedStateFromError(error) {
+    return { error };
+  }
+  render() {
+    if (this.state.error) {
+      if (this.props.fallback) return this.props.fallback(this.state.error);
+      const pluginError = new (0, _chunkETCJDJTIcjs.PluginError)(this.props.pluginName, `\u6E32\u67D3\u5D29\u6E83: ${this.state.error.message}`);
+      return /* @__PURE__ */ _react2.default.createElement(DefaultErrorUI, { pluginName: this.props.pluginName, error: pluginError, retry: () => this.setState({ error: null }) });
+    }
+    return this.props.children;
+  }
+};
+function toPluginError(pluginName, err) {
+  if (err instanceof _chunkETCJDJTIcjs.PluginError) return err;
+  const message = err instanceof Error ? err.message : String(err);
+  return new (0, _chunkETCJDJTIcjs.PluginError)(pluginName, message);
+}
+function DefaultErrorUI({ pluginName, error, retry }) {
+  return /* @__PURE__ */ _react2.default.createElement(
+    "div",
+    {
+      style: {
+        padding: "12px 16px",
+        border: "1px solid #ff4d4f",
+        borderRadius: 6,
+        color: "#ff4d4f",
+        background: "#fff2f0"
+      }
+    },
+    /* @__PURE__ */ _react2.default.createElement("strong", { style: { fontSize: 14 } }, "\u63D2\u4EF6 [", pluginName, "] \u52A0\u8F7D\u5931\u8D25"),
+    /* @__PURE__ */ _react2.default.createElement("p", { style: { margin: "4px 0 8px", fontSize: 12, opacity: 0.85 } }, error.message),
+    /* @__PURE__ */ _react2.default.createElement(
+      "button",
+      {
+        onClick: retry,
+        style: {
+          background: "none",
+          border: "1px solid currentColor",
+          borderRadius: 4,
+          color: "inherit",
+          padding: "2px 8px",
+          cursor: "pointer",
+          fontSize: 12
+        }
+      },
+      "\u91CD\u8BD5"
+    )
+  );
+}
+function RemotePluginLoader({
+  pluginName,
+  url,
+  styleUrls,
+  themeConfig,
+  fallback,
+  renderError,
+  restProps
+}) {
+  const kernel = _react.useContext.call(void 0, KernelContext);
+  const [Component, setComponent] = _react.useState.call(void 0, null);
+  const [error, setError] = _react.useState.call(void 0, null);
+  const [retryCount, setRetryCount] = _react.useState.call(void 0, 0);
+  const styleUrlsKey = _nullishCoalesce(_optionalChain([styleUrls, 'optionalAccess', _ => _.join, 'call', _2 => _2(",")]), () => ( ""));
+  _react.useEffect.call(void 0, () => {
+    let alive = true;
+    const loadFn = kernel ? kernel.loadPlugin.bind(kernel) : _chunkETCJDJTIcjs.loadRemotePlugin;
+    loadFn(pluginName, { url, styleUrls: styleUrlsKey ? styleUrlsKey.split(",") : [] }).then((exports) => {
+      if (!alive) return;
+      const Comp = _nullishCoalesce(_optionalChain([exports, 'optionalAccess', _3 => _3.default]), () => ( exports));
+      setComponent(() => Comp);
+      setError(null);
+    }).catch((err) => {
+      if (alive) setError(toPluginError(pluginName, err));
+    });
+    return () => {
+      alive = false;
+    };
+  }, [pluginName, url, styleUrlsKey, retryCount, kernel]);
+  const handleRetry = () => {
+    setError(null);
+    setRetryCount((c) => c + 1);
+  };
+  if (error) return renderError ? renderError(error, handleRetry) : /* @__PURE__ */ _react2.default.createElement(DefaultErrorUI, { pluginName, error, retry: handleRetry });
+  if (!Component) return /* @__PURE__ */ _react2.default.createElement(_react2.default.Fragment, null, fallback);
+  return /* @__PURE__ */ _react2.default.createElement(
+    PluginErrorBoundary,
+    {
+      pluginName,
+      fallback: (err) => renderError ? renderError(toPluginError(pluginName, err), handleRetry) : void 0
+    },
+    /* @__PURE__ */ _react2.default.createElement(Component, { themeConfig, ...restProps })
+  );
+}
+function PluginSlot(props) {
+  const {
+    pluginName,
+    url,
+    styleUrls,
+    localComponent: LocalComponent,
+    themeConfig,
+    fallback = /* @__PURE__ */ _react2.default.createElement("span", { style: { color: "#bbb", fontSize: 12 } }, "\u63D2\u4EF6\u52A0\u8F7D\u4E2D..."),
+    renderError,
+    ...restProps
+  } = props;
+  if (LocalComponent) {
+    return /* @__PURE__ */ _react2.default.createElement(_react.Suspense, { fallback }, /* @__PURE__ */ _react2.default.createElement(LocalComponent, { themeConfig, ...restProps }));
+  }
+  if (!url) {
+    const err = new (0, _chunkETCJDJTIcjs.PluginError)(pluginName, `\u63D2\u4EF6 [${pluginName}] \u5728\u751F\u4EA7\u73AF\u5883\u4E0B\u5FC5\u987B\u63D0\u4F9B url \u53C2\u6570`);
+    return renderError ? /* @__PURE__ */ _react2.default.createElement(_react2.default.Fragment, null, renderError(err, () => {
+    })) : /* @__PURE__ */ _react2.default.createElement(DefaultErrorUI, { pluginName, error: err, retry: () => {
+    } });
+  }
+  return /* @__PURE__ */ _react2.default.createElement(
+    RemotePluginLoader,
+    {
+      pluginName,
+      url,
+      styleUrls,
+      themeConfig,
+      fallback,
+      renderError,
+      restProps
+    }
+  );
+}
+
+
+
+
+exports.KernelContext = KernelContext; exports.KernelProvider = KernelProvider; exports.PluginSlot = PluginSlot;

package/dist/react/index.d.cts

@@ -0,0 +1,42 @@
+import React from 'react';
+import { e as PluginError, a as KernelInstance } from '../types-JlxTjSfC.cjs';
+
+interface PluginSlotProps<Theme = unknown> {
+    /** 插件唯一标识符（需与 rollup amd.id 一致） */
+    pluginName: string;
+    /** 远端插件 JS 地址（生产环境使用） */
+    url?: string;
+    /** 配套的远端 CSS 地址列表（生产环境使用） */
+    styleUrls?: string[];
+    /** 本地开发组件（由 dev-plugins alias 注入，完整保留 HMR） */
+    localComponent?: any;
+    /** 主题配置，透传给插件的 ConfigProvider（泛型，不强绑定 Antd） */
+    themeConfig?: Theme;
+    /** 加载中占位节点，默认为行内文字提示 */
+    fallback?: any;
+    /** 自定义错误渲染，接收分级 PluginError 和重试函数 */
+    renderError?: (err: PluginError, retry: () => void) => any;
+    /** 其余业务透传参数 */
+    [key: string]: any;
+}
+
+declare const KernelContext: React.Context<KernelInstance | null>;
+/**
+ * 内核提供者组件，用于将内核实例注入到组件树中，供子组件使用
+ * @param kernel 内核实例
+ * @param children 子元素
+ * @returns ReactNode
+ */
+declare function KernelProvider({ kernel, children }: {
+    kernel: KernelInstance;
+    children: React.ReactNode;
+}): React.JSX.Element;
+
+/**
+ * 插件插槽
+ * @param props 插件插槽参数
+ * @returns 插件组件
+ */
+declare function PluginSlot(props: PluginSlotProps): React.JSX.Element;
+
+export { KernelContext, KernelProvider, PluginSlot, type PluginSlotProps };

package/dist/react/index.d.ts

@@ -0,0 +1,42 @@
+import React from 'react';
+import { e as PluginError, a as KernelInstance } from '../types-JlxTjSfC.js';
+
+interface PluginSlotProps<Theme = unknown> {
+    /** 插件唯一标识符（需与 rollup amd.id 一致） */
+    pluginName: string;
+    /** 远端插件 JS 地址（生产环境使用） */
+    url?: string;
+    /** 配套的远端 CSS 地址列表（生产环境使用） */
+    styleUrls?: string[];
+    /** 本地开发组件（由 dev-plugins alias 注入，完整保留 HMR） */
+    localComponent?: any;
+    /** 主题配置，透传给插件的 ConfigProvider（泛型，不强绑定 Antd） */
+    themeConfig?: Theme;
+    /** 加载中占位节点，默认为行内文字提示 */
+    fallback?: any;
+    /** 自定义错误渲染，接收分级 PluginError 和重试函数 */
+    renderError?: (err: PluginError, retry: () => void) => any;
+    /** 其余业务透传参数 */
+    [key: string]: any;
+}
+
+declare const KernelContext: React.Context<KernelInstance | null>;
+/**
+ * 内核提供者组件，用于将内核实例注入到组件树中，供子组件使用
+ * @param kernel 内核实例
+ * @param children 子元素
+ * @returns ReactNode
+ */
+declare function KernelProvider({ kernel, children }: {
+    kernel: KernelInstance;
+    children: React.ReactNode;
+}): React.JSX.Element;
+
+/**
+ * 插件插槽
+ * @param props 插件插槽参数
+ * @returns 插件组件
+ */
+declare function PluginSlot(props: PluginSlotProps): React.JSX.Element;
+
+export { KernelContext, KernelProvider, PluginSlot, type PluginSlotProps };

package/dist/react/index.js

@@ -0,0 +1,147 @@
+import {
+  PluginError,
+  loadRemotePlugin
+} from "../chunk-D4E5XKWD.js";
+
+// src/react/PluginSlot.tsx
+import React, { Suspense, useEffect, useState, useContext } from "react";
+var KernelContext = React.createContext(null);
+function KernelProvider({ kernel, children }) {
+  return /* @__PURE__ */ React.createElement(KernelContext.Provider, { value: kernel }, children);
+}
+var PluginErrorBoundary = class extends React.Component {
+  constructor(props) {
+    super(props);
+    this.state = { error: null };
+  }
+  static getDerivedStateFromError(error) {
+    return { error };
+  }
+  render() {
+    if (this.state.error) {
+      if (this.props.fallback) return this.props.fallback(this.state.error);
+      const pluginError = new PluginError(this.props.pluginName, `\u6E32\u67D3\u5D29\u6E83: ${this.state.error.message}`);
+      return /* @__PURE__ */ React.createElement(DefaultErrorUI, { pluginName: this.props.pluginName, error: pluginError, retry: () => this.setState({ error: null }) });
+    }
+    return this.props.children;
+  }
+};
+function toPluginError(pluginName, err) {
+  if (err instanceof PluginError) return err;
+  const message = err instanceof Error ? err.message : String(err);
+  return new PluginError(pluginName, message);
+}
+function DefaultErrorUI({ pluginName, error, retry }) {
+  return /* @__PURE__ */ React.createElement(
+    "div",
+    {
+      style: {
+        padding: "12px 16px",
+        border: "1px solid #ff4d4f",
+        borderRadius: 6,
+        color: "#ff4d4f",
+        background: "#fff2f0"
+      }
+    },
+    /* @__PURE__ */ React.createElement("strong", { style: { fontSize: 14 } }, "\u63D2\u4EF6 [", pluginName, "] \u52A0\u8F7D\u5931\u8D25"),
+    /* @__PURE__ */ React.createElement("p", { style: { margin: "4px 0 8px", fontSize: 12, opacity: 0.85 } }, error.message),
+    /* @__PURE__ */ React.createElement(
+      "button",
+      {
+        onClick: retry,
+        style: {
+          background: "none",
+          border: "1px solid currentColor",
+          borderRadius: 4,
+          color: "inherit",
+          padding: "2px 8px",
+          cursor: "pointer",
+          fontSize: 12
+        }
+      },
+      "\u91CD\u8BD5"
+    )
+  );
+}
+function RemotePluginLoader({
+  pluginName,
+  url,
+  styleUrls,
+  themeConfig,
+  fallback,
+  renderError,
+  restProps
+}) {
+  const kernel = useContext(KernelContext);
+  const [Component, setComponent] = useState(null);
+  const [error, setError] = useState(null);
+  const [retryCount, setRetryCount] = useState(0);
+  const styleUrlsKey = styleUrls?.join(",") ?? "";
+  useEffect(() => {
+    let alive = true;
+    const loadFn = kernel ? kernel.loadPlugin.bind(kernel) : loadRemotePlugin;
+    loadFn(pluginName, { url, styleUrls: styleUrlsKey ? styleUrlsKey.split(",") : [] }).then((exports) => {
+      if (!alive) return;
+      const Comp = exports?.default ?? exports;
+      setComponent(() => Comp);
+      setError(null);
+    }).catch((err) => {
+      if (alive) setError(toPluginError(pluginName, err));
+    });
+    return () => {
+      alive = false;
+    };
+  }, [pluginName, url, styleUrlsKey, retryCount, kernel]);
+  const handleRetry = () => {
+    setError(null);
+    setRetryCount((c) => c + 1);
+  };
+  if (error) return renderError ? renderError(error, handleRetry) : /* @__PURE__ */ React.createElement(DefaultErrorUI, { pluginName, error, retry: handleRetry });
+  if (!Component) return /* @__PURE__ */ React.createElement(React.Fragment, null, fallback);
+  return /* @__PURE__ */ React.createElement(
+    PluginErrorBoundary,
+    {
+      pluginName,
+      fallback: (err) => renderError ? renderError(toPluginError(pluginName, err), handleRetry) : void 0
+    },
+    /* @__PURE__ */ React.createElement(Component, { themeConfig, ...restProps })
+  );
+}
+function PluginSlot(props) {
+  const {
+    pluginName,
+    url,
+    styleUrls,
+    localComponent: LocalComponent,
+    themeConfig,
+    fallback = /* @__PURE__ */ React.createElement("span", { style: { color: "#bbb", fontSize: 12 } }, "\u63D2\u4EF6\u52A0\u8F7D\u4E2D..."),
+    renderError,
+    ...restProps
+  } = props;
+  if (LocalComponent) {
+    return /* @__PURE__ */ React.createElement(Suspense, { fallback }, /* @__PURE__ */ React.createElement(LocalComponent, { themeConfig, ...restProps }));
+  }
+  if (!url) {
+    const err = new PluginError(pluginName, `\u63D2\u4EF6 [${pluginName}] \u5728\u751F\u4EA7\u73AF\u5883\u4E0B\u5FC5\u987B\u63D0\u4F9B url \u53C2\u6570`);
+    return renderError ? /* @__PURE__ */ React.createElement(React.Fragment, null, renderError(err, () => {
+    })) : /* @__PURE__ */ React.createElement(DefaultErrorUI, { pluginName, error: err, retry: () => {
+    } });
+  }
+  return /* @__PURE__ */ React.createElement(
+    RemotePluginLoader,
+    {
+      pluginName,
+      url,
+      styleUrls,
+      themeConfig,
+      fallback,
+      renderError,
+      restProps
+    }
+  );
+}
+export {
+  KernelContext,
+  KernelProvider,
+  PluginSlot
+};

package/dist/types-JlxTjSfC.d.cts

@@ -0,0 +1,120 @@
+/**
+ * 日志接口
+ */
+interface KernelLogger {
+    warn: (msg: string) => void;
+    error: (msg: string) => void;
+}
+interface KernelOptions {
+    /** 插件加载超时时间（ms），默认 10000 */
+    timeout?: number;
+    /** 网络失败自动重试次数，默认 2 */
+    retryCount?: number;
+    /** script 标签的 CSP nonce 值 */
+    nonce?: string;
+    /** false 时静默所有内部 warn/log，默认 true */
+    debug?: boolean;
+    /** 全局拦截器的命名空间前缀，默认 '__KERNEL__' */
+    namespace: string;
+    /** 自定义 logger，默认使用 console */
+    logger?: KernelLogger;
+    /** 插件开始加载时的钩子 */
+    onLoadStart?: (pluginName: string) => void;
+    /** 插件加载成功后的钩子 */
+    onLoadSuccess?: (pluginName: string) => void;
+    /** 插件加载失败后的全局错误钩子 */
+    onLoadError?: (pluginName: string, error: PluginError) => void;
+}
+interface ModuleEntry {
+    /** 已解析的模块实例（加载完成后赋值） */
+    module: any;
+    /** 模块加载的 Promise，挂起直到 definePlugin 回调完成 */
+    _promise: Promise<any>;
+    /** 外部控制的 resolve 方法（Deferred 模式） */
+    _resolve?: (value: any) => void;
+    /** 外部控制的 reject 方法（Deferred 模式） */
+    _reject?: (reason?: any) => void;
+    /** 同步标记：脚本解析完成前是否合法调用了 define */
+    _defineCalled?: boolean;
+    /** 当前条目的状态 */
+    status: 'pending' | 'resolved' | 'rejected';
+    /** 加载时使用的 url（用于缓存失效判断） */
+    url?: string;
+}
+interface PluginLoadOptions {
+    /** 插件主 JS 入口地址 */
+    url: string;
+    /** 可选的配套 CSS 样式地址列表 */
+    styleUrls?: string[];
+}
+interface KernelInstance {
+    /**
+     * 注册主应用的共享依赖（如 react、antd）
+     * 已注册过的模块默认不允许重复覆盖，传入 { force: true } 可强制覆盖
+     */
+    regSharedModule(name: string, instance: any, options?: {
+        force?: boolean;
+    }): void;
+    /**
+     * 加载远端插件，返回其导出模块
+     * 内置：并发去重、URL 变更缓存失效、超时控制、指数退避重试、分级错误、生命周期钩子
+     */
+    loadPlugin<T = any>(pluginName: string, options: PluginLoadOptions): Promise<T>;
+    /**
+     * 卸载插件，清除 registry 中的缓存
+     * 下次调用 loadPlugin 时会重新加载
+     */
+    unloadPlugin(pluginName: string): void;
+    /**
+     * 预加载远端插件资源到浏览器缓存（不执行）
+     * @param options 插件地址或配置
+     */
+    preloadPlugin(options: PluginLoadOptions): void;
+    /**
+     * 销毁内核实例，清空所有状态（用于测试隔离或多租户场景）
+     */
+    destroy(): void;
+    /** 判断内核是否已完成初始化 */
+    isInitialized(): boolean;
+}
+/**
+ * 错误基类
+ */
+declare class PluginError extends Error {
+    readonly pluginName: string;
+    cause?: unknown;
+    constructor(pluginName: string, message: string);
+}
+/**
+ * 网络层错误：script 标签加载失败
+*/
+declare class PluginNetworkError extends PluginError {
+    constructor(pluginName: string, url: string, cause?: unknown);
+}
+/**
+ * 加载超时错误
+ */
+declare class PluginTimeoutError extends PluginError {
+    constructor(pluginName: string, timeout: number);
+}
+/**
+ * 依赖注入错误：插件声明的依赖在共享池中不存在
+ */
+declare class PluginDependencyError extends PluginError {
+    readonly dependency: string;
+    constructor(pluginName: string, dependency: string);
+}
+/**
+ * 执行错误：插件 factory 函数内部抛出异常
+ */
+declare class PluginExecutionError extends PluginError {
+    constructor(pluginName: string, cause?: unknown);
+}
+/**
+ * 引擎未初始化错误
+ */
+declare class KernelNotInitializedError extends Error {
+    constructor();
+}
+
+export { type KernelOptions as K, type ModuleEntry as M, type PluginLoadOptions as P, type KernelInstance as a, type KernelLogger as b, KernelNotInitializedError as c, PluginDependencyError as d, PluginError as e, PluginExecutionError as f, PluginNetworkError as g, PluginTimeoutError as h };

package/dist/types-JlxTjSfC.d.ts

@@ -0,0 +1,120 @@
+/**
+ * 日志接口
+ */
+interface KernelLogger {
+    warn: (msg: string) => void;
+    error: (msg: string) => void;
+}
+interface KernelOptions {
+    /** 插件加载超时时间（ms），默认 10000 */
+    timeout?: number;
+    /** 网络失败自动重试次数，默认 2 */
+    retryCount?: number;
+    /** script 标签的 CSP nonce 值 */
+    nonce?: string;
+    /** false 时静默所有内部 warn/log，默认 true */
+    debug?: boolean;
+    /** 全局拦截器的命名空间前缀，默认 '__KERNEL__' */
+    namespace: string;
+    /** 自定义 logger，默认使用 console */
+    logger?: KernelLogger;
+    /** 插件开始加载时的钩子 */
+    onLoadStart?: (pluginName: string) => void;
+    /** 插件加载成功后的钩子 */
+    onLoadSuccess?: (pluginName: string) => void;
+    /** 插件加载失败后的全局错误钩子 */
+    onLoadError?: (pluginName: string, error: PluginError) => void;
+}
+interface ModuleEntry {
+    /** 已解析的模块实例（加载完成后赋值） */
+    module: any;
+    /** 模块加载的 Promise，挂起直到 definePlugin 回调完成 */
+    _promise: Promise<any>;
+    /** 外部控制的 resolve 方法（Deferred 模式） */
+    _resolve?: (value: any) => void;
+    /** 外部控制的 reject 方法（Deferred 模式） */
+    _reject?: (reason?: any) => void;
+    /** 同步标记：脚本解析完成前是否合法调用了 define */
+    _defineCalled?: boolean;
+    /** 当前条目的状态 */
+    status: 'pending' | 'resolved' | 'rejected';
+    /** 加载时使用的 url（用于缓存失效判断） */
+    url?: string;
+}
+interface PluginLoadOptions {
+    /** 插件主 JS 入口地址 */
+    url: string;
+    /** 可选的配套 CSS 样式地址列表 */
+    styleUrls?: string[];
+}
+interface KernelInstance {
+    /**
+     * 注册主应用的共享依赖（如 react、antd）
+     * 已注册过的模块默认不允许重复覆盖，传入 { force: true } 可强制覆盖
+     */
+    regSharedModule(name: string, instance: any, options?: {
+        force?: boolean;
+    }): void;
+    /**
+     * 加载远端插件，返回其导出模块
+     * 内置：并发去重、URL 变更缓存失效、超时控制、指数退避重试、分级错误、生命周期钩子
+     */
+    loadPlugin<T = any>(pluginName: string, options: PluginLoadOptions): Promise<T>;
+    /**
+     * 卸载插件，清除 registry 中的缓存
+     * 下次调用 loadPlugin 时会重新加载
+     */
+    unloadPlugin(pluginName: string): void;
+    /**
+     * 预加载远端插件资源到浏览器缓存（不执行）
+     * @param options 插件地址或配置
+     */
+    preloadPlugin(options: PluginLoadOptions): void;
+    /**
+     * 销毁内核实例，清空所有状态（用于测试隔离或多租户场景）
+     */
+    destroy(): void;
+    /** 判断内核是否已完成初始化 */
+    isInitialized(): boolean;
+}
+/**
+ * 错误基类
+ */
+declare class PluginError extends Error {
+    readonly pluginName: string;
+    cause?: unknown;
+    constructor(pluginName: string, message: string);
+}
+/**
+ * 网络层错误：script 标签加载失败
+*/
+declare class PluginNetworkError extends PluginError {
+    constructor(pluginName: string, url: string, cause?: unknown);
+}
+/**
+ * 加载超时错误
+ */
+declare class PluginTimeoutError extends PluginError {
+    constructor(pluginName: string, timeout: number);
+}
+/**
+ * 依赖注入错误：插件声明的依赖在共享池中不存在
+ */
+declare class PluginDependencyError extends PluginError {
+    readonly dependency: string;
+    constructor(pluginName: string, dependency: string);
+}
+/**
+ * 执行错误：插件 factory 函数内部抛出异常
+ */
+declare class PluginExecutionError extends PluginError {
+    constructor(pluginName: string, cause?: unknown);
+}
+/**
+ * 引擎未初始化错误
+ */
+declare class KernelNotInitializedError extends Error {
+    constructor();
+}
+
+export { type KernelOptions as K, type ModuleEntry as M, type PluginLoadOptions as P, type KernelInstance as a, type KernelLogger as b, KernelNotInitializedError as c, PluginDependencyError as d, PluginError as e, PluginExecutionError as f, PluginNetworkError as g, PluginTimeoutError as h };

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@zero-bits/kernel",
+  "version": "1.0.0",
+  "description": "A framework-agnostic kernel for plugin loading and dependency injection.",
+  "type": "module",
+  "exports": {
+    ".": {
+      "types": "./dist/core/index.d.ts",
+      "import": "./dist/core/index.js",
+      "require": "./dist/core/index.cjs"
+    },
+    "./react": {
+      "types": "./dist/react/index.d.ts",
+      "import": "./dist/react/index.js",
+      "require": "./dist/react/index.cjs"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "publishConfig": {
+    "access": "public",
+    "registry": "https://registry.npmjs.org/"
+  },
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch"
+  },
+  "peerDependencies": {
+    "react": ">=16.8.0",
+    "react-dom": ">=16.8.0"
+  },
+  "devDependencies": {
+    "@types/react": "^18.0.0",
+    "tsup": "^8.0.0",
+    "typescript": "^5.0.0"
+  }
+}