zcw-shared 2.11.0 → 2.13.0

package/dist/schemas/video.schema.d.ts

@@ -310,8 +310,8 @@ export declare const VideoCommentSchema: z.ZodObject<{
     created_at: z.ZodOptional<z.ZodString>;
     updated_at: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
-    id: number;
     content: string;
+    id: number;
     video_id: string;
     user_id: string;
     created_at?: string | undefined;
@@ -319,8 +319,8 @@ export declare const VideoCommentSchema: z.ZodObject<{
     updated_at?: string | undefined;
     parent_id?: number | null | undefined;
 }, {
-    id: number;
     content: string;
+    id: number;
     video_id: string;
     user_id: string;
     created_at?: string | undefined;
@@ -339,8 +339,8 @@ export declare const VideoCommentsResponseSchema: z.ZodObject<{
         created_at: z.ZodOptional<z.ZodString>;
         updated_at: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
-        id: number;
         content: string;
+        id: number;
         video_id: string;
         user_id: string;
         created_at?: string | undefined;
@@ -348,8 +348,8 @@ export declare const VideoCommentsResponseSchema: z.ZodObject<{
         updated_at?: string | undefined;
         parent_id?: number | null | undefined;
     }, {
-        id: number;
         content: string;
+        id: number;
         video_id: string;
         user_id: string;
         created_at?: string | undefined;
@@ -362,8 +362,8 @@ export declare const VideoCommentsResponseSchema: z.ZodObject<{
     offset: z.ZodNumber;
 }, "strip", z.ZodTypeAny, {
     data: {
-        id: number;
         content: string;
+        id: number;
         video_id: string;
         user_id: string;
         created_at?: string | undefined;
@@ -376,8 +376,8 @@ export declare const VideoCommentsResponseSchema: z.ZodObject<{
     offset: number;
 }, {
     data: {
-        id: number;
         content: string;
+        id: number;
         video_id: string;
         user_id: string;
         created_at?: string | undefined;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zcw-shared",
-  "version": "2.11.0",
+  "version": "2.13.0",
   "files": [
     "references",
     "dist",
@@ -12,19 +12,6 @@
   "license": "ISC",
   "type": "module",
   "description": "",
-  "scripts": {
-    "build": "tsc -p tsconfig.build.json && tsx scripts/generate-exports.ts",
-    "publish:patch": "npx tsx scripts/publish.ts patch",
-    "publish:minor": "npx tsx scripts/publish.ts minor",
-    "publish:major": "npx tsx scripts/publish.ts major",
-    "publish:prerelease": "npx tsx scripts/publish.ts prerelease",
-    "docs:dev": "vitepress dev docs",
-    "docs:build": "NODE_OPTIONS=--max-old-space-size=4096 vitepress build docs",
-    "docs:preview": "vitepress preview docs",
-    "deploy:cos:build": "NODE_OPTIONS=--max-old-space-size=4096 vitepress build docs",
-    "deploy:tcb": "npx tsx scripts/deploy-tcb.ts",
-    "deploy:cos": "npx tsx scripts/deploy-cos.ts"
-  },
   "dependencies": {
     "zod": "^3.23.8"
   },
@@ -159,6 +146,7 @@
     "./functions/design-tokens/mixColors": "./dist/functions/design-tokens/mixColors.js",
     "./functions/design-tokens/parseDesignTokens": "./dist/functions/design-tokens/parseDesignTokens.js",
     "./functions/dom/computePosition": "./dist/functions/dom/computePosition.js",
+    "./functions/dom/copyHtmlAndPlainToClipboard": "./dist/functions/dom/copyHtmlAndPlainToClipboard.js",
     "./functions/dom/copyTextToClipboard": "./dist/functions/dom/copyTextToClipboard.js",
     "./functions/dom/createSharedKeyboardCenter": "./dist/functions/dom/createSharedKeyboardCenter.js",
     "./functions/dom/createThrottledEventListener": "./dist/functions/dom/createThrottledEventListener.js",
@@ -200,7 +188,10 @@
     "./functions/hybrid/postBridgeMessage": "./dist/functions/hybrid/postBridgeMessage.js",
     "./functions/hybrid/validateBridgeMessage": "./dist/functions/hybrid/validateBridgeMessage.js",
     "./functions/im/formatImChatConversationListTime": "./dist/functions/im/formatImChatConversationListTime.js",
-    "./functions/im/parseImMentionSegments": "./dist/functions/im/parseImMentionSegments.js",
+    "./functions/im/forwardBundlePayload": "./dist/functions/im/forwardBundlePayload.js",
+    "./functions/im/getActiveMentionQuery": "./dist/functions/im/getActiveMentionQuery.js",
+    "./functions/im/imRichClipboardPlain": "./dist/functions/im/imRichClipboardPlain.js",
+    "./functions/im/imRichContentHtml": "./dist/functions/im/imRichContentHtml.js",
     "./functions/image/compressImageToWidth": "./dist/functions/image/compressImageToWidth.js",
     "./functions/image/compressToTargetSize": "./dist/functions/image/compressToTargetSize.js",
     "./functions/image/generateFavIcon": "./dist/functions/image/generateFavIcon.js",
@@ -445,7 +436,9 @@
     "./types/hybrid": "./types/hybrid.d.ts",
     "./types/im-api": "./types/im-api.d.ts",
     "./types/im-chat": "./types/im-chat.d.ts",
+    "./types/im-forward": "./types/im-forward.d.ts",
     "./types/im-message-display": "./types/im-message-display.d.ts",
+    "./types/im-reply": "./types/im-reply.d.ts",
     "./types/ios-build": "./types/ios-build.d.ts",
     "./types/music": "./types/music.d.ts",
     "./types/notification": "./types/notification.d.ts",
@@ -465,6 +458,7 @@
     "./types/review": "./types/review.d.ts",
     "./types/semver": "./types/semver.d.ts",
     "./types/software": "./types/software.d.ts",
+    "./types/sticker-pack": "./types/sticker-pack.d.ts",
     "./types/storage": "./types/storage.d.ts",
     "./types/tencent-cloud": "./types/tencent-cloud.d.ts",
     "./types/uniapp-android-build": "./types/uniapp-android-build.d.ts",
@@ -474,5 +468,18 @@
     "./types/video": "./types/video.d.ts",
     "./types/vue": "./types/vue.d.ts",
     "./types/worker": "./types/worker.d.ts"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json && tsx scripts/generate-exports.ts",
+    "publish:patch": "npx tsx scripts/publish.ts patch",
+    "publish:minor": "npx tsx scripts/publish.ts minor",
+    "publish:major": "npx tsx scripts/publish.ts major",
+    "publish:prerelease": "npx tsx scripts/publish.ts prerelease",
+    "docs:dev": "vitepress dev docs",
+    "docs:build": "NODE_OPTIONS=--max-old-space-size=4096 vitepress build docs",
+    "docs:preview": "vitepress preview docs",
+    "deploy:cos:build": "NODE_OPTIONS=--max-old-space-size=4096 vitepress build docs",
+    "deploy:tcb": "npx tsx scripts/deploy-tcb.ts",
+    "deploy:cos": "npx tsx scripts/deploy-cos.ts"
   }
 }

package/types/chat-shell-tab-config.d.ts

@@ -32,10 +32,10 @@ export interface ChatShellTabConfig {
   /** 使用「我的」头像而非 icon */
   useMineAvatar?: boolean
   /**
-   * 该 Tab 激活时切换整应用为深色主题（`html[data-theme="dark"]`），Dialog 等与主界面一致。
-   * 默认仅 AI Tab 开启；其它 Tab 可在 page-config「更多」里勾选。
+   * 该 Tab 激活时隐藏壳层 Tabbar（移动端底栏 + 宽屏左侧导航，含底部头像入口）。
+   * 切换到其它 Tab 后 Tabbar 恢复；适合全屏沉浸页。
    */
-  shellDark?: boolean
+  hideTabbar?: boolean
 }
 
 export interface ChatShellDisplaysConfig {
@@ -45,10 +45,6 @@ export interface ChatShellDisplaysConfig {
 /** page-config `displays` 中与 Chat 壳层相关的字段 */
 export interface ChatAppDisplaysConfig {
   chatShell?: ChatShellDisplaysConfig
-  /** @deprecated 使用 chatShell.tabs */
-  mobileTabbar?: {
-    enabledTabs?: string[]
-  }
 }
 
 export interface ChatShellTabbarItem {

package/types/im-api.d.ts

@@ -31,7 +31,16 @@ export interface ImApiMessage {
   sender_id: string
   conversation_id: string
   content: string
-  type: 'text' | 'markdown' | 'image' | 'file' | 'system' | 'audio' | 'video'
+  type:
+    | 'text'
+    | 'markdown'
+    | 'image'
+    | 'file'
+    | 'system'
+    | 'audio'
+    | 'video'
+    | 'forward_bundle'
+    | 'sticker'
   status: 'sent' | 'delivered' | 'read'
   /** 发送方在该会话中的第几条（由服务端写入；旧数据可由接口补算） */
   sender_seq?: number
@@ -47,6 +56,8 @@ export interface ImApiMessage {
   outbound_status?: ImOutboundStatus
   /**
    * 可含 attachments、im_display（多段展示，见 types/im-message-display）等。
+   * 用户消息引用：`extra_data.reply_to`（见 `types/im-reply.d.ts` 的 `ImReplyToRef`）。
+   * 合并转发：主载荷在 `content`（JSON，见 `types/im-forward.d.ts`）；旧数据可能仍在 `extra_data.forward_bundle`。
    * 智能体中断回复：`extra_data.ai_reply` 见 {@link ImApiAiReplyExtra}。
    */
   extra_data?: Record<string, any>

package/types/im-chat.d.ts

@@ -5,17 +5,53 @@
  * 在仓库层做 `ImApiMessage` → `ChatMessage` 的映射即可两端共类型、各层语义清晰。
  */
 import type { ImMessageDisplaySpec } from './im-message-display'
+import type { ImForwardBundleStoredItem } from './im-forward'
+import type { ImReplyToRef } from './im-reply'
+
+/** 引用预览（仅 UI 解析 id 后填充，不落库） */
+export interface ChatMessageQuotePreview {
+  senderName: string
+  snippet: string
+  /** 原消息不在当前线程缓存中（已删或未加载） */
+  missing?: boolean
+}
 
 /** 与 `ImMessage.extra_data.attachments[]` 对齐的列表项（会话消息内联附件） */
 export interface ChatInlineAttachmentListItem {
   url: string
   name?: string
   mimeType?: string
+  /** 字节数，来自 extra_data.attachments[].size */
+  size?: number
+}
+
+/** 合并转发气泡内单条预览（由 `forward_bundle` 解析） */
+export interface ChatForwardBundleItem {
+  senderName: string
+  snippet: string
+  /** 原会话消息 id（合并转发快照内） */
+  messageId?: string
+  /** 原会话发送方序号 #N */
+  senderSeq?: number
+  /** 原消息 IM type（text / markdown / image …） */
+  type?: string
+  /** 转发快照正文（URL 或文本） */
+  content?: string
+  /** 原消息展示用 extra（缩略图、im_display 等） */
+  extraData?: Record<string, unknown>
 }
 
 export interface ChatMessage {
   id: string
-  type: 'text' | 'markdown' | 'image' | 'video' | 'voice' | 'file'
+  type:
+    | 'text'
+    | 'markdown'
+    | 'image'
+    | 'video'
+    | 'voice'
+    | 'file'
+    | 'forward_bundle'
+    | 'sticker'
   content: string
   timestamp: Date
   sender: {
@@ -38,7 +74,8 @@ export interface ChatMessage {
    * 媒体出站细分阶段：登记接口尚未返回时没有 OSS 字节进度，勿与实际上传百分比混淆。
    * server_storage：客户端向 COS 直传时的占位阶段（如 PUT 已发出、等待完成回调）。
    */
-  mediaUploadPhase?: 'registering' | 'oss' | 'server_storage'
+  /** queued：已落本地草稿、排队等待串行上传；仅当前活跃条在 UI 上映射为 registering */
+  mediaUploadPhase?: 'queued' | 'registering' | 'oss' | 'server_storage'
   /** 终端幂等 id，与 ImApiMessage.client_message_id 一致 */
   clientMessageId?: string
   /** 媒体登记时原名（content 尚为空时用于文件气泡标题） */
@@ -58,8 +95,9 @@ export interface ChatMessage {
   /** 与 `extra_data.attachments` 同步的只读列表（用于附件列表弹窗等） */
   inlineAttachments?: ChatInlineAttachmentListItem[]
   /**
-   * 正文同条「内联附件」正在本地上传（`extra_data.inline_uploading`）。
-   * 进度用 {@link inlineUploadUploadedCount} / {@link inlineUploadTotalCount}，勿往 `content` 拼接文案。
+   * 正文富文本仍在本地补齐资源（`extra_data.inline_uploading`）：
+   * 工具栏待传附件条，或正文 `img:[local:…]` / blob 预览 → OSS。
+   * 进度用 {@link inlineUploadUploadedCount} / {@link inlineUploadTotalCount}（仅附件条）；勿往 `content` 拼接文案。
    */
   inlineUploading?: boolean
   /** 已完成上传的附件个数（`extra_data.inline_upload_uploaded_count`） */
@@ -74,6 +112,16 @@ export interface ChatMessage {
   agentProxyRetryable?: boolean
   /** 代理失败时的错误文案（如库不可用、ENOTFOUND） */
   agentProxyError?: string
+  /** `extra_data.reply_to.message_id`：引用的目标消息 */
+  replyToMessageId?: string
+  /** 由列表层按 {@link replyToMessageId} 从同会话消息解析，仅展示用 */
+  quotePreview?: ChatMessageQuotePreview
+  /** `type === 'forward_bundle'` 时由 content JSON（兼容 extra_data.forward_bundle）解析 */
+  forwardBundle?: ChatForwardBundleItem[]
+  /** `type === 'sticker'`：来自 extra_data.sticker */
+  stickerPackId?: number
+  stickerId?: number
+  stickerName?: string
 }
 
 

package/types/im-forward.d.ts

@@ -0,0 +1,37 @@
+/**
+ * 合并转发：`ImMessage.type === 'forward_bundle'`，载荷在 **content**（JSON，见 {@link ImForwardBundleContentPayload}）。
+ * 引用回复才用 `extra_data.reply_to`；合并转发不是引用，不应占用 extra 主载荷。
+ * 旧数据可能仍在 `extra_data.forward_bundle`，读路径在 `parseForwardBundleFromImMessage` 中兼容。
+ */
+export const IM_FORWARD_BUNDLE_EXTRA_KEY: 'forward_bundle'
+
+/** content 内 JSON 版本号 */
+export const IM_FORWARD_BUNDLE_CONTENT_VERSION: 1
+
+/** 合并转发条目中单条原消息的快照（落库） */
+export interface ImForwardBundleStoredItem {
+  sender_id?: string
+  sender_name: string
+  /** 原消息 IM type（text / markdown / image …） */
+  type: string
+  /** 转发发送用的正文（URL 或文本） */
+  content: string
+  /** 列表/气泡内预览文案 */
+  snippet: string
+  /** 原会话中的消息主键（便于详情展示 #序号 或跳转） */
+  message_id?: string
+  /** 原会话中的发送方序号（与气泡元数据 #N 一致） */
+  sender_seq?: number
+  /** 原消息展示用 extra（如 im_display、缩略图字段等） */
+  extra_data?: Record<string, unknown>
+}
+
+export interface ImForwardBundleExtra {
+  items: ImForwardBundleStoredItem[]
+}
+
+/** 写入 `ImMessage.content` 的 JSON 结构 */
+export interface ImForwardBundleContentPayload {
+  v: typeof IM_FORWARD_BUNDLE_CONTENT_VERSION
+  items: ImForwardBundleStoredItem[]
+}

package/types/im-reply.d.ts

@@ -0,0 +1,6 @@
+/**
+ * 用户消息「引用」：`ImApiMessage.extra_data.reply_to`（与 `ai_reply.reply_to_message_id` 无关）。
+ */
+export interface ImReplyToRef {
+  message_id: string | number
+}

package/types/sticker-pack.d.ts

@@ -0,0 +1,38 @@
+/** 表情包（运营配置，客户端拉取展示） */
+
+export type StickerPackStatus = 'active' | 'inactive' | 'draft'
+
+export interface StickerItem {
+  id: number
+  pack_id: number
+  name?: string
+  /** 表情图 URL（建议 OSS 公网或签名 URL） */
+  url: string
+  sort_order?: number
+  status?: StickerPackStatus
+  width?: number
+  height?: number
+  created_at?: string
+  updated_at?: string
+}
+
+export interface StickerPack {
+  id: number
+  name: string
+  cover_url?: string
+  sort_order?: number
+  status: StickerPackStatus
+  stickers?: StickerItem[]
+  created_at?: string
+  updated_at?: string
+}
+
+/** IM 消息 extra_data.sticker */
+export interface ImMessageStickerExtra {
+  pack_id: number
+  sticker_id: number
+  url: string
+  name?: string
+  width?: number
+  height?: number
+}