zcw-shared 1.4.0 → 1.5.0

package/README.md

@@ -4,17 +4,43 @@
 
 **重要说明**: 本库是环境无关的纯TypeScript库，所有函数必须保持环境无关性，仅通过TypeScript引用声明环境依赖。
 
-**例外说明**: `scripts/` 目录下的文件为构建脚本，不会被打包到最终产物中，因此可以直接导入Node.js环境模块，不需要遵循环境无关性规则。playground是一个子项目，有自己的规则，你完全忽略此文件夹。
+**例外说明**: 
+- `scripts/` 目录下的文件为构建脚本，不会被打包到最终产物中，因此可以直接导入Node.js环境模块，不需要遵循环境无关性规则。
+- `playground/` 目录是功能验证环境，用于测试和验证shared包中的函数功能，有独立的配置和依赖管理，不受shared包的环境无关性规则约束。
+
+## 核心原则摘要
+
+### 🎯 设计原则
+- **环境无关性**: 所有代码必须与运行环境无关，通过依赖注入获取环境实例
+- **纯函数**: Functions 目录中的所有函数必须是纯函数，无副作用
+- **类型安全**: 使用 TypeScript 严格模式，避免 any 类型
+- **单一职责**: 每个文件只包含一个函数或一组相关常量
+
+### 📁 文件组织
+- **Functions**: 一个文件一个函数，使用具名导出，禁止 index.ts
+- **Types**: 通用类型定义，支持环境类型引用
+- **Constants**: 按模块组织常量，使用具名导出
+- **Playground**: 功能验证环境，不受 shared 包规则约束
+
+### 🔧 技术要求
+- **导出方式**: 强制使用具名导出，禁止默认导出
+- **类型引用**: 环境类型通过 TypeScript 引用声明，实例通过参数传入
+- **错误处理**: 统一的错误处理机制，明确的错误类型
+- **文档**: 完整的 JSDoc 注释，清晰的参数和返回值说明
+
+---
 
 ## 目录结构
 
 ```
 src/
-├── functions/          # 纯函数，按功能分类组织
-├── hooks/             # Vue/React hooks
-references/            # 仅供TypeScript引用的环境类型定义
-types/                 # 可导出的公共类型定义
-scripts/               # 构建脚本（不会被打包，可直接使用Node.js模块）
+├── constants/         # 常量定义，包括配置项、正则表达式、映射表等
+├── functions/         # 纯函数，按功能分类组织
+├── hooks/            # Vue/React hooks
+references/           # 环境相关和第三方库的TypeScript类型定义
+types/                # 可导出的公共类型定义
+scripts/              # 构建脚本（不会被打包，可直接使用Node.js模块）
+playground/           # 功能验证环境（用于测试shared包功能，有独立配置）
 ```
 
 ## TypeScript 类型声明规范
