@scm-js/cli 0.8.10 → 0.8.11

package/dist/THIRD-PARTY-NOTICES.txt

@@ -1,4 +1,4 @@
-Third-party notices for scmjs 0.8.10
+Third-party notices for scmjs 0.8.11
 
 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

@@ -6857,8 +6857,8 @@ document.getElementById("go").onclick = go;
 //#endregion
 //#region cli/src/about.ts
 /** `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 VERSION = "0.8.11";
+var COMMIT = "71d8282";
 var BUILT = "2026-11-06";
 var PACKAGE = "@scm-js/cli";
 /** a < b, for x.y.z versions (a prerelease or build suffix is ignored). */
@@ -6893,7 +6893,7 @@ async function aboutReport() {
 	return {
 		version: VERSION,
 		latest,
-		outdated: latest !== null && olderThan("0.8.10", latest),
+		outdated: latest !== null && olderThan("0.8.11", latest),
 		commit: COMMIT,
 		built: BUILT,
 		node: process.version,
@@ -6953,6 +6953,68 @@ function printAbout(r) {
 	];
 }
 //#endregion
+//#region cli/src/banner.ts
+/**
+* The app mark, the wireframe globe of `public/favicon.svg` and the splash screen, in braille (2 × 4 dots a
+* character): the splash's sphere (`src/components/splash/starfield.ts`) with 6 rings and 8 segments, turned 0.3 rad
+* about y and −0.45 about x, its near half and its outline, on 32 × 32 dots.
+*/
+var GLOBE = [
+	"   ⣠⡴⢶⡿⣿⢿⢿⣲⢦⣄   ",
+	" ⣠⠞⣡⠟⠯⢤⡧⠬⢷⡴⠛⠮⡳⣄ ",
+	"⢰⢳⡼⠁  ⡞   ⢣  ⣘⣾⡆",
+	"⡇⡼⠉⠙⠒⢦⠧⠤⠤⠤⠼⡖⠋⠁⠘⣾",
+	"⡷⣇   ⢸     ⢧  ⣠⣿",
+	"⠸⣏⠙⠒⠦⢼⠤⠤⠤⠤⠤⢼⠒⠋⢡⠇",
+	" ⠙⢦⣀⡀⢸     ⣞⣀⡴⠋ ",
+	"   ⠙⠻⠭⣯⣓⣒⣫⠽⠟⠋   "
+];
+/** The same globe in ASCII, for a console without braille (the old Windows one, where ui.ts's marks fall back too). */
+var GLOBE_ASCII = [
+	"     .-'''-.     ",
+	"   .'/  |  \\'.   ",
+	"  /-+---+---+-\\  ",
+	" |  |   |   |  | ",
+	" |==+===+===+==| ",
+	"  \\-+---+---+-/  ",
+	"   '.\\  |  /.'   ",
+	"     '-...-'     "
+];
+/** The logo's violet (#a06cf0), or the terminal's magenta without 24-bit colour. */
+var violet = (s) => truecolor ? rgb("#a06cf0", s) : import_picocolors.default.magenta(s);
+/**
+* `text` beside the globe, centred on its height; the text alone when the terminal is narrower than both. `width` is
+* the terminal's (80 when it is not one).
+*/
+function banner(text, { width = 80, ascii = !unicode } = {}) {
+	const art = ascii ? GLOBE_ASCII : GLOBE;
+	const artWidth = Math.max(...art.map((l) => l.length));
+	const indent = "  ", gap = "   ";
+	if (2 + artWidth + 3 + Math.max(...text.map((l) => visible(l).length)) > width) return text;
+	const top = Math.max(0, Math.floor((art.length - text.length) / 2));
+	return art.map((l, i) => text[i - top] ? `${indent}${violet(l.padEnd(artWidth))}${gap}${text[i - top]}` : `${indent}${violet(l.trimEnd())}`);
+}
+/** The overview, in place of commander's: the banner, the command groups as commander lays them out, the options. */
+function rootHelp(cmd, helper, version, opts = {}) {
+	const termWidth = helper.padWidth(cmd, helper);
+	const out = banner([
+		`${import_picocolors.default.bold(import_picocolors.default.cyan(cmd.name()))} ${import_picocolors.default.bold(version)}`,
+		"scmJS on the command line",
+		import_picocolors.default.dim("StarCraft: Brood War maps, replays, plugins and bots"),
+		"",
+		`${helper.styleTitle("Usage:")} ${helper.styleUsage(helper.commandUsage(cmd))}`,
+		`${helper.styleTitle("Docs:")}  ${import_picocolors.default.cyan("https://docs.scmjs.dev")}`
+	], {
+		width: helper.helpWidth ?? 80,
+		...opts
+	});
+	out.push("");
+	const groups = helper.groupItems([...cmd.commands], helper.visibleCommands(cmd), (sub) => sub.helpGroup() || "Commands:");
+	for (const [heading, commands] of groups) out.push(...helper.formatItemList(heading, commands.map((sub) => helper.formatItem(helper.styleSubcommandTerm(helper.subcommandTerm(sub)), termWidth, helper.styleSubcommandDescription(helper.subcommandDescription(sub)), helper)), helper));
+	out.push(`${helper.styleTitle("Options:")} ${helper.visibleOptions(cmd).map((o) => helper.styleOptionTerm(helper.optionTerm(o))).join("   ")}`, "");
+	return out.join("\n");
+}
+//#endregion
 //#region src/formats/chk/binary.ts
 /** Little-endian readers/writers over a Uint8Array. StarCraft data is LE throughout. */
 var Reader$1 = class {
@@ -13008,10 +13070,18 @@ async function restoreBuiltMap(chk, extras) {
 	};
 }
 //#endregion
-//#region src/services/mapIo.ts
-/** Read a picked or dropped file into a parsed document. */
-async function openMapFile(file, handle = null) {
-	const loaded = await loadMap(new Uint8Array(await file.arrayBuffer()));
+//#region src/editor/mapFile.ts
+/**
+* A map file as bytes, in and out — the half of opening and saving that needs no browser.
+*
+* `openMapBytes` is what File ▸ Open, a drop, the command line and `@scm-js/core` all run:
+* the archive read, the scenario parsed, the other members kept, a built map restored to the
+* map it was built from, and the warnings the editor would show. `writeMapBytes` is the
+* reverse. The pickers, handles and downloads around them are `services/mapIo.ts`.
+*/
+/** Read a map file's bytes (.scm, .scx or a bare .chk) into a parsed scenario and the rest of its archive. */
+async function openMapBytes(bytes, fileName) {
+	const loaded = await loadMap(bytes);
 	const problems = [];
 	let members = {
 		extras: /* @__PURE__ */ new Map(),
@@ -13057,8 +13127,7 @@ async function openMapFile(file, handle = null) {
 		scenario,
 		extras,
 		stored,
-		fileName: file.name,
-		handle,
+		fileName,
 		origin: loaded.scenarioInfo,
 		builtBy
 	};
@@ -13709,7 +13778,7 @@ function kindOf(name, bytes) {
 }
 async function loadMapInput(input) {
 	try {
-		return await openMapFile(new File([input.bytes], input.name));
+		return await openMapBytes(input.bytes, input.name);
 	} catch (e) {
 		throw new CliError(`${input.name} is not a map this can read: ${e instanceof Error ? e.message : e}`);
 	}
@@ -16256,17 +16325,9 @@ var program = new Command$1("scmjs").description("StarCraft: Brood War maps, rep
 	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
-  ${import_picocolors.default.dim("$")} scmjs map check *.scx                 Check Map on every map here
-  ${import_picocolors.default.dim("$")} scmjs replay open game.rep            watch it in the editor
-  ${import_picocolors.default.dim("$")} scmjs plugin new "Base Check"         a plugin for the editor to start from
-  ${import_picocolors.default.dim("$")} scmjs bot new                         a BWAPI bot to start from, for scmjs.dev/play
-  ${import_picocolors.default.dim("$")} scmjs about                           this version, and where things are
-
-${import_picocolors.default.dim("Docs: https://docs.scmjs.dev")}`);
+	},
+	formatHelp: (cmd, helper) => cmd.parent ? Help$1.prototype.formatHelp.call(helper, cmd, helper) : rootHelp(cmd, helper, VERSION)
+});
 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);
@@ -16350,7 +16411,7 @@ program.command("about").description("this version, any newer one, and links").h
 	const r = await aboutReport();
 	print(...o.json ? [JSON.stringify(r, null, 2)] : printAbout(r));
 });
-try {
+if (!process.env.VITEST) try {
 	if (process.argv.length <= 2) program.outputHelp();
 	else await program.parseAsync();
 } catch (e) {
@@ -16363,4 +16424,4 @@ try {
 	}
 }
 //#endregion
-export {};
+export { program };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@scm-js/cli",
-  "version": "0.8.10",
+  "version": "0.8.11",
   "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",