@ant-design/agentic-ui 2.30.5 → 2.30.6

package/dist/Bubble/MessagesContent/MarkdownPreview.js

@@ -125,20 +125,22 @@ import { MessagesContext } from "./BubbleContext";
         var _content_includes, _htmlRef_current, _htmlRef_current1, _props_markdownRenderConfig, _props_originData, _props_originData1, _props_originData2, _props_markdownRenderConfig1, _props_markdownRenderConfig2, _props_markdownRenderConfig3;
         // MarkdownRenderer 渲染路径——轻量，不创建 Slate 实例
         if (renderMode === 'markdown') {
-            var _props_originData3, _props_markdownRenderConfig4, _props_markdownRenderConfig5, _props_markdownRenderConfig6, _props_markdownRenderConfig7;
+            var _props_originData3, _props_markdownRenderConfig4, _props_markdownRenderConfig5, _props_markdownRenderConfig6, _props_markdownRenderConfig7, _props_markdownRenderConfig8, _props_markdownRenderConfig9;
             return /*#__PURE__*/ React.createElement(MarkdownRenderer, {
                 content: content,
                 streaming: typing,
                 isFinished: (_props_originData3 = props.originData) === null || _props_originData3 === void 0 ? void 0 : _props_originData3.isFinished,
                 plugins: (_props_markdownRenderConfig4 = props.markdownRenderConfig) === null || _props_markdownRenderConfig4 === void 0 ? void 0 : _props_markdownRenderConfig4.plugins,
+                queueOptions: (_props_markdownRenderConfig5 = props.markdownRenderConfig) === null || _props_markdownRenderConfig5 === void 0 ? void 0 : _props_markdownRenderConfig5.queueOptions,
+                streamingParagraphAnimation: (_props_markdownRenderConfig6 = props.markdownRenderConfig) === null || _props_markdownRenderConfig6 === void 0 ? void 0 : _props_markdownRenderConfig6.streamingParagraphAnimation,
                 fncProps: fncProps,
                 style: _object_spread({
                     maxWidth: standalone ? '100%' : undefined,
                     padding: isPaddingHidden ? 0 : undefined,
                     margin: isPaddingHidden ? 0 : undefined
-                }, ((_props_markdownRenderConfig5 = props.markdownRenderConfig) === null || _props_markdownRenderConfig5 === void 0 ? void 0 : _props_markdownRenderConfig5.style) || {}),
-                codeProps: (_props_markdownRenderConfig6 = props.markdownRenderConfig) === null || _props_markdownRenderConfig6 === void 0 ? void 0 : _props_markdownRenderConfig6.codeProps,
-                apaasify: (_props_markdownRenderConfig7 = props.markdownRenderConfig) === null || _props_markdownRenderConfig7 === void 0 ? void 0 : _props_markdownRenderConfig7.apaasify
+                }, ((_props_markdownRenderConfig7 = props.markdownRenderConfig) === null || _props_markdownRenderConfig7 === void 0 ? void 0 : _props_markdownRenderConfig7.style) || {}),
+                codeProps: (_props_markdownRenderConfig8 = props.markdownRenderConfig) === null || _props_markdownRenderConfig8 === void 0 ? void 0 : _props_markdownRenderConfig8.codeProps,
+                apaasify: (_props_markdownRenderConfig9 = props.markdownRenderConfig) === null || _props_markdownRenderConfig9 === void 0 ? void 0 : _props_markdownRenderConfig9.apaasify
             });
         }
         // Slate 渲染路径——保持向后兼容

package/dist/MarkdownEditor/types.d.ts

@@ -4,7 +4,7 @@ import React from 'react';
 import { BaseEditor, Editor, Selection } from 'slate';
 import { HistoryEditor } from 'slate-history';
 import { ReactEditor, RenderElementProps } from 'slate-react';
-import type { RenderMode } from '../MarkdownRenderer/types';
+import type { CharacterQueueOptions, RenderMode } from '../MarkdownRenderer/types';
 import { TagPopupProps } from './editor/elements/TagPopup';
 import { EditorStore } from './editor/store';
 import { InsertAutocompleteProps } from './editor/tools/InsertAutocomplete';
@@ -473,6 +473,16 @@ export type MarkdownEditorProps = {
         /** 自定义链接渲染函数 */
         onClick?: (url?: string) => boolean | void;
     };
