@ai-group/chat-sdk 3.7.1-alpha5 → 3.7.1-alpha8

package/dist/cjs/components/XAdkProvider/index.js.map

@@ -1,7 +1,7 @@
 {
   "version": 3,
   "sources": ["../../../../src/components/XAdkProvider/index.tsx"],
-  "sourcesContent": ["import React, { forwardRef, useImperativeHandle, useMemo, useState } from \"react\";\nimport { ConfigProvider } from \"antd\";\nimport { XProvider } from \"@ant-design/x\";\nimport { ChatStateContext } from \"./context/ChatStateContext\";\nimport { ChatActionContext } from \"./context/ChatActionContext\";\nimport { SessionContext } from \"./context/SessionContext\";\nimport { ChatSenderStateContext } from \"./context/ChatSenderStateContext\";\nimport useADKChat from \"@/hooks/useADKChat\";\nimport { primaryBlue } from \"@/styles/common\";\nimport { cssVarStyle } from \"@/styles/tokens\";\nimport type {\n  XAdkProviderProps,\n  XAdkProviderHandle,\n  XAdkProviderConfig,\n} from \"@/types/XAdkProvider\";\nimport type { ChatHookResult } from \"@/types/ChatHook\";\nimport {\n  mergeChatStrategies,\n  resolvePresetUploadRequest,\n} from \"@/presets/xgroup\";\n\n/**\n * XAdkProvider Props (扩展版)\n *\n * 支持两种使用方式:\n * 1. 标准协议: 提供 url/token/config,使用内置 useADKChat\n * 2. 自定义协议: 提供 chatData,使用自己的 Hook\n */\nexport interface XAdkProviderPropsExtended extends Omit<\n  XAdkProviderProps,\n  \"url\" | \"token\" | \"config\"\n> {\n  /**\n   * 选项 A: 使用标准协议 (内置 useADKChat)\n   */\n  url?: string;\n  token: string;\n  config?: XAdkProviderConfig;\n\n  /**\n   * 选项 B: 使用自定义 Hook 数据\n   * 如果提供此参数,将忽略 url/token/config\n   *\n   * @example\n   * // GraphQL 协议\n   * const chatData = useMyGraphQLChat({ endpoint: '...' });\n   * <XAdkProvider chatData={chatData}>\n   *   <XAdkProvider.DefaultLayout />\n   * </XAdkProvider>\n   *\n   * @example\n   * // WebSocket 协议\n   * const chatData = useWebSocketChat({ url: 'ws://...' });\n   * <XAdkProvider chatData={chatData}>\n   *   <XAdkProvider.DefaultLayout />\n   * </XAdkProvider>\n   */\n  chatData?: ChatHookResult;\n\n  children: React.ReactNode;\n}\n\n/**\n * XAdkProvider - AI 聊天 SDK 核心 Provider\n *\n * 采用 Compound Components 架构:\n * - 只负责数据和状态管理\n * - 不包含 UI 布局\n * - 通过 Context 向子组件提供数据\n * - 支持完全自定义的组件组合\n * - 支持协议解耦,可使用自定义 Hook\n *\n * @example\n * // 基础用法 - 标准协议\n * <XAdkProvider url=\"...\" token=\"...\" config={...}>\n *   <XAdkProvider.Chatbot />\n * </XAdkProvider>\n *\n * @example\n * // 自定义协议 - GraphQL\n * function App() {\n *   const chatData = useMyGraphQLChat({ endpoint: '...' });\n *   return (\n *     <XAdkProvider chatData={chatData}>\n *       <XAdkProvider.DefaultLayout />\n *     </XAdkProvider>\n *   );\n * }\n *\n * @example\n * // 自定义布局\n * <XAdkProvider url=\"...\" token=\"...\">\n *   <div style={{ display: 'flex' }}>\n *     <XAdkProvider.Sidebar />\n *     <div>\n *       <XAdkProvider.Messages />\n *       <XAdkProvider.Sender />\n *     </div>\n *   </div>\n * </XAdkProvider>\n */\nconst XAdkProviderComponent = forwardRef<\n  XAdkProviderHandle,\n  XAdkProviderPropsExtended\n>(\n  (\n    {\n      url = window.location.origin,\n      token,\n      config,\n      preset,\n      strategies,\n      chatData, // 自定义 Hook 数据\n      providerId = \"defaultId\",\n      onSuccess,\n      onError,\n      onMessage,\n      onStream,\n      children,\n    },\n    ref,\n  ) => {\n    const mergedStrategies = useMemo(\n      () =>\n        mergeChatStrategies(\n          preset ?? config?.preset,\n          {\n            ...config?.strategies,\n            ...strategies,\n          },\n        ),\n      [preset, strategies, config?.preset, config?.strategies],\n    );\n\n    // 内置 Hook 数据 (仅在没有提供 chatData 时调用)\n    const internalData = useADKChat({\n      url,\n      token: token || \"\",\n      config: config || {},\n      strategies: mergedStrategies,\n      onError,\n      onSuccess,\n      onMessage,\n      onStream,\n      // 仅在提供了 url 和 token 时才初始化\n      enabled: !chatData && !!url && !!token,\n    });\n\n    // 使用外部数据或内部数据\n    const data = chatData || internalData;\n\n    // 解构数据\n    const {\n      appInfo,\n      startChat,\n      stopChat,\n      reChat,\n      clearChat,\n      suggestChat,\n      confirmFnCall,\n      deleteSession,\n      updateSession,\n      currentSessionId,\n      sessionPagination,\n      sessionList,\n      messages,\n      loading,\n      prologue,\n      suggestions,\n      initialized,\n      setCurrentSession,\n      setMessages,\n      likeMessage = async () => false,\n      setStateDelta = () => {},\n    } = data;\n\n    const showFeedback = config?.showFeedback ?? true;\n    const onFileClick = config?.onFileClick;\n    const presetUploadRequest = useMemo(\n      () =>\n        resolvePresetUploadRequest(preset ?? config?.preset, {\n          url,\n          token,\n          appNo: config?.appNo,\n        }),\n      [preset, config?.preset, url, token, config?.appNo],\n    );\n    const uploadRequest = config?.uploadRequest ?? presetUploadRequest;\n\n    // 暴露 API 给 ref\n    useImperativeHandle(\n      ref,\n      () => ({\n        startChat,\n        stopChat,\n        reChat,\n        clearChat,\n        suggestChat,\n        deleteSession,\n        updateSession,\n        getAppInfo: () => appInfo,\n        getMessages: () => messages,\n        getSessions: () => sessionList,\n        setMessages,\n        setCurrentSession,\n        setStateDelta,\n      }),\n      [\n        appInfo,\n        messages,\n        sessionList,\n        startChat,\n        stopChat,\n        reChat,\n        clearChat,\n        suggestChat,\n        deleteSession,\n        updateSession,\n        setMessages,\n        setCurrentSession,\n        setStateDelta,\n      ],\n    );\n\n    // 状态 Context Value - 使用 useMemo 避免不必要的 rerender\n    const chatStateValue = useMemo(\n      () => ({\n        messages,\n        loading,\n        currentSessionId,\n        prologue,\n        suggestions,\n        appInfo,\n        initialized,\n        url,\n        token,\n        showFeedback,\n        onFileClick,\n        uploadRequest,\n        strategies: mergedStrategies,\n      }),\n      [\n        messages,\n        loading,\n        currentSessionId,\n        prologue,\n        suggestions,\n        appInfo,\n        initialized,\n        url,\n        token,\n        showFeedback,\n        onFileClick,\n        uploadRequest,\n        mergedStrategies,\n      ],\n    );\n\n    // 动作 Context Value - 函数引用稳定,不需要每次都创建新对象\n    const chatActionValue = useMemo(\n      () => ({\n        chat: startChat,\n        stopChat,\n        clearChat,\n        reChat,\n        suggestChat,\n        confirmFnCall,\n        setMessages,\n        likeMessage,\n        setStateDelta,\n      }),\n      [\n        startChat,\n        stopChat,\n        clearChat,\n        reChat,\n        suggestChat,\n        confirmFnCall,\n        setMessages,\n        likeMessage,\n        setStateDelta,\n      ],\n    );\n\n    // 会话 Context Value\n    const sessionValue = useMemo(\n      () => ({\n        sessionList,\n        sessionPagination,\n        deleteSession,\n        updateSession,\n        setCurrentSession,\n      }),\n      [\n        sessionList,\n        sessionPagination,\n        deleteSession,\n        updateSession,\n        setCurrentSession,\n      ],\n    );\n\n    // Sender 输入框受控状态\n    const [senderValue, setSenderValue] = useState(\"\");\n\n    // Sender 专用状态 — 不包含 messages，避免轮询更新消息时导致 Sender 重渲染和焦点丢失\n    const senderStateValue = useMemo(\n      () => ({\n        loading,\n        uploadRequest,\n        senderValue,\n        setSenderValue,\n      }),\n      [loading, uploadRequest, senderValue],\n    );\n\n    return (\n      <ConfigProvider\n        theme={{\n          token: {\n            colorPrimary: appInfo?.appTheme || primaryBlue,\n          },\n        }}\n      >\n        <XProvider>\n          <ChatStateContext.Provider value={chatStateValue}>\n            <ChatActionContext.Provider value={chatActionValue}>\n              <SessionContext.Provider value={sessionValue}>\n                <ChatSenderStateContext.Provider value={senderStateValue}>\n                  <div\n                    style={{\n                      ...cssVarStyle,\n                      display: \"flex\",\n                      height: \"100%\",\n                      width: \"100%\",\n                      position: \"relative\",\n                    } as React.CSSProperties}\n                  >\n                    {children}\n                  </div>\n                </ChatSenderStateContext.Provider>\n              </SessionContext.Provider>\n            </ChatActionContext.Provider>\n          </ChatStateContext.Provider>\n        </XProvider>\n      </ConfigProvider>\n    );\n  },\n);\n\nXAdkProviderComponent.displayName = \"XAdkProvider\";\n\n// 导入 Compound Components\nimport Header from \"./compound/Header\";\nimport Sidebar from \"./compound/Sidebar\";\nimport Messages from \"./compound/Messages\";\nimport Sender from \"./compound/Sender\";\nimport Chatbot from \"./compound/Chatbot\";\nimport Welcome from \"./compound/Welcome\";\nimport DefaultLayout from \"./compound/DefaultLayout\";\n\n// 导出时会挂载 Compound Components\nconst XAdkProvider = XAdkProviderComponent as typeof XAdkProviderComponent & {\n  Header: typeof Header;\n  Sidebar: typeof Sidebar;\n  Messages: typeof Messages;\n  Sender: typeof Sender;\n  Chatbot: typeof Chatbot;\n  Welcome: typeof Welcome;\n  DefaultLayout: typeof DefaultLayout;\n};\n\n// 挂载 Compound Components\nXAdkProvider.Header = Header;\nXAdkProvider.Sidebar = Sidebar;\nXAdkProvider.Messages = Messages;\nXAdkProvider.Sender = Sender;\nXAdkProvider.Chatbot = Chatbot;\nXAdkProvider.DefaultLayout = DefaultLayout;\nXAdkProvider.Welcome = Welcome;\n\nexport default XAdkProvider;\n"],
-  "mappings": "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",
+  "sourcesContent": ["import React, {\n  forwardRef,\n  useImperativeHandle,\n  useMemo,\n  useState,\n} from \"react\";\nimport { ConfigProvider } from \"antd\";\nimport { XProvider } from \"@ant-design/x\";\nimport { ChatStateContext } from \"./context/ChatStateContext\";\nimport { ChatActionContext } from \"./context/ChatActionContext\";\nimport { SessionContext } from \"./context/SessionContext\";\nimport { ChatSenderStateContext } from \"./context/ChatSenderStateContext\";\nimport useADKChat from \"@/hooks/useADKChat\";\nimport { primaryBlue } from \"@/styles/common\";\nimport { cssVarStyle } from \"@/styles/tokens\";\nimport type {\n  XAdkProviderProps,\n  XAdkProviderHandle,\n  XAdkProviderConfig,\n} from \"@/types/XAdkProvider\";\nimport type { ChatHookResult } from \"@/types/ChatHook\";\nimport {\n  mergeChatStrategies,\n  resolvePresetUploadRequest,\n} from \"@/presets/xgroup\";\n\n/**\n * XAdkProvider Props (扩展版)\n *\n * 支持两种使用方式:\n * 1. 标准协议: 提供 url/token/config,使用内置 useADKChat\n * 2. 自定义协议: 提供 chatData,使用自己的 Hook\n */\nexport interface XAdkProviderPropsExtended extends Omit<\n  XAdkProviderProps,\n  \"url\" | \"token\" | \"config\"\n> {\n  /**\n   * 选项 A: 使用标准协议 (内置 useADKChat)\n   */\n  url?: string;\n  token: string;\n  config?: XAdkProviderConfig;\n\n  /**\n   * 选项 B: 使用自定义 Hook 数据\n   * 如果提供此参数,将忽略 url/token/config\n   *\n   * @example\n   * // GraphQL 协议\n   * const chatData = useMyGraphQLChat({ endpoint: '...' });\n   * <XAdkProvider chatData={chatData}>\n   *   <XAdkProvider.DefaultLayout />\n   * </XAdkProvider>\n   *\n   * @example\n   * // WebSocket 协议\n   * const chatData = useWebSocketChat({ url: 'ws://...' });\n   * <XAdkProvider chatData={chatData}>\n   *   <XAdkProvider.DefaultLayout />\n   * </XAdkProvider>\n   */\n  chatData?: ChatHookResult;\n\n  children: React.ReactNode;\n}\n\n/**\n * XAdkProvider - AI 聊天 SDK 核心 Provider\n *\n * 采用 Compound Components 架构:\n * - 只负责数据和状态管理\n * - 不包含 UI 布局\n * - 通过 Context 向子组件提供数据\n * - 支持完全自定义的组件组合\n * - 支持协议解耦,可使用自定义 Hook\n *\n * @example\n * // 基础用法 - 标准协议\n * <XAdkProvider url=\"...\" token=\"...\" config={...}>\n *   <XAdkProvider.Chatbot />\n * </XAdkProvider>\n *\n * @example\n * // 自定义协议 - GraphQL\n * function App() {\n *   const chatData = useMyGraphQLChat({ endpoint: '...' });\n *   return (\n *     <XAdkProvider chatData={chatData}>\n *       <XAdkProvider.DefaultLayout />\n *     </XAdkProvider>\n *   );\n * }\n *\n * @example\n * // 自定义布局\n * <XAdkProvider url=\"...\" token=\"...\">\n *   <div style={{ display: 'flex' }}>\n *     <XAdkProvider.Sidebar />\n *     <div>\n *       <XAdkProvider.Messages />\n *       <XAdkProvider.Sender />\n *     </div>\n *   </div>\n * </XAdkProvider>\n */\nconst XAdkProviderComponent = forwardRef<\n  XAdkProviderHandle,\n  XAdkProviderPropsExtended\n>(\n  (\n    {\n      url = window.location.origin,\n      token,\n      config,\n      preset,\n      strategies,\n      chatData, // 自定义 Hook 数据\n      providerId = \"defaultId\",\n      onSuccess,\n      onError,\n      onMessage,\n      onStream,\n      children,\n    },\n    ref,\n  ) => {\n    const mergedStrategies = useMemo(\n      () =>\n        mergeChatStrategies(preset ?? config?.preset, {\n          ...config?.strategies,\n          ...strategies,\n        }),\n      [preset, strategies, config?.preset, config?.strategies],\n    );\n\n    // 内置 Hook 数据 (仅在没有提供 chatData 时调用)\n    const internalData = useADKChat({\n      url,\n      token: token || \"\",\n      config: config || {},\n      strategies: mergedStrategies,\n      onError,\n      onSuccess,\n      onMessage,\n      onStream,\n      // 仅在提供了 url 和 token 时才初始化\n      enabled: !chatData && !!url && !!token,\n    });\n\n    // 使用外部数据或内部数据\n    const data = chatData || internalData;\n\n    // 解构数据\n    const {\n      appInfo,\n      startChat,\n      stopChat,\n      reChat,\n      clearChat,\n      suggestChat,\n      confirmFnCall,\n      deleteSession,\n      updateSession,\n      currentSessionId,\n      sessionPagination,\n      sessionList,\n      messages,\n      loading,\n      prologue,\n      suggestions,\n      initialized,\n      setCurrentSession,\n      setMessages,\n      likeMessage = async () => false,\n      setStateDelta = () => {},\n    } = data;\n\n    const showFeedback = config?.showFeedback ?? true;\n    const onFileClick = config?.onFileClick;\n    const allowUpload = config?.allowUpload ?? false;\n    const draggable = config?.draggable ?? true;\n    const presetUploadRequest = useMemo(\n      () =>\n        resolvePresetUploadRequest(preset ?? config?.preset, {\n          url,\n          token,\n          appNo: config?.appNo,\n        }),\n      [preset, config?.preset, url, token, config?.appNo],\n    );\n    const uploadRequest = config?.uploadRequest ?? presetUploadRequest;\n\n    // 暴露 API 给 ref\n    useImperativeHandle(\n      ref,\n      () => ({\n        startChat,\n        stopChat,\n        reChat,\n        clearChat,\n        suggestChat,\n        deleteSession,\n        updateSession,\n        getAppInfo: () => appInfo,\n        getMessages: () => messages,\n        getSessions: () => sessionList,\n        setMessages,\n        setCurrentSession,\n        setStateDelta,\n      }),\n      [\n        appInfo,\n        messages,\n        sessionList,\n        startChat,\n        stopChat,\n        reChat,\n        clearChat,\n        suggestChat,\n        deleteSession,\n        updateSession,\n        setMessages,\n        setCurrentSession,\n        setStateDelta,\n      ],\n    );\n\n    // 状态 Context Value - 使用 useMemo 避免不必要的 rerender\n    const chatStateValue = useMemo(\n      () => ({\n        messages,\n        loading,\n        currentSessionId,\n        prologue,\n        suggestions,\n        appInfo,\n        initialized,\n        url,\n        token,\n        showFeedback,\n        onFileClick,\n        uploadRequest,\n        strategies: mergedStrategies,\n      }),\n      [\n        messages,\n        loading,\n        currentSessionId,\n        prologue,\n        suggestions,\n        appInfo,\n        initialized,\n        url,\n        token,\n        showFeedback,\n        onFileClick,\n        uploadRequest,\n        mergedStrategies,\n      ],\n    );\n\n    // 动作 Context Value - 函数引用稳定,不需要每次都创建新对象\n    const chatActionValue = useMemo(\n      () => ({\n        chat: startChat,\n        stopChat,\n        clearChat,\n        reChat,\n        suggestChat,\n        confirmFnCall,\n        setMessages,\n        likeMessage,\n        setStateDelta,\n      }),\n      [\n        startChat,\n        stopChat,\n        clearChat,\n        reChat,\n        suggestChat,\n        confirmFnCall,\n        setMessages,\n        likeMessage,\n        setStateDelta,\n      ],\n    );\n\n    // 会话 Context Value\n    const sessionValue = useMemo(\n      () => ({\n        sessionList,\n        sessionPagination,\n        deleteSession,\n        updateSession,\n        setCurrentSession,\n      }),\n      [\n        sessionList,\n        sessionPagination,\n        deleteSession,\n        updateSession,\n        setCurrentSession,\n      ],\n    );\n\n    // Sender 输入框受控状态\n    const [senderValue, setSenderValue] = useState(\"\");\n\n    // Sender 专用状态 — 不包含 messages，避免轮询更新消息时导致 Sender 重渲染和焦点丢失\n    const senderStateValue = useMemo(\n      () => ({\n        loading,\n        uploadRequest,\n        allowUpload,\n        draggable,\n        senderValue,\n        setSenderValue,\n      }),\n      [loading, uploadRequest, allowUpload, draggable, senderValue],\n    );\n\n    return (\n      <ConfigProvider\n        theme={{\n          token: {\n            colorPrimary: appInfo?.appTheme || primaryBlue,\n          },\n        }}\n      >\n        <XProvider>\n          <ChatStateContext.Provider value={chatStateValue}>\n            <ChatActionContext.Provider value={chatActionValue}>\n              <SessionContext.Provider value={sessionValue}>\n                <ChatSenderStateContext.Provider value={senderStateValue}>\n                  <div\n                    style={\n                      {\n                        ...cssVarStyle,\n                        display: \"flex\",\n                        height: \"100%\",\n                        width: \"100%\",\n                        position: \"relative\",\n                      } as React.CSSProperties\n                    }\n                  >\n                    {children}\n                  </div>\n                </ChatSenderStateContext.Provider>\n              </SessionContext.Provider>\n            </ChatActionContext.Provider>\n          </ChatStateContext.Provider>\n        </XProvider>\n      </ConfigProvider>\n    );\n  },\n);\n\nXAdkProviderComponent.displayName = \"XAdkProvider\";\n\n// 导入 Compound Components\nimport Header from \"./compound/Header\";\nimport Sidebar from \"./compound/Sidebar\";\nimport Messages from \"./compound/Messages\";\nimport Sender from \"./compound/Sender\";\nimport Chatbot from \"./compound/Chatbot\";\nimport Welcome from \"./compound/Welcome\";\nimport DefaultLayout from \"./compound/DefaultLayout\";\n\n// 导出时会挂载 Compound Components\nconst XAdkProvider = XAdkProviderComponent as typeof XAdkProviderComponent & {\n  Header: typeof Header;\n  Sidebar: typeof Sidebar;\n  Messages: typeof Messages;\n  Sender: typeof Sender;\n  Chatbot: typeof Chatbot;\n  Welcome: typeof Welcome;\n  DefaultLayout: typeof DefaultLayout;\n};\n\n// 挂载 Compound Components\nXAdkProvider.Header = Header;\nXAdkProvider.Sidebar = Sidebar;\nXAdkProvider.Messages = Messages;\nXAdkProvider.Sender = Sender;\nXAdkProvider.Chatbot = Chatbot;\nXAdkProvider.DefaultLayout = DefaultLayout;\nXAdkProvider.Welcome = Welcome;\n\nexport default XAdkProvider;\n"],
+  "mappings": "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",
   "names": ["useADKChat", "Header", "Sidebar", "Messages", "Sender", "Chatbot", "DefaultLayout", "Welcome"]
 }

