@chatbi-v/core 2.1.0 → 2.1.2

package/dist/api/engine.d.ts

@@ -1,87 +0,0 @@
-import { ApiAdapter, ApiConfig, ApiEndpointConfig, ApiInterceptor, RequestOptions } from '../ports/api-port';
-/**
- * API 引擎核心类
- * @description 负责加载配置并执行请求，支持策略模式切换底层请求实现
- */
-export declare class ApiEngine {
-    private adapter;
-    private config;
-    private interceptors;
-    constructor(adapter?: ApiAdapter);
-    /**
-     * 注册拦截器
-     */
-    registerInterceptor(interceptor: ApiInterceptor): void;
-    /**
-     * 移除拦截器
-     */
-    unregisterInterceptor(interceptor: ApiInterceptor): void;
-    /**
-     * 切换请求适配器
-     * @param adapter 新的适配器实例
-     */
-    useAdapter(adapter: ApiAdapter): void;
-    /**
-     * 注册 API 配置
-     * @param config 配置对象
-     */
-    register(config: ApiConfig): void;
-    /**
-     * 获取接口配置
-     */
-    getEndpoint(module: string, action: string): ApiEndpointConfig | undefined;
-    /**
-     * 发起 API 请求
-     * @param module 模块名
-     * @param action 动作名
-     * @param data 请求数据 (Body 或 Query)
-     * @param options 请求选项
-     */
-    call<T = any>(module: string, action: string, data?: any, options?: RequestOptions): Promise<T>;
-    /**
-     * 发起流式请求
-     * @param module 模块名
-     * @param action 动作名
-     * @param data 请求数据
-     * @param options 请求选项
-     */
-    stream(module: string, action: string, data?: any, options?: RequestOptions): Promise<void>;
-    /**
-     * 准备请求配置，应用 URL 参数替换和请求拦截器
-     */
-    private prepareRequestConfig;
-    /**
-     * 应用所有请求拦截器
-     */
-    private applyRequestInterceptors;
-    /**
-     * 应用所有响应拦截器
-     * @returns 是否被劫持
-     */
-    private applyResponseInterceptors;
-    /**
-     * 检查 HTTP 状态码
-     */
-    private checkHttpStatus;
-    /**
-     * 提取响应数据
-     */
-    private extractResponseData;
-    /**
-     * 处理业务错误
-     */
-    private handleBusinessError;
-    /**
-     * 判断是否为 BaseResponse
-     */
-    private isBaseResponse;
-    /**
-     * 严格判断是否为 AxiosResponse
-     */
-    private isAxiosResponse;
-    /**
-     * 创建拦截上下文
-     */
-    private createInterceptorContext;
-}
-export declare const apiEngine: ApiEngine;

package/dist/api/index.d.ts

@@ -1,6 +0,0 @@
-export * from './adapters/axios-adapter';
-export * from './engine';
-export * from './utils';
-export * from '../domain/models';
-export * from '../ports/api-port';
-export * from '../ports/plugin-port';

package/dist/api/utils.d.ts

@@ -1,14 +0,0 @@
-import { ApiConfig } from '../ports/api-port';
-/**
- * 自动检测是否处于 Mock 模式
- */
-export declare function isMockMode(): boolean;
-/**
- * 从文件模块映射中解析 API 配置
- * @description 配合 Vite 的 import.meta.glob 使用，自动匹配定义文件和 Mock 文件
- * @param definitionsMap API 定义文件映射 (import.meta.glob('./modules/*.ts', { eager: true }))
- * @param mocksMap Mock 文件映射 (import.meta.glob('./modules/*.mock.ts', { eager: true }))
- * @param useMock 是否启用 Mock (如果不传，将自动调用 isMockMode())
- * @returns 合并后的 ApiConfig
- */
-export declare function resolveApiModules(definitionsMap: Record<string, any>, mocksMap?: Record<string, any>): ApiConfig;

package/dist/api-context.d.ts

