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

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

@@ -0,0 +1,113 @@
+/**
+ * tdesign v1.0.2-alpha.14
+ * (c) 2026 tdesign
+ * @license MIT
+ */
+
+import _defineProperty from '@babel/runtime/helpers/defineProperty';
+import _classCallCheck from '@babel/runtime/helpers/classCallCheck';
+import _createClass from '@babel/runtime/helpers/createClass';
+import _possibleConstructorReturn from '@babel/runtime/helpers/possibleConstructorReturn';
+import _getPrototypeOf from '@babel/runtime/helpers/getPrototypeOf';
+import _inherits from '@babel/runtime/helpers/inherits';
+import React__default, { Component } from 'react';
+
+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 _callSuper(t, o, e) { return o = _getPrototypeOf(o), _possibleConstructorReturn(t, _isNativeReflectConstruct() ? Reflect.construct(o, e || [], _getPrototypeOf(t).constructor) : o.apply(t, e)); }
+function _isNativeReflectConstruct() { try { var t = !Boolean.prototype.valueOf.call(Reflect.construct(Boolean, [], function () {})); } catch (t) {} return (_isNativeReflectConstruct = function _isNativeReflectConstruct() { return !!t; })(); }
+var A2UIErrorBoundary = /*#__PURE__*/function (_Component) {
+  function A2UIErrorBoundary(props) {
+    var _this;
+    _classCallCheck(this, A2UIErrorBoundary);
+    _this = _callSuper(this, A2UIErrorBoundary, [props]);
+    _this.state = {
+      hasError: false,
+      error: null
+    };
+    return _this;
+  }
+  _inherits(A2UIErrorBoundary, _Component);
+  return _createClass(A2UIErrorBoundary, [{
+    key: "componentDidCatch",
+    value: function componentDidCatch(error, errorInfo) {
+      var _this$props = this.props,
+        componentType = _this$props.componentType,
+        componentId = _this$props.componentId,
+        onError = _this$props.onError;
+      console.error("[A2UI] Component render error", {
+        componentType: componentType,
+        componentId: componentId,
+        error: error.message,
+        stack: error.stack,
+        componentStack: errorInfo.componentStack
+      });
+      onError === null || onError === void 0 || onError(error, componentType, componentId);
+    }
+  }, {
+    key: "render",
+    value: function render() {
+      var _this$state = this.state,
+        hasError = _this$state.hasError,
+        error = _this$state.error;
+      var _this$props2 = this.props,
+        children = _this$props2.children,
+        fallback = _this$props2.fallback,
+        _this$props2$showErro = _this$props2.showError,
+        showError = _this$props2$showErro === void 0 ? false : _this$props2$showErro,
+        componentType = _this$props2.componentType;
+      if (hasError) {
+        if (fallback) {
+          if (typeof fallback === "function") {
+            return /* @__PURE__ */React__default.createElement(React__default.Fragment, null, fallback(error, componentType));
+          }
+          return /* @__PURE__ */React__default.createElement(React__default.Fragment, null, fallback);
+        }
+        if (showError) {
+          return /* @__PURE__ */React__default.createElement("div", {
+            className: "a2ui-error-boundary",
+            style: {
+              padding: "8px 12px",
+              backgroundColor: "rgba(255, 77, 79, 0.1)",
+              border: "1px solid rgba(255, 77, 79, 0.3)",
+              borderRadius: "4px",
+              color: "#ff4d4f",
+              fontSize: "12px"
+            }
+          }, /* @__PURE__ */React__default.createElement("div", {
+            style: {
+              fontWeight: 500,
+              marginBottom: "4px"
+            }
+          }, "\u7EC4\u4EF6\u6E32\u67D3\u9519\u8BEF ", componentType ? "(".concat(componentType, ")") : ""), /* @__PURE__ */React__default.createElement("div", {
+            style: {
+              color: "#666",
+              wordBreak: "break-all"
+            }
+          }, (error === null || error === void 0 ? void 0 : error.message) || "\u672A\u77E5\u9519\u8BEF"));
+        }
+        return null;
+      }
+      return children;
+    }
+  }], [{
+    key: "getDerivedStateFromError",
+    value: function getDerivedStateFromError(error) {
+      return {
+        hasError: true,
+        error: error
+      };
+    }
+  }]);
+}(Component);
+function withA2UIErrorBoundary(WrappedComponent) {
+  var options = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
+  var WithErrorBoundary = function WithErrorBoundary(props) {
+    return /* @__PURE__ */React__default.createElement(A2UIErrorBoundary, _objectSpread({}, options), /* @__PURE__ */React__default.createElement(WrappedComponent, _objectSpread({}, props)));
+  };
+  WithErrorBoundary.displayName = "WithA2UIErrorBoundary(".concat(WrappedComponent.displayName || WrappedComponent.name || "Component", ")");
+  return WithErrorBoundary;
+}
+
+export { A2UIErrorBoundary, A2UIErrorBoundary as default, withA2UIErrorBoundary };
+//# sourceMappingURL=A2UIErrorBoundary.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"A2UIErrorBoundary.js","sources":["../../../../../pro-components/chat/chat-engine/components/a2ui/A2UIErrorBoundary.tsx"],"sourcesContent":["/**\n * A2UI 错误边界组件\n * 捕获组件渲染错误，防止整个 Surface 崩溃\n */\n\nimport React, { Component, ErrorInfo, ReactNode } from 'react';\n\nexport interface A2UIErrorBoundaryProps {\n  /** 子组件 */\n  children: ReactNode;\n  /** 组件类型（用于日志） */\n  componentType?: string;\n  /** 组件 ID（用于日志） */\n  componentId?: string;\n  /** 自定义 fallback 渲染 */\n  fallback?: ReactNode | ((error: Error, componentType?: string) => ReactNode);\n  /** 错误回调 */\n  onError?: (error: Error, componentType?: string, componentId?: string) => void;\n  /** 是否显示错误 UI（默认 false，静默失败） */\n  showError?: boolean;\n}\n\ninterface A2UIErrorBoundaryState {\n  hasError: boolean;\n  error: Error | null;\n}\n\n/**\n * A2UI 错误边界\n * \n * 设计原则：\n * 1. 默认静默失败，不显示错误 UI（避免影响用户体验）\n * 2. 在控制台输出详细错误信息（便于调试）\n * 3. 支持自定义 fallback 和错误回调（便于业务定制）\n */\nexport class A2UIErrorBoundary extends Component<A2UIErrorBoundaryProps, A2UIErrorBoundaryState> {\n  constructor(props: A2UIErrorBoundaryProps) {\n    super(props);\n    this.state = { hasError: false, error: null };\n  }\n\n  static getDerivedStateFromError(error: Error): A2UIErrorBoundaryState {\n    return { hasError: true, error };\n  }\n\n  componentDidCatch(error: Error, errorInfo: ErrorInfo): void {\n    const { componentType, componentId, onError } = this.props;\n\n    // 输出详细错误日志\n    console.error(\n      `[A2UI] Component render error`,\n      {\n        componentType,\n        componentId,\n        error: error.message,\n        stack: error.stack,\n        componentStack: errorInfo.componentStack,\n      }\n    );\n\n    // 调用错误回调\n    onError?.(error, componentType, componentId);\n  }\n\n  render() {\n    const { hasError, error } = this.state;\n    const { children, fallback, showError = false, componentType } = this.props;\n\n    if (hasError) {\n      // 自定义 fallback\n      if (fallback) {\n        if (typeof fallback === 'function') {\n          return <>{fallback(error!, componentType)}</>;\n        }\n        return <>{fallback}</>;\n      }\n\n      // 显示错误 UI\n      if (showError) {\n        return (\n          <div\n            className=\"a2ui-error-boundary\"\n            style={{\n              padding: '8px 12px',\n              backgroundColor: 'rgba(255, 77, 79, 0.1)',\n              border: '1px solid rgba(255, 77, 79, 0.3)',\n              borderRadius: '4px',\n              color: '#ff4d4f',\n              fontSize: '12px',\n            }}\n          >\n            <div style={{ fontWeight: 500, marginBottom: '4px' }}>\n              组件渲染错误 {componentType ? `(${componentType})` : ''}\n            </div>\n            <div style={{ color: '#666', wordBreak: 'break-all' }}>\n              {error?.message || '未知错误'}\n            </div>\n          </div>\n        );\n      }\n\n      // 默认静默失败，返回 null\n      return null;\n    }\n\n    return children;\n  }\n}\n\n/**\n * 高阶组件：为组件添加错误边界\n */\nexport function withA2UIErrorBoundary<P extends object>(\n  WrappedComponent: React.ComponentType<P>,\n  options: Omit<A2UIErrorBoundaryProps, 'children'> = {}\n): React.FC<P> {\n  const WithErrorBoundary: React.FC<P> = (props) => (\n    <A2UIErrorBoundary {...options}>\n      <WrappedComponent {...props} />\n    </A2UIErrorBoundary>\n  );\n\n  WithErrorBoundary.displayName = `WithA2UIErrorBoundary(${\n    WrappedComponent.displayName || WrappedComponent.name || 'Component'\n  })`;\n\n  return WithErrorBoundary;\n}\n\nexport default A2UIErrorBoundary;\n"],"names":["A2UIErrorBoundary","props","_this","_classCallCheck","_callSuper","state","hasError","error","_inherits","_Component","_createClass","key","value","componentDidCatch","errorInfo","_this$props","componentType","componentId","onError","console","message","stack","componentStack","render","_this$state","_this$props2","children","fallback","_this$props2$showErro","showError","React","createElement","Fragment","className","style","padding","backgroundColor","border","borderRadius","color","fontSize","fontWeight","marginBottom","concat","wordBreak","getDerivedStateFromError","Component","withA2UIErrorBoundary","WrappedComponent","options","arguments","length","undefined","WithErrorBoundary","_objectSpread","displayName","name"],"mappings":";;;;;;;;;;;;;;;;;;AAmCaA,IAAAA;EACX,SAAAA,iBAAAA,CAAYC,KAA+B,EAAA;AAAA,IAAA,IAAAC,KAAA,CAAA;AAAAC,IAAAA,eAAA,OAAAH,iBAAA,CAAA,CAAA;AACzCE,IAAAA,KAAA,GAAAE,UAAA,CAAAJ,IAAAA,EAAAA,iBAAA,GAAMC,KAAK,CAAA,CAAA,CAAA;IACXC,KAAA,CAAKG,KAAQ,GAAA;AAAEC,MAAAA,QAAU,EAAA,KAAA;AAAOC,MAAAA,OAAO,IAAA;KAAK,CAAA;AAAA,IAAA,OAAAL,KAAA,CAAA;AAC9C,GAAA;EAAAM,SAAA,CAAAR,iBAAA,EAAAS,UAAA,CAAA,CAAA;EAAA,OAAAC,YAAA,CAAAV,iBAAA,EAAA,CAAA;IAAAW,GAAA,EAAA,mBAAA;AAAAC,IAAAA,KAAA,EAMA,SAAAC,iBAAAA,CAAkBN,OAAcO,SAA4B,EAAA;AAC1D,MAAA,IAAAC,WAAA,GAAgD,IAAK,CAAAd,KAAA;QAA7Ce,aAAA,GAAAD,WAAA,CAAAC,aAAA;QAAeC,WAAa,GAAAF,WAAA,CAAbE,WAAa;QAAAC,OAAA,GAAAH,WAAA,CAAAG,OAAA,CAAA;MAG5BC,OAAA,CAAAZ,KAAA,CAEN,+BAAA,EAAA;AACES,QAAAA,aAAA,EAAAA,aAAA;AACAC,QAAAA,WAAA,EAAAA,WAAA;QACAV,OAAOA,KAAM,CAAAa,OAAA;QACbC,OAAOd,KAAM,CAAAc,KAAA;QACbC,gBAAgBR,SAAU,CAAAQ,cAAAA;AAC5B,OACF,CAAA,CAAA;MAGUJ,OAAA,KAAA,IAAA,IAAAA,OAAA,KAAA,KAAA,CAAA,IAAAA,OAAA,CAAAX,KAAA,EAAOS,eAAeC,WAAW,CAAA,CAAA;AAC7C,KAAA;AAAA,GAAA,EAAA;IAAAN,GAAA,EAAA,QAAA;AAAAC,IAAAA,KAAA,EAEA,SAAAW,MAASA,GAAA;AACP,MAAA,IAAAC,WAAA,GAA4B,IAAK,CAAAnB,KAAA;QAAzBC,QAAA,GAAAkB,WAAA,CAAAlB,QAAA;QAAUC,KAAM,GAAAiB,WAAA,CAANjB,KAAM,CAAA;AACxB,MAAA,IAAAkB,YAAA,GAAiE,IAAK,CAAAxB,KAAA;QAA9DyB,QAAU,GAAAD,YAAA,CAAVC,QAAU;QAAAC,QAAA,GAAAF,YAAA,CAAAE,QAAA;QAAAC,qBAAA,GAAAH,YAAA,CAAUI;AAAAA,QAAAA,sCAAY,KAAA,CAAA,GAAA,KAAO,GAAAD,qBAAA;QAAAZ,aAAA,GAAAS,YAAA,CAAAT,aAAA,CAAA;AAE/C,MAAA,IAAIV,QAAU,EAAA;AAEZ,QAAA,IAAIqB,QAAU,EAAA;AACR,UAAA,IAAA,OAAOA,aAAa,UAAY,EAAA;AAClC,YAAA,sBAAUG,cAAA,CAAAC,aAAA,CAAAD,cAAA,CAAAE,QAAA,EAAA,IAAA,EAAAL,QAAA,CAASpB,KAAQ,EAAAS,aAAa,CAAE,CAAA,CAAA;AAC5C,WAAA;AACA,UAAA,kFAAUW,QAAS,CAAA,CAAA;AACrB,SAAA;AAGA,QAAA,IAAIE,SAAW,EAAA;AACb,UAAA,sBACGC,cAAA,CAAAC,aAAA,CAAA,KAAA,EAAA;AACCE,YAAAA,SAAU,EAAA,qBAAA;AACVC,YAAAA,KAAO,EAAA;AACLC,cAAAA,OAAS,EAAA,UAAA;AACTC,cAAAA,eAAiB,EAAA,wBAAA;AACjBC,cAAAA,MAAQ,EAAA,kCAAA;AACRC,cAAAA,YAAc,EAAA,KAAA;AACdC,cAAAA,KAAO,EAAA,SAAA;AACPC,cAAAA,QAAU,EAAA,MAAA;AACZ,aAAA;AAAA,WAAA,iBAECV,cAAA,CAAAC,aAAA,CAAA,KAAA,EAAA;AAAIG,YAAAA,KAAO,EAAA;AAAEO,cAAAA,UAAY,EAAA,GAAA;AAAKC,cAAAA,cAAc,KAAA;AAAM,aAAA;AAAA,WAAA,EAAG,yCAC5C1B,aAAgB,GAAA2B,GAAAA,CAAAA,MAAA,CAAI3B,aAAmB,EAAA,GAAA,CAAA,GAAA,EACjD,kBACCc,cAAA,CAAAC,aAAA,CAAA,KAAA,EAAA;AAAIG,YAAAA,KAAO,EAAA;AAAEK,cAAAA,KAAO,EAAA,MAAA;AAAQK,cAAAA,WAAW,WAAA;AAAY,aAAA;AACjD,WAAA,EAAA,CAAArC,KAAA,KAAA,IAAA,IAAAA,KAAA,KAAA,KAAA,CAAA,GAAA,KAAA,CAAA,GAAAA,KAAA,CAAOa,OAAW,KAAA,0BACrB,CACF,CAAA,CAAA;AAEJ,SAAA;AAGO,QAAA,OAAA,IAAA,CAAA;AACT,OAAA;AAEO,MAAA,OAAAM,QAAA,CAAA;AACT,KAAA;AAAA,GAAA,CAAA,EAAA,CAAA;IAAAf,GAAA,EAAA,0BAAA;AAAAC,IAAAA,KAAA,EAjEA,SAAOiC,yBAAyBtC,KAAsC,EAAA;MAC7D,OAAA;AAAED,QAAAA,QAAU,EAAA,IAAA;AAAMC,QAAAA,KAAM,EAANA,KAAAA;OAAM,CAAA;AACjC,KAAA;AAAA,GAAA,CAAA,CAAA,CAAA;AAAA,CAAA,CARqCuC,SAA0D,EAAA;AA6E1F,SAASC,qBACdA,CAAAC,gBAAA,EAEa;AAAA,EAAA,IADbC,OAAoD,GAAAC,SAAA,CAAAC,MAAA,GAAA,CAAA,IAAAD,SAAA,CAAA,CAAA,CAAA,KAAAE,SAAA,GAAAF,SAAA,CAAA,CAAA,CAAA,GAAA,EACvC,CAAA;AACP,EAAA,IAAAG,iBAAA,GAAiC,SAAjCA,iBAAAA,CAAkCpD,KAAA,EAAA;IAAA,sBACrC6B,cAAA,CAAAC,aAAA,CAAA/B,iBAAA,EAAAsD,aAAA,CAAA,EAAA,EAAsBL,OAAA,CAAA,iBACpBnB,cAAA,CAAAC,aAAA,CAAAiB,gBAAA,EAAAM,aAAA,CAAqBrD,EAAAA,EAAAA,KAAA,CAAO,CAC/B,CAAA,CAAA;AAAA,GAAA,CAAA;AAGFoD,EAAAA,iBAAA,CAAkBE,WAAc,GAAAZ,wBAAAA,CAAAA,MAAA,CAC9BK,gBAAiB,CAAAO,WAAA,IAAeP,iBAAiBQ,IAAQ,IAAA,WAAA,EAAA,GAAA,CAAA,CAAA;AAGpD,EAAA,OAAAH,iBAAA,CAAA;AACT;;;;"}

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

