zcw-shared 1.5.0 → 1.8.0

package/references/fetch.d.ts

@@ -1,41 +1,15 @@
-/**
- * Fetch API 类型定义
- * 包含浏览器和 Node.js 环境都支持的 Fetch 相关 API
- */
+import type { BufferSource } from './arraybuffer.d'
 
-/**
- * 请求凭据类型
- */
 type RequestCredentials = 'omit' | 'same-origin' | 'include'
-
-/**
- * 请求缓存类型
- */
 type RequestCache = 'default' | 'no-store' | 'reload' | 'no-cache' | 'force-cache' | 'only-if-cached'
-
-/**
- * 请求重定向类型
- */
 type RequestRedirect = 'follow' | 'error' | 'manual'
-
-/**
- * 引用策略类型
- */
 type ReferrerPolicy = 'no-referrer' | 'no-referrer-when-downgrade' | 'origin' | 'origin-when-cross-origin' | 'same-origin' | 'strict-origin' | 'strict-origin-when-cross-origin' | 'unsafe-url'
-
-/**
- * 请求模式类型
- */
 type RequestMode = 'cors' | 'no-cors' | 'same-origin' | 'navigate'
-
-/**
- * 请求体类型
- */
 type BodyInit = Blob | BufferSource | FormData | URLSearchParams | string
+type HeadersInit = string[][] | Record<string, string> | Headers
+type RequestInfo = Request | string
+type ResponseType = 'basic' | 'cors' | 'default' | 'error' | 'opaque' | 'opaqueredirect'
 