@@ -1,8 +0,0 @@
-import React from 'react';
-import type { ApiEngine } from './api';
-export interface ApiProviderProps {
-    api: ApiEngine;
-    children: React.ReactNode;
-}
-export declare const ApiProvider: React.FC<ApiProviderProps>;
-export declare const useApi: () => ApiEngine;

package/dist/application/service-registry.d.ts

@@ -1,57 +0,0 @@
-/**
- * 服务注册中心 (Service Registry)
- * @description 核心应用层服务，作为微内核架构中的“中枢调度员”。
- * 主要职责：
- * 1. 服务解耦：允许插件将其内部功能暴露为“服务”，而无需与其他插件产生物理依赖。
- * 2. 动态发现：提供按名称查找服务的能力，支持服务热插拔。
- * 3. 依赖协调：通过 `waitFor` 机制解决插件间由于加载顺序导致的初始化依赖问题。
- *
- * 建议的服务命名规范: `pluginId.serviceName` (例如: `auth.sessionService`)
- */
-export declare class ServiceRegistry {
-    /** 存储已注册服务的 Map 对象 */
-    private services;
-    /** 存储正在等待特定服务的监听器集合 */
-    private listeners;
-    /**
-     * 注册一个服务实现
-     * @param name - 唯一的服务名称
-     * @param service - 服务实例或对象
-     */
-    register(name: string, service: any): void;
-    /**
-     * 同步获取服务实例
-     * @template T - 服务类型的泛型
-     * @param name - 服务名称
-     * @returns 服务实例，若不存在则返回 undefined
-     */
-    get<T = any>(name: string): T | undefined;
-    /**
-     * 异步等待并获取服务
-     * @description 如果服务尚未注册，将返回一个 Promise，直到该服务被注册时 resolve。
-     * 支持设置超时时间，防止因插件加载失败导致的永久挂起。
-     *
-     * @template T - 服务类型的泛型
-     * @param name - 待等待的服务名称
-     * @param timeout - 超时时间 (毫秒)，默认 10000ms (10秒)。若为 0 则永不超时。
-     * @returns 包含服务实例的 Promise
-     * @throws {Error} 若在规定时间内服务未注册，则抛出超时异常。
-     */
-    waitFor<T = any>(name: string, timeout?: number): Promise<T>;
-    /**
-     * 检查服务是否已注册
-     * @param name - 服务名称
-     */
-    has(name: string): boolean;
-    /**
-     * 注销特定的服务
-     * @param name - 服务名称
-     */
-    unregister(name: string): void;
-    /**
-     * 清除所有已注册的服务和监听器
-     * @description 通常仅在系统重置或大型热更新时使用。
-     */
-    clear(): void;
-}
-export declare const serviceRegistry: ServiceRegistry;

package/dist/chunk-O74KYN5N.mjs

@@ -1 +0,0 @@
-var s=class{config=new Map;set(t,e){this.config.set(t,e)}get(t){return this.config.get(t)}merge(t){Object.keys(t).forEach(e=>{let i=this.config.get(e),n=t[e];i&&typeof i=="object"&&n&&typeof n=="object"?this.config.set(e,{...i,...n}):this.config.set(e,n)})}getAll(){return Object.fromEntries(this.config)}},c=new s;export{s as a,c as b};

package/dist/components/PluginErrorBoundary.d.ts

