zcw-shared 1.28.0 → 1.30.0

package/dist/vue-hooks/worker/useWorkerPool.d.ts

@@ -1,6 +1,6 @@
 import type { WorkerConstructor } from '../../../references/worker.d';
 import type { setTimeout, clearTimeout, setInterval, clearInterval } from '../../../references/timer.d';
-import type { Ref } from '../../../references/vue.d';
+import type { Ref } from 'vue';
 import type { WebWorkerOptions, WorkerTask, WorkerPoolResult, WorkerPoolStats } from '../../../types/worker';
 export interface WorkerPoolDeps {
     Worker: WorkerConstructor;
@@ -18,9 +18,9 @@ export default function useWorkerPool(deps: WorkerPoolDeps, options: WebWorkerOp
     minPoolSize?: number;
     maxPoolSize?: number;
 }): {
-    isReady: Ref<boolean>;
-    isLoading: Ref<boolean>;
-    error: Ref<Error | null>;
+    isReady: Ref<boolean, boolean>;
+    isLoading: Ref<boolean, boolean>;
+    error: Ref<Error | null, Error | null>;
     execute: <T>(task: WorkerTask) => Promise<WorkerPoolResult<T>>;
     executeBatch: <T>(tasks: WorkerTask[]) => Promise<WorkerPoolResult<T>[]>;
     cancelTask: (taskId: number) => boolean;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "zcw-shared",
-  "version": "1.28.0",
+  "version": "1.30.0",
   "files": [
     "references",
     "dist",
@@ -34,7 +34,7 @@
     "typescript": "^5.8.3",
     "vitepress": "^1.6.4",
     "vue": "^3.5.22",
-    "zcw-shared": "^1.27.0",
+    "zcw-shared": "^1.28.0",
     "zcw-vue-ui": "^1.11.3"
   },
   "exports": {
@@ -148,6 +148,7 @@
     "./functions/image/generateMacIcons": "./dist/functions/image/generateMacIcons.js",
     "./functions/image/generateMacTrayIcon": "./dist/functions/image/generateMacTrayIcon.js",
     "./functions/image/generatePaddedImage": "./dist/functions/image/generatePaddedImage.js",
+    "./functions/image/generatePlaceholderImage": "./dist/functions/image/generatePlaceholderImage.js",
     "./functions/image/generatePwaIcons": "./dist/functions/image/generatePwaIcons.js",
     "./functions/image/generateRoundedImage": "./dist/functions/image/generateRoundedImage.js",
     "./functions/image/getImageDimensions": "./dist/functions/image/getImageDimensions.js",
@@ -257,6 +258,7 @@
     "./vue-hooks/browser/useBluetooth": "./dist/vue-hooks/browser/useBluetooth.js",
     "./vue-hooks/browser/useCamera": "./dist/vue-hooks/browser/useCamera.js",
     "./vue-hooks/browser/useClipboard": "./dist/vue-hooks/browser/useClipboard.js",
+    "./vue-hooks/browser/useFileUpload": "./dist/vue-hooks/browser/useFileUpload.js",
     "./vue-hooks/browser/useFullscreen": "./dist/vue-hooks/browser/useFullscreen.js",
     "./vue-hooks/browser/useGamepad": "./dist/vue-hooks/browser/useGamepad.js",
     "./vue-hooks/browser/useGeolocation": "./dist/vue-hooks/browser/useGeolocation.js",

package/types/vue.d.ts

@@ -1,5 +1,5 @@
 import type { ColorReference } from './design-system.d'
-import type { Ref, InjectionKey, WatchStopHandle } from '../references/vue.d'
+import type { Ref, InjectionKey, WatchStopHandle } from 'vue'
 
 /**
  * Vue Composition API 通用接口

package/references/vue.d.ts

@@ -1,242 +0,0 @@
-// 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 虚拟节点
- */
-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 type LifecycleHook = () => void
-
-/**
- * Vue 监听器选项
- */
-export interface WatchOptions {
-  immediate?: boolean
-  deep?: boolean
-  flush?: 'pre' | 'post' | 'sync'
-}
-
-/**
- * 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
-}