@ant-design/agentic-ui 2.30.21 → 2.30.23

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

@@ -140,6 +140,7 @@ import { useLocale } from "../I18n";
 import { BaseMarkdownEditor } from "../MarkdownEditor";
 import { BorderBeamAnimation } from "./BorderBeamAnimation";
 import { useFileUploadManager } from "./FileUploadManager";
+import { resolveSendDisabled } from "./SendButton";
 import { useMarkdownInputFieldActions } from "./hooks/useMarkdownInputFieldActions";
 import { useMarkdownInputFieldHandlers } from "./hooks/useMarkdownInputFieldHandlers";
 import { useMarkdownInputFieldLayout } from "./hooks/useMarkdownInputFieldLayout";
@@ -255,7 +256,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,
@@ -280,6 +281,7 @@ var MarkdownInputFieldComponent = function MarkdownInputFieldComponent(_0) {
             attachment: attachment,
             triggerSendKey: props.triggerSendKey
         },
+        sendDisabled: resolveSendDisabled(props.sendButtonProps, fileUploadStatus),
         markdownEditorRef: markdownEditorRef,
         inputRef: inputRef,
         isSendingRef: isSendingRef,
@@ -446,6 +448,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 +456,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/SendActions/index.js

@@ -58,7 +58,7 @@ import React, { useContext, useMemo } from "react";
 import { ActionIconBox } from "../../Components/ActionIconBox";
 import { I18nContext } from "../../I18n";
 import { AttachmentButton } from "../AttachmentButton";
-import { SendButton } from "../SendButton";
+import { SendButton, resolveSendDisabled } from "../SendButton";
 import { VoiceInputButton } from "../VoiceInput";
 import { MARKDOWN_INPUT_FIELD_TEST_IDS } from "../testIds";
 /**
@@ -68,6 +68,7 @@ import { MARKDOWN_INPUT_FIELD_TEST_IDS } from "../testIds";
  */ export var SendActions = function SendActions(param) {
     var attachment = param.attachment, voiceRecognizer = param.voiceRecognizer, value = param.value, disabled = param.disabled, typing = param.typing, isLoading = param.isLoading, _param_fileUploadDone = param.fileUploadDone, fileUploadDone = _param_fileUploadDone === void 0 ? true : _param_fileUploadDone, _param_fileUploadStatus = param.fileUploadStatus, fileUploadStatus = _param_fileUploadStatus === void 0 ? fileUploadDone ? 'done' : 'uploading' : _param_fileUploadStatus, fileUploadSummary = param.fileUploadSummary, _param_recording = param.recording, recording = _param_recording === void 0 ? false : _param_recording, _param_collapseSendActions = param.collapseSendActions, collapseSendActions = _param_collapseSendActions === void 0 ? false : _param_collapseSendActions, _param_allowEmptySubmit = param.allowEmptySubmit, allowEmptySubmit = _param_allowEmptySubmit === void 0 ? false : _param_allowEmptySubmit, uploadImage = param.uploadImage, onStartRecording = param.onStartRecording, onStopRecording = param.onStopRecording, onSend = param.onSend, onStop = param.onStop, actionsRender = param.actionsRender, _param_prefixCls = param.prefixCls, prefixCls = _param_prefixCls === void 0 ? 'ant-agentic-md-input-field' : _param_prefixCls, _param_hashId = param.hashId, hashId = _param_hashId === void 0 ? '' : _param_hashId, _param_hasTools = param.hasTools, hasTools = _param_hasTools === void 0 ? false : _param_hasTools, onResize = param.onResize, sendButtonProps = param.sendButtonProps, triggerSendKey = param.triggerSendKey;
     var fileMap = attachment === null || attachment === void 0 ? void 0 : attachment.fileMap;
+    var sendDisabled = resolveSendDisabled(sendButtonProps, fileUploadStatus);
     var defaultActionsLen = [
         (attachment === null || attachment === void 0 ? void 0 : attachment.enable) ? '()' : null,
         voiceRecognizer ? '()' : null,
@@ -104,11 +105,10 @@ import { MARKDOWN_INPUT_FIELD_TEST_IDS } from "../testIds";
                     return Promise.resolve();
                 }
             }) : null,
