zcw-shared 1.20.0 → 1.22.0

package/references/device.d.ts

@@ -0,0 +1,340 @@
+/**
+ * 设备 API 类型定义
+ * 包含浏览器端设备相关的 Web API 接口
+ */
+
+// 蓝牙相关类型
+export interface BluetoothDevice {
+  id: string
+  name?: string
+  gatt?: BluetoothRemoteGATTServer
+  watchAdvertisements(): Promise<void>
+  unwatchAdvertisements(): void
+  addEventListener(type: string, listener: EventListener): void
+  removeEventListener(type: string, listener: EventListener): void
+}
+
+export interface BluetoothRemoteGATTServer {
+  device: BluetoothDevice
+  connected: boolean
+  connect(): Promise<BluetoothRemoteGATTServer>
+  disconnect(): void
+  getPrimaryService(service: string): Promise<BluetoothRemoteGATTService>
+  getPrimaryServices(service?: string): Promise<BluetoothRemoteGATTService[]>
+}
+
+export interface BluetoothRemoteGATTService {
+  device: BluetoothDevice
+  uuid: string
+  isPrimary: boolean
+  getCharacteristic(characteristic: string): Promise<BluetoothRemoteGATTCharacteristic>
+  getCharacteristics(characteristic?: string): Promise<BluetoothRemoteGATTCharacteristic[]>
+}
+
+export interface BluetoothRemoteGATTCharacteristic {
+  service: BluetoothRemoteGATTService
+  uuid: string
+  value?: DataView
+  readValue(): Promise<DataView>
+  writeValue(value: BufferSource): Promise<void>
+  startNotifications(): Promise<BluetoothRemoteGATTCharacteristic>
+  stopNotifications(): Promise<BluetoothRemoteGATTCharacteristic>
+  addEventListener(type: string, listener: EventListener): void
+  removeEventListener(type: string, listener: EventListener): void
+}
+
+export interface Bluetooth {
+  requestDevice(options?: {
+    filters?: Array<{ name?: string; namePrefix?: string; services?: string[] }>
+    optionalServices?: string[]
+    acceptAllDevices?: boolean
+  }): Promise<BluetoothDevice>
+  getAvailability(): Promise<boolean>
+  addEventListener(type: string, listener: EventListener): void
+  removeEventListener(type: string, listener: EventListener): void
+}
+
+// 地理位置相关类型
+export interface GeolocationPosition {
+  coords: {
+    latitude: number
+    longitude: number
+    altitude: number | null
+    accuracy: number
+    altitudeAccuracy: number | null
+    heading: number | null
+    speed: number | null
+  }
+  timestamp: number
+}
+
+export interface GeolocationPositionError {
+  code: number
+  message: string
+  PERMISSION_DENIED: 1
+  POSITION_UNAVAILABLE: 2
+  TIMEOUT: 3
+}
+
+export interface Geolocation {
+  getCurrentPosition(
+    successCallback: (position: GeolocationPosition) => void,
+    errorCallback?: (error: GeolocationPositionError) => void,
+    options?: {
+      enableHighAccuracy?: boolean
+      timeout?: number
+      maximumAge?: number
+    }
+  ): void
+  watchPosition(
+    successCallback: (position: GeolocationPosition) => void,
+    errorCallback?: (error: GeolocationPositionError) => void,
+    options?: {
+      enableHighAccuracy?: boolean
+      timeout?: number
+      maximumAge?: number
+    }
+  ): number
+  clearWatch(watchId: number): void
+}
+
+// 媒体设备相关类型
+export interface MediaStream {
+  id: string
+  active: boolean
+  getTracks(): MediaStreamTrack[]
+  getVideoTracks(): MediaStreamTrack[]
+  getAudioTracks(): MediaStreamTrack[]
+  addTrack(track: MediaStreamTrack): void
+  removeTrack(track: MediaStreamTrack): void
+  addEventListener(type: string, listener: EventListener): void
+  removeEventListener(type: string, listener: EventListener): void
+}
+
+export interface MediaStreamTrack {
+  id: string
+  kind: 'audio' | 'video'
+  label: string
+  enabled: boolean
+  muted: boolean
+  readyState: 'live' | 'ended'
+  stop(): void
+  getSettings(): MediaTrackSettings
+  getCapabilities(): MediaTrackCapabilities
+  addEventListener(type: string, listener: EventListener): void
+  removeEventListener(type: string, listener: EventListener): void
+}
+
+export interface MediaTrackSettings {
+  width?: number
+  height?: number
+  aspectRatio?: number
+  frameRate?: number
+  facingMode?: string
+  deviceId?: string
+  sampleRate?: number
+  sampleSize?: number
+  echoCancellation?: boolean
+  noiseSuppression?: boolean
+  autoGainControl?: boolean
+}
+
+export interface MediaTrackCapabilities {
+  width?: { min: number; max: number }
+  height?: { min: number; max: number }
+  aspectRatio?: { min: number; max: number }
+  frameRate?: { min: number; max: number }
+  facingMode?: string[]
+  deviceId?: string
+}
+
+export interface MediaDevices {
+  getUserMedia(constraints?: {
+    video?: boolean | { facingMode?: string; width?: number; height?: number }
+    audio?: boolean | { echoCancellation?: boolean; noiseSuppression?: boolean }
+  }): Promise<MediaStream>
+  enumerateDevices(): Promise<MediaDeviceInfo[]>
+  getSupportedConstraints(): MediaTrackSupportedConstraints
+  addEventListener(type: string, listener: EventListener): void
+  removeEventListener(type: string, listener: EventListener): void
+}
+
+export interface MediaDeviceInfo {
+  deviceId: string
+  kind: 'audioinput' | 'audiooutput' | 'videoinput'
+  label: string
+  groupId: string
+}
+
+export interface MediaTrackSupportedConstraints {
+  width?: boolean
+  height?: boolean
+  aspectRatio?: boolean
+  frameRate?: boolean
+  facingMode?: boolean
+  volume?: boolean
+  sampleRate?: boolean
+  sampleSize?: boolean
+  echoCancellation?: boolean
+  noiseSuppression?: boolean
+  autoGainControl?: boolean
+}
+
+export interface MediaStreamConstraints {
+  video?: boolean | { facingMode?: string; width?: number; height?: number }
+  audio?: boolean | { echoCancellation?: boolean; noiseSuppression?: boolean; autoGainControl?: boolean }
+}
+
+// 电池相关类型
+export interface BatteryManager {
+  charging: boolean
+  chargingTime: number
+  dischargingTime: number
+  level: number
+  addEventListener(type: string, listener: EventListener): void
+  removeEventListener(type: string, listener: EventListener): void
+}
+
+export interface Navigator {
+  getBattery(): Promise<BatteryManager>
+}
+
+// 网络相关类型
+export interface NetworkInformation {
+  type?: 'bluetooth' | 'cellular' | 'ethernet' | 'none' | 'wifi' | 'wimax' | 'other' | 'unknown'
+  effectiveType?: 'slow-2g' | '2g' | '3g' | '4g'
+  downlink?: number
+  downlinkMax?: number
+  rtt?: number
+  saveData?: boolean
+  addEventListener(type: string, listener: EventListener): void
+  removeEventListener(type: string, listener: EventListener): void
+}
+
+export interface NavigatorConnection extends Navigator {
+  connection?: NetworkInformation
+}
+
+// 设备方向相关类型
+export interface DeviceOrientationEvent {
+  alpha: number | null
+  beta: number | null
+  gamma: number | null
+  absolute: boolean
+}
+
+export interface DeviceMotionEvent {
+  acceleration: {
+    x: number | null
+    y: number | null
+    z: number | null
+  } | null
+  accelerationIncludingGravity: {
+    x: number | null
+    y: number | null
+    z: number | null
+  } | null
+  rotationRate: {
+    alpha: number | null
+    beta: number | null
+    gamma: number | null
+  } | null
+  interval: number
+}
+
+// 震动相关类型
+export interface NavigatorVibration extends Navigator {
+  vibrate(pattern: number | number[]): boolean
+}
+
+// 屏幕相关类型
+export interface ScreenOrientation {
+  type: 'portrait-primary' | 'portrait-secondary' | 'landscape-primary' | 'landscape-secondary'
+  angle: number
+  lock(orientation: OrientationLockType): Promise<void>
+  unlock(): void
+  addEventListener(type: string, listener: EventListener): void
+  removeEventListener(type: string, listener: EventListener): void
+}
+
+export type OrientationLockType = 
+  | 'any'
+  | 'natural'
+  | 'landscape'
+  | 'portrait'
+  | 'portrait-primary'
+  | 'portrait-secondary'
+  | 'landscape-primary'
+  | 'landscape-secondary'
+
+export interface Screen {
+  orientation?: ScreenOrientation
+}
+
+// 游戏手柄相关类型
+export interface GamepadButton {
+  pressed: boolean
+  touched: boolean
+  value: number
+}
+
+export interface Gamepad {
+  id: string
+  index: number
+  connected: boolean
+  timestamp: number
+  mapping: 'standard' | ''
+  axes: readonly number[]
+  buttons: readonly GamepadButton[]
+  hapticActuators?: readonly GamepadHapticActuator[]
+  vibrationActuator?: GamepadHapticActuator
+}
+
+export interface GamepadHapticActuator {
+  type: 'vibration' | 'dual-rumble'
+  playEffect(
+    type: 'dual-rumble',
+    params: {
+      duration?: number
+      startDelay?: number
+      strongMagnitude?: number
+      weakMagnitude?: number
+    }
+  ): Promise<'complete' | 'preempted'>
+  reset(): Promise<'complete' | 'preempted'>
+}
+
+// Wake Lock 相关类型
+export interface WakeLockSentinel {
+  readonly type: 'screen'
+  readonly released: boolean
+  release(): Promise<void>
+  addEventListener(type: 'release', listener: () => void): void
+  removeEventListener(type: 'release', listener: () => void): void
+}
+
+export interface WakeLock {
+  request(type: 'screen'): Promise<WakeLockSentinel>
+}
+
+// Media Session 相关类型
+export interface MediaMetadataInit {
+  title?: string
+  artist?: string
+  album?: string
+  artwork?: Array<{
+    src: string
+    sizes?: string
+    type?: string
+  }>
+}
+
+export interface MediaSession {
+  metadata: any
+  playbackState: 'none' | 'paused' | 'playing'
+  setActionHandler(
+    action: 'play' | 'pause' | 'stop' | 'seekbackward' | 'seekforward' | 'previoustrack' | 'nexttrack' | 'seekto',
+    handler: ((details?: any) => void) | null
+  ): void
+}
+

