@chatbi-v/core 2.1.0 → 2.1.2

package/dist/ports/plugin-port.d.ts

@@ -1,308 +0,0 @@
-import React from 'react';
-import { ApiConfig } from './api-port';
-import { EventBusPort } from './event-bus-port';
-import { TypedStorage } from './storage-port';
-/**
- * 插件类型定义
- */
-export declare const PLUGIN_TYPES: readonly ["business", "functional", "view", "theme", "renderer", "system"];
-export type PluginType = typeof PLUGIN_TYPES[number];
-/**
- * 路由配置
- */
-export interface RouteConfig {
-    path: string;
-    component: React.ComponentType<any>;
-    meta?: Record<string, any>;
-}
-/**
- * 插件插槽位置
- * @description 定义插件可以注入 UI 的标准位置
- */
-export declare const Slot: {
-    readonly Sidebar: "sidebar";
-    readonly SidebarPanel: "sidebar-panel";
-    readonly Header: "header";
-    readonly StatusBar: "status-bar";
-    readonly Settings: "settings";
-    readonly MessageRenderer: "message-renderer";
-    readonly MessageContentRenderer: "message-content-renderer";
-    readonly SidebarSystem: "sidebar-system";
-    readonly SidebarBottom: "sidebar-bottom";
-    readonly RootLayout: "root-layout";
-    readonly Custom: "custom";
-};
-export type SlotType = typeof Slot[keyof typeof Slot];
-export type SlotPosition = SlotType | string;
-/**
- * 插件扩展 (插槽注入配置)
- */
-export interface PluginExtension {
-    /** 插槽位置标识符 */
-    slot: SlotPosition;
-    /** 要注入的 React 组件 */
-    component: React.ComponentType<any>;
-    /** 排序权重，数值越小越靠前 */
-    order?: number;
-    /** @internal 插件 ID，由系统在加载时自动注入，用于溯源 */
-    _pluginId?: string;
-    /** 扩展的元数据信息 */
-    meta?: {
-        /** 显示图标 */
-        icon?: React.ReactNode;
-        /** 显示标签文本 */
-        label?: string;
-        /** 详细描述 */
-        description?: string;
-        /** 唯一标识符，用于某些特定插槽的索引 */
-        key?: string;
-        /** 允许其他自定义属性 */
-        [key: string]: any;
-    };
-}
-/**
- * 插件配置项定义
- */
-export interface PluginConfigItem {
-    /** 配置键名 */
-    key: string;
-    /** 配置类型 */
-    type: 'string' | 'number' | 'boolean' | 'select';
-    /** 配置显示的标签 */
-    label: string;
-    /** 配置描述信息 */
-    description?: string;
-    /** 默认值 */
-    default?: any;
-    /** 当类型为 select 时的选项列表 */
-    options?: {
-        label: string;
-        value: any;
-    }[];
-    /** 选择模式：支持多选或标签模式 (AntD 风格) */
-    mode?: 'multiple' | 'tags';
-    /** 最小值 (针对 number 类型) */
-    min?: number;
-    /** 最大值 (针对 number 类型) */
-    max?: number;
-}
-/**
- * 插件能力定义 (Behavioral Capabilities)
- * @description 定义插件的行为特征。注意：路由(routes)和扩展(extensions)属于结构化能力，直接通过 metadata 字段声明，不在此列。
- */
-export interface PluginCapabilities {
-    /**
-     * 是否支持配置设置
-     * @default false (如果 metadata.configuration 存在，则可能被隐式视为 true，建议显式声明)
-     */
-    configurable?: boolean;
-    /**
-     * 是否可嵌入其他页面
-     * @description 声明该插件是否可以作为 Widget 被其他插件引用
-     */
-    embeddable?: boolean;
-    /**
-     * 是否支持多实例
-     * @description 默认为 false (单例)。如果在聊天窗口中每个会话都需要独立状态，则设为 true
-     */
-    multiInstance?: boolean;
-    /**
-     * 是否需要后台运行
-     * @description 如果为 true，即使 UI 不可见，插件也不会被卸载
-     */
-    background?: boolean;
-    [key: string]: boolean | undefined;
-}
-/**
- * 存储项数据结构定义 (Schema)
- */
-export interface StorageItemSchema {
-    /** 存储键名 */
-    key: string;
-    /** 数据类型 */
-    type: 'string' | 'number' | 'boolean' | 'object' | 'array';
-    /** 默认值 */
-    default?: any;
-    /** 描述信息 */
-    description?: string;
-    /**
-     * 作用域
-     * @description 'plugin' 表示仅当前插件可见（带插件 ID 前缀），'shared' 表示全局共享
-     */
-    scope?: 'plugin' | 'shared';
-}
-/**
- * 插件存储接口
- * @description 包含私有存储和共享存储访问能力
- */
-export interface PluginStorage extends TypedStorage {
-    /** 获取插件私有存储数据 */
-    get: TypedStorage['get'];
-    /** 设置插件私有存储数据 */
-    set: TypedStorage['set'];
-    /** 移除插件私有存储数据 */
-    remove: TypedStorage['remove'];
-    /** 全局共享存储访问 */
-    shared: TypedStorage & {
-        /** 获取全局共享存储数据 */
-        get: TypedStorage['get'];
-        /** 设置全局共享存储数据 */
-        set: TypedStorage['set'];
-        /** 移除全局共享存储数据 */
-        remove: TypedStorage['remove'];
-    };
-}
-/**
- * 插件生命周期 Hooks
- * @description 插件可以在不同的生命周期阶段执行特定的逻辑
- */
-export interface PluginLifecycle {
-    /**
-     * 插件加载时调用
-     * @description 在插件被扫描并注入内核时触发。用于初始化内部状态、注册服务、设置拦截器等。此时 UI 尚未挂载。
-     * @param context - 插件上下文对象，提供核心能力的访问
-     */
-    onLoad?: (context: PluginContext) => void | Promise<void>;
-    /**
-     * 插件挂载到 UI 时调用
-     * @description 当插件的 UI 组件（如有）被 React 挂载到 DOM 时触发。
-     * @param context - 插件上下文对象
-     */
-    onMount?: (context: PluginContext) => void;
-    /**
-     * 插件从 UI 卸载时调用
-     * @description 当插件的 UI 组件被销毁时触发。用于清理定时器、取消订阅等。
-     * @param context - 插件上下文对象
-     */
-    onUnmount?: (context: PluginContext) => void;
-    /**
-     * 插件配置发生变化时调用
-     * @description 当用户通过配置中心修改插件设置时触发。
-     * @param newConfig - 变更后的新配置对象
-     * @param oldConfig - 变更前的旧配置对象
-     */
-    onConfigChange?: (newConfig: any, oldConfig: any) => void;
-}
-/**
- * 插件上下文
- * @description 传递给插件生命周期钩子的核心对象，是插件访问宿主环境能力的唯一入口。
- */
-export interface PluginContext {
-    /** 当前插件的唯一标识符 */
-    pluginId: string;
-    /** API 请求能力入口 */
-    api: any;
-    /** 事件总线能力入口 */
-    events: EventBusPort;
-    /** 存储管理能力入口 */
-    storage: PluginStorage;
-    /** 日志输出工具，自动携带插件 ID 前缀 */
-    logger: {
-        debug: (...args: any[]) => void;
-        info: (...args: any[]) => void;
-        warn: (...args: any[]) => void;
-        error: (...args: any[]) => void;
-    };
-    /**
-     * 访问其他插件提供的服务
-     * @param serviceName - 服务注册名称
-     * @returns 服务实例，如果不存在则返回 undefined
-     */
-    getService: <T = any>(serviceName: string) => T | undefined;
-    /**
-     * 注册当前插件的服务供他人使用
-     * @param serviceName - 唯一服务名称
-     * @param service - 服务实现对象
-     */
-    registerService: (serviceName: string, service: any) => void;
-    /** 宿主环境 Window 的代理对象 (用于沙箱隔离) */
-    window: WindowProxy;
-}
-/**
- * 完整的插件对象定义
- */
-export interface Plugin extends PluginLifecycle {
-    /**
-     * 插件唯一标识符
-     * @description 必须与 metadata.id 一致，通常为只读。
-     */
-    readonly id: string;
-    /** 插件元数据配置 */
-    metadata: PluginMetadata;
-    /** 插件提供的功能组件集合 (可选) */
-    components?: Record<string, React.ComponentType<any>>;
-    /** 插件提供的工具函数集合 (可选) */
-    utils?: Record<string, any>;
-    /** 插件的初始默认配置 (可选) */
-    defaultConfig?: Record<string, any>;
-}
-/**
- * 插件基础类
- * @deprecated 建议统一使用工厂模式 definePlugin() 定义插件，以消除类与对象定义的歧义。
- * @description 解决插件定义时 id 与 metadata.id 重复定义的问题，并提供基础生命周期管理
- */
-export declare abstract class BasePlugin implements Plugin {
-    abstract metadata: PluginMetadata;
-    /**
-     * 插件 ID
-     * @description 自动从 metadata.id 获取
-     */
-    get id(): string;
-    onLoad?(context: PluginContext): void | Promise<void>;
-    onMount?(context: PluginContext): void;
-    onUnmount?(context: PluginContext): void;
-    onConfigChange?(newConfig: any, oldConfig: any): void;
-}
-/**
- * 辅助函数：定义插件并自动从 metadata.id 注入顶级 id
- * @description 解决插件定义时 id 与 metadata.id 重复定义的问题，提高代码优雅度
- * @param plugin 插件定义（不包含顶级 id）
- * @returns 完整的插件对象
- */
-export declare function definePlugin(plugin: Omit<Plugin, 'id'>): Plugin;
-/**
- * 插件元数据定义
- * @description 描述插件的静态属性，用于插件市场展示、权限校验和内核加载参考。
- */
-export interface PluginMetadata {
-    /** 插件唯一 ID (推荐反向域名格式，如 com.company.plugin) */
-    id: string;
-    /** 插件显示名称 */
-    name: string;
-    /** 插件版本号 (符合 SemVer 规范) */
-    version: string;
-    /** 插件类型 */
-    type: PluginType;
-    /** 插件功能描述 */
-    description?: string;
-    /** 插件作者信息 */
-    author?: string;
-    /** 插件图标 (React 组件或图标名称) */
-    icon?: React.ReactNode;
-    /** 插件依赖的其他插件 ID 列表 */
-    dependencies?: string[];
-    /** 路由配置集合，用于在主应用中注册页面 */
-    routes?: RouteConfig[];
-    /** 插槽扩展集合，用于在主应用 UI 预留位注入组件 */
-    extensions?: PluginExtension[];
-    /** 插件所需调用的 API 接口配置 */
-    api?: ApiConfig;
-    /** 插件行为能力声明 */
-    capabilities?: PluginCapabilities;
-    /** 插件的可配置项定义 */
-    configuration?: PluginConfigItem[];
-    /** 插件所需的存储结构定义 */
-    storage?: StorageItemSchema[];
-    /**
-     * 系统状态自动绑定
-     * @description 将插件的配置项自动同步到系统的全局状态中 (如主题色、身份认证等)
-     */
-    systemStateBindings?: {
-        /** 插件配置中的键名 */
-        configKey: string;
-        /** 系统全局状态中的键名 */
-        stateKey: string;
-        /** 预设的转换逻辑名称 */
-        transform?: 'theme-mode' | 'identity';
-    }[];
-}

