@infly/libs 2.0.48 → 2.0.50

package/{tools → cli}/project-command.js

@@ -1,198 +1,199 @@
-const { execFileSync } = require("node:child_process");
-const fs = require("node:fs");
-const path = require("node:path");
-
-const {
-  EXIT_SELECTION,
-  selectOption: defaultSelectOption,
-} = require("./select-option");
-
-function loadConfig(cwd = process.cwd()) {
-  const packagePath = path.resolve(cwd, "package.json");
-  if (!fs.existsSync(packagePath)) {
-    throw new Error(`Project package not found: ${packagePath}.`);
-  }
-  delete require.cache[require.resolve(packagePath)];
-  const inflyConfig = require(packagePath).infly;
-  if (!inflyConfig?.dev && !inflyConfig?.build) {
-    throw new Error(`Project config is missing in ${packagePath}. Add infly.dev or infly.build.`);
-  }
-  return {
-    config: {
-      targets: inflyConfig.targets,
-      dev: inflyConfig.dev,
-      build: inflyConfig.build,
-    },
-    configDir: path.dirname(packagePath),
-  };
-}
-
-function normalizeTargets(targets) {
-  if (Array.isArray(targets)) {
-    return Object.fromEntries(targets.map((target) => [target, {}]));
-  }
-  if (targets && typeof targets === "object") return targets;
-  throw new Error("Project targets must be a non-empty array or object.");
-}
-
-function normalizeEnvironments(environments) {
-  if (Array.isArray(environments)) {
-    return Object.fromEntries(environments.map((entry) => {
-      const separatorIndex = entry.indexOf(":");
-      const environment = separatorIndex < 0 ? entry : entry.slice(0, separatorIndex);
-      const mode = separatorIndex < 0 ? entry : entry.slice(separatorIndex + 1);
-      if (!environment || !mode) {
-        throw new Error(`Invalid build environment mapping: ${entry}`);
-      }
-      return [environment, { mode, args: ["--mode", mode] }];
-    }));
-  }
-  if (environments && typeof environments === "object") return environments;
-  throw new Error("Build environments must be an array or object.");
-}
-
-function resolveBuildPlatforms(targets, buildConfig, targetName) {
-  const normalizedTargets = normalizeTargets(targets);
-  if (normalizedTargets[targetName]) return [targetName];
-
-  const preset = buildConfig.presets?.[targetName];
-  if (!preset) throw new Error(`Unknown build target: ${targetName}`);
-
-  return preset.targets.map((name) => {
-    if (!normalizedTargets[name]) {
-      throw new Error(`Unknown build target in preset ${targetName}: ${name}`);
-    }
-    return name;
-  });
-}
-
-function commandParts(command) {
-  const parts = typeof command === "string"
-    ? command.trim().split(/\s+/)
-    : command;
-  if (!Array.isArray(parts) || parts.length === 0 || !parts[0]) {
-    throw new Error("Command configuration must be a non-empty string or array.");
-  }
-  return { command: parts[0], args: parts.slice(1) };
-}
-
-function defaultRunCommand(command, args, options) {
-  execFileSync(command, args, {
-    cwd: options.cwd,
-    env: options.env,
-    stdio: "inherit",
-  });
-}
-
-function printDryRun(command, args, env) {
-  const platform = env.VUE_APP_PLATFORM ? `VUE_APP_PLATFORM=${env.VUE_APP_PLATFORM} ` : "";
-  console.log(`[dry-run] ${platform}${command} ${args.join(" ")}`.trim());
-}
-
-async function choose(selectOption, message, entries) {
-  return selectOption(
-    message,
-    entries.map(([value, item]) => ({ value, label: item.label || value })),
-  );
-}
-
-async function runProjectCommand(options = {}, dependencies = {}) {
-  if (typeof options.config === "string") {
-    throw new Error("--config is not supported for project commands; use package.json infly config.");
-  }
-
-  const configObject = options.configObject
-    || (options.config && typeof options.config === "object" ? options.config : undefined);
-  const loaded = configObject
-    ? { config: configObject, configDir: options.configDir }
-    : loadConfig(options.cwd || process.cwd());
-  const config = loaded.config;
-  const configDir = options.configDir || loaded.configDir || process.cwd();
-  if (!config) throw new Error("Project command config is required.");
-  const targets = normalizeTargets(config.targets);
-
-  const selectOption = dependencies.selectOption || defaultSelectOption;
-  const runCommand = dependencies.runCommand || defaultRunCommand;
-  const log = dependencies.log || console.log;
-  const exitIfSelected = (selection) => {
-    if (selection !== EXIT_SELECTION) return false;
-    log("已退出，未执行任何操作。");
-    return true;
-  };
-  const action = options.action || await selectOption("请选择操作", [
-    { value: "dev", label: "启动开发环境" },
-    { value: "build", label: "构建项目" },
-  ]);
-  if (exitIfSelected(action)) return { cancelled: true };
-
-  if (action === "dev") {
-    const devConfig = config.dev;
-    if (!devConfig) throw new Error("Dev configuration is missing.");
-    const targetName = options.target || await choose(
-      selectOption,
-      "请选择目标平台",
-      Object.entries(targets),
-    );
-    if (exitIfSelected(targetName)) return { cancelled: true };
-    const target = targets[targetName];
-    if (!target) throw new Error(`Unknown dev target: ${targetName}`);
-    const parts = commandParts(devConfig.command);
-    const env = { ...process.env, VUE_APP_PLATFORM: targetName };
-    if (options.dryRun) printDryRun(parts.command, parts.args, env);
-    else runCommand(parts.command, parts.args, { cwd: configDir, env });
-    return { action, target: targetName };
-  }
-
-  if (action !== "build") throw new Error(`Unknown project action: ${action}`);
-  const buildConfig = config.build;
-  if (!buildConfig) throw new Error("Build configuration is missing.");
-  const environments = normalizeEnvironments(buildConfig.environments);
-  const environment = options.env || await choose(
-    selectOption,
-    "请选择构建环境",
-    Object.entries(environments),
-  );
-  if (exitIfSelected(environment)) return { cancelled: true };
-  const environmentConfig = environments[environment];
-  if (!environmentConfig) throw new Error(`Unknown build environment: ${environment}`);
-  const targetEntries = [
-    ...Object.entries(targets),
-    ...Object.entries(buildConfig.presets || {}),
-  ];
-  const targetName = options.target || await choose(
-    selectOption,
-    "请选择目标平台",
-    targetEntries,
-  );
-  if (exitIfSelected(targetName)) return { cancelled: true };
-  const platforms = resolveBuildPlatforms(targets, buildConfig, targetName);
-
-  for (const platform of platforms) {
-    const env = { ...process.env, VUE_APP_PLATFORM: platform };
-    const lifecycleArgs = environmentConfig.mode ? ["--mode", environmentConfig.mode] : [];
-    // staging 构建禁用 Vue CLI 5 默认的 modern mode 双构建（测试环境无需 legacy 兼容）
-    const buildArgs = environment === "stage"
-      ? [...(environmentConfig.args || []), "--no-module"]
-      : (environmentConfig.args || []);
-    const steps = [
-      { command: buildConfig.before, extraArgs: lifecycleArgs },
-      { command: buildConfig.command, extraArgs: buildArgs },
-      { command: buildConfig.after, extraArgs: lifecycleArgs },
-    ];
-
-    for (const step of steps) {
-      const parts = commandParts(step.command);
-      const args = [...parts.args, ...step.extraArgs];
-      if (options.dryRun) printDryRun(parts.command, args, env);
-      else runCommand(parts.command, args, { cwd: configDir, env });
-    }
-  }
-
-  return { action, environment, target: targetName, platforms };
-}
-
-module.exports = {
-  loadConfig,
-  resolveBuildPlatforms,
-  runProjectCommand,
-};
+// 配置驱动的公共项目命令编排。
+const { execFileSync } = require("node:child_process");
+const fs = require("node:fs");
+const path = require("node:path");
+
+const {
+  EXIT_SELECTION,
+  selectOption: defaultSelectOption,
+} = require("./select-option");
+
+function loadConfig(cwd = process.cwd()) {
+  const packagePath = path.resolve(cwd, "package.json");
+  if (!fs.existsSync(packagePath)) {
+    throw new Error(`Project package not found: ${packagePath}.`);
+  }
+  delete require.cache[require.resolve(packagePath)];
+  const inflyConfig = require(packagePath).infly;
+  if (!inflyConfig?.dev && !inflyConfig?.build) {
+    throw new Error(`Project config is missing in ${packagePath}. Add infly.dev or infly.build.`);
+  }
+  return {
+    config: {
+      targets: inflyConfig.targets,
+      dev: inflyConfig.dev,
+      build: inflyConfig.build,
+    },
+    configDir: path.dirname(packagePath),
+  };
+}
+
+function normalizeTargets(targets) {
+  if (Array.isArray(targets)) {
+    return Object.fromEntries(targets.map((target) => [target, {}]));
+  }
+  if (targets && typeof targets === "object") return targets;
+  throw new Error("Project targets must be a non-empty array or object.");
+}
+
+function normalizeEnvironments(environments) {
+  if (Array.isArray(environments)) {
+    return Object.fromEntries(environments.map((entry) => {
+      const separatorIndex = entry.indexOf(":");
+      const environment = separatorIndex < 0 ? entry : entry.slice(0, separatorIndex);
+      const mode = separatorIndex < 0 ? entry : entry.slice(separatorIndex + 1);
+      if (!environment || !mode) {
+        throw new Error(`Invalid build environment mapping: ${entry}`);
+      }
+      return [environment, { mode, args: ["--mode", mode] }];
+    }));
+  }
+  if (environments && typeof environments === "object") return environments;
+  throw new Error("Build environments must be an array or object.");
+}
+
+function resolveBuildPlatforms(targets, buildConfig, targetName) {
+  const normalizedTargets = normalizeTargets(targets);
+  if (normalizedTargets[targetName]) return [targetName];
+
+  const preset = buildConfig.presets?.[targetName];
+  if (!preset) throw new Error(`Unknown build target: ${targetName}`);
+
+  return preset.targets.map((name) => {
+    if (!normalizedTargets[name]) {
+      throw new Error(`Unknown build target in preset ${targetName}: ${name}`);
+    }
+    return name;
+  });
+}
+
+function commandParts(command) {
+  const parts = typeof command === "string"
+    ? command.trim().split(/\s+/)
+    : command;
+  if (!Array.isArray(parts) || parts.length === 0 || !parts[0]) {
+    throw new Error("Command configuration must be a non-empty string or array.");
+  }
+  return { command: parts[0], args: parts.slice(1) };
+}
+
+function defaultRunCommand(command, args, options) {
+  execFileSync(command, args, {
+    cwd: options.cwd,
+    env: options.env,
+    stdio: "inherit",
+  });
+}
+
+function printDryRun(command, args, env) {
+  const platform = env.VUE_APP_PLATFORM ? `VUE_APP_PLATFORM=${env.VUE_APP_PLATFORM} ` : "";
+  console.log(`[dry-run] ${platform}${command} ${args.join(" ")}`.trim());
+}
+
+async function choose(selectOption, message, entries) {
+  return selectOption(
+    message,
+    entries.map(([value, item]) => ({ value, label: item.label || value })),
+  );
+}
+
+async function runProjectCommand(options = {}, dependencies = {}) {
+  if (typeof options.config === "string") {
+    throw new Error("--config is not supported for project commands; use package.json infly config.");
+  }
+
+  const configObject = options.configObject
+    || (options.config && typeof options.config === "object" ? options.config : undefined);
+  const loaded = configObject
+    ? { config: configObject, configDir: options.configDir }
+    : loadConfig(options.cwd || process.cwd());
+  const config = loaded.config;
+  const configDir = options.configDir || loaded.configDir || process.cwd();
+  if (!config) throw new Error("Project command config is required.");
+  const targets = normalizeTargets(config.targets);
+
+  const selectOption = dependencies.selectOption || defaultSelectOption;
+  const runCommand = dependencies.runCommand || defaultRunCommand;
+  const log = dependencies.log || console.log;
+  const exitIfSelected = (selection) => {
+    if (selection !== EXIT_SELECTION) return false;
+    log("已退出，未执行任何操作。");
+    return true;
+  };
+  const action = options.action || await selectOption("请选择操作", [
+    { value: "dev", label: "启动开发环境" },
+    { value: "build", label: "构建项目" },
+  ]);
+  if (exitIfSelected(action)) return { cancelled: true };
+
+  if (action === "dev") {
+    const devConfig = config.dev;
+    if (!devConfig) throw new Error("Dev configuration is missing.");
+    const targetName = options.target || await choose(
+      selectOption,
+      "请选择目标平台",
+      Object.entries(targets),
+    );
+    if (exitIfSelected(targetName)) return { cancelled: true };
+    const target = targets[targetName];
+    if (!target) throw new Error(`Unknown dev target: ${targetName}`);
+    const parts = commandParts(devConfig.command);
+    const env = { ...process.env, VUE_APP_PLATFORM: targetName };
+    if (options.dryRun) printDryRun(parts.command, parts.args, env);
+    else runCommand(parts.command, parts.args, { cwd: configDir, env });
+    return { action, target: targetName };
+  }
+
+  if (action !== "build") throw new Error(`Unknown project action: ${action}`);
+  const buildConfig = config.build;
+  if (!buildConfig) throw new Error("Build configuration is missing.");
+  const environments = normalizeEnvironments(buildConfig.environments);
+  const environment = options.env || await choose(
+    selectOption,
+    "请选择构建环境",
+    Object.entries(environments),
+  );
+  if (exitIfSelected(environment)) return { cancelled: true };
+  const environmentConfig = environments[environment];
+  if (!environmentConfig) throw new Error(`Unknown build environment: ${environment}`);
+  const targetEntries = [
+    ...Object.entries(targets),
+    ...Object.entries(buildConfig.presets || {}),
+  ];
+  const targetName = options.target || await choose(
+    selectOption,
+    "请选择目标平台",
+    targetEntries,
+  );
+  if (exitIfSelected(targetName)) return { cancelled: true };
+  const platforms = resolveBuildPlatforms(targets, buildConfig, targetName);
+
+  for (const platform of platforms) {
+    const env = { ...process.env, VUE_APP_PLATFORM: platform };
+    const lifecycleArgs = environmentConfig.mode ? ["--mode", environmentConfig.mode] : [];
+    // staging 构建禁用 Vue CLI 5 默认的 modern mode 双构建（测试环境无需 legacy 兼容）
+    const buildArgs = environment === "stage"
+      ? [...(environmentConfig.args || []), "--no-module"]
+      : (environmentConfig.args || []);
+    const steps = [
+      { command: buildConfig.before, extraArgs: lifecycleArgs },
+      { command: buildConfig.command, extraArgs: buildArgs },
+      { command: buildConfig.after, extraArgs: lifecycleArgs },
+    ];
+
+    for (const step of steps) {
+      const parts = commandParts(step.command);
+      const args = [...parts.args, ...step.extraArgs];
+      if (options.dryRun) printDryRun(parts.command, args, env);
+      else runCommand(parts.command, args, { cwd: configDir, env });
+    }
+  }
+
+  return { action, environment, target: targetName, platforms };
+}
+
+module.exports = {
+  loadConfig,
+  resolveBuildPlatforms,
+  runProjectCommand,
+};

