@tdesign-react/chat 1.0.2 → 1.0.3-alpha.2

package/es/chat-engine/core/store/reactiveState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reactiveState.js","sources":["../../../../../pro-components/chat/chat-engine/core/store/reactiveState.ts"],"sourcesContent":["import { enablePatches, produceWithPatches } from 'immer';\n\n/**\n * 状态订阅者回调函数类型\n * @template T 状态类型\n * @param state 只读的最新状态\n * @param changes 发生变更的路径数组（只读）\n */\nexport type Subscriber<T> = (state: Readonly<T>, changes: readonly string[]) => void;\n\n// 启用immer的patch支持，用于追踪状态变更路径\nenablePatches();\n\n/**\n * 响应式状态管理类，提供高效的状态管理和变更追踪功能\n * @template T 状态对象类型，必须为object类型\n */\nexport default class ReactiveState<T extends object> {\n  private currentState: T; // 当前状态（始终为冻结对象）\n\n  private subscribers = new Set<{ handler: Subscriber<T>; paths?: string[] }>(); // 订阅者集合（包含路径过滤条件）\n\n  private pendingChanges: string[] = []; // 待处理的变更路径（自动去重）\n\n  private notificationScheduled = false; // 通知调度锁（防止重复调度）\n\n  private pathSubscribers = new Map<string, Set<{ handler: Subscriber<T> }>>(); // 增加订阅者分组缓存\n\n  /**\n   * 初始化响应式状态\n   * @param initialState 初始状态（会自动冻结）\n   */\n  public initialize(initialState: T) {\n    this.currentState = Object.freeze(initialState);\n  }\n\n  /**\n   * 更新状态方法\n   * @param updater 状态更新函数（使用immer的draft机制）\n   * @param paths 可选的手动指定变更路径（自动模式会从immer patches中提取）\n   */\n  public setState(updater: (draft: T) => void, paths?: string[]): void {\n    // 使用produceWithPatches来获取变更路径，生成新状态和变更记录\n    const [nextState, patches] = produceWithPatches(this.currentState, updater);\n\n    // 处理变更路径：优先使用手动指定路径，否则从patches中提取\n    const changes =\n      paths || patches.filter((p) => ['replace', 'add', 'remove'].includes(p.op)).map((p) => p.path.join('.'));\n\n    if (changes.length > 0) {\n      this.pendingChanges.push(...changes);\n      this.currentState = Object.freeze(nextState) as T;\n      this.scheduleNotification();\n    }\n  }\n\n  /**\n   * 获取当前状态\n   * @param cloned 是否返回克隆副本（默认false）\n   * @returns 当前状态的只读引用或克隆副本\n   */\n  public getState(cloned = false): Readonly<T> {\n    return cloned ? structuredClone(this.currentState) : this.currentState;\n  }\n\n  /**\n   * 订阅状态变更（支持路径过滤），订阅时维护路径索引\n   * @param subscriber 订阅回调函数\n   * @param paths 可选的要监听的属性路径数组\n   * @returns 取消订阅的函数\n   */\n  public subscribe(subscriber: Subscriber<T>, paths?: string[]): () => void {\n    const subscription = { handler: subscriber, paths };\n    this.subscribers.add(subscription);\n    // 维护路径索引\n    paths?.forEach((path) => {\n      if (!this.pathSubscribers.has(path)) {\n        this.pathSubscribers.set(path, new Set());\n      }\n      this.pathSubscribers.get(path)?.add(subscription);\n    });\n\n    return () => {\n      this.subscribers.delete(subscription);\n      paths?.forEach((path) => {\n        this.pathSubscribers.get(path)?.delete(subscription);\n      });\n    };\n  }\n\n  /**\n   * 调度通知（使用微任务批量处理）\n   */\n  private scheduleNotification() {\n    if (this.notificationScheduled) return;\n    this.notificationScheduled = true;\n\n    // 使用微任务进行批处理，确保在同一个事件循环内的多次更新只会触发一次通知\n    queueMicrotask(() => {\n      // 去重变更路径并重置待处理队列\n      const changedPaths = [...new Set(this.pendingChanges)];\n      this.pendingChanges = [];\n      this.notificationScheduled = false;\n\n      // 冻结状态和路径数组，防止订阅者意外修改\n      const frozenState = Object.freeze(this.currentState);\n      const frozenPaths = Object.freeze(changedPaths);\n\n      // 安全通知所有订阅者\n      this.subscribers.forEach(({ handler, paths }) => {\n        try {\n          // 如果没有设置监听路径，或变更路径中有匹配项，则触发回调\n          if (\n            !paths ||\n            frozenPaths.some((p) =>\n              paths.some((target) => {\n                const targetParts = target.split('.');\n                const pathParts = p.split('.');\n                return targetParts.every((part, i) => pathParts[i] === part);\n              }),\n            )\n          ) {\n            handler(frozenState, frozenPaths);\n          }\n        } catch (error) {\n          console.error('Subscriber error:', error);\n        }\n      });\n    });\n  }\n\n  /**\n   * 销毁方法，清理资源\n   */\n  public destroy() {\n    this.subscribers.clear();\n    this.pathSubscribers.clear();\n    this.pendingChanges = [];\n    this.notificationScheduled = false;\n  }\n\n  /**\n   * 调试方法（开发时使用）\n   * @param label 调试标签（默认'State'）\n   * @returns 当前实例（支持链式调用）\n   */\n  public debug(label = 'State'): this {\n    this.subscribe((state, paths) => {\n      console.groupCollapsed(`%c${label} Update`, 'color: #4CAF50; font-weight: bold;');\n      console.log('Changed Paths:', paths);\n      console.log('New State:', state);\n      console.groupEnd();\n    });\n    return this;\n  }\n}\n"],"names":["enablePatches","ReactiveState","_classCallCheck","_defineProperty","Set","Map","_createClass","key","value","initialize","initialState","currentState","Object","freeze","setState","updater","paths","_produceWithPatches","produceWithPatches","_produceWithPatches2","_slicedToArray","nextState","patches","changes","filter","p","includes","op","map","path","join","length","_this$pendingChanges","pendingChanges","push","apply","_toConsumableArray","scheduleNotification","getState","cloned","structuredClone","subscribe","subscriber","_this","subscription","handler","subscribers","add","forEach","_this$pathSubscribers","pathSubscribers","has","set","get","_this$pathSubscribers2","_this2","notificationScheduled","queueMicrotask","changedPaths","frozenState","frozenPaths","_ref","some","target","targetParts","split","pathParts","every","part","i","error","console","destroy","clear","debug","label","state","groupCollapsed","concat","log","groupEnd"],"mappings":"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"}