@@ -0,0 +1,60 @@
+/**
+ * A2UI Skeleton 组件
+ * 在组件树渲染前显示骨架屏占位
+ */
+import React from 'react';
+import type { A2UIComponent } from '../../core/a2ui';
+export interface A2UISkeletonProps {
+    /** 组件定义（可选，用于推断骨架形状） */
+    component?: A2UIComponent | null;
+    /** 是否显示动画 */
+    animation?: 'gradient' | 'flashed' | 'none';
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: React.CSSProperties;
+}
+/**
+ * A2UI Skeleton 占位组件
+ *
+ * 用法1: 简单骨架
+ * ```tsx
+ * <A2UISkeleton />
+ * ```
+ *
+ * 用法2: 根据组件类型显示对应骨架
+ * ```tsx
+ * <A2UISkeleton component={surface.root} />
+ * ```
+ */
+export declare const A2UISkeleton: React.FC<A2UISkeletonProps>;
+/**
+ * A2UI Surface 骨架屏
+ * 适用于整个 Surface 加载时的占位
+ */
+export interface A2UISurfaceSkeletonProps {
+    /** 骨架布局类型 */
+    layout?: 'form' | 'card' | 'list' | 'simple' | 'wizard';
+    /** 是否显示动画 */
+    animation?: 'gradient' | 'flashed' | 'none';
+    /** 行数（list 布局时生效） */
+    rowCount?: number;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: React.CSSProperties;
+}
+/**
+ * A2UI Surface 骨架屏
+ *
+ * 用法:
+ * ```tsx
+ * <A2UISurfaceRenderer
+ *   processor={processor}
+ *   surfaceId="my-surface"
+ *   loading={<A2UISurfaceSkeleton layout="form" />}
+ * />
+ * ```
+ */
+export declare const A2UISurfaceSkeleton: React.FC<A2UISurfaceSkeletonProps>;
+export default A2UISkeleton;

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