package/{tools → cli}/select-option.js

@@ -1,60 +1,61 @@
-const EXIT_SELECTION = "__exit__";
-
-function isReadlineClosedError(error) {
-  return error?.code === "ERR_USE_AFTER_CLOSE";
-}
-
-function makePromptCancellationSafe(prompt) {
-  const unsafeStop = prompt.stop;
-  if (typeof unsafeStop !== "function") return;
-
-  prompt.removeListener("close", unsafeStop);
-  const safeStop = () => {
-    try {
-      unsafeStop();
-    } catch (error) {
-      if (!isReadlineClosedError(error)) throw error;
-    }
-  };
-  prompt.stop = safeStop;
-  prompt.once("close", safeStop);
-}
-
-async function selectOption(message, choices, dependencies = {}) {
-  const stdin = dependencies.stdin || process.stdin;
-  const stdout = dependencies.stdout || process.stdout;
-  if (!stdin.isTTY || !stdout.isTTY) {
-    throw new Error(`${message}: interactive selection requires a TTY; pass an explicit option.`);
-  }
-
-  const Select = dependencies.Select || require("enquirer").Select;
-  const prompt = new Select({
-    name: "selection",
-    message,
-    stdin,
-    stdout,
-    choices: [
-      ...choices.map((choice) => ({
-        name: choice.value,
-        message: choice.label,
-      })),
-      { name: EXIT_SELECTION, message: "退出" },
-    ],
-  });
-
-  prompt.once("start", makePromptCancellationSafe);
-  try {
-    return await prompt.run();
-  } catch (error) {
-    if (!error || error.name === "CancelPromptError" || isReadlineClosedError(error)) {
-      return EXIT_SELECTION;
-    }
-    throw error;
-  }
-}
-
-module.exports = {
-  EXIT_SELECTION,
-  makePromptCancellationSafe,
-  selectOption,
-};
+// CLI 交互选择适配，业务选项由调用方注入。
+const EXIT_SELECTION = "__exit__";
+
+function isReadlineClosedError(error) {
+  return error?.code === "ERR_USE_AFTER_CLOSE";
+}
+
+function makePromptCancellationSafe(prompt) {
+  const unsafeStop = prompt.stop;
+  if (typeof unsafeStop !== "function") return;
+
+  prompt.removeListener("close", unsafeStop);
+  const safeStop = () => {
+    try {
+      unsafeStop();
+    } catch (error) {
+      if (!isReadlineClosedError(error)) throw error;
+    }
+  };
+  prompt.stop = safeStop;
+  prompt.once("close", safeStop);
+}
+
+async function selectOption(message, choices, dependencies = {}) {
+  const stdin = dependencies.stdin || process.stdin;
+  const stdout = dependencies.stdout || process.stdout;
+  if (!stdin.isTTY || !stdout.isTTY) {
+    throw new Error(`${message}: interactive selection requires a TTY; pass an explicit option.`);
+  }
+
+  const Select = dependencies.Select || require("enquirer").Select;
+  const prompt = new Select({
+    name: "selection",
+    message,
+    stdin,
+    stdout,
+    choices: [
+      ...choices.map((choice) => ({
+        name: choice.value,
+        message: choice.label,
+      })),
+      { name: EXIT_SELECTION, message: "退出" },
+    ],
+  });
+
+  prompt.once("start", makePromptCancellationSafe);
+  try {
+    return await prompt.run();
+  } catch (error) {
+    if (!error || error.name === "CancelPromptError" || isReadlineClosedError(error)) {
+      return EXIT_SELECTION;
+    }
+    throw error;
+  }
+}
+
+module.exports = {
+  EXIT_SELECTION,
+  makePromptCancellationSafe,
+  selectOption,
+};

