@tdesign-react/chat 1.0.2-alpha.10 → 1.0.2-alpha.12

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

@@ -0,0 +1,116 @@
+/**
+ * tdesign v1.0.2-alpha.11
+ * (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;

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

@@ -0,0 +1,113 @@
+/**
+ * tdesign v1.0.2-alpha.11
+ * (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":"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"}

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.11
+ * (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;