+    /**
+     * MarkdownRenderer 字符队列（仅 `renderMode: 'markdown'` 只读预览时生效）
+     * @description 默认关闭逐字 RAF；需要打字机时再设 `{ animate: true, animateTailChars: 50 }` 等
+     */
+    queueOptions?: CharacterQueueOptions;
+    /**
+     * 流式 Markdown 末段淡入（仅 `renderMode: 'markdown'` 时传给 MarkdownRenderer）
+     * @description 默认 false；设为 true 时末段使用 AnimationText 入场，可能在高频更新时产生闪动
+     */
+    streamingParagraphAnimation?: boolean;
     /**
      * 依赖数组
      * @description 用于控制 MElement 组件是否刷新的依赖数组。当 deps 数组内容发生变化时，MElement 会重新渲染

package/dist/MarkdownRenderer/AnimationText.d.ts

@@ -4,6 +4,11 @@ export interface AnimationConfig {
     fadeDuration?: number;
     /** 缓动函数，默认 ease-out */
     easing?: string;
+    /**
+     * 已废弃：单段入场动画模式下不再按 chunk 瘦身 DOM，保留仅为类型兼容
+     * @deprecated
+     */
+    collapseThreshold?: number;
 }
 export interface AnimationTextProps {
     children: React.ReactNode;
@@ -12,9 +17,7 @@ export interface AnimationTextProps {
 /**
  * 流式文字淡入动画组件。
  *
- * 采用 opacity + translateY（GPU 硬件加速），清爽流派。
- * 同一段流式前缀追加只触发**一次**入场动画；后续增量仅更新文案。内容被替换
- * （非前缀增长）时重新播放入场。动画结束后仍用 span 包裹以保持布局稳定。
+ * 同一段流式前缀追加（或尾部截断修正）只触发一次入场动画；非前缀替换时重播。
  */
 declare const AnimationText: React.NamedExoticComponent<AnimationTextProps>;
 export default AnimationText;

package/dist/MarkdownRenderer/AnimationText.js

@@ -57,34 +57,21 @@ import React, { useEffect, useMemo, useRef, useState } from "react";
     }
     return '';
 };
