@ant-design/agentic-ui 2.30.6 → 2.30.7

package/dist/MarkdownRenderer/streaming/MarkdownBlockPiece.d.ts

@@ -0,0 +1,15 @@
+import type { Processor } from 'unified';
+import React from 'react';
+export interface MarkdownBlockPieceProps {
+    /** 末块为 tail（生长中）；一旦其后出现新块，同一段内容变为 sealed，保持同一 React key 可避免重组件卸载 */
+    variant: 'sealed' | 'tail';
+    blockSource: string;
+    processor: Processor;
+    components: Record<string, any>;
+    /** 仅末块且处于流式模式时为 true，用于节流与末段动画 */
+    streaming: boolean;
+}
+/**
+ * 统一的块级渲染：封版与末块使用同一组件类型；按 blockSource 缓存解析结果引用，使 tail→sealed 时与旧 Map 缓存一样复用同一棵 React 子树。
+ */
+export declare const MarkdownBlockPiece: React.NamedExoticComponent<MarkdownBlockPieceProps>;

package/dist/MarkdownRenderer/streaming/MarkdownBlockPiece.js

@@ -0,0 +1,61 @@
+import React, { memo, useMemo, useRef } from "react";
+import { renderMarkdownBlock } from "../markdownReactShared";
+import { StreamingAnimationContext } from "../StreamingAnimationContext";
+import { shouldReparseLastBlock } from "./lastBlockThrottle";
+/**
+ * 统一的块级渲染：封版与末块使用同一组件类型；按 blockSource 缓存解析结果引用，使 tail→sealed 时与旧 Map 缓存一样复用同一棵 React 子树。
+ */ export var MarkdownBlockPiece = /*#__PURE__*/ memo(function MarkdownBlockPiece(param) {
+    var variant = param.variant, blockSource = param.blockSource, processor = param.processor, components = param.components, streaming = param.streaming;
+    var lastParsedRef = useRef(null);
+    /** 完整 parse 结果缓存：键为 block 源串，供 sealed 与 tail 晋升时复用同一引用 */ var parseBySourceRef = useRef(new Map());
+    var node = useMemo(function() {
+        var cached = parseBySourceRef.current.get(blockSource);
+        if (cached && variant === 'sealed') {
+            return cached;
+        }
+        if (variant === 'sealed') {
+            var el = renderMarkdownBlock(blockSource, processor, components, {
+                markStreamingTailParagraph: false
+            });
+            parseBySourceRef.current.set(blockSource, el);
+            return el;
+        }
+        if (!streaming) {
+            var el1 = renderMarkdownBlock(blockSource, processor, components, {
+                markStreamingTailParagraph: false
+            });
+            parseBySourceRef.current.set(blockSource, el1);
+            lastParsedRef.current = {
+                source: blockSource,
+                node: el1
+            };
+            return el1;
+        }
+        var prev = lastParsedRef.current;
+        if (prev && !shouldReparseLastBlock(prev.source, blockSource, true)) {
+            return prev.node;
+        }
+        var el2 = renderMarkdownBlock(blockSource, processor, components, {
+            markStreamingTailParagraph: true
+        });
+        parseBySourceRef.current.set(blockSource, el2);
+        lastParsedRef.current = {
+            source: blockSource,
+            node: el2
+        };
+        return el2;
+    }, [
+        variant,
+        blockSource,
+        processor,
+        components,
+        streaming
+    ]);
+    var animateBlock = variant === 'tail' && streaming;
+    return /*#__PURE__*/ React.createElement(StreamingAnimationContext.Provider, {
+        value: {
+            animateBlock: animateBlock
+        }
+    }, node);
+});
+MarkdownBlockPiece.displayName = 'MarkdownBlockPiece';

package/dist/MarkdownRenderer/streaming/lastBlockThrottle.d.ts

@@ -0,0 +1,4 @@
+/**
+ * 流式末块：是否应重新 parse（相对上一次已 parse 的源）。
+ */
+export declare const shouldReparseLastBlock: (prevParsedSource: string | undefined, newSource: string, streaming: boolean) => boolean;

