zcw-shared 1.4.0 → 1.7.0

package/references/node.d.ts

@@ -1,111 +1,116 @@
-// Node.js 类型定义文件
-// 仅包含必要的 Node.js 类型，避免全局污染
-import type { ConsoleInterface } from './console.d'
-
-export namespace Node {
-  interface ReadableStream {
-    [key: string]: any
-  }
-
-  interface WritableStream {
-    [key: string]: any
-  }
-
-  interface Process {
-    env: Record<string, string | undefined>
-    argv: string[]
-    cwd(): string
-    exit(code?: number): never
-    [key: string]: any
-  }
-
-  interface Buffer {
-    length: number
-    toString(encoding?: string): string
-    [key: string]: any
-  }
-  interface FileSystem {
-    readFile(path: string): Promise<any>
-    writeFile(path: string, data: any): Promise<void>
-    mkdir(path: string, options?: any): Promise<void>
-    [key: string]: any
-  }
-
-  interface Path {
-    join(...paths: string[]): string
-    resolve(...paths: string[]): string
-    dirname(path: string): string
-    basename(path: string, ext?: string): string
-    extname(path: string): string
-    [key: string]: any
-  }
-
-  interface ChildProcess {
-    exec(command: string, callback?: (error: any, stdout: string, stderr: string) => void): any
-    [key: string]: any
-  }
-
-  interface Util {
-    promisify<T extends (...args: any[]) => any>(fn: T): (...args: Parameters<T>) => Promise<any>
-    [key: string]: any
-  }
-
-  interface BufferConstructor {
-    from(str: string, encoding?: string): Buffer
-  }
-}
-
-// NodeJS 命名空间
-export namespace NodeJS {
-  interface Timeout {
-    ref(): this
-    unref(): this
-    hasRef(): boolean
-    refresh(): this
-    [Symbol.toPrimitive](): number
-  }
-
-  interface Immediate {
-    ref(): this
-    unref(): this
-    hasRef(): boolean
-    _onImmediate: Function
-  }
-}
-
-// 定时器函数
-export function setImmediate(callback: (...args: any[]) => void, ...args: any[]): NodeJS.Immediate
-export function clearImmediate(immediateId: NodeJS.Immediate): void
-
-
-// 导出 Node.js 相关类型
-export type NodeFileSystem = Node.FileSystem
-export type NodePath = Node.Path
-export type NodeChildProcess = Node.ChildProcess
-export type NodeUtil = Node.Util
-export type NodeProcess = Node.Process
-export type NodeBuffer = Node.Buffer
-export type NodeBufferConstructor = Node.BufferConstructor
-export type NodeReadableStream = Node.ReadableStream
-export type NodeWritableStream = Node.WritableStream
-
-// 导出 NodeJS 命名空间类型
-export type NodeTimeout = NodeJS.Timeout
-export type NodeImmediate = NodeJS.Immediate
-
-// 重新导出函数类型
-export { setImmediate, clearImmediate }
-
-// Node.js 调试环境接口
-export interface NodeEnvironment {
-  process: NodeProcess
-  fs: NodeFileSystem
-  path: NodePath
-  childProcess: NodeChildProcess
-  util: NodeUtil
-  Buffer: NodeBufferConstructor
-  console: ConsoleInterface
-  setImmediate: typeof setImmediate
-  clearImmediate: typeof clearImmediate
-  __DEV__?: boolean
-}
+// Node.js 环境类型声明 - 统一的Global接口
+import type { Console } from './console.d'
+import type { TextDecoderConstructor, TextEncoderConstructor } from './encoding.d'
+import type { ArrayBufferConstructor, Uint8ArrayConstructor, DataViewConstructor } from './arraybuffer.d'
+
+// 基础类型定义
+export interface ReadableStream {
+  // ReadableStream 基本接口
+}
+
+export interface WritableStream {
+  // WritableStream 基本接口
+}
+
+export interface Process {
+  env: Record<string, string | undefined>
+  argv: string[]
+  platform: string
+  cwd(): string
+  exit(code?: number): never
+}
+
+export interface Buffer {
+  length: number
+  toString(encoding?: string): string
+}
+
+export interface FileSystem {
+  readFile(path: string, encoding?: string): Promise<any>
+  readFileSync(path: string, encoding?: string): string
+  writeFile(path: string, data: any): Promise<void>
+  writeFileSync(path: string, data: any, encoding?: string): void
+  mkdir(path: string, options?: any): Promise<void>
+  mkdirSync(path: string, options?: any): void
+  copyFileSync(src: string, dest: string): void
+  existsSync(path: string): boolean
+  readdirSync(path: string): string[]
+  promises: {
+    cp(source: string, destination: string, options?: any): Promise<void>
+  }
+}
+
+export interface Path {
+  join(...paths: string[]): string
+  resolve(...paths: string[]): string
+  dirname(path: string): string
+  basename(path: string, ext?: string): string
+  extname(path: string): string
+}
+
+export interface ChildProcess {
+  exec(command: string, callback?: (error: any, stdout: string, stderr: string) => void): any
+}
+
+export interface Util {
+  promisify<T extends (...args: any[]) => any>(fn: T): (...args: Parameters<T>) => Promise<any>
+}
+
+export interface BufferConstructor {
+  from(str: string, encoding?: string): Buffer
+}
+
+export interface Timeout {
+  ref(): this
+  unref(): this
+  hasRef(): boolean
+  refresh(): this
+  [Symbol.toPrimitive](): number
+}
+
+export interface Immediate {
+  ref(): this
+  unref(): this
+  hasRef(): boolean
+  _onImmediate: Function
+}
+
+// Node.js Global对象 - 包含所有Node.js API
+export interface Global {
+  // 进程对象
+  process: Process
+  
+  // 控制台
+  console: Console
+  
+  // Buffer API
+  Buffer: BufferConstructor
+  
+  // 编码API
+  TextDecoder: TextDecoderConstructor
+  TextEncoder: TextEncoderConstructor
+  
+  // 定时器API
+  setTimeout(callback: (...args: any[]) => void, ms?: number, ...args: any[]): Timeout
+  clearTimeout(timeoutId: Timeout): void
+  setInterval(callback: (...args: any[]) => void, ms?: number, ...args: any[]): Timeout
+  clearInterval(intervalId: Timeout): void
+  setImmediate(callback: (...args: any[]) => void, ...args: any[]): Immediate
+  clearImmediate(immediateId: Immediate): void
+  
+  // 类型化数组
+  ArrayBuffer: ArrayBufferConstructor
+  Uint8Array: Uint8ArrayConstructor
+  DataView: DataViewConstructor
+  
+  // 全局变量
+  __dirname?: string
+  __filename?: string
+  
+  // 开发环境标识
+  __DEV__?: boolean
+}
+
+// 定时器函数
+export declare function setImmediate(callback: (...args: any[]) => void, ...args: any[]): Immediate
+export declare function clearImmediate(immediateId: Immediate): void

