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

package/es/chat-engine/components/a2ui/A2UIActivityRenderer.js

@@ -0,0 +1,301 @@
+/**
+ * tdesign v1.0.2-alpha.14
+ * (c) 2026 tdesign
+ * @license MIT
+ */
+
+import _defineProperty from '@babel/runtime/helpers/defineProperty';
+import _asyncToGenerator from '@babel/runtime/helpers/asyncToGenerator';
+import _slicedToArray from '@babel/runtime/helpers/slicedToArray';
+import _typeof from '@babel/runtime/helpers/typeof';
+import _regeneratorRuntime from '@babel/runtime/regenerator';
+import React__default, { useRef, useSyncExternalStore, useEffect, useMemo } from 'react';
+import '../../core/a2ui/index.js';
+import { A2UISurfaceRenderer } from './A2UISurfaceRenderer.js';
+import { defaultComponentRegistry } from './registry.js';
+import { A2uiMessageProcessor } from '../../core/a2ui/processor/A2uiMessageProcessor.js';
+import '../../core/a2ui/types/index.js';
+import '../../core/a2ui/types/types.js';
+import 'zod';
+import '../../core/a2ui/utils/index.js';
+import '../../core/a2ui/utils/binding.js';
+import '../../core/a2ui/utils/validation.js';
+import '@babel/runtime/helpers/toConsumableArray';
+import '../../core/a2ui/processor/DataStore.js';
+import '@babel/runtime/helpers/toArray';
+import '@babel/runtime/helpers/classCallCheck';
+import '@babel/runtime/helpers/createClass';
+import '../../core/a2ui/processor/ComponentTree.js';
+import '../../core/a2ui/processor/PathResolver.js';
+import '../../hooks/a2ui/A2UIContext.js';
+import '../../hooks/a2ui/useA2UISurface.js';
+import './A2UIComponentRenderer.js';
+import './A2UIErrorBoundary.js';
+import '@babel/runtime/helpers/possibleConstructorReturn';
+import '@babel/runtime/helpers/getPrototypeOf';
+import '@babel/runtime/helpers/inherits';
+import './A2UISkeleton.js';
+import 'tdesign-react';
+import './primitives/A2UIText.js';
+import 'classnames';
+import '../../hooks/a2ui/useDataBinding.js';
+import './primitives/A2UIImage.js';
+import './primitives/A2UIIcon.js';
+import './primitives/A2UIButton.js';
+import '../../hooks/a2ui/useA2UIAction.js';
+import './primitives/A2UIInput.js';
+import './primitives/A2UITextField.js';
+import './primitives/A2UICheckBox.js';
+import './primitives/A2UIChoicePicker.js';
+import './primitives/A2UISlider.js';
+import './primitives/A2UIRadioGroup.js';
+import './primitives/A2UICheckboxGroup.js';
+import './primitives/A2UIDivider.js';
+import './containers/A2UICard.js';
+import './containers/A2UIRow.js';
+import './containers/A2UIColumn.js';
+import './containers/A2UIList.js';
+import './containers/A2UITabs.js';
+
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function resolveActionContext(actionContext, getData) {
+  var resolved = {};
+  if (!actionContext || _typeof(actionContext) !== "object") {
+    return resolved;
+  }
+  for (var _i = 0, _Object$entries = Object.entries(actionContext); _i < _Object$entries.length; _i++) {
+    var _Object$entries$_i = _slicedToArray(_Object$entries[_i], 2),
+      key = _Object$entries$_i[0],
+      value = _Object$entries$_i[1];
+    if (_typeof(value) === "object" && value && "path" in value) {
+      var path = value.path;
+      resolved[key] = getData === null || getData === void 0 ? void 0 : getData(path);
+    } else {
+      resolved[key] = value;
+    }
+  }
+  return resolved;
+}
+function createA2UIActionHandler(onAction) {
+  return /*#__PURE__*/function () {
+    var _ref = _asyncToGenerator(/*#__PURE__*/_regeneratorRuntime.mark(function _callee(action, context) {
+      var name, resolvedContext, userActionMessage;
+      return _regeneratorRuntime.wrap(function (_context) {
+        while (1) switch (_context.prev = _context.next) {
+          case 0:
+            name = action.name;
+            if (name) {
+              _context.next = 1;
+              break;
+            }
+            console.warn("[A2UI] Action \u7F3A\u5C11 name \u5B57\u6BB5:", action);
+            return _context.abrupt("return");
+          case 1:
+            resolvedContext = resolveActionContext(action.context, context === null || context === void 0 ? void 0 : context.getData);
+            userActionMessage = {
+              name: name,
+              surfaceId: (context === null || context === void 0 ? void 0 : context.surfaceId) || "unknown",
+              sourceComponentId: (context === null || context === void 0 ? void 0 : context.componentId) || "unknown",
+              timestamp: new Date().toISOString(),
+              context: resolvedContext
+            };
+            console.log("[A2UI] Action \u89E6\u53D1:", {
+              name: name,
+              userActionMessage: userActionMessage
+            });
+            _context.next = 2;
+            return onAction({
+              userActionMessage: userActionMessage,
+              action: action,
+              actionContext: context
+            });
+          case 2:
+          case "end":
+            return _context.stop();
+        }
+      }, _callee);
+    }));
+    return function (_x, _x2) {
+      return _ref.apply(this, arguments);
+    };
+  }();
+}
+function isA2UIServerMessage(msg) {
+  if (!msg || _typeof(msg) !== "object") return false;
+  return "createSurface" in msg || "updateComponents" in msg || "updateDataModel" in msg || "deleteSurface" in msg;
+}
+function convertToA2UIMessages(content, messageId) {
+  var _content$surface;
+  var messages = [];
+  var surfaceId = content.surfaceId || ((_content$surface = content.surface) === null || _content$surface === void 0 ? void 0 : _content$surface.id) || "surface-".concat(messageId);
+  var a2uiMessages = content.messages || content.operations;
+  if (a2uiMessages && a2uiMessages.length > 0) {
+    return a2uiMessages.filter(isA2UIServerMessage);
+  }
+  if (content.surface) {
+    messages.push({
+      createSurface: {
+        surfaceId: surfaceId,
+        catalogId: "default"
+      }
+    });
+    if (content.surface.data) {
+      messages.push({
+        updateDataModel: {
+          surfaceId: surfaceId,
+          path: "/",
+          op: "replace",
+          value: content.surface.data
+        }
+      });
+    }
+    if (content.surface.root) {
+      var components = flattenComponents(content.surface.root);
+      if (components.length > 0) {
+        messages.push({
+          updateComponents: {
+            surfaceId: surfaceId,
+            components: components
+          }
+        });
+      }
+    }
+  }
+  return messages;
+}
+function flattenComponents(root) {
+  var components = [];
+  var idCounter = {
+    value: 0
+  };
+  function flatten(node, parentId) {
+    var nodeId = node.id || "comp_".concat(idCounter.value++);
+    var component = _objectSpread(_objectSpread({}, node), {}, {
+      id: nodeId
+    });
+    if (Array.isArray(node.children)) {
+      var childIds = node.children.map(function (child) {
+        if (typeof child === "string") {
+          return child;
+        }
+        return flatten(child);
+      });
+      component.children = childIds;
+    }
+    if (node.child && _typeof(node.child) === "object") {
+      component.child = flatten(node.child);
+    }
+    components.push(component);
+    return nodeId;
+  }
+  var rootWithId = _objectSpread(_objectSpread({}, root), {}, {
+    id: root.id || "root"
+  });
+  flatten(rootWithId);
+  return components;
+}
+var A2UIActivityRenderer = function A2UIActivityRenderer(_ref2) {
+  var content = _ref2.content,
+    messageId = _ref2.messageId,
+    registry = _ref2.registry,
+    onAction = _ref2.onAction,
+    loading = _ref2.loading,
+    className = _ref2.className,
+    style = _ref2.style,
+    deltaInfo = _ref2.deltaInfo;
+  var processorRef = useRef(null);
+  var lastContentRef = useRef(null);
+  var processedCountRef = useRef(0);
+  if (!processorRef.current) {
+    processorRef.current = new A2uiMessageProcessor({
+      onAction: onAction
+    });
+  }
+  var processor = processorRef.current;
+  var snapshot = useSyncExternalStore(processor.subscribe, processor.getSnapshot, processor.getServerSnapshot);
+  useEffect(function () {
+    if (!content) return;
+    var allMessages = content.messages || content.operations;
+    if (deltaInfo && allMessages && Array.isArray(allMessages)) {
+      var fromIndex = deltaInfo.fromIndex,
+        toIndex = deltaInfo.toIndex;
+      if (fromIndex < toIndex && fromIndex >= processedCountRef.current) {
+        var newMessages = allMessages.slice(fromIndex, toIndex).filter(isA2UIServerMessage);
+        if (newMessages.length > 0) {
+          processor.processMessagesIncremental(newMessages);
+          processedCountRef.current = toIndex;
+        }
+      }
+      lastContentRef.current = content;
+      return;
+    }
+    var contentStr = JSON.stringify(content);
+    var lastContentStr = lastContentRef.current ? JSON.stringify(lastContentRef.current) : "";
+    if (contentStr === lastContentStr && processedCountRef.current > 0) {
+      return;
+    }
+    var messages = convertToA2UIMessages(content, messageId);
+    if (messages.length > 0) {
+      var _content$surface2;
+      var surfaceId = content.surfaceId || ((_content$surface2 = content.surface) === null || _content$surface2 === void 0 ? void 0 : _content$surface2.id) || "surface-".concat(messageId);
+      if (loading && !processor.getSurface(surfaceId)) {
+        var _content$surface3;
+        var skeletonHint = (_content$surface3 = content.surface) === null || _content$surface3 === void 0 ? void 0 : _content$surface3.skeletonHint;
+        processor.createPendingSurface(surfaceId, skeletonHint);
+      }
+      processor.processMessages(messages);
+      processedCountRef.current = messages.length;
+    }
+    lastContentRef.current = content;
+  }, [content, messageId, processor, loading, deltaInfo]);
+  var mergedRegistry = useMemo(function () {
+    return _objectSpread(_objectSpread({}, defaultComponentRegistry), registry);
+  }, [registry]);
+  var surfaceIds = Array.from(snapshot.keys());
+  if (surfaceIds.length === 0) {
+    return loading ? /* @__PURE__ */React__default.createElement("div", {
+      className: className,
+      style: style
+    }, loading) : null;
+  }
+  return /* @__PURE__ */React__default.createElement("div", {
+    className: className,
+    style: style
+  }, surfaceIds.map(function (surfaceId) {
+    return /* @__PURE__ */React__default.createElement(A2UISurfaceRenderer, {
+      key: surfaceId,
+      processor: processor,
+      surfaceId: surfaceId,
+      registry: mergedRegistry,
+      onAction: onAction,
+      loading: loading
+    });
+  }));
+};
+A2UIActivityRenderer.displayName = "A2UIActivityRenderer";
+function createA2UIActivityConfig(options) {
+  var _ref3 = options || {},
+    _ref3$activityType = _ref3.activityType,
+    activityType = _ref3$activityType === void 0 ? "a2ui-surface" : _ref3$activityType,
+    registry = _ref3.registry,
+    onAction = _ref3.onAction,
+    loading = _ref3.loading;
+  var finalOnAction = onAction ? createA2UIActionHandler(onAction) : void 0;
+  return {
+    activityType: activityType,
+    component: function component(props) {
+      var _props$ext;
+      return /* @__PURE__ */React__default.createElement(A2UIActivityRenderer, _objectSpread(_objectSpread({}, props), {}, {
+        registry: registry,
+        onAction: finalOnAction,
+        loading: loading,
+        deltaInfo: (_props$ext = props.ext) === null || _props$ext === void 0 ? void 0 : _props$ext.deltaInfo
+      }));
+    },
+    description: "A2UI Surface \u6E32\u67D3\u5668"
+  };
+}
+
+export { A2UIActivityRenderer, createA2UIActionHandler, createA2UIActivityConfig, A2UIActivityRenderer as default };
+//# sourceMappingURL=A2UIActivityRenderer.js.map

