zcw-shared 1.2.0

package/references/wechat.d.ts

@@ -0,0 +1,49 @@
+// 微信小程序环境类型声明
+
+export interface WxAPI {
+  env: {
+    USER_DATA_PATH: string
+  }
+  downloadFile(options: {
+    url: string
+    filePath: string
+    success: (res: { statusCode: number; filePath: string }) => void
+    fail: (err: any) => void
+  }): void
+  
+  uploadFile(options: {
+    url: string
+    filePath: string
+    name: string
+    formData?: Record<string, any>
+    success: (res: { statusCode: number; data: string }) => void
+    fail: (err: any) => void
+  }): void
+  
+  request(options: {
+    url: string
+    method?: 'GET' | 'POST' | 'PUT' | 'DELETE'
+    data?: any
+    header?: Record<string, string>
+    success: (res: { statusCode: number; data: any }) => void
+    fail: (err: any) => void
+  }): void
+  
+  showToast(options: {
+    title: string
+    icon?: 'success' | 'error' | 'loading' | 'none'
+    duration?: number
+    success?: () => void
+    fail?: (err: any) => void
+  }): void
+  
+  showModal(options: {
+    title: string
+    content: string
+    showCancel?: boolean
+    cancelText?: string
+    confirmText?: string
+    success: (res: { confirm: boolean; cancel: boolean }) => void
+    fail?: (err: any) => void
+  }): void
+}

package/references/worker.d.ts

@@ -0,0 +1,207 @@
+/**
+ * Web Worker 环境类型定义
+ * 包含浏览器和其他环境的 Worker API 类型支持
+ */
+
+/**
+ * Worker 构造函数选项
+ */
+export interface WorkerOptions {
+  type?: 'classic' | 'module'
+  credentials?: 'omit' | 'same-origin' | 'include'
+  name?: string
+}
+
+/**
+ * Transferable 对象接口
+ */
+export interface Transferable {
+  // 标记接口，用于类型检查
+}
+
+/**
+ * Worker 全局作用域接口
+ */
+export interface WorkerGlobalScope extends EventTarget {
+  self: WorkerGlobalScope
+  location: WorkerLocation
+  navigator: WorkerNavigator
+  importScripts(...urls: string[]): void
+  close(): void
+  postMessage(message: any, transfer?: Transferable[]): void
+  onmessage: ((event: MessageEvent) => void) | null
+  onmessageerror: ((event: MessageEvent) => void) | null
+  onerror: ((event: ErrorEvent) => void) | null
+}
+
+/**
+ * Worker 位置接口
+ */
+export interface WorkerLocation {
+  href: string
+  protocol: string
+  host: string
+  hostname: string
+  port: string
+  pathname: string
+  search: string
+  hash: string
+  origin: string
+}
+
+/**
+ * Worker 导航器接口
+ */
+export interface WorkerNavigator {
+  userAgent: string
+  platform: string
+  language: string
+  languages: readonly string[]
+  onLine: boolean
+  hardwareConcurrency: number
+}
+
+/**
+ * 消息事件接口
+ */
+export interface MessageEvent<T = any> extends Event {
+  data: T
+  origin: string
+  lastEventId: string
+  source: MessageEventSource | null
+  ports: readonly MessagePort[]
+}
+
+/**
+ * 错误事件接口
+ */
+export interface ErrorEvent extends Event {
+  message: string
+  filename: string
+  lineno: number
+  colno: number
+  error: any
+}
+
+/**
+ * 消息端口接口
+ */
+export interface MessagePort extends EventTarget {
+  postMessage(message: any, transfer?: Transferable[]): void
+  start(): void
+  close(): void
+  onmessage: ((event: MessageEvent) => void) | null
+  onmessageerror: ((event: MessageEvent) => void) | null
+}
+
+/**
+ * 消息事件源类型
+ */
+export type MessageEventSource = WindowProxy | MessagePort | ServiceWorker
+
+/**
+ * Window 代理接口
+ */
+export interface WindowProxy {
+  // 标记接口，用于类型检查
+}
+
+/**
+ * Service Worker 接口
+ */
+export interface ServiceWorker extends EventTarget {
+  scriptURL: string
+  state: ServiceWorkerState
+  postMessage(message: any, transfer?: Transferable[]): void
+  onstatechange: ((event: Event) => void) | null
+}
+
+/**
+ * Service Worker 状态类型
+ */
+export type ServiceWorkerState = 'installing' | 'installed' | 'activating' | 'activated' | 'redundant'
+
+/**
+ * Worker 构造函数接口
+ */
+export interface WorkerConstructor {
+  new (scriptURL: string | URL, options?: WorkerOptions): Worker
+}
+
+/**
+ * Worker 接口
+ */
+export interface Worker extends EventTarget {
+  postMessage(message: any, transfer?: Transferable[]): void
+  terminate(): void
+  onmessage: ((event: MessageEvent) => void) | null
+  onmessageerror: ((event: MessageEvent) => void) | null
+  onerror: ((event: ErrorEvent) => void) | null
+}
+
+/**
+ * Worker 环境接口
+ * 包含所有 Worker 相关的环境 API
+ */
+export interface WorkerEnvironment {
+  Worker?: WorkerConstructor
+  SharedWorker?: SharedWorkerConstructor
+  ServiceWorker?: ServiceWorkerConstructor
+  MessageChannel?: MessageChannelConstructor
+  BroadcastChannel?: BroadcastChannelConstructor
+}
+
+/**
+ * Shared Worker 构造函数接口
+ */
+export interface SharedWorkerConstructor {
+  new (scriptURL: string | URL, options?: string | WorkerOptions): SharedWorker
+}
+
+/**
+ * Shared Worker 接口
+ */
+export interface SharedWorker extends EventTarget {
+  port: MessagePort
+  onerror: ((event: ErrorEvent) => void) | null
+}
+
+/**
+ * Service Worker 构造函数接口
+ */
+export interface ServiceWorkerConstructor {
+  new (): ServiceWorker
+}
+
+/**
+ * Message Channel 构造函数接口
+ */
+export interface MessageChannelConstructor {
+  new (): MessageChannel
+}
+
+/**
+ * Message Channel 接口
+ */
+export interface MessageChannel {
+  port1: MessagePort
+  port2: MessagePort
+}
+
+/**
+ * Broadcast Channel 构造函数接口
+ */
+export interface BroadcastChannelConstructor {
+  new (name: string): BroadcastChannel
+}
+
+/**
+ * Broadcast Channel 接口
+ */
+export interface BroadcastChannel extends EventTarget {
+  name: string
+  postMessage(message: any): void
+  close(): void
+  onmessage: ((event: MessageEvent) => void) | null
+  onmessageerror: ((event: MessageEvent) => void) | null
+}

