zcw-shared 1.2.0

package/references/node.d.ts

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

package/references/sharp.d.ts

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

package/references/storage.d.ts

@@ -0,0 +1,112 @@
+/**
+ * 存储环境类型定义
+ * 包含浏览器和其他环境的存储 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
+}

package/references/timer.d.ts

@@ -0,0 +1,46 @@
+/**
+ * 定时器 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
+}
+
+// 定时器函数已在上面导出

package/references/uniapp.d.ts

@@ -0,0 +1,9 @@
+// UniApp 环境类型声明
+import type { TimerEnvironment } from './timer.d'
+
+export interface UniAppAPI {
+  getCurrentPages(): any[]
+}
+
+// 重新导出定时器环境类型
+export type { TimerEnvironment as TimerAPI } from './timer.d'

package/references/url.d.ts

@@ -0,0 +1,161 @@
+/**
+ * URL API 类型定义
+ * 包含浏览器和 Node.js 环境都支持的 URL 相关 API
+ */
+
+/**
+ * URL 类
+ * 用于解析和构造 URL
+ */
+declare class URL {
+  /**
+   * 构造函数
+   * @param url URL 字符串
+   * @param base 基础 URL（可选）
+   */
+  constructor(url: string, base?: string | URL)
+  
+  /** 完整的 URL 字符串 */
+  href: string
+  
+  /** URL 的源（协议 + 主机名 + 端口） */
+  origin: string
+  
+  /** URL 的协议部分 */
+  protocol: string
+  
+  /** URL 的主机名部分 */
+  hostname: string
+  
+  /** URL 的端口部分 */
+  port: string
+  
+  /** URL 的路径部分 */
+  pathname: string
+  
+  /** URL 的查询字符串部分 */
+  search: string
+  
+  /** URL 的哈希部分 */
+  hash: string
+  
+  /** URL 的用户名部分 */
+  username: string
+  
+  /** URL 的密码部分 */
+  password: string
+  
+  /** URL 的主机部分（主机名 + 端口） */
+  host: string
+  
+  /** URL 的搜索参数对象 */
+  searchParams: URLSearchParams
+  
+  /**
+   * 返回 URL 的字符串表示
+   */
+  toString(): string
+  
+  /**
+   * 返回 URL 的 JSON 表示
+   */
+  toJSON(): string
+}
+
+/**
+ * URLSearchParams 类
+ * 用于处理 URL 查询参数
+ */
+declare class URLSearchParams {
+  /**
+   * 构造函数
+   * @param init 初始化参数
+   */
+  constructor(init?: string | string[][] | Record<string, string> | URLSearchParams)
+  
+  /**
+   * 添加参数
+   * @param name 参数名
+   * @param value 参数值
+   */
+  append(name: string, value: string): void
+  
+  /**
+   * 删除参数
+   * @param name 参数名
+   */
+  delete(name: string): void
+  
+  /**
+   * 获取参数值
+   * @param name 参数名
+   */
+  get(name: string): string | null
+  
+  /**
+   * 获取所有同名参数值
+   * @param name 参数名
+   */
+  getAll(name: string): string[]
+  
+  /**
+   * 检查是否存在参数
+   * @param name 参数名
+   */
+  has(name: string): boolean
+  
+  /**
+   * 设置参数值
+   * @param name 参数名
+   * @param value 参数值
+   */
+  set(name: string, value: string): void
+  
+  /**
+   * 排序参数
+   */
+  sort(): void
+  
+  /**
+   * 返回字符串表示
+   */
+  toString(): string
+  
+  /**
+   * 返回迭代器
+   */
+  [Symbol.iterator](): IterableIterator<[string, string]>
+  
+  /**
+   * 返回键的迭代器
+   */
+  keys(): IterableIterator<string>
+  
+  /**
+   * 返回值的迭代器
+   */
+  values(): IterableIterator<string>
+  
+  /**
+   * 返回键值对的迭代器
+   */
+  entries(): IterableIterator<[string, string]>
+  
+  /**
+   * 遍历参数
+   * @param callback 回调函数
+   * @param thisArg this 上下文
+   */
+  forEach(callback: (value: string, key: string, parent: URLSearchParams) => void, thisArg?: any): void
+}
+
+/**
+ * URL 环境类型定义
+ */
+export interface URLEnvironment {
+  URL: typeof URL
+  URLSearchParams: typeof URLSearchParams
+}
+
+// 导出 URL 相关类
+export { URL, URLSearchParams }

