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

package/es/chat-engine/components/json-render/registry/config.d.ts

@@ -0,0 +1,142 @@
+/**
+ * json-render Activity 配置工厂函数
+ * 便捷创建 ActivityConfig 用于注册
+ */
+import type { ActivityConfig } from '../../activity/types';
+import type { JsonRenderActivityProps, ComponentRegistry } from '../types';
+/**
+ * json-render Activity 配置选项
+ */
+export interface JsonRenderActivityConfigOptions {
+    /** Activity 类型标识，默认 'json-render' */
+    activityType?: string;
+    /** 组件注册表，默认使用 tdesignRegistry */
+    registry?: ComponentRegistry;
+    /**
+     * Action 处理器映射表
+     *
+     * 重要：json-render 采用预定义 action 模式
+     * - AI/服务端只能生成在此预定义的 action 名称
+     * - 每个 action 对应一个具体的处理函数
+     * - 这确保了生成式 UI 的安全性和可控性
+     *
+     * @example
+     * ```tsx
+     * actionHandlers: {
+     *   // 表单提交
+     *   submit: async (params) => {
+     *     await api.submitForm(params);
+     *     MessagePlugin.success('提交成功');
+     *   },
+     *
+     *   // 表单重置
+     *   reset: async (params) => {
+     *     MessagePlugin.info('表单已重置');
+     *   },
+     *
+     *   // 删除操作
+     *   delete: async (params) => {
+     *     await api.deleteItem(params.id);
+     *   },
+     *
+     *   // 刷新数据
+     *   refresh: async () => {
+     *     await refetchData();
+     *   }
+     * }
+     * ```
+     */
+    actionHandlers?: Record<string, (params: Record<string, unknown>) => void | Promise<void>>;
+    /** 显示调试信息 */
+    debug?: boolean;
+    /** 描述信息 */
+    description?: string;
+}
+/**
+ * 创建 json-render Activity 配置
+ *
+ * @example
+ * 基础用法 - 预定义 action handlers
+ * ```tsx
+ * const jsonRenderConfig = createJsonRenderActivityConfig({
+ *   activityType: 'json-render',
+ *   actionHandlers: {
+ *     submit: async (params) => {
+ *       console.log('提交表单:', params);
+ *       await api.submit(params);
+ *       MessagePlugin.success('提交成功');
+ *     },
+ *     reset: async (params) => {
+ *       MessagePlugin.info('表单已重置');
+ *     },
+ *     delete: async (params) => {
+ *       await api.delete(params.id);
+ *     }
+ *   },
+ * });
+ *
+ * useAgentActivity(jsonRenderConfig);
+ * ```
+ *
+ * @example
+ * 结合 ChatEngine 发送消息到服务端
+ * ```tsx
+ * const jsonRenderConfig = createJsonRenderActivityConfig({
+ *   actionHandlers: {
+ *     submit: async (params) => {
+ *       // 发送到服务端处理
+ *       await chatEngine.sendAIMessage({
+ *         params: { userActionMessage: { name: 'submit', params } },
+ *         sendRequest: true,
+ *       });
+ *     },
+ *     reset: async (params) => {
+ *       // 本地处理，不发送到服务端
+ *       MessagePlugin.info('已重置');
+ *     },
+ *   },
+ * });
+ * ```
+ *
+ * @example
+ * 配合自定义组件注册表
+ * ```tsx
+ * import { createCustomRegistry } from './catalog';
+ *
+ * const jsonRenderConfig = createJsonRenderActivityConfig({
+ *   registry: createCustomRegistry({
+ *     MyCustomComponent: MyComponentRenderer,
+ *   }),
+ *   actionHandlers: {
+ *     custom_action: async (params) => {
+ *       // 处理自定义操作
+ *     },
+ *   },
+ * });
+ * ```
+ */
+export declare function createJsonRenderActivityConfig(options?: JsonRenderActivityConfigOptions): ActivityConfig<JsonRenderActivityProps['content']>;
+/**
+ * 创建 A2UI + json-render Activity 配置
+ * 支持将 A2UI 协议转换为 json-render Schema 渲染
+ *
+ * 注意：默认使用 a2uiRegistry，自动支持 valuePath/disabledPath/action.context 绑定
+ *
+ * @example
+ * ```tsx
+ * const a2uiJsonRenderConfig = createA2UIJsonRenderActivityConfig({
+ *   activityType: 'a2ui-json-render',
+ *   actionHandlers: {
+ *     submit: async (params) => {
+ *       console.log('提交:', params);
+ *     },
+ *     cancel: async (params) => {
+ *       console.log('取消');
+ *     },
+ *   },
+ * });
+ *
+ * useAgentActivity(a2uiJsonRenderConfig);
+ * ```
+ */
+export declare function createA2UIJsonRenderActivityConfig(options?: JsonRenderActivityConfigOptions): ActivityConfig<any>;

