zcw-shared 1.4.0 → 1.7.0

package/references/browser.d.ts

@@ -1,175 +1,70 @@
-// 浏览器环境类型声明
-import type { ConsoleInterface } from './console.d'
-import type { AbortController, Response } from './fetch.d'
-import type { URLSearchParams } from './url.d'
-import type { StorageInterface } from './storage.d'
-import type { WorkerConstructor } from './worker.d'
-
-// 重新导出常用类型
-export type { ConsoleInterface, AbortController, Response, URLSearchParams, StorageInterface }
-
-export interface WindowLike {
-  innerWidth: number
-  innerHeight: number
-  document: {
-    documentElement: {
-      clientWidth: number
-      clientHeight: number
-    }
-  }
-}
-
-export interface DocumentLike {
-  createElement(tagName: string): HTMLElement
-}
-
-export interface HTMLElement {
-  appendChild(node: Element): Element
-  removeChild(node: Element): Element
-  parentNode?: Element | null
-  getBoundingClientRect(): {
-    width: number
-    height: number
-    top: number
-    left: number
-    right: number
-    bottom: number
-  }
-  [key: string]: any
-}
-
-export interface Element {
-  parentNode?: Element | null
-  [key: string]: any
-}
-
-export interface Base64Encoder {
-  btoa(data: string): string
-  atob(data: string): string
-}
-
-
-
-// URLSearchParams 类型别名（使用标准 URLSearchParams 类）
-export type URLSearchParamsConstructor = typeof URLSearchParams
-
-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 extends Event {
-  target: IDBOpenDBRequest
-}
-
-export interface DOMStringList {
-  contains(string: string): boolean
-}
-
-export type IDBValidKey = string | number | Date | ArrayBuffer | IDBValidKey[]
-export type IDBTransactionMode = 'readonly' | 'readwrite' | 'versionchange'
-export interface IDBObjectStoreParameters {
-  keyPath?: string | string[]
-  autoIncrement?: boolean
-}
-
-// Blob 相关类型
-export type BlobPart = BufferSource | Blob | string
-export interface BlobPropertyBag {
-  type?: string
-  endings?: 'transparent' | 'native'
-}
-export interface Blob {
-  readonly size: number
-  readonly type: string
-  arrayBuffer(): Promise<ArrayBuffer>
-  slice(start?: number, end?: number, contentType?: string): Blob
-  stream(): ReadableStream<Uint8Array>
-  text(): Promise<string>
-}
-export interface MediaSource {
-  // MediaSource 的基本定义
-}
-
-// Fetch API 类型别名（使用标准 Response 接口）
-export type FetchResponse = Response
-export type FetchAPI = typeof fetch
-
-
-
-export interface ReadableStreamReader<T> {
-  read(): Promise<{ done: boolean; value: T }>
-  releaseLock(): void
-  cancel(reason?: any): Promise<void>
-}
-
-export interface ReadableStream<T> {
-  getReader(): ReadableStreamReader<T>
-  cancel(reason?: any): Promise<void>
-  locked: boolean
-}
-
-export interface TextDecoder {
-  decode(input?: BufferSource, options?: { stream?: boolean }): string
-}
-
-export interface TextDecoderConstructor {
-  new (label?: string, options?: { fatal?: boolean; ignoreBOM?: boolean }): TextDecoder
-}
-
-// 浏览器环境接口
-export interface BrowserEnvironment {
-  window: {
-    location: {
-      search: string
-    }
-  }
-  __DEV__?: boolean
-  localStorage?: StorageInterface
-  sessionStorage?: StorageInterface
-  indexedDB?: IDBFactory
-  fetch: FetchAPI
-  AbortController: typeof AbortController
-  TextDecoder: TextDecoderConstructor
-  Worker?: WorkerConstructor
-  console: ConsoleInterface
-  URLSearchParams: typeof URLSearchParams
-  Blob: {
-    new (blobParts?: BlobPart[], options?: BlobPropertyBag): Blob
-  }
-  URL: {
-    createObjectURL(object: Blob | MediaSource): string
-    revokeObjectURL(url: string): void
-  }
+// 浏览器环境类型声明 - 统一的Window接口
+import type { Console } from './console.d'
+import type { AbortController, Response, FetchFunction } from './fetch.d'
+import type { URLSearchParams } from './url.d'
+import type { Storage } from './storage.d'
+import type { WorkerConstructor } from './worker.d'
+import type { Document, HTMLElement, Element } from './dom.d'
+import type { IDBFactory } from './indexeddb.d'
+import type { Blob, BlobPart, BlobPropertyBag, MediaSource, ReadableStream } from './blob.d'
+import type { TextDecoderConstructor, TextEncoderConstructor } from './encoding.d'
+import type { Location } from './location.d'
+import type { ArrayBufferConstructor, Uint8ArrayConstructor, DataViewConstructor } from './arraybuffer.d'
+
+
+
+// 浏览器Window对象 - 包含所有浏览器API
+export interface Window {
+  // 窗口属性
+  innerWidth: number
+  innerHeight: number
+  
+  // DOM
+  document: Document
+  
+  // 位置信息
+  location: Location
+  
+  // 存储API
+  localStorage: Storage
+  sessionStorage: Storage
+  indexedDB: IDBFactory
+  
+  // 网络API
+  fetch: FetchFunction
+  AbortController: typeof AbortController
+  
+  // 编码API
+  TextDecoder: TextDecoderConstructor
+  TextEncoder: TextEncoderConstructor
+  btoa(data: string): string
+  atob(data: string): string
+  
+  // Worker API
+  Worker?: WorkerConstructor
+  
+  // 控制台
+  console: Console
+  
+  // URL API
+  URLSearchParams: typeof URLSearchParams
+  URL: {
+    createObjectURL(object: Blob | MediaSource): string
+    revokeObjectURL(url: string): void
+  }
+  
+  // Blob API
+  Blob: {
+    new (blobParts?: BlobPart[], options?: BlobPropertyBag): Blob
+  }
+  
+  // ArrayBuffer API
+  ArrayBuffer: ArrayBufferConstructor
+  Uint8Array: Uint8ArrayConstructor
+  DataView: DataViewConstructor
+  
+  // 开发环境标识
+  __DEV__?: boolean
+  
+
 }

package/references/chrome.extension.d.ts

@@ -0,0 +1,83 @@
+// Chrome Extension API 类型定义
+
+export interface ChromeTab {
+  id?: number;
+  windowId?: number;
+  url?: string;
+  title?: string;
+  active?: boolean;
+  pinned?: boolean;
+  highlighted?: boolean;
+  incognito?: boolean;
+  selected?: boolean;
+  discarded?: boolean;
+  autoDiscardable?: boolean;
+  mutedInfo?: {
+    muted: boolean;
+    reason?: string;
+    extensionId?: string;
+  };
+  favIconUrl?: string;
+  status?: 'loading' | 'complete';
+  width?: number;
+  height?: number;
+  sessionId?: string;
+  openerTabId?: number;
+  pendingUrl?: string;
+  groupId?: number;
+}
+
+export type SenderType = 'content' | 'background' | 'popup' | 'sidepanel' | 'options';
+
+export interface ChromeMessageSender {
+  type: SenderType;
+  tab?: ChromeTab;
+  id?: string;
+  url?: string;
+  frameId?: number;
+  origin?: string;
+  tlsChannelId?: string;
+  documentId?: string;
+  documentLifecycle?: string;
+}
+
+export interface ChromeRuntime {
+  sendMessage: (message: any, responseCallback?: (response: any) => void) => void;
+  onMessage: {
+    addListener: (callback: (message: any, sender: ChromeMessageSender, sendResponse: (response?: any) => void) => void | boolean) => void;
+    removeListener: (callback: Function) => void;
+  };
+  getURL: (path: string) => string;
+  id: string;
+  getManifest: () => any;
+}
+
+export interface ChromeTabs {
+  query: (queryInfo: Partial<ChromeTab>, callback: (tabs: ChromeTab[]) => void) => void;
+  get: (tabId: number, callback: (tab: ChromeTab) => void) => void;
+  create: (createProperties: Partial<ChromeTab>, callback?: (tab: ChromeTab) => void) => void;
+  update: (tabId: number, updateProperties: Partial<ChromeTab>, callback?: (tab: ChromeTab) => void) => void;
+  remove: (tabIds: number | number[], callback?: () => void) => void;
+  sendMessage: (tabId: number, message: any, options?: any, responseCallback?: (response: any) => void) => void;
+}
+
+export interface ChromeStorage {
+  local: {
+    get: (keys?: string | string[] | null, callback?: (items: { [key: string]: any }) => void) => void;
+    set: (items: { [key: string]: any }, callback?: () => void) => void;
+    remove: (keys: string | string[], callback?: () => void) => void;
+    clear: (callback?: () => void) => void;
+  };
+  sync: {
+    get: (keys?: string | string[] | null, callback?: (items: { [key: string]: any }) => void) => void;
+    set: (items: { [key: string]: any }, callback?: () => void) => void;
+    remove: (keys: string | string[], callback?: () => void) => void;
+    clear: (callback?: () => void) => void;
+  };
+}
+
+export interface Chrome {
+  runtime: ChromeRuntime;
+  tabs: ChromeTabs;
+  storage: ChromeStorage;
+}

package/references/console.d.ts

@@ -1,164 +1,25 @@
-/**
- * 控制台 API 类型定义
- * 包含浏览器和 Node.js 环境都支持的控制台相关 API
- */
-
-/**
- * 控制台接口
- * 提供调试和日志输出功能
- */
-export interface ConsoleInterface {
-  /**
-   * 输出普通日志信息
-   * @param message 消息内容
-   * @param optionalParams 可选参数
-   */
-  log(message?: any, ...optionalParams: any[]): void
-  
-  /**
-   * 输出错误信息
-   * @param message 消息内容
-   * @param optionalParams 可选参数
-   */
-  error(message?: any, ...optionalParams: any[]): void
-  
-  /**
-   * 输出警告信息
-   * @param message 消息内容
-   * @param optionalParams 可选参数
-   */
-  warn(message?: any, ...optionalParams: any[]): void
-  
-  /**
-   * 输出信息级别日志
-   * @param message 消息内容
-   * @param optionalParams 可选参数
-   */
-  info(message?: any, ...optionalParams: any[]): void
-  
-  /**
-   * 输出调试信息
-   * @param message 消息内容
-   * @param optionalParams 可选参数
-   */
-  debug(message?: any, ...optionalParams: any[]): void
-  
-  /**
-   * 创建一个新的分组
-   * @param label 分组标签
-   */
-  group(label?: string): void
-  
-  /**
-   * 创建一个新的折叠分组
-   * @param label 分组标签
-   */
-  groupCollapsed(label?: string): void
-  
-  /**
-   * 结束当前分组
-   */
-  groupEnd(): void
-  
-  /**
-   * 输出堆栈跟踪信息
-   * @param message 消息内容
-   * @param optionalParams 可选参数
-   */
-  trace(message?: any, ...optionalParams: any[]): void
-  
-  /**
-   * 清空控制台
-   */
-  clear(): void
-  
-  /**
-   * 输出表格数据
-   * @param tabularData 表格数据
-   * @param properties 要显示的属性
-   */
-  table(tabularData: any, properties?: string[]): void
-  
-  /**
-   * 开始计时
-   * @param label 计时器标签
-   */
-  time(label?: string): void
-  
-  /**
-   * 输出计时器当前时间
-   * @param label 计时器标签
-   * @param data 附加数据
-   */
-  timeLog(label?: string, ...data: any[]): void
-  
-  /**
-   * 结束计时并输出总时间
-   * @param label 计时器标签
-   */
-  timeEnd(label?: string): void
-  
-  /**
-   * 开始计数
-   * @param label 计数器标签
-   */
-  count(label?: string): void
-  
-  /**
-   * 重置计数器
-   * @param label 计数器标签
-   */
-  countReset(label?: string): void
-  
-  /**
-   * 断言，如果条件为 false 则输出错误信息
-   * @param condition 断言条件
-   * @param data 错误信息
-   */
-  assert(condition?: boolean, ...data: any[]): void
-  
-  /**
-   * 输出对象的详细信息
-   * @param item 要检查的对象
-   * @param options 选项
-   */
-  dir(item?: any, options?: any): void
-  
-  /**
-   * 输出 XML/HTML 元素的详细信息
-   * @param object 要检查的对象
-   */
-  dirxml(object: any): void
-  
-  /**
-   * 在性能面板中标记时间点
-   * @param markName 标记名称
-   */
-  timeStamp(markName?: string): void
-  
-  /**
-   * 开始性能分析
-   * @param reportName 报告名称
-   */
-  profile(reportName?: string): void
-  
-  /**
-   * 结束性能分析
-   * @param reportName 报告名称
-   */
-  profileEnd(reportName?: string): void
-}
-
-/**
- * 控制台对象
- */
-export declare const console: ConsoleInterface
-
-/**
- * 控制台环境类型定义
- */
-export interface ConsoleEnvironment {
-  console: ConsoleInterface
-}
-
-// console 已在上面导出
+// Console API 类型定义
+export interface Console {
+  log(message?: any, ...optionalParams: any[]): void
+  error(message?: any, ...optionalParams: any[]): void
+  warn(message?: any, ...optionalParams: any[]): void
+  info(message?: any, ...optionalParams: any[]): void
+  debug(message?: any, ...optionalParams: any[]): void
+  group(label?: string): void
+  groupCollapsed(label?: string): void
+  groupEnd(): void
+  trace(message?: any, ...optionalParams: any[]): void
+  clear(): void
+  table(tabularData: any, properties?: string[]): void
+  time(label?: string): void
+  timeLog(label?: string, ...data: any[]): void
+  timeEnd(label?: string): void
+  count(label?: string): void
+  countReset(label?: string): void
+  assert(condition?: boolean, ...data: any[]): void
+  dir(item?: any, options?: any): void
+  dirxml(object: any): void
+  timeStamp(markName?: string): void
+  profile(reportName?: string): void
+  profileEnd(reportName?: string): void
+}

package/references/{crypto.d.ts → crypto-js.d.ts}

@@ -1,57 +1,57 @@
-// 加密相关第三方库类型声明
-
-/**
- * CryptoJS 加密库类型定义
- * 注意：CryptoJS 是一个第三方 JavaScript 加密库，不是浏览器原生 API
- * 需要通过 npm install crypto-js 安装
- */
-export interface CryptoJS {
-  MD5(message: string): {
-    toString(): string
-  } | string
-  
-  SHA1(message: string): {
-    toString(): string
-  } | string
-  
-  SHA256(message: string): {
-    toString(): string
-  } | string
-  
-  SHA512(message: string): {
-    toString(): string
-  } | string
-  
-  AES: {
-    encrypt(message: string, key: string): {
-      toString(): string
-    }
-    decrypt(ciphertext: string, key: string): {
-      toString(): string
-    }
-  }
-  
-  DES: {
-    encrypt(message: string, key: string): {
-      toString(): string
-    }
-    decrypt(ciphertext: string, key: string): {
-      toString(): string
-    }
-  }
-  
-  enc: {
-    Utf8: {
-      parse(str: string): any
-      stringify(words: any): string
-    }
-    Base64: {
-      parse(str: string): any
-      stringify(words: any): string
-    }
-    Hex: {
-      parse(str: string): any
-      stringify(words: any): string
-    }
-  }
-}
+// 加密相关第三方库类型声明
+
+/**
+ * CryptoJS 加密库类型定义
+ * 注意：CryptoJS 是一个第三方 JavaScript 加密库，不是浏览器原生 API
+ * 需要通过 npm install crypto-js 安装
+ */
+export interface CryptoJS {
+  MD5(message: string): {
+    toString(): string
+  } | string
+  
+  SHA1(message: string): {
+    toString(): string
+  } | string
+  
+  SHA256(message: string): {
+    toString(): string
+  } | string
+  
+  SHA512(message: string): {
+    toString(): string
+  } | string
+  
+  AES: {
+    encrypt(message: string, key: string): {
+      toString(): string
+    }
+    decrypt(ciphertext: string, key: string): {
+      toString(): string
+    }
+  }
+  
+  DES: {
+    encrypt(message: string, key: string): {
+      toString(): string
+    }
+    decrypt(ciphertext: string, key: string): {
+      toString(): string
+    }
+  }
+  
+  enc: {
+    Utf8: {
+      parse(str: string): any
+      stringify(words: any): string
+    }
+    Base64: {
+      parse(str: string): any
+      stringify(words: any): string
+    }
+    Hex: {
+      parse(str: string): any
+      stringify(words: any): string
+    }
+  }
+}

package/references/dom.d.ts

@@ -0,0 +1,41 @@
+// DOM 相关类型声明
+
+// DOM 元素接口 - 按继承关系组织
+export interface Element {
+  parentNode?: Element | null
+}
+
+export interface HTMLElement extends Element {
+  appendChild(node: Element): Element
+  removeChild(node: Element): Element
+  getBoundingClientRect(): {
+    width: number
+    height: number
+    top: number
+    left: number
+    right: number
+    bottom: number
+  }
+}
+
+export interface Document {
+  createElement(tagName: string): HTMLElement
+  documentElement: {
+    clientWidth: number
+    clientHeight: number
+  }
+}
+
+// DOM 事件相关
+export interface Event {
+  target?: any
+}
+
+export interface DOMException {
+  name: string
+  message: string
+}
+
+export interface DOMStringList {
+  contains(string: string): boolean
+}

package/references/encoding.d.ts

@@ -0,0 +1,24 @@
+// 编码相关类型声明
+import type { BufferSource } from './arraybuffer.d'
+
+export interface TextDecoder {
+  decode(input?: BufferSource, options?: { stream?: boolean }): string
+}
+
+export interface TextDecoderConstructor {
+  new (label?: string, options?: { fatal?: boolean; ignoreBOM?: boolean }): TextDecoder
+}
+
+export interface TextEncoder {
+  encode(input?: string): Uint8Array
+}
+
+export interface TextEncoderConstructor {
+  new (): TextEncoder
+}
+
+// Base64 编码相关
+export interface Base64Encoder {
+  btoa(data: string): string
+  atob(data: string): string
+}