@tdesign-react/chat 1.1.0-alpha.5 → 1.1.0-alpha.6

package/es/chat-engine/components/json-render/registry/index.js

@@ -0,0 +1,76 @@
+/**
+ * tdesign v1.1.0-alpha.5
+ * (c) 2026 tdesign
+ * @license MIT
+ */
+
+import '@babel/runtime/helpers/defineProperty';
+import '@babel/runtime/helpers/slicedToArray';
+import 'react';
+import '../../../../_chunks/dep-96eca06f.js';
+import '../catalog/atomic/button.js';
+export { d as A2UIButton, A as A2UITextField, a as a2uiRegistry, g as createA2UIJsonRenderActivityConfig, b as createA2UIRegistry, c as createCustomRegistry, f as createJsonRenderActivityConfig, t as tdesignRegistry, e as withA2UIBinding, w as withStableProps } from '../../../../_chunks/dep-1743bd61.js';
+import '../catalog/atomic/card.js';
+import '../catalog/atomic/text.js';
+import '../catalog/atomic/layout.js';
+import '@babel/runtime/helpers/typeof';
+import '@babel/runtime/helpers/objectWithoutProperties';
+import 'tdesign-react';
+import '../renderer/JsonRenderActivityRenderer.js';
+import '../renderer/JsonUIRenderer.js';
+import '../contexts/index.js';
+import '../contexts/data.js';
+import '@babel/runtime/helpers/classCallCheck';
+import '@babel/runtime/helpers/createClass';
+import '@babel/runtime/helpers/possibleConstructorReturn';
+import '@babel/runtime/helpers/getPrototypeOf';
+import '@babel/runtime/helpers/inherits';
+import '../../../../_chunks/dep-16520c2b.js';
+import '@babel/runtime/helpers/wrapNativeSuper';
+import '@json-render/core';
+import '../contexts/store.js';
+import '../contexts/visibility.js';
+import '../contexts/actions.js';
+import '@babel/runtime/helpers/asyncToGenerator';
+import '@babel/runtime/regenerator';
+import '../contexts/validation.js';
+import '../contexts/tree.js';
+import '../renderer/A2UIJsonRenderActivityRenderer.js';
+import '../../../core/index.js';
+import '../../../core/adapters/agui/index.js';
+import '@babel/runtime/helpers/toConsumableArray';
+import '../../../core/adapters/agui/event-mapper.js';
+import '../../../core/adapters/agui/types/index.js';
+import 'zod';
+import '../../../core/adapters/agui/StateManager.js';
+import '../../../core/utils/index.js';
+import '../../../core/utils/immutable-patch.js';
+import '@babel/runtime/helpers/toArray';
+import '../../../core/adapters/agui/ActivityManager.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';
+import '../../../core/processor/index.js';
+import '../../../core/server/index.js';
+import '../../../core/server/llm-service.js';
+import '../../../core/utils/logger.js';
+import '../../../core/server/batch-client.js';
+import '../../../core/utils/eventEmitter.js';
+import '../../../core/server/errors.js';
+import '../../../core/server/sse-client.js';
+import '../../../core/server/connection-manager.js';
+import '../../../core/server/sse-parser.js';
+import '../../../core/server/types.js';
+import '../../../core/adapters/index.js';
+import '../../../core/adapters/json-render/index.js';
+import '../../../core/adapters/json-render/a2ui-to-jsonrender.js';
+import '../../../core/adapters/json-render/types/a2ui.js';
+import '../../../core/adapters/json-render/SurfaceStateManager.js';
+import '../../../core/adapters/json-render/types/index.js';
+import '../../../core/adapters/json-render/types/core.js';
+import '../catalog/catalog-to-prompt.js';
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,35 @@
+/**
+ * A2UI v0.9 + json-render Activity 渲染器
+ * 将 A2UI v0.9 协议转换为 json-render Schema 进行渲染
+ *
+ * 工作流程：
+ * 1. 接收 ACTIVITY_SNAPSHOT/DELTA 中的 A2UI content
+ * 2. 区分消息类型：UI型 vs 纯数据型
+ * 3. UI型：转换为 Schema 并注册到 SurfaceStateManager，渲染 UI
+ * 4. 纯数据型：通过 SurfaceStateManager 更新数据，触发订阅者重渲染，本组件不渲染
+ *
+ * 消息分类：
+ * - UI型消息：包含 createSurface / updateComponents / deleteSurface → 需要渲染/更新 UI
+ * - 纯数据型消息：仅包含 updateDataModel → 只更新状态，不渲染新 UI
+ */
+import React from 'react';
+import type { A2UIMessage } from '../../../core';
+import type { JsonRenderActivityProps, ComponentRegistry } from '../types';
+export interface A2UIJsonRenderActivityRendererProps extends Omit<JsonRenderActivityProps, 'content'> {
+    /** A2UI content（包含 messages 数组） */
+    content: {
+        messages?: A2UIMessage[];
+        [key: string]: any;
+    };
+    /** 组件注册表（必须） */
+    registry: ComponentRegistry;
+    /** Action 处理器（可选） */
+    actionHandlers?: Record<string, (params: Record<string, unknown>) => void | Promise<void>>;
+    /** 显示调试信息 */
+    debug?: boolean;
+}
+/**
+ * A2UI v0.9 + json-render Activity 渲染器组件
+ */
+export declare const A2UIJsonRenderActivityRenderer: React.FC<A2UIJsonRenderActivityRendererProps>;
+export default A2UIJsonRenderActivityRenderer;

