@ant-design/agentic-ui 2.30.22 → 2.30.24

package/dist/MarkdownRenderer/types.d.ts

@@ -4,76 +4,34 @@ import type { MarkdownEditorPlugin } from '../MarkdownEditor/plugin';
 import type { MarkdownEditorProps } from '../MarkdownEditor/types';
 import type { AttachmentFile } from '../MarkdownInputField/AttachmentButton/types';
 import type { FileMapViewProps } from '../MarkdownInputField/FileMapView';
-/**
- * FileMapView 相关配置，透传给 agentic-ui-filemap 代码块渲染器，
- * 方便在 markdownRenderConfig 中统一配置图片回显行为。
- */
+/** 透传给 agentic-ui-filemap 代码块渲染器的配置 */
 export interface FileMapConfig {
-    /**
-     * 预览文件回调，透传给 FileMapView.onPreview。
-     * 对图片：点击缩略图时触发，传入则阻止 antd Image 内置灯箱；
-     * 对视频：传入则阻止内置弹窗；对普通文件：传入则阻止默认 window.open。
-     */
+    /** 传入则阻止内置预览（灯箱/弹窗/window.open） */
     onPreview?: (file: AttachmentFile) => void;
-    /**
-     * 自定义每个媒体条目（图片/视频）的渲染，透传给 FileMapView.itemRender，
-     * 常用于回显场景。
-     */
+    /** 自定义媒体条目渲染 */
     itemRender?: FileMapViewProps['itemRender'];
-    /**
-     * 自定义文件数据规范化函数，用于将 agentic-ui-filemap 代码块中的原始 JSON 条目
-     * 转换为 AttachmentFile 对象。
-     *
-     * 适用于服务端返回的字段名与 AttachmentFile 不一致（如 fileUrl → url、
-     * fileId → uuid）或需要在数据层补充额外字段的场景。
-     *
-     * @param raw - 代码块 JSON 中的原始文件对象（未经处理）
-     * @param defaultFile - 由内置逻辑生成的默认 AttachmentFile，可在此基础上做局部覆盖
-     * @returns 转换后的 AttachmentFile；返回 null 时该条目将被过滤掉
-     *
-     * @example
-     * ```tsx
-     * fileMapConfig={{
-     *   normalizeFile: (raw, defaultFile) => ({
-     *     ...defaultFile,
-     *     url: raw.fileUrl as string,
-     *     uuid: raw.fileId as string,
-     *   }),
-     * }}
-     * ```
-     */
+    /** 将原始 JSON 条目转为 AttachmentFile，返回 null 过滤该条目 */
     normalizeFile?: (raw: Record<string, unknown>, defaultFile: AttachmentFile) => AttachmentFile | null;
 }
 export interface MarkdownRendererEleProps {
-    /** HTML tag name, e.g. 'p', 'h1', 'blockquote', 'pre' */
     tagName: string;
-    /** The original hast node */
     node?: any;
-    /** Rendered children */
     children?: React.ReactNode;
     [key: string]: any;
 }
 export interface CharacterQueueOptions {
-    /** 每帧输出的最大字符数，默认 3 */
+    /** 默认 3 */
     charsPerFrame?: number;
-    /**
-     * 是否启用 CharacterQueue 逐字输出（RAF 驱动）。
-     * MarkdownRenderer 流式默认合并为 `false`，避免每帧全量重解析导致整页闪动；需打字机时再设为 `true`。
-     */
+    /** 流式时默认合并为 false，需打字机时设 true */
     animate?: boolean;
-    /**
-     * 仅对末尾 N 个字符做动画，前面内容立即展示。
-     * 设为 50 时，每次 push 只对最后 50 字逐字输出，避免整段逐字动画。
-     * 默认 undefined 表示整段动画（原有行为）。
-     */
+    /** 仅对末尾 N 字做动画，前面内容立即展示 */
     animateTailChars?: number;
-    /** 动画速度因子，1.0 为标准速度 */
+    /** 速度因子，默认 1.0 */
     speed?: number;
-    /** 内容完成后立即 flush 全部剩余 */
     flushOnComplete?: boolean;
-    /** 后台 tick 间隔（ms），默认 100 */
+    /** 默认 100ms */
     backgroundInterval?: number;
-    /** 后台每次 tick 的字符数倍率，默认 10 */
+    /** 默认 10 */
     backgroundBatchMultiplier?: number;
 }
 export type { RendererPlugin } from '../MarkdownEditor/plugin';
