zcw-shared 1.19.0 → 1.20.0

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zcw-shared",
-  "version": "1.19.0",
+  "version": "1.20.0",
   "files": [
     "references",
     "dist",
@@ -22,13 +22,15 @@
     "publish:major": "npx tsx scripts/publish.ts major",
     "publish:prerelease": "npx tsx scripts/publish.ts prerelease",
     "docs:dev": "vitepress dev docs",
-    "docs:build": "vitepress build docs",
+    "docs:build": "NODE_OPTIONS=--max-old-space-size=4096 vitepress build docs",
     "docs:preview": "vitepress preview docs"
   },
   "devDependencies": {
     "tsx": "^4.20.3",
     "typescript": "^5.8.3",
-    "vitepress": "^1.6.4"
+    "vitepress": "^1.6.4",
+    "vue": "^3.5.22",
+    "zcw-vue-ui": "^1.9.0"
   },
   "exports": {
     "./constants/colorPatterns": "./dist/constants/colorPatterns.js",
@@ -40,6 +42,7 @@
     "./functions/android/modifyGradle": "./dist/functions/android/modifyGradle.js",
     "./functions/android/modifyManifest": "./dist/functions/android/modifyManifest.js",
     "./functions/android/permission": "./dist/functions/android/permission.js",
+    "./functions/async/createInterruptibleTask": "./dist/functions/async/createInterruptibleTask.js",
     "./functions/color/colorValidation": "./dist/functions/color/colorValidation.js",
     "./functions/color/convertColor": "./dist/functions/color/convertColor.js",
     "./functions/color/deduplicateColors": "./dist/functions/color/deduplicateColors.js",
@@ -47,6 +50,7 @@
     "./functions/color/extractColors": "./dist/functions/color/extractColors.js",
     "./functions/css/extractCssVariables": "./dist/functions/css/extractCssVariables.js",
     "./functions/debug/createDebugger": "./dist/functions/debug/createDebugger.js",
+    "./functions/dom/demonstrateResourceLoading": "./dist/functions/dom/demonstrateResourceLoading.js",
     "./functions/dom/detectOverflow": "./dist/functions/dom/detectOverflow.js",
     "./functions/dom/getElementRect": "./dist/functions/dom/getElementRect.js",
     "./functions/dom/getRelativePosition": "./dist/functions/dom/getRelativePosition.js",
@@ -80,21 +84,45 @@
     "./functions/uniapp/detectProjectType": "./dist/functions/uniapp/detectProjectType.js",
     "./functions/uniapp/parseManifest": "./dist/functions/uniapp/parseManifest.js",
     "./functions/uniapp/waitForPages": "./dist/functions/uniapp/waitForPages.js",
+    "./functions/utils/AVLTree": "./dist/functions/utils/AVLTree.js",
+    "./functions/utils/BinarySearchTree": "./dist/functions/utils/BinarySearchTree.js",
+    "./functions/utils/EventEmitter": "./dist/functions/utils/EventEmitter.js",
+    "./functions/utils/Graph": "./dist/functions/utils/Graph.js",
+    "./functions/utils/HashMap": "./dist/functions/utils/HashMap.js",
+    "./functions/utils/Heap": "./dist/functions/utils/Heap.js",
+    "./functions/utils/LRUCache": "./dist/functions/utils/LRUCache.js",
+    "./functions/utils/LinkedList": "./dist/functions/utils/LinkedList.js",
+    "./functions/utils/MyPromise": "./dist/functions/utils/MyPromise.js",
+    "./functions/utils/PriorityQueue": "./dist/functions/utils/PriorityQueue.js",
+    "./functions/utils/Queue": "./dist/functions/utils/Queue.js",
+    "./functions/utils/Stack": "./dist/functions/utils/Stack.js",
+    "./functions/utils/Trie": "./dist/functions/utils/Trie.js",
+    "./functions/utils/UnionFind": "./dist/functions/utils/UnionFind.js",
     "./functions/utils/compose": "./dist/functions/utils/compose.js",
     "./functions/utils/cond": "./dist/functions/utils/cond.js",
     "./functions/utils/curry": "./dist/functions/utils/curry.js",
+    "./functions/utils/curryAdvanced": "./dist/functions/utils/curryAdvanced.js",
     "./functions/utils/debounce": "./dist/functions/utils/debounce.js",
+    "./functions/utils/deepClone": "./dist/functions/utils/deepClone.js",
     "./functions/utils/evolve": "./dist/functions/utils/evolve.js",
+    "./functions/utils/flatten": "./dist/functions/utils/flatten.js",
+    "./functions/utils/flattenObject": "./dist/functions/utils/flattenObject.js",
     "./functions/utils/flow": "./dist/functions/utils/flow.js",
+    "./functions/utils/functionBind": "./dist/functions/utils/functionBind.js",
     "./functions/utils/generateExports": "./dist/functions/utils/generateExports.js",
+    "./functions/utils/generatorUtils": "./dist/functions/utils/generatorUtils.js",
     "./functions/utils/isType": "./dist/functions/utils/isType.js",
     "./functions/utils/memoize": "./dist/functions/utils/memoize.js",
+    "./functions/utils/myInstanceof": "./dist/functions/utils/myInstanceof.js",
+    "./functions/utils/myNew": "./dist/functions/utils/myNew.js",
     "./functions/utils/once": "./dist/functions/utils/once.js",
     "./functions/utils/partial": "./dist/functions/utils/partial.js",
     "./functions/utils/pipe": "./dist/functions/utils/pipe.js",
+    "./functions/utils/promiseLimit": "./dist/functions/utils/promiseLimit.js",
     "./functions/utils/retryWithBackoff": "./dist/functions/utils/retryWithBackoff.js",
     "./functions/utils/tap": "./dist/functions/utils/tap.js",
     "./functions/utils/throttle": "./dist/functions/utils/throttle.js",
+    "./functions/utils/unique": "./dist/functions/utils/unique.js",
     "./functions/utils/until": "./dist/functions/utils/until.js",
     "./functions/utils/validate": "./dist/functions/utils/validate.js",
     "./functions/utils/walk": "./dist/functions/utils/walk.js",
@@ -109,11 +137,20 @@
     "./functions/vue/parseVueFile": "./dist/functions/vue/parseVueFile.js",
     "./functions/wechat/miniapp/downloadFile": "./dist/functions/wechat/miniapp/downloadFile.js",
     "./functions/xml/modifyXml": "./dist/functions/xml/modifyXml.js",
+    "./hooks/createGlobalState": "./dist/hooks/createGlobalState.js",
+    "./hooks/createInjectionState": "./dist/hooks/createInjectionState.js",
+    "./hooks/createSharedComposable": "./dist/hooks/createSharedComposable.js",
+    "./hooks/injectLocal": "./dist/hooks/injectLocal.js",
+    "./hooks/provideLocal": "./dist/hooks/provideLocal.js",
     "./hooks/useAltool": "./dist/hooks/useAltool.js",
+    "./hooks/useAsyncState": "./dist/hooks/useAsyncState.js",
     "./hooks/useCache": "./dist/hooks/useCache.js",
+    "./hooks/useDebouncedRefHistory": "./dist/hooks/useDebouncedRefHistory.js",
     "./hooks/useDraggable": "./dist/hooks/useDraggable.js",
     "./hooks/useLocalStorage": "./dist/hooks/useLocalStorage.js",
+    "./hooks/useManualRefHistory": "./dist/hooks/useManualRefHistory.js",
     "./hooks/usePluginSystem": "./dist/hooks/usePluginSystem.js",
+    "./hooks/useRefHistory": "./dist/hooks/useRefHistory.js",
     "./hooks/useResizable": "./dist/hooks/useResizable.js",
     "./hooks/useSessionStorage": "./dist/hooks/useSessionStorage.js",
     "./hooks/useStorage": "./dist/hooks/useStorage.js",

package/references/browser.d.ts

@@ -4,7 +4,7 @@ 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, HTMLImageElement } from './dom.d'
+import type { Document, HTMLElement, Element, HTMLImageElement, CSSStyleDeclaration } 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'
@@ -88,9 +88,35 @@ export interface Window {
   // 动画API
   requestAnimationFrame: (callback: (time: number) => void) => number
   cancelAnimationFrame: (id: number) => void
-  
+
+  // 空闲回调API
+  requestIdleCallback?: (callback: (deadline: IdleDeadline) => void, options?: IdleRequestOptions) => number
+  cancelIdleCallback?: (id: number) => void
+
+  // 性能API
+  performance: Performance
+
+  // 样式计算API
+  getComputedStyle: (element: Element, pseudoElement?: string | null) => CSSStyleDeclaration
+
   // 开发环境标识
   __DEV__?: boolean
   
 
+}
+
+// 空闲回调相关接口
+export interface IdleDeadline {
+  timeRemaining(): number
+  didTimeout: boolean
+}
+
+export interface IdleRequestOptions {
+  timeout?: number
+}
+
+// 性能API接口
+export interface Performance {
+  now(): number
+  timeOrigin: number
 }