package/es/chat-engine/components/json-render/renderer/A2UIJsonRenderActivityRenderer.js

@@ -0,0 +1,271 @@
+/**
+ * tdesign v1.1.0-alpha.5
+ * (c) 2026 tdesign
+ * @license MIT
+ */
+
+import _slicedToArray from '@babel/runtime/helpers/slicedToArray';
+import React, { useEffect, useState, useMemo, useCallback } from 'react';
+import '../../../core/index.js';
+import { JsonRenderActivityRenderer } from './JsonRenderActivityRenderer.js';
+import { surfaceStateManager } from '../../../core/adapters/json-render/SurfaceStateManager.js';
+import { convertA2UIMessagesToJsonRender } from '../../../core/adapters/json-render/a2ui-to-jsonrender.js';
+import '@babel/runtime/helpers/objectWithoutProperties';
+import '@babel/runtime/helpers/asyncToGenerator';
+import '@babel/runtime/helpers/classCallCheck';
+import '@babel/runtime/helpers/createClass';
+import '@babel/runtime/helpers/defineProperty';
+import '@babel/runtime/regenerator';
+import '../../../core/adapters/agui/index.js';
+import '@babel/runtime/helpers/toConsumableArray';
+import '../../../core/adapters/agui/event-mapper.js';
+import '../../../core/adapters/agui/types/index.js';
+import 'zod';
+import '@babel/runtime/helpers/possibleConstructorReturn';
+import '@babel/runtime/helpers/getPrototypeOf';
+import '@babel/runtime/helpers/inherits';
+import '@babel/runtime/helpers/wrapNativeSuper';
+import '../../../core/adapters/agui/StateManager.js';
+import '@babel/runtime/helpers/typeof';
+import '../../../core/utils/index.js';
+import '../../../core/utils/immutable-patch.js';
+import '@babel/runtime/helpers/toArray';
+import '../../../core/adapters/agui/ActivityManager.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';
+import '../../../../_chunks/dep-16520c2b.js';
+import '../../../core/processor/index.js';
+import '../../../core/server/index.js';
+import '../../../core/server/llm-service.js';
+import '../../../core/utils/logger.js';
+import '../../../core/server/batch-client.js';
+import '../../../core/utils/eventEmitter.js';
+import '../../../core/server/errors.js';
+import '../../../core/server/sse-client.js';
+import '../../../core/server/connection-manager.js';
+import '../../../core/server/sse-parser.js';
+import '../../../core/server/types.js';
+import '../../../core/adapters/index.js';
+import '../../../core/adapters/json-render/index.js';
+import '../../../core/adapters/json-render/types/a2ui.js';
+import '../../../core/adapters/json-render/types/index.js';
+import '../../../core/adapters/json-render/types/core.js';
+import '../../../../_chunks/dep-96eca06f.js';
+import './JsonUIRenderer.js';
+import '../contexts/index.js';
+import '../contexts/data.js';
+import '@json-render/core';
+import '../contexts/store.js';
+import '../contexts/visibility.js';
+import '../contexts/actions.js';
+import '../contexts/validation.js';
+import '../contexts/tree.js';
+
+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 extractSurfaceId(messages) {
+  var _iterator = _createForOfIteratorHelper(messages),
+    _step;
+  try {
+    for (_iterator.s(); !(_step = _iterator.n()).done;) {
+      var msg = _step.value;
+      if (msg.createSurface) return msg.createSurface.surfaceId;
+      if (msg.updateComponents) return msg.updateComponents.surfaceId;
+      if (msg.updateDataModel) return msg.updateDataModel.surfaceId;
+      if (msg.deleteSurface) return msg.deleteSurface.surfaceId;
+    }
+  } catch (err) {
+    _iterator.e(err);
+  } finally {
+    _iterator.f();
+  }
+  return null;
+}
+function isUIMessages(messages) {
+  return messages.some(function (msg) {
+    return msg.createSurface || msg.updateComponents || msg.deleteSurface;
+  });
+}
+function hasDeletionMessages(messages) {
+  return messages.some(function (msg) {
+    return msg.deleteSurface;
+  });
+}
+function hasCreationMessages(messages) {
+  return messages.some(function (msg) {
+    return msg.createSurface || msg.updateComponents;
+  });
+}
+var A2UIJsonRenderActivityRenderer = function A2UIJsonRenderActivityRenderer(_ref) {
+  var activityType = _ref.activityType,
+    content = _ref.content,
+    messageId = _ref.messageId,
+    ext = _ref.ext,
+    registry = _ref.registry,
+    actionHandlers = _ref.actionHandlers,
+    _ref$debug = _ref.debug,
+    debug = _ref$debug === void 0 ? false : _ref$debug;
+  useEffect(function () {
+    surfaceStateManager.setDebug(debug);
+  }, [debug]);
+  var _useState = useState(0),
+    _useState2 = _slicedToArray(_useState, 2),
+    schemaVersion = _useState2[0],
+    setSchemaVersion = _useState2[1];
+  var _useMemo = useMemo(function () {
+      var msgs = content.messages;
+      if (!Array.isArray(msgs) || msgs.length === 0) {
+        return {
+          surfaceId: null,
+          isUI: false,
+          isDeletion: false,
+          isCreation: false,
+          messages: []
+        };
+      }
+      return {
+        surfaceId: extractSurfaceId(msgs),
+        isUI: isUIMessages(msgs),
+        isDeletion: hasDeletionMessages(msgs),
+        isCreation: hasCreationMessages(msgs),
+        messages: msgs
+      };
+    }, [content.messages]),
+    surfaceId = _useMemo.surfaceId,
+    isUI = _useMemo.isUI,
+    isDeletion = _useMemo.isDeletion,
+    isCreation = _useMemo.isCreation,
+    messages = _useMemo.messages;
+  var initialSchema = useMemo(function () {
+    if (!surfaceId || messages.length === 0) {
+      return null;
+    }
+    if (debug) {
+      console.log("[A2UI Adapter] \u5904\u7406\u6D88\u606F:", {
+        messageId: messageId,
+        surfaceId: surfaceId,
+        messagesCount: messages.length,
+        messageTypes: messages.map(function (m) {
+          return Object.keys(m).filter(function (k) {
+            return ["createSurface", "updateComponents", "updateDataModel", "deleteSurface"].includes(k);
+          })[0];
+        }),
+        isUI: isUI,
+        isCreation: isCreation,
+        isDeletion: isDeletion,
+        cachedSurfaces: surfaceStateManager.getAllSurfaceIds()
+      });
+    }
+    if (isDeletion) {
+      surfaceStateManager.deleteSurface(surfaceId);
+      if (debug) {
+        console.log("[A2UI Adapter] \u5220\u9664 Surface:", surfaceId);
+      }
+      return null;
+    }
+    if (isCreation) {
+      var schema = convertA2UIMessagesToJsonRender(messages);
+      if (schema) {
+        var _messages$find;
+        var catalogId = (_messages$find = messages.find(function (m) {
+          return m.createSurface;
+        })) === null || _messages$find === void 0 || (_messages$find = _messages$find.createSurface) === null || _messages$find === void 0 ? void 0 : _messages$find.catalogId;
+        surfaceStateManager.registerSurface(surfaceId, schema, catalogId);
+        if (debug) {
+          console.log("[A2UI Adapter] \u521B\u5EFA\u578B\u6D88\u606F\uFF0C\u6CE8\u518C Surface:", {
+            surfaceId: surfaceId,
+            elementsCount: Object.keys(schema.elements).length,
+            data: schema.data
+          });
+        }
+      }
+      return schema;
+    }
+    var _iterator2 = _createForOfIteratorHelper(messages),
+      _step2;
+    try {
+      for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
+        var msg = _step2.value;
+        if (msg.updateDataModel) {
+          var _msg$updateDataModel = msg.updateDataModel,
+            path = _msg$updateDataModel.path,
+            op = _msg$updateDataModel.op,
+            value = _msg$updateDataModel.value;
+          var success = surfaceStateManager.updateData(surfaceId, path, op || "replace", value);
+          if (debug) {
+            console.log("[A2UI Adapter] \u66F4\u65B0\u578B\u6D88\u606F\uFF0C\u66F4\u65B0\u6570\u636E:", {
+              surfaceId: surfaceId,
+              path: path,
+              op: op || "replace",
+              value: value,
+              success: success
+            });
+          }
+        }
+      }
+    } catch (err) {
+      _iterator2.e(err);
+    } finally {
+      _iterator2.f();
+    }
+    return null;
+  }, [messages, surfaceId, isCreation, isDeletion, isUI, debug, messageId]);
+  var handleSchemaUpdate = useCallback(function () {
+    if (debug) {
+      console.log("[A2UI Adapter] \u6536\u5230\u72B6\u6001\u66F4\u65B0\u901A\u77E5\uFF0C\u89E6\u53D1\u91CD\u6E32\u67D3");
+    }
+    setSchemaVersion(function (v) {
+      return v + 1;
+    });
+  }, [debug]);
+  useEffect(function () {
+    if (!isCreation || !surfaceId) {
+      return;
+    }
+    if (debug) {
+      console.log("[A2UI Adapter] \u8BA2\u9605 Surface \u72B6\u6001:", surfaceId);
+    }
+    var unsubscribe = surfaceStateManager.subscribe(surfaceId, handleSchemaUpdate);
+    return function () {
+      if (debug) {
+        console.log("[A2UI Adapter] \u53D6\u6D88\u8BA2\u9605 Surface \u72B6\u6001:", surfaceId);
+      }
+      unsubscribe();
+    };
+  }, [isCreation, surfaceId, handleSchemaUpdate, debug]);
+  var currentSchema = useMemo(function () {
+    if (!isCreation || !surfaceId) {
+      return null;
+    }
+    return surfaceStateManager.getSchema(surfaceId) || initialSchema;
+  }, [isCreation, surfaceId, initialSchema, schemaVersion]);
+  if (!isUI) {
+    if (debug && messages.length > 0) {
+      console.log("[A2UI Adapter] \u7EAF\u6570\u636E\u66F4\u65B0\u6D88\u606F\uFF0C\u8DF3\u8FC7\u6E32\u67D3");
+    }
+    return null;
+  }
+  if (isDeletion && !isCreation) {
+    if (debug) {
+      console.log("[A2UI Adapter] \u5220\u9664\u578B\u6D88\u606F\uFF0C\u8DF3\u8FC7\u6E32\u67D3");
+    }
+    return null;
+  }
+  return /* @__PURE__ */React.createElement(JsonRenderActivityRenderer, {
+    activityType: activityType,
+    content: currentSchema,
+    messageId: messageId,
+    ext: ext,
+    registry: registry,
+    actionHandlers: actionHandlers
+  });
+};
+
+export { A2UIJsonRenderActivityRenderer, A2UIJsonRenderActivityRenderer as default };
+//# sourceMappingURL=A2UIJsonRenderActivityRenderer.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"A2UIJsonRenderActivityRenderer.js","sources":["../../../../../../pro-components/chat/chat-engine/components/json-render/renderer/A2UIJsonRenderActivityRenderer.tsx"],"sourcesContent":["/**\n * A2UI v0.9 + json-render Activity 渲染器\n * 将 A2UI v0.9 协议转换为 json-render Schema 进行渲染\n * \n * 工作流程：\n * 1. 接收 ACTIVITY_SNAPSHOT/DELTA 中的 A2UI content\n * 2. 区分消息类型：UI型 vs 纯数据型\n * 3. UI型：转换为 Schema 并注册到 SurfaceStateManager，渲染 UI\n * 4. 纯数据型：通过 SurfaceStateManager 更新数据，触发订阅者重渲染，本组件不渲染\n * \n * 消息分类：\n * - UI型消息：包含 createSurface / updateComponents / deleteSurface → 需要渲染/更新 UI\n * - 纯数据型消息：仅包含 updateDataModel → 只更新状态，不渲染新 UI\n */\n\nimport React, { useMemo, useEffect, useState, useCallback } from 'react';\nimport { convertA2UIMessagesToJsonRender, surfaceStateManager } from '../../../core';\nimport type { A2UIMessage, JsonRenderSchema } from '../../../core';\nimport type { JsonRenderActivityProps, ComponentRegistry } from '../types';\nimport { JsonRenderActivityRenderer } from './JsonRenderActivityRenderer';\n\n\nexport interface A2UIJsonRenderActivityRendererProps extends Omit<JsonRenderActivityProps, 'content'> {\n  /** A2UI content（包含 messages 数组） */\n  content: {\n    messages?: A2UIMessage[];\n    [key: string]: any;\n  };\n  /** 组件注册表（必须） */\n  registry: ComponentRegistry;\n  /** Action 处理器（可选） */\n  actionHandlers?: Record<string, (params: Record<string, unknown>) => void | Promise<void>>;\n  /** 显示调试信息 */\n  debug?: boolean;\n}\n\n/**\n * 从消息中提取 surfaceId\n */\nfunction extractSurfaceId(messages: A2UIMessage[]): string | null {\n  for (const msg of messages) {\n    if (msg.createSurface) return msg.createSurface.surfaceId;\n    if (msg.updateComponents) return msg.updateComponents.surfaceId;\n    if (msg.updateDataModel) return msg.updateDataModel.surfaceId;\n    if (msg.deleteSurface) return msg.deleteSurface.surfaceId;\n  }\n  return null;\n}\n\n/**\n * 判断消息是否为\"UI型\"（需要渲染/更新 UI）\n * 包括 createSurface / updateComponents / deleteSurface\n * 只有纯 updateDataModel 消息不需要渲染\n */\nfunction isUIMessages(messages: A2UIMessage[]): boolean {\n  return messages.some(msg => msg.createSurface || msg.updateComponents || msg.deleteSurface);\n}\n\n/**\n * 判断消息是否包含删除操作\n */\nfunction hasDeletionMessages(messages: A2UIMessage[]): boolean {\n  return messages.some(msg => msg.deleteSurface);\n}\n\n/**\n * 判断消息是否包含创建/更新操作（需要渲染 UI 的）\n */\nfunction hasCreationMessages(messages: A2UIMessage[]): boolean {\n  return messages.some(msg => msg.createSurface || msg.updateComponents);\n}\n\n/**\n * A2UI v0.9 + json-render Activity 渲染器组件\n */\nexport const A2UIJsonRenderActivityRenderer: React.FC<A2UIJsonRenderActivityRendererProps> = ({\n  activityType,\n  content,\n  messageId,\n  ext,\n  registry,\n  actionHandlers,\n  debug = false,\n}) => {\n  // 设置调试模式\n  useEffect(() => {\n    surfaceStateManager.setDebug(debug);\n  }, [debug]);\n\n  // 用于触发重渲染的版本号\n  const [schemaVersion, setSchemaVersion] = useState(0);\n\n  // 分析消息类型\n  const { surfaceId, isUI, isDeletion, isCreation, messages } = useMemo(() => {\n    const msgs = content.messages;\n    if (!Array.isArray(msgs) || msgs.length === 0) {\n      return { surfaceId: null, isUI: false, isDeletion: false, isCreation: false, messages: [] };\n    }\n    return {\n      surfaceId: extractSurfaceId(msgs),\n      isUI: isUIMessages(msgs),\n      isDeletion: hasDeletionMessages(msgs),\n      isCreation: hasCreationMessages(msgs),\n      messages: msgs,\n    };\n  }, [content.messages]);\n\n  // 处理消息并获取 Schema\n  const initialSchema = useMemo<JsonRenderSchema | null>(() => {\n    if (!surfaceId || messages.length === 0) {\n      return null;\n    }\n\n    if (debug) {\n      // eslint-disable-next-line no-console\n      console.log('[A2UI Adapter] 处理消息:', {\n        messageId,\n        surfaceId,\n        messagesCount: messages.length,\n        messageTypes: messages.map(m => \n          Object.keys(m).filter(k => ['createSurface', 'updateComponents', 'updateDataModel', 'deleteSurface'].includes(k))[0]\n        ),\n        isUI,\n        isCreation,\n        isDeletion,\n        cachedSurfaces: surfaceStateManager.getAllSurfaceIds(),\n      });\n    }\n\n    // 删除型消息：清理缓存\n    if (isDeletion) {\n      surfaceStateManager.deleteSurface(surfaceId);\n      if (debug) {\n        // eslint-disable-next-line no-console\n        console.log('[A2UI Adapter] 删除 Surface:', surfaceId);\n      }\n      return null;\n    }\n\n    // 创建型消息：转换并注册\n    if (isCreation) {\n      const schema = convertA2UIMessagesToJsonRender(messages);\n      if (schema) {\n        // 提取 catalogId\n        const catalogId = messages.find(m => m.createSurface)?.createSurface?.catalogId;\n        surfaceStateManager.registerSurface(surfaceId, schema, catalogId);\n        \n        if (debug) {\n          // eslint-disable-next-line no-console\n          console.log('[A2UI Adapter] 创建型消息，注册 Surface:', {\n            surfaceId,\n            elementsCount: Object.keys(schema.elements).length,\n            data: schema.data,\n          });\n        }\n      }\n      return schema;\n    }\n\n    // 更新型消息：通过 SurfaceStateManager 更新数据\n    for (const msg of messages) {\n      if (msg.updateDataModel) {\n        const { path, op, value } = msg.updateDataModel;\n        const success = surfaceStateManager.updateData(surfaceId, path, op || 'replace', value);\n        \n        if (debug) {\n          // eslint-disable-next-line no-console\n          console.log('[A2UI Adapter] 更新型消息，更新数据:', {\n            surfaceId,\n            path,\n            op: op || 'replace',\n            value,\n            success,\n          });\n        }\n      }\n    }\n\n    // 更新型消息不需要渲染，返回 null\n    return null;\n  }, [messages, surfaceId, isCreation, isDeletion, isUI, debug, messageId]);\n\n  // 订阅状态变化的回调\n  const handleSchemaUpdate = useCallback(() => {\n    if (debug) {\n      // eslint-disable-next-line no-console\n      console.log('[A2UI Adapter] 收到状态更新通知，触发重渲染');\n    }\n    setSchemaVersion(v => v + 1);\n  }, [debug]);\n\n  // 订阅 Surface 状态变化（仅当是创建型消息时）\n  useEffect(() => {\n    if (!isCreation || !surfaceId) {\n      return;\n    }\n\n    if (debug) {\n      // eslint-disable-next-line no-console\n      console.log('[A2UI Adapter] 订阅 Surface 状态:', surfaceId);\n    }\n\n    const unsubscribe = surfaceStateManager.subscribe(surfaceId, handleSchemaUpdate);\n\n    return () => {\n      if (debug) {\n        // eslint-disable-next-line no-console\n        console.log('[A2UI Adapter] 取消订阅 Surface 状态:', surfaceId);\n      }\n      unsubscribe();\n    };\n  }, [isCreation, surfaceId, handleSchemaUpdate, debug]);\n\n  // 获取当前 Schema（考虑版本变化）\n  const currentSchema = useMemo(() => {\n    if (!isCreation || !surfaceId) {\n      return null;\n    }\n    // schemaVersion 变化时从缓存获取最新 Schema\n    return surfaceStateManager.getSchema(surfaceId) || initialSchema;\n  // eslint-disable-next-line react-hooks/exhaustive-deps\n  }, [isCreation, surfaceId, initialSchema, schemaVersion]);\n\n  // 非 UI 型消息不渲染（仅 updateDataModel 的消息）\n  if (!isUI) {\n    if (debug && messages.length > 0) {\n      // eslint-disable-next-line no-console\n      console.log('[A2UI Adapter] 纯数据更新消息，跳过渲染');\n    }\n    return null;\n  }\n\n  // 删除型消息：返回 null（UI 已被删除）\n  if (isDeletion && !isCreation) {\n    if (debug) {\n      // eslint-disable-next-line no-console\n      console.log('[A2UI Adapter] 删除型消息，跳过渲染');\n    }\n    return null;\n  }\n\n  // 渲染 UI\n  return (\n    <JsonRenderActivityRenderer\n      activityType={activityType}\n      content={currentSchema}\n      messageId={messageId}\n      ext={ext}\n      registry={registry}\n      actionHandlers={actionHandlers}\n    />\n  );\n};\n\nexport default A2UIJsonRenderActivityRenderer;\n"],"names":["extractSurfaceId","messages","_iterator","_createForOfIteratorHelper","_step","s","n","done","msg","createSurface","surfaceId","updateComponents","updateDataModel","deleteSurface","err","e","f","isUIMessages","some","hasDeletionMessages","hasCreationMessages","A2UIJsonRenderActivityRenderer","activityType","_ref","content","messageId","ext","registry","actionHandlers","_ref$debug","debug","useEffect","surfaceStateManager","setDebug","_useState","useState","_useState2","_slicedToArray","schemaVersion","setSchemaVersion","_useMemo","useMemo","msgs","Array","isArray","length","isUI","isDeletion","isCreation","initialSchema","console","log","messagesCount","messageTypes","map","Object","keys","m","filter","k","includes","cachedSurfaces","getAllSurfaceIds","schema","convertA2UIMessagesToJsonRender","_messages$find","catalogId","find","registerSurface","elementsCount","elements","data","_iterator2","_step2","_msg$updateDataModel","path","op","value","success","updateData","handleSchemaUpdate","useCallback","v","unsubscribe","subscribe","currentSchema","getSchema","React","createElement","JsonRenderActivityRenderer"],"mappings":"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"}

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

