one-design-next 0.0.18 → 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;
     /**

package/dist/_genui-types.js

@@ -8,8 +8,8 @@
 /**
  * Composer 正文内 `/` 触发的内联引用（Invocation 组件数据契约）。
  *
- * 库只关心 UI 渲染必需字段；业务字段（refId、参数、上下文等）放 `payload`，
- * 库**不约定其内部结构**，发送时原样透传。
+ * 库只关心 UI 渲染必需字段；业务方自行扩展 `payload` 以携带参数、上下文等。
+ * 库**不约定 payload 内部结构**，发送时原样透传。
  */
 
 /** Composer 正文内 `@` 触发的内联引用（Mention 组件数据契约）。结构同 Invocation。 */

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/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/package.json

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