package/es/chat-engine/components/a2ui/A2UIActivityRenderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"A2UIActivityRenderer.js","sources":["../../../../../pro-components/chat/chat-engine/components/a2ui/A2UIActivityRenderer.tsx"],"sourcesContent":["/**\n * A2UI Activity 渲染器\n * 将 A2UI v0.9 协议数据作为 Activity 进行渲染\n * \n * 支持的消息格式：\n * 1. A2UI v0.9 原生格式（createSurface、updateComponents、updateDataModel、deleteSurface）\n * 2. 简化的 surface 格式（向后兼容）\n * \n * 使用方式：\n * 1. 通过 useAgentActivity 注册此组件\n * 2. 后端发送 ACTIVITY_SNAPSHOT/ACTIVITY_DELTA 事件，activityType 为 'a2ui-surface'\n * 3. content 中包含 A2UI 协议消息\n */\n\nimport React, { useEffect, useMemo, useRef, useSyncExternalStore } from 'react';\nimport { A2uiMessageProcessor } from '../../core/a2ui';\nimport type {\n  A2UIServerMessage,\n  A2UIComponentBase,\n  A2UIAction,\n  ActionHandler,\n  ActionContext,\n  SkeletonHint,\n} from '../../core/a2ui';\nimport type { ComponentRegistry } from '../../hooks/a2ui/A2UIContext';\nimport { A2UISurfaceRenderer } from './A2UISurfaceRenderer';\nimport { defaultComponentRegistry } from './registry';\n\n// ============= A2UI 0.9 协议标准 Action 处理 =============\n\n/**\n * UserAction 消息格式（A2UI 0.9 规范）\n * 用于发送给服务端的用户操作消息\n */\nexport interface UserActionMessage {\n  /** Action 名称 */\n  name: string;\n  /** 触发 Action 的 Surface ID */\n  surfaceId: string;\n  /** 触发 Action 的组件 ID */\n  sourceComponentId: string;\n  /** 时间戳 */\n  timestamp: string;\n  /** 解析后的上下文数据（数据绑定路径已解析为实际值） */\n  context: Record<string, unknown>;\n}\n\n/**\n * Action 处理结果\n * 返回给业务层，由业务层决定如何处理\n */\nexport interface ActionResult {\n  /** 构造好的 userAction 消息 */\n  userActionMessage: UserActionMessage;\n  /** 原始 Action 定义 */\n  action: A2UIAction;\n  /** Action 上下文 */\n  actionContext?: ActionContext;\n}\n\n/**\n * Action 处理回调\n * 业务层通过此回调接收解析后的 Action 数据，自行决定是否发送请求\n */\nexport type OnActionCallback = (result: ActionResult) => void | Promise<void>;\n\n/**\n * 解析 Action 中的数据绑定路径\n * 将 { path: '/xxx' } 格式的绑定解析为实际数据值\n */\nfunction resolveActionContext(\n  actionContext: Record<string, unknown> | undefined,\n  getData?: (path?: string) => unknown\n): Record<string, unknown> {\n  const resolved: Record<string, unknown> = {};\n  \n  if (!actionContext || typeof actionContext !== 'object') {\n    return resolved;\n  }\n\n  for (const [key, value] of Object.entries(actionContext)) {\n    if (typeof value === 'object' && value && 'path' in value) {\n      // 解析数据绑定路径 { path: '/xxx' }\n      const path = (value as { path: string }).path;\n      resolved[key] = getData?.(path);\n    } else {\n      resolved[key] = value;\n    }\n  }\n\n  return resolved;\n}\n\n/**\n * 创建 A2UI 0.9 协议标准的 Action 处理器\n * \n * 职责：\n * 1. 解析 Action 中的数据绑定路径\n * 2. 构造标准的 UserActionMessage\n * 3. 将处理结果传递给业务层回调\n * \n * @param onAction 业务层回调，接收解析后的 ActionResult\n * @returns ActionHandler\n */\nexport function createA2UIActionHandler(onAction: OnActionCallback): ActionHandler {\n  return async (action: A2UIAction, context?: ActionContext) => {\n    const { name } = action;\n    \n    if (!name) {\n      console.warn('[A2UI] Action 缺少 name 字段:', action);\n      return;\n    }\n\n    // 解析 context 中的数据绑定路径\n    const resolvedContext = resolveActionContext(action.context, context?.getData);\n\n    // 构造符合 A2UI 0.9 协议的 userAction 消息\n    const userActionMessage: UserActionMessage = {\n      name,\n      surfaceId: context?.surfaceId || 'unknown',\n      sourceComponentId: context?.componentId || 'unknown',\n      timestamp: new Date().toISOString(),\n      context: resolvedContext,\n    };\n\n    console.log('[A2UI] Action 触发:', { name, userActionMessage });\n\n    // 将处理结果传递给业务层\n    await onAction({\n      userActionMessage,\n      action,\n      actionContext: context,\n    });\n  };\n}\n\n/**\n * A2UI Activity Content 类型\n * 支持 A2UI v0.9 原生格式和简化格式\n */\nexport interface A2UIActivityContent {\n  /** A2UI v0.9 消息列表（标准名称） */\n  messages?: A2UIServerMessage[];\n  \n  /** A2UI v0.9 消息列表（别名，向后兼容） */\n  operations?: A2UIServerMessage[];\n  \n  /** 简化模式：单个 Surface 定义 */\n  surface?: {\n    id?: string;\n    root?: A2UIComponentBase;\n    data?: Record<string, unknown>;\n    skeletonHint?: SkeletonHint;\n  };\n  \n  /** Surface ID（用于简化模式） */\n  surfaceId?: string;\n}\n\n/**\n * 增量信息类型\n */\nexport interface DeltaInfo {\n  fromIndex: number;\n  toIndex: number;\n}\n\nexport interface A2UIActivityRendererProps {\n  /** Activity 类型 */\n  activityType?: string;\n  /** Activity 内容数据 */\n  content: A2UIActivityContent;\n  /** 关联的消息 ID */\n  messageId: string;\n  /** 自定义组件注册表 */\n  registry?: ComponentRegistry;\n  /** Action 处理回调 */\n  onAction?: ActionHandler;\n  /** \n   * 加载中占位\n   * - ReactNode: 自定义骨架屏组件\n   * - true: 使用服务端 skeletonHint 自动渲染骨架屏\n   */\n  loading?: React.ReactNode | boolean;\n  /** 自定义类名 */\n  className?: string;\n  /** 自定义样式 */\n  style?: React.CSSProperties;\n  /** 增量信息（由 AG-UI adapter 提供） */\n  deltaInfo?: DeltaInfo;\n}\n\n/**\n * 检查是否为 A2UI v0.9 原生消息格式\n */\nfunction isA2UIServerMessage(msg: unknown): msg is A2UIServerMessage {\n  if (!msg || typeof msg !== 'object') return false;\n  return (\n    'createSurface' in msg ||\n    'updateComponents' in msg ||\n    'updateDataModel' in msg ||\n    'deleteSurface' in msg\n  );\n}\n\n/**\n * 将简化格式转换为 A2UI v0.9 消息\n */\nfunction convertToA2UIMessages(\n  content: A2UIActivityContent,\n  messageId: string\n): A2UIServerMessage[] {\n  const messages: A2UIServerMessage[] = [];\n  const surfaceId = content.surfaceId || content.surface?.id || `surface-${messageId}`;\n\n  // 优先使用 messages 字段（A2UI v0.9 标准），其次使用 operations（别名）\n  const a2uiMessages = content.messages || content.operations;\n  if (a2uiMessages && a2uiMessages.length > 0) {\n    // 验证并过滤有效消息\n    return a2uiMessages.filter(isA2UIServerMessage);\n  }\n\n  // 简化格式转换\n  if (content.surface) {\n    // 1. 创建 Surface\n    messages.push({\n      createSurface: {\n        surfaceId,\n        catalogId: 'default',\n      },\n    });\n\n    // 2. 如果有数据，更新数据模型\n    if (content.surface.data) {\n      messages.push({\n        updateDataModel: {\n          surfaceId,\n          path: '/',\n          op: 'replace',\n          value: content.surface.data,\n        },\n      });\n    }\n\n    // 3. 如果有 root 组件，转换为 components 数组\n    if (content.surface.root) {\n      const components = flattenComponents(content.surface.root);\n      if (components.length > 0) {\n        messages.push({\n          updateComponents: {\n            surfaceId,\n            components,\n          },\n        });\n      }\n    }\n  }\n\n  return messages;\n}\n\n/**\n * 将嵌套组件树展平为组件数组\n * A2UI v0.9 要求组件以平铺形式存储，通过 id 引用\n */\nfunction flattenComponents(root: A2UIComponentBase): A2UIComponentBase[] {\n  const components: A2UIComponentBase[] = [];\n  const idCounter = { value: 0 };\n\n  function flatten(node: any, parentId?: string): string {\n    // 确保有 id\n    const nodeId = node.id || `comp_${idCounter.value++}`;\n    \n    // 创建新组件（不包含嵌套 children）\n    const component: A2UIComponentBase = {\n      ...node,\n      id: nodeId,\n    };\n\n    // 处理 children\n    if (Array.isArray(node.children)) {\n      const childIds = node.children.map((child: any) => {\n        if (typeof child === 'string') {\n          return child;\n        }\n        return flatten(child);\n      });\n      component.children = childIds;\n    }\n\n    // 处理 child（单子组件）\n    if (node.child && typeof node.child === 'object') {\n      component.child = flatten(node.child);\n    }\n\n    components.push(component);\n    return nodeId;\n  }\n\n  // 从 root 开始展平，确保 root id 为 'root'\n  const rootWithId = { ...root, id: root.id || 'root' };\n  flatten(rootWithId);\n\n  return components;\n}\n\n/**\n * A2UI Activity 渲染器组件\n */\nexport const A2UIActivityRenderer: React.FC<A2UIActivityRendererProps> = ({\n  content,\n  messageId,\n  registry,\n  onAction,\n  loading,\n  className,\n  style,\n  deltaInfo,\n}) => {\n  // 创建或获取 Processor\n  const processorRef = useRef<A2uiMessageProcessor | null>(null);\n  const lastContentRef = useRef<A2UIActivityContent | null>(null);\n  const processedCountRef = useRef(0);\n\n  // 初始化 processor\n  if (!processorRef.current) {\n    processorRef.current = new A2uiMessageProcessor({ onAction });\n  }\n  const processor = processorRef.current;\n\n  // 订阅 processor 变化\n  const snapshot = useSyncExternalStore(\n    processor.subscribe,\n    processor.getSnapshot,\n    processor.getServerSnapshot\n  );\n\n  // 处理 content 变化\n  useEffect(() => {\n    if (!content) return;\n\n    // 获取 A2UI 消息\n    const allMessages = content.messages || content.operations;\n    \n    // 如果有增量信息且有消息数组，使用增量处理\n    if (deltaInfo && allMessages && Array.isArray(allMessages)) {\n      const { fromIndex, toIndex } = deltaInfo;\n      \n      // 只处理新增的消息\n      if (fromIndex < toIndex && fromIndex >= processedCountRef.current) {\n        const newMessages = allMessages.slice(fromIndex, toIndex).filter(isA2UIServerMessage);\n        \n        if (newMessages.length > 0) {\n          // 使用增量处理方法\n          processor.processMessagesIncremental(newMessages);\n          processedCountRef.current = toIndex;\n        }\n      }\n      \n      lastContentRef.current = content;\n      return;\n    }\n\n    // 非增量模式：完整处理\n    const contentStr = JSON.stringify(content);\n    const lastContentStr = lastContentRef.current ? JSON.stringify(lastContentRef.current) : '';\n    \n    if (contentStr === lastContentStr && processedCountRef.current > 0) {\n      return;\n    }\n\n    // 转换为 A2UI v0.9 消息格式\n    const messages = convertToA2UIMessages(content, messageId);\n\n    if (messages.length > 0) {\n      // 获取 surfaceId 用于骨架屏\n      const surfaceId = content.surfaceId || content.surface?.id || `surface-${messageId}`;\n      \n      // 如果有 loading 且 Surface 不存在，先创建 pending 状态\n      if (loading && !processor.getSurface(surfaceId)) {\n        const skeletonHint = content.surface?.skeletonHint;\n        processor.createPendingSurface(surfaceId, skeletonHint);\n      }\n\n      // 处理消息\n      processor.processMessages(messages);\n      processedCountRef.current = messages.length;\n    }\n\n    lastContentRef.current = content;\n  }, [content, messageId, processor, loading, deltaInfo]);\n\n  // 合并组件注册表\n  const mergedRegistry = useMemo<ComponentRegistry>(\n    () => ({\n      ...defaultComponentRegistry,\n      ...registry,\n    }),\n    [registry]\n  );\n\n  // 获取当前所有 surface IDs\n  const surfaceIds = Array.from(snapshot.keys());\n\n  // 如果没有 surface，显示 loading 占位\n  if (surfaceIds.length === 0) {\n    return loading ? <div className={className} style={style}>{loading}</div> : null;\n  }\n\n  return (\n    <div className={className} style={style}>\n      {surfaceIds.map((surfaceId) => (\n        <A2UISurfaceRenderer\n          key={surfaceId}\n          processor={processor}\n          surfaceId={surfaceId}\n          registry={mergedRegistry}\n          onAction={onAction}\n          loading={loading}\n        />\n      ))}\n    </div>\n  );\n};\n\nA2UIActivityRenderer.displayName = 'A2UIActivityRenderer';\n\n/**\n * A2UI Activity 配置选项\n */\nexport interface A2UIActivityConfigOptions {\n  /** Activity 类型标识 */\n  activityType?: string;\n  /** 自定义组件注册表 */\n  registry?: ComponentRegistry;\n  /**\n   * Action 处理回调（推荐使用）\n   * \n   * 接收解析后的 ActionResult，包含：\n   * - userActionMessage: 构造好的标准消息，可直接发送给服务端\n   * - action: 原始 Action 定义\n   * - actionContext: Action 上下文（包含 getData、updateData 等方法）\n   * \n   * 业务层自行决定：\n   * 1. 是否需要发送请求到服务端\n   * 2. 是否需要本地处理（如 reset 操作）\n   * 3. 是否需要更新本地状态\n   * \n   * @example\n   * ```tsx\n   * createA2UIActivityConfig({\n   *   onAction: async ({ userActionMessage, action, actionContext }) => {\n   *     // 根据 action.name 决定处理方式\n   *     if (action.name === 'reset') {\n   *       // 本地处理，不发送请求\n   *       actionContext?.updateData('/', initialData);\n   *       return;\n   *     }\n   *     \n   *     // 发送请求到服务端\n   *     await chatEngine.sendAIMessage({\n   *       params: { userActionMessage },\n   *       sendRequest: true,\n   *     });\n   *   }\n   * })\n   * ```\n   */\n  onAction?: OnActionCallback;\n  /** 加载中占位 */\n  loading?: React.ReactNode | boolean;\n}\n\n/**\n * 创建 A2UI Activity 配置\n * \n * @example\n * ```tsx\n * const { chatEngine } = useChat({ ... });\n * \n * const a2uiConfig = useMemo(() => createA2UIActivityConfig({\n *   onAction: async ({ userActionMessage, action }) => {\n *     // 本地操作不发请求\n *     if (action.name === 'reset') return;\n *     \n *     // 其他操作发送到服务端\n *     await chatEngine.sendAIMessage({\n *       params: { userActionMessage },\n *       sendRequest: true,\n *     });\n *   }\n * }), [chatEngine]);\n * \n * useAgentActivity(a2uiConfig);\n * ```\n */\nexport function createA2UIActivityConfig(options?: A2UIActivityConfigOptions) {\n  const {\n    activityType = 'a2ui-surface',\n    registry,\n    onAction,\n    loading,\n  } = options || {};\n\n  // 使用 onAction 回调创建内置处理器\n  const finalOnAction = onAction ? createA2UIActionHandler(onAction) : undefined;\n\n  return {\n    activityType,\n    component: (props: { \n      activityType: string; \n      content: A2UIActivityContent; \n      messageId: string;\n      ext?: { deltaInfo?: DeltaInfo };\n    }) => (\n      <A2UIActivityRenderer\n        {...props}\n        registry={registry}\n        onAction={finalOnAction}\n        loading={loading}\n        deltaInfo={props.ext?.deltaInfo}\n      />\n    ),\n    description: 'A2UI Surface 渲染器',\n  };\n}\n\nexport default A2UIActivityRenderer;\n"],"names":["resolveActionContext","actionContext","getData","resolved","_typeof","_i","_Object$entries","Object","entries","length","_Object$entries$_i","_slicedToArray","key","value","path","createA2UIActionHandler","onAction","_ref","_asyncToGenerator","_regeneratorRuntime","mark","_callee","action","context","name","resolvedContext","userActionMessage","wrap","_context","prev","next","console","warn","abrupt","surfaceId","sourceComponentId","componentId","timestamp","Date","toISOString","log","stop","_x","_x2","apply","arguments","isA2UIServerMessage","msg","convertToA2UIMessages","content","messageId","_content$surface","messages","surface","id","a2uiMessages","operations","filter","push","createSurface","catalogId","data","updateDataModel","op","root","components","flattenComponents","updateComponents","idCounter","flatten","node","parentId","nodeId","concat","component","_objectSpread","Array","isArray","children","childIds","map","child","rootWithId","A2UIActivityRenderer","_ref2","registry","loading","className","style","deltaInfo","processorRef","useRef","lastContentRef","processedCountRef","current","A2uiMessageProcessor","processor","snapshot","useSyncExternalStore","subscribe","getSnapshot","getServerSnapshot","useEffect","allMessages","fromIndex","toIndex","newMessages","slice","processMessagesIncremental","contentStr","JSON","stringify","lastContentStr","_content$surface2","getSurface","_content$surface3","skeletonHint","createPendingSurface","processMessages","mergedRegistry","useMemo","defaultComponentRegistry","surfaceIds","from","keys","React","createElement","A2UISurfaceRenderer","displayName","createA2UIActivityConfig","options","_ref3","_ref3$activityType","activityType","finalOnAction","props","_props$ext","ext","description"],"mappings":"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"}

