one-design-next 0.0.13 → 0.0.15

package/dist/composer/index.d.ts

@@ -1,6 +1,8 @@
 /// <reference types="react" />
-import type { Attachment, SkillItem, SendMeta } from '../_genui-types';
+import type { Attachment, ComposerSegment, SkillItem, SendMeta } from '../_genui-types';
+import type { ComposerParamPanelContext } from './param-panel';
 import './style';
+export type { ComposerParamPanelContext } from './param-panel';
 export type ComposerTool = 'attachment' | 'webSearch' | 'skill';
 export type ComposerVariant = 'full' | 'lite';
 export type SubmitType = 'enter' | 'shiftEnter';
@@ -33,7 +35,15 @@ export interface ComposerProps {
     defaultValue?: string;
     /** 输入框值变化回调 */
     onChange?: (value: string) => void;
-    onSend: (text: string, meta?: SendMeta) => void;
+    /**
+     * 发送回调。
+     *
+     * `segments`：有序内容 IR，业务按数组顺序自定义拼后端。
+     * `meta`：附件 / 联网搜索等非正文数据；为空时不传。
+     *
+     * 兼容旧链路（需要单串文本）：业务可调 `segmentsToReadableText(segments)`。
+     */
+    onSend: (segments: ComposerSegment[], meta?: SendMeta) => void;
     onStop?: () => void;
     isGenerating?: boolean;
     /**
@@ -133,6 +143,11 @@ export interface ComposerProps {
      * @default 20 * 1024 * 1024（20MB）
      */
     maxFileSize?: number;
+    /**
+     * 参数面板内容渲染。提供后 invocation chip 可点击打开面板；
+     * `SkillItem.initialState='pending'` 插入后会自动打开。
+     */
+    renderParamPanel?: (ctx: ComposerParamPanelContext) => React.ReactNode;
     className?: string;
     style?: React.CSSProperties;
 }

package/dist/composer/index.js

@@ -18,14 +18,28 @@ import Popover from "../popover";
 import Attachments from "../attachments";
 import { Message } from "../message";
 import SkillSlot from "../skill-slot";
+import { InvocationParamPopover } from "../invocation/param-popover";
 import useControlledState from "../_util/useControlledState";
 import { ComposerEditor } from "./editor";
-import { buildSendMetaFromChips } from "./send-meta";
-import { stripMarkers } from "./utils";
+import { isMentionChip } from "./inline-ref";
+import { rawValueToSegments, segmentsHasContent } from "./segments";
 import "./style";