package/es/chat-engine/core/type.d.ts

@@ -0,0 +1,279 @@
+import type { ToolCallEventType } from './adapters/agui/types/events';
+export type ChatMessageRole = 'user' | 'assistant' | 'system';
+export type ChatMessageStatus = 'pending' | 'streaming' | 'complete' | 'stop' | 'error';
+export type ChatStatus = 'idle' | ChatMessageStatus;
+export type ChatContentType = 'text' | 'markdown' | 'search' | 'attachment' | 'thinking' | 'image' | 'audio' | 'video' | 'suggestion' | 'reasoning' | 'toolcall' | 'activity';
+export type AttachmentType = 'image' | 'video' | 'audio' | 'pdf' | 'doc' | 'ppt' | 'txt';
+export interface ChatBaseContent<T extends string, TData> {
+    type: T;
+    data: TData;
+    status?: ChatMessageStatus;
+    id?: string;
+    strategy?: 'merge' | 'append';
+    ext?: Record<string, any>;
+}
+export type TextContent = ChatBaseContent<'text', string>;
+export type MarkdownContent = ChatBaseContent<'markdown', string>;
+export type ImageContent = ChatBaseContent<'image', {
+    name?: string;
+    url?: string;
+    width?: number;
+    height?: number;
+}>;
+export type ReferenceItem = {
+    title: string;
+    icon?: string;
+    type?: string;
+    url?: string;
+    content?: string;
+    site?: string;
+    date?: string;
+};
+export type SearchContent = ChatBaseContent<'search', {
+    title?: string;
+    references?: ReferenceItem[];
+}>;
+export type SuggestionItem = {
+    title: string;
+    prompt?: string;
+};
+export type SuggestionContent = ChatBaseContent<'suggestion', SuggestionItem[]>;
+export type ReasoningContent = ChatBaseContent<'reasoning', AIMessageContent[]>;
+export type AttachmentItem = {
+    fileType: AttachmentType;
+    size?: number;
+    name?: string;
+    url?: string;
+    isReference?: boolean;
+    width?: number;
+    height?: number;
+    extension?: string;
+    metadata?: Record<string, any>;
+};
+export type AttachmentContent = ChatBaseContent<'attachment', AttachmentItem[]>;
+export type ThinkingContent = ChatBaseContent<'thinking', {
+    text?: string;
+    title?: string;
+}>;
+export type ToolCall = {
+    toolCallId: string;
+    toolCallName: string;
+    eventType?: ToolCallEventType;
+    parentMessageId?: string;
+    args?: string;
+    chunk?: string;
+    result?: string;
+};
+export type ToolCallContent = ChatBaseContent<'toolcall', ToolCall>;
+export type ActivityData<TContent = Record<string, any>> = {
+    activityType: string;
+    messageId?: string;
+    content: TContent;
+    /** 增量更新信息 */
+    deltaInfo?: {
+        fromIndex: number;
+        toIndex: number;
+    };
+};
+export type ActivityContent<TContent = Record<string, any>> = ChatBaseContent<'activity', ActivityData<TContent>>;
+export interface ChatBaseMessage {
+    id: string;
+    status?: ChatMessageStatus;
+    datetime?: string;
+    ext?: any;
+}
+declare global {
+    interface AIContentTypeOverrides {
+    }
+}
+type AIContentTypeMap = {
+    text: TextContent;
+    markdown: MarkdownContent;
+    thinking: ThinkingContent;
+    image: ImageContent;
+    search: SearchContent;
+    suggestion: SuggestionContent;
+    reasoning: ReasoningContent;
+    toolcall: ToolCallContent;
+    activity: ActivityContent;
+} & AIContentTypeOverrides;
+export type AIContentType = keyof AIContentTypeMap;
+export type AIMessageContent = AIContentTypeMap[AIContentType];
+export type UserMessageContent = TextContent | AttachmentContent;
+export interface UserMessage extends ChatBaseMessage {
+    role: 'user';
+    content: UserMessageContent[];
+}
+export type ChatComment = 'good' | 'bad' | '';
+export interface AIMessage extends ChatBaseMessage {
+    role: 'assistant';
+    content?: AIMessageContent[];
+    history?: AIMessageContent[][];
+    /** 点赞点踩 */
+    comment?: ChatComment;
+}
+export interface SystemMessage extends ChatBaseMessage {
+    role: 'system';
+    content: TextContent[];
+}
+export type ChatMessagesData = UserMessage | AIMessage | SystemMessage;
+export type SSEChunkData = {
+    event?: string;
+    data: any;
+};
+export interface ChatRequestParams {
+    prompt?: string;
+    messageID?: string;
+    attachments?: AttachmentContent['data'];
+    [key: string]: any;
+}
+export type AIContentChunkUpdate = AIMessageContent;
+export interface ChatNetworkConfig {
+    /** 请求端点 */
+    endpoint?: string;
+    /** 是否启用流式传输 */
+    stream?: boolean;
+    /** 重试间隔（毫秒） */
+    retryInterval?: number;
+    /** 最大重试次数 */
+    maxRetries?: number;
+    /** 请求超时时间（毫秒） */
+    timeout?: number;
+    /** 协议类型 */
+    protocol?: 'default' | 'agui';
+}
+export interface DefaultEngineCallbacks {
+    /** 请求发送前配置 */
+    onRequest?: (params: ChatRequestParams) => (ChatRequestParams & RequestInit) | Promise<ChatRequestParams & RequestInit>;
+    onStart?: (chunk: string) => void;
+    /** 接收到消息数据块 - 用于解析和处理聊天内容 */
+    onMessage?: (chunk: SSEChunkData, message?: ChatMessagesData, parsedResult?: AIMessageContent | AIMessageContent[] | null) => AIMessageContent | AIMessageContent[] | null;
+    onComplete?: (isAborted: boolean, params?: ChatRequestParams, result?: any) => AIMessageContent | AIMessageContent[] | void;
+    onAbort?: () => Promise<void>;
+    /** 错误处理 */
+    onError?: (err: Error | Response) => void;
+    /**
+     * Chunk 验证器 - 用于验证 SSE 数据块是否有效
+     *
+     * 当后端返回空内容或无效数据时，可以通过此配置判断 chunk 是否有效，
+     * 只有有效的 chunk 才会被处理，避免过早进入 streaming 状态。
+     *
+     * @param chunk SSE 数据块
+     * @returns 返回 true 表示该 chunk 有效（需要处理），返回 false 表示无效（跳过）
+     *
+     * @example
+     * ```ts
+     * // 只处理 content 不为空的 chunk
+     * isValidChunk: (chunk) => {
+     *   const content = chunk.data?.choices?.[0]?.delta?.content;
+     *   return content !== '' && content !== undefined;
+     * }
+     * ```
+     */
+    isValidChunk?: (chunk: SSEChunkData) => boolean;
+}
+export interface ChatServiceConfig extends ChatNetworkConfig, DefaultEngineCallbacks {
+}
+export type ChatServiceConfigSetter = ChatServiceConfig | ((params?: any) => ChatServiceConfig);
+export interface IChatEngine {
+    /**
+     * 初始化聊天引擎
+     * @param config 聊天服务配置或配置生成函数，包含网络请求配置和回调函数
+     * @param messages 初始消息列表，用于恢复历史对话
+     * @description 必须在使用其他方法前调用此方法进行初始化
+     */
+    init(config?: any, messages?: ChatMessagesData[]): void;
+    /**
+     * 发送用户消息并获取AI回复
+     * @param params 请求参数，包含用户输入的文本和附件
+     * @description 创建用户消息和AI消息，并发送请求获取AI回复
+     */
+    sendUserMessage(params: ChatRequestParams): Promise<void>;
+    /**
+     * 手动发送AI消息
+     * @param options 包含请求参数params、发送消息内容content和是否发送请求的标志sendRequest
+     * @description 创建并存储一条AI消息，可选择是否同时发送请求
+     */
+    sendAIMessage(options: {
+        params?: ChatRequestParams;
+        content?: AIMessageContent[];
+        sendRequest?: boolean;
+    }): Promise<void>;
+    /**
+     * 重新生成AI回复
+     * @param keepVersion 是否保留历史版本，默认为false
+     * @description
+     * - 当keepVersion=false时：删除最后一条AI消息，创建新消息并重新请求
+     * - 当keepVersion=true时：保留旧消息，创建分支消息并重新请求
+     */
+    regenerateAIMessage(keepVersion?: boolean): Promise<void>;
+    /**
+     * 中止当前进行中的聊天请求
+     * @description 停止接收流式响应，关闭连接，并调用配置的onAbort回调
+     */
+    abortChat(): Promise<void>;
+    /**
+     * 设置消息列表
+     * @param messages 要设置的消息数组
+     * @param mode 设置模式：'replace'(替换)、'prepend'(前置)、'append'(追加)，默认为'replace'
+     * @description 用于批量更新消息，如加载历史消息或重置对话
+     */
+    setMessages(messages: ChatMessagesData[], mode?: ChatMessageSetterMode): void;
+    /**
+     * 清空所有消息
+     * @description 清除消息存储中的所有历史记录
+     */
+    clearMessages(): void;
+    /**
+     * 注册内容块合并策略
+     * @param type 内容类型，如'text'、'markdown'等
+     * @param handler 合并处理函数，接收新块和现有块，返回合并后的内容块
+     * @description 用于自定义不同类型内容的增量更新逻辑
+     */
+    registerMergeStrategy<T extends AIMessageContent>(type: T['type'], handler: (chunk: T, existing?: T) => T): void;
+    /**
+     * 获取当前所有消息
+     * @returns 消息数组
+     */
+    get messages(): ChatMessagesData[];
+    /**
+     * 获取当前聊天状态
+     * @returns 聊天状态：'idle'、'pending'、'streaming'、'complete'、'stop'或'error'
+     */
+    get status(): ChatStatus;
+    /**
+     * 获取消息存储实例
+     * @returns 消息存储对象
+     */
+    get messageStore(): any;
+    /**
+     * 销毁聊天引擎实例
+     * @description 中止请求，清理消息存储和适配器，释放资源
+     */
+    destroy(): void;
+}
+export interface ChatMessageStore {
+    messageIds: string[];
+    messages: ChatMessagesData[];
+}
+export interface ModelParams {
+    model?: string;
+    useThink?: boolean;
+    useSearch?: boolean;
+}
+export interface ModelServiceState extends ModelParams {
+    config: ChatServiceConfig;
+}
+export interface ChatState {
+    message: ChatMessageStore;
+    model: ModelServiceState;
+}
+export type ChatMessageSetterMode = 'replace' | 'prepend' | 'append';
+export type AIContentHandler<T extends ChatBaseContent<any, any>> = (chunk: T, existing?: T) => T;
+export interface ContentTypeDefinition<T extends string = string, D = any> {
+    type: T;
+    handler?: AIContentHandler<ChatBaseContent<T, D>>;
+    renderer?: ContentRenderer<ChatBaseContent<T, D>>;
+}
+export type ContentRenderer<T extends ChatBaseContent<any, any>> = (content: T) => unknown;
+export {};