package/dist/cjs/components/XAdkSender/InlineTagInput.js

@@ -25,6 +25,7 @@ module.exports = __toCommonJS(InlineTagInput_exports);
 var import_react = require("react");
 var import_client = require("react-dom/client");
 var import_styles = require("./styles");
+var import_markdownResource = require("../../utils/markdownResource");
 var import_jsx_runtime = require("react/jsx-runtime");
 var MENTION_ATTR = "data-xadk-inline-mention-id";
 var CARET_TEXT = "​";
@@ -63,6 +64,11 @@ var InlineTagInput = (0, import_react.forwardRef)(
     const lastInsertedCaretRef = (0, import_react.useRef)(null);
     const savedRangeRef = (0, import_react.useRef)(null);
     const defaultInputPartsAppliedRef = (0, import_react.useRef)(false);
+    const skipEmptyCleanupOnceRef = (0, import_react.useRef)(false);
+    const structuralCleanupFrameRef = (0, import_react.useRef)(null);
+    const [hasContent, setHasContent] = (0, import_react.useState)(
+      () => Boolean(value || mentions.length)
+    );
     const lastEmittedStateRef = (0, import_react.useRef)({
       value,
       mentionIds: mentions.map((mention) => mention.id).join("|")
@@ -78,7 +84,9 @@ var InlineTagInput = (0, import_react.forwardRef)(
         latestMentionsRef.current.map((mention) => [mention.id, mention])
       );
       return Array.from(editor.querySelectorAll(`[${MENTION_ATTR}]`)).map(
-        (node) => mentionMap.get(node.dataset.xadkInlineMentionId || "")
+        (node) => mentionMap.get(
+          node.dataset.xadkInlineMentionId || ""
+        )
       ).filter(Boolean);
     }, []);
     const getPlainText = (0, import_react.useCallback)(() => {
@@ -120,6 +128,7 @@ var InlineTagInput = (0, import_react.forwardRef)(
     const emitChange = (0, import_react.useCallback)(() => {
       const nextValue = getPlainText();
       const nextMentions = getOrderedMentions();
+      setHasContent(Boolean(nextValue || nextMentions.length));
       lastEmittedStateRef.current = {
         value: nextValue,
         mentionIds: nextMentions.map((mention) => mention.id).join("|")
@@ -127,12 +136,15 @@ var InlineTagInput = (0, import_react.forwardRef)(
       onChange(nextValue);
       onMentionsChange(nextMentions);
     }, [getOrderedMentions, getPlainText, onChange, onMentionsChange]);
-    const removeTextRange = (0, import_react.useCallback)((node, start, end) => {
-      const text = node.textContent || "";
-      node.textContent = `${text.slice(0, start)}${text.slice(end)}`;
-      if (!node.textContent)
-        node.remove();
-    }, []);
+    const removeTextRange = (0, import_react.useCallback)(
+      (node, start, end) => {
+        const text = node.textContent || "";
+        node.textContent = `${text.slice(0, start)}${text.slice(end)}`;
+        if (!node.textContent)
+          node.remove();
+      },
+      []
+    );
     const removeMentionNode = (0, import_react.useCallback)(
       (node) => {
         var _a, _b, _c;
@@ -152,7 +164,11 @@ var InlineTagInput = (0, import_react.forwardRef)(
           const text = previous.textContent || "";
           const spaceLength = ((_c = text.match(/\s+$/)) == null ? void 0 : _c[0].length) || 0;
           if (spaceLength > 0) {
-            removeTextRange(previous, text.length - spaceLength, text.length);
+            removeTextRange(
+              previous,
+              text.length - spaceLength,
+              text.length
+            );
           }
         }
       },
@@ -180,6 +196,7 @@ var InlineTagInput = (0, import_react.forwardRef)(
         span.setAttribute("contenteditable", "false");
         span.setAttribute(MENTION_ATTR, mention.id);
         span.dataset.xadkInlineMentionId = mention.id;
+        span.dataset.xadkInlineMentionType = mention.type;
         span.className = styles.inlineTag;
         if (renderMention) {
           const root = (0, import_client.createRoot)(span);
@@ -300,6 +317,37 @@ var InlineTagInput = (0, import_react.forwardRef)(
       }
       return null;
     };
+    const moveCursorAroundMention = (0, import_react.useCallback)(
+      (mention, direction) => {
+        var _a, _b;
+        const editor = editorRef.current;
+        const selection = window.getSelection();
+        if (!editor || !selection || !editor.contains(mention))
+          return;
+        const range = document.createRange();
+        if (direction === "before") {
+          const previous = mention.previousSibling;
+          if ((previous == null ? void 0 : previous.nodeType) === Node.TEXT_NODE) {
+            range.setStart(previous, ((_a = previous.textContent) == null ? void 0 : _a.length) || 0);
+          } else {
+            range.setStartBefore(mention);
+          }
+        } else {
+          const next = mention.nextSibling;
+          if ((next == null ? void 0 : next.nodeType) === Node.TEXT_NODE) {
+            const leadingCaretLength = ((_b = (next.textContent || "").match(/^\u200B+/)) == null ? void 0 : _b[0].length) || 0;
+            range.setStart(next, leadingCaretLength);
+          } else {
+            range.setStartAfter(mention);
+          }
+        }
+        range.collapse(true);
+        selection.removeAllRanges();
+        selection.addRange(range);
+        savedRangeRef.current = range.cloneRange();
+      },
+      []
+    );
     const getOffsetInEditor = (0, import_react.useCallback)(() => {
       const editor = editorRef.current;
       const selection = window.getSelection();
@@ -395,11 +443,67 @@ var InlineTagInput = (0, import_react.forwardRef)(
         }
       });
     }, []);
+    const cleanupEmptyStructuralNodes = (0, import_react.useCallback)(() => {
+      const editor = editorRef.current;
+      const selection = window.getSelection();
+      if (!editor)
+        return;
+      Array.from(editor.children).forEach((node) => {
+        if (node.hasAttribute(MENTION_ATTR))
+          return;
+        if (node.querySelector(`[${MENTION_ATTR}]`))
+          return;
+        if (normalizeText(node.textContent || ""))
+          return;
+        const range = (selection == null ? void 0 : selection.rangeCount) ? selection.getRangeAt(0) : null;
+        const nodeIndex = getNodeIndex(node);
+        const containsCursor = Boolean(
+          range && range.collapsed && (range.startContainer === node || node.contains(range.startContainer) || range.startContainer === editor && (range.startOffset === nodeIndex || range.startOffset === nodeIndex + 1))
+        );
+        if (containsCursor && selection) {
+          const caretNode = createTextNode(CARET_TEXT);
+          node.replaceWith(caretNode);
+          const nextRange = document.createRange();
+          nextRange.setStart(caretNode, CARET_TEXT.length);
+          nextRange.collapse(true);
+          selection.removeAllRanges();
+          selection.addRange(nextRange);
+          savedRangeRef.current = nextRange.cloneRange();
+          return;
+        }
+        node.remove();
+      });
+    }, []);
+    (0, import_react.useEffect)(() => {
+      const editor = editorRef.current;
+      if (!editor)
+        return;
+      const handleNativeDelete = (event) => {
+        if (!(event instanceof InputEvent))
+          return;
+        if (!event.inputType.startsWith("delete"))
+          return;
+        if (structuralCleanupFrameRef.current !== null) {
+          window.cancelAnimationFrame(structuralCleanupFrameRef.current);
+        }
+        structuralCleanupFrameRef.current = window.requestAnimationFrame(() => {
+          structuralCleanupFrameRef.current = null;
+          cleanupEmptyStructuralNodes();
+          cleanupCaretTextNodes();
+        });
+      };
+      editor.addEventListener("input", handleNativeDelete);
+      return () => editor.removeEventListener("input", handleNativeDelete);
+    }, [cleanupCaretTextNodes, cleanupEmptyStructuralNodes]);
     const insertMention = (0, import_react.useCallback)(
       (mention, replace) => {
         const editor = editorRef.current;
         if (!editor)
           return;
+        const selectionBeforeFocus = window.getSelection();
+        const activeRangeBeforeFocus = (selectionBeforeFocus == null ? void 0 : selectionBeforeFocus.rangeCount) && editor.contains(selectionBeforeFocus.getRangeAt(0).startContainer) ? selectionBeforeFocus.getRangeAt(0).cloneRange() : null;
+        const savedRangeBeforeFocus = savedRangeRef.current && editor.contains(savedRangeRef.current.startContainer) ? savedRangeRef.current.cloneRange() : null;
+        const rangeBeforeFocus = activeRangeBeforeFocus || savedRangeBeforeFocus;
         editor.focus();
         latestMentionsRef.current = [
           ...latestMentionsRef.current.filter((item) => item.id !== mention.id),
@@ -410,11 +514,15 @@ var InlineTagInput = (0, import_react.forwardRef)(
           insertRange = replaceTextRange(replace.start, replace.end);
           cleanupCaretTextNodes();
         }
+        const isSemanticallyEmpty = !getPlainText() && !editor.querySelector(`[${MENTION_ATTR}]`);
+        if (isSemanticallyEmpty) {
+          editor.innerHTML = "";
+          savedRangeRef.current = null;
+          insertRange = null;
+        }
         const mentionNode = buildMentionNode(mention);
         const caretNode = createTextNode(CARET_TEXT);
-        const selection = window.getSelection();
-        const savedRange = savedRangeRef.current;
-        const range = insertRange || ((selection == null ? void 0 : selection.rangeCount) && editor.contains(selection.getRangeAt(0).startContainer) ? selection.getRangeAt(0) : savedRange && editor.contains(savedRange.startContainer) ? savedRange : null);
+        const range = insertRange || rangeBeforeFocus;
         if (range && editor.contains(range.startContainer)) {
           const fragment = document.createDocumentFragment();
           fragment.append(mentionNode, caretNode);
@@ -436,6 +544,7 @@ var InlineTagInput = (0, import_react.forwardRef)(
         buildMentionNode,
         cleanupCaretTextNodes,
         emitChange,
+        getPlainText,
         replaceTextRange,
         restoreCursorAfterInsert,
         setCursorAtTextEnd
@@ -447,23 +556,36 @@ var InlineTagInput = (0, import_react.forwardRef)(
         document.removeEventListener("selectionchange", saveSelectionRange);
       };
     }, [saveSelectionRange]);
-    (0, import_react.useImperativeHandle)(ref, () => ({
-      focus: () => {
-        var _a;
-        return (_a = editorRef.current) == null ? void 0 : _a.focus();
+    (0, import_react.useEffect)(
+      () => () => {
+        if (structuralCleanupFrameRef.current !== null) {
+          window.cancelAnimationFrame(structuralCleanupFrameRef.current);
+        }
       },
-      getText: getPlainText,
-      getParts,
-      getCursorOffset: getOffsetInEditor,
-      insertMention,
-      insertTag: insertMention
-    }), [getOffsetInEditor, getParts, getPlainText, insertMention]);
+      []
+    );
+    (0, import_react.useImperativeHandle)(
+      ref,
+      () => ({
+        focus: () => {
+          var _a;
+          return (_a = editorRef.current) == null ? void 0 : _a.focus();
+        },
+        getText: getPlainText,
+        getParts,
+        getCursorOffset: getOffsetInEditor,
+        insertMention,
+        insertTag: insertMention
+      }),
+      [getOffsetInEditor, getParts, getPlainText, insertMention]
+    );
     useIsomorphicLayoutEffect(() => {
       const editor = editorRef.current;
       if (!editor)
         return;
       if (!defaultInputPartsAppliedRef.current && (defaultInputParts == null ? void 0 : defaultInputParts.length) && !value && mentions.length === 0) {
         defaultInputPartsAppliedRef.current = true;
+        skipEmptyCleanupOnceRef.current = true;
         renderPartsToEditor(defaultInputParts);
         emitChange();
         return;
@@ -477,6 +599,7 @@ var InlineTagInput = (0, import_react.forwardRef)(
         ...value ? [{ type: "text", text: value }] : [],
         ...mentions.map((mention) => ({ type: "mention", mention }))
       ]);
+      setHasContent(Boolean(value || mentions.length));
       const lastTextNode = Array.from(editor.childNodes).reverse().find((node) => node.nodeType === Node.TEXT_NODE);
       if (document.activeElement === editor && lastTextNode) {
         setCursorAtTextEnd(lastTextNode);
@@ -493,6 +616,10 @@ var InlineTagInput = (0, import_react.forwardRef)(
       const editor = editorRef.current;
       if (!editor)
         return;
+      if (skipEmptyCleanupOnceRef.current) {
+        skipEmptyCleanupOnceRef.current = false;
+        return;
+      }
       if (!value && mentions.length === 0 && editor.childNodes.length > 0) {
         editor.querySelectorAll(`[${MENTION_ATTR}]`).forEach((node) => {
           var _a;
@@ -502,10 +629,76 @@ var InlineTagInput = (0, import_react.forwardRef)(
       }
     }, [mentions.length, value]);
     const handleInput = () => {
-      if (!composingRef.current)
+      if (!composingRef.current) {
+        cleanupEmptyStructuralNodes();
+        cleanupCaretTextNodes();
         emitChange();
+        if (structuralCleanupFrameRef.current !== null) {
+          window.cancelAnimationFrame(structuralCleanupFrameRef.current);
+        }
+        structuralCleanupFrameRef.current = window.requestAnimationFrame(() => {
+          structuralCleanupFrameRef.current = null;
+          cleanupEmptyStructuralNodes();
+          cleanupCaretTextNodes();
+        });
+      }
+    };
+    const handlePaste = (event) => {
+      event.preventDefault();
+      const editor = editorRef.current;
+      if (!editor)
+        return;
+      const text = event.clipboardData.getData("text/plain");
+      if (!text)
+        return;
+      const parts = (0, import_markdownResource.parseMarkdownResourceLinksAsParts)(text);
+      const selection = window.getSelection();
+      const range = (selection == null ? void 0 : selection.rangeCount) && editor.contains(selection.getRangeAt(0).startContainer) ? selection.getRangeAt(0) : null;
+      const fragment = document.createDocumentFragment();
+      let lastTextNode = null;
+      for (const part of parts) {
+        if (part.type === "text") {
+          lastTextNode = createTextNode(part.text);
+          fragment.append(lastTextNode);
+          continue;
+        }
+        latestMentionsRef.current = [
+          ...latestMentionsRef.current,
+          part.mention
+        ];
+        fragment.append(buildMentionNode(part.mention));
+        lastTextNode = createTextNode(CARET_TEXT);
+        fragment.append(lastTextNode);
+      }
+      if (range) {
+        range.deleteContents();
+        range.insertNode(fragment);
+      } else {
+        editor.append(fragment);
+      }
+      cleanupCaretTextNodes();
+      if (lastTextNode)
+        setCursorAtTextEnd(lastTextNode);
+      emitChange();
     };
     const handleKeyDown = (event) => {
+      if (event.key === "ArrowLeft" || event.key === "ArrowRight") {
+        const selection = window.getSelection();
+        if (selection == null ? void 0 : selection.rangeCount) {
+          const range = selection.getRangeAt(0);
+          if (range.collapsed) {
+            const targetMention = event.key === "ArrowLeft" ? getMentionBeforeRange(range) : getMentionAfterRange(range);
+            if (targetMention) {
+              event.preventDefault();
+              moveCursorAroundMention(
+                targetMention,
+                event.key === "ArrowLeft" ? "before" : "after"
+              );
+              return;
+            }
+          }
+        }
+      }
       if (event.key === "Backspace" || event.key === "Delete") {
         const selection = window.getSelection();
         if (selection == null ? void 0 : selection.rangeCount) {
@@ -514,7 +707,9 @@ var InlineTagInput = (0, import_react.forwardRef)(
             const targetMention = event.key === "Backspace" ? getMentionBeforeRange(range) : getMentionAfterRange(range);
             if (targetMention) {
               event.preventDefault();
-              removeMentionById(targetMention.dataset.xadkInlineMentionId || "");
+              removeMentionById(
+                targetMention.dataset.xadkInlineMentionId || ""
+              );
               return;
             }
           }
@@ -522,7 +717,7 @@ var InlineTagInput = (0, import_react.forwardRef)(
       }
       onKeyDown == null ? void 0 : onKeyDown(event);
     };
-    const showPlaceholder = !value && mentions.length === 0;
+    const showPlaceholder = !hasContent;
     return /* @__PURE__ */ (0, import_jsx_runtime.jsxs)("div", { className: styles.inlineInputWrapper, children: [
       showPlaceholder && placeholder && /* @__PURE__ */ (0, import_jsx_runtime.jsx)("div", { className: styles.inlinePlaceholder, children: placeholder }),
       /* @__PURE__ */ (0, import_jsx_runtime.jsx)(
@@ -535,8 +730,11 @@ var InlineTagInput = (0, import_react.forwardRef)(
           role: "textbox",
           "aria-multiline": "true",
           onInput: handleInput,
+          onPaste: handlePaste,
           onKeyDown: handleKeyDown,
           onKeyUp: (event) => {
+            cleanupEmptyStructuralNodes();
+            cleanupCaretTextNodes();
             saveSelectionRange();
             onKeyUp == null ? void 0 : onKeyUp(event);
           },
@@ -544,6 +742,7 @@ var InlineTagInput = (0, import_react.forwardRef)(
           onFocus: saveSelectionRange,
           onCompositionStart: () => {
             composingRef.current = true;
+            setHasContent(true);
           },
           onCompositionEnd: () => {
             composingRef.current = false;