zcw-shared 1.5.0 → 1.7.0

package/types/android-build.d.ts

@@ -1,85 +1,60 @@
-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
-}
+/**
+ * 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 工程编译选项（通用）
+ */
+export interface AndroidBuildOptions {
+  /** 工程路径 */
+  projectPath: string
+  /** 输出路径 */
+  outputPath?: string
+  /** 是否清理构建 */
+  clean?: boolean
+  /** 构建变体 */
+  buildVariant?: 'debug' | 'release'
+  /** 签名配置 */
+  signing?: {
+    keystorePath: string
+    keystorePassword: string
+    keyAlias: string
+    keyPassword: string
+  }
+}
+
+/**
+ * Android 工程编译结果（通用）
+ */
+export interface AndroidBuildResult {
+  success: boolean
+  outputPath?: string
+  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
+}

package/types/color.d.ts

@@ -1,163 +1,73 @@
-/**
- * 颜色处理相关类型定义
- */
-
-/**
- * 支持的颜色格式类型
- */
-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
-}
-
-/**
- * 颜色引用信息
- * 用于记录在代码中发现的颜色值及其位置信息
- */
-export interface ColorReference {
-  /** 原始颜色值 */
-  originalValue: string
-  /** 颜色格式 */
-  format: ColorFormat | 'css-variable' | 'third-party-variable'
-  /** 文件路径 */
-  file: string
-  /** 行号 */
-  line: number
-  /** 上下文代码 */
-  context: string
-  /** 是否为变量引用 */
-  isVariableReference?: boolean
-  /** 变量名称（如果是变量引用） */
-  variableName?: string
-}
-
-/**
- * 颜色提取器依赖注入接口
- * 定义颜色提取功能所需的外部依赖
- */
-export interface ColorExtractorDependencies {
-  /** 获取颜色模式匹配正则表达式 */
-  getColorPatterns: () => ColorPatterns
-  /** 标准化颜色值为8位十六进制格式 */
-  standardizeColor: (color: string) => string
-  /** 检测颜色格式 */
-  detectColorFormat: (color: string) => ColorFormat | null
-  /** 验证是否为有效颜色值 */
-  isColorValue: (value: string) => { isValid: boolean; format?: ColorFormat }
-}
-
-/**
- * 颜色提取选项
- */
-export interface ColorExtractionOptions {
-  /** 是否只提取有效的颜色值 */
-  validOnly?: boolean
-  /** CSS变量映射 */
-  cssVariables?: Record<string, string>
-  /** 第三方变量映射 */
-  thirdPartyVariables?: Record<string, string>
+/**
+ * 颜色处理相关类型定义
+ */
+
+/**
+ * 支持的颜色格式类型
+ */
+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 ColorReference {
+  /** 原始颜色值 */
+  originalValue: string
+  /** 颜色格式 */
+  format: ColorFormat | 'css-variable' | 'third-party-variable'
+  /** 文件路径 */
+  file: string
+  /** 行号 */
+  line: number
+  /** 上下文代码 */
+  context: string
+  /** 是否为变量引用 */
+  isVariableReference?: boolean
+  /** 变量名称（如果是变量引用） */
+  variableName?: string
+}
+
+/**
+ * 颜色提取选项
+ */
+export interface ColorExtractionOptions {
+  /** 是否只提取有效的颜色值 */
+  validOnly?: boolean
+  /** CSS变量映射 */
+  cssVariables?: Record<string, string>
+  /** 第三方变量映射 */
+  thirdPartyVariables?: Record<string, string>
 }

package/types/geometry.d.ts

@@ -1,66 +1,29 @@
-/**
- * 几何和位置计算相关类型定义
- */
-
-/**
- * 矩形区域定义
- */
-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 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
+}
+
+// 类型别名 - 这些被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

@@ -1,27 +1,15 @@
-/**
- * 软件配置接口定义
- */
-export interface SoftwareConfig {
-  /** 可执行文件名 */
-  executable: string
-  /** 可能的安装路径列表 */
-  possiblePaths: string[]
-  /** 用户自定义路径（可选） */
-  userPaths?: string[]
-  /** Windows注册表键（可选） */
-  registryKey?: string
-  /** 环境变量名 */
-  envVar: string
-}
-
-/**
- * 平台类型
- */
-export type Platform = 'win32' | 'darwin' | 'linux'
-
-/**
- * Process对象接口
- */
-export interface ProcessLike {
-  platform: string
+/**
+ * 软件配置接口定义
+ */
+export interface SoftwareConfig {
+  /** 可执行文件名 */
+  executable: string
+  /** 可能的安装路径列表 */
+  possiblePaths: string[]
+  /** 用户自定义路径（可选） */
+  userPaths?: string[]
+  /** Windows注册表键（可选） */
+  registryKey?: string
+  /** 环境变量名 */
+  envVar: string
 }

package/types/storage.d.ts

@@ -1,49 +1,51 @@
-/**
- * 存储相关的应用层类型定义
- * 
- * @description
- * 定义存储hooks使用的接口和类型，不包含环境相关的类型
- * 环境相关的类型请从 references/storage.d 导入
- * 
- * @since 1.0.0
- * @author Assistant
- */
-
-// 存储操作结果
-export interface StorageResult<T> {
-  success: boolean
-  data?: T
-  error?: string
-}
-
-// 存储配置选项
-export interface StorageOptions {
-  prefix?: string // 键名前缀
-  serializer?: {
-    serialize: (value: any) => string
-    deserialize: (value: string) => any
-  }
-}
-
-// IndexedDB 存储配置
-export interface IndexedDBStorageOptions extends StorageOptions {
-  dbName: string // 数据库名称
-  storeName: string // 对象存储名称
-  version?: number // 数据库版本
-}
-
-// 存储 Hook 返回值接口
-export interface UseStorageReturn<T> {
-  value: T | null
-  setValue: (value: T | null) => Promise<void>
-  removeValue: () => Promise<void>
-  clear: () => Promise<void>
-}
-
-// 存储适配器接口
-export interface StorageAdapter<T> {
-  get: (key: string) => Promise<T | null>
-  set: (key: string, value: T) => Promise<void>
-  remove: (key: string) => Promise<void>
-  clear: () => Promise<void>
+/**
+ * 存储相关的应用层类型定义
+ * 
+ * @description
+ * 定义存储hooks使用的接口和类型，不包含环境相关的类型
+ * 环境相关的类型请从 references/storage.d 导入
+ * 
+ * @since 1.0.0
+ * @author Assistant
+ */
+
+// 存储操作结果
+export interface StorageResult<T> {
+  success: boolean
+  data?: T
+  error?: string
+}
+
+// 存储配置选项
+export interface StorageOptions {
+  prefix?: string // 键名前缀
+  serializer?: {
+    serialize: (value: any) => string
+    deserialize: (value: string) => any
+  }
+}
+
+// IndexedDB 存储配置
+export interface IndexedDBStorageOptions extends StorageOptions {
+  dbName: string // 数据库名称
+  storeName: string // 对象存储名称
+  version?: number // 数据库版本
+}
+
+// 存储 Hook 返回值接口
+export interface UseStorageReturn<T> {
+  get value(): T | null
+  setValue: (value: T | null) => Promise<void>
+  removeValue: () => Promise<void>
+  clear: () => Promise<void>
+}
+
+// 存储适配器接口
+export interface StorageAdapter<T> {
+  get: (key: string) => Promise<T | null>
+  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 特有的结果属性
+}
+
+/**
+ * 系统依赖接口
+ * 用于依赖注入，确保函数的环境无关性
+ */
+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
+}