one-design-next 0.0.14 → 0.0.16

package/dist/_genui-types.d.ts

@@ -54,24 +54,58 @@ export interface PreviewTab {
     content: string;
     type: string;
 }
-/** Composer 正文内 `/` 触发的内联引用（Invocation 组件数据契约）。 */
+/**
+ * 内联引用三态：
+ * - complete：默认稳态（无参数 / 参数已填）
+ * - pending：邀请补充参数（业务自定，不强制）
+ * - active：参数面板打开（最高优先级，由组件内部根据 `active` prop 控制）
+ */
+export type InlineRefState = 'pending' | 'complete';
+/**
+ * Composer 正文内 `/` 触发的内联引用（Invocation 组件数据契约）。
+ *
+ * 库只关心 UI 渲染必需字段；业务字段（refId、参数、上下文等）放 `payload`，
+ * 库**不约定其内部结构**，发送时原样透传。
+ */
 export interface InvocationData {
+    /** chip 实例唯一 id（库内部 DOM 锚定、segments 去重用） */
     id: string;
-    /** 业务类型：skill / command / 自定义 */
+    /** 业务子类型（'skill' / 'command' / 自定义）；当前仅 'skill' 使用，预留扩展 */
     kind: string;
-    refId: string;
+    /** 显示文字 */
     label: string;
+    /** 图标 name（可选） */
     icon?: string;
-    params?: Record<string, unknown>;
+    /** 视觉态。`active`（参数面板打开）由组件 prop 控制，不进 data。 */
+    state?: InlineRefState;
+    /** 业务自定义任意字段：refId / 参数 / 上下文等，库不消费 */
+    payload?: Record<string, unknown>;
 }
