roundel 0.5.0 → 0.5.1

package/dist/check.js

@@ -1,9 +1,37 @@
+import { readFileSync } from 'node:fs';
 import { resolve } from 'node:path';
 import { pathToFileURL } from 'node:url';
 import { contributions, PluginError, register, reset, validate } from './plugin.js';
 export const EXIT_OK = 0;
 export const EXIT_RUNTIME = 1;
 export const EXIT_USAGE = 2;
+const USAGE = 'usage: roundel check <plugin-file>\n';
+const HELP = `${USAGE}
+Load a plugin file, validate it against the family schema, register it, and report what
+roundel 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;
@@ -20,11 +48,9 @@ export async function check(argv, write) {
     }
 }
 async function inspect(argv, write) {
-    const file = argv[0];
-    if (file === undefined) {
-        write('usage: roundel 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;
     reset();

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "roundel",
-  "version": "0.5.0",
+  "version": "0.5.1",
   "description": "The colours a CLI carries. One output policy, semantic tokens, a theme, and a chalk migration path lighter than chalk. Zero dependencies.",
   "license": "MIT",
   "type": "module",