package/es/chat-engine/components/json-render/registry/config.js

@@ -0,0 +1,76 @@
+/**
+ * tdesign v1.1.0-alpha.9
+ * (c) 2026 tdesign
+ * @license MIT
+ */
+
+import '@babel/runtime/helpers/defineProperty';
+import 'react';
+import '../renderer/JsonRenderActivityRenderer.js';
+import '../renderer/A2UIJsonRenderActivityRenderer.js';
+export { g as createA2UIJsonRenderActivityConfig, f as createJsonRenderActivityConfig } from '../../../../_chunks/dep-688e4aaa.js';
+import '../../../../_chunks/dep-ba3bd553.js';
+import '@babel/runtime/helpers/typeof';
+import '../renderer/JsonUIRenderer.js';
+import '../contexts/index.js';
+import '../contexts/data.js';
+import '@babel/runtime/helpers/slicedToArray';
+import '@babel/runtime/helpers/classCallCheck';
+import '@babel/runtime/helpers/createClass';
+import '@babel/runtime/helpers/possibleConstructorReturn';
+import '@babel/runtime/helpers/getPrototypeOf';
+import '@babel/runtime/helpers/inherits';
+import '../../../../_chunks/dep-de8ac730.js';
+import '@babel/runtime/helpers/wrapNativeSuper';
+import '@json-render/core';
+import '../contexts/store.js';
+import '../contexts/visibility.js';
+import '../contexts/actions.js';
+import '@babel/runtime/helpers/asyncToGenerator';
+import '@babel/runtime/regenerator';
+import '../contexts/validation.js';
+import '@babel/runtime/helpers/objectWithoutProperties';
+import '../contexts/tree.js';
+import '../../../core/index.js';
+import '../../../core/adapters/agui/index.js';
+import '@babel/runtime/helpers/toConsumableArray';
+import '../../../core/adapters/agui/event-mapper.js';
+import '../../../core/adapters/agui/types/index.js';
+import 'zod';
+import '../../../core/adapters/agui/StateManager.js';
+import '../../../core/utils/index.js';
+import '../../../core/utils/immutable-patch.js';
+import '@babel/runtime/helpers/toArray';
+import '../../../core/adapters/agui/ActivityManager.js';
+import '../../../core/adapters/agui/utils.js';
+import '../../../core/store/message.js';
+import '@babel/runtime/helpers/get';
+import '../../../core/store/reactiveState.js';
+import '../../../core/event-bus/index.js';
+import '../../../core/event-bus/ChatEventBus.js';
+import '../../../core/event-bus/types.js';
+import '../../../core/processor/index.js';
+import '../../../core/server/index.js';
+import '../../../core/server/llm-service.js';
+import '../../../core/utils/logger.js';
+import '../../../core/server/batch-client.js';
+import '../../../core/utils/eventEmitter.js';
+import '../../../core/server/errors.js';
+import '../../../core/server/sse-client.js';
+import '../../../core/server/connection-manager.js';
+import '../../../core/server/sse-parser.js';
+import '../../../core/server/types.js';
+import '../../../core/adapters/index.js';
+import '../../../core/adapters/json-render/index.js';
+import '../../../core/adapters/json-render/a2ui-to-jsonrender.js';
+import '../../../core/adapters/json-render/types/a2ui.js';
+import '../../../core/adapters/json-render/SurfaceStateManager.js';
+import '../../../core/adapters/json-render/types/index.js';
+import '../../../core/adapters/json-render/types/core.js';
+import '../catalog/atomic/button.js';
+import 'tdesign-react';
+import '../catalog/catalog-to-prompt.js';
+import '../catalog/atomic/card.js';
+import '../catalog/atomic/text.js';
+import '../catalog/atomic/layout.js';
+//# sourceMappingURL=config.js.map

