zcw-shared 1.5.0 → 1.8.0

package/references/uniapp.d.ts

@@ -1,9 +1,51 @@
 // UniApp 环境类型声明
-import type { TimerEnvironment } from './timer.d'
 
-export interface UniAppAPI {
-  getCurrentPages(): any[]
+/**
+ * UniApp 页面实例接口
+ */
+export interface UniPage {
+  route: string
+  options: Record<string, any>
+  $vm: any
 }
 
-// 重新导出定时器环境类型
-export type { TimerEnvironment as TimerAPI } from './timer.d'
+/**
+ * UniApp 全局对象
+ * 定义 UniApp 框架的完整能力
+ */
+export interface UniApp {
+  // 页面管理
+  getCurrentPages(): any[]
+  
+  // 路由导航
+  navigateTo(options: { url: string; success?: () => void; fail?: () => void }): void
+  redirectTo(options: { url: string; success?: () => void; fail?: () => void }): void
+  switchTab(options: { url: string; success?: () => void; fail?: () => void }): void
+  navigateBack(options?: { delta?: number; success?: () => void; fail?: () => void }): void
+  reLaunch(options: { url: string; success?: () => void; fail?: () => void }): void
+  
+  // UI 交互
+  showToast(options: { title: string; icon?: 'success' | 'loading' | 'none'; duration?: number }): void
+  hideToast(): void
+  showModal(options: { title?: string; content: string; showCancel?: boolean; success?: (res: { confirm: boolean; cancel: boolean }) => void }): void
+  showActionSheet(options: { itemList: string[]; success?: (res: { tapIndex: number }) => void }): void
+  
+  // 系统信息
+  getSystemInfo(options: { success?: (res: any) => void; fail?: () => void }): void
+  
+  // 本地存储
+  getStorageSync(key: string): any
+  setStorageSync(key: string, data: any): void
+  removeStorageSync(key: string): void
+  clearStorageSync(): void
+  
+  // 网络请求
+  request(options: {
+    url: string
+    method?: 'GET' | 'POST' | 'PUT' | 'DELETE'
+    data?: any
+    header?: Record<string, string>
+    success?: (res: any) => void
+    fail?: () => void
+  }): void
+}

package/references/url.d.ts

@@ -1,161 +1,56 @@
-/**
- * URL API 类型定义
- * 包含浏览器和 Node.js 环境都支持的 URL 相关 API
- */
+// URL API 类型定义
 
 /**
- * URL 类
- * 用于解析和构造 URL
+ * URL 解析和构造类
  */
 declare class URL {
-  /**
-   * 构造函数
-   * @param url URL 字符串
-   * @param base 基础 URL（可选）
-   */
   constructor(url: string, base?: string | URL)
   
-  /** 完整的 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 查询参数
+ * 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

@@ -1,113 +1,86 @@
-// Vue 类型定义文件
-// 仅包含必要的 Vue 类型，避免全局污染
+// Vue 类型定义
 
-export interface VueRuntimeFunctions {
-  createVNode: (type: any, props?: any, children?: any) => VNode
-  render: (vnode: VNode | null, container: any, isSVG?: boolean) => void
+/**
+ * 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
 }
 
-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
-  }
+/**
+ * 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>
+}
 
-  interface ComponentInstance {
-    type: Component
-    parent: ComponentInstance | null
-    appContext: AppContext
-    [key: string]: any
-  }
+/**
+ * Vue 组件实例
+ */
+export interface ComponentInstance {
+  type: Component
+  parent: ComponentInstance | null
+  appContext: AppContext
+}
 
-  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
-  }
+/**
+ * Vue 应用上下文
+ */
+export interface AppContext {
+  app: App
+  config: AppConfig
+  components: Record<string, Component>
+  provides: Record<string | symbol, any>
+}
 
-  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
-  }
+/**
+ * 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
+}
 
-  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 应用配置
+ */
+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 响应式 API 类型定义
+/**
+ * Vue 响应式引用
+ */
 export interface Ref<T> {
   value: T
 }
 
-export interface VueReactivityAPI {
+/**
+ * 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
-}
-
-// 导出类型
-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

@@ -2,126 +2,100 @@
  * WebAssembly 环境类型定义
  * 用于在不同环境下提供 WebAssembly API 的类型支持
  */
+import type { BufferSource } from './arraybuffer.d'
 
-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'
-  }
+// 核心接口
+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
+}

package/references/wechat.d.ts

@@ -1,6 +1,6 @@
 // 微信小程序环境类型声明
 
-export interface WxAPI {
+export interface Wx {
   env: {
     USER_DATA_PATH: string
   }