zcw-shared 1.5.0 → 1.8.0

package/types/color.d.ts

@@ -39,81 +39,6 @@ export interface HslaColor extends HslColor {
   a: number
 }
 
-/**
- * 颜色转换结果
- */
-export interface ColorConversionResult {
-  /** 转换后的颜色值 */
-  value: string
-  /** 原始颜色格式 */
-  originalFormat: ColorFormat
-  /** 目标颜色格式 */
-  targetFormat: ColorFormat
-  /** 是否转换成功 */
-  success: boolean
-}
-
-/**
- * 颜色验证结果
- */
-export interface ColorValidationResult {
-  /** 是否为有效颜色 */
-  isValid: boolean
-  /** 检测到的颜色格式 */
-  format?: ColorFormat
-  /** 标准化后的颜色值 */
-  normalizedValue?: string
-}
-
-/**
- * 颜色模式匹配正则表达式集合
- */
-export interface ColorPatterns {
-  /** 十六进制颜色匹配 */
-  hex: RegExp
-  /** RGB颜色匹配 */
-  rgb: RegExp
-  /** RGBA颜色匹配 */
-  rgba: RegExp
-  /** HSL颜色匹配 */
-  hsl: RegExp
-  /** HSLA颜色匹配 */
-  hsla: RegExp
-  /** 命名颜色匹配 */
-  namedColors: RegExp
-}
-
-/**
- * 命名颜色映射表类型
- */
-export type NamedColorMap = Record<string, string>
-
-/**
- * 颜色标准化选项
- */
-export interface ColorNormalizationOptions {
-  /** 是否保留原始格式 */
-  preserveFormat?: boolean
-  /** 是否转换为小写 */
-  toLowerCase?: boolean
-  /** 是否移除空格 */
-  trimSpaces?: boolean
-}
-
-/**
- * 颜色转换选项
- */
-export interface ColorConversionOptions {
-  /** 目标格式 */
-  targetFormat: ColorFormat
-  /** 是否包含alpha通道 */
-  includeAlpha?: boolean
-  /** alpha值（0-1） */
-  alphaValue?: number
-  /** 是否使用8位十六进制格式 */
-  use8BitHex?: boolean
-}
-
 /**
  * 颜色引用信息
  * 用于记录在代码中发现的颜色值及其位置信息
@@ -135,21 +60,6 @@ export interface ColorReference {
   variableName?: string
 }
 
-/**
- * 颜色提取器依赖注入接口
- * 定义颜色提取功能所需的外部依赖
- */
-export interface ColorExtractorDependencies {
-  /** 获取颜色模式匹配正则表达式 */
-  getColorPatterns: () => ColorPatterns
-  /** 标准化颜色值为8位十六进制格式 */
-  standardizeColor: (color: string) => string
-  /** 检测颜色格式 */
-  detectColorFormat: (color: string) => ColorFormat | null
-  /** 验证是否为有效颜色值 */
-  isColorValue: (value: string) => { isValid: boolean; format?: ColorFormat }
-}
-
 /**
  * 颜色提取选项
  */

package/types/geometry.d.ts

@@ -24,43 +24,6 @@ export interface Coordinate {
   y: number
 }
 
-/**
- * 尺寸定义
- */
-export interface Size {
-  width: number
-  height: number
-}
-
-/**
- * 边距定义
- */
-export interface Margin {
-  top: number
-  right: number
-  bottom: number
-  left: number
-}
-
-/**
- * 边框定义
- */
-export interface Border {
-  width: number
-  style: 'solid' | 'dashed' | 'dotted' | 'none'
-  color: string
-}
-
-/**
- * 向量定义
- */
-export interface Vector2D {
-  x: number
-  y: number
-}
-
-/**
- * 类型别名，用于向后兼容
- */
+// 类型别名 - 这些被DOM函数使用
 export type Rect = Rectangle
 export type Coords = Coordinate

package/types/platform.d.ts

@@ -0,0 +1,4 @@
+/**
+ * 平台类型定义
+ */
+export type Platform = 'win32' | 'darwin' | 'linux'

