@ant-design/agentic-ui 2.30.21 → 2.30.22

package/dist/Bubble/OpenAIMessageBubble/normalizeOpenClawMessages.js

@@ -0,0 +1,61 @@
+function _object_without_properties(source, excluded) {
+    if (source == null) return {};
+    var target = {}, sourceKeys, key, i;
+    if (typeof Reflect !== "undefined" && Reflect.ownKeys) {
+        sourceKeys = Reflect.ownKeys(source);
+        for(i = 0; i < sourceKeys.length; i++){
+            key = sourceKeys[i];
+            if (excluded.indexOf(key) >= 0) continue;
+            if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue;
+            target[key] = source[key];
+        }
+        return target;
+    }
+    target = _object_without_properties_loose(source, excluded);
+    if (Object.getOwnPropertySymbols) {
+        sourceKeys = Object.getOwnPropertySymbols(source);
+        for(i = 0; i < sourceKeys.length; i++){
+            key = sourceKeys[i];
+            if (excluded.indexOf(key) >= 0) continue;
+            if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue;
+            target[key] = source[key];
+        }
+    }
+    return target;
+}
+function _object_without_properties_loose(source, excluded) {
+    if (source == null) return {};
+    var target = {}, sourceKeys = Object.getOwnPropertyNames(source), key, i;
+    for(i = 0; i < sourceKeys.length; i++){
+        key = sourceKeys[i];
+        if (excluded.indexOf(key) >= 0) continue;
+        if (!Object.prototype.propertyIsEnumerable.call(source, key)) continue;
+        target[key] = source[key];
+    }
+    return target;
+}
+import { extractTextFromContent } from "./mapOpenAIMessages";
+/**
+ * 将单条 OpenClaw 风格消息转为可与 {@link mapOpenAIMessagesToMessageBubbleData} 兼容的 OpenAI 形状（`toolResult` → `tool`）。
+ */ export function normalizeOpenClawMessageToOpenAI(msg) {
+    if (msg.role === 'toolResult') {
+        var m = msg;
+        var content = m.content === undefined || m.content === null ? '' : typeof m.content === 'string' ? m.content : extractTextFromContent(m.content);
+        return {
+            role: 'tool',
+            id: m.id,
+            name: m.name,
+            content: content,
+            tool_call_id: m.tool_call_id
+        };
+    }
+    var _ts = msg.timestamp, rest = _object_without_properties(msg, [
+        "timestamp"
+    ]);
+    return rest;
+}
+/**
+ * 批量将 OpenClaw transcript 消息转为 OpenAI Chat Completions 兼容结构
+ */ export function normalizeOpenClawMessagesToOpenAI(messages) {
+    return messages.map(normalizeOpenClawMessageToOpenAI);
+}

package/dist/Bubble/OpenAIMessageBubble/ollamaTypes.d.ts

@@ -0,0 +1,48 @@
+import type { OpenAIMessagesMapOptions } from './types';
+/**
+ * Ollama Chat API 中 ToolCall（见官方 OpenAPI `ToolCall`）
+ */
+export interface OllamaToolCall {
+    function?: {
+        name: string;
+        description?: string;
+        arguments?: Record<string, unknown>;
+    };
+    /** 部分实现会带 id */
+    id?: string;
+    type?: string;
+}
+/**
+ * Ollama POST /api/chat 请求体中的单条 `messages[]`（见官方 `ChatMessage`）
+ */
+export interface OllamaChatMessage {
+    role: 'system' | 'user' | 'assistant' | 'tool';
+    /** 流式片段可能为空字符串 */
+    content: string;
+    /** 客户端为稳定列表 key 可带 id */
+    id?: string;
+    /** 多模态：base64 图片列表 */
+    images?: string[];
+    /** assistant 上模型发起的工具调用 */
+    tool_calls?: OllamaToolCall[];
+    /** `think` 开启时的思考过程（流式或完整响应） */
+    thinking?: string;
+    /** `role: tool` 时常用，与 OpenAI 的 tool 名称对应 */
+    tool_name?: string;
+    tool_call_id?: string;
+}
+/** Ollama 映射选项 */
+export interface OllamaMessagesMapOptions extends OpenAIMessagesMapOptions {
+    /**
+     * 为 true（默认）时，将 `thinking` 拼入展示用正文（映射后的 OpenAI assistant 文本）
+     */
+    appendThinkingToContent?: boolean;
+    /**
+     * 为 true（默认）时，若有 `images`，在正文中追加占位说明（不嵌入 base64）
+     */
+    appendImagesPlaceholder?: boolean;
+    /**
+     * 为 true（默认）时，在 `extra.ollama.raw` 保留原始 Ollama 消息
+     */
+    preserveOllamaRawInExtra?: boolean;
+}