package/es/chat-engine/core/type.js

@@ -0,0 +1,7 @@
+/**
+ * tdesign v1.1.0-alpha.11
+ * (c) 2026 tdesign
+ * @license MIT
+ */
+
+//# sourceMappingURL=type.js.map

package/es/chat-engine/core/type.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"type.js","sources":[],"sourcesContent":[],"names":[],"mappings":";;;;;;"}

package/es/chat-engine/core/utils/eventEmitter.d.ts

@@ -0,0 +1,10 @@
+/**
+ * 简单的 EventEmitter 实现，用于浏览器环境
+ */
+export default class SimpleEventEmitter {
+    private events;
+    on(event: string, listener: (...args: any[]) => void): void;
+    off(event: string, listener: (...args: any[]) => void): void;
+    emit(event: string, ...args: any[]): boolean;
+    removeAllListeners(event?: string): void;
+}

package/es/chat-engine/core/utils/eventEmitter.js

@@ -0,0 +1,67 @@
+/**
+ * tdesign v1.1.0-alpha.11
+ * (c) 2026 tdesign
+ * @license MIT
+ */
+
+import _classCallCheck from '@babel/runtime/helpers/classCallCheck';
+import _createClass from '@babel/runtime/helpers/createClass';
+import _defineProperty from '@babel/runtime/helpers/defineProperty';
+
+var SimpleEventEmitter = /*#__PURE__*/function () {
+  function SimpleEventEmitter() {
+    _classCallCheck(this, SimpleEventEmitter);
+    _defineProperty(this, "events", /* @__PURE__ */new Map());
+  }
+  return _createClass(SimpleEventEmitter, [{
+    key: "on",
+    value: function on(event, listener) {
+      if (!this.events.has(event)) {
+        this.events.set(event, []);
+      }
+      this.events.get(event).push(listener);
+    }
+  }, {
+    key: "off",
+    value: function off(event, listener) {
+      var listeners = this.events.get(event);
+      if (listeners) {
+        var index = listeners.indexOf(listener);
+        if (index !== -1) {
+          listeners.splice(index, 1);
+        }
+      }
+    }
+  }, {
+    key: "emit",
+    value: function emit(event) {
+      for (var _len = arguments.length, args = new Array(_len > 1 ? _len - 1 : 0), _key = 1; _key < _len; _key++) {
+        args[_key - 1] = arguments[_key];
+      }
+      var listeners = this.events.get(event);
+      if (listeners && listeners.length > 0) {
+        listeners.forEach(function (listener) {
+          try {
+            listener.apply(void 0, args);
+          } catch (error) {
+            console.error("EventEmitter listener error:", error);
+          }
+        });
+        return true;
+      }
+      return false;
+    }
+  }, {
+    key: "removeAllListeners",
+    value: function removeAllListeners(event) {
+      if (event) {
+        this.events["delete"](event);
+      } else {
+        this.events.clear();
+      }
+    }
+  }]);
+}();
+
+export { SimpleEventEmitter as default };
+//# sourceMappingURL=eventEmitter.js.map

