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

package/es/chat-engine/core/utils/performance.d.ts

@@ -0,0 +1,94 @@
+/**
+ * json-render 性能监控和优化工具（框架无关）
+ */
+import type { PerformanceMetrics, PerformanceThresholds } from '../adapters/json-render/types/core';
+/**
+ * 性能监控器
+ * 框架无关，可在任何 JavaScript 环境中使用
+ */
+export declare class PerformanceMonitor {
+    private metrics;
+    private maxMetricsCount;
+    /**
+     * 开始性能测量
+     */
+    start(): (elementCount: number, deltaInfo?: {
+        fromIndex: number;
+        toIndex: number;
+    }) => PerformanceMetrics;
+    /**
+     * 测量更新性能
+     */
+    measureUpdate<T>(fn: () => T): {
+        result: T;
+        metric: PerformanceMetrics;
+    };
+    /**
+     * 获取内存使用情况（MB）
+     */
+    private getMemoryUsage;
+    /**
+     * 添加性能指标
+     */
+    private addMetric;
+    /**
+     * 获取所有指标
+     */
+    getMetrics(): PerformanceMetrics[];
+    /**
+     * 获取平均渲染时间
+     */
+    getAverageRenderTime(): number;
+    /**
+     * 获取平均更新时间
+     */
+    getAverageUpdateTime(): number;
+    /**
+     * 获取最近 N 次操作的平均时间
+     */
+    getRecentAverageTime(count?: number, type?: 'render' | 'update'): number;
+    /**
+     * 获取性能统计摘要
+     */
+    getSummary(): {
+        totalOperations: number;
+        renderOperations: number;
+        updateOperations: number;
+        avgRenderTime: number;
+        avgUpdateTime: number;
+        recentAvgRenderTime: number;
+        recentAvgUpdateTime: number;
+        avgMemoryUsage: number;
+    };
+    /**
+     * 获取平均内存使用
+     */
+    private getAverageMemoryUsage;
+    /**
+     * 重置所有指标
+     */
+    reset(): void;
+    /**
+     * 打印性能摘要
+     */
+    printSummary(): void;
+}
+/**
+ * 全局性能监控实例
+ */
+export declare const globalPerformanceMonitor: PerformanceMonitor;
+/**
+ * 性能警告阈值（ms）
+ */
+export declare const PERFORMANCE_THRESHOLDS: PerformanceThresholds;
+/**
+ * 检查性能并发出警告
+ */
+export declare function checkPerformance(metric: PerformanceMetrics, thresholds?: PerformanceThresholds): void;
+declare const _default: {
+    PerformanceMonitor: typeof PerformanceMonitor;
+    globalPerformanceMonitor: PerformanceMonitor;
+    checkPerformance: typeof checkPerformance;
+    PERFORMANCE_THRESHOLDS: PerformanceThresholds;
+};
+export default _default;

package/es/chat-engine/core/utils/performance.js