package/dist/Bubble/OpenAIMessageBubble/ollamaTypes.js

@@ -0,0 +1 @@
+/** Ollama 映射选项 */ export { };

package/dist/Bubble/OpenAIMessageBubble/openClawTypes.d.ts

@@ -0,0 +1,27 @@
+import type { OpenAIChatContentPart, OpenAIChatMessageAssistant, OpenAIChatMessageFunction, OpenAIChatMessageSystem, OpenAIChatMessageTool, OpenAIChatMessageUser, OpenAIMessagesMapOptions } from './types';
+/**
+ * OpenClaw 会话 / transcript 常见字段：毫秒时间戳
+ */
+export type OpenClawChatMeta = {
+    id?: string;
+    timestamp?: number;
+    name?: string;
+};
+/** OpenClaw transcript 中工具结果常用 `toolResult`，与 OpenAI 的 `tool` 对应 */
+export interface OpenClawChatMessageToolResult extends OpenClawChatMeta {
+    role: 'toolResult';
+    content: string | OpenAIChatContentPart[] | null;
+    tool_call_id?: string;
+}
+export type OpenClawChatMessage = (OpenAIChatMessageSystem & OpenClawChatMeta) | (OpenAIChatMessageUser & OpenClawChatMeta) | (OpenAIChatMessageAssistant & OpenClawChatMeta) | (OpenAIChatMessageTool & OpenClawChatMeta) | (OpenAIChatMessageFunction & OpenClawChatMeta) | OpenClawChatMessageToolResult;
+/** OpenClaw 映射选项（在 OpenAI 选项基础上增加 transcript 行为） */
+export interface OpenClawMessagesMapOptions extends OpenAIMessagesMapOptions {
+    /**
+     * 为 true（默认）时，若消息含 `timestamp`（毫秒），写入 `createAt` / `updateAt`
+     */
+    useOpenClawTimestamps?: boolean;
+    /**
+     * 为 true（默认）时，在 `extra.openclaw.raw` 保留原始 OpenClaw 消息
+     */
+    preserveOpenClawRawInExtra?: boolean;
+}

package/dist/Bubble/OpenAIMessageBubble/openClawTypes.js

@@ -0,0 +1 @@
+/** OpenClaw 映射选项（在 OpenAI 选项基础上增加 transcript 行为） */ export { };

package/dist/Bubble/OpenAIMessageBubble/types.d.ts