package/dist/ports/storage-port.d.ts

@@ -1,49 +0,0 @@
-/**
- * 存储端口接口
- * @description 定义数据持久化的标准契约，兼容 Web Storage API。
- */
-export interface StoragePort {
-    /**
-     * 获取存储项
-     * @param key - 键名
-     * @returns 对应的值，如果不存在则返回 null
-     */
-    getItem(key: string): string | null;
-    /**
-     * 设置存储项
-     * @param key - 键名
-     * @param value - 键值 (字符串)
-     */
-    setItem(key: string, value: string): void;
-    /**
-     * 移除指定的存储项
-     * @param key - 键名
-     */
-    removeItem(key: string): void;
-    /**
-     * 清空所有存储项
-     */
-    clear(): void;
-    /**
-     * 返回存储对象中当前存储的数据项总数
-     */
-    readonly length: number;
-    /**
-     * 根据索引返回存储中对应键的名称
-     * @param index - 数值索引
-     * @returns 键名，如果索引超出范围则返回 null
-     */
-    key(index: number): string | null;
-}
-/**
- * 类型化存储接口
- * @description 提供泛型支持的存储访问能力，自动处理序列化
- */
-export interface TypedStorage {
-    /** 获取存储数据 */
-    get: <T = any>(key: string) => T | null;
-    /** 设置存储数据 */
-    set: <T = any>(key: string, value: T) => void;
-    /** 移除存储数据 */
-    remove: (key: string) => void;
-}

