@ant-design/agentic-ui 2.30.20 → 2.30.22

package/dist/MarkdownEditor/editor/tools/InsertAutocomplete.js

@@ -936,18 +936,22 @@ export var InsertAutocomplete = function InsertAutocomplete(props) {
                     isTop: EditorUtils.isTop(markdownEditorRef.current, node[1])
                 };
                 if ((node === null || node === void 0 ? void 0 : (_node_ = node[0]) === null || _node_ === void 0 ? void 0 : _node_.type) === 'paragraph') {
-                    var el = ReactEditor.toDOMNode(markdownEditorRef.current, node[0]);
-                    if (el) {
-                        var position = calculatePosition(el, document.body);
-                        if (position) {
-                            setState(position);
-                        } else {
-                            setState({
-                                top: 0,
-                                left: 0,
-                                bottom: undefined
-                            });
+                    try {
+                        var el = ReactEditor.toDOMNode(markdownEditorRef.current, node[0]);
+                        if (el) {
+                            var position = calculatePosition(el, document.body);
+                            if (position) {
+                                setState(position);
+                            } else {
+                                setState({
+                                    top: 0,
+                                    left: 0,
+                                    bottom: undefined
+                                });
+                            }
                         }
+                    } catch (unused) {
+                    // node may not be mounted yet; position update skipped
                     }
                 }
                 setupEventListeners();

package/dist/MarkdownInputField/AttachmentButton/AttachmentFileList/AttachmentFileListItem.d.ts

@@ -3,7 +3,7 @@ import { AttachmentFile } from '../types';
 interface FileListItemProps {
     file: AttachmentFile;
     onDelete: (file: AttachmentFile) => void;
-    onPreview?: (file: AttachmentFile) => void;
+    onPreview?: (file: AttachmentFile) => void | Promise<void>;
     onDownload?: (file: AttachmentFile) => void;
     onRetry?: (file: AttachmentFile) => void;
     className?: string;

package/dist/MarkdownInputField/AttachmentButton/AttachmentFileList/AttachmentFileListItem.js

@@ -110,13 +110,13 @@ export var AttachmentFileListItem = function AttachmentFileListItem(param) {
     var isDoneStatus = file.status === 'done';
     var canDelete = !isAttachmentFileLoading(file.status);
     var handleFileClick = function handleFileClick() {
+        if (canRetry) {
+            onRetry === null || onRetry === void 0 ? void 0 : onRetry(file);
+            return;
+        }
         if (!isDoneStatus) return;
         onPreview === null || onPreview === void 0 ? void 0 : onPreview(file);
     };
-    var handleRetryClick = function handleRetryClick() {
-        if (!canRetry) return;
-        onRetry === null || onRetry === void 0 ? void 0 : onRetry(file);
-    };
     var handleDeleteClick = function handleDeleteClick(e) {
         e.stopPropagation();
         onDelete(file);
@@ -145,7 +145,6 @@ export var AttachmentFileListItem = function AttachmentFileListItem(param) {
     }), /*#__PURE__*/ React.createElement("div", {
         className: classNames("".concat(prefixCls, "-file-info"), hashId)
     }, /*#__PURE__*/ React.createElement("div", {
-        onClick: handleRetryClick,
         className: classNames("".concat(prefixCls, "-file-name"), hashId)
     }, /*#__PURE__*/ React.createElement("span", {
         className: classNames("".concat(prefixCls, "-file-name-text"), hashId)

package/dist/MarkdownInputField/AttachmentButton/AttachmentFileList/index.d.ts

@@ -3,7 +3,7 @@ import { AttachmentFile } from '../types';
 export type AttachmentFileListProps = {
     fileMap?: Map<string, AttachmentFile>;
     onDelete: (file: AttachmentFile) => void;
-    onPreview?: (file: AttachmentFile) => void;
+    onPreview?: (file: AttachmentFile) => void | Promise<void>;
     onDownload?: (file: AttachmentFile) => void;
     onRetry?: (file: AttachmentFile) => void;
     onClearFileMap?: () => void;

package/dist/MarkdownInputField/AttachmentButton/index.d.ts

@@ -31,7 +31,7 @@ export type AttachmentButtonProps = {
     /** 删除文件回调 */
     onDelete?: (file: AttachmentFile) => Promise<void>;
     /** 预览文件回调 */
-    onPreview?: (file: AttachmentFile) => Promise<void>;
+    onPreview?: (file: AttachmentFile) => void | Promise<void>;
     /** 下载文件回调 */
     onDownload?: (file: AttachmentFile) => Promise<void>;
     /** 单个文件最大大小（字节） */

package/dist/MarkdownInputField/MarkdownInputField.js

@@ -255,7 +255,7 @@ var MarkdownInputFieldComponent = function MarkdownInputFieldComponent(_0) {
         inputRef: props.inputRef,
         value: props.value,
         setValue: setValue
-    }), markdownEditorRef = _useMarkdownInputFieldRefs.markdownEditorRef, quickActionsRef = _useMarkdownInputFieldRefs.quickActionsRef, actionsRef = _useMarkdownInputFieldRefs.actionsRef, isSendingRef = _useMarkdownInputFieldRefs.isSendingRef;
+    }), markdownEditorRef = _useMarkdownInputFieldRefs.markdownEditorRef, quickActionsRef = _useMarkdownInputFieldRefs.quickActionsRef, actionsRef = _useMarkdownInputFieldRefs.actionsRef, isSendingRef = _useMarkdownInputFieldRefs.isSendingRef, onEditorChange = _useMarkdownInputFieldRefs.onEditorChange;
     // 文件上传管理
     var _useFileUploadManager = useFileUploadManager({
         attachment: attachment,
@@ -446,6 +446,7 @@ var MarkdownInputFieldComponent = function MarkdownInputFieldComponent(_0) {
                     var _props_onChange1, _props_onMaxLengthExceeded, // 更新编辑器内容以反映截断后的值
                     _markdownEditorRef_current_store, _markdownEditorRef_current;
                     var truncatedValue = value.slice(0, props.maxLength);
+                    onEditorChange(truncatedValue);
                     setValue(truncatedValue);
                     (_props_onChange1 = props.onChange) === null || _props_onChange1 === void 0 ? void 0 : _props_onChange1.call(props, truncatedValue);
                     (_props_onMaxLengthExceeded = props.onMaxLengthExceeded) === null || _props_onMaxLengthExceeded === void 0 ? void 0 : _props_onMaxLengthExceeded.call(props, value);
@@ -453,6 +454,10 @@ var MarkdownInputFieldComponent = function MarkdownInputFieldComponent(_0) {
                     return;
                 }
             }
+            // Record the value the editor just produced so the external
+            // props.value sync effect skips the redundant setMDContent call
+            // that would disrupt the live Slate selection while typing.
+            onEditorChange(value);
             setValue(value);
             (_props_onChange = props.onChange) === null || _props_onChange === void 0 ? void 0 : _props_onChange.call(props, value);
         },

package/dist/MarkdownInputField/hooks/useMarkdownInputFieldHandlers.js

@@ -401,8 +401,12 @@ import { getFileListFromDataTransferItems } from "../FilePaste";
         var isInteractive = target.closest('button') || target.closest('a') || target.closest('input') || target.closest('[contenteditable="true"]');
         if (isInteractive) return;
         EditorUtils.focus(editor);
-        var end = Editor.end(editor, []);
-        Transforms.select(editor, end);
+        try {
+            var end = Editor.end(editor, []);
+            Transforms.select(editor, end);
+        } catch (unused) {
+        // editor may have no valid content points yet; focus is still applied
+        }
     });
     var activeInput = useRefFunction(function(active) {
         if (inputRef.current) {

package/dist/MarkdownInputField/hooks/useMarkdownInputFieldRefs.d.ts

@@ -13,5 +13,6 @@ export declare const useMarkdownInputFieldRefs: (props: UseMarkdownInputFieldRef
     quickActionsRef: import("react").RefObject<HTMLDivElement>;
     actionsRef: import("react").RefObject<HTMLDivElement>;
     isSendingRef: import("react").MutableRefObject<boolean>;
+    onEditorChange: (value: string) => void;
 };
 export {};

package/dist/MarkdownInputField/hooks/useMarkdownInputFieldRefs.js

@@ -50,7 +50,8 @@ function _object_spread_props(target, source) {
     }
     return target;
 }
-import { useEffect, useImperativeHandle, useRef } from "react";
+import { useCallback, useEffect, useImperativeHandle, useRef } from "react";
+import { ReactEditor } from "slate-react";
 /**
  * Refs 管理 Hook
  * 管理组件中所有的 refs 和相关逻辑
@@ -59,12 +60,41 @@ import { useEffect, useImperativeHandle, useRef } from "react";
     var quickActionsRef = useRef(null);
     var actionsRef = useRef(null);
     var isSendingRef = useRef(false);
-    // 同步外部 value 到编辑器
+    /**
+   * Tracks the last value emitted by the editor's own onChange callback.
+   * When props.value matches this ref we know the update originated from the
+   * editor itself and there is no need to call setMDContent — doing so would
+   * replace the live Slate document while the user is actively typing, causing
+   * ReactEditor.deselect() to throw "Failed to execute 'collapseToEnd' on
+   * 'Selection': There is no selection", which crashes the component tree.
+   */ var lastEditorValueRef = useRef(undefined);
+    /** Called by MarkdownInputField's onChange handler to record what the editor just emitted. */ var onEditorChange = useCallback(function(value) {
+        lastEditorValueRef.current = value;
+    }, []);
+    // 同步外部 value 到编辑器 — 只在 value 来自外部（非编辑器自身输入）时写回
     useEffect(function() {
         var _props_value;
-        var _markdownEditorRef_current_store, _markdownEditorRef_current;
+        var _markdownEditorRef_current_markdownEditorRef, _markdownEditorRef_current, _markdownEditorRef_current_store, _markdownEditorRef_current1;
         if (!markdownEditorRef.current) return;
-        (_markdownEditorRef_current = markdownEditorRef.current) === null || _markdownEditorRef_current === void 0 ? void 0 : (_markdownEditorRef_current_store = _markdownEditorRef_current.store) === null || _markdownEditorRef_current_store === void 0 ? void 0 : _markdownEditorRef_current_store.setMDContent((_props_value = props.value) !== null && _props_value !== void 0 ? _props_value : '');
+        // Primary guard: this value was just produced by the editor itself —
+        // the Slate document is already correct, no write-back needed.
+        if (props.value === lastEditorValueRef.current) return;
+        // Secondary guard: the editor is focused, meaning the user is actively
+        // typing.  A stale props.value (delayed by debounce + React batching) could
+        // arrive *after* the editor has moved on to a newer character.  Calling
+        // setMDContent in that window replaces the live document and triggers
+        // ReactEditor.deselect() on a focused editor → InvalidStateError → white
+        // screen.  Skip the write; _safeDeselect in store.ts also defends here as
+        // a last resort, but not calling setMDContent at all is the clean fix.
+        var slateEditor = (_markdownEditorRef_current = markdownEditorRef.current) === null || _markdownEditorRef_current === void 0 ? void 0 : (_markdownEditorRef_current_markdownEditorRef = _markdownEditorRef_current.markdownEditorRef) === null || _markdownEditorRef_current_markdownEditorRef === void 0 ? void 0 : _markdownEditorRef_current_markdownEditorRef.current;
+        if (slateEditor) {
+            try {
+                if (ReactEditor.isFocused(slateEditor)) return;
+            } catch (unused) {
+            // ReactEditor.isFocused can throw if the editor is being torn down
+            }
+        }
+        (_markdownEditorRef_current1 = markdownEditorRef.current) === null || _markdownEditorRef_current1 === void 0 ? void 0 : (_markdownEditorRef_current_store = _markdownEditorRef_current1.store) === null || _markdownEditorRef_current_store === void 0 ? void 0 : _markdownEditorRef_current_store.setMDContent((_props_value = props.value) !== null && _props_value !== void 0 ? _props_value : '');
     }, [
         props.value
     ]);
@@ -104,6 +134,7 @@ import { useEffect, useImperativeHandle, useRef } from "react";
         markdownEditorRef: markdownEditorRef,
         quickActionsRef: quickActionsRef,
         actionsRef: actionsRef,
-        isSendingRef: isSendingRef
+        isSendingRef: isSendingRef,
+        onEditorChange: onEditorChange
     };
 };

package/dist/MarkdownInputField/utils/renderHelpers.js

@@ -64,6 +64,10 @@ import { MARKDOWN_INPUT_FIELD_TEST_IDS } from "../testIds";
             fileMap: fileMap,
             onDelete: handleFileRemoval,
             onRetry: handleFileRetry,
+            onPreview: (attachment === null || attachment === void 0 ? void 0 : attachment.onPreview) ? function(file) {
+                var _attachment_onPreview;
+                void Promise.resolve((_attachment_onPreview = attachment.onPreview) === null || _attachment_onPreview === void 0 ? void 0 : _attachment_onPreview.call(attachment, file)).catch(function() {});
+            } : undefined,
             onClearFileMap: function onClearFileMap() {
                 updateAttachmentFiles(undefined);
             },
@@ -71,6 +75,7 @@ import { MARKDOWN_INPUT_FIELD_TEST_IDS } from "../testIds";
         });
     }, [
         attachment === null || attachment === void 0 ? void 0 : attachment.enable,
+        attachment === null || attachment === void 0 ? void 0 : attachment.onPreview,
         fileMap,
         handleFileRemoval,
         handleFileRetry,

package/dist/MarkdownRenderer/FncRefForMarkdown.d.ts

@@ -0,0 +1,24 @@
+import React from 'react';
+import type { MarkdownEditorProps } from '../MarkdownEditor/types';
+export interface MarkdownLinkInterceptConfig {
+    openInNewTab?: boolean;
+    onClick?: (url?: string) => boolean | void;
+}
+/**
+ * 从 GFM 脚注引用 <sup><a href="#user-content-fn-x">…</a></sup> 解析标识符
+ */
+export declare const extractFootnoteRefFromSupChildren: (children: React.ReactNode) => {
+    identifier: string;
+    url?: string;
+} | undefined;
+export interface FncRefForMarkdownProps {
+    fncProps?: MarkdownEditorProps['fncProps'];
+    linkConfig?: MarkdownLinkInterceptConfig;
+    identifier: string;
+    children: React.ReactNode;
+    url?: string;
+}
+/**
+ * 将 Markdown hast 中的脚注引用与 Slate 只读路径的 FncLeaf 对齐
+ */
+export declare const FncRefForMarkdown: React.FC<FncRefForMarkdownProps>;

package/dist/MarkdownRenderer/FncRefForMarkdown.js

@@ -0,0 +1,65 @@
+import React, { useMemo } from "react";
+import { FncLeaf } from "../MarkdownEditor/editor/elements/FncLeaf";
+var FOOTNOTE_HREF_ID = /user-content-fn-([^#?]+)$/i;
+var extractSingleChildText = function extractSingleChildText1(node) {
+    if (node === null || node === undefined || node === false) return '';
+    if (typeof node === 'string' || typeof node === 'number') return String(node);
+    if (Array.isArray(node)) return node.map(extractSingleChildText).join('');
+    if (/*#__PURE__*/ React.isValidElement(node) && node.props !== undefined && node.props.children !== undefined && node.props.children !== null) {
+        return extractSingleChildText(node.props.children);
+    }
+    return '';
+};
+/**
+ * 从 GFM 脚注引用 <sup><a href="#user-content-fn-x">…</a></sup> 解析标识符
+ */ export var extractFootnoteRefFromSupChildren = function extractFootnoteRefFromSupChildren(children) {
+    var _el_props, _el_props1;
+    var childArray = React.Children.toArray(children);
+    if (childArray.length !== 1) return undefined;
+    var only = childArray[0];
+    if (!/*#__PURE__*/ React.isValidElement(only)) return undefined;
+    var el = only;
+    if (typeof el.type !== 'string' || el.type !== 'a') return undefined;
+    var href = (_el_props = el.props) === null || _el_props === void 0 ? void 0 : _el_props.href;
+    var labelText = extractSingleChildText((_el_props1 = el.props) === null || _el_props1 === void 0 ? void 0 : _el_props1.children);
+    if (typeof href === 'string') {
+        var m = FOOTNOTE_HREF_ID.exec(href);
+        if (m === null || m === void 0 ? void 0 : m[1]) {
+            return {
+                identifier: decodeURIComponent(m[1]),
+                url: href.startsWith('http') ? href : undefined
+            };
+        }
+    }
+    if (labelText) {
+        return {
+            identifier: labelText
+        };
+    }
+    return undefined;
+};
+/**
+ * 将 Markdown hast 中的脚注引用与 Slate 只读路径的 FncLeaf 对齐
+ */ export var FncRefForMarkdown = function FncRefForMarkdown(param) {
+    var fncProps = param.fncProps, linkConfig = param.linkConfig, identifier = param.identifier, children = param.children, url = param.url;
+    var leaf = useMemo(function() {
+        return {
+            fnc: true,
+            text: "[^".concat(identifier, "]"),
+            identifier: identifier,
+            url: url
+        };
+    }, [
+        identifier,
+        url
+    ]);
+    return /*#__PURE__*/ React.createElement(FncLeaf, {
+        attributes: {
+            'data-slate-leaf': true
+        },
+        leaf: leaf,
+        text: leaf,
+        fncProps: fncProps,
+        linkConfig: linkConfig
+    }, children);
+};

package/dist/MarkdownRenderer/MarkdownRenderer.js

@@ -146,6 +146,7 @@ import { CodeBlockRenderer } from "./renderers/CodeRenderer";
 import { MermaidBlockRenderer } from "./renderers/MermaidRenderer";
 import { SchemaBlockRenderer } from "./renderers/SchemaRenderer";
 import { useRendererVarStyle } from "./style";
+import { extractFootnoteDefinitionsFromMarkdown } from "./extractFootnoteDefinitions";
 import { useMarkdownToReact } from "./useMarkdownToReact";
 import { useStreaming } from "./useStreaming";
 var SCHEMA_LANGUAGES = new Set([
@@ -187,11 +188,12 @@ var SCHEMA_LANGUAGES = new Set([
 /**
  * 默认的代码块路由——根据语言分发到对应渲染器
  */ var DefaultCodeRouter = function DefaultCodeRouter(props) {
-    var language = props.language, pluginComponents = props.pluginComponents, apaasifyRender = props.apaasifyRender, fileMapConfig = props.fileMapConfig, rest = _object_without_properties(props, [
+    var language = props.language, pluginComponents = props.pluginComponents, apaasifyRender = props.apaasifyRender, fileMapConfig = props.fileMapConfig, editorCodeProps = props.editorCodeProps, rest = _object_without_properties(props, [
         "language",
         "pluginComponents",
         "apaasifyRender",
-        "fileMapConfig"
+        "fileMapConfig",
+        "editorCodeProps"
     ]);
     if (language === 'mermaid') {
         var MermaidComp = pluginComponents.mermaid || MermaidBlockRenderer;
@@ -228,12 +230,14 @@ var SCHEMA_LANGUAGES = new Set([
         var SchemaComp = pluginComponents.schema || SchemaBlockRenderer;
         return /*#__PURE__*/ React.createElement(SchemaComp, _object_spread_props(_object_spread({}, rest), {
             language: language,
-            apaasifyRender: apaasifyRender
+            apaasifyRender: apaasifyRender,
+            editorCodeProps: editorCodeProps
         }));
     }
     var CodeComp = pluginComponents.code || CodeBlockRenderer;
     return /*#__PURE__*/ React.createElement(CodeComp, _object_spread_props(_object_spread({}, rest), {
-        language: language
+        language: language,
+        editorCodeProps: editorCodeProps
     }));
 };
 /**
@@ -245,7 +249,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, streamingParagraphAnimation = props.streamingParagraphAnimation, apaasify = props.apaasify, eleRender = props.eleRender, fileMapConfig = props.fileMapConfig;
+    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, eleRender = props.eleRender, fileMapConfig = props.fileMapConfig, fncProps = props.fncProps, editorCodeProps = props.codeProps;
     var getPrefixCls = useContext(ConfigProvider.ConfigContext).getPrefixCls;
     // 复用 MarkdownEditor 的 CSS 前缀和样式，保持渲染一致性
     var prefixCls = getPrefixCls('agentic-md-editor', customPrefixCls);
@@ -333,6 +337,14 @@ var SCHEMA_LANGUAGES = new Set([
         content,
         streaming
     ]);
+    useEffect(function() {
+        var notify = fncProps === null || fncProps === void 0 ? void 0 : fncProps.onFootnoteDefinitionChange;
+        if (!notify) return;
+        notify(extractFootnoteDefinitionsFromMarkdown(displayedContent || ''));
+    }, [
+        displayedContent,
+        fncProps === null || fncProps === void 0 ? void 0 : fncProps.onFootnoteDefinitionChange
+    ]);
     // 构建组件映射
     // code 渲染器通过 pre override 在 useMarkdownToReact 中路由，
     // 不直接映射到 <code> 标签（否则会影响行内代码 `code`）
@@ -343,11 +355,12 @@ var SCHEMA_LANGUAGES = new Set([
         apaasify
     ]);
     var components = useMemo(function() {
-        var codeRouter = function codeRouter(codeProps) {
-            return /*#__PURE__*/ React.createElement(DefaultCodeRouter, _object_spread_props(_object_spread({}, codeProps), {
+        var codeRouter = function codeRouter(blockProps) {
+            return /*#__PURE__*/ React.createElement(DefaultCodeRouter, _object_spread_props(_object_spread({}, blockProps), {
                 pluginComponents: pluginComponents,
                 apaasifyRender: apaasifyRender,
-                fileMapConfig: fileMapConfig
+                fileMapConfig: fileMapConfig,
+                editorCodeProps: editorCodeProps
             }));
         };
         codeRouter.displayName = 'CodeRouter';
@@ -357,7 +370,8 @@ var SCHEMA_LANGUAGES = new Set([
     }, [
         pluginComponents,
         apaasifyRender,
-        fileMapConfig
+        fileMapConfig,
+        editorCodeProps
     ]);
     // 流式缓存：将不完整的 Markdown token 暂缓，避免 parser 错误解析
     var safeContent = useStreaming(displayedContent, streaming);
@@ -367,6 +381,7 @@ var SCHEMA_LANGUAGES = new Set([
         components: components,
         prefixCls: prefixCls,
         linkConfig: linkConfig,
+        fncProps: fncProps,
         streaming: streaming,
         streamingParagraphAnimation: streamingParagraphAnimation,
         contentRevisionSource: streaming ? displayedContent : undefined,

package/dist/MarkdownRenderer/extractFootnoteDefinitions.d.ts

@@ -0,0 +1,13 @@
+/** 与 `fncProps.onFootnoteDefinitionChange` 数组元素一致 */
+export interface FootnoteDefinitionRow {
+    id: any;
+    placeholder: any;
+    origin_text: any;
+    url: any;
+    origin_url: any;
+}
+/**
+ * 从 Markdown 源码提取 GFM 脚注定义，结构与 Slate 只读 Editor 中
+ * `fncProps.onFootnoteDefinitionChange` 入参对齐。
+ */
+export declare const extractFootnoteDefinitionsFromMarkdown: (content: string) => FootnoteDefinitionRow[];

package/dist/MarkdownRenderer/extractFootnoteDefinitions.js

@@ -0,0 +1,40 @@
+import remarkGfm from "remark-gfm";
+import remarkParse from "remark-parse";
+import { unified } from "unified";
+import { visit } from "unist-util-visit";
+var mdastFootnoteProcessor = unified().use(remarkParse).use(remarkGfm, {
+    singleTilde: false
+});
+var mdastPlainText = function mdastPlainText1(node) {
+    if (!node) return '';
+    if (node.type === 'text') return node.value || '';
+    if (Array.isArray(node.children)) {
+        return node.children.map(mdastPlainText).join('');
+    }
+    return '';
+};
+/**
+ * 从 Markdown 源码提取 GFM 脚注定义，结构与 Slate 只读 Editor 中
+ * `fncProps.onFootnoteDefinitionChange` 入参对齐。
+ */ export var extractFootnoteDefinitionsFromMarkdown = function extractFootnoteDefinitionsFromMarkdown(content) {
+    if (!(content === null || content === void 0 ? void 0 : content.trim())) return [];
+    try {
+        var tree = mdastFootnoteProcessor.parse(content);
+        var list = [];
+        visit(tree, 'footnoteDefinition', function(node) {
+            var _node_label;
+            list.push({
+                id: node.identifier,
+                placeholder: (_node_label = node.label) !== null && _node_label !== void 0 ? _node_label : node.identifier,
+                origin_text: mdastPlainText({
+                    children: node.children
+                }),
+                url: undefined,
+                origin_url: undefined
+            });
+        });
+        return list;
+    } catch (unused) {
+        return [];
+    }
+};

package/dist/MarkdownRenderer/markdownReactShared.d.ts

@@ -1,6 +1,7 @@
 import React from 'react';
 import type { Processor } from 'unified';
 import { type MarkdownRemarkPlugin, type MarkdownToHtmlConfig } from '../MarkdownEditor/editor/utils/markdownToHtml';
+import type { MarkdownEditorProps } from '../MarkdownEditor/types';
 import type { MarkdownRendererEleProps, RendererBlockProps } from './types';
 declare const createHastProcessor: (extraRemarkPlugins?: MarkdownRemarkPlugin[], config?: MarkdownToHtmlConfig) => Processor;
 /**
@@ -12,7 +13,7 @@ declare const createHastProcessor: (extraRemarkPlugins?: MarkdownRemarkPlugin[],
 declare const buildEditorAlignedComponents: (prefixCls: string, userComponents: Record<string, React.ComponentType<RendererBlockProps>>, streaming?: boolean, linkConfig?: {
     openInNewTab?: boolean | undefined;
     onClick?: ((url?: string) => boolean | void) | undefined;
-} | undefined, streamingParagraphAnimation?: boolean, eleRender?: ((props: MarkdownRendererEleProps, defaultDom: React.ReactNode) => React.ReactNode) | undefined) => {
+} | undefined, fncProps?: MarkdownEditorProps['fncProps'], streamingParagraphAnimation?: boolean, eleRender?: ((props: MarkdownRendererEleProps, defaultDom: React.ReactNode) => React.ReactNode) | undefined) => {
     p: (props: any) => React.ReactNode;
     h1: (props: any) => React.ReactNode;
     h2: (props: any) => React.ReactNode;
@@ -77,6 +78,8 @@ export interface UseMarkdownToReactOptions {
         openInNewTab?: boolean;
         onClick?: (url?: string) => boolean | void;
     };
+    /** 脚注：与只读 Slate 路径 FncLeaf / fncProps 对齐 */
+    fncProps?: MarkdownEditorProps['fncProps'];
     /** 是否处于流式状态，用于最后一个块的打字动画 */
     streaming?: boolean;
     /**

package/dist/MarkdownRenderer/markdownReactShared.js

@@ -140,6 +140,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 { FncRefForMarkdown, extractFootnoteRefFromSupChildren } from "./FncRefForMarkdown";
 import { StreamingAnimationContext } from "./StreamingAnimationContext";
 var INLINE_MATH_WITH_SINGLE_DOLLAR = {
     singleDollarTextMath: true
@@ -432,7 +433,7 @@ var extractLanguageFromClassName = function extractLanguageFromClassName(classNa
  *
  * MarkdownEditor 的 Slate 元素使用 data-be 属性和 prefixCls 类名，
  * 这里为原生 HTML 标签添加相同的属性，使共用的 CSS 能正确命中。
- */ var buildEditorAlignedComponents = function buildEditorAlignedComponents(prefixCls, userComponents, streaming, linkConfig, streamingParagraphAnimation, eleRender) {
+ */ var buildEditorAlignedComponents = function buildEditorAlignedComponents(prefixCls, userComponents, streaming, linkConfig, fncProps, streamingParagraphAnimation, eleRender) {
     var listCls = "".concat(prefixCls, "-list");
     var tableCls = "".concat(prefixCls, "-content-table");
     var contentCls = prefixCls; // e.g. ant-agentic-md-editor-content
@@ -1119,12 +1120,22 @@ var extractLanguageFromClassName = function extractLanguageFromClassName(classNa
                 node: node
             }, rest), defaultDom);
         },
-        // 脚注引用 sup > a（remark-gfm 有定义时生成）
+        // 脚注引用 sup > a（remark-gfm 有定义时生成）— 与 Slate FncLeaf 对齐
         sup: function sup(props) {
             var node = props.node, children = props.children, rest = _object_without_properties(props, [
                 "node",
                 "children"
             ]);
+            var meta = extractFootnoteRefFromSupChildren(children);
+            if (meta) {
+                return jsx(FncRefForMarkdown, {
+                    fncProps: fncProps,
+                    linkConfig: linkConfig,
+                    identifier: meta.identifier,
+                    url: meta.url,
+                    children: children
+                });
+            }
             var defaultDom = jsx('span', _object_spread_props(_object_spread({}, rest), {
                 'data-fnc': 'fnc',
                 'data-testid': 'markdown-footnote-ref',
@@ -1146,15 +1157,14 @@ var extractLanguageFromClassName = function extractLanguageFromClassName(classNa
                 "children"
             ]);
             if (rest['data-fnc'] === 'fnc') {
-                return jsx('span', _object_spread_props(_object_spread({}, rest), {
-                    'data-testid': 'markdown-footnote-ref',
-                    className: "".concat(contentCls, "-fnc"),
-                    style: {
-                        fontSize: 12,
-                        cursor: 'pointer'
-                    },
+                var raw = rest['data-fnc-name'];
+                var identifier = raw !== undefined && raw !== null && String(raw).length > 0 ? String(raw) : extractChildrenText(children) || '?';
+                return jsx(FncRefForMarkdown, {
+                    fncProps: fncProps,
+                    linkConfig: linkConfig,
+                    identifier: identifier,
                     children: children
-                }));
+                });
             }
             return jsx('span', _object_spread_props(_object_spread({}, rest), {
                 children: children

package/dist/MarkdownRenderer/renderers/CodeRenderer.d.ts

@@ -1,7 +1,10 @@
 import React from 'react';
+import type { MarkdownEditorProps } from '../../MarkdownEditor/types';
 import type { RendererBlockProps } from '../types';
 /**
  * 代码块渲染器——复用 MarkdownEditor 的 CodeContainer 和样式体系。
  * 不依赖 Slate 上下文，提供与 CodeRenderer readonly 模式一致的视觉效果。
  */
-export declare const CodeBlockRenderer: React.FC<RendererBlockProps>;
+export declare const CodeBlockRenderer: React.FC<RendererBlockProps & {
+    editorCodeProps?: MarkdownEditorProps['codeProps'];
+}>;

package/dist/MarkdownRenderer/renderers/CodeRenderer.js

@@ -52,6 +52,7 @@ import { I18nContext } from "../../I18n";
 import { CodeContainer } from "../../Plugins/code/components/CodeContainer";
 import { LoadImage } from "../../Plugins/code/components/LoadImage";
 import { langIconMap } from "../../Plugins/code/langIconMap";
+import { debugInfo } from "../../Utils/debugUtils";
 var extractTextContent = function extractTextContent1(children) {
     var _children_props;
     if (typeof children === 'string') return children;
@@ -67,8 +68,10 @@ var extractTextContent = function extractTextContent1(children) {
  * 不依赖 Slate 上下文，提供与 CodeRenderer readonly 模式一致的视觉效果。
  */ export var CodeBlockRenderer = function CodeBlockRenderer(props) {
     var _i18n_locale, _i18n_locale1, _i18n_locale2;
-    var language = props.language, children = props.children;
-    var _useState = _sliced_to_array(useState('github'), 2), theme = _useState[0], setTheme = _useState[1];
+    var language = props.language, children = props.children, editorCodeProps = props.editorCodeProps;
+    var _useState = _sliced_to_array(useState(function() {
+        return (editorCodeProps === null || editorCodeProps === void 0 ? void 0 : editorCodeProps.theme) || 'github';
+    }), 2), theme = _useState[0], setTheme = _useState[1];
     var _useState1 = _sliced_to_array(useState(true), 2), isExpanded = _useState1[0], setIsExpanded = _useState1[1];
     var i18n = useContext(I18nContext);
     var code = useMemo(function() {
@@ -101,7 +104,7 @@ var extractTextContent = function extractTextContent1(children) {
         code
     ]);
     var langIcon = langIconMap.get((language === null || language === void 0 ? void 0 : language.toLowerCase()) || '');
-    return /*#__PURE__*/ React.createElement(CodeContainer, {
+    var defaultDom = /*#__PURE__*/ React.createElement(CodeContainer, {
         element: fakeElement,
         showBorder: false,
         hide: false,
@@ -214,5 +217,26 @@ var extractTextContent = function extractTextContent1(children) {
     }, /*#__PURE__*/ React.createElement("code", {
         className: language ? "language-".concat(language) : undefined
     }, children))));
+    var customRender = editorCodeProps === null || editorCodeProps === void 0 ? void 0 : editorCodeProps.render;
+    if (!customRender) {
+        return defaultDom;
+    }
+    try {
+        var renderElementProps = {
+            attributes: {},
+            children: null,
+            element: fakeElement
+        };
+        var rendered = customRender(renderElementProps, defaultDom, editorCodeProps);
+        if (rendered === undefined) {
+            return defaultDom;
+        }
+        return rendered;
+    } catch (error) {
+        debugInfo('CodeBlockRenderer - codeProps.render 异常，回退默认', {
+            error: (error === null || error === void 0 ? void 0 : error.message) || String(error)
+        });
+        return defaultDom;
+    }
 };
 CodeBlockRenderer.displayName = 'CodeBlockRenderer';