@@ -0,0 +1,71 @@
+import type { MessageBubbleData } from '../../Types/message';
+import type { RoleType } from '../../Types/common';
+/**
+ * OpenAI Chat Completions 风格的多段 content（与官方结构兼容，库内自建）
+ */
+export interface OpenAIChatTextPart {
+    type: 'text';
+    text: string;
+}
+export interface OpenAIChatRefusalPart {
+    type?: 'refusal';
+    refusal?: string;
+}
+/** 多模态等其它 part 以弱类型保留 */
+export interface OpenAIChatContentPartFallback {
+    type: string;
+    [key: string]: unknown;
+}
+export type OpenAIChatContentPart = OpenAIChatTextPart | OpenAIChatRefusalPart | OpenAIChatContentPartFallback;
+export interface OpenAIChatMessageBase {
+    id?: string;
+    name?: string;
+    tool_calls?: unknown[];
+    function_call?: {
+        name?: string;
+        arguments?: string;
+    } | null;
+}
+export interface OpenAIChatMessageSystem extends OpenAIChatMessageBase {
+    role: 'system';
+    content: string | null;
+}
+export interface OpenAIChatMessageUser extends OpenAIChatMessageBase {
+    role: 'user';
+    content: string | OpenAIChatContentPart[] | null;
+}
+export interface OpenAIChatMessageAssistant extends OpenAIChatMessageBase {
+    role: 'assistant';
+    content: string | OpenAIChatContentPart[] | null;
+    tool_calls?: unknown[];
+    function_call?: OpenAIChatMessageBase['function_call'];
+}
+export interface OpenAIChatMessageTool extends OpenAIChatMessageBase {
+    role: 'tool';
+    content: string | null;
+    tool_call_id?: string;
+}
+export interface OpenAIChatMessageFunction extends OpenAIChatMessageBase {
+    role: 'function';
+    content: string | null;
+    name?: string;
+}
+export type OpenAIChatMessage = OpenAIChatMessageSystem | OpenAIChatMessageUser | OpenAIChatMessageAssistant | OpenAIChatMessageTool | OpenAIChatMessageFunction;
+/** 单条映射覆盖 */
+export type OpenAIMessagesMapMessage = (msg: OpenAIChatMessage, index: number, draft: MessageBubbleData) => MessageBubbleData;
+export interface OpenAIMessagesMapOptions {
+    /** createAt / updateAt 基准（毫秒） */
+    baseTime?: number;
+    /** 第 i 条：createAt = baseTime + i * timeStepMs */
+    timeStepMs?: number;
+    /** 为 true 时最后一条的 updateAt 使用 Date.now()（流式可选） */
+    bumpUpdateAtOnLastMessage?: boolean;
+    /** 生成 MessageBubbleData.id，默认不用 content，避免 SSE 抖动 */
+    getMessageId?: (msg: OpenAIChatMessage, index: number) => string;
+    /** tool / function 行映射到的 RoleType */
+    toolRoleAs?: RoleType;
+    /** assistant 是否将 tool_calls 等拼入展示文案 */
+    appendToolCallsToContent?: boolean;
+    /** 在 extra.openai 中保留原始 role 与 raw */
+    preserveRawInExtra?: boolean;
+}

package/dist/Bubble/OpenAIMessageBubble/types.js

@@ -0,0 +1 @@
+export { };

package/dist/Bubble/OpenAIMessageBubble/useOllamaMessageBubbleData.d.ts

@@ -0,0 +1,7 @@
+import type { MessageBubbleData } from '../../Types/message';
+import type { OpenAIMessagesMapMessage } from './types';
+import type { OllamaChatMessage, OllamaMessagesMapOptions } from './ollamaTypes';
+/**
+ * 将 Ollama `/api/chat` 的 messages 转为 MessageBubbleData[]（与 {@link mapOllamaMessagesToMessageBubbleData} 一致，带 memo）。
+ */
+export declare function useOllamaMessageBubbleData(messages: OllamaChatMessage[], mapOptions?: OllamaMessagesMapOptions, mapMessage?: OpenAIMessagesMapMessage): MessageBubbleData[];

package/dist/Bubble/OpenAIMessageBubble/useOllamaMessageBubbleData.js

