weapp-ide-cli 3.1.0 → 4.0.0-alpha.0

package/dist/index.cjs

@@ -30,42 +30,180 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 // src/index.ts
 var src_exports = {};
 __export(src_exports, {
+  SupportedPlatformsMap: () => SupportedPlatformsMap,
   createAlias: () => createAlias,
+  createCustomConfig: () => createCustomConfig,
   createPathCompat: () => createPathCompat,
   defaultCustomConfigDirPath: () => defaultCustomConfigDirPath,
   defaultCustomConfigFilePath: () => defaultCustomConfigFilePath,
   execute: () => execute,
-  getDefaultPath: () => getDefaultPath,
+  getConfig: () => getConfig,
+  getDefaultCliPath: () => getDefaultCliPath,
+  isOperatingSystemSupported: () => isOperatingSystemSupported,
   operatingSystemName: () => operatingSystemName,
   parse: () => parse,
-  resolvePath: () => resolvePath
+  promptForCliPath: () => promptForCliPath,
+  resolveCliPath: () => resolveCliPath,
+  resolvePath: () => resolvePath,
+  transformArgv: () => transformArgv
 });
 module.exports = __toCommonJS(src_exports);
 
-// src/defaults.ts
-var import_node_os = __toESM(require("os"), 1);
-var import_node_process = __toESM(require("process"), 1);
+// src/cli/prompt.ts
+var import_node_process2 = require("process");
+var import_promises = require("readline/promises");
+var import_fs_extra2 = __toESM(require("fs-extra"), 1);
+
+// src/config/custom.ts
 var import_fs_extra = __toESM(require("fs-extra"), 1);
+
+// src/utils/path.ts
+var import_node_process = __toESM(require("process"), 1);
 var import_pathe = __toESM(require("pathe"), 1);
+function resolvePath(filePath) {
+  if (import_pathe.default.isAbsolute(filePath)) {
+    return filePath;
+  }
+  return import_pathe.default.resolve(import_node_process.default.cwd(), filePath);
+}
+
+// src/config/paths.ts
+var import_node_os = __toESM(require("os"), 1);
+var import_pathe2 = __toESM(require("pathe"), 1);
+var homedir = import_node_os.default.homedir();
+var defaultCustomConfigDirPath = import_pathe2.default.join(homedir, ".weapp-ide-cli");
+var defaultCustomConfigFilePath = import_pathe2.default.join(
+  defaultCustomConfigDirPath,
+  "config.json"
+);
+
+// src/config/custom.ts
+var JSON_OPTIONS = {
+  encoding: "utf8",
+  spaces: 2
+};
+async function createCustomConfig(params) {
+  const trimmedCliPath = params.cliPath.trim();
+  if (!trimmedCliPath) {
+    throw new Error("cliPath cannot be empty");
+  }
+  const normalizedCliPath = resolvePath(trimmedCliPath);
+  await import_fs_extra.default.ensureDir(defaultCustomConfigDirPath);
+  await import_fs_extra.default.writeJSON(
+    defaultCustomConfigFilePath,
+    {
+      cliPath: normalizedCliPath
+    },
+    JSON_OPTIONS
+  );
+  return normalizedCliPath;
+}
 
 // src/logger.ts
 var import_logger = __toESM(require("@weapp-core/logger"), 1);
 var logger_default = import_logger.default;
 
