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

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

@@ -0,0 +1 @@
+{"version":3,"file":"engine.js","sources":["../../../../../pro-components/chat/chat-engine/components/json-render/engine.ts"],"sourcesContent":["/**\n * json-render 引擎封装\n * 提供高性能的增量渲染能力\n */\n\nimport type { UIElement } from '@json-render/core';\nimport type { ComponentRegistry } from './renderer';\nimport type { JsonRenderSchema, DeltaInfo } from './types';\n\n/**\n * json-render 引擎管理器\n * 负责 Schema 缓存、增量更新和性能优化\n */\nexport class JsonRenderEngine {\n  private currentSchema: JsonRenderSchema | null = null;\n  private registry: ComponentRegistry;\n\n  constructor(registry: ComponentRegistry) {\n    this.registry = registry;\n  }\n\n  /**\n   * 全量渲染\n   * 用于 ACTIVITY_SNAPSHOT 事件\n   */\n  setSchema(schema: JsonRenderSchema): void {\n    this.currentSchema = schema;\n  }\n\n  /**\n   * 获取当前 Schema\n   */\n  getSchema(): JsonRenderSchema | null {\n    return this.currentSchema;\n  }\n\n  /**\n   * 增量更新\n   * 用于 ACTIVITY_DELTA 事件\n   * \n   * @param newSchema 应用 JSON Patch 后的完整 Schema\n   * @param deltaInfo 增量信息（可选，用于进一步优化）\n   */\n  patchSchema(newSchema: JsonRenderSchema, deltaInfo?: DeltaInfo): void {\n    if (!this.currentSchema) {\n      // 如果没有初始 Schema，直接设置\n      this.currentSchema = newSchema;\n      return;\n    }\n\n    // 更新 Schema（json-render 的 Renderer 会自动处理 diff）\n    this.currentSchema = newSchema;\n\n    // 如果有 deltaInfo，可以在这里做进一步优化\n    if (deltaInfo) {\n      console.debug('[json-render] 增量更新范围:', deltaInfo);\n      // 未来可以基于 deltaInfo 实现更细粒度的优化\n    }\n  }\n\n  /**\n   * 重置引擎状态\n   */\n  reset(): void {\n    this.currentSchema = null;\n  }\n\n  /**\n   * 获取组件注册表\n   */\n  getRegistry(): ComponentRegistry {\n    return this.registry;\n  }\n\n  /**\n   * 更新组件注册表\n   */\n  updateRegistry(registry: ComponentRegistry): void {\n    this.registry = { ...this.registry, ...registry };\n  }\n\n  /**\n   * 验证 Schema 是否有效\n   */\n  validateSchema(schema: JsonRenderSchema): boolean {\n    if (!schema || !schema.root || !schema.elements) {\n      console.error('[json-render] Schema 验证失败：缺少 root 或 elements');\n      return false;\n    }\n\n    const rootElement = schema.elements[schema.root];\n    if (!rootElement) {\n      console.error('[json-render] Schema 验证失败：root 元素不存在');\n      return false;\n    }\n\n    return true;\n  }\n\n  /**\n   * 提取增量元素（基于 deltaInfo）\n   * 用于性能优化场景\n   */\n  extractDeltaElements(schema: JsonRenderSchema, deltaInfo: DeltaInfo): Record<string, UIElement> {\n    const elementKeys = Object.keys(schema.elements);\n    const deltaKeys = elementKeys.slice(deltaInfo.fromIndex, deltaInfo.toIndex);\n    \n    const deltaElements: Record<string, UIElement> = {};\n    deltaKeys.forEach((key) => {\n      deltaElements[key] = schema.elements[key];\n    });\n    \n    return deltaElements;\n  }\n}\n\n/**\n * 创建 json-render 引擎实例\n */\nexport function createJsonRenderEngine(registry: ComponentRegistry): JsonRenderEngine {\n  return new JsonRenderEngine(registry);\n}\n"],"names":["JsonRenderEngine","registry","_classCallCheck","_defineProperty","_createClass","key","value","setSchema","schema","currentSchema","getSchema","patchSchema","newSchema","deltaInfo","console","debug","reset","getRegistry","updateRegistry","validateSchema","root","elements","error","rootElement","extractDeltaElements","elementKeys","Object","keys","deltaKeys","slice","fromIndex","toIndex","deltaElements","forEach","createJsonRenderEngine"],"mappings":"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"}

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