package/references/dom.d.ts

@@ -21,6 +21,10 @@ export interface HTMLElement extends Element {
   removeEventListener(event: string, handler: (e: any) => void, options?: any): void
   clientWidth: number
   clientHeight: number
+  offsetLeft: number
+  offsetTop: number
+  offsetWidth: number
+  offsetHeight: number
 }
 
 export interface HTMLImageElement extends HTMLElement {
@@ -31,6 +35,29 @@ export interface HTMLImageElement extends HTMLElement {
   onerror: (() => void) | null
 }
 
+export interface HTMLScriptElement extends HTMLElement {
+  src: string
+  async: boolean
+  defer: boolean
+  type: string
+  onload: (() => void) | null
+  onerror: (() => void) | null
+}
+
+export interface HTMLLinkElement extends HTMLElement {
+  href: string
+  rel: string
+  media: string
+  onload: (() => void) | null
+  onerror: (() => void) | null
+}
+
+export interface HTMLIFrameElement extends HTMLElement {
+  src: string
+  onload: (() => void) | null
+  onerror: (() => void) | null
+}
+
 export interface CanvasRenderingContext2D {
   drawImage(image: HTMLImageElement, dx: number, dy: number, dWidth: number, dHeight: number): void
 }
@@ -44,11 +71,19 @@ export interface HTMLCanvasElement extends HTMLElement {
 
 export interface Document {
   createElement(tagName: 'canvas'): HTMLCanvasElement
+  createElement(tagName: 'script'): HTMLScriptElement
+  createElement(tagName: 'link'): HTMLLinkElement
+  createElement(tagName: 'img'): HTMLImageElement
+  createElement(tagName: 'iframe'): HTMLIFrameElement
   createElement(tagName: string): HTMLElement
   documentElement: {
     clientWidth: number
     clientHeight: number
   }
+  head: {
+    appendChild(element: HTMLElement): HTMLElement
+  }
+  body: HTMLElement
   addEventListener(event: string, handler: (e: any) => void, options?: any): void
   removeEventListener(event: string, handler: (e: any) => void, options?: any): void
 }
@@ -81,4 +116,14 @@ export interface DOMException {
 
 export interface DOMStringList {
   contains(string: string): boolean
+}
+
+export interface CSSStyleDeclaration {
+  position: string
+  left: string
+  top: string
+  width: string
+  height: string
+  transform: string
+  [property: string]: string
 }

package/references/indexeddb.d.ts

@@ -23,6 +23,7 @@ export interface IDBObjectStore {
   put(value: any, key?: IDBValidKey): IDBRequest
   delete(key: IDBValidKey): IDBRequest
   clear(): IDBRequest
+  getAllKeys(): IDBRequest
 }
 
 export interface IDBTransaction {

package/references/node.d.ts

@@ -25,21 +25,56 @@ export interface Buffer {
   toString(encoding?: string): string
 }
 
+export type BufferEncoding = 'ascii' | 'utf8' | 'utf-8' | 'utf16le' | 'ucs2' | 'ucs-2' | 'base64' | 'base64url' | 'latin1' | 'binary' | 'hex'
+
 export interface FileSystem {
-  readFile(path: string, encoding?: string): Promise<any>
-  readFileSync(path: string, encoding?: string): string
-  writeFile(path: string, data: any): Promise<void>
-  writeFileSync(path: string, data: any, encoding?: string): void
-  mkdir(path: string, options?: any): Promise<void>
-  mkdirSync(path: string, options?: any): void
-  copyFileSync(src: string, dest: string): void
+  /** 异步读取文件（回调版本） - 返回 Buffer */
+  readFile(path: string, callback: (err: Error | null, data: Buffer) => void): void
+  /** 异步读取文件（回调版本） - 返回 string */
+  readFile(path: string, encoding: BufferEncoding, callback: (err: Error | null, data: string) => void): void
+  readFile(path: string, options: { encoding: BufferEncoding, flag?: string }, callback: (err: Error | null, data: string) => void): void
+  
+  /** 同步读取文件 - 返回 Buffer */
+  readFileSync(path: string): Buffer
+  /** 同步读取文件 - 返回 string */
+  readFileSync(path: string, encoding: BufferEncoding): string
+  readFileSync(path: string, options?: { encoding?: BufferEncoding, flag?: string } | BufferEncoding | null): string | Buffer
+  
+  /** 异步写入文件（Promise 版本） */
+  writeFile(path: string, data: string | Buffer): Promise<void>
+  
+  /** 同步写入文件 */
+  writeFileSync(path: string, data: string | Buffer, encoding?: BufferEncoding): void
+  writeFileSync(path: string, data: string | Buffer, options?: { encoding?: BufferEncoding, mode?: number, flag?: string }): void
+  
+  /** 异步创建目录 */
+  mkdir(path: string, options?: { recursive?: boolean, mode?: number }): Promise<void>
+  /** 同步创建目录 */
+  mkdirSync(path: string, options?: { recursive?: boolean, mode?: number }): void
+  /** 同步复制文件 */
+  copyFileSync(src: string, dest: string, mode?: number): void
+  /** 检查文件是否存在 */
   existsSync(path: string): boolean
+  /** 读取目录内容 */
   readdirSync(path: string): string[]
+  /** 获取文件状态（跟随符号链接） */
   statSync(path: string): { isDirectory(): boolean; isFile(): boolean; isSymbolicLink(): boolean }
+  /** 获取文件状态（不跟随符号链接） */
   lstatSync(path: string): { isDirectory(): boolean; isFile(): boolean; isSymbolicLink(): boolean }
+  /** 获取符号链接的真实路径 */
   realpathSync(path: string): string
+  /** Promise API */
   promises: {
+    /** 异步复制文件或目录 */
     cp(source: string, destination: string, options?: any): Promise<void>
+    /** 异步读取文件（Promise 版本） - 返回 Buffer */
+    readFile(path: string): Promise<Buffer>
+    /** 异步读取文件（Promise 版本） - 返回 string */
+    readFile(path: string, encoding: BufferEncoding): Promise<string>
+    readFile(path: string, options?: { encoding?: BufferEncoding, flag?: string } | BufferEncoding | null): Promise<string | Buffer>
+    /** 异步写入文件（Promise 版本） */
+    writeFile(path: string, data: string | Buffer, encoding?: BufferEncoding): Promise<void>
+    writeFile(path: string, data: string | Buffer, options?: { encoding?: BufferEncoding, mode?: number, flag?: string }): Promise<void>
   }
 }
 

package/references/vue.d.ts

@@ -1,4 +1,38 @@
-// Vue 类型定义
+// Vue 3 类型定义
+
+/**
+ * Vue 注入键类型
+ */
+export type InjectionKey<T> = symbol
+
+/**
+ * Vue 响应式引用
+ */
+export interface Ref<T = any> {
+  value: T
+  readonly [Symbol.toStringTag]: 'Ref'
+}
+
+/**
+ * Vue 计算属性引用
+ */
+export interface ComputedRef<T = any> extends WritableComputedRef<T> {
+  readonly value: T
+}
+
+/**
+ * Vue 可写计算属性引用
+ */
+export interface WritableComputedRef<T> extends Ref<T> {
+  readonly effect: any
+}
+
+/**
+ * Vue 响应式对象
+ */
+export type UnwrapRef<T> = {
+  [K in keyof T]: T[K] extends Ref<infer V> ? V : T[K]
+}
 
 /**
  * Vue 虚拟节点
@@ -69,18 +103,140 @@ export interface AppConfig {
 }
 
 /**
- * Vue 响应式引用
+ * Vue 生命周期钩子函数类型
  */
-export interface Ref<T> {
-  value: T
+export type LifecycleHook = () => void
+
+/**
+ * Vue 监听器选项
+ */
+export interface WatchOptions {
+  immediate?: boolean
+  deep?: boolean
+  flush?: 'pre' | 'post' | 'sync'
 }
 
 /**
- * Vue 运行时函数
+ * Vue 监听器停止函数
+ */
+export type WatchStopHandle = () => void
+
+// Vue 3 Composition API 函数声明
+
+/**
+ * 创建响应式引用
+ */
+export declare function ref<T>(value: T): Ref<UnwrapRef<T>>
+export declare function ref<T = any>(): Ref<T | undefined>
+
+/**
+ * 创建响应式对象
+ */
+export declare function reactive<T extends object>(target: T): UnwrapRef<T>
+
+/**
+ * 创建计算属性
+ */
+export declare function computed<T>(
+  getter: () => T,
+  debugOptions?: any
+): ComputedRef<T>
+export declare function computed<T>(
+  options: {
+    get: () => T
+    set: (value: T) => void
+  },
+  debugOptions?: any
+): WritableComputedRef<T>
+
+/**
+ * 监听响应式数据变化
+ */
+export declare function watch<T>(
+  source: () => T,
+  callback: (newValue: T, oldValue: T) => void,
+  options?: WatchOptions
+): WatchStopHandle
+
+export declare function watch<T>(
+  source: Ref<T>,
+  callback: (newValue: T, oldValue: T) => void,
+  options?: WatchOptions
+): WatchStopHandle
+
+/**
+ * 立即监听响应式数据变化
+ */
+export declare function watchEffect(
+  effect: () => void,
+  options?: {
+    flush?: 'pre' | 'post' | 'sync'
+    onTrack?: (event: any) => void
+    onTrigger?: (event: any) => void
+  }
+): WatchStopHandle
+
+/**
+ * 组件挂载时执行
+ */
+export declare function onMounted(hook: LifecycleHook): void
+
+/**
+ * 组件卸载时执行
+ */
+export declare function onUnmounted(hook: LifecycleHook): void
+
+/**
+ * 组件更新前执行
+ */
+export declare function onBeforeUpdate(hook: LifecycleHook): void
+
+/**
+ * 组件更新后执行
+ */
+export declare function onUpdated(hook: LifecycleHook): void
+
+/**
+ * 组件挂载前执行
+ */
+export declare function onBeforeMount(hook: LifecycleHook): void
+
+/**
+ * 组件卸载前执行
+ */
+export declare function onBeforeUnmount(hook: LifecycleHook): void
+
+/**
+ * 获取当前组件实例
+ */
+export declare function getCurrentInstance(): ComponentInstance | null
+
+/**
+ * 下一个DOM更新周期
+ */
+export declare function nextTick(fn?: () => void): Promise<void>
+
+/**
+ * 创建Vue应用
+ */
+export declare function createApp(rootComponent: Component, rootProps?: any): App
+
+/**
+ * 定义组件
+ */
+export declare function defineComponent<Props, RawBindings = object>(
+  setup: (props: Props, ctx: any) => RawBindings | (() => VNode | VNode[])
+): Component
+
+export declare function defineComponent(options: Component): Component
+
+/**
+ * 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>
+  onMounted: (fn: () => void) => void
   onUnmounted: (fn: () => void) => void
 }

package/types/android-build.d.ts

@@ -8,11 +8,6 @@
  * @author Assistant
  */
 
-import type { ChildProcess, FileSystem, Path, Process } from '../references/node.d'
-import type { XMLParser, XMLSerializer, XMLParserConstructor, XMLSerializerConstructor } from '../references/xml.d'
-import type { JSON5Parser } from '../references/json5.d'
-import type { XPath } from '../references/xpath.d'
-
 /**
  * Android 工程编译选项（通用）
  */
@@ -43,20 +38,3 @@ export interface AndroidBuildResult {
   error?: string
   logs: string[]
 }
-
-/**
- * 系统依赖接口
- * 用于依赖注入，确保函数的环境无关性
- */
-export interface SystemDependencies {
-  childProcess: ChildProcess
-  fs: FileSystem
-  path: Path
-  process: Process
-  setTimeout: (callback: () => void, delay: number) => any
-  require: (id: string) => any
-  json5: JSON5Parser
-  xmlParser: XMLParserConstructor
-  xmlSerializer: XMLSerializerConstructor
-  xpath: XPath
-}

package/types/tencent-cloud.d.ts

@@ -9,10 +9,7 @@
  * @author Assistant
  */
 
-import type {
-  TencentCloudSystemDependencies,
-  TencentCloudSecret
-} from '../references/tencent-cloud.d'
+import type { TencentCloudSecret } from '../references/tencent-cloud.d'
 
 // 密钥类型
 export type SecretType = 'personal' | 'individual' | 'enterprise'
@@ -36,9 +33,4 @@ export interface DeployResult {
   success: boolean
   message?: string
   error?: string
-}
-
-// 部署函数依赖接口
-export interface DeployDependencies extends TencentCloudSystemDependencies {
-  // 可以扩展特定于部署功能的依赖
 }

package/types/uniapp-android-build.d.ts

@@ -8,10 +8,6 @@
  * @author Assistant
  */
 
-import type { ChildProcess, FileSystem, Path, Process } from '../references/node.d'
-import type { XMLParser, XMLSerializer, XMLParserConstructor, XMLSerializerConstructor } from '../references/xml.d'
-import type { JSON5Parser } from '../references/json5.d'
-import type { XPath } from '../references/xpath.d'
 import type { AndroidBuildOptions, AndroidBuildResult } from './android-build.d'
 
 /**
@@ -31,21 +27,4 @@ export interface UniAppAndroidBuildOptions extends AndroidBuildOptions {
  */
 export interface UniAppAndroidBuildResult extends AndroidBuildResult {
   // 可以添加 UniApp 特有的结果属性
-}
-
-/**
- * UniApp 系统依赖接口
- * 用于依赖注入，确保函数的环境无关性
- */
-export interface UniAppSystemDependencies {
-  childProcess: ChildProcess
-  fs: FileSystem
-  path: Path
-  process: Process
-  setTimeout: (callback: () => void, delay: number) => any
-  require: (id: string) => any
-  json5: JSON5Parser
-  xmlParser: XMLParserConstructor
-  xmlSerializer: XMLSerializerConstructor
-  xpath: XPath
 }