package/dist/sandbox/proxy-sandbox.d.ts

@@ -1,45 +0,0 @@
-/**
- * ProxySandbox 类
- * @description 基于 Proxy 的 JS 沙箱实现，模拟独立的 Window 环境
- */
-export declare class ProxySandbox {
-    /** 沙箱名称 */
-    name: string;
-    /** 代理后的 Window 对象 */
-    proxy: WindowProxy;
-    /** 沙箱是否激活 */
-    running: boolean;
-    /** 记录新增/修改的全局变量 */
-    private updatedValueSet;
-    /** 副作用记录池 */
-    private effectPool;
-    /** 真实的 Window 对象 */
-    private globalContext;
-    /** 白名单全局变量（允许透传访问真实 Window） */
-    private static globalWhitelist;
-    constructor(name: string, globalContext?: Window & typeof globalThis);
-    /**
-     * 激活沙箱
-     */
-    active(): void;
-    /**
-     * 销毁沙箱
-     */
-    inactive(): void;
-    /**
-     * 在沙箱中执行代码
-     * @param code JS 代码字符串
-     * @returns 执行结果
-     */
-    eval(code: string): any;
-    /**
-     * 创建伪造的 Window 对象
-     */
-    private createFakeWindow;
-    private isConstructor;
-    private isNativeFunction;
-    /**
-     * 劫持全局副作用 API
-     */
-    private patchGlobalEffects;
-}

