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

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

@@ -1,5 +1,5 @@
 /**
- * tdesign v1.0.2-alpha.6
+ * tdesign v1.0.2-alpha.15
  * (c) 2026 tdesign
  * @license MIT
  */

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;

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

@@ -0,0 +1,74 @@
+/**
+ * tdesign v1.0.2-alpha.14
+ * (c) 2026 tdesign
+ * @license MIT
+ */
+
+import { useCallback } from 'react';
+import { useA2UIContext } from './A2UIContext.js';
+import '@babel/runtime/helpers/defineProperty';
+
+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 useA2UIAction() {
+  var _useA2UIContext = useA2UIContext(),
+    processor = _useA2UIContext.processor,
+    surfaceId = _useA2UIContext.surfaceId,
+    onAction = _useA2UIContext.onAction;
+  return useCallback(function (action, componentId) {
+    if (onAction) {
+      var context = {
+        surfaceId: surfaceId,
+        componentId: componentId,
+        updateData: function updateData(path, value) {
+          processor.updateDataValue(surfaceId, path, value);
+        },
+        getData: function getData(path) {
+          var surface = processor.getSurface(surfaceId);
+          if (!surface) return void 0;
+          if (!path) return surface.data;
+          var segments = path.split("/").filter(Boolean);
+          var result = surface.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);
+    } else {
+      processor.dispatchAction(action, surfaceId, componentId);
+    }
+  }, [processor, surfaceId, onAction]);
+}
+function useActionCallback(action, componentId) {
+  var dispatch = useA2UIAction();
+  return useCallback(function () {
+    if (action) {
+      dispatch(action, componentId);
+    }
+  }, [dispatch, action, componentId]);
+}
+function useActionWithPayload(actionName, componentId) {
+  var dispatch = useA2UIAction();
+  return useCallback(function (context) {
+    dispatch({
+      name: actionName,
+      context: context
+    }, componentId);
+  }, [dispatch, actionName, componentId]);
+}
+
+export { useA2UIAction, useActionCallback, useActionWithPayload };
+//# sourceMappingURL=useA2UIAction.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useA2UIAction.js","sources":["../../../../../pro-components/chat/chat-engine/hooks/a2ui/useA2UIAction.ts"],"sourcesContent":["/**\n * A2UI Action 相关 Hooks\n */\n\nimport { useCallback } from 'react';\nimport { useA2UIContext } from './A2UIContext';\nimport type { A2UIAction } from '../../core/a2ui';\n\n/**\n * 获取 Action 分发函数\n * \n * @example\n * ```tsx\n * function Button({ action }: { action: A2UIAction }) {\n *   const dispatch = useA2UIAction();\n *   return <TButton onClick={() => dispatch(action)}>Click</TButton>;\n * }\n * ```\n */\nexport function useA2UIAction(): (action: A2UIAction, componentId?: string) => void {\n  const { processor, surfaceId, onAction } = useA2UIContext();\n\n  return useCallback(\n    (action: A2UIAction, componentId?: string) => {\n      // 优先使用外部提供的 onAction\n      if (onAction) {\n        const context = {\n          surfaceId,\n          componentId,\n          updateData: (path: string, value: unknown) => {\n            processor.updateDataValue(surfaceId, path, value);\n          },\n          getData: (path?: string) => {\n            const surface = processor.getSurface(surfaceId);\n            if (!surface) return undefined;\n            if (!path) return surface.data;\n            // 简单路径解析\n            const segments = path.split('/').filter(Boolean);\n            let result: unknown = surface.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        onAction(action, context);\n      } else {\n        // 使用 processor 内部处理\n        processor.dispatchAction(action, surfaceId, componentId);\n      }\n    },\n    [processor, surfaceId, onAction]\n  );\n}\n\n/**\n * 创建绑定特定 Action 的回调\n * \n * @example\n * ```tsx\n * function ConfirmButton({ id }: { id: string }) {\n *   const handleConfirm = useActionCallback({ name: 'confirm', context: { value: true } }, id);\n *   return <TButton onClick={handleConfirm}>确认</TButton>;\n * }\n * ```\n */\nexport function useActionCallback(\n  action: A2UIAction | undefined,\n  componentId?: string\n): (() => void) | undefined {\n  const dispatch = useA2UIAction();\n\n  return useCallback(() => {\n    if (action) {\n      dispatch(action, componentId);\n    }\n  }, [dispatch, action, componentId]);\n}\n\n/**\n * 创建带参数的 Action 回调\n * \n * @example\n * ```tsx\n * function Input({ id }: { id: string }) {\n *   const handleChange = useActionWithPayload('input-change', id);\n *   return <TInput onChange={(val) => handleChange({ value: val })} />;\n * }\n * ```\n */\nexport function useActionWithPayload(\n  actionName: string,\n  componentId?: string\n): (context: Record<string, unknown>) => void {\n  const dispatch = useA2UIAction();\n\n  return useCallback(\n    (context: Record<string, unknown>) => {\n      dispatch({ name: actionName, context }, componentId);\n    },\n    [dispatch, actionName, componentId]\n  );\n}\n"],"names":["useA2UIAction","_useA2UIContext","useA2UIContext","processor","surfaceId","onAction","useCallback","action","componentId","context","updateData","path","value","updateDataValue","getData","surface","getSurface","data","segments","split","filter","Boolean","result","_iterator","_createForOfIteratorHelper","_step","s","n","done","segment","err","e","f","dispatchAction","useActionCallback","dispatch","useActionWithPayload","actionName","name"],"mappings":"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"}

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

@@ -0,0 +1,36 @@
+/**
+ * A2UI Surface 相关 Hooks
+ */
+import type { A2uiMessageProcessor } from '../../core/a2ui';
+import type { A2UISurface, ResolvedComponent } from '../../core/a2ui';
+/**
+ * 订阅单个 Surface
+ *
+ * @example
+ * ```tsx
+ * const surface = useA2UISurface(processor, 'surface-1');
+ * if (!surface) return <Loading />;
+ * return <A2UIRenderer root={surface.root} />;
+ * ```
+ */
+export declare function useA2UISurface(processor: A2uiMessageProcessor, surfaceId: string): A2UISurface | undefined;
+/**
+ * 订阅所有 Surface
+ */
+export declare function useA2UISurfaces(processor: A2uiMessageProcessor): A2UISurface[];
+/**
+ * 订阅 Surface 的组件树根节点
+ */
+export declare function useA2UIRoot(processor: A2uiMessageProcessor, surfaceId: string): ResolvedComponent | null;
+/**
+ * 订阅 Surface 的数据模型
+ */
+export declare function useA2UIData<T = Record<string, unknown>>(processor: A2uiMessageProcessor, surfaceId: string): T | undefined;
+/**
+ * 订阅 Surface 状态
+ */
+export declare function useA2UISurfaceState(processor: A2uiMessageProcessor, surfaceId: string): 'active' | 'closed' | 'pending' | undefined;
+/**
+ * 获取 Surface IDs 列表
+ */
+export declare function useA2UISurfaceIds(processor: A2uiMessageProcessor): string[];

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

@@ -0,0 +1,39 @@
+/**
+ * tdesign v1.0.2-alpha.14
+ * (c) 2026 tdesign
+ * @license MIT
+ */
+
+import { useSyncExternalStore, useMemo } from 'react';
+
+function useA2UISurface(processor, surfaceId) {
+  var snapshot = useSyncExternalStore(processor.subscribe, processor.getSnapshot, processor.getServerSnapshot);
+  return snapshot.get(surfaceId);
+}
+function useA2UISurfaces(processor) {
+  var snapshot = useSyncExternalStore(processor.subscribe, processor.getSnapshot, processor.getServerSnapshot);
+  return useMemo(function () {
+    return Array.from(snapshot.values());
+  }, [snapshot]);
+}
+function useA2UIRoot(processor, surfaceId) {
+  var surface = useA2UISurface(processor, surfaceId);
+  return (surface === null || surface === void 0 ? void 0 : surface.root) || null;
+}
+function useA2UIData(processor, surfaceId) {
+  var surface = useA2UISurface(processor, surfaceId);
+  return surface === null || surface === void 0 ? void 0 : surface.data;
+}
+function useA2UISurfaceState(processor, surfaceId) {
+  var surface = useA2UISurface(processor, surfaceId);
+  return surface === null || surface === void 0 ? void 0 : surface.state;
+}
+function useA2UISurfaceIds(processor) {
+  var snapshot = useSyncExternalStore(processor.subscribe, processor.getSnapshot, processor.getServerSnapshot);
+  return useMemo(function () {
+    return Array.from(snapshot.keys());
+  }, [snapshot]);
+}
+
+export { useA2UIData, useA2UIRoot, useA2UISurface, useA2UISurfaceIds, useA2UISurfaceState, useA2UISurfaces };
+//# sourceMappingURL=useA2UISurface.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"useA2UISurface.js","sources":["../../../../../pro-components/chat/chat-engine/hooks/a2ui/useA2UISurface.ts"],"sourcesContent":["/**\n * A2UI Surface 相关 Hooks\n */\n\nimport { useSyncExternalStore, useMemo } from 'react';\nimport type { A2uiMessageProcessor } from '../../core/a2ui';\nimport type { A2UISurface, ResolvedComponent } from '../../core/a2ui';\n\n/**\n * 订阅单个 Surface\n * \n * @example\n * ```tsx\n * const surface = useA2UISurface(processor, 'surface-1');\n * if (!surface) return <Loading />;\n * return <A2UIRenderer root={surface.root} />;\n * ```\n */\nexport function useA2UISurface(\n  processor: A2uiMessageProcessor,\n  surfaceId: string\n): A2UISurface | undefined {\n  const snapshot = useSyncExternalStore(\n    processor.subscribe,\n    processor.getSnapshot,\n    processor.getServerSnapshot\n  );\n\n  return snapshot.get(surfaceId);\n}\n\n/**\n * 订阅所有 Surface\n */\nexport function useA2UISurfaces(processor: A2uiMessageProcessor): A2UISurface[] {\n  const snapshot = useSyncExternalStore(\n    processor.subscribe,\n    processor.getSnapshot,\n    processor.getServerSnapshot\n  );\n\n  return useMemo(() => Array.from(snapshot.values()), [snapshot]);\n}\n\n/**\n * 订阅 Surface 的组件树根节点\n */\nexport function useA2UIRoot(\n  processor: A2uiMessageProcessor,\n  surfaceId: string\n): ResolvedComponent | null {\n  const surface = useA2UISurface(processor, surfaceId);\n  return surface?.root || null;\n}\n\n/**\n * 订阅 Surface 的数据模型\n */\nexport function useA2UIData<T = Record<string, unknown>>(\n  processor: A2uiMessageProcessor,\n  surfaceId: string\n): T | undefined {\n  const surface = useA2UISurface(processor, surfaceId);\n  return surface?.data as T | undefined;\n}\n\n/**\n * 订阅 Surface 状态\n */\nexport function useA2UISurfaceState(\n  processor: A2uiMessageProcessor,\n  surfaceId: string\n): 'active' | 'closed' | 'pending' | undefined {\n  const surface = useA2UISurface(processor, surfaceId);\n  return surface?.state;\n}\n\n/**\n * 获取 Surface IDs 列表\n */\nexport function useA2UISurfaceIds(processor: A2uiMessageProcessor): string[] {\n  const snapshot = useSyncExternalStore(\n    processor.subscribe,\n    processor.getSnapshot,\n    processor.getServerSnapshot\n  );\n\n  return useMemo(() => Array.from(snapshot.keys()), [snapshot]);\n}\n"],"names":["useA2UISurface","processor","surfaceId","snapshot","useSyncExternalStore","subscribe","getSnapshot","getServerSnapshot","get","useA2UISurfaces","useMemo","Array","from","values","useA2UIRoot","surface","root","useA2UIData","data","useA2UISurfaceState","state","useA2UISurfaceIds","keys"],"mappings":";;;;;;;;AAkBgB,SAAAA,cAAAA,CACdC,WACAC,SACyB,EAAA;AACzB,EAAA,IAAMC,QAAW,GAAAC,oBAAA,CACfH,SAAU,CAAAI,SAAA,EACVJ,SAAU,CAAAK,WAAA,EACVL,SAAU,CAAAM,iBACZ,CAAA,CAAA;AAEO,EAAA,OAAAJ,QAAA,CAASK,IAAIN,SAAS,CAAA,CAAA;AAC/B,CAAA;AAKO,SAASO,gBAAgBR,SAAgD,EAAA;AAC9E,EAAA,IAAME,QAAW,GAAAC,oBAAA,CACfH,SAAU,CAAAI,SAAA,EACVJ,SAAU,CAAAK,WAAA,EACVL,SAAU,CAAAM,iBACZ,CAAA,CAAA;AAEO,EAAA,OAAAG,OAAA,CAAQ,YAAA;IAAA,OAAMC,KAAA,CAAMC,IAAK,CAAAT,QAAA,CAASU,QAAQ,CAAA,CAAA;GAAG,EAAA,CAACV,QAAQ,CAAC,CAAA,CAAA;AAChE,CAAA;AAKgB,SAAAW,WAAAA,CACdb,WACAC,SAC0B,EAAA;AACpB,EAAA,IAAAa,OAAA,GAAUf,cAAe,CAAAC,SAAA,EAAWC,SAAS,CAAA,CAAA;EACnD,OAAO,CAAAa,YAAAA,IAAAA,IAAAA,8BAAAA,QAASC,IAAQ,KAAA,IAAA,CAAA;AAC1B,CAAA;AAKgB,SAAAC,WAAAA,CACdhB,WACAC,SACe,EAAA;AACT,EAAA,IAAAa,OAAA,GAAUf,cAAe,CAAAC,SAAA,EAAWC,SAAS,CAAA,CAAA;AACnD,EAAA,OAAOa,OAAS,KAATA,IAAAA,IAAAA,OAAS,KAATA,KAAAA,CAAAA,GAAAA,KAAAA,CAAAA,GAAAA,OAAS,CAAAG,IAAA,CAAA;AAClB,CAAA;AAKgB,SAAAC,mBAAAA,CACdlB,WACAC,SAC6C,EAAA;AACvC,EAAA,IAAAa,OAAA,GAAUf,cAAe,CAAAC,SAAA,EAAWC,SAAS,CAAA,CAAA;AACnD,EAAA,OAAOa,OAAS,KAATA,IAAAA,IAAAA,OAAS,KAATA,KAAAA,CAAAA,GAAAA,KAAAA,CAAAA,GAAAA,OAAS,CAAAK,KAAA,CAAA;AAClB,CAAA;AAKO,SAASC,kBAAkBpB,SAA2C,EAAA;AAC3E,EAAA,IAAME,QAAW,GAAAC,oBAAA,CACfH,SAAU,CAAAI,SAAA,EACVJ,SAAU,CAAAK,WAAA,EACVL,SAAU,CAAAM,iBACZ,CAAA,CAAA;AAEO,EAAA,OAAAG,OAAA,CAAQ,YAAA;IAAA,OAAMC,KAAA,CAAMC,IAAK,CAAAT,QAAA,CAASmB,MAAM,CAAA,CAAA;GAAG,EAAA,CAACnB,QAAQ,CAAC,CAAA,CAAA;AAC9D;;;;"}

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

@@ -0,0 +1,53 @@
+/**
+ * A2UI 数据绑定 Hooks
+ * 实现单向/双向数据绑定
+ */
+import type { Bindable } from '../../core/a2ui/types';
+/**
+ * 单向数据绑定 Hook
+ *
+ * 用于读取绑定值：
+ * - 如果是字面值，直接返回
+ * - 如果是路径绑定，从数据模型读取
+ *
+ * @example
+ * ```tsx
+ * function Text({ text }: { text: Bindable<string> }) {
+ *   const resolvedText = useDataBinding(text);
+ *   return <span>{resolvedText}</span>;
+ * }
+ * ```
+ */
+export declare function useDataBinding<T>(value: Bindable<T>): T;
+export declare function useDataBinding<T>(value: Bindable<T> | undefined): T | undefined;
+/**
+ * 双向数据绑定 Hook
+ *
+ * 用于表单控件的双向绑定：
+ * - 读取：从数据模型获取当前值
+ * - 写入：更新数据模型
+ *
+ * @example
+ * ```tsx
+ * function TextField({ text }: { text: Bindable<string> }) {
+ *   const [inputValue, setInputValue] = useTwoWayBinding(text, '');
+ *   return <Input value={inputValue} onChange={setInputValue} />;
+ * }
+ * ```
+ */
+export declare function useTwoWayBinding<T>(value: Bindable<T> | undefined, defaultValue: T): [T, (newValue: T) => void];
+/**
+ * 获取路径绑定的完整路径
+ */
+export declare function useBindingPath(value: Bindable<unknown> | undefined): string | null;
+/**
+ * 批量解析绑定值
+ */
+export declare function useDataBindings<T extends Record<string, Bindable<unknown>>>(bindings: T): {
+    [K in keyof T]: T[K] extends Bindable<infer V> ? V : never;
+};
+/**
+ * 解析字符串中的绑定占位符
+ * 支持模板字符串格式: "Hello, {{/user/name}}!"
+ */
+export declare function useResolvedString(template: string | undefined): string;

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

@@ -0,0 +1,111 @@
+/**
+ * tdesign v1.0.2-alpha.14
+ * (c) 2026 tdesign
+ * @license MIT
+ */
+
+import _slicedToArray from '@babel/runtime/helpers/slicedToArray';
+import { useSyncExternalStore, useMemo, useCallback } from 'react';
+import { useA2UIContext } from './A2UIContext.js';
+import '../../core/a2ui/utils/index.js';
+import { resolveBinding, isPathBinding } from '../../core/a2ui/utils/binding.js';
+import '@babel/runtime/helpers/defineProperty';
+import '../../core/a2ui/utils/validation.js';
+import '@babel/runtime/helpers/toConsumableArray';
+import '@babel/runtime/helpers/typeof';
+
+function useDataBinding(value) {
+  var _useA2UIContext = useA2UIContext(),
+    processor = _useA2UIContext.processor,
+    surfaceId = _useA2UIContext.surfaceId,
+    dataContextPath = _useA2UIContext.dataContextPath;
+  var snapshot = useSyncExternalStore(processor.subscribe, processor.getSnapshot, processor.getServerSnapshot);
+  var surface = snapshot.get(surfaceId);
+  var data = (surface === null || surface === void 0 ? void 0 : surface.data) || {};
+  return useMemo(function () {
+    if (value === void 0) return void 0;
+    return resolveBinding(value, data, dataContextPath);
+  }, [value, data, dataContextPath]);
+}
+function useTwoWayBinding(value, defaultValue) {
+  var _useA2UIContext2 = useA2UIContext(),
+    processor = _useA2UIContext2.processor,
+    surfaceId = _useA2UIContext2.surfaceId,
+    dataContextPath = _useA2UIContext2.dataContextPath;
+  var snapshot = useSyncExternalStore(processor.subscribe, processor.getSnapshot, processor.getServerSnapshot);
+  var surface = snapshot.get(surfaceId);
+  var data = (surface === null || surface === void 0 ? void 0 : surface.data) || {};
+  var currentValue = useMemo(function () {
+    if (value === void 0) return defaultValue;
+    var resolved = resolveBinding(value, data, dataContextPath);
+    return resolved !== void 0 ? resolved : defaultValue;
+  }, [value, data, dataContextPath, defaultValue]);
+  var fullPath = useMemo(function () {
+    if (!isPathBinding(value)) return null;
+    var path = value.path;
+    if (path.startsWith("/")) return path;
+    if (!dataContextPath || dataContextPath === "/") {
+      return "/".concat(path);
+    }
+    return "".concat(dataContextPath, "/").concat(path).replace(/\/+/g, "/");
+  }, [value, dataContextPath]);
+  var setValue = useCallback(function (newValue) {
+    if (fullPath) {
+      processor.setData(surfaceId, fullPath, "", newValue);
+    }
+  }, [processor, surfaceId, fullPath]);
+  return [currentValue, setValue];
+}
+function useBindingPath(value) {
+  var _useA2UIContext3 = useA2UIContext(),
+    dataContextPath = _useA2UIContext3.dataContextPath;
+  return useMemo(function () {
+    if (!isPathBinding(value)) return null;
+    var path = value.path;
+    if (path.startsWith("/")) return path;
+    if (!dataContextPath || dataContextPath === "/") {
+      return "/".concat(path);
+    }
+    return "".concat(dataContextPath, "/").concat(path).replace(/\/+/g, "/");
+  }, [value, dataContextPath]);
+}
+function useDataBindings(bindings) {
+  var _useA2UIContext4 = useA2UIContext(),
+    processor = _useA2UIContext4.processor,
+    surfaceId = _useA2UIContext4.surfaceId,
+    dataContextPath = _useA2UIContext4.dataContextPath;
+  var snapshot = useSyncExternalStore(processor.subscribe, processor.getSnapshot, processor.getServerSnapshot);
+  var surface = snapshot.get(surfaceId);
+  var data = (surface === null || surface === void 0 ? void 0 : surface.data) || {};
+  return useMemo(function () {
+    var result = {};
+    for (var _i = 0, _Object$entries = Object.entries(bindings); _i < _Object$entries.length; _i++) {
+      var _Object$entries$_i = _slicedToArray(_Object$entries[_i], 2),
+        key = _Object$entries$_i[0],
+        value = _Object$entries$_i[1];
+      result[key] = resolveBinding(value, data, dataContextPath);
+    }
+    return result;
+  }, [bindings, data, dataContextPath]);
+}
+function useResolvedString(template) {
+  var _useA2UIContext5 = useA2UIContext(),
+    processor = _useA2UIContext5.processor,
+    surfaceId = _useA2UIContext5.surfaceId,
+    dataContextPath = _useA2UIContext5.dataContextPath;
+  var snapshot = useSyncExternalStore(processor.subscribe, processor.getSnapshot, processor.getServerSnapshot);
+  var surface = snapshot.get(surfaceId);
+  var data = (surface === null || surface === void 0 ? void 0 : surface.data) || {};
+  return useMemo(function () {
+    if (!template) return "";
+    return template.replace(/\{\{([^}]+)\}\}/g, function (_, path) {
+      var value = resolveBinding({
+        path: path.trim()
+      }, data, dataContextPath);
+      return value !== void 0 ? String(value) : "";
+    });
+  }, [template, data, dataContextPath]);
+}
+
+export { useBindingPath, useDataBinding, useDataBindings, useResolvedString, useTwoWayBinding };
+//# sourceMappingURL=useDataBinding.js.map