zcw-shared 1.5.0 → 1.7.0

package/references/url.d.ts

@@ -1,161 +1,56 @@
-/**
- * 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 相关类
+// URL API 类型定义
+
+/**
+ * URL 解析和构造类
+ */
+declare class URL {
+  constructor(url: string, base?: string | URL)
+  
+  // URL 组成部分
+  href: string
+  origin: string
+  protocol: string
+  hostname: string
+  port: string
+  pathname: string
+  search: string
+  hash: string
+  username: string
+  password: string
+  host: string
+  
+  // 查询参数
+  searchParams: URLSearchParams
+  
+  // 序列化方法
+  toString(): string
+  toJSON(): string
+}
+
+/**
+ * URL 查询参数处理类
+ */
+declare class URLSearchParams {
+  constructor(init?: string | string[][] | Record<string, string> | URLSearchParams)
+  
+  // 参数操作
+  append(name: string, value: string): void
+  delete(name: string): void
+  get(name: string): string | null
+  getAll(name: string): string[]
+  has(name: string): boolean
+  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]>
+  forEach(callback: (value: string, key: string, parent: URLSearchParams) => void, thisArg?: any): void
+}
+
 export { URL, URLSearchParams }

package/references/vue.d.ts

@@ -1,113 +1,86 @@
-// 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
+// Vue 类型定义
+
+/**
+ * Vue 虚拟节点
+ */
+export interface VNode {
+  type: Component | string | symbol
+  props: Record<string, any> | null
+  children: VNode[] | string | null
+  key: string | number | symbol | null
+  ref: ((el: any) => void) | string | null
+  el: Element | null
+  appContext?: AppContext
+}
+
+/**
+ * Vue 组件定义
+ */
+export interface Component {
+  name?: string
+  setup?: (props: any, ctx: any) => any
+  render?: (ctx: any) => VNode | VNode[]
+  template?: string
+  components?: Record<string, Component>
+  props?: string[] | Record<string, any>
+  emits?: string[] | Record<string, any>
+}
+
+/**
+ * Vue 组件实例
+ */
+export interface ComponentInstance {
+  type: Component
+  parent: ComponentInstance | null
+  appContext: AppContext
+}
+
+/**
+ * Vue 应用上下文
+ */
+export interface AppContext {
+  app: App
+  config: AppConfig
+  components: Record<string, Component>
+  provides: Record<string | symbol, any>
+}
+
+/**
+ * Vue 应用实例
+ */
+export interface App {
+  version: string
+  config: AppConfig
+  use(plugin: any, ...options: any[]): App
+  component(name: string): Component | undefined
+  component(name: string, component: Component): App
+  mount(rootContainer: Element | string): ComponentInstance
+  unmount(): void
+  provide<T>(key: string | symbol, value: T): App
+}
+
+/**
+ * Vue 应用配置
+ */
+export interface AppConfig {
+  errorHandler?: (err: any, instance: ComponentInstance | null, info: string) => void
+  warnHandler?: (msg: string, instance: ComponentInstance | null, trace: string) => void
+  globalProperties?: Record<string, any>
+}
+
+/**
+ * Vue 响应式引用
+ */
+export interface Ref<T> {
+  value: T
+}
+
+/**
+ * Vue 运行时函数
+ */
+export interface VueRuntime {
+  createVNode: (type: any, props?: any, children?: any) => VNode
+  render: (vnode: VNode | null, container: any) => void
+  ref: <T>(value: T) => Ref<T>
+  onUnmounted: (fn: () => void) => void
+}

package/references/webassembly.d.ts

@@ -1,127 +1,101 @@
-/**
- * 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'
-  }
+/**
+ * WebAssembly 环境类型定义
+ * 用于在不同环境下提供 WebAssembly API 的类型支持
+ */
+import type { BufferSource } from './arraybuffer.d'
+
+// 核心接口
+export interface WebAssemblyModule {}
+
+export interface WebAssemblyInstance {
+  exports: WebAssemblyExports
+}
+
+export interface WebAssemblyMemory {
+  buffer: ArrayBuffer
+  grow(pages: number): number
+}
+
+export interface WebAssemblyExports {
+  memory?: WebAssemblyMemory
+  malloc?: (size: number) => number
+  free?: (pointer: number) => void
+  [key: string]: any
+}
+
+export interface WebAssemblyGlobal {
+  value: any
+  valueOf(): any
+}
+
+export interface WebAssemblyTable {
+  length: number
+  get(index: number): any
+  set(index: number, value: any): void
+  grow(delta: number, value?: any): number
+}
+
+// 错误类型
+export interface WebAssemblyCompileError extends Error {
+  name: 'CompileError'
+}
+
+export interface WebAssemblyLinkError extends Error {
+  name: 'LinkError'
+}
+
+export interface WebAssemblyRuntimeError extends Error {
+  name: 'RuntimeError'
+}
+    
+// 描述符接口
+export interface WebAssemblyMemoryDescriptor {
+  initial: number
+  maximum?: number
+  shared?: boolean
+}
+
+export interface WebAssemblyTableDescriptor {
+  element: WebAssemblyTableKind
+  initial: number
+  maximum?: number
+}
+
+export interface WebAssemblyGlobalDescriptor {
+  value: WebAssemblyValueType
+  mutable?: boolean
+}
+
+export interface WebAssemblyModuleExportDescriptor {
+  name: string
+  kind: WebAssemblyImportExportKind
+}
+
+export interface WebAssemblyModuleImportDescriptor {
+  module: string
+  name: string
+  kind: WebAssemblyImportExportKind
+}
+
+export interface WebAssemblyInstantiatedSource {
+  module: WebAssemblyModule
+  instance: WebAssemblyInstance
+}
+
+// 类型别名
+export type WebAssemblyImports = Record<string, WebAssemblyModuleImports>
+export type WebAssemblyModuleImports = Record<string, WebAssemblyExportValue>
+export type WebAssemblyExportValue = Function | WebAssemblyGlobal | WebAssemblyMemory | WebAssemblyTable
+export type WebAssemblyValueType = 'i32' | 'i64' | 'f32' | 'f64' | 'v128' | 'funcref' | 'externref'
+export type WebAssemblyTableKind = 'funcref' | 'externref'
+export type WebAssemblyImportExportKind = 'function' | 'table' | 'memory' | 'global'
+
+// WebAssembly 运行时函数
+export interface WebAssemblyRuntime {
+  compile: (bytes: BufferSource) => Promise<WebAssemblyModule>
+  instantiate: {
+    (bytes: BufferSource, imports?: WebAssemblyImports): Promise<WebAssemblyInstantiatedSource>
+    (module: WebAssemblyModule, imports?: WebAssemblyImports): Promise<WebAssemblyInstance>
+  }
+  validate: (bytes: BufferSource) => boolean
+}