@tdesign-react/chat 1.0.2-alpha.11 → 1.0.2-alpha.13

package/es/chat-engine/hooks/a2ui/useA2UISurface.d.ts

@@ -0,0 +1,36 @@
+/**
+ * A2UI Surface 相关 Hooks
+ */
+import type { A2uiMessageProcessor } from '../../core/a2ui';
+import type { A2UISurface, ResolvedComponent } from '../../core/a2ui';
+/**
+ * 订阅单个 Surface
+ *
+ * @example
+ * ```tsx
+ * const surface = useA2UISurface(processor, 'surface-1');
+ * if (!surface) return <Loading />;
+ * return <A2UIRenderer root={surface.root} />;
+ * ```
+ */
+export declare function useA2UISurface(processor: A2uiMessageProcessor, surfaceId: string): A2UISurface | undefined;
+/**
+ * 订阅所有 Surface
+ */
+export declare function useA2UISurfaces(processor: A2uiMessageProcessor): A2UISurface[];
+/**
+ * 订阅 Surface 的组件树根节点
+ */
+export declare function useA2UIRoot(processor: A2uiMessageProcessor, surfaceId: string): ResolvedComponent | null;
+/**
+ * 订阅 Surface 的数据模型
+ */
+export declare function useA2UIData<T = Record<string, unknown>>(processor: A2uiMessageProcessor, surfaceId: string): T | undefined;
+/**
+ * 订阅 Surface 状态
+ */
+export declare function useA2UISurfaceState(processor: A2uiMessageProcessor, surfaceId: string): 'active' | 'closed' | 'pending' | undefined;
+/**
+ * 获取 Surface IDs 列表
+ */
+export declare function useA2UISurfaceIds(processor: A2uiMessageProcessor): string[];

package/es/chat-engine/hooks/a2ui/useA2UISurface.js

@@ -0,0 +1,39 @@
+/**
+ * tdesign v1.0.2-alpha.12
+ * (c) 2026 tdesign
+ * @license MIT
+ */
+
+import { useSyncExternalStore, useMemo } from 'react';
+
+function useA2UISurface(processor, surfaceId) {
+  var snapshot = useSyncExternalStore(processor.subscribe, processor.getSnapshot, processor.getServerSnapshot);
+  return snapshot.get(surfaceId);
+}
+function useA2UISurfaces(processor) {
+  var snapshot = useSyncExternalStore(processor.subscribe, processor.getSnapshot, processor.getServerSnapshot);
+  return useMemo(function () {
+    return Array.from(snapshot.values());
+  }, [snapshot]);
+}
+function useA2UIRoot(processor, surfaceId) {
+  var surface = useA2UISurface(processor, surfaceId);
+  return (surface === null || surface === void 0 ? void 0 : surface.root) || null;
+}
+function useA2UIData(processor, surfaceId) {
+  var surface = useA2UISurface(processor, surfaceId);
+  return surface === null || surface === void 0 ? void 0 : surface.data;
+}
+function useA2UISurfaceState(processor, surfaceId) {
+  var surface = useA2UISurface(processor, surfaceId);
+  return surface === null || surface === void 0 ? void 0 : surface.state;
+}
+function useA2UISurfaceIds(processor) {
+  var snapshot = useSyncExternalStore(processor.subscribe, processor.getSnapshot, processor.getServerSnapshot);
+  return useMemo(function () {
+    return Array.from(snapshot.keys());
+  }, [snapshot]);
+}
+
+export { useA2UIData, useA2UIRoot, useA2UISurface, useA2UISurfaceIds, useA2UISurfaceState, useA2UISurfaces };
+//# sourceMappingURL=useA2UISurface.js.map

