flagstaff 0.4.0 → 0.4.1

package/dist/cli.js

@@ -1,4 +1,5 @@
 #!/usr/bin/env node
+import { readFileSync } from 'node:fs';
 import { resolve } from 'node:path';
 import { pathToFileURL } from 'node:url';
 import { hoist, manualClock } from './loop.js';
@@ -77,12 +78,37 @@ function describe(value) {
         return '(not serializable — shown as given)';
     }
 }
-async function main(argv, write) {
-    const file = argv[0];
-    if (file === undefined) {
-        write('usage: flagstaff check <plugin-file>\n');
+const USAGE = 'usage: flagstaff check <plugin-file>\n';
+const HELP = `${USAGE}
+Load a plugin file, validate it against the family schema, and render every contribution in
+all five output modes side by side. Exit 0 when it renders, 1 on a refusal (with a code and
+a fix), 2 on a usage error.
+
+  -h, --help     show this help
+  -V, --version  print the version
+`;
+function version() {
+    return JSON.parse(readFileSync(new URL('../package.json', import.meta.url), 'utf8')).version;
+}
+function target(arg, write) {
+    if (arg === '--help' || arg === '-h') {
+        write(HELP);
+        return EXIT_OK;
+    }
+    if (arg === '--version' || arg === '-V') {
+        write(`${version()}\n`);
+        return EXIT_OK;
+    }
+    if (arg === undefined || arg.startsWith('-')) {
+        write(arg === undefined ? USAGE : `unknown option ${arg}\n${USAGE}`);
         return EXIT_USAGE;
     }
+    return arg;
+}
+async function main(argv, write) {
+    const file = target(argv[0], write);
+    if (typeof file === 'number')
+        return file;
     const before = new Set(registered().plugins);
     const loaded = (await import(pathToFileURL(resolve(file)).href));
     const plugin = loaded.default ?? loaded;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "flagstaff",
-  "version": "0.4.0",
+  "version": "0.4.1",
   "description": "The staff the flag flies from. A terminal frame loop with a static projection for agents and screen readers, and a plugin host for spinners, progress, boxes and tables. Drop-in paths for ora, log-update, boxen and cli-table3. No dependency outside the burgee family.",
   "license": "MIT",
   "type": "module",
@@ -121,10 +121,10 @@
     "json"
   ],
   "dependencies": {
-    "closeout": "^0.5.0",
-    "linegauge": "^0.5.0",
-    "paratext": "^0.6.0",
-    "roundel": "^0.5.0"
+    "closeout": "^0.5.1",
+    "linegauge": "^0.5.1",
+    "paratext": "^0.6.1",
+    "roundel": "^0.5.1"
   },
   "devDependencies": {
     "fast-check": "^4.10.1",