@thi.ng/args 2.7.2 → 2.8.0

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2025-07-11T22:07:07Z
+- **Last updated**: 2025-07-12T13:21:04Z
 - **Generator**: [thi.ng/monopub](https://thi.ng/monopub)
 
 All notable changes to this project will be documented in this file.
@@ -11,6 +11,13 @@ 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.8.0](https://github.com/thi-ng/umbrella/tree/@thi.ng/args@2.8.0) (2025-07-12)
+
+#### 🚀 Features
+
+- update `Command`, support min/max input ranges ([471543e](https://github.com/thi-ng/umbrella/commit/471543e))
+  - update cliApp() input checks & error messages
+
 ### [2.7.1](https://github.com/thi-ng/umbrella/tree/@thi.ng/args@2.7.1) (2025-07-11)
 
 #### 🩹 Bug fixes

package/api.d.ts

@@ -238,9 +238,10 @@ export interface Command<OPTS extends BASE, BASE extends object, CTX extends Com
     opts: Args<Omit<OPTS, keyof BASE>>;
     /**
      * Number of required rest input value (after all parsed options). Leave
-     * unset to allow any number.
+     * unset to allow any number. If given as tuple, the values are interpreted
+     * as acceptable `[min,max]` range.
      */
-    inputs?: number;
+    inputs?: number | [number, number];
     /**
      * Actual command function/implementation.
      */

package/cli.js

@@ -10,6 +10,7 @@ import {
   __padRightAnsi,
   __wrapWithIndent
 } from "./utils.js";
+import { isArray } from "@thi.ng/checks/is-array";
 const cliApp = async (config) => {
   const argv = config.argv || process.argv;
   const isColor = !process.env.NO_COLOR;
@@ -46,9 +47,21 @@ const cliApp = async (config) => {
       process.exit(1);
     }
     if (!parsed) process.exit(0);
-    if (cmd.inputs !== void 0 && cmd.inputs !== parsed.rest.length) {
-      __printError(`expected ${cmd.inputs || 0} input(s)`, theme);
-      __usageAndExit(config, usageOpts);
+    if (cmd.inputs !== void 0) {
+      const num = parsed.rest.length;
+      let err;
+      if (isArray(cmd.inputs)) {
+        const [min, max] = cmd.inputs;
+        if (num < min || num > max) {
+          err = max < Infinity ? `expected ${min}-${max} inputs` : `expected at least ${min} inputs`;
+        }
+      } else if (num !== cmd.inputs) {
+        err = `expected ${cmd.inputs} input(s)`;
+      }
+      if (err) {
+        __printError(err, theme);
+        __usageAndExit(config, usageOpts);
+      }
     }
     const ctx = await config.ctx(
       {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@thi.ng/args",
-  "version": "2.7.2",
+  "version": "2.8.0",
   "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": "186d38b07f4ba940a8127cbe2379a38036eff387\n"
+  "gitHead": "a157f18f16200faad01e15da553c9eea3fa37014\n"
 }