@@ -0,0 +1,44 @@
+/**
+ * json-render Activity 渲染器
+ * 基于 TDesign ChatEngine 的 Activity 机制集成 json-render
+ *
+ * 核心特性：
+ * 1. 支持 ACTIVITY_SNAPSHOT 全量渲染
+ * 2. 支持 ACTIVITY_DELTA 增量更新（Delta Merge 由数据层完成，此处接收完整 Schema）
+ * 3. 使用 React.memo + react-fast-compare 优化渲染性能
+ *
+ */
+import React from 'react';
+import type { JsonRenderActivityProps, ComponentRegistry } from '../types';
+export interface JsonRenderActivityRendererProps extends JsonRenderActivityProps {
+    /** 组件注册表（必须） */
+    registry: ComponentRegistry;
+    /**
+     * Action 处理器映射表
+     *
+     * 示例：
+     * ```tsx
+     * const actionHandlers = {
+     *   submit: async (params) => { ... },
+     *   reset: async (params) => { ... },
+     *   cancel: async (params) => { ... },
+     * };
+     * ```
+     */
+    actionHandlers?: Record<string, (params: Record<string, unknown>) => void | Promise<void>>;
+    /** 显示调试信息 */
+    debug?: boolean;
+}
+/**
+ * 使用 React.memo 包装，配合 react-fast-compare 进行高效的深比较
+ *
+ * 对比策略：
+ * 1. registry 引用比较（通常是稳定的）
+ * 2. actionHandlers 引用比较（建议使用 useMemo 稳定化）
+ * 3. content 使用 react-fast-compare 深比较（比 JSON.stringify 快 3-5 倍）
+ */
+export declare const JsonRenderActivityRenderer: React.NamedExoticComponent<JsonRenderActivityRendererProps>;
+/**
+ * 默认导出
+ */
+export default JsonRenderActivityRenderer;

