weapp-ide-cli 5.0.0 → 5.0.1

package/dist/index.d.ts

@@ -1,56 +1,120 @@
+/**
+ * @description 运行支付宝小程序 CLI（minidev）
+ */
 declare function runMinidev(argv: readonly string[]): Promise<void>;
 
+/**
+ * @description 交互式提示并保存 CLI 路径
+ */
 declare function promptForCliPath(): Promise<string | null>;
 
+/**
+ * @description 解析 CLI 路径并校验可用性
+ */
 declare function resolveCliPath(): Promise<{
     cliPath: string | null;
     source: ConfigSource;
 }>;
 
+/**
+ * @description CLI 入口解析与分发
+ */
 declare function parse(argv: string[]): Promise<void>;
 
+/**
+ * @description 基础配置
+ */
 interface BaseConfig {
     cliPath: string;
 }
+/**
+ * @description 配置来源
+ */
 type ConfigSource = 'custom' | 'default' | 'missing';
+/**
+ * @description 解析后的配置
+ */
 interface ResolvedConfig extends BaseConfig {
     source: ConfigSource;
 }
+/**
+ * @description CLI 参数别名配置
+ */
 interface AliasEntry {
     find: string;
     replacement: string;
 }
 
+/**
+ * @description 写入自定义 CLI 路径配置
+ */
 declare function createCustomConfig(params: BaseConfig): Promise<string>;
 
+/**
+ * @description 默认自定义配置目录
+ */
 declare const defaultCustomConfigDirPath: string;
+/**
+ * @description 默认自定义配置文件路径
+ */
 declare const defaultCustomConfigFilePath: string;
 
+/**
+ * @description 读取并解析 CLI 配置（自定义优先）
+ */
 declare function getConfig(): Promise<ResolvedConfig>;
 
 /**
- * 官方微信开发者工具只支持 Windows、macOS, Linux只有社区版 https://github.com/msojocs/wechat-web-devtools-linux
+ * @description 官方微信开发者工具只支持 Windows、macOS，Linux 只有社区版
+ * https://github.com/msojocs/wechat-web-devtools-linux
  */
 declare const SupportedPlatformsMap: {
     readonly Windows_NT: "Windows_NT";
     readonly Darwin: "Darwin";
     readonly Linux: "Linux";
 };
+/**
+ * @description 支持的系统类型
+ */
 type SupportedPlatform = (typeof SupportedPlatformsMap)[keyof typeof SupportedPlatformsMap];
+/**
+ * @description 判断当前系统是否支持微信开发者工具
+ */
 declare function isOperatingSystemSupported(osName?: string): osName is SupportedPlatform;
+/**
+ * @description 当前系统名称
+ */
 declare const operatingSystemName: string;
+/**
+ * @description 获取默认 CLI 路径（按系统）
+ */
 declare function getDefaultCliPath(targetOs?: string): Promise<string | undefined>;
 
+/**
+ * @description argv 处理函数
+ */
 type ArgvTransform = (argv: readonly string[]) => string[];
 /**
- * Apply a list of argv transforms in order while keeping the original argv untouched.
+ * @description 依次应用 argv 处理函数（不修改原始 argv）
  */
 declare function transformArgv(argv: readonly string[], transforms: readonly ArgvTransform[]): string[];
+/**
+ * @description 创建参数别名转换器
+ */
 declare function createAlias(entry: AliasEntry): ArgvTransform;
+/**
+ * @description 创建路径参数兼容转换器（补全或规范化路径）
+ */
 declare function createPathCompat(option: string): ArgvTransform;
 
+/**
+ * @description 执行 CLI 命令并透传输出
+ */
 declare function execute(cliPath: string, argv: string[]): Promise<void>;
 
+/**
+ * @description 解析为绝对路径（基于当前工作目录）
+ */
 declare function resolvePath(filePath: string): string;
 
 export { type ArgvTransform, type BaseConfig, type ConfigSource, type ResolvedConfig, type SupportedPlatform, SupportedPlatformsMap, createAlias, createCustomConfig, createPathCompat, defaultCustomConfigDirPath, defaultCustomConfigFilePath, execute, getConfig, getDefaultCliPath, isOperatingSystemSupported, operatingSystemName, parse, promptForCliPath, resolveCliPath, resolvePath, runMinidev, transformArgv };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "weapp-ide-cli",
   "type": "module",
-  "version": "5.0.0",
+  "version": "5.0.1",
   "description": "让微信开发者工具，用起来更加方便！",
   "author": "ice breaker <1324318532@qq.com>",
   "license": "MIT",
@@ -65,7 +65,7 @@
     "execa": "9.6.1",
     "fs-extra": "^11.3.3",
     "pathe": "^2.0.3",
-    "@weapp-core/logger": "^3.0.0"
+    "@weapp-core/logger": "^3.0.3"
   },
   "scripts": {
     "dev": "tsup --watch --sourcemap",