package/references/xml.d.ts

@@ -0,0 +1,56 @@
+/**
+ * XML 解析器和序列化器类型定义
+ * 用于支持不同环境下的 XML 处理功能
+ */
+
+/**
+ * XML 解析器接口
+ */
+export interface XMLParser {
+  parseFromString(xmlString: string, mimeType: string): XMLDocument
+}
+
+/**
+ * XML 序列化器接口
+ */
+export interface XMLSerializer {
+  serializeToString(node: Node): string
+}
+
+/**
+ * XML 文档接口
+ */
+export interface XMLDocument {
+  documentElement: XMLElement
+  getElementsByTagName(tagName: string): XMLNodeList
+  createElement(tagName: string): XMLElement
+}
+
+/**
+ * XML 元素接口
+ */
+export interface XMLElement {
+  tagName: string
+  getAttribute(name: string): string | null
+  setAttribute(name: string, value: string): void
+  getElementsByTagName(tagName: string): XMLNodeList
+  appendChild(child: XMLElement): XMLElement
+  textContent: string | null
+}
+
+/**
+ * XML 节点列表接口
+ */
+export interface XMLNodeList {
+  length: number
+  item(index: number): XMLElement | null
+  [index: number]: XMLElement
+}
+
+/**
+ * XML 环境依赖接口
+ */
+export interface XMLEnvironment {
+  xmlParser: XMLParser
+  xmlSerializer: XMLSerializer
+}

package/types/altool.d.ts