-/**
- * Headers 接口
- */
 export interface Headers {
   append(name: string, value: string): void
   delete(name: string): void
@@ -49,113 +23,42 @@ export interface Headers {
   values(): IterableIterator<string>
 }
 
-/**
- * Headers 构造函数
- */
 export declare const Headers: {
   new (init?: HeadersInit): Headers
 }
 
-/**
- * Headers 初始化类型
- */
-type HeadersInit = string[][] | Record<string, string> | Headers
-
-/**
- * 中止信号接口
- */
 export interface AbortSignal {
-  /** 是否已中止 */
   aborted: boolean
-  
-  /** 中止原因 */
   reason?: any
-  
-  /**
-   * 添加事件监听器
-   * @param type 事件类型
-   * @param listener 监听器函数
-   */
   addEventListener(type: 'abort', listener: () => void): void
-  
-  /**
-   * 移除事件监听器
-   * @param type 事件类型
-   * @param listener 监听器函数
-   */
   removeEventListener(type: 'abort', listener: () => void): void
-  
-  /**
-   * 抛出中止异常（如果已中止）
-   */
   throwIfAborted(): void
 }
 
-/**
- * 中止控制器接口
- */
 export interface AbortController {
-  /** 中止信号 */
   signal: AbortSignal
-  
-  /**
-   * 中止操作
-   * @param reason 中止原因
-   */
   abort(reason?: any): void
 }
 
-/**
- * 中止控制器构造函数
- */
 export declare const AbortController: {
   new (): AbortController
 }
 
-/**
- * 请求初始化选项
- */
 export interface RequestInit {
-  /** HTTP 方法 */
   method?: string
-  
-  /** 请求头 */
   headers?: HeadersInit
-  
-  /** 请求体 */
   body?: BodyInit | null
-  
-  /** 中止信号 */
   signal?: AbortSignal
-  
-  /** 凭据模式 */
   credentials?: RequestCredentials
-  
-  /** 缓存模式 */
   cache?: RequestCache
-  
-  /** 重定向模式 */
   redirect?: RequestRedirect
-  
-  /** 引用页面 */
   referrer?: string
-  
-  /** 引用策略 */
   referrerPolicy?: ReferrerPolicy
-  
-  /** 完整性校验 */
   integrity?: string
-  
-  /** 保持连接 */
   keepalive?: boolean
-  
-  /** 请求模式 */
   mode?: RequestMode
 }
 
-/**
- * Request 接口
- */
 export interface Request {
   readonly url: string
   readonly method: string
@@ -181,21 +84,10 @@ export interface Request {
   text(): Promise<string>
 }
 
-/**
- * Request 构造函数
- */
 export declare const Request: {
   new (input: RequestInfo, init?: RequestInit): Request
 }
 
-/**
- * RequestInfo 类型
- */
-type RequestInfo = Request | string
-
-/**
- * Response 接口
- */
 export interface Response {
   readonly ok: boolean
   readonly status: number
@@ -215,55 +107,18 @@ export interface Response {
   text(): Promise<string>
 }
 
-/**
- * Response 构造函数
- */
 export declare const Response: {
   new (body?: BodyInit | null, init?: ResponseInit): Response
   error(): Response
   redirect(url: string, status?: number): Response
 }
 
-/**
- * Response 初始化选项
- */
 export interface ResponseInit {
   status?: number
   statusText?: string
   headers?: HeadersInit
 }
 
-/**
- * Response 类型
- */
-type ResponseType = 'basic' | 'cors' | 'default' | 'error' | 'opaque' | 'opaqueredirect'
-
-/**
- * Fetch 函数
- */
-export declare function fetch(input: RequestInfo, init?: RequestInit): Promise<Response>
-
-/**
- * Fetch 环境类型定义
- */
-export interface FetchEnvironment {
-  fetch: typeof fetch
-  Request: typeof Request
-  Response: typeof Response
-  Headers: typeof Headers
-  AbortController: typeof AbortController
-}
+export declare function fetch(input: RequestInfo | URL, init?: RequestInit): Promise<Response>
 
-// 导出 Fetch 相关 API
-// 导出类型别名
-export type {
-  RequestCredentials,
-  RequestCache,
-  RequestRedirect,
-  ReferrerPolicy,
-  RequestMode,
-  BodyInit,
-  HeadersInit,
-  RequestInfo,
-  ResponseType
-}
+export type FetchFunction = typeof fetch

package/references/indexeddb.d.ts

@@ -0,0 +1,49 @@
+// IndexedDB 相关类型声明
+
+export interface IDBFactory {
+  open(name: string, version?: number): IDBOpenDBRequest
+}
+
+export interface IDBOpenDBRequest {
+  result: IDBDatabase
+  error: DOMException | null
+  onsuccess: ((event: Event) => void) | null
+  onerror: ((event: Event) => void) | null
+  onupgradeneeded: ((event: IDBVersionChangeEvent) => void) | null
+}
+
+export interface IDBDatabase {
+  objectStoreNames: DOMStringList
+  createObjectStore(name: string, options?: IDBObjectStoreParameters): IDBObjectStore
+  transaction(storeNames: string | string[], mode?: IDBTransactionMode): IDBTransaction
+}
+
+export interface IDBObjectStore {
+  get(key: IDBValidKey): IDBRequest
+  put(value: any, key?: IDBValidKey): IDBRequest
+  delete(key: IDBValidKey): IDBRequest
+  clear(): IDBRequest
+}
+
+export interface IDBTransaction {
+  objectStore(name: string): IDBObjectStore
+}
+
+export interface IDBRequest {
+  result: any
+  error: DOMException | null
+  onsuccess: ((event: Event) => void) | null
+  onerror: ((event: Event) => void) | null
+}
+
+export interface IDBVersionChangeEvent {
+  target: IDBOpenDBRequest
+}
+
+export type IDBValidKey = string | number | Date | ArrayBuffer | IDBValidKey[]
+export type IDBTransactionMode = 'readonly' | 'readwrite' | 'versionchange'
+
+export interface IDBObjectStoreParameters {
+  keyPath?: string | string[]
+  autoIncrement?: boolean
+}

package/references/json5.d.ts

@@ -19,10 +19,3 @@ export interface JSON5Parser {
    */
   stringify(value: any, replacer?: any, space?: string | number): string
 }
-
-/**
- * JSON5 环境类型定义
- */
-export interface JSON5Environment {
-  JSON5: JSON5Parser
-}

package/references/location.d.ts

@@ -0,0 +1,16 @@
+// 位置信息相关类型声明
+
+export interface Location {
+  search: string
+  href: string
+  origin: string
+  pathname: string
+  hash: string
+  protocol: string
+  host: string
+  hostname: string
+  port: string
+  assign(url: string): void
+  reload(forcedReload?: boolean): void
+  replace(url: string): void
+}

package/references/node.d.ts

@@ -1,111 +1,122 @@
-// Node.js 类型定义文件
-// 仅包含必要的 Node.js 类型，避免全局污染
-import type { ConsoleInterface } from './console.d'
+// 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 namespace Node {
-  interface ReadableStream {
-    [key: string]: any
-  }
+export interface WritableStream {
+  // WritableStream 基本接口
+}
 
-  interface WritableStream {
-    [key: string]: any
-  }
+export interface Process {
+  env: Record<string, string | undefined>
+  argv: string[]
+  platform: string
+  cwd(): string
+  exit(code?: number): never
+}
 
-  interface Process {
-    env: Record<string, string | undefined>
-    argv: string[]
-    cwd(): string
-    exit(code?: number): never
-    [key: string]: any
-  }
+export interface Buffer {
+  length: number
+  toString(encoding?: string): string
+}
 
-  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
+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[]
+  statSync(path: string): { isDirectory(): boolean; isFile(): boolean }
+  promises: {
+    cp(source: string, destination: string, options?: any): Promise<void>
   }
+}
 
-  interface Path {
+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
+  sep: string
+  posix: {
     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
+    sep: string
   }
 }
 
-// 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 interface ChildProcess {
+  exec(command: string, callback?: (error: any, stdout: string, stderr: string) => void): any
 }
 
-// 定时器函数
-export function setImmediate(callback: (...args: any[]) => void, ...args: any[]): NodeJS.Immediate
-export function clearImmediate(immediateId: NodeJS.Immediate): void
-
+export interface Util {
+  promisify<T extends (...args: any[]) => any>(fn: T): (...args: Parameters<T>) => Promise<any>
+}
 
-// 导出 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
+export interface BufferConstructor {
+  from(str: string, encoding?: string): Buffer
+}
 
-// 导出 NodeJS 命名空间类型
-export type NodeTimeout = NodeJS.Timeout
-export type NodeImmediate = NodeJS.Immediate
+export interface Timeout {
+  ref(): this
+  unref(): this
+  hasRef(): boolean
+  refresh(): this
+  [Symbol.toPrimitive](): number
+}
 
-// 重新导出函数类型
-export { setImmediate, clearImmediate }
+export interface Immediate {
+  ref(): this
+  unref(): this
+  hasRef(): boolean
+  _onImmediate: Function
+}
 
-// 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
+// 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/storage.d.ts

@@ -7,106 +7,12 @@
  * 基础存储接口
  * 对应浏览器的 localStorage 和 sessionStorage API
  */
-export interface StorageInterface {
+export interface Storage {
+  readonly length: number
+  clear(): void
   getItem(key: string): string | null
-  setItem(key: string, value: string): void
+  key(index: number): string | null
   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
+  setItem(key: string, value: string): void
+  [name: string]: any
 }

package/references/timer.d.ts

@@ -34,13 +34,12 @@ export declare const setInterval: (callback: (...args: any[]) => void, ms?: numb
 export declare const clearInterval: (intervalId: any) => void
 
 /**
- * 定时器环境类型定义
+ * 定时器环境接口
+ * 包含所有定时器相关的 API
  */
-export interface TimerEnvironment {
+export interface Timer {
   setTimeout: typeof setTimeout
   clearTimeout: typeof clearTimeout
   setInterval: typeof setInterval
   clearInterval: typeof clearInterval
-}
-
-// 定时器函数已在上面导出
+}