package/es/chat-engine/components/json-render/renderer/JsonRenderActivityRenderer.js

@@ -0,0 +1,63 @@
+/**
+ * tdesign v1.1.0-alpha.5
+ * (c) 2026 tdesign
+ * @license MIT
+ */
+
+import React, { useMemo } from 'react';
+import { r as reactFastCompare } from '../../../../_chunks/dep-96eca06f.js';
+import { JsonRenderElement } from './JsonUIRenderer.js';
+import '../contexts/index.js';
+import { DataProvider } from '../contexts/data.js';
+import { VisibilityProvider } from '../contexts/visibility.js';
+import { ActionProvider } from '../contexts/actions.js';
+import '@babel/runtime/helpers/typeof';
+import '@babel/runtime/helpers/defineProperty';
+import '../contexts/tree.js';
+import '@babel/runtime/helpers/classCallCheck';
+import '@babel/runtime/helpers/createClass';
+import '@babel/runtime/helpers/possibleConstructorReturn';
+import '@babel/runtime/helpers/getPrototypeOf';
+import '@babel/runtime/helpers/inherits';
+import '../contexts/store.js';
+import '../contexts/validation.js';
+import '@babel/runtime/helpers/objectWithoutProperties';
+import '@babel/runtime/helpers/slicedToArray';
+import '@json-render/core';
+import '../../../../_chunks/dep-16520c2b.js';
+import '@babel/runtime/helpers/wrapNativeSuper';
+import '@babel/runtime/helpers/asyncToGenerator';
+import '@babel/runtime/regenerator';
+
+var JsonRenderActivityRendererInner = function JsonRenderActivityRendererInner(_ref) {
+  var activityType = _ref.activityType,
+    content = _ref.content,
+    messageId = _ref.messageId,
+    registry = _ref.registry,
+    _ref$actionHandlers = _ref.actionHandlers,
+    actionHandlers = _ref$actionHandlers === void 0 ? {} : _ref$actionHandlers;
+  var isValidSchema = content && content.root && content.elements && content.elements[content.root];
+  var renderData = useMemo(function () {
+    return (content === null || content === void 0 ? void 0 : content.data) || {};
+  }, [content === null || content === void 0 ? void 0 : content.data]);
+  return /* @__PURE__ */React.createElement("div", {
+    "data-activity-type": activityType,
+    "data-message-id": messageId
+  }, /* @__PURE__ */React.createElement(DataProvider, {
+    initialData: renderData
+  }, /* @__PURE__ */React.createElement(VisibilityProvider, null, /* @__PURE__ */React.createElement(ActionProvider, {
+    handlers: actionHandlers
+  }, /* @__PURE__ */React.createElement(JsonRenderElement, {
+    tree: content,
+    registry: registry
+  })))));
+};
+var JsonRenderActivityRenderer = /*#__PURE__*/React.memo(JsonRenderActivityRendererInner, function (prevProps, nextProps) {
+  if (prevProps.registry !== nextProps.registry) return false;
+  if (prevProps.actionHandlers !== nextProps.actionHandlers) return false;
+  if (prevProps.content === nextProps.content) return true;
+  return reactFastCompare(prevProps.content, nextProps.content);
+});
+
+export { JsonRenderActivityRenderer, JsonRenderActivityRenderer as default };
+//# sourceMappingURL=JsonRenderActivityRenderer.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"JsonRenderActivityRenderer.js","sources":["../../../../../../pro-components/chat/chat-engine/components/json-render/renderer/JsonRenderActivityRenderer.tsx"],"sourcesContent":["/**\n * json-render Activity 渲染器\n * 基于 TDesign ChatEngine 的 Activity 机制集成 json-render\n * \n * 核心特性：\n * 1. 支持 ACTIVITY_SNAPSHOT 全量渲染\n * 2. 支持 ACTIVITY_DELTA 增量更新（Delta Merge 由数据层完成，此处接收完整 Schema）\n * 3. 使用 React.memo + react-fast-compare 优化渲染性能\n * \n */\n\nimport React, { useMemo } from 'react';\nimport isEqual from 'react-fast-compare';\nimport { JsonRenderElement } from './JsonUIRenderer';\nimport { DataProvider, ActionProvider, VisibilityProvider } from '../contexts';\nimport type { JsonRenderActivityProps, ComponentRegistry } from '../types';\n\nexport interface JsonRenderActivityRendererProps extends JsonRenderActivityProps {\n  /** 组件注册表（必须） */\n  registry: ComponentRegistry;\n  /** \n   * Action 处理器映射表\n   * \n   * 示例：\n   * ```tsx\n   * const actionHandlers = {\n   *   submit: async (params) => { ... },\n   *   reset: async (params) => { ... },\n   *   cancel: async (params) => { ... },\n   * };\n   * ```\n   */\n  actionHandlers?: Record<string, (params: Record<string, unknown>) => void | Promise<void>>;\n  /** 显示调试信息 */\n  debug?: boolean;\n}\n\n/**\n * json-render Activity 渲染器组件\n */\nconst JsonRenderActivityRendererInner: React.FC<JsonRenderActivityRendererProps> = ({\n  activityType,\n  content,\n  messageId,\n  registry,\n  actionHandlers = {},\n}) => {\n  // 直接在渲染阶段做校验\n  const isValidSchema = content && content.root && content.elements && content.elements[content.root];\n\n  // 数据处理：使用 useMemo 缓存，只在 content.data 变化时重新计算\n  const renderData = useMemo(() => content?.data || {}, [content?.data]);\n\n  // todo: Schema 无效时显示加载状态\n  // if (!isValidSchema) {\n  //   return (\n  //     <div style={{ padding: '16px', color: 'var(--td-text-color-secondary)' }}>\n  //       数据初始化中...\n  //     </div>\n  //   );\n  // }\n  return (\n    <div data-activity-type={activityType} data-message-id={messageId}>\n      <DataProvider initialData={renderData}>\n        <VisibilityProvider>\n          <ActionProvider handlers={actionHandlers}>\n            <JsonRenderElement tree={content} registry={registry} />\n          </ActionProvider>\n        </VisibilityProvider>\n      </DataProvider>\n    </div>\n  );\n};\n\n/**\n * 使用 React.memo 包装，配合 react-fast-compare 进行高效的深比较\n * \n * 对比策略：\n * 1. registry 引用比较（通常是稳定的）\n * 2. actionHandlers 引用比较（建议使用 useMemo 稳定化）\n * 3. content 使用 react-fast-compare 深比较（比 JSON.stringify 快 3-5 倍）\n */\nexport const JsonRenderActivityRenderer = React.memo(\n  JsonRenderActivityRendererInner,\n  (prevProps, nextProps) => {\n    // registry 变化必须重渲染\n    if (prevProps.registry !== nextProps.registry) return false;\n    \n    // actionHandlers 变化必须重渲染\n    if (prevProps.actionHandlers !== nextProps.actionHandlers) return false;\n\n    // content 引用相同，跳过渲染\n    if (prevProps.content === nextProps.content) return true;\n\n    // 使用 react-fast-compare 进行高效深比较\n    // 比 JSON.stringify 快 3-5 倍，且能正确处理循环引用\n    return isEqual(prevProps.content, nextProps.content);\n  },\n);\n\n/**\n * 默认导出\n */\nexport default JsonRenderActivityRenderer;\n"],"names":["JsonRenderActivityRendererInner","activityType","_ref","content","messageId","registry","_ref$actionHandlers","actionHandlers","isValidSchema","root","elements","renderData","useMemo","data","React","createElement","DataProvider","initialData","VisibilityProvider","ActionProvider","handlers","JsonRenderElement","tree","JsonRenderActivityRenderer","memo","prevProps","nextProps","isEqual"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAwCA,IAAMA,kCAA6E,SAA7EA,sCAMA;AAAA,EAAA,IALJC,YAAA,GAAAC,IAAA,CAAAD,YAAA;IACAE,OAAA,GAAAD,IAAA,CAAAC,OAAA;IACAC,SAAA,GAAAF,IAAA,CAAAE,SAAA;IACAC,QAAA,GAAAH,IAAA,CAAAG,QAAA;IAAAC,mBAAA,GAAAJ,IAAA,CACAK;AAAAA,IAAAA,kDAAiB,EAAC,GAAAD,mBAAA,CAAA;AAGZ,EAAA,IAAAE,aAAA,GAAgBL,WAAWA,OAAQ,CAAAM,IAAA,IAAQN,QAAQO,QAAY,IAAAP,OAAA,CAAQO,SAASP,OAAQ,CAAAM,IAAA,CAAA,CAAA;EAGxF,IAAAE,UAAA,GAAaC,OAAQ,CAAA,YAAA;IAAA,OAAM,CAAAT,OAAS,KAAA,IAAA,IAATA,OAAS,KAAA,KAAA,CAAA,GAAA,KAAA,CAAA,GAATA,OAAS,CAAAU,IAAA,KAAQ,EAAI,CAAA;GAAA,EAAA,CAACV,OAAS,KAATA,IAAAA,IAAAA,OAAS,uBAATA,OAAS,CAAAU,IAAI,CAAC,CAAA,CAAA;AAUrE,EAAA,sBACGC,KAAA,CAAAC,aAAA,CAAA,KAAA,EAAA;AAAI,IAAA,oBAAoB,EAAAd,YAAA;AAAc,IAAA,iBAAiB,EAAAG,SAAAA;AAAA,GAAA,iBACrDU,KAAA,CAAAC,aAAA,CAAAC,YAAA,EAAA;AAAaC,IAAAA,WAAa,EAAAN,UAAAA;AACzB,GAAA,iBAAAG,KAAA,CAAAC,aAAA,CAACG,yCACEJ,KAAA,CAAAC,aAAA,CAAAI,cAAA,EAAA;AAAeC,IAAAA,QAAU,EAAAb,cAAAA;AAAA,GAAA,iBACvBO,KAAA,CAAAC,aAAA,CAAAM,iBAAA,EAAA;AAAkBC,IAAAA,IAAM,EAAAnB,OAAA;AAASE,IAAAA,QAAA,EAAAA,QAAAA;AAAoB,GAAA,CACxD,CACF,CACF,CACF,CAAA,CAAA;AAEJ,CAAA,CAAA;AAUakB,IAAAA,0CAA6BT,KAAM,CAAAU,IAAA,CAC9CxB,+BAAA,EACA,UAACyB,WAAWC,SAAc,EAAA;EAEpB,IAAAD,SAAA,CAAUpB,aAAaqB,SAAU,CAAArB,QAAA,EAAiB,OAAA,KAAA,CAAA;EAGlD,IAAAoB,SAAA,CAAUlB,mBAAmBmB,SAAU,CAAAnB,cAAA,EAAuB,OAAA,KAAA,CAAA;EAG9D,IAAAkB,SAAA,CAAUtB,YAAYuB,SAAU,CAAAvB,OAAA,EAAgB,OAAA,IAAA,CAAA;EAIpD,OAAOwB,gBAAQ,CAAAF,SAAA,CAAUtB,OAAS,EAAAuB,SAAA,CAAUvB,OAAO,CAAA,CAAA;AACrD,CACF;;;;"}

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

