@chatbi-v/core 2.1.9 → 3.0.0

package/dist/adapter/index.cjs

@@ -0,0 +1,208 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/adapter/index.ts
+var adapter_exports = {};
+__export(adapter_exports, {
+  AdapterRegistry: () => AdapterRegistry,
+  BaseAdapter: () => BaseAdapter,
+  adapterRegistry: () => adapterRegistry
+});
+module.exports = __toCommonJS(adapter_exports);
+
+// src/adapter/AdapterInterface.ts
+var BaseAdapter = class {
+  /**
+   * 模板方法 - 三层变换默认实现
+   * primitives -> semantics -> component tokens
+   */
+  transformTokens(tokens, options) {
+    const semantics = options?.colorScheme === "dark" && tokens.semanticsDark ? tokens.semanticsDark : tokens.semantics;
+    return this.semanticsToComponents(semantics, options);
+  }
+  /**
+   * 将语义 Token 转换为组件级别配置
+   * 由子类实现具体转换逻辑
+   */
+  semanticsToComponents(semantics, options) {
+    return {};
+  }
+  transform(tokens, options) {
+    return this.transformTokens(tokens, options);
+  }
+};
+
+// src/adapter/AdapterRegistry.ts
+var AdapterRegistry = class {
+  adapters = /* @__PURE__ */ new Map();
+  states = /* @__PURE__ */ new Map();
+  activeAdapterId = null;
+  currentTokens = {};
+  /**
+   * 注册适配器
+   * @param adapter 要注册的 UIAdapter 实例
+   */
+  register(adapter) {
+    if (this.adapters.has(adapter.id)) {
+      console.warn(`[AdapterRegistry] Adapter ${adapter.id} already registered, overwriting`);
+    }
+    this.adapters.set(adapter.id, adapter);
+    this.states.set(adapter.id, {
+      adapter,
+      status: "registered",
+      registeredAt: /* @__PURE__ */ new Date()
+    });
+  }
+  /**
+   * 注销适配器
+   * @param adapterId 要注销的适配器 ID
+   * @returns 是否成功注销
+   */
+  unregister(adapterId) {
+    if (this.activeAdapterId === adapterId) {
+      console.warn(`[AdapterRegistry] Cannot unregister active adapter ${adapterId}`);
+      return false;
+    }
+    const adapter = this.adapters.get(adapterId);
+    if (adapter) {
+      adapter.remove();
+    }
+    this.adapters.delete(adapterId);
+    this.states.delete(adapterId);
+    return true;
+  }
+  /**
+   * 获取指定适配器
+   * @param adapterId 适配器 ID
+   * @returns 适配器实例或 undefined
+   */
+  get(adapterId) {
+    return this.adapters.get(adapterId);
+  }
+  /**
+   * 获取所有已注册的适配器
+   * @returns 所有适配器实例数组
+   */
+  getAll() {
+    return Array.from(this.adapters.values());
+  }
+  /**
+   * 获取所有适配器状态
+   * @returns 所有适配器状态数组
+   */
+  getAllStates() {
+    return Array.from(this.states.values());
+  }
+  /**
+   * 设置活跃适配器
+   * @param adapterId 要激活的适配器 ID
+   * @returns 是否成功激活
+   */
+  setActive(adapterId) {
+    const adapter = this.adapters.get(adapterId);
+    if (!adapter) {
+      console.error(`[AdapterRegistry] Adapter ${adapterId} not found`);
+      return false;
+    }
+    if (this.activeAdapterId) {
+      const current = this.adapters.get(this.activeAdapterId);
+      current?.remove();
+      this.updateState(this.activeAdapterId, "inactive");
+    }
+    const transformedTheme = adapter.transform(this.currentTokens);
+    adapter.apply(transformedTheme);
+    this.activeAdapterId = adapterId;
+    this.updateState(adapterId, "active");
+    return true;
+  }
+  /**
+   * 获取当前活跃适配器
+   * @returns 活跃适配器实例或 undefined
+   */
+  getActive() {
+    return this.activeAdapterId ? this.adapters.get(this.activeAdapterId) : void 0;
+  }
+  /**
+   * 使用当前活跃适配器转换 Token
+   * @param tokens DesignSystem Token
+   * @param options 转换选项
+   * @returns 转换后的主题配置
+   */
+  transform(tokens, options) {
+    const adapter = this.getActive();
+    if (!adapter) {
+      console.warn("[AdapterRegistry] No active adapter, returning raw tokens");
+      return tokens;
+    }
+    return adapter.transform(tokens, options);
+  }
+  /**
+   * 检查是否支持指定目标库
+   * @param targetLibrary 目标库标识
+   * @returns 是否支持
+   */
+  supports(targetLibrary) {
+    return Array.from(this.adapters.values()).some(
+      (adapter) => adapter.targetLibrary === targetLibrary
+    );
+  }
+  /**
+   * 获取支持指定目标库的所有适配器
+   * @param targetLibrary 目标库标识
+   * @returns 适配器数组
+   */
+  getAdaptersForTarget(targetLibrary) {
+    return this.getAll().filter(
+      (adapter) => adapter.targetLibrary === targetLibrary
+    );
+  }
+  /**
+   * 设置当前 DesignSystem Token
+   * @param tokens DesignSystem 实例
+   */
+  setTokens(tokens) {
+    this.currentTokens = tokens;
+  }
+  /**
+   * 获取当前 DesignSystem Token
+   * @returns 当前 Token
+   */
+  getTokens() {
+    return this.currentTokens;
+  }
+  /**
+   * 内部方法 - 更新适配器状态
+   */
+  updateState(adapterId, status) {
+    const state = this.states.get(adapterId);
+    if (state) {
+      state.status = status;
+      if (status === "active") {
+        state.activatedAt = /* @__PURE__ */ new Date();
+      }
+    }
+  }
+};
+var adapterRegistry = new AdapterRegistry();
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  AdapterRegistry,
+  BaseAdapter,
+  adapterRegistry
+});

