@tdesign-react/chat 1.0.2-alpha.9 → 1.1.0-alpha.1

package/es/chat-engine/components/json-render/SurfaceStateManager.d.ts

@@ -0,0 +1,113 @@
+/**
+ * Surface 状态管理器
+ *
+ * 职责：
+ * 1. 缓存已创建的 Surface Schema（跨消息/跨轮次）
+ * 2. 提供订阅机制，当 Surface 数据更新时通知已渲染的组件
+ *
+ * 使用场景：
+ * - 第一轮对话：createSurface + updateComponents → 创建完整 UI，注册到缓存
+ * - 后续轮次：仅 updateDataModel → 更新缓存中的数据，通知订阅者重渲染
+ *
+ * 设计原则：
+ * 1. 服务端是状态的单一数据源（updateDataModel 来自服务端）
+ * 2. 本模块只负责存储和订阅，不负责 A2UI → JsonRender 的转换
+ * 3. 转换逻辑由 a2ui-to-jsonrender.ts 中的函数完成
+ */
+import type { JsonRenderSchema } from './types';
+export interface SurfaceCache {
+    /** Surface ID */
+    surfaceId: string;
+    /** Catalog ID */
+    catalogId?: string;
+    /** 当前的 json-render Schema */
+    schema: JsonRenderSchema;
+    /** 创建时间 */
+    createdAt: number;
+    /** 最后更新时间 */
+    updatedAt: number;
+}
+/** 订阅者回调函数类型 */
+export type SurfaceSubscriber = (schema: JsonRenderSchema) => void;
+/**
+ * Surface 状态管理器
+ * 单例模式，全局共享 Surface 缓存
+ */
+declare class SurfaceStateManager {
+    private surfaces;
+    /** 订阅者映射：surfaceId → Set<subscriber> */
+    private subscribers;
+    private debug;
+    /**
+     * 设置调试模式
+     */
+    setDebug(enabled: boolean): void;
+    /**
+     * 注册 Surface（由创建型消息调用）
+     *
+     * @param surfaceId Surface ID
+     * @param schema 转换后的 json-render Schema
+     * @param catalogId 可选的 Catalog ID
+     */
+    registerSurface(surfaceId: string, schema: JsonRenderSchema, catalogId?: string): void;
+    /**
+     * 更新 Surface 数据（由更新型消息调用）
+     *
+     * @param surfaceId Surface ID
+     * @param path JSON Pointer 路径
+     * @param op 操作类型
+     * @param value 值
+     * @returns 是否成功（Surface 存在）
+     */
+    updateData(surfaceId: string, path: string | undefined, op?: 'add' | 'replace' | 'remove', value?: unknown): boolean;
+    /**
+     * 订阅 Surface 状态变化
+     *
+     * @param surfaceId Surface ID
+     * @param subscriber 订阅者回调
+     * @returns 取消订阅函数
+     */
+    subscribe(surfaceId: string, subscriber: SurfaceSubscriber): () => void;
+    /**
+     * 异步通知订阅者（避免在 React 渲染期间调用 setState）
+     */
+    private notifySubscribersAsync;
+    /**
+     * 获取指定 Surface 的缓存
+     */
+    getSurface(surfaceId: string): SurfaceCache | undefined;
+    /**
+     * 获取指定 Surface 的 Schema
+     */
+    getSchema(surfaceId: string): JsonRenderSchema | null;
+    /**
+     * 检查 Surface 是否存在
+     */
+    hasSurface(surfaceId: string): boolean;
+    /**
+     * 获取所有 Surface ID
+     */
+    getAllSurfaceIds(): string[];
+    /**
+     * 删除 Surface（由 deleteSurface 消息调用）
+     */
+    deleteSurface(surfaceId: string): boolean;
+    /**
+     * 清除所有 Surface 缓存
+     */
+    clearAll(): void;
+    /**
+     * 获取缓存统计信息
+     */
+    getStats(): {
+        count: number;
+        surfaces: Array<{
+            id: string;
+            elementsCount: number;
+            updatedAt: number;
+            subscriberCount: number;
+        }>;
+    };
+}
+export declare const surfaceStateManager: SurfaceStateManager;
+export { SurfaceStateManager };