package/references/dom.d.ts

@@ -1,8 +1,31 @@
 // DOM 相关类型声明
 import type { Blob } from './blob.d'
 
+// 事件监听器类型
+export type EventListener = (event: Event) => void
+
+// 事件监听选项
+export interface AddEventListenerOptions {
+  capture?: boolean
+  once?: boolean
+  passive?: boolean
+}
+
+export interface EventListenerOptions {
+  capture?: boolean
+}
+
+// Node 接口
+export interface Node {
+  nodeType: number
+  nodeName: string
+  parentNode: Node | null
+  childNodes: Node[]
+  contains(other: Node | null): boolean
+}
+
 // DOM 元素接口 - 按继承关系组织
-export interface Element {
+export interface Element extends Node {
   parentNode?: Element | null
 }
 
@@ -17,14 +40,15 @@ export interface HTMLElement extends Element {
     right: number
     bottom: number
   }
-  addEventListener(event: string, handler: (e: any) => void, options?: any): void
-  removeEventListener(event: string, handler: (e: any) => void, options?: any): void
+  addEventListener(event: string, handler: EventListener, options?: boolean | AddEventListenerOptions): void
+  removeEventListener(event: string, handler: EventListener, options?: boolean | EventListenerOptions): void
   clientWidth: number
   clientHeight: number
   offsetLeft: number
   offsetTop: number
   offsetWidth: number
   offsetHeight: number
+  contains(other: Node | null): boolean
 }
 
 export interface HTMLImageElement extends HTMLElement {
@@ -69,7 +93,7 @@ export interface HTMLCanvasElement extends HTMLElement {
   toBlob(callback: (blob: Blob | null) => void, type?: string, quality?: number): void
 }
 
-export interface Document {
+export interface Document extends Node {
   createElement(tagName: 'canvas'): HTMLCanvasElement
   createElement(tagName: 'script'): HTMLScriptElement
   createElement(tagName: 'link'): HTMLLinkElement
@@ -84,8 +108,9 @@ export interface Document {
     appendChild(element: HTMLElement): HTMLElement
   }
   body: HTMLElement
-  addEventListener(event: string, handler: (e: any) => void, options?: any): void
-  removeEventListener(event: string, handler: (e: any) => void, options?: any): void
+  cookie: string
+  addEventListener(event: string, handler: EventListener, options?: boolean | AddEventListenerOptions): void
+  removeEventListener(event: string, handler: EventListener, options?: boolean | EventListenerOptions): void
 }
 
 // DOM 事件相关

package/references/node.d.ts

@@ -84,6 +84,8 @@ export interface Path {
   dirname(path: string): string
   basename(path: string, ext?: string): string
   extname(path: string): string
+  relative(from: string, to: string): string
+  normalize(path: string): string
   sep: string
   posix: {
     join(...paths: string[]): string

package/references/tencent-cloud.d.ts

@@ -62,4 +62,42 @@ export interface TencentCloudSystemDependencies {
   process: Process
   console: Console
   getSecret: (type: string) => TencentCloudSecret
+}
+
+// COS 上传进度回调参数
+export interface COSUploadProgressData {
+  percent: number
+  loaded: number
+  total: number
+}
+
+// COS 上传文件参数
+export interface COSPutObjectParams {
+  Bucket: string
+  Region: string
+  Key: string
+  Body: Buffer | string
+  onProgress?: (progressData: COSUploadProgressData) => void
+}
+
+// COS 上传结果
+export interface COSPutObjectResult {
+  statusCode: number
+  headers: Record<string, string>
+}
+
+// COS SDK 接口
+export interface COSSDK {
+  putObject(params: COSPutObjectParams, callback?: (err: Error | null, data: COSPutObjectResult) => void): void
+}
+
+// COS 构造函数参数
+export interface COSConstructorParams {
+  SecretId: string
+  SecretKey: string
+}
+
+// COS 构造函数接口
+export interface COSConstructor {
+  new (params: COSConstructorParams): COSSDK
 }

package/references/xlsx.d.ts

@@ -0,0 +1,51 @@
+/**
+ * XLSX 库类型声明
+ * 用于 Excel 文件读取和解析
+ * 与 import type { XLSXLibrary } from '...' 兼容
+ */
+
+export interface WorkBook {
+  /** 工作表名称数组 */
+  SheetNames: string[]
+  /** 工作表对象映射 */
+  Sheets: { [sheetName: string]: WorkSheet }
+}
+
+export interface WorkSheet {
+  [cellRef: string]: CellObject
+}
+
+export interface CellObject {
+  /** 单元格值 */
+  v?: string | number | boolean | Date
+  /** 值类型 */
+  t?: 's' | 'n' | 'b' | 'd'
+}
+
+export interface XLSXUtils {
+  /** 将工作表转换为 JSON 数组 */
+  sheet_to_json(sheet: WorkSheet, options?: { header: number }): any[][]
+}
+
+export interface XLSXLibrary {
+  /** 读取 Excel 文件 */
+  readFile(filePath: string): WorkBook
+  /** 读取文件缓冲区 */
+  read(buffer: Buffer, options?: any): WorkBook
+  /** 全局工具对象 */
+  utils: XLSXUtils
+}
+
+/**
+ * XLSX 库默认导出
+ * 兼容 import * as XLSX from 'xlsx' 的使用
+ */
+declare module 'xlsx' {
+  export = XLSXLibrary
+}
+
+/**
+ * 全局类型声明
+ * 兼容 import type { XLSXLibrary } from '../../../references/xlsx.d'
+ */
+export type XLSX = XLSXLibrary

package/types/algorithm-visual.d.ts

@@ -0,0 +1,79 @@
+/**
+ * 算法可视化相关类型定义
+ */
+
+/**
+ * 可视化步骤基础接口
+ */
+export interface VisualStep {
+  /** 步骤描述 */
+  description: string
+  /** 步骤编号 */
+  stepNumber: number
+}
+
+/**
+ * 数组可视化步骤
+ */
+export interface ArrayVisualStep extends VisualStep {
+  /** 当前数组状态 */
+  array: number[]
+  /** 高亮的索引 */
+  highlights: {
+    /** 主要元素 */
+    primary?: number[]
+    /** 次要元素 */
+    secondary?: number[]
+    /** 比较中的元素 */
+    comparing?: number[]
+    /** 已完成的元素 */
+    completed?: number[]
+  }
+  /** 当前操作范围 */
+  range?: { left: number; right: number }
+}
+
+/**
+ * DP表可视化步骤
+ */
+export interface DPTableVisualStep extends VisualStep {
+  /** 当前DP表状态 */
+  dpTable: number[][]
+  /** 当前处理的单元格 */
+  currentCell?: { row: number; col: number }
+  /** 依赖的单元格 */
+  dependencies?: Array<{ row: number; col: number }>
+  /** 当前计算的值 */
+  currentValue?: number
+}
+
+/**
+ * 回溯算法可视化步骤
+ */
+export interface BacktrackVisualStep extends VisualStep {
+  /** 当前路径 */
+  path: any[]
+  /** 可选项 */
+  choices?: any[]
+  /** 当前选择 */
+  currentChoice?: any
+  /** 是否回溯 */
+  isBacktracking?: boolean
+  /** 已使用的元素 */
+  used?: boolean[]
+}
+
+/**
+ * 图算法可视化步骤
+ */
+export interface GraphVisualStep extends VisualStep {
+  /** 图的状态 */
+  graph: any[][]
+  /** 已访问的节点 */
+  visited: Set<string> | boolean[]
+  /** 当前节点 */
+  current?: number | string
+  /** 队列/栈状态 */
+  queue?: any[]
+}
+

package/types/algorithm.d.ts

@@ -0,0 +1,85 @@
+/**
+ * 算法相关类型定义
+ */
+
+/**
+ * 背包物品接口
+ */
+export interface KnapsackItem {
+  /** 物品名称 */
+  name?: string
+  /** 物品重量 */
+  weight: number
+  /** 物品价值 */
+  value: number
+}
+
+/**
+ * 背包问题结果
+ */
+export interface KnapsackResult {
+  /** 最大价值 */
+  maxValue: number
+  /** 选中的物品索引 */
+  selectedItems: number[]
+  /** DP表(用于调试) */
+  dpTable?: number[][]
+}
+
+/**
+ * 最长公共子序列结果
+ */
+export interface LCSResult {
+  /** 最长公共子序列长度 */
+  length: number
+  /** 最长公共子序列字符串 */
+  sequence: string
+  /** DP表(用于调试) */
+  dpTable?: number[][]
+}
+
+/**
+ * 最长递增子序列结果
+ */
+export interface LISResult {
+  /** 最长递增子序列长度 */
+  length: number
+  /** 最长递增子序列 */
+  sequence: number[]
+  /** DP数组(用于调试) */
+  dp?: number[]
+}
+
+/**
+ * 编辑距离结果
+ */
+export interface EditDistanceResult {
+  /** 最小编辑距离 */
+  distance: number
+  /** 操作步骤 */
+  operations: EditOperation[]
+  /** DP表(用于调试) */
+  dpTable?: number[][]
+}
+
+/**
+ * 编辑操作类型
+ */
+export type EditOperationType = 'insert' | 'delete' | 'replace' | 'keep'
+
+/**
+ * 编辑操作
+ */
+export interface EditOperation {
+  /** 操作类型 */
+  type: EditOperationType
+  /** 源字符串位置 */
+  sourceIndex: number
+  /** 目标字符串位置 */
+  targetIndex: number
+  /** 源字符 */
+  sourceChar?: string
+  /** 目标字符 */
+  targetChar?: string
+}
+