@@ -0,0 +1,205 @@
+/**
+ * tdesign v1.1.0-alpha.11
+ * (c) 2026 tdesign
+ * @license MIT
+ */
+
+import _toConsumableArray from '@babel/runtime/helpers/toConsumableArray';
+import _classCallCheck from '@babel/runtime/helpers/classCallCheck';
+import _createClass from '@babel/runtime/helpers/createClass';
+import _defineProperty from '@babel/runtime/helpers/defineProperty';
+
+var PerformanceMonitor = /*#__PURE__*/function () {
+  function PerformanceMonitor() {
+    _classCallCheck(this, PerformanceMonitor);
+    _defineProperty(this, "metrics", []);
+    _defineProperty(this, "maxMetricsCount", 100);
+  }
+  return _createClass(PerformanceMonitor, [{
+    key: "start",
+    value: function start() {
+      var _this = this;
+      var startTime = performance.now();
+      return function (elementCount) {
+        var endTime = performance.now();
+        var renderTime = endTime - startTime;
+        var metric = {
+          renderTime: renderTime,
+          updateTime: 0,
+          memoryUsage: _this.getMemoryUsage(),
+          componentCount: elementCount,
+          timestamp: Date.now()
+        };
+        _this.addMetric(metric);
+        return metric;
+      };
+    }
+  }, {
+    key: "measureUpdate",
+    value: function measureUpdate(fn) {
+      var startTime = performance.now();
+      var result = fn();
+      var endTime = performance.now();
+      var updateTime = endTime - startTime;
+      var metric = {
+        renderTime: 0,
+        updateTime: updateTime,
+        memoryUsage: this.getMemoryUsage(),
+        componentCount: 0,
+        timestamp: Date.now()
+      };
+      this.addMetric(metric);
+      return {
+        result: result,
+        metric: metric
+      };
+    }
+  }, {
+    key: "getMemoryUsage",
+    value: function getMemoryUsage() {
+      if (typeof performance !== "undefined" && "memory" in performance) {
+        var _performance$memory;
+        return (((_performance$memory = performance.memory) === null || _performance$memory === void 0 ? void 0 : _performance$memory.usedJSHeapSize) || 0) / 1024 / 1024;
+      }
+      return 0;
+    }
+  }, {
+    key: "addMetric",
+    value: function addMetric(metric) {
+      this.metrics.push(metric);
+      if (this.metrics.length > this.maxMetricsCount) {
+        this.metrics.shift();
+      }
+    }
+  }, {
+    key: "getMetrics",
+    value: function getMetrics() {
+      return _toConsumableArray(this.metrics);
+    }
+  }, {
+    key: "getAverageRenderTime",
+    value: function getAverageRenderTime() {
+      var renderMetrics = this.metrics.filter(function (m) {
+        return m.renderTime > 0;
+      });
+      if (renderMetrics.length === 0) return 0;
+      var totalTime = renderMetrics.reduce(function (sum, m) {
+        return sum + m.renderTime;
+      }, 0);
+      return totalTime / renderMetrics.length;
+    }
+  }, {
+    key: "getAverageUpdateTime",
+    value: function getAverageUpdateTime() {
+      var updateMetrics = this.metrics.filter(function (m) {
+        return m.updateTime > 0;
+      });
+      if (updateMetrics.length === 0) return 0;
+      var totalTime = updateMetrics.reduce(function (sum, m) {
+        return sum + m.updateTime;
+      }, 0);
+      return totalTime / updateMetrics.length;
+    }
+  }, {
+    key: "getRecentAverageTime",
+    value: function getRecentAverageTime() {
+      var count = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : 10;
+      var type = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : "render";
+      var recentMetrics = this.metrics.slice(-count);
+      if (recentMetrics.length === 0) return 0;
+      var timeField = type === "render" ? "renderTime" : "updateTime";
+      var validMetrics = recentMetrics.filter(function (m) {
+        return m[timeField] > 0;
+      });
+      if (validMetrics.length === 0) return 0;
+      var totalTime = validMetrics.reduce(function (sum, m) {
+        return sum + m[timeField];
+      }, 0);
+      return totalTime / validMetrics.length;
+    }
+  }, {
+    key: "getSummary",
+    value: function getSummary() {
+      var renderMetrics = this.metrics.filter(function (m) {
+        return m.renderTime > 0;
+      });
+      var updateMetrics = this.metrics.filter(function (m) {
+        return m.updateTime > 0;
+      });
+      return {
+        totalOperations: this.metrics.length,
+        renderOperations: renderMetrics.length,
+        updateOperations: updateMetrics.length,
+        avgRenderTime: this.getAverageRenderTime(),
+        avgUpdateTime: this.getAverageUpdateTime(),
+        recentAvgRenderTime: this.getRecentAverageTime(10, "render"),
+        recentAvgUpdateTime: this.getRecentAverageTime(10, "update"),
+        avgMemoryUsage: this.getAverageMemoryUsage()
+      };
+    }
+  }, {
+    key: "getAverageMemoryUsage",
+    value: function getAverageMemoryUsage() {
+      if (this.metrics.length === 0) return 0;
+      var totalMemory = this.metrics.reduce(function (sum, m) {
+        return sum + m.memoryUsage;
+      }, 0);
+      return totalMemory / this.metrics.length;
+    }
+  }, {
+    key: "reset",
+    value: function reset() {
+      this.metrics = [];
+    }
+  }, {
+    key: "printSummary",
+    value: function printSummary() {
+      var summary = this.getSummary();
+      console.log("[json-render Performance Summary]", {
+        "\u603B\u64CD\u4F5C\u6B21\u6570": summary.totalOperations,
+        "\u6E32\u67D3\u64CD\u4F5C": summary.renderOperations,
+        "\u66F4\u65B0\u64CD\u4F5C": summary.updateOperations,
+        "\u5E73\u5747\u6E32\u67D3\u65F6\u95F4(ms)": summary.avgRenderTime.toFixed(2),
+        "\u5E73\u5747\u66F4\u65B0\u65F6\u95F4(ms)": summary.avgUpdateTime.toFixed(2),
+        "\u6700\u8FD110\u6B21\u6E32\u67D3\u65F6\u95F4(ms)": summary.recentAvgRenderTime.toFixed(2),
+        "\u6700\u8FD110\u6B21\u66F4\u65B0\u65F6\u95F4(ms)": summary.recentAvgUpdateTime.toFixed(2),
+        "\u5E73\u5747\u5185\u5B58\u4F7F\u7528(MB)": summary.avgMemoryUsage.toFixed(2)
+      });
+    }
+  }]);
+}();
+var globalPerformanceMonitor = new PerformanceMonitor();
+var PERFORMANCE_THRESHOLDS = {
+  renderTime: 50,
+  updateTime: 16,
+  memoryUsage: 100
+};
+function checkPerformance(metric) {
+  var thresholds = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : PERFORMANCE_THRESHOLDS;
+  if (metric.renderTime > thresholds.renderTime) {
+    console.warn("[json-render Performance Warning] \u6E32\u67D3\u8017\u65F6 ".concat(metric.renderTime.toFixed(2), "ms\uFF0C\u8D85\u8FC7\u9608\u503C ").concat(thresholds.renderTime, "ms"), {
+      componentCount: metric.componentCount,
+      memoryUsage: metric.memoryUsage.toFixed(2) + "MB"
+    });
+  }
+  if (metric.updateTime > thresholds.updateTime) {
+    console.warn("[json-render Performance Warning] \u66F4\u65B0\u8017\u65F6 ".concat(metric.updateTime.toFixed(2), "ms\uFF0C\u8D85\u8FC7\u9608\u503C ").concat(thresholds.updateTime, "ms"), {
+      componentCount: metric.componentCount,
+      memoryUsage: metric.memoryUsage.toFixed(2) + "MB"
+    });
+  }
+  if (metric.memoryUsage > thresholds.memoryUsage) {
+    console.warn("[json-render Performance Warning] \u5185\u5B58\u4F7F\u7528 ".concat(metric.memoryUsage.toFixed(2), "MB\uFF0C\u8D85\u8FC7\u9608\u503C ").concat(thresholds.memoryUsage, "MB"), {
+      componentCount: metric.componentCount
+    });
+  }
+}
+var performance$1 = {
+  PerformanceMonitor: PerformanceMonitor,
+  globalPerformanceMonitor: globalPerformanceMonitor,
+  checkPerformance: checkPerformance,
+  PERFORMANCE_THRESHOLDS: PERFORMANCE_THRESHOLDS
+};
+
+export { PERFORMANCE_THRESHOLDS, PerformanceMonitor, checkPerformance, performance$1 as default, globalPerformanceMonitor };
+//# sourceMappingURL=performance.js.map