@@ -0,0 +1,34 @@
+/**
+ * json-render 集成模块入口
+ * 导出所有核心 API 和类型
+ */
+export { JsonRenderActivityRenderer } from './JsonRenderActivityRenderer';
+export type { JsonRenderActivityRendererProps } from './JsonRenderActivityRenderer';
+export { A2UIJsonRenderActivityRenderer } from './A2UIJsonRenderActivityRenderer';
+export type { A2UIJsonRenderActivityRendererProps } from './A2UIJsonRenderActivityRenderer';
+export { JsonRenderEngine, createJsonRenderEngine } from './engine';
+export { PerformanceMonitor, globalPerformanceMonitor, checkPerformance, PERFORMANCE_THRESHOLDS, } from './performance';
+export type { PerformanceMetrics } from './performance';
+export type { JsonRenderSchema, ComponentCatalog, JsonRenderContext, DeltaInfo, JsonRenderActivityProps, A2UIAdapterConfig, } from './types';
+export { createCustomRegistry, tdesignRegistry, withStableProps } from './catalog/index';
+export type { CreateCustomRegistryOptions } from './catalog/index';
+export { tdesignCatalog, createCustomCatalog, tdesignComponentList, tdesignActionList, } from './catalog/index';
+export type { Catalog } from '@json-render/core';
+export { a2uiRegistry, createA2UIRegistry, A2UITextField, A2UIButton } from './catalog/index';
+export { withA2UIBinding } from './catalog/index';
+export type { A2UIBindingConfig } from './catalog/index';
+export { JsonRenderButton } from './catalog/button';
+export { JsonRenderInput } from './catalog/input';
+export { JsonRenderCard } from './catalog/card';
+export { JsonRenderRow, JsonRenderCol, JsonRenderSpace, JsonRenderDivider, } from './catalog/layout';
+export { createJsonRenderActivityConfig, defaultJsonRenderActivityConfig, createA2UIJsonRenderActivityConfig, defaultA2UIJsonRenderActivityConfig, } from './config';
+export type { JsonRenderActivityConfigOptions } from './config';
+export * from './adapters';
+export { surfaceStateManager, SurfaceStateManager } from './SurfaceStateManager';
+export type { SurfaceCache, SurfaceSubscriber } from './SurfaceStateManager';
+export { createJsonRenderActivityConfig as default } from './config';
+export { DataProvider, useData, useDataValue, useDataBinding, type DataContextValue, type DataProviderProps, } from "./contexts/data";
+export { VisibilityProvider, useVisibility, useIsVisible, type VisibilityContextValue, type VisibilityProviderProps, } from "./contexts/visibility";
+export { ActionProvider, useActions, useAction, ConfirmDialog, type ActionContextValue, type ActionProviderProps, type PendingConfirmation, type ConfirmDialogProps, } from "./contexts/actions";
+export { ValidationProvider, useValidation, useFieldValidation, type ValidationContextValue, type ValidationProviderProps, type FieldValidationState, } from "./contexts/validation";
+export { Renderer, JSONUIProvider, createRendererFromCatalog, type ComponentRenderProps, type ComponentRenderer, type ComponentRegistry, type RendererProps, type JSONUIProviderProps, } from "./renderer";

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

@@ -0,0 +1,36 @@
+/**
+ * tdesign v1.0.2-alpha.15
+ * (c) 2026 tdesign
+ * @license MIT
+ */
+
+export { e as A2UIButton, A as A2UIJsonRenderActivityRenderer, d as A2UITextField, J as JsonRenderActivityRenderer, g as JsonRenderInput, a as a2uiRegistry, j as createA2UIJsonRenderActivityConfig, b as createA2UIRegistry, c as createCustomRegistry, h as createJsonRenderActivityConfig, h as default, k as defaultA2UIJsonRenderActivityConfig, i as defaultJsonRenderActivityConfig, t as tdesignRegistry, f as withA2UIBinding, w as withStableProps } from '../../../_chunks/dep-f2051ebd.js';
+export { JsonRenderEngine, createJsonRenderEngine } from './engine.js';
+export { PERFORMANCE_THRESHOLDS, PerformanceMonitor, checkPerformance, globalPerformanceMonitor } from './performance.js';
+export { JsonRenderButton } from './catalog/button.js';
+export { JsonRenderCard } from './catalog/card.js';
+export { JsonRenderCol, JsonRenderDivider, JsonRenderRow, JsonRenderSpace } from './catalog/layout.js';
+import './adapters/index.js';
+export { SurfaceStateManager, surfaceStateManager } from './SurfaceStateManager.js';
+export { DataProvider, useData, useDataBinding, useDataValue } from './contexts/data.js';
+export { VisibilityProvider, useIsVisible, useVisibility } from './contexts/visibility.js';
+export { ActionProvider, ConfirmDialog, useAction, useActions } from './contexts/actions.js';
+export { ValidationProvider, useFieldValidation, useValidation } from './contexts/validation.js';
+export { JSONUIProvider, Renderer, createRendererFromCatalog } from './renderer.js';
+export { createCustomCatalog, tdesignActionList, tdesignCatalog, tdesignComponentList } from './catalog.js';
+export { default as A2UIAdapter, applyA2UIDataUpdate, applyA2UIUpdates, convertA2UIMessagesToJsonRender } from './adapters/a2ui-to-jsonrender.js';
+import 'react';
+import '@babel/runtime/helpers/typeof';
+import '@babel/runtime/helpers/slicedToArray';
+import '@babel/runtime/helpers/defineProperty';
+import '@babel/runtime/helpers/objectWithoutProperties';
+import 'tdesign-react';
+import '@json-render/core';
+import './catalog/text.js';
+import '@babel/runtime/helpers/classCallCheck';
+import '@babel/runtime/helpers/createClass';
+import '@babel/runtime/helpers/toConsumableArray';
+import '@babel/runtime/helpers/asyncToGenerator';
+import '@babel/runtime/regenerator';
+import 'zod';
+//# sourceMappingURL=index.js.map

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

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

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