@@ -0,0 +1,23 @@
+import { useMemo } from "react";
+import { mapOllamaMessagesToMessageBubbleData } from "./mapOllamaMessages";
+/**
+ * 将 Ollama `/api/chat` 的 messages 转为 MessageBubbleData[]（与 {@link mapOllamaMessagesToMessageBubbleData} 一致，带 memo）。
+ */ export function useOllamaMessageBubbleData(messages, mapOptions, mapMessage) {
+    var _ref = mapOptions !== null && mapOptions !== void 0 ? mapOptions : {}, baseTime = _ref.baseTime, timeStepMs = _ref.timeStepMs, bumpUpdateAtOnLastMessage = _ref.bumpUpdateAtOnLastMessage, getMessageId = _ref.getMessageId, toolRoleAs = _ref.toolRoleAs, appendToolCallsToContent = _ref.appendToolCallsToContent, preserveRawInExtra = _ref.preserveRawInExtra, appendThinkingToContent = _ref.appendThinkingToContent, appendImagesPlaceholder = _ref.appendImagesPlaceholder, preserveOllamaRawInExtra = _ref.preserveOllamaRawInExtra;
+    return useMemo(function() {
+        return mapOllamaMessagesToMessageBubbleData(messages, mapOptions, mapMessage);
+    }, [
+        messages,
+        baseTime,
+        timeStepMs,
+        bumpUpdateAtOnLastMessage,
+        getMessageId,
+        toolRoleAs,
+        appendToolCallsToContent,
+        preserveRawInExtra,
+        appendThinkingToContent,
+        appendImagesPlaceholder,
+        preserveOllamaRawInExtra,
+        mapMessage
+    ]);
+}

package/dist/Bubble/OpenAIMessageBubble/useOpenAIMessageBubbleData.d.ts

@@ -0,0 +1,6 @@
+import type { MessageBubbleData } from '../../Types/message';
+import type { OpenAIChatMessage, OpenAIMessagesMapMessage, OpenAIMessagesMapOptions } from './types';
+/**
+ * 将 OpenAI Chat Completions 风格的 messages 转为 MessageBubbleData[]（与 {@link mapOpenAIMessagesToMessageBubbleData} 一致，带 memo）。
+ */
+export declare function useOpenAIMessageBubbleData(messages: OpenAIChatMessage[], mapOptions?: OpenAIMessagesMapOptions, mapMessage?: OpenAIMessagesMapMessage): MessageBubbleData[];

package/dist/Bubble/OpenAIMessageBubble/useOpenAIMessageBubbleData.js

@@ -0,0 +1,20 @@
+import { useMemo } from "react";
+import { mapOpenAIMessagesToMessageBubbleData } from "./mapOpenAIMessages";
+/**
+ * 将 OpenAI Chat Completions 风格的 messages 转为 MessageBubbleData[]（与 {@link mapOpenAIMessagesToMessageBubbleData} 一致，带 memo）。
+ */ export function useOpenAIMessageBubbleData(messages, mapOptions, mapMessage) {
+    var _ref = mapOptions !== null && mapOptions !== void 0 ? mapOptions : {}, baseTime = _ref.baseTime, timeStepMs = _ref.timeStepMs, bumpUpdateAtOnLastMessage = _ref.bumpUpdateAtOnLastMessage, getMessageId = _ref.getMessageId, toolRoleAs = _ref.toolRoleAs, appendToolCallsToContent = _ref.appendToolCallsToContent, preserveRawInExtra = _ref.preserveRawInExtra;
+    return useMemo(function() {
+        return mapOpenAIMessagesToMessageBubbleData(messages, mapOptions, mapMessage);
+    }, [
+        messages,
+        baseTime,
+        timeStepMs,
+        bumpUpdateAtOnLastMessage,
+        getMessageId,
+        toolRoleAs,
+        appendToolCallsToContent,
+        preserveRawInExtra,
+        mapMessage
+    ]);
+}

package/dist/Bubble/OpenAIMessageBubble/useOpenClawMessageBubbleData.d.ts

