zcw-shared 1.21.0 → 1.23.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/eventsource.d.ts

@@ -0,0 +1,121 @@
+// EventSource (Server-Sent Events) 类型声明
+
+/**
+ * EventSource 连接状态
+ */
+export enum EventSourceReadyState {
+  CONNECTING = 0,
+  OPEN = 1,
+  CLOSED = 2
+}
+
+/**
+ * EventSource 事件接口
+ */
+export interface EventSourceEventMap {
+  open: Event
+  message: MessageEvent
+  error: Event
+}
+
+/**
+ * EventSource 消息事件
+ */
+export interface MessageEvent extends Event {
+  readonly data: string
+  readonly lastEventId: string
+  readonly origin: string
+}
+
+/**
+ * EventSource 配置选项
+ */
+export interface EventSourceInit {
+  withCredentials?: boolean
+}
+
+/**
+ * EventSource 构造函数类型
+ */
+export interface EventSourceConstructor {
+  new (url: string | URL, eventSourceInitDict?: EventSourceInit): EventSource
+  readonly CONNECTING: 0
+  readonly OPEN: 1
+  readonly CLOSED: 2
+}
+
+/**
+ * EventSource 实例接口
+ */
+export interface EventSource {
+  readonly url: string
+  readonly readyState: number
+  readonly withCredentials: boolean
+  
+  // 事件监听器
+  onopen: ((this: EventSource, ev: Event) => any) | null
+  onmessage: ((this: EventSource, ev: MessageEvent) => any) | null
+  onerror: ((this: EventSource, ev: Event) => any) | null
+  
+  // 方法
+  close(): void
+  addEventListener<K extends keyof EventSourceEventMap>(
+    type: K,
+    listener: (this: EventSource, ev: EventSourceEventMap[K]) => any,
+    options?: boolean | AddEventListenerOptions
+  ): void
+  addEventListener(
+    type: string,
+    listener: (this: EventSource, ev: MessageEvent) => any,
+    options?: boolean | AddEventListenerOptions
+  ): void
+  removeEventListener<K extends keyof EventSourceEventMap>(
+    type: K,
+    listener: (this: EventSource, ev: EventSourceEventMap[K]) => any,
+    options?: boolean | EventListenerOptions
+  ): void
+  removeEventListener(
+    type: string,
+    listener: (this: EventSource, ev: MessageEvent) => any,
+    options?: boolean | EventListenerOptions
+  ): void
+}
+
+/**
+ * 事件监听器选项
+ */
+export interface AddEventListenerOptions {
+  capture?: boolean
+  once?: boolean
+  passive?: boolean
+  signal?: AbortSignal
+}
+
+export interface EventListenerOptions {
+  capture?: boolean
+}
+
+/**
+ * 中止信号
+ */
+export interface AbortSignal {
+  readonly aborted: boolean
+  onabort: ((this: AbortSignal, ev: Event) => any) | null
+}
+
+/**
+ * 事件基础接口
+ */
+export interface Event {
+  readonly type: string
+  readonly target: any
+  readonly currentTarget: any
+  readonly bubbles: boolean
+  readonly cancelable: boolean
+  readonly defaultPrevented: boolean
+  readonly timeStamp: number
+  preventDefault(): void
+  stopPropagation(): void
+  stopImmediatePropagation(): void
+}
+

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/websocket.d.ts

@@ -0,0 +1,121 @@
+// WebSocket 类型声明
+
+/**
+ * WebSocket 连接状态
+ */
+export enum WebSocketReadyState {
+  CONNECTING = 0,
+  OPEN = 1,
+  CLOSING = 2,
+  CLOSED = 3
+}
+
+/**
+ * WebSocket 事件接口
+ */
+export interface WebSocketEventMap {
+  close: CloseEvent
+  error: Event
+  message: MessageEvent
+  open: Event
+}
+
+/**
+ * WebSocket 关闭事件
+ */
+export interface CloseEvent extends Event {
+  readonly code: number
+  readonly reason: string
+  readonly wasClean: boolean
+}
+
+/**
+ * WebSocket 消息事件
+ */
+export interface MessageEvent extends Event {
+  readonly data: any
+  readonly origin: string
+  readonly lastEventId: string
+}
+
+/**
+ * WebSocket 构造函数类型
+ */
+export interface WebSocketConstructor {
+  new (url: string | URL, protocols?: string | string[]): WebSocket
+  readonly CONNECTING: 0
+  readonly OPEN: 1
+  readonly CLOSING: 2
+  readonly CLOSED: 3
+}
+
+/**
+ * WebSocket 实例接口
+ */
+export interface WebSocket {
+  readonly url: string
+  readonly readyState: number
+  readonly bufferedAmount: number
+  readonly extensions: string
+  readonly protocol: string
+  binaryType: 'blob' | 'arraybuffer'
+  
+  // 事件监听器
+  onopen: ((this: WebSocket, ev: Event) => any) | null
+  onmessage: ((this: WebSocket, ev: MessageEvent) => any) | null
+  onerror: ((this: WebSocket, ev: Event) => any) | null
+  onclose: ((this: WebSocket, ev: CloseEvent) => any) | null
+  
+  // 方法
+  send(data: string | ArrayBufferLike | Blob | ArrayBufferView): void
+  close(code?: number, reason?: string): void
+  addEventListener<K extends keyof WebSocketEventMap>(
+    type: K,
+    listener: (this: WebSocket, ev: WebSocketEventMap[K]) => any,
+    options?: boolean | AddEventListenerOptions
+  ): void
+  removeEventListener<K extends keyof WebSocketEventMap>(
+    type: K,
+    listener: (this: WebSocket, ev: WebSocketEventMap[K]) => any,
+    options?: boolean | EventListenerOptions
+  ): void
+}
+
+/**
+ * 事件监听器选项
+ */
+export interface AddEventListenerOptions {
+  capture?: boolean
+  once?: boolean
+  passive?: boolean
+  signal?: AbortSignal
+}
+
+export interface EventListenerOptions {
+  capture?: boolean
+}
+
+/**
+ * 中止信号
+ */
+export interface AbortSignal {
+  readonly aborted: boolean
+  onabort: ((this: AbortSignal, ev: Event) => any) | null
+}
+
+/**
+ * 事件基础接口
+ */
+export interface Event {
+  readonly type: string
+  readonly target: any
+  readonly currentTarget: any
+  readonly bubbles: boolean
+  readonly cancelable: boolean
+  readonly defaultPrevented: boolean
+  readonly timeStamp: number
+  preventDefault(): void
+  stopPropagation(): void
+  stopImmediatePropagation(): void
+}
+