package/es/chat-engine/components/json-render/registry/config.js.map

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

package/es/chat-engine/components/json-render/registry/index.d.ts

@@ -0,0 +1,137 @@
+/**
+ * TDesign ComponentRegistry（React 组件注册表）
+ * 用于 json-render 渲染层的组件映射
+ *
+ * 重要概念区分：
+ * - ComponentRegistry（本文件）：渲染层，映射组件名到 React 组件（传给 Renderer）
+ * - Catalog（catalog.ts）：约束层，定义组件 props schema 和 actions 白名单（给 AI/服务端）
+ *
+ * Registry 分类：
+ * - tdesignRegistry: 纯净的 TDesign 组件，用于直接的 json-render schema
+ * - a2uiRegistry: 支持 A2UI 协议的组件，自动处理 valuePath/disabledPath/action.context
+ *
+ * 详见：ARCHITECTURE.md
+ */
+import React from 'react';
+import type { ComponentRegistry, ComponentRenderProps } from '../types';
+/**
+ * 高性能组件包装器（可选）
+ * 使用 React.memo + react-fast-compare 实现深比较
+ *
+ * 注意：由于 ElementRenderer 已经实现了 React.memo + 深比较优化，
+ * 大多数情况下叶子组件不需要再使用 withStableProps 包装。
+ *
+ * 使用场景：
+ * - 组件内部有复杂的计算逻辑，希望进一步减少重渲染
+ * - 组件使用了 Context，需要避免 Context 变化导致的不必要渲染
+ *
+ * 原理：
+ * - json-render 每次渲染都会创建新的 element 对象引用
+ * - 默认的 React.memo 浅比较会认为 props 变化了
+ * - 使用 react-fast-compare 进行高效深比较，只在内容真正变化时才重渲染
+ *
+ * 性能说明：
+ * - react-fast-compare 比 JSON.stringify 更快（短路比较）
+ * - 发现第一个不同属性时立即停止，不会遍历整个对象
+ * - 处理了循环引用等边缘情况
+ */
+export declare function withStableProps<P extends ComponentRenderProps>(Component: React.ComponentType<P>): React.MemoExoticComponent<React.ComponentType<P>>;
+/**
+ * TDesign 内置组件注册表（渲染层）
+ *
+ * 这是框架内置的原子组件集合，提供基础 UI 渲染能力
+ * 业务层可以通过 createCustomRegistry 扩展自定义组件
+ *
+ * 使用方式：
+ * ```tsx
+ * import { tdesignRegistry } from '@tdesign-react/chat';
+ *
+ * const config = createJsonRenderActivityConfig({
+ *   registry: tdesignRegistry,
+ *   actionHandlers: { ... },
+ * });
+ * ```
+ *
+ * Schema 示例：
+ * ```json
+ * {
+ *   "root": "btn1",
+ *   "elements": {
+ *     "btn1": {
+ *       "key": "btn1",
+ *       "type": "Button",
+ *       "props": {
+ *         "variant": "base",
+ *         "theme": "primary",
+ *         "children": "点击我",
+ *         "action": "submit"
+ *       }
+ *     }
+ *   }
+ * }
+ * ```
+ */
+export declare const tdesignRegistry: ComponentRegistry;
+/**
+ * createCustomRegistry 配置选项
+ */
+export interface CreateCustomRegistryOptions {
+    /**
+     * 是否自动包装组件以优化性能
+     * 使用 React.memo + react-fast-compare 深比较 element.props
+     *
+     * 注意：由于 ElementRenderer 已经实现了 memo 优化，
+     * 默认关闭此选项。仅在组件有复杂内部逻辑时考虑开启。
+     *
+     * @default false
+     */
+    enableStableProps?: boolean;
+}
+/**
+ * 创建自定义组件注册表（扩展内置组件）
+ *
+ * 用于渲染层：扩展自定义业务组件的 React 实现
+ *
+ * 性能说明：
+ * - ElementRenderer 已经使用 React.memo + 深比较优化，会自动跳过无变化节点
+ * - 默认情况下，自定义组件无需额外的 memo 包装
+ * - 如果组件有复杂内部逻辑，可以设置 enableStableProps: true 进行双重优化
+ *
+ * @example
+ * ```tsx
+ * import { createCustomRegistry } from '@tdesign-react/chat';
+ * import type { ComponentRenderProps } from '@json-render/react';
+ *
+ * // 定义自定义组件（无需手动 React.memo）
+ * const StatusCard: React.FC<ComponentRenderProps> = ({ element }) => (
+ *   <div className="status-card">{element.props.status}</div>
+ * );
+ *
+ * const ProgressBar: React.FC<ComponentRenderProps> = ({ element }) => (
+ *   <div className="progress-bar" style={{ width: `${element.props.percentage}%` }} />
+ * );
+ *
+ * // 扩展 registry（ElementRenderer 已有优化，无需额外包装）
+ * const customRegistry = createCustomRegistry({
+ *   StatusCard,
+ *   ProgressBar,
+ * });
+ *
+ * // 如果组件有复杂内部逻辑，可以开启双重优化
+ * const customRegistry = createCustomRegistry(
+ *   { StatusCard, ProgressBar },
+ *   { enableStableProps: true }
+ * );
+ * ```
+ *
+ * 注意：
+ * - 这里只定义渲染层的组件映射
+ * - 约束层（Catalog）需要使用 createCustomCatalog 定义（见 catalog.ts）
+ * - 两者需要保持组件名称一致
+ */
+export declare function createCustomRegistry(customComponents: ComponentRegistry, options?: CreateCustomRegistryOptions): ComponentRegistry;
+export { a2uiRegistry, createA2UIRegistry, A2UITextField, A2UIButton } from './a2ui-registry';
+export type { JsonRenderActivityConfigOptions } from './config';
+export { createJsonRenderActivityConfig, createA2UIJsonRenderActivityConfig } from './config';
+export { withA2UIBinding } from './a2ui-binding';
+export type { A2UIBindingConfig } from './a2ui-binding';

