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

package/es/chat-actionbar/index.js

@@ -6,18 +6,16 @@
 
 import 'tdesign-web-components/lib/chat-action';
 import reactify from '../_util/reactify.js';
+import '@babel/runtime/helpers/defineProperty';
 import '@babel/runtime/helpers/objectWithoutProperties';
-import '@babel/runtime/helpers/toConsumableArray';
+import '@babel/runtime/helpers/typeof';
+import '@babel/runtime/helpers/slicedToArray';
 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 '@babel/runtime/helpers/defineProperty';
-import '@babel/runtime/helpers/slicedToArray';
-import '@babel/runtime/helpers/typeof';
 import 'react';
-import 'react-dom';
 import 'react-dom/client';
 
 var ChatActionBar = reactify("t-chat-action");

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

@@ -1 +1 @@
-{"version":3,"file":"index.js","sources":["../../../pro-components/chat/chat-actionbar/index.tsx"],"sourcesContent":["import { TdChatActionProps } from 'tdesign-web-components';\nimport 'tdesign-web-components/lib/chat-action';\nimport reactify from '../_util/reactify';\n\nexport const ChatActionBar: React.ForwardRefExoticComponent<\n  Omit<TdChatActionProps, 'ref'> &\n    React.RefAttributes<HTMLElement | undefined> & {\n      [key: string]: any;\n    }\n> = reactify<TdChatActionProps>('t-chat-action');\n\nexport default ChatActionBar;\nexport type { TdChatActionProps, TdChatActionsName } from 'tdesign-web-components';\n\n// 方案1\n// import { reactifyLazy } from './_util/reactifyLazy';\n// const ChatActionBar = reactifyLazy<{\n//   size: 'small' | 'medium' | 'large',\n//   variant: 'primary' | 'secondary' | 'outline'\n// }>(\n//   't-chat-action',\n//   'tdesign-web-components/esm/chat-action'\n// );\n\n// import ChatAction from 'tdesign-web-components/esm/chat-action';\n// import React, { forwardRef, useEffect } from 'react';\n\n// // 注册Web Components组件\n// const registerChatAction = () => {\n//   if (!customElements.get('t-chat-action')) {\n//     customElements.define('t-chat-action', ChatAction);\n//   }\n// };\n\n// // 在组件挂载时注册\n// const useRegisterWebComponent = () => {\n//   useEffect(() => {\n//     registerChatAction();\n//   }, []);\n// };\n\n// // 使用reactify创建React组件\n// const BaseChatActionBar = reactify<TdChatActionProps>('t-chat-action');\n\n// // 包装组件，确保Web Components已注册\n// export const ChatActionBar2 = forwardRef<\n//   HTMLElement | undefined,\n//   Omit<TdChatActionProps, 'ref'> & { [key: string]: any }\n// >((props, ref) => {\n//   useRegisterWebComponent();\n//   return <BaseChatActionBar {...props} ref={ref} />;\n// });\n"],"names":["ChatActionBar","reactify"],"mappings":";;;;;;;;;;;;;;;;;;;;;;IAIaA,aAAA,GAKTC,SAA4B,eAAe;;;;"}
+{"version":3,"file":"index.js","sources":["../../../pro-components/chat/chat-actionbar/index.tsx"],"sourcesContent":["import { TdChatActionProps } from 'tdesign-web-components';\nimport 'tdesign-web-components/lib/chat-action';\nimport reactify from '../_util/reactify';\n\nexport const ChatActionBar: React.ForwardRefExoticComponent<\n  Omit<TdChatActionProps, 'ref'> &\n    React.RefAttributes<HTMLElement | undefined> & {\n      [key: string]: any;\n    }\n> = reactify<TdChatActionProps>('t-chat-action');\n\nexport default ChatActionBar;\nexport type { TdChatActionProps, TdChatActionsName } from 'tdesign-web-components';\n\n// 方案1\n// import { reactifyLazy } from './_util/reactifyLazy';\n// const ChatActionBar = reactifyLazy<{\n//   size: 'small' | 'medium' | 'large',\n//   variant: 'primary' | 'secondary' | 'outline'\n// }>(\n//   't-chat-action',\n//   'tdesign-web-components/esm/chat-action'\n// );\n\n// import ChatAction from 'tdesign-web-components/esm/chat-action';\n// import React, { forwardRef, useEffect } from 'react';\n\n// // 注册Web Components组件\n// const registerChatAction = () => {\n//   if (!customElements.get('t-chat-action')) {\n//     customElements.define('t-chat-action', ChatAction);\n//   }\n// };\n\n// // 在组件挂载时注册\n// const useRegisterWebComponent = () => {\n//   useEffect(() => {\n//     registerChatAction();\n//   }, []);\n// };\n\n// // 使用reactify创建React组件\n// const BaseChatActionBar = reactify<TdChatActionProps>('t-chat-action');\n\n// // 包装组件，确保Web Components已注册\n// export const ChatActionBar2 = forwardRef<\n//   HTMLElement | undefined,\n//   Omit<TdChatActionProps, 'ref'> & { [key: string]: any }\n// >((props, ref) => {\n//   useRegisterWebComponent();\n//   return <BaseChatActionBar {...props} ref={ref} />;\n// });\n"],"names":["ChatActionBar","reactify"],"mappings":";;;;;;;;;;;;;;;;;;;;IAIaA,aAAA,GAKTC,SAA4B,eAAe;;;;"}

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