package/{tools → core/async}/concurrency.js

@@ -1,30 +1,31 @@
-/**
- * 异步并发限流器。
- * 对 items 数组中的每一项执行 worker，同时最多运行 concurrency 个 worker。
- *
- * @param {Array} items - 待处理项
- * @param {number} concurrency - 最大并发数
- * @param {Function} worker - 处理函数 (item, index) => Promise
- * @returns {Promise<Array>} 结果数组，索引与 items 一一对应
- */
-async function runWithConcurrency(items, concurrency, worker) {
-  if (!Number.isInteger(concurrency) || concurrency < 1) {
-    throw new TypeError("concurrency must be a positive integer");
-  }
-
-  const results = new Array(items.length);
-  let nextIndex = 0;
-  const runWorker = async () => {
-    while (nextIndex < items.length) {
-      const index = nextIndex;
-      nextIndex += 1;
-      results[index] = await worker(items[index], index);
-    }
-  };
-
-  const workerCount = Math.min(concurrency, items.length);
-  await Promise.all(Array.from({ length: workerCount }, runWorker));
-  return results;
-}
-
-module.exports = { runWithConcurrency };
+/**
+ * 框架无关的异步并发控制。
+ * 异步并发限流器。
+ * 对 items 数组中的每一项执行 worker，同时最多运行 concurrency 个 worker。
+ *
+ * @param {Array} items - 待处理项
+ * @param {number} concurrency - 最大并发数
+ * @param {Function} worker - 处理函数 (item, index) => Promise
+ * @returns {Promise<Array>} 结果数组，索引与 items 一一对应
+ */
+async function runWithConcurrency(items, concurrency, worker) {
+  if (!Number.isInteger(concurrency) || concurrency < 1) {
+    throw new TypeError("concurrency must be a positive integer");
+  }
+
+  const results = new Array(items.length);
+  let nextIndex = 0;
+  const runWorker = async () => {
+    while (nextIndex < items.length) {
+      const index = nextIndex;
+      nextIndex += 1;
+      results[index] = await worker(items[index], index);
+    }
+  };
+
+  const workerCount = Math.min(concurrency, items.length);
+  await Promise.all(Array.from({ length: workerCount }, runWorker));
+  return results;
+}
+
+module.exports = { runWithConcurrency };