package/references/vue.d.ts

@@ -0,0 +1,113 @@
+// Vue 类型定义文件
+// 仅包含必要的 Vue 类型，避免全局污染
+
+export interface VueRuntimeFunctions {
+  createVNode: (type: any, props?: any, children?: any) => VNode
+  render: (vnode: VNode | null, container: any, isSVG?: boolean) => void
+}
+
+export namespace Vue {
+  interface VNode {
+    __v_isVNode: true
+    type: Component | string | symbol
+    props: Record<string, any> | null
+    children: VNode[] | string | null
+    key: string | number | symbol | null
+    ref: ((el: any) => void) | string | null
+    scopeId: string | null
+    slotScopeIds: string[] | null
+    dirs: Array<{ dir: any; instance: any; value: any; oldValue: any; arg: string; modifiers: Record<string, boolean> }> | null
+    transition: any | null
+    component: ComponentInstance | null
+    suspense: any | null
+    ssContent: VNode | null
+    ssFallback: VNode | null
+    el: Element | null
+    anchor: Element | null
+    target: Element | null
+    targetAnchor: Element | null
+    staticCount: number
+    shapeFlag: number
+    patchFlag: number
+    dynamicProps: string[] | null
+    dynamicChildren: VNode[] | null
+    appContext: AppContext | null
+    ctx: ComponentInstance | null
+  }
+
+  interface Component {
+    __v_isVue?: true
+    name?: string
+    setup?: (props: any, ctx: any) => any
+    render?: (ctx: any) => VNode | VNode[]
+    template?: string
+    components?: Record<string, Component>
+    directives?: Record<string, any>
+    props?: string[] | Record<string, any>
+    emits?: string[] | Record<string, any>
+    [key: string]: any
+  }
+
+  interface ComponentInstance {
+    type: Component
+    parent: ComponentInstance | null
+    appContext: AppContext
+    [key: string]: any
+  }
+
+  interface AppContext {
+    app: App
+    config: AppConfig
+    mixins: Component[]
+    components: Record<string, Component>
+    directives: Record<string, any>
+    provides: Record<string | symbol, any>
+    optionsCache: WeakMap<Component, any>
+    propsCache: WeakMap<Component, any>
+    emitsCache: WeakMap<Component, any>
+    reload?: () => void
+  }
+
+  interface App {
+    version: string
+    config: AppConfig
+    use(plugin: any, ...options: any[]): App
+    mixin(mixin: Component): App
+    component(name: string): Component | undefined
+    component(name: string, component: Component): App
+    directive(name: string): any | undefined
+    directive(name: string, directive: any): App
+    mount(rootContainer: Element | string): ComponentInstance
+    unmount(): void
+    provide<T>(key: string | symbol, value: T): App
+    [key: string]: any
+  }
+
+  interface AppConfig {
+    errorHandler?: (err: any, instance: ComponentInstance | null, info: string) => void
+    warnHandler?: (msg: string, instance: ComponentInstance | null, trace: string) => void
+    performance?: boolean
+    compilerOptions?: any
+    globalProperties?: Record<string, any>
+    optionMergeStrategies?: Record<string, any>
+    [key: string]: any
+  }
+}
+
+// Vue 响应式 API 类型定义
+export interface Ref<T> {
+  value: T
+}
+
+export interface VueReactivityAPI {
+  ref: <T>(value: T) => Ref<T>
+  onUnmounted: (fn: () => void) => void
+}
+
+// 导出类型
+export type VNode = Vue.VNode
+export type Component = Vue.Component
+export type ComponentInstance = Vue.ComponentInstance
+export type AppContext = Vue.AppContext
+export type App = Vue.App
+export type AppConfig = Vue.AppConfig