-var TOOL_BTN_ACTIVE = 'color-mix(in srgb, var(--odn-color-cyan-5) 10%, transparent)';
+function createInvocationChipData(skill) {
+  return {
+    id: "skill-".concat(skill.id, "-").concat(Date.now().toString(36), "-").concat(Math.random().toString(36).slice(2, 6)),
+    label: skill.label,
+    icon: skill.icon,
+    kind: 'invocation',
+    state: skill.initialState,
+    payload: {
+      refId: skill.id
+    }
+  };
+}
+var TOOL_BTN_ACTIVE = 'color-mix(in srgb, var(--odn-color-brand-6) 10%, transparent)';
 var DEFAULT_TOOLS = ['attachment', 'webSearch', 'skill'];
 export var Composer = /*#__PURE__*/forwardRef(function Composer(_ref, ref) {
+  var _paramEdit$chipId;
   var valueProp = _ref.value,
     _ref$defaultValue = _ref.defaultValue,
     defaultValue = _ref$defaultValue === void 0 ? '' : _ref$defaultValue,
@@ -62,6 +76,7 @@ export var Composer = /*#__PURE__*/forwardRef(function Composer(_ref, ref) {
     maxFileCount = _ref$maxFileCount === void 0 ? 5 : _ref$maxFileCount,
     _ref$maxFileSize = _ref.maxFileSize,
     maxFileSize = _ref$maxFileSize === void 0 ? 20 * 1024 * 1024 : _ref$maxFileSize,
+    renderParamPanel = _ref.renderParamPanel,
     className = _ref.className,
     style = _ref.style;
   var _useControlledState = useControlledState(defaultValue, valueProp),
@@ -115,6 +130,40 @@ export var Composer = /*#__PURE__*/forwardRef(function Composer(_ref, ref) {
     setAtMax = _useState14[1];
   var fileInputRef = useRef(null);
   var editorRef = useRef(null);
+  var boxRef = useRef(null);
+  var _useState15 = useState(null),
+    _useState16 = _slicedToArray(_useState15, 2),
+    paramEdit = _useState16[0],
+    setParamEdit = _useState16[1];
+  var openParamPanel = useCallback(function (chipId) {
+    if (!renderParamPanel) return;
+    requestAnimationFrame(function () {
+      var _editorRef$current;
+      var host = (_editorRef$current = editorRef.current) === null || _editorRef$current === void 0 ? void 0 : _editorRef$current.getChipHost(chipId);
+      if (host) setParamEdit({
+        chipId: chipId,
+        anchor: host
+      });
+    });
+  }, [renderParamPanel]);
+  var closeParamPanel = useCallback(function () {
+    setParamEdit(null);
+  }, []);
+  var handleInlineRefClick = useCallback(function (chipId, anchor) {
+    var _editorRef$current$ge, _editorRef$current2;
+    if (!renderParamPanel) return;
+    var chips = (_editorRef$current$ge = (_editorRef$current2 = editorRef.current) === null || _editorRef$current2 === void 0 ? void 0 : _editorRef$current2.getChips()) !== null && _editorRef$current$ge !== void 0 ? _editorRef$current$ge : [];
+    var chip = chips.find(function (c) {
+      return c.id === chipId;
+    });
+    if (!chip || isMentionChip(chip)) return;
+    setParamEdit(function (prev) {
+      return (prev === null || prev === void 0 ? void 0 : prev.chipId) === chipId ? null : {
+        chipId: chipId,
+        anchor: anchor
+      };
+    });
+  }, [renderParamPanel]);
 
   /* ---- ref 实例方法 ----
    * editor.clear() 内部已经会调 onChange('')，会经由 ComposerEditor 的
@@ -123,32 +172,27 @@ export var Composer = /*#__PURE__*/forwardRef(function Composer(_ref, ref) {
   useImperativeHandle(ref, function () {
     return {
       focus: function focus(options) {
-        var _editorRef$current;
-        return (_editorRef$current = editorRef.current) === null || _editorRef$current === void 0 ? void 0 : _editorRef$current.focus(options);
+        var _editorRef$current3;
+        return (_editorRef$current3 = editorRef.current) === null || _editorRef$current3 === void 0 ? void 0 : _editorRef$current3.focus(options);
       },
       blur: function blur() {
-        var _editorRef$current2;
-        return (_editorRef$current2 = editorRef.current) === null || _editorRef$current2 === void 0 ? void 0 : _editorRef$current2.blur();
+        var _editorRef$current4;
+        return (_editorRef$current4 = editorRef.current) === null || _editorRef$current4 === void 0 ? void 0 : _editorRef$current4.blur();
       },
       clear: function clear() {
-        var _editorRef$current3;
-        return (_editorRef$current3 = editorRef.current) === null || _editorRef$current3 === void 0 ? void 0 : _editorRef$current3.clear();
+        var _editorRef$current5;
+        return (_editorRef$current5 = editorRef.current) === null || _editorRef$current5 === void 0 ? void 0 : _editorRef$current5.clear();
       },
       insertSkill: function insertSkill(skill) {
-        var _editorRef$current4, _editorRef$current5;
-        var data = {
-          id: "c_".concat(Date.now(), "_").concat(Math.random().toString(36).slice(2, 6)),
-          skillId: skill.id,
-          label: skill.label,
-          icon: skill.icon,
-          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();
+        var _editorRef$current6, _editorRef$current7;
+        var data = createInvocationChipData(skill);
+        (_editorRef$current6 = editorRef.current) === null || _editorRef$current6 === void 0 || _editorRef$current6.insertChip(data);
+        (_editorRef$current7 = editorRef.current) === null || _editorRef$current7 === void 0 || _editorRef$current7.focus();
+        if (skill.initialState === 'pending') openParamPanel(data.id);
       },
       get nativeElement() {
-        var _editorRef$current$na, _editorRef$current6;
-        return (_editorRef$current$na = (_editorRef$current6 = editorRef.current) === null || _editorRef$current6 === void 0 ? void 0 : _editorRef$current6.nativeElement) !== null && _editorRef$current$na !== void 0 ? _editorRef$current$na : null;
+        var _editorRef$current$na, _editorRef$current8;
+        return (_editorRef$current$na = (_editorRef$current8 = editorRef.current) === null || _editorRef$current8 === void 0 ? void 0 : _editorRef$current8.nativeElement) !== null && _editorRef$current$na !== void 0 ? _editorRef$current$na : null;
       }
     };
   });
@@ -210,29 +254,30 @@ export var Composer = /*#__PURE__*/forwardRef(function Composer(_ref, ref) {
   }, [text, attachments.length, expanded]);
 
   /* ---- Send ----
-   * 内部 text 是 raw value（chip 序列化为不可见 marker 字符）。对外 onSend：
-   * - text 给 stripMarkers 之后的纯文本（旧业务收到的字符串保持纯净）
-   * - invocations / mentions 从 editor.getChips() 经 buildSendMetaFromChips 拆分；
-   *   chips 仍双写（deprecated）
+   * 内部 text 是 raw value（chip 序列化为零宽 marker）。
+   * 对外只有一份契约：`onSend(segments, meta?)`
+   *   - segments：有序 IR（text / invocation / mention 交替）
+   *   - meta：attachments / webSearch 等非正文数据；都为空时不传
    *
-   * 发送后内部状态全部清空：text、attachments、webSearch——与 ChatGPT / Claude /
-   * iMessage 等业界对话产品一致。attachments 不 revoke blob URL：业务方在 onSend
-   * 回调里可能仍持有 url（消息记录、本地预览等），由消费方负责回收。 */
+   * 需要单串文本的业务方在 onSend 内自行调 segmentsToReadableText。
+   * 发送后内部状态全部清空。attachments 的 blob URL 由消费方负责回收。 */
   var handleSend = useCallback(function () {
-    var _editorRef$current$ge, _editorRef$current7, _editorRef$current8;
+    var _editorRef$current$ge2, _editorRef$current9, _editorRef$current10;
     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 = buildSendMetaFromChips(chips, {
-      attachments: attachments.length > 0 ? attachments : undefined,
-      webSearch: webSearch || undefined
-    });
-    onSend(plain, meta);
-    (_editorRef$current8 = editorRef.current) === null || _editorRef$current8 === void 0 || _editorRef$current8.clear();
+    var chips = (_editorRef$current$ge2 = (_editorRef$current9 = editorRef.current) === null || _editorRef$current9 === void 0 ? void 0 : _editorRef$current9.getChips()) !== null && _editorRef$current$ge2 !== void 0 ? _editorRef$current$ge2 : [];
+    var segments = rawValueToSegments(text, chips);
+    var hasAttachments = attachments.length > 0;
+    if (!segmentsHasContent(segments) && !hasAttachments) return;
+    var meta = {};
+    if (hasAttachments) meta.attachments = attachments;
+    if (webSearch) meta.webSearch = true;
+    var hasMeta = hasAttachments || webSearch;
+    onSend(segments, hasMeta ? meta : undefined);
+    closeParamPanel();
+    (_editorRef$current10 = editorRef.current) === null || _editorRef$current10 === void 0 || _editorRef$current10.clear();
     setAttachments([]);
     setWebSearch(false);
-  }, [text, attachments, webSearch, onSend]);
+  }, [text, attachments, webSearch, onSend, disabled, closeParamPanel]);
 
   /* ---- File upload ----
    * 三入口（按钮 / 拖入 / 粘贴）共用此函数。先做内置校验（数量、单文件体积、重名），
@@ -314,10 +359,10 @@ export var Composer = /*#__PURE__*/forwardRef(function Composer(_ref, ref) {
     addFilesFromList(Array.from(files));
     e.target.value = '';
   };
-  var _useState15 = useState(false),
-    _useState16 = _slicedToArray(_useState15, 2),
-    fileDragOver = _useState16[0],
-    setFileDragOver = _useState16[1];
+  var _useState17 = useState(false),
+    _useState18 = _slicedToArray(_useState17, 2),
+    fileDragOver = _useState18[0],
+    setFileDragOver = _useState18[1];
   var composerBoxFileDragAttrs = fileDragOver ? {
     'data-odn-composer-file-drag': ''
   } : {};
@@ -352,24 +397,19 @@ export var Composer = /*#__PURE__*/forwardRef(function Composer(_ref, ref) {
    * source = 'trigger' → editor.replaceTriggerWithChip 替换 `/` + query 整段
    * 任一入口选完后都关闭对应 menu。chip data 用 skill.id + 一次性实例 id。 */
   var handleSelectSkill = useCallback(function (skill, source) {
-    var data = {
-      id: "skill-".concat(skill.id, "-").concat(Date.now().toString(36), "-").concat(Math.random().toString(36).slice(2, 6)),
-      skillId: skill.id,
-      label: skill.label,
-      icon: skill.icon,
-      kind: 'invocation'
-    };
+    var data = createInvocationChipData(skill);
     if (source === 'trigger') {
-      var _editorRef$current9;
-      (_editorRef$current9 = editorRef.current) === null || _editorRef$current9 === void 0 || _editorRef$current9.replaceTriggerWithChip(data);
+      var _editorRef$current11;
+      (_editorRef$current11 = editorRef.current) === null || _editorRef$current11 === void 0 || _editorRef$current11.replaceTriggerWithChip(data);
       setTriggerInfo(null);
     } else {
-      var _editorRef$current10, _editorRef$current11;
-      (_editorRef$current10 = editorRef.current) === null || _editorRef$current10 === void 0 || _editorRef$current10.insertChip(data);
+      var _editorRef$current12, _editorRef$current13;
+      (_editorRef$current12 = editorRef.current) === null || _editorRef$current12 === void 0 || _editorRef$current12.insertChip(data);
       setToolMenuOpen(false);
-      (_editorRef$current11 = editorRef.current) === null || _editorRef$current11 === void 0 || _editorRef$current11.focus();
+      (_editorRef$current13 = editorRef.current) === null || _editorRef$current13 === void 0 || _editorRef$current13.focus();
     }
-  }, []);
+    if (skill.initialState === 'pending') openParamPanel(data.id);
+  }, [openParamPanel]);
 
   /* trigger query 实时筛选 skills（substring match，case-insensitive）。
    * 没有 query / 没有 trigger → 返回原列表。 */
@@ -410,16 +450,16 @@ export var Composer = /*#__PURE__*/forwardRef(function Composer(_ref, ref) {
       });
       return true;
     }
-    if (e.key === 'Enter' || e.key === 'Tab') {
+    if (e.key === 'Enter' && !e.shiftKey || e.key === 'Tab') {
       e.preventDefault();
       var _skill = list === null || list === void 0 ? void 0 : list[triggerActiveIndex];
       if (_skill) handleSelectSkill(_skill, 'trigger');
       return true;
     }
     if (e.key === 'Escape') {
-      var _editorRef$current12;
+      var _editorRef$current14;
       e.preventDefault();
-      (_editorRef$current12 = editorRef.current) === null || _editorRef$current12 === void 0 || _editorRef$current12.cancelTrigger();
+      (_editorRef$current14 = editorRef.current) === null || _editorRef$current14 === void 0 || _editorRef$current14.cancelTrigger();
       setTriggerInfo(null);
       return true;
     }
@@ -538,6 +578,9 @@ export var Composer = /*#__PURE__*/forwardRef(function Composer(_ref, ref) {
     }, /*#__PURE__*/React.createElement("button", {
       type: "button",
       disabled: disabled,
+      onMouseDown: function onMouseDown(e) {
+        return e.preventDefault();
+      },
       "data-odn-composer-tool-btn": true,
       "data-odn-composer-tool-iconic": !effectiveLabeled || undefined,
       "data-odn-composer-tool-active": toolMenuOpen || undefined,
@@ -655,6 +698,31 @@ export var Composer = /*#__PURE__*/forwardRef(function Composer(_ref, ref) {
   /* trigger 浮层渲染条件：editor 处于 `/` 触发态 + 业务方传了 skills。
    * `@` 触发本轮不接（mention 数据源待业务接入），onTriggerChange 拿到也不弹。 */
   var triggerMenuVisible = !!(triggerInfo && triggerInfo.trigger === '/' && skills && skills.length > 0);
+  var paramPanelNode = function (_editorRef$current$ge3, _editorRef$current15, _boxRef$current) {
+    if (!paramEdit || !renderParamPanel) return null;
+    var chips = (_editorRef$current$ge3 = (_editorRef$current15 = editorRef.current) === null || _editorRef$current15 === void 0 ? void 0 : _editorRef$current15.getChips()) !== null && _editorRef$current$ge3 !== void 0 ? _editorRef$current$ge3 : [];
+    var chip = chips.find(function (c) {
+      return c.id === paramEdit.chipId;
+    });
+    if (!chip || isMentionChip(chip)) return null;
+    var boxWidth = (_boxRef$current = boxRef.current) === null || _boxRef$current === void 0 ? void 0 : _boxRef$current.getBoundingClientRect().width;
+    var ctx = {
+      chip: chip,
+      anchor: paramEdit.anchor,
+      onApply: function onApply(patch) {
+        var _editorRef$current16;
+        (_editorRef$current16 = editorRef.current) === null || _editorRef$current16 === void 0 || _editorRef$current16.updateChipData(chip.id, patch);
+      },
+      onClose: closeParamPanel
+    };
+    return /*#__PURE__*/React.createElement(InvocationParamPopover, {
+      anchor: paramEdit.anchor,
+      label: chip.label,
+      icon: chip.icon,
+      width: boxWidth,
+      onClose: closeParamPanel
+    }, renderParamPanel(ctx));
+  }();
   var editorNode = /*#__PURE__*/React.createElement(ComposerEditor, {
     ref: editorRef,
     autoSize: {
@@ -664,7 +732,9 @@ export var Composer = /*#__PURE__*/forwardRef(function Composer(_ref, ref) {
     placeholder: placeholder,
     value: text,
     onChange: updateText,
-    disabled: disabled
+    disabled: disabled,
+    paramEditChipId: (_paramEdit$chipId = paramEdit === null || paramEdit === void 0 ? void 0 : paramEdit.chipId) !== null && _paramEdit$chipId !== void 0 ? _paramEdit$chipId : null,
+    onInlineRefClick: renderParamPanel ? handleInlineRefClick : undefined
     /* 本轮只接 `/`，`@` 留给业务接 mention 搜索时再加 */,
     triggers: ['/'],
     onTriggerChange: setTriggerInfo,
@@ -678,8 +748,8 @@ export var Composer = /*#__PURE__*/forwardRef(function Composer(_ref, ref) {
     },
     onPressEnter: function onPressEnter(e) {
       if (e.nativeEvent.isComposing || e.keyCode === 229) return;
-      // trigger 浮层激活时 Enter 留给浮层做选择，本组件不发送也不换行
-      if (triggerMenuVisible) {
+      // trigger 浮层激活时，普通 Enter 留给浮层做选择；Shift+Enter 继续换行
+      if (triggerMenuVisible && !e.shiftKey) {
         e.preventDefault();
         return false;
       }
@@ -705,8 +775,8 @@ export var Composer = /*#__PURE__*/forwardRef(function Composer(_ref, ref) {
     visible: triggerMenuVisible,
     onVisibleChange: function onVisibleChange(v) {
       if (!v) {
-        var _editorRef$current13;
-        (_editorRef$current13 = editorRef.current) === null || _editorRef$current13 === void 0 || _editorRef$current13.cancelTrigger();
+        var _editorRef$current17;
+        (_editorRef$current17 = editorRef.current) === null || _editorRef$current17 === void 0 || _editorRef$current17.cancelTrigger();
         setTriggerInfo(null);
       }
     },
@@ -746,7 +816,8 @@ export var Composer = /*#__PURE__*/forwardRef(function Composer(_ref, ref) {
     style: style
   }, /*#__PURE__*/React.createElement("div", {
     "data-odn-composer-inner": true
-  }, hiddenFileInput, triggerMenu, /*#__PURE__*/React.createElement("div", _extends({
+  }, hiddenFileInput, triggerMenu, paramPanelNode, /*#__PURE__*/React.createElement("div", _extends({
+    ref: boxRef,
     "data-odn-composer-box": true
   }, composerBoxFileDragAttrs, {
     onDragEnter: handleComposerDragEnter,

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

@@ -1,9 +1,13 @@
 /// <reference types="react" />
-import type { ChipData } from './chip';
+import type { ChipData } from '../_genui-types';
 export declare function isMentionChip(chip: ChipData): boolean;
 export interface ComposerInlineRefProps {
     data: ChipData;
+    /** 参数面板打开时高亮 */
+    active?: boolean;
+    /** 有参数面板时由 Composer 注入；点击打开面板 */
+    onClick?: (anchor: HTMLElement) => void;
 }
 /** Composer 内联引用视觉：按 kind 派发 Invocation（/）或 Mention（@）。 */
-export declare function ComposerInlineRef({ data }: ComposerInlineRefProps): import("react").JSX.Element;
+export declare function ComposerInlineRef({ data, active, onClick, }: ComposerInlineRefProps): import("react").JSX.Element;
 export default ComposerInlineRef;

package/dist/composer/inline-ref.js

@@ -6,16 +6,23 @@ export function isMentionChip(chip) {
 }
 /** Composer 内联引用视觉：按 kind 派发 Invocation（/）或 Mention（@）。 */
 export function ComposerInlineRef(_ref) {
-  var data = _ref.data;
+  var data = _ref.data,
+    _ref$active = _ref.active,
+    active = _ref$active === void 0 ? false : _ref$active,
+    onClick = _ref.onClick;
   if (isMentionChip(data)) {
     return /*#__PURE__*/React.createElement(Mention, {
       data: chipToMentionData(data),
-      interactive: true
+      interactive: true,
+      active: active,
+      onClick: onClick
     });
   }
   return /*#__PURE__*/React.createElement(Invocation, {
     data: chipToInvocationData(data),
-    interactive: true
+    interactive: true,
+    active: active,
+    onClick: onClick
   });
 }
 export default ComposerInlineRef;

package/dist/composer/param-panel.d.ts

@@ -0,0 +1,14 @@
+import type { ChipData, InlineRefState } from '../_genui-types';
+/** Composer `renderParamPanel` 回调上下文。 */
+export interface ComposerParamPanelContext {
+    chip: ChipData;
+    anchor: HTMLElement;
+    /**
+     * 关闭即保存：业务在表单 onChange 时调用，合并进 chip.payload / state。
+     */
+    onApply: (patch: {
+        payload?: Record<string, unknown>;
+        state?: InlineRefState;
+    }) => void;
+    onClose: () => void;
+}

package/dist/composer/param-panel.js

@@ -0,0 +1 @@
+export {};

package/dist/composer/segments.d.ts

@@ -0,0 +1,29 @@
+/**
+ * Composer Segments · 发送时的有序 IR
+ *
+ * `onSend(segments, meta?)` 的主出口；业务按数组顺序自定义拼后端。
+ *
+ * - `rawValueToSegments`：库内部用，把含零宽 marker 的 raw value + chip 列表
+ *   还原为 `ComposerSegment[]`。
+ * - `segmentsToReadableText`：业务可选工具，按指定占位符格式把 segments 拼成
+ *   一句话（默认 `[Skill: label]` / `[@label]`，与 ComposerMention 兼容）。
+ * - `segmentsHasContent`：是否含可见内容；库内 send 校验用，业务可复用。
+ */
+import type { ComposerSegment } from '../_genui-types';
+import type { ChipData } from '../_genui-types';
+export type { ComposerSegment };
+/** 从含零宽 marker 的 raw value + chip 列表构建有序 segments。 */
+export declare function rawValueToSegments(raw: string, chips: ChipData[]): ComposerSegment[];
+export interface SegmentsToReadableTextOptions {
+    /** invocation 占位格式，默认 `[Skill: {label}]` */
+    formatInvocation?: (label: string) => string;
+    /** mention 占位格式，默认 `[@{label}]` */
+    formatMention?: (label: string) => string;
+}
+/**
+ * 把 segments 拼成一条字符串，供需要单串 string 的 LLM / 旧后端使用。
+ * 库**不内置调用**此函数；由业务在 onSend 内自行选择。
+ */
+export declare function segmentsToReadableText(segments: ComposerSegment[], options?: SegmentsToReadableTextOptions): string;
+/** segments 是否含可见内容（文本非空或含内联引用）。 */
+export declare function segmentsHasContent(segments: ComposerSegment[]): boolean;

package/dist/composer/segments.js

@@ -0,0 +1,83 @@
+/**
+ * Composer Segments · 发送时的有序 IR
+ *
+ * `onSend(segments, meta?)` 的主出口；业务按数组顺序自定义拼后端。
+ *
+ * - `rawValueToSegments`：库内部用，把含零宽 marker 的 raw value + chip 列表
+ *   还原为 `ComposerSegment[]`。
+ * - `segmentsToReadableText`：业务可选工具，按指定占位符格式把 segments 拼成
+ *   一句话（默认 `[Skill: label]` / `[@label]`，与 ComposerMention 兼容）。
+ * - `segmentsHasContent`：是否含可见内容；库内 send 校验用，业务可复用。
+ */
+
+import { chipToInvocationData, chipToMentionData } from "./send-meta";
+import { forEachMarkerSegment } from "./utils";
+/** 从含零宽 marker 的 raw value + chip 列表构建有序 segments。 */
+export function rawValueToSegments(raw, chips) {
+  var chipById = new Map(chips.map(function (c) {
+    return [c.id, c];
+  }));
+  var segments = [];
+  forEachMarkerSegment(raw, function (seg) {
+    if (seg.type === 'text') {
+      if (seg.text.length > 0) {
+        segments.push({
+          type: 'text',
+          data: {
+            text: seg.text
+          }
+        });
+      }
+      return;
+    }
+    var chip = chipById.get(seg.id);
+    if (!chip) return;
+    if (chip.kind === 'mention') {
+      segments.push({
+        type: 'mention',
+        data: chipToMentionData(chip)
+      });
+    } else {
+      segments.push({
+        type: 'invocation',
+        data: chipToInvocationData(chip)
+      });
+    }
+  });
+  return segments;
+}
+var defaultFormatInvocation = function defaultFormatInvocation(label) {
+  return "[Skill: ".concat(label, "]");
+};
+var defaultFormatMention = function defaultFormatMention(label) {
+  return "[@".concat(label, "]");
+};
+
+/**
+ * 把 segments 拼成一条字符串，供需要单串 string 的 LLM / 旧后端使用。
+ * 库**不内置调用**此函数；由业务在 onSend 内自行选择。
+ */
+export function segmentsToReadableText(segments, options) {
+  var _options$formatInvoca, _options$formatMentio;
+  var fmtInv = (_options$formatInvoca = options === null || options === void 0 ? void 0 : options.formatInvocation) !== null && _options$formatInvoca !== void 0 ? _options$formatInvoca : defaultFormatInvocation;
+  var fmtMen = (_options$formatMentio = options === null || options === void 0 ? void 0 : options.formatMention) !== null && _options$formatMentio !== void 0 ? _options$formatMentio : defaultFormatMention;
+  return segments.map(function (seg) {
+    switch (seg.type) {
+      case 'text':
+        return seg.data.text;
+      case 'invocation':
+        return fmtInv(seg.data.label);
+      case 'mention':
+        return fmtMen(seg.data.label);
+      default:
+        return '';
+    }
+  }).join('');
+}
+
+/** segments 是否含可见内容（文本非空或含内联引用）。 */
+export function segmentsHasContent(segments) {
+  return segments.some(function (s) {
+    return s.type === 'invocation' || s.type === 'mention' || s.type === 'text' && s.data.text.trim().length > 0;
+  });
+}

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

@@ -1,6 +1,9 @@
-import type { InvocationData, MentionData, SendMeta } from '../_genui-types';
-import type { ChipData } from './chip';
+import type { ChipData, InvocationData, MentionData } from '../_genui-types';
+/**
+ * Chip → Invocation/Mention 派发。
+ *
+ * 库只搬运 UI 字段（id/kind/label/icon/state）与业务字段（payload），
+ * 不对 payload 内容做任何假设。
+ */
 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;

package/dist/composer/send-meta.js

@@ -1,20 +1,17 @@
-function _typeof(o) { "@babel/helpers - typeof"; return _typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, _typeof(o); }
-function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
-function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
-function _defineProperty(obj, key, value) { key = _toPropertyKey(key); if (key in obj) { Object.defineProperty(obj, key, { value: value, enumerable: true, configurable: true, writable: true }); } else { obj[key] = value; } return obj; }
-function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == _typeof(i) ? i : String(i); }
-function _toPrimitive(t, r) { if ("object" != _typeof(t) || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != _typeof(i)) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); }
-function _createForOfIteratorHelper(o, allowArrayLike) { var it = typeof Symbol !== "undefined" && o[Symbol.iterator] || o["@@iterator"]; if (!it) { if (Array.isArray(o) || (it = _unsupportedIterableToArray(o)) || allowArrayLike && o && typeof o.length === "number") { if (it) o = it; var i = 0; var F = function F() {}; return { s: F, n: function n() { if (i >= o.length) return { done: true }; return { done: false, value: o[i++] }; }, e: function e(_e) { throw _e; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var normalCompletion = true, didErr = false, err; return { s: function s() { it = it.call(o); }, n: function n() { var step = it.next(); normalCompletion = step.done; return step; }, e: function e(_e2) { didErr = true; err = _e2; }, f: function f() { try { if (!normalCompletion && it.return != null) it.return(); } finally { if (didErr) throw err; } } }; }
-function _unsupportedIterableToArray(o, minLen) { if (!o) return; if (typeof o === "string") return _arrayLikeToArray(o, minLen); var n = Object.prototype.toString.call(o).slice(8, -1); if (n === "Object" && o.constructor) n = o.constructor.name; if (n === "Map" || n === "Set") return Array.from(o); if (n === "Arguments" || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(n)) return _arrayLikeToArray(o, minLen); }
-function _arrayLikeToArray(arr, len) { if (len == null || len > arr.length) len = arr.length; for (var i = 0, arr2 = new Array(len); i < len; i++) arr2[i] = arr[i]; return arr2; }
+/**
+ * Chip → Invocation/Mention 派发。
+ *
+ * 库只搬运 UI 字段（id/kind/label/icon/state）与业务字段（payload），
+ * 不对 payload 内容做任何假设。
+ */
 export function chipToInvocationData(chip) {
-  var kind = chip.kind === 'skill' || chip.kind === 'invocation' || !chip.kind ? 'skill' : chip.kind;
   return {
     id: chip.id,
-    kind: kind,
-    refId: chip.skillId,
+    kind: chip.kind === 'mention' || !chip.kind ? 'skill' : chip.kind,
     label: chip.label,
-    icon: chip.icon
+    icon: chip.icon,
+    state: chip.state,
+    payload: chip.payload
   };
 }
 export function chipToMentionData(chip) {
@@ -22,46 +19,9 @@ export function chipToMentionData(chip) {
   return {
     id: chip.id,
     kind: (_chip$kind = chip.kind) !== null && _chip$kind !== void 0 ? _chip$kind : 'mention',
-    refId: chip.skillId,
-    label: chip.label,
-    icon: chip.icon
-  };
-}
-function chipToLegacyMeta(chip) {
-  var kind = chip.kind === 'mention' ? 'mention' : chip.kind === 'invocation' || chip.kind === 'skill' || !chip.kind ? 'skill' : chip.kind;
-  return {
-    id: chip.id,
-    skillId: chip.skillId,
     label: chip.label,
     icon: chip.icon,
-    kind: kind
+    state: chip.state,
+    payload: chip.payload
   };
-}
-
-/** 从 editor chip 列表构建 SendMeta（含 invocations / mentions + chips 兼容字段）。 */
-export function buildSendMetaFromChips(chips) {
-  var base = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : {};
-  var invocations = [];
-  var mentions = [];
-  var _iterator = _createForOfIteratorHelper(chips),
-    _step;
-  try {
-    for (_iterator.s(); !(_step = _iterator.n()).done;) {
-      var chip = _step.value;
-      if (chip.kind === 'mention') {
-        mentions.push(chipToMentionData(chip));
-      } else {
-        invocations.push(chipToInvocationData(chip));
-      }
-    }
-  } catch (err) {
-    _iterator.e(err);
-  } finally {
-    _iterator.f();
-  }
-  return _objectSpread(_objectSpread({}, base), {}, {
-    invocations: invocations.length > 0 ? invocations : undefined,
-    mentions: mentions.length > 0 ? mentions : undefined,
-    chips: chips.length > 0 ? chips.map(chipToLegacyMeta) : undefined
-  });
 }