@thi.ng/args 2.5.0 → 2.6.1

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2025-06-27T13:16:16Z
+- **Last updated**: 2025-07-02T09:55:21Z
 - **Generator**: [thi.ng/monopub](https://thi.ng/monopub)
 
 All notable changes to this project will be documented in this file.
@@ -11,6 +11,12 @@ See [Conventional Commits](https://conventionalcommits.org/) for commit guidelin
 **Note:** Unlisted _patch_ versions only involve non-code or otherwise excluded changes
 and/or version bumps of transitive dependencies.
 
+## [2.6.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/args@2.6.0) (2025-06-28)
+
+#### 🚀 Features
+
+- emit colorized error messages in cliApp() ([36f66b6](https://github.com/thi-ng/umbrella/commit/36f66b6))
+
 ## [2.5.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/args@2.5.0) (2025-06-27)
 
 #### 🚀 Features

package/README.md

@@ -71,7 +71,7 @@ For Node.js REPL:
 const args = await import("@thi.ng/args");
 ```
 
-Package sizes (brotli'd, pre-treeshake): ESM: 2.80 KB
+Package sizes (brotli'd, pre-treeshake): ESM: 2.91 KB
 
 ## Dependencies
 

package/cli.js

@@ -12,6 +12,7 @@ import {
 const cliApp = async (config) => {
   const argv = config.argv || process.argv;
   const isColor = !process.env.NO_COLOR;
+  const format = isColor ? PRESET_ANSI16 : PRESET_NONE;
   const usageOpts = {
     prefix: "",
     color: isColor,
@@ -28,23 +29,28 @@ const cliApp = async (config) => {
     } else {
       cmdID = argv[start];
       cmd = config.commands[cmdID];
-      usageOpts.prefix += __descriptions(config.commands, usageOpts);
-      if (!cmd) __usageAndExit(config, usageOpts);
+      if (!cmd) {
+        usageOpts.prefix += __descriptions(config.commands, usageOpts);
+        __usageAndExit(config, usageOpts);
+      }
       start++;
     }
     let parsed;
     try {
       parsed = parse({ ...config.opts, ...cmd.opts }, argv, {
-        showUsage: true,
+        showUsage: false,
         usageOpts,
         start
       });
-    } catch (_) {
+    } catch (e) {
+      __printError(e.message, format);
+    }
+    if (!parsed) {
+      __usageAndExit(config, usageOpts);
+      process.exit(1);
     }
-    if (!parsed) process.exit(1);
     if (cmd.inputs !== void 0 && cmd.inputs !== parsed.rest.length) {
-      process.stderr.write(`expected ${cmd.inputs || 0} input(s)
-`);
+      __printError(`expected ${cmd.inputs || 0} input(s)`, format);
       __usageAndExit(config, usageOpts);
     }
     const ctx = await config.ctx(
@@ -59,7 +65,7 @@ const cliApp = async (config) => {
     await cmd.fn(ctx);
     if (config.post) await config.post(ctx, cmd);
   } catch (e) {
-    process.stderr.write(e.message + "\n\n");
+    __printError(e.message, format);
     process.exit(1);
   }
 };
@@ -86,6 +92,7 @@ const __descriptions = (commands, { color, lineWidth = 80 } = {}) => {
     "\n"
   ].join("\n");
 };
+const __printError = (msg, fmt) => process.stderr.write(fmt.red(msg) + "\n\n");
 export {
   cliApp
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/args",
-  "version": "2.5.0",
+  "version": "2.6.1",
   "description": "Declarative, functional CLI argument/options parser, value coercions, sub-commands etc.",
   "type": "module",
   "module": "./index.js",
@@ -110,5 +110,5 @@
     "tag": "cli",
     "year": 2018
   },
-  "gitHead": "71294b20c04b6ee35db08d30b43b292b07af0d1b\n"
+  "gitHead": "eb3ac07d044559d88b4871fed080929556de1b7c\n"
 }