package/es/chat-engine/components/a2ui/A2UIComponentRenderer.d.ts

@@ -0,0 +1,37 @@
+/**
+ * A2UI 组件渲染器
+ * 根据组件类型分发到具体渲染实现
+ * 支持 A2UI v0.9 的 ResolvedComponent 结构
+ */
+import React from 'react';
+import type { ResolvedComponent, A2UIComponentBase } from '../../core/a2ui';
+export interface A2UIComponentRendererProps {
+    /** 要渲染的组件（支持 ResolvedComponent 或 A2UIComponentBase） */
+    component: ResolvedComponent | A2UIComponentBase;
+    className?: string;
+    style?: React.CSSProperties;
+    /** 是否在渲染错误时显示错误 UI（默认 false） */
+    showError?: boolean;
+    /** 组件渲染错误回调 */
+    onRenderError?: (error: Error, componentType?: string, componentId?: string) => void;
+}
+/**
+ * A2UI 组件渲染器
+ *
+ * 功能：
+ * 1. 从 ComponentRegistry 中查找对应组件类型的渲染器
+ * 2. 使用错误边界包裹，防止单个组件错误导致整个 Surface 崩溃
+ * 3. 支持自定义错误处理和错误 UI 显示
+ * 4. 支持 DataContextProvider 处理 template 渲染
+ */
+export declare const A2UIComponentRenderer: React.FC<A2UIComponentRendererProps>;
+interface A2UIChildrenRendererProps {
+    children?: ResolvedComponent[];
+    className?: string;
+}
+/**
+ * 渲染子组件列表
+ * 用于容器组件渲染其 resolvedChildren
+ */
+export declare const A2UIChildrenRenderer: React.FC<A2UIChildrenRendererProps>;
+export default A2UIComponentRenderer;

