Function parseFlags

packages/computer/src/git/cli.ts:2221–2297

(args: string[], spec: Record<string, FlagSpec>)

}

function parseFlags(args: string[], spec: Record<string, FlagSpec>): ParseResult {
  const flags: Record<string, string | boolean> = {};
  const positional: string[] = [];
  const aliasMap = new Map<string, string>();
  for (const [name, s] of Object.entries(spec)) {
    if (s.alias) for (const a of s.alias) aliasMap.set(a, name);
  }

  let i = 0;
  while (i < args.length) {
    const arg = args[i];
    if (arg === "--") {
      for (i++; i < args.length; i++) positional.push(args[i]);
      break;
    }
    if (arg.startsWith("--")) {
      const eq = arg.indexOf("=");
      const name = eq === -1 ? arg.slice(2) : arg.slice(2, eq);
      const inlineValue = eq === -1 ? undefined : arg.slice(eq + 1);
      const s = spec[name];
      if (!s) return { error: `unknown option '--${name}'` };
      if (s.kind === "bool") {
        if (inlineValue !== undefined) {
          return { error: `option '--${name}' does not take a value` };
        }
        flags[name] = true;
        i++;
        continue;
      }
      if (s.kind === "value-or-bool") {
        // Bare `--flag` -> true; `--flag=x` -> x. The bare form
        // never consumes the next argv (it would be ambiguous
        // against a positional).
        flags[name] = inlineValue ?? true;
        i++;
        continue;
      }
      if (inlineValue !== undefined) {
        flags[name] = inlineValue;
        i++;
        continue;
      }
      const next = args[i + 1];
      if (next === undefined) {
        return { error: `option '--${name}' requires a value` };
      }
      flags[name] = next;
      i += 2;
      continue;
    }
    if (arg.startsWith("-") && arg.length > 1) {
      const short = arg.slice(1);
      // Look up by alias first; fall back to a spec entry whose
      // *name* is a single char matching the short form (so a
      // spec like `{ n: { kind: "value" } }` accepts `-n` without
      // declaring `alias: ["n"]`).
      const name = aliasMap.get(short) ?? (spec[short] ? short : undefined);
      if (!name) return { error: `unknown option '-${short}'` };