linegauge 0.5.0 → 0.5.1

package/README.md

@@ -169,7 +169,7 @@ its own suite — which this package passes. The runner reports that as a failur
 to the incumbent an unexpected pass means a stale annotation; it is counted here as the
 pass it is, and marked rather than left to look like the ones beside it.
 
-Weight, installed and tree-inclusive: **84,596 bytes** against **194,329** for the incumbents it replaces — a ratio of **0.4353**.
+Weight, installed and tree-inclusive: **85,473 bytes** against **194,329** for the incumbents it replaces — a ratio of **0.4398**.
 ## Where it sits
 
 Plugins register under the `widths` key, against the one schema the whole family shares.

package/dist/check.js

@@ -1,3 +1,4 @@
+import { readFileSync } from 'node:fs';
 import { resolve } from 'node:path';
 import { pathToFileURL } from 'node:url';
 import { overrides, PluginError, register, setOverrides, validate } from './plugin.js';
@@ -5,6 +6,33 @@ import { width } from './width.js';
 export const EXIT_OK = 0;
 export const EXIT_RUNTIME = 1;
 export const EXIT_USAGE = 2;
+const USAGE = 'usage: linegauge check <plugin-file>\n';
+const HELP = `${USAGE}
+Load a plugin file, validate it against the family schema, register it, and report what
+linegauge does with it. Exit 0 when it contributes, 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;
+}
 function refuse(code, message, fix, write) {
     write(`${code}: ${message}\n  fix: ${fix}\n`);
     return EXIT_RUNTIME;
@@ -29,11 +57,9 @@ export async function check(argv, write) {
     }
 }
 async function inspect(argv, write) {
-    const file = argv[0];
-    if (file === undefined) {
-        write('usage: linegauge check <plugin-file>\n');
-        return EXIT_USAGE;
-    }
+    const file = target(argv[0], write);
+    if (typeof file === 'number')
+        return file;
     const loaded = (await import(pathToFileURL(resolve(file)).href));
     const plugin = loaded.default ?? loaded;
     for (const registered of [...overrides().keys()])

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "linegauge",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "description": "A printer's line gauge \u2014 the steel rule marked in picas and points. Measuring, wrapping, truncating and slicing styled terminal text without the edge fraying \u2014 grapheme-correct over Intl.Segmenter. Drop-in paths for string-width, wrap-ansi, strip-ansi and slice-ansi. Zero dependencies.",
   "license": "MIT",
   "type": "module",