package/es/chat-engine/core/utils/eventEmitter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"eventEmitter.js","sources":["../../../../../pro-components/chat/chat-engine/core/utils/eventEmitter.ts"],"sourcesContent":["/**\n * 简单的 EventEmitter 实现，用于浏览器环境\n */\nexport default class SimpleEventEmitter {\n  private events: Map<string, Array<(...args: any[]) => void>> = new Map();\n\n  on(event: string, listener: (...args: any[]) => void): void {\n    if (!this.events.has(event)) {\n      this.events.set(event, []);\n    }\n    this.events.get(event)!.push(listener);\n  }\n\n  off(event: string, listener: (...args: any[]) => void): void {\n    const listeners = this.events.get(event);\n    if (listeners) {\n      const index = listeners.indexOf(listener);\n      if (index !== -1) {\n        listeners.splice(index, 1);\n      }\n    }\n  }\n\n  emit(event: string, ...args: any[]): boolean {\n    const listeners = this.events.get(event);\n    if (listeners && listeners.length > 0) {\n      listeners.forEach((listener) => {\n        try {\n          listener(...args);\n        } catch (error) {\n          console.error('EventEmitter listener error:', error);\n        }\n      });\n      return true;\n    }\n    return false;\n  }\n\n  removeAllListeners(event?: string): void {\n    if (event) {\n      this.events.delete(event);\n    } else {\n      this.events.clear();\n    }\n  }\n}\n"],"names":["SimpleEventEmitter","_classCallCheck","_defineProperty","Map","_createClass","key","value","on","event","listener","events","has","set","get","push","off","listeners","index","indexOf","splice","emit","_len","arguments","length","args","Array","_key","forEach","apply","error","console","removeAllListeners","clear"],"mappings":";;;;;;;;;;IAGqBA,kBAAmB,gBAAA,YAAA;AAAA,EAAA,SAAAA,kBAAA,GAAA;AAAAC,IAAAA,eAAA,OAAAD,kBAAA,CAAA,CAAA;AAAAE,IAAAA,eAAA,CACyB,IAAA,EAAA,QAAA,qBAAIC,GAAI,EAAA,CAAA,CAAA;AAAA,GAAA;EAAA,OAAAC,YAAA,CAAAJ,kBAAA,EAAA,CAAA;IAAAK,GAAA,EAAA,IAAA;AAAAC,IAAAA,KAAA,EAEvE,SAAAC,EAAAA,CAAGC,OAAeC,QAA0C,EAAA;MAC1D,IAAI,CAAC,IAAA,CAAKC,MAAO,CAAAC,GAAA,CAAIH,KAAK,CAAG,EAAA;QAC3B,IAAA,CAAKE,MAAO,CAAAE,GAAA,CAAIJ,KAAO,EAAA,EAAE,CAAA,CAAA;AAC3B,OAAA;MACA,IAAA,CAAKE,MAAO,CAAAG,GAAA,CAAIL,KAAK,CAAA,CAAGM,KAAKL,QAAQ,CAAA,CAAA;AACvC,KAAA;AAAA,GAAA,EAAA;IAAAJ,GAAA,EAAA,KAAA;AAAAC,IAAAA,KAAA,EAEA,SAAAS,GAAAA,CAAIP,OAAeC,QAA0C,EAAA;MAC3D,IAAMO,SAAY,GAAA,IAAA,CAAKN,MAAO,CAAAG,GAAA,CAAIL,KAAK,CAAA,CAAA;AACvC,MAAA,IAAIQ,SAAW,EAAA;AACP,QAAA,IAAAC,KAAA,GAAQD,SAAU,CAAAE,OAAA,CAAQT,QAAQ,CAAA,CAAA;AACxC,QAAA,IAAIQ,UAAU,CAAI,CAAA,EAAA;AACND,UAAAA,SAAA,CAAAG,MAAA,CAAOF,OAAO,CAAC,CAAA,CAAA;AAC3B,SAAA;AACF,OAAA;AACF,KAAA;AAAA,GAAA,EAAA;IAAAZ,GAAA,EAAA,MAAA;AAAAC,IAAAA,KAAA,EAEA,SAAAc,IAAAA,CAAKZ,OAAwC;MAAA,KAAAa,IAAAA,IAAA,GAAAC,SAAA,CAAAC,MAAA,EAAtBC,IAAsB,OAAAC,KAAA,CAAAJ,IAAA,GAAAA,CAAAA,GAAAA,IAAA,WAAAK,IAAA,GAAA,CAAA,EAAAA,IAAA,GAAAL,IAAA,EAAAK,IAAA,EAAA,EAAA;AAAtBF,QAAAA,IAAsB,CAAAE,IAAA,GAAAJ,CAAAA,CAAAA,GAAAA,SAAA,CAAAI,IAAA,CAAA,CAAA;AAAA,OAAA;MAC3C,IAAMV,SAAY,GAAA,IAAA,CAAKN,MAAO,CAAAG,GAAA,CAAIL,KAAK,CAAA,CAAA;AACnC,MAAA,IAAAQ,SAAA,IAAaA,SAAU,CAAAO,MAAA,GAAS,CAAG,EAAA;AAC3BP,QAAAA,SAAA,CAAAW,OAAA,CAAQ,UAAClB,QAAa,EAAA;UAC1B,IAAA;AACFA,YAAAA,QAAA,CAAAmB,KAAA,CAAYJ,KAAAA,CAAAA,EAAAA,IAAI,CAAA,CAAA;mBACTK,KAAP,EAAA;AACQC,YAAAA,OAAA,CAAAD,KAAA,CAAM,gCAAgCA,KAAK,CAAA,CAAA;AACrD,WAAA;AACF,SAAC,CAAA,CAAA;AACM,QAAA,OAAA,IAAA,CAAA;AACT,OAAA;AACO,MAAA,OAAA,KAAA,CAAA;AACT,KAAA;AAAA,GAAA,EAAA;IAAAxB,GAAA,EAAA,oBAAA;AAAAC,IAAAA,KAAA,EAEA,SAAAyB,mBAAmBvB,KAAsB,EAAA;AACvC,MAAA,IAAIA,KAAO,EAAA;AACJ,QAAA,IAAA,CAAAE,MAAA,WAAcF,KAAK,CAAA,CAAA;AAC1B,OAAO,MAAA;AACL,QAAA,IAAA,CAAKE,OAAOsB,KAAM,EAAA,CAAA;AACpB,OAAA;AACF,KAAA;AAAA,GAAA,CAAA,CAAA,CAAA;AAAA,CAAA;;;;"}

