@scm-js/cli 0.8.9 → 0.8.10

package/dist/THIRD-PARTY-NOTICES.txt

@@ -1,4 +1,4 @@
-Third-party notices for scmjs 0.8.9
+Third-party notices for scmjs 0.8.10
 
 scmjs is MIT-licensed (LICENSE). It is built into one file from scmJS's own code and the
 packages below, whose license texts this file carries. Who wrote what, and where the

package/dist/scmjs.mjs

@@ -6856,13 +6856,44 @@ document.getElementById("go").onclick = go;
 }
 //#endregion
 //#region cli/src/about.ts
-/** `scmjs about`: this build, who made it, the machine it runs on, the desktop app and Docker, and where everything is. */
-var VERSION = "0.8.9";
-var COMMIT = "0469680";
+/** `scmjs about`: this build and whether npm has a newer one, who made it, the machine it runs on, the desktop app and Docker, and where everything is. */
+var VERSION = "0.8.10";
+var COMMIT = "6cf22f8";
 var BUILT = "2026-11-06";
-function aboutReport() {
+var PACKAGE = "@scm-js/cli";
+/** a < b, for x.y.z versions (a prerelease or build suffix is ignored). */
+function olderThan(a, b) {
+	const n = (v) => v.split(/[-+]/)[0].split(".").map((x) => Number(x) || 0);
+	const [x, y] = [n(a), n(b)];
+	for (let i = 0; i < 3; i++) if ((x[i] ?? 0) !== (y[i] ?? 0)) return (x[i] ?? 0) < (y[i] ?? 0);
+	return false;
+}
+/** The newest version on npm, or null when npm could not be asked (offline, slow): two seconds at most. */
+async function newestVersion() {
+	try {
+		const res = await fetch(`https://registry.npmjs.org/${PACKAGE}/latest`, {
+			signal: AbortSignal.timeout(2e3),
+			headers: { accept: "application/json" }
+		});
+		if (!res.ok) return null;
+		const v = (await res.json()).version;
+		return typeof v === "string" ? v : null;
+	} catch {
+		return null;
+	}
+}
+/** About's "Newest" row: the update to install, this one, or what npm has when this is newer (a build from a clone). */
+function newestLine(version, latest) {
+	if (latest === null) return import_picocolors.default.dim("could not ask npm");
+	if (olderThan(version, latest)) return `${import_picocolors.default.yellow(latest)}${dot}npm install -g ${PACKAGE}@latest`;
+	return import_picocolors.default.dim(latest === version ? "this one" : `${latest} on npm`);
+}
+async function aboutReport() {
+	const latest = await newestVersion();
 	return {
 		version: VERSION,
+		latest,
+		outdated: latest !== null && olderThan("0.8.10", latest),
 		commit: COMMIT,
 		built: BUILT,
 		node: process.version,
@@ -6902,6 +6933,7 @@ function printAbout(r) {
 				r.commit && `commit ${r.commit}`,
 				r.built && `built ${r.built}`
 			].filter(Boolean).join(dot)],
+			["Newest", newestLine(r.version, r.latest)],
 			["Node", `${r.node}${dot}${r.platform}`],
 			["Desktop app", r.desktopApp ?? import_picocolors.default.dim("not found (scmjs … open uses the browser)")],
 			["Docker", r.docker ? `${r.docker}` : import_picocolors.default.dim("not found (scmjs bot needs it)")],
@@ -16215,12 +16247,16 @@ for (const stream of [process.stdout, process.stderr]) stream.on("error", (e) =>
 	if (e.code === "EPIPE") process.exit(process.exitCode ?? 0);
 	else throw e;
 });
-var program = new Command$1("scmjs").description("StarCraft: Brood War maps, replays, plugins and bots from the command line").version(VERSION, "-v, --version", "print the version").helpOption("-h, --help", "show help for a command").addOption(new Option("--no-color", "plain text, no colour (also NO_COLOR=1)")).showSuggestionAfterError().helpCommand("help [command]", "show help for a command").configureOutput({ outputError: (text, write) => write(text.replace(/^error: /, `${mark.error} `)) }).showHelpAfterError(import_picocolors.default.dim("(scmjs --help lists the commands)")).configureHelp({
+var program = new Command$1("scmjs").description("StarCraft: Brood War maps, replays, plugins and bots from the command line").version(VERSION, "-v, --version", "print the version").helpOption("-h, --help", "show help for a command").addOption(new Option("--no-color", "plain text, no colour (also NO_COLOR=1)")).showSuggestionAfterError().commandsGroup("This tool:").helpCommand("help [command]", "show help for a command").configureOutput({ outputError: (text, write) => write(text.replace(/^error: /, `${mark.error} `)) }).showHelpAfterError(import_picocolors.default.dim("(scmjs --help lists the commands)")).configureHelp({
 	styleTitle: (s) => import_picocolors.default.bold(s),
 	styleCommandText: (s) => import_picocolors.default.cyan(s),
 	styleSubcommandText: (s) => import_picocolors.default.cyan(s),
 	styleArgumentText: (s) => import_picocolors.default.yellow(s),
-	styleOptionText: (s) => import_picocolors.default.green(s)
+	styleOptionText: (s) => import_picocolors.default.green(s),
+	subcommandTerm: (cmd) => {
+		const subs = cmd.commands.map((c) => c.name()).filter((n) => n !== "help");
+		return subs.length ? `${cmd.name()} ${subs.join("|")}` : new Help$1().subcommandTerm(cmd).replace(" [options]", "");
+	}
 }).addHelpText("after", () => `
 ${import_picocolors.default.bold("Examples:")}
   ${import_picocolors.default.dim("$")} scmjs info "(2)Destination.scx"       what a map or a replay holds
@@ -16231,15 +16267,11 @@ ${import_picocolors.default.bold("Examples:")}
   ${import_picocolors.default.dim("$")} scmjs about                           this version, and where things are
 
 ${import_picocolors.default.dim("Docs: https://docs.scmjs.dev")}`);
-program.command("about").description("this version of scmjs, and where things are").addOption(json).action((o) => {
-	const r = aboutReport();
-	print(...o.json ? [JSON.stringify(r, null, 2)] : printAbout(r));
-});
-program.command("info").description("what a map, replay or bot file holds").argument("<files...>", "maps (.scm .scx .chk), replays (.rep) or bots (.scmbot)").addOption(json).action(async (files, o) => void await eachFile(files, !!o.json, async (input) => {
+program.command("info").description("what a map, replay or bot file holds").helpGroup("Maps and replays:").argument("<files...>", "maps (.scm .scx .chk), replays (.rep) or bots (.scmbot)").addOption(json).action(async (files, o) => void await eachFile(files, !!o.json, async (input) => {
 	const kind = expectKind(input, "map", "replay", "bot");
 	return kind === "map" ? mapInfo(input) : kind === "replay" ? replayInfo(input) : botInfo(input);
 }));
-var map = program.command("map").description("read, check and open maps");
+var map = program.command("map").description("read, check and open maps").helpGroup("Maps and replays:");
 map.command("info").description("a map's size, players, units, triggers and its check").argument("<maps...>").addOption(json).action(async (files, o) => void await eachFile(files, !!o.json, mapInfo));
 map.command("check").description("Check Map, as the editor's: errors, then warnings").argument("<maps...>").addOption(json).option("--all", "list notes too, not only errors and warnings").option("--strict", "fail on warnings as well as errors").addHelpText("after", `\nExits 1 when a map has errors (or warnings, with --strict): fit for a CI step.`).action(async (files, o) => {
 	const reports = await eachFile(files, !!o.json, async (input) => {
@@ -16266,14 +16298,14 @@ map.command("open").description("open a map in the scmJS app, or the editor in y
 	expectKind(input, "map");
 	await openInScmjs(input, o);
 });
-var replay = program.command("replay").description("read and open replays");
+var replay = program.command("replay").description("read and open replays").helpGroup("Maps and replays:");
 replay.command("info").description("who played, on what map, for how long, at what APM").argument("<replays...>").addOption(json).action(async (files, o) => void await eachFile(files, !!o.json, replayInfo));
 replay.command("open").description("watch a replay in the scmJS app, or the editor in your browser").argument("<replay>").option("--browser", "the editor in the browser, even with the app installed").addOption(new Option("--editor <url>", "the editor's address (SCMJS_EDITOR_URL)").hideHelp()).action(async (file, o) => {
 	const input = await readInput(file);
 	expectKind(input, "replay");
 	await openInScmjs(input, o);
 });
-var plugin = program.command("plugin").description("write a plugin for the editor: start one, check it, run it");
+var plugin = program.command("plugin").description("start, check and run a plugin for the editor").helpGroup("Plugins and bots:");
 plugin.command("new").description("a plugin to start from, in a new folder").argument("[name]", "the plugin's name, such as \"Base Check\"").option("--dir <folder>", "the folder to write it in (default plugin-<id>)").action((name, o) => {
 	const made = newPlugin({
 		name,
@@ -16297,7 +16329,7 @@ plugin.command("dev").description("the editor with your plugin, reloaded on ever
 		editor: o.editor
 	});
 });
-var bot = program.command("bot").description("build your own BWAPI bot for scmjs.dev/play (needs Docker)").addHelpText("after", () => `
+var bot = program.command("bot").description("build a BWAPI bot for scmjs.dev/play (Docker)").helpGroup("Plugins and bots:").addHelpText("after", () => `
 Run these in your bot's folder. The toolchain is a Docker image, downloaded the first time.
 A built bot is added on the play page: Options → Community bots → Add a bot from a file…
 
@@ -16314,8 +16346,13 @@ bot.command("build").description("out/<key>.scmbot, to add on the play page").ac
 bot.command("update").description("the newest toolchain, the one the play page expects").action(async () => {
 	await updateBot();
 });
+program.command("about").description("this version, any newer one, and links").helpGroup("This tool:").addOption(json).action(async (o) => {
+	const r = await aboutReport();
+	print(...o.json ? [JSON.stringify(r, null, 2)] : printAbout(r));
+});
 try {
-	await program.parseAsync();
+	if (process.argv.length <= 2) program.outputHelp();
+	else await program.parseAsync();
 } catch (e) {
 	if (e instanceof CliError) {
 		fail(e);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@scm-js/cli",
-  "version": "0.8.9",
+  "version": "0.8.10",
   "description": "StarCraft: Brood War maps, replays and bots from the command line: what a map or replay holds, Check Map, opening them in scmJS, and building a BWAPI bot for the play page",
   "keywords": [
     "starcraft",