@@ -0,0 +1,197 @@
+/**
+ * tdesign v1.0.2-alpha.14
+ * (c) 2026 tdesign
+ * @license MIT
+ */
+
+import React__default from 'react';
+import { Skeleton } from 'tdesign-react';
+
+var getRowColByType = function getRowColByType(componentType) {
+  switch (componentType) {
+    case "Text":
+      return [1];
+    case "Button":
+      return [{
+        width: "80px",
+        height: "32px"
+      }];
+    case "Input":
+      return [{
+        width: "100%",
+        height: "32px"
+      }];
+    case "RadioGroup":
+    case "CheckboxGroup":
+      return [[{
+        type: "rect",
+        width: "80px",
+        height: "22px"
+      }, {
+        type: "rect",
+        width: "80px",
+        height: "22px"
+      }, {
+        type: "rect",
+        width: "80px",
+        height: "22px"
+      }]];
+    case "Row":
+      return [[{
+        type: "rect",
+        width: "100px",
+        height: "32px"
+      }, {
+        type: "rect",
+        width: "100px",
+        height: "32px"
+      }]];
+    case "Column":
+      return [{
+        width: "100%",
+        height: "20px"
+      }, {
+        width: "80%",
+        height: "20px"
+      }];
+    case "Card":
+      return [{
+        type: "rect",
+        height: "30px",
+        width: "100%"
+      }, {
+        type: "rect",
+        height: "100px",
+        width: "100%"
+      }];
+    default:
+      return [1];
+  }
+};
+var A2UISkeleton = function A2UISkeleton(_ref) {
+  var component = _ref.component,
+    _ref$animation = _ref.animation,
+    animation = _ref$animation === void 0 ? "gradient" : _ref$animation,
+    className = _ref.className,
+    style = _ref.style;
+  var animationProp = animation === "none" ? "none" : animation;
+  var rowCol = getRowColByType(component === null || component === void 0 ? void 0 : component.component);
+  return /* @__PURE__ */React__default.createElement("div", {
+    className: className,
+    style: style
+  }, /* @__PURE__ */React__default.createElement(Skeleton, {
+    animation: animationProp,
+    rowCol: rowCol
+  }));
+};
+A2UISkeleton.displayName = "A2UISkeleton";
+var getRowColByLayout = function getRowColByLayout(layout, rowCount) {
+  switch (layout) {
+    case "form":
+      return [{
+        width: "200px",
+        height: "28px"
+      }, {
+        width: "80px",
+        height: "16px"
+      }, {
+        width: "100%",
+        height: "32px"
+      }, {
+        width: "80px",
+        height: "16px"
+      }, {
+        width: "100%",
+        height: "32px"
+      }, [{
+        type: "rect",
+        width: "80px",
+        height: "32px"
+      }, {
+        type: "rect",
+        width: "80px",
+        height: "32px"
+      }]];
+    case "card":
+      return [{
+        type: "rect",
+        height: "30px",
+        width: "100%"
+      }, {
+        type: "rect",
+        height: "200px",
+        width: "100%"
+      }];
+    case "list":
+      return Array.from({
+        length: rowCount
+      }, function (_, i) {
+        return {
+          width: "".concat(100 - i * 10, "%"),
+          height: "20px"
+        };
+      });
+    case "wizard":
+      return [[{
+        type: "circle",
+        size: "32px"
+      }, {
+        type: "rect",
+        width: "60px",
+        height: "4px"
+      }, {
+        type: "circle",
+        size: "32px"
+      }, {
+        type: "rect",
+        width: "60px",
+        height: "4px"
+      }, {
+        type: "circle",
+        size: "32px"
+      }], {
+        width: "180px",
+        height: "24px"
+      }, {
+        width: "100%",
+        height: "40px"
+      }, {
+        width: "100%",
+        height: "40px"
+      }, [{
+        type: "rect",
+        width: "80px",
+        height: "32px"
+      }, {
+        type: "rect",
+        width: "80px",
+        height: "32px"
+      }]];
+    case "simple":
+    default:
+      return [1];
+  }
+};
+var A2UISurfaceSkeleton = function A2UISurfaceSkeleton(_ref2) {
+  var _ref2$layout = _ref2.layout,
+    layout = _ref2$layout === void 0 ? "simple" : _ref2$layout,
+    _ref2$animation = _ref2.animation,
+    animation = _ref2$animation === void 0 ? "gradient" : _ref2$animation,
+    _ref2$rowCount = _ref2.rowCount,
+    rowCount = _ref2$rowCount === void 0 ? 3 : _ref2$rowCount,
+    className = _ref2.className,
+    style = _ref2.style;
+  var animationProp = animation === "none" ? "none" : animation;
+  var rowCol = getRowColByLayout(layout, rowCount);
+  return /* @__PURE__ */React__default.createElement("div", {
+    className: className,
+    style: style
+  }, /* @__PURE__ */React__default.createElement(Skeleton, {
+    animation: animationProp,
+    rowCol: rowCol
+  }));
+};
+A2UISurfaceSkeleton.displayName = "A2UISurfaceSkeleton";
+
+export { A2UISkeleton, A2UISurfaceSkeleton, A2UISkeleton as default };
+//# sourceMappingURL=A2UISkeleton.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"A2UISkeleton.js","sources":["../../../../../pro-components/chat/chat-engine/components/a2ui/A2UISkeleton.tsx"],"sourcesContent":["/**\n * A2UI Skeleton 组件\n * 在组件树渲染前显示骨架屏占位\n */\n\nimport React from 'react';\nimport { Skeleton } from 'tdesign-react';\nimport type { A2UIComponent } from '../../core/a2ui';\n\nexport interface A2UISkeletonProps {\n  /** 组件定义（可选，用于推断骨架形状） */\n  component?: A2UIComponent | null;\n  /** 是否显示动画 */\n  animation?: 'gradient' | 'flashed' | 'none';\n  /** 自定义类名 */\n  className?: string;\n  /** 自定义样式 */\n  style?: React.CSSProperties;\n}\n\n/**\n * 根据组件类型生成对应的 Skeleton rowCol\n */\nconst getRowColByType = (componentType?: string): Array<number | object | object[]> => {\n  switch (componentType) {\n    case 'Text':\n      return [1];\n\n    case 'Button':\n      return [{ width: '80px', height: '32px' }];\n\n    case 'Input':\n      return [{ width: '100%', height: '32px' }];\n\n    case 'RadioGroup':\n    case 'CheckboxGroup':\n      return [[\n        { type: 'rect' as const, width: '80px', height: '22px' },\n        { type: 'rect' as const, width: '80px', height: '22px' },\n        { type: 'rect' as const, width: '80px', height: '22px' },\n      ]];\n\n    case 'Row':\n      return [[\n        { type: 'rect' as const, width: '100px', height: '32px' },\n        { type: 'rect' as const, width: '100px', height: '32px' },\n      ]];\n\n    case 'Column':\n      return [\n        { width: '100%', height: '20px' },\n        { width: '80%', height: '20px' },\n      ];\n\n    case 'Card':\n      return [\n        { type: 'rect' as const, height: '30px', width: '100%' },\n        { type: 'rect' as const, height: '100px', width: '100%' },\n      ];\n\n    default:\n      return [1];\n  }\n};\n\n/**\n * A2UI Skeleton 占位组件\n * \n * 用法1: 简单骨架\n * ```tsx\n * <A2UISkeleton />\n * ```\n * \n * 用法2: 根据组件类型显示对应骨架\n * ```tsx\n * <A2UISkeleton component={surface.root} />\n * ```\n */\nexport const A2UISkeleton: React.FC<A2UISkeletonProps> = ({\n  component,\n  animation = 'gradient',\n  className,\n  style,\n}) => {\n  const animationProp = animation === 'none' ? 'none' : animation;\n  const rowCol = getRowColByType(component?.component);\n\n  return (\n    <div className={className} style={style}>\n      <Skeleton animation={animationProp} rowCol={rowCol} />\n    </div>\n  );\n};\n\nA2UISkeleton.displayName = 'A2UISkeleton';\n\n/**\n * A2UI Surface 骨架屏\n * 适用于整个 Surface 加载时的占位\n */\nexport interface A2UISurfaceSkeletonProps {\n  /** 骨架布局类型 */\n  layout?: 'form' | 'card' | 'list' | 'simple' | 'wizard';\n  /** 是否显示动画 */\n  animation?: 'gradient' | 'flashed' | 'none';\n  /** 行数（list 布局时生效） */\n  rowCount?: number;\n  /** 自定义类名 */\n  className?: string;\n  /** 自定义样式 */\n  style?: React.CSSProperties;\n}\n\n/**\n * 根据布局类型获取 rowCol 配置\n */\nconst getRowColByLayout = (\n  layout: string,\n  rowCount: number\n): Array<number | object | object[]> => {\n  switch (layout) {\n    case 'form':\n      return [\n        // 标题\n        { width: '200px', height: '28px' },\n        // 表单项 1\n        { width: '80px', height: '16px' },\n        { width: '100%', height: '32px' },\n        // 表单项 2\n        { width: '80px', height: '16px' },\n        { width: '100%', height: '32px' },\n        // 按钮\n        [\n          { type: 'rect' as const, width: '80px', height: '32px' },\n          { type: 'rect' as const, width: '80px', height: '32px' },\n        ],\n      ];\n\n    case 'card':\n      return [\n        { type: 'rect' as const, height: '30px', width: '100%' },\n        { type: 'rect' as const, height: '200px', width: '100%' },\n      ];\n\n    case 'list':\n      return Array.from({ length: rowCount }, (_, i) => ({\n        width: `${100 - i * 10}%`,\n        height: '20px',\n      }));\n\n    case 'wizard':\n      return [\n        // 步骤指示器\n        [\n          { type: 'circle' as const, size: '32px' },\n          { type: 'rect' as const, width: '60px', height: '4px' },\n          { type: 'circle' as const, size: '32px' },\n          { type: 'rect' as const, width: '60px', height: '4px' },\n          { type: 'circle' as const, size: '32px' },\n        ],\n        // 标题\n        { width: '180px', height: '24px' },\n        // 内容\n        { width: '100%', height: '40px' },\n        { width: '100%', height: '40px' },\n        // 按钮\n        [\n          { type: 'rect' as const, width: '80px', height: '32px' },\n          { type: 'rect' as const, width: '80px', height: '32px' },\n        ],\n      ];\n\n    case 'simple':\n    default:\n      return [1];\n  }\n};\n\n/**\n * A2UI Surface 骨架屏\n * \n * 用法:\n * ```tsx\n * <A2UISurfaceRenderer\n *   processor={processor}\n *   surfaceId=\"my-surface\"\n *   loading={<A2UISurfaceSkeleton layout=\"form\" />}\n * />\n * ```\n */\nexport const A2UISurfaceSkeleton: React.FC<A2UISurfaceSkeletonProps> = ({\n  layout = 'simple',\n  animation = 'gradient',\n  rowCount = 3,\n  className,\n  style,\n}) => {\n  const animationProp = animation === 'none' ? 'none' : animation;\n  const rowCol = getRowColByLayout(layout, rowCount);\n\n  return (\n    <div className={className} style={style}>\n      <Skeleton animation={animationProp} rowCol={rowCol} />\n    </div>\n  );\n};\n\nA2UISurfaceSkeleton.displayName = 'A2UISurfaceSkeleton';\n\nexport default A2UISkeleton;\n"],"names":["getRowColByType","componentType","width","height","type","A2UISkeleton","component","_ref","_ref$animation","animation","className","style","animationProp","rowCol","React","createElement","Skeleton","displayName","getRowColByLayout","layout","rowCount","Array","from","length","_","i","concat","size","A2UISurfaceSkeleton","_ref2$layout","_ref2","_ref2$animation","_ref2$rowCount"],"mappings":"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"}

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