-// src/defaults.ts
-var homedir = import_node_os.default.homedir();
+// src/cli/prompt.ts
+async function promptForCliPath() {
+  const rl = (0, import_promises.createInterface)({ input: import_node_process2.stdin, output: import_node_process2.stdout });
+  try {
+    logger_default.log("\u8BF7\u8BBE\u7F6E\u5FAE\u4FE1web\u5F00\u53D1\u8005\u5DE5\u5177 CLI \u7684\u8DEF\u5F84");
+    logger_default.log("> \u63D0\u793A\uFF1A\u547D\u4EE4\u884C\u5DE5\u5177\u9ED8\u8BA4\u6240\u5728\u4F4D\u7F6E\uFF1A");
+    logger_default.log("- MacOS: <\u5B89\u88C5\u8DEF\u5F84>/Contents/MacOS/cli");
+    logger_default.log("- Windows: <\u5B89\u88C5\u8DEF\u5F84>/cli.bat");
+    logger_default.log("- Linux: <\u5B89\u88C5\u8DEF\u5F84>/files/bin/bin/wechat-devtools-cli");
+    const cliPath = (await rl.question("\u8BF7\u8F93\u5165\u5FAE\u4FE1web\u5F00\u53D1\u8005\u5DE5\u5177 CLI \u8DEF\u5F84\uFF1A")).trim();
+    if (!cliPath) {
+      logger_default.error("\u8DEF\u5F84\u4E0D\u80FD\u4E3A\u7A7A\uFF0C\u5DF2\u53D6\u6D88\u672C\u6B21\u914D\u7F6E\u3002");
+      return null;
+    }
+    try {
+      const normalizedPath = await createCustomConfig({ cliPath });
+      logger_default.log(`\u5168\u5C40\u914D\u7F6E\u5B58\u50A8\u4F4D\u7F6E\uFF1A${defaultCustomConfigFilePath}`);
+      if (!await import_fs_extra2.default.pathExists(normalizedPath)) {
+        logger_default.warn("\u5728\u5F53\u524D\u8DEF\u5F84\u672A\u627E\u5230\u5FAE\u4FE1web\u5F00\u53D1\u8005\u547D\u4EE4\u884C\u5DE5\u5177\uFF0C\u8BF7\u786E\u8BA4\u8DEF\u5F84\u662F\u5426\u6B63\u786E\u3002");
+      }
+      return normalizedPath;
+    } catch (error) {
+      const reason = error instanceof Error ? error.message : String(error);
+      logger_default.error(`\u4FDD\u5B58\u914D\u7F6E\u5931\u8D25\uFF1A${reason}`);
+      return null;
+    }
+  } finally {
+    rl.close();
+  }
+}
+
+// src/cli/resolver.ts
+var import_fs_extra5 = __toESM(require("fs-extra"), 1);
+
+// src/config/resolver.ts
+var import_fs_extra4 = __toESM(require("fs-extra"), 1);
+
+// src/runtime/platform.ts
+var import_node_os2 = __toESM(require("os"), 1);
+var import_node_process3 = __toESM(require("process"), 1);
+var import_fs_extra3 = __toESM(require("fs-extra"), 1);
+var import_pathe3 = __toESM(require("pathe"), 1);
 var SupportedPlatformsMap = {
   Windows_NT: "Windows_NT",
   Darwin: "Darwin",
   Linux: "Linux"
 };
