zcw-shared 1.46.1 → 1.47.0

package/references/device.d.ts

@@ -2,6 +2,7 @@
  * 设备 API 类型定义
  * 包含浏览器端设备相关的 Web API 接口
  */
+import type { HTMLElement } from './dom.d'
 
 // 蓝牙相关类型
 export interface BluetoothDevice {
@@ -185,6 +186,51 @@ export interface MediaStreamConstraints {
   audio?: boolean | { echoCancellation?: boolean; noiseSuppression?: boolean; autoGainControl?: boolean }
 }
 
+// MediaRecorder 相关类型
+export interface MediaRecorder {
+  state: 'inactive' | 'recording' | 'paused'
+  stream: MediaStream
+  mimeType: string
+  ondataavailable: ((event: { data: Blob }) => void) | null
+  onerror: ((event: { error: Error }) => void) | null
+  onstop: (() => void) | null
+  start(timeslice?: number): void
+  stop(): void
+  pause(): void
+  resume(): void
+  requestData(): void
+}
+
+export interface MediaRecorderOptions {
+  mimeType?: string
+  audioBitsPerSecond?: number
+  videoBitsPerSecond?: number
+  bitsPerSecond?: number
+}
+
+export interface MediaRecorderConstructor {
+  new (stream: MediaStream, options?: MediaRecorderOptions): MediaRecorder
+  isTypeSupported(mimeType: string): boolean
+}
+
+// Audio 相关类型
+export interface Audio extends HTMLElement {
+  src: string
+  currentTime: number
+  duration: number
+  paused: boolean
+  volume: number
+  onerror: ((event: { error: Error }) => void) | null
+  onended: (() => void) | null
+  play(): Promise<void>
+  pause(): void
+  load(): void
+}
+
+export interface AudioConstructor {
+  new (src?: string): Audio
+}
+
 // 电池相关类型
 export interface BatteryManager {
   charging: boolean

package/references/dom.d.ts

@@ -76,6 +76,12 @@ export interface HTMLLinkElement extends HTMLElement {
   onerror: (() => void) | null
 }
 
+export interface HTMLAnchorElement extends HTMLElement {
+  href: string
+  download: string
+  click(): void
+}
+
 export interface HTMLIFrameElement extends HTMLElement {
   src: string
   onload: (() => void) | null

package/references/uniapp.d.ts

@@ -1,12 +1,20 @@
 // UniApp 环境类型声明
 
+/**
+ * UniApp 通用错误类型
+ */
+export interface UniError {
+  errMsg: string
+  [key: string]: unknown
+}
+
 /**
  * UniApp 页面实例接口
  */
 export interface UniPage {
   route: string
-  options: Record<string, any>
-  $vm: any
+  options: Record<string, unknown>
+  $vm: unknown
 }
 
 /**
@@ -15,7 +23,7 @@ export interface UniPage {
  */
 export interface UniApp {
   // 页面管理
-  getCurrentPages(): any[]
+  getCurrentPages(): UniPage[]
   
   // 路由导航
   navigateTo(options: { url: string; success?: () => void; fail?: () => void }): void
@@ -31,11 +39,12 @@ export interface UniApp {
   showActionSheet(options: { itemList: string[]; success?: (res: { tapIndex: number }) => void }): void
   
   // 系统信息
-  getSystemInfo(options: { success?: (res: any) => void; fail?: () => void }): void
+  getSystemInfo(options: { success?: (res: Record<string, unknown>) => void; fail?: () => void }): void
+  getProvider(options: { service: string; success?: (res: { provider: string[] }) => void; fail?: () => void }): void
   
   // 本地存储
-  getStorageSync(key: string): any
-  setStorageSync(key: string, data: any): void
+  getStorageSync(key: string): unknown
+  setStorageSync(key: string, data: unknown): void
   removeStorageSync(key: string): void
   clearStorageSync(): void
   
@@ -43,9 +52,213 @@ export interface UniApp {
   request(options: {
     url: string
     method?: 'GET' | 'POST' | 'PUT' | 'DELETE'
-    data?: any
+    data?: unknown
     header?: Record<string, string>
-    success?: (res: any) => void
+    success?: (res: { data: unknown; statusCode: number; header: Record<string, string> }) => void
     fail?: () => void
   }): void
+  
+  // 图片选择/拍照
+  chooseImage(options: {
+    count?: number
+    sizeType?: ('original' | 'compressed')[]
+    sourceType?: ('album' | 'camera')[]
+    success?: (res: { tempFilePaths: string[]; tempFiles: Array<{ path: string; size: number; type?: string; name?: string }>; errMsg: string }) => void
+    fail?: (err: UniError) => void
+  }): void
+  
+  // 视频选择/录制
+  chooseVideo(options: {
+    sourceType?: ('album' | 'camera')[]
+    compressed?: boolean
+    maxDuration?: number
+    camera?: 'back' | 'front'
+    success?: (res: { tempFilePath: string; duration: number; size: number; width: number; height: number; errMsg: string }) => void
+    fail?: (err: UniError) => void
+  }): void
+  
+  // 扫码
+  scanCode(options: {
+    onlyFromCamera?: boolean
+    scanType?: ('qrCode' | 'barCode')[]
+    autoDecodeCharSet?: boolean
+    success?: (res: { result: string; scanType: string; charSet: string; path: string; errMsg: string }) => void
+    fail?: (err: UniError) => void
+  }): void
+  
+  // 录音
+  startRecord(options: {
+    duration?: number
+    sampleRate?: number
+    numberOfChannels?: number
+    encodeBitRate?: number
+    format?: 'mp3' | 'aac' | 'wav'
+    frameSize?: number
+    success?: (res: { tempFilePath: string; duration: number; fileSize: number; errMsg: string }) => void
+    fail?: (err: UniError) => void
+  }): void
+  stopRecord(): void
+  
+  // 文件系统
+  readFile(options: {
+    filePath: string
+    encoding?: string
+    success?: (res: { data: string | ArrayBuffer; errMsg: string }) => void
+    fail?: (err: UniError) => void
+  }): void
+  writeFile(options: {
+    filePath: string
+    data: string | ArrayBuffer
+    encoding?: string
+    success?: (res: { errMsg: string }) => void
+    fail?: (err: UniError) => void
+  }): void
+  
+  // 登录
+  login(options: {
+    provider?: string
+    success?: (res: { code: string; errMsg: string; authResult?: unknown }) => void
+    fail?: (err: UniError) => void
+  }): void
+  getUserInfo(options: {
+    withCredentials?: boolean
+    success?: (res: { userInfo: Record<string, unknown>; errMsg: string }) => void
+    fail?: (err: UniError) => void
+  }): void
+  
+  // 支付
+  requestPayment(options: {
+    provider?: string
+    timeStamp?: string
+    nonceStr?: string
+    package?: string
+    signType?: string
+    paySign?: string
+    orderInfo?: string | Record<string, unknown>
+    success?: (res: { errMsg: string; transactionId?: string }) => void
+    fail?: (err: UniError) => void
+    complete?: (res: { errMsg?: string }) => void
+  }): void
+  
+  // 手机号
+  getPhoneNumber(options: {
+    success?: (res: { code: string; encryptedData?: string; iv?: string; cloudID?: string; errMsg: string }) => void
+    fail?: (err: UniError) => void
+  }): void
+  
+  // 客服
+  openCustomerServiceConversation(options: {
+    sessionFrom?: string
+    success?: (res: { errMsg: string }) => void
+    fail?: (err: UniError) => void
+  }): void
+  
+  // 订阅消息
+  requestSubscribeMessage(options: {
+    tmplIds: string[]
+    success?: (res: Record<string, string> & { errMsg: string }) => void
+    fail?: (err: UniError) => void
+  }): void
+  
+  // 分享
+  showShareMenu(options: {
+    withShareTicket?: boolean
+    menus?: string[]
+    success?: (res: { errMsg: string }) => void
+    fail?: (err: UniError) => void
+  }): void
+  
+  // 文件上传
+  uploadFile(options: {
+    url: string
+    filePath: string
+    name: string
+    success?: (res: { data: string; statusCode: number; errMsg: string }) => void
+    fail?: (err: UniError) => void
+  }): void
+  
+  // 客服
+  openCustomerServiceChat?: (options: {
+    corpId: string
+    extInfo?: Record<string, unknown>
+    showMessageCard?: boolean
+    sendMessageTitle?: string
+    sendMessagePath?: string
+    sendMessageImg?: string
+    success?: (res: { errMsg?: string }) => void
+    fail?: (err: UniError) => void
+  }) => void
+  
+  // 录音管理器
+  getRecorderManager(): UniNamespace.RecorderManager
+  
+  // 音频上下文
+  createInnerAudioContext(): UniNamespace.InnerAudioContext
+  
+  // 文件系统管理器
+  getFileSystemManager(): UniNamespace.FileSystemManager
+}
+
+/**
+ * UniApp 命名空间扩展
+ */
+export declare namespace UniNamespace {
+  interface RecorderManager {
+    start(options: {
+      duration?: number
+      sampleRate?: number
+      numberOfChannels?: number
+      encodeBitRate?: number
+      format?: 'mp3' | 'aac' | 'wav'
+      frameSize?: number
+    }): void
+    stop(): void
+    onStart(callback: () => void): void
+    onStop(callback: (res: { tempFilePath: string; duration: number; fileSize: number; errMsg: string }) => void): void
+    onError(callback: (err: { errMsg: string }) => void): void
+  }
+  
+  interface InnerAudioContext {
+    src: string
+    play(): void
+    destroy(): void
+    onPlay(callback: () => void): void
+    onEnded(callback: () => void): void
+    onError(callback: (err: UniError) => void): void
+  }
+  
+  interface FileSystemManager {
+    readFile(options: {
+      filePath: string
+      encoding?: string
+      success?: (res: { data: string | ArrayBuffer }) => void
+      fail?: (err: UniError) => void
+    }): void
+    writeFile(options: {
+      filePath: string
+      data: string | ArrayBuffer
+      encoding?: string
+      success?: (res: { errMsg?: string }) => void
+      fail?: (err: UniError) => void
+    }): void
+    mkdir(options: {
+      dirPath: string
+      recursive?: boolean
+      success?: () => void
+      fail?: (err: UniError) => void
+    }): void
+  }
+  
+  interface RequestPaymentOptions {
+    provider: string
+    timeStamp?: string
+    nonceStr?: string
+    package?: string
+    signType?: string
+    paySign?: string
+    orderInfo?: string
+    success?: (res: { errMsg: string; transactionId?: string }) => void
+    fail?: (err: UniError) => void
+    complete?: (res: { errMsg?: string }) => void
+  }
 }

package/types/uniapp-ios-build.d.ts

@@ -78,6 +78,26 @@ export interface SinaShareIOSOptions {
   weiboSDKBundlePath?: string
 }
 
+/**
+ * Camera/Gallery 配置（iOS）
+ */
+export interface CameraGalleryIOSOptions {
+  /** liblibCamera.a 文件路径 */
+  liblibCameraPath?: string
+  /** DCTZImagePickerController.bundle 文件路径 */
+  dctzImagePickerControllerBundlePath?: string
+  /** DCMediaEditingController.bundle 文件路径 */
+  dcMediaEditingControllerBundlePath?: string
+  /** 相机权限描述 */
+  cameraUsageDescription?: string
+  /** 相册读取权限描述 */
+  photoLibraryUsageDescription?: string
+  /** 相册写入权限描述 */
+  photoLibraryAddUsageDescription?: string
+  /** 麦克风权限描述 */
+  microphoneUsageDescription?: string
+}
+
 /**
  * UniApp 原生插件配置（iOS）
  */
@@ -128,6 +148,8 @@ export interface UniAppIOSBuildOptions extends IOSBuildOptions {
   qqShare?: QQShareIOSOptions
   /** 新浪微博分享配置（可选） */
   sinaShare?: SinaShareIOSOptions
+  /** Camera/Gallery 配置（可选） */
+  cameraGallery?: CameraGalleryIOSOptions
   /** UniApp 原生插件配置列表（可选） */
   nativePlugins?: UniAppNativePluginIOSOptions[]
   /** 源码目录名称（可选，如果 .xcodeproj 文件名与实际源码目录不一致时需要指定，默认从 .xcodeproj 推断） */

package/types/uniapp.d.ts

@@ -0,0 +1,298 @@
+/**
+ * UniApp 相关类型定义
+ */
+
+// 图片相关
+export interface ImageOptions {
+  count?: number
+  sizeType?: ('original' | 'compressed')[]
+  sourceType?: ('album' | 'camera')[]
+  crop?: boolean
+  extraData?: Record<string, any>
+}
+
+export interface ImageResult {
+  errMsg?: string
+  tempFilePaths?: string[]
+  tempFiles?: Array<{
+    path: string
+    size: number
+    type?: string
+    name?: string
+  }>
+  raw?: any
+}
+
+// 视频相关
+export interface VideoOptions {
+  sourceType?: ('album' | 'camera')[]
+  compressed?: boolean
+  maxDuration?: number
+  camera?: 'back' | 'front'
+  extraData?: Record<string, any>
+}
+
+export interface VideoResult {
+  errMsg?: string
+  tempFilePath?: string
+  duration?: number
+  size?: number
+  width?: number
+  height?: number
+  raw?: any
+}
+
+// 扫码相关
+export interface ScanCodeOptions {
+  onlyFromCamera?: boolean
+  scanType?: ('qrCode' | 'barCode')[]
+  autoDecodeCharSet?: boolean
+  extraData?: Record<string, any>
+}
+
+export interface ScanCodeResult {
+  errMsg?: string
+  result?: string
+  scanType?: string
+  charSet?: string
+  path?: string
+  raw?: any
+}
+
+// 录音相关
+export interface RecordOptions {
+  duration?: number
+  sampleRate?: number
+  numberOfChannels?: number
+  encodeBitRate?: number
+  format?: 'mp3' | 'aac' | 'wav'
+  frameSize?: number
+  extraData?: Record<string, any>
+}
+
+export interface RecordResult {
+  errMsg?: string
+  tempFilePath?: string
+  duration?: number
+  fileSize?: number
+  raw?: any
+}
+
+// 文件相关
+export interface FileOptions {
+  filePath?: string
+  data?: string | ArrayBuffer
+  encoding?: 'ascii' | 'base64' | 'binary' | 'hex' | 'ucs2' | 'ucs-2' | 'utf16le' | 'utf-16le' | 'utf8' | 'utf-8'
+  extraData?: Record<string, any>
+}
+
+export interface FileResult {
+  errMsg?: string
+  data?: string | ArrayBuffer
+  filePath?: string
+  savedFilePath?: string
+  raw?: any
+}
+
+// 登录相关
+export interface LoginOptions {
+  provider?: 'weixin' | 'qq' | 'sinaweibo' | 'xiaomi' | 'alipay' | 'baidu' | 'toutiao' | 'douyin'
+  extraData?: Record<string, any>
+}
+
+export interface LoginResult {
+  errMsg?: string
+  code?: string
+  userInfo?: {
+    nickName?: string
+    avatarUrl?: string
+    [key: string]: any
+  }
+  raw?: any
+}
+
+// 支付相关
+export interface PayRequest {
+  appId?: string
+  timeStamp?: string
+  nonceStr?: string
+  package?: string
+  signType?: string
+  paySign?: string
+  orderInfo?: string | Record<string, any>
+  extraData?: Record<string, any>
+  success?: (res: any) => void
+  fail?: (err: any) => void
+  complete?: (res: any) => void
+}
+
+export interface PayResult {
+  errMsg?: string
+  transactionId?: string
+  raw?: any
+}
+
+// 手机号相关
+export interface PhoneRequest {
+  eventDetail?: any
+  rawEvent?: any
+  code?: string
+  encryptedData?: string
+  iv?: string
+  cloudID?: string
+}
+
+export interface PhoneResult {
+  errMsg?: string
+  code?: string
+  encryptedData?: string
+  iv?: string
+  phoneNumber?: string
+  purePhoneNumber?: string
+  countryCode?: string
+  cloudID?: string
+  raw?: any
+}
+
+// 客服相关
+export interface CustomerServiceOptions {
+  sessionFrom?: string
+  sessionFromParam?: string
+  extraData?: Record<string, any>
+  corpId?: string
+  extInfo?: Record<string, any>
+  showMessageCard?: boolean
+  sendMessageTitle?: string
+  sendMessagePath?: string
+  sendMessageImg?: string
+}
+
+export interface CustomerServiceResult {
+  errMsg?: string
+  raw?: any
+}
+
+// 订阅消息相关
+export interface SubscribeMessageOptions {
+  tmplIds?: string[]
+  tmplId?: string
+  scene?: string
+  extraData?: Record<string, any>
+}
+
+export interface SubscribeMessageResult {
+  errMsg?: string
+  [tmplId: string]: string | any | undefined
+  raw?: any
+}
+
+// 分享相关
+export type ShareContentType = 
+  | 'link'
+  | 'text'
+  | 'image'
+  | 'music'
+  | 'video'
+  | 'miniapp'
+
+export type ShareTarget = 
+  | 'wechat'
+  | 'timeline'
+  | 'favorite'
+  | 'copy'
+  | 'system'
+
+export interface ShareOptions {
+  type: ShareContentType
+  title?: string
+  description?: string
+  image?: string
+  url?: string
+  target?: ShareTarget | ShareTarget[]
+  miniapp?: {
+    id: string
+    path: string
+    version?: 'release' | 'develop' | 'trial'
+    webUrl?: string
+  }
+  music?: {
+    url: string
+    dataUrl?: string
+  }
+  video?: {
+    url: string
+  }
+  text?: string
+  imageUrl?: string
+}
+
+export interface ShareResult {
+  success: boolean
+  message?: string
+  data?: {
+    shareTicket?: string
+    [key: string]: any
+  }
+  error?: {
+    code: string | number
+    message: string
+    details?: any
+  }
+}
+
+export interface ShareCapability {
+  available: boolean
+  supportedTypes: ShareContentType[]
+  supportedTargets: ShareTarget[]
+  reason?: string
+}
+
+// WebView 相关
+export interface WebViewOptions {
+  url: string
+  title?: string
+  showLoading?: boolean
+  loadingText?: string
+  extraData?: Record<string, any>
+}
+
+export interface WebViewResult {
+  errMsg?: string
+  success?: boolean
+  raw?: any
+}
+
+// 用户信息相关
+export interface UserInfoOptions {
+  withCredentials?: boolean
+  extraData?: Record<string, any>
+}
+
+export interface UserInfoResult {
+  errMsg?: string
+  userInfo?: {
+    nickName?: string
+    avatarUrl?: string
+    gender?: number
+    country?: string
+    province?: string
+    city?: string
+    language?: string
+    [key: string]: any
+  }
+  raw?: any
+}
+
+// 房间相关
+export interface CreateRoomOptions {
+  roomName?: string
+  maxPlayers?: number
+}
+
+export interface CreateRoomResult {
+  roomCode: string
+  roomId?: string
+  roomName?: string
+  createdAt?: number
+}
+