zcw-shared 1.2.0

package/references/browser.d.ts

@@ -0,0 +1,175 @@
+// 浏览器环境类型声明
+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
+  }
+}

package/references/browser.extension.d.ts

@@ -0,0 +1,14 @@
+export interface TabInfo {
+  id?: number;
+  windowId?: number;
+}
+
+export type SenderType = 'content' | 'background' | 'popup' | 'sidepanel' | 'options';
+
+export interface MessageSender {
+  type: SenderType;
+  tab?: TabInfo;
+  id?: string;
+  url?: string;
+  frameId?: number;
+} 

package/references/console.d.ts

@@ -0,0 +1,164 @@
+/**
+ * 控制台 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 已在上面导出

package/references/crypto.d.ts

@@ -0,0 +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
+    }
+  }
+}

package/references/fetch.d.ts

@@ -0,0 +1,269 @@
+/**
+ * Fetch API 类型定义
+ * 包含浏览器和 Node.js 环境都支持的 Fetch 相关 API
+ */
+
+/**
+ * 请求凭据类型
+ */
+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
+
+/**
+ * Headers 接口
+ */
+export interface Headers {
+  append(name: string, value: string): void
+  delete(name: string): void
+  get(name: string): string | null
+  has(name: string): boolean
+  set(name: string, value: string): void
+  forEach(callbackfn: (value: string, key: string, parent: Headers) => void, thisArg?: any): void
+  [Symbol.iterator](): IterableIterator<[string, string]>
+  entries(): IterableIterator<[string, string]>
+  keys(): IterableIterator<string>
+  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
+  readonly headers: Headers
+  readonly body: ReadableStream<Uint8Array> | null
+  readonly bodyUsed: boolean
+  readonly cache: RequestCache
+  readonly credentials: RequestCredentials
+  readonly destination: string
+  readonly integrity: string
+  readonly keepalive: boolean
+  readonly mode: RequestMode
+  readonly redirect: RequestRedirect
+  readonly referrer: string
+  readonly referrerPolicy: ReferrerPolicy
+  readonly signal: AbortSignal
+  
+  clone(): Request
+  arrayBuffer(): Promise<ArrayBuffer>
+  blob(): Promise<Blob>
+  formData(): Promise<FormData>
+  json(): Promise<any>
+  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
+  readonly statusText: string
+  readonly headers: Headers
+  readonly body: ReadableStream<Uint8Array> | null
+  readonly bodyUsed: boolean
+  readonly redirected: boolean
+  readonly type: ResponseType
+  readonly url: string
+  
+  clone(): Response
+  arrayBuffer(): Promise<ArrayBuffer>
+  blob(): Promise<Blob>
+  formData(): Promise<FormData>
+  json(): Promise<any>
+  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
+}
+
+// 导出 Fetch 相关 API
+// 导出类型别名
+export type {
+  RequestCredentials,
+  RequestCache,
+  RequestRedirect,
+  ReferrerPolicy,
+  RequestMode,
+  BodyInit,
+  HeadersInit,
+  RequestInfo,
+  ResponseType
+}

package/references/json5.d.ts

@@ -0,0 +1,28 @@
+/**
+ * JSON5 解析器类型定义
+ * JSON5 是 JSON 的扩展，支持注释、尾随逗号等特性
+ */
+export interface JSON5Parser {
+  /**
+   * 解析 JSON5 字符串
+   * @param text 要解析的 JSON5 字符串
+   * @returns 解析后的对象
+   */
+  parse(text: string): any
+  
+  /**
+   * 将对象序列化为 JSON5 字符串
+   * @param value 要序列化的值
+   * @param replacer 替换函数或属性数组
+   * @param space 缩进空格数
+   * @returns JSON5 字符串
+   */
+  stringify(value: any, replacer?: any, space?: string | number): string
+}
+
+/**
+ * JSON5 环境类型定义
+ */
+export interface JSON5Environment {
+  JSON5: JSON5Parser
+}