package/dist/sandbox/style-isolation.d.ts

@@ -1,13 +0,0 @@
-import React from 'react';
-interface SandboxContainerProps {
-    children?: React.ReactNode;
-    name: string;
-    className?: string;
-    style?: React.CSSProperties;
-}
-/**
- * 样式隔离容器
- * @description 使用 Shadow DOM 实现完全的样式隔离
- */
-export declare const SandboxContainer: React.FC<SandboxContainerProps>;
-export {};

package/dist/utils/date.d.ts

@@ -1,32 +0,0 @@
-import dayjs from 'dayjs';
-import 'dayjs/locale/zh-cn';
-/**
- * 日期时间格式化工具类
- */
-export declare const dateUtils: {
-    /**
-     * 格式化日期为 YYYY-MM-DD
-     */
-    formatDate(date?: dayjs.ConfigType): string;
-    /**
-     * 格式化时间为 HH:mm:ss
-     */
-    formatTime(date?: dayjs.ConfigType): string;
-    /**
-     * 格式化日期时间为 YYYY-MM-DD HH:mm:ss
-     */
-    formatDateTime(date?: dayjs.ConfigType): string;
-    /**
-     * 获取当前时间戳（毫秒）
-     */
-    now(): number;
-    /**
-     * 获取相对时间（例如：几分钟前）
-     */
-    fromNow(date: dayjs.ConfigType): string;
-    /**
-     * 原始 dayjs 对象，用于更复杂的场景
-     */
-    dayjs: typeof dayjs;
-};
-export default dateUtils;