@@ -84,65 +42,35 @@ export interface RendererBlockProps {
 }
 export type RenderMode = 'slate' | 'markdown';
 export interface MarkdownRendererProps {
-    /** 完整的 markdown 内容（流式场景下持续增长） */
     content: string;
-    /** 是否处于流式状态 */
     streaming?: boolean;
-    /** 流式完成 */
     isFinished?: boolean;
-    /** 字符队列配置 */
     queueOptions?: CharacterQueueOptions;
-    /** 插件配置（用于自定义块渲染） */
     plugins?: MarkdownEditorPlugin[];
-    /** markdownToHtml 的额外 remark/rehype 插件 */
     remarkPlugins?: MarkdownRemarkPlugin[];
-    /** HTML 渲染配置 */
     htmlConfig?: MarkdownToHtmlConfig;
-    /** 类名 */
     className?: string;
-    /** 样式 */
     style?: React.CSSProperties;
-    /** 类名前缀 */
     prefixCls?: string;
-    /** 代码块配置，与 MarkdownEditor `codeProps` 对齐（含 `render` 覆盖） */
     codeProps?: MarkdownEditorProps['codeProps'];
-    /** 脚注配置，与 MarkdownEditor `fncProps` 对齐 */
     fncProps?: MarkdownEditorProps['fncProps'];
-    /** 链接配置 */
     linkConfig?: {
-        /** 是否在新标签页打开链接，默认 true */
+        /** 默认 true */
         openInNewTab?: boolean;
-        /** 自定义链接点击处理，返回 false 可阻止默认跳转 */
+        /** 返回 false 阻止跳转 */
         onClick?: (url?: string) => boolean | void;
     };
-    /**
-     * 流式时是否为生长中的末段启用淡入（AnimationText）。
-     * 默认 false，避免重解析时整页闪动；需要段落入场效果时再设为 true。
-     */
+    /** 末段淡入动画，默认开启；传 false 关闭 */
     streamingParagraphAnimation?: boolean;
-    /** Apaasify / Schema 自定义渲染 */
     apaasify?: {
         enable?: boolean;
-        /** 自定义渲染函数，接收解析后的 JSON value，返回 React 节点 */
         render?: (value: any) => React.ReactNode;
     };
-    /**
-     * FileMapView 配置，透传给 agentic-ui-filemap 代码块渲染器。
-     * 可在 markdownRenderConfig 中统一配置图片 onPreview 和 itemRender。
-     */
     fileMapConfig?: FileMapConfig;
-    /**
-     * 自定义元素渲染函数（markdown 渲染模式）
-     * 与 Slate 模式的 eleItemRender 对应，允许拦截并替换任意块级/行内元素的渲染结果。
-     * @param props - 元素属性（tagName、node、children 等）
-     * @param defaultDom - 默认渲染结果
-     * @returns 自定义渲染节点，或 undefined 时回退到 defaultDom
-     */
+    /** 返回 undefined 回退默认渲染 */
     eleRender?: (props: MarkdownRendererEleProps, defaultDom: React.ReactNode) => React.ReactNode;
 }
 export interface MarkdownRendererRef {
-    /** 获取渲染容器的 DOM 元素 */
     nativeElement: HTMLDivElement | null;
-    /** 获取当前显示的内容 */
     getDisplayedContent: () => string;
 }

package/dist/MarkdownRenderer/useStreaming.d.ts

@@ -16,14 +16,5 @@ export declare enum StreamCacheTokenType {
     Table = "table",
     InlineCode = "inline-code"
 }