@@ -1,44 +0,0 @@
-import React, { Component, ErrorInfo, ReactNode } from 'react';
-/** 插件错误边界组件属性 */
-interface Props {
-    /** 发生错误的插件 ID */
-    pluginId?: string;
-    /** 错误发生时的降级 UI */
-    fallback?: ReactNode;
-    /** 子组件内容 */
-    children: ReactNode;
-    /** 是否静默模式，开启后不显示任何错误 UI，仅记录日志 */
-    silent?: boolean;
-}
-/** 插件错误边界组件状态 */
-interface State {
-    /** 是否捕获到错误 */
-    hasError: boolean;
-    /** 捕获到的错误对象 */
-    error: Error | null;
-}
-/**
- * 插件错误边界组件
- * @description 核心组件，用于捕获子组件渲染过程中的 JavaScript 错误，记录日志并显示降级 UI。
- * 确保单个插件的运行异常不会导致整个主应用或其他插件崩溃。
- */
-export declare class PluginErrorBoundary extends Component<Props, State> {
-    constructor(props: Props);
-    /**
-     * 从错误中派生状态
-     * @param error - 捕获到的错误
-     */
-    static getDerivedStateFromError(error: Error): State;
-    /**
-     * 捕获到错误后的回调
-     * @param error - 错误对象
-     * @param errorInfo - 错误堆栈信息
-     */
-    componentDidCatch(error: Error, errorInfo: ErrorInfo): void;
-    /**
-     * 重置错误状态，尝试重新渲染
-     */
-    handleRetry: () => void;
-    render(): string | number | boolean | Iterable<React.ReactNode> | import("react/jsx-runtime").JSX.Element | null | undefined;
-}
-export {};

package/dist/components/PluginSlot.d.ts

@@ -1,35 +0,0 @@
-import React from 'react';
-import type { PluginExtension, SlotPosition } from '../api';
-/** 插件插槽组件属性 */
-interface PluginSlotProps {
-    /** 插槽位置标识，决定渲染哪些插件扩展 */
-    slot: SlotPosition;
-    /** 传递给扩展组件的 Props 对象 */
-    props?: Record<string, any>;
-    /** 自定义容器类名 (Tailwind CSS) */
-    className?: string;
-    /** 自定义容器内联样式 */
-    style?: React.CSSProperties;
-    /**
-     * 自定义渲染函数
-     * @param item - 包含 key、组件和扩展元信息的对象
-     * @param index - 索引位置
-     */
-    renderItem?: (item: {
-        key: string;
-        component: React.ReactNode;
-        extension: PluginExtension;
-    }, index: number) => React.ReactNode;
-    /** 骨架屏组件，当插槽内无插件扩展时显示的占位 UI */
-    skeleton?: React.ReactNode;
-    /** 回退组件，当插槽内无插件扩展时显示的 UI，优先级高于 skeleton */
-    fallback?: React.ReactNode;
-}
-/**
- * 插件插槽组件
- * @description UI 层的核心组件，用于在应用中声明一个“插槽”。
- * 它会自动根据 slot 标识从 PluginManager 中获取所有注册的插件扩展组件并按顺序渲染。
- * 支持订阅插件变更，实现动态热插拔。
- */
-export declare const PluginSlot: React.FC<PluginSlotProps>;
-export {};

package/dist/components/SlotSkeletons.d.ts

@@ -1,27 +0,0 @@
-import React from 'react';
-/**
- * 通用插槽骨架屏组件集合
- * @description 提供一组预定义的骨架屏 UI，用于在插件加载或插槽内容未准备好时提供更好的用户体验。
- */
-/**
- * 侧边栏图标骨架屏
- * @param expanded - 是否处于展开状态
- */
-export declare const SidebarIconSkeleton: React.FC<{
-    expanded?: boolean;
-}>;
-/**
- * 状态栏项骨架屏
- */
-export declare const StatusBarItemSkeleton: React.FC;
-/**
- * 头像骨架屏
- */
-export declare const AvatarSkeleton: React.FC;
-/**
- * 通用块级骨架屏
- * @param className - 自定义类名
- */
-export declare const BlockSkeleton: React.FC<{
-    className?: string;
-}>;

package/dist/config-manager-LQITPSUA.mjs

@@ -1 +0,0 @@
-import{a,b}from"./chunk-O74KYN5N.mjs";export{a as ConfigManager,b as configManager};

package/dist/config-manager.d.ts