-            /*#__PURE__*/ React.createElement(SendButton, _object_spread({
+            /*#__PURE__*/ React.createElement(SendButton, _object_spread_props(_object_spread({
                 key: "send-button",
                 typing: !!typing || !!isLoading,
                 isSendable: allowEmptySubmit || !!(value === null || value === void 0 ? void 0 : value.trim()) || fileMap && fileMap.size > 0 || recording,
-                disabled: disabled,
                 onClick: function onClick() {
                     if (typing || isLoading) {
                         onStop === null || onStop === void 0 ? void 0 : onStop();
@@ -117,11 +117,14 @@ import { MARKDOWN_INPUT_FIELD_TEST_IDS } from "../testIds";
                     onSend === null || onSend === void 0 ? void 0 : onSend();
                 },
                 triggerSendKey: triggerSendKey
-            }, sendButtonProps))
+            }, sendButtonProps), {
+                disabled: disabled || sendDisabled
+            }))
         ].filter(Boolean);
     }, [
         attachment,
         fileUploadDone,
+        sendDisabled,
         value,
         collapseSendActions,
         isLoading,

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

@@ -1,4 +1,5 @@
 import React from 'react';
+import type { FileUploadManagerReturn } from '../FileUploadManager';
 /**
  * 按钮颜色配置
  */
@@ -18,7 +19,12 @@ export type SendButtonColors = {
 export type SendButtonCustomizationProps = {
     compact?: boolean;
     colors?: SendButtonColors;
+    disabled?: boolean;
 };
+/**
+ * 解析发送按钮的最终禁用状态：用户显式传入优先，否则按上传状态判断
+ */
+export declare function resolveSendDisabled(sendButtonProps: SendButtonCustomizationProps | undefined, fileUploadStatus: FileUploadManagerReturn['fileUploadStatus'] | undefined): boolean;
 /**
  * Props for the SendButton component.
  */

package/dist/MarkdownInputField/SendButton/index.js

@@ -70,6 +70,12 @@ import { ErrorBoundary } from "react-error-boundary";
 import { StopIcon } from "../../AgentRunBar/icons";
 import { I18nContext } from "../../I18n";
 import { useStyle } from "./style";
+/**
+ * 解析发送按钮的最终禁用状态：用户显式传入优先，否则按上传状态判断
+ */ export function resolveSendDisabled(sendButtonProps, fileUploadStatus) {
+    var _ref;
+    return (_ref = sendButtonProps === null || sendButtonProps === void 0 ? void 0 : sendButtonProps.disabled) !== null && _ref !== void 0 ? _ref : fileUploadStatus === 'uploading';
+}
 var DEFAULT_SEND_BUTTON_COLORS = {
     icon: '#00183D',
     iconHover: '#fff',

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

@@ -4,6 +4,7 @@ import type { AttachmentFile } from '../AttachmentButton/types';
 import type { MarkdownInputFieldProps } from '../types/MarkdownInputFieldProps';
 interface UseMarkdownInputFieldHandlersParams {
     props: Pick<MarkdownInputFieldProps, 'disabled' | 'typing' | 'onChange' | 'onSend' | 'allowEmptySubmit' | 'markdownProps' | 'attachment' | 'triggerSendKey'>;
+    sendDisabled?: boolean;
     markdownEditorRef: React.MutableRefObject<MarkdownEditorInstance | undefined>;
     inputRef: React.RefObject<HTMLDivElement>;
     isSendingRef: React.MutableRefObject<boolean>;
@@ -22,7 +23,7 @@ interface UseMarkdownInputFieldHandlersParams {
  * 事件处理 Hook
  * 管理组件中的所有事件处理函数
  */
-export declare const useMarkdownInputFieldHandlers: ({ props, markdownEditorRef, inputRef, isSendingRef, isLoading, setIsLoading, value, setValue, fileMap, setFileMap, recording, stopRecording, isEnlarged, setIsEnlarged, }: UseMarkdownInputFieldHandlersParams) => {
+export declare const useMarkdownInputFieldHandlers: ({ props, sendDisabled, markdownEditorRef, inputRef, isSendingRef, isLoading, setIsLoading, value, setValue, fileMap, setFileMap, recording, stopRecording, isEnlarged, setIsEnlarged, }: UseMarkdownInputFieldHandlersParams) => {
     handleEnlargeClick: () => void;
     sendMessage: () => Promise<void>;
     handlePaste: (e: React.ClipboardEvent<HTMLDivElement>) => Promise<void>;

package/dist/MarkdownInputField/hooks/useMarkdownInputFieldHandlers.js

@@ -189,7 +189,7 @@ import { getFileListFromDataTransferItems } from "../FilePaste";
  * 事件处理 Hook
  * 管理组件中的所有事件处理函数
  */ export var useMarkdownInputFieldHandlers = function useMarkdownInputFieldHandlers(param) {
-    var props = param.props, markdownEditorRef = param.markdownEditorRef, inputRef = param.inputRef, isSendingRef = param.isSendingRef, isLoading = param.isLoading, setIsLoading = param.setIsLoading, value = param.value, setValue = param.setValue, fileMap = param.fileMap, setFileMap = param.setFileMap, recording = param.recording, stopRecording = param.stopRecording, isEnlarged = param.isEnlarged, setIsEnlarged = param.setIsEnlarged;
+    var props = param.props, sendDisabled = param.sendDisabled, markdownEditorRef = param.markdownEditorRef, inputRef = param.inputRef, isSendingRef = param.isSendingRef, isLoading = param.isLoading, setIsLoading = param.setIsLoading, value = param.value, setValue = param.setValue, fileMap = param.fileMap, setFileMap = param.setFileMap, recording = param.recording, stopRecording = param.stopRecording, isEnlarged = param.isEnlarged, setIsEnlarged = param.setIsEnlarged;
     /**
    * 处理放大缩小按钮点击
    * @description 切换编辑器的放大/缩小状态
@@ -206,6 +206,7 @@ import { getFileListFromDataTransferItems } from "../FilePaste";
             return _ts_generator(this, function(_state) {
                 switch(_state.label){
                     case 0:
+                        // 这个 disable 是整体 input 的禁用
                         if (props.disabled) return [
                             2
                         ];
@@ -220,6 +221,10 @@ import { getFileListFromDataTransferItems } from "../FilePaste";
                         if (isSendingRef.current) return [
                             2
                         ];
+                        // 这个是发送按钮的单独禁用
+                        if (sendDisabled) return [
+                            2
+                        ];
                         if (!recording) return [
                             3,
                             2
@@ -401,8 +406,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/AnimationText.d.ts

@@ -14,10 +14,6 @@ export interface AnimationTextProps {
     children: React.ReactNode;
     animationConfig?: AnimationConfig;
 }
-/**
- * 流式文字淡入动画组件。
- *
- * 同一段流式前缀追加（或尾部截断修正）只触发一次入场动画；非前缀替换时重播。
- */
+/** 流式文字淡入，前缀追加只触发一次入场，非前缀替换时重播 */
 declare const AnimationText: React.NamedExoticComponent<AnimationTextProps>;
 export default AnimationText;

package/dist/MarkdownRenderer/AnimationText.js

@@ -45,9 +45,7 @@ function _unsupported_iterable_to_array(o, minLen) {
     if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _array_like_to_array(o, minLen);
 }
 import React, { useEffect, useMemo, useRef, useState } from "react";
-/**
- * 提取 React children 的纯文本
- */ var extractText = function extractText1(children) {
+var extractText = function extractText1(children) {
     var _children_props;
     if (typeof children === 'string') return children;
     if (typeof children === 'number') return String(children);
@@ -60,11 +58,7 @@ import React, { useEffect, useMemo, useRef, useState } from "react";
 /** 流式同一段内：前后文案仅「前缀关系」变化（增长或尾部截断修正） */ var isStreamingCompatible = function isStreamingCompatible(prev, next) {
     return prev.startsWith(next) || next.startsWith(prev);
 };
-/**
- * 流式文字淡入动画组件。
- *
- * 同一段流式前缀追加（或尾部截断修正）只触发一次入场动画；非前缀替换时重播。
- */ var AnimationText = /*#__PURE__*/ React.memo(function(param) {
+/** 流式文字淡入，前缀追加只触发一次入场，非前缀替换时重播 */ 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 ? 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];

package/dist/MarkdownRenderer/CharacterQueue.d.ts

@@ -23,9 +23,7 @@ export declare class CharacterQueue {
     complete(): void;
     /** 释放资源 */
     dispose(): void;
-    /** 当前已展示的长度 */
     getDisplayedLength(): number;
-    /** 完整内容 */
     getFullContent(): string;
     private ensureTicking;
     private tick;

package/dist/MarkdownRenderer/CharacterQueue.js

@@ -126,13 +126,13 @@ var DEFAULT_BACKGROUND_BATCH_MULTIPLIER = 10;
             }
         },
         {
-            /** 当前已展示的长度 */ key: "getDisplayedLength",
+            key: "getDisplayedLength",
             value: function getDisplayedLength() {
                 return this.displayedLength;
             }
         },
         {
-            /** 完整内容 */ key: "getFullContent",
+            key: "getFullContent",
             value: function getFullContent() {
                 return this.fullContent;
             }

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.d.ts

@@ -1,13 +1,5 @@
 import React from 'react';
 import type { MarkdownRendererProps, MarkdownRendererRef } from './types';
-/**
- * MarkdownRenderer —— 流式/只读场景下的轻量 Markdown 渲染器。
- *
- * 核心优势：
- * - 不创建 Slate 实例，无编辑态开销
- * - 字符队列驱动流式逐字输出动画
- * - Markdown → hast → React 元素树（hast-util-to-jsx-runtime）
- * - 特殊块（code / mermaid / chart / katex）通过组件映射拦截渲染
- */
+/** 轻量流式 Markdown 渲染器——无 Slate 实例，Markdown → hast → React */
 declare const InternalMarkdownRenderer: React.ForwardRefExoticComponent<MarkdownRendererProps & React.RefAttributes<MarkdownRendererRef>>;
 export default InternalMarkdownRenderer;

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,24 +230,18 @@ 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
     }));
 };
-/**
- * MarkdownRenderer —— 流式/只读场景下的轻量 Markdown 渲染器。
- *
- * 核心优势：
- * - 不创建 Slate 实例，无编辑态开销
- * - 字符队列驱动流式逐字输出动画
- * - 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;
+/** 轻量流式 Markdown 渲染器——无 Slate 实例，Markdown → hast → React */ 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, fncProps = props.fncProps, editorCodeProps = props.codeProps;
     var getPrefixCls = useContext(ConfigProvider.ConfigContext).getPrefixCls;
     // 复用 MarkdownEditor 的 CSS 前缀和样式，保持渲染一致性
     var prefixCls = getPrefixCls('agentic-md-editor', customPrefixCls);
@@ -333,6 +329,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 +347,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 +362,8 @@ var SCHEMA_LANGUAGES = new Set([
     }, [
         pluginComponents,
         apaasifyRender,
-        fileMapConfig
+        fileMapConfig,
+        editorCodeProps
     ]);
     // 流式缓存：将不完整的 Markdown token 暂缓，避免 parser 错误解析
     var safeContent = useStreaming(displayedContent, streaming);
@@ -367,6 +373,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/StreamingCursor.d.ts

@@ -0,0 +1,4 @@
+import React from 'react';
+/** 流式闪烁光标，由 MarkdownBlockPiece 控制挂载/卸载 */
+declare const StreamingCursor: React.FC;
+export { StreamingCursor };

package/dist/MarkdownRenderer/StreamingCursor.js

@@ -0,0 +1,20 @@
+import React from "react";
+/** 流式闪烁光标，由 MarkdownBlockPiece 控制挂载/卸载 */ var StreamingCursor = function StreamingCursor() {
+    return /*#__PURE__*/ React.createElement("span", {
+        "data-streaming-cursor": "",
+        "data-testid": "streaming-cursor",
+        "aria-hidden": "true",
+        style: {
+            display: 'inline-block',
+            width: 2,
+            height: '1.1em',
+            marginLeft: 2,
+            verticalAlign: 'text-bottom',
+            backgroundColor: 'currentColor',
+            borderRadius: 1,
+            animation: 'markdownStreamingCursorFadeIn 0.2s ease-out forwards, markdownStreamingCursorBlink 0.8s ease-in-out 0.2s infinite'
+        }
+    });
+};
+StreamingCursor.displayName = 'StreamingCursor';
+export { StreamingCursor };