package/es/chat-engine/components/a2ui/A2UIComponentRenderer.js

@@ -0,0 +1,116 @@
+/**
+ * tdesign v1.0.2-alpha.14
+ * (c) 2026 tdesign
+ * @license MIT
+ */
+
+import _defineProperty from '@babel/runtime/helpers/defineProperty';
+import React__default, { memo, useMemo } from 'react';
+import { useComponentRegistry, DataContextProvider } from '../../hooks/a2ui/A2UIContext.js';
+import { A2UIErrorBoundary } from './A2UIErrorBoundary.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';
+
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+var UnknownComponent = function UnknownComponent(_ref) {
+  var componentType = _ref.componentType;
+  return /* @__PURE__ */React__default.createElement("div", {
+    className: "a2ui-unknown-component",
+    style: {
+      padding: "8px 12px",
+      backgroundColor: "rgba(250, 173, 20, 0.1)",
+      border: "1px solid rgba(250, 173, 20, 0.3)",
+      borderRadius: "4px",
+      color: "#faad14",
+      fontSize: "12px"
+    }
+  }, "\u672A\u77E5\u7EC4\u4EF6\u7C7B\u578B: ", componentType);
+};
+var InnerComponentRenderer = /*#__PURE__*/memo(function (props) {
+  var component = props.component,
+    className = props.className,
+    style = props.style;
+  var _useComponentRegistry = useComponentRegistry(),
+    getComponent = _useComponentRegistry.getComponent;
+  var resolvedComp = component;
+  var componentType = resolvedComp.component;
+  var id = resolvedComp.id;
+  var resolvedChildren = resolvedComp.resolvedChildren;
+  var dataContextPath = resolvedComp.dataContextPath;
+  var componentProps = _objectSpread({}, resolvedComp);
+  delete componentProps.component;
+  delete componentProps.resolvedChildren;
+  delete componentProps.dataContextPath;
+  var Component = getComponent(componentType);
+  if (!Component) {
+    console.warn("[A2UI] Unknown component type: ".concat(componentType));
+    return /* @__PURE__ */React__default.createElement(UnknownComponent, {
+      componentType: componentType
+    });
+  }
+  var content = /* @__PURE__ */React__default.createElement(Component, _objectSpread(_objectSpread({}, componentProps), {}, {
+    id: id,
+    className: className,
+    style: style,
+    resolvedChildren: resolvedChildren
+  }));
+  if (dataContextPath && dataContextPath !== "/") {
+    return /* @__PURE__ */React__default.createElement(DataContextProvider, {
+      path: dataContextPath
+    }, content);
+  }
+  return content;
+});
+InnerComponentRenderer.displayName = "InnerComponentRenderer";
+var A2UIComponentRenderer = /*#__PURE__*/memo(function (props) {
+  var component = props.component,
+    className = props.className,
+    style = props.style,
+    _props$showError = props.showError,
+    showError = _props$showError === void 0 ? false : _props$showError,
+    onRenderError = props.onRenderError;
+  var componentType = component === null || component === void 0 ? void 0 : component.component;
+  var componentId = component === null || component === void 0 ? void 0 : component.id;
+  var errorBoundaryKey = useMemo(function () {
+    return "".concat(componentType, "-").concat(componentId || "unknown");
+  }, [componentType, componentId]);
+  if (!component) {
+    console.warn("[A2UI] Received null/undefined component");
+    return null;
+  }
+  return /* @__PURE__ */React__default.createElement(A2UIErrorBoundary, {
+    key: errorBoundaryKey,
+    componentType: componentType,
+    componentId: componentId,
+    showError: showError,
+    onError: onRenderError
+  }, /* @__PURE__ */React__default.createElement(InnerComponentRenderer, {
+    component: component,
+    className: className,
+    style: style
+  }));
+});
+A2UIComponentRenderer.displayName = "A2UIComponentRenderer";
+var A2UIChildrenRenderer = /*#__PURE__*/memo(function (props) {
+  var children = props.children,
+    className = props.className;
+  if (!children || children.length === 0) {
+    return null;
+  }
+  return /* @__PURE__ */React__default.createElement("div", {
+    className: className
+  }, children.map(function (child, index) {
+    return /* @__PURE__ */React__default.createElement(A2UIComponentRenderer, {
+      key: child.id || "child-".concat(index),
+      component: child
+    });
+  }));
+});
+A2UIChildrenRenderer.displayName = "A2UIChildrenRenderer";
+
+export { A2UIChildrenRenderer, A2UIComponentRenderer, A2UIComponentRenderer as default };
+//# sourceMappingURL=A2UIComponentRenderer.js.map