-/** Composer 正文内 `@` 触发的内联引用（Mention 组件数据契约）。 */
+/** Composer 正文内 `@` 触发的内联引用（Mention 组件数据契约）。结构同 Invocation。 */
 export interface MentionData {
     id: string;
     kind: string;
-    refId: string;
     label: string;
     icon?: string;
-    params?: Record<string, unknown>;
+    state?: InlineRefState;
+    payload?: Record<string, unknown>;
+}
+/**
+ * Composer 编辑器内 chip 实例数据（DOM host + Portal 渲染用）。
+ * 发送时经 `rawValueToSegments` 转为 `ComposerSegment` 的 invocation / mention。
+ */
+export interface ChipData {
+    /** chip 实例唯一 id（与 value marker 中的 id 对应） */
+    id: string;
+    label: string;
+    icon?: string;
+    /**
+     * 'invocation' = `/` 或 Skill 按钮；'mention' = `@`（预留）。
+     * 其他值归 invocation。
+     */
+    kind?: 'invocation' | 'mention' | (string & {});
+    state?: InlineRefState;
+    payload?: Record<string, unknown>;
 }
 export interface SkillItem {
     id: string;
@@ -79,32 +113,38 @@ export interface SkillItem {
     icon: string;
     description?: string;
     /**
-     * 禁用态。设为 true 时按钮不可点击、不会触发 onSelect，视觉降级。
-     * 用于"该 Skill 处于灰度未开放 / 当前会话不支持"等场景，
-     * 既保留入口可见性，又避免误触；与 active 互斥（active 不会同时禁用）。
+     * 插入后的默认视觉态。`'pending'` 时若 Composer 提供 `renderParamPanel`，
+     * 插入后会自动打开参数面板。
+     */
+    initialState?: InlineRefState;
+    /**
+     * 禁用态。true 时按钮不可点击、不会触发 onSelect、视觉降级。
+     * 典型场景：技能灰度未开放 / 当前会话不支持。
      */
     disabled?: boolean;
 }
+/**
+ * Composer 发送时的有序内容 IR（与编辑器内出现顺序一致）。
+ *
+ * 这是 `onSend` 的**主出口**：业务按此数组顺序自定义拼后端（可选用
+ * `segmentsToReadableText` 工具函数兜底拼成一句话）。
+ */
+export type ComposerSegment = {
+    type: 'text';
+    data: {
+        text: string;
+    };
+} | {
+    type: 'invocation';
+    data: InvocationData;
+} | {
+    type: 'mention';
+    data: MentionData;
+};
+/** `onSend(segments, meta?)` 第二参数：非正文的附加数据。 */
 export interface SendMeta {
     attachments?: Attachment[];
     webSearch?: boolean;
-    /** `/` 内联引用列表（Invocation），按编辑器内出现顺序。 */
-    invocations?: InvocationData[];
-    /** `@` 内联引用列表（Mention），按编辑器内出现顺序。 */
-    mentions?: MentionData[];
-    /**
-     * @deprecated 请改用 `invocations` / `mentions`。本字段仍双写一版，便于旧业务迁移。
-     * 编辑器内 chip 列表（按出现顺序）；`kind: 'skill'` 对应 invocation。
-     */
-    chips?: ComposerChipMeta[];
-}
-/** SendMeta.chips 的元素结构；与 components/composer/chip.tsx ChipData 对齐。 */
-export interface ComposerChipMeta {
-    id: string;
-    skillId: string;
-    label: string;
-    icon: string;
-    kind?: 'skill' | 'invocation' | 'mention' | (string & {});
 }
 export type AgentEvent = {
     kind: 'thinking';
@@ -140,6 +180,11 @@ export interface ChatMessage {
     id: string;
     role: 'user' | 'assistant' | 'system';
     content: string;
+    /**
+     * 有序内容 IR（与 Composer `onSend` 的 segments 同构）。
+     * UserBubble 优先用此字段渲染正文；`content` 仍可保留给 LLM / 日志（如 readableText）。
+     */
+    segments?: ComposerSegment[];
     timestamp: number;
     isStreaming?: boolean;
     toolCalls?: ToolCall[];

package/dist/action-bar/style/index.css

@@ -43,7 +43,7 @@
 }
 [data-odn-action-bar-toolbar-btn] [data-odn-button]:focus-visible {
   outline: none;
-  box-shadow: 0 0 0 2px var(--odn-color-cyan-5);
+  box-shadow: 0 0 0 2px var(--odn-color-brand-6);
 }
 
 [data-odn-action-bar-toolbar-btn] [data-odn-action-bar-feedback=positive][aria-pressed=true] {
@@ -85,7 +85,7 @@
 }
 [data-odn-action-bar-pager-btn]:focus-visible {
   outline: none;
-  box-shadow: 0 0 0 2px var(--odn-color-cyan-5);
+  box-shadow: 0 0 0 2px var(--odn-color-brand-6);
 }
 
 [data-odn-action-bar-pager-text] {

package/dist/agent-step/style/index.css

@@ -33,7 +33,7 @@
 }
 [data-odn-agent-step-group-trigger]:focus-visible, [data-odn-agent-step-trigger]:focus-visible {
   outline: none;
-  box-shadow: 0 0 0 2px var(--odn-color-cyan-5);
+  box-shadow: 0 0 0 2px var(--odn-color-brand-6);
 }
 
 [data-odn-agent-step] {

package/dist/attachments/style/index.css

@@ -244,7 +244,7 @@
   padding: 20px 20px 20px 24px;
   border-radius: var(--odn-attachments-report-border-radius);
   border: none;
-  background: radial-gradient(ellipse 60% 50% at 0% 0%, color-mix(in srgb, var(--odn-color-cyan-5) 4%, transparent) 0%, transparent 60%), var(--odn-color-bg-elevated);
+  background: radial-gradient(ellipse 60% 50% at 0% 0%, color-mix(in srgb, var(--odn-color-brand-6) 4%, transparent) 0%, transparent 60%), var(--odn-color-bg-elevated);
   box-sizing: border-box;
   font: inherit;
   color: inherit;
@@ -285,8 +285,8 @@
   width: var(--odn-attachments-report-icon-size);
   height: var(--odn-attachments-report-icon-size);
   border-radius: 10px;
-  background: var(--odn-color-cyan-1);
-  color: var(--odn-color-cyan-5);
+  background: var(--odn-color-brand-1);
+  color: var(--odn-color-brand-6);
   flex-shrink: 0;
 }
 
@@ -294,7 +294,7 @@
   position: absolute;
   top: 8px;
   right: 8px;
-  color: var(--odn-color-cyan-5);
+  color: var(--odn-color-brand-6);
 }
 
 [data-odn-attachments-report-body] {
@@ -342,7 +342,7 @@
 [data-odn-attachments-report-thumb-placeholder] {
   position: absolute;
   inset: 0;
-  background: linear-gradient(180deg, var(--odn-color-bg-elevated) 0%, var(--odn-color-cyan-1) 100%);
+  background: linear-gradient(180deg, var(--odn-color-bg-elevated) 0%, var(--odn-color-brand-1) 100%);
 }
 [data-odn-attachments-report-thumb-placeholder]::before, [data-odn-attachments-report-thumb-placeholder]::after {
   content: "";

package/dist/chat-item/style/index.css

@@ -56,7 +56,7 @@
   box-shadow: none;
 }
 [data-odn-chat-item-rename-input]::selection {
-  background: var(--odn-color-cyan-3, rgba(0, 160, 200, 0.25));
+  background: var(--odn-color-brand-3, rgba(0, 160, 200, 0.25));
 }
 
 [data-odn-chat-item-btn] {
@@ -125,7 +125,7 @@
   width: 6px;
   height: 6px;
   border-radius: 50%;
-  background: var(--odn-color-cyan-5);
+  background: var(--odn-color-brand-6);
   flex-shrink: 0;
 }
 

package/dist/composer/clipboard.d.ts

@@ -1,4 +1,4 @@
-import type { ChipData } from './chip';
+import type { ChipData } from '../_genui-types';
 import type { ManagedChip } from './hooks/useChipManager';
 export declare const COMPOSER_CLIPBOARD_MIME = "application/x-odn-composer-chips";
 export interface ComposerClipboardPayload {

package/dist/composer/editor.d.ts

@@ -13,11 +13,11 @@
  *
  * chip 模型（hybrid）：
  *   - DOM 由 contenteditable 自治：每个 chip 是 contentEditable=false 的 span（host），带 data-mention-id
- *   - 视觉由 React Portal 注入到 host 内：chip.tsx 负责
+ *   - 视觉由 React Portal 注入到 host 内：ComposerInlineRef 负责
  *   - chip 状态（id ↔ host）由 useChipManager 维护
  */
 /// <reference types="react" />
-import type { ChipData } from './chip';
+import type { ChipData } from '../_genui-types';
 /** Composer editor 触发态对外信号——告诉父组件该弹浮层选 skill 了。 */
 export interface ComposerEditorTriggerInfo {
     /** 触发字符（@ 或 /） */
@@ -88,6 +88,10 @@ export interface ComposerEditorProps {
     onPasteFiles?: (files: File[]) => void;
     /** 复制 / 剪切时回调（选区含 chip 时触发）。 */
     onCopyChips?: (chips: ChipData[]) => void;
+    /** 当前打开参数面板的 chip id（驱动 Invocation active 态）。 */
+    paramEditChipId?: string | null;
+    /** 内联引用（/ skill）被点击；由 Composer 决定是否打开参数面板。 */
+    onInlineRefClick?: (chipId: string, anchor: HTMLElement) => void;
     /**
      * 禁用：contenteditable 关闭，editor 不接受输入 / 聚焦 / 粘贴。
      * 已有的文本与 chip 仍渲染（仅冻结，不清空），便于"等接通后继续编辑"。
@@ -121,6 +125,10 @@ export interface ComposerEditorRef {
      * 父组件 onSend 时用，避免自行 parse value marker。
      */
     getChips: () => ChipData[];
+    /** 更新 chip 数据（参数面板保存）。 */
+    updateChipData: (id: string, patch: Partial<ChipData>) => void;
+    /** 取 chip host 元素（参数面板 anchor）。 */
+    getChipHost: (id: string) => HTMLSpanElement | null;
     /** 底层 contenteditable 元素 */
     nativeElement: HTMLDivElement | null;
 }

package/dist/composer/editor.js

@@ -25,7 +25,7 @@ function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
  *
  * chip 模型（hybrid）：
  *   - DOM 由 contenteditable 自治：每个 chip 是 contentEditable=false 的 span（host），带 data-mention-id
- *   - 视觉由 React Portal 注入到 host 内：chip.tsx 负责
+ *   - 视觉由 React Portal 注入到 host 内：ComposerInlineRef 负责
  *   - chip 状态（id ↔ host）由 useChipManager 维护
  */
 
@@ -34,7 +34,7 @@ import { createPortal } from 'react-dom';
 import { buildClipboardPayload, COMPOSER_CLIPBOARD_MIME, parseClipboardPayload, plainTextFromClipboardPayload, remapClipboardPayload } from "./clipboard";
 import { useChipManager } from "./hooks/useChipManager";
 import { useChipSelectionMarker } from "./hooks/useChipSelectionMarker";
-import { findChipHostAfterCaret, findChipHostBeforeCaret, getPlainText, getVisibleTextBeforeHost, isEditorEmpty, moveCaretBeforeChip, normalizeEditorDom, probeTrigger, resolveCaretJumpAroundChip, stripInvisibleChars, ZWSP } from "./utils";
+import { ensureTextAnchorAt, findChipHostAfterCaret, findChipHostBeforeCaret, getPlainText, getVisibleTextBeforeHost, isEditorEmpty, moveCaretBeforeChip, normalizeComposerEditorDom, normalizeEditorDom, probeTrigger, resolveCaretJumpAroundChip, stripInvisibleChars, CARET_SPACER } from "./utils";
 import { ComposerInlineRef } from "./inline-ref";
 import ScrollArea from "../scroll-area";
 
@@ -102,6 +102,9 @@ export var ComposerEditor = /*#__PURE__*/forwardRef(function ComposerEditor(_ref
     onHeightChange = _ref.onHeightChange,
     onPasteFiles = _ref.onPasteFiles,
     onCopyChips = _ref.onCopyChips,
+    _ref$paramEditChipId = _ref.paramEditChipId,
+    paramEditChipId = _ref$paramEditChipId === void 0 ? null : _ref$paramEditChipId,
+    onInlineRefClick = _ref.onInlineRefClick,
     _ref$disabled = _ref.disabled,
     disabled = _ref$disabled === void 0 ? false : _ref$disabled,
     className = _ref.className,
@@ -122,18 +125,29 @@ export var ComposerEditor = /*#__PURE__*/forwardRef(function ComposerEditor(_ref
 
   /** 当前活动 trigger probe；null 表示无触发态。 */
   var triggerRef = useRef(null);
+  /** 最近一次落在 editor 内的 selection（菜单点击导致 blur 后用于恢复插入点）。 */
+  var lastEditorRangeRef = useRef(null);
+  /** 抑制换行后短窗口内的 selection 二次校正，避免首次 chip 后换行闪烁。 */
+  var suppressSelectionNormalizeCountRef = useRef(0);
+  /** 用户刚执行“主动换行”时，允许 empty 判定在一次变更内保持非空。 */
+  var forceNonEmptyOnceRef = useRef(false);
 
   /** 派生：编辑器是否完全空（无文本 + 无 chip），驱动 placeholder。 */
   var _useState = useState(true),
     _useState2 = _slicedToArray(_useState, 2),
     empty = _useState2[0],
     setEmpty = _useState2[1];
+  /** 输入模态：键盘操作时置为 keyboard，用于抑制“鼠标隐藏但 hover 仍生效”的视觉残留。 */
+  var _useState3 = useState('pointer'),
+    _useState4 = _slicedToArray(_useState3, 2),
+    inputModality = _useState4[0],
+    setInputModality = _useState4[1];
 
   /** ScrollArea root 显式高度。Base UI viewport=100%，root 必须有确定 height。 */
-  var _useState3 = useState(null),
-    _useState4 = _slicedToArray(_useState3, 2),
-    scrollHeight = _useState4[0],
-    setScrollHeight = _useState4[1];
+  var _useState5 = useState(null),
+    _useState6 = _slicedToArray(_useState5, 2),
+    scrollHeight = _useState6[0],
+    setScrollHeight = _useState6[1];
 
   /** onHeightChange 用 ref 稳定，避免 ResizeObserver effect 反复 cleanup/重建。 */
   var onHeightChangeRef = useRef(onHeightChange);
@@ -173,15 +187,27 @@ export var ComposerEditor = /*#__PURE__*/forwardRef(function ComposerEditor(_ref
     });
     (_onHeightChangeRef$cu = onHeightChangeRef.current) === null || _onHeightChangeRef$cu === void 0 || _onHeightChangeRef$cu.call(onHeightChangeRef, natural, overflow);
   }, [minHeightPx, maxHeightPx]);
+  var shouldShowPlaceholder = useCallback(function (el) {
+    if (!isEditorEmpty(el)) return false;
+    // placeholder 仅在“单行且空内容”展示
+    var lineCount = el.querySelectorAll('br').length + 1;
+    return lineCount <= 1;
+  }, []);
   var fireChange = useCallback(function () {
     var el = editorRef.current;
     if (!el) return;
     normalizeEditorDom(el);
-    setEmpty(isEditorEmpty(el));
+    var showPlaceholder = shouldShowPlaceholder(el);
+    if (forceNonEmptyOnceRef.current && showPlaceholder) {
+      setEmpty(false);
+    } else {
+      setEmpty(showPlaceholder);
+    }
+    forceNonEmptyOnceRef.current = false;
     onChange === null || onChange === void 0 || onChange(getPlainText(el));
     // editor.height 锁定时 RO 不触发，主动同步一次，确保升格判定能拿到 scrollHeight
     syncHeight();
-  }, [onChange, syncHeight]);
+  }, [onChange, shouldShowPlaceholder, syncHeight]);
 
   /* ─────────────────────────────────────
    * chip 管理
@@ -195,6 +221,8 @@ export var ComposerEditor = /*#__PURE__*/forwardRef(function ComposerEditor(_ref
     insertSerializedAtRange = _useChipManager.insertSerializedAtRange,
     syncChipsAfterDomMutation = _useChipManager.syncChipsAfterDomMutation,
     removeChip = _useChipManager.removeChip,
+    updateChipData = _useChipManager.updateChipData,
+    getChipHost = _useChipManager.getChipHost,
     resetChips = _useChipManager.resetChips;
   useChipSelectionMarker(editorRef, chips);
 
@@ -254,7 +282,17 @@ export var ComposerEditor = /*#__PURE__*/forwardRef(function ComposerEditor(_ref
       insertChip: function insertChip(data) {
         var el = editorRef.current;
         if (!el) return;
-        _insertChip(data, el);
+        // 优先恢复缓存光标到真实 selection；菜单点击时 selection 已经离开 editor，
+        // 直接走 useChipManager 的 fallback 会落到 editor 末尾，导致“飞到第一/末行”。
+        var cached = lastEditorRangeRef.current;
+        if (cached && cached.startContainer.isConnected && cached.endContainer.isConnected && el.contains(cached.startContainer) && el.contains(cached.endContainer)) {
+          var sel = window.getSelection();
+          if (sel) {
+            sel.removeAllRanges();
+            sel.addRange(cached.cloneRange());
+          }
+        }
+        _insertChip(data, el, cached);
       },
       removeChip: removeChip,
       replaceTriggerWithChip: function replaceTriggerWithChip(data) {
@@ -262,8 +300,8 @@ export var ComposerEditor = /*#__PURE__*/forwardRef(function ComposerEditor(_ref
         if (!el) return;
         var probe = triggerRef.current;
         if (!probe) {
-          // 无活动 trigger，退化为光标处插入
-          _insertChip(data, el);
+          // 无活动 trigger，退化为最近光标处插入
+          _insertChip(data, el, lastEditorRangeRef.current);
           return;
         }
         // 选中 trigger + query 整段，删掉再插 chip
@@ -300,11 +338,13 @@ export var ComposerEditor = /*#__PURE__*/forwardRef(function ComposerEditor(_ref
           return c.data;
         });
       },
+      updateChipData: updateChipData,
+      getChipHost: getChipHost,
       get nativeElement() {
         return editorRef.current;
       }
     };
-  }, [onChange, _insertChip, removeChip, resetChips, onTriggerChange, chips]);
+  }, [onChange, _insertChip, removeChip, resetChips, onTriggerChange, chips, updateChipData, getChipHost]);
 
   /* ─────────────────────────────────────
    * 监听 selection 变化：方向键 / 鼠标点击移位都要重算 trigger
@@ -324,6 +364,28 @@ export var ComposerEditor = /*#__PURE__*/forwardRef(function ComposerEditor(_ref
         }
         return;
       }
+      var range = sel.getRangeAt(0);
+      // 先缓存 editor 内真实光标；即便本次走 suppress 提前 return，也不能丢失插入锚点
+      lastEditorRangeRef.current = range.cloneRange();
+      if (suppressSelectionNormalizeCountRef.current > 0) {
+        suppressSelectionNormalizeCountRef.current -= 1;
+        recomputeTrigger();
+        return;
+      }
+      if (range.collapsed && range.startContainer.nodeType === Node.ELEMENT_NODE) {
+        var hostBefore = findChipHostBeforeCaret(range);
+        var hostAfter = findChipHostAfterCaret(range);
+        if (hostBefore || hostAfter) {
+          var _anchor = ensureTextAnchorAt(range.startContainer, range.startOffset);
+          if (_anchor) {
+            var r = document.createRange();
+            r.setStart(_anchor.node, _anchor.offset);
+            r.collapse(true);
+            sel.removeAllRanges();
+            sel.addRange(r);
+          }
+        }
+      }
       recomputeTrigger();
     };
     document.addEventListener('selectionchange', handler);
@@ -374,7 +436,7 @@ export var ComposerEditor = /*#__PURE__*/forwardRef(function ComposerEditor(_ref
     if (valueProp !== current) {
       el.textContent = valueProp !== null && valueProp !== void 0 ? valueProp : '';
       resetChips();
-      setEmpty(!valueProp);
+      setEmpty(shouldShowPlaceholder(el));
       if (triggerRef.current) {
         triggerRef.current = null;
         onTriggerChange === null || onTriggerChange === void 0 || onTriggerChange(null);
@@ -391,12 +453,15 @@ export var ComposerEditor = /*#__PURE__*/forwardRef(function ComposerEditor(_ref
    * ───────────────────────────────────── */
   var handleInput = useCallback(function () {
     var el = editorRef.current;
-    if (el) {
-      normalizeEditorDom(el);
-      setEmpty(isEditorEmpty(el));
+    if (el && !isComposingRef.current) {
+      normalizeComposerEditorDom(el);
     }
     requestScrollCaretIntoView();
-    if (isComposingRef.current) return;
+    if (isComposingRef.current) {
+      // 合成期只负责隐藏 placeholder，不触发归一化提交链路
+      setEmpty(false);
+      return;
+    }
     fireChange();
     recomputeTrigger();
   }, [fireChange, recomputeTrigger, requestScrollCaretIntoView]);
@@ -407,6 +472,8 @@ export var ComposerEditor = /*#__PURE__*/forwardRef(function ComposerEditor(_ref
   }, []);
   var handleCompositionEnd = useCallback(function () {
     isComposingRef.current = false;
+    var el = editorRef.current;
+    if (el) normalizeComposerEditorDom(el);
     fireChange();
     recomputeTrigger();
     requestScrollCaretIntoView();
@@ -418,18 +485,25 @@ export var ComposerEditor = /*#__PURE__*/forwardRef(function ComposerEditor(_ref
    *   - 默认行为 = 自插 <br>（替代浏览器默认的 <div> 包裹，避免破坏 inline 流）
    * ───────────────────────────────────── */
   var insertLineBreak = useCallback(function () {
-    var _br$parentNode;
+    var _br$parentNode, _tail$textContent;
     var sel = window.getSelection();
     if (!sel || sel.rangeCount === 0) return;
     var range = sel.getRangeAt(0);
     range.deleteContents();
     var br = document.createElement('br');
+    br.setAttribute('data-odn-composer-user-break', 'true');
     range.insertNode(br);
-    // webkit：行尾插 br 时需要 ZWSP 让 caret 落点可见
-    var tail = document.createTextNode(ZWSP);
+    // 用户主动换行后应立即收起 placeholder
+    setEmpty(false);
+    forceNonEmptyOnceRef.current = true;
+    // 本次主动设 range 会触发 selectionchange，短窗口内跳过二次 caret 校正避免闪烁
+    suppressSelectionNormalizeCountRef.current = 2;
+    // webkit：行尾插 br 时需要 spacer 让 caret 落点可见
+    var tail = document.createTextNode(CARET_SPACER);
     (_br$parentNode = br.parentNode) === null || _br$parentNode === void 0 || _br$parentNode.insertBefore(tail, br.nextSibling);
     var newRange = document.createRange();
-    newRange.setStartAfter(tail);
+    // 直接落在 spacer 文本内部，避免 element-boundary caret 在首拍被二次改写
+    newRange.setStart(tail, ((_tail$textContent = tail.textContent) !== null && _tail$textContent !== void 0 ? _tail$textContent : '').length);
     newRange.collapse(true);
     sel.removeAllRanges();
     sel.addRange(newRange);
@@ -437,12 +511,13 @@ export var ComposerEditor = /*#__PURE__*/forwardRef(function ComposerEditor(_ref
     requestScrollCaretIntoView();
   }, [fireChange, requestScrollCaretIntoView]);
   var handleKeyDown = useCallback(function (e) {
+    if (inputModality !== 'keyboard') setInputModality('keyboard');
     if (isComposingRef.current || e.nativeEvent.isComposing || e.keyCode === 229) return;
 
     /* 触发态优先：activeTrigger 时把导航键先吐给父组件（驱动浮层选择）。
      * 父返回 true 表示已处理，editor 直接结束本次 keydown，不再走任何
      * 自身逻辑（避免 Enter 又触发 onPressEnter / 插换行）。 */
-    if (triggerRef.current && onTriggerKeyDown && (e.key === 'ArrowDown' || e.key === 'ArrowUp' || e.key === 'Enter' || e.key === 'Escape' || e.key === 'Tab')) {
+    if (triggerRef.current && onTriggerKeyDown && (e.key === 'ArrowDown' || e.key === 'ArrowUp' || e.key === 'Enter' && !e.shiftKey || e.key === 'Escape' || e.key === 'Tab')) {
       if (onTriggerKeyDown(e) === true) return;
     }
 
@@ -453,16 +528,72 @@ export var ComposerEditor = /*#__PURE__*/forwardRef(function ComposerEditor(_ref
       if (el && sel && sel.rangeCount > 0) {
         var range = sel.getRangeAt(0);
         if (range.collapsed && el.contains(range.startContainer)) {
+          var node = range.startContainer,
+            offset = range.startOffset;
+
+          // 用户换行生成的 "<br> + CARET_SPACER"：一次 Backspace 应合并删除，避免看起来“卡一下”
+          {
+            var spacerText = null;
+            var br = null;
+            if (node.nodeType === Node.TEXT_NODE) {
+              var _t$textContent;
+              var t = node;
+              var s = (_t$textContent = t.textContent) !== null && _t$textContent !== void 0 ? _t$textContent : '';
+              if (s.startsWith(CARET_SPACER) && offset <= 1 && t.previousSibling instanceof HTMLBRElement) {
+                spacerText = t;
+                br = t.previousSibling;
+              }
+            } else if (node.nodeType === Node.ELEMENT_NODE) {
+              var _elNode$childNodes, _elNode$childNodes$of, _textContent, _textContent2;
+              var elNode = node;
+              var prev = (_elNode$childNodes = elNode.childNodes[offset - 1]) !== null && _elNode$childNodes !== void 0 ? _elNode$childNodes : null;
+              var at = (_elNode$childNodes$of = elNode.childNodes[offset]) !== null && _elNode$childNodes$of !== void 0 ? _elNode$childNodes$of : null;
+              if (prev && prev.nodeType === Node.TEXT_NODE && ((_textContent = prev.textContent) !== null && _textContent !== void 0 ? _textContent : '').startsWith(CARET_SPACER) && prev.previousSibling instanceof HTMLBRElement) {
+                spacerText = prev;
+                br = prev.previousSibling;
+              } else if (prev instanceof HTMLBRElement && at && at.nodeType === Node.TEXT_NODE && ((_textContent2 = at.textContent) !== null && _textContent2 !== void 0 ? _textContent2 : '').startsWith(CARET_SPACER)) {
+                spacerText = at;
+                br = prev;
+              }
+            }
+            if (spacerText && br) {
+              e.preventDefault();
+              var parent = br.parentNode;
+              if (parent) {
+                var _spacerText$textConte;
+                var idx = Array.from(parent.childNodes).indexOf(br);
+                var text = (_spacerText$textConte = spacerText.textContent) !== null && _spacerText$textConte !== void 0 ? _spacerText$textConte : '';
+                if (text === CARET_SPACER) {
+                  spacerText.remove();
+                } else {
+                  spacerText.textContent = text.slice(1);
+                }
+                br.remove();
+                var r = document.createRange();
+                if (spacerText.isConnected) {
+                  r.setStart(spacerText, 0);
+                } else {
+                  r.setStart(parent, Math.max(0, idx));
+                }
+                r.collapse(true);
+                sel.removeAllRanges();
+                sel.addRange(r);
+                fireChange();
+                recomputeTrigger();
+              }
+              return;
+            }
+          }
           var hostBefore = findChipHostBeforeCaret(range);
           if (hostBefore !== null && hostBefore !== void 0 && hostBefore.dataset.mentionId) {
             var _node$textContent;
-            var node = range.startContainer,
-              offset = range.startOffset;
-            if (node.nodeType === Node.TEXT_NODE && offset === 0 && node.previousSibling === hostBefore && stripInvisibleChars((_node$textContent = node.textContent) !== null && _node$textContent !== void 0 ? _node$textContent : '') === '') {
+            var _node = range.startContainer,
+              _offset = range.startOffset;
+            if (_node.nodeType === Node.TEXT_NODE && _offset === 0 && _node.previousSibling === hostBefore && stripInvisibleChars((_node$textContent = _node.textContent) !== null && _node$textContent !== void 0 ? _node$textContent : '') === '') {
               e.preventDefault();
               moveCaretBeforeChip(hostBefore, {
                 removeTrailingEmptyText: true,
-                trailingText: node
+                trailingText: _node
               });
               return;
             }
@@ -491,11 +622,11 @@ export var ComposerEditor = /*#__PURE__*/forwardRef(function ComposerEditor(_ref
           var target = resolveCaretJumpAroundChip(_range, e.key === 'ArrowLeft' ? 'left' : 'right');
           if (target) {
             e.preventDefault();
-            var r = document.createRange();
-            r.setStart(target.node, target.offset);
-            r.collapse(true);
+            var _r = document.createRange();
+            _r.setStart(target.node, target.offset);
+            _r.collapse(true);
             _sel.removeAllRanges();
-            _sel.addRange(r);
+            _sel.addRange(_r);
             return;
           }
         }
@@ -503,15 +634,18 @@ export var ComposerEditor = /*#__PURE__*/forwardRef(function ComposerEditor(_ref
     }
     if (e.key === 'Enter') {
       if (onPressEnter) {
-        var _r = onPressEnter(e);
-        if (_r === false) return;
+        var _r2 = onPressEnter(e);
+        if (_r2 === false) return;
       }
       // 外部（如浮层）已经 preventDefault → 不再插换行
       if (e.defaultPrevented) return;
       e.preventDefault();
       insertLineBreak();
     }
-  }, [onPressEnter, insertLineBreak, removeChip, onTriggerKeyDown]);
+  }, [inputModality, onPressEnter, insertLineBreak, removeChip, onTriggerKeyDown, fireChange, recomputeTrigger]);
+  var handlePointerInput = useCallback(function () {
+    if (inputModality !== 'pointer') setInputModality('pointer');
+  }, [inputModality]);
   var writeClipboardPayload = useCallback(function (e, payload) {
     if (!payload) return false;
     e.clipboardData.setData(COMPOSER_CLIPBOARD_MIME, JSON.stringify(payload));
@@ -622,6 +756,7 @@ export var ComposerEditor = /*#__PURE__*/forwardRef(function ComposerEditor(_ref
     "aria-disabled": disabled || undefined,
     "data-odn-composer-editor": true,
     "data-odn-composer-editor-disabled": disabled || undefined,
+    "data-odn-input-modality": inputModality,
     "data-empty": empty || undefined,
     "data-placeholder": placeholder,
     className: className,
@@ -629,12 +764,19 @@ export var ComposerEditor = /*#__PURE__*/forwardRef(function ComposerEditor(_ref
     onCompositionStart: handleCompositionStart,
     onCompositionEnd: handleCompositionEnd,
     onKeyDown: handleKeyDown,
+    onMouseMove: handlePointerInput,
+    onMouseDown: handlePointerInput,
+    onPointerMove: handlePointerInput,
     onCopy: handleCopy,
     onCut: handleCut,
     onPaste: handlePaste
   })), chips.map(function (chip) {
     return /*#__PURE__*/createPortal( /*#__PURE__*/React.createElement(ComposerInlineRef, {
-      data: chip.data
+      data: chip.data,
+      active: paramEditChipId === chip.data.id,
+      onClick: onInlineRefClick ? function (anchor) {
+        return onInlineRefClick(chip.data.id, anchor);
+      } : undefined
     }), chip.host, chip.data.id);
   }));
 });