@thi.ng/args 2.7.1 → 2.8.0

package/CHANGELOG.md

@@ -1,6 +1,6 @@
 # Change Log
 
-- **Last updated**: 2025-07-11T08:24:44Z
+- **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/README.md

@@ -18,6 +18,7 @@
 - [Status](#status)
 - [Installation](#installation)
 - [Dependencies](#dependencies)
+- [Projects using this package](#projects-using-this-package)
 - [API](#api)
   - [Basic usage](#basic-usage)
     - [Generate & display help](#generate--display-help)
@@ -71,7 +72,7 @@ For Node.js REPL:
 const args = await import("@thi.ng/args");
 ```
 
-Package sizes (brotli'd, pre-treeshake): ESM: 2.91 KB
+Package sizes (brotli'd, pre-treeshake): ESM: 2.99 KB
 
 ## Dependencies
 
@@ -84,6 +85,19 @@ Package sizes (brotli'd, pre-treeshake): ESM: 2.91 KB
 
 Note: @thi.ng/api is in _most_ cases a type-only import (not used at runtime)
 
+## Projects using this package
+
+- [@thi.ng/block-fs](https://thi.ng/block-fs): Customizable block-based storage,
+  adapters & file system layer
+- [@thi.ng/meta-css](https://thi.ng/meta-css): Data-driven CSS framework
+  codegen, transpiler & bundler
+- [@thi.ng/pointfree-lang](https://thi.ng/pointfree-lang): Forth style syntax
+  layer/compiler & CLI for the [@thi.ng/pointfree](https://thi.ng/pointfree) DSL
+- [@thi.ng/tangle](https://thi.ng/tangle): Literate programming code block
+  tangling / codegen utility, inspired by org-mode & noweb
+- [@thi.ng/wasm-api-bindgen](https://thi.ng/wasm-api-bindgen): Polyglot bindings
+  code generators (TS/JS, Zig, C11) for hybrid WebAssembly projects
+
 ## API
 
 [Generated API docs](https://docs.thi.ng/umbrella/args/)

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.1",
+  "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": "cc6ab918acdac66990d04d6751d19c573a09730d\n"
+  "gitHead": "a157f18f16200faad01e15da553c9eea3fa37014\n"
 }