@@ -0,0 +1,44 @@
+/**
+ * A2UI Surface 渲染器
+ * 渲染单个 Surface 的入口组件
+ */
+import React from 'react';
+import { type ComponentRegistry } from '../../hooks/a2ui/A2UIContext';
+import type { A2uiMessageProcessor } from '../../core/a2ui';
+import type { ActionHandler } from '../../core/a2ui';
+export interface A2UISurfaceRendererProps {
+    /** A2UI 消息处理器 */
+    processor: A2uiMessageProcessor;
+    /** Surface ID */
+    surfaceId: string;
+    /** 自定义组件注册表（可选，不传使用默认注册表） */
+    registry?: ComponentRegistry;
+    /** Action 处理回调 */
+    onAction?: ActionHandler;
+    /** 自定义类名 */
+    className?: string;
+    /** 自定义样式 */
+    style?: React.CSSProperties;
+    /**
+     * 加载中占位
+     * - 传入 ReactNode：使用自定义骨架屏
+     * - 传入 true：使用服务端 skeletonHint 或默认骨架屏
+     */
+    loading?: React.ReactNode | boolean;
+    /** Surface 不存在时的占位 */
+    fallback?: React.ReactNode;
+}
+/**
+ * A2UI Surface 渲染器
+ *
+ * 使用方式：
+ * ```tsx
+ * <A2UISurfaceRenderer
+ *   processor={processor}
+ *   surfaceId="confirm-form"
+ *   onAction={handleAction}
+ * />
+ * ```
+ */
+export declare const A2UISurfaceRenderer: React.FC<A2UISurfaceRendererProps>;
+export default A2UISurfaceRenderer;

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