package/es/chat-engine/core/utils/immutable-patch.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Immutable JSON Patch with Structural Sharing
+ *
+ * 核心特性：
+ * - 只重建被修改路径上的节点
+ * - 未修改的节点保持原引用（实现结构共享）
+ * - 支持标准 JSON Patch 操作：add, remove, replace, move, copy
+ * - 支持扩展操作：append（字符串追加）
+ *
+ * 性能优势：
+ * - 配合 React.memo / useSyncExternalStore 使用时，未变化的组件不会重渲染
+ * - 避免深拷贝带来的性能开销
+ */
+export type Operation = {
+    op: 'add';
+    path: string;
+    value: any;
+} | {
+    op: 'remove';
+    path: string;
+} | {
+    op: 'replace';
+    path: string;
+    value: any;
+} | {
+    op: 'move';
+    path: string;
+    from: string;
+} | {
+    op: 'copy';
+    path: string;
+    from: string;
+} | {
+    op: 'append';
+    path: string;
+    value: string;
+};
+/**
+ * 应用 JSON Patch 数组（结构共享版本）
+ *
+ * @param document 原始文档
+ * @param patch 操作数组
+ * @returns 新文档（未修改的节点保持原引用）
+ *
+ * @example
+ * const tree = { elements: { a: { props: { x: 1 } }, b: { props: { y: 2 } } } };
+ * const newTree = applyPatchImmutable(tree, [
+ *   { op: 'replace', path: '/elements/a/props/x', value: 10 }
+ * ]);
+ *
+ * // 结构共享验证：
+ * tree.elements.b === newTree.elements.b  // true - b 节点未变，保持原引用
+ * tree.elements.a === newTree.elements.a  // false - a 节点被修改，是新引用
+ */
+export declare function applyPatchImmutable<T>(document: T, patch: Operation[]): T;
+/**
+ * 兼容原有 applyPatch 的返回格式
+ */
+export declare function applyPatch<T>(document: T, patch: Operation[]): {
+    newDocument: T;
+};