@@ -0,0 +1,7 @@
+import type { MessageBubbleData } from '../../Types/message';
+import type { OpenAIMessagesMapMessage } from './types';
+import type { OpenClawChatMessage, OpenClawMessagesMapOptions } from './openClawTypes';
+/**
+ * 将 OpenClaw 会话 / transcript 风格的 messages 转为 MessageBubbleData[]（与 {@link mapOpenClawMessagesToMessageBubbleData} 一致，带 memo）。
+ */
+export declare function useOpenClawMessageBubbleData(messages: OpenClawChatMessage[], mapOptions?: OpenClawMessagesMapOptions, mapMessage?: OpenAIMessagesMapMessage): MessageBubbleData[];

package/dist/Bubble/OpenAIMessageBubble/useOpenClawMessageBubbleData.js

@@ -0,0 +1,22 @@
+import { useMemo } from "react";
+import { mapOpenClawMessagesToMessageBubbleData } from "./mapOpenClawMessages";
+/**
+ * 将 OpenClaw 会话 / transcript 风格的 messages 转为 MessageBubbleData[]（与 {@link mapOpenClawMessagesToMessageBubbleData} 一致，带 memo）。
+ */ export function useOpenClawMessageBubbleData(messages, mapOptions, mapMessage) {
+    var _ref = mapOptions !== null && mapOptions !== void 0 ? mapOptions : {}, baseTime = _ref.baseTime, timeStepMs = _ref.timeStepMs, bumpUpdateAtOnLastMessage = _ref.bumpUpdateAtOnLastMessage, getMessageId = _ref.getMessageId, toolRoleAs = _ref.toolRoleAs, appendToolCallsToContent = _ref.appendToolCallsToContent, preserveRawInExtra = _ref.preserveRawInExtra, useOpenClawTimestamps = _ref.useOpenClawTimestamps, preserveOpenClawRawInExtra = _ref.preserveOpenClawRawInExtra;
+    return useMemo(function() {
+        return mapOpenClawMessagesToMessageBubbleData(messages, mapOptions, mapMessage);
+    }, [
+        messages,
+        baseTime,
+        timeStepMs,
+        bumpUpdateAtOnLastMessage,
+        getMessageId,
+        toolRoleAs,
+        appendToolCallsToContent,
+        preserveRawInExtra,
+        useOpenClawTimestamps,
+        preserveOpenClawRawInExtra,
+        mapMessage
+    ]);
+}

package/dist/Bubble/index.d.ts

@@ -14,3 +14,5 @@ export * from './type';
 export { UserBubble } from './UserBubble';
 /** Schema Editor 相关导出 */
 export * from './schema-editor';
+/** OpenAI Chat messages → MessageBubbleData */
+export * from './OpenAIMessageBubble';

package/dist/Bubble/index.js

@@ -12,3 +12,4 @@ export * from "./MessagesContent/BubbleContext";
 export * from "./type";
 export { UserBubble } from "./UserBubble";
 /** Schema Editor 相关导出 */ export * from "./schema-editor";
+/** OpenAI Chat messages → MessageBubbleData */ export * from "./OpenAIMessageBubble";

package/dist/MarkdownEditor/editor/Editor.js