package/es/chat-engine/components/a2ui/A2UIComponentRenderer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"A2UIComponentRenderer.js","sources":["../../../../../pro-components/chat/chat-engine/components/a2ui/A2UIComponentRenderer.tsx"],"sourcesContent":["/**\n * A2UI 组件渲染器\n * 根据组件类型分发到具体渲染实现\n * 支持 A2UI v0.9 的 ResolvedComponent 结构\n */\n\nimport React, { memo, useMemo } from 'react';\nimport { useComponentRegistry, DataContextProvider } from '../../hooks/a2ui/A2UIContext';\nimport { A2UIErrorBoundary } from './A2UIErrorBoundary';\nimport type { ResolvedComponent, A2UIComponentBase } from '../../core/a2ui';\n\nexport interface A2UIComponentRendererProps {\n  /** 要渲染的组件（支持 ResolvedComponent 或 A2UIComponentBase） */\n  component: ResolvedComponent | A2UIComponentBase;\n  className?: string;\n  style?: React.CSSProperties;\n  /** 是否在渲染错误时显示错误 UI（默认 false） */\n  showError?: boolean;\n  /** 组件渲染错误回调 */\n  onRenderError?: (error: Error, componentType?: string, componentId?: string) => void;\n}\n\ninterface InnerComponentRendererProps {\n  component: ResolvedComponent | A2UIComponentBase;\n  className?: string;\n  style?: React.CSSProperties;\n}\n\n/**\n * 未知组件占位\n */\nconst UnknownComponent: React.FC<{ componentType: string }> = ({ componentType }) => (\n  <div\n    className=\"a2ui-unknown-component\"\n    style={{\n      padding: '8px 12px',\n      backgroundColor: 'rgba(250, 173, 20, 0.1)',\n      border: '1px solid rgba(250, 173, 20, 0.3)',\n      borderRadius: '4px',\n      color: '#faad14',\n      fontSize: '12px',\n    }}\n  >\n    未知组件类型: {componentType}\n  </div>\n);\n\n/**\n * 内部组件渲染器（无错误边界）\n */\nconst InnerComponentRenderer: React.FC<InnerComponentRendererProps> = memo((props: InnerComponentRendererProps) => {\n  const { component, className, style } = props;\n  const { getComponent } = useComponentRegistry();\n\n  const resolvedComp = component as ResolvedComponent;\n  const componentType = resolvedComp.component;\n  const id = resolvedComp.id;\n  const resolvedChildren = resolvedComp.resolvedChildren;\n  const dataContextPath = resolvedComp.dataContextPath;\n  \n  // 其他属性传递给具体组件\n  const componentProps = { ...resolvedComp } as Record<string, unknown>;\n  delete componentProps.component;\n  delete componentProps.resolvedChildren;\n  delete componentProps.dataContextPath;\n\n  const Component = getComponent(componentType);\n\n  if (!Component) {\n    console.warn(`[A2UI] Unknown component type: ${componentType}`);\n    return <UnknownComponent componentType={componentType} />;\n  }\n\n  // 如果有 dataContextPath，使用 DataContextProvider 包裹\n  const content = (\n    <Component\n      {...componentProps}\n      id={id}\n      className={className}\n      style={style}\n      // 传递解析后的子组件（如果有）\n      resolvedChildren={resolvedChildren}\n    />\n  );\n\n  // 如果组件有自己的 dataContextPath（如 template 渲染的组件），包裹 DataContextProvider\n  if (dataContextPath && dataContextPath !== '/') {\n    return (\n      <DataContextProvider path={dataContextPath}>\n        {content}\n      </DataContextProvider>\n    );\n  }\n\n  return content;\n});\n\nInnerComponentRenderer.displayName = 'InnerComponentRenderer';\n\n/**\n * A2UI 组件渲染器\n * \n * 功能：\n * 1. 从 ComponentRegistry 中查找对应组件类型的渲染器\n * 2. 使用错误边界包裹，防止单个组件错误导致整个 Surface 崩溃\n * 3. 支持自定义错误处理和错误 UI 显示\n * 4. 支持 DataContextProvider 处理 template 渲染\n */\nexport const A2UIComponentRenderer: React.FC<A2UIComponentRendererProps> = memo((props: A2UIComponentRendererProps) => {\n  const { component, className, style, showError = false, onRenderError } = props;\n  \n  // 提取组件信息用于错误边界\n  const componentType = (component as ResolvedComponent)?.component;\n  const componentId = (component as ResolvedComponent)?.id;\n\n  // 使用 useMemo 避免每次渲染都创建新的错误边界 key\n  const errorBoundaryKey = useMemo(\n    () => `${componentType}-${componentId || 'unknown'}`,\n    [componentType, componentId]\n  );\n\n  // 空组件检查\n  if (!component) {\n    console.warn('[A2UI] Received null/undefined component');\n    return null;\n  }\n\n  return (\n    <A2UIErrorBoundary\n      key={errorBoundaryKey}\n      componentType={componentType}\n      componentId={componentId}\n      showError={showError}\n      onError={onRenderError}\n    >\n      <InnerComponentRenderer\n        component={component}\n        className={className}\n        style={style}\n      />\n    </A2UIErrorBoundary>\n  );\n});\n\nA2UIComponentRenderer.displayName = 'A2UIComponentRenderer';\n\ninterface A2UIChildrenRendererProps {\n  children?: ResolvedComponent[];\n  className?: string;\n}\n\n/**\n * 渲染子组件列表\n * 用于容器组件渲染其 resolvedChildren\n */\nexport const A2UIChildrenRenderer: React.FC<A2UIChildrenRendererProps> = memo((props: A2UIChildrenRendererProps) => {\n  const { children, className } = props;\n  if (!children || children.length === 0) {\n    return null;\n  }\n\n  return (\n    <div className={className}>\n      {children.map((child, index) => (\n        <A2UIComponentRenderer\n          key={child.id || `child-${index}`}\n          component={child}\n        />\n      ))}\n    </div>\n  );\n});\n\nA2UIChildrenRenderer.displayName = 'A2UIChildrenRenderer';\n\nexport default A2UIComponentRenderer;\n"],"names":["UnknownComponent","_ref","componentType","React","createElement","className","style","padding","backgroundColor","border","borderRadius","color","fontSize","InnerComponentRenderer","memo","props","component","_useComponentRegistry","useComponentRegistry","getComponent","resolvedComp","id","resolvedChildren","dataContextPath","componentProps","_objectSpread","Component","console","warn","concat","content","DataContextProvider","path","displayName","A2UIComponentRenderer","showError","_props$showError","onRenderError","componentId","errorBoundaryKey","useMemo","A2UIErrorBoundary","key","onError","A2UIChildrenRenderer","children","length","map","child","index"],"mappings":"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"}