+function isOperatingSystemSupported(osName = import_node_os2.default.type()) {
+  return osName === SupportedPlatformsMap.Windows_NT || osName === SupportedPlatformsMap.Darwin || osName === SupportedPlatformsMap.Linux;
+}
+var operatingSystemName = import_node_os2.default.type();
+function createLinuxCliResolver() {
+  let resolvedPath;
+  let attempted = false;
+  let pending = null;
+  return async () => {
+    if (attempted) {
+      return resolvedPath;
+    }
+    if (!pending) {
+      pending = (async () => {
+        try {
+          const envPath = await getFirstBinaryPath("wechat-devtools-cli");
+          if (envPath) {
+            resolvedPath = envPath;
+          }
+        } catch (error) {
+          const reason = error instanceof Error ? error.message : String(error);
+          logger_default.warn(`\u83B7\u53D6 Linux wechat-devtools-cli \u8DEF\u5F84\u5931\u8D25\uFF1A${reason}`);
+        } finally {
+          attempted = true;
+        }
+        return resolvedPath;
+      })();
+    }
+    return pending;
+  };
+}
+var linuxCliResolver = createLinuxCliResolver();
+var WINDOWS_DEFAULT_CLI = "C:\\Program Files (x86)\\Tencent\\\u5FAE\u4FE1web\u5F00\u53D1\u8005\u5DE5\u5177\\cli.bat";
+var DARWIN_DEFAULT_CLI = "/Applications/wechatwebdevtools.app/Contents/MacOS/cli";
+var cliPathResolvers = {
+  [SupportedPlatformsMap.Windows_NT]: async () => WINDOWS_DEFAULT_CLI,
+  [SupportedPlatformsMap.Darwin]: async () => DARWIN_DEFAULT_CLI,
+  [SupportedPlatformsMap.Linux]: linuxCliResolver
+};
+async function getDefaultCliPath(targetOs = operatingSystemName) {
+  if (!isOperatingSystemSupported(targetOs)) {
+    return void 0;
+  }
+  const resolver = cliPathResolvers[targetOs];
+  const resolvedPath = await resolver();
+  return resolvedPath;
+}
 async function getFirstBinaryPath(command) {
-  const envPath = import_node_process.default.env.PATH || "";
-  const pathDirs = envPath.split(import_pathe.default.delimiter);
+  const envPath = import_node_process3.default.env.PATH || "";
+  const pathDirs = envPath.split(import_pathe3.default.delimiter);
   for (const dir of pathDirs) {
-    const fullPath = import_pathe.default.join(dir, command);
+    const fullPath = import_pathe3.default.join(dir, command);
     try {
-      await import_fs_extra.default.access(fullPath, import_fs_extra.default.constants.X_OK);
+      await import_fs_extra3.default.access(fullPath, import_fs_extra3.default.constants.X_OK);
       return fullPath;
     } catch {
       continue;
@@ -73,170 +211,107 @@ async function getFirstBinaryPath(command) {
   }
   return void 0;
 }
-var operatingSystemName = import_node_os.default.type();
-var defaultPathMap = {
-  [SupportedPlatformsMap.Windows_NT]: "C:\\Program Files (x86)\\Tencent\\\u5FAE\u4FE1web\u5F00\u53D1\u8005\u5DE5\u5177\\cli.bat",
-  [SupportedPlatformsMap.Darwin]: "/Applications/wechatwebdevtools.app/Contents/MacOS/cli"
-};
-var linuxPathInitialized = false;
-async function getLinuxDevToolsPath() {
-  if (operatingSystemName !== SupportedPlatformsMap.Linux && linuxPathInitialized) {
-    return;
-  }
-  try {
-    const linuxDevCliPath = await getFirstBinaryPath("wechat-devtools-cli");
-    if (linuxDevCliPath) {
-      linuxPathInitialized = true;
-      defaultPathMap[SupportedPlatformsMap.Linux] = linuxDevCliPath;
-    }
-  } catch (error) {
-    if (error instanceof Error) {
-      logger_default.error("\u83B7\u53D6Linux\u5F00\u53D1\u5DE5\u5177 wechat-devtools-cli \u8DEF\u5F84\u5931\u8D25:", error.message);
-    } else {
-      logger_default.error("\u83B7\u53D6Linux\u5F00\u53D1\u5DE5\u5177 wechat-devtools-cli \u8DEF\u5F84\u5931\u8D25:", error);
-    }
-    return defaultPathMap[SupportedPlatformsMap.Linux];
-  }
-}
-async function getDefaultPath() {
-  await getLinuxDevToolsPath();
-  return defaultPathMap[operatingSystemName];
-}
-var defaultCustomConfigDirPath = import_pathe.default.join(homedir, ".weapp-ide-cli");
-var defaultCustomConfigFilePath = import_pathe.default.join(
-  defaultCustomConfigDirPath,
-  "config.json"
-);
-
-// src/parse.ts
-var import_node_process3 = __toESM(require("process"), 1);
-var import_node_readline = __toESM(require("readline"), 1);
-var import_fs_extra3 = __toESM(require("fs-extra"), 1);
-
-// src/compose.ts
-function compose(...funcs) {
-  if (funcs.length === 0) {
-    return (arg) => arg;
-  }
-  if (funcs.length === 1) {
-    return funcs[0];
-  }
-  return funcs.reduce(
-    (a, b) => (...args) => a(b(...args))
-  );
-}
 
-// src/config.ts
-var import_fs_extra2 = __toESM(require("fs-extra"), 1);
-function createCustomConfig(params) {
-  return import_fs_extra2.default.outputJSON(
-    defaultCustomConfigFilePath,
-    {
-      cliPath: params.cliPath
-    },
-    {
-      encoding: "utf8",
-      spaces: 2
-    }
-  );
-}
+// src/config/resolver.ts
 async function getConfig() {
-  const isExisted = await import_fs_extra2.default.exists(defaultCustomConfigFilePath);
-  if (isExisted) {
-    const content = await import_fs_extra2.default.readFile(defaultCustomConfigFilePath, {
-      encoding: "utf8"
-    });
-    const config = JSON.parse(content);
-    logger_default.log("> \u5168\u5C40\u914D\u7F6E\u6587\u4EF6\u8DEF\u5F84\uFF1A", defaultCustomConfigFilePath);
-    logger_default.log("> \u81EA\u5B9A\u4E49cli\u8DEF\u5F84\uFF1A", config.cliPath);
-    return config;
-  } else {
+  if (await import_fs_extra4.default.pathExists(defaultCustomConfigFilePath)) {
+    try {
+      const config = await import_fs_extra4.default.readJSON(defaultCustomConfigFilePath);
+      const cliPath = typeof config.cliPath === "string" ? config.cliPath.trim() : "";
+      if (cliPath) {
+        logger_default.log("> \u5168\u5C40\u914D\u7F6E\u6587\u4EF6\u8DEF\u5F84\uFF1A", defaultCustomConfigFilePath);
+        logger_default.log("> \u81EA\u5B9A\u4E49 CLI \u8DEF\u5F84\uFF1A", cliPath);
+        return {
+          cliPath,
+          source: "custom"
+        };
+      }
+      logger_default.warn("\u81EA\u5B9A\u4E49\u914D\u7F6E\u6587\u4EF6\u7F3A\u5C11\u6709\u6548\u7684 CLI \u8DEF\u5F84\uFF0C\u5C06\u5C1D\u8BD5\u4F7F\u7528\u9ED8\u8BA4\u8DEF\u5F84\u3002");
+    } catch (error) {
+      const reason = error instanceof Error ? error.message : String(error);
+      logger_default.warn(`\u89E3\u6790\u81EA\u5B9A\u4E49\u914D\u7F6E\u5931\u8D25\uFF0C\u5C06\u5C1D\u8BD5\u4F7F\u7528\u9ED8\u8BA4\u8DEF\u5F84\u3002\u539F\u56E0\uFF1A${reason}`);
+    }
+  }
+  const fallbackPath = await getDefaultCliPath();
+  if (fallbackPath) {
     return {
-      cliPath: await getDefaultPath()
+      cliPath: fallbackPath,
+      source: "default"
     };
   }
+  return {
+    cliPath: "",
+    source: "missing"
+  };
 }
 
-// src/utils.ts
-var import_node_process2 = __toESM(require("process"), 1);
-var import_pathe2 = __toESM(require("pathe"), 1);
-async function execute(cliPath, argv) {
-  const { execa } = await import("execa");
-  const task = execa(cliPath, argv);
-  task?.stdout?.pipe(import_node_process2.default.stdout);
-  await task;
-}
-function resolvePath(filePath) {
-  if (import_pathe2.default.isAbsolute(filePath)) {
-    return filePath;
-  } else {
-    return import_pathe2.default.resolve(import_node_process2.default.cwd(), filePath);
+// src/cli/resolver.ts
+async function resolveCliPath() {
+  const config = await getConfig();
+  if (!config.cliPath) {
+    return { cliPath: null, source: config.source };
   }
+  const exists = await import_fs_extra5.default.pathExists(config.cliPath);
+  return {
+    cliPath: exists ? config.cliPath : null,
+    source: config.source
+  };
 }
-function alias(argv, entry) {
-  let findIdx = argv.indexOf(entry.find);
-  if (findIdx > -1) {
-    argv[findIdx] = entry.replacement;
+
+// src/utils/argv.ts
+var import_node_process4 = __toESM(require("process"), 1);
+function ensurePathArgument(argv, optionIndex) {
+  const paramIdx = optionIndex + 1;
+  const param = argv[paramIdx];
+  if (param && !param.startsWith("-")) {
+    argv[paramIdx] = resolvePath(param);
   } else {
-    findIdx = argv.indexOf(entry.replacement);
-  }
-  if (findIdx > -1) {
-    const paramIdx = findIdx + 1;
-    const param = argv[paramIdx];
-    if (param && param[0] !== "-") {
-      argv[paramIdx] = resolvePath(param);
-    } else {
-      argv.splice(paramIdx, 0, import_node_process2.default.cwd());
-    }
+    argv.splice(paramIdx, 0, import_node_process4.default.cwd());
   }
   return argv;
 }
-function pathCompat(argv, option) {
-  const findIdx = argv.indexOf(option);
-  if (findIdx > -1) {
-    const paramIdx = findIdx + 1;
-    const param = argv[paramIdx];
-    if (param && param[0] !== "-") {
-      argv[paramIdx] = resolvePath(param);
-    } else {
-      argv.splice(paramIdx, 0, import_node_process2.default.cwd());
-    }
-  }
-  return argv;
+function transformArgv(argv, transforms) {
+  return transforms.reduce((current, transform) => transform(current), [
+    ...argv
+  ]);
 }
 function createAlias(entry) {
-  return function(argv) {
-    return alias(argv, entry);
+  return (input2) => {
+    const argv = [...input2];
+    let optionIndex = argv.indexOf(entry.find);
+    if (optionIndex > -1) {
+      argv.splice(optionIndex, 1, entry.replacement);
+    } else {
+      optionIndex = argv.indexOf(entry.replacement);
+    }
+    if (optionIndex === -1) {
+      return argv;
+    }
+    return ensurePathArgument(argv, optionIndex);
   };
 }
 function createPathCompat(option) {
-  return function(argv) {
-    return pathCompat(argv, option);
+  return (input2) => {
+    const argv = [...input2];
+    const optionIndex = argv.indexOf(option);
+    if (optionIndex === -1) {
+      return argv;
+    }
+    return ensurePathArgument(argv, optionIndex);
   };
 }
 
-// src/parse.ts
-function rlSetConfig() {
-  const rl = import_node_readline.default.createInterface({
-    input: import_node_process3.default.stdin,
-    output: import_node_process3.default.stdout
-  });
-  logger_default.log("\u8BF7\u8BBE\u7F6E\u5FAE\u4FE1web\u5F00\u53D1\u8005\u5DE5\u5177 cli \u7684\u8DEF\u5F84");
-  logger_default.log("> \u63D0\u793A\uFF1A\u547D\u4EE4\u884C\u5DE5\u5177\u9ED8\u8BA4\u6240\u5728\u4F4D\u7F6E\uFF1A");
-  logger_default.log("- MacOS: <\u5B89\u88C5\u8DEF\u5F84>/Contents/MacOS/cli");
-  logger_default.log("- Windows: <\u5B89\u88C5\u8DEF\u5F84>/cli.bat");
-  logger_default.log("- Linux: <\u5B89\u88C5\u8DEF\u5F84>/files/bin/bin/wechat-devtools-cli");
-  return new Promise((resolve, _reject) => {
-    rl.question("\u8BF7\u8F93\u5165\u5FAE\u4FE1web\u5F00\u53D1\u8005\u5DE5\u5177cli\u8DEF\u5F84\uFF1A", async (cliPath) => {
-      await createCustomConfig({
-        cliPath
-      });
-      logger_default.log(`\u5168\u5C40\u914D\u7F6E\u5B58\u50A8\u4F4D\u7F6E\uFF1A${defaultCustomConfigFilePath}`);
-      resolve(cliPath);
-    });
-  });
+// src/utils/exec.ts
+var import_node_process5 = __toESM(require("process"), 1);
+async function execute(cliPath, argv) {
+  const { execa } = await import("execa");
+  const task = execa(cliPath, argv);
+  task?.stdout?.pipe(import_node_process5.default.stdout);
+  await task;
 }
-var parseArgv = compose(
+
+// src/cli/run.ts
+var ARG_TRANSFORMS = [
   createAlias({ find: "-p", replacement: "--project" }),
   createPathCompat("--result-output"),
   createPathCompat("-r"),
@@ -244,38 +319,42 @@ var parseArgv = compose(
   createPathCompat("-o"),
   createPathCompat("--info-output"),
   createPathCompat("-i")
-);
+];
 async function parse(argv) {
-  const isSupported = Boolean(await getDefaultPath());
-  if (isSupported) {
-    const { cliPath } = await getConfig();
-    const isExisted = await import_fs_extra3.default.exists(cliPath);
-    if (isExisted) {
-      if (argv[0] === "config") {
-        await rlSetConfig();
-        return;
-      }
-      const formattedArgv = parseArgv(argv);
-      await execute(cliPath, formattedArgv);
-    } else {
-      logger_default.log(
-        "\u5728\u5F53\u524D\u81EA\u5B9A\u4E49\u8DEF\u5F84\u4E2D,\u672A\u627E\u5230\u5FAE\u4FE1web\u5F00\u53D1\u8005\u547D\u4EE4\u884C\u5DE5\u5177\uFF0C\u8BF7\u91CD\u65B0\u6307\u5B9A\u8DEF\u5F84"
-      );
-      await rlSetConfig();
-    }
-  } else {
+  if (!isOperatingSystemSupported(operatingSystemName)) {
     logger_default.log(`\u5FAE\u4FE1web\u5F00\u53D1\u8005\u5DE5\u5177\u4E0D\u652F\u6301\u5F53\u524D\u5E73\u53F0\uFF1A${operatingSystemName} !`);
+    return;
+  }
+  if (argv[0] === "config") {
+    await promptForCliPath();
+    return;
+  }
+  const { cliPath, source } = await resolveCliPath();
+  if (!cliPath) {
+    const message = source === "custom" ? "\u5728\u5F53\u524D\u81EA\u5B9A\u4E49\u8DEF\u5F84\u4E2D\u672A\u627E\u5230\u5FAE\u4FE1web\u5F00\u53D1\u8005\u547D\u4EE4\u884C\u5DE5\u5177\uFF0C\u8BF7\u91CD\u65B0\u6307\u5B9A\u8DEF\u5F84\u3002" : "\u672A\u68C0\u6D4B\u5230\u5FAE\u4FE1web\u5F00\u53D1\u8005\u547D\u4EE4\u884C\u5DE5\u5177\uFF0C\u8BF7\u6267\u884C `weapp-ide-cli config` \u6307\u5B9A\u8DEF\u5F84\u3002";
+    logger_default.log(message);
+    await promptForCliPath();
+    return;
   }
+  const formattedArgv = transformArgv(argv, ARG_TRANSFORMS);
+  await execute(cliPath, formattedArgv);
 }
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
+  SupportedPlatformsMap,
   createAlias,
+  createCustomConfig,
   createPathCompat,
   defaultCustomConfigDirPath,
   defaultCustomConfigFilePath,
   execute,
-  getDefaultPath,
+  getConfig,
+  getDefaultCliPath,
+  isOperatingSystemSupported,
   operatingSystemName,
   parse,
-  resolvePath
+  promptForCliPath,
+  resolveCliPath,
+  resolvePath,
+  transformArgv
 });

package/dist/index.d.cts

@@ -1,21 +1,54 @@
-declare const operatingSystemName: string;
-declare function getDefaultPath(): Promise<string>;
-declare const defaultCustomConfigDirPath: string;
-declare const defaultCustomConfigFilePath: string;
+declare function promptForCliPath(): Promise<string | null>;
+
+declare function resolveCliPath(): Promise<{
+    cliPath: string | null;
+    source: ConfigSource;
+}>;
 
 declare function parse(argv: string[]): Promise<void>;
 
 interface BaseConfig {
     cliPath: string;
 }
+type ConfigSource = 'custom' | 'default' | 'missing';
+interface ResolvedConfig extends BaseConfig {
+    source: ConfigSource;
+}
 interface AliasEntry {
     find: string;
     replacement: string;
 }
 
+declare function createCustomConfig(params: BaseConfig): Promise<string>;
+
+declare const defaultCustomConfigDirPath: string;
+declare const defaultCustomConfigFilePath: string;
+
+declare function getConfig(): Promise<ResolvedConfig>;
+
+/**
+ * 官方微信开发者工具只支持 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";
+};
+type SupportedPlatform = (typeof SupportedPlatformsMap)[keyof typeof SupportedPlatformsMap];
+declare function isOperatingSystemSupported(osName?: string): osName is SupportedPlatform;
+declare const operatingSystemName: string;
+declare function getDefaultCliPath(targetOs?: string): Promise<string | undefined>;
+
+type ArgvTransform = (argv: readonly string[]) => string[];
+/**
+ * Apply a list of argv transforms in order while keeping the original argv untouched.
+ */
+declare function transformArgv(argv: readonly string[], transforms: readonly ArgvTransform[]): string[];
+declare function createAlias(entry: AliasEntry): ArgvTransform;
+declare function createPathCompat(option: string): ArgvTransform;
+
 declare function execute(cliPath: string, argv: string[]): Promise<void>;
+
 declare function resolvePath(filePath: string): string;
-declare function createAlias(entry: AliasEntry): (argv: string[]) => string[];
-declare function createPathCompat(option: string): (argv: string[]) => string[];
 
-export { type BaseConfig, createAlias, createPathCompat, defaultCustomConfigDirPath, defaultCustomConfigFilePath, execute, getDefaultPath, operatingSystemName, parse, resolvePath };
+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, transformArgv };

package/dist/index.d.ts

@@ -1,21 +1,54 @@
-declare const operatingSystemName: string;
-declare function getDefaultPath(): Promise<string>;
-declare const defaultCustomConfigDirPath: string;
-declare const defaultCustomConfigFilePath: string;
+declare function promptForCliPath(): Promise<string | null>;
+
+declare function resolveCliPath(): Promise<{
+    cliPath: string | null;
+    source: ConfigSource;
+}>;
 
 declare function parse(argv: string[]): Promise<void>;
 
 interface BaseConfig {
     cliPath: string;
 }
+type ConfigSource = 'custom' | 'default' | 'missing';
+interface ResolvedConfig extends BaseConfig {
+    source: ConfigSource;
+}
 interface AliasEntry {
     find: string;
     replacement: string;
 }
 
+declare function createCustomConfig(params: BaseConfig): Promise<string>;
+
+declare const defaultCustomConfigDirPath: string;
+declare const defaultCustomConfigFilePath: string;
+
+declare function getConfig(): Promise<ResolvedConfig>;
+
+/**
+ * 官方微信开发者工具只支持 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";
+};
+type SupportedPlatform = (typeof SupportedPlatformsMap)[keyof typeof SupportedPlatformsMap];
+declare function isOperatingSystemSupported(osName?: string): osName is SupportedPlatform;
+declare const operatingSystemName: string;
+declare function getDefaultCliPath(targetOs?: string): Promise<string | undefined>;
+
+type ArgvTransform = (argv: readonly string[]) => string[];
+/**
+ * Apply a list of argv transforms in order while keeping the original argv untouched.
+ */
+declare function transformArgv(argv: readonly string[], transforms: readonly ArgvTransform[]): string[];
+declare function createAlias(entry: AliasEntry): ArgvTransform;
+declare function createPathCompat(option: string): ArgvTransform;
+
 declare function execute(cliPath: string, argv: string[]): Promise<void>;
+
 declare function resolvePath(filePath: string): string;
-declare function createAlias(entry: AliasEntry): (argv: string[]) => string[];
-declare function createPathCompat(option: string): (argv: string[]) => string[];
 
-export { type BaseConfig, createAlias, createPathCompat, defaultCustomConfigDirPath, defaultCustomConfigFilePath, execute, getDefaultPath, operatingSystemName, parse, resolvePath };
+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, transformArgv };

package/dist/index.js

@@ -1,22 +1,36 @@
 import {
+  SupportedPlatformsMap,
   createAlias,
+  createCustomConfig,
   createPathCompat,
   defaultCustomConfigDirPath,
   defaultCustomConfigFilePath,
   execute,
-  getDefaultPath,
+  getConfig,
+  getDefaultCliPath,
+  isOperatingSystemSupported,
   operatingSystemName,
   parse,
-  resolvePath
-} from "./chunk-WCSD523G.js";
+  promptForCliPath,
+  resolveCliPath,
+  resolvePath,
+  transformArgv
+} from "./chunk-FJJOQAVP.js";
 export {
+  SupportedPlatformsMap,
   createAlias,
+  createCustomConfig,
   createPathCompat,
   defaultCustomConfigDirPath,
   defaultCustomConfigFilePath,
   execute,
-  getDefaultPath,
+  getConfig,
+  getDefaultCliPath,
+  isOperatingSystemSupported,
   operatingSystemName,
   parse,
-  resolvePath
+  promptForCliPath,
+  resolveCliPath,
+  resolvePath,
+  transformArgv
 };