package/es/chat-engine/hooks/a2ui/useA2UISurface.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useA2UISurface.js","sources":["../../../../../pro-components/chat/chat-engine/hooks/a2ui/useA2UISurface.ts"],"sourcesContent":["/**\n * A2UI Surface 相关 Hooks\n */\n\nimport { useSyncExternalStore, useMemo } from 'react';\nimport type { A2uiMessageProcessor } from '../../core/a2ui';\nimport type { A2UISurface, ResolvedComponent } from '../../core/a2ui';\n\n/**\n * 订阅单个 Surface\n * \n * @example\n * ```tsx\n * const surface = useA2UISurface(processor, 'surface-1');\n * if (!surface) return <Loading />;\n * return <A2UIRenderer root={surface.root} />;\n * ```\n */\nexport function useA2UISurface(\n  processor: A2uiMessageProcessor,\n  surfaceId: string\n): A2UISurface | undefined {\n  const snapshot = useSyncExternalStore(\n    processor.subscribe,\n    processor.getSnapshot,\n    processor.getServerSnapshot\n  );\n\n  return snapshot.get(surfaceId);\n}\n\n/**\n * 订阅所有 Surface\n */\nexport function useA2UISurfaces(processor: A2uiMessageProcessor): A2UISurface[] {\n  const snapshot = useSyncExternalStore(\n    processor.subscribe,\n    processor.getSnapshot,\n    processor.getServerSnapshot\n  );\n\n  return useMemo(() => Array.from(snapshot.values()), [snapshot]);\n}\n\n/**\n * 订阅 Surface 的组件树根节点\n */\nexport function useA2UIRoot(\n  processor: A2uiMessageProcessor,\n  surfaceId: string\n): ResolvedComponent | null {\n  const surface = useA2UISurface(processor, surfaceId);\n  return surface?.root || null;\n}\n\n/**\n * 订阅 Surface 的数据模型\n */\nexport function useA2UIData<T = Record<string, unknown>>(\n  processor: A2uiMessageProcessor,\n  surfaceId: string\n): T | undefined {\n  const surface = useA2UISurface(processor, surfaceId);\n  return surface?.data as T | undefined;\n}\n\n/**\n * 订阅 Surface 状态\n */\nexport function useA2UISurfaceState(\n  processor: A2uiMessageProcessor,\n  surfaceId: string\n): 'active' | 'closed' | 'pending' | undefined {\n  const surface = useA2UISurface(processor, surfaceId);\n  return surface?.state;\n}\n\n/**\n * 获取 Surface IDs 列表\n */\nexport function useA2UISurfaceIds(processor: A2uiMessageProcessor): string[] {\n  const snapshot = useSyncExternalStore(\n    processor.subscribe,\n    processor.getSnapshot,\n    processor.getServerSnapshot\n  );\n\n  return useMemo(() => Array.from(snapshot.keys()), [snapshot]);\n}\n"],"names":["useA2UISurface","processor","surfaceId","snapshot","useSyncExternalStore","subscribe","getSnapshot","getServerSnapshot","get","useA2UISurfaces","useMemo","Array","from","values","useA2UIRoot","surface","root","useA2UIData","data","useA2UISurfaceState","state","useA2UISurfaceIds","keys"],"mappings":";;;;;;;;AAkBgB,SAAAA,cAAAA,CACdC,WACAC,SACyB,EAAA;AACzB,EAAA,IAAMC,QAAW,GAAAC,oBAAA,CACfH,SAAU,CAAAI,SAAA,EACVJ,SAAU,CAAAK,WAAA,EACVL,SAAU,CAAAM,iBACZ,CAAA,CAAA;AAEO,EAAA,OAAAJ,QAAA,CAASK,IAAIN,SAAS,CAAA,CAAA;AAC/B,CAAA;AAKO,SAASO,gBAAgBR,SAAgD,EAAA;AAC9E,EAAA,IAAME,QAAW,GAAAC,oBAAA,CACfH,SAAU,CAAAI,SAAA,EACVJ,SAAU,CAAAK,WAAA,EACVL,SAAU,CAAAM,iBACZ,CAAA,CAAA;AAEO,EAAA,OAAAG,OAAA,CAAQ,YAAA;IAAA,OAAMC,KAAA,CAAMC,IAAK,CAAAT,QAAA,CAASU,QAAQ,CAAA,CAAA;GAAG,EAAA,CAACV,QAAQ,CAAC,CAAA,CAAA;AAChE,CAAA;AAKgB,SAAAW,WAAAA,CACdb,WACAC,SAC0B,EAAA;AACpB,EAAA,IAAAa,OAAA,GAAUf,cAAe,CAAAC,SAAA,EAAWC,SAAS,CAAA,CAAA;EACnD,OAAO,CAAAa,YAAAA,IAAAA,IAAAA,8BAAAA,QAASC,IAAQ,KAAA,IAAA,CAAA;AAC1B,CAAA;AAKgB,SAAAC,WAAAA,CACdhB,WACAC,SACe,EAAA;AACT,EAAA,IAAAa,OAAA,GAAUf,cAAe,CAAAC,SAAA,EAAWC,SAAS,CAAA,CAAA;AACnD,EAAA,OAAOa,OAAS,KAATA,IAAAA,IAAAA,OAAS,KAATA,KAAAA,CAAAA,GAAAA,KAAAA,CAAAA,GAAAA,OAAS,CAAAG,IAAA,CAAA;AAClB,CAAA;AAKgB,SAAAC,mBAAAA,CACdlB,WACAC,SAC6C,EAAA;AACvC,EAAA,IAAAa,OAAA,GAAUf,cAAe,CAAAC,SAAA,EAAWC,SAAS,CAAA,CAAA;AACnD,EAAA,OAAOa,OAAS,KAATA,IAAAA,IAAAA,OAAS,KAATA,KAAAA,CAAAA,GAAAA,KAAAA,CAAAA,GAAAA,OAAS,CAAAK,KAAA,CAAA;AAClB,CAAA;AAKO,SAASC,kBAAkBpB,SAA2C,EAAA;AAC3E,EAAA,IAAME,QAAW,GAAAC,oBAAA,CACfH,SAAU,CAAAI,SAAA,EACVJ,SAAU,CAAAK,WAAA,EACVL,SAAU,CAAAM,iBACZ,CAAA,CAAA;AAEO,EAAA,OAAAG,OAAA,CAAQ,YAAA;IAAA,OAAMC,KAAA,CAAMC,IAAK,CAAAT,QAAA,CAASmB,MAAM,CAAA,CAAA;GAAG,EAAA,CAACnB,QAAQ,CAAC,CAAA,CAAA;AAC9D;;;;"}

package/es/chat-engine/hooks/a2ui/useDataBinding.d.ts

@@ -0,0 +1,53 @@
+/**
+ * A2UI 数据绑定 Hooks
+ * 实现单向/双向数据绑定
+ */
+import type { Bindable } from '../../core/a2ui/types';
+/**
+ * 单向数据绑定 Hook
+ *
+ * 用于读取绑定值：
+ * - 如果是字面值，直接返回
+ * - 如果是路径绑定，从数据模型读取
+ *
+ * @example
+ * ```tsx
+ * function Text({ text }: { text: Bindable<string> }) {
+ *   const resolvedText = useDataBinding(text);
+ *   return <span>{resolvedText}</span>;
+ * }
+ * ```
+ */
+export declare function useDataBinding<T>(value: Bindable<T>): T;
+export declare function useDataBinding<T>(value: Bindable<T> | undefined): T | undefined;
+/**
+ * 双向数据绑定 Hook
+ *
+ * 用于表单控件的双向绑定：
+ * - 读取：从数据模型获取当前值
+ * - 写入：更新数据模型
+ *
+ * @example
+ * ```tsx
+ * function TextField({ text }: { text: Bindable<string> }) {
+ *   const [inputValue, setInputValue] = useTwoWayBinding(text, '');
+ *   return <Input value={inputValue} onChange={setInputValue} />;
+ * }
+ * ```
+ */
+export declare function useTwoWayBinding<T>(value: Bindable<T> | undefined, defaultValue: T): [T, (newValue: T) => void];
+/**
+ * 获取路径绑定的完整路径
+ */
+export declare function useBindingPath(value: Bindable<unknown> | undefined): string | null;
+/**
+ * 批量解析绑定值
+ */
+export declare function useDataBindings<T extends Record<string, Bindable<unknown>>>(bindings: T): {
+    [K in keyof T]: T[K] extends Bindable<infer V> ? V : never;
+};
+/**
+ * 解析字符串中的绑定占位符
+ * 支持模板字符串格式: "Hello, {{/user/name}}!"
+ */
+export declare function useResolvedString(template: string | undefined): string;

package/es/chat-engine/hooks/a2ui/useDataBinding.js