@@ -0,0 +1,65 @@
+/**
+ * altool相关的类型定义
+ */
+
+/**
+ * altool支持的应用类型
+ */
+export type AltoolAppType = 'ios-app' | 'osx-app' | 'appletvos-app'
+
+/**
+ * altool输出格式
+ */
+export type AltoolOutputFormat = 'xml' | 'normal'
+
+/**
+ * altool认证方式
+ */
+export interface AltoolAuthCredentials {
+  /** Apple ID用户名 */
+  username: string
+  /** 应用专用密码 */
+  password: string
+}
+
+export interface AltoolAuthApiKey {
+  /** API密钥ID */
+  apiKey: string
+  /** API发行者ID */
+  apiIssuer: string
+}
+
+export type AltoolAuth = AltoolAuthCredentials | AltoolAuthApiKey
+
+/**
+ * altool基础选项
+ */
+export interface AltoolBaseOptions {
+  /** 应用类型 */
+  type: AltoolAppType
+  /** 输出格式 */
+  outputFormat?: AltoolOutputFormat
+  /** 认证信息 */
+  auth: AltoolAuth
+}
+
+/**
+ * altool命令类型
+ */
+export type AltoolCommand = 'upload-app' | 'validate-app' | 'list-apps'
+
+/**
+ * altool执行结果基础接口
+ */
+export interface AltoolBaseResult {
+  /** 是否成功 */
+  success: boolean
+  /** 命令输出 */
+  output: string
+  /** 错误信息 */
+  error?: string
+  /** 退出码 */
+  exitCode: number
+  /** 执行的命令 */
+  command: string
+}

package/types/android-build.d.ts

@@ -0,0 +1,85 @@
+import type { NodeChildProcess, NodeFileSystem, NodePath, NodeProcess } from '../../references/node.d'
+import type { XMLParser, XMLSerializer } from '../../references/xml.d'
+import type { JSON5Parser } from '../../references/json5.d'
+
+/**
+ * Android 离线打包选项
+ */
+export interface AndroidBuildOptions {
+  /** UniApp 项目路径 */
+  projectPath: string
+  /** Android 离线 SDK 路径 */
+  sdkPath: string
+  /** 输出目录 */
+  outputDir: string
+  /** DCloud AppKey（必传） */
+  appkey: string
+  /** Android 应用包名（必传） */
+  applicationId: string
+  /** 是否为调试版本 */
+  debug?: boolean
+  /** UniApp 构建脚本名称，如果不指定则直接使用 uni 命令 */
+  buildScript?: string
+  /** Android 示例工程路径 */
+  androidProjectPath: string
+  /** 签名配置（可选） */
+  signing?: {
+    keystore: string
+    keystorePassword: string
+    keyAlias: string
+    keyPassword: string
+  }
+}
+
+/**
+ * Android 打包结果
+ */
+export interface AndroidBuildResult {
+  /** 是否成功 */
+  success: boolean
+  /** 输出文件路径 */
+  outputPath?: string
+  /** 错误信息 */
+  error?: string
+  /** 构建日志 */
+  logs: string[]
+}
+
+/**
+ * 系统依赖接口
+ */
+export interface SystemDependencies {
+  childProcess: NodeChildProcess
+  fs: NodeFileSystem
+  path: NodePath
+  process: NodeProcess
+  setTimeout: (callback: () => void, delay: number) => any
+  require: (id: string) => any
+  json5: JSON5Parser
+  xmlParser: XMLParser
+  xmlSerializer: XMLSerializer
+}
+
+/**
+ * 验证结果接口
+ */
+export interface ValidationResult {
+  valid: boolean
+  error?: string
+}
+
+/**
+ * 操作结果接口
+ */
+export interface OperationResult {
+  success: boolean
+  error?: string
+  logs: string[]
+}
+
+/**
+ * 构建结果接口
+ */
+export interface BuildResult extends OperationResult {
+  outputPath?: string
+}

package/types/color.d.ts

@@ -0,0 +1,115 @@
+/**
+ * 颜色处理相关类型定义
+ */
+
+/**
+ * 支持的颜色格式类型
+ */
+export type ColorFormat = 'hex' | 'rgb' | 'rgba' | 'hsl' | 'hsla' | 'named'
+
+/**
+ * RGB颜色值对象
+ */
+export interface RgbColor {
+  r: number
+  g: number
+  b: number
+}
+
+/**
+ * RGBA颜色值对象
+ */
+export interface RgbaColor extends RgbColor {
+  a: number
+}
+
+/**
+ * HSL颜色值对象
+ */
+export interface HslColor {
+  h: number
+  s: number
+  l: number
+}
+
+/**
+ * HSLA颜色值对象
+ */
+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
+}

package/types/geometry.d.ts

@@ -0,0 +1,64 @@
+/**
+ * 几何和位置计算相关类型定义
+ */
+
+/**
+ * 矩形区域定义
+ */
+export interface Rectangle {
+  x: number
+  y: number
+  width: number
+  height: number
+  top: number
+  left: number
+  right: number
+  bottom: number
+}
+
+/**
+ * 坐标点定义
+ */
+export interface Coordinate {
+  x: number
+  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
+}
+
+// 兼容性别名
+export type Rect = Rectangle
+export type Coords = Coordinate