package/dist/adapter/index.d.cts

@@ -0,0 +1,201 @@
+/**
+ * @file AdapterInterface.ts
+ * @description UI 适配器接口定义，提供统一的适配器契约
+ * @author ChatBI Team
+ */
+interface DesignSystemTokens {
+    meta: {
+        id: string;
+        name: string;
+        version: string;
+        mode: 'light' | 'dark' | 'system';
+    };
+    primitives: Record<string, any>;
+    semantics: Record<string, any>;
+    semanticsDark?: Record<string, any>;
+    components: Record<string, any>;
+    componentsDark?: Record<string, any>;
+}
+/**
+ * UI 适配器接口
+ * 定义所有 UI 库适配器必须实现的契约
+ */
+interface UIAdapter {
+    /** 适配器唯一标识符 */
+    readonly id: string;
+    /** 适配器显示名称 */
+    readonly name: string;
+    /** 适配器版本 */
+    readonly version: string;
+    /** 目标 UI 库标识 (如: 'antd', 'mui', 'chakra') */
+    readonly targetLibrary: string;
+    /** 兼容的 UI 库版本 */
+    readonly compatibleVersion?: string;
+    /**
+     * 将 DesignSystem 转换为目标 UI 库的主题配置
+     * @param tokens 设计系统 Token
+     * @param options 转换选项
+     * @returns 目标 UI 库的主题配置对象
+     */
+    transform(tokens: DesignSystemTokens, options?: TransformOptions): any;
+    /**
+     * 应用主题到目标 UI 库
+     * @param theme 转换后的主题配置
+     */
+    apply(theme: any): void;
+    /**
+     * 移除已应用的主题
+     */
+    remove(): void;
+}
+/**
+ * Token 转换选项
+ */
+interface TransformOptions {
+    /** 颜色方案 */
+    colorScheme?: 'light' | 'dark';
+    /** 组件级别覆盖配置 */
+    componentOverrides?: Record<string, any>;
+    /** CSS 变量前缀 */
+    prefix?: string;
+}
+/**
+ * 适配器工厂函数类型
+ */
+interface AdapterFactory {
+    /** 创建适配器实例 */
+    create(config?: any): UIAdapter;
+}
+/**
+ * 适配器状态类型
+ */
+type AdapterStatus = 'registered' | 'active' | 'inactive' | 'error';
+/**
+ * 适配器运行时状态
+ */
+interface AdapterState {
+    /** 适配器实例 */
+    adapter: UIAdapter;
+    /** 当前状态 */
+    status: AdapterStatus;
+    /** 错误信息 (仅在 error 状态时有效) */
+    error?: Error;
+    /** 注册时间 */
+    registeredAt: Date;
+    /** 激活时间 */
+    activatedAt?: Date;
+}
+/**
+ * 适配器抽象基类
+ * 提供通用的适配器实现模板
+ */
+declare abstract class BaseAdapter implements UIAdapter {
+    abstract readonly id: string;
+    abstract readonly name: string;
+    abstract readonly version: string;
+    abstract readonly targetLibrary: string;
+    /**
+     * 模板方法 - 三层变换默认实现
+     * primitives -> semantics -> component tokens
+     */
+    protected transformTokens(tokens: DesignSystemTokens, options?: TransformOptions): any;
+    /**
+     * 将语义 Token 转换为组件级别配置
+     * 由子类实现具体转换逻辑
+     */
+    protected semanticsToComponents(semantics: any, options?: TransformOptions): any;
+    transform(tokens: DesignSystemTokens, options?: TransformOptions): any;
+    abstract apply(theme: any): void;
+    abstract remove(): void;
+}
+
+/**
+ * @file AdapterRegistry.ts
+ * @description 适配器注册发现机制，管理 UI 适配器的注册、激活和查询
+ * @author ChatBI Team
+ */
+
+/**
+ * 适配器注册表
+ * 提供适配器的注册、注销、激活和查询功能
+ */
+declare class AdapterRegistry {
+    private adapters;
+    private states;
+    private activeAdapterId;
+    private currentTokens;
+    /**
+     * 注册适配器
+     * @param adapter 要注册的 UIAdapter 实例
+     */
+    register(adapter: UIAdapter): void;
+    /**
+     * 注销适配器
+     * @param adapterId 要注销的适配器 ID
+     * @returns 是否成功注销
+     */
+    unregister(adapterId: string): boolean;
+    /**
+     * 获取指定适配器
+     * @param adapterId 适配器 ID
+     * @returns 适配器实例或 undefined
+     */
+    get(adapterId: string): UIAdapter | undefined;
+    /**
+     * 获取所有已注册的适配器
+     * @returns 所有适配器实例数组
+     */
+    getAll(): UIAdapter[];
+    /**
+     * 获取所有适配器状态
+     * @returns 所有适配器状态数组
+     */
+    getAllStates(): AdapterState[];
+    /**
+     * 设置活跃适配器
+     * @param adapterId 要激活的适配器 ID
+     * @returns 是否成功激活
+     */
+    setActive(adapterId: string): boolean;
+    /**
+     * 获取当前活跃适配器
+     * @returns 活跃适配器实例或 undefined
+     */
+    getActive(): UIAdapter | undefined;
+    /**
+     * 使用当前活跃适配器转换 Token
+     * @param tokens DesignSystem Token
+     * @param options 转换选项
+     * @returns 转换后的主题配置
+     */
+    transform(tokens: any, options?: TransformOptions): any;
+    /**
+     * 检查是否支持指定目标库
+     * @param targetLibrary 目标库标识
+     * @returns 是否支持
+     */
+    supports(targetLibrary: string): boolean;
+    /**
+     * 获取支持指定目标库的所有适配器
+     * @param targetLibrary 目标库标识
+     * @returns 适配器数组
+     */
+    getAdaptersForTarget(targetLibrary: string): UIAdapter[];
+    /**
+     * 设置当前 DesignSystem Token
+     * @param tokens DesignSystem 实例
+     */
+    setTokens(tokens: any): void;
+    /**
+     * 获取当前 DesignSystem Token
+     * @returns 当前 Token
+     */
+    getTokens(): any;
+    /**
+     * 内部方法 - 更新适配器状态
+     */
+    private updateState;
+}
+declare const adapterRegistry: AdapterRegistry;
+
+export { type AdapterFactory, AdapterRegistry, type AdapterState, type AdapterStatus, BaseAdapter, type TransformOptions, type UIAdapter, adapterRegistry };