-/**
- * 流式 Markdown 缓存 hook。
- *
- * 逐字符扫描输入，识别不完整的 Markdown token（link、image、table、emphasis 等），
- * 将已完成的内容输出，不完整的部分暂缓，避免 parser 错误解析。
- *
- * @param input - 完整的 markdown 内容（持续增长）
- * @param enabled - 是否启用流式缓存（非流式直接透传）
- * @returns 安全的可解析 markdown 字符串
- */
+/** 流式 token 缓存——暂缓不完整的 link/image/table 等，避免 parser 错误解析 */
 export declare const useStreaming: (input: string, enabled: boolean) => string;

package/dist/MarkdownRenderer/useStreaming.js

@@ -303,16 +303,7 @@ var isInCodeBlock = function isInCodeBlock(text) {
     }
     return inFenced;
 };
-/**
- * 流式 Markdown 缓存 hook。
- *
- * 逐字符扫描输入，识别不完整的 Markdown token（link、image、table、emphasis 等），
- * 将已完成的内容输出，不完整的部分暂缓，避免 parser 错误解析。
- *
- * @param input - 完整的 markdown 内容（持续增长）
- * @param enabled - 是否启用流式缓存（非流式直接透传）
- * @returns 安全的可解析 markdown 字符串
- */ export var useStreaming = function useStreaming(input, enabled) {
+/** 流式 token 缓存——暂缓不完整的 link/image/table 等，避免 parser 错误解析 */ export var useStreaming = function useStreaming(input, enabled) {
     var _useState = _sliced_to_array(useState(''), 2), output = _useState[0], setOutput = _useState[1];
     var cacheRef = useRef(getInitialCache());
     var processStreaming = useCallback(function(text) {
@@ -420,11 +411,12 @@ var isInCodeBlock = function isInCodeBlock(text) {
             cacheRef.current = getInitialCache();
             return;
         }
-        if (enabled) {
-            processStreaming(input);
-        } else {
+        if (!enabled) {
             setOutput(input);
+            cacheRef.current = getInitialCache();
+            return;
         }
+        processStreaming(input);
     }, [
         input,
         enabled,

package/dist/ThoughtChainList/MarkdownEditor.d.ts

@@ -1,40 +1,6 @@
 import React from 'react';
 import { MarkdownEditorProps } from '../MarkdownEditor';
-/**
- * MarkdownEditorUpdate 组件 - Markdown 编辑器更新组件
- *
- * 该组件是对 MarkdownEditor 的封装，提供自动更新和格式化功能。
- * 主要用于在思维链中显示和更新 Markdown 内容。
- *
- * @component
- * @description Markdown 编辑器更新组件，提供自动更新和格式化功能
- * @param {MarkdownEditorProps & {isFinished?: boolean}} props - 组件属性
- * @param {boolean} [props.isFinished] - 内容是否已完成
- * @param {string} [props.initValue] - 初始内容
- * @param {boolean} [props.typewriter] - 是否启用打字机效果
- * @param {MarkdownEditorProps} props - 其他 MarkdownEditor 属性
- *
- * @example
- * ```tsx
- * import { MarkdownEditorUpdate } from './MarkdownEditor';
- *
- * <MarkdownEditorUpdate
- *   initValue="# Hello World"
- *   isFinished={true}
- *   typewriter={false}
- * />
- * ```
- *
- * @returns {React.ReactElement} 渲染的 Markdown 编辑器组件
- *
- * @remarks
- * - 自动格式化 Markdown 内容
- * - 支持内容完成状态检测
- * - 提供打字机效果
- * - 只读模式
- * - 自动更新节点列表
- * - 响应式布局
- */
+/** 思维链中的 MarkdownEditor 封装，自动格式化 + 流式更新 */
 export declare const MarkdownEditorUpdate: (props: MarkdownEditorProps & {
     isFinished?: boolean;
 }) => React.JSX.Element;

package/dist/ThoughtChainList/MarkdownEditor.js

@@ -53,52 +53,13 @@ function _object_spread_props(target, source) {
 import React, { useEffect } from "react";
 import { MarkdownEditor, parserMdToSchema } from "../MarkdownEditor";
 import { MarkdownFormatter } from "../Plugins/formatter";
-/**
- * 将内容转换为列表格式的 Markdown
- * @param {string} content - 原始内容
- * @returns {string} 转换后的内容
- */ var toListMarkdown = function toListMarkdown(content) {
-    return content;
-};
-/**
- * MarkdownEditorUpdate 组件 - Markdown 编辑器更新组件
- *
- * 该组件是对 MarkdownEditor 的封装，提供自动更新和格式化功能。
- * 主要用于在思维链中显示和更新 Markdown 内容。
- *
- * @component
- * @description Markdown 编辑器更新组件，提供自动更新和格式化功能
- * @param {MarkdownEditorProps & {isFinished?: boolean}} props - 组件属性
- * @param {boolean} [props.isFinished] - 内容是否已完成
- * @param {string} [props.initValue] - 初始内容
- * @param {boolean} [props.typewriter] - 是否启用打字机效果
- * @param {MarkdownEditorProps} props - 其他 MarkdownEditor 属性
- *
- * @example
- * ```tsx
- * import { MarkdownEditorUpdate } from './MarkdownEditor';
- *
- * <MarkdownEditorUpdate
- *   initValue="# Hello World"
- *   isFinished={true}
- *   typewriter={false}
- * />
- * ```
- *
- * @returns {React.ReactElement} 渲染的 Markdown 编辑器组件
- *
- * @remarks
- * - 自动格式化 Markdown 内容
- * - 支持内容完成状态检测
- * - 提供打字机效果
- * - 只读模式
- * - 自动更新节点列表
- * - 响应式布局
- */ export var MarkdownEditorUpdate = function MarkdownEditorUpdate(props) {
+/** 思维链中的 MarkdownEditor 封装，自动格式化 + 流式更新 */ export var MarkdownEditorUpdate = function MarkdownEditorUpdate(props) {
+    var _props_streaming;
     var editorRef = React.useRef();
     useEffect(function() {
         var _editorRef_current_store, _editorRef_current;
-        (_editorRef_current = editorRef.current) === null || _editorRef_current === void 0 ? void 0 : (_editorRef_current_store = _editorRef_current.store) === null || _editorRef_current_store === void 0 ? void 0 : _editorRef_current_store.updateNodeList(parserMdToSchema(toListMarkdown(MarkdownFormatter.format(props.initValue || '') || '').trim(), props.plugins).schema);
+        var formatted = MarkdownFormatter.format(props.initValue || '') || '';
+        (_editorRef_current = editorRef.current) === null || _editorRef_current === void 0 ? void 0 : (_editorRef_current_store = _editorRef_current.store) === null || _editorRef_current_store === void 0 ? void 0 : _editorRef_current_store.updateNodeList(parserMdToSchema(formatted.trim(), props.plugins).schema);
     }, [
         props.initValue
     ]);
@@ -126,7 +87,7 @@ import { MarkdownFormatter } from "../Plugins/formatter";
             showLineNumbers: false
         }
     }, props), {
-        typewriter: props.typewriter && !props.isFinished,
+        streaming: ((_props_streaming = props.streaming) !== null && _props_streaming !== void 0 ? _props_streaming : props.typewriter) && !props.isFinished,
         initValue: ""
     }));
 };

package/dist/Workspace/RealtimeFollow/index.d.ts

@@ -12,6 +12,9 @@ export interface RealtimeFollowData {
     title?: string;
     subTitle?: string;
     icon?: React.ComponentType;
+    /** 流式输出模式，同时传入时优先于 typewriter */
+    streaming?: boolean;
+    /** @deprecated 请使用 streaming */
     typewriter?: boolean;
     rightContent?: React.ReactNode;
     loadingRender?: React.ReactNode | (() => React.ReactNode);

package/dist/Workspace/RealtimeFollow/index.js

@@ -268,7 +268,7 @@ var Overlay = function Overlay(param) {
  * ```
  */ export var RealtimeFollow = function RealtimeFollow(param) {
     var data = param.data, _param_htmlViewMode = param.htmlViewMode, htmlViewMode = _param_htmlViewMode === void 0 ? 'preview' : _param_htmlViewMode, prefixCls = param.prefixCls, hashId = param.hashId;
-    var _data_typewriter, _data_content;
+    var _ref, _data_streaming, _data_content;
     var _data_markdownEditorProps;
     var getPrefixCls = useContext(ConfigProvider.ConfigContext).getPrefixCls;
     var finalPrefixCls = prefixCls || getPrefixCls('workspace-realtime');
@@ -282,13 +282,14 @@ var Overlay = function Overlay(param) {
         ]
     }), autoScrollRef = _useAutoScroll.containerRef, scrollToBottom = _useAutoScroll.scrollToBottom;
     useEffect(function() {
+        var _data_streaming;
         var _mdInstance_current;
         if (isTestEnv || !((_mdInstance_current = mdInstance.current) === null || _mdInstance_current === void 0 ? void 0 : _mdInstance_current.store)) return;
         if (!shouldUpdateEditor(data.type, htmlViewMode)) return;
         var content = getContentForEditor(data.type, data.content);
         var schema = parserMdToSchema(content, mdInstance.current.store.plugins).schema;
         mdInstance.current.store.updateNodeList(schema);
-        if (data.typewriter && !isTestEnv) {
+        if (((_data_streaming = data.streaming) !== null && _data_streaming !== void 0 ? _data_streaming : data.typewriter) && !isTestEnv) {
             setTimeout(function() {
                 return scrollToBottom();
             }, SCROLL_DELAY);
@@ -298,6 +299,7 @@ var Overlay = function Overlay(param) {
         data.type,
         htmlViewMode,
         isTestEnv,
+        data.streaming,
         data.typewriter,
         scrollToBottom
     ]);
@@ -338,7 +340,7 @@ var Overlay = function Overlay(param) {
     }
     var defaultProps = getEditorConfig(data.type);
     var mergedProps = _object_spread_props(_object_spread({}, defaultProps, data.markdownEditorProps), {
-        typewriter: isTestEnv ? false : (_data_typewriter = data.typewriter) !== null && _data_typewriter !== void 0 ? _data_typewriter : defaultProps.typewriter,
+        streaming: isTestEnv ? false : (_ref = (_data_streaming = data.streaming) !== null && _data_streaming !== void 0 ? _data_streaming : data.typewriter) !== null && _ref !== void 0 ? _ref : defaultProps.typewriter,
         style: _object_spread({
             maxHeight: 'auto'
         }, defaultProps.style, (_data_markdownEditorProps = data.markdownEditorProps) === null || _data_markdownEditorProps === void 0 ? void 0 : _data_markdownEditorProps.style)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ant-design/agentic-ui",
-  "version": "2.30.22",
+  "version": "2.30.24",
   "description": "面向智能体的 UI 组件库，提供多步推理可视化、工具调用展示、任务执行协同等 Agentic UI 能力",
   "repository": "git@github.com:ant-design/agentic-ui.git",
   "license": "MIT",
@@ -23,8 +23,8 @@
     "lint": "pnpm run lint:es && pnpm run lint:css",
     "lint:css": "stylelint \"{src,test}/**/*.{css,less}\"",
     "lint:es": "eslint \"{src,test}/**/*.{js,jsx,ts,tsx}\"",
+    "playwright:install": "playwright install --with-deps chromium",
     "prepare": "husky install && dumi setup",
-    "prepublishOnly": "npm run build && npm run test",
     "prettier": "prettier --write \"{src,docs,test}/**/*.{js,jsx,ts,tsx,css,less,json,md}\"",
     "preview": "pnpm dumi preview",
     "report:demo": "node scripts/generateDemoReport.js",