zcw-shared 1.7.0 → 1.9.0

package/references/xml.d.ts

@@ -1,89 +1,88 @@
-/**
- * XML 处理类型定义
- * 提供核心 XML 处理功能的类型支持
- */
-
-// 核心类型定义
-export type XMLMimeType = 'text/xml' | 'application/xml' | 'application/xhtml+xml' | 'image/svg+xml'
-export type XMLNodeType = 'element' | 'text' | 'comment' | 'document'
-
-// 节点接口
-export interface XMLNode {
-  nodeType: XMLNodeType
-  nodeName: string
-  nodeValue: string | null
-  textContent: string | null
-  parentNode: XMLNode | null
-  childNodes: XMLNodeList
-}
-
-// 元素接口
-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: XMLNode): XMLNode
-  removeChild(child: XMLNode): XMLNode
-}
-
-// 属性映射
-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): XMLNode | null
-  [index: number]: XMLNode
-}
-
-// 文档接口
-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: XMLMimeType): XMLDocument
-}
-
-export interface XMLSerializer {
-  serializeToString(node: XMLNode): string
-}
-
-// 构造函数类型
-export interface XMLParserConstructor {
-  new (): XMLParser
-}
-
-export interface XMLSerializerConstructor {
-  new (): XMLSerializer
-}
-
-// 运行时接口
-export interface XMLRuntime {
-  DOMParser: XMLParserConstructor
-  XMLSerializer: XMLSerializerConstructor
+/**
+ * XML 处理类型定义
+ * 提供核心 XML 处理功能的类型支持
+ */
+
+// 核心类型定义
+export type XMLMimeType = 'text/xml' | 'application/xml' | 'application/xhtml+xml' | 'image/svg+xml'
+export type XMLNodeType = 'element' | 'text' | 'comment' | 'document'
+
+// 节点接口
+export interface XMLNode {
+  nodeType: XMLNodeType
+  nodeName: string
+  nodeValue: string | null
+  textContent: string | null
+  parentNode: XMLNode | null
+  childNodes: XMLNodeList
+}
+
+// 元素接口
+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: XMLNode): XMLNode
+  removeChild(child: XMLNode): XMLNode
+}
+
+// 属性映射
+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): XMLNode | null
+  [index: number]: XMLNode
+}
+
+// 文档接口
+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/android-build.d.ts

@@ -1,60 +1,60 @@
-/**
- * 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
-}
+/**
+ * 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,73 +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 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>
+/**
+ * 颜色处理相关类型定义
+ */
+
+/**
+ * 支持的颜色格式类型
+ */
+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,29 +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
-}
-
-// 类型别名 - 这些被DOM函数使用
-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

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

package/types/software.d.ts

@@ -1,15 +1,15 @@
-/**
- * 软件配置接口定义
- */
-export interface SoftwareConfig {
-  /** 可执行文件名 */
-  executable: string
-  /** 可能的安装路径列表 */
-  possiblePaths: string[]
-  /** 用户自定义路径（可选） */
-  userPaths?: string[]
-  /** Windows注册表键（可选） */
-  registryKey?: string
-  /** 环境变量名 */
-  envVar: string
+/**
+ * 软件配置接口定义
+ */
+export interface SoftwareConfig {
+  /** 可执行文件名 */
+  executable: string
+  /** 可能的安装路径列表 */
+  possiblePaths: string[]
+  /** 用户自定义路径（可选） */
+  userPaths?: string[]
+  /** Windows注册表键（可选） */
+  registryKey?: string
+  /** 环境变量名 */
+  envVar: string
 }

package/types/storage.d.ts

@@ -1,51 +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> {
-  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[]>
+/**
+ * 存储相关的应用层类型定义
+ * 
+ * @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[]>
 }