package/es/chat-engine/components/json-render/registry/index.js

@@ -0,0 +1,76 @@
+/**
+ * tdesign v1.1.0-alpha.9
+ * (c) 2026 tdesign
+ * @license MIT
+ */
+
+import '@babel/runtime/helpers/defineProperty';
+import '@babel/runtime/helpers/slicedToArray';
+import 'react';
+import '../../../../_chunks/dep-ba3bd553.js';
+import '../catalog/atomic/button.js';
+export { d as A2UIButton, A as A2UITextField, a as a2uiRegistry, g as createA2UIJsonRenderActivityConfig, b as createA2UIRegistry, c as createCustomRegistry, f as createJsonRenderActivityConfig, t as tdesignRegistry, e as withA2UIBinding, w as withStableProps } from '../../../../_chunks/dep-688e4aaa.js';
+import '../catalog/atomic/card.js';
+import '../catalog/atomic/text.js';
+import '../catalog/atomic/layout.js';
+import '@babel/runtime/helpers/typeof';
+import '@babel/runtime/helpers/objectWithoutProperties';
+import 'tdesign-react';
+import '../renderer/JsonRenderActivityRenderer.js';
+import '../renderer/JsonUIRenderer.js';
+import '../contexts/index.js';
+import '../contexts/data.js';
+import '@babel/runtime/helpers/classCallCheck';
+import '@babel/runtime/helpers/createClass';
+import '@babel/runtime/helpers/possibleConstructorReturn';
+import '@babel/runtime/helpers/getPrototypeOf';
+import '@babel/runtime/helpers/inherits';
+import '../../../../_chunks/dep-de8ac730.js';
+import '@babel/runtime/helpers/wrapNativeSuper';
+import '@json-render/core';
+import '../contexts/store.js';
+import '../contexts/visibility.js';
+import '../contexts/actions.js';
+import '@babel/runtime/helpers/asyncToGenerator';
+import '@babel/runtime/regenerator';
+import '../contexts/validation.js';
+import '../contexts/tree.js';
+import '../renderer/A2UIJsonRenderActivityRenderer.js';
+import '../../../core/index.js';
+import '../../../core/adapters/agui/index.js';
+import '@babel/runtime/helpers/toConsumableArray';
+import '../../../core/adapters/agui/event-mapper.js';
+import '../../../core/adapters/agui/types/index.js';
+import 'zod';
+import '../../../core/adapters/agui/StateManager.js';
+import '../../../core/utils/index.js';
+import '../../../core/utils/immutable-patch.js';
+import '@babel/runtime/helpers/toArray';
+import '../../../core/adapters/agui/ActivityManager.js';
+import '../../../core/adapters/agui/utils.js';
+import '../../../core/store/message.js';
+import '@babel/runtime/helpers/get';
+import '../../../core/store/reactiveState.js';
+import '../../../core/event-bus/index.js';
+import '../../../core/event-bus/ChatEventBus.js';
+import '../../../core/event-bus/types.js';
+import '../../../core/processor/index.js';
+import '../../../core/server/index.js';
+import '../../../core/server/llm-service.js';
+import '../../../core/utils/logger.js';
+import '../../../core/server/batch-client.js';
+import '../../../core/utils/eventEmitter.js';
+import '../../../core/server/errors.js';
+import '../../../core/server/sse-client.js';
+import '../../../core/server/connection-manager.js';
+import '../../../core/server/sse-parser.js';
+import '../../../core/server/types.js';
+import '../../../core/adapters/index.js';
+import '../../../core/adapters/json-render/index.js';
+import '../../../core/adapters/json-render/a2ui-to-jsonrender.js';
+import '../../../core/adapters/json-render/types/a2ui.js';
+import '../../../core/adapters/json-render/SurfaceStateManager.js';
+import '../../../core/adapters/json-render/types/index.js';
+import '../../../core/adapters/json-render/types/core.js';
+import '../catalog/catalog-to-prompt.js';
+//# sourceMappingURL=index.js.map