package/dist/utils/index.d.ts

@@ -1,4 +0,0 @@
-export * from './logger';
-export * from './date';
-export * from './url';
-export declare const version = "1.0.0";

package/dist/utils/logger.d.ts

@@ -1,79 +0,0 @@
-/**
- * 日志等级枚举
- */
-export declare enum LogLevel {
-    /** 调试级别：输出最详尽的信息 */
-    DEBUG = 0,
-    /** 信息级别：输出重要的运行状态 */
-    INFO = 1,
-    /** 警告级别：输出潜在的问题，但不影响运行 */
-    WARN = 2,
-    /** 错误级别：输出严重的运行异常 */
-    ERROR = 3,
-    /** 禁用日志：不输出任何信息 */
-    NONE = 4
-}
-/**
- * 日志工具类
- * @description 核心工具类，提供统一的日志输出格式 `[Prefix] Message`。
- * 支持通过 `LogLevel` 进行全局过滤，在生产环境下建议设置为 WARN 或以上。
- */
-export declare class Logger {
-    /** 全局静态日志等级，所有实例共享 */
-    private static level;
-    /** 当前实例的业务模块前缀 */
-    private prefix;
-    /**
-     * 构造函数
-     * @param prefix - 业务模块前缀，默认为 'App'
-     */
-    constructor(prefix?: string);
-    /**
-     * 静态方法：设置全局日志输出等级
-     * @param level - 目标日志等级
-     */
-    static setLevel(level: LogLevel): void;
-    /**
-     * 静态方法：获取当前全局日志等级
-     * @returns 当前生效的全局日志等级
-     */
-    static getLevel(): LogLevel;
-    /**
-     * 打印 DEBUG 级别日志
-     * @description 仅在 LogLevel <= DEBUG 时输出
-     */
-    get debug(): (...args: any[]) => void;
-    /**
-     * 打印 INFO 级别日志
-     * @description 仅在 LogLevel <= INFO 时输出
-     */
-    get info(): (...args: any[]) => void;
-    /**
-     * 打印 WARN 级别日志
-     * @description 仅在 LogLevel <= WARN 时输出
-     */
-    get warn(): (...args: any[]) => void;
-    /**
-     * 打印 ERROR 级别日志
-     * @description 仅在 LogLevel <= ERROR 时输出
-     */
-    get error(): (...args: any[]) => void;
-    /**
-     * 开始一个日志控制台分组
-     * @param label - 分组显示的标签名
-     * @param collapsed - 是否默认折叠显示，默认为 false
-     */
-    group(label: string, collapsed?: boolean): void;
-    /**
-     * 结束当前日志控制台分组
-     */
-    get groupEnd(): () => void;
-}
-/** 默认 Logger 实例 */
-export declare const logger: Logger;
-/**
- * 创建带特定前缀的 Logger 实例
- * @param prefix 日志前缀
- * @returns Logger 实例
- */
-export declare const createLogger: (prefix: string) => Logger;

package/dist/utils/url.d.ts

@@ -1,16 +0,0 @@
-type KeepStrategy = 'first' | 'last' | 'search' | 'hash';
-/**
- * 把当前地址中所有出现的参数合并成一份。
- * 重复 key 的处理策略：
- *  - 'first'  : 按出现顺序，第一次的值生效
- *  - 'last'   : 按出现顺序，最后一次的值生效（默认，最直观）
- *  - 'search' : 只要 search 里出现过，就用 search 的
- *  - 'hash'   : 只要 hash 里出现过，就用 hash 的
- */
-export declare function normalizeParams(strategy?: KeepStrategy): URLSearchParams;
-/**
- * 清除 URL 中的特定参数并返回新的 URL
- * @description 同时处理 search 和 hash 中的参数
- */
-export declare function cleanUrlParams(keysToRemove: string[]): string;
-export {};