package/es/chat-engine/core/utils/performance.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"performance.js","sources":["../../../../../pro-components/chat/chat-engine/core/utils/performance.ts"],"sourcesContent":["/**\n * json-render 性能监控和优化工具（框架无关）\n */\n\nimport type { PerformanceMetrics, PerformanceThresholds } from '../adapters/json-render/types/core';\n\n/**\n * 性能监控器\n * 框架无关，可在任何 JavaScript 环境中使用\n */\nexport class PerformanceMonitor {\n  private metrics: PerformanceMetrics[] = [];\n  private maxMetricsCount = 100; // 最多保留 100 条记录\n\n  /**\n   * 开始性能测量\n   */\n  start(): (elementCount: number, deltaInfo?: { fromIndex: number; toIndex: number }) => PerformanceMetrics {\n    const startTime = performance.now();\n    \n    return (\n      elementCount: number,\n    ): PerformanceMetrics => {\n      const endTime = performance.now();\n      const renderTime = endTime - startTime;\n\n      const metric: PerformanceMetrics = {\n        renderTime,\n        updateTime: 0, // 这里只测量渲染时间，更新时间由调用方设置\n        memoryUsage: this.getMemoryUsage(),\n        componentCount: elementCount,\n        timestamp: Date.now(),\n      };\n\n      this.addMetric(metric);\n      return metric;\n    };\n  }\n\n  /**\n   * 测量更新性能\n   */\n  measureUpdate<T>(fn: () => T): { result: T; metric: PerformanceMetrics } {\n    const startTime = performance.now();\n    const result = fn();\n    const endTime = performance.now();\n    const updateTime = endTime - startTime;\n\n    const metric: PerformanceMetrics = {\n      renderTime: 0,\n      updateTime,\n      memoryUsage: this.getMemoryUsage(),\n      componentCount: 0, // 更新操作不涉及组件数量\n      timestamp: Date.now(),\n    };\n\n    this.addMetric(metric);\n    return { result, metric };\n  }\n\n  /**\n   * 获取内存使用情况（MB）\n   */\n  private getMemoryUsage(): number {\n    if (typeof performance !== 'undefined' && 'memory' in performance) {\n      // @ts-ignore - performance.memory 在某些环境中可用\n      return (performance.memory?.usedJSHeapSize || 0) / 1024 / 1024;\n    }\n    return 0;\n  }\n\n  /**\n   * 添加性能指标\n   */\n  private addMetric(metric: PerformanceMetrics): void {\n    this.metrics.push(metric);\n\n    // 限制记录数量\n    if (this.metrics.length > this.maxMetricsCount) {\n      this.metrics.shift();\n    }\n  }\n\n  /**\n   * 获取所有指标\n   */\n  getMetrics(): PerformanceMetrics[] {\n    return [...this.metrics];\n  }\n\n  /**\n   * 获取平均渲染时间\n   */\n  getAverageRenderTime(): number {\n    const renderMetrics = this.metrics.filter(m => m.renderTime > 0);\n    if (renderMetrics.length === 0) return 0;\n\n    const totalTime = renderMetrics.reduce((sum, m) => sum + m.renderTime, 0);\n    return totalTime / renderMetrics.length;\n  }\n\n  /**\n   * 获取平均更新时间\n   */\n  getAverageUpdateTime(): number {\n    const updateMetrics = this.metrics.filter(m => m.updateTime > 0);\n    if (updateMetrics.length === 0) return 0;\n\n    const totalTime = updateMetrics.reduce((sum, m) => sum + m.updateTime, 0);\n    return totalTime / updateMetrics.length;\n  }\n\n  /**\n   * 获取最近 N 次操作的平均时间\n   */\n  getRecentAverageTime(count: number = 10, type: 'render' | 'update' = 'render'): number {\n    const recentMetrics = this.metrics.slice(-count);\n    if (recentMetrics.length === 0) return 0;\n\n    const timeField = type === 'render' ? 'renderTime' : 'updateTime';\n    const validMetrics = recentMetrics.filter(m => m[timeField] > 0);\n    if (validMetrics.length === 0) return 0;\n\n    const totalTime = validMetrics.reduce((sum, m) => sum + m[timeField], 0);\n    return totalTime / validMetrics.length;\n  }\n\n  /**\n   * 获取性能统计摘要\n   */\n  getSummary() {\n    const renderMetrics = this.metrics.filter(m => m.renderTime > 0);\n    const updateMetrics = this.metrics.filter(m => m.updateTime > 0);\n\n    return {\n      totalOperations: this.metrics.length,\n      renderOperations: renderMetrics.length,\n      updateOperations: updateMetrics.length,\n      avgRenderTime: this.getAverageRenderTime(),\n      avgUpdateTime: this.getAverageUpdateTime(),\n      recentAvgRenderTime: this.getRecentAverageTime(10, 'render'),\n      recentAvgUpdateTime: this.getRecentAverageTime(10, 'update'),\n      avgMemoryUsage: this.getAverageMemoryUsage(),\n    };\n  }\n\n  /**\n   * 获取平均内存使用\n   */\n  private getAverageMemoryUsage(): number {\n    if (this.metrics.length === 0) return 0;\n    const totalMemory = this.metrics.reduce((sum, m) => sum + m.memoryUsage, 0);\n    return totalMemory / this.metrics.length;\n  }\n\n  /**\n   * 重置所有指标\n   */\n  reset(): void {\n    this.metrics = [];\n  }\n\n  /**\n   * 打印性能摘要\n   */\n  printSummary(): void {\n    const summary = this.getSummary();\n    console.log('[json-render Performance Summary]', {\n      '总操作次数': summary.totalOperations,\n      '渲染操作': summary.renderOperations,\n      '更新操作': summary.updateOperations,\n      '平均渲染时间(ms)': summary.avgRenderTime.toFixed(2),\n      '平均更新时间(ms)': summary.avgUpdateTime.toFixed(2),\n      '最近10次渲染时间(ms)': summary.recentAvgRenderTime.toFixed(2),\n      '最近10次更新时间(ms)': summary.recentAvgUpdateTime.toFixed(2),\n      '平均内存使用(MB)': summary.avgMemoryUsage.toFixed(2),\n    });\n  }\n}\n\n/**\n * 全局性能监控实例\n */\nexport const globalPerformanceMonitor = new PerformanceMonitor();\n\n/**\n * 性能警告阈值（ms）\n */\nexport const PERFORMANCE_THRESHOLDS: PerformanceThresholds = {\n  renderTime: 50, // 渲染超过 50ms 发出警告\n  updateTime: 16, // 更新超过 16ms 发出警告（1帧）\n  memoryUsage: 100, // 内存使用超过 100MB 发出警告\n};\n\n/**\n * 检查性能并发出警告\n */\nexport function checkPerformance(metric: PerformanceMetrics, thresholds: PerformanceThresholds = PERFORMANCE_THRESHOLDS): void {\n  if (metric.renderTime > thresholds.renderTime) {\n    console.warn(\n      `[json-render Performance Warning] 渲染耗时 ${metric.renderTime.toFixed(2)}ms，超过阈值 ${thresholds.renderTime}ms`,\n      {\n        componentCount: metric.componentCount,\n        memoryUsage: metric.memoryUsage.toFixed(2) + 'MB',\n      },\n    );\n  }\n\n  if (metric.updateTime > thresholds.updateTime) {\n    console.warn(\n      `[json-render Performance Warning] 更新耗时 ${metric.updateTime.toFixed(2)}ms，超过阈值 ${thresholds.updateTime}ms`,\n      {\n        componentCount: metric.componentCount,\n        memoryUsage: metric.memoryUsage.toFixed(2) + 'MB',\n      },\n    );\n  }\n\n  if (metric.memoryUsage > thresholds.memoryUsage) {\n    console.warn(\n      `[json-render Performance Warning] 内存使用 ${metric.memoryUsage.toFixed(2)}MB，超过阈值 ${thresholds.memoryUsage}MB`,\n      {\n        componentCount: metric.componentCount,\n      },\n    );\n  }\n}\n\nexport default {\n  PerformanceMonitor,\n  globalPerformanceMonitor,\n  checkPerformance,\n  PERFORMANCE_THRESHOLDS,\n};"],"names":["PerformanceMonitor","_classCallCheck","_defineProperty","_createClass","key","value","start","_this","startTime","performance","now","elementCount","endTime","renderTime","metric","updateTime","memoryUsage","getMemoryUsage","componentCount","timestamp","Date","addMetric","measureUpdate","fn","result","_performance$memory","memory","usedJSHeapSize","metrics","push","length","maxMetricsCount","shift","getMetrics","_toConsumableArray","getAverageRenderTime","renderMetrics","filter","m","totalTime","reduce","sum","getAverageUpdateTime","updateMetrics","getRecentAverageTime","count","arguments","undefined","type","recentMetrics","slice","timeField","validMetrics","getSummary","totalOperations","renderOperations","updateOperations","avgRenderTime","avgUpdateTime","recentAvgRenderTime","recentAvgUpdateTime","avgMemoryUsage","getAverageMemoryUsage","totalMemory","reset","printSummary","summary","console","log","toFixed","globalPerformanceMonitor","PERFORMANCE_THRESHOLDS","checkPerformance","thresholds","warn","concat"],"mappings":"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"}