package/references/sharp.d.ts

@@ -1,19 +1,19 @@
-import type { NodeBuffer } from './node.d'
-
-/**
- * Sharp 图像处理库的类型定义
- */
-
-export interface SharpInstance {
-  metadata(): Promise<{ width?: number; height?: number }>;
-  resize(width: number, height: number): SharpInstance;
-  composite(images: Array<{ input: NodeBuffer; top: number; left: number; blend?: string }>): SharpInstance;
-  extend(options: { top: number; bottom: number; left: number; right: number; background: { r: number; g: number; b: number; alpha: number } }): SharpInstance;
-  flatten(options?: { background?: string | { r: number; g: number; b: number } }): SharpInstance;
-  negate(options?: boolean): SharpInstance;
-  toBuffer(): Promise<NodeBuffer>;
-}
-
-export interface Sharp {
-  (input: NodeBuffer): SharpInstance;
+import type { NodeBuffer } from './node.d'
+
+/**
+ * Sharp 图像处理库的类型定义
+ */
+
+export interface SharpInstance {
+  metadata(): Promise<{ width?: number; height?: number }>;
+  resize(width: number, height: number): SharpInstance;
+  composite(images: Array<{ input: NodeBuffer; top: number; left: number; blend?: string }>): SharpInstance;
+  extend(options: { top: number; bottom: number; left: number; right: number; background: { r: number; g: number; b: number; alpha: number } }): SharpInstance;
+  flatten(options?: { background?: string | { r: number; g: number; b: number } }): SharpInstance;
+  negate(options?: boolean): SharpInstance;
+  toBuffer(): Promise<NodeBuffer>;
+}
+
+export interface Sharp {
+  (input: NodeBuffer): SharpInstance;
 }

package/references/storage.d.ts

@@ -1,112 +1,18 @@
-/**
- * 存储环境类型定义
- * 包含浏览器和其他环境的存储 API 类型支持
- */
-
-/**
- * 基础存储接口
- * 对应浏览器的 localStorage 和 sessionStorage API
- */
-export interface StorageInterface {
-  getItem(key: string): string | null
-  setItem(key: string, value: string): void
-  removeItem(key: string): void
-  clear(): void
-}
-
-/**
- * IndexedDB 工厂接口
- * 已在 browser.d.ts 中定义，这里重新导出以保持一致性
- */
-export interface IDBFactory {
-  open(name: string, version?: number): IDBOpenDBRequest
-}
-
-/**
- * IndexedDB 请求接口
- */
-export interface IDBOpenDBRequest extends EventTarget {
-  result: IDBDatabase
-  error: DOMException | null
-  onsuccess: ((event: Event) => void) | null
-  onerror: ((event: Event) => void) | null
-  onupgradeneeded: ((event: IDBVersionChangeEvent) => void) | null
-}
-
-/**
- * IndexedDB 数据库接口
- */
-export interface IDBDatabase {
-  objectStoreNames: DOMStringList
-  createObjectStore(name: string, options?: IDBObjectStoreParameters): IDBObjectStore
-  transaction(storeNames: string | string[], mode?: IDBTransactionMode): IDBTransaction
-}
-
-/**
- * IndexedDB 对象存储接口
- */
-export interface IDBObjectStore {
-  get(key: IDBValidKey): IDBRequest
-  put(value: any, key?: IDBValidKey): IDBRequest
-  delete(key: IDBValidKey): IDBRequest
-  clear(): IDBRequest
-}
-
-/**
- * IndexedDB 事务接口
- */
-export interface IDBTransaction {
-  objectStore(name: string): IDBObjectStore
-}
-
-/**
- * IndexedDB 请求接口
- */
-export interface IDBRequest {
-  result: any
-  error: DOMException | null
-  onsuccess: ((event: Event) => void) | null
-  onerror: ((event: Event) => void) | null
-}
-
-/**
- * IndexedDB 版本变更事件接口
- */
-export interface IDBVersionChangeEvent extends Event {
-  target: IDBOpenDBRequest
-}
-
-/**
- * DOM 字符串列表接口
- */
-export interface DOMStringList {
-  contains(string: string): boolean
-}
-
-/**
- * IndexedDB 有效键类型
- */
-export type IDBValidKey = string | number | Date | ArrayBuffer | IDBValidKey[]
-
-/**
- * IndexedDB 事务模式类型
- */
-export type IDBTransactionMode = 'readonly' | 'readwrite' | 'versionchange'
-
-/**
- * IndexedDB 对象存储参数接口
- */
-export interface IDBObjectStoreParameters {
-  keyPath?: string | string[]
-  autoIncrement?: boolean
-}
-
-/**
- * 存储环境接口
- * 包含所有存储相关的环境 API
- */
-export interface StorageEnvironment {
-  localStorage?: StorageInterface
-  sessionStorage?: StorageInterface
-  indexedDB?: IDBFactory
+/**
+ * 存储环境类型定义
+ * 包含浏览器和其他环境的存储 API 类型支持
+ */
+
+/**
+ * 基础存储接口
+ * 对应浏览器的 localStorage 和 sessionStorage API
+ */
+export interface Storage {
+  readonly length: number
+  clear(): void
+  getItem(key: string): string | null
+  key(index: number): string | null
+  removeItem(key: string): void
+  setItem(key: string, value: string): void
+  [name: string]: any
 }

package/references/timer.d.ts

@@ -1,46 +1,45 @@
-/**
- * 定时器 API 类型定义
- * 包含浏览器和 Node.js 环境都支持的定时器相关 API
- */
-
-/**
- * 设置定时器
- * @param callback 回调函数
- * @param ms 延迟时间（毫秒）
- * @param args 传递给回调函数的参数
- * @returns 定时器 ID
- */
-export declare const setTimeout: (callback: (...args: any[]) => void, ms?: number, ...args: any[]) => any
-
-/**
- * 清除定时器
- * @param timeoutId 定时器 ID
- */
-export declare const clearTimeout: (timeoutId: any) => void
-
-/**
- * 设置间隔定时器
- * @param callback 回调函数
- * @param ms 间隔时间（毫秒）
- * @param args 传递给回调函数的参数
- * @returns 间隔定时器 ID
- */
-export declare const setInterval: (callback: (...args: any[]) => void, ms?: number, ...args: any[]) => any
-
-/**
- * 清除间隔定时器
- * @param intervalId 间隔定时器 ID
- */
-export declare const clearInterval: (intervalId: any) => void
-
-/**
- * 定时器环境类型定义
- */
-export interface TimerEnvironment {
-  setTimeout: typeof setTimeout
-  clearTimeout: typeof clearTimeout
-  setInterval: typeof setInterval
-  clearInterval: typeof clearInterval
-}
-
-// 定时器函数已在上面导出
+/**
+ * 定时器 API 类型定义
+ * 包含浏览器和 Node.js 环境都支持的定时器相关 API
+ */
+
+/**
+ * 设置定时器
+ * @param callback 回调函数
+ * @param ms 延迟时间（毫秒）
+ * @param args 传递给回调函数的参数
+ * @returns 定时器 ID
+ */
+export declare const setTimeout: (callback: (...args: any[]) => void, ms?: number, ...args: any[]) => any
+
+/**
+ * 清除定时器
+ * @param timeoutId 定时器 ID
+ */
+export declare const clearTimeout: (timeoutId: any) => void
+
+/**
+ * 设置间隔定时器
+ * @param callback 回调函数
+ * @param ms 间隔时间（毫秒）
+ * @param args 传递给回调函数的参数
+ * @returns 间隔定时器 ID
+ */
+export declare const setInterval: (callback: (...args: any[]) => void, ms?: number, ...args: any[]) => any
+
+/**
+ * 清除间隔定时器
+ * @param intervalId 间隔定时器 ID
+ */
+export declare const clearInterval: (intervalId: any) => void
+
+/**
+ * 定时器环境接口
+ * 包含所有定时器相关的 API
+ */
+export interface Timer {
+  setTimeout: typeof setTimeout
+  clearTimeout: typeof clearTimeout
+  setInterval: typeof setInterval
+  clearInterval: typeof clearInterval
+}

package/references/uniapp.d.ts

@@ -1,9 +1,51 @@
-// UniApp 环境类型声明
-import type { TimerEnvironment } from './timer.d'
-
-export interface UniAppAPI {
-  getCurrentPages(): any[]
-}
-
-// 重新导出定时器环境类型
-export type { TimerEnvironment as TimerAPI } from './timer.d'
+// UniApp 环境类型声明
+
+/**
+ * UniApp 页面实例接口
+ */
+export interface UniPage {
+  route: string
+  options: Record<string, any>
+  $vm: any
+}
+
+/**
+ * UniApp 全局对象
+ * 定义 UniApp 框架的完整能力
+ */
+export interface UniApp {
+  // 页面管理
+  getCurrentPages(): any[]
+  
+  // 路由导航
+  navigateTo(options: { url: string; success?: () => void; fail?: () => void }): void
+  redirectTo(options: { url: string; success?: () => void; fail?: () => void }): void
+  switchTab(options: { url: string; success?: () => void; fail?: () => void }): void
+  navigateBack(options?: { delta?: number; success?: () => void; fail?: () => void }): void
+  reLaunch(options: { url: string; success?: () => void; fail?: () => void }): void
+  
+  // UI 交互
+  showToast(options: { title: string; icon?: 'success' | 'loading' | 'none'; duration?: number }): void
+  hideToast(): void
+  showModal(options: { title?: string; content: string; showCancel?: boolean; success?: (res: { confirm: boolean; cancel: boolean }) => void }): void
+  showActionSheet(options: { itemList: string[]; success?: (res: { tapIndex: number }) => void }): void
+  
+  // 系统信息
+  getSystemInfo(options: { success?: (res: any) => void; fail?: () => void }): void
+  
+  // 本地存储
+  getStorageSync(key: string): any
+  setStorageSync(key: string, data: any): void
+  removeStorageSync(key: string): void
+  clearStorageSync(): void
+  
+  // 网络请求
+  request(options: {
+    url: string
+    method?: 'GET' | 'POST' | 'PUT' | 'DELETE'
+    data?: any
+    header?: Record<string, string>
+    success?: (res: any) => void
+    fail?: () => void
+  }): void
+}