@@ -260,6 +286,87 @@ export interface Sharp {
 - 所有图像处理函数都应该接收 `sharp: Sharp` 参数
 - 确保 Sharp 相关接口正确导出
 
+
+
+## 函数设计原则
+
+### 5. 函数设计核心原则
+
+#### 5.1 环境无关性与依赖注入
+- 所有环境依赖都必须通过参数传入，确保函数保持环境无关性
+- 函数不能直接导入任何环境模块（如 fs、path、sharp 等）
+- 仅通过 TypeScript 引用声明环境类型，实例通过参数传入
+- 函数可在任意环境中运行，更容易测试、维护和跨环境复用
+
+#### 5.2 纯函数要求
+- `functions/` 目录下的函数必须是环境无关的纯函数
+- 函数不能直接访问任何环境变量或全局对象
+- 相同的输入必须产生相同的输出，不能有副作用
+- 按功能模块组织函数（如 dom/、image/、debug/ 等）
+
+#### 5.3 类型安全
+- 所有函数参数都应该有明确的类型声明
+- 使用 TypeScript 的严格模式
+- 避免使用 `any` 类型，优先使用具体的类型定义
+
+#### 5.4 避免过度抽象
+- **函数复杂度要求**: 每个导出的函数都应该有足够的复杂度和独立的使用价值
+- **避免简单包装**: 不要为只有几行代码的简单操作创建独立函数
+- **内联简单逻辑**: 过于简单的逻辑应该内联到使用它们的地方，而不是单独抽取
+- **减少文件数量**: 避免创建大量功能单一的小文件，影响项目的可维护性
+
+**✅ 合理的函数抽象**:
+```typescript
+// 复杂的业务逻辑，值得单独抽取
+export function parseVueFile(content: string): VueFileStructure {
+  // 包含复杂的解析逻辑，正则匹配，错误处理等
+  // 50+ 行代码的复杂实现
+}
+
+// 组合多个相关功能的函数
+export function checkVueType(content: unknown): VueTypeCheckResult {
+  // 内联简单的类型检查逻辑
+  const isComponent = (
+    typeof content === 'object' &&
+    content !== null &&
+    ('render' in content || 'setup' in content || 'template' in content)
+  )
+  
+  const isVNode = (
+    typeof content === 'object' && content !== null && '__v_isVNode' in content
+  )
+  
+  return { isComponent, isVNode, type: isComponent ? 'component' : isVNode ? 'vnode' : 'unknown' }
+}
+```
+
+**❌ 过度抽象的反例**:
+```typescript
+// 过于简单，不值得单独抽取
+export function isVNode(content: unknown): boolean {
+  return typeof content === 'object' && content !== null && '__v_isVNode' in content
+}
+
+// 只有简单的数组操作，应该内联
+export function saveVueSection(sections: VueSection[], section: VueSection): void {
+  if (section.type && section.content.length > 0) {
+    sections.push(section)
+  }
+}
+```
+
+#### 5.5 函数独立价值原则
+- **独立使用价值**: 每个函数都应该能够独立使用，解决特定的业务问题
+- **避免仅内部使用**: 如果函数只被一个地方使用，考虑是否应该内联
+- **功能完整性**: 函数应该提供完整的功能，而不是功能片段
+- **复用性考虑**: 优先考虑函数的复用性和通用性
+
+#### 5.6 重构指导原则
+- **合并相关功能**: 将相关的简单函数合并到一个更完整的函数中
+- **内联简单逻辑**: 将过于简单的函数逻辑内联到调用方
+- **保持核心功能**: 重构时保持原有功能不变，只优化代码结构
+- **减少依赖关系**: 减少函数之间不必要的依赖关系
+
 ## Functions 目录规范
 
 本目录包含项目中使用的纯函数，所有函数必须遵循以下规范：
@@ -276,7 +383,7 @@ export interface Sharp {
 - 按照**模块进行划分文件夹**
 - 每个文件中**只能包含一个函数**
 - 文件名应该与函数名保持一致
-- 使用 `export` 导出函数（推荐使用具名导出）
+- 使用 `export` 导出函数（强制要求使用具名导出）
 - **❌ 严禁创建 index.ts 入口文件**：每个函数文件都需要单独打包，不允许使用统一入口文件
 - **❌ 子模块不要创建 README 文件**：避免文档冗余，统一在根目录的 README 中说明规范
 
@@ -288,21 +395,14 @@ export interface Sharp {
 ### Functions 代码规范
 
 #### 1. 导出方式
-推荐使用具名导出：
+**强制要求使用具名导出**：
 ```typescript
 export function functionName(params: Type): ReturnType {
   // 函数实现
 }
 ```
 
-也可以使用默认导出：
-```typescript
-const functionName = (params: Type): ReturnType => {
-  // 函数实现
-}
-
-export default functionName
-```
+**说明**: 为保持项目一致性和支持单独打包，所有函数必须使用具名导出。禁止使用默认导出。
 
 #### 2. 类型定义
 - **函数专用类型**：如果类型只被当前函数使用，应该在同一个文件中定义
@@ -365,6 +465,12 @@ export function dependsOnGlobalState(): number {
 export function firstFunction(): void {}
 export function secondFunction(): void {}
 
+// ❌ 使用默认导出
+const functionName = (params: Type): ReturnType => {
+  // 函数实现
+}
+export default functionName // 禁止使用默认导出
+
 // ❌ 创建 index.ts 入口文件
 // functions/module/index.ts
 export { functionA } from './functionA'
@@ -376,32 +482,9 @@ export { functionB } from './functionB'
 // 子模块不需要单独的 README 文件，会造成文档冗余
 ```
 
-## 函数设计原则
-
-### 1. 依赖注入与环境无关性
-
-- 所有环境依赖都必须通过参数传入，确保函数保持环境无关性
-- 函数不能直接导入任何环境模块（如 fs、path、sharp 等）
-- 仅通过 TypeScript 引用声明环境类型，实例通过参数传入
-- 函数实现完全依赖传入的参数，保持环境无关
-
-### 2. 类型安全
-
-- 所有函数参数都应该有明确的类型声明
-- 使用 TypeScript 的严格模式
-- 避免使用 `any` 类型，优先使用具体的类型定义
-
-### 3. 纯函数与环境无关性
-
-- `functions/` 目录下的函数必须是环境无关的纯函数
-- 函数不能直接访问任何环境变量或全局对象
-- 所有环境依赖通过参数传入，确保函数可在任意环境中运行
-- 按功能模块组织函数（如 dom/、image/、debug/ 等）
-- 环境无关的纯函数更容易测试、维护和跨环境复用
-
-### 4. 错误处理规范
+### 6. 错误处理规范
 
-#### 4.1 错误信息格式
+#### 6.1 错误信息格式
 
 - **中文错误信息**: 面向用户的错误信息使用中文，提供清晰的错误描述
 - **状态码包含**: 网络请求相关错误应包含具体的状态码信息
@@ -431,21 +514,21 @@ throw new Error('error');
 reject(new Error('Download failed'));
 ```
 
-#### 4.2 错误处理一致性
+#### 6.2 错误处理一致性
 
 - **Promise 错误**: 异步函数使用 `reject(new Error(...))` 抛出错误
 - **同步错误**: 同步函数使用 `throw new Error(...)` 抛出错误
 - **错误类型**: 统一使用 `Error` 类型，避免抛出字符串或其他类型
 - **错误传递**: 适当时保留原始错误信息，避免错误信息丢失
 
-### 5. JSDoc 文档规范
+### 7. JSDoc 文档规范
 
 - **强制要求**: 每个导出的函数都必须包含完整的 JSDoc 注释
 - **禁止生成**: 不要为函数模块生成单独的 README.md 文件
 - **文档内容**: JSDoc 必须包含函数描述、参数说明、返回值说明和使用示例
 - **类型信息**: 充分利用 TypeScript 类型系统，JSDoc 中重点描述业务逻辑
 
-#### 5.1 JSDoc 格式要求
+#### 7.1 JSDoc 格式要求
 
 ```typescript
 // 正确的类型导入方式
@@ -471,7 +554,7 @@ export async function myFunction(
 
 ## 文件引用规范
 
-### 6. 导入限制
+### 8. 导入限制
 
 **✅ 允许的导入**:
 - 本包内的类型和函数（使用相对路径）
@@ -525,7 +608,7 @@ export function processFile(
 }
 ```
 
-### 6.1 相对路径
+### 8.1 相对路径
 
 - 使用相对路径引用类型定义文件
 - 保持路径的一致性和可维护性
@@ -590,21 +673,111 @@ export function processFile(
 
 ## 代码组织和文档要求
 
-### 7. 函数组织原则
+### 9. 函数组织原则
 
 - 按功能模块组织函数到不同的目录（如 dom/、image/、debug/ 等）
 - 每个函数文件专注于单一功能领域
 - 保持函数的单一职责原则
 - 优先考虑函数的复用性和可测试性
 
-### 7.1 文档要求
+### 9.1 文档要求
 
 - **JSDoc 优先**: 每个函数必须有完整的 JSDoc 注释，不生成单独的 README 文件
 - **类型安全**: 充分利用 TypeScript 类型系统提供类型信息
 - **文档完整性**: JSDoc 必须包含函数描述、参数说明和返回值说明
 
-### 7.2 代码质量要求
+### 9.2 代码质量要求
 
 - 遵循 TypeScript 严格模式
 - 函数复杂度控制在合理范围内
-- 保持函数职责单一，易于测试和维护
+- 保持函数职责单一，易于测试和维护
+
+## 模块组织规范
+
+### 10. Constants 目录规范
+
+`src/constants/` 目录用于存放项目中的常量定义，包括配置项、正则表达式、映射表等。
+
+#### 10.1 常量组织原则
+
+- **功能分类**: 按功能模块组织常量文件
+- **命名规范**: 使用大写字母和下划线命名常量
+- **类型安全**: 为常量提供明确的类型定义
+- **导出方式**: 使用具名导出，避免默认导出
+- **环境无关**: 常量定义必须保持环境无关性
+- **不可变性**: 使用 `as const` 断言确保常量的不可变性
+
+#### 10.2 文件命名规范
+
+- **描述性命名**: 文件名应清晰描述常量的用途
+- **驼峰命名**: 使用 camelCase 命名文件
+- **功能前缀**: 可使用功能模块作为文件名前缀
+- **避免缩写**: 使用完整的单词而非缩写
+
+#### 10.3 常量定义规范
+
+- **类型导入**: 统一从 types 目录导入相关类型定义
+- **JSDoc注释**: 为每个常量提供清晰的文档说明
+- **分组组织**: 相关常量应分组定义，使用注释分隔
+- **默认导出禁止**: 禁止使用默认导出，必须使用具名导出
+- **禁止入口文件**: 不允许创建 `index.ts` 等入口文件
+
+#### 10.4 使用规范
+
+- **集中管理**: 避免在函数文件中定义常量，统一在 constants 目录管理
+- **按需导入**: 从 constants 文件中按需导入所需常量
+- **类型一致**: 确保常量类型与使用场景的类型定义一致
+- **文档引用**: 在函数的 JSDoc 中适当引用相关常量的说明
+
+## 开发工作流程
+
+### 11. 快速开始指南
+
+#### 11.1 新功能开发流程
+
+1. **创建函数文件**: 在 `src/functions/` 对应模块目录下创建新的函数文件
+2. **定义类型**: 如需要，在 `types/` 目录下定义或导入相关类型
+3. **实现函数**: 遵循环境无关性原则，通过参数注入依赖
+4. **编写文档**: 添加完整的 JSDoc 注释
+5. **验证功能**: 在 `playground/` 中创建验证用例
+6. **代码检查**: 确保符合所有编码规范
+
+#### 11.2 常见开发场景
+
+**添加新的常量**:
+```typescript
+// src/constants/moduleConstants.ts
+export const MODULE_CONFIG = {
+  DEFAULT_TIMEOUT: 5000,
+  MAX_RETRIES: 3
+} as const
+```
+
+**创建环境无关函数**:
+```typescript
+// src/functions/module/processData.ts
+import type { NodeFileSystem } from '../../../references/node.d'
+
+/**
+ * 处理数据文件
+ * @param filePath - 文件路径
+ * @param fs - 文件系统依赖
+ * @returns 处理结果
+ */
+export function processData(
+  filePath: string,
+  fs: NodeFileSystem
+): Promise<string> {
+  // 实现逻辑
+}
+```
+
+#### 11.3 代码质量检查
+
+开发完成后，请确保：
+- [ ] 函数保持环境无关性
+- [ ] 类型定义完整且正确
+- [ ] JSDoc 文档完整
+- [ ] 遵循命名规范
+- [ ] 通过 playground 验证
+- [ ] 符合项目架构原则

package/dist/constants/colorPatterns.d.ts

@@ -0,0 +1,2 @@
+import type { ColorPatterns } from '../../types/color.d';
+export declare const COLOR_PATTERNS: ColorPatterns;

package/dist/constants/colorPatterns.js

@@ -0,0 +1,9 @@
+export const COLOR_PATTERNS = {
+    hex: /^#([0-9a-fA-F]{3}|[0-9a-fA-F]{4}|[0-9a-fA-F]{6}|[0-9a-fA-F]{8})$/,
+    rgb: /^rgb\(\s*(\d+)\s*,\s*(\d+)\s*,\s*(\d+)\s*\)$/,
+    rgba: /^rgba\(\s*(\d+)\s*,\s*(\d+)\s*,\s*(\d+)\s*,\s*([\d.]+)\s*\)$/,
+    hsl: /^hsl\(\s*(\d+)\s*,\s*(\d+)%\s*,\s*(\d+)%\s*\)$/,
+    hsla: /^hsla\(\s*(\d+)\s*,\s*(\d+)%\s*,\s*(\d+)%\s*,\s*([\d.]+)\s*\)$/,
+    namedColors: /^(red|green|blue|yellow|orange|purple|pink|brown|black|white|gray|grey|cyan|magenta)$/i
+};
+//# sourceMappingURL=colorPatterns.js.map

package/dist/constants/colorPatterns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"colorPatterns.js","sourceRoot":"","sources":["../../src/constants/colorPatterns.ts"],"names":[],"mappings":"AA6BA,MAAM,CAAC,MAAM,cAAc,GAAkB;IAE3C,GAAG,EAAE,kEAAkE;IAGvE,GAAG,EAAE,8CAA8C;IAGnD,IAAI,EAAE,8DAA8D;IAGpE,GAAG,EAAE,gDAAgD;IAGrD,IAAI,EAAE,gEAAgE;IAGtE,WAAW,EAAE,wFAAwF;CACtG,CAAA"}

package/dist/constants/namedColors.d.ts

@@ -0,0 +1,2 @@
+import type { NamedColorMap } from '../../types/color.d';
+export declare const NAMED_COLOR_MAP: NamedColorMap;

package/dist/constants/namedColors.js

@@ -0,0 +1,17 @@
+export const NAMED_COLOR_MAP = {
+    'red': '#ff0000',
+    'green': '#00ff00',
+    'blue': '#0000ff',
+    'yellow': '#ffff00',
+    'orange': '#ffa500',
+    'purple': '#800080',
+    'pink': '#ffc0cb',
+    'brown': '#a52a2a',
+    'black': '#000000',
+    'white': '#ffffff',
+    'gray': '#808080',
+    'grey': '#808080',
+    'cyan': '#00ffff',
+    'magenta': '#ff00ff'
+};
+//# sourceMappingURL=namedColors.js.map

package/dist/constants/namedColors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"namedColors.js","sourceRoot":"","sources":["../../src/constants/namedColors.ts"],"names":[],"mappings":"AA6BA,MAAM,CAAC,MAAM,eAAe,GAAkB;IAC5C,KAAK,EAAE,SAAS;IAChB,OAAO,EAAE,SAAS;IAClB,MAAM,EAAE,SAAS;IACjB,QAAQ,EAAE,SAAS;IACnB,QAAQ,EAAE,SAAS;IACnB,QAAQ,EAAE,SAAS;IACnB,MAAM,EAAE,SAAS;IACjB,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,OAAO,EAAE,SAAS;IAClB,MAAM,EAAE,SAAS;IACjB,MAAM,EAAE,SAAS;IACjB,MAAM,EAAE,SAAS;IACjB,SAAS,EAAE,SAAS;CACrB,CAAA"}

package/dist/constants/softwareConfigs.d.ts

@@ -0,0 +1,15 @@
+export interface PlatformSoftwareConfig {
+    executable: string;
+    possiblePaths: string[];
+    userPaths: string[];
+    registryKey?: string;
+}
+export interface SoftwareConfigDefinition {
+    win32: PlatformSoftwareConfig;
+    darwin: PlatformSoftwareConfig;
+    linux: PlatformSoftwareConfig;
+    envVar: string;
+}
+export declare const SOFTWARE_CONFIGS: Record<string, SoftwareConfigDefinition>;
+export declare const SOFTWARE_NAME_MAP: Record<string, string>;
+export declare const SUPPORTED_PLATFORMS: readonly ["darwin", "win32", "linux"];

package/dist/constants/softwareConfigs.js

@@ -0,0 +1,157 @@
+export const SOFTWARE_CONFIGS = {
+    git: {
+        win32: {
+            executable: 'git.exe',
+            possiblePaths: [
+                'C:\\Program Files\\Git\\bin',
+                'C:\\Program Files (x86)\\Git\\bin'
+            ],
+            userPaths: ['AppData\\Local\\Programs\\Git\\bin'],
+            registryKey: 'HKEY_LOCAL_MACHINE\\SOFTWARE\\GitForWindows'
+        },
+        darwin: {
+            executable: 'git',
+            possiblePaths: ['/usr/bin', '/usr/local/bin', '/opt/homebrew/bin'],
+            userPaths: ['~/.local/bin']
+        },
+        linux: {
+            executable: 'git',
+            possiblePaths: ['/usr/bin', '/usr/local/bin'],
+            userPaths: ['~/.local/bin']
+        },
+        envVar: 'GIT_PATH'
+    },
+    chrome: {
+        win32: {
+            executable: 'chrome.exe',
+            possiblePaths: [
+                'C:\\Program Files\\Google\\Chrome\\Application',
+                'C:\\Program Files (x86)\\Google\\Chrome\\Application'
+            ],
+            userPaths: ['AppData\\Local\\Google\\Chrome\\Application'],
+            registryKey: 'HKEY_CURRENT_USER\\Software\\Google\\Chrome'
+        },
+        darwin: {
+            executable: 'Google Chrome',
+            possiblePaths: ['/Applications/Google Chrome.app/Contents/MacOS'],
+            userPaths: ['~/Applications/Google Chrome.app/Contents/MacOS']
+        },
+        linux: {
+            executable: 'google-chrome',
+            possiblePaths: ['/usr/bin', '/usr/local/bin', '/opt/google/chrome'],
+            userPaths: ['~/.local/bin']
+        },
+        envVar: 'CHROME_PATH'
+    },
+    nodejs: {
+        win32: {
+            executable: 'node.exe',
+            possiblePaths: [
+                'C:\\Program Files\\nodejs',
+                'C:\\Program Files (x86)\\nodejs'
+            ],
+            userPaths: ['AppData\\Roaming\\npm'],
+            registryKey: 'HKEY_LOCAL_MACHINE\\SOFTWARE\\Node.js'
+        },
+        darwin: {
+            executable: 'node',
+            possiblePaths: ['/usr/local/bin', '/opt/homebrew/bin', '/usr/bin'],
+            userPaths: ['~/.local/bin']
+        },
+        linux: {
+            executable: 'node',
+            possiblePaths: ['/usr/bin', '/usr/local/bin'],
+            userPaths: ['~/.local/bin']
+        },
+        envVar: 'NODE_PATH'
+    },
+    wechat: {
+        win32: {
+            executable: 'cli.bat',
+            possiblePaths: [
+                'C:\\Program Files (x86)\\Tencent\\微信web开发者工具',
+                'C:\\Program Files\\Tencent\\微信web开发者工具'
+            ],
+            userPaths: [
+                'AppData\\Local\\微信web开发者工具',
+                'AppData\\Roaming\\微信web开发者工具'
+            ],
+            registryKey: 'HKEY_CURRENT_USER\\Software\\Tencent\\微信web开发者工具'
+        },
+        darwin: {
+            executable: 'cli',
+            possiblePaths: [
+                '/Applications/wechatwebdevtools.app/Contents/MacOS',
+                '/Applications/wechatwebdevtools.app/Contents/Resources/app.nw/bin'
+            ],
+            userPaths: [
+                '/Applications/wechatwebdevtools.app/Contents/MacOS',
+                '/Applications/wechatwebdevtools.app/Contents/Resources/app.nw/bin'
+            ]
+        },
+        linux: {
+            executable: 'cli',
+            possiblePaths: ['/usr/local/bin', '/usr/bin'],
+            userPaths: ['.local/bin']
+        },
+        envVar: 'WECHAT_DEV_TOOLS_PATH'
+    },
+    hbuilderx: {
+        win32: {
+            executable: 'HBuilderX.exe',
+            possiblePaths: [
+                'C:\\Program Files\\HBuilderX',
+                'C:\\Program Files (x86)\\HBuilderX'
+            ],
+            userPaths: [
+                'AppData\\Local\\HBuilderX',
+                'AppData\\Roaming\\HBuilderX'
+            ],
+            registryKey: 'HKEY_CURRENT_USER\\Software\\DCloud\\HBuilderX'
+        },
+        darwin: {
+            executable: 'HBuilderX',
+            possiblePaths: ['/Applications/HBuilderX.app/Contents/MacOS'],
+            userPaths: ['~/Applications/HBuilderX.app/Contents/MacOS']
+        },
+        linux: {
+            executable: 'HBuilderX',
+            possiblePaths: ['/opt/HBuilderX', '/usr/local/HBuilderX'],
+            userPaths: ['~/.local/share/HBuilderX', '~/HBuilderX']
+        },
+        envVar: 'HBUILDERX_PATH'
+    },
+    altool: {
+        win32: {
+            executable: 'altool.exe',
+            possiblePaths: [],
+            userPaths: []
+        },
+        darwin: {
+            executable: 'altool',
+            possiblePaths: [
+                '/Applications/Xcode.app/Contents/Applications/Application Loader.app/Contents/Frameworks/ITunesSoftwareService.framework/Versions/A/Support',
+                '/Applications/Xcode.app/Contents/Applications/Application Loader.app/Contents/itms/bin',
+                '/Applications/Xcode.app/Contents/Developer/usr/bin',
+                '/usr/local/bin'
+            ],
+            userPaths: ['~/Applications/Xcode.app/Contents/Developer/usr/bin']
+        },
+        linux: {
+            executable: 'altool',
+            possiblePaths: [],
+            userPaths: []
+        },
+        envVar: 'ALTOOL_PATH'
+    }
+};
+export const SOFTWARE_NAME_MAP = {
+    wechat: 'wechat',
+    chrome: 'chrome',
+    git: 'git',
+    hbuilderx: 'hbuilderx',
+    nodejs: 'nodejs',
+    node: 'nodejs',
+};
+export const SUPPORTED_PLATFORMS = ['darwin', 'win32', 'linux'];
+//# sourceMappingURL=softwareConfigs.js.map

package/dist/constants/softwareConfigs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"softwareConfigs.js","sourceRoot":"","sources":["../../src/constants/softwareConfigs.ts"],"names":[],"mappings":"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"}

package/dist/functions/ag-grid/generateLicense.d.ts

@@ -1,4 +1,3 @@
 import type { CryptoJS } from '../../../references/crypto.d';
 import type { Base64Encoder } from '../../../references/browser.d';
-declare const _default: (crypto: CryptoJS, base64Encoder: Base64Encoder) => string;
-export default _default;
+export declare function generateLicense(crypto: CryptoJS, base64Encoder: Base64Encoder): string;

package/dist/functions/ag-grid/generateLicense.js

@@ -1,4 +1,4 @@
-export default (crypto, base64Encoder) => {
+export function generateLicense(crypto, base64Encoder) {
     let expiredDate = new Date();
     expiredDate.setFullYear(expiredDate.getFullYear() + 99);
     const milliSeconds = expiredDate.getTime();
@@ -8,5 +8,5 @@ export default (crypto, base64Encoder) => {
     const hash = typeof hashResult === 'string' ? hashResult : hashResult.toString();
     const licenseKey = `${license}${hash}`;
     return licenseKey;
-};
+}
 //# sourceMappingURL=generateLicense.js.map

package/dist/functions/ag-grid/generateLicense.js.map

@@ -1 +1 @@
-{"version":3,"file":"generateLicense.js","sourceRoot":"","sources":["../../../src/functions/ag-grid/generateLicense.ts"],"names":[],"mappings":"AASA,eAAe,CAAC,MAAgB,EAAE,aAA4B,EAAE,EAAE;IAChE,IAAI,WAAW,GAAG,IAAI,IAAI,EAAE,CAAA;IAC5B,WAAW,CAAC,WAAW,CAAC,WAAW,CAAC,WAAW,EAAE,GAAG,EAAE,CAAC,CAAA;IACvD,MAAM,YAAY,GAAG,WAAW,CAAC,OAAO,EAAE,CAAA;IAC1C,MAAM,OAAO,GAAG,aAAa,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC,CAAA;IAC3D,MAAM,OAAO,GAAG,uBAAuB,OAAO,EAAE,CAAA;IAChD,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;IACtC,MAAM,IAAI,GAAG,OAAO,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAA;IAChF,MAAM,UAAU,GAAG,GAAG,OAAO,GAAG,IAAI,EAAE,CAAA;IACtC,OAAO,UAAU,CAAA;AACnB,CAAC,CAAA"}
+{"version":3,"file":"generateLicense.js","sourceRoot":"","sources":["../../../src/functions/ag-grid/generateLicense.ts"],"names":[],"mappings":"AASA,MAAM,UAAU,eAAe,CAAC,MAAgB,EAAE,aAA4B;IAC5E,IAAI,WAAW,GAAG,IAAI,IAAI,EAAE,CAAA;IAC5B,WAAW,CAAC,WAAW,CAAC,WAAW,CAAC,WAAW,EAAE,GAAG,EAAE,CAAC,CAAA;IACvD,MAAM,YAAY,GAAG,WAAW,CAAC,OAAO,EAAE,CAAA;IAC1C,MAAM,OAAO,GAAG,aAAa,CAAC,IAAI,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC,CAAA;IAC3D,MAAM,OAAO,GAAG,uBAAuB,OAAO,EAAE,CAAA;IAChD,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;IACtC,MAAM,IAAI,GAAG,OAAO,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAA;IAChF,MAAM,UAAU,GAAG,GAAG,OAAO,GAAG,IAAI,EAAE,CAAA;IACtC,OAAO,UAAU,CAAA;AACnB,CAAC"}

package/dist/functions/altool/createAltoolClient.js

@@ -1,21 +1,15 @@
 import { uploadApp } from './uploadApp';
 import { validateApp } from './validateApp';
 import { getAppInfo } from './getAppInfo';
+import { getAltoolAuth } from './getAltoolAuth';
 export function createAltoolClient(config) {
     const { altoolPath, childProcess, defaultAuth, defaultOutputFormat = 'normal' } = config;
-    function getAuth(auth) {
-        if (auth)
-            return auth;
-        if (defaultAuth)
-            return defaultAuth;
-        throw new Error('No authentication provided and no default authentication configured');
-    }
     return {
         async upload(file, type, auth, outputFormat = defaultOutputFormat) {
             const options = {
                 file,
                 type,
-                auth: getAuth(auth),
+                auth: getAltoolAuth(auth, defaultAuth),
                 outputFormat
             };
             const result = await uploadApp(altoolPath, options, childProcess);
@@ -25,7 +19,7 @@ export function createAltoolClient(config) {
             const options = {
                 file,
                 type,
-                auth: getAuth(auth),
+                auth: getAltoolAuth(auth, defaultAuth),
                 outputFormat
             };
             return validateApp(altoolPath, options, childProcess);
@@ -33,7 +27,7 @@ export function createAltoolClient(config) {
         async listApps(type, auth, outputFormat = defaultOutputFormat) {
             const options = {
                 type,
-                auth: getAuth(auth),
+                auth: getAltoolAuth(auth, defaultAuth),
                 outputFormat
             };
             return getAppInfo(altoolPath, options, childProcess);