@ant-design/agentic-ui 2.30.21 → 2.30.23

package/dist/MarkdownEditor/editor/plugins/useKeyboard.js

@@ -116,16 +116,20 @@ var SPECIAL_ENTER_BLOCK_TYPES = new Set([
     // 从 editorProps.jinja 读取（BaseMarkdownEditor 已写入 effectiveJinja），支持插件配置的 trigger
     var effectiveJinja = editorProps === null || editorProps === void 0 ? void 0 : editorProps.jinja;
     var jinjaTrigger = (effectiveJinja === null || effectiveJinja === void 0 ? void 0 : effectiveJinja.templatePanel) && _type_of(effectiveJinja.templatePanel) === 'object' && effectiveJinja.templatePanel.trigger || '{}';
+    var matchInputToNodeRef = useRef(false);
+    matchInputToNodeRef.current = (props === null || props === void 0 ? void 0 : (_props_markdown = props.markdown) === null || _props_markdown === void 0 ? void 0 : _props_markdown.matchInputToNode) === true;
     var matchKeyRef = useRef(null);
     if (matchKeyRef.current === null) {
-        matchKeyRef.current = new MatchKey(markdownEditorRef);
+        matchKeyRef.current = new MatchKey(markdownEditorRef, function() {
+            return matchInputToNodeRef.current;
+        });
     }
     return useMemo(function() {
         var tab = new TabKey(markdownEditorRef.current);
         var backspace = new BackspaceKey(markdownEditorRef.current);
         var enter = new EnterKey(store, backspace);
         return function(e) {
-            var _props_markdown, _e_nativeEvent, _node_;
+            var _e_nativeEvent, _node_, _e_nativeEvent1;
             // 只读模式下跳过所有键盘处理，提升性能
             if (props.readonly) return;
             // 处理表格键盘事件
@@ -173,10 +177,10 @@ var SPECIAL_ENTER_BLOCK_TYPES = new Set([
             if (isHotkey('mod+shift+s', e)) {
                 e.preventDefault();
             }
-            // 仅当显式开启 matchInputToNode 时才执行输入转节点（如 "- " 转列表），默认关闭
-            // IME 输入法组合期间不触发，避免输入「-」后按空格选字时误转为列表
-            if ((props === null || props === void 0 ? void 0 : (_props_markdown = props.markdown) === null || _props_markdown === void 0 ? void 0 : _props_markdown.matchInputToNode) === true && !((_e_nativeEvent = e.nativeEvent) === null || _e_nativeEvent === void 0 ? void 0 : _e_nativeEvent.isComposing)) {
-                if (matchKeyRef.current.run(e)) return;
+            // Markdown 短语法转节点（``` / --- / 列表等）由 MatchKey 处理
+            // IME 组合期间不触发，避免选字时误转
+            if (!((_e_nativeEvent = e.nativeEvent) === null || _e_nativeEvent === void 0 ? void 0 : _e_nativeEvent.isComposing) && matchKeyRef.current.run(e)) {
+                return;
             }
             if (e.key.toLowerCase().startsWith('arrow')) {
                 if ([
@@ -250,48 +254,47 @@ var SPECIAL_ENTER_BLOCK_TYPES = new Set([
                 // 不在特殊块中，让 MarkdownInputField 处理发送
                 return;
             }
-            var _Editor_nodes2 = _sliced_to_array(Editor.nodes(markdownEditorRef.current, {
+            var sel = markdownEditorRef.current.selection;
+            if (!sel || !Range.isCollapsed(sel)) {
+                return;
+            }
+            var blockIter = Editor.nodes(markdownEditorRef.current, {
+                at: sel.anchor,
                 match: function match(n) {
                     return Element.isElement(n);
                 },
                 mode: 'lowest'
-            }), 1), node2 = _Editor_nodes2[0];
-            if (!node2) return;
-            if ((node2 === null || node2 === void 0 ? void 0 : (_node_ = node2[0]) === null || _node_ === void 0 ? void 0 : _node_.type) === 'paragraph') {
-                var _Editor_nodes3 = _sliced_to_array(Editor.nodes(markdownEditorRef.current, {
-                    match: function match(n) {
-                        return Element.isElement(n) && n.type === 'paragraph';
-                    },
-                    mode: 'lowest'
-                }), 1), paraNode = _Editor_nodes3[0];
-                var node3 = paraNode;
-                if (node3) {
-                    var _e_nativeEvent1;
-                    var sel = markdownEditorRef.current.selection;
-                    // Jinja 触发：基于光标位置检测，支持在任意位置输入 {}（含两个模板中间）
-                    if (jinjaTemplatePanelEnabled && e.key.length === 1 && !((_e_nativeEvent1 = e.nativeEvent) === null || _e_nativeEvent1 === void 0 ? void 0 : _e_nativeEvent1.isComposing) && sel && Range.isCollapsed(sel) && Path.isAncestor(node3[1], sel.anchor.path) && setOpenJinjaTemplate && setJinjaAnchorPath) {
-                        var strBeforeCursor = Editor.string(markdownEditorRef.current, Editor.range(markdownEditorRef.current, Editor.start(markdownEditorRef.current, node3[1]), sel.anchor));
-                        var strAfterKeyAtCursor = strBeforeCursor + (e.key.length === 1 ? e.key : '');
-                        if (strAfterKeyAtCursor.endsWith(jinjaTrigger)) {
-                            setJinjaAnchorPath(node3[1]);
-                            setTimeout(function() {
-                                return setOpenJinjaTemplate(true);
-                            });
-                            return;
-                        }
-                    }
+            });
+            var blockFirst = blockIter.next();
+            if (blockFirst.done) {
+                return;
+            }
+            var node2 = blockFirst.value;
+            if ((node2 === null || node2 === void 0 ? void 0 : (_node_ = node2[0]) === null || _node_ === void 0 ? void 0 : _node_.type) !== 'paragraph') {
+                return;
+            }
+            // Jinja 触发：基于光标位置检测，支持在任意位置输入 {}（含两个模板中间）
+            if (jinjaTemplatePanelEnabled && e.key.length === 1 && !((_e_nativeEvent1 = e.nativeEvent) === null || _e_nativeEvent1 === void 0 ? void 0 : _e_nativeEvent1.isComposing) && Path.isAncestor(node2[1], sel.anchor.path) && setOpenJinjaTemplate && setJinjaAnchorPath) {
+                var strBeforeCursor = Editor.string(markdownEditorRef.current, Editor.range(markdownEditorRef.current, Editor.start(markdownEditorRef.current, node2[1]), sel.anchor));
+                var strAfterKeyAtCursor = strBeforeCursor + (e.key.length === 1 ? e.key : '');
+                if (strAfterKeyAtCursor.endsWith(jinjaTrigger)) {
+                    setJinjaAnchorPath(node2[1]);
+                    setTimeout(function() {
+                        return setOpenJinjaTemplate(true);
+                    });
+                    return;
                 }
-                if (node3 && node3[0].children.length === 1 && !EditorUtils.isDirtLeaf(node3[0].children[0]) && (e.key === 'Backspace' || /^[^\n]$/.test(e.key))) {
-                    var str = Node.string(node3[0]) || '';
-                    var codeMatch = str.match(/^```([\w+\-#]+)$/i);
-                    if (codeMatch) {} else {
-                        var insertMatch = str.match(/^\/([^\n]+)?$/i);
-                        if (insertMatch && !(!Path.hasPrevious(node3[1]) && Node.parent(markdownEditorRef.current, node3[1]).type === 'list-item')) {
-                            setOpenInsertCompletion === null || setOpenInsertCompletion === void 0 ? void 0 : setOpenInsertCompletion(true);
-                            setTimeout(function() {
-                                insertCompletionText$.next(insertMatch[1]);
-                            });
-                        }
+            }
+            if (node2[0].children.length === 1 && !EditorUtils.isDirtLeaf(node2[0].children[0]) && (e.key === 'Backspace' || /^[^\n]$/.test(e.key))) {
+                var str = Node.string(node2[0]) || '';
+                var codeMatch = str.match(/^```([\w+\-#]+)$/i);
+                if (!codeMatch) {
+                    var insertMatch = str.match(/^\/([^\n]+)?$/i);
+                    if (insertMatch && !(!Path.hasPrevious(node2[1]) && Node.parent(markdownEditorRef.current, node2[1]).type === 'list-item')) {
+                        setOpenInsertCompletion === null || setOpenInsertCompletion === void 0 ? void 0 : setOpenInsertCompletion(true);
+                        setTimeout(function() {
+                            insertCompletionText$.next(insertMatch[1]);
+                        });
                     }
                 }
             }
@@ -299,7 +302,6 @@ var SPECIAL_ENTER_BLOCK_TYPES = new Set([
     }, [
         markdownEditorRef.current,
         props === null || props === void 0 ? void 0 : props.readonly,
-        props === null || props === void 0 ? void 0 : (_props_markdown = props.markdown) === null || _props_markdown === void 0 ? void 0 : _props_markdown.matchInputToNode,
         openInsertCompletion,
         insertCompletionText$,
         setOpenInsertCompletion,

package/dist/MarkdownEditor/editor/plugins/withCodeTagPlugin.js

@@ -168,19 +168,7 @@ import { hasRange } from "./utils";
             }
         }
         if ((currentNode1 === null || currentNode1 === void 0 ? void 0 : currentNode1.tag) && operation.text.trim().length > 0 && currentNode1.text.trim().length === 0) {
-            Editor.withoutNormalizing(editor, function() {
-                Transforms.removeNodes(editor, {
-                    at: operation.path
-                });
-                Transforms.insertNodes(editor, _object_spread_props(_object_spread({}, currentNode1), {
-                    tag: true,
-                    code: true,
-                    text: operation.text
-                }), {
-                    at: operation.path,
-                    select: true
-                });
-            });
+            apply(operation);
             return true;
         }
     }

package/dist/MarkdownEditor/editor/store.d.ts

@@ -203,6 +203,18 @@ export declare class EditorStore {
      * 取消当前正在进行的 setMDContent 操作
      */
     cancelSetMDContent(): void;
+    /**
+     * 安全地取消编辑器选区。
+     *
+     * ReactEditor.deselect() 内部调用 window.getSelection().removeAllRanges()，
+     * 当编辑器处于聚焦状态时，浏览器要求必须存在活跃选区才能操作，
+     * 否则抛出 InvalidStateError("Failed to execute 'collapseToEnd' on 'Selection'")。
+     *
+     * 双重防御策略：
+     * 1. isFocused 检查 —— 大多数情况下直接跳过（性能优先）
+     * 2. try-catch —— 覆盖 isFocused 与 deselect 之间的竞态窗口
+     */
+    private _safeDeselect;
     /**
      * 使用 requestAnimationFrame 分批解析和设置内容
      * 边解析边插入，实时显示内容
@@ -650,7 +662,9 @@ export declare class EditorStore {
         maxResults?: number;
     }): {
         path: Path;
-        range: import("slate").BaseRange;
+        range: import("slate").BaseRange; /**
+         * 更新结构不同的表格
+         */
         node: any;
         matchedText: string;
         offset: {

package/dist/MarkdownEditor/editor/store.js

@@ -237,9 +237,13 @@ export var EditorStoreContext = createContext(null);
             value: function focus() {
                 var editor = this._editor.current;
                 try {
-                    // 1. 确保编辑器获得焦点
+                    // 1. 确保编辑器获得焦点（异步，需要单独 try-catch 防止白屏）
                     setTimeout(function() {
-                        return ReactEditor.focus(editor);
+                        try {
+                            ReactEditor.focus(editor);
+                        } catch (e) {
+                            console.error('ReactEditor.focus 失败:', e);
+                        }
                     }, 0);
                     // 2. 处理空文档情况
                     if (editor.children.length === 0) {
@@ -400,8 +404,7 @@ export var EditorStoreContext = createContext(null);
    * Clears all content from the editor, replacing it with an empty paragraph.
    */ key: "clearContent",
             value: function clearContent() {
-                this._editor.current.selection = null;
-                this._editor.current.children = [
+                EditorUtils.replaceEditorContent(this._editor.current, [
                     {
                         type: 'paragraph',
                         children: [
@@ -410,7 +413,7 @@ export var EditorStoreContext = createContext(null);
                             }
                         ]
                     }
-                ];
+                ]);
             }
         },
         {
@@ -474,9 +477,9 @@ export var EditorStoreContext = createContext(null);
    */ function _setShortContent(md, plugins, onProgress) {
                 try {
                     var nodeList = parserMdToSchema(md, plugins).schema;
+                    this._editor.current.selection = null;
                     this.setContent(nodeList);
-                    this._editor.current.children = nodeList;
-                    ReactEditor.deselect(this._editor.current);
+                    this._safeDeselect();
                     onProgress === null || onProgress === void 0 ? void 0 : onProgress(1);
                 } catch (error) {
                     console.error('Failed to set MD content:', error);
@@ -492,9 +495,9 @@ export var EditorStoreContext = createContext(null);
                 try {
                     var allNodes = this._parseChunksToNodes(chunks, plugins);
                     if (allNodes.length > 0) {
+                        this._editor.current.selection = null;
                         this.setContent(allNodes);
-                        this._editor.current.children = allNodes;
-                        ReactEditor.deselect(this._editor.current);
+                        this._safeDeselect();
                     }
                     onProgress === null || onProgress === void 0 ? void 0 : onProgress(1);
                 } catch (error) {
@@ -547,6 +550,27 @@ export var EditorStoreContext = createContext(null);
                 }
             }
         },
+        {
+            key: "_safeDeselect",
+            value: /**
+   * 安全地取消编辑器选区。
+   *
+   * ReactEditor.deselect() 内部调用 window.getSelection().removeAllRanges()，
+   * 当编辑器处于聚焦状态时，浏览器要求必须存在活跃选区才能操作，
+   * 否则抛出 InvalidStateError("Failed to execute 'collapseToEnd' on 'Selection'")。
+   *
+   * 双重防御策略：
+   * 1. isFocused 检查 —— 大多数情况下直接跳过（性能优先）
+   * 2. try-catch —— 覆盖 isFocused 与 deselect 之间的竞态窗口
+   */ function _safeDeselect() {
+                if (ReactEditor.isFocused(this._editor.current)) return;
+                try {
+                    ReactEditor.deselect(this._editor.current);
+                } catch (unused) {
+                // InvalidStateError：编辑器在 isFocused 检查与 deselect 调用之间获得了焦点，忽略即可
+                }
+            }
+        },
         {
             key: "_parseAndSetContentWithRAF",
             value: /**
@@ -599,9 +623,7 @@ export var EditorStoreContext = createContext(null);
                                         var schema = parserMdToSchema(chunk, plugins).schema;
                                         if (schema.length > 0) {
                                             if (isFirstBatch) {
-                                                // 第一批：清空并插入
-                                                _this._editor.current.children = schema;
-                                                _this._editor.current.onChange();
+                                                EditorUtils.replaceEditorContent(_this._editor.current, schema);
                                                 isFirstBatch = false;
                                             } else {
                                                 // 后续批次：追加节点
@@ -634,7 +656,7 @@ export var EditorStoreContext = createContext(null);
                                 rafId = requestAnimationFrame(parseAndInsertNextBatch);
                             } else {
                                 // 所有内容处理完成
-                                ReactEditor.deselect(_this._editor.current);
+                                _this._safeDeselect();
                                 rafId = null;
                                 _this._currentAbortController = null;
                                 resolve();
@@ -885,11 +907,14 @@ export var EditorStoreContext = createContext(null);
    * @param newNode - 新节点
    * @private
    */ function _replaceNodeAt(path, newNode) {
-                Transforms.removeNodes(this._editor.current, {
-                    at: path
-                });
-                Transforms.insertNodes(this._editor.current, newNode, {
-                    at: path
+                var _this = this;
+                Editor.withoutNormalizing(this._editor.current, function() {
+                    Transforms.removeNodes(_this._editor.current, {
+                        at: path
+                    });
+                    Transforms.insertNodes(_this._editor.current, newNode, {
+                        at: path
+                    });
                 });
             }
         },
@@ -900,21 +925,7 @@ export var EditorStoreContext = createContext(null);
    * @param nodeList - 要设置为编辑器内容的节点列表
    */ key: "setContent",
             value: function setContent(nodeList) {
-                var currentChildren = this._editor.current.children;
-                this._editor.current.children = nodeList;
-                this._editor.current.onChange();
-                // 检查最后一个节点是否以换行符结尾
-                var lastNode = currentChildren[currentChildren.length - 1];
-                if (lastNode && Text.isText(lastNode)) {
-                    var text = Node.string(lastNode);
-                    if (!text.endsWith('\n')) {
-                        this._editor.current.insertText('\n', {
-                            at: [
-                                currentChildren.length - 1
-                            ]
-                        });
-                    }
-                }
+                EditorUtils.replaceEditorContent(this._editor.current, nodeList);
             }
         },
         {
@@ -954,7 +965,7 @@ export var EditorStoreContext = createContext(null);
                     }
                 } catch (error) {
                     console.error('Failed to update nodes with optimized method:', error);
-                    this._editor.current.children = nodeList;
+                    EditorUtils.replaceEditorContent(this._editor.current, nodeList);
                 }
             }
         },

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/MarkdownEditor/editor/utils/editorCommands.js

@@ -98,6 +98,73 @@ import { EditorUtils } from "./editorUtils";
         }
     });
 }
+/** 光标所在段落/标题；避免 getCurrentNodes 取到 list-item 等子块导致插入路径错误 */ function resolveParagraphOrHead(editor, preferred) {
+    if ((preferred === null || preferred === void 0 ? void 0 : preferred[0]) && [
+        'paragraph',
+        'head'
+    ].includes(preferred[0].type)) {
+        return preferred;
+    }
+    var selection = editor.selection;
+    if (selection) {
+        var above = Editor.above(editor, {
+            at: selection.anchor,
+            match: function match(n) {
+                return Element.isElement(n) && [
+                    'paragraph',
+                    'head'
+                ].includes(n.type);
+            }
+        });
+        if (above) {
+            return above;
+        }
+    }
+    var nodesResult = Editor.nodes(editor, {
+        at: [],
+        match: function match(n) {
+            return Element.isElement(n) && [
+                'paragraph',
+                'head'
+            ].includes(n.type);
+        },
+        mode: 'lowest'
+    });
+    if (Array.isArray(nodesResult) && nodesResult.length > 0) {
+        var entry = nodesResult[0];
+        if ((entry === null || entry === void 0 ? void 0 : entry[0]) && [
+            'paragraph',
+            'head'
+        ].includes(entry[0].type)) {
+            return entry;
+        }
+        return undefined;
+    }
+    var iter = nodesResult;
+    if (iter && typeof iter.next === 'function') {
+        var first = iter.next();
+        return first.done ? undefined : first.value;
+    }
+    return undefined;
+}
+function firstLowestElement(editor) {
+    var nodesResult = Editor.nodes(editor, {
+        at: [],
+        match: function match(n) {
+            return Element.isElement(n);
+        },
+        mode: 'lowest'
+    });
+    if (Array.isArray(nodesResult) && nodesResult.length > 0) {
+        return nodesResult[0];
+    }
+    var iter = nodesResult;
+    if (iter && typeof iter.next === 'function') {
+        var first = iter.next();
+        return first.done ? undefined : first.value;
+    }
+    return undefined;
+}
 /**
  * 插入表格
  *
@@ -108,38 +175,44 @@ import { EditorUtils } from "./editorUtils";
  * @param editor Slate 编辑器实例
  * @param node 可选的节点，如果不提供则从编辑器获取
  */ export function insertTable(editor, node) {
-    var _currentNode_, _currentNode_1;
-    var currentNode = node || Array.from(getCurrentNodes(editor))[0];
+    var _resolveParagraphOrHead;
+    var _node_, _node_1, _currentNode_;
+    if ((node === null || node === void 0 ? void 0 : (_node_ = node[0]) === null || _node_ === void 0 ? void 0 : _node_.type) === 'column-cell') {
+        NativeTableEditor.insertTable(editor, {
+            rows: 3,
+            cols: 3,
+            at: _to_consumable_array(node[1]).concat([
+                0
+            ])
+        });
+        return;
+    }
+    if (node !== undefined && ![
+        'paragraph',
+        'head'
+    ].includes((_node_1 = node[0]) === null || _node_1 === void 0 ? void 0 : _node_1.type)) {
+        return;
+    }
+    var currentNode = node === undefined ? (_resolveParagraphOrHead = resolveParagraphOrHead(editor)) !== null && _resolveParagraphOrHead !== void 0 ? _resolveParagraphOrHead : firstLowestElement(editor) : resolveParagraphOrHead(editor, node);
     if (currentNode && [
         'paragraph',
         'head'
     ].includes(currentNode === null || currentNode === void 0 ? void 0 : (_currentNode_ = currentNode[0]) === null || _currentNode_ === void 0 ? void 0 : _currentNode_.type)) {
-        var _currentNode_2, _currentNode_3;
-        var path = (currentNode === null || currentNode === void 0 ? void 0 : (_currentNode_2 = currentNode[0]) === null || _currentNode_2 === void 0 ? void 0 : _currentNode_2.type) === 'paragraph' && !Node.string(currentNode[0]) ? currentNode[1] : Path.next(currentNode[1]);
+        var _currentNode_1, _currentNode_2;
+        var path = (currentNode === null || currentNode === void 0 ? void 0 : (_currentNode_1 = currentNode[0]) === null || _currentNode_1 === void 0 ? void 0 : _currentNode_1.type) === 'paragraph' && !Node.string(currentNode[0]) ? currentNode[1] : Path.next(currentNode[1]);
         // 使用原生表格编辑器插入表格
         NativeTableEditor.insertTable(editor, {
             rows: 3,
             cols: 3,
             at: path
         });
-        if ((currentNode === null || currentNode === void 0 ? void 0 : (_currentNode_3 = currentNode[0]) === null || _currentNode_3 === void 0 ? void 0 : _currentNode_3.type) === 'paragraph' && !Node.string(currentNode[0])) {
+        if ((currentNode === null || currentNode === void 0 ? void 0 : (_currentNode_2 = currentNode[0]) === null || _currentNode_2 === void 0 ? void 0 : _currentNode_2.type) === 'paragraph' && !Node.string(currentNode[0])) {
             Transforms.delete(editor, {
                 at: Path.next(path)
             });
         }
         Transforms.select(editor, Editor.start(editor, path));
     }
-    if (currentNode && [
-        'column-cell'
-    ].includes(currentNode === null || currentNode === void 0 ? void 0 : (_currentNode_1 = currentNode[0]) === null || _currentNode_1 === void 0 ? void 0 : _currentNode_1.type)) {
-        NativeTableEditor.insertTable(editor, {
-            rows: 3,
-            cols: 3,
-            at: _to_consumable_array(currentNode[1]).concat([
-                0
-            ])
-        });
-    }
 }
 /**
  * 插入代码块
@@ -151,7 +224,15 @@ import { EditorUtils } from "./editorUtils";
  * @param type 可选的代码块类型，'mermaid'表示流程图，'html'表示HTML渲染
  * @param node 可选的节点，如果不提供则从编辑器获取
  */ export function insertCodeBlock(editor, type, node) {
-    var currentNode = node || Array.from(getCurrentNodes(editor))[0];
+    var _resolveParagraphOrHead;
+    var _node_;
+    if (node !== undefined && ![
+        'paragraph',
+        'head'
+    ].includes((_node_ = node[0]) === null || _node_ === void 0 ? void 0 : _node_.type)) {
+        return;
+    }
+    var currentNode = node === undefined ? (_resolveParagraphOrHead = resolveParagraphOrHead(editor)) !== null && _resolveParagraphOrHead !== void 0 ? _resolveParagraphOrHead : firstLowestElement(editor) : resolveParagraphOrHead(editor, node);
     if (currentNode && currentNode[0] && [
         'paragraph',
         'head'

package/dist/MarkdownEditor/editor/utils/editorUtils.d.ts

@@ -11,6 +11,17 @@ export declare class EditorUtils {
             readonly text: "";
         }];
     };
+    /**
+     * 通过 Slate Transforms API 安全替换编辑器全部内容。
+     * 避免直接赋值 editor.children，确保 Operation/History/Normalizer 管线正常运行。
+     *
+     * @param editor - 编辑器实例
+     * @param nodes - 新的节点列表
+     * @param options.withoutHistory - 是否跳过 History 记录（默认 true，适用于外部数据同步场景）
+     */
+    static replaceEditorContent(editor: Editor, nodes: Node[], options?: {
+        withoutHistory?: boolean;
+    }): void;
     static hasPath(editor: Editor, path: Path): boolean;
     static focus(editor: Editor): void;
     static blur(editor: Editor): void;

package/dist/MarkdownEditor/editor/utils/editorUtils.js

@@ -135,6 +135,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);
 }
 /* eslint-disable no-param-reassign */ import { Editor, Element, Node, Path, Point, Range, Text, Transforms } from "slate";
+import { HistoryEditor } from "slate-history";
 import { ReactEditor } from "slate-react";
 import { getMediaType } from "./dom";
 export var EditorUtils = /*#__PURE__*/ function() {
@@ -156,6 +157,44 @@ export var EditorUtils = /*#__PURE__*/ function() {
                 };
             }
         },
+        {
+            key: "replaceEditorContent",
+            value: /**
+   * 通过 Slate Transforms API 安全替换编辑器全部内容。
+   * 避免直接赋值 editor.children，确保 Operation/History/Normalizer 管线正常运行。
+   *
+   * @param editor - 编辑器实例
+   * @param nodes - 新的节点列表
+   * @param options.withoutHistory - 是否跳过 History 记录（默认 true，适用于外部数据同步场景）
+   */ function replaceEditorContent(editor, nodes, options) {
+                var _ref = options || {}, _ref_withoutHistory = _ref.withoutHistory, withoutHistory = _ref_withoutHistory === void 0 ? true : _ref_withoutHistory;
+                var doReplace = function doReplace() {
+                    Editor.withoutNormalizing(editor, function() {
+                        if (editor.selection) {
+                            Transforms.deselect(editor);
+                        }
+                        var totalChildren = editor.children.length;
+                        for(var i = totalChildren - 1; i >= 0; i--){
+                            Transforms.removeNodes(editor, {
+                                at: [
+                                    i
+                                ]
+                            });
+                        }
+                        Transforms.insertNodes(editor, nodes, {
+                            at: [
+                                0
+                            ]
+                        });
+                    });
+                };
+                if (withoutHistory && HistoryEditor.isHistoryEditor(editor)) {
+                    HistoryEditor.withoutSaving(editor, doReplace);
+                } else {
+                    doReplace();
+                }
+            }
+        },
         {
             key: "hasPath",
             value: function hasPath(editor, path) {
@@ -485,18 +524,16 @@ export var EditorUtils = /*#__PURE__*/ function() {
    * @param insertNodes - 可选的插入节点数组。如果未提供，则使用默认段落节点
    * @param force - 可选的布尔值或历史记录对象。如果为布尔值，则强制重置历史记录；如果为历史记录对象，则使用提供的历史记录
    */ function reset(editor, insertNodes, force) {
-                var nodesToInsert = insertNodes || [
+                var nodesToInsert = JSON.parse(JSON.stringify(insertNodes || [
                     EditorUtils.p
-                ];
-                // 深克隆节点以避免引用问题
-                editor.children = JSON.parse(JSON.stringify(nodesToInsert));
-                if (force) {
+                ]));
+                EditorUtils.replaceEditorContent(editor, nodesToInsert);
+                if (force && HistoryEditor.isHistoryEditor(editor)) {
                     editor.history = typeof force === 'boolean' ? {
                         redos: [],
                         undos: []
                     } : force;
                 }
-                editor.onChange();
             }
         },
         {