package/dist/adapter/index.d.ts

@@ -0,0 +1,201 @@
+/**
+ * @file AdapterInterface.ts
+ * @description UI 适配器接口定义，提供统一的适配器契约
+ * @author ChatBI Team
+ */
+interface DesignSystemTokens {
+    meta: {
+        id: string;
+        name: string;
+        version: string;
+        mode: 'light' | 'dark' | 'system';
+    };
+    primitives: Record<string, any>;
+    semantics: Record<string, any>;
+    semanticsDark?: Record<string, any>;
+    components: Record<string, any>;
+    componentsDark?: Record<string, any>;
+}
+/**
+ * UI 适配器接口
+ * 定义所有 UI 库适配器必须实现的契约
+ */
+interface UIAdapter {
+    /** 适配器唯一标识符 */
+    readonly id: string;
+    /** 适配器显示名称 */
+    readonly name: string;
+    /** 适配器版本 */
+    readonly version: string;
+    /** 目标 UI 库标识 (如: 'antd', 'mui', 'chakra') */
+    readonly targetLibrary: string;
+    /** 兼容的 UI 库版本 */
+    readonly compatibleVersion?: string;
+    /**
+     * 将 DesignSystem 转换为目标 UI 库的主题配置
+     * @param tokens 设计系统 Token
+     * @param options 转换选项
+     * @returns 目标 UI 库的主题配置对象
+     */
+    transform(tokens: DesignSystemTokens, options?: TransformOptions): any;
+    /**
+     * 应用主题到目标 UI 库
+     * @param theme 转换后的主题配置
+     */
+    apply(theme: any): void;
+    /**
+     * 移除已应用的主题
+     */
+    remove(): void;
+}
+/**
+ * Token 转换选项
+ */
+interface TransformOptions {
+    /** 颜色方案 */
+    colorScheme?: 'light' | 'dark';
+    /** 组件级别覆盖配置 */
+    componentOverrides?: Record<string, any>;
+    /** CSS 变量前缀 */
+    prefix?: string;
+}
+/**
+ * 适配器工厂函数类型
+ */
+interface AdapterFactory {
+    /** 创建适配器实例 */
+    create(config?: any): UIAdapter;
+}
+/**
+ * 适配器状态类型
+ */
+type AdapterStatus = 'registered' | 'active' | 'inactive' | 'error';
+/**
+ * 适配器运行时状态
+ */
+interface AdapterState {
+    /** 适配器实例 */
+    adapter: UIAdapter;
+    /** 当前状态 */
+    status: AdapterStatus;
+    /** 错误信息 (仅在 error 状态时有效) */
+    error?: Error;
+    /** 注册时间 */
+    registeredAt: Date;
+    /** 激活时间 */
+    activatedAt?: Date;
+}
+/**
+ * 适配器抽象基类
+ * 提供通用的适配器实现模板
+ */
+declare abstract class BaseAdapter implements UIAdapter {
+    abstract readonly id: string;
+    abstract readonly name: string;
+    abstract readonly version: string;
+    abstract readonly targetLibrary: string;
+    /**
+     * 模板方法 - 三层变换默认实现
+     * primitives -> semantics -> component tokens
+     */
+    protected transformTokens(tokens: DesignSystemTokens, options?: TransformOptions): any;
+    /**
+     * 将语义 Token 转换为组件级别配置
+     * 由子类实现具体转换逻辑
+     */
+    protected semanticsToComponents(semantics: any, options?: TransformOptions): any;
+    transform(tokens: DesignSystemTokens, options?: TransformOptions): any;
+    abstract apply(theme: any): void;
+    abstract remove(): void;
+}
+
+/**
+ * @file AdapterRegistry.ts
+ * @description 适配器注册发现机制，管理 UI 适配器的注册、激活和查询
+ * @author ChatBI Team
+ */
+
+/**
+ * 适配器注册表
+ * 提供适配器的注册、注销、激活和查询功能
+ */
+declare class AdapterRegistry {
+    private adapters;
+    private states;
+    private activeAdapterId;
+    private currentTokens;
+    /**
+     * 注册适配器
+     * @param adapter 要注册的 UIAdapter 实例
+     */
+    register(adapter: UIAdapter): void;
+    /**
+     * 注销适配器
+     * @param adapterId 要注销的适配器 ID
+     * @returns 是否成功注销
+     */
+    unregister(adapterId: string): boolean;
+    /**
+     * 获取指定适配器
+     * @param adapterId 适配器 ID
+     * @returns 适配器实例或 undefined
+     */
+    get(adapterId: string): UIAdapter | undefined;
+    /**
+     * 获取所有已注册的适配器
+     * @returns 所有适配器实例数组
+     */
+    getAll(): UIAdapter[];
+    /**
+     * 获取所有适配器状态
+     * @returns 所有适配器状态数组
+     */
+    getAllStates(): AdapterState[];
+    /**
+     * 设置活跃适配器
+     * @param adapterId 要激活的适配器 ID
+     * @returns 是否成功激活
+     */
+    setActive(adapterId: string): boolean;
+    /**
+     * 获取当前活跃适配器
+     * @returns 活跃适配器实例或 undefined
+     */
+    getActive(): UIAdapter | undefined;
+    /**
+     * 使用当前活跃适配器转换 Token
+     * @param tokens DesignSystem Token
+     * @param options 转换选项
+     * @returns 转换后的主题配置
+     */
+    transform(tokens: any, options?: TransformOptions): any;
+    /**
+     * 检查是否支持指定目标库
+     * @param targetLibrary 目标库标识
+     * @returns 是否支持
+     */
+    supports(targetLibrary: string): boolean;
+    /**
+     * 获取支持指定目标库的所有适配器
+     * @param targetLibrary 目标库标识
+     * @returns 适配器数组
+     */
+    getAdaptersForTarget(targetLibrary: string): UIAdapter[];
+    /**
+     * 设置当前 DesignSystem Token
+     * @param tokens DesignSystem 实例
+     */
+    setTokens(tokens: any): void;
+    /**
+     * 获取当前 DesignSystem Token
+     * @returns 当前 Token
+     */
+    getTokens(): any;
+    /**
+     * 内部方法 - 更新适配器状态
+     */
+    private updateState;
+}
+declare const adapterRegistry: AdapterRegistry;
+
+export { type AdapterFactory, AdapterRegistry, type AdapterState, type AdapterStatus, BaseAdapter, type TransformOptions, type UIAdapter, adapterRegistry };

package/dist/adapter/index.mjs

@@ -0,0 +1,10 @@
+import {
+  AdapterRegistry,
+  BaseAdapter,
+  adapterRegistry
+} from "../chunk-BOR237QK.mjs";
+export {
+  AdapterRegistry,
+  BaseAdapter,
+  adapterRegistry
+};