@@ -0,0 +1,91 @@
+/**
+ * json-render 性能监控和优化工具
+ */
+/**
+ * 性能指标
+ */
+export interface PerformanceMetrics {
+    /** 渲染类型 */
+    type: 'snapshot' | 'delta';
+    /** 渲染开始时间 */
+    startTime: number;
+    /** 渲染结束时间 */
+    endTime: number;
+    /** 渲染耗时（ms） */
+    duration: number;
+    /** Schema 元素数量 */
+    elementCount: number;
+    /** 增量信息（仅 delta 类型） */
+    deltaInfo?: {
+        fromIndex: number;
+        toIndex: number;
+        newElementsCount: number;
+    };
+}
+/**
+ * 性能监控器
+ */
+export declare class PerformanceMonitor {
+    private metrics;
+    private maxMetricsCount;
+    /**
+     * 开始性能测量
+     */
+    start(): () => PerformanceMetrics;
+    /**
+     * 添加性能指标
+     */
+    private addMetric;
+    /**
+     * 获取所有指标
+     */
+    getMetrics(): PerformanceMetrics[];
+    /**
+     * 获取平均渲染时间
+     */
+    getAverageDuration(type?: 'snapshot' | 'delta'): number;
+    /**
+     * 获取最近 N 次渲染的平均时间
+     */
+    getRecentAverageDuration(count?: number): number;
+    /**
+     * 获取性能统计摘要
+     */
+    getSummary(): {
+        totalRenders: number;
+        snapshotRenders: number;
+        deltaRenders: number;
+        avgSnapshotDuration: number;
+        avgDeltaDuration: number;
+        recentAvgDuration: number;
+    };
+    /**
+     * 重置所有指标
+     */
+    reset(): void;
+    /**
+     * 打印性能摘要
+     */
+    printSummary(): void;
+}
+/**
+ * 全局性能监控实例
+ */
+export declare const globalPerformanceMonitor: PerformanceMonitor;
+/**
+ * 性能警告阈值（ms）
+ */
+export declare const PERFORMANCE_THRESHOLDS: {
+    snapshot: number;
+    delta: number;
+};
+/**
+ * 检查性能并发出警告
+ */
+export declare function checkPerformance(metric: PerformanceMetrics): void;
+declare const _default: {
+    PerformanceMonitor: typeof PerformanceMonitor;
+    globalPerformanceMonitor: PerformanceMonitor;
+    checkPerformance: typeof checkPerformance;
+};
+export default _default;

package/es/chat-engine/components/json-render/performance.js

