one-design-next 0.0.86 → 0.0.87

package/dist/composer/index.js

@@ -16,10 +16,11 @@ import { Message } from "../message";
 import Popover from "../popover";
 import SkillSlot from "../skill-slot";
 import Tooltip from "../tooltip";
-import { ComposerEditor } from "./editor";
+import { COMPOSER_EDITOR_MAX_ROWS_PX, ComposerEditor } from "./editor";
 import { chipHasEditableParams, isMentionChip } from "./inline-ref";
 import { rawValueToSegments, segmentsHasContent } from "./segments";
 import "./style";
+import { filterSkillsByQuery, resolveComposerSkillMenuWidth, shouldOpenSlashTriggerMenu } from "./utils";
 function createInvocationChipData(skill) {
   return {
     id: "skill-".concat(skill.id, "-").concat(Date.now().toString(36), "-").concat(Math.random().toString(36).slice(2, 6)),
@@ -96,7 +97,7 @@ var DEFAULT_TOOL_CONFIGS = {
  */
 
 export var Composer = /*#__PURE__*/forwardRef(function Composer(_ref, ref) {
-  var _skillSlotProps$menuW, _paramEdit$chipId;
+  var _filteredSkillGroups$, _filteredSkills$lengt, _paramEdit$chipId;
   var valueProp = _ref.value,
     _ref$defaultValue = _ref.defaultValue,
     defaultValue = _ref$defaultValue === void 0 ? '' : _ref$defaultValue,
@@ -150,7 +151,6 @@ export var Composer = /*#__PURE__*/forwardRef(function Composer(_ref, ref) {
   var onManageSkills = skillSlotProps === null || skillSlotProps === void 0 ? void 0 : skillSlotProps.onManageSkills;
   var skillManageFooter = skillSlotProps === null || skillSlotProps === void 0 ? void 0 : skillSlotProps.skillManageFooter;
   var resolvedMenuMaxHeight = skillSlotProps === null || skillSlotProps === void 0 ? void 0 : skillSlotProps.menuMaxHeight;
-  var resolvedMenuWidth = (_skillSlotProps$menuW = skillSlotProps === null || skillSlotProps === void 0 ? void 0 : skillSlotProps.menuWidth) !== null && _skillSlotProps$menuW !== void 0 ? _skillSlotProps$menuW : 260;
   var showGroupTitles = skillSlotProps === null || skillSlotProps === void 0 ? void 0 : skillSlotProps.showGroupTitles;
   var _useControlledState = useControlledState(defaultValue, valueProp),
     _useControlledState2 = _slicedToArray(_useControlledState, 2),
@@ -192,7 +192,7 @@ export var Composer = /*#__PURE__*/forwardRef(function Composer(_ref, ref) {
     _useState10 = _slicedToArray(_useState9, 2),
     expanded = _useState10[0],
     setExpanded = _useState10[1];
-  /** full 模式下由右上角按钮控制的 50vh 展开态。 */
+  /** 右上角按钮：拉到当前生效上限（10 行盒高，矮屏被整框 50vh 截住）。 */
   var _useState11 = useState(false),
     _useState12 = _slicedToArray(_useState11, 2),
     fullExpanded = _useState12[0],
@@ -202,8 +202,7 @@ export var Composer = /*#__PURE__*/forwardRef(function Composer(_ref, ref) {
     _useState14 = _slicedToArray(_useState13, 2),
     editorHeight = _useState14[0],
     setEditorHeight = _useState14[1];
-  /** editor 内容是否真正达到 maxRows 触顶——配合 SCSS 控制 viewport overflow，
-   *  阻止升格 transition / 换行未触顶时的 scrollbar 闪现 */
+  /** 内容已超过 10 行，或整框 50vh 把编辑器挤到放不下当前内容 */
   var _useState15 = useState(false),
     _useState16 = _slicedToArray(_useState15, 2),
     atMax = _useState16[0],
@@ -211,6 +210,35 @@ export var Composer = /*#__PURE__*/forwardRef(function Composer(_ref, ref) {
   var fileInputRef = useRef(null);
   var editorRef = useRef(null);
   var boxRef = useRef(null);
+  var skillTriggerRef = useRef(null);
+  var triggerAnchorRef = useRef(null);
+  var _useState17 = useState(0),
+    _useState18 = _slicedToArray(_useState17, 2),
+    skillMenuCrossAxis = _useState18[0],
+    setSkillMenuCrossAxis = _useState18[1];
+  /** composer box 实宽；技能菜单默认比它略窄。显式 menuWidth 覆盖。 */
+  var _useState19 = useState(0),
+    _useState20 = _slicedToArray(_useState19, 2),
+    boxWidth = _useState20[0],
+    setBoxWidth = _useState20[1];
+  useLayoutEffect(function () {
+    var el = boxRef.current;
+    if (!el) return undefined;
+    var sync = function sync() {
+      var next = el.getBoundingClientRect().width;
+      setBoxWidth(function (prev) {
+        return prev === next ? prev : next;
+      });
+    };
+    sync();
+    if (typeof ResizeObserver === 'undefined') return undefined;
+    var ro = new ResizeObserver(sync);
+    ro.observe(el);
+    return function () {
+      return ro.disconnect();
+    };
+  }, []);
+  var resolvedMenuWidth = resolveComposerSkillMenuWidth(skillSlotProps === null || skillSlotProps === void 0 ? void 0 : skillSlotProps.menuWidth, boxWidth);
   var handleComposerMouseDown = useCallback(function (event) {
     var _editorRef$current;
     if (disabled || event.button !== 0) return;
@@ -226,10 +254,10 @@ export var Composer = /*#__PURE__*/forwardRef(function Composer(_ref, ref) {
       preventScroll: true
     });
   }, [disabled]);
-  var _useState17 = useState(null),
-    _useState18 = _slicedToArray(_useState17, 2),
-    paramEdit = _useState18[0],
-    setParamEdit = _useState18[1];
+  var _useState21 = useState(null),
+    _useState22 = _slicedToArray(_useState21, 2),
+    paramEdit = _useState22[0],
+    setParamEdit = _useState22[1];
   var openParamPanel = useCallback(function (chipId) {
     if (!renderParamPanel) return;
     requestAnimationFrame(function () {
@@ -369,13 +397,19 @@ export var Composer = /*#__PURE__*/forwardRef(function Composer(_ref, ref) {
     }
   }, [text, attachments.length, expanded]);
 
-  // lite 回落到单行后同步退出手动 50vh 展开态。
+  // lite 回落到单行后同步退出手动展开态。
   useEffect(function () {
     if (variant === 'lite' && !expanded) {
       setFullExpanded(false);
     }
   }, [variant, expanded]);
 
+  // 内容已顶满（满 10 行或整框 50vh 溢出）时展开态没有可切换的高度。
+  var atHeightCap = atMax || editorHeight >= COMPOSER_EDITOR_MAX_ROWS_PX;
+  useEffect(function () {
+    if (atHeightCap) setFullExpanded(false);
+  }, [atHeightCap]);
+
   /* ---- Send ----
    * 内部 text 是 raw value（chip 序列化为零宽 marker）。
    * 对外只有一份契约：`onSend(segments, meta?)`
@@ -564,10 +598,10 @@ export var Composer = /*#__PURE__*/forwardRef(function Composer(_ref, ref) {
      * 不夺回焦点时 Enter 会再次激活按钮而不是发送 */
     (_editorRef$current15 = editorRef.current) === null || _editorRef$current15 === void 0 || _editorRef$current15.focus();
   };
-  var _useState19 = useState(false),
-    _useState20 = _slicedToArray(_useState19, 2),
-    fileDragOver = _useState20[0],
-    setFileDragOver = _useState20[1];
+  var _useState23 = useState(false),
+    _useState24 = _slicedToArray(_useState23, 2),
+    fileDragOver = _useState24[0],
+    setFileDragOver = _useState24[1];
   var composerBoxFileDragAttrs = fileDragOver ? {
     'data-odn-composer-file-drag': ''
   } : {};
@@ -617,39 +651,37 @@ export var Composer = /*#__PURE__*/forwardRef(function Composer(_ref, ref) {
   }, [openParamPanel]);
 
   /* trigger query 实时筛选 skills（substring match，case-insensitive）。
-   * 没有 query / 没有 trigger → 返回原列表。 */
+   * trigger 已结束时返回空列表，避免 Popover 关闭动画那一帧把子节点切回全量目录。
+   * 依赖 query / trigger 而不是整个 triggerInfo：rect 变化不应重建列表。 */
+  var slashTriggerActive = (triggerInfo === null || triggerInfo === void 0 ? void 0 : triggerInfo.trigger) === '/';
+  var slashTriggerQuery = slashTriggerActive ? triggerInfo === null || triggerInfo === void 0 ? void 0 : triggerInfo.query : undefined;
   var filteredSkills = useMemo(function () {
-    var _triggerInfo$query;
     if (!skills) return undefined;
-    var q = triggerInfo === null || triggerInfo === void 0 || (_triggerInfo$query = triggerInfo.query) === null || _triggerInfo$query === void 0 ? void 0 : _triggerInfo$query.trim().toLowerCase();
-    if (!q) return skills;
-    return skills.filter(function (s) {
-      return s.label.toLowerCase().includes(q);
-    });
-  }, [skills, triggerInfo === null || triggerInfo === void 0 ? void 0 : triggerInfo.query]);
+    if (!slashTriggerActive) return [];
+    return filterSkillsByQuery(skills, slashTriggerQuery);
+  }, [skills, slashTriggerActive, slashTriggerQuery]);
 
   /* grouped 版本的 trigger query 筛选：按组分别过滤，保留非空组。 */
   var filteredSkillGroups = useMemo(function () {
-    var _triggerInfo$query2;
     if (!skillGroups) return undefined;
-    var q = triggerInfo === null || triggerInfo === void 0 || (_triggerInfo$query2 = triggerInfo.query) === null || _triggerInfo$query2 === void 0 ? void 0 : _triggerInfo$query2.trim().toLowerCase();
-    if (!q) return skillGroups;
+    if (!slashTriggerActive) return [];
     return skillGroups.map(function (g) {
       return {
         groupName: g.groupName,
-        skills: g.skills.filter(function (s) {
-          return s.label.toLowerCase().includes(q);
-        })
+        skills: filterSkillsByQuery(g.skills, slashTriggerQuery)
       };
     }).filter(function (g) {
       return g.skills.length > 0;
     });
-  }, [skillGroups, triggerInfo === null || triggerInfo === void 0 ? void 0 : triggerInfo.query]);
+  }, [skillGroups, slashTriggerActive, slashTriggerQuery]);
 
-  /* trigger 浮层渲染条件：editor 处于 `/` 触发态 + 业务方传了 skills 或 skillGroups。
-   * `@` 触发本轮不接（mention 数据源待业务接入），onTriggerChange 拿到也不弹。 */
+  /* trigger 浮层：`/` 触发态 + 目录非空 + 过滤后仍有命中。
+   * 无匹配时菜单关闭，Enter 不再被当成「选 skill」。`@` 本轮不接。 */
   var hasSkills = !!(skills && skills.length > 0) || !!(skillGroups && skillGroups.length > 0);
-  var triggerMenuVisible = !!(triggerInfo && triggerInfo.trigger === '/' && hasSkills);
+  var triggerHitCount = skillGroups ? (_filteredSkillGroups$ = filteredSkillGroups === null || filteredSkillGroups === void 0 ? void 0 : filteredSkillGroups.reduce(function (n, g) {
+    return n + g.skills.length;
+  }, 0)) !== null && _filteredSkillGroups$ !== void 0 ? _filteredSkillGroups$ : 0 : (_filteredSkills$lengt = filteredSkills === null || filteredSkills === void 0 ? void 0 : filteredSkills.length) !== null && _filteredSkills$lengt !== void 0 ? _filteredSkills$lengt : 0;
+  var triggerMenuVisible = shouldOpenSlashTriggerMenu(triggerInfo === null || triggerInfo === void 0 ? void 0 : triggerInfo.trigger, hasSkills ? triggerHitCount : 0);
 
   /* query 变化或浮层关闭 → 高亮项重置到「最上方的可用项」（跳过 disabled）。
    * 用 query 而不是 triggerInfo 整体当依赖：rect 变化（光标移位）不应该 reset。 */
@@ -691,7 +723,8 @@ export var Composer = /*#__PURE__*/forwardRef(function Composer(_ref, ref) {
       var _skill = (_ref6 = (_triggerSkillSlotRef$3 = (_triggerSkillSlotRef$4 = triggerSkillSlotRef.current) === null || _triggerSkillSlotRef$4 === void 0 ? void 0 : _triggerSkillSlotRef$4.getActiveSkill()) !== null && _triggerSkillSlotRef$3 !== void 0 ? _triggerSkillSlotRef$3 : filteredSkills === null || filteredSkills === void 0 ? void 0 : filteredSkills[triggerActiveIndex]) !== null && _ref6 !== void 0 ? _ref6 : filteredSkillGroups === null || filteredSkillGroups === void 0 ? void 0 : filteredSkillGroups.flatMap(function (g) {
         return g.skills;
       })[triggerActiveIndex];
-      if (_skill) handleSelectSkill(_skill, 'trigger');
+      if (!_skill) return false;
+      handleSelectSkill(_skill, 'trigger');
       return true;
     }
     if (e.key === 'Escape') {
@@ -704,29 +737,6 @@ export var Composer = /*#__PURE__*/forwardRef(function Composer(_ref, ref) {
     return false;
   }, [filteredSkills, filteredSkillGroups, handleSelectSkill, triggerActiveIndex, triggerMenuVisible]);
 
-  /* trigger 浮 anchor：跟随 caret 的 0×0 隐形元素，给 Popover 当 children。
-   * Popover 需要 DOM children 当 reference，没有"虚拟 anchor" API，只能这么搞。
-   *
-   * 使用 position: absolute 而非 fixed——Drawer 等容器的 transform 会创建
-   * 新的 containing block，导致 fixed 定位失准。absolute 相对于最近 positioned
-   * 祖先（[data-odn-composer] 有 position:relative），通过减去 offsetParent
-   * 的 viewport rect 得到正确的局部坐标。 */
-  var triggerAnchorRef = useRef(null);
-  useLayoutEffect(function () {
-    var el = triggerAnchorRef.current;
-    if (!el || !triggerInfo) return;
-    var offsetParent = el.offsetParent;
-    if (offsetParent) {
-      var parentRect = offsetParent.getBoundingClientRect();
-      el.style.left = "".concat(triggerInfo.rect.left - parentRect.left, "px");
-      el.style.top = "".concat(triggerInfo.rect.top - parentRect.top, "px");
-    } else {
-      // fallback：没有 offsetParent（比如 display:none），用 viewport 坐标
-      el.style.left = "".concat(triggerInfo.rect.left, "px");
-      el.style.top = "".concat(triggerInfo.rect.top, "px");
-    }
-  }, [triggerInfo]);
-
   /* ---- Derived ---- */
   var hasUploadingAttachment = attachments.some(function (a) {
     var _a$status2;
@@ -740,6 +750,29 @@ export var Composer = /*#__PURE__*/forwardRef(function Composer(_ref, ref) {
   var effectiveLabeled = isLite ? false : toolsLabeled;
   // lite 模式下仅允许一个工具按钮（数量在两态下保持恒定）
   var effectiveTools = isLite ? tools.slice(0, 1) : tools;
+  useLayoutEffect(function () {
+    var el = triggerAnchorRef.current;
+    var box = boxRef.current;
+    if (!el || !box || !triggerInfo) return;
+    var boxRect = box.getBoundingClientRect();
+    el.style.top = "".concat(triggerInfo.rect.top - boxRect.top, "px");
+  }, [triggerInfo]);
+  useLayoutEffect(function () {
+    var box = boxRef.current;
+    var trigger = skillTriggerRef.current;
+    if (!box || !trigger) {
+      setSkillMenuCrossAxis(function (prev) {
+        return prev === 0 ? prev : 0;
+      });
+      return;
+    }
+    var boxRect = box.getBoundingClientRect();
+    var triggerRect = trigger.getBoundingClientRect();
+    var next = Math.round(boxRect.left + boxRect.width / 2 - (triggerRect.left + triggerRect.width / 2));
+    setSkillMenuCrossAxis(function (prev) {
+      return prev === next ? prev : next;
+    });
+  }, [boxWidth, toolMenuOpen, effectiveLabeled, isLite, expanded, fullExpanded]);
 
   /* 统一解析 toolConfigs：
    * - key 未配置 → 整份默认
@@ -891,12 +924,17 @@ export var Composer = /*#__PURE__*/forwardRef(function Composer(_ref, ref) {
       visible: toolMenuOpen ? false : undefined,
       transitionDuration: toolMenuOpen ? 0 : undefined
     }, /*#__PURE__*/React.createElement("div", {
+      ref: skillTriggerRef,
       "data-odn-composer-skill-trigger": true
     }, /*#__PURE__*/React.createElement(Popover, {
       trigger: "click",
       arrowed: false,
-      placement: "topLeft",
-      offset: 4,
+      placement: "top",
+      shift: false,
+      offset: {
+        mainAxis: 4,
+        crossAxis: skillMenuCrossAxis
+      },
       visible: !disabled && toolMenuOpen,
       onVisibleChange: function onVisibleChange(v) {
         if (disabled) return;
@@ -1089,7 +1127,7 @@ export var Composer = /*#__PURE__*/forwardRef(function Composer(_ref, ref) {
     },
     onPressEnter: function onPressEnter(e) {
       if (e.nativeEvent.isComposing || e.keyCode === 229) return;
-      // trigger 浮层激活时，普通 Enter 留给浮层做选择；Shift+Enter 继续换行
+      // trigger 浮层有可选中项时，普通 Enter 留给浮层做选择；Shift+Enter 继续换行
       if (triggerMenuVisible && !e.shiftKey) {
         e.preventDefault();
         return false;
@@ -1106,12 +1144,13 @@ export var Composer = /*#__PURE__*/forwardRef(function Composer(_ref, ref) {
     }
   });
 
-  /* trigger 浮层：anchor 是 fixed 定位的 0×0 隐形 div，跟随 caret 处的 trigger rect。
-   * 共用 SkillSlot 渲染，过滤后的列表为空时仍显示 menu（empty 视觉由 SkillSlot 自己处理）。 */
+  /* `/` 浮层：anchor 水平铺满 composer box、竖直跟 caret，菜单与输入框水平居中。
+   * 共用 SkillSlot 渲染；过滤后无命中时 triggerMenuVisible=false，不挂菜单。 */
   var triggerMenu = hasSkills ? /*#__PURE__*/React.createElement(Popover, {
     trigger: "click",
     arrowed: false,
-    placement: "topLeft",
+    placement: "top",
+    shift: false,
     offset: 4,
     visible: triggerMenuVisible,
     onVisibleChange: function onVisibleChange(v) {
@@ -1143,7 +1182,9 @@ export var Composer = /*#__PURE__*/forwardRef(function Composer(_ref, ref) {
     "data-odn-composer-trigger-anchor": true,
     style: {
       position: 'absolute',
-      width: 0,
+      left: 0,
+      right: 0,
+      top: 0,
       height: 0,
       pointerEvents: 'none'
     },
@@ -1152,6 +1193,7 @@ export var Composer = /*#__PURE__*/forwardRef(function Composer(_ref, ref) {
 
   // lite：有附件即强制升格（否则按钮会和附件/多行内容打架）
   var liteExpanded = isLite && !isInlineLite;
+  var showExpandBtn = !isInlineLite && !atHeightCap;
   var fullExpandLabel = fullExpanded ? '收起输入框' : '展开输入框';
   return /*#__PURE__*/React.createElement("div", {
     "data-odn-composer": true,
@@ -1159,6 +1201,7 @@ export var Composer = /*#__PURE__*/forwardRef(function Composer(_ref, ref) {
     "data-odn-composer-expanded": liteExpanded ? '' : undefined,
     "data-odn-composer-full-expanded": fullExpanded ? '' : undefined,
     "data-odn-composer-atmax": atMax ? '' : undefined,
+    "data-odn-composer-height-cap": atHeightCap ? '' : undefined,
     "data-odn-composer-disabled": disabled || undefined,
     "data-odn-composer-spacing": spacing === 'drawer' ? 'drawer' : undefined,
     "aria-disabled": disabled || undefined,
@@ -1167,7 +1210,7 @@ export var Composer = /*#__PURE__*/forwardRef(function Composer(_ref, ref) {
     onMouseDown: handleComposerMouseDown
   }, /*#__PURE__*/React.createElement("div", {
     "data-odn-composer-inner": true
-  }, hiddenFileInput, triggerMenu, paramPanelNode, /*#__PURE__*/React.createElement("div", _extends({
+  }, hiddenFileInput, paramPanelNode, /*#__PURE__*/React.createElement("div", _extends({
     ref: boxRef,
     "data-odn-composer-box": true
   }, composerBoxFileDragAttrs, {
@@ -1175,7 +1218,7 @@ export var Composer = /*#__PURE__*/forwardRef(function Composer(_ref, ref) {
     onDragOver: handleComposerDragOver,
     onDragLeave: handleComposerDragLeave,
     onDrop: handleComposerDrop
-  }), !isInlineLite && /*#__PURE__*/React.createElement(Tooltip, {
+  }), triggerMenu, showExpandBtn && /*#__PURE__*/React.createElement(Tooltip, {
     popup: fullExpandLabel,
     placement: "top"
   }, /*#__PURE__*/React.createElement("button", {

package/dist/composer/style/index.css

@@ -31,6 +31,11 @@
   --odn-composer-expand-control-offset: 38px;
 }
 
+/* 满 10 行或溢出后缩放按钮隐藏，右上角不必再给按钮留位。 */
+[data-odn-composer][data-odn-composer-height-cap] {
+  --odn-composer-expand-control-offset: 6px;
+}
+
 [data-odn-composer-box] {
   position: relative;
   display: flex;
@@ -168,7 +173,7 @@
   padding-bottom: 42px;
 }
 
-/* ─────────── scrollbar 显隐控制（lite 三重保险） ───────────
+/* ─────────── scrollbar 显隐控制 ───────────
  * base-ui 的 ScrollArea autohide 默认在 root hover / scrolling 时会把
  * [data-hovering] / [data-scrolling] 标到 Scrollbar 上，opacity 切到 1，
  * 那条灰色 thumb 就显出来。这是 ScrollArea 的预设行为，对 chat composer
@@ -180,13 +185,13 @@
  *   3. thumb 背景透明（即便前两条都被压，看到的也是空 div）
  *
  * 触顶（atmax）时三条全部回滚，由 ScrollArea autohide 接管。 */
-[data-odn-composer][data-odn-composer-variant=lite] [data-odn-scroll-area-scrollbar] {
+[data-odn-composer]:not([data-odn-composer-atmax]) [data-odn-scroll-area-scrollbar] {
   display: none !important;
   opacity: 0 !important;
   pointer-events: none !important;
 }
 
-[data-odn-composer][data-odn-composer-variant=lite] [data-odn-scroll-area-thumb] {
+[data-odn-composer]:not([data-odn-composer-atmax]) [data-odn-scroll-area-thumb] {
   background-color: transparent !important;
 }
 
@@ -194,20 +199,20 @@
  * 不能用 `revert` —— revert 跳过整个 author origin，连 ODN ScrollArea
  * 的 `opacity: 0` / thumb `background-color: var(--odn-scrollbar-...)`
  * 都会被擦掉，结果是 thumb 元素存在但没颜色（看不到 bar）。 */
-[data-odn-composer][data-odn-composer-variant=lite][data-odn-composer-atmax] [data-odn-scroll-area-scrollbar] {
+[data-odn-composer][data-odn-composer-atmax] [data-odn-scroll-area-scrollbar] {
   display: flex !important;
   opacity: 0 !important;
   pointer-events: none !important;
   transition: opacity 0.18s ease;
 }
 
-[data-odn-composer][data-odn-composer-variant=lite][data-odn-composer-atmax] [data-odn-scroll-area-scrollbar][data-hovering],
-[data-odn-composer][data-odn-composer-variant=lite][data-odn-composer-atmax] [data-odn-scroll-area-scrollbar][data-scrolling] {
+[data-odn-composer][data-odn-composer-atmax] [data-odn-scroll-area-scrollbar][data-hovering],
+[data-odn-composer][data-odn-composer-atmax] [data-odn-scroll-area-scrollbar][data-scrolling] {
   opacity: 1 !important;
   pointer-events: auto !important;
 }
 
-[data-odn-composer][data-odn-composer-variant=lite][data-odn-composer-atmax] [data-odn-scroll-area-thumb] {
+[data-odn-composer][data-odn-composer-atmax] [data-odn-scroll-area-thumb] {
   background-color: var(--odn-scrollbar-background-color) !important;
 }
 
@@ -225,6 +230,7 @@
   flex: 1 1 auto;
   min-height: 0;
   overflow: hidden;
+  max-height: 242px;
 }
 
 [data-odn-composer] [data-odn-composer-editor] {
@@ -509,5 +515,6 @@ p[data-odn-composer-hint] {
 
 [data-odn-composer][data-odn-composer-full-expanded] [data-odn-composer-box] {
   box-sizing: border-box;
-  min-height: 50vh;
+  /* 拉到当前上限：10 行盒高 302px（242 编辑器 + 60 chrome）与 50vh 取小。 */
+  min-height: min(302px, 50vh);
 }

package/dist/composer/utils.d.ts

@@ -101,7 +101,7 @@ export declare function isEditorEmpty(editor: HTMLElement, chipIdAttr?: string):
  * 之后空 text / chip 前 leading br 的清理逻辑不变（TreeWalker / querySelectorAll
  * 在 line div 内部一样工作）。
  */
-export declare function normalizeEditorDom(editor: HTMLElement, _chipIdAttr?: string): void;
+export declare function normalizeEditorDom(editor: HTMLElement): void;
 export interface TriggerProbe {
     /** 触发字符 */
     trigger: string;
@@ -117,3 +117,15 @@ export interface TriggerProbe {
 export declare function probeTrigger(range: Range, triggers: readonly string[], 
 /** caret 与触发字符之间允许的最大 query 字符数；默认 50 */
 maxQueryLen?: number): TriggerProbe | null;
+/** 按 trigger query 做 label 子串匹配（忽略大小写）。query 为空则返回原列表。 */
+export declare function filterSkillsByQuery<T extends {
+    label: string;
+}>(items: T[], query?: string | null): T[];
+/** `/` 技能菜单只在「有可选中的过滤结果」时打开；空匹配不应拦截 Enter。 */
+export declare function shouldOpenSlashTriggerMenu(trigger: string | null | undefined, hitCount: number): boolean;
+/** 技能菜单比 composer box 左右各缩 12px。 */
+export declare const COMPOSER_SKILL_MENU_INSET_PX = 24;
+/** box 尚未量到宽度时的兜底（与旧默认对齐）。 */
+export declare const COMPOSER_SKILL_MENU_FALLBACK_WIDTH = 260;
+/** 未显式传 menuWidth 时，菜单比 composer box 略窄。 */
+export declare function resolveComposerSkillMenuWidth(explicit: number | undefined, boxWidth: number): number;

package/dist/composer/utils.js

@@ -294,6 +294,11 @@ export function getPlainText(editor) {
   }
   return out;
 }
+var kebab = function kebab(s) {
+  return s.replace(/[A-Z]/g, function (m) {
+    return "-".concat(m.toLowerCase());
+  });
+};
 
 /**
  * editor 是否为完全空（无 chip + 文本剔除 ZWSP / 换行后为空）。
@@ -310,16 +315,6 @@ export function isEditorEmpty(editor) {
   // 仅过滤换行符（contenteditable 默认 <br> 单独存在时 textContent 是 '\n'，视觉仍为空）
   return text.replace(/\n/g, '') === '';
 }
-var kebab = function kebab(s) {
-  return s.replace(/[A-Z]/g, function (m) {
-    return "-".concat(m.toLowerCase());
-  });
-};
-var makeIsHost = function makeIsHost(chipIdAttr) {
-  return function (el) {
-    return el instanceof HTMLElement && el.dataset[chipIdAttr] !== undefined;
-  };
-};
 
 /* ────────────────────────────────────────────────────────────────────
  * DOM 不变量 · chip 后 ZWSP 锚点 + 行首占位清理
@@ -338,7 +333,6 @@ var makeIsHost = function makeIsHost(chipIdAttr) {
  * 在 line div 内部一样工作）。
  */
 export function normalizeEditorDom(editor) {
-  var _chipIdAttr = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : 'mentionId';
   ensureLineRoots(editor);
   var emptyTexts = [];
   var orphanAnchorTexts = [];
@@ -491,4 +485,32 @@ export function probeTrigger(range, triggers) {
     triggerOffset: triggerOffset,
     caretOffset: caret
   };
+}
+
+/** 按 trigger query 做 label 子串匹配（忽略大小写）。query 为空则返回原列表。 */
+export function filterSkillsByQuery(items, query) {
+  var q = query === null || query === void 0 ? void 0 : query.trim().toLowerCase();
+  if (!q) return items;
+  return items.filter(function (s) {
+    return s.label.toLowerCase().includes(q);
+  });
+}
+
+/** `/` 技能菜单只在「有可选中的过滤结果」时打开；空匹配不应拦截 Enter。 */
+export function shouldOpenSlashTriggerMenu(trigger, hitCount) {
+  return trigger === '/' && hitCount > 0;
+}
+
+/** 技能菜单比 composer box 左右各缩 12px。 */
+export var COMPOSER_SKILL_MENU_INSET_PX = 24;
+/** box 尚未量到宽度时的兜底（与旧默认对齐）。 */
+export var COMPOSER_SKILL_MENU_FALLBACK_WIDTH = 260;
+
+/** 未显式传 menuWidth 时，菜单比 composer box 略窄。 */
+export function resolveComposerSkillMenuWidth(explicit, boxWidth) {
+  if (explicit !== undefined) return explicit;
+  if (boxWidth > COMPOSER_SKILL_MENU_INSET_PX) {
+    return Math.round(boxWidth - COMPOSER_SKILL_MENU_INSET_PX);
+  }
+  return COMPOSER_SKILL_MENU_FALLBACK_WIDTH;
 }

package/dist/index.d.ts

@@ -58,7 +58,7 @@ export { APPROVAL_DEFAULT_ACTIONS_HINT, default as Approval, type ApprovalDecisi
 export { ARTIFACT_DEDICATED_FILE_ICON_TYPES, ARTIFACT_FILE_GLOW_COLORS, ARTIFACT_FILE_ICON_TYPES, default as Artifact, ArtifactFileIcon, getArtifactAction, getArtifactActionFromKind, getArtifactGlowColor, type ArtifactAction, type ArtifactActionKind, type ArtifactFileIconProps, type ArtifactFileIconSize, type ArtifactFileIconType, type ArtifactProps, type ArtifactSize, } from './artifact';
 export { default as Attachments, type AttachmentsProps } from './attachments';
 export { default as ChatItem, formatRelativeTime, type ChatItemProps, } from './chat-item';
-export { default as ChatList, matchChatListFilterTime, matchChatListFilterType, type ChatListFilterTime, type ChatListFilterType, type ChatListItem, type ChatListProps, } from './chat-list';
+export { default as ChatList, matchChatListFilterStatus, matchChatListFilterTime, matchChatListFilterType, type ChatListFilterStatus, type ChatListFilterTime, type ChatListFilterType, type ChatListItem, type ChatListProps, } from './chat-list';
 export { CLARIFY_DOCK_MAX_OPTIONS, CLARIFY_DOCK_SKIPPED_LABEL, CLARIFY_DOCK_SKIPPED_VALUE, ClarifyDockPanel, ClarifyDockTrigger, clarifyDockLayoutId, parseClarifyBoundDate, toISODate, useClarifyDockState, type ClarifyDockAnswerItem, type ClarifyDockHostMessage, type ClarifyDockMessageState, type ClarifyDockPanelProps, type ClarifyDockQuestion, type ClarifyDockResolvePayload, type ClarifyDockSpec, type ClarifyDockState, type ClarifyDockTriggerProps, type ClarifyInput, type ClarifyOption, } from './clarify-dock';
 export { default as CodeBlock, type CodeBlockProps } from './code-block';
 export { default as Composer, type ComposerProps, type ComposerRef, type ComposerSkillSlotProps, type ComposerTool, type ComposerToolConfig, } from './composer';

package/dist/index.js

@@ -64,7 +64,7 @@ export { APPROVAL_DEFAULT_ACTIONS_HINT, default as Approval } from "./approval";
 export { ARTIFACT_DEDICATED_FILE_ICON_TYPES, ARTIFACT_FILE_GLOW_COLORS, ARTIFACT_FILE_ICON_TYPES, default as Artifact, ArtifactFileIcon, getArtifactAction, getArtifactActionFromKind, getArtifactGlowColor } from "./artifact";
 export { default as Attachments } from "./attachments";
 export { default as ChatItem, formatRelativeTime } from "./chat-item";
-export { default as ChatList, matchChatListFilterTime, matchChatListFilterType } from "./chat-list";
+export { default as ChatList, matchChatListFilterStatus, matchChatListFilterTime, matchChatListFilterType } from "./chat-list";
 export { CLARIFY_DOCK_MAX_OPTIONS, CLARIFY_DOCK_SKIPPED_LABEL, CLARIFY_DOCK_SKIPPED_VALUE, ClarifyDockPanel, ClarifyDockTrigger, clarifyDockLayoutId, parseClarifyBoundDate, toISODate, useClarifyDockState } from "./clarify-dock";
 export { default as CodeBlock } from "./code-block";
 export { default as Composer } from "./composer";

package/dist/skill-slot/index.d.ts

@@ -24,15 +24,16 @@ export interface SkillSlotProps {
     value?: string | null;
     onSelect?: (skill: SkillItem) => void;
     /**
-     * 技能管理回调。提供后 menu 变体会在列表底部渲染按钮。
-     * 按钮内容默认显示「技能管理」文字 + 右箭头图标。
+     * 技能管理回调。提供后 menu 变体渲染「技能管理」按钮：
+     * 有搜索栏时在搜索行最右侧 hug，无搜索时仍在列表底部。
+     * 按钮内容默认左侧管理 icon +「技能管理」文字。
      * （`skillManageFooter` 为非推荐逃生舱，见该 prop 注释。）
      */
     onManageSkills?: () => void;
     /**
      * 技能管理按钮的自定义内容（ReactNode）。
      * 仅在 `onManageSkills` 提供且 `variant='menu'` 时生效。
-     * 不传时默认渲染「技能管理」文字 + 右箭头图标。
+     * 不传时默认渲染左侧管理 icon +「技能管理」文字。
      * 非推荐：徽标 / 待处理数等业务状态应留在技能管理，勿经此槽塞进选 skill 菜单。
      */
     skillManageFooter?: React.ReactNode;