one-design-next 0.0.13 → 0.0.15

package/dist/_genui-types.d.ts

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

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

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

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

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

package/dist/attachments/style/index.css

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

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

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

package/dist/composer/clipboard.d.ts

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

package/dist/composer/editor.d.ts

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