package/es/chat-engine/components/json-render/registry/index.js.map

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

package/es/chat-engine/components/json-render/renderer/A2UIJsonRenderActivityRenderer.d.ts

@@ -0,0 +1,35 @@
+/**
+ * A2UI v0.9 + json-render Activity 渲染器
+ * 将 A2UI v0.9 协议转换为 json-render Schema 进行渲染
+ *
+ * 工作流程：
+ * 1. 接收 ACTIVITY_SNAPSHOT/DELTA 中的 A2UI content
+ * 2. 区分消息类型：UI型 vs 纯数据型
+ * 3. UI型：转换为 Schema 并注册到 SurfaceStateManager，渲染 UI
+ * 4. 纯数据型：通过 SurfaceStateManager 更新数据，触发订阅者重渲染，本组件不渲染
+ *
+ * 消息分类：
+ * - UI型消息：包含 createSurface / updateComponents / deleteSurface → 需要渲染/更新 UI
+ * - 纯数据型消息：仅包含 updateDataModel → 只更新状态，不渲染新 UI
+ */
+import React from 'react';
+import type { A2UIMessage } from '../../../core';
+import type { JsonRenderActivityProps, ComponentRegistry } from '../types';
+export interface A2UIJsonRenderActivityRendererProps extends Omit<JsonRenderActivityProps, 'content'> {
+    /** A2UI content（包含 messages 数组） */
+    content: {
+        messages?: A2UIMessage[];
+        [key: string]: any;
+    };
+    /** 组件注册表（必须） */
+    registry: ComponentRegistry;
+    /** Action 处理器（可选） */
+    actionHandlers?: Record<string, (params: Record<string, unknown>) => void | Promise<void>>;
+    /** 显示调试信息 */
+    debug?: boolean;
+}
+/**
+ * A2UI v0.9 + json-render Activity 渲染器组件
+ */
+export declare const A2UIJsonRenderActivityRenderer: React.FC<A2UIJsonRenderActivityRendererProps>;
+export default A2UIJsonRenderActivityRenderer;