@@ -633,10 +633,14 @@ var defaultAllowedTypes = [
             // 2. 检查目标元素是否可编辑，如果不可编辑，则从DOM选区中获取编辑器选区
             if (operationType === 'copy' && !hasEditableTarget(markdownEditorRef.current, event.target)) {
                 var domSelection = window.getSelection();
-                markdownEditorRef.current.selection = getSelectionFromDomSelection(markdownEditorRef.current, domSelection);
+                if (domSelection) {
+                    markdownEditorRef.current.selection = getSelectionFromDomSelection(markdownEditorRef.current, domSelection);
+                }
             } else if (operationType === 'cut') {
                 var domSelection1 = window.getSelection();
-                markdownEditorRef.current.selection = getSelectionFromDomSelection(markdownEditorRef.current, domSelection1);
+                if (domSelection1) {
+                    markdownEditorRef.current.selection = getSelectionFromDomSelection(markdownEditorRef.current, domSelection1);
+                }
             }
             // 如果无法获取选区，则直接返回
             if (!markdownEditorRef.current.selection) {
@@ -970,12 +974,16 @@ var defaultAllowedTypes = [
             var _markdownEditorRef_current_selection1;
             var node = Node.get(markdownEditorRef.current, ((_markdownEditorRef_current_selection1 = markdownEditorRef.current.selection) === null || _markdownEditorRef_current_selection1 === void 0 ? void 0 : _markdownEditorRef_current_selection1.focus.path) || []);
             if (node) {
-                var dom = ReactEditor.toDOMNode(markdownEditorRef.current, node);
-                if (dom) {
-                    var tagInput = dom.querySelector('[data-tag-popup-input]');
-                    if (tagInput) {
-                        tagInput.setAttribute('data-composition', '');
+                try {
+                    var dom = ReactEditor.toDOMNode(markdownEditorRef.current, node);
+                    if (dom) {
+                        var tagInput = dom.querySelector('[data-tag-popup-input]');
+                        if (tagInput) {
+                            tagInput.setAttribute('data-composition', '');
+                        }
                     }
+                } catch (unused) {
+                // node may not be mounted yet; ignore
                 }
             }
         }
@@ -1003,12 +1011,16 @@ var defaultAllowedTypes = [
             var _markdownEditorRef_current_selection1;
             var node = Node.get(markdownEditorRef.current, ((_markdownEditorRef_current_selection1 = markdownEditorRef.current.selection) === null || _markdownEditorRef_current_selection1 === void 0 ? void 0 : _markdownEditorRef_current_selection1.focus.path) || []);
             if (node) {
-                var dom = ReactEditor.toDOMNode(markdownEditorRef.current, node);
-                if (dom) {
-                    var tagInput = dom.querySelector('[data-tag-popup-input]');
-                    if (tagInput) {
-                        tagInput.removeAttribute('data-composition');
+                try {
+                    var dom = ReactEditor.toDOMNode(markdownEditorRef.current, node);
+                    if (dom) {
+                        var tagInput = dom.querySelector('[data-tag-popup-input]');
+                        if (tagInput) {
+                            tagInput.removeAttribute('data-composition');
+                        }
                     }
+                } catch (unused) {
+                // node may have been unmounted during composition; ignore
                 }
             }
         }

package/dist/MarkdownEditor/editor/elements/Table/SimpleTable.js

@@ -64,7 +64,11 @@ import { TablePropsProvider } from "./TableContext";
     var baseCls = getPrefixCls('agentic-md-editor-content-table');
     var editor = useSlate();
     var tablePath = useMemo(function() {
-        return ReactEditor.findPath(editor, props.element);
+        try {
+            return ReactEditor.findPath(editor, props.element);
+        } catch (unused) {
+            return [];
+        }
     }, [
         props.element
     ]);

package/dist/MarkdownEditor/editor/elements/Table/commands/tableCommands.js

@@ -114,8 +114,12 @@ function forEachCellPath(editor, tablePath, callback) {
 }
 export function clearTableSelection(editor, tablePath) {
     forEachCellPath(editor, tablePath, function(_, cellNode) {
-        var domNode = ReactEditor.toDOMNode(editor, cellNode);
-        domNode === null || domNode === void 0 ? void 0 : domNode.removeAttribute('data-select');
+        try {
+            var domNode = ReactEditor.toDOMNode(editor, cellNode);
+            domNode === null || domNode === void 0 ? void 0 : domNode.removeAttribute('data-select');
+        } catch (unused) {
+        // cell may not be mounted yet
+        }
     });
 }
 export function selectTableRow(editor, tablePath, rowIndex) {
@@ -137,8 +141,12 @@ export function selectTableRow(editor, tablePath, rowIndex) {
         if (tableCellNode.type !== 'table-cell') {
             continue;
         }
-        var domNode = ReactEditor.toDOMNode(editor, tableCellNode);
-        domNode === null || domNode === void 0 ? void 0 : domNode.setAttribute('data-select', 'true');
+        try {
+            var domNode = ReactEditor.toDOMNode(editor, tableCellNode);
+            domNode === null || domNode === void 0 ? void 0 : domNode.setAttribute('data-select', 'true');
+        } catch (unused) {
+        // cell may not be mounted yet
+        }
     }
 }
 export function selectTableColumn(editor, tablePath, columnIndex) {
@@ -158,14 +166,22 @@ export function selectTableColumn(editor, tablePath, columnIndex) {
         if (tableCellNode.type !== 'table-cell') {
             continue;
         }
-        var domNode = ReactEditor.toDOMNode(editor, tableCellNode);
-        domNode === null || domNode === void 0 ? void 0 : domNode.setAttribute('data-select', 'true');
+        try {
+            var domNode = ReactEditor.toDOMNode(editor, tableCellNode);
+            domNode === null || domNode === void 0 ? void 0 : domNode.setAttribute('data-select', 'true');
+        } catch (unused) {
+        // cell may not be mounted yet
+        }
     }
 }
 export function selectWholeTable(editor, tablePath) {
     forEachCellPath(editor, tablePath, function(_, cellNode) {
-        var domNode = ReactEditor.toDOMNode(editor, cellNode);
-        domNode === null || domNode === void 0 ? void 0 : domNode.setAttribute('data-select', 'true');
+        try {
+            var domNode = ReactEditor.toDOMNode(editor, cellNode);
+            domNode === null || domNode === void 0 ? void 0 : domNode.setAttribute('data-select', 'true');
+        } catch (unused) {
+        // cell may not be mounted yet
+        }
     });
 }
 export function removeTableRow(editor, tablePath, rowIndex) {

package/dist/MarkdownEditor/editor/elements/index.js

@@ -387,20 +387,24 @@ var MLeafComponent = function MLeafComponent(props) {
                     setTimeout(function() {
                         if (!markdownEditorRef.current) return;
                         if (!(path === null || path === void 0 ? void 0 : path.length)) return;
-                        var nextPath = Path.next(path);
-                        if (!Editor.hasPath(markdownEditorRef.current, nextPath)) {
-                            Transforms.insertNodes(markdownEditorRef.current, [
-                                {
-                                    text: ' '
-                                }
-                            ], {
-                                select: true
-                            });
-                        } else {
-                            Transforms.select(markdownEditorRef.current, {
-                                anchor: Editor.end(markdownEditorRef.current, path),
-                                focus: Editor.end(markdownEditorRef.current, path)
-                            });
+                        try {
+                            var nextPath = Path.next(path);
+                            if (!Editor.hasPath(markdownEditorRef.current, nextPath)) {
+                                Transforms.insertNodes(markdownEditorRef.current, [
+                                    {
+                                        text: ' '
+                                    }
+                                ], {
+                                    select: true
+                                });
+                            } else {
+                                Transforms.select(markdownEditorRef.current, {
+                                    anchor: Editor.end(markdownEditorRef.current, path),
+                                    focus: Editor.end(markdownEditorRef.current, path)
+                                });
+                            }
+                        } catch (unused) {
+                        // path may have become stale after the timeout; ignore
                         }
                     }, 0);
                 },

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 分批解析和设置内容
      * 边解析边插入，实时显示内容

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) {
@@ -476,7 +480,7 @@ export var EditorStoreContext = createContext(null);
                     var nodeList = parserMdToSchema(md, plugins).schema;
                     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);
@@ -494,7 +498,7 @@ export var EditorStoreContext = createContext(null);
                     if (allNodes.length > 0) {
                         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 +551,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: /**
@@ -634,7 +659,7 @@ export var EditorStoreContext = createContext(null);
                                 rafId = requestAnimationFrame(parseAndInsertNextBatch);
                             } else {
                                 // 所有内容处理完成
-                                ReactEditor.deselect(_this._editor.current);
+                                _this._safeDeselect();
                                 rafId = null;
                                 _this._currentAbortController = null;
                                 resolve();

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;