package/es/chat-engine/hooks/a2ui/A2UIContext.d.ts

@@ -0,0 +1,90 @@
+/**
+ * A2UI React Context
+ * 双 Context 设计：A2UIContext（运行时状态）+ ComponentRegistryContext（组件注册）
+ */
+import React, { ReactNode } from 'react';
+import type { A2uiMessageProcessor } from '../../core/a2ui';
+import type { ActionHandler } from '../../core/a2ui';
+/**
+ * A2UI 组件渲染器类型
+ */
+export type A2UIComponentRenderer<T = any> = React.ComponentType<T>;
+/**
+ * 组件注册表
+ */
+export interface ComponentRegistry {
+    [componentType: string]: A2UIComponentRenderer;
+}
+/**
+ * 组件注册表上下文值
+ */
+interface ComponentRegistryContextValue {
+    registry: ComponentRegistry;
+    getComponent: (type: string) => A2UIComponentRenderer | undefined;
+}
+/**
+ * 组件注册表 Provider
+ */
+export interface ComponentRegistryProviderProps {
+    registry: ComponentRegistry;
+    children: ReactNode;
+}
+export declare function ComponentRegistryProvider({ registry, children }: ComponentRegistryProviderProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * 获取组件注册表
+ */
+export declare function useComponentRegistry(): ComponentRegistryContextValue;
+/**
+ * A2UI 运行时上下文值
+ */
+export interface A2UIContextValue {
+    /** A2UI 消息处理器 */
+    processor: A2uiMessageProcessor;
+    /** 当前 Surface ID */
+    surfaceId: string;
+    /** 当前数据上下文路径（用于相对路径解析和 template 渲染） */
+    dataContextPath: string;
+    /** Action 处理回调 */
+    onAction?: ActionHandler;
+}
+/**
+ * A2UI 运行时 Provider
+ */
+export interface A2UIProviderProps {
+    processor: A2uiMessageProcessor;
+    surfaceId: string;
+    dataContextPath?: string;
+    onAction?: ActionHandler;
+    children: ReactNode;
+}
+export declare function A2UIProvider({ processor, surfaceId, dataContextPath, onAction, children, }: A2UIProviderProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * 获取 A2UI 运行时上下文
+ */
+export declare function useA2UIContext(): A2UIContextValue;
+/**
+ * 安全获取 A2UI 上下文（可能为 null）
+ */
+export declare function useA2UIContextSafe(): A2UIContextValue | null;
+/**
+ * A2UI 完整 Provider（组合两个 Context）
+ */
+export interface A2UIRootProviderProps {
+    processor: A2uiMessageProcessor;
+    surfaceId: string;
+    registry: ComponentRegistry;
+    dataContextPath?: string;
+    onAction?: ActionHandler;
+    children: ReactNode;
+}
+export declare function A2UIRootProvider({ processor, surfaceId, registry, dataContextPath, onAction, children, }: A2UIRootProviderProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * 数据上下文路径 Provider
+ * 用于 List/Template 渲染时修改子组件的数据上下文
+ */
+export interface DataContextProviderProps {
+    path: string;
+    children: ReactNode;
+}
+export declare function DataContextProvider({ path, children }: DataContextProviderProps): import("react/jsx-runtime").JSX.Element;
+export {};

package/es/chat-engine/hooks/a2ui/A2UIContext.js

@@ -0,0 +1,97 @@
+/**
+ * tdesign v1.0.2-alpha.14
+ * (c) 2026 tdesign
+ * @license MIT
+ */
+
+import _defineProperty from '@babel/runtime/helpers/defineProperty';
+import React__default, { createContext, useMemo, useContext } 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; }
+var ComponentRegistryContext = /*#__PURE__*/createContext(null);
+function ComponentRegistryProvider(_ref) {
+  var registry = _ref.registry,
+    children = _ref.children;
+  var value = useMemo(function () {
+    return {
+      registry: registry,
+      getComponent: function getComponent(type) {
+        return registry[type];
+      }
+    };
+  }, [registry]);
+  return /* @__PURE__ */React__default.createElement(ComponentRegistryContext.Provider, {
+    value: value
+  }, children);
+}
+function useComponentRegistry() {
+  var context = useContext(ComponentRegistryContext);
+  if (!context) {
+    throw new Error("useComponentRegistry must be used within ComponentRegistryProvider");
+  }
+  return context;
+}
+var A2UIContext = /*#__PURE__*/createContext(null);
+function A2UIProvider(_ref2) {
+  var processor = _ref2.processor,
+    surfaceId = _ref2.surfaceId,
+    _ref2$dataContextPath = _ref2.dataContextPath,
+    dataContextPath = _ref2$dataContextPath === void 0 ? "/" : _ref2$dataContextPath,
+    onAction = _ref2.onAction,
+    children = _ref2.children;
+  var value = useMemo(function () {
+    return {
+      processor: processor,
+      surfaceId: surfaceId,
+      dataContextPath: dataContextPath,
+      onAction: onAction
+    };
+  }, [processor, surfaceId, dataContextPath, onAction]);
+  return /* @__PURE__ */React__default.createElement(A2UIContext.Provider, {
+    value: value
+  }, children);
+}
+function useA2UIContext() {
+  var context = useContext(A2UIContext);
+  if (!context) {
+    throw new Error("useA2UIContext must be used within A2UIProvider");
+  }
+  return context;
+}
+function useA2UIContextSafe() {
+  return useContext(A2UIContext);
+}
+function A2UIRootProvider(_ref3) {
+  var processor = _ref3.processor,
+    surfaceId = _ref3.surfaceId,
+    registry = _ref3.registry,
+    _ref3$dataContextPath = _ref3.dataContextPath,
+    dataContextPath = _ref3$dataContextPath === void 0 ? "/" : _ref3$dataContextPath,
+    onAction = _ref3.onAction,
+    children = _ref3.children;
+  return /* @__PURE__ */React__default.createElement(ComponentRegistryProvider, {
+    registry: registry
+  }, /* @__PURE__ */React__default.createElement(A2UIProvider, {
+    processor: processor,
+    surfaceId: surfaceId,
+    dataContextPath: dataContextPath,
+    onAction: onAction
+  }, children));
+}
+function DataContextProvider(_ref4) {
+  var path = _ref4.path,
+    children = _ref4.children;
+  var parent = useA2UIContext();
+  var value = useMemo(function () {
+    return _objectSpread(_objectSpread({}, parent), {}, {
+      dataContextPath: path
+    });
+  }, [parent, path]);
+  return /* @__PURE__ */React__default.createElement(A2UIContext.Provider, {
+    value: value
+  }, children);
+}
+
+export { A2UIProvider, A2UIRootProvider, ComponentRegistryProvider, DataContextProvider, useA2UIContext, useA2UIContextSafe, useComponentRegistry };
+//# sourceMappingURL=A2UIContext.js.map

package/es/chat-engine/hooks/a2ui/A2UIContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"A2UIContext.js","sources":["../../../../../pro-components/chat/chat-engine/hooks/a2ui/A2UIContext.tsx"],"sourcesContent":["/**\n * A2UI React Context\n * 双 Context 设计：A2UIContext（运行时状态）+ ComponentRegistryContext（组件注册）\n */\n\nimport React, { createContext, useContext, useMemo, ReactNode } from 'react';\nimport type { A2uiMessageProcessor } from '../../core/a2ui';\nimport type { ActionHandler } from '../../core/a2ui';\n\n// ============= Component Registry Context =============\n\n/**\n * A2UI 组件渲染器类型\n */\nexport type A2UIComponentRenderer<T = any> = React.ComponentType<T>;\n\n/**\n * 组件注册表\n */\nexport interface ComponentRegistry {\n  [componentType: string]: A2UIComponentRenderer;\n}\n\n/**\n * 组件注册表上下文值\n */\ninterface ComponentRegistryContextValue {\n  registry: ComponentRegistry;\n  getComponent: (type: string) => A2UIComponentRenderer | undefined;\n}\n\nconst ComponentRegistryContext = createContext<ComponentRegistryContextValue | null>(null);\n\n/**\n * 组件注册表 Provider\n */\nexport interface ComponentRegistryProviderProps {\n  registry: ComponentRegistry;\n  children: ReactNode;\n}\n\nexport function ComponentRegistryProvider({ registry, children }: ComponentRegistryProviderProps) {\n  const value = useMemo<ComponentRegistryContextValue>(\n    () => ({\n      registry,\n      getComponent: (type: string) => registry[type],\n    }),\n    [registry]\n  );\n\n  return (\n    <ComponentRegistryContext.Provider value={value}>\n      {children}\n    </ComponentRegistryContext.Provider>\n  );\n}\n\n/**\n * 获取组件注册表\n */\nexport function useComponentRegistry(): ComponentRegistryContextValue {\n  const context = useContext(ComponentRegistryContext);\n  if (!context) {\n    throw new Error('useComponentRegistry must be used within ComponentRegistryProvider');\n  }\n  return context;\n}\n\n// ============= A2UI Runtime Context =============\n\n/**\n * A2UI 运行时上下文值\n */\nexport interface A2UIContextValue {\n  /** A2UI 消息处理器 */\n  processor: A2uiMessageProcessor;\n  /** 当前 Surface ID */\n  surfaceId: string;\n  /** 当前数据上下文路径（用于相对路径解析和 template 渲染） */\n  dataContextPath: string;\n  /** Action 处理回调 */\n  onAction?: ActionHandler;\n}\n\nconst A2UIContext = createContext<A2UIContextValue | null>(null);\n\n/**\n * A2UI 运行时 Provider\n */\nexport interface A2UIProviderProps {\n  processor: A2uiMessageProcessor;\n  surfaceId: string;\n  dataContextPath?: string;\n  onAction?: ActionHandler;\n  children: ReactNode;\n}\n\nexport function A2UIProvider({\n  processor,\n  surfaceId,\n  dataContextPath = '/',\n  onAction,\n  children,\n}: A2UIProviderProps) {\n  const value = useMemo<A2UIContextValue>(\n    () => ({\n      processor,\n      surfaceId,\n      dataContextPath,\n      onAction,\n    }),\n    [processor, surfaceId, dataContextPath, onAction]\n  );\n\n  return <A2UIContext.Provider value={value}>{children}</A2UIContext.Provider>;\n}\n\n/**\n * 获取 A2UI 运行时上下文\n */\nexport function useA2UIContext(): A2UIContextValue {\n  const context = useContext(A2UIContext);\n  if (!context) {\n    throw new Error('useA2UIContext must be used within A2UIProvider');\n  }\n  return context;\n}\n\n/**\n * 安全获取 A2UI 上下文（可能为 null）\n */\nexport function useA2UIContextSafe(): A2UIContextValue | null {\n  return useContext(A2UIContext);\n}\n\n// ============= 组合 Provider =============\n\n/**\n * A2UI 完整 Provider（组合两个 Context）\n */\nexport interface A2UIRootProviderProps {\n  processor: A2uiMessageProcessor;\n  surfaceId: string;\n  registry: ComponentRegistry;\n  dataContextPath?: string;\n  onAction?: ActionHandler;\n  children: ReactNode;\n}\n\nexport function A2UIRootProvider({\n  processor,\n  surfaceId,\n  registry,\n  dataContextPath = '/',\n  onAction,\n  children,\n}: A2UIRootProviderProps) {\n  return (\n    <ComponentRegistryProvider registry={registry}>\n      <A2UIProvider\n        processor={processor}\n        surfaceId={surfaceId}\n        dataContextPath={dataContextPath}\n        onAction={onAction}\n      >\n        {children}\n      </A2UIProvider>\n    </ComponentRegistryProvider>\n  );\n}\n\n// ============= Data Context Path Provider =============\n\n/**\n * 数据上下文路径 Provider\n * 用于 List/Template 渲染时修改子组件的数据上下文\n */\nexport interface DataContextProviderProps {\n  path: string;\n  children: ReactNode;\n}\n\nexport function DataContextProvider({ path, children }: DataContextProviderProps) {\n  const parent = useA2UIContext();\n\n  const value = useMemo<A2UIContextValue>(\n    () => ({\n      ...parent,\n      dataContextPath: path,\n    }),\n    [parent, path]\n  );\n\n  return <A2UIContext.Provider value={value}>{children}</A2UIContext.Provider>;\n}\n"],"names":["ComponentRegistryContext","createContext","ComponentRegistryProvider","_ref","registry","children","value","useMemo","getComponent","type","React","createElement","Provider","useComponentRegistry","context","useContext","Error","A2UIContext","A2UIProvider","_ref2","processor","surfaceId","_ref2$dataContextPath","dataContextPath","onAction","useA2UIContext","useA2UIContextSafe","A2UIRootProvider","_ref3","_ref3$dataContextPath","DataContextProvider","_ref4","path","parent","_objectSpread"],"mappings":"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"}

package/es/chat-engine/hooks/a2ui/index.d.ts

@@ -0,0 +1,12 @@
+/**
+ * A2UI React 适配层 Hooks 导出
+ */
+export { A2UIRootProvider, // 组合 Provider，一站式解决方案
+useA2UIContext, // 核心 Context Hook
+useComponentRegistry, // 组件注册表 Hook
+type ComponentRegistry, // 核心类型
+type A2UIRootProviderProps, } from './A2UIContext';
+export { useDataBinding, // 单向绑定（最常用）
+useTwoWayBinding, } from './useDataBinding';
+export { useA2UISurface, } from './useA2UISurface';
+export { useA2UIAction, } from './useA2UIAction';

package/es/chat-engine/hooks/a2ui/index.js

@@ -0,0 +1,19 @@
+/**
+ * tdesign v1.0.2-alpha.14
+ * (c) 2026 tdesign
+ * @license MIT
+ */
+
+export { A2UIRootProvider, useA2UIContext, useComponentRegistry } from './A2UIContext.js';
+export { useDataBinding, useTwoWayBinding } from './useDataBinding.js';
+export { useA2UISurface } from './useA2UISurface.js';
+export { useA2UIAction } from './useA2UIAction.js';
+import '@babel/runtime/helpers/defineProperty';
+import 'react';
+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';
+//# sourceMappingURL=index.js.map

package/es/chat-engine/hooks/a2ui/index.js.map

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

package/es/chat-engine/hooks/a2ui/useA2UIAction.d.ts

@@ -0,0 +1,40 @@
+/**
+ * A2UI Action 相关 Hooks
+ */
+import type { A2UIAction } from '../../core/a2ui';
+/**
+ * 获取 Action 分发函数
+ *
+ * @example
+ * ```tsx
+ * function Button({ action }: { action: A2UIAction }) {
+ *   const dispatch = useA2UIAction();
+ *   return <TButton onClick={() => dispatch(action)}>Click</TButton>;
+ * }
+ * ```
+ */
+export declare function useA2UIAction(): (action: A2UIAction, componentId?: string) => void;
+/**
+ * 创建绑定特定 Action 的回调
+ *
+ * @example
+ * ```tsx
+ * function ConfirmButton({ id }: { id: string }) {
+ *   const handleConfirm = useActionCallback({ name: 'confirm', context: { value: true } }, id);
+ *   return <TButton onClick={handleConfirm}>确认</TButton>;
+ * }
+ * ```
+ */
+export declare function useActionCallback(action: A2UIAction | undefined, componentId?: string): (() => void) | undefined;
+/**
+ * 创建带参数的 Action 回调
+ *
+ * @example
+ * ```tsx
+ * function Input({ id }: { id: string }) {
+ *   const handleChange = useActionWithPayload('input-change', id);
+ *   return <TInput onChange={(val) => handleChange({ value: val })} />;
+ * }
+ * ```
+ */
+export declare function useActionWithPayload(actionName: string, componentId?: string): (context: Record<string, unknown>) => void;