package/es/chat-engine/components/json-render/SurfaceStateManager.js

@@ -0,0 +1,195 @@
+/**
+ * tdesign v1.0.2-alpha.15
+ * (c) 2026 tdesign
+ * @license MIT
+ */
+
+import _slicedToArray from '@babel/runtime/helpers/slicedToArray';
+import _classCallCheck from '@babel/runtime/helpers/classCallCheck';
+import _createClass from '@babel/runtime/helpers/createClass';
+import _defineProperty from '@babel/runtime/helpers/defineProperty';
+import './adapters/index.js';
+import { applyA2UIDataUpdate } from './adapters/a2ui-to-jsonrender.js';
+import '@babel/runtime/helpers/typeof';
+import '@babel/runtime/helpers/objectWithoutProperties';
+
+var SurfaceStateManager = /*#__PURE__*/function () {
+  function SurfaceStateManager() {
+    _classCallCheck(this, SurfaceStateManager);
+    _defineProperty(this, "surfaces", /* @__PURE__ */new Map());
+    _defineProperty(this, "subscribers", /* @__PURE__ */new Map());
+    _defineProperty(this, "debug", false);
+  }
+  return _createClass(SurfaceStateManager, [{
+    key: "setDebug",
+    value: function setDebug(enabled) {
+      this.debug = enabled;
+    }
+  }, {
+    key: "registerSurface",
+    value: function registerSurface(surfaceId, schema, catalogId) {
+      var cache = {
+        surfaceId: surfaceId,
+        catalogId: catalogId,
+        schema: schema,
+        createdAt: Date.now(),
+        updatedAt: Date.now()
+      };
+      this.surfaces.set(surfaceId, cache);
+      if (this.debug) {
+        console.log("[SurfaceStateManager] \u6CE8\u518C Surface:", {
+          surfaceId: surfaceId,
+          elementsCount: Object.keys(schema.elements).length
+        });
+      }
+    }
+  }, {
+    key: "updateData",
+    value: function updateData(surfaceId, path) {
+      var op = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : "replace";
+      var value = arguments.length > 3 ? arguments[3] : undefined;
+      var cache = this.surfaces.get(surfaceId);
+      if (!cache) {
+        if (this.debug) {
+          console.warn("[SurfaceStateManager] updateData: Surface \u4E0D\u5B58\u5728", surfaceId);
+        }
+        return false;
+      }
+      cache.schema = applyA2UIDataUpdate(cache.schema, path, op, value);
+      cache.updatedAt = Date.now();
+      if (this.debug) {
+        console.log("[SurfaceStateManager] \u66F4\u65B0\u6570\u636E:", {
+          surfaceId: surfaceId,
+          path: path,
+          op: op,
+          value: value,
+          newData: cache.schema.data
+        });
+      }
+      this.notifySubscribersAsync(surfaceId, cache.schema);
+      return true;
+    }
+  }, {
+    key: "subscribe",
+    value: function subscribe(surfaceId, subscriber) {
+      var _this = this;
+      if (!this.subscribers.has(surfaceId)) {
+        this.subscribers.set(surfaceId, /* @__PURE__ */new Set());
+      }
+      this.subscribers.get(surfaceId).add(subscriber);
+      if (this.debug) {
+        console.log("[SurfaceStateManager] \u8BA2\u9605 Surface:", surfaceId);
+      }
+      return function () {
+        var subs = _this.subscribers.get(surfaceId);
+        if (subs) {
+          subs["delete"](subscriber);
+          if (subs.size === 0) {
+            _this.subscribers["delete"](surfaceId);
+          }
+        }
+        if (_this.debug) {
+          console.log("[SurfaceStateManager] \u53D6\u6D88\u8BA2\u9605 Surface:", surfaceId);
+        }
+      };
+    }
+  }, {
+    key: "notifySubscribersAsync",
+    value: function notifySubscribersAsync(surfaceId, schema) {
+      var _this2 = this;
+      var subs = this.subscribers.get(surfaceId);
+      if (!subs || subs.size === 0) {
+        return;
+      }
+      if (this.debug) {
+        console.log("[SurfaceStateManager] \u51C6\u5907\u901A\u77E5\u8BA2\u9605\u8005:", {
+          surfaceId: surfaceId,
+          subscriberCount: subs.size
+        });
+      }
+      queueMicrotask(function () {
+        var currentSubs = _this2.subscribers.get(surfaceId);
+        if (!currentSubs || currentSubs.size === 0) {
+          return;
+        }
+        if (_this2.debug) {
+          console.log("[SurfaceStateManager] \u6267\u884C\u901A\u77E5\u8BA2\u9605\u8005:", {
+            surfaceId: surfaceId
+          });
+        }
+        currentSubs.forEach(function (subscriber) {
+          try {
+            subscriber(schema);
+          } catch (e) {
+            console.error("[SurfaceStateManager] \u8BA2\u9605\u8005\u56DE\u8C03\u51FA\u9519:", e);
+          }
+        });
+      });
+    }
+  }, {
+    key: "getSurface",
+    value: function getSurface(surfaceId) {
+      return this.surfaces.get(surfaceId);
+    }
+  }, {
+    key: "getSchema",
+    value: function getSchema(surfaceId) {
+      var _this$surfaces$get;
+      return ((_this$surfaces$get = this.surfaces.get(surfaceId)) === null || _this$surfaces$get === void 0 ? void 0 : _this$surfaces$get.schema) || null;
+    }
+  }, {
+    key: "hasSurface",
+    value: function hasSurface(surfaceId) {
+      return this.surfaces.has(surfaceId);
+    }
+  }, {
+    key: "getAllSurfaceIds",
+    value: function getAllSurfaceIds() {
+      return Array.from(this.surfaces.keys());
+    }
+  }, {
+    key: "deleteSurface",
+    value: function deleteSurface(surfaceId) {
+      this.subscribers["delete"](surfaceId);
+      var deleted = this.surfaces["delete"](surfaceId);
+      if (this.debug && deleted) {
+        console.log("[SurfaceStateManager] \u5220\u9664 Surface:", surfaceId);
+      }
+      return deleted;
+    }
+  }, {
+    key: "clearAll",
+    value: function clearAll() {
+      this.surfaces.clear();
+      this.subscribers.clear();
+      if (this.debug) {
+        console.log("[SurfaceStateManager] \u6E05\u9664\u6240\u6709\u7F13\u5B58");
+      }
+    }
+  }, {
+    key: "getStats",
+    value: function getStats() {
+      var _this3 = this;
+      var surfaces = Array.from(this.surfaces.entries()).map(function (_ref) {
+        var _this3$subscribers$ge;
+        var _ref2 = _slicedToArray(_ref, 2),
+          id = _ref2[0],
+          cache = _ref2[1];
+        return {
+          id: id,
+          elementsCount: Object.keys(cache.schema.elements).length,
+          updatedAt: cache.updatedAt,
+          subscriberCount: ((_this3$subscribers$ge = _this3.subscribers.get(id)) === null || _this3$subscribers$ge === void 0 ? void 0 : _this3$subscribers$ge.size) || 0
+        };
+      });
+      return {
+        count: this.surfaces.size,
+        surfaces: surfaces
+      };
+    }
+  }]);
+}();
+var surfaceStateManager = new SurfaceStateManager();
+
+export { SurfaceStateManager, surfaceStateManager };
+//# sourceMappingURL=SurfaceStateManager.js.map