-/**
- * 识别 children 中是否包含 React 元素节点。
- * 富文本结构（链接、脚注、图片等）在纯文本差分下会丢失结构信息，直接透传更安全。
- */ var hasElementNode = function hasElementNode1(children) {
-    if (children === null || children === undefined || typeof children === 'boolean') return false;
-    if (typeof children === 'string' || typeof children === 'number') return false;
-    if (Array.isArray(children)) return children.some(hasElementNode);
-    return /*#__PURE__*/ React.isValidElement(children);
+/** 流式同一段内：前后文案仅「前缀关系」变化（增长或尾部截断修正） */ var isStreamingCompatible = function isStreamingCompatible(prev, next) {
+    return prev.startsWith(next) || next.startsWith(prev);
 };
 /**
  * 流式文字淡入动画组件。
  *
- * 采用 opacity + translateY（GPU 硬件加速），清爽流派。
- * 同一段流式前缀追加只触发**一次**入场动画；后续增量仅更新文案。内容被替换
- * （非前缀增长）时重新播放入场。动画结束后仍用 span 包裹以保持布局稳定。
+ * 同一段流式前缀追加（或尾部截断修正）只触发一次入场动画；非前缀替换时重播。
  */ var AnimationText = /*#__PURE__*/ React.memo(function(param) {
     var children = param.children, animationConfig = param.animationConfig;
-    var _ref = animationConfig || {}, _ref_fadeDuration = _ref.fadeDuration, fadeDuration = _ref_fadeDuration === void 0 ? 200 : _ref_fadeDuration, _ref_easing = _ref.easing, easing = _ref_easing === void 0 ? 'ease-out' : _ref_easing;
+    var _ref = animationConfig || {}, _ref_fadeDuration = _ref.fadeDuration, fadeDuration = _ref_fadeDuration === void 0 ? 250 : _ref_fadeDuration, _ref_easing = _ref.easing, easing = _ref_easing === void 0 ? 'ease-out' : _ref_easing;
     var _useState = _sliced_to_array(useState(false), 2), animComplete = _useState[0], setAnimComplete = _useState[1];
     var _useState1 = _sliced_to_array(useState(0), 2), animSession = _useState1[0], setAnimSession = _useState1[1];
     var prevTextRef = useRef('');
     var text = extractText(children);
-    var hasElementContent = hasElementNode(children);
     useEffect(function() {
-        if (hasElementContent) {
-            prevTextRef.current = text;
-            return;
-        }
         if (text === prevTextRef.current) return;
         var prev = prevTextRef.current;
         if (!prev) {
@@ -93,7 +80,7 @@ import React, { useEffect, useMemo, useRef, useState } from "react";
             setAnimComplete(false);
             return;
         }
-        if (text.length > prev.length && text.startsWith(prev)) {
+        if (isStreamingCompatible(prev, text)) {
             prevTextRef.current = text;
             return;
         }
@@ -103,8 +90,7 @@ import React, { useEffect, useMemo, useRef, useState } from "react";
         });
         prevTextRef.current = text;
     }, [
-        text,
-        hasElementContent
+        text
     ]);
     var handleAnimationEnd = function handleAnimationEnd() {
         return setAnimComplete(true);
@@ -120,15 +106,12 @@ import React, { useEffect, useMemo, useRef, useState } from "react";
         fadeDuration,
         easing
     ]);
-    /** 动画结束后仍用 inline-block 包裹，避免从 span 变为裸内容时的宽度重排 */ var doneChunkStyle = useMemo(function() {
+    var doneChunkStyle = useMemo(function() {
         return {
             display: 'inline-block',
             color: 'inherit'
         };
     }, []);
-    if (hasElementContent) {
-        return /*#__PURE__*/ React.createElement(React.Fragment, null, children);
-    }
     return animComplete ? /*#__PURE__*/ React.createElement("span", {
         style: doneChunkStyle
     }, children) : /*#__PURE__*/ React.createElement("span", {

package/dist/MarkdownRenderer/MarkdownRenderer.js

@@ -236,7 +236,7 @@ var SCHEMA_LANGUAGES = new Set([
  * - Markdown → hast → React 元素树（hast-util-to-jsx-runtime）
  * - 特殊块（code / mermaid / chart / katex）通过组件映射拦截渲染
  */ var InternalMarkdownRenderer = /*#__PURE__*/ forwardRef(function(props, ref) {
-    var content = props.content, _props_streaming = props.streaming, streaming = _props_streaming === void 0 ? false : _props_streaming, isFinished = props.isFinished, queueOptions = props.queueOptions, plugins = props.plugins, remarkPlugins = props.remarkPlugins, htmlConfig = props.htmlConfig, className = props.className, style = props.style, customPrefixCls = props.prefixCls, linkConfig = props.linkConfig, apaasify = props.apaasify;
+    var content = props.content, _props_streaming = props.streaming, streaming = _props_streaming === void 0 ? false : _props_streaming, isFinished = props.isFinished, queueOptions = props.queueOptions, plugins = props.plugins, remarkPlugins = props.remarkPlugins, htmlConfig = props.htmlConfig, className = props.className, style = props.style, customPrefixCls = props.prefixCls, linkConfig = props.linkConfig, streamingParagraphAnimation = props.streamingParagraphAnimation, apaasify = props.apaasify;
     var getPrefixCls = useContext(ConfigProvider.ConfigContext).getPrefixCls;
     // 复用 MarkdownEditor 的 CSS 前缀和样式，保持渲染一致性
     var prefixCls = getPrefixCls('agentic-md-editor', customPrefixCls);
@@ -249,6 +249,7 @@ var SCHEMA_LANGUAGES = new Set([
     var containerRef = useRef(null);
     var _useState = _sliced_to_array(useState(content || ''), 2), displayedContent = _useState[0], setDisplayedContent = _useState[1];
     var queueRef = useRef(null);
+    /** 与 CharacterQueue 构造参数同步，避免 queueOptions 变更后仍用旧队列行为 */ var queueOptsSigRef = useRef('');
     useImperativeHandle(ref, function() {
         return {
             nativeElement: containerRef.current,
@@ -263,10 +264,12 @@ var SCHEMA_LANGUAGES = new Set([
     }, [
         plugins
     ]);
-    // 字符队列管理：流式时仅对最后 50 字做动画，避免每段逐字输出
+    // 字符队列：默认关闭逐字动画，避免 RAF 每帧全量重解析 Markdown 导致整页闪动。
+    // 需要打字机效果时显式传入 queueOptions={{ animate: true, animateTailChars?: number }}。
     var resolvedQueueOptions = useMemo(function() {
         return streaming ? _object_spread({
-            animateTailChars: 50
+            animate: false,
+            animateTailChars: undefined
         }, queueOptions) : queueOptions;
     }, [
         streaming,
@@ -274,17 +277,23 @@ var SCHEMA_LANGUAGES = new Set([
     ]);
     useEffect(function() {
         if (!streaming) {
-            // 非流式：直接展示全部内容
+            var _queueRef_current;
             setDisplayedContent(content || '');
+            (_queueRef_current = queueRef.current) === null || _queueRef_current === void 0 ? void 0 : _queueRef_current.dispose();
+            queueRef.current = null;
+            queueOptsSigRef.current = '';
             return;
         }
-        if (!queueRef.current) {
+        var sig = JSON.stringify(resolvedQueueOptions !== null && resolvedQueueOptions !== void 0 ? resolvedQueueOptions : {});
+        if (!queueRef.current || sig !== queueOptsSigRef.current) {
+            var _queueRef_current1;
+            (_queueRef_current1 = queueRef.current) === null || _queueRef_current1 === void 0 ? void 0 : _queueRef_current1.dispose();
             queueRef.current = new CharacterQueue(function(displayed) {
                 return setDisplayedContent(displayed);
             }, resolvedQueueOptions);
+            queueOptsSigRef.current = sig;
         }
         queueRef.current.push(content || '');
-        return undefined;
     }, [
         content,
         streaming,
@@ -347,7 +356,8 @@ var SCHEMA_LANGUAGES = new Set([
         components: components,
         prefixCls: prefixCls,
         linkConfig: linkConfig,
-        streaming: streaming
+        streaming: streaming,
+        streamingParagraphAnimation: streamingParagraphAnimation
     });
     return wrapVarSSR(wrapSSR(wrapContentSSR(/*#__PURE__*/ React.createElement("div", {
         ref: containerRef,
@@ -359,7 +369,7 @@ var SCHEMA_LANGUAGES = new Set([
             display: 'block'
         }
     }, /*#__PURE__*/ React.createElement("div", {
-        className: clsx(contentCls, hashId),
+        className: clsx(contentCls, "".concat(contentCls, "-markdown-readonly"), hashId),
         style: {
             whiteSpace: 'normal',
             wordWrap: 'normal'

package/dist/MarkdownRenderer/StreamingAnimationContext.d.ts

@@ -0,0 +1,6 @@
+import React from 'react';
+/** 仅末块为 true：流式 Markdown 只对「当前生长块」播放入场，避免全页段落/表格单元格一起闪动 */
+export interface StreamingAnimationContextValue {
+    animateBlock: boolean;
+}
+export declare const StreamingAnimationContext: React.Context<StreamingAnimationContextValue | null>;

package/dist/MarkdownRenderer/StreamingAnimationContext.js

@@ -0,0 +1,2 @@
+import React from "react";
+export var StreamingAnimationContext = /*#__PURE__*/ React.createContext(null);

package/dist/MarkdownRenderer/types.d.ts

@@ -4,7 +4,10 @@ import type { MarkdownEditorPlugin } from '../MarkdownEditor/plugin';
 export interface CharacterQueueOptions {
     /** 每帧输出的最大字符数，默认 3 */
     charsPerFrame?: number;
-    /** 是否启用打字动画，默认 true（流式时） */
+    /**
+     * 是否启用 CharacterQueue 逐字输出（RAF 驱动）。
+     * MarkdownRenderer 流式默认合并为 `false`，避免每帧全量重解析导致整页闪动；需打字机时再设为 `true`。
+     */
     animate?: boolean;
     /**
      * 仅对末尾 N 个字符做动画，前面内容立即展示。
@@ -65,6 +68,11 @@ export interface MarkdownRendererProps {
         /** 自定义链接点击处理，返回 false 可阻止默认跳转 */
         onClick?: (url?: string) => boolean | void;
     };
+    /**
+     * 流式时是否为生长中的末段启用淡入（AnimationText）。
+     * 默认 false，避免重解析时整页闪动；需要段落入场效果时再设为 true。
+     */
+    streamingParagraphAnimation?: boolean;
     /** Apaasify / Schema 自定义渲染 */
     apaasify?: {
         enable?: boolean;

package/dist/MarkdownRenderer/useMarkdownToReact.d.ts

@@ -14,6 +14,11 @@ interface UseMarkdownToReactOptions {
     };
     /** 是否处于流式状态，用于最后一个块的打字动画 */
     streaming?: boolean;
+    /**
+     * 流式时是否对「生长中的末段」启用段落淡入（AnimationText）。
+     * 默认 false：重解析时频繁触发动画易导致整页闪动；需要时再显式传入 true。
+     */
+    streamingParagraphAnimation?: boolean;
 }
 export declare const useMarkdownToReact: (content: string, options?: UseMarkdownToReactOptions) => React.ReactNode;
 /**

package/dist/MarkdownRenderer/useMarkdownToReact.js

@@ -122,7 +122,7 @@ function _unsupported_iterable_to_array(o, minLen) {
 }
 import { Checkbox, Image } from "antd";
 import { toJsxRuntime } from "hast-util-to-jsx-runtime";
-import React, { useMemo, useRef } from "react";
+import React, { useContext, useMemo, useRef } from "react";
 import { Fragment, jsx, jsxs } from "react/jsx-runtime";
 import rehypeKatex from "rehype-katex";
 import rehypeRaw from "rehype-raw";
@@ -141,6 +141,7 @@ import { REMARK_REHYPE_DIRECTIVE_HANDLERS } from "../MarkdownEditor/editor/utils
 import { parseChineseCurrencyToNumber } from "../Plugins/chart/utils";
 import { ToolUseBarThink } from "../ToolUseBarThink";
 import AnimationText from "./AnimationText";
+import { StreamingAnimationContext } from "./StreamingAnimationContext";
 var INLINE_MATH_WITH_SINGLE_DOLLAR = {
     singleDollarTextMath: true
 };
@@ -432,14 +433,26 @@ var extractLanguageFromClassName = function extractLanguageFromClassName(classNa
  *
  * MarkdownEditor 的 Slate 元素使用 data-be 属性和 prefixCls 类名，
  * 这里为原生 HTML 标签添加相同的属性，使共用的 CSS 能正确命中。
- */ var buildEditorAlignedComponents = function buildEditorAlignedComponents(prefixCls, userComponents, streaming, linkConfig) {
+ */ var buildEditorAlignedComponents = function buildEditorAlignedComponents(prefixCls, userComponents, streaming, linkConfig, streamingParagraphAnimation) {
     var listCls = "".concat(prefixCls, "-list");
     var tableCls = "".concat(prefixCls, "-content-table");
     var contentCls = prefixCls; // e.g. ant-agentic-md-editor-content
+    /** 仅当 streaming、末块动画上下文允许且显式开启段落动画时包 AnimationText */ var StreamAnimWrap = function StreamAnimWrap(param) {
+        var children = param.children;
+        var _ref;
+        var ctx = useContext(StreamingAnimationContext);
+        var animateBlock = (_ref = ctx === null || ctx === void 0 ? void 0 : ctx.animateBlock) !== null && _ref !== void 0 ? _ref : true;
+        var allow = !!streaming && animateBlock && !!streamingParagraphAnimation;
+        if (!allow) return children;
+        return jsx(AnimationText, {
+            children: children
+        });
+    };
+    StreamAnimWrap.displayName = 'StreamAnimWrap';
     var wrapAnimation = function wrapAnimation(children) {
-        return streaming ? jsx(AnimationText, {
+        return jsx(StreamAnimWrap, {
             children: children
-        }) : children;
+        });
     };
     return _object_spread({
         // ================================================================
@@ -464,7 +477,7 @@ var extractLanguageFromClassName = function extractLanguageFromClassName(classNa
             return jsx('h1', _object_spread_props(_object_spread({}, rest), {
                 'data-be': 'head',
                 'data-testid': 'markdown-heading-1',
-                children: wrapAnimation(children)
+                children: children
             }));
         },
         h2: function h2(props) {
@@ -475,7 +488,7 @@ var extractLanguageFromClassName = function extractLanguageFromClassName(classNa
             return jsx('h2', _object_spread_props(_object_spread({}, rest), {
                 'data-be': 'head',
                 'data-testid': 'markdown-heading-2',
-                children: wrapAnimation(children)
+                children: children
             }));
         },
         h3: function h3(props) {
@@ -486,7 +499,7 @@ var extractLanguageFromClassName = function extractLanguageFromClassName(classNa
             return jsx('h3', _object_spread_props(_object_spread({}, rest), {
                 'data-be': 'head',
                 'data-testid': 'markdown-heading-3',
-                children: wrapAnimation(children)
+                children: children
             }));
         },
         h4: function h4(props) {
@@ -497,7 +510,7 @@ var extractLanguageFromClassName = function extractLanguageFromClassName(classNa
             return jsx('h4', _object_spread_props(_object_spread({}, rest), {
                 'data-be': 'head',
                 'data-testid': 'markdown-heading-4',
-                children: wrapAnimation(children)
+                children: children
             }));
         },
         h5: function h5(props) {
@@ -508,7 +521,7 @@ var extractLanguageFromClassName = function extractLanguageFromClassName(classNa
             return jsx('h5', _object_spread_props(_object_spread({}, rest), {
                 'data-be': 'head',
                 'data-testid': 'markdown-heading-5',
-                children: wrapAnimation(children)
+                children: children
             }));
         },
         h6: function h6(props) {
@@ -519,7 +532,7 @@ var extractLanguageFromClassName = function extractLanguageFromClassName(classNa
             return jsx('h6', _object_spread_props(_object_spread({}, rest), {
                 'data-be': 'head',
                 'data-testid': 'markdown-heading-6',
-                children: wrapAnimation(children)
+                children: children
             }));
         },
         blockquote: function blockquote(props) {
@@ -607,7 +620,7 @@ var extractLanguageFromClassName = function extractLanguageFromClassName(classNa
                 className: "".concat(listCls, "-item"),
                 'data-be': 'list-item',
                 'data-testid': 'markdown-list-item',
-                children: wrapAnimation(children)
+                children: children
             }));
         },
         table: function table(props) {
@@ -686,7 +699,7 @@ var extractLanguageFromClassName = function extractLanguageFromClassName(classNa
                     whiteSpace: 'normal',
                     maxWidth: '20%'
                 },
-                children: wrapAnimation(children)
+                children: children
             }));
         },
         // input[type=checkbox]：task list 的 checkbox（兜底，主逻辑在 li 中）
@@ -1061,13 +1074,31 @@ var extractLanguageFromClassName = function extractLanguageFromClassName(classNa
         }
     }, userComponents);
 };
+/**
+ * 在 hast 上标记「最后一个 p」，用于流式时仅该段落播放入场（单块长文时避免全页 p 一起闪）
+ */ var markLastParagraphStreamingTail = function markLastParagraphStreamingTail(hast) {
+    var paragraphs = [];
+    visit(hast, 'element', function(node) {
+        if (node.tagName === 'p') {
+            paragraphs.push(node);
+        }
+    });
+    var last = paragraphs[paragraphs.length - 1];
+    if (last) {
+        last.properties = last.properties || {};
+        last.properties.dataStreamingTail = true;
+    }
+};
 /**
  * 将单个 markdown 片段转为 React 元素（内部函数）
- */ var renderMarkdownBlock = function renderMarkdownBlock(blockContent, processor, components) {
+ */ var renderMarkdownBlock = function renderMarkdownBlock(blockContent, processor, components, blockOpts) {
     if (!blockContent.trim()) return null;
     try {
         var mdast = processor.parse(blockContent);
         var hast = processor.runSync(mdast);
+        if (blockOpts === null || blockOpts === void 0 ? void 0 : blockOpts.markStreamingTailParagraph) {
+            markLastParagraphStreamingTail(hast);
+        }
         return toJsxRuntime(hast, {
             Fragment: Fragment,
             jsx: jsx,
@@ -1079,62 +1110,47 @@ var extractLanguageFromClassName = function extractLanguageFromClassName(classNa
         return null;
     }
 };
-/** 流式未闭合围栏内，空行后的下一行是否仍像围栏内代码（JSON 等）延续 */ var lineLooksLikeFenceCodeContinuation = function lineLooksLikeFenceCodeContinuation(rawLine) {
-    var t = rawLine.trimStart();
-    if (!t) {
-        return true;
-    }
-    if (t.startsWith('```') || t.startsWith('~~~')) {
-        return true;
-    }
-    var c = t[0];
-    return c === '{' || c === '}' || c === '[' || c === ']' || c === '"' || c === "'" || c === '`' || c === '-' || c === ',' || c >= '0' && c <= '9';
-};
 /**
  * 将 markdown 按块（双换行）拆分，尊重代码围栏边界。
  * 返回的每个块是一个独立的 markdown 片段，可单独解析。
- *
- * 流式且围栏未闭合时，inFence 会一直为 true，段间 `\n\n` 在按行拆分时只出现一个空行，
- * 无法用「连续两个空行」检测。此时在空行处前瞻下一行：若不像围栏内代码延续则虚拟闭合围栏，
- * 使末块能变为非末块且缓存键与先前一致。
- */ var splitMarkdownBlocks = function splitMarkdownBlocks(content, streaming) {
+ */ var splitMarkdownBlocks = function splitMarkdownBlocks(content) {
     var lines = content.split('\n');
     var blocks = [];
     var current = [];
     var inFence = false;
-    for(var i = 0; i < lines.length; i += 1){
-        var line = lines[i];
-        var trimmed = line.trimStart();
-        if (trimmed.startsWith('```') || trimmed.startsWith('~~~')) {
-            inFence = !inFence;
-        }
-        if (streaming && inFence && line === '' && current.length > 0) {
-            var prev = current[current.length - 1];
-            var nextLine = lines[i + 1];
-            var doubleBlankInsideFence = prev === '';
-            var blankThenNonCodeLine = prev !== '' && nextLine !== undefined && nextLine.trim() !== '' && !lineLooksLikeFenceCodeContinuation(nextLine);
-            if (doubleBlankInsideFence || blankThenNonCodeLine) {
-                var body = current;
-                while(body.length > 0 && body[body.length - 1] === ''){
-                    body = body.slice(0, -1);
-                }
-                if (body.length > 0) {
-                    blocks.push(body.join('\n'));
+    var _iteratorNormalCompletion = true, _didIteratorError = false, _iteratorError = undefined;
+    try {
+        for(var _iterator = lines[Symbol.iterator](), _step; !(_iteratorNormalCompletion = (_step = _iterator.next()).done); _iteratorNormalCompletion = true){
+            var line = _step.value;
+            var trimmed = line.trimStart();
+            if (trimmed.startsWith('```') || trimmed.startsWith('~~~')) {
+                inFence = !inFence;
+            }
+            if (!inFence && line === '' && current.length > 0) {
+                var prev = current[current.length - 1];
+                if (prev === '') {
+                    // 触发分割的是「第二个连续空行」，不应并入上一块末尾，否则与单块解析结果字符串不一致、缓存失效
+                    var withoutTrailingBlank = current.slice(0, -1);
+                    blocks.push(withoutTrailingBlank.join('\n'));
+                    current = [];
+                    continue;
                 }
-                current = [];
-                inFence = false;
-                continue;
             }
+            current.push(line);
         }
-        if (!inFence && line === '' && current.length > 0) {
-            var prev1 = current[current.length - 1];
-            if (prev1 === '') {
-                blocks.push(current.join('\n'));
-                current = [];
-                continue;
+    } catch (err) {
+        _didIteratorError = true;
+        _iteratorError = err;
+    } finally{
+        try {
+            if (!_iteratorNormalCompletion && _iterator.return != null) {
+                _iterator.return();
+            }
+        } finally{
+            if (_didIteratorError) {
+                throw _iteratorError;
             }
         }
-        current.push(line);
     }
     if (current.length > 0) {
         blocks.push(current.join('\n'));
@@ -1181,12 +1197,13 @@ export var useMarkdownToReact = function useMarkdownToReact(content, options) {
     var prefixCls = (options === null || options === void 0 ? void 0 : options.prefixCls) || 'ant-agentic-md-editor';
     var components = useMemo(function() {
         var userComponents = (options === null || options === void 0 ? void 0 : options.components) || {};
-        return buildEditorAlignedComponents(prefixCls, userComponents, options === null || options === void 0 ? void 0 : options.streaming, options === null || options === void 0 ? void 0 : options.linkConfig);
+        return buildEditorAlignedComponents(prefixCls, userComponents, options === null || options === void 0 ? void 0 : options.streaming, options === null || options === void 0 ? void 0 : options.linkConfig, options === null || options === void 0 ? void 0 : options.streamingParagraphAnimation);
     }, [
         prefixCls,
         options === null || options === void 0 ? void 0 : options.components,
         options === null || options === void 0 ? void 0 : options.streaming,
-        options === null || options === void 0 ? void 0 : options.linkConfig
+        options === null || options === void 0 ? void 0 : options.linkConfig,
+        options === null || options === void 0 ? void 0 : options.streamingParagraphAnimation
     ]);
     return useMemo(function() {
         if (!content) {
@@ -1201,11 +1218,20 @@ export var useMarkdownToReact = function useMarkdownToReact(content, options) {
         prevContentRef.current = content;
         try {
             var preprocessed = content.replace(new RegExp(JINJA_DOLLAR_PLACEHOLDER, 'g'), '$');
-            var blocks = splitMarkdownBlocks(preprocessed, options === null || options === void 0 ? void 0 : options.streaming);
+            var blocks = splitMarkdownBlocks(preprocessed);
             if (blocks.length === 0) return null;
             var cache = blockCacheRef.current;
             var newCache = new Map();
             var elements = [];
+            var wrapBlockScope = function wrapBlockScope(node, key, animateBlock) {
+                return jsx(StreamingAnimationContext.Provider, {
+                    key: key,
+                    value: {
+                        animateBlock: animateBlock
+                    },
+                    children: node
+                });
+            };
             var KEY_PREFIX_LEN = 64;
             for(var i = 0; i < blocks.length; i++){
                 var block = blocks[i];
@@ -1220,9 +1246,7 @@ export var useMarkdownToReact = function useMarkdownToReact(content, options) {
                     var cached = cache.get(block);
                     if (cached && cached.source === block) {
                         newCache.set(block, cached);
-                        elements.push(jsx(Fragment, {
-                            children: cached.element
-                        }, stableKey));
+                        elements.push(wrapBlockScope(cached.element, stableKey, false));
                         continue;
                     }
                 }
@@ -1233,22 +1257,20 @@ export var useMarkdownToReact = function useMarkdownToReact(content, options) {
                             source: lastBlockRef.current.source,
                             element: lastBlockRef.current.element
                         });
-                        elements.push(jsx(Fragment, {
-                            children: lastBlockRef.current.element
-                        }, stableKey));
+                        elements.push(wrapBlockScope(lastBlockRef.current.element, stableKey, !!(options === null || options === void 0 ? void 0 : options.streaming)));
                         continue;
                     }
                 }
-                var element = renderMarkdownBlock(block, processor, components);
+                var element = renderMarkdownBlock(block, processor, components, {
+                    markStreamingTailParagraph: isLast && !!(options === null || options === void 0 ? void 0 : options.streaming)
+                });
                 var entry = {
                     source: block,
                     element: element
                 };
                 newCache.set(block, entry);
                 if (isLast) lastBlockRef.current = entry;
-                elements.push(jsx(Fragment, {
-                    children: element
-                }, stableKey));
+                elements.push(wrapBlockScope(element, stableKey, isLast && !!(options === null || options === void 0 ? void 0 : options.streaming)));
             }
             blockCacheRef.current = newCache;
             return jsxs(Fragment, {
@@ -1275,7 +1297,7 @@ export var useMarkdownToReact = function useMarkdownToReact(content, options) {
         var mdast = processor.parse(preprocessed);
         var hast = processor.runSync(mdast);
         var userComps = components || {};
-        var allComponents = buildEditorAlignedComponents('ant-agentic-md-editor', userComps, false);
+        var allComponents = buildEditorAlignedComponents('ant-agentic-md-editor', userComps, false, undefined, false);
         return toJsxRuntime(hast, {
             Fragment: Fragment,
             jsx: jsx,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@ant-design/agentic-ui",
-  "version": "2.30.5",
+  "version": "2.30.6",
   "description": "面向智能体的 UI 组件库，提供多步推理可视化、工具调用展示、任务执行协同等 Agentic UI 能力",
   "repository": "git@github.com:ant-design/agentic-ui.git",
   "license": "MIT",
@@ -24,7 +24,6 @@
     "lint:css": "stylelint \"{src,test}/**/*.{css,less}\"",
     "lint:es": "eslint \"{src,test}/**/*.{js,jsx,ts,tsx}\"",
     "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",