one-design-next 0.0.13 → 0.0.15

package/dist/composer/style/index.css

@@ -27,11 +27,11 @@
   transition: border-color 0.15s;
 }
 [data-odn-composer-box]:focus-within {
-  border-color: color-mix(in srgb, var(--odn-color-cyan-5) 50%, transparent);
+  border-color: color-mix(in srgb, var(--odn-color-brand-6) 50%, transparent);
 }
 [data-odn-composer-box][data-odn-composer-file-drag] {
-  border-color: color-mix(in srgb, var(--odn-color-cyan-5) 60%, transparent);
-  background: color-mix(in srgb, var(--odn-color-cyan-5) 6%, var(--odn-color-bg-elevated));
+  border-color: color-mix(in srgb, var(--odn-color-brand-6) 60%, transparent);
+  background: color-mix(in srgb, var(--odn-color-brand-6) 6%, var(--odn-color-bg-elevated));
 }
 
 /* ------------------------------------------------------------------
@@ -225,6 +225,25 @@
   vertical-align: baseline;
 }
 
+/* editor 内跟随正文 inherit，避免与外层 14/24 双写冲突。
+ * 同时收紧 chip 视觉间距：
+ * - 取消组件默认 margin（否则 text↔chip / chip↔chip 都会被双边叠加拉宽）
+ * - 下调横向 padding，保留可点击热区但减少“透明留白”观感 */
+[data-odn-composer] [data-odn-composer-editor] [data-odn-invocation],
+[data-odn-composer] [data-odn-composer-editor] [data-odn-mention] {
+  margin-inline: 1px;
+  padding-left: 2px;
+  padding-right: 2px;
+  font-size: inherit;
+  line-height: inherit;
+}
+
+/* 键盘输入模态：鼠标会被隐藏，此时不应沿用旧鼠标位置触发 hover 态。 */
+[data-odn-composer] [data-odn-composer-editor][data-odn-input-modality=keyboard] [data-odn-invocation]:hover:not([data-state=active]),
+[data-odn-composer] [data-odn-composer-editor][data-odn-input-modality=keyboard] [data-odn-mention]:hover:not([data-state=active]) {
+  background: transparent;
+}
+
 /* chip 在 contentEditable=false 下无原生 selection 高亮，自绘选中态 */
 [data-odn-composer] [data-odn-composer-chip-host][data-selected] [data-odn-invocation],
 [data-odn-composer] [data-odn-composer-chip-host][data-selected] [data-odn-mention] {
@@ -303,9 +322,9 @@
   transition: opacity 0.15s;
 }
 [data-odn-composer-tool-btn][data-odn-composer-tool-active] {
-  color: var(--odn-color-cyan-5);
+  color: var(--odn-color-brand-6);
   font-weight: 600;
-  background: color-mix(in srgb, var(--odn-color-cyan-5) 10%, transparent);
+  background: color-mix(in srgb, var(--odn-color-brand-6) 10%, transparent);
 }
 [data-odn-composer-tool-btn][data-odn-composer-tool-active]::before {
   opacity: 1;
@@ -321,11 +340,11 @@
   height: 16px;
   margin-left: 2px;
   border-radius: 4px;
-  color: color-mix(in srgb, var(--odn-color-cyan-5) 70%, transparent);
+  color: color-mix(in srgb, var(--odn-color-brand-6) 70%, transparent);
   transition: color 0.15s;
 }
 [data-odn-composer-skill-clear]:hover {
-  color: var(--odn-color-cyan-5);
+  color: var(--odn-color-brand-6);
 }
 [data-odn-composer-skill-clear] [data-odn-hover-fill-content] {
   display: inline-flex;
@@ -350,7 +369,7 @@
   padding: 0;
   border-radius: 6px;
   border: none;
-  background-color: var(--odn-color-cyan-5);
+  background-color: var(--odn-color-brand-6);
   color: #fff;
   cursor: pointer;
   transition: opacity 0.15s;

package/dist/composer/utils.d.ts

@@ -9,8 +9,10 @@
  *
  * @ / / 触发判定（getTriggerContext）放在 step 4 一起加。
  */
-/** Zero Width Space (U+200B)：编辑器还会用作光标锚点（chip 后面塞一个）。 */
+/** Zero Width Space (U+200B)：仅用于 marker 包裹。 */
 export declare const ZWSP = "\u200B";
+/** Zero Width No-Break Space (U+FEFF)：仅用于 caret 锚点（chip 后 spacer）。 */
+export declare const CARET_SPACER = "\uFEFF";
 /** Invisible Separator (U+2063)：包裹 marker 的 id，业务文本不会出现。 */
 export declare const SEP = "\u2063";
 export declare function stripInvisibleChars(s: string): string;
@@ -63,6 +65,25 @@ export declare function getPlainText(editor: HTMLElement, chipIdAttr?: string):
  * 空格 / 全角空格也算"已输入"，只要文本非空就该收起 placeholder。
  */
 export declare function isEditorEmpty(editor: HTMLElement, chipIdAttr?: string): boolean;
+export declare const isZwspText: (n: Node | null | undefined) => n is Text;
+/** chip 后插入（或复用）独立 spacer text node，供 caret 落点与方向键 helper 识别。 */
+export declare function attachCaretSpacerAfter(host: HTMLElement): Text;
+/** 删除 chip 时一并移除紧随的 ZWSP 锚点（仅整 node 为 ZWSP 时删，避免误伤合并 text）。 */
+export declare function detachCaretSpacerAfter(host: HTMLElement): void;
+/**
+ * 把 element-boundary caret 位置规范为 text-node caret：
+ * - 若 offset 左侧已经是 text node，落到该 text 末尾
+ * - 否则在 offset 位置插入一个 caret spacer text，并落到 offset=1
+ */
+export declare function ensureTextAnchorAt(parent: Node, offset: number): {
+    node: Text;
+    offset: number;
+} | null;
+/**
+ * 清理行首浏览器占位：leading `<br>` / 空 text / 孤立 ZWSP（紧邻 chip 前）。
+ * 返回是否改过 DOM；若 caret 落在被删节点上，恢复到 editor 起点或首个 chip 前。
+ */
+export declare function normalizeComposerEditorDom(editor: HTMLElement, chipIdAttr?: string): boolean;
 /**
  * caret 视觉是否紧邻某个 chip 后方？返回该 chip，否则 null。
  * 用于 Backspace 整块删 + ArrowLeft 跨过 chip。
@@ -86,6 +107,19 @@ export declare function resolveCaretJumpAroundChip(range: Range, direction: 'lef
     node: Node;
     offset: number;
 } | null;
+export declare function childIndex(node: Node): number;
+/** chip 之前的可见纯文本（不含 marker / 不可见字符）。 */
+export declare function getVisibleTextBeforeHost(editor: HTMLElement, host: HTMLElement, chipIdAttr?: string): string;
+/**
+ * 清理 contenteditable 删字后的幽灵节点：空 text、仅 chip 时的占位 <br>。
+ * 避免「文字 + invocation」删光文字后出现多余换行，以及 caret 卡在 chip 后误删 invocation。
+ */
+export declare function normalizeEditorDom(editor: HTMLElement, _chipIdAttr?: string): void;
+/** caret 落在 chip 后空 text 时，挪到 chip 前（不删 chip）。 */
+export declare function moveCaretBeforeChip(host: HTMLElement, opts?: {
+    removeTrailingEmptyText?: boolean;
+    trailingText?: Text | null;
+}): void;
 export interface TriggerProbe {
     /** 触发字符 */
     trigger: string;

package/dist/composer/utils.js

@@ -17,8 +17,10 @@ function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len
  * Marker · 用零宽字符把 mention id 写入纯文本
  * ──────────────────────────────────────────────────────────────────── */
 
-/** Zero Width Space (U+200B)：编辑器还会用作光标锚点（chip 后面塞一个）。 */
+/** Zero Width Space (U+200B)：仅用于 marker 包裹。 */
 export var ZWSP = "\u200B";
+/** Zero Width No-Break Space (U+FEFF)：仅用于 caret 锚点（chip 后 spacer）。 */
+export var CARET_SPACER = "\uFEFF";
 
 /** Invisible Separator (U+2063)：包裹 marker 的 id，业务文本不会出现。 */
 export var SEP = "\u2063";
@@ -29,11 +31,14 @@ var escapeRe = function escapeRe(s) {
 };
 var MARKER_RE = new RegExp("".concat(escapeRe(MARKER_OPEN), "([^").concat(SEP, "]+)").concat(escapeRe(MARKER_CLOSE)), 'g');
 
-/** 从用户可见文本中剔除 ZWSP / SEP（粘贴残留、锚点字符）。 */
-var INVISIBLE_RE = new RegExp("[".concat(ZWSP).concat(SEP, "]"), 'g');
+/** 从用户可见文本中剔除 marker/锚点不可见字符。 */
+var INVISIBLE_RE = new RegExp("[".concat(ZWSP).concat(CARET_SPACER).concat(SEP, "]"), 'g');
 export function stripInvisibleChars(s) {
   return s.replace(INVISIBLE_RE, '');
 }
+var isCaretSpacerChar = function isCaretSpacerChar(ch) {
+  return ch === CARET_SPACER || ch === ZWSP;
+};
 
 /** 把 mention id 包成 marker token，插入 value 的 string 里。 */
 export function createMarker(id) {
@@ -184,6 +189,143 @@ var kebab = function kebab(s) {
     return "-".concat(m.toLowerCase());
   });
 };
+var makeIsHost = function makeIsHost(chipIdAttr) {
+  return function (el) {
+    return el instanceof HTMLElement && el.dataset[chipIdAttr] !== undefined;
+  };
+};
+
+/* ────────────────────────────────────────────────────────────────────
+ * DOM 不变量 · chip 后 ZWSP 锚点 + 行首占位清理
+ *
+ * contentEditable=false 的 chip 顶在行首时，浏览器常会塞占位 <br>，删光前文后
+ * invocation 会「掉到第二行」。chip 后固定插 ZWSP（caret 锚点），input 时剥掉
+ * chip 前的 leading <br> / 空 text node。
+ * ──────────────────────────────────────────────────────────────────── */
+
+export var isZwspText = function isZwspText(n) {
+  var _n$textContent;
+  return !!n && n.nodeType === Node.TEXT_NODE && isCaretSpacerChar((_n$textContent = n.textContent) !== null && _n$textContent !== void 0 ? _n$textContent : '');
+};
+
+/** chip 后插入（或复用）独立 spacer text node，供 caret 落点与方向键 helper 识别。 */
+export function attachCaretSpacerAfter(host) {
+  var _host$parentNode;
+  var next = host.nextSibling;
+  if (isZwspText(next)) return next;
+  var spacer = document.createTextNode(CARET_SPACER);
+  (_host$parentNode = host.parentNode) === null || _host$parentNode === void 0 || _host$parentNode.insertBefore(spacer, host.nextSibling);
+  return spacer;
+}
+
+/** 删除 chip 时一并移除紧随的 ZWSP 锚点（仅整 node 为 ZWSP 时删，避免误伤合并 text）。 */
+export function detachCaretSpacerAfter(host) {
+  var next = host.nextSibling;
+  if (isZwspText(next)) next.remove();
+}
+
+/**
+ * 把 element-boundary caret 位置规范为 text-node caret：
+ * - 若 offset 左侧已经是 text node，落到该 text 末尾
+ * - 否则在 offset 位置插入一个 caret spacer text，并落到 offset=1
+ */
+export function ensureTextAnchorAt(parent, offset) {
+  var _parent$childNodes$sa;
+  var len = parent.childNodes.length;
+  var safeOffset = Math.max(0, Math.min(offset, len));
+  var left = parent.childNodes[safeOffset - 1];
+  if ((left === null || left === void 0 ? void 0 : left.nodeType) === Node.TEXT_NODE) {
+    var _t$textContent;
+    var t = left;
+    return {
+      node: t,
+      offset: ((_t$textContent = t.textContent) !== null && _t$textContent !== void 0 ? _t$textContent : '').length
+    };
+  }
+  var ref = (_parent$childNodes$sa = parent.childNodes[safeOffset]) !== null && _parent$childNodes$sa !== void 0 ? _parent$childNodes$sa : null;
+  var spacer = document.createTextNode(CARET_SPACER);
+  parent.insertBefore(spacer, ref);
+  return {
+    node: spacer,
+    offset: 1
+  };
+}
+
+/**
+ * 清理行首浏览器占位：leading `<br>` / 空 text / 孤立 ZWSP（紧邻 chip 前）。
+ * 返回是否改过 DOM；若 caret 落在被删节点上，恢复到 editor 起点或首个 chip 前。
+ */
+export function normalizeComposerEditorDom(editor) {
+  var chipIdAttr = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 'mentionId';
+  var isHost = makeIsHost(chipIdAttr);
+  var nodeStartsWithChip = function nodeStartsWithChip(n) {
+    if (!n) return false;
+    if (isHost(n)) return true;
+    if (isZwspText(n) && isHost(n.nextSibling)) return true;
+    return false;
+  };
+  var isRemovableLeading = function isRemovableLeading(n) {
+    if (n.nodeType === Node.ELEMENT_NODE && n.tagName === 'BR') return true;
+    if (n.nodeType === Node.TEXT_NODE) {
+      var _n$textContent2;
+      return stripInvisibleChars((_n$textContent2 = n.textContent) !== null && _n$textContent2 !== void 0 ? _n$textContent2 : '') === '';
+    }
+    return false;
+  };
+  var sel = window.getSelection();
+  var saved = sel && sel.rangeCount > 0 && sel.isCollapsed && editor.contains(sel.anchorNode) ? {
+    node: sel.anchorNode,
+    offset: sel.anchorOffset
+  } : null;
+  var mutated = false;
+  while (editor.firstChild) {
+    var first = editor.firstChild;
+    if (isRemovableLeading(first) && nodeStartsWithChip(first.nextSibling)) {
+      first.remove();
+      mutated = true;
+      continue;
+    }
+    break;
+  }
+  var chipHosts = Array.from(editor.querySelectorAll("[data-".concat(kebab(chipIdAttr), "]")));
+  for (var _i3 = 0, _chipHosts = chipHosts; _i3 < _chipHosts.length; _i3++) {
+    var el = _chipHosts[_i3];
+    if (!isZwspText(el.nextSibling)) {
+      attachCaretSpacerAfter(el);
+      mutated = true;
+    }
+  }
+  if (mutated && saved && (!saved.node.isConnected || !editor.contains(saved.node))) {
+    restoreCaretAtEditorStart(editor, chipIdAttr);
+  }
+  return mutated;
+}
+function restoreCaretAtEditorStart(editor, chipIdAttr) {
+  var sel = window.getSelection();
+  if (!sel) return;
+  var isHost = makeIsHost(chipIdAttr);
+  var r = document.createRange();
+  var first = editor.firstChild;
+  if (!first) {
+    r.setStart(editor, 0);
+  } else if (first.nodeType === Node.TEXT_NODE) {
+    var _first$textContent;
+    var text = (_first$textContent = first.textContent) !== null && _first$textContent !== void 0 ? _first$textContent : '';
+    r.setStart(first, text.length > 0 && isCaretSpacerChar(text[0]) ? 1 : 0);
+  } else {
+    var anchor = ensureTextAnchorAt(editor, 0);
+    if (anchor) {
+      r.setStart(anchor.node, anchor.offset);
+    } else if (isHost(first)) {
+      r.setStart(editor, 0);
+    } else {
+      r.setStart(editor, 0);
+    }
+  }
+  r.collapse(true);
+  sel.removeAllRanges();
+  sel.addRange(r);
+}
 
 /* ────────────────────────────────────────────────────────────────────
  * Cursor helpers · chip 边界判定
@@ -201,16 +343,6 @@ var kebab = function kebab(s) {
  * 多按一次」「两 chip 之间又卡一下」的体验问题。
  * ──────────────────────────────────────────────────────────────────── */
 
-var isZwspText = function isZwspText(n) {
-  var _n$textContent;
-  return !!n && n.nodeType === Node.TEXT_NODE && ((_n$textContent = n.textContent) !== null && _n$textContent !== void 0 ? _n$textContent : '') === ZWSP;
-};
-var makeIsHost = function makeIsHost(chipIdAttr) {
-  return function (el) {
-    return el instanceof HTMLElement && el.dataset[chipIdAttr] !== undefined;
-  };
-};
-
 /**
  * caret 视觉是否紧邻某个 chip 后方？返回该 chip，否则 null。
  * 用于 Backspace 整块删 + ArrowLeft 跨过 chip。
@@ -233,7 +365,7 @@ export function findChipHostBeforeCaret(range) {
     }
     // (a) caret 紧贴 text 开头的 ZWSP（含 ZWSP 与后续输入合并的场景，如 '\u200babc'）
     // 视觉位置 = chip 之后，应让 Backspace / ← 一次跨过 chip
-    if (text[0] === ZWSP && (offset === 0 || offset === 1) && isHost(node.previousSibling)) {
+    if (isCaretSpacerChar(text[0]) && (offset === 0 || offset === 1) && isHost(node.previousSibling)) {
       return node.previousSibling;
     }
     return null;
@@ -272,9 +404,12 @@ export function findChipHostAfterCaret(range) {
         return node.nextSibling.nextSibling;
       }
     }
-    // chip 之前的 ZWSP（场景：两 chip 紧贴时，前 chip 的 ZWSP 即在后 chip 之前；
-    // 也兼容 ZWSP 与文字合并的合并 text node 边界）
-    if (text[0] === ZWSP && (offset === 0 || offset === 1) && isHost(node.nextSibling)) {
+    // 独立 ZWSP 节点：仅 offset=1（紧贴下一 chip 前缘）才算「caret 在 chip 前」
+    if (text.length === 1 && isCaretSpacerChar(text[0]) && offset === 1 && isHost(node.nextSibling)) {
+      return node.nextSibling;
+    }
+    // 合并 text（spacer + 正文）：offset=1 且下一 sibling 是 chip
+    if (text.length > 1 && isCaretSpacerChar(text[0]) && offset === 1 && isHost(node.nextSibling)) {
       return node.nextSibling;
     }
     return null;
@@ -283,10 +418,6 @@ export function findChipHostAfterCaret(range) {
     var el = node;
     var next = el.childNodes[offset];
     if (isHost(next)) return next;
-    // chip + ZWSP 链：next 是 ZWSP，再后一个是 chip
-    if (isZwspText(next) && isHost(next.nextSibling)) {
-      return next.nextSibling;
-    }
   }
   return null;
 }
@@ -301,16 +432,56 @@ export function findChipHostAfterCaret(range) {
  * 返回 null 表示无需介入；调用方按浏览器默认处理即可。
  */
 export function resolveCaretJumpAroundChip(range, direction) {
+  var _node$textContent4;
   var chipIdAttr = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : 'mentionId';
+  var isHost = makeIsHost(chipIdAttr);
+  var node = range.startContainer,
+    offset = range.startOffset;
+
+  /* spacer 内微步：仅保留 ArrowRight 的 0→1。
+   * ArrowLeft 在 chip 右侧一律直接跨到 chip 左侧，避免任何“卡一下”。 */
+  if (node.nodeType === Node.TEXT_NODE && isCaretSpacerChar((_node$textContent4 = node.textContent) !== null && _node$textContent4 !== void 0 ? _node$textContent4 : '')) {
+    if (direction === 'right' && offset === 0) {
+      return {
+        node: node,
+        offset: 1
+      };
+    }
+    if (direction === 'left' && offset === 1) {
+      var _chip = findChipHostBeforeCaret(range, chipIdAttr);
+      if (!_chip) return null;
+      var _parent = _chip.parentNode;
+      if (!_parent) return null;
+      return ensureTextAnchorAt(_parent, childIndex(_chip));
+    }
+  }
+  if (node.nodeType === Node.ELEMENT_NODE) {
+    var el = node;
+    if (direction === 'right') {
+      var next = el.childNodes[offset];
+      if (isZwspText(next)) {
+        return {
+          node: next,
+          offset: 0
+        };
+      }
+    } else {
+      var prev = el.childNodes[offset - 1];
+      var _next = el.childNodes[offset];
+      if (isZwspText(prev) && isHost(_next)) {
+        return {
+          node: prev,
+          offset: 1
+        };
+      }
+    }
+  }
   if (direction === 'left') {
-    var _chip = findChipHostBeforeCaret(range, chipIdAttr);
-    if (!_chip) return null;
-    var _parent = _chip.parentNode;
-    if (!_parent) return null;
-    return {
-      node: _parent,
-      offset: childIndex(_chip)
-    };
+    var _chip2 = findChipHostBeforeCaret(range, chipIdAttr);
+    if (!_chip2) return null;
+    var _parent2 = _chip2.parentNode;
+    if (!_parent2) return null;
+    return ensureTextAnchorAt(_parent2, childIndex(_chip2));
   }
   var chip = findChipHostAfterCaret(range, chipIdAttr);
   if (!chip) return null;
@@ -323,12 +494,9 @@ export function resolveCaretJumpAroundChip(range, direction) {
   }
   var parent = chip.parentNode;
   if (!parent) return null;
-  return {
-    node: parent,
-    offset: childIndex(chip) + 1
-  };
+  return ensureTextAnchorAt(parent, childIndex(chip) + 1);
 }
-function childIndex(node) {
+export function childIndex(node) {
   var i = 0;
   var cur = node.previousSibling;
   while (cur) {
@@ -338,6 +506,83 @@ function childIndex(node) {
   return i;
 }
 
+/** chip 之前的可见纯文本（不含 marker / 不可见字符）。 */
+export function getVisibleTextBeforeHost(editor, host) {
+  var chipIdAttr = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : 'mentionId';
+  var r = document.createRange();
+  r.selectNodeContents(editor);
+  r.setEndBefore(host);
+  var tmp = document.createElement('div');
+  tmp.appendChild(r.cloneContents());
+  return stripInvisibleChars(stripMarkers(getPlainText(tmp))).replace(/\n/g, '');
+}
+
+/**
+ * 清理 contenteditable 删字后的幽灵节点：空 text、仅 chip 时的占位 <br>。
+ * 避免「文字 + invocation」删光文字后出现多余换行，以及 caret 卡在 chip 后误删 invocation。
+ */
+export function normalizeEditorDom(editor) {
+  var _chipIdAttr = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 'mentionId';
+  var emptyTexts = [];
+  var walker = document.createTreeWalker(editor, NodeFilter.SHOW_TEXT);
+  var n;
+  while (n = walker.nextNode()) {
+    var _t$textContent2;
+    var t = n;
+    // 仅清理真正的空文本节点；保留 caret spacer，避免首次换行落点被抹掉
+    if (((_t$textContent2 = t.textContent) !== null && _t$textContent2 !== void 0 ? _t$textContent2 : '') === '') {
+      emptyTexts.push(t);
+    }
+  }
+  emptyTexts.forEach(function (t) {
+    return t.remove();
+  });
+  editor.querySelectorAll('[data-odn-composer-chip-host]').forEach(function (hostEl) {
+    var host = hostEl;
+    var prev = host.previousSibling;
+    while (prev) {
+      if (prev.nodeType === Node.TEXT_NODE) {
+        var _prev$textContent;
+        var _t = stripInvisibleChars((_prev$textContent = prev.textContent) !== null && _prev$textContent !== void 0 ? _prev$textContent : '');
+        if (_t !== '') break;
+        var rm = prev;
+        prev = prev.previousSibling;
+        rm.remove();
+        continue;
+      }
+      if (prev.nodeType === Node.ELEMENT_NODE && prev.tagName === 'BR') {
+        // 用户主动换行（data-odn-composer-user-break）必须保留，否则会出现
+        // 「第二行/第三行换行被吞、chip 插入回到首行」。仅清理浏览器塞的占位 <br>。
+        var brEl = prev;
+        if (brEl.hasAttribute('data-odn-composer-user-break')) break;
+        var _rm = prev;
+        prev = prev.previousSibling;
+        _rm.remove();
+        continue;
+      }
+      break;
+    }
+  });
+}
+
+/** caret 落在 chip 后空 text 时，挪到 chip 前（不删 chip）。 */
+export function moveCaretBeforeChip(host, opts) {
+  var parent = host.parentNode;
+  if (!parent) return;
+  var sel = window.getSelection();
+  if (!sel) return;
+  var anchor = ensureTextAnchorAt(parent, childIndex(host));
+  if (!anchor) return;
+  var r = document.createRange();
+  r.setStart(anchor.node, anchor.offset);
+  r.collapse(true);
+  sel.removeAllRanges();
+  sel.addRange(r);
+  if (opts !== null && opts !== void 0 && opts.removeTrailingEmptyText && opts.trailingText) {
+    opts.trailingText.remove();
+  }
+}
+
 /* ────────────────────────────────────────────────────────────────────
  * Trigger probe · @ / / 触发态判定
  *
@@ -376,7 +621,7 @@ var isTriggerBoundary = function isTriggerBoundary(node) {
   return false;
 };
 export function probeTrigger(range, triggers) {
-  var _node$textContent4;
+  var _node$textContent5;
   var maxQueryLen = arguments.length > 2 && arguments[2] !== undefined ? arguments[2] : 50;
   if (!range.collapsed) return null;
 
@@ -401,7 +646,7 @@ export function probeTrigger(range, triggers) {
     }
   }
   if (node.nodeType !== Node.TEXT_NODE) return null;
-  var text = (_node$textContent4 = node.textContent) !== null && _node$textContent4 !== void 0 ? _node$textContent4 : '';
+  var text = (_node$textContent5 = node.textContent) !== null && _node$textContent5 !== void 0 ? _node$textContent5 : '';
   var triggerOffset = -1;
   var trigger = '';
   for (var i = caret - 1; i >= 0 && caret - i <= maxQueryLen + 1; i--) {

package/dist/fab/style/index.css

@@ -14,7 +14,7 @@
   backdrop-filter: blur(12px);
   -webkit-backdrop-filter: blur(12px);
   -webkit-tap-highlight-color: transparent;
-  font-family: "PingFang SC", -apple-system, BlinkMacSystemFont, "Segoe UI", sans-serif;
+  transition: all 200ms cubic-bezier(0.32, 0.72, 0, 1);
 }
 [data-odn-fab]:active {
   transform: scale(0.95);

package/dist/index.d.ts

@@ -59,7 +59,8 @@ export { default as AgentThink, type AgentThinkProps } from './agent-think';
 export { default as Attachments, type AttachmentsProps } from './attachments';
 export { default as CodeBlock, type CodeBlockProps } from './code-block';
 export { default as Composer, type ComposerProps, type ComposerRef } from './composer';
-export { default as Invocation, type InvocationProps } from './invocation';
+export { default as Invocation, InvocationParamPopover, type InvocationProps, type InvocationParamPopoverProps, } from './invocation';
+export { type ComposerParamPanelContext } from './composer/param-panel';
 export { default as Mention, type MentionProps } from './mention';
 export { default as ChatItem, type ChatItemProps } from './chat-item';
 export { default as SkillSlot, type SkillSlotProps } from './skill-slot';
@@ -72,4 +73,5 @@ export { default as StreamText, type StreamTextProps, type TypographyOverrides }
 export { default as Suggestions, type SuggestionsProps } from './suggestions';
 export { default as UserBubble, type UserBubbleProps } from './user-bubble';
 export { default as Welcome, type WelcomeProps } from './welcome';
-export type { ToolCall, ToolStatus, Source, Attachment, PreviewTarget, PreviewTab, SendMeta, ComposerChipMeta, InvocationData, MentionData, SkillItem, AgentEvent, Conversation, MessageSnapshot, ChatMessage } from './_genui-types';
+export type { ToolCall, ToolStatus, Source, Attachment, PreviewTarget, PreviewTab, SendMeta, ComposerSegment, InvocationData, MentionData, InlineRefState, SkillItem, AgentEvent, Conversation, MessageSnapshot, ChatMessage } from './_genui-types';
+export { rawValueToSegments, segmentsToReadableText, segmentsHasContent, type SegmentsToReadableTextOptions, } from './composer/segments';

package/dist/index.js

@@ -65,7 +65,7 @@ export { default as AgentThink } from "./agent-think";
 export { default as Attachments } from "./attachments";
 export { default as CodeBlock } from "./code-block";
 export { default as Composer } from "./composer";
-export { default as Invocation } from "./invocation";
+export { default as Invocation, InvocationParamPopover } from "./invocation";
 export { default as Mention } from "./mention";
 export { default as ChatItem } from "./chat-item";
 export { default as SkillSlot } from "./skill-slot";
@@ -79,4 +79,6 @@ export { default as Suggestions } from "./suggestions";
 export { default as UserBubble } from "./user-bubble";
 export { default as Welcome } from "./welcome";
 
-// GenUI shared modules
+// GenUI shared modules
+
+export { rawValueToSegments, segmentsToReadableText, segmentsHasContent } from "./composer/segments";

package/dist/invocation/index.d.ts

@@ -8,10 +8,15 @@ export interface InvocationProps {
      * false：UserBubble 等只读态（可 hover 看摘要）。
      */
     interactive?: boolean;
-    /** form popover 打开时的高亮态（L4 params 启用后使用） */
+    /**
+     * 参数面板打开时高亮（最高优先级，叠浅底色）。
+     * 不进 `data.state`，因为它是临时 UI 状态，不属于 invocation 自身语义。
+     */
     active?: boolean;
-    /** 交互态单击回调 */
+    /** 交互态单击；业务接管打开参数面板等行为 */
     onClick?: (anchor: HTMLElement) => void;
 }
 export declare function Invocation({ data, interactive, active, onClick, }: InvocationProps): import("react").JSX.Element;
+export { InvocationParamPopover } from './param-popover';
+export type { InvocationParamPopoverProps } from './param-popover';
 export default Invocation;

package/dist/invocation/index.js

@@ -6,9 +6,9 @@ function _iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" !=
 function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
 import Popover from "../popover";
 import "./style";
-function formatParamsSummary(params) {
-  if (!params) return null;
-  var entries = Object.entries(params).filter(function (_ref) {
+function formatPayloadSummary(payload) {
+  if (!payload) return null;
+  var entries = Object.entries(payload).filter(function (_ref) {
     var _ref2 = _slicedToArray(_ref, 2),
       v = _ref2[1];
     return v != null && v !== '';
@@ -22,6 +22,7 @@ function formatParamsSummary(params) {
   }).join(' · ');
 }
 export function Invocation(_ref5) {
+  var _data$state;
   var data = _ref5.data,
     _ref5$interactive = _ref5.interactive,
     interactive = _ref5$interactive === void 0 ? false : _ref5$interactive,
@@ -29,7 +30,8 @@ export function Invocation(_ref5) {
     active = _ref5$active === void 0 ? false : _ref5$active,
     onClick = _ref5.onClick;
   var clickable = interactive && !!onClick;
-  var state = active ? 'active' : 'complete';
+  /** 状态优先级：active > data.state > 'complete' */
+  var state = active ? 'active' : (_data$state = data.state) !== null && _data$state !== void 0 ? _data$state : 'complete';
   var handleClick = clickable ? function (e) {
     e.preventDefault();
     e.stopPropagation();
@@ -52,8 +54,9 @@ export function Invocation(_ref5) {
     "data-odn-invocation-label": true
   }, data.label));
   if (interactive) return core;
-  var summary = formatParamsSummary(data.params);
-  if (!summary) return core;
+  var summary = formatPayloadSummary(data.payload);
+  /** 只读态：有 payload 摘要 → hover；pending 但无 payload → 「未填参数」；否则不弹 */
+  if (!summary && data.state !== 'pending') return core;
   return /*#__PURE__*/React.createElement(Popover, {
     trigger: "hover",
     placement: "top",
@@ -77,8 +80,11 @@ function InvocationHoverPopup(_ref6) {
   }, /*#__PURE__*/React.createElement("span", {
     "data-odn-invocation-popover-slash": true,
     "aria-hidden": true
-  }, "/"), label), /*#__PURE__*/React.createElement("div", {
+  }, "/"), label), summary ? /*#__PURE__*/React.createElement("div", {
     "data-odn-invocation-popover-summary": true
-  }, summary));
+  }, summary) : /*#__PURE__*/React.createElement("div", {
+    "data-odn-invocation-popover-empty": true
+  }, "\u672A\u586B\u53C2\u6570"));
 }
+export { InvocationParamPopover } from "./param-popover";
 export default Invocation;