create-eigen-game 0.13.0 → 0.13.1

package/dist/cli.js

@@ -1,156 +1,206 @@
 #!/usr/bin/env node
-import {
-  addContinuousIntegration,
-  applicationId,
-  destinationProblem,
-  detectPackageManager,
-  firebaseReadiness,
-  insideWorkTree,
-  normaliseTerminalWidth,
-  plainReporter,
-  scaffoldGame
-} from "./chunk-L7EVXO3Y.js";
-
-// src/cli.ts
-import { readFileSync } from "fs";
-import { basename, dirname, resolve } from "path";
-import { fileURLToPath } from "url";
-import { parseArgs } from "util";
-import { cancel, intro, isCI, isTTY, log, note, outro, taskLog } from "@clack/prompts";
-import color2 from "picocolors";
-
-// src/prompt.ts
-import { TextPrompt } from "@clack/core";
-import { confirm, isCancel, S_BAR, S_BAR_END, select, symbol } from "@clack/prompts";
+import { a as destinationProblem, c as insideWorkTree, d as scaffoldGame, l as normaliseTerminalWidth, n as applicationId, o as detectPackageManager, s as firebaseReadiness, t as addContinuousIntegration, u as plainReporter } from "./src-q9BxESYC.js";
+import { readFileSync } from "node:fs";
+import { basename, dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import { parseArgs } from "node:util";
+import { S_BAR, S_BAR_END, cancel, confirm, intro, isCI, isCancel, isTTY, log, note, outro, select, symbol, taskLog } from "@clack/prompts";
 import color from "picocolors";
-var ORG = /^[A-Za-z_][A-Za-z0-9_]*(\.[A-Za-z_][A-Za-z0-9_]*)+$/;
-var DEFAULT_ORG = "com.example";
-var bar = color.gray(S_BAR);
+import { TextPrompt } from "@clack/core";
+//#region src/prompt.ts
+/**
+* Two or more dot-separated Java identifiers. `flutter create --org` accepts
+* anything and defers the complaint to Gradle, which reports it as a manifest
+* error in a generated file, so `com.example-games` costs a full scaffold and
+* a first build before anyone learns that a hyphen is not legal in a package
+* segment.
+*/
+const ORG = /^[A-Za-z_][A-Za-z0-9_]*(\.[A-Za-z_][A-Za-z0-9_]*)+$/;
+/** The default, which an empty answer accepts. */
+const DEFAULT_ORG = "com.example";
+const bar = color.gray(S_BAR);
+/** A `com.acme.chess` answer to a game called `chess`, which yields `com.acme.chess.chess`. */
 function repeatsGameName(org, game) {
-  return org.split(".").at(-1) === game;
+	return org.split(".").at(-1) === game;
 }
+/** The organization implied by an answer that already ends in the game name. */
 function withoutGameName(org) {
-  const shorter = org.split(".").slice(0, -1).join(".");
-  return ORG.test(shorter) ? shorter : void 0;
+	const shorter = org.split(".").slice(0, -1).join(".");
+	return ORG.test(shorter) ? shorter : void 0;
 }
+/**
+* Asks, with the game name rendered dimmed after the cursor so the shape of
+* the answer is visible while it is being given.
+*
+* Returns the organization, `undefined` for the default, or `null` when
+* cancelled.
+*
+* `input` and `output` default to this process's, and are parameters for the
+* same reason every clack prompt takes them: a prompt is otherwise the one
+* part of a CLI that cannot be driven by a test.
+*/
 async function askForOrg(game, registering, io = {}) {
-  const input = io.input ?? process.stdin;
-  const output = io.output ?? process.stdout;
-  const suffix = color.dim(`.${game}`);
-  const prompt = new TextPrompt({
-    input,
-    output,
-    // An empty answer is the default, not a mistake.
-    validate: (value) => value === void 0 || value === "" || ORG.test(value) ? void 0 : "Two or more dot-separated segments, as in com.example or dev.yourname.games.",
-    render() {
-      const typed = String(this.value ?? "");
-      const shown = typed === "" ? `${color.dim(DEFAULT_ORG)}${suffix}` : `${this.userInputWithCursor}${suffix}`;
-      const problem = this.state === "error" ? `
-${bar}  ${color.yellow(this.error ?? "")}` : "";
-      return [`${bar}`, `${symbol(this.state)}  Organization in reverse domain notation`, `${bar}  ${shown}${problem}`, color.gray(S_BAR_END)].join("\n");
-    }
-  });
-  output.write(`${bar}  ${color.dim("Prefixes the Android applicationId, which Google Play makes permanent at first upload.")}
-`);
-  if (registering) output.write(`${bar}  ${color.dim("Also the Android app registered in the Firebase project you pick next.")}
-`);
-  const answer = await prompt.prompt();
-  if (isCancel(answer)) return null;
-  const org = String(answer).trim();
-  if (org === "" || org === DEFAULT_ORG) return void 0;
-  const shorter = repeatsGameName(org, game) ? withoutGameName(org) : void 0;
-  if (shorter !== void 0) {
-    const shorten = await confirm({
-      message: `That gives ${color.yellow(`${org}.${game}`)}, the game name twice. Use ${color.green(shorter)} instead?`,
-      initialValue: true,
-      input,
-      output
-    });
-    if (isCancel(shorten)) return null;
-    if (shorten) return shorter;
-  }
-  return org;
+	const input = io.input ?? process.stdin;
+	const output = io.output ?? process.stdout;
+	const suffix = color.dim(`.${game}`);
+	const prompt = new TextPrompt({
+		input,
+		output,
+		validate: (value) => value === void 0 || value === "" || ORG.test(value) ? void 0 : "Two or more dot-separated segments, as in com.example or dev.yourname.games.",
+		render() {
+			const shown = String(this.value ?? "") === "" ? `${color.dim(DEFAULT_ORG)}${suffix}` : `${this.userInputWithCursor}${suffix}`;
+			const problem = this.state === "error" ? `\n${bar}  ${color.yellow(this.error ?? "")}` : "";
+			return [
+				`${bar}`,
+				`${symbol(this.state)}  Organization in reverse domain notation`,
+				`${bar}  ${shown}${problem}`,
+				color.gray(S_BAR_END)
+			].join("\n");
+		}
+	});
+	output.write(`${bar}  ${color.dim("Prefixes the Android applicationId, which Google Play makes permanent at first upload.")}\n`);
+	if (registering) output.write(`${bar}  ${color.dim("Also the Android app registered in the Firebase project you pick next.")}\n`);
+	const answer = await prompt.prompt();
+	if (isCancel(answer)) return null;
+	const org = String(answer).trim();
+	if (org === "" || org === "com.example") return void 0;
+	const shorter = repeatsGameName(org, game) ? withoutGameName(org) : void 0;
+	if (shorter !== void 0) {
+		const shorten = await confirm({
+			message: `That gives ${color.yellow(`${org}.${game}`)}, the game name twice. Use ${color.green(shorter)} instead?`,
+			initialValue: true,
+			input,
+			output
+		});
+		if (isCancel(shorten)) return null;
+		if (shorten) return shorter;
+	}
+	return org;
 }
+/**
+* A yes/no question, with its reason on the line above.
+*
+* The three below share this so cancellation is handled in one place: ^C
+* during any question has to mean the run stops having written nothing, and
+* that is only true if every call site checks. `null` is that answer.
+*
+* `hint` is written rather than passed to `confirm`, which has nowhere to put
+* it. It is the same dimmed line the organization prompt uses, and carries the
+* thing that makes the default the default: a question whose answer is
+* pre-chosen owes the reader why.
+*/
 async function ask(message, initialValue, hint, io) {
-  const input = io.input ?? process.stdin;
-  const output = io.output ?? process.stdout;
-  output.write(`${bar}
-${bar}  ${color.dim(hint)}
-`);
-  const answer = await confirm({ message, initialValue, input, output });
-  return isCancel(answer) ? null : answer;
+	const input = io.input ?? process.stdin;
+	const output = io.output ?? process.stdout;
+	output.write(`${bar}\n${bar}  ${color.dim(hint)}\n`);
+	const answer = await confirm({
+		message,
+		initialValue,
+		input,
+		output
+	});
+	return isCancel(answer) ? null : answer;
 }
+/**
+* Asked only when {@link firebaseReadiness} found something missing, and
+* defaulted to "no" because the honest answer usually is: the tools are two
+* commands away, and the alternative is an app that throws at launch until
+* they are installed anyway.
+*/
 function askToScaffoldWithoutFirebase(io = {}) {
-  return ask("Scaffold anyway, and connect Firebase yourself later?", false, "Everything except the app's sign-in still works, and `firebase:configure` finishes the job.", io);
+	return ask("Scaffold anyway, and connect Firebase yourself later?", false, "Everything except the app's sign-in still works, and `firebase:configure` finishes the job.", io);
 }
+/** Defaulted to yes: the scaffold is a few hundred generated files, and a commit is what makes the first `git diff` the first game change rather than all of them. */
 function askForGit(io = {}) {
-  return ask("Initialise a git repository and commit the scaffold?", true, "Commits once, so your first diff is your first game change.", io);
+	return ask("Initialise a git repository and commit the scaffold?", true, "Commits once, so your first diff is your first game change.", io);
 }
+/**
+* Defaulted to no, and the hint says why rather than leaving it as an
+* arbitrary-looking choice: `release.yml` needs an upload keystore and a Play
+* service account, so a project that takes the workflows before it has either
+* gets a red `main` from its first push.
+*/
 function askForWorkflows(io = {}) {
-  return ask("Add the GitHub Actions workflows?", false, "Release needs a signing keystore and a Play service account, so this fails until you have both. `add workflows` writes them later.", io);
+	return ask("Add the GitHub Actions workflows?", false, "Release needs a signing keystore and a Play service account, so this fails until you have both. `add workflows` writes them later.", io);
 }
+/**
+* The package manager, asked only when nothing else could say.
+*
+* `npm create` and `pnpm create` both set `npm_config_user_agent`, so this is
+* reached by the paths that do not: a global install, or running the binary
+* directly. Rare, but it decides what every generated script says, and the old
+* silent fallback to pnpm was a guess printed into a project's package.json.
+*/
 async function askForPackageManager(io = {}) {
-  const answer = await select({
-    message: "Which package manager should the generated scripts use?",
-    options: [
-      { value: "pnpm", label: "pnpm" },
-      { value: "npm", label: "npm" }
-    ],
-    input: io.input ?? process.stdin,
-    output: io.output ?? process.stdout
-  });
-  return isCancel(answer) ? null : answer;
+	const answer = await select({
+		message: "Which package manager should the generated scripts use?",
+		options: [{
+			value: "pnpm",
+			label: "pnpm"
+		}, {
+			value: "npm",
+			label: "npm"
+		}],
+		input: io.input ?? process.stdin,
+		output: io.output ?? process.stdout
+	});
+	return isCancel(answer) ? null : answer;
 }
-
-// src/summary.ts
+//#endregion
+//#region src/summary.ts
+/** Two-column rows, aligned to the widest left cell. */
 function columns(rows) {
-  const width = Math.max(...rows.map(([left]) => left.length));
-  return rows.map(([left, right]) => `  ${left.padEnd(width)}  ${right}`);
+	const width = Math.max(...rows.map(([left]) => left.length));
+	return rows.map(([left, right]) => `  ${left.padEnd(width)}  ${right}`);
 }
 function summarise(result, manager, workflows) {
-  const run = manager === "npm" ? "npm run" : "pnpm";
-  const status = [];
-  if (result.git === "committed") status.push(`Committed as "Scaffold ${result.name}"`);
-  if (result.git === "existing") status.push("Created inside a repository you already had, so nothing was committed");
-  if (result.firebase === "configured") status.push(result.git === "committed" ? "Firebase is configured, and everything it generated is in that commit" : "Firebase is configured");
-  if (result.link?.projectId != null) status.push(`FIREBASE_PROJECT_ID is set to ${result.link.projectId}, and app-config.json points at the local Worker`);
-  const remaining = [];
-  if (result.link !== void 0) {
-    if (result.link.googleWebClientId === null) {
-      remaining.push(["Enable Google sign-in", "Console > Authentication > Sign-in method"]);
-      remaining.push(["GOOGLE_WEB_CLIENT_ID", "that same page, under Web SDK configuration"]);
-    }
-    remaining.push(["FIREBASE_VAPID_KEY", "Console > Project settings > Cloud Messaging > Web configuration"]);
-  }
-  const next = [
-    "Write the game",
-    ...columns([
-      ["server/src/module/v1.ts", "the authoritative rules"],
-      ["app/lib/game/v1/rules.dart", "the presentation twin"]
-    ]),
-    "",
-    `Then, from ${result.name}/`,
-    ...columns([
-      [`cd server && ${run} test:watch`, "rules and twin fixtures"],
-      [`cd server && ${run} dev`, "the Worker, on http://localhost:8787"],
-      [`${run} contract`, "regenerate after a schema change"],
-      // Named here because it is the one step the game itself cannot do
-      // without: rules, fixtures and the Worker all run unconfigured, and the
-      // app throws `Firebase is not configured` at launch until this has run
-      // once.
-      ...result.firebase === "configured" ? [] : [[`${run} firebase:configure`, "connect Firebase before the app runs"]]
-    ]),
-    ...remaining.length === 0 ? [] : ["", "Before the app runs, from the Firebase console", ...columns(remaining), "", "  The values go in app/app-config.json. Both are public, not secrets."]
-  ].join("\n");
-  const footnotes = ["Docs: https://eigeninteractive.com"];
-  if (!workflows) footnotes.unshift("No CI workflows yet: `create-eigen-game add workflows` writes them when shipping is the next step.");
-  return { status, next, footnotes, headline: `${result.name} is ready, at ${result.root}` };
+	const run = manager === "npm" ? "npm run" : "pnpm";
+	const status = [];
+	if (result.git === "committed") status.push(`Committed as "Scaffold ${result.name}"`);
+	if (result.git === "existing") status.push("Created inside a repository you already had, so nothing was committed");
+	if (result.firebase === "configured") status.push(result.git === "committed" ? "Firebase is configured, and everything it generated is in that commit" : "Firebase is configured");
+	if (result.link?.projectId != null) status.push(`FIREBASE_PROJECT_ID is set to ${result.link.projectId}, and app-config.json points at the local Worker`);
+	const remaining = [];
+	if (result.link !== void 0) {
+		if (result.link.googleWebClientId === null) {
+			remaining.push(["Enable Google sign-in", "Console > Authentication > Sign-in method"]);
+			remaining.push(["GOOGLE_WEB_CLIENT_ID", "that same page, under Web SDK configuration"]);
+		}
+		remaining.push(["FIREBASE_VAPID_KEY", "Console > Project settings > Cloud Messaging > Web configuration"]);
+	}
+	const next = [
+		"Write the game",
+		...columns([["server/src/module/v1.ts", "the authoritative rules"], ["app/lib/game/v1/rules.dart", "the presentation twin"]]),
+		"",
+		`Then, from ${result.name}/`,
+		...columns([
+			[`cd server && ${run} test:watch`, "rules and twin fixtures"],
+			[`cd server && ${run} dev`, "the Worker, on http://localhost:8787"],
+			[`${run} contract`, "regenerate after a schema change"],
+			...result.firebase === "configured" ? [] : [[`${run} firebase:configure`, "connect Firebase before the app runs"]]
+		]),
+		...remaining.length === 0 ? [] : [
+			"",
+			"Before the app runs, from the Firebase console",
+			...columns(remaining),
+			"",
+			"  The values go in app/app-config.json. Both are public, not secrets."
+		]
+	].join("\n");
+	const footnotes = ["Docs: https://eigeninteractive.com"];
+	if (!workflows) footnotes.unshift("No CI workflows yet: `create-eigen-game add workflows` writes them when shipping is the next step.");
+	return {
+		status,
+		next,
+		footnotes,
+		headline: `${result.name} is ready, at ${result.root}`
+	};
 }
-
-// src/cli.ts
-var version = JSON.parse(readFileSync(resolve(dirname(fileURLToPath(import.meta.url)), "../package.json"), "utf8")).version;
-var PREREQUISITES = "https://eigeninteractive.com/docs/getting-started/prerequisites";
-var help = `Usage: create-eigen-game <game-slug> [options]
+//#endregion
+//#region src/cli.ts
+const version = JSON.parse(readFileSync(resolve(dirname(fileURLToPath(import.meta.url)), "../package.json"), "utf8")).version;
+const PREREQUISITES = "https://eigeninteractive.com/docs/getting-started/prerequisites";
+const help = `Usage: create-eigen-game <game-slug> [options]
        create-eigen-game add workflows [directory] [options]
 
 Creates one repository containing an EigenInteractive Cloudflare Worker and
@@ -189,274 +239,312 @@ Commands:
                          you are ready to ship rather than at scaffold time.
                          Defaults to the current directory.`;
 normaliseTerminalWidth(process.stdout);
-var decorated = isTTY(process.stdout) && !isCI();
-var ui = decorated ? {
-  open: () => intro(color2.inverse(" EigenInteractive ")),
-  info: (message) => log.info(message),
-  warn: (message) => log.warn(message),
-  success: (message) => log.success(message),
-  block: (body) => note(body, "Next"),
-  close: (message) => outro(color2.bold(message)),
-  stop: (message) => cancel(message)
+/**
+* Whether to draw, using clack's own predicates rather than a hand-rolled
+* `isTTY`, the same pair `taskLog` consults internally. A pipe has nowhere to
+* put a redraw, and a CI log is read after the fact, in full, by someone who
+* wants every line a tool printed.
+*/
+const decorated = isTTY(process.stdout) && !isCI();
+/**
+* The CLI's voice, in whichever of the two registers this terminal supports.
+*
+* Every message goes through here so the undecorated path cannot drift into
+* being the untested one.
+*/
+const ui = decorated ? {
+	open: () => intro(color.inverse(" EigenInteractive ")),
+	info: (message) => log.info(message),
+	warn: (message) => log.warn(message),
+	success: (message) => log.success(message),
+	block: (body) => note(body, "Next"),
+	close: (message) => outro(color.bold(message)),
+	stop: (message) => cancel(message)
 } : {
-  open: () => console.log("\nEigenInteractive\n"),
-  info: (message) => console.log(message),
-  warn: (message) => console.warn(message),
-  success: (message) => console.log(message),
-  block: (body) => console.log(`
-${body}
-`),
-  close: (message) => console.log(message),
-  stop: (message) => console.error(message)
+	open: () => console.log("\nEigenInteractive\n"),
+	info: (message) => console.log(message),
+	warn: (message) => console.warn(message),
+	success: (message) => console.log(message),
+	block: (body) => console.log(`\n${body}\n`),
+	close: (message) => console.log(message),
+	stop: (message) => console.error(message)
 };
 function resolveManager(requested) {
-  if (requested === void 0) return void 0;
-  if (requested !== "npm" && requested !== "pnpm") {
-    throw new Error("--package-manager must be npm or pnpm");
-  }
-  return requested;
+	if (requested === void 0) return void 0;
+	if (requested !== "npm" && requested !== "pnpm") throw new Error("--package-manager must be npm or pnpm");
+	return requested;
 }
+/**
+* Why a scaffold asks about a second service at all, said once, before the
+* first question rather than in the error that follows it.
+*
+* Firebase is not an integration this engine offers; it is where a player
+* comes from. Somebody meeting that for the first time deserves the reason in
+* the same breath as the requirement, and deserves to know the size of it:
+* one free project, shared by every game they build.
+*/
 function greet() {
-  ui.open();
-  ui.info("A game is one repository with two halves: a Cloudflare Worker that owns the rules,\nand a Flutter app for Android and the web. This writes both, wired together and\nalready playable.");
-  ui.info(
-    `Firebase signs your players in. The Worker verifies Firebase ID tokens to decide who
-holds a seat, and sends turn notifications through the same project, so a scaffolded
-app throws ${color2.dim("Firebase is not configured")} at launch until one is connected.
-
-It is free to start, one project serves every game you build, and this connects yours
-as it goes. ${color2.dim(PREREQUISITES)}`
-  );
+	ui.open();
+	ui.info("A game is one repository with two halves: a Cloudflare Worker that owns the rules,\nand a Flutter app for Android and the web. This writes both, wired together and\nalready playable.");
+	ui.info(`Firebase signs your players in. The Worker verifies Firebase ID tokens to decide who\nholds a seat, and sends turn notifications through the same project, so a scaffolded\napp throws ${color.dim("Firebase is not configured")} at launch until one is connected.\n\nIt is free to start, one project serves every game you build, and this connects yours\nas it goes. ${color.dim(PREREQUISITES)}`);
 }
+/** What is missing, and the one command that fixes each: the same list the warning and the parting message are both built from. */
 function firebaseReport(problems) {
-  const lines = problems.flatMap((problem) => [`  ${problem.reason}`, `    ${color2.cyan(problem.fix)}`]);
-  if (problems.some((problem) => problem.fix.startsWith("dart pub"))) {
-    lines.push(`    ${color2.dim('\u2026then, if your shell cannot find it: export PATH="$PATH":"$HOME/.pub-cache/bin"')}`);
-  }
-  return lines.join("\n");
+	const lines = problems.flatMap((problem) => [`  ${problem.reason}`, `    ${color.cyan(problem.fix)}`]);
+	if (problems.some((problem) => problem.fix.startsWith("dart pub"))) lines.push(`    ${color.dim("…then, if your shell cannot find it: export PATH=\"$PATH\":\"$HOME/.pub-cache/bin\"")}`);
+	return lines.join("\n");
 }
+/**
+* The parting message when someone answers "no" to scaffolding without
+* Firebase: every command they need, in the order they run in.
+*
+* Deliberately not a failure of the scaffold: nothing has been written, they
+* asked for that, and the exit code is non-zero only so a script that wrapped
+* this can tell there is no project.
+*/
 function stopForFirebase(problems) {
-  note(`${problems.map((problem) => `  ${color2.cyan(problem.fix)}`).join("\n")}
-
-Then run this again.
-${color2.dim(PREREQUISITES)}`, "Set up Firebase");
-  ui.stop("Nothing was written.");
-  process.exitCode = 1;
+	note(`${problems.map((problem) => `  ${color.cyan(problem.fix)}`).join("\n")}\n\nThen run this again.\n${color.dim(PREREQUISITES)}`, "Set up Firebase");
+	ui.stop("Nothing was written.");
+	process.exitCode = 1;
 }
+/**
+* The error for a run with no terminal and an unanswered question.
+*
+* The strictness is the point: a default applied where nobody can see it is
+* how `com.example.my_game` reaches Google Play, which freezes it at the first
+* upload. What keeps that from being merely annoying is this message: the
+* whole command, with every default already filled in, so the fix is one
+* paste and the one value worth changing is visible in it.
+*/
 function unanswered(directory, missing) {
-  const command = ["npx create-eigen-game", directory, ...missing.map((question) => question.suggestion)].join(" ");
-  return [`No terminal to ask on, so every answer has to come from a flag. These were not given:`, "", ...missing.map((question) => `  ${question.flags}`), "", "That command, with each default filled in. Read them before you run it:", "", `  ${command}`].join("\n");
+	const command = [
+		"npx create-eigen-game",
+		directory,
+		...missing.map((question) => question.suggestion)
+	].join(" ");
+	return [
+		`No terminal to ask on, so every answer has to come from a flag. These were not given:`,
+		"",
+		...missing.map((question) => `  ${question.flags}`),
+		"",
+		"That command, with each default filled in. Read them before you run it:",
+		"",
+		`  ${command}`
+	].join("\n");
 }
+/** `--foo` and `--no-foo`, which `parseArgs` has no notion of: `undefined` means nobody said, which is what makes it a question. */
 function flagPair(yes, no, name) {
-  if (yes === true && no === true) throw new Error(`--${name} and --no-${name} contradict each other`);
-  if (yes === true) return true;
-  if (no === true) return false;
-  return void 0;
+	if (yes === true && no === true) throw new Error(`--${name} and --no-${name} contradict each other`);
+	if (yes === true) return true;
+	if (no === true) return false;
 }
+/** `--org ""` falls through to the default rather than failing, matching what an empty answer to the prompt does. */
 function resolveOrg(value) {
-  if (value.trim() === "") return void 0;
-  if (!ORG.test(value)) {
-    throw new Error(`invalid organization: ${value}
-
-Use reverse domain notation: two or more dot-separated segments of letters, digits and underscores, each starting with a letter, as in ${DEFAULT_ORG} or dev.yourname.games.`);
-  }
-  return value;
+	if (value.trim() === "") return void 0;
+	if (!ORG.test(value)) throw new Error(`invalid organization: ${value}\n\nUse reverse domain notation: two or more dot-separated segments of letters, digits and underscores, each starting with a letter, as in ${DEFAULT_ORG} or dev.yourname.games.`);
+	return value;
 }
+/**
+* Shows each step running, and keeps its output only when it fails.
+*
+* Every tool a scaffold drives has plenty to say (pub resolving 179
+* dependencies, two icon generators, a package manager) and none of it is
+* read while it scrolls past. `taskLog` is exactly that bargain: the stream is
+* visible while the step runs, cleared when it succeeds, and left on screen
+* when it does not, so a failure is still debuggable from what is in the
+* terminal.
+*
+* `handOver` is the exception, and the reason `interactive` exists at all.
+* FlutterFire asks which Firebase project to use, so that step needs the
+* terminal rather than a captured pipe.
+*/
 function clackReporter() {
-  if (!decorated) return plainReporter;
-  let task;
-  let interactive = false;
-  return {
-    step(label, body) {
-      task = taskLog({ title: label });
-      try {
-        const value = body();
-        task.success(label);
-        return value;
-      } catch (error) {
-        task.error(label);
-        throw error;
-      } finally {
-        task = void 0;
-      }
-    },
-    handOver(label, body) {
-      log.step(`${label} ${color2.dim("(FlutterFire takes over here)")}`);
-      interactive = true;
-      try {
-        return body();
-      } finally {
-        interactive = false;
-      }
-    },
-    emit(output) {
-      const text = output.trimEnd();
-      if (text !== "") task?.message(text);
-    },
-    warn(message) {
-      ui.warn(message);
-    },
-    get interactive() {
-      return interactive;
-    }
-  };
+	if (!decorated) return plainReporter;
+	let task;
+	let interactive = false;
+	return {
+		step(label, body) {
+			task = taskLog({ title: label });
+			try {
+				const value = body();
+				task.success(label);
+				return value;
+			} catch (error) {
+				task.error(label);
+				throw error;
+			} finally {
+				task = void 0;
+			}
+		},
+		handOver(label, body) {
+			log.step(`${label} ${color.dim("(FlutterFire takes over here)")}`);
+			interactive = true;
+			try {
+				return body();
+			} finally {
+				interactive = false;
+			}
+		},
+		emit(output) {
+			const text = output.trimEnd();
+			if (text !== "") task?.message(text);
+		},
+		warn(message) {
+			ui.warn(message);
+		},
+		get interactive() {
+			return interactive;
+		}
+	};
 }
 async function main(args) {
-  const { values, positionals } = parseArgs({
-    args,
-    allowPositionals: true,
-    strict: true,
-    options: {
-      help: { type: "boolean", short: "h" },
-      version: { type: "boolean", short: "v" },
-      org: { type: "string" },
-      "firebase-project": { type: "string" },
-      // Each negation is declared under the name it is typed with, because
-      // `parseArgs` has no boolean negation of its own. `flagPair` puts the
-      // two halves back together, and the third state, neither given, is the
-      // one that matters: it is what turns the flag into a question.
-      "no-firebase": { type: "boolean" },
-      git: { type: "boolean" },
-      "no-git": { type: "boolean" },
-      workflows: { type: "boolean" },
-      "no-workflows": { type: "boolean" },
-      "package-manager": { type: "string" }
-    }
-  });
-  if (values.help) {
-    console.log(help);
-    return;
-  }
-  if (values.version) {
-    console.log(version);
-    return;
-  }
-  const requestedManager = resolveManager(values["package-manager"]);
-  if (positionals[0] === "add") {
-    if (positionals[1] !== "workflows" && positionals[1] !== "ci") {
-      throw new Error(`unknown subcommand: add ${positionals[1] ?? ""}
-
-${help}`.trim());
-    }
-    if (positionals.length > 3) {
-      throw new Error(`expected at most one directory
-
-${help}`);
-    }
-    const result2 = addContinuousIntegration({
-      directory: positionals[2] ?? process.cwd(),
-      packageManager: requestedManager
-    });
-    console.log(`Added ${result2.files.join(" and ")} in ${result2.root}`);
-    return;
-  }
-  if (positionals.length !== 1) {
-    throw new Error(`expected exactly one destination directory
-
-${help}`);
-  }
-  const directory = positionals[0];
-  const game = basename(resolve(directory));
-  applicationId(directory);
-  const occupied = destinationProblem(directory);
-  if (occupied !== void 0) throw new Error(occupied);
-  greet();
-  const interactive = process.stdin.isTTY === true;
-  const missing = [];
-  const cancelled = () => {
-    ui.stop("Nothing was written.");
-    process.exitCode = 130;
-  };
-  const needsFlag = (flags, suggestion, fallback) => {
-    missing.push({ flags, suggestion });
-    return fallback;
-  };
-  const project = values["firebase-project"]?.trim();
-  if (project === "") throw new Error("--firebase-project needs a project id");
-  if (project !== void 0 && values["no-firebase"] === true) {
-    throw new Error("--firebase-project and --no-firebase contradict each other");
-  }
-  let firebase = false;
-  if (project !== void 0) {
-    firebase = project;
-  } else if (values["no-firebase"] !== true) {
-    const readiness = firebaseReadiness();
-    if (readiness.ready) {
-      if (interactive) firebase = true;
-      else firebase = needsFlag("--firebase-project <id>, or --no-firebase", "--no-firebase", false);
-    } else {
-      ui.warn(`Firebase is not set up on this machine:
-
-${firebaseReport(readiness.problems)}`);
-      if (!interactive) {
-        firebase = needsFlag("--no-firebase, to scaffold without it", "--no-firebase", false);
-      } else {
-        const carryOn = await askToScaffoldWithoutFirebase();
-        if (carryOn === null) return cancelled();
-        if (!carryOn) return stopForFirebase(readiness.problems);
-      }
-    }
-  }
-  let org;
-  if (values.org !== void 0) {
-    org = resolveOrg(values.org);
-  } else if (interactive) {
-    const answer = await askForOrg(game.replaceAll("-", "_"), firebase !== false);
-    if (answer === null) return cancelled();
-    org = answer;
-  } else {
-    org = needsFlag("--org <reverse-domain>", `--org ${DEFAULT_ORG}`, void 0);
-  }
-  let git = flagPair(values.git, values["no-git"], "git");
-  if (git === void 0 && insideWorkTree(directory)) git = true;
-  if (git === void 0) {
-    if (!interactive) git = needsFlag("--git or --no-git", "--git", true);
-    else {
-      const answer = await askForGit();
-      if (answer === null) return cancelled();
-      git = answer;
-    }
-  }
-  let workflows = flagPair(values.workflows, values["no-workflows"], "workflows");
-  if (workflows === void 0) {
-    if (!interactive) workflows = needsFlag("--workflows or --no-workflows", "--no-workflows", false);
-    else {
-      const answer = await askForWorkflows();
-      if (answer === null) return cancelled();
-      workflows = answer;
-    }
-  }
-  let manager = requestedManager ?? detectPackageManager();
-  if (manager === void 0) {
-    if (!interactive) manager = needsFlag("--package-manager <npm|pnpm>", "--package-manager pnpm", "pnpm");
-    else {
-      const answer = await askForPackageManager();
-      if (answer === null) return cancelled();
-      manager = answer;
-    }
-  }
-  if (missing.length > 0) throw new Error(unanswered(directory, missing));
-  ui.success(`applicationId ${color2.bold(applicationId(directory, org))}`);
-  const result = scaffoldGame({
-    directory,
-    org,
-    packageManager: manager,
-    ci: workflows,
-    git,
-    firebase,
-    reporter: clackReporter()
-  });
-  const { status, next, footnotes, headline } = summarise(result, manager, workflows);
-  for (const line of status) ui.success(line);
-  ui.block(next);
-  for (const line of footnotes) ui.info(line);
-  ui.close(headline);
+	const { values, positionals } = parseArgs({
+		args,
+		allowPositionals: true,
+		strict: true,
+		options: {
+			help: {
+				type: "boolean",
+				short: "h"
+			},
+			version: {
+				type: "boolean",
+				short: "v"
+			},
+			org: { type: "string" },
+			"firebase-project": { type: "string" },
+			"no-firebase": { type: "boolean" },
+			git: { type: "boolean" },
+			"no-git": { type: "boolean" },
+			workflows: { type: "boolean" },
+			"no-workflows": { type: "boolean" },
+			"package-manager": { type: "string" }
+		}
+	});
+	if (values.help) {
+		console.log(help);
+		return;
+	}
+	if (values.version) {
+		console.log(version);
+		return;
+	}
+	const requestedManager = resolveManager(values["package-manager"]);
+	if (positionals[0] === "add") {
+		if (positionals[1] !== "workflows" && positionals[1] !== "ci") throw new Error(`unknown subcommand: add ${positionals[1] ?? ""}\n\n${help}`.trim());
+		if (positionals.length > 3) throw new Error(`expected at most one directory\n\n${help}`);
+		const result = addContinuousIntegration({
+			directory: positionals[2] ?? process.cwd(),
+			packageManager: requestedManager
+		});
+		console.log(`Added ${result.files.join(" and ")} in ${result.root}`);
+		return;
+	}
+	if (positionals.length !== 1) throw new Error(`expected exactly one destination directory\n\n${help}`);
+	const directory = positionals[0];
+	const game = basename(resolve(directory));
+	applicationId(directory);
+	const occupied = destinationProblem(directory);
+	if (occupied !== void 0) throw new Error(occupied);
+	greet();
+	const interactive = process.stdin.isTTY === true;
+	const missing = [];
+	const cancelled = () => {
+		ui.stop("Nothing was written.");
+		process.exitCode = 130;
+	};
+	/**
+	* Records a question that could not be asked, and hands back the default it
+	* suggested. The value is never used, since `missing` throws before anything
+	* is written, but returning it keeps each answer definitely typed instead of
+	* carrying a `| undefined` all the way to the scaffold call.
+	*/
+	const needsFlag = (flags, suggestion, fallback) => {
+		missing.push({
+			flags,
+			suggestion
+		});
+		return fallback;
+	};
+	const project = values["firebase-project"]?.trim();
+	if (project === "") throw new Error("--firebase-project needs a project id");
+	if (project !== void 0 && values["no-firebase"] === true) throw new Error("--firebase-project and --no-firebase contradict each other");
+	let firebase = false;
+	if (project !== void 0) firebase = project;
+	else if (values["no-firebase"] !== true) {
+		const readiness = firebaseReadiness();
+		if (readiness.ready) {
+			if (interactive) firebase = true;
+			else firebase = needsFlag("--firebase-project <id>, or --no-firebase", "--no-firebase", false);
+		} else {
+			ui.warn(`Firebase is not set up on this machine:\n\n${firebaseReport(readiness.problems)}`);
+			if (!interactive) firebase = needsFlag("--no-firebase, to scaffold without it", "--no-firebase", false);
+			else {
+				const carryOn = await askToScaffoldWithoutFirebase();
+				if (carryOn === null) return cancelled();
+				if (!carryOn) return stopForFirebase(readiness.problems);
+			}
+		}
+	}
+	let org;
+	if (values.org !== void 0) org = resolveOrg(values.org);
+	else if (interactive) {
+		const answer = await askForOrg(game.replaceAll("-", "_"), firebase !== false);
+		if (answer === null) return cancelled();
+		org = answer;
+	} else org = needsFlag("--org <reverse-domain>", `--org ${DEFAULT_ORG}`, void 0);
+	let git = flagPair(values.git, values["no-git"], "git");
+	if (git === void 0 && insideWorkTree(directory)) git = true;
+	if (git === void 0) {
+		if (!interactive) git = needsFlag("--git or --no-git", "--git", true);
+		else {
+			const answer = await askForGit();
+			if (answer === null) return cancelled();
+			git = answer;
+		}
+	}
+	let workflows = flagPair(values.workflows, values["no-workflows"], "workflows");
+	if (workflows === void 0) {
+		if (!interactive) workflows = needsFlag("--workflows or --no-workflows", "--no-workflows", false);
+		else {
+			const answer = await askForWorkflows();
+			if (answer === null) return cancelled();
+			workflows = answer;
+		}
+	}
+	let manager = requestedManager ?? detectPackageManager();
+	if (manager === void 0) {
+		if (!interactive) manager = needsFlag("--package-manager <npm|pnpm>", "--package-manager pnpm", "pnpm");
+		else {
+			const answer = await askForPackageManager();
+			if (answer === null) return cancelled();
+			manager = answer;
+		}
+	}
+	if (missing.length > 0) throw new Error(unanswered(directory, missing));
+	ui.success(`applicationId ${color.bold(applicationId(directory, org))}`);
+	const { status, next, footnotes, headline } = summarise(scaffoldGame({
+		directory,
+		org,
+		packageManager: manager,
+		ci: workflows,
+		git,
+		firebase,
+		reporter: clackReporter()
+	}), manager, workflows);
+	for (const line of status) ui.success(line);
+	ui.block(next);
+	for (const line of footnotes) ui.info(line);
+	ui.close(headline);
 }
 try {
-  await main(process.argv.slice(2));
+	await main(process.argv.slice(2));
 } catch (error) {
-  const message = error instanceof Error ? error.message : String(error);
-  ui.stop(`create-eigen-game: ${message}`);
-  process.exitCode = 1;
+	const message = error instanceof Error ? error.message : String(error);
+	ui.stop(`create-eigen-game: ${message}`);
+	process.exitCode = 1;
 }
+//#endregion
+export {};
+
 //# sourceMappingURL=cli.js.map