package/es/chat-engine/components/a2ui/A2UIErrorBoundary.d.ts

@@ -0,0 +1,42 @@
+/**
+ * A2UI 错误边界组件
+ * 捕获组件渲染错误，防止整个 Surface 崩溃
+ */
+import React, { Component, ErrorInfo, ReactNode } from 'react';
+export interface A2UIErrorBoundaryProps {
+    /** 子组件 */
+    children: ReactNode;
+    /** 组件类型（用于日志） */
+    componentType?: string;
+    /** 组件 ID（用于日志） */
+    componentId?: string;
+    /** 自定义 fallback 渲染 */
+    fallback?: ReactNode | ((error: Error, componentType?: string) => ReactNode);
+    /** 错误回调 */
+    onError?: (error: Error, componentType?: string, componentId?: string) => void;
+    /** 是否显示错误 UI（默认 false，静默失败） */
+    showError?: boolean;
+}
+interface A2UIErrorBoundaryState {
+    hasError: boolean;
+    error: Error | null;
+}
+/**
+ * A2UI 错误边界
+ *
+ * 设计原则：
+ * 1. 默认静默失败，不显示错误 UI（避免影响用户体验）
+ * 2. 在控制台输出详细错误信息（便于调试）
+ * 3. 支持自定义 fallback 和错误回调（便于业务定制）
+ */
+export declare class A2UIErrorBoundary extends Component<A2UIErrorBoundaryProps, A2UIErrorBoundaryState> {
+    constructor(props: A2UIErrorBoundaryProps);
+    static getDerivedStateFromError(error: Error): A2UIErrorBoundaryState;
+    componentDidCatch(error: Error, errorInfo: ErrorInfo): void;
+    render(): string | number | boolean | React.ReactElement<any, string | React.JSXElementConstructor<any>> | Iterable<React.ReactNode> | import("react/jsx-runtime").JSX.Element;
+}
+/**
+ * 高阶组件：为组件添加错误边界
+ */
+export declare function withA2UIErrorBoundary<P extends object>(WrappedComponent: React.ComponentType<P>, options?: Omit<A2UIErrorBoundaryProps, 'children'>): React.FC<P>;
+export default A2UIErrorBoundary;