Genarrative/apps/ai-game-creator-shell/scripts/cargo-features.mjs

/** 默认桌面能力；显式 feature 参数优先，不把应用参数当 Cargo 参数。 */
export function withDefaultCargoFeatures(argv, features) {
  const separator = argv.indexOf('--');
  const cargoArgs = separator < 0 ? argv : argv.slice(0, separator);
  if (
    !features.length ||
    cargoArgs.some(
      (value) =>
        value === '--features' ||
        value === '-f' ||
        value.startsWith('--features=') ||
        /^-f.+/u.test(value),
    )
  ) {
    return argv;
  }
  return [`--features=${features.join(',')}`, ...argv];
}

export function defaultEditorFeatures(target) {
  return target === 'win32' || target.includes('windows')
    ? ['cocos-editor-execute', 'unity-editor-execute', 'godot-editor-execute']
    : [];
}

/// 单一声明式解析：本次构建实际生效的编辑器 feature 集。
/// 解析顺序：环境变量 `AGC_DEV_CARGO_FEATURES` > 命令行 `--features` > 目标平台默认值。
/// dev 入口、发布入口的 cargo 参数与随包资源准备步骤都必须用这里的返回值，
/// 否则会出现「cargo 开了 feature、staging 没开（或反之）」的窗口。
export function resolveEditorFeatures({
  argv = [],
  target,
  env = process.env,
} = {}) {
  // 顺序：环境变量（dev 的显式覆盖）> 命令行 --features > 目标平台默认值。
  const fromEnv = String(env.AGC_DEV_CARGO_FEATURES ?? '').trim();
  if (fromEnv) {
    return fromEnv
      .split(',')
      .map((name) => name.trim())
      .filter(Boolean);
  }
  const fromArgv = featuresFromArgv(argv);
  if (fromArgv) {
    return fromArgv;
  }
  return defaultEditorFeatures(target);
}

/// 从 argv 里解析 `--features a,b` / `--features=a,b`；没有则返回 null。
export function featuresFromArgv(argv = []) {
  for (let index = 0; index < argv.length; index += 1) {
    const value = String(argv[index]);
    if (value.startsWith('--features=')) {
      return value
        .slice('--features='.length)
        .split(',')
        .map((name) => name.trim())
        .filter(Boolean);
    }
    if (value === '--features' && argv[index + 1] !== undefined) {
      return String(argv[index + 1])
        .split(',')
        .map((name) => name.trim())
        .filter(Boolean);
    }
  }
  return null;
}