zcw-shared 1.5.0 → 1.8.0

package/references/worker.d.ts

@@ -1,42 +1,24 @@
 /**
  * Web Worker 环境类型定义
- * 包含浏览器和其他环境的 Worker API 类型支持
+ * 提供核心 Worker API 的类型支持
  */
 
-/**
- * Worker 构造函数选项
- */
-export interface WorkerOptions {
-  type?: 'classic' | 'module'
-  credentials?: 'omit' | 'same-origin' | 'include'
+// 核心类型定义
+export type WorkerType = 'classic' | 'module'
+export type WorkerCredentials = 'omit' | 'same-origin' | 'include'
+export type ServiceWorkerState = 'installing' | 'installed' | 'activating' | 'activated' | 'redundant'
+
+// 配置接口
+export interface WorkerConfig {
+  type?: WorkerType
+  credentials?: WorkerCredentials
   name?: string
 }
 
-/**
- * Transferable 对象接口
- */
-export interface 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
@@ -49,9 +31,7 @@ export interface WorkerLocation {
   origin: string
 }
 
-/**
- * Worker 导航器接口
- */
+// 导航器信息
 export interface WorkerNavigator {
   userAgent: string
   platform: string
@@ -61,21 +41,16 @@ export interface WorkerNavigator {
   hardwareConcurrency: number
 }
 
-/**
- * 消息事件接口
- */
-export interface MessageEvent<T = any> extends Event {
+// 事件接口
+export interface WorkerMessageEvent<T = any> extends Event {
   data: T
   origin: string
   lastEventId: string
-  source: MessageEventSource | null
-  ports: readonly MessagePort[]
+  source: WorkerMessageSource | null
+  ports: readonly WorkerMessagePort[]
 }
 
-/**
- * 错误事件接口
- */
-export interface ErrorEvent extends Event {
+export interface WorkerErrorEvent extends Event {
   message: string
   filename: string
   lineno: number
@@ -83,125 +58,96 @@ export interface ErrorEvent extends Event {
   error: any
 }
 
-/**
- * 消息端口接口
- */
-export interface MessagePort extends EventTarget {
+// 消息通信
+export interface WorkerMessagePort extends EventTarget {
   postMessage(message: any, transfer?: Transferable[]): void
   start(): void
   close(): void
-  onmessage: ((event: MessageEvent) => void) | null
-  onmessageerror: ((event: MessageEvent) => void) | null
+  onmessage: ((event: WorkerMessageEvent) => void) | null
+  onmessageerror: ((event: WorkerMessageEvent) => void) | null
 }
 
-/**
- * 消息事件源类型
- */
-export type MessageEventSource = WindowProxy | MessagePort | ServiceWorker
+export type WorkerMessageSource = WorkerWindowProxy | WorkerMessagePort | WorkerServiceWorker
 
-/**
- * Window 代理接口
- */
-export interface WindowProxy {
-  // 标记接口，用于类型检查
-}
+// 代理和服务
+export interface WorkerWindowProxy {}
 
-/**
- * Service Worker 接口
- */
-export interface ServiceWorker extends EventTarget {
+export interface WorkerServiceWorker 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 WorkerGlobalScope extends EventTarget {
+  self: WorkerGlobalScope
+  location: WorkerLocation
+  navigator: WorkerNavigator
+  importScripts(...urls: string[]): void
+  close(): void
+  postMessage(message: any, transfer?: Transferable[]): void
+  onmessage: ((event: WorkerMessageEvent) => void) | null
+  onmessageerror: ((event: WorkerMessageEvent) => void) | null
+  onerror: ((event: WorkerErrorEvent) => void) | null
 }
 
-/**
- * Worker 接口
- */
-export interface Worker extends EventTarget {
+// Worker 实例
+export interface WorkerInstance 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
+  onmessage: ((event: WorkerMessageEvent) => void) | null
+  onmessageerror: ((event: WorkerMessageEvent) => void) | null
+  onerror: ((event: WorkerErrorEvent) => void) | null
 }
 
-/**
- * Worker 环境接口
- * 包含所有 Worker 相关的环境 API
- */
-export interface WorkerEnvironment {
-  Worker?: WorkerConstructor
-  SharedWorker?: SharedWorkerConstructor
-  ServiceWorker?: ServiceWorkerConstructor
-  MessageChannel?: MessageChannelConstructor
-  BroadcastChannel?: BroadcastChannelConstructor
+// 共享 Worker
+export interface WorkerShared extends EventTarget {
+  port: WorkerMessagePort
+  onerror: ((event: WorkerErrorEvent) => void) | null
 }
 
-/**
- * Shared Worker 构造函数接口
- */
-export interface SharedWorkerConstructor {
-  new (scriptURL: string | URL, options?: string | WorkerOptions): SharedWorker
+// 消息通道
+export interface WorkerMessageChannel {
+  port1: WorkerMessagePort
+  port2: WorkerMessagePort
 }
 
-/**
- * Shared Worker 接口
- */
-export interface SharedWorker extends EventTarget {
-  port: MessagePort
-  onerror: ((event: ErrorEvent) => void) | null
+// 广播通道
+export interface WorkerBroadcastChannel extends EventTarget {
+  name: string
+  postMessage(message: any): void
+  close(): void
+  onmessage: ((event: WorkerMessageEvent) => void) | null
+  onmessageerror: ((event: WorkerMessageEvent) => void) | null
 }
 
-/**
- * Service Worker 构造函数接口
- */
-export interface ServiceWorkerConstructor {
-  new (): ServiceWorker
+// 构造函数类型
+export interface WorkerConstructor {
+  new (scriptURL: string | URL, options?: WorkerConfig): WorkerInstance
 }
 
-/**
- * Message Channel 构造函数接口
- */
-export interface MessageChannelConstructor {
-  new (): MessageChannel
+export interface WorkerSharedConstructor {
+  new (scriptURL: string | URL, options?: string | WorkerConfig): WorkerShared
 }
 
-/**
- * Message Channel 接口
- */
-export interface MessageChannel {
-  port1: MessagePort
-  port2: MessagePort
+export interface WorkerServiceConstructor {
+  new (): WorkerServiceWorker
 }
 
-/**
- * Broadcast Channel 构造函数接口
- */
-export interface BroadcastChannelConstructor {
-  new (name: string): BroadcastChannel
+export interface WorkerMessageChannelConstructor {
+  new (): WorkerMessageChannel
 }
 
-/**
- * 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
+export interface WorkerBroadcastChannelConstructor {
+  new (name: string): WorkerBroadcastChannel
+}
+
+// 运行时接口
+export interface WorkerRuntime {
+  Worker: WorkerConstructor
+  SharedWorker: WorkerSharedConstructor
+  ServiceWorker: WorkerServiceConstructor
+  MessageChannel: WorkerMessageChannelConstructor
+  BroadcastChannel: WorkerBroadcastChannelConstructor
 }

package/references/xml.d.ts

@@ -1,56 +1,88 @@
 /**
- * XML 解析器和序列化器类型定义
- * 用于支持不同环境下的 XML 处理功能
+ * XML 处理类型定义
+ * 提供核心 XML 处理功能的类型支持
  */
 
-/**
- * XML 解析器接口
- */
-export interface XMLParser {
-  parseFromString(xmlString: string, mimeType: string): XMLDocument
-}
-
-/**
- * XML 序列化器接口
- */
-export interface XMLSerializer {
-  serializeToString(node: Node): string
-}
+// 核心类型定义
+export type XMLMimeType = 'text/xml' | 'application/xml' | 'application/xhtml+xml' | 'image/svg+xml'
+export type XMLNodeType = 'element' | 'text' | 'comment' | 'document'
 
-/**
- * XML 文档接口
- */
-export interface XMLDocument {
-  documentElement: XMLElement
-  getElementsByTagName(tagName: string): XMLNodeList
-  createElement(tagName: string): XMLElement
+// 节点接口
+export interface XMLNode {
+  nodeType: XMLNodeType
+  nodeName: string
+  nodeValue: string | null
+  textContent: string | null
+  parentNode: XMLNode | null
+  childNodes: XMLNodeList
 }
 
-/**
- * XML 元素接口
- */
-export interface XMLElement {
+// 元素接口
+export interface XMLElement extends XMLNode {
   tagName: string
+  attributes: XMLAttributeMap
   getAttribute(name: string): string | null
   setAttribute(name: string, value: string): void
+  removeAttribute(name: string): void
+  hasAttribute(name: string): boolean
   getElementsByTagName(tagName: string): XMLNodeList
-  appendChild(child: XMLElement): XMLElement
-  textContent: string | null
+  appendChild(child: XMLNode): XMLNode
+  removeChild(child: XMLNode): XMLNode
 }
 
-/**
- * XML 节点列表接口
- */
+// 属性映射
+export interface XMLAttributeMap {
+  length: number
+  getNamedItem(name: string): XMLAttribute | null
+  setNamedItem(attr: XMLAttribute): XMLAttribute | null
+  removeNamedItem(name: string): XMLAttribute
+  item(index: number): XMLAttribute | null
+  [index: number]: XMLAttribute
+}
+
+// 属性接口
+export interface XMLAttribute {
+  name: string
+  value: string
+  ownerElement: XMLElement | null
+}
+
+// 节点列表
 export interface XMLNodeList {
   length: number
-  item(index: number): XMLElement | null
-  [index: number]: XMLElement
+  item(index: number): XMLNode | null
+  [index: number]: XMLNode
 }
 
-/**
- * XML 环境依赖接口
- */
-export interface XMLEnvironment {
-  xmlParser: XMLParser
-  xmlSerializer: XMLSerializer
+// 文档接口
+export interface XMLDocument extends XMLNode {
+  documentElement: XMLElement | null
+  createElement(tagName: string): XMLElement
+  createTextNode(data: string): XMLNode
+  createComment(data: string): XMLNode
+  getElementsByTagName(tagName: string): XMLNodeList
+  getElementById(id: string): XMLElement | null
+}
+
+// 解析器和序列化器
+export interface XMLParser {
+  parseFromString(xmlString: string, mimeType?: string): any
+}
+
+export interface XMLSerializer {
+  serializeToString(node: any): string
+}
+
+export interface XMLParserConstructor {
+  new (options?: any): XMLParser
+}
+
+export interface XMLSerializerConstructor {
+  new (): XMLSerializer
+}
+
+// 运行时接口
+export interface XMLRuntime {
+  DOMParser: XMLParserConstructor
+  XMLSerializer: XMLSerializerConstructor
 }

package/types/altool.d.ts

@@ -31,23 +31,6 @@ export interface AltoolAuthApiKey {
 
 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执行结果基础接口
  */
@@ -62,4 +45,53 @@ export interface AltoolBaseResult {
   exitCode: number
   /** 执行的命令 */
   command: string
+}
+
+/**
+ * altool上传选项
+ */
+export interface AltoolUploadOptions {
+  file: string
+  type: AltoolAppType
+  auth: AltoolAuth
+  outputFormat?: AltoolOutputFormat
+}
+
+/**
+ * altool验证选项
+ */
+export interface AltoolValidateOptions {
+  file: string
+  type: AltoolAppType
+  auth: AltoolAuth
+  outputFormat?: AltoolOutputFormat
+}
+
+/**
+ * altool验证结果
+ */
+export interface AltoolValidateResult {
+  hasWarnings: boolean
+  hasErrors: boolean
+  warnings: string[]
+  errors: string[]
+}
+
+/**
+ * altool应用信息选项
+ */
+export interface AltoolAppInfoOptions {
+  type: AltoolAppType
+  auth: AltoolAuth
+  outputFormat?: AltoolOutputFormat
+}
+
+/**
+ * 应用信息
+ */
+export interface AppInfo {
+  bundleId: string
+  name: string
+  version: string
+  build: string
 }

package/types/android-build.d.ts

@@ -1,30 +1,32 @@
-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 离线打包相关类型定义
+ * 
+ * @description
+ * 定义通用 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'
 
 /**
- * Android 离线打包选项
+ * 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
-  /** 签名配置（可选） */
+  /** 输出路径 */
+  outputPath?: string
+  /** 是否清理构建 */
+  clean?: boolean
+  /** 构建变体 */
+  buildVariant?: 'debug' | 'release'
+  /** 签名配置 */
   signing?: {
-    keystore: string
+    keystorePath: string
     keystorePassword: string
     keyAlias: string
     keyPassword: string
@@ -32,54 +34,27 @@ export interface AndroidBuildOptions {
 }
 
 /**
- * Android 打包结果
+ * Android 工程编译结果（通用）
  */
 export interface AndroidBuildResult {
-  /** 是否成功 */
   success: boolean
-  /** 输出文件路径 */
   outputPath?: string
-  /** 错误信息 */
   error?: string
-  /** 构建日志 */
   logs: string[]
 }
 
 /**
  * 系统依赖接口
+ * 用于依赖注入，确保函数的环境无关性
  */
 export interface SystemDependencies {
-  childProcess: NodeChildProcess
-  fs: NodeFileSystem
-  path: NodePath
-  process: NodeProcess
+  childProcess: ChildProcess
+  fs: FileSystem
+  path: Path
+  process: Process
   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[]
+  xmlParser: XMLParserConstructor
+  xmlSerializer: XMLSerializerConstructor
 }
-
-/**
- * 构建结果接口
- */
-export interface BuildResult extends OperationResult {
-  outputPath?: string
-}