@@ -0,0 +1,139 @@
+/**
+ * tdesign v1.0.2-alpha.14
+ * (c) 2026 tdesign
+ * @license MIT
+ */
+
+import _defineProperty from '@babel/runtime/helpers/defineProperty';
+import React__default, { useMemo, useCallback } from 'react';
+import { A2UIRootProvider } from '../../hooks/a2ui/A2UIContext.js';
+import { useA2UISurface } from '../../hooks/a2ui/useA2UISurface.js';
+import { A2UIComponentRenderer } from './A2UIComponentRenderer.js';
+import { A2UISurfaceSkeleton } from './A2UISkeleton.js';
+import { defaultComponentRegistry } from './registry.js';
+import './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';
+import 'tdesign-react';
+import './primitives/A2UIText.js';
+import 'classnames';
+import '../../hooks/a2ui/useDataBinding.js';
+import '@babel/runtime/helpers/slicedToArray';
+import '../../core/a2ui/utils/index.js';
+import '../../core/a2ui/utils/binding.js';
+import '@babel/runtime/helpers/typeof';
+import '../../core/a2ui/utils/validation.js';
+import '@babel/runtime/helpers/toConsumableArray';
+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 _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 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 renderSkeleton = function renderSkeleton(hint) {
+  return /* @__PURE__ */React__default.createElement(A2UISurfaceSkeleton, {
+    layout: (hint === null || hint === void 0 ? void 0 : hint.layout) || "simple",
+    rowCount: hint === null || hint === void 0 ? void 0 : hint.rowCount,
+    animation: (hint === null || hint === void 0 ? void 0 : hint.animation) || "gradient"
+  });
+};
+var A2UISurfaceRenderer = function A2UISurfaceRenderer(_ref) {
+  var processor = _ref.processor,
+    surfaceId = _ref.surfaceId,
+    registry = _ref.registry,
+    onAction = _ref.onAction,
+    className = _ref.className,
+    style = _ref.style,
+    _ref$loading = _ref.loading,
+    loading = _ref$loading === void 0 ? null : _ref$loading,
+    _ref$fallback = _ref.fallback,
+    fallback = _ref$fallback === void 0 ? null : _ref$fallback;
+  var surface = useA2UISurface(processor, surfaceId);
+  var mergedRegistry = useMemo(function () {
+    return _objectSpread(_objectSpread({}, defaultComponentRegistry), registry);
+  }, [registry]);
+  var wrappedOnAction = useCallback(function (action) {
+    if (!onAction) return;
+    var context = {
+      surfaceId: surfaceId,
+      updateData: function updateData(path, value) {
+        processor.updateDataValue(surfaceId, path, value);
+      },
+      getData: function getData(path) {
+        var _processor$getSurface;
+        var data = (_processor$getSurface = processor.getSurface(surfaceId)) === null || _processor$getSurface === void 0 ? void 0 : _processor$getSurface.data;
+        if (!path) return data;
+        var segments = path.split("/").filter(Boolean);
+        var result = data;
+        var _iterator = _createForOfIteratorHelper(segments),
+          _step;
+        try {
+          for (_iterator.s(); !(_step = _iterator.n()).done;) {
+            var segment = _step.value;
+            if (result === null || result === void 0) return void 0;
+            result = result[segment];
+          }
+        } catch (err) {
+          _iterator.e(err);
+        } finally {
+          _iterator.f();
+        }
+        return result;
+      }
+    };
+    onAction(action, context);
+  }, [onAction, processor, surfaceId]);
+  if (!surface) {
+    return /* @__PURE__ */React__default.createElement(React__default.Fragment, null, fallback);
+  }
+  if (surface.state === "pending") {
+    if (loading === true) {
+      return /* @__PURE__ */React__default.createElement(React__default.Fragment, null, renderSkeleton(surface.skeletonHint));
+    }
+    if (loading) {
+      return /* @__PURE__ */React__default.createElement(React__default.Fragment, null, loading);
+    }
+    return null;
+  }
+  if (surface.state === "closed") {
+    return null;
+  }
+  if (!surface.root) {
+    return null;
+  }
+  return /* @__PURE__ */React__default.createElement(A2UIRootProvider, {
+    processor: processor,
+    surfaceId: surfaceId,
+    registry: mergedRegistry,
+    onAction: wrappedOnAction
+  }, /* @__PURE__ */React__default.createElement("div", {
+    className: className,
+    style: style
+  }, /* @__PURE__ */React__default.createElement(A2UIComponentRenderer, {
+    component: surface.root
+  })));
+};
+A2UISurfaceRenderer.displayName = "A2UISurfaceRenderer";
+
+export { A2UISurfaceRenderer, A2UISurfaceRenderer as default };
+//# sourceMappingURL=A2UISurfaceRenderer.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"A2UISurfaceRenderer.js","sources":["../../../../../pro-components/chat/chat-engine/components/a2ui/A2UISurfaceRenderer.tsx"],"sourcesContent":["/**\n * A2UI Surface 渲染器\n * 渲染单个 Surface 的入口组件\n */\n\nimport React, { useCallback, useMemo } from 'react';\nimport { A2UIRootProvider, type ComponentRegistry } from '../../hooks/a2ui/A2UIContext';\nimport { useA2UISurface } from '../../hooks/a2ui/useA2UISurface';\nimport { A2UIComponentRenderer } from './A2UIComponentRenderer';\nimport { A2UISurfaceSkeleton } from './A2UISkeleton';\nimport { defaultComponentRegistry } from './registry';\nimport type { A2uiMessageProcessor } from '../../core/a2ui';\nimport type { ActionHandler, ActionContext, A2UIAction, SkeletonHint } from '../../core/a2ui';\n\nexport interface A2UISurfaceRendererProps {\n  /** A2UI 消息处理器 */\n  processor: A2uiMessageProcessor;\n  /** Surface ID */\n  surfaceId: string;\n  /** 自定义组件注册表（可选，不传使用默认注册表） */\n  registry?: ComponentRegistry;\n  /** Action 处理回调 */\n  onAction?: ActionHandler;\n  /** 自定义类名 */\n  className?: string;\n  /** 自定义样式 */\n  style?: React.CSSProperties;\n  /** \n   * 加载中占位\n   * - 传入 ReactNode：使用自定义骨架屏\n   * - 传入 true：使用服务端 skeletonHint 或默认骨架屏\n   */\n  loading?: React.ReactNode | boolean;\n  /** Surface 不存在时的占位 */\n  fallback?: React.ReactNode;\n}\n\n/**\n * 根据 skeletonHint 渲染骨架屏\n */\nconst renderSkeleton = (hint?: SkeletonHint): React.ReactNode => {\n  return (\n    <A2UISurfaceSkeleton\n      layout={hint?.layout || 'simple'}\n      rowCount={hint?.rowCount}\n      animation={hint?.animation || 'gradient'}\n    />\n  );\n};\n\n/**\n * A2UI Surface 渲染器\n * \n * 使用方式：\n * ```tsx\n * <A2UISurfaceRenderer\n *   processor={processor}\n *   surfaceId=\"confirm-form\"\n *   onAction={handleAction}\n * />\n * ```\n */\nexport const A2UISurfaceRenderer: React.FC<A2UISurfaceRendererProps> = ({\n  processor,\n  surfaceId,\n  registry,\n  onAction,\n  className,\n  style,\n  loading = null,\n  fallback = null,\n}) => {\n  // 订阅 Surface\n  const surface = useA2UISurface(processor, surfaceId);\n\n  // 合并默认注册表和自定义注册表\n  const mergedRegistry = useMemo<ComponentRegistry>(\n    () => ({\n      ...defaultComponentRegistry,\n      ...registry,\n    }),\n    [registry]\n  );\n\n  // 创建带 context 的 action handler\n  const wrappedOnAction = useCallback(\n    (action: A2UIAction) => {\n      if (!onAction) return;\n\n      // 创建 ActionContext，提供更新 UI 的能力\n      const context: ActionContext = {\n        surfaceId,\n        updateData: (path: string, value: unknown) => {\n          processor.updateDataValue(surfaceId, path, value);\n        },\n        getData: (path?: string) => {\n          const data = processor.getSurface(surfaceId)?.data;\n          if (!path) return data;\n          // 简单的 path 解析\n          const segments = path.split('/').filter(Boolean);\n          let result: unknown = data;\n          for (const segment of segments) {\n            if (result === null || result === undefined) return undefined;\n            result = (result as Record<string, unknown>)[segment];\n          }\n          return result;\n        },\n      };\n\n      onAction(action, context);\n    },\n    [onAction, processor, surfaceId]\n  );\n\n  // Surface 不存在\n  if (!surface) {\n    return <>{fallback}</>;\n  }\n\n  // Surface 正在加载（pending 状态）\n  if (surface.state === 'pending') {\n    // 优先级：自定义 loading > skeletonHint > 默认骨架屏\n    if (loading === true) {\n      // loading=true 时，使用服务端 skeletonHint 或默认骨架屏\n      return <>{renderSkeleton(surface.skeletonHint)}</>;\n    }\n    if (loading) {\n      // 自定义 loading 组件\n      return <>{loading}</>;\n    }\n    // 无 loading 配置，不显示占位\n    return null;\n  }\n\n  // Surface 已关闭\n  if (surface.state === 'closed') {\n    return null;\n  }\n\n  // 没有根组件\n  if (!surface.root) {\n    return null;\n  }\n\n  return (\n    <A2UIRootProvider\n      processor={processor}\n      surfaceId={surfaceId}\n      registry={mergedRegistry}\n      onAction={wrappedOnAction}\n    >\n      <div className={className} style={style}>\n        <A2UIComponentRenderer component={surface.root} />\n      </div>\n    </A2UIRootProvider>\n  );\n};\n\nA2UISurfaceRenderer.displayName = 'A2UISurfaceRenderer';\n\nexport default A2UISurfaceRenderer;\n"],"names":["renderSkeleton","hint","React","createElement","A2UISurfaceSkeleton","layout","rowCount","animation","A2UISurfaceRenderer","processor","_ref","surfaceId","registry","onAction","className","style","_ref$loading","loading","_ref$fallback","fallback","surface","useA2UISurface","mergedRegistry","useMemo","_objectSpread","defaultComponentRegistry","wrappedOnAction","useCallback","action","context","updateData","path","value","updateDataValue","getData","_processor$getSurface","data","getSurface","segments","split","filter","Boolean","result","_iterator","_createForOfIteratorHelper","_step","s","n","done","segment","err","e","f","state","Fragment","skeletonHint","root","A2UIRootProvider","A2UIComponentRenderer","component","displayName"],"mappings":"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"}

package/es/chat-engine/components/a2ui/containers/A2UICard.d.ts

@@ -0,0 +1,22 @@
+/**
+ * A2UI Card 容器组件
+ * 复用 TDesign Card，支持 A2UI v0.9 child 模式
+ */
+import React from 'react';
+import type { A2UICardComponent, ResolvedComponent } from '../../../core/a2ui';
+export interface A2UICardProps extends Omit<A2UICardComponent, 'component'> {
+    /** 解析后的子组件（由 ComponentRenderer 传入） */
+    resolvedChildren?: ResolvedComponent[];
+    className?: string;
+    style?: React.CSSProperties;
+    /** TDesign 扩展属性 */
+    subtitle?: string;
+    description?: string;
+    hoverShadow?: boolean;
+    size?: 'medium' | 'small';
+    headerBordered?: boolean;
+    /** 向后兼容：children 数组 */
+    children?: any[];
+}
+export declare const A2UICard: React.FC<A2UICardProps>;
+export default A2UICard;