one-design-next 0.0.17 → 0.0.19

package/README.md

@@ -6,7 +6,7 @@
 
 通用业务控件 / 平台布局 / GenUI 对话组件 / AI Skill 工程化流水线
 
-[![npm](https://img.shields.io/badge/npm-one--design--next-blue)](http://mirrors.tencent.com/npm/package/one-design-next)
+[![npm](https://img.shields.io/npm/v/one-design-next.svg)](https://www.npmjs.com/package/one-design-next)
 [![React](https://img.shields.io/badge/React-16.14%20%7C%2017%20%7C%2018%20%7C%2019-61dafb)](https://react.dev)
 [![License](https://img.shields.io/badge/License-MIT-green.svg)](./LICENSE)
 
@@ -30,11 +30,10 @@ One Design Next 是腾讯 TAD / WXAD 团队维护的 React 组件库，提供 **
 ### 安装
 
 ```bash
-# 腾讯内部 npm 源
-npm install one-design-next --registry http://mirrors.tencent.com/npm/
+npm install one-design-next
 
 # 或使用 pnpm
-pnpm add one-design-next --registry http://mirrors.tencent.com/npm/
+pnpm add one-design-next
 ```
 
 ### 使用
@@ -96,7 +95,7 @@ pnpm run docs:build
 ### 常用脚本
 
 | 命令 | 说明 |
-|:-----|:-----|
+|:-----|:-----|·
 | `pnpm run dev` | 启动本地开发文档站 |
 | `pnpm run build` | 构建组件库（father + 样式） |
 | `pnpm run docs:build` | 静态构建文档站（含 LLM 知识生成） |
@@ -178,11 +177,7 @@ bash skills/build.sh huxuan   # 只构建互选
 
 ### 环境准备
 
-```bash
-npm config set registry http://mirrors.tencent.com/npm/
-pnpm config set registry http://mirrors.tencent.com/npm/
-# 在 ~/.npmrc 配置 mirrors 的 _authToken（发布权限）
-```
+在 `~/.npmrc` 中配置 npm 账号的 `_authToken`（需有 `one-design-next` 包的发布权限）。
 
 ### 发布流程
 
@@ -192,30 +187,14 @@ git checkout master && git pull origin master
 # 更新 package.json 版本号后：
 pnpm install
 pnpm run build
-npm publish --registry http://mirrors.tencent.com/npm/
+npm publish
 ```
 
 提交信息遵循 [Conventional Commits](https://www.conventionalcommits.org/) 规范（通过 `commitlint` + `husky` 钩子校验）。
 
-### 同步到 tad-universal-components
-
-```bash
-cd tad-universal-components
-git checkout odn-update && git merge origin/main --no-edit
-
-# 更新 packages/lib-od/package.json 中的 one-design-next 版本
-pnpm install
-git add packages/lib-od/package.json pnpm-lock.yaml
-git commit -m "chore(od): update one-design-next to <版本号>"
-git push origin odn-update
-# 在工蜂创建 MR：odn-update → main
-```
-
 ## 相关链接
 
-- **源码仓库** — https://git.woa.com/wxad-design/one-design-next
-- **tad-universal-components** — https://git.woa.com/tad-ag/tad-universal-components
-- **npm 包** — `one-design-next` @ [mirrors.tencent.com/npm](http://mirrors.tencent.com/npm/)
+- **npm 包** — [one-design-next](https://www.npmjs.com/package/one-design-next)
 
 ## 协议
 

package/dist/_genui-types.d.ts

@@ -64,12 +64,14 @@ export type InlineRefState = 'pending' | 'complete';
 /**
  * Composer 正文内 `/` 触发的内联引用（Invocation 组件数据契约）。
  *
- * 库只关心 UI 渲染必需字段；业务字段（refId、参数、上下文等）放 `payload`，
- * 库**不约定其内部结构**，发送时原样透传。
+ * 库只关心 UI 渲染必需字段；业务方自行扩展 `payload` 以携带参数、上下文等。
+ * 库**不约定 payload 内部结构**，发送时原样透传。
  */
 export interface InvocationData {
     /** chip 实例唯一 id（库内部 DOM 锚定、segments 去重用） */
     id: string;
+    /** 业务侧资源唯一 id（来自 SkillItem.id，原样透传至 onSend segments） */
+    refId?: string;
     /** 业务子类型（'skill' / 'command' / 自定义）；当前仅 'skill' 使用，预留扩展 */
     kind: string;
     /** 显示文字 */
@@ -78,12 +80,14 @@ export interface InvocationData {
     icon?: string;
     /** 视觉态。`active`（参数面板打开）由组件 prop 控制，不进 data。 */
     state?: InlineRefState;
-    /** 业务自定义任意字段：refId / 参数 / 上下文等，库不消费 */
+    /** 业务自定义任意字段：参数、上下文等，库不消费 */
     payload?: Record<string, unknown>;
 }
 /** Composer 正文内 `@` 触发的内联引用（Mention 组件数据契约）。结构同 Invocation。 */
 export interface MentionData {
     id: string;
+    /** 业务侧资源唯一 id，原样透传至 onSend segments */
+    refId?: string;
     kind: string;
     label: string;
     icon?: string;
@@ -97,6 +101,8 @@ export interface MentionData {
 export interface ChipData {
     /** chip 实例唯一 id（与 value marker 中的 id 对应） */
     id: string;
+    /** 业务侧资源唯一 id，透传至 InvocationData / MentionData */
+    refId?: string;
     label: string;
     icon?: string;
     /**
@@ -132,18 +138,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 渲染必需字段；业务方自行扩展 `payload` 以携带参数、上下文等。
+ * 库**不约定 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/index.js

@@ -31,9 +31,8 @@ function createInvocationChipData(skill) {
     icon: skill.icon,
     kind: 'invocation',
     state: skill.initialState,
-    payload: {
-      refId: skill.id
-    }
+    refId: skill.id,
+    payload: {}
   };
 }
 var TOOL_BTN_ACTIVE = 'color-mix(in srgb, var(--odn-color-brand-6) 10%, transparent)';

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/composer/send-meta.d.ts

@@ -2,7 +2,7 @@ import type { ChipData, InvocationData, MentionData } from '../_genui-types';
 /**
  * Chip → Invocation/Mention 派发。
  *
- * 库只搬运 UI 字段（id/kind/label/icon/state）与业务字段（payload），
+ * 库只搬运 UI 字段（id/refId/kind/label/icon/state）与业务字段（payload），
  * 不对 payload 内容做任何假设。
  */
 export declare function chipToInvocationData(chip: ChipData): InvocationData;

package/dist/composer/send-meta.js

@@ -1,12 +1,13 @@
 /**
  * Chip → Invocation/Mention 派发。
  *
- * 库只搬运 UI 字段（id/kind/label/icon/state）与业务字段（payload），
+ * 库只搬运 UI 字段（id/refId/kind/label/icon/state）与业务字段（payload），
  * 不对 payload 内容做任何假设。
  */
 export function chipToInvocationData(chip) {
   return {
     id: chip.id,
+    refId: chip.refId,
     kind: chip.kind === 'mention' || !chip.kind ? 'skill' : chip.kind,
     label: chip.label,
     icon: chip.icon,
@@ -18,6 +19,7 @@ export function chipToMentionData(chip) {
   var _chip$kind;
   return {
     id: chip.id,
+    refId: chip.refId,
     kind: (_chip$kind = chip.kind) !== null && _chip$kind !== void 0 ? _chip$kind : 'mention',
     label: chip.label,
     icon: chip.icon,

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.19",
   "description": "One Design Next from TAD@tencent.com",
   "packageManager": "pnpm@10.33.0",
   "module": "dist/index.js",