@@ -1,34 +0,0 @@
-/**
- * 配置管理器
- * @description 核心工具类，负责管理应用的全局系统配置以及各插件的初始化业务配置。
- * 配置数据通常在应用启动时通过 `usePluginLoader` 注入，并作为插件运行时的取值回退来源。
- */
-export declare class ConfigManager {
-    /** 内部存储配置的 Map 对象 */
-    private config;
-    /**
-     * 设置特定的配置项
-     * @param key - 配置键名（如 'system' 或插件 ID）
-     * @param value - 配置内容对象
-     */
-    set(key: string, value: any): void;
-    /**
-     * 获取指定的配置项
-     * @param key - 配置键名
-     * @returns 配置内容，若不存在则返回 undefined
-     */
-    get(key: string): any;
-    /**
-     * 批量合并配置对象
-     * @description 对顶层属性进行浅合并，若属性值为对象则进行一层深度的合并。
-     * @param config - 待合并的配置对象映射
-     */
-    merge(config: Record<string, any>): void;
-    /**
-     * 获取当前存储的所有配置快照
-     * @returns 包含所有配置的普通对象
-     */
-    getAll(): Record<string, any>;
-}
-/** 全局配置管理器单例 */
-export declare const configManager: ConfigManager;

package/dist/domain/auto-loader.d.ts

@@ -1,36 +0,0 @@
-/**
- * 插件注册表接口
- * @description 键为插件 ID，值为一个返回插件定义的异步加载函数。
- */
-export interface PluginRegistry {
-    [pluginId: string]: () => Promise<any>;
-}
-/**
- * 插件自动发现规则
- */
-export interface DiscoveryRule {
-    /**
-     * 路径匹配标识。
-     * @example 'plugins' 或 '@chatbi-plugins'
-     */
-    pathSegment: string;
-    /**
-     * 生成插件 ID 时的前缀。
-     * @example '@chatbi-v/plugin'，最终生成如 '@chatbi-v/plugin-demo'
-     */
-    idPrefix: string;
-}
-/**
- * 解析插件注册表
- * @description 核心逻辑：将 Vite 的 `import.meta.glob` 结果映射为标准的插件注册表。
- * 它会根据预定义的路径匹配规则，从文件路径中提取插件目录名，并拼接前缀生成唯一的插件 ID。
- *
- * @param options - 包含待处理模块和匹配规则的选项对象
- * @returns 解析后的 PluginRegistry 对象
- */
-export declare const resolvePluginRegistry: (options: {
-    /** 原始模块映射 (来自 Vite glob) */
-    modules: Record<string, () => Promise<any>>;
-    /** 自定义发现规则 (可选) */
-    rules?: DiscoveryRule[];
-}) => PluginRegistry;

package/dist/domain/models.d.ts

@@ -1,42 +0,0 @@
-/**
- * 成功状态码
- */
-export declare const SUCCESS_CODE = "000000";
-/**
- * 基础 API 响应接口
- * @template T 响应数据的类型
- */
-export interface BaseResponse<T = any> {
-    /** 业务状态码 */
-    code: string | number;
-    /** 响应消息提示 */
-    message: string;
-    /** 业务响应数据主体 */
-    data: T;
-}
-/**
- * 业务场景实体接口
- * @description 描述系统中的业务分析场景
- */
-export interface Scene {
-    /** 场景唯一标识符 */
-    id: string;
-    /** 场景名称 */
-    name: string;
-    /** 场景详细描述 */
-    description: string;
-    /** 场景内部代码/标识 */
-    code: string;
-    /** 场景创建者 ID 或名称 */
-    creator: string;
-    /** 创建时间字符串 (ISO 格式) */
-    createTime: string;
-    /** 该场景关联的物理数据表数量 */
-    tableCount: number;
-    /** 该场景关联的知识库数量 */
-    kbCount: number;
-    /** 该场景关联的预设问答对数量 */
-    qaCount: number;
-    /** 场景封面图 URL (可选) */
-    cover?: string;
-}

package/dist/domain/plugin-manager.d.ts