package/es/chat-engine/components/json-render/SurfaceStateManager.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SurfaceStateManager.js","sources":["../../../../../pro-components/chat/chat-engine/components/json-render/SurfaceStateManager.ts"],"sourcesContent":["/**\n * Surface 状态管理器\n * \n * 职责：\n * 1. 缓存已创建的 Surface Schema（跨消息/跨轮次）\n * 2. 提供订阅机制，当 Surface 数据更新时通知已渲染的组件\n * \n * 使用场景：\n * - 第一轮对话：createSurface + updateComponents → 创建完整 UI，注册到缓存\n * - 后续轮次：仅 updateDataModel → 更新缓存中的数据，通知订阅者重渲染\n * \n * 设计原则：\n * 1. 服务端是状态的单一数据源（updateDataModel 来自服务端）\n * 2. 本模块只负责存储和订阅，不负责 A2UI → JsonRender 的转换\n * 3. 转换逻辑由 a2ui-to-jsonrender.ts 中的函数完成\n */\n\nimport type { JsonRenderSchema } from './types';\nimport { applyA2UIDataUpdate } from './adapters';\n\nexport interface SurfaceCache {\n  /** Surface ID */\n  surfaceId: string;\n  /** Catalog ID */\n  catalogId?: string;\n  /** 当前的 json-render Schema */\n  schema: JsonRenderSchema;\n  /** 创建时间 */\n  createdAt: number;\n  /** 最后更新时间 */\n  updatedAt: number;\n}\n\n/** 订阅者回调函数类型 */\nexport type SurfaceSubscriber = (schema: JsonRenderSchema) => void;\n\n/**\n * Surface 状态管理器\n * 单例模式，全局共享 Surface 缓存\n */\nclass SurfaceStateManager {\n  private surfaces: Map<string, SurfaceCache> = new Map();\n  /** 订阅者映射：surfaceId → Set<subscriber> */\n  private subscribers: Map<string, Set<SurfaceSubscriber>> = new Map();\n  private debug: boolean = false;\n\n  /**\n   * 设置调试模式\n   */\n  setDebug(enabled: boolean): void {\n    this.debug = enabled;\n  }\n\n  /**\n   * 注册 Surface（由创建型消息调用）\n   * \n   * @param surfaceId Surface ID\n   * @param schema 转换后的 json-render Schema\n   * @param catalogId 可选的 Catalog ID\n   */\n  registerSurface(surfaceId: string, schema: JsonRenderSchema, catalogId?: string): void {\n    const cache: SurfaceCache = {\n      surfaceId,\n      catalogId,\n      schema,\n      createdAt: Date.now(),\n      updatedAt: Date.now(),\n    };\n    \n    this.surfaces.set(surfaceId, cache);\n    \n    if (this.debug) {\n      // eslint-disable-next-line no-console\n      console.log('[SurfaceStateManager] 注册 Surface:', {\n        surfaceId,\n        elementsCount: Object.keys(schema.elements).length,\n      });\n    }\n  }\n\n  /**\n   * 更新 Surface 数据（由更新型消息调用）\n   * \n   * @param surfaceId Surface ID\n   * @param path JSON Pointer 路径\n   * @param op 操作类型\n   * @param value 值\n   * @returns 是否成功（Surface 存在）\n   */\n  updateData(\n    surfaceId: string,\n    path: string | undefined,\n    op: 'add' | 'replace' | 'remove' = 'replace',\n    value?: unknown,\n  ): boolean {\n    const cache = this.surfaces.get(surfaceId);\n    if (!cache) {\n      if (this.debug) {\n        // eslint-disable-next-line no-console\n        console.warn('[SurfaceStateManager] updateData: Surface 不存在', surfaceId);\n      }\n      return false;\n    }\n\n    // 使用已有的增量更新函数\n    cache.schema = applyA2UIDataUpdate(cache.schema, path, op, value);\n    cache.updatedAt = Date.now();\n\n    if (this.debug) {\n      // eslint-disable-next-line no-console\n      console.log('[SurfaceStateManager] 更新数据:', {\n        surfaceId,\n        path,\n        op,\n        value,\n        newData: cache.schema.data,\n      });\n    }\n\n    // 异步通知订阅者\n    this.notifySubscribersAsync(surfaceId, cache.schema);\n    \n    return true;\n  }\n\n  /**\n   * 订阅 Surface 状态变化\n   * \n   * @param surfaceId Surface ID\n   * @param subscriber 订阅者回调\n   * @returns 取消订阅函数\n   */\n  subscribe(surfaceId: string, subscriber: SurfaceSubscriber): () => void {\n    if (!this.subscribers.has(surfaceId)) {\n      this.subscribers.set(surfaceId, new Set());\n    }\n    this.subscribers.get(surfaceId)!.add(subscriber);\n\n    if (this.debug) {\n      // eslint-disable-next-line no-console\n      console.log('[SurfaceStateManager] 订阅 Surface:', surfaceId);\n    }\n\n    // 返回取消订阅函数\n    return () => {\n      const subs = this.subscribers.get(surfaceId);\n      if (subs) {\n        subs.delete(subscriber);\n        if (subs.size === 0) {\n          this.subscribers.delete(surfaceId);\n        }\n      }\n      if (this.debug) {\n        // eslint-disable-next-line no-console\n        console.log('[SurfaceStateManager] 取消订阅 Surface:', surfaceId);\n      }\n    };\n  }\n\n  /**\n   * 异步通知订阅者（避免在 React 渲染期间调用 setState）\n   */\n  private notifySubscribersAsync(surfaceId: string, schema: JsonRenderSchema): void {\n    const subs = this.subscribers.get(surfaceId);\n    if (!subs || subs.size === 0) {\n      return;\n    }\n\n    if (this.debug) {\n      // eslint-disable-next-line no-console\n      console.log('[SurfaceStateManager] 准备通知订阅者:', { surfaceId, subscriberCount: subs.size });\n    }\n\n    // 使用 queueMicrotask 延迟到当前渲染完成后执行\n    queueMicrotask(() => {\n      // 重新获取订阅者（可能在这期间已被取消）\n      const currentSubs = this.subscribers.get(surfaceId);\n      if (!currentSubs || currentSubs.size === 0) {\n        return;\n      }\n\n      if (this.debug) {\n        // eslint-disable-next-line no-console\n        console.log('[SurfaceStateManager] 执行通知订阅者:', { surfaceId });\n      }\n\n      currentSubs.forEach(subscriber => {\n        try {\n          subscriber(schema);\n        } catch (e) {\n          // eslint-disable-next-line no-console\n          console.error('[SurfaceStateManager] 订阅者回调出错:', e);\n        }\n      });\n    });\n  }\n\n  /**\n   * 获取指定 Surface 的缓存\n   */\n  getSurface(surfaceId: string): SurfaceCache | undefined {\n    return this.surfaces.get(surfaceId);\n  }\n\n  /**\n   * 获取指定 Surface 的 Schema\n   */\n  getSchema(surfaceId: string): JsonRenderSchema | null {\n    return this.surfaces.get(surfaceId)?.schema || null;\n  }\n\n  /**\n   * 检查 Surface 是否存在\n   */\n  hasSurface(surfaceId: string): boolean {\n    return this.surfaces.has(surfaceId);\n  }\n\n  /**\n   * 获取所有 Surface ID\n   */\n  getAllSurfaceIds(): string[] {\n    return Array.from(this.surfaces.keys());\n  }\n\n  /**\n   * 删除 Surface（由 deleteSurface 消息调用）\n   */\n  deleteSurface(surfaceId: string): boolean {\n    this.subscribers.delete(surfaceId);\n    const deleted = this.surfaces.delete(surfaceId);\n    \n    if (this.debug && deleted) {\n      // eslint-disable-next-line no-console\n      console.log('[SurfaceStateManager] 删除 Surface:', surfaceId);\n    }\n    \n    return deleted;\n  }\n\n  /**\n   * 清除所有 Surface 缓存\n   */\n  clearAll(): void {\n    this.surfaces.clear();\n    this.subscribers.clear();\n    if (this.debug) {\n      // eslint-disable-next-line no-console\n      console.log('[SurfaceStateManager] 清除所有缓存');\n    }\n  }\n\n  /**\n   * 获取缓存统计信息\n   */\n  getStats(): { \n    count: number; \n    surfaces: Array<{ id: string; elementsCount: number; updatedAt: number; subscriberCount: number }>;\n  } {\n    const surfaces = Array.from(this.surfaces.entries()).map(([id, cache]) => ({\n      id,\n      elementsCount: Object.keys(cache.schema.elements).length,\n      updatedAt: cache.updatedAt,\n      subscriberCount: this.subscribers.get(id)?.size || 0,\n    }));\n\n    return {\n      count: this.surfaces.size,\n      surfaces,\n    };\n  }\n}\n\n// 导出单例实例\nexport const surfaceStateManager = new SurfaceStateManager();\n\n// 导出类供测试或创建独立实例\nexport { SurfaceStateManager };\n"],"names":["SurfaceStateManager","_classCallCheck","_defineProperty","Map","_createClass","key","value","setDebug","enabled","debug","registerSurface","surfaceId","schema","catalogId","cache","createdAt","Date","now","updatedAt","surfaces","set","console","log","elementsCount","Object","keys","elements","length","updateData","path","op","arguments","undefined","get","warn","applyA2UIDataUpdate","newData","data","notifySubscribersAsync","subscribe","subscriber","_this","subscribers","has","Set","add","subs","size","_this2","subscriberCount","queueMicrotask","currentSubs","forEach","e","error","getSurface","getSchema","_this$surfaces$get","hasSurface","getAllSurfaceIds","Array","from","deleteSurface","deleted","clearAll","clear","getStats","_this3","entries","map","_ref","_this3$subscribers$ge","_ref2","_slicedToArray","id","count","surfaceStateManager"],"mappings":"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"}

package/es/chat-engine/components/json-render/adapters/a2ui-to-jsonrender.d.ts

@@ -0,0 +1,49 @@
+/**
+ * A2UI v0.9 → json-render 适配器
+ * 将 A2UI v0.9 协议转换为 json-render Schema
+ *
+ * 核心设计：
+ * 1. A2UI v0.9 的 createSurface 只是初始化信号，不包含组件数据
+ * 2. 组件数据通过 updateComponents 消息逐步发送（数组形式）
+ * 3. 数据模型通过 updateDataModel 消息填充
+ * 4. 组件字段名是 'component'，不是 'type'
+ */
+import type { JsonRenderSchema } from '../types';
+import type { A2UIComponent, A2UIMessage } from './a2ui-types';
+/**
+ * 转换 A2UI v0.9 消息数组为 json-render Schema
+ *
+ * 处理流程：
+ * 1. 查找 createSurface 消息初始化 Surface
+ * 2. 累积所有 updateComponents 消息构建组件树
+ * 3. 累积所有 updateDataModel 消息填充数据
+ * 4. 转换为 json-render Schema
+ *
+ * @param messages A2UI 消息数组
+ * @returns json-render Schema 或 null
+ */
+export declare function convertA2UIMessagesToJsonRender(messages: A2UIMessage[]): JsonRenderSchema | null;
+/**
+ * 应用增量更新到现有 Schema
+ *
+ * @param schema 当前 json-render Schema
+ * @param components A2UI updateComponents 的组件数组
+ * @returns 更新后的 Schema
+ */
+export declare function applyA2UIUpdates(schema: JsonRenderSchema, components: A2UIComponent[]): JsonRenderSchema;
+/**
+ * 应用数据模型更新到现有 Schema
+ *
+ * @param schema 当前 json-render Schema
+ * @param path JSON Pointer 路径
+ * @param op 操作类型
+ * @param value 值
+ * @returns 更新后的 Schema
+ */
+export declare function applyA2UIDataUpdate(schema: JsonRenderSchema, path: string | undefined, op?: 'add' | 'replace' | 'remove', value?: unknown): JsonRenderSchema;
+declare const _default: {
+    convertA2UIMessagesToJsonRender: typeof convertA2UIMessagesToJsonRender;
+    applyA2UIUpdates: typeof applyA2UIUpdates;
+    applyA2UIDataUpdate: typeof applyA2UIDataUpdate;
+};
+export default _default;