@@ -0,0 +1,111 @@
+/**
+ * tdesign v1.0.2-alpha.12
+ * (c) 2026 tdesign
+ * @license MIT
+ */
+
+import _slicedToArray from '@babel/runtime/helpers/slicedToArray';
+import { useSyncExternalStore, useMemo, useCallback } from 'react';
+import { useA2UIContext } from './A2UIContext.js';
+import '../../core/a2ui/utils/index.js';
+import { resolveBinding, isPathBinding } from '../../core/a2ui/utils/binding.js';
+import '@babel/runtime/helpers/defineProperty';
+import '../../core/a2ui/utils/validation.js';
+import '@babel/runtime/helpers/toConsumableArray';
+import '@babel/runtime/helpers/typeof';
+
+function useDataBinding(value) {
+  var _useA2UIContext = useA2UIContext(),
+    processor = _useA2UIContext.processor,
+    surfaceId = _useA2UIContext.surfaceId,
+    dataContextPath = _useA2UIContext.dataContextPath;
+  var snapshot = useSyncExternalStore(processor.subscribe, processor.getSnapshot, processor.getServerSnapshot);
+  var surface = snapshot.get(surfaceId);
+  var data = (surface === null || surface === void 0 ? void 0 : surface.data) || {};
+  return useMemo(function () {
+    if (value === void 0) return void 0;
+    return resolveBinding(value, data, dataContextPath);
+  }, [value, data, dataContextPath]);
+}
+function useTwoWayBinding(value, defaultValue) {
+  var _useA2UIContext2 = useA2UIContext(),
+    processor = _useA2UIContext2.processor,
+    surfaceId = _useA2UIContext2.surfaceId,
+    dataContextPath = _useA2UIContext2.dataContextPath;
+  var snapshot = useSyncExternalStore(processor.subscribe, processor.getSnapshot, processor.getServerSnapshot);
+  var surface = snapshot.get(surfaceId);
+  var data = (surface === null || surface === void 0 ? void 0 : surface.data) || {};
+  var currentValue = useMemo(function () {
+    if (value === void 0) return defaultValue;
+    var resolved = resolveBinding(value, data, dataContextPath);
+    return resolved !== void 0 ? resolved : defaultValue;
+  }, [value, data, dataContextPath, defaultValue]);
+  var fullPath = useMemo(function () {
+    if (!isPathBinding(value)) return null;
+    var path = value.path;
+    if (path.startsWith("/")) return path;
+    if (!dataContextPath || dataContextPath === "/") {
+      return "/".concat(path);
+    }
+    return "".concat(dataContextPath, "/").concat(path).replace(/\/+/g, "/");
+  }, [value, dataContextPath]);
+  var setValue = useCallback(function (newValue) {
+    if (fullPath) {
+      processor.setData(surfaceId, fullPath, "", newValue);
+    }
+  }, [processor, surfaceId, fullPath]);
+  return [currentValue, setValue];
+}
+function useBindingPath(value) {
+  var _useA2UIContext3 = useA2UIContext(),
+    dataContextPath = _useA2UIContext3.dataContextPath;
+  return useMemo(function () {
+    if (!isPathBinding(value)) return null;
+    var path = value.path;
+    if (path.startsWith("/")) return path;
+    if (!dataContextPath || dataContextPath === "/") {
+      return "/".concat(path);
+    }
+    return "".concat(dataContextPath, "/").concat(path).replace(/\/+/g, "/");
+  }, [value, dataContextPath]);
+}
+function useDataBindings(bindings) {
+  var _useA2UIContext4 = useA2UIContext(),
+    processor = _useA2UIContext4.processor,
+    surfaceId = _useA2UIContext4.surfaceId,
+    dataContextPath = _useA2UIContext4.dataContextPath;
+  var snapshot = useSyncExternalStore(processor.subscribe, processor.getSnapshot, processor.getServerSnapshot);
+  var surface = snapshot.get(surfaceId);
+  var data = (surface === null || surface === void 0 ? void 0 : surface.data) || {};
+  return useMemo(function () {
+    var result = {};
+    for (var _i = 0, _Object$entries = Object.entries(bindings); _i < _Object$entries.length; _i++) {
+      var _Object$entries$_i = _slicedToArray(_Object$entries[_i], 2),
+        key = _Object$entries$_i[0],
+        value = _Object$entries$_i[1];
+      result[key] = resolveBinding(value, data, dataContextPath);
+    }
+    return result;
+  }, [bindings, data, dataContextPath]);
+}
+function useResolvedString(template) {
+  var _useA2UIContext5 = useA2UIContext(),
+    processor = _useA2UIContext5.processor,
+    surfaceId = _useA2UIContext5.surfaceId,
+    dataContextPath = _useA2UIContext5.dataContextPath;
+  var snapshot = useSyncExternalStore(processor.subscribe, processor.getSnapshot, processor.getServerSnapshot);
+  var surface = snapshot.get(surfaceId);
+  var data = (surface === null || surface === void 0 ? void 0 : surface.data) || {};
+  return useMemo(function () {
+    if (!template) return "";
+    return template.replace(/\{\{([^}]+)\}\}/g, function (_, path) {
+      var value = resolveBinding({
+        path: path.trim()
+      }, data, dataContextPath);
+      return value !== void 0 ? String(value) : "";
+    });
+  }, [template, data, dataContextPath]);
+}
+
+export { useBindingPath, useDataBinding, useDataBindings, useResolvedString, useTwoWayBinding };
+//# sourceMappingURL=useDataBinding.js.map