@@ -1,215 +0,0 @@
-/**
- * @file plugin-manager.ts
- * @description 插件管理器，负责插件的注册、生命周期管理、状态持久化及扩展点收集
- * @author ChatBI Team
- */
-import { DefaultEventBus } from '../event-bus';
-import { Plugin, PluginExtension, RouteConfig, SlotPosition } from '../ports/plugin-port';
-import { StoragePort } from '../ports/storage-port';
-import { StorageManager } from './storage-manager';
-/**
- * 插件管理器
- * @description 核心领域服务，负责插件的完整生命周期管理，包括扫描、注册、配置合并、状态切换及依赖解析。
- */
-export declare class PluginManager {
-    /** 全局事件总线，用于插件间及插件与内核间的异步通信 */
-    readonly eventBus: DefaultEventBus;
-    /** 存储管理服务，负责插件私有存储和系统级状态的持久化 */
-    private storageManager;
-    /** 插件 ID 到运行时实例的映射表 */
-    private runtimes;
-    /** 插件 ID 到原始插件定义对象的映射表 */
-    private plugins;
-    /** 收集到的所有插件路由配置 */
-    private routes;
-    /** 收集到的所有插件扩展点配置，按插槽位置分组 */
-    private extensions;
-    /** 插件的启用状态和排序信息的内存缓存 */
-    private pluginStates;
-    /** 状态变更监听器集合，支持按插槽过滤 */
-    private listeners;
-    /** 按插槽位置存储的监听器，用于精确通知 */
-    private slotListeners;
-    /** 扩展点缓存，避免重复计算 */
-    private memoizedExtensions;
-    /** 路由缓存 */
-    private memoizedRoutes;
-    /** 传递给插件的共享上下文缓存 */
-    private sharedContext;
-    /** 收集到的插件工具函数集合 */
-    private utils;
-    /**
-     * 构造函数
-     * @param storage - 底层存储适配器
-     */
-    constructor(storage: StoragePort);
-    /**
-     * 从持久化存储中恢复插件状态 (启用/禁用、排序等)
-     */
-    private loadStates;
-    /**
-     * 将当前的插件状态持久化到存储中
-     */
-    private saveStates;
-    /**
-     * 订阅插件状态的变更通知
-     * @param listener - 变更时的回调函数
-     * @param slot - (可选) 指定监听的插槽位置，若提供则仅在该插槽受影响时通知
-     * @returns 取消订阅的函数
-     */
-    subscribe(listener: () => void, slot?: SlotPosition | string): () => void;
-    /**
-     * 获取存储管理器实例
-     * @returns StorageManager 实例
-     */
-    getStorageManager(): StorageManager;
-    /**
-     * 触发状态变更通知
-     * @param affectedSlot - (可选) 受影响的插槽位置
-     */
-    private notify;
-    /**
-     * 获取所有已注册的插件列表
-     * @description 结果会根据插件类型优先级和用户自定义排序进行排序
-     * @returns 排序后的插件数组
-     */
-    getPlugins(): Plugin[];
-    /**
-     * 获取指定插件的状态信息
-     * @param pluginId - 插件 ID
-     * @returns 包含启用状态和排序值的对象
-     */
-    getPluginState(pluginId: string): {
-        enabled: boolean;
-        order: number;
-    };
-    /**
-     * 检查指定插件是否处于启用状态
-     * @param pluginId - 插件 ID
-     * @returns 是否启用
-     */
-    isPluginEnabled(pluginId: string): boolean;
-    /**
-     * 切换插件的启用/禁用状态
-     * @description 禁用插件会立即触发其卸载生命周期并销毁运行时。
-     * @param pluginId - 插件 ID
-     * @param enabled - 目标状态
-     */
-    togglePlugin(pluginId: string, enabled: boolean): void;
-    /**
-     * 设置插件的显示排序权重
-     * @param pluginId - 插件 ID
-     * @param order - 排序权重值
-     */
-    setPluginOrder(pluginId: string, order: number): void;
-    /**
-     * 获取指定插件的运行时状态
-     * @param pluginId - 插件 ID
-     * @returns 'error' | 'mounted' | 'loaded' | 'initial'
-     */
-    getPluginRuntimeStatus(pluginId: string): "error" | "mounted" | "loaded" | "initial";
-    /**
-     * 获取指定插件的运行时错误
-     * @param pluginId - 插件 ID
-     * @returns Error 对象或 null
-     */
-    getPluginError(pluginId: string): Error | null;
-    /**
-     * 报告插件运行时错误 (通常由 ErrorBoundary 调用)
-     * @param pluginId - 插件 ID
-     * @param error - 错误对象
-     */
-    reportPluginError(pluginId: string, error: Error): void;
-    /**
-     * 获取插件的完整能力声明
-     * @param pluginId - 插件 ID
-     * @returns 能力对象
-     */
-    getUnifiedCapabilities(pluginId: string): import("..").PluginCapabilities;
-    /**
-     * 更新指定插件的某项配置
-     * @description 该操作会同步更新内存中的配置、持久化到存储并触发全局事件通知。
-     * @param pluginId - 插件 ID
-     * @param key - 配置键名
-     * @param value - 新的配置值
-     */
-    updatePluginConfig(pluginId: string, key: string, value: any): void;
-    /**
-     * 获取指定插件的某项配置值
-     * @param pluginId - 插件 ID
-     * @param key - 配置键名
-     * @returns 配置值
-     */
-    getPluginConfig(pluginId: string, key: string): any;
-    /**
-     * 获取系统全局配置 (非插件特定)
-     * @param key - 系统配置键名
-     * @returns 配置值
-     */
-    getSystemConfig(key: string): any;
-    /**
-     * 获取由插件注册的服务实例
-     * @template T 服务接口类型
-     * @param name - 服务注册名称
-     * @returns 服务实例或 undefined
-     */
-    getService<T = any>(name: string): T | undefined;
-    /**
-     * 获取指定插槽位置的所有已启用插件的扩展
-     * @param slot - 插槽位置标识
-     * @returns 排序后的扩展配置数组
-     */
-    getExtensions(slot: SlotPosition | string): PluginExtension[];
-    /**
-     * 获取所有已启用插件注册的路由配置
-     * @returns 增强后的路由配置数组
-     */
-    getRoutes(): RouteConfig[];
-    /**
-     * 注册一个新插件到管理器中
-     * @description 此阶段会执行元数据校验、存储 Schema 注册、配置合并及扩展点收集。
-     * @param plugin - 插件对象
-     * @param notify - 是否在注册完成后触发状态变更通知
-     */
-    register(plugin: Plugin, notify?: boolean): void;
-    /**
-     * 初始化所有插件
-     * @param sharedContext 共享上下文
-     */
-    initPlugins(sharedContext?: Record<string, any>): Promise<void>;
-    /**
-     * 获取排序后的插件 ID 列表 (处理依赖)
-     */
-    private getSortedPluginIds;
-    /**
-     * 加载插件列表
-     * @param configs 插件配置
-     * @param registry 插件注册表 (动态导入函数)
-     */
-    loadPlugins(configs: Record<string, any>, registry: Record<string, () => Promise<any>>): Promise<void>;
-    /**
-     * 加载远程插件
-     * @param pluginId 插件 ID
-     * @param url 远程 URL
-     * @param config 插件配置
-     */
-    loadRemotePlugin(pluginId: string, url: string, config: any): Promise<Plugin | null>;
-    /**
-     * IIFE 模式加载插件
-     */
-    private loadIIFEPlugin;
-    /**
-     * 实例化插件
-     */
-    private instantiatePlugin;
-    private validatePlugin;
-    private handleBusinessPlugin;
-    private handleFunctionalPlugin;
-    private handleViewPlugin;
-    private handleThemePlugin;
-    private handleSystemPlugin;
-}
-/**
- * 全局插件管理器实例
- */
-export declare const pluginManager: PluginManager;