package/dist/MarkdownRenderer/streaming/lastBlockThrottle.js

@@ -0,0 +1,14 @@
+var LAST_BLOCK_THROTTLE_CHARS = 20;
+var BLOCK_BOUNDARY_TRIGGERS = /[\n`|#>*\-!$[\]]/;
+/**
+ * 流式末块：是否应重新 parse（相对上一次已 parse 的源）。
+ */ export var shouldReparseLastBlock = function shouldReparseLastBlock(prevParsedSource, newSource, streaming) {
+    if (!streaming) return true;
+    if (!prevParsedSource) return true;
+    if (newSource.length < prevParsedSource.length) return true;
+    if (!newSource.startsWith(prevParsedSource)) return true;
+    var added = newSource.slice(prevParsedSource.length);
+    if (added.length >= LAST_BLOCK_THROTTLE_CHARS) return true;
+    if (BLOCK_BOUNDARY_TRIGGERS.test(added)) return true;
+    return false;
+};

package/dist/MarkdownRenderer/streaming/revisionPolicy.d.ts

@@ -0,0 +1,5 @@
+/**
+ * 判断是否应视为「非前缀修订」，从而放弃基于前缀的块级复用。
+ * revisionSource 应为单调前缀流（如 displayedContent）；若未传则调用方用 content 自身。
+ */
+export declare const shouldResetRevisionProgress: (previous: string | undefined, next: string) => boolean;

package/dist/MarkdownRenderer/streaming/revisionPolicy.js

@@ -0,0 +1,10 @@
+/**
+ * 判断是否应视为「非前缀修订」，从而放弃基于前缀的块级复用。
+ * revisionSource 应为单调前缀流（如 displayedContent）；若未传则调用方用 content 自身。
+ */ export var shouldResetRevisionProgress = function shouldResetRevisionProgress(previous, next) {
+    if (previous === undefined || previous === '') return false;
+    if (next === previous) return false;
+    if (next.startsWith(previous)) return false;
+    if (previous.startsWith(next)) return false;
+    return true;
+};

package/dist/MarkdownRenderer/streaming/useStreamingMarkdownReact.d.ts

@@ -0,0 +1,6 @@
+import React from 'react';
+import { type UseMarkdownToReactOptions } from '../markdownReactShared';
+/**
+ * 流式优先的 Markdown → React：每块独立 memo 组件；tail 与 sealed 共用组件类型以便块晋升时复用实例。
+ */
+export declare const useStreamingMarkdownReact: (content: string, options?: UseMarkdownToReactOptions) => React.ReactNode;

package/dist/MarkdownRenderer/streaming/useStreamingMarkdownReact.js

@@ -0,0 +1,70 @@
+import { JINJA_DOLLAR_PLACEHOLDER } from "../../MarkdownEditor/editor/parser/constants";
+import React, { useMemo, useRef } from "react";
+import { Fragment, jsx, jsxs } from "react/jsx-runtime";
+import { buildEditorAlignedComponents, createHastProcessor, splitMarkdownBlocks } from "../markdownReactShared";
+import { MarkdownBlockPiece } from "./MarkdownBlockPiece";
+import { shouldResetRevisionProgress } from "./revisionPolicy";
+/**
+ * 流式优先的 Markdown → React：每块独立 memo 组件；tail 与 sealed 共用组件类型以便块晋升时复用实例。
+ */ export var useStreamingMarkdownReact = function useStreamingMarkdownReact(content, options) {
+    var revisionSource = (options === null || options === void 0 ? void 0 : options.contentRevisionSource) !== undefined ? options.contentRevisionSource : content;
+    var prevRevisionRef = useRef(undefined);
+    var revisionGenerationRef = useRef(0);
+    var processor = useMemo(function() {
+        return createHastProcessor(options === null || options === void 0 ? void 0 : options.remarkPlugins, options === null || options === void 0 ? void 0 : options.htmlConfig);
+    }, [
+        options === null || options === void 0 ? void 0 : options.remarkPlugins,
+        options === null || options === void 0 ? void 0 : options.htmlConfig
+    ]);
+    var prefixCls = (options === null || options === void 0 ? void 0 : options.prefixCls) || 'ant-agentic-md-editor';
+    var components = useMemo(function() {
+        return buildEditorAlignedComponents(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.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.streamingParagraphAnimation
+    ]);
+    return useMemo(function() {
+        if (!content) {
+            prevRevisionRef.current = '';
+            return null;
+        }
+        var prevRev = prevRevisionRef.current;
+        if (prevRev !== undefined && shouldResetRevisionProgress(prevRev, revisionSource)) {
+            revisionGenerationRef.current += 1;
+        }
+        prevRevisionRef.current = revisionSource;
+        try {
+            var preprocessed = content.replace(new RegExp(JINJA_DOLLAR_PLACEHOLDER, 'g'), '$');
+            var blocks = splitMarkdownBlocks(preprocessed);
+            if (blocks.length === 0) return null;
+            var gen = revisionGenerationRef.current;
+            var elements = blocks.map(function(blockSource, index) {
+                var isLast = index === blocks.length - 1;
+                // 仅用修订代 + 块下标作 key，避免末块随文本增长导致 identity 变化而整段 remount
+                var key = "b-".concat(gen, "-").concat(index);
+                return jsx(MarkdownBlockPiece, {
+                    variant: isLast ? 'tail' : 'sealed',
+                    blockSource: blockSource,
+                    processor: processor,
+                    components: components,
+                    streaming: !!((options === null || options === void 0 ? void 0 : options.streaming) && isLast)
+                }, key);
+            });
+            return jsxs(Fragment, {
+                children: elements
+            });
+        } catch (error) {
+            console.error('Failed to render markdown:', error);
+            return null;
+        }
+    }, [
+        content,
+        revisionSource,
+        processor,
+        components,
+        options === null || options === void 0 ? void 0 : options.streaming
+    ]);
+};

package/dist/MarkdownRenderer/useMarkdownToReact.d.ts

@@ -1,28 +1,9 @@
 import React from 'react';
-import { type MarkdownRemarkPlugin, type MarkdownToHtmlConfig } from '../MarkdownEditor/editor/utils/markdownToHtml';
+import type { MarkdownRemarkPlugin, MarkdownToHtmlConfig } from '../MarkdownEditor/editor/utils/markdownToHtml';
 import type { RendererBlockProps } from './types';
-interface UseMarkdownToReactOptions {
-    remarkPlugins?: MarkdownRemarkPlugin[];
-    htmlConfig?: MarkdownToHtmlConfig;
-    components?: Record<string, React.ComponentType<RendererBlockProps>>;
-    /** MarkdownEditor 的 CSS 前缀，用于生成对齐的 className */
-    prefixCls?: string;
-    /** 链接配置：onClick 拦截、openInNewTab 控制 */
-    linkConfig?: {
-        openInNewTab?: boolean;
-        onClick?: (url?: string) => boolean | void;
-    };
-    /** 是否处于流式状态，用于最后一个块的打字动画 */
-    streaming?: boolean;
-    /**
-     * 流式时是否对「生长中的末段」启用段落淡入（AnimationText）。
-     * 默认 false：重解析时频繁触发动画易导致整页闪动；需要时再显式传入 true。
-     */
-    streamingParagraphAnimation?: boolean;
-}
-export declare const useMarkdownToReact: (content: string, options?: UseMarkdownToReactOptions) => React.ReactNode;
+export type { UseMarkdownToReactOptions } from './markdownReactShared';
+export declare const useMarkdownToReact: (content: string, options?: import("./markdownReactShared").UseMarkdownToReactOptions | undefined) => React.ReactNode;
 /**
  * 同步将 markdown 转为 React 元素（非 hook 版本，用于测试或一次性转换）
  */
 export declare const markdownToReactSync: (content: string, components?: Record<string, React.ComponentType<RendererBlockProps>>, remarkPlugins?: MarkdownRemarkPlugin[], htmlConfig?: MarkdownToHtmlConfig) => React.ReactNode;
-export {};