package/es/chat-engine/core/utils/immutable-patch.js

@@ -0,0 +1,147 @@
+/**
+ * tdesign v1.1.0-alpha.11
+ * (c) 2026 tdesign
+ * @license MIT
+ */
+
+import _typeof from '@babel/runtime/helpers/typeof';
+import _objectWithoutProperties from '@babel/runtime/helpers/objectWithoutProperties';
+import _defineProperty from '@babel/runtime/helpers/defineProperty';
+import _toConsumableArray from '@babel/runtime/helpers/toConsumableArray';
+import _toArray from '@babel/runtime/helpers/toArray';
+
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : i + ""; }
+function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _createForOfIteratorHelper(r, e) { var t = "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (!t) { if (Array.isArray(r) || (t = _unsupportedIterableToArray(r)) || e && r && "number" == typeof r.length) { t && (r = t); var _n = 0, F = function F() {}; return { s: F, n: function n() { return _n >= r.length ? { done: !0 } : { done: !1, value: r[_n++] }; }, e: function e(r) { throw r; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var o, a = !0, u = !1; return { s: function s() { t = t.call(r); }, n: function n() { var r = t.next(); return a = r.done, r; }, e: function e(r) { u = !0, o = r; }, f: function f() { try { a || null == t["return"] || t["return"](); } finally { if (u) throw o; } } }; }
+function _unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return _arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? _arrayLikeToArray(r, a) : void 0; } }
+function _arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e]; return n; }
+function parsePath(path) {
+  if (path === "" || path === "/") return [];
+  return path.split("/").slice(1).map(function (s) {
+    return s.replace(/~1/g, "/").replace(/~0/g, "~");
+  });
+}
+function getByPath(obj, path) {
+  var current = obj;
+  var _iterator = _createForOfIteratorHelper(path),
+    _step;
+  try {
+    for (_iterator.s(); !(_step = _iterator.n()).done;) {
+      var key = _step.value;
+      if (current == null) return void 0;
+      current = current[key];
+    }
+  } catch (err) {
+    _iterator.e(err);
+  } finally {
+    _iterator.f();
+  }
+  return current;
+}
+function setByPath(obj, path, value) {
+  if (path.length === 0) {
+    return value;
+  }
+  var _path = _toArray(path),
+    head = _path[0],
+    tail = _path.slice(1);
+  var current = obj;
+  var isArray = Array.isArray(current);
+  var index = isArray ? head === "-" ? current.length : parseInt(head, 10) : head;
+  if (tail.length === 0) {
+    if (isArray) {
+      var newArr = _toConsumableArray(current);
+      newArr[index] = value;
+      return newArr;
+    } else {
+      return _objectSpread(_objectSpread({}, current), {}, _defineProperty({}, head, value));
+    }
+  }
+  var child = current[head];
+  var newChild = setByPath(child, tail, value);
+  if (isArray) {
+    var _newArr = _toConsumableArray(current);
+    _newArr[index] = newChild;
+    return _newArr;
+  } else {
+    return _objectSpread(_objectSpread({}, current), {}, _defineProperty({}, head, newChild));
+  }
+}
+function removeByPath(obj, path) {
+  if (path.length === 0) {
+    return void 0;
+  }
+  var _path2 = _toArray(path),
+    head = _path2[0],
+    tail = _path2.slice(1);
+  var current = obj;
+  var isArray = Array.isArray(current);
+  if (tail.length === 0) {
+    if (isArray) {
+      var index = parseInt(head, 10);
+      var newArr = _toConsumableArray(current);
+      newArr.splice(index, 1);
+      return newArr;
+    } else {
+      var _ = current[head],
+        rest = _objectWithoutProperties(current, [head].map(_toPropertyKey));
+      return rest;
+    }
+  }
+  var child = current[head];
+  var newChild = removeByPath(child, tail);
+  if (isArray) {
+    var _index = parseInt(head, 10);
+    var _newArr2 = _toConsumableArray(current);
+    _newArr2[_index] = newChild;
+    return _newArr2;
+  } else {
+    return _objectSpread(_objectSpread({}, current), {}, _defineProperty({}, head, newChild));
+  }
+}
+function applyOperationImmutable(document, operation) {
+  var path = parsePath(operation.path);
+  switch (operation.op) {
+    case "add":
+    case "replace":
+      return setByPath(document, path, operation.value);
+    case "remove":
+      return removeByPath(document, path);
+    case "append":
+      {
+        var existing = getByPath(document, path);
+        var newValue = existing == null ? operation.value : String(existing) + operation.value;
+        return setByPath(document, path, newValue);
+      }
+    case "move":
+      {
+        var fromPath = parsePath(operation.from);
+        var value = getByPath(document, fromPath);
+        var afterRemove = removeByPath(document, fromPath);
+        return setByPath(afterRemove, path, value);
+      }
+    case "copy":
+      {
+        var _fromPath = parsePath(operation.from);
+        var _value = getByPath(document, _fromPath);
+        return setByPath(document, path, JSON.parse(JSON.stringify(_value)));
+      }
+    default:
+      return document;
+  }
+}
+function applyPatchImmutable(document, patch) {
+  return patch.reduce(function (doc, op) {
+    return applyOperationImmutable(doc, op);
+  }, document);
+}
+function applyPatch(document, patch) {
+  return {
+    newDocument: applyPatchImmutable(document, patch)
+  };
+}
+
+export { applyPatch, applyPatchImmutable };
+//# sourceMappingURL=immutable-patch.js.map

