zcw-shared 2.24.0 → 2.25.0

package/references/browser.d.ts

@@ -4,7 +4,7 @@ import type { AbortController, Response, FetchFunction } from './fetch.d'
 import type { URLSearchParams } from './url.d'
 import type { Storage } from './storage.d'
 import type { WorkerConstructor } from './worker.d'
-import type { Document, HTMLElement, Element, HTMLImageElement, CSSStyleDeclaration } from './dom.d'
+import type { Document, HTMLElement, Element, HTMLImageElement, CSSStyleDeclaration, Selection } from './dom.d'
 import type { IDBFactory } from './indexeddb.d'
 import type { Blob, BlobPart, BlobPropertyBag, MediaSource, ReadableStream } from './blob.d'
 import type { ImageBitmap } from './dom.d'
@@ -118,6 +118,9 @@ export interface Window {
   // Navigator API
   navigator: Navigator
 
+  // 选区 API
+  getSelection(): Selection | null
+
   // 事件监听API
   addEventListener(type: string, listener: EventListener, options?: boolean | AddEventListenerOptions): void
   removeEventListener(type: string, listener: EventListener, options?: boolean | EventListenerOptions): void

package/references/dom.d.ts

@@ -28,6 +28,8 @@ export interface Node {
 // parentNode 不可标为可选：undefined 会破坏与 Node 的结构兼容，导致 appendChild/removeChild 参数报错
 export interface Element extends Node {
   parentNode: Element | null
+  closest(selectors: string): Element | null
+  querySelector(selectors: string): Element | null
 }
 
 export interface HTMLElement extends Element {
@@ -57,6 +59,8 @@ export interface HTMLElement extends Element {
 
 export interface HTMLImageElement extends HTMLElement {
   src: string
+  crossOrigin: string | null
+  complete: boolean
   naturalWidth: number
   naturalHeight: number
   onload: (() => void) | null
@@ -163,6 +167,8 @@ export interface Document extends Node {
   createElement(tagName: 'iframe'): HTMLIFrameElement
   createElement(tagName: 'input'): HTMLInputElement
   createElement(tagName: string): HTMLElement
+  createDocumentFragment(): DocumentFragment
+  createRange(): Range
   querySelector(selector: string): Element | null
   querySelectorAll(selector: string): NodeListOf<Element>
   documentElement: {
@@ -219,6 +225,13 @@ export interface DOMStringList {
   contains(string: string): boolean
 }
 
+export interface DataTransfer {
+  setData(format: string, data: string): void
+  getData(format: string): string
+  readonly types: readonly string[]
+  effectAllowed: string
+}
+
 export interface CSSStyleDeclaration {
   position: string
   left: string
@@ -227,4 +240,23 @@ export interface CSSStyleDeclaration {
   height: string
   transform: string
   [property: string]: string
+}
+
+export interface Range {
+  startContainer: Node
+  endContainer: Node
+  cloneRange(): Range
+  cloneContents(): DocumentFragment
+  toString(): string
+  selectNodeContents(node: Node): void
+}
+
+export interface DocumentFragment extends Node {
+  appendChild<T extends Node>(node: T): T
+}
+
+export interface Selection {
+  rangeCount: number
+  isCollapsed: boolean
+  getRangeAt(index: number): Range
 }

package/types/ai-chat.d.ts

@@ -0,0 +1,23 @@
+export type AiChatMessageRole = 'user' | 'assistant' | 'system'
+
+export interface AiChatMessage {
+  id: string
+  session_id: string
+  role: AiChatMessageRole
+  content: string
+  created_at: string
+}
+
+export type AiChatSuggestionCategory = 'news' | 'creative' | 'qa' | 'general'
+
+export interface AiChatSuggestion {
+  id: string
+  text: string
+  category?: AiChatSuggestionCategory
+}
+
+/** GET /ai-chat/suggestions 响应体 */
+export interface AiChatSuggestionsPayload {
+  title: string
+  items: AiChatSuggestion[]
+}

package/types/capacitor-ota-release-manifest.d.ts

@@ -0,0 +1,21 @@
+/**
+ * 自建 Web 资源 OTA 清单（zip 整包），供壳内或后续 Capgo 等消费。
+ * 发布路径示例：`/capacitor/ota-manifests/stable/latest.json`
+ */
+
+export interface CapacitorOtaReleaseManifest {
+  version: string
+  pubDate: string
+  channel: string
+  updateMode: 'web'
+  /** 与前端 package version 对齐，用于与原生壳 App.getInfo().version 比较 */
+  minNativeVersion?: string
+  forceUpdate?: boolean
+  minSupportedVersion?: string
+  deadlineAt?: string
+  notes?: string
+  bundleFileName: string
+  bundleUrl: string
+  sha256: string
+  size: number
+}

package/types/capacitor-release-manifest.d.ts

@@ -0,0 +1,27 @@
+/**
+ * 自建 Capacitor（Android）整包更新清单，与 Electron `latest.json` 同字段语义（仅使用 full + packages）。
+ * 发布路径示例：`/capacitor/manifests/stable/latest.json`
+ */
+
+export interface CapacitorAndroidPackage {
+  platform: 'android'
+  /** 可选：arm64-v8a | armeabi-v7a | universal */
+  abi?: string
+  fileName: string
+  url: string
+  sha256: string
+  size: number
+}
+
+export interface CapacitorReleaseManifest {
+  version: string
+  pubDate: string
+  channel: string
+  /** 移动端仅支持 full（整包 APK） */
+  updateMode?: 'full'
+  forceUpdate?: boolean
+  minSupportedVersion?: string
+  deadlineAt?: string
+  notes?: string
+  packages: CapacitorAndroidPackage[]
+}

package/types/chat-appearance.d.ts

@@ -0,0 +1 @@
+export type ChatAppearanceMode = 'light' | 'dark' | 'system'

package/types/electron-release-manifest.d.ts

@@ -0,0 +1,40 @@
+/** 与 `scripts/generate-update-manifest.ts` / `electron/updater.cjs` 清单结构一致 */
+
+export type ElectronReleasePlatform = 'darwin' | 'win32' | 'linux'
+export type ElectronReleaseArch = 'x64' | 'arm64'
+
+export interface ElectronReleasePackage {
+  platform: ElectronReleasePlatform
+  arch: ElectronReleaseArch
+  fileName: string
+  url: string
+  sha256: string
+  size: number
+  blockmapUrl?: string
+}
+
+export interface ElectronReleaseManifest {
+  version: string
+  pubDate?: string
+  channel?: string
+  updateMode?: 'full' | 'renderer' | 'main' | 'mixed'
+  forceUpdate?: boolean
+  minSupportedVersion?: string
+  deadlineAt?: string
+  notes?: string
+  rollout?: number
+  packages?: ElectronReleasePackage[]
+  rendererPackage?: {
+    url: string
+    sha256: string
+    size: number
+    entryHtml: string
+  }
+  mainPackage?: {
+    url: string
+    sha256: string
+    size: number
+    restartRequired: boolean
+  }
+  fallbackFull?: ElectronReleasePackage
+}

package/types/im-ai-agent.d.ts

@@ -0,0 +1,23 @@
+import type { ImAccountKind } from './im-account-kind'
+
+/** `/ai/agents` 列表行（映射 Agent 选项所需字段） */
+export type ImAiAgentCatalogRow = {
+  id?: string | null
+  user_id?: string | null
+  display_name?: string | null
+  bio?: string | null
+  avatar_url?: string | null
+  account_kind?: string | null
+  enabled?: boolean | null
+}
+
+/** 会话侧 AI Agent 选项（新建会话 / @ 提及等） */
+export type ImAiChatAgentOption = {
+  userId: string
+  displayName: string
+  avatarUrl?: string
+  bio?: string
+  accountKind: ImAccountKind
+  /** `ai_agents.id`，用于运行状态 API */
+  agentRowId?: string
+}

package/types/named-sse.d.ts

@@ -0,0 +1,11 @@
+export type NamedSseHandlers = {
+  onDelta: (text: string) => void
+  onDone: (payload: {
+    message_id: string
+    content: string
+    session_id?: string
+  }) => void
+  onError: (message: string) => void
+  /** 新建会话并首条消息时，流开始前返回会话 */
+  onSession?: (session: Record<string, unknown>) => void
+}

package/types/wallet-ledger.d.ts

@@ -0,0 +1,47 @@
+export type WalletLedgerKind = 'fiat' | 'crypto'
+
+/** 账单分类（对应 API source / type 筛选） */
+export type WalletLedgerCategory =
+  | 'all'
+  | 'recharge'
+  | 'transfer'
+  | 'red_envelope'
+  | 'lottery'
+  | 'refund'
+  | 'other'
+
+export interface WalletLedgerCategoryOption {
+  id: WalletLedgerCategory
+  label: string
+}
+
+export type WalletLedgerFiatTransaction = {
+  amount: number
+  direction: 'in' | 'out'
+  type: string
+  source: string
+  description?: string
+  related_id?: string
+  created_at?: string
+  createdAt?: string
+  createTime?: number | string
+  _createTime?: number | string
+}
+
+export type WalletLedgerCryptoTransaction = {
+  amount: string
+  direction: 'in' | 'out'
+  type: string
+  source: string
+  description?: string
+  related_id?: string
+  created_at?: string
+  createdAt?: string
+  createTime?: number | string
+  _createTime?: number | string
+}
+
+export interface WalletLedgerMonthStats {
+  expense: number
+  income: number
+}