package/references/webassembly.d.ts

@@ -0,0 +1,127 @@
+/**
+ * WebAssembly 环境类型定义
+ * 用于在不同环境下提供 WebAssembly API 的类型支持
+ */
+
+export namespace WebAssembly {
+    interface Module {}
+    
+    interface Instance {
+      exports: Exports
+    }
+    
+    interface Memory {
+      buffer: ArrayBuffer
+      grow(pages: number): number
+    }
+    
+    interface Exports {
+      [key: string]: any
+      memory?: Memory
+    }
+    
+    interface CompileError extends Error {
+      name: 'CompileError'
+    }
+    
+    interface LinkError extends Error {
+      name: 'LinkError'
+    }
+    
+    interface RuntimeError extends Error {
+      name: 'RuntimeError'
+    }
+    
+    interface Global {
+      value: any
+      valueOf(): any
+    }
+    
+    interface Table {
+      length: number
+      get(index: number): any
+      set(index: number, value: any): void
+      grow(delta: number, value?: any): number
+    }
+    
+    // 构造函数和静态方法
+    function compile(bytes: BufferSource): Promise<Module>
+    function instantiate(bytes: BufferSource, imports?: Imports): Promise<WebAssemblyInstantiatedSource>
+    function instantiate(module: Module, imports?: Imports): Promise<Instance>
+    function validate(bytes: BufferSource): boolean
+    
+    // 类构造函数
+    class Module {
+      constructor(bytes: BufferSource)
+      static customSections(module: Module, sectionName: string): ArrayBuffer[]
+      static exports(module: Module): ModuleExportDescriptor[]
+      static imports(module: Module): ModuleImportDescriptor[]
+    }
+    
+    class Instance {
+      constructor(module: Module, imports?: Imports)
+      exports: Exports
+    }
+    
+    class Memory {
+      constructor(descriptor: MemoryDescriptor)
+      buffer: ArrayBuffer
+      grow(pages: number): number
+    }
+    
+    class Table {
+      constructor(descriptor: TableDescriptor, value?: any)
+      length: number
+      get(index: number): any
+      set(index: number, value: any): void
+      grow(delta: number, value?: any): number
+    }
+    
+    class Global {
+      constructor(descriptor: GlobalDescriptor, value?: any)
+      value: any
+      valueOf(): any
+    }
+    
+    // 描述符接口
+    interface MemoryDescriptor {
+      initial: number
+      maximum?: number
+      shared?: boolean
+    }
+    
+    interface TableDescriptor {
+      element: TableKind
+      initial: number
+      maximum?: number
+    }
+    
+    interface GlobalDescriptor {
+      value: ValueType
+      mutable?: boolean
+    }
+    
+    interface ModuleExportDescriptor {
+      name: string
+      kind: ImportExportKind
+    }
+    
+    interface ModuleImportDescriptor {
+      module: string
+      name: string
+      kind: ImportExportKind
+    }
+    
+    interface WebAssemblyInstantiatedSource {
+      module: Module
+      instance: Instance
+    }
+    
+    // 类型别名
+    type Imports = Record<string, ModuleImports>
+    type ModuleImports = Record<string, ExportValue>
+    type ExportValue = Function | Global | Memory | Table
+    type ValueType = 'i32' | 'i64' | 'f32' | 'f64' | 'v128' | 'funcref' | 'externref'
+    type TableKind = 'funcref' | 'externref'
+    type ImportExportKind = 'function' | 'table' | 'memory' | 'global'
+  }