one-design-next 0.0.17 → 0.0.18

package/dist/_genui-types.d.ts

@@ -132,18 +132,33 @@ export interface SkillItem {
  * 三种分支拆成命名 interface 导出，业务可直接 `import` 单一形态，
  * 无需再写 `Extract<ComposerSegment, { type: 'xxx' }>`。
  */
+/** Composer 文本片段携带的数据。 */
+export interface TextData {
+    text: string;
+}
+/**
+ * Composer segment 的 type 字面量集合。
+ *
+ * 用 `as const` 对象 + 同名类型 alias 取代 TS `enum`：
+ * - 业务方可写 `seg.type === ComposerSegmentType.Invocation` 取代裸字符串
+ * - 底层仍是字符串字面量 union，自动收窄、JSON 兼容、tree-shake 友好
+ */
+export declare const ComposerSegmentType: {
+    readonly Text: "text";
+    readonly Invocation: "invocation";
+    readonly Mention: "mention";
+};
+export type ComposerSegmentType = (typeof ComposerSegmentType)[keyof typeof ComposerSegmentType];
 export interface ComposerTextSegment {
-    type: 'text';
-    data: {
-        text: string;
-    };
+    type: typeof ComposerSegmentType.Text;
+    data: TextData;
 }
 export interface ComposerInvocationSegment {
-    type: 'invocation';
+    type: typeof ComposerSegmentType.Invocation;
     data: InvocationData;
 }
 export interface ComposerMentionSegment {
-    type: 'mention';
+    type: typeof ComposerSegmentType.Mention;
     data: MentionData;
 }
 export type ComposerSegment = ComposerTextSegment | ComposerInvocationSegment | ComposerMentionSegment;

package/dist/_genui-types.js

@@ -1 +1,47 @@
-export {};
+/**
+ * 内联引用三态：
+ * - complete：默认稳态（无参数 / 参数已填）
+ * - pending：邀请补充参数（业务自定，不强制）
+ * - active：参数面板打开（最高优先级，由组件内部根据 `active` prop 控制）
+ */
+
+/**
+ * Composer 正文内 `/` 触发的内联引用（Invocation 组件数据契约）。
+ *
+ * 库只关心 UI 渲染必需字段；业务字段（refId、参数、上下文等）放 `payload`，
+ * 库**不约定其内部结构**，发送时原样透传。
+ */
+
+/** Composer 正文内 `@` 触发的内联引用（Mention 组件数据契约）。结构同 Invocation。 */
+
+/**
+ * Composer 编辑器内 chip 实例数据（DOM host + Portal 渲染用）。
+ * 发送时经 `rawValueToSegments` 转为 `ComposerSegment` 的 invocation / mention。
+ */
+
+/**
+ * Composer 发送时的有序内容 IR（与编辑器内出现顺序一致）。
+ *
+ * 这是 `onSend` 的**主出口**：业务按此数组顺序自定义拼后端（可选用
+ * `segmentsToReadableText` 工具函数兜底拼成一句话）。
+ *
+ * 三种分支拆成命名 interface 导出，业务可直接 `import` 单一形态，
+ * 无需再写 `Extract<ComposerSegment, { type: 'xxx' }>`。
+ */
+
+/** Composer 文本片段携带的数据。 */
+
+/**
+ * Composer segment 的 type 字面量集合。
+ *
+ * 用 `as const` 对象 + 同名类型 alias 取代 TS `enum`：
+ * - 业务方可写 `seg.type === ComposerSegmentType.Invocation` 取代裸字符串
+ * - 底层仍是字符串字面量 union，自动收窄、JSON 兼容、tree-shake 友好
+ */
+export var ComposerSegmentType = {
+  Text: 'text',
+  Invocation: 'invocation',
+  Mention: 'mention'
+};
+
+/** `onSend(segments, meta?)` 第二参数：非正文的附加数据。 */

package/dist/composer/segments.d.ts

@@ -9,8 +9,10 @@
  *   一句话（默认 `[Skill: label]` / `[@label]`，与 ComposerMention 兼容）。
  * - `segmentsHasContent`：是否含可见内容；库内 send 校验用，业务可复用。
  */
-import type { ChipData, ComposerInvocationSegment, ComposerMentionSegment, ComposerSegment, ComposerTextSegment } from '../_genui-types';
-export type { ComposerInvocationSegment, ComposerMentionSegment, ComposerSegment, ComposerTextSegment, };
+import type { ChipData, ComposerInvocationSegment, ComposerMentionSegment, ComposerSegment, ComposerTextSegment, TextData } from '../_genui-types';
+import { ComposerSegmentType } from '../_genui-types';
+export type { ComposerInvocationSegment, ComposerMentionSegment, ComposerSegment, ComposerTextSegment, TextData, };
+export { ComposerSegmentType };
 export declare const isTextSegment: (s: ComposerSegment) => s is ComposerTextSegment;
 export declare const isInvocationSegment: (s: ComposerSegment) => s is ComposerInvocationSegment;
 export declare const isMentionSegment: (s: ComposerSegment) => s is ComposerMentionSegment;

package/dist/composer/segments.js

@@ -10,8 +10,11 @@
  * - `segmentsHasContent`：是否含可见内容；库内 send 校验用，业务可复用。
  */
 
+import { ComposerSegmentType } from "../_genui-types";
 import { chipToInvocationData, chipToMentionData } from "./send-meta";
 import { forEachMarkerSegment } from "./utils";
+export { ComposerSegmentType };
+
 /* ────────────────────────────────────────────────────────────────────
  * Type guards · 给业务方 filter / find 用，避免现场写 Extract<…>。
  *
@@ -19,13 +22,13 @@ import { forEachMarkerSegment } from "./utils";
  * ──────────────────────────────────────────────────────────────────── */
 
 export var isTextSegment = function isTextSegment(s) {
-  return s.type === 'text';
+  return s.type === ComposerSegmentType.Text;
 };
 export var isInvocationSegment = function isInvocationSegment(s) {
-  return s.type === 'invocation';
+  return s.type === ComposerSegmentType.Invocation;
 };
 export var isMentionSegment = function isMentionSegment(s) {
-  return s.type === 'mention';
+  return s.type === ComposerSegmentType.Mention;
 };
 
 /** 从含零宽 marker 的 raw value + chip 列表构建有序 segments。 */

package/dist/index.d.ts

@@ -73,5 +73,6 @@ export { default as StreamText, type StreamTextProps, type TypographyOverrides }
 export { default as Suggestions, type SuggestionsProps } from './suggestions';
 export { default as UserBubble, type UserBubbleProps } from './user-bubble';
 export { default as Welcome, type WelcomeProps } from './welcome';
-export type { ToolCall, ToolStatus, Source, Attachment, PreviewTarget, PreviewTab, SendMeta, ComposerSegment, ComposerTextSegment, ComposerInvocationSegment, ComposerMentionSegment, InvocationData, MentionData, InlineRefState, SkillItem, AgentEvent, Conversation, MessageSnapshot, ChatMessage } from './_genui-types';
+export type { ToolCall, ToolStatus, Source, Attachment, PreviewTarget, PreviewTab, SendMeta, ComposerSegment, ComposerTextSegment, ComposerInvocationSegment, ComposerMentionSegment, TextData, InvocationData, MentionData, InlineRefState, SkillItem, AgentEvent, Conversation, MessageSnapshot, ChatMessage } from './_genui-types';
+export { ComposerSegmentType } from './_genui-types';
 export { rawValueToSegments, segmentsToReadableText, segmentsHasContent, isTextSegment, isInvocationSegment, isMentionSegment, type SegmentsToReadableTextOptions, } from './composer/segments';

package/dist/index.js

@@ -81,4 +81,5 @@ export { default as Welcome } from "./welcome";
 
 // GenUI shared modules
 
+export { ComposerSegmentType } from "./_genui-types";
 export { rawValueToSegments, segmentsToReadableText, segmentsHasContent, isTextSegment, isInvocationSegment, isMentionSegment } from "./composer/segments";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "one-design-next",
-  "version": "0.0.17",
+  "version": "0.0.18",
   "description": "One Design Next from TAD@tencent.com",
   "packageManager": "pnpm@10.33.0",
   "module": "dist/index.js",