package/es/chat-engine/core/utils/immutable-patch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"immutable-patch.js","sources":["../../../../../pro-components/chat/chat-engine/core/utils/immutable-patch.ts"],"sourcesContent":["/**\n * Immutable JSON Patch with Structural Sharing\n * \n * 核心特性：\n * - 只重建被修改路径上的节点\n * - 未修改的节点保持原引用（实现结构共享）\n * - 支持标准 JSON Patch 操作：add, remove, replace, move, copy\n * - 支持扩展操作：append（字符串追加）\n * \n * 性能优势：\n * - 配合 React.memo / useSyncExternalStore 使用时，未变化的组件不会重渲染\n * - 避免深拷贝带来的性能开销\n */\n\nexport type Operation = \n  | { op: 'add'; path: string; value: any }\n  | { op: 'remove'; path: string }\n  | { op: 'replace'; path: string; value: any }\n  | { op: 'move'; path: string; from: string }\n  | { op: 'copy'; path: string; from: string }\n  | { op: 'append'; path: string; value: string };\n\n/**\n * 解析 JSON Pointer 路径\n * \"/elements/deep-progress/props/percentage\" => [\"elements\", \"deep-progress\", \"props\", \"percentage\"]\n */\nfunction parsePath(path: string): string[] {\n  if (path === '' || path === '/') return [];\n  return path.split('/').slice(1).map(s => s.replace(/~1/g, '/').replace(/~0/g, '~'));\n}\n\n/**\n * 获取嵌套值\n */\nfunction getByPath(obj: any, path: string[]): any {\n  let current = obj;\n  for (const key of path) {\n    if (current == null) return undefined;\n    current = current[key];\n  }\n  return current;\n}\n\n/**\n * 不可变地设置嵌套值（结构共享）\n * 只重建路径上的节点，其他节点保持原引用\n */\nfunction setByPath<T>(obj: T, path: string[], value: any): T {\n  if (path.length === 0) {\n    return value;\n  }\n  \n  const [head, ...tail] = path;\n  const current = obj as any;\n  \n  // 判断当前层是数组还是对象\n  const isArray = Array.isArray(current);\n  const index = isArray ? (head === '-' ? current.length : parseInt(head, 10)) : head;\n  \n  if (tail.length === 0) {\n    // 到达目标位置，设置值\n    if (isArray) {\n      const newArr = [...current];\n      newArr[index as number] = value;\n      return newArr as unknown as T;\n    } else {\n      return { ...current, [head]: value };\n    }\n  }\n  \n  // 递归处理子路径\n  const child = current[head];\n  const newChild = setByPath(child, tail, value);\n  \n  if (isArray) {\n    const newArr = [...current];\n    newArr[index as number] = newChild;\n    return newArr as unknown as T;\n  } else {\n    return { ...current, [head]: newChild };\n  }\n}\n\n/**\n * 不可变地删除嵌套值（结构共享）\n */\nfunction removeByPath<T>(obj: T, path: string[]): T {\n  if (path.length === 0) {\n    return undefined as unknown as T;\n  }\n  \n  const [head, ...tail] = path;\n  const current = obj as any;\n  const isArray = Array.isArray(current);\n  \n  if (tail.length === 0) {\n    // 到达目标位置，删除值\n    if (isArray) {\n      const index = parseInt(head, 10);\n      const newArr = [...current];\n      newArr.splice(index, 1);\n      return newArr as unknown as T;\n    } else {\n      const { [head]: _, ...rest } = current;\n      return rest as T;\n    }\n  }\n  \n  // 递归处理子路径\n  const child = current[head];\n  const newChild = removeByPath(child, tail);\n  \n  if (isArray) {\n    const index = parseInt(head, 10);\n    const newArr = [...current];\n    newArr[index] = newChild;\n    return newArr as unknown as T;\n  } else {\n    return { ...current, [head]: newChild };\n  }\n}\n\n/**\n * 应用单个操作（结构共享）\n */\nfunction applyOperationImmutable<T>(document: T, operation: Operation): T {\n  const path = parsePath(operation.path);\n  \n  switch (operation.op) {\n    case 'add':\n    case 'replace':\n      return setByPath(document, path, operation.value);\n      \n    case 'remove':\n      return removeByPath(document, path);\n      \n    case 'append': {\n      const existing = getByPath(document, path);\n      const newValue = existing == null ? operation.value : String(existing) + operation.value;\n      return setByPath(document, path, newValue);\n    }\n    \n    case 'move': {\n      const fromPath = parsePath(operation.from);\n      const value = getByPath(document, fromPath);\n      const afterRemove = removeByPath(document, fromPath);\n      return setByPath(afterRemove, path, value);\n    }\n    \n    case 'copy': {\n      const fromPath = parsePath(operation.from);\n      const value = getByPath(document, fromPath);\n      // 深拷贝 copy 的值，避免共享引用\n      return setByPath(document, path, JSON.parse(JSON.stringify(value)));\n    }\n    \n    default:\n      return document;\n  }\n}\n\n/**\n * 应用 JSON Patch 数组（结构共享版本）\n * \n * @param document 原始文档\n * @param patch 操作数组\n * @returns 新文档（未修改的节点保持原引用）\n * \n * @example\n * const tree = { elements: { a: { props: { x: 1 } }, b: { props: { y: 2 } } } };\n * const newTree = applyPatchImmutable(tree, [\n *   { op: 'replace', path: '/elements/a/props/x', value: 10 }\n * ]);\n * \n * // 结构共享验证：\n * tree.elements.b === newTree.elements.b  // true - b 节点未变，保持原引用\n * tree.elements.a === newTree.elements.a  // false - a 节点被修改，是新引用\n */\nexport function applyPatchImmutable<T>(document: T, patch: Operation[]): T {\n  return patch.reduce((doc, op) => applyOperationImmutable(doc, op), document);\n}\n\n/**\n * 兼容原有 applyPatch 的返回格式\n */\nexport function applyPatch<T>(document: T, patch: Operation[]): { newDocument: T } {\n  return {\n    newDocument: applyPatchImmutable(document, patch)\n  };\n}\n"],"names":["parsePath","path","split","slice","map","s","replace","getByPath","obj","current","_iterator","_createForOfIteratorHelper","_step","n","done","key","err","e","f","setByPath","value","length","_path","_toArray","head","tail","isArray","Array","index","parseInt","newArr","_toConsumableArray","_objectSpread","_defineProperty","child","newChild","removeByPath","_path2","splice","_","rest","_objectWithoutProperties","_toPropertyKey","applyOperationImmutable","document","operation","op","existing","newValue","String","fromPath","from","afterRemove","JSON","parse","stringify","applyPatchImmutable","patch","reduce","doc","applyPatch","newDocument"],"mappings":"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"}