@@ -0,0 +1,196 @@
+/**
+ * A2UI Activity 渲染器
+ * 将 A2UI v0.9 协议数据作为 Activity 进行渲染
+ *
+ * 支持的消息格式：
+ * 1. A2UI v0.9 原生格式（createSurface、updateComponents、updateDataModel、deleteSurface）
+ * 2. 简化的 surface 格式（向后兼容）
+ *
+ * 使用方式：
+ * 1. 通过 useAgentActivity 注册此组件
+ * 2. 后端发送 ACTIVITY_SNAPSHOT/ACTIVITY_DELTA 事件，activityType 为 'a2ui-surface'
+ * 3. content 中包含 A2UI 协议消息
+ */
+import React from 'react';
+import type { A2UIServerMessage, A2UIComponentBase, A2UIAction, ActionHandler, ActionContext, SkeletonHint } from '../../core/a2ui';
+import type { ComponentRegistry } from '../../hooks/a2ui/A2UIContext';
+/**
+ * UserAction 消息格式（A2UI 0.9 规范）
+ * 用于发送给服务端的用户操作消息
+ */
+export interface UserActionMessage {
+    /** Action 名称 */
+    name: string;
+    /** 触发 Action 的 Surface ID */
+    surfaceId: string;
+    /** 触发 Action 的组件 ID */
+    sourceComponentId: string;
+    /** 时间戳 */
+    timestamp: string;
+    /** 解析后的上下文数据（数据绑定路径已解析为实际值） */
+    context: Record<string, unknown>;
+}
+/**
+ * Action 处理结果
+ * 返回给业务层，由业务层决定如何处理
+ */
+export interface ActionResult {
+    /** 构造好的 userAction 消息 */
+    userActionMessage: UserActionMessage;
+    /** 原始 Action 定义 */
+    action: A2UIAction;
+    /** Action 上下文 */
+    actionContext?: ActionContext;
+}
+/**
+ * Action 处理回调
+ * 业务层通过此回调接收解析后的 Action 数据，自行决定是否发送请求
+ */
+export type OnActionCallback = (result: ActionResult) => void | Promise<void>;
+/**
+ * 创建 A2UI 0.9 协议标准的 Action 处理器
+ *
+ * 职责：
+ * 1. 解析 Action 中的数据绑定路径
+ * 2. 构造标准的 UserActionMessage
+ * 3. 将处理结果传递给业务层回调
+ *
+ * @param onAction 业务层回调，接收解析后的 ActionResult
+ * @returns ActionHandler
+ */
+export declare function createA2UIActionHandler(onAction: OnActionCallback): ActionHandler;
+/**
+ * A2UI Activity Content 类型
+ * 支持 A2UI v0.9 原生格式和简化格式
+ */
+export interface A2UIActivityContent {
+    /** A2UI v0.9 消息列表（标准名称） */
+    messages?: A2UIServerMessage[];
+    /** A2UI v0.9 消息列表（别名，向后兼容） */
+    operations?: A2UIServerMessage[];
+    /** 简化模式：单个 Surface 定义 */
+    surface?: {
+        id?: string;
+        root?: A2UIComponentBase;
+        data?: Record<string, unknown>;
+        skeletonHint?: SkeletonHint;
+    };
+    /** Surface ID（用于简化模式） */
+    surfaceId?: string;
+}
+/**
+ * 增量信息类型
+ */
+export interface DeltaInfo {
+    fromIndex: number;
+    toIndex: number;
+}
+export interface A2UIActivityRendererProps {
+    /** Activity 类型 */
+    activityType?: string;
+    /** Activity 内容数据 */
+    content: A2UIActivityContent;
+    /** 关联的消息 ID */
+    messageId: string;
+    /** 自定义组件注册表 */
+    registry?: ComponentRegistry;
+    /** Action 处理回调 */
+    onAction?: ActionHandler;
+    /**
+     * 加载中占位
+     * - ReactNode: 自定义骨架屏组件
+     * - true: 使用服务端 skeletonHint 自动渲染骨架屏
+     */
+    loading?: React.ReactNode | boolean;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: React.CSSProperties;
+    /** 增量信息（由 AG-UI adapter 提供） */
+    deltaInfo?: DeltaInfo;
+}
+/**
+ * A2UI Activity 渲染器组件
+ */
+export declare const A2UIActivityRenderer: React.FC<A2UIActivityRendererProps>;
+/**
+ * A2UI Activity 配置选项
+ */
+export interface A2UIActivityConfigOptions {
+    /** Activity 类型标识 */
+    activityType?: string;
+    /** 自定义组件注册表 */
+    registry?: ComponentRegistry;
+    /**
+     * Action 处理回调（推荐使用）
+     *
+     * 接收解析后的 ActionResult，包含：
+     * - userActionMessage: 构造好的标准消息，可直接发送给服务端
+     * - action: 原始 Action 定义
+     * - actionContext: Action 上下文（包含 getData、updateData 等方法）
+     *
+     * 业务层自行决定：
+     * 1. 是否需要发送请求到服务端
+     * 2. 是否需要本地处理（如 reset 操作）
+     * 3. 是否需要更新本地状态
+     *
+     * @example
+     * ```tsx
+     * createA2UIActivityConfig({
+     *   onAction: async ({ userActionMessage, action, actionContext }) => {
+     *     // 根据 action.name 决定处理方式
+     *     if (action.name === 'reset') {
+     *       // 本地处理，不发送请求
+     *       actionContext?.updateData('/', initialData);
+     *       return;
+     *     }
+     *
+     *     // 发送请求到服务端
+     *     await chatEngine.sendAIMessage({
+     *       params: { userActionMessage },
+     *       sendRequest: true,
+     *     });
+     *   }
+     * })
+     * ```
+     */
+    onAction?: OnActionCallback;
+    /** 加载中占位 */
+    loading?: React.ReactNode | boolean;
+}
+/**
+ * 创建 A2UI Activity 配置
+ *
+ * @example
+ * ```tsx
+ * const { chatEngine } = useChat({ ... });
+ *
+ * const a2uiConfig = useMemo(() => createA2UIActivityConfig({
+ *   onAction: async ({ userActionMessage, action }) => {
+ *     // 本地操作不发请求
+ *     if (action.name === 'reset') return;
+ *
+ *     // 其他操作发送到服务端
+ *     await chatEngine.sendAIMessage({
+ *       params: { userActionMessage },
+ *       sendRequest: true,
+ *     });
+ *   }
+ * }), [chatEngine]);
+ *
+ * useAgentActivity(a2uiConfig);
+ * ```
+ */
+export declare function createA2UIActivityConfig(options?: A2UIActivityConfigOptions): {
+    activityType: string;
+    component: (props: {
+        activityType: string;
+        content: A2UIActivityContent;
+        messageId: string;
+        ext?: {
+            deltaInfo?: DeltaInfo;
+        };
+    }) => import("react/jsx-runtime").JSX.Element;
+    description: string;
+};
+export default A2UIActivityRenderer;

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":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsEA,SAASA,oBAAAA,CACPC,eACAC,OACyB,EAAA;EACzB,IAAMC,WAAoC,EAAC,CAAA;EAE3C,IAAI,CAACF,aAAA,IAAiBG,OAAA,CAAOH,aAAA,CAAA,KAAkB,QAAU,EAAA;AAChD,IAAA,OAAAE,QAAA,CAAA;AACT,GAAA;AAEA,EAAA,KAAA,IAAAE,EAAA,GAAAC,CAAAA,EAAAA,eAAA,GAA2BC,MAAO,CAAAC,OAAA,CAAQP,aAAa,CAAG,EAAAI,EAAA,GAAAC,eAAA,CAAAG,MAAA,EAAAJ,EAAA,EAAA,EAAA;AAA1D,IAAA,IAAAK,kBAAA,GAAAC,cAAA,CAAAL,eAAA,CAAAD,EAAA,CAAA,EAAA,CAAA,CAAA;AAAYO,MAAAA,GAAK,GAAAF,kBAAA,CAAA,CAAA,CAAA;AAAAG,MAAAA,KAAK,GAAAH,kBAAA,CAAA,CAAA,CAAA,CAAA;IACpB,IAAIN,OAAA,CAAOS,KAAA,CAAU,KAAA,QAAY,IAAAA,KAAA,IAAS,UAAUA,KAAO,EAAA;AAEzD,MAAA,IAAMC,OAAQD,KAA2B,CAAAC,IAAA,CAAA;MAChCX,QAAA,CAAAS,GAAA,CAAA,GAAOV,YAAAA,IAAAA,IAAAA,YAAAA,KAAAA,CAAAA,GAAAA,KAAAA,CAAAA,GAAAA,QAAUY,IAAI,CAAA,CAAA;AAChC,KAAO,MAAA;AACLX,MAAAA,QAAA,CAASS,GAAO,CAAA,GAAAC,KAAA,CAAA;AAClB,KAAA;AACF,GAAA;AAEO,EAAA,OAAAV,QAAA,CAAA;AACT,CAAA;AAaO,SAASY,wBAAwBC,QAA2C,EAAA;AAC1E,EAAA,oBAAA,YAAA;AAAA,IAAA,IAAAC,IAAA,GAAAC,iBAAA,cAAAC,mBAAA,CAAAC,IAAA,CAAA,SAAAC,OAAAA,CAAOC,QAAoBC,OAA4B,EAAA;AAAA,MAAA,IAAAC,IAAA,EAAAC,eAAA,EAAAC,iBAAA,CAAA;AAAA,MAAA,OAAAP,mBAAA,CAAAQ,IAAA,CAAA,UAAAC,QAAA,EAAA;AAAA,QAAA,OAAA,CAAA,EAAA,QAAAA,QAAA,CAAAC,IAAA,GAAAD,QAAA,CAAAE,IAAA;AAAA,UAAA,KAAA,CAAA;YACpDN,OAASF,MAAA,CAATE;gBAEHA,IAAM,EAAA;AAAAI,cAAAA,QAAA,CAAAE,IAAA,GAAA,CAAA,CAAA;AAAA,cAAA,MAAA;AAAA,aAAA;AACDC,YAAAA,OAAA,CAAAC,IAAA,CAAK,iDAA6BV,MAAM,CAAA,CAAA;YAAA,OAAAM,QAAA,CAAAK,MAAA,CAAA,QAAA,CAAA,CAAA;AAAA,UAAA,KAAA,CAAA;AAK5CR,YAAAA,eAAkB,GAAAzB,oBAAA,CAAqBsB,MAAO,CAAAC,OAAA,EAASA,oBAAAA,8BAAAA,QAASrB,OAAO,CAAA,CAAA;AAGvEwB,YAAAA,iBAAuC,GAAA;AAC3CF,cAAAA,IAAA,EAAAA,IAAA;cACAU,SAAA,EAAW,CAAAX,YAAAA,IAAAA,IAAAA,8BAAAA,QAASW,SAAa,KAAA,SAAA;cACjCC,iBAAA,EAAmB,CAAAZ,YAAAA,IAAAA,IAAAA,8BAAAA,QAASa,WAAe,KAAA,SAAA;cAC3CC,SAAW,EAAA,IAAIC,IAAK,EAAA,CAAEC,WAAY,EAAA;AAClChB,cAAAA,OAAS,EAAAE,eAAAA;aACX,CAAA;AAEAM,YAAAA,OAAA,CAAQS,GAAI,CAAA,6BAAA,EAAqB;AAAEhB,cAAAA,IAAA,EAAAA,IAAA;AAAME,cAAAA,mBAAAA,iBAAAA;AAAkB,aAAC,CAAA,CAAA;AAAAE,YAAAA,QAAA,CAAAE,IAAA,GAAA,CAAA,CAAA;AAAA,YAAA,OAGtDd,QAAS,CAAA;AACbU,cAAAA,iBAAA,EAAAA,iBAAA;AACAJ,cAAAA,MAAA,EAAAA,MAAA;AACArB,cAAAA,aAAe,EAAAsB,OAAAA;AACjB,aAAC,CAAA,CAAA;AAAA,UAAA,KAAA,CAAA,CAAA;AAAA,UAAA,KAAA,KAAA;YAAA,OAAAK,QAAA,CAAAa,IAAA,EAAA,CAAA;AAAA,SAAA;AAAA,OAAA,EAAApB,OAAA,CAAA,CAAA;KACH,CAAA,CAAA,CAAA;IAAA,OAAAqB,UAAAA,EAAA,EAAAC,GAAA,EAAA;AAAA,MAAA,OAAA1B,IAAA,CAAA2B,KAAA,CAAA,IAAA,EAAAC,SAAA,CAAA,CAAA;AAAA,KAAA,CAAA;AAAA,GAAA,EAAA,CAAA;AACF,CAAA;AA6DA,SAASC,oBAAoBC,GAAwC,EAAA;EAC/D,IAAA,CAACA,GAAO,IAAA3C,OAAA,CAAO2C,GAAQ,CAAA,KAAA,QAAA,EAAiB,OAAA,KAAA,CAAA;AAC5C,EAAA,OACE,mBAAmBA,GACnB,IAAA,kBAAA,IAAsBA,GACtB,IAAA,iBAAA,IAAqBA,OACrB,eAAmB,IAAAA,GAAA,CAAA;AAEvB,CAAA;AAKA,SAASC,qBAAAA,CACPC,SACAC,SACqB,EAAA;AAAA,EAAA,IAAAC,gBAAA,CAAA;EACrB,IAAMC,WAAgC,EAAC,CAAA;EACvC,IAAMlB,YAAYe,OAAQ,CAAAf,SAAA,KAAAiB,CAAAA,gBAAA,GAAaF,OAAQ,CAAAI,OAAA,MAAAF,IAAAA,IAAAA,gBAAA,uBAARA,gBAAA,CAAiBG,yBAAiBJ,SAAA,CAAA,CAAA;EAGnE,IAAAK,YAAA,GAAeN,OAAQ,CAAAG,QAAA,IAAYH,OAAQ,CAAAO,UAAA,CAAA;AAC7C,EAAA,IAAAD,YAAA,IAAgBA,YAAa,CAAA9C,MAAA,GAAS,CAAG,EAAA;AAEpC,IAAA,OAAA8C,YAAA,CAAaE,OAAOX,mBAAmB,CAAA,CAAA;AAChD,GAAA;EAGA,IAAIG,QAAQI,OAAS,EAAA;IAEnBD,QAAA,CAASM,IAAK,CAAA;AACZC,MAAAA,aAAe,EAAA;AACbzB,QAAAA,SAAA,EAAAA,SAAA;AACA0B,QAAAA,SAAW,EAAA,SAAA;AACb,OAAA;AACF,KAAC,CAAA,CAAA;AAGG,IAAA,IAAAX,OAAA,CAAQI,QAAQQ,IAAM,EAAA;MACxBT,QAAA,CAASM,IAAK,CAAA;AACZI,QAAAA,eAAiB,EAAA;AACf5B,UAAAA,SAAA,EAAAA,SAAA;AACApB,UAAAA,IAAM,EAAA,GAAA;AACNiD,UAAAA,EAAI,EAAA,SAAA;AACJlD,UAAAA,KAAA,EAAOoC,QAAQI,OAAQ,CAAAQ,IAAAA;AACzB,SAAA;AACF,OAAC,CAAA,CAAA;AACH,KAAA;AAGI,IAAA,IAAAZ,OAAA,CAAQI,QAAQW,IAAM,EAAA;MACxB,IAAMC,UAAa,GAAAC,iBAAA,CAAkBjB,OAAQ,CAAAI,OAAA,CAAQW,IAAI,CAAA,CAAA;AACrD,MAAA,IAAAC,UAAA,CAAWxD,SAAS,CAAG,EAAA;QACzB2C,QAAA,CAASM,IAAK,CAAA;AACZS,UAAAA,gBAAkB,EAAA;AAChBjC,YAAAA,SAAA,EAAAA,SAAA;AACA+B,YAAAA,UAAA,EAAAA,UAAAA;AACF,WAAA;AACF,SAAC,CAAA,CAAA;AACH,OAAA;AACF,KAAA;AACF,GAAA;AAEO,EAAA,OAAAb,QAAA,CAAA;AACT,CAAA;AAMA,SAASc,kBAAkBF,IAA8C,EAAA;EACvE,IAAMC,aAAkC,EAAC,CAAA;AACnC,EAAA,IAAAG,SAAA,GAAY;AAAEvD,IAAAA,KAAA,EAAO,CAAA;GAAE,CAAA;AAEpB,EAAA,SAAAwD,OAAAA,CAAQC,MAAWC,QAA2B,EAAA;AAErD,IAAA,IAAMC,MAAS,GAAAF,IAAA,CAAKhB,EAAM,IAAA,OAAA,CAAAmB,MAAA,CAAQL,SAAU,CAAAvD,KAAA,EAAA,CAAA,CAAA;AAG5C,IAAA,IAAM6D,SAA+B,GAAAC,aAAA,CAAAA,aAAA,KAChCL,IAAA,CAAA,EAAA,EAAA,EAAA;AACHhB,MAAAA,EAAI,EAAAkB,MAAAA;KACN,CAAA,CAAA;IAGA,IAAII,KAAM,CAAAC,OAAA,CAAQP,IAAK,CAAAQ,QAAQ,CAAG,EAAA;MAChC,IAAMC,QAAW,GAAAT,IAAA,CAAKQ,QAAS,CAAAE,GAAA,CAAI,UAACC,KAAe,EAAA;AAC7C,QAAA,IAAA,OAAOA,UAAU,QAAU,EAAA;AACtB,UAAA,OAAAA,KAAA,CAAA;AACT,SAAA;QACA,OAAOZ,QAAQY,KAAK,CAAA,CAAA;AACtB,OAAC,CAAA,CAAA;MACDP,SAAA,CAAUI,QAAW,GAAAC,QAAA,CAAA;AACvB,KAAA;IAGA,IAAIT,IAAK,CAAAW,KAAA,IAAS7E,OAAA,CAAOkE,IAAA,CAAKW,MAAU,KAAA,QAAU,EAAA;MACtCP,SAAA,CAAAO,KAAA,GAAQZ,OAAQ,CAAAC,IAAA,CAAKW,KAAK,CAAA,CAAA;AACtC,KAAA;AAEAhB,IAAAA,UAAA,CAAWP,KAAKgB,SAAS,CAAA,CAAA;AAClB,IAAA,OAAAF,MAAA,CAAA;AACT,GAAA;AAGA,EAAA,IAAMU,6CAAkBlB;AAAMV,IAAAA,EAAI,EAAAU,IAAA,CAAKV,MAAM,MAAA;GAAO,CAAA,CAAA;EACpDe,OAAA,CAAQa,UAAU,CAAA,CAAA;AAEX,EAAA,OAAAjB,UAAA,CAAA;AACT,CAAA;IAKakB,uBAA4D,SAA5DA,4BASP;AAAA,EAAA,IARJlC,OAAA,GAAAmC,KAAA,CAAAnC,OAAA;IACAC,SAAA,GAAAkC,KAAA,CAAAlC,SAAA;IACAmC,QAAA,GAAAD,KAAA,CAAAC,QAAA;IACArE,QAAA,GAAAoE,KAAA,CAAApE,QAAA;IACAsE,OAAA,GAAAF,KAAA,CAAAE,OAAA;IACAC,SAAA,GAAAH,KAAA,CAAAG,SAAA;IACAC,KAAA,GAAAJ,KAAA,CAAAI,KAAA;IACAC,SAAA,GAAAL,KAAA,CAAAK,SAAA,CAAA;AAGM,EAAA,IAAAC,YAAA,GAAeC,OAAoC,IAAI,CAAA,CAAA;AACvD,EAAA,IAAAC,cAAA,GAAiBD,OAAmC,IAAI,CAAA,CAAA;AACxD,EAAA,IAAAE,iBAAA,GAAoBF,OAAO,CAAC,CAAA,CAAA;AAG9B,EAAA,IAAA,CAACD,aAAaI,OAAS,EAAA;AACzBJ,IAAAA,YAAA,CAAaI,OAAU,GAAA,IAAIC,oBAAqB,CAAA;AAAE/E,MAAAA,UAAAA,QAAAA;AAAS,KAAC,CAAA,CAAA;AAC9D,GAAA;AACA,EAAA,IAAMgF,YAAYN,YAAa,CAAAI,OAAA,CAAA;AAG/B,EAAA,IAAMG,QAAW,GAAAC,oBAAA,CACfF,SAAU,CAAAG,SAAA,EACVH,SAAU,CAAAI,WAAA,EACVJ,SAAU,CAAAK,iBACZ,CAAA,CAAA;AAGAC,EAAAA,SAAA,CAAU,YAAM;IACd,IAAI,CAACrD,OAAA,EAAS,OAAA;IAGR,IAAAsD,WAAA,GAActD,OAAQ,CAAAG,QAAA,IAAYH,OAAQ,CAAAO,UAAA,CAAA;IAGhD,IAAIiC,SAAa,IAAAc,WAAA,IAAe3B,KAAM,CAAAC,OAAA,CAAQ0B,WAAW,CAAG,EAAA;AACpD,MAAA,IAAEC,SAAW,GAAYf,SAAA,CAAvBe,SAAW;QAAAC,OAAA,GAAYhB,SAAA,CAAZgB,OAAA,CAAA;MAGnB,IAAID,SAAY,GAAAC,OAAA,IAAWD,SAAa,IAAAX,iBAAA,CAAkBC,OAAS,EAAA;AACjE,QAAA,IAAMY,cAAcH,WAAY,CAAAI,KAAA,CAAMH,WAAWC,OAAO,CAAA,CAAEhD,OAAOX,mBAAmB,CAAA,CAAA;AAEhF,QAAA,IAAA4D,WAAA,CAAYjG,SAAS,CAAG,EAAA;AAE1BuF,UAAAA,SAAA,CAAUY,2BAA2BF,WAAW,CAAA,CAAA;UAChDb,iBAAA,CAAkBC,OAAU,GAAAW,OAAA,CAAA;AAC9B,SAAA;AACF,OAAA;MAEAb,cAAA,CAAeE,OAAU,GAAA7C,OAAA,CAAA;AACzB,MAAA,OAAA;AACF,KAAA;AAGM,IAAA,IAAA4D,UAAA,GAAaC,IAAK,CAAAC,SAAA,CAAU9D,OAAO,CAAA,CAAA;AACzC,IAAA,IAAM+D,iBAAiBpB,cAAe,CAAAE,OAAA,GAAUgB,KAAKC,SAAU,CAAAnB,cAAA,CAAeE,OAAO,CAAI,GAAA,EAAA,CAAA;IAEzF,IAAIe,UAAe,KAAAG,cAAA,IAAkBnB,iBAAkB,CAAAC,OAAA,GAAU,CAAG,EAAA;AAClE,MAAA,OAAA;AACF,KAAA;AAGM,IAAA,IAAA1C,QAAA,GAAWJ,qBAAsB,CAAAC,OAAA,EAASC,SAAS,CAAA,CAAA;AAErD,IAAA,IAAAE,QAAA,CAAS3C,SAAS,CAAG,EAAA;AAAA,MAAA,IAAAwG,iBAAA,CAAA;MAEvB,IAAM/E,YAAYe,OAAQ,CAAAf,SAAA,KAAA+E,CAAAA,iBAAA,GAAahE,OAAQ,CAAAI,OAAA,MAAA4D,IAAAA,IAAAA,iBAAA,uBAARA,iBAAA,CAAiB3D,yBAAiBJ,SAAA,CAAA,CAAA;MAGzE,IAAIoC,OAAW,IAAA,CAACU,SAAU,CAAAkB,UAAA,CAAWhF,SAAS,CAAG,EAAA;AAAA,QAAA,IAAAiF,iBAAA,CAAA;AACzC,QAAA,IAAAC,YAAA,GAAA,CAAAD,iBAAA,GAAelE,QAAQI,OAAS,MAAA,IAAA,IAAA8D,iBAAA,KAAA,KAAA,CAAA,GAAA,KAAA,CAAA,GAAjBA,iBAAA,CAAiBC,YAAA,CAAA;AAC5BpB,QAAAA,SAAA,CAAAqB,oBAAA,CAAqBnF,WAAWkF,YAAY,CAAA,CAAA;AACxD,OAAA;AAGApB,MAAAA,SAAA,CAAUsB,gBAAgBlE,QAAQ,CAAA,CAAA;AAClCyC,MAAAA,iBAAA,CAAkBC,UAAU1C,QAAS,CAAA3C,MAAA,CAAA;AACvC,KAAA;IAEAmF,cAAA,CAAeE,OAAU,GAAA7C,OAAA,CAAA;AAC3B,KAAG,CAACA,OAAA,EAASC,WAAW8C,SAAW,EAAAV,OAAA,EAASG,SAAS,CAAC,CAAA,CAAA;EAGtD,IAAM8B,cAAiB,GAAAC,OAAA,CACrB,YAAA;AAAA,IAAA,OAAA7C,aAAA,CAAAA,aAAA,CACK8C,EAAAA,EAAAA,wBAAA,GACApC,QAAA,CAAA,CAAA;AAAA,GACL,EACA,CAACA,QAAQ,CACX,CAAA,CAAA;EAGA,IAAMqC,UAAa,GAAA9C,KAAA,CAAM+C,IAAK,CAAA1B,QAAA,CAAS2B,MAAM,CAAA,CAAA;AAGzC,EAAA,IAAAF,UAAA,CAAWjH,WAAW,CAAG,EAAA;IAC3B,OAAO6E,yBAAWuC,cAAA,CAAAC,aAAA,CAAA,KAAA,EAAA;AAAIvC,MAAAA,SAAA,EAAAA,SAAA;AAAsBC,MAAAA,KAAA,EAAAA,KAAAA;AAAA,KAAA,EAAeF,OAAQ,CAAS,GAAA,IAAA,CAAA;AAC9E,GAAA;AAEA,EAAA,sBACGuC,cAAA,CAAAC,aAAA,CAAA,KAAA,EAAA;AAAIvC,IAAAA,SAAA,EAAAA,SAAA;AAAsBC,IAAAA,KAAA,EAAAA,KAAAA;AAAA,GAAA,EACxBkC,UAAW,CAAA1C,GAAA,CAAI,UAAC9C,SAAA,EAAA;AAAA,IAAA,sBACd2F,cAAA,CAAAC,aAAA,CAAAC,mBAAA,EAAA;AACCnH,MAAAA,GAAK,EAAAsB,SAAA;AACL8D,MAAAA,SAAA,EAAAA,SAAA;AACA9D,MAAAA,SAAA,EAAAA,SAAA;AACAmD,MAAAA,QAAU,EAAAkC,cAAA;AACVvG,MAAAA,QAAA,EAAAA,QAAA;AACAsE,MAAAA,OAAA,EAAAA,OAAAA;AAAA,KACF,CACD,CAAA;AAAA,GAAA,CACH,CAAA,CAAA;AAEJ,EAAA;AAEAH,oBAAA,CAAqB6C,WAAc,GAAA,sBAAA,CAAA;AAuE5B,SAASC,yBAAyBC,OAAqC,EAAA;AACtE,EAAA,IAAAC,KAAA,GAKFD,WAAW,EAAC;IAAAE,kBAAA,GAAAD,KAAA,CAJdE,YAAe;AAAfA,IAAAA,YAAe,GAAAD,kBAAA,KAAA,KAAA,CAAA,GAAA,cAAA,GAAAA,kBAAA;IACf/C,QAAA,GAAA8C,KAAA,CAAA9C,QAAA;IACArE,QAAA,GAAAmH,KAAA,CAAAnH,QAAA;IACAsE,OAAA,GAAA6C,KAAA,CAAA7C,OAAA,CAAA;EAIF,IAAMgD,aAAgB,GAAAtH,QAAA,GAAWD,uBAAwB,CAAAC,QAAQ,CAAI,GAAA,KAAA,CAAA,CAAA;EAE9D,OAAA;AACLqH,IAAAA,YAAA,EAAAA,YAAA;AACA3D,IAAAA,SAAA,EAAW,SAAXA,SAAAA,CAAY6D,KAAA,EAAA;AAAA,MAAA,IAAAC,UAAA,CAAA;MAAA,sBAMTX,cAAA,CAAAC,aAAA,CAAA3C,oBAAA,EAAAR,aAAA,CAAAA,aAAA,CAAA,EAAA,EACK4D,KAAA,CAAA,EAAA,EAAA,EAAA;AACJlD,QAAAA,QAAA,EAAAA,QAAA;AACArE,QAAAA,QAAU,EAAAsH,aAAA;AACVhD,QAAAA,OAAA,EAAAA,OAAA;QACAG,SAAA,EAAA,CAAA+C,UAAA,GAAWD,MAAME,GAAK,MAAAD,IAAAA,IAAAA,UAAA,KAAXA,KAAAA,CAAAA,GAAAA,KAAAA,CAAAA,GAAAA,UAAA,CAAW/C,SAAAA;AAAA,OAAA,CACxB,CAAA,CAAA;AAAA,KAAA;AAEFiD,IAAAA,WAAa,EAAA,iCAAA;GACf,CAAA;AACF;;;;"}

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;