package/es/chat-engine/hooks/a2ui/useDataBinding.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useDataBinding.js","sources":["../../../../../pro-components/chat/chat-engine/hooks/a2ui/useDataBinding.ts"],"sourcesContent":["/**\n * A2UI 数据绑定 Hooks\n * 实现单向/双向数据绑定\n */\n\nimport { useSyncExternalStore, useCallback, useMemo } from 'react';\nimport { useA2UIContext } from './A2UIContext';\nimport type { Bindable, PathBinding } from '../../core/a2ui/types';\nimport type { SurfaceSnapshot } from '../../core/a2ui/processor/A2uiMessageProcessor';\nimport { isPathBinding, resolveBinding } from '../../core/a2ui/utils';\n\n/**\n * 单向数据绑定 Hook\n * \n * 用于读取绑定值：\n * - 如果是字面值，直接返回\n * - 如果是路径绑定，从数据模型读取\n * \n * @example\n * ```tsx\n * function Text({ text }: { text: Bindable<string> }) {\n *   const resolvedText = useDataBinding(text);\n *   return <span>{resolvedText}</span>;\n * }\n * ```\n */\nexport function useDataBinding<T>(value: Bindable<T>): T;\nexport function useDataBinding<T>(value: Bindable<T> | undefined): T | undefined;\nexport function useDataBinding<T>(value: Bindable<T> | undefined): T | undefined {\n  const { processor, surfaceId, dataContextPath } = useA2UIContext();\n\n  // 订阅 processor 变化\n  const snapshot: SurfaceSnapshot = useSyncExternalStore(\n    processor.subscribe,\n    processor.getSnapshot,\n    processor.getServerSnapshot\n  );\n\n  // 从快照中获取 surface 数据\n  const surface = snapshot.get(surfaceId);\n  const data = surface?.data || {};\n\n  // 解析绑定值\n  return useMemo(() => {\n    if (value === undefined) return undefined;\n    return resolveBinding(value, data, dataContextPath);\n  }, [value, data, dataContextPath]);\n}\n\n/**\n * 双向数据绑定 Hook\n * \n * 用于表单控件的双向绑定：\n * - 读取：从数据模型获取当前值\n * - 写入：更新数据模型\n * \n * @example\n * ```tsx\n * function TextField({ text }: { text: Bindable<string> }) {\n *   const [inputValue, setInputValue] = useTwoWayBinding(text, '');\n *   return <Input value={inputValue} onChange={setInputValue} />;\n * }\n * ```\n */\nexport function useTwoWayBinding<T>(\n  value: Bindable<T> | undefined,\n  defaultValue: T\n): [T, (newValue: T) => void] {\n  const { processor, surfaceId, dataContextPath } = useA2UIContext();\n\n  // 订阅 processor 变化\n  const snapshot: SurfaceSnapshot = useSyncExternalStore(\n    processor.subscribe,\n    processor.getSnapshot,\n    processor.getServerSnapshot\n  );\n\n  // 从快照中获取 surface 数据\n  const surface = snapshot.get(surfaceId);\n  const data = surface?.data || {};\n\n  // 解析当前值\n  const currentValue = useMemo(() => {\n    if (value === undefined) return defaultValue;\n    const resolved = resolveBinding(value, data, dataContextPath);\n    return resolved !== undefined ? resolved : defaultValue;\n  }, [value, data, dataContextPath, defaultValue]);\n\n  // 获取完整路径\n  const fullPath = useMemo(() => {\n    if (!isPathBinding(value)) return null;\n    const path = (value as PathBinding).path;\n    // 使用 processor 内部的 pathResolver 来解析路径\n    if (path.startsWith('/')) return path;\n    // 相对路径处理\n    if (!dataContextPath || dataContextPath === '/') {\n      return `/${path}`;\n    }\n    return `${dataContextPath}/${path}`.replace(/\\/+/g, '/');\n  }, [value, dataContextPath]);\n\n  // 更新函数\n  const setValue = useCallback(\n    (newValue: T) => {\n      if (fullPath) {\n        processor.setData(surfaceId, fullPath, '', newValue);\n      }\n    },\n    [processor, surfaceId, fullPath]\n  );\n\n  return [currentValue, setValue];\n}\n\n/**\n * 获取路径绑定的完整路径\n */\nexport function useBindingPath(value: Bindable<unknown> | undefined): string | null {\n  const { dataContextPath } = useA2UIContext();\n\n  return useMemo(() => {\n    if (!isPathBinding(value)) return null;\n    const path = (value as PathBinding).path;\n    if (path.startsWith('/')) return path;\n    if (!dataContextPath || dataContextPath === '/') {\n      return `/${path}`;\n    }\n    return `${dataContextPath}/${path}`.replace(/\\/+/g, '/');\n  }, [value, dataContextPath]);\n}\n\n/**\n * 批量解析绑定值\n */\nexport function useDataBindings<T extends Record<string, Bindable<unknown>>>(\n  bindings: T\n): { [K in keyof T]: T[K] extends Bindable<infer V> ? V : never } {\n  const { processor, surfaceId, dataContextPath } = useA2UIContext();\n\n  const snapshot: SurfaceSnapshot = useSyncExternalStore(\n    processor.subscribe,\n    processor.getSnapshot,\n    processor.getServerSnapshot\n  );\n\n  const surface = snapshot.get(surfaceId);\n  const data = surface?.data || {};\n\n  return useMemo(() => {\n    const result: Record<string, unknown> = {};\n    for (const [key, value] of Object.entries(bindings)) {\n      result[key] = resolveBinding(value, data, dataContextPath);\n    }\n    return result as { [K in keyof T]: T[K] extends Bindable<infer V> ? V : never };\n  }, [bindings, data, dataContextPath]);\n}\n\n/**\n * 解析字符串中的绑定占位符\n * 支持模板字符串格式: \"Hello, {{/user/name}}!\"\n */\nexport function useResolvedString(template: string | undefined): string {\n  const { processor, surfaceId, dataContextPath } = useA2UIContext();\n\n  const snapshot: SurfaceSnapshot = useSyncExternalStore(\n    processor.subscribe,\n    processor.getSnapshot,\n    processor.getServerSnapshot\n  );\n\n  const surface = snapshot.get(surfaceId);\n  const data = surface?.data || {};\n\n  return useMemo(() => {\n    if (!template) return '';\n    \n    // 匹配 {{path}} 格式\n    return template.replace(/\\{\\{([^}]+)\\}\\}/g, (_, path) => {\n      const value = resolveBinding({ path: path.trim() }, data, dataContextPath);\n      return value !== undefined ? String(value) : '';\n    });\n  }, [template, data, dataContextPath]);\n}\n"],"names":["useDataBinding","value","_useA2UIContext","useA2UIContext","processor","surfaceId","dataContextPath","snapshot","useSyncExternalStore","subscribe","getSnapshot","getServerSnapshot","surface","get","data","useMemo","resolveBinding","useTwoWayBinding","defaultValue","_useA2UIContext2","currentValue","resolved","fullPath","isPathBinding","path","startsWith","concat","replace","setValue","useCallback","newValue","setData","useBindingPath","_useA2UIContext3","useDataBindings","bindings","_useA2UIContext4","result","_i","_Object$entries","Object","entries","length","_Object$entries$_i","_slicedToArray","key","useResolvedString","template","_useA2UIContext5","_","trim","String"],"mappings":"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"}

package/es/chat-engine/hooks/index.js

@@ -1,5 +1,5 @@
 /**
- * tdesign v1.0.2-alpha.10
+ * tdesign v1.0.2-alpha.12
  * (c) 2026 tdesign
  * @license MIT
  */
@@ -31,6 +31,9 @@ import '../core/adapters/agui/state-manager.js';
 import '@babel/runtime/helpers/typeof';
 import '../core/utils/index.js';
 import '../core/adapters/agui/utils.js';
+import '../core/event-bus/index.js';
+import '../core/event-bus/ChatEventBus.js';
+import '../core/event-bus/types.js';
 import '../core/store/message.js';
 import '@babel/runtime/helpers/get';
 import '../core/store/reactiveState.js';

package/es/chat-engine/hooks/index.js.map

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

package/es/chat-engine/hooks/useAgentActivity.js

@@ -1,5 +1,5 @@
 /**
- * tdesign v1.0.2-alpha.10
+ * tdesign v1.0.2-alpha.12
  * (c) 2026 tdesign
  * @license MIT
  */

package/es/chat-engine/hooks/useAgentState.js

@@ -1,5 +1,5 @@
 /**
- * tdesign v1.0.2-alpha.10
+ * tdesign v1.0.2-alpha.12
  * (c) 2026 tdesign
  * @license MIT
  */
@@ -27,6 +27,9 @@ import '@babel/runtime/helpers/wrapNativeSuper';
 import '../core/utils/index.js';
 import '@babel/runtime/helpers/typeof';
 import '../core/adapters/agui/utils.js';
+import '../core/event-bus/index.js';
+import '../core/event-bus/ChatEventBus.js';
+import '../core/event-bus/types.js';
 import '../core/store/message.js';
 import '@babel/runtime/helpers/get';
 import '../core/store/reactiveState.js';

package/es/chat-engine/hooks/useAgentState.js.map

@@ -1 +1 @@
-{"version":3,"file":"useAgentState.js","sources":["../../../../pro-components/chat/chat-engine/hooks/useAgentState.ts"],"sourcesContent":["/* eslint-disable react-hooks/exhaustive-deps */\nimport { useState, useEffect, useRef, createContext, useContext, useMemo } from 'react';\n// import { stateManager } from 'tdesign-web-components/lib/chat-engine';\nimport { stateManager } from '../core';\n\n/**\n * 状态订阅相关类型定义\n */\n\nexport interface StateActionOptions {\n  /**\n   * 初始状态\n   */\n  initialState?: Record<string, any>;\n  /**\n   * 只订阅特定key的变化\n   */\n  subscribeKey?: string;\n}\n\nexport interface UseStateActionReturn {\n  /**\n   * 全量状态Map - 包含所有stateKey的状态\n   * 格式: { [stateKey]: stateData }\n   */\n  stateMap: Record<string, any>;\n  /**\n   * 当前最新的状态key\n   */\n  currentStateKey: string | null;\n  /**\n   * 设置状态Map，用于加载历史对话消息中的state数据\n   */\n  setStateMap: (stateMap: Record<string, any> | ((prev: Record<string, any>) => Record<string, any>)) => void;\n  /**\n   * 获取当前完整状态的方法\n   */\n  getCurrentState: () => Record<string, any>;\n  /**\n   * 获取特定 key 状态的方法\n   */\n  getStateByKey: (key: string) => any;\n}\n\nexport const useAgentState = <T = any>(options: StateActionOptions = {}): UseStateActionReturn => {\n  const { initialState, subscribeKey } = options;\n  const [stateMap, setStateMap] = useState<Record<string, any>>(initialState || {});\n  const [currentStateKey, setCurrentStateKey] = useState<string | null>(null);\n\n  // 使用 ref 来避免不必要的重新渲染\n  const stateMapRef = useRef(stateMap);\n  stateMapRef.current = stateMap;\n\n  useEffect(\n    () =>\n      stateManager.subscribeToLatest((newState: T, newStateKey: string) => {\n        // 如果指定了 subscribeKey，只有匹配时才更新状态\n        if (subscribeKey && newStateKey !== subscribeKey) {\n          // 仍然更新内部状态，但不触发重新渲染\n          stateMapRef.current = {\n            ...stateMapRef.current,\n            [newStateKey]: newState,\n          };\n          return;\n        }\n\n        setStateMap((prev) => ({\n          ...prev,\n          [newStateKey]: newState,\n        }));\n        setCurrentStateKey(newStateKey);\n      }),\n    [subscribeKey],\n  );\n\n  return {\n    stateMap: stateMapRef.current,\n    currentStateKey,\n    setStateMap,\n    getCurrentState: () => stateMapRef.current,\n    getStateByKey: (key: string) => stateMapRef.current[key],\n  };\n};\n\n// 创建 AgentState Context\nexport const AgentStateContext = createContext<UseStateActionReturn | null>(null);\n\n// 简化的状态选择器\nexport const useAgentStateDataByKey = (stateKey?: string) => {\n  const contextState = useContext(AgentStateContext);\n  const independentState = useAgentState({ subscribeKey: stateKey });\n\n  return useMemo(() => {\n    if (contextState) {\n      // 有 Provider，使用 Context 状态\n      const { stateMap } = contextState;\n      return stateKey ? stateMap[stateKey] : stateMap;\n    }\n\n    // 没有 Provider，使用独立状态\n    const { stateMap } = independentState;\n    return stateKey ? stateMap[stateKey] : stateMap;\n  }, [\n    stateKey,\n    // 关键：添加和 useAgentStateByKey 相同的深度依赖逻辑\n    contextState && (stateKey ? contextState.stateMap[stateKey] : JSON.stringify(contextState.stateMap)),\n    independentState && (stateKey ? independentState.stateMap[stateKey] : JSON.stringify(independentState.stateMap)),\n  ]);\n};\n\n// 导出 Context Hook\nexport const useAgentStateContext = (): UseStateActionReturn => {\n  const context = useContext(AgentStateContext);\n\n  if (!context) {\n    throw new Error('useAgentState must be used within AgentStateProvider');\n  }\n\n  return context;\n};\n"],"names":["useAgentState","options","arguments","length","undefined","initialState","subscribeKey","_useState","useState","_useState2","_slicedToArray","stateMap","setStateMap","_useState3","_useState4","currentStateKey","setCurrentStateKey","stateMapRef","useRef","current","useEffect","stateManager","subscribeToLatest","newState","newStateKey","_objectSpread","_defineProperty","prev","getCurrentState","getStateByKey","key","AgentStateContext","createContext","useAgentStateDataByKey","stateKey","contextState","useContext","independentState","useMemo","JSON","stringify","useAgentStateContext","context","Error"],"mappings":"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"}
+{"version":3,"file":"useAgentState.js","sources":["../../../../pro-components/chat/chat-engine/hooks/useAgentState.ts"],"sourcesContent":["/* eslint-disable react-hooks/exhaustive-deps */\nimport { useState, useEffect, useRef, createContext, useContext, useMemo } from 'react';\n// import { stateManager } from 'tdesign-web-components/lib/chat-engine';\nimport { stateManager } from '../core';\n\n/**\n * 状态订阅相关类型定义\n */\n\nexport interface StateActionOptions {\n  /**\n   * 初始状态\n   */\n  initialState?: Record<string, any>;\n  /**\n   * 只订阅特定key的变化\n   */\n  subscribeKey?: string;\n}\n\nexport interface UseStateActionReturn {\n  /**\n   * 全量状态Map - 包含所有stateKey的状态\n   * 格式: { [stateKey]: stateData }\n   */\n  stateMap: Record<string, any>;\n  /**\n   * 当前最新的状态key\n   */\n  currentStateKey: string | null;\n  /**\n   * 设置状态Map，用于加载历史对话消息中的state数据\n   */\n  setStateMap: (stateMap: Record<string, any> | ((prev: Record<string, any>) => Record<string, any>)) => void;\n  /**\n   * 获取当前完整状态的方法\n   */\n  getCurrentState: () => Record<string, any>;\n  /**\n   * 获取特定 key 状态的方法\n   */\n  getStateByKey: (key: string) => any;\n}\n\nexport const useAgentState = <T = any>(options: StateActionOptions = {}): UseStateActionReturn => {\n  const { initialState, subscribeKey } = options;\n  const [stateMap, setStateMap] = useState<Record<string, any>>(initialState || {});\n  const [currentStateKey, setCurrentStateKey] = useState<string | null>(null);\n\n  // 使用 ref 来避免不必要的重新渲染\n  const stateMapRef = useRef(stateMap);\n  stateMapRef.current = stateMap;\n\n  useEffect(\n    () =>\n      stateManager.subscribeToLatest((newState: T, newStateKey: string) => {\n        // 如果指定了 subscribeKey，只有匹配时才更新状态\n        if (subscribeKey && newStateKey !== subscribeKey) {\n          // 仍然更新内部状态，但不触发重新渲染\n          stateMapRef.current = {\n            ...stateMapRef.current,\n            [newStateKey]: newState,\n          };\n          return;\n        }\n\n        setStateMap((prev) => ({\n          ...prev,\n          [newStateKey]: newState,\n        }));\n        setCurrentStateKey(newStateKey);\n      }),\n    [subscribeKey],\n  );\n\n  return {\n    stateMap: stateMapRef.current,\n    currentStateKey,\n    setStateMap,\n    getCurrentState: () => stateMapRef.current,\n    getStateByKey: (key: string) => stateMapRef.current[key],\n  };\n};\n\n// 创建 AgentState Context\nexport const AgentStateContext = createContext<UseStateActionReturn | null>(null);\n\n// 简化的状态选择器\nexport const useAgentStateDataByKey = (stateKey?: string) => {\n  const contextState = useContext(AgentStateContext);\n  const independentState = useAgentState({ subscribeKey: stateKey });\n\n  return useMemo(() => {\n    if (contextState) {\n      // 有 Provider，使用 Context 状态\n      const { stateMap } = contextState;\n      return stateKey ? stateMap[stateKey] : stateMap;\n    }\n\n    // 没有 Provider，使用独立状态\n    const { stateMap } = independentState;\n    return stateKey ? stateMap[stateKey] : stateMap;\n  }, [\n    stateKey,\n    // 关键：添加和 useAgentStateByKey 相同的深度依赖逻辑\n    contextState && (stateKey ? contextState.stateMap[stateKey] : JSON.stringify(contextState.stateMap)),\n    independentState && (stateKey ? independentState.stateMap[stateKey] : JSON.stringify(independentState.stateMap)),\n  ]);\n};\n\n// 导出 Context Hook\nexport const useAgentStateContext = (): UseStateActionReturn => {\n  const context = useContext(AgentStateContext);\n\n  if (!context) {\n    throw new Error('useAgentState must be used within AgentStateProvider');\n  }\n\n  return context;\n};\n"],"names":["useAgentState","options","arguments","length","undefined","initialState","subscribeKey","_useState","useState","_useState2","_slicedToArray","stateMap","setStateMap","_useState3","_useState4","currentStateKey","setCurrentStateKey","stateMapRef","useRef","current","useEffect","stateManager","subscribeToLatest","newState","newStateKey","_objectSpread","_defineProperty","prev","getCurrentState","getStateByKey","key","AgentStateContext","createContext","useAgentStateDataByKey","stateKey","contextState","useContext","independentState","useMemo","JSON","stringify","useAgentStateContext","context","Error"],"mappings":"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"}

package/es/chat-engine/hooks/useAgentToolcall.js

@@ -1,5 +1,5 @@
 /**
- * tdesign v1.0.2-alpha.10
+ * tdesign v1.0.2-alpha.12
  * (c) 2026 tdesign
  * @license MIT
  */

package/es/chat-engine/hooks/useChat.js

@@ -1,5 +1,5 @@
 /**
- * tdesign v1.0.2-alpha.10
+ * tdesign v1.0.2-alpha.12
  * (c) 2026 tdesign
  * @license MIT
  */
@@ -27,6 +27,9 @@ import '../core/adapters/agui/state-manager.js';
 import '@babel/runtime/helpers/typeof';
 import '../core/utils/index.js';
 import '../core/adapters/agui/utils.js';
+import '../core/event-bus/index.js';
+import '../core/event-bus/ChatEventBus.js';
+import '../core/event-bus/types.js';
 import '../core/store/message.js';
 import '@babel/runtime/helpers/get';
 import '../core/store/reactiveState.js';

package/es/chat-engine/hooks/useChat.js.map

@@ -1 +1 @@
-{"version":3,"file":"useChat.js","sources":["../../../../pro-components/chat/chat-engine/hooks/useChat.ts"],"sourcesContent":["import { useEffect, useRef, useState } from 'react';\nimport ChatEngine from '../core';\nimport type { ChatMessagesData, ChatServiceConfig, ChatStatus } from '../core';\n// import ChatEngine from 'tdesign-web-components/lib/chat-engine';\n// import type { ChatMessagesData, ChatServiceConfig, ChatStatus } from 'tdesign-web-components/lib/chat-engine';\n\n\nexport type IUseChat = {\n  defaultMessages?: ChatMessagesData[];\n  chatServiceConfig: ChatServiceConfig;\n};\n\nexport const useChat = ({ defaultMessages: initialMessages, chatServiceConfig }: IUseChat) => {\n  const [messages, setMessage] = useState<ChatMessagesData[]>([]);\n  const [status, setStatus] = useState<ChatStatus>('idle');\n  const chatEngineRef = useRef<ChatEngine>(new ChatEngine());\n  const msgSubscribeRef = useRef<null | (() => void)>(null);\n  const prevInitialMessagesRef = useRef<ChatMessagesData[]>([]);\n\n  const chatEngine = chatEngineRef.current;\n\n  const syncState = (state: ChatMessagesData[]) => {\n    setMessage(state);\n    setStatus(state.at(-1)?.status || 'idle');\n  };\n\n  const subscribeToChat = () => {\n    // 清理之前的订阅\n    msgSubscribeRef.current?.();\n\n    msgSubscribeRef.current = chatEngine.messageStore.subscribe((state) => {\n      syncState(state.messages);\n    });\n  };\n\n  const initChat = () => {\n    // @ts-ignore\n    chatEngine.init(chatServiceConfig, initialMessages);\n    // @ts-ignore\n    syncState(initialMessages);\n    subscribeToChat();\n  };\n\n  // 初始化聊天引擎\n  useEffect(() => {\n    initChat();\n    return () => msgSubscribeRef.current?.();\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, []);\n\n  // 监听 defaultMessages 变化\n  useEffect(() => {\n    // 检查 initialMessages 是否真的发生了变化\n    const hasChanged = JSON.stringify(prevInitialMessagesRef.current) !== JSON.stringify(initialMessages);\n\n    if (hasChanged && initialMessages && initialMessages.length > 0) {\n      // 更新引用\n      prevInitialMessagesRef.current = initialMessages;\n\n      // 重新初始化聊天引擎或更新消息\n      chatEngine.setMessages(initialMessages, 'replace');\n\n      // 同步状态\n      syncState(initialMessages);\n    }\n  }, [initialMessages, chatEngine]);\n\n  return {\n    chatEngine,\n    messages,\n    status,\n  };\n};\n"],"names":["useChat","initialMessages","_ref","defaultMessages","chatServiceConfig","_useState","useState","_useState2","_slicedToArray","messages","setMessage","_useState3","_useState4","status","setStatus","chatEngineRef","useRef","ChatEngine","msgSubscribeRef","prevInitialMessagesRef","chatEngine","current","syncState","state","_state$at","at","subscribeToChat","_msgSubscribeRef$curr","call","messageStore","subscribe","initChat","init","useEffect","_msgSubscribeRef$curr2","hasChanged","JSON","stringify","length","setMessages"],"mappings":"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"}
+{"version":3,"file":"useChat.js","sources":["../../../../pro-components/chat/chat-engine/hooks/useChat.ts"],"sourcesContent":["import { useEffect, useRef, useState } from 'react';\nimport ChatEngine from '../core';\nimport type { ChatMessagesData, ChatServiceConfig, ChatStatus } from '../core';\n// import ChatEngine from 'tdesign-web-components/lib/chat-engine';\n// import type { ChatMessagesData, ChatServiceConfig, ChatStatus } from 'tdesign-web-components/lib/chat-engine';\n\n\nexport type IUseChat = {\n  defaultMessages?: ChatMessagesData[];\n  chatServiceConfig: ChatServiceConfig;\n};\n\nexport const useChat = ({ defaultMessages: initialMessages, chatServiceConfig }: IUseChat) => {\n  const [messages, setMessage] = useState<ChatMessagesData[]>([]);\n  const [status, setStatus] = useState<ChatStatus>('idle');\n  const chatEngineRef = useRef<ChatEngine>(new ChatEngine());\n  const msgSubscribeRef = useRef<null | (() => void)>(null);\n  const prevInitialMessagesRef = useRef<ChatMessagesData[]>([]);\n\n  const chatEngine = chatEngineRef.current;\n\n  const syncState = (state: ChatMessagesData[]) => {\n    setMessage(state);\n    setStatus(state.at(-1)?.status || 'idle');\n  };\n\n  const subscribeToChat = () => {\n    // 清理之前的订阅\n    msgSubscribeRef.current?.();\n\n    msgSubscribeRef.current = chatEngine.messageStore.subscribe((state) => {\n      syncState(state.messages);\n    });\n  };\n\n  const initChat = () => {\n    // @ts-ignore\n    chatEngine.init(chatServiceConfig, initialMessages);\n    // @ts-ignore\n    syncState(initialMessages);\n    subscribeToChat();\n  };\n\n  // 初始化聊天引擎\n  useEffect(() => {\n    initChat();\n    return () => msgSubscribeRef.current?.();\n    // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, []);\n\n  // 监听 defaultMessages 变化\n  useEffect(() => {\n    // 检查 initialMessages 是否真的发生了变化\n    const hasChanged = JSON.stringify(prevInitialMessagesRef.current) !== JSON.stringify(initialMessages);\n\n    if (hasChanged && initialMessages && initialMessages.length > 0) {\n      // 更新引用\n      prevInitialMessagesRef.current = initialMessages;\n\n      // 重新初始化聊天引擎或更新消息\n      chatEngine.setMessages(initialMessages, 'replace');\n\n      // 同步状态\n      syncState(initialMessages);\n    }\n  }, [initialMessages, chatEngine]);\n\n  return {\n    chatEngine,\n    messages,\n    status,\n  };\n};\n"],"names":["useChat","initialMessages","_ref","defaultMessages","chatServiceConfig","_useState","useState","_useState2","_slicedToArray","messages","setMessage","_useState3","_useState4","status","setStatus","chatEngineRef","useRef","ChatEngine","msgSubscribeRef","prevInitialMessagesRef","chatEngine","current","syncState","state","_state$at","at","subscribeToChat","_msgSubscribeRef$curr","call","messageStore","subscribe","initChat","init","useEffect","_msgSubscribeRef$curr2","hasChanged","JSON","stringify","length","setMessages"],"mappings":"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"}

package/es/chat-engine/index.js

@@ -1,5 +1,5 @@
 /**
- * tdesign v1.0.2-alpha.10
+ * tdesign v1.0.2-alpha.12
  * (c) 2026 tdesign
  * @license MIT
  */
@@ -20,6 +20,8 @@ export { applyJsonPatch, findTargetElement, getMessageContentForCopy, isAIMessag
 export { StateManagerImpl, stateManager } from './core/adapters/agui/state-manager.js';
 export { AGUIEventType, ActivityDeltaEventSchema, ActivitySnapshotEventSchema, CustomEventSchema, EventSchemas, MessagesSnapshotEventSchema, RawEventSchema, RunErrorEventSchema, RunFinishedEventSchema, RunStartedEventSchema, StateDeltaEventSchema, StateSnapshotEventSchema, StepFinishedEventSchema, StepStartedEventSchema, TextMessageChunkEventSchema, TextMessageContentEventSchema, TextMessageEndEventSchema, TextMessageStartEventSchema, ThinkingEndEventSchema, ThinkingStartEventSchema, ThinkingTextMessageContentEventSchema, ThinkingTextMessageEndEventSchema, ThinkingTextMessageStartEventSchema, ToolCallArgsEventSchema, ToolCallChunkEventSchema, ToolCallEndEventSchema, ToolCallResultEventSchema, ToolCallStartEventSchema, isActivityEvent, isStateEvent, isTextMessageEvent, isThinkingEvent, isToolCallEvent } from './core/adapters/agui/events.js';
 export { AGUIAdapter } from './core/adapters/agui/index.js';
+export { ChatEventBus, createEventBus } from './core/event-bus/ChatEventBus.js';
+export { ChatEngineEventType } from './core/event-bus/types.js';
 import '@babel/runtime/helpers/slicedToArray';
 import 'react';
 import '@babel/runtime/helpers/toConsumableArray';
@@ -32,6 +34,7 @@ import '@babel/runtime/helpers/asyncToGenerator';
 import '@babel/runtime/helpers/classCallCheck';
 import '@babel/runtime/helpers/createClass';
 import '@babel/runtime/regenerator';
+import './core/event-bus/index.js';
 import './core/store/message.js';
 import '@babel/runtime/helpers/possibleConstructorReturn';
 import '@babel/runtime/helpers/getPrototypeOf';

package/es/chat-engine/index.js.map

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

package/es/chat-filecard/index.js

@@ -1,5 +1,5 @@
 /**
- * tdesign v1.0.2-alpha.10
+ * tdesign v1.0.2-alpha.12
  * (c) 2026 tdesign
  * @license MIT
  */

package/es/chat-loading/index.js

@@ -1,5 +1,5 @@
 /**
- * tdesign v1.0.2-alpha.10
+ * tdesign v1.0.2-alpha.12
  * (c) 2026 tdesign
  * @license MIT
  */

package/es/chat-markdown/index.js

@@ -1,5 +1,5 @@
 /**
- * tdesign v1.0.2-alpha.10
+ * tdesign v1.0.2-alpha.12
  * (c) 2026 tdesign
  * @license MIT
  */

package/es/chat-message/index.js

@@ -1,5 +1,5 @@
 /**
- * tdesign v1.0.2-alpha.10
+ * tdesign v1.0.2-alpha.12
  * (c) 2026 tdesign
  * @license MIT
  */

package/es/chat-sender/index.js

@@ -1,5 +1,5 @@
 /**
- * tdesign v1.0.2-alpha.10
+ * tdesign v1.0.2-alpha.12
  * (c) 2026 tdesign
  * @license MIT
  */

package/es/chat-thinking/index.js

@@ -1,5 +1,5 @@
 /**
- * tdesign v1.0.2-alpha.10
+ * tdesign v1.0.2-alpha.12
  * (c) 2026 tdesign
  * @license MIT
  */

package/es/chatbot/docs/react-best-practice.d.ts

@@ -0,0 +1,13 @@
+export function SimpleCallbackExample(): import("react/jsx-runtime").JSX.Element;
+export function HybridExample(): import("react/jsx-runtime").JSX.Element;
+export function CrossComponentExample(): import("react/jsx-runtime").JSX.Element;
+export function AsyncWaitExample(): import("react/jsx-runtime").JSX.Element;
+export function CustomEventExample(): import("react/jsx-runtime").JSX.Element;
+declare namespace _default {
+    export { SimpleCallbackExample };
+    export { HybridExample };
+    export { CrossComponentExample };
+    export { AsyncWaitExample };
+    export { CustomEventExample };
+}
+export default _default;

package/es/chatbot/index.js

@@ -1,5 +1,5 @@
 /**
- * tdesign v1.0.2-alpha.10
+ * tdesign v1.0.2-alpha.12
  * (c) 2026 tdesign
  * @license MIT
  */

package/es/index.js

@@ -1,5 +1,5 @@
 /**
- * tdesign v1.0.2-alpha.10
+ * tdesign v1.0.2-alpha.12
  * (c) 2026 tdesign
  * @license MIT
  */
@@ -28,6 +28,8 @@ export { applyJsonPatch, findTargetElement, getMessageContentForCopy, isAIMessag
 export { StateManagerImpl, stateManager } from './chat-engine/core/adapters/agui/state-manager.js';
 export { AGUIEventType, ActivityDeltaEventSchema, ActivitySnapshotEventSchema, CustomEventSchema, EventSchemas, MessagesSnapshotEventSchema, RawEventSchema, RunErrorEventSchema, RunFinishedEventSchema, RunStartedEventSchema, StateDeltaEventSchema, StateSnapshotEventSchema, StepFinishedEventSchema, StepStartedEventSchema, TextMessageChunkEventSchema, TextMessageContentEventSchema, TextMessageEndEventSchema, TextMessageStartEventSchema, ThinkingEndEventSchema, ThinkingStartEventSchema, ThinkingTextMessageContentEventSchema, ThinkingTextMessageEndEventSchema, ThinkingTextMessageStartEventSchema, ToolCallArgsEventSchema, ToolCallChunkEventSchema, ToolCallEndEventSchema, ToolCallResultEventSchema, ToolCallStartEventSchema, isActivityEvent, isStateEvent, isTextMessageEvent, isThinkingEvent, isToolCallEvent } from './chat-engine/core/adapters/agui/events.js';
 export { AGUIAdapter } from './chat-engine/core/adapters/agui/index.js';
+export { ChatEventBus, createEventBus } from './chat-engine/core/event-bus/ChatEventBus.js';
+export { ChatEngineEventType } from './chat-engine/core/event-bus/types.js';
 import 'tdesign-web-components/lib/chatbot';
 import 'tdesign-web-components/lib/chat-message/content/reasoning-content';
 import 'tdesign-web-components/lib/chat-message/content/search-content';
@@ -51,6 +53,7 @@ import './chat-engine/components/activity/types.js';
 import './chat-engine/core/index.js';
 import '@babel/runtime/helpers/asyncToGenerator';
 import '@babel/runtime/regenerator';
+import './chat-engine/core/event-bus/index.js';
 import './chat-engine/core/store/message.js';
 import '@babel/runtime/helpers/toConsumableArray';
 import '@babel/runtime/helpers/get';

package/es/index.js.map

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

package/es/style/index.js

@@ -1,5 +1,5 @@
 /**
- * tdesign v1.0.2-alpha.10
+ * tdesign v1.0.2-alpha.12
  * (c) 2026 tdesign
  * @license MIT
  */

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tdesign-react/chat",
-  "version": "1.0.2-alpha.11",
+  "version": "1.0.2-alpha.13",
   "title": "@tdesign-react/chat",
   "description": "TDesign Pro Component for AIGC",
   "module": "es/index.js",
@@ -50,7 +50,7 @@
   },
   "dependencies": {
     "@babel/runtime": "~7.26.7",
-    "tdesign-web-components": "1.2.11-alpha.9",
+    "tdesign-web-components": "1.2.11-alpha.11",
     "classnames": "~2.5.1",
     "lodash-es": "^4.17.21",
     "zod": "^3.24.2",