one-design-next 0.0.11 → 0.0.13

package/dist/composer/index.js

@@ -13,12 +13,14 @@ function _arrayWithHoles(arr) { if (Array.isArray(arr)) return arr; }
 import { useState, useRef, useCallback, useEffect, useLayoutEffect, useMemo, forwardRef, useImperativeHandle } from 'react';
 import HoverFill from "../hover-fill";
 import Icon from "../icon";
+import Image from "../image";
 import Popover from "../popover";
 import Attachments from "../attachments";
 import { Message } from "../message";
 import SkillSlot from "../skill-slot";
 import useControlledState from "../_util/useControlledState";
 import { ComposerEditor } from "./editor";
+import { buildSendMetaFromChips } from "./send-meta";
 import { stripMarkers } from "./utils";
 import "./style";
 var TOOL_BTN_ACTIVE = 'color-mix(in srgb, var(--odn-color-cyan-5) 10%, transparent)';
@@ -32,6 +34,8 @@ export var Composer = /*#__PURE__*/forwardRef(function Composer(_ref, ref) {
     onStop = _ref.onStop,
     _ref$isGenerating = _ref.isGenerating,
     isGenerating = _ref$isGenerating === void 0 ? false : _ref$isGenerating,
+    _ref$disabled = _ref.disabled,
+    disabled = _ref$disabled === void 0 ? false : _ref$disabled,
     _ref$placeholder = _ref.placeholder,
     placeholder = _ref$placeholder === void 0 ? '发送消息…' : _ref$placeholder,
     _ref$spacing = _ref.spacing,
@@ -48,57 +52,67 @@ export var Composer = /*#__PURE__*/forwardRef(function Composer(_ref, ref) {
     _ref$submitType = _ref.submitType,
     submitType = _ref$submitType === void 0 ? 'enter' : _ref$submitType,
     onEnter = _ref.onEnter,
+    attachmentsProp = _ref.attachments,
+    onAttachmentsChange = _ref.onAttachmentsChange,
+    onAttachFiles = _ref.onAttachFiles,
+    onAttachmentRemove = _ref.onAttachmentRemove,
+    _ref$attachmentsDisab = _ref.attachmentsDisabled,
+    attachmentsDisabled = _ref$attachmentsDisab === void 0 ? false : _ref$attachmentsDisab,
+    _ref$maxFileCount = _ref.maxFileCount,
+    maxFileCount = _ref$maxFileCount === void 0 ? 5 : _ref$maxFileCount,
+    _ref$maxFileSize = _ref.maxFileSize,
+    maxFileSize = _ref$maxFileSize === void 0 ? 20 * 1024 * 1024 : _ref$maxFileSize,
     className = _ref.className,
     style = _ref.style;
   var _useControlledState = useControlledState(defaultValue, valueProp),
     _useControlledState2 = _slicedToArray(_useControlledState, 2),
     text = _useControlledState2[0],
     setText = _useControlledState2[1];
-  var _useState = useState([]),
+  var _useControlledState3 = useControlledState([], attachmentsProp),
+    _useControlledState4 = _slicedToArray(_useControlledState3, 2),
+    attachments = _useControlledState4[0],
+    setAttachments = _useControlledState4[1];
+  var _useState = useState(false),
     _useState2 = _slicedToArray(_useState, 2),
-    attachments = _useState2[0],
-    setAttachments = _useState2[1];
-  var _useState3 = useState(false),
-    _useState4 = _slicedToArray(_useState3, 2),
-    webSearch = _useState4[0],
-    setWebSearch = _useState4[1];
+    webSearch = _useState2[0],
+    setWebSearch = _useState2[1];
   /**
    * 工具栏「技能」按钮触发的 menu 显隐。
    * 跟 trigger 触发的 menu 共用 SkillSlot 渲染，但 anchor / 关闭路径不同。
    */
-  var _useState5 = useState(false),
-    _useState6 = _slicedToArray(_useState5, 2),
-    toolMenuOpen = _useState6[0],
-    setToolMenuOpen = _useState6[1];
+  var _useState3 = useState(false),
+    _useState4 = _slicedToArray(_useState3, 2),
+    toolMenuOpen = _useState4[0],
+    setToolMenuOpen = _useState4[1];
   /**
    * editor 内 `@` / `/` 触发态的实时信号。null 表示无活动 trigger。
    * 由 editor 的 onTriggerChange 写入；选定 chip 或 cancelTrigger 后置 null。
    */
-  var _useState7 = useState(null),
-    _useState8 = _slicedToArray(_useState7, 2),
-    triggerInfo = _useState8[0],
-    setTriggerInfo = _useState8[1];
+  var _useState5 = useState(null),
+    _useState6 = _slicedToArray(_useState5, 2),
+    triggerInfo = _useState6[0],
+    setTriggerInfo = _useState6[1];
   /** trigger 浮层内键盘高亮项 index；query 变化或 menu 关闭时复位 0。 */
-  var _useState9 = useState(0),
-    _useState10 = _slicedToArray(_useState9, 2),
-    triggerActiveIndex = _useState10[0],
-    setTriggerActiveIndex = _useState10[1];
+  var _useState7 = useState(0),
+    _useState8 = _slicedToArray(_useState7, 2),
+    triggerActiveIndex = _useState8[0],
+    setTriggerActiveIndex = _useState8[1];
   /** lite 模式下由单行升格到多行布局；粘性：只在 text 清空时复位 */
-  var _useState11 = useState(false),
-    _useState12 = _slicedToArray(_useState11, 2),
-    expanded = _useState12[0],
-    setExpanded = _useState12[1];
+  var _useState9 = useState(false),
+    _useState10 = _slicedToArray(_useState9, 2),
+    expanded = _useState10[0],
+    setExpanded = _useState10[1];
   /** ComposerEditor 反馈的 editor 自然高度（offsetHeight，未 clamp），用于 lite 升格判断 */
-  var _useState13 = useState(0),
-    _useState14 = _slicedToArray(_useState13, 2),
-    editorHeight = _useState14[0],
-    setEditorHeight = _useState14[1];
+  var _useState11 = useState(0),
+    _useState12 = _slicedToArray(_useState11, 2),
+    editorHeight = _useState12[0],
+    setEditorHeight = _useState12[1];
   /** editor 内容是否真正达到 maxRows 触顶——配合 SCSS 控制 viewport overflow，
    *  阻止升格 transition / 换行未触顶时的 scrollbar 闪现 */
-  var _useState15 = useState(false),
-    _useState16 = _slicedToArray(_useState15, 2),
-    atMax = _useState16[0],
-    setAtMax = _useState16[1];
+  var _useState13 = useState(false),
+    _useState14 = _slicedToArray(_useState13, 2),
+    atMax = _useState14[0],
+    setAtMax = _useState14[1];
   var fileInputRef = useRef(null);
   var editorRef = useRef(null);
 
@@ -127,7 +141,7 @@ export var Composer = /*#__PURE__*/forwardRef(function Composer(_ref, ref) {
           skillId: skill.id,
           label: skill.label,
           icon: skill.icon,
-          kind: 'skill'
+          kind: 'invocation'
         };
         (_editorRef$current4 = editorRef.current) === null || _editorRef$current4 === void 0 || _editorRef$current4.insertChip(data);
         (_editorRef$current5 = editorRef.current) === null || _editorRef$current5 === void 0 || _editorRef$current5.focus();
@@ -143,17 +157,34 @@ export var Composer = /*#__PURE__*/forwardRef(function Composer(_ref, ref) {
     onChangeProp === null || onChangeProp === void 0 || onChangeProp(v);
   }, [setText, onChangeProp]);
 
-  /* ---- Revoke blob URLs on unmount ---- */
-  var attachmentsRef = useRef(attachments);
-  attachmentsRef.current = attachments;
+  /* ---- Attachments controlled writer ----
+   * useControlledState 只做"value vs innerValue"合流；onAttachmentsChange 需要手动派发。
+   * 模式与上面 updateText 一致：内部 set + 对外 callback。 */
+  var updateAttachments = useCallback(function (next) {
+    setAttachments(next);
+    onAttachmentsChange === null || onAttachmentsChange === void 0 || onAttachmentsChange(next);
+  }, [setAttachments, onAttachmentsChange]);
+
+  /* ---- 内部生成的 blob url 记账 ----
+   * 仅"非受控 + 未传 onAttachFiles"路径会 createObjectURL；这些 url 由我们负责 revoke。
+   * 受控模式下，attachments 里的 url 归业务方所有（如企点 / OSS 云端 url），不能被组件 revoke。
+   * 用 Set 当账本，删除/卸载时按 has 判断是否动手。 */
+  var internalBlobUrlsRef = useRef(new Set());
   useEffect(function () {
     return function () {
-      attachmentsRef.current.forEach(function (a) {
-        if (a.url) URL.revokeObjectURL(a.url);
+      internalBlobUrlsRef.current.forEach(function (url) {
+        return URL.revokeObjectURL(url);
       });
+      internalBlobUrlsRef.current.clear();
     };
   }, []);
 
+  /* ---- 受控模式校验：受控但没接 onAttachFiles 时，组件无路径塞文件进 attachments ---- */
+  if (process.env.NODE_ENV !== 'production' && attachmentsProp !== undefined && !onAttachFiles) {
+    // eslint-disable-next-line no-console
+    console.warn('[Composer] 检测到受控 attachments，但未提供 onAttachFiles。' + '内置文件入口（按钮 / 拖入 / 粘贴）将无法把文件写入 attachments。' + '若需让用户继续添加附件，请传入 onAttachFiles 接管 File → Attachment 转换。');
+  }
+
   /* ---- lite 升格判断 ----
    * 基准 32px = lite 单行 SCSS 锁定的 min-height（与 ComposerEditor minRows=1
    * 算出的 minHeightPx 一致）。直接用常量当基准，不依赖 ResizeObserver 第一次
@@ -181,34 +212,45 @@ export var Composer = /*#__PURE__*/forwardRef(function Composer(_ref, ref) {
   /* ---- Send ----
    * 内部 text 是 raw value（chip 序列化为不可见 marker 字符）。对外 onSend：
    * - text 给 stripMarkers 之后的纯文本（旧业务收到的字符串保持纯净）
-   * - chips 从 editor.getChips() 拿，按 DOM 顺序，业务方按 kind 自行分类
-   *   （BREAKING from v0.0.x：取代 meta.skill 单值字段） */
+   * - invocations / mentions 从 editor.getChips() 经 buildSendMetaFromChips 拆分；
+   *   chips 仍双写（deprecated）
+   *
+   * 发送后内部状态全部清空：text、attachments、webSearch——与 ChatGPT / Claude /
+   * iMessage 等业界对话产品一致。attachments 不 revoke blob URL：业务方在 onSend
+   * 回调里可能仍持有 url（消息记录、本地预览等），由消费方负责回收。 */
   var handleSend = useCallback(function () {
-    var _editorRef$current$ge, _editorRef$current7;
+    var _editorRef$current$ge, _editorRef$current7, _editorRef$current8;
+    if (disabled) return;
     var plain = stripMarkers(text).trim();
     if (!plain && attachments.length === 0) return;
     var chips = (_editorRef$current$ge = (_editorRef$current7 = editorRef.current) === null || _editorRef$current7 === void 0 ? void 0 : _editorRef$current7.getChips()) !== null && _editorRef$current$ge !== void 0 ? _editorRef$current$ge : [];
-    var meta = {
+    var meta = buildSendMetaFromChips(chips, {
       attachments: attachments.length > 0 ? attachments : undefined,
-      webSearch: webSearch || undefined,
-      chips: chips.length > 0 ? chips : undefined
-    };
+      webSearch: webSearch || undefined
+    });
     onSend(plain, meta);
+    (_editorRef$current8 = editorRef.current) === null || _editorRef$current8 === void 0 || _editorRef$current8.clear();
+    setAttachments([]);
+    setWebSearch(false);
   }, [text, attachments, webSearch, onSend]);
 
-  /* ---- File upload ---- */
-  var MAX_FILE_SIZE = 20 * 1024 * 1024;
-  var MAX_FILE_COUNT = 5;
-
-  /** 从选择器 / 粘贴 / 拖放等入口并入附件，沿用与 file input 相同的数量与体积规则。 */
+  /* ---- File upload ----
+   * 三入口（按钮 / 拖入 / 粘贴）共用此函数。先做内置校验（数量、单文件体积、重名），
+   * 再分两条路径派发：
+   * - 传了 onAttachFiles：把通过校验的原生 File[] 交给业务方，组件不再 createObjectURL，
+   *   也不入栈。业务方负责上传并通过 onAttachmentsChange 回写 attachments。
+   * - 未传 onAttachFiles：沿用旧路径（createObjectURL → updateAttachments），保持
+   *   demo 与历史业务零改动。生成的 blob url 记入 internalBlobUrlsRef，仅这些会被
+   *   组件 revoke。 */
   var addFilesFromList = useCallback(function (fileArray) {
+    if (disabled || attachmentsDisabled) return;
     if (fileArray.length === 0) return;
-    var remaining = MAX_FILE_COUNT - attachments.length;
+    var remaining = maxFileCount - attachments.length;
     if (remaining <= 0) {
-      Message.warning('至多支持添加 5 个文件');
+      Message.warning("\u81F3\u591A\u652F\u6301\u6DFB\u52A0 ".concat(maxFileCount, " \u4E2A\u6587\u4EF6"));
       return;
     }
-    var accepted = [];
+    var acceptedFiles = [];
     var oversized = 0;
     var duplicated = 0;
     var overCount = 0;
@@ -217,28 +259,23 @@ export var Composer = /*#__PURE__*/forwardRef(function Composer(_ref, ref) {
     try {
       var _loop = function _loop() {
           var f = _step.value;
-          if (accepted.length >= remaining) {
+          if (acceptedFiles.length >= remaining) {
             overCount++;
             return 0; // continue
           }
-          if (f.size > MAX_FILE_SIZE) {
+          if (f.size > maxFileSize) {
             oversized++;
             return 0; // continue
           }
           if (attachments.some(function (a) {
             return a.name === f.name && a.size === f.size;
-          }) || accepted.some(function (a) {
-            return a.name === f.name && a.size === f.size;
+          }) || acceptedFiles.some(function (af) {
+            return af.name === f.name && af.size === f.size;
           })) {
             duplicated++;
             return 0; // continue
           }
-          accepted.push({
-            name: f.name,
-            type: f.type,
-            size: f.size,
-            url: URL.createObjectURL(f)
-          });
+          acceptedFiles.push(f);
         },
         _ret;
       for (_iterator.s(); !(_step = _iterator.n()).done;) {
@@ -250,32 +287,48 @@ export var Composer = /*#__PURE__*/forwardRef(function Composer(_ref, ref) {
     } finally {
       _iterator.f();
     }
-    if (oversized > 0) Message.warning('文件大小至多为 20MB');
+    var sizeLabel = "".concat(Math.round(maxFileSize / 1024 / 1024), "MB");
+    if (oversized > 0) Message.warning("\u6587\u4EF6\u5927\u5C0F\u81F3\u591A\u4E3A ".concat(sizeLabel));
     if (duplicated > 0) Message.warning('请不要重复添加文件');
-    if (overCount > 0) Message.warning('至多支持添加 5 个文件');
-    if (accepted.length > 0) setAttachments(function (prev) {
-      return [].concat(_toConsumableArray(prev), accepted);
+    if (overCount > 0) Message.warning("\u81F3\u591A\u652F\u6301\u6DFB\u52A0 ".concat(maxFileCount, " \u4E2A\u6587\u4EF6"));
+    if (acceptedFiles.length === 0) return;
+    if (onAttachFiles) {
+      onAttachFiles(acceptedFiles);
+      return;
+    }
+    var accepted = acceptedFiles.map(function (f) {
+      var url = URL.createObjectURL(f);
+      internalBlobUrlsRef.current.add(url);
+      return {
+        name: f.name,
+        type: f.type,
+        size: f.size,
+        url: url
+      };
     });
-  }, [attachments]);
+    updateAttachments([].concat(_toConsumableArray(attachments), _toConsumableArray(accepted)));
+  }, [attachments, attachmentsDisabled, disabled, maxFileCount, maxFileSize, onAttachFiles, updateAttachments]);
   var handleFileChange = function handleFileChange(e) {
     var files = e.target.files;
     if (!files) return;
     addFilesFromList(Array.from(files));
     e.target.value = '';
   };
-  var _useState17 = useState(false),
-    _useState18 = _slicedToArray(_useState17, 2),
-    fileDragOver = _useState18[0],
-    setFileDragOver = _useState18[1];
+  var _useState15 = useState(false),
+    _useState16 = _slicedToArray(_useState15, 2),
+    fileDragOver = _useState16[0],
+    setFileDragOver = _useState16[1];
   var composerBoxFileDragAttrs = fileDragOver ? {
     'data-odn-composer-file-drag': ''
   } : {};
   var handleComposerDragEnter = function handleComposerDragEnter(e) {
     e.preventDefault();
+    if (disabled || attachmentsDisabled) return;
     if (!_toConsumableArray(e.dataTransfer.types).includes('Files')) return;
     setFileDragOver(true);
   };
   var handleComposerDragOver = function handleComposerDragOver(e) {
+    if (disabled || attachmentsDisabled) return;
     if (!_toConsumableArray(e.dataTransfer.types).includes('Files')) return;
     e.preventDefault();
     e.dataTransfer.dropEffect = 'copy';
@@ -288,6 +341,7 @@ export var Composer = /*#__PURE__*/forwardRef(function Composer(_ref, ref) {
     var _dt$files;
     e.preventDefault();
     setFileDragOver(false);
+    if (disabled || attachmentsDisabled) return;
     var dt = e.dataTransfer;
     if (!((_dt$files = dt.files) !== null && _dt$files !== void 0 && _dt$files.length)) return;
     addFilesFromList(Array.from(dt.files));
@@ -303,17 +357,17 @@ export var Composer = /*#__PURE__*/forwardRef(function Composer(_ref, ref) {
       skillId: skill.id,
       label: skill.label,
       icon: skill.icon,
-      kind: 'skill'
+      kind: 'invocation'
     };
     if (source === 'trigger') {
-      var _editorRef$current8;
-      (_editorRef$current8 = editorRef.current) === null || _editorRef$current8 === void 0 || _editorRef$current8.replaceTriggerWithChip(data);
+      var _editorRef$current9;
+      (_editorRef$current9 = editorRef.current) === null || _editorRef$current9 === void 0 || _editorRef$current9.replaceTriggerWithChip(data);
       setTriggerInfo(null);
     } else {
-      var _editorRef$current9, _editorRef$current10;
-      (_editorRef$current9 = editorRef.current) === null || _editorRef$current9 === void 0 || _editorRef$current9.insertChip(data);
+      var _editorRef$current10, _editorRef$current11;
+      (_editorRef$current10 = editorRef.current) === null || _editorRef$current10 === void 0 || _editorRef$current10.insertChip(data);
       setToolMenuOpen(false);
-      (_editorRef$current10 = editorRef.current) === null || _editorRef$current10 === void 0 || _editorRef$current10.focus();
+      (_editorRef$current11 = editorRef.current) === null || _editorRef$current11 === void 0 || _editorRef$current11.focus();
     }
   }, []);
 
@@ -363,9 +417,9 @@ export var Composer = /*#__PURE__*/forwardRef(function Composer(_ref, ref) {
       return true;
     }
     if (e.key === 'Escape') {
-      var _editorRef$current11;
+      var _editorRef$current12;
       e.preventDefault();
-      (_editorRef$current11 = editorRef.current) === null || _editorRef$current11 === void 0 || _editorRef$current11.cancelTrigger();
+      (_editorRef$current12 = editorRef.current) === null || _editorRef$current12 === void 0 || _editorRef$current12.cancelTrigger();
       setTriggerInfo(null);
       return true;
     }
@@ -396,22 +450,31 @@ export var Composer = /*#__PURE__*/forwardRef(function Composer(_ref, ref) {
     console.warn("[Composer] variant=\"lite\" \u4EC5\u652F\u6301\u4E00\u4E2A\u5DE5\u5177\u6309\u94AE\uFF0C\u5DF2\u5FFD\u7565\u5176\u4F59 ".concat(tools.length - 1, " \u4E2A\u3002\u82E5\u9700\u8981\u591A\u4E2A\u5DE5\u5177\u6309\u94AE\uFF0C\u8BF7\u4F7F\u7528 variant=\"full\"\u3002"));
   }
 
-  /* ---- Tool buttons ---- */
+  /* ---- Tool buttons ----
+   * disabled（整体禁用）合并到各按钮的 disabled 状态：
+   * - attachment：disabled || attachmentsDisabled
+   * - webSearch / skill：disabled（attachmentsDisabled 不影响这两个）
+   * skill 的 Popover 在 disabled 时禁用 trigger，避免弹出菜单。 */
   var renderAttachmentBtn = function renderAttachmentBtn() {
+    var btnDisabled = disabled || attachmentsDisabled;
     return /*#__PURE__*/React.createElement(HoverFill, {
       key: "attachment",
       "data-odn-composer-tool-btn-wrap": true,
       bgClassName: "odn-composer-tool-btn-bg",
-      activeColor: TOOL_BTN_ACTIVE
+      activeColor: TOOL_BTN_ACTIVE,
+      disabled: btnDisabled
     }, /*#__PURE__*/React.createElement("button", {
       type: "button",
       onClick: function onClick() {
         var _fileInputRef$current;
         return (_fileInputRef$current = fileInputRef.current) === null || _fileInputRef$current === void 0 ? void 0 : _fileInputRef$current.click();
       },
+      disabled: btnDisabled,
       "data-odn-composer-tool-btn": true,
       "data-odn-composer-tool-iconic": !effectiveLabeled || undefined,
+      "data-odn-composer-tool-disabled": btnDisabled || undefined,
       "aria-label": "\u9644\u4EF6",
+      "aria-disabled": btnDisabled || undefined,
       title: effectiveLabeled ? undefined : '附件'
     }, /*#__PURE__*/React.createElement(Icon, {
       name: "paperclip",
@@ -424,7 +487,7 @@ export var Composer = /*#__PURE__*/forwardRef(function Composer(_ref, ref) {
       "data-odn-composer-tool-btn-wrap": true,
       bgClassName: "odn-composer-tool-btn-bg",
       activeColor: TOOL_BTN_ACTIVE,
-      disabled: webSearch
+      disabled: disabled || webSearch
     }, /*#__PURE__*/React.createElement("button", {
       type: "button",
       onClick: function onClick() {
@@ -432,11 +495,14 @@ export var Composer = /*#__PURE__*/forwardRef(function Composer(_ref, ref) {
           return !v;
         });
       },
+      disabled: disabled,
       "data-odn-composer-tool-btn": true,
       "data-odn-composer-tool-iconic": !effectiveLabeled || undefined,
       "data-odn-composer-tool-active": webSearch || undefined,
+      "data-odn-composer-tool-disabled": disabled || undefined,
       "aria-label": "\u8054\u7F51",
       "aria-pressed": webSearch,
+      "aria-disabled": disabled || undefined,
       title: effectiveLabeled ? undefined : '联网'
     }, /*#__PURE__*/React.createElement(Icon, {
       name: "globe",
@@ -451,8 +517,11 @@ export var Composer = /*#__PURE__*/forwardRef(function Composer(_ref, ref) {
       arrowed: false,
       placement: "topLeft",
       offset: 4,
-      visible: toolMenuOpen,
-      onVisibleChange: setToolMenuOpen,
+      visible: !disabled && toolMenuOpen,
+      onVisibleChange: function onVisibleChange(v) {
+        if (disabled) return;
+        setToolMenuOpen(v);
+      },
       popupClassName: "odn-composer-skill-popup",
       popup: /*#__PURE__*/React.createElement(SkillSlot, {
         variant: "menu",
@@ -465,13 +534,16 @@ export var Composer = /*#__PURE__*/forwardRef(function Composer(_ref, ref) {
       "data-odn-composer-tool-btn-wrap": true,
       bgClassName: "odn-composer-tool-btn-bg",
       activeColor: TOOL_BTN_ACTIVE,
-      disabled: toolMenuOpen
+      disabled: disabled || toolMenuOpen
     }, /*#__PURE__*/React.createElement("button", {
       type: "button",
+      disabled: disabled,
       "data-odn-composer-tool-btn": true,
       "data-odn-composer-tool-iconic": !effectiveLabeled || undefined,
       "data-odn-composer-tool-active": toolMenuOpen || undefined,
+      "data-odn-composer-tool-disabled": disabled || undefined,
       "aria-label": "\u6280\u80FD",
+      "aria-disabled": disabled || undefined,
       title: effectiveLabeled ? undefined : '技能'
     }, /*#__PURE__*/React.createElement(Icon, {
       name: "puzzle",
@@ -486,22 +558,64 @@ export var Composer = /*#__PURE__*/forwardRef(function Composer(_ref, ref) {
   }).filter(Boolean);
   var hasTools = toolNodes.length > 0;
 
-  /* ---- Slots ---- */
+  /* ---- Slots ----
+   * 待发送区按 type 分流：
+   *  - 图片（image/* + url）→ Image leaf + 72×72 cover wrap，输入态用模板
+   *    驱动尺寸（整齐划一比保留长宽比要紧）
+   *  - 其他附件 → 走 Attachments，保持原 file-card 渲染
+   *
+   * 删除：按 internalBlobUrlsRef 判断是否需要 revoke，避免误 revoke 业务方
+   * 的云端 url；同时派发 onAttachmentRemove（语义钩子，便于业务调"服务端
+   * 删文件"）与 onAttachmentsChange。
+   *
+   * 分流子集与原 attachments 的 index 不一致，对外回调（onAttachmentRemove）
+   * 用 attachments.indexOf 拿到原始 index，保持业务方语义。 */
+  var isImageAttachment = function isImageAttachment(a) {
+    return a.type.startsWith('image/') && !!a.url;
+  };
+  var composerImages = attachments.filter(isImageAttachment);
+  var composerFiles = attachments.filter(function (a) {
+    return !isImageAttachment(a);
+  });
+  var removeAttachmentAt = function removeAttachmentAt(i) {
+    var removed = attachments[i];
+    if (removed !== null && removed !== void 0 && removed.url && internalBlobUrlsRef.current.has(removed.url)) {
+      URL.revokeObjectURL(removed.url);
+      internalBlobUrlsRef.current.delete(removed.url);
+    }
+    var next = attachments.filter(function (_, idx) {
+      return idx !== i;
+    });
+    if (removed) onAttachmentRemove === null || onAttachmentRemove === void 0 || onAttachmentRemove(i, removed);
+    updateAttachments(next);
+  };
   var attachmentsSlot = attachments.length > 0 ? /*#__PURE__*/React.createElement("div", {
     "data-odn-composer-attachments": true
-  }, /*#__PURE__*/React.createElement(Attachments, {
-    attachments: attachments,
+  }, composerImages.length > 0 && /*#__PURE__*/React.createElement("div", {
+    "data-odn-composer-images": true
+  }, composerImages.map(function (img) {
+    var realIdx = attachments.indexOf(img);
+    return /*#__PURE__*/React.createElement("div", {
+      key: "".concat(img.name, "-").concat(realIdx),
+      "data-odn-composer-image-thumb": true
+    }, /*#__PURE__*/React.createElement(Image, {
+      url: img.url,
+      alt: img.name,
+      onRemove: function onRemove() {
+        return removeAttachmentAt(realIdx);
+      }
+    }));
+  })), composerFiles.length > 0 && /*#__PURE__*/React.createElement(Attachments, {
+    attachments: composerFiles,
     onRemove: function onRemove(i) {
-      var removed = attachments[i];
-      if (removed !== null && removed !== void 0 && removed.url) URL.revokeObjectURL(removed.url);
-      setAttachments(function (prev) {
-        return prev.filter(function (_, idx) {
-          return idx !== i;
-        });
-      });
+      return removeAttachmentAt(attachments.indexOf(composerFiles[i]));
     }
   })) : null;
-  var sendOrStopButton = isGenerating ? /*#__PURE__*/React.createElement("button", {
+
+  /* 状态优先级：disabled > isGenerating > canSend
+   * disabled 时永远呈现发送按钮（仅置灰），不切到中止——
+   * 因为整体禁用语义包含"现在什么都不能做"，包括中断。 */
+  var sendOrStopButton = !disabled && isGenerating ? /*#__PURE__*/React.createElement("button", {
     type: "button",
     onClick: onStop,
     "data-odn-composer-stop-btn": true,
@@ -512,10 +626,10 @@ export var Composer = /*#__PURE__*/forwardRef(function Composer(_ref, ref) {
   })) : /*#__PURE__*/React.createElement("button", {
     type: "button",
     onClick: handleSend,
-    disabled: !canSend,
+    disabled: disabled || !canSend,
     "data-odn-composer-send-btn": true,
-    "data-odn-composer-send-disabled": !canSend || undefined,
-    title: "\u53D1\u9001"
+    "data-odn-composer-send-disabled": disabled || !canSend || undefined,
+    title: disabled ? undefined : '发送'
   }, /*#__PURE__*/React.createElement(Icon, {
     name: "arrow-up",
     size: 18
@@ -549,7 +663,8 @@ export var Composer = /*#__PURE__*/forwardRef(function Composer(_ref, ref) {
     },
     placeholder: placeholder,
     value: text,
-    onChange: updateText
+    onChange: updateText,
+    disabled: disabled
     /* 本轮只接 `/`，`@` 留给业务接 mention 搜索时再加 */,
     triggers: ['/'],
     onTriggerChange: setTriggerInfo,
@@ -590,8 +705,8 @@ export var Composer = /*#__PURE__*/forwardRef(function Composer(_ref, ref) {
     visible: triggerMenuVisible,
     onVisibleChange: function onVisibleChange(v) {
       if (!v) {
-        var _editorRef$current12;
-        (_editorRef$current12 = editorRef.current) === null || _editorRef$current12 === void 0 || _editorRef$current12.cancelTrigger();
+        var _editorRef$current13;
+        (_editorRef$current13 = editorRef.current) === null || _editorRef$current13 === void 0 || _editorRef$current13.cancelTrigger();
         setTriggerInfo(null);
       }
     },
@@ -624,7 +739,9 @@ export var Composer = /*#__PURE__*/forwardRef(function Composer(_ref, ref) {
     "data-odn-composer-variant": variant,
     "data-odn-composer-expanded": liteExpanded ? '' : undefined,
     "data-odn-composer-atmax": atMax ? '' : undefined,
+    "data-odn-composer-disabled": disabled || undefined,
     "data-odn-composer-spacing": spacing === 'drawer' ? 'drawer' : undefined,
+    "aria-disabled": disabled || undefined,
     className: className !== null && className !== void 0 ? className : spacing === 'drawer' ? 'shrink-0' : undefined,
     style: style
   }, /*#__PURE__*/React.createElement("div", {

package/dist/composer/inline-ref.d.ts

@@ -0,0 +1,9 @@
+/// <reference types="react" />
+import type { ChipData } from './chip';
+export declare function isMentionChip(chip: ChipData): boolean;
+export interface ComposerInlineRefProps {
+    data: ChipData;
+}
+/** Composer 内联引用视觉：按 kind 派发 Invocation（/）或 Mention（@）。 */
+export declare function ComposerInlineRef({ data }: ComposerInlineRefProps): import("react").JSX.Element;
+export default ComposerInlineRef;

package/dist/composer/inline-ref.js

@@ -0,0 +1,21 @@
+import { Invocation } from "../invocation";
+import { Mention } from "../mention";
+import { chipToInvocationData, chipToMentionData } from "./send-meta";
+export function isMentionChip(chip) {
+  return chip.kind === 'mention';
+}
+/** Composer 内联引用视觉：按 kind 派发 Invocation（/）或 Mention（@）。 */
+export function ComposerInlineRef(_ref) {
+  var data = _ref.data;
+  if (isMentionChip(data)) {
+    return /*#__PURE__*/React.createElement(Mention, {
+      data: chipToMentionData(data),
+      interactive: true
+    });
+  }
+  return /*#__PURE__*/React.createElement(Invocation, {
+    data: chipToInvocationData(data),
+    interactive: true
+  });
+}
+export default ComposerInlineRef;

package/dist/composer/send-meta.d.ts

@@ -0,0 +1,6 @@
+import type { InvocationData, MentionData, SendMeta } from '../_genui-types';
+import type { ChipData } from './chip';
+export declare function chipToInvocationData(chip: ChipData): InvocationData;
+export declare function chipToMentionData(chip: ChipData): MentionData;
+/** 从 editor chip 列表构建 SendMeta（含 invocations / mentions + chips 兼容字段）。 */
+export declare function buildSendMetaFromChips(chips: ChipData[], base?: Omit<SendMeta, 'chips' | 'invocations' | 'mentions'>): SendMeta;