@@ -0,0 +1,44 @@
+import { type ComponentType, type ReactNode } from "react";
+import type { Catalog, ComponentDefinition } from "@json-render/core";
+import type { ComponentRegistry, RendererProps } from "../types";
+/**
+ * Main renderer component
+ *
+ * 架构说明：
+ * - JsonRenderElement 作为入口，不因 tree 变化而重渲染
+ * - tree 更新通过 store.setTree() 通知订阅者
+ * - 每个 ElementRenderer 独立订阅自己的 element
+ * - 配合上游 Structural Sharing，只有真正变化的节点才重渲染
+ */
+export declare function JsonRenderElement({ tree, registry, loading, fallback }: RendererProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Props for JSONUIProvider
+ */
+export interface JSONUIProviderProps {
+    /** Component registry */
+    registry: ComponentRegistry;
+    /** Initial data model */
+    initialData?: Record<string, unknown>;
+    /** Auth state */
+    authState?: {
+        isSignedIn: boolean;
+        user?: Record<string, unknown>;
+    };
+    /** Action handlers */
+    actionHandlers?: Record<string, (params: Record<string, unknown>) => Promise<unknown> | unknown>;
+    /** Navigation function */
+    navigate?: (path: string) => void;
+    /** Custom validation functions */
+    validationFunctions?: Record<string, (value: unknown, args?: Record<string, unknown>) => boolean>;
+    /** Callback when data changes */
+    onDataChange?: (path: string, value: unknown) => void;
+    children: ReactNode;
+}
+/**
+ * Combined provider for all JSONUI contexts
+ */
+export declare function JSONUIProvider({ registry, initialData, authState, actionHandlers, navigate, validationFunctions, onDataChange, children, }: JSONUIProviderProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Helper to create a renderer component from a catalog
+ */
+export declare function createRendererFromCatalog<C extends Catalog<Record<string, ComponentDefinition>>>(_catalog: C, registry: ComponentRegistry): ComponentType<Omit<RendererProps, "registry">>;