package/types/software.d.ts

@@ -12,16 +12,4 @@ export interface SoftwareConfig {
   registryKey?: string
   /** 环境变量名 */
   envVar: string
-}
-
-/**
- * 平台类型
- */
-export type Platform = 'win32' | 'darwin' | 'linux'
-
-/**
- * Process对象接口
- */
-export interface ProcessLike {
-  platform: string
 }

package/types/storage.d.ts

@@ -34,7 +34,7 @@ export interface IndexedDBStorageOptions extends StorageOptions {
 
 // 存储 Hook 返回值接口
 export interface UseStorageReturn<T> {
-  value: T | null
+  get value(): T | null
   setValue: (value: T | null) => Promise<void>
   removeValue: () => Promise<void>
   clear: () => Promise<void>
@@ -46,4 +46,6 @@ export interface StorageAdapter<T> {
   set: (key: string, value: T) => Promise<void>
   remove: (key: string) => Promise<void>
   clear: () => Promise<void>
+  getAll: () => Promise<Record<string, T>>
+  getKeys: () => Promise<string[]>
 }

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

@@ -0,0 +1,49 @@
+/**
+ * UniApp Android 离线打包相关类型定义
+ * 
+ * @description
+ * 定义 UniApp Android 离线打包功能使用的接口和类型
+ * 
+ * @since 1.0.0
+ * @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 { AndroidBuildOptions, AndroidBuildResult } from './android-build.d'
+
+/**
+ * UniApp Android 构建选项
+ */
+export interface UniAppAndroidBuildOptions extends AndroidBuildOptions {
+  /** UniApp 工程路径 */
+  uniappProjectPath: string
+  /** Android 应用包名 */
+  applicationId?: string
+  /** UniApp 应用密钥 */
+  appkey?: string
+}
+
+/**
+ * UniApp Android 构建结果
+ */
+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
+}

package/types/worker.d.ts

@@ -9,6 +9,8 @@
  * @author Assistant
  */
 
+import type { Timeout } from '../../references/node.d'
+
 /**
  * 响应式值接口
  */
@@ -58,33 +60,6 @@ export interface WebWorkerResult<T> {
   error: Error | null
 }
 
-/**
- * useWebWorker返回值接口
- */
-export interface UseWebWorkerReturn {
-  /** Worker是否准备就绪 */
-  isReady: ReactiveValue<boolean>
-  /** 是否正在加载 */
-  isLoading: ReactiveValue<boolean>
-  /** 错误状态 */
-  error: ReactiveValue<Error | null>
-  /** 发送消息 */
-  postMessage: <T>(data: any, transfer?: Transferable[]) => Promise<WebWorkerResult<T>>
-  /** 批量发送消息 */
-  postMessages: <T>(messages: any[], transfer?: Transferable[][]) => Promise<WebWorkerResult<T>[]>
-  /** 终止Worker */
-  terminate: () => void
-  /** 重启Worker */
-  restart: () => Promise<void>
-  /** 获取状态 */
-  getStatus: () => {
-    isReady: boolean
-    isLoading: boolean
-    error: Error | null
-    pendingMessages: number
-  }
-}
-
 /**
  * Worker任务接口
  */
@@ -192,64 +167,6 @@ export interface WorkerFunctionResult<R> {
   executionTime: number
 }
 
-/**
- * useWorkerFunction返回类型
- */
-export interface UseWorkerFunctionReturn<T extends any[], R> {
-  /** Worker是否准备就绪 */
-  isReady: ReactiveValue<boolean>
-  /** 是否正在加载 */
-  isLoading: ReactiveValue<boolean>
-  /** 错误状态 */
-  error: ReactiveValue<Error | null>
-  /** 执行函数 */
-  execute: (...args: T) => Promise<WorkerFunctionResult<R>>
-  /** 终止Worker */
-  terminate: () => void
-  /** 获取状态信息 */
-  getStatus: () => {
-    isReady: boolean
-    isLoading: boolean
-    error: Error | null
-    executionCount: number
-  }
-}
-
-/**
- * useWorkerPool返回值接口
- */
-export interface UseWorkerPoolReturn {
-  /** 池是否准备就绪 */
-  isReady: ReactiveValue<boolean>
-  /** 是否正在加载 */
-  isLoading: ReactiveValue<boolean>
-  /** 错误状态 */
-  error: ReactiveValue<Error | null>
-  /** 执行任务 */
-  execute: <T>(task: WorkerTask) => Promise<WorkerPoolResult<T>>
-  /** 批量执行任务 */
-  executeBatch: <T>(tasks: WorkerTask[]) => Promise<WorkerPoolResult<T>[]>
-  /** 取消任务 */
-  cancelTask: (taskId: number) => boolean
-  /** 清空队列 */
-  clearQueue: () => void
-  /** 调整池大小 */
-  resize: (newSize: number) => Promise<void>
-  /** 获取统计信息 */
-  getStats: () => WorkerPoolStats
-  /** 终止池 */
-  terminate: () => void
-  /** 重启池 */
-  restart: () => Promise<void>
-  /** 清理资源 */
-  cleanup: () => void
-}
-
-/**
- * Worker事件类型
- */
-export type WorkerEventType = 'message' | 'error' | 'messageerror'
-
 /**
  * Worker状态类型
  */
@@ -258,107 +175,4 @@ export type WorkerStatus = 'idle' | 'loading' | 'ready' | 'busy' | 'error' | 'te
 /**
  * 任务优先级类型
  */
-export type TaskPriority = 'low' | 'normal' | 'high'
-
-/**
- * Worker池策略类型
- */
-export type PoolStrategy = 'round-robin' | 'least-busy' | 'random' | 'priority'
-
-/**
- * 负载均衡策略接口
- */
-export interface LoadBalancingStrategy {
-  /** 策略名称 */
-  name: PoolStrategy
-  /** 选择Worker的函数 */
-  selectWorker: (workers: WorkerInfo[], task: WorkerTask) => number
-}
-
-/**
- * Worker信息接口
- */
-export interface WorkerInfo {
-  /** Worker ID */
-  id: number
-  /** 是否忙碌 */
-  busy: boolean
-  /** 任务计数 */
-  taskCount: number
-  /** 最后使用时间 */
-  lastUsed: number
-  /** Worker状态 */
-  status: WorkerStatus
-  /** 错误计数 */
-  errorCount: number
-}
-
-/**
- * 任务执行上下文
- */
-export interface TaskExecutionContext {
-  /** 任务ID */
-  taskId: number
-  /** Worker ID */
-  workerId: number
-  /** 开始时间 */
-  startTime: number
-  /** 超时ID */
-  timeoutId: NodeJS.Timeout
-  /** 任务数据 */
-  task: WorkerTask
-}
-
-/**
- * Worker池配置
- */
-export interface WorkerPoolConfig extends WorkerPoolOptions {
-  /** 负载均衡策略 */
-  strategy?: PoolStrategy
-  /** 健康检查间隔（毫秒） */
-  healthCheckInterval?: number
-  /** Worker空闲超时（毫秒） */
-  idleTimeout?: number
-  /** 最大错误次数 */
-  maxErrors?: number
-}
-
-/**
- * 任务队列项
- */
-export interface TaskQueueItem {
-  /** 任务 */
-  task: WorkerTask
-  /** 解决函数 */
-  resolve: (value: WorkerPoolResult<any>) => void
-  /** 拒绝函数 */
-  reject: (error: Error) => void
-  /** 优先级数值 */
-  priority: number
-  /** 时间戳 */
-  timestamp: number
-  /** 任务ID */
-  taskId: number
-}
-
-/**
- * Worker性能指标
- */
-export interface WorkerMetrics {
-  /** 总任务数 */
-  totalTasks: number
-  /** 成功任务数 */
-  successfulTasks: number
-  /** 失败任务数 */
-  failedTasks: number
-  /** 平均执行时间 */
-  averageExecutionTime: number
-  /** 最大执行时间 */
-  maxExecutionTime: number
-  /** 最小执行时间 */
-  minExecutionTime: number
-  /** 错误率 */
-  errorRate: number
-  /** 吞吐量（任务/秒） */
-  throughput: number
-}
+export type TaskPriority = 'low' | 'normal' | 'high'

package/references/browser.extension.d.ts

@@ -1,14 +0,0 @@
-export interface TabInfo {
-  id?: number;
-  windowId?: number;
-}
-
-export type SenderType = 'content' | 'background' | 'popup' | 'sidepanel' | 'options';
-
-export interface MessageSender {
-  type: SenderType;
-  tab?: TabInfo;
-  id?: string;
-  url?: string;
-  frameId?: number;
-} 

package/types/network.d.ts

@@ -1,184 +0,0 @@
-/**
- * 网络请求相关类型定义
- * 
- * @description
- * 定义网络请求hooks使用的接口和类型
- * 
- * @since 1.0.0
- * @author Assistant
- */
-
-import type { Response } from '../../references/fetch.d'
-
-/**
- * 请求选项接口
- */
-export interface RequestOptions extends RequestInit {
-  /** 是否启用缓存 */
-  cache?: boolean
-  /** 缓存TTL（毫秒） */
-  cacheTTL?: number
-  /** 重试次数 */
-  retry?: number
-  /** 重试延迟（毫秒） */
-  retryDelay?: number
-  /** 请求超时（毫秒） */
-  timeout?: number
-}
-
-/**
- * 请求结果接口
- */
-export interface RequestResult<T> {
-  /** 请求是否成功 */
-  success: boolean
-  /** 响应数据 */
-  data: T | null
-  /** 错误信息 */
-  error: Error | null
-  /** 是否来自缓存 */
-  fromCache: boolean
-}
-
-/**
- * 响应式值接口
- */
-export interface ReactiveValue<T> {
-  value: T
-}
-
-/**
- * useRequest返回值接口
- */
-export interface UseRequestReturn<T> {
-  /** 加载状态 */
-  loading: ReactiveValue<boolean>
-  /** 错误状态 */
-  error: ReactiveValue<Error | null>
-  /** 数据状态 */
-  data: ReactiveValue<T | null>
-  /** 执行请求 */
-  execute: (url: string, options?: RequestOptions) => Promise<RequestResult<T>>
-  /** 取消请求 */
-  cancel: () => void
-  /** 清除缓存 */
-  clearCache: (url?: string) => void
-  /** 获取缓存统计 */
-  getCacheStats: () => {
-    total: number
-    valid: number
-    expired: number
-  }
-}
-
-/**
- * 请求数据类型
- */
-export type RequestData = string | FormData | Blob | ArrayBuffer | URLSearchParams | Record<string, unknown> | null
-
-/**
- * Fetch选项接口
- */
-export interface FetchOptions {
-  /** 基础URL */
-  baseURL?: string
-  /** 请求数据 */
-  data?: RequestData
-  /** HTTP方法 */
-  method?: string
-  /** 请求头 */
-  headers?: Record<string, string> | Headers
-  /** 请求体 */
-  body?: BodyInit | null
-  /** 中止信号 */
-  signal?: AbortSignal
-  /** 凭据模式 */
-  credentials?: RequestCredentials
-  /** 缓存模式 */
-  cache?: RequestCache
-  /** 重定向模式 */
-  redirect?: RequestRedirect
-  /** 引用者 */
-  referrer?: string
-  /** 引用者策略 */
-  referrerPolicy?: ReferrerPolicy
-  /** 完整性 */
-  integrity?: string
-  /** 保持连接 */
-  keepalive?: boolean
-  /** 模式 */
-  mode?: RequestMode
-}
-
-/**
- * Fetch结果接口
- */
-export interface FetchResult<T> {
-  /** 请求是否成功 */
-  success: boolean
-  /** 响应数据 */
-  data: T | null
-  /** 响应数据 */
-  response: Response | null
-  /** 错误信息 */
-  error: Error | null
-}
-
-/**
- * useFetch返回值接口
- */
-export interface UseFetchReturn {
-  /** 加载状态 */
-  loading: ReactiveValue<boolean>
-  /** 错误状态 */
-  error: ReactiveValue<Error | null>
-  /** 通用请求方法 */
-  request: <T>(url: string, options?: FetchOptions) => Promise<FetchResult<T>>
-  /** GET请求 */
-  get: <T>(url: string, options?: Omit<FetchOptions, 'method' | 'data'>) => Promise<FetchResult<T>>
-  /** POST请求 */
-  post: <T>(url: string, data?: RequestData, options?: Omit<FetchOptions, 'method' | 'data'>) => Promise<FetchResult<T>>
-  /** PUT请求 */
-  put: <T>(url: string, data?: RequestData, options?: Omit<FetchOptions, 'method' | 'data'>) => Promise<FetchResult<T>>
-  /** DELETE请求 */
-  delete: <T>(url: string, options?: Omit<FetchOptions, 'method' | 'data'>) => Promise<FetchResult<T>>
-  /** PATCH请求 */
-  patch: <T>(url: string, data?: RequestData, options?: Omit<FetchOptions, 'method' | 'data'>) => Promise<FetchResult<T>>
-  /** HEAD请求 */
-  head: (url: string, options?: Omit<FetchOptions, 'method' | 'data'>) => Promise<FetchResult<unknown>>
-  /** OPTIONS请求 */
-  options: (url: string, options?: Omit<FetchOptions, 'method' | 'data'>) => Promise<FetchResult<unknown>>
-  /** 添加请求拦截器 */
-  addRequestInterceptor: (interceptor: (config: FetchOptions) => FetchOptions | Promise<FetchOptions>) => void
-  /** 添加响应拦截器 */
-  addResponseInterceptor: (interceptor: (response: Response) => Response | Promise<Response>) => void
-  /** 移除请求拦截器 */
-  removeRequestInterceptor: (interceptor: (config: FetchOptions) => FetchOptions | Promise<FetchOptions>) => void
-  /** 移除响应拦截器 */
-  removeResponseInterceptor: (interceptor: (response: Response) => Response | Promise<Response>) => void
-}
-
-/**
- * 请求拦截器函数类型
- */
-export type RequestInterceptor = (config: FetchOptions) => FetchOptions | Promise<FetchOptions>
-
-/**
- * 响应拦截器类型
- */
-export type ResponseInterceptor = (response: Response) => Response | Promise<Response>
-
-/**
- * HTTP方法类型
- */
-export type HttpMethod = 'GET' | 'POST' | 'PUT' | 'DELETE' | 'PATCH' | 'HEAD' | 'OPTIONS'
-
-/**
- * 缓存策略类型
- */
-export type CacheStrategy = 'no-cache' | 'memory' | 'storage'
-
-/**
- * 请求状态类型
- */
-export type RequestStatus = 'idle' | 'loading' | 'success' | 'error'

package/types/util.d.ts

@@ -1,27 +0,0 @@
-/**
- * 通用工具类型定义
- */
-
-// 忽略所有body开头的属性
-export type OmitBodyProperties<T> = {
-  [K in keyof T as K extends `body${string}` ? never : K]: T[K]
-}
-
-// 深度可选类型
-export type DeepPartial<T> = {
-  [P in keyof T]?: T[P] extends object ? DeepPartial<T[P]> : T[P]
-}
-
-// 可选属性类型
-export type Optional<T, K extends keyof T> = Omit<T, K> & Partial<Pick<T, K>>
-
-// 必需属性类型
-export type RequiredKeys<T, K extends keyof T> = T & Required<Pick<T, K>>
-
-// 非空类型
-export type NonNullable<T> = T extends null | undefined ? never : T
-
-// 键值对类型
-export type KeyValuePair<K extends string | number | symbol, V> = {
-  [P in K]: V
-}