@@ -0,0 +1,135 @@
+/**
+ * tdesign v1.0.2-alpha.15
+ * (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 (type, elementCount, deltaInfo) {
+        var endTime = performance.now();
+        var duration = endTime - startTime;
+        var metric = {
+          type: type,
+          startTime: startTime,
+          endTime: endTime,
+          duration: duration,
+          elementCount: elementCount,
+          deltaInfo: deltaInfo ? {
+            fromIndex: deltaInfo.fromIndex,
+            toIndex: deltaInfo.toIndex,
+            newElementsCount: deltaInfo.toIndex - deltaInfo.fromIndex
+          } : void 0
+        };
+        _this.addMetric(metric);
+        return metric;
+      };
+    }
+  }, {
+    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: "getAverageDuration",
+    value: function getAverageDuration(type) {
+      var filteredMetrics = type ? this.metrics.filter(function (m) {
+        return m.type === type;
+      }) : this.metrics;
+      if (filteredMetrics.length === 0) return 0;
+      var totalDuration = filteredMetrics.reduce(function (sum, m) {
+        return sum + m.duration;
+      }, 0);
+      return totalDuration / filteredMetrics.length;
+    }
+  }, {
+    key: "getRecentAverageDuration",
+    value: function getRecentAverageDuration() {
+      var count = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : 10;
+      var recentMetrics = this.metrics.slice(-count);
+      if (recentMetrics.length === 0) return 0;
+      var totalDuration = recentMetrics.reduce(function (sum, m) {
+        return sum + m.duration;
+      }, 0);
+      return totalDuration / recentMetrics.length;
+    }
+  }, {
+    key: "getSummary",
+    value: function getSummary() {
+      return {
+        totalRenders: this.metrics.length,
+        snapshotRenders: this.metrics.filter(function (m) {
+          return m.type === "snapshot";
+        }).length,
+        deltaRenders: this.metrics.filter(function (m) {
+          return m.type === "delta";
+        }).length,
+        avgSnapshotDuration: this.getAverageDuration("snapshot"),
+        avgDeltaDuration: this.getAverageDuration("delta"),
+        recentAvgDuration: this.getRecentAverageDuration()
+      };
+    }
+  }, {
+    key: "reset",
+    value: function reset() {
+      this.metrics = [];
+    }
+  }, {
+    key: "printSummary",
+    value: function printSummary() {
+      var summary = this.getSummary();
+      console.log("[json-render Performance Summary]", {
+        "\u603B\u6E32\u67D3\u6B21\u6570": summary.totalRenders,
+        "\u5FEB\u7167\u6E32\u67D3": summary.snapshotRenders,
+        "\u589E\u91CF\u6E32\u67D3": summary.deltaRenders,
+        "\u5FEB\u7167\u5E73\u5747\u8017\u65F6(ms)": summary.avgSnapshotDuration.toFixed(2),
+        "\u589E\u91CF\u5E73\u5747\u8017\u65F6(ms)": summary.avgDeltaDuration.toFixed(2),
+        "\u6700\u8FD110\u6B21\u5E73\u5747\u8017\u65F6(ms)": summary.recentAvgDuration.toFixed(2)
+      });
+    }
+  }]);
+}();
+var globalPerformanceMonitor = new PerformanceMonitor();
+var PERFORMANCE_THRESHOLDS = {
+  snapshot: 50,
+  delta: 16
+};
+function checkPerformance(metric) {
+  var threshold = PERFORMANCE_THRESHOLDS[metric.type];
+  if (metric.duration > threshold) {
+    console.warn("[json-render Performance Warning] ".concat(metric.type, " \u6E32\u67D3\u8017\u65F6 ").concat(metric.duration.toFixed(2), "ms\uFF0C\u8D85\u8FC7\u9608\u503C ").concat(threshold, "ms"), {
+      elementCount: metric.elementCount,
+      deltaInfo: metric.deltaInfo
+    });
+  }
+}
+var performance$1 = {
+  PerformanceMonitor: PerformanceMonitor,
+  globalPerformanceMonitor: globalPerformanceMonitor,
+  checkPerformance: checkPerformance
+};
+
+export { PERFORMANCE_THRESHOLDS, PerformanceMonitor, checkPerformance, performance$1 as default, globalPerformanceMonitor };
+//# sourceMappingURL=performance.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"performance.js","sources":["../../../../../pro-components/chat/chat-engine/components/json-render/performance.ts"],"sourcesContent":["/**\n * json-render 性能监控和优化工具\n */\n\n/**\n * 性能指标\n */\nexport interface PerformanceMetrics {\n  /** 渲染类型 */\n  type: 'snapshot' | 'delta';\n  /** 渲染开始时间 */\n  startTime: number;\n  /** 渲染结束时间 */\n  endTime: number;\n  /** 渲染耗时（ms） */\n  duration: number;\n  /** Schema 元素数量 */\n  elementCount: number;\n  /** 增量信息（仅 delta 类型） */\n  deltaInfo?: {\n    fromIndex: number;\n    toIndex: number;\n    newElementsCount: number;\n  };\n}\n\n/**\n * 性能监控器\n */\nexport class PerformanceMonitor {\n  private metrics: PerformanceMetrics[] = [];\n  private maxMetricsCount = 100; // 最多保留 100 条记录\n\n  /**\n   * 开始性能测量\n   */\n  start(): () => PerformanceMetrics {\n    const startTime = performance.now();\n    \n    return (\n      type: 'snapshot' | 'delta',\n      elementCount: number,\n      deltaInfo?: { fromIndex: number; toIndex: number },\n    ): PerformanceMetrics => {\n      const endTime = performance.now();\n      const duration = endTime - startTime;\n\n      const metric: PerformanceMetrics = {\n        type,\n        startTime,\n        endTime,\n        duration,\n        elementCount,\n        deltaInfo: deltaInfo\n          ? {\n              fromIndex: deltaInfo.fromIndex,\n              toIndex: deltaInfo.toIndex,\n              newElementsCount: deltaInfo.toIndex - deltaInfo.fromIndex,\n            }\n          : undefined,\n      };\n\n      this.addMetric(metric);\n      return metric;\n    };\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  getAverageDuration(type?: 'snapshot' | 'delta'): number {\n    const filteredMetrics = type\n      ? this.metrics.filter((m) => m.type === type)\n      : this.metrics;\n\n    if (filteredMetrics.length === 0) return 0;\n\n    const totalDuration = filteredMetrics.reduce((sum, m) => sum + m.duration, 0);\n    return totalDuration / filteredMetrics.length;\n  }\n\n  /**\n   * 获取最近 N 次渲染的平均时间\n   */\n  getRecentAverageDuration(count: number = 10): number {\n    const recentMetrics = this.metrics.slice(-count);\n    if (recentMetrics.length === 0) return 0;\n\n    const totalDuration = recentMetrics.reduce((sum, m) => sum + m.duration, 0);\n    return totalDuration / recentMetrics.length;\n  }\n\n  /**\n   * 获取性能统计摘要\n   */\n  getSummary() {\n    return {\n      totalRenders: this.metrics.length,\n      snapshotRenders: this.metrics.filter((m) => m.type === 'snapshot').length,\n      deltaRenders: this.metrics.filter((m) => m.type === 'delta').length,\n      avgSnapshotDuration: this.getAverageDuration('snapshot'),\n      avgDeltaDuration: this.getAverageDuration('delta'),\n      recentAvgDuration: this.getRecentAverageDuration(),\n    };\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.totalRenders,\n      '快照渲染': summary.snapshotRenders,\n      '增量渲染': summary.deltaRenders,\n      '快照平均耗时(ms)': summary.avgSnapshotDuration.toFixed(2),\n      '增量平均耗时(ms)': summary.avgDeltaDuration.toFixed(2),\n      '最近10次平均耗时(ms)': summary.recentAvgDuration.toFixed(2),\n    });\n  }\n}\n\n/**\n * 全局性能监控实例\n */\nexport const globalPerformanceMonitor = new PerformanceMonitor();\n\n/**\n * 性能警告阈值（ms）\n */\nexport const PERFORMANCE_THRESHOLDS = {\n  snapshot: 50, // 快照渲染超过 50ms 发出警告\n  delta: 16, // 增量渲染超过 16ms 发出警告（1帧）\n};\n\n/**\n * 检查性能并发出警告\n */\nexport function checkPerformance(metric: PerformanceMetrics): void {\n  const threshold = PERFORMANCE_THRESHOLDS[metric.type];\n  \n  if (metric.duration > threshold) {\n    console.warn(\n      `[json-render Performance Warning] ${metric.type} 渲染耗时 ${metric.duration.toFixed(2)}ms，超过阈值 ${threshold}ms`,\n      {\n        elementCount: metric.elementCount,\n        deltaInfo: metric.deltaInfo,\n      },\n    );\n  }\n}\n\nexport default {\n  PerformanceMonitor,\n  globalPerformanceMonitor,\n  checkPerformance,\n};\n"],"names":["PerformanceMonitor","_classCallCheck","_defineProperty","_createClass","key","value","start","_this","startTime","performance","now","type","elementCount","deltaInfo","endTime","duration","metric","fromIndex","toIndex","newElementsCount","addMetric","metrics","push","length","maxMetricsCount","shift","getMetrics","_toConsumableArray","getAverageDuration","filteredMetrics","filter","m","totalDuration","reduce","sum","getRecentAverageDuration","count","recentMetrics","slice","getSummary","totalRenders","snapshotRenders","deltaRenders","avgSnapshotDuration","avgDeltaDuration","recentAvgDuration","reset","printSummary","summary","console","log","toFixed","globalPerformanceMonitor","PERFORMANCE_THRESHOLDS","snapshot","delta","checkPerformance","threshold","warn","concat"],"mappings":"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"}

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

@@ -0,0 +1,71 @@
+import { type ComponentType, type ReactNode } from "react";
+import type { UIElement, UITree, Action, Catalog, ComponentDefinition } from "@json-render/core";
+/**
+ * Props passed to component renderers
+ */
+export interface ComponentRenderProps<P = Record<string, unknown>> {
+    /** The element being rendered */
+    element: UIElement<string, P>;
+    /** Rendered children */
+    children?: ReactNode;
+    /** Execute an action */
+    onAction?: (action: Action) => void;
+    /** Whether the parent is loading */
+    loading?: boolean;
+}
+/**
+ * Component renderer type
+ */
+export type ComponentRenderer<P = Record<string, unknown>> = ComponentType<ComponentRenderProps<P>>;
+/**
+ * Registry of component renderers
+ */
+export type ComponentRegistry = Record<string, ComponentRenderer<any>>;
+/**
+ * Props for the Renderer component
+ */
+export interface RendererProps {
+    /** The UI tree to render */
+    tree: UITree | null;
+    /** Component registry */
+    registry: ComponentRegistry;
+    /** Whether the tree is currently loading/streaming */
+    loading?: boolean;
+    /** Fallback component for unknown types */
+    fallback?: ComponentRenderer;
+}
+/**
+ * Main renderer component
+ */
+export declare function Renderer({ tree, registry, loading, fallback }: RendererProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Props for JSONUIProvider
+ */
+export interface JSONUIProviderProps {
+    /** Component registry */
+    registry: ComponentRegistry;
+    /** Initial data model */
+    initialData?: Record<string, unknown>;
+    /** Auth state */
+    authState?: {
+        isSignedIn: boolean;
+        user?: Record<string, unknown>;
+    };
+    /** Action handlers */
+    actionHandlers?: Record<string, (params: Record<string, unknown>) => Promise<unknown> | unknown>;
+    /** Navigation function */
+    navigate?: (path: string) => void;
+    /** Custom validation functions */
+    validationFunctions?: Record<string, (value: unknown, args?: Record<string, unknown>) => boolean>;
+    /** Callback when data changes */
+    onDataChange?: (path: string, value: unknown) => void;
+    children: ReactNode;
+}
+/**
+ * Combined provider for all JSONUI contexts
+ */
+export declare function JSONUIProvider({ registry, initialData, authState, actionHandlers, navigate, validationFunctions, onDataChange, children, }: JSONUIProviderProps): import("react/jsx-runtime").JSX.Element;
+/**
+ * Helper to create a renderer component from a catalog
+ */
+export declare function createRendererFromCatalog<C extends Catalog<Record<string, ComponentDefinition>>>(_catalog: C, registry: ComponentRegistry): ComponentType<Omit<RendererProps, "registry">>;

package/es/chat-engine/components/json-render/renderer.js

@@ -0,0 +1,124 @@
+/**
+ * tdesign v1.0.2-alpha.15
+ * (c) 2026 tdesign
+ * @license MIT
+ */
+
+import _defineProperty from '@babel/runtime/helpers/defineProperty';
+import React from 'react';
+import { useIsVisible, VisibilityProvider } from './contexts/visibility.js';
+import { useActions, ActionProvider, ConfirmDialog } from './contexts/actions.js';
+import { DataProvider } from './contexts/data.js';
+import { ValidationProvider } from './contexts/validation.js';
+import '@json-render/core';
+import '@babel/runtime/helpers/typeof';
+import '@babel/runtime/helpers/slicedToArray';
+import '@babel/runtime/helpers/asyncToGenerator';
+import '@babel/runtime/regenerator';
+import '@babel/runtime/helpers/objectWithoutProperties';
+
+"use client";
+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 ElementRenderer(_ref) {
+  var _registry$element$typ, _element$children;
+  var element = _ref.element,
+    tree = _ref.tree,
+    registry = _ref.registry,
+    loading = _ref.loading,
+    fallback = _ref.fallback;
+  var isVisible = useIsVisible(element.visible);
+  var _useActions = useActions(),
+    execute = _useActions.execute;
+  if (!isVisible) {
+    return null;
+  }
+  var Component = (_registry$element$typ = registry[element.type]) !== null && _registry$element$typ !== void 0 ? _registry$element$typ : fallback;
+  if (!Component) {
+    console.warn("No renderer for component type: ".concat(element.type));
+    return null;
+  }
+  var children = (_element$children = element.children) === null || _element$children === void 0 ? void 0 : _element$children.map(function (childKey) {
+    var childElement = tree.elements[childKey];
+    if (!childElement) {
+      return null;
+    }
+    return /* @__PURE__ */React.createElement(ElementRenderer, {
+      key: childKey,
+      element: childElement,
+      tree: tree,
+      registry: registry,
+      loading: loading,
+      fallback: fallback
+    });
+  });
+  return /* @__PURE__ */React.createElement(Component, {
+    element: element,
+    onAction: execute,
+    loading: loading
+  }, children);
+}
+function Renderer(_ref2) {
+  var tree = _ref2.tree,
+    registry = _ref2.registry,
+    loading = _ref2.loading,
+    fallback = _ref2.fallback;
+  if (!tree || !tree.root) {
+    return null;
+  }
+  var rootElement = tree.elements[tree.root];
+  if (!rootElement) {
+    return null;
+  }
+  return /* @__PURE__ */React.createElement(ElementRenderer, {
+    element: rootElement,
+    tree: tree,
+    registry: registry,
+    loading: loading,
+    fallback: fallback
+  });
+}
+function JSONUIProvider(_ref3) {
+  var registry = _ref3.registry,
+    initialData = _ref3.initialData,
+    authState = _ref3.authState,
+    actionHandlers = _ref3.actionHandlers,
+    navigate = _ref3.navigate,
+    validationFunctions = _ref3.validationFunctions,
+    onDataChange = _ref3.onDataChange,
+    children = _ref3.children;
+  return /* @__PURE__ */React.createElement(DataProvider, {
+    initialData: initialData,
+    authState: authState,
+    onDataChange: onDataChange
+  }, /* @__PURE__ */React.createElement(VisibilityProvider, null, /* @__PURE__ */React.createElement(ActionProvider, {
+    handlers: actionHandlers,
+    navigate: navigate
+  }, /* @__PURE__ */React.createElement(ValidationProvider, {
+    customFunctions: validationFunctions
+  }, children, /* @__PURE__ */React.createElement(ConfirmationDialogManager, null)))));
+}
+function ConfirmationDialogManager() {
+  var _useActions2 = useActions(),
+    pendingConfirmation = _useActions2.pendingConfirmation,
+    confirm = _useActions2.confirm,
+    cancel = _useActions2.cancel;
+  if (!(pendingConfirmation !== null && pendingConfirmation !== void 0 && pendingConfirmation.action.confirm)) {
+    return null;
+  }
+  return /* @__PURE__ */React.createElement(ConfirmDialog, {
+    confirm: pendingConfirmation.action.confirm,
+    onConfirm: confirm,
+    onCancel: cancel
+  });
+}
+function createRendererFromCatalog(_catalog, registry) {
+  return function CatalogRenderer(props) {
+    return /* @__PURE__ */React.createElement(Renderer, _objectSpread(_objectSpread({}, props), {}, {
+      registry: registry
+    }));
+  };
+}
+
+export { JSONUIProvider, Renderer, createRendererFromCatalog };
+//# sourceMappingURL=renderer.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"renderer.js","sources":["../../../../../pro-components/chat/chat-engine/components/json-render/renderer.tsx"],"sourcesContent":["\"use client\";\n\nimport React, { type ComponentType, type ReactNode, useMemo } from \"react\";\nimport type {\n  UIElement,\n  UITree,\n  Action,\n  Catalog,\n  ComponentDefinition,\n} from \"@json-render/core\";\nimport { useIsVisible } from \"./contexts/visibility\";\nimport { useActions } from \"./contexts/actions\";\n\n/**\n * Props passed to component renderers\n */\nexport interface ComponentRenderProps<P = Record<string, unknown>> {\n  /** The element being rendered */\n  element: UIElement<string, P>;\n  /** Rendered children */\n  children?: ReactNode;\n  /** Execute an action */\n  onAction?: (action: Action) => void;\n  /** Whether the parent is loading */\n  loading?: boolean;\n}\n\n/**\n * Component renderer type\n */\nexport type ComponentRenderer<P = Record<string, unknown>> = ComponentType<\n  ComponentRenderProps<P>\n>;\n\n/**\n * Registry of component renderers\n */\nexport type ComponentRegistry = Record<string, ComponentRenderer<any>>;\n\n/**\n * Props for the Renderer component\n */\nexport interface RendererProps {\n  /** The UI tree to render */\n  tree: UITree | null;\n  /** Component registry */\n  registry: ComponentRegistry;\n  /** Whether the tree is currently loading/streaming */\n  loading?: boolean;\n  /** Fallback component for unknown types */\n  fallback?: ComponentRenderer;\n}\n\n/**\n * Element renderer component\n */\nfunction ElementRenderer({\n  element,\n  tree,\n  registry,\n  loading,\n  fallback,\n}: {\n  element: UIElement;\n  tree: UITree;\n  registry: ComponentRegistry;\n  loading?: boolean;\n  fallback?: ComponentRenderer;\n}) {\n  const isVisible = useIsVisible(element.visible);\n  const { execute } = useActions();\n\n  // Don't render if not visible\n  if (!isVisible) {\n    return null;\n  }\n\n  // Get the component renderer\n  const Component = registry[element.type] ?? fallback;\n\n  if (!Component) {\n    console.warn(`No renderer for component type: ${element.type}`);\n    return null;\n  }\n\n  // Render children\n  const children = element.children?.map((childKey) => {\n    const childElement = tree.elements[childKey];\n    if (!childElement) {\n      return null;\n    }\n    return (\n      <ElementRenderer\n        key={childKey}\n        element={childElement}\n        tree={tree}\n        registry={registry}\n        loading={loading}\n        fallback={fallback}\n      />\n    );\n  });\n\n  return (\n    <Component element={element} onAction={execute} loading={loading}>\n      {children}\n    </Component>\n  );\n}\n\n/**\n * Main renderer component\n */\nexport function Renderer({ tree, registry, loading, fallback }: RendererProps) {\n  if (!tree || !tree.root) {\n    return null;\n  }\n\n  const rootElement = tree.elements[tree.root];\n  if (!rootElement) {\n    return null;\n  }\n\n  return (\n    <ElementRenderer\n      element={rootElement}\n      tree={tree}\n      registry={registry}\n      loading={loading}\n      fallback={fallback}\n    />\n  );\n}\n\n/**\n * Props for JSONUIProvider\n */\nexport interface JSONUIProviderProps {\n  /** Component registry */\n  registry: ComponentRegistry;\n  /** Initial data model */\n  initialData?: Record<string, unknown>;\n  /** Auth state */\n  authState?: { isSignedIn: boolean; user?: Record<string, unknown> };\n  /** Action handlers */\n  actionHandlers?: Record<\n    string,\n    (params: Record<string, unknown>) => Promise<unknown> | unknown\n  >;\n  /** Navigation function */\n  navigate?: (path: string) => void;\n  /** Custom validation functions */\n  validationFunctions?: Record<\n    string,\n    (value: unknown, args?: Record<string, unknown>) => boolean\n  >;\n  /** Callback when data changes */\n  onDataChange?: (path: string, value: unknown) => void;\n  children: ReactNode;\n}\n\n// Import the providers\nimport { DataProvider } from \"./contexts/data\";\nimport { VisibilityProvider } from \"./contexts/visibility\";\nimport { ActionProvider } from \"./contexts/actions\";\nimport { ValidationProvider } from \"./contexts/validation\";\nimport { ConfirmDialog } from \"./contexts/actions\";\n\n/**\n * Combined provider for all JSONUI contexts\n */\nexport function JSONUIProvider({\n  registry,\n  initialData,\n  authState,\n  actionHandlers,\n  navigate,\n  validationFunctions,\n  onDataChange,\n  children,\n}: JSONUIProviderProps) {\n  return (\n    <DataProvider\n      initialData={initialData}\n      authState={authState}\n      onDataChange={onDataChange}\n    >\n      <VisibilityProvider>\n        <ActionProvider handlers={actionHandlers} navigate={navigate}>\n          <ValidationProvider customFunctions={validationFunctions}>\n            {children}\n            <ConfirmationDialogManager />\n          </ValidationProvider>\n        </ActionProvider>\n      </VisibilityProvider>\n    </DataProvider>\n  );\n}\n\n/**\n * Renders the confirmation dialog when needed\n */\nfunction ConfirmationDialogManager() {\n  const { pendingConfirmation, confirm, cancel } = useActions();\n\n  if (!pendingConfirmation?.action.confirm) {\n    return null;\n  }\n\n  return (\n    <ConfirmDialog\n      confirm={pendingConfirmation.action.confirm}\n      onConfirm={confirm}\n      onCancel={cancel}\n    />\n  );\n}\n\n/**\n * Helper to create a renderer component from a catalog\n */\nexport function createRendererFromCatalog<\n  C extends Catalog<Record<string, ComponentDefinition>>,\n>(\n  _catalog: C,\n  registry: ComponentRegistry,\n): ComponentType<Omit<RendererProps, \"registry\">> {\n  return function CatalogRenderer(props: Omit<RendererProps, \"registry\">) {\n    return <Renderer {...props} registry={registry} />;\n  };\n}\n"],"names":["ownKeys","e","r","t","Object","keys","getOwnPropertySymbols","o","filter","getOwnPropertyDescriptor","enumerable","push","apply","_objectSpread","arguments","length","forEach","_defineProperty","getOwnPropertyDescriptors","defineProperties","defineProperty","ElementRenderer","_ref","_registry$element$typ","_element$children","element","tree","registry","loading","fallback","isVisible","useIsVisible","visible","_useActions","useActions","execute","Component","type","console","warn","concat","children","map","childKey","childElement","elements","React","createElement","key","onAction","Renderer","_ref2","root","rootElement","JSONUIProvider","_ref3","initialData","authState","actionHandlers","navigate","validationFunctions","onDataChange","DataProvider","VisibilityProvider","ActionProvider","handlers","ValidationProvider","customFunctions","ConfirmationDialogManager","_useActions2","pendingConfirmation","confirm","cancel","action","ConfirmDialog","onConfirm","onCancel","createRendererFromCatalog","_catalog","CatalogRenderer","props"],"mappings":"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"}

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

@@ -0,0 +1,69 @@
+/**
+ * json-render 集成相关类型定义
+ */
+import type { UITree, UIElement } from '@json-render/core';
+import type { ComponentRenderProps, ComponentRegistry } from '@json-render/react';
+/**
+ * json-render Activity 内容格式
+ * 用于 ACTIVITY_SNAPSHOT 和 ACTIVITY_DELTA 事件
+ */
+export interface JsonRenderSchema extends UITree {
+    root: string;
+    elements: Record<string, UIElement>;
+    data?: Record<string, unknown>;
+}
+/**
+ * 组件目录（Catalog）定义
+ * 映射组件类型到 React 组件实现
+ * 使用 @json-render/react 的 ComponentRegistry 类型
+ */
+export type ComponentCatalog = ComponentRegistry;
+export type { ComponentRenderProps };
+/**
+ * 渲染上下文配置
+ */
+export interface JsonRenderContext {
+    /** 渲染模式：direct（直接模式） | adapter（适配模式） */
+    mode: 'direct' | 'adapter';
+    /** 组件目录 */
+    catalog: ComponentCatalog;
+    /** 可选：自定义数据 */
+    customData?: Record<string, unknown>;
+}
+/**
+ * 增量更新信息
+ * 从 event-mapper 的 deltaInfo 传递过来
+ */
+export interface DeltaInfo {
+    /** 新增元素的起始索引 */
+    fromIndex: number;
+    /** 新增元素的结束索引 */
+    toIndex: number;
+}
+/**
+ * json-render Activity 渲染器 Props
+ */
+export interface JsonRenderActivityProps {
+    /** Activity 类型 */
+    activityType: string;
+    /** json-render Schema 内容 */
+    content: JsonRenderSchema;
+    /** 关联的消息 ID */
+    messageId: string;
+    /** 扩展属性（包含 deltaInfo） */
+    ext?: {
+        deltaInfo?: DeltaInfo;
+        [key: string]: any;
+    };
+}
+/**
+ * A2UI → json-render 转换配置
+ */
+export interface A2UIAdapterConfig {
+    /** 启用适配模式 */
+    enabled: boolean;
+    /** 自定义类型映射表 */
+    typeMapping?: Record<string, string>;
+    /** 自定义属性映射 */
+    propsMapping?: Record<string, (value: any) => any>;
+}

package/es/chat-engine/components/json-render/types.js

@@ -0,0 +1,7 @@
+/**
+ * tdesign v1.0.2-alpha.15
+ * (c) 2026 tdesign
+ * @license MIT
+ */
+
+//# sourceMappingURL=types.js.map

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

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