@rickosborne/clamp 2025.1.7

package/package.json

@@ -0,0 +1,51 @@
+{
+	"author": {
+		"name": "Rick Osborne",
+		"url": "https://rickosborne.org"
+	},
+	"dependencies": {
+		"@rickosborne/foundation": "2025.1.7",
+		"@rickosborne/guard": "2025.1.7",
+		"@rickosborne/term": "2025.1.7",
+		"@rickosborne/typical": "2025.1.7"
+	},
+	"description": "Rick Osborne's command-line parameter handling tools",
+	"engines": {
+		"node": ">=14"
+	},
+	"exports": {
+		".": {
+			"types": "./types/index.d.ts",
+			"import": "./esm/index.js",
+			"require": "./cjs/index.js",
+			"default": "./esm/index.js"
+		}
+	},
+	"homepage": "https://github.com/rickosborne/es-js-ts",
+	"keywords": [
+		"typescript",
+		"files",
+		"terminal",
+		"console",
+		"command-line",
+		"arguments",
+		"parameters"
+	],
+	"license": "CC-BY-NC-SA-4.0",
+	"main": "cjs/index.js",
+	"module": "esm/index.js",
+	"name": "@rickosborne/clamp",
+	"private": false,
+	"publishConfig": {
+		"access": "public"
+	},
+	"readme": "README.md",
+	"repository": {
+		"directory": "clamp",
+		"type": "git",
+		"url": "git+https://github.com/rickosborne/es-js-ts.git"
+	},
+	"types": "types/index.d.ts",
+	"typings": "types/index.d.ts",
+	"version": "2025.1.7"
+}

package/tsdoc-metadata.json

@@ -0,0 +1,11 @@
+// This file is read by tools that parse documentation comments conforming to the TSDoc standard.
+// It should be published with your NPM package.  It should not be tracked by Git.
+{
+  "tsdocVersion": "0.12",
+  "toolPackages": [
+    {
+      "packageName": "@microsoft/api-extractor",
+      "packageVersion": "7.48.1"
+    }
+  ]
+}

package/types/index.d.ts

@@ -0,0 +1,11 @@
+export * from "./ts/boolean-param.js";
+export * from "./ts/command-params.js";
+export * from "./ts/common.js";
+export * from "./ts/date-param.js";
+export * from "./ts/file-param.js";
+export * from "./ts/help-for-param.js";
+export * from "./ts/label-for-param.js";
+export * from "./ts/number-param.js";
+export * from "./ts/param-handler.js";
+export * from "./ts/string-param.js";
+//# sourceMappingURL=index.d.ts.map

package/types/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../index.ts"],"names":[],"mappings":"AAAA,cAAc,uBAAuB,CAAC;AACtC,cAAc,wBAAwB,CAAC;AACvC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,oBAAoB,CAAC;AACnC,cAAc,oBAAoB,CAAC;AACnC,cAAc,wBAAwB,CAAC;AACvC,cAAc,yBAAyB,CAAC;AACxC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,sBAAsB,CAAC"}

package/types/index.js

@@ -0,0 +1,27 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./ts/boolean-param.js"), exports);
+__exportStar(require("./ts/command-params.js"), exports);
+__exportStar(require("./ts/common.js"), exports);
+__exportStar(require("./ts/date-param.js"), exports);
+__exportStar(require("./ts/file-param.js"), exports);
+__exportStar(require("./ts/help-for-param.js"), exports);
+__exportStar(require("./ts/label-for-param.js"), exports);
+__exportStar(require("./ts/number-param.js"), exports);
+__exportStar(require("./ts/param-handler.js"), exports);
+__exportStar(require("./ts/string-param.js"), exports);
+//# sourceMappingURL=index.js.map

package/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;AAAA,wDAAsC;AACtC,yDAAuC;AACvC,iDAA+B;AAC/B,qDAAmC;AACnC,qDAAmC;AACnC,yDAAuC;AACvC,0DAAwC;AACxC,uDAAqC;AACrC,wDAAsC;AACtC,uDAAqC"}

package/types/ts/boolean-param.d.ts

@@ -0,0 +1,50 @@
+import type { CommandParamBase, ParamHandler } from "./common.js";
+/**
+ * Default possible values for true.
+ * @internal
+ */
+export declare const TRUES: readonly string[];
+/**
+ * Default possible values for false.
+ * @internal
+ */
+export declare const FALSES: readonly string[];
+/**
+ * A command-line parameter which will be converted to a Boolean.
+ */
+export type BooleanCommandParam = CommandParamBase & {
+    /**
+     * Possible values for false.
+     * @defaultValue {@link FALSES}
+     */
+    falses?: string[];
+    /**
+     * Text value passed to the parser for a negative, if not otherwise provided.
+     */
+    falseText?: string;
+    /**
+     * Convert the text value to its Boolean result form.
+     * @defaultValue {@link parseBooleanArg}
+     */
+    parse?: (this: void, text: string, param: BooleanCommandParam) => boolean;
+    placeholder?: undefined;
+    /**
+     * Possible values for true.
+     * @defaultValue {@link TRUES}
+     */
+    trues?: string[];
+    /**
+     * Text value passed to the parser for a positive, if not otherwise provided.
+     */
+    trueText?: string;
+    type: typeof Boolean;
+};
+/**
+ * @internal
+ */
+export declare const parseBooleanArg: (text: string, param: BooleanCommandParam) => boolean;
+/**
+ * @internal
+ */
+export declare const booleanParamHandler: ParamHandler<BooleanCommandParam, boolean>;
+//# sourceMappingURL=boolean-param.d.ts.map

package/types/ts/boolean-param.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"boolean-param.d.ts","sourceRoot":"","sources":["../../../ts/boolean-param.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAqB,MAAM,aAAa,CAAC;AAGrF;;;GAGG;AACH,eAAO,MAAM,KAAK,mBAAkD,CAAC;AAGrE;;;GAGG;AACH,eAAO,MAAM,MAAM,mBAAkD,CAAC;AAEtE;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,gBAAgB,GAAG;IAEpD;;;OAGG;IACH,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,mBAAmB,KAAK,OAAO,CAAC;IAC1E,WAAW,CAAC,EAAE,SAAS,CAAC;IACxB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB;;OAEG;IACH,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,OAAO,OAAO,CAAC;CACrB,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,eAAe,SAAU,MAAM,SAAS,mBAAmB,KAAG,OAW1E,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,mBAAmB,EAAE,YAAY,CAAC,mBAAmB,EAAE,OAAO,CAQ1E,CAAC"}

package/types/ts/boolean-param.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.booleanParamHandler = exports.parseBooleanArg = exports.FALSES = exports.TRUES = void 0;
+const label_for_param_js_1 = require("./label-for-param.js");
+/**
+ * Default possible values for true.
+ * @internal
+ */
+exports.TRUES = Object.freeze(["t", "true", "1", "y", "yes"]);
+// noinspection SpellCheckingInspection
+/**
+ * Default possible values for false.
+ * @internal
+ */
+exports.FALSES = Object.freeze(["f", "false", "0", "n", "no"]);
+/**
+ * @internal
+ */
+const parseBooleanArg = (text, param) => {
+    const lower = text.toLocaleLowerCase();
+    const trueValues = param.trues ?? exports.TRUES;
+    if (trueValues.includes(lower)) {
+        return true;
+    }
+    const falseValues = param.falses ?? exports.FALSES;
+    if (falseValues.includes(lower)) {
+        return false;
+    }
+    throw new RangeError(`${(0, label_for_param_js_1.labelForParam)(param)}: invalid value`);
+};
+exports.parseBooleanArg = parseBooleanArg;
+/**
+ * @internal
+ */
+exports.booleanParamHandler = {
+    matchesParam(param) {
+        return param.type === Boolean;
+    },
+    parseArg: exports.parseBooleanArg,
+    placeholderForParam() {
+        return undefined;
+    },
+};
+//# sourceMappingURL=boolean-param.js.map

package/types/ts/boolean-param.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"boolean-param.js","sourceRoot":"","sources":["../../../ts/boolean-param.ts"],"names":[],"mappings":";;;AACA,6DAAqD;AAErD;;;GAGG;AACU,QAAA,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,CAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,CAAE,CAAC,CAAC;AAErE,uCAAuC;AACvC;;;GAGG;AACU,QAAA,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,CAAE,CAAC,CAAC;AAkCtE;;GAEG;AACI,MAAM,eAAe,GAAG,CAAC,IAAY,EAAE,KAA0B,EAAW,EAAE;IACpF,MAAM,KAAK,GAAG,IAAI,CAAC,iBAAiB,EAAE,CAAC;IACvC,MAAM,UAAU,GAAG,KAAK,CAAC,KAAK,IAAI,aAAK,CAAC;IACxC,IAAI,UAAU,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QAChC,OAAO,IAAI,CAAC;IACb,CAAC;IACD,MAAM,WAAW,GAAG,KAAK,CAAC,MAAM,IAAI,cAAM,CAAC;IAC3C,IAAI,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO,KAAK,CAAC;IACd,CAAC;IACD,MAAM,IAAI,UAAU,CAAC,GAAI,IAAA,kCAAa,EAAC,KAAK,CAAE,iBAAiB,CAAC,CAAC;AAClE,CAAC,CAAC;AAXW,QAAA,eAAe,mBAW1B;AAEF;;GAEG;AACU,QAAA,mBAAmB,GAA+C;IAC9E,YAAY,CAAC,KAAwB;QACpC,OAAO,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC;IAC/B,CAAC;IACD,QAAQ,EAAE,uBAAe;IACzB,mBAAmB;QAClB,OAAO,SAAS,CAAC;IAClB,CAAC;CACD,CAAC"}

package/types/ts/command-params.d.ts

@@ -0,0 +1,44 @@
+import { type BooleanCommandParam } from "./boolean-param.js";
+import type { IfOptional, IfRepeated } from "./common.js";
+import { type DateCommandParam } from "./date-param.js";
+import { type FileArg, type FileCommandParam } from "./file-param.js";
+import { type NumberCommandParam } from "./number-param.js";
+import { type StringCommandParam } from "./string-param.js";
+/**
+ * One of the built-in param types.
+ */
+export type CommandParam = StringCommandParam | NumberCommandParam | BooleanCommandParam | FileCommandParam | DateCommandParam;
+/**
+ * @internal
+ */
+export type CommandParamsSpec = Record<string, CommandParam>;
+/**
+ * A parser function for a specific type of param.
+ */
+export type CommandParamParser<Param extends CommandParam, Return> = (text: string, param: Param) => Return;
+/**
+ * @internal
+ */
+export type HasCommandParamParser<Param extends CommandParam, Return> = {
+    parse?: CommandParamParser<Param, Return>;
+};
+/**
+ * Computed return type for a param.
+ */
+export type CommandParamReturn<Param extends CommandParam> = Param extends HasCommandParamParser<Param, infer Return> ? IfRepeated<Param, Return> : Param["type"] extends typeof Boolean ? IfOptional<Param, IfRepeated<Param, boolean>> : Param["type"] extends typeof Date ? IfOptional<Param, IfRepeated<Param, Date>> : Param["type"] extends typeof Number ? IfOptional<Param, IfRepeated<Param, number>> : Param["type"] extends "file" ? IfOptional<Param, IfRepeated<Param, FileArg>> : Param["type"] extends typeof String ? IfOptional<Param, IfRepeated<Param, string>> : undefined extends Param["type"] ? IfOptional<Param, IfRepeated<Param, string>> : never;
+/**
+ * Computed return (Record) type for a Record of params.
+ */
+export type CommandParamsReturn<Params extends object> = {
+    [K in keyof Params]: Params[K] extends CommandParam ? CommandParamReturn<Params[K]> : never;
+};
+/**
+ * Parse the (maybe-given) command-line arguments according to the
+ * given param specs and construct a return type of the converted values.
+ */
+export declare const commandParams: <Spec extends CommandParamsSpec>(spec: Spec, { args, ignoreUnknown, onError, }?: {
+    args?: string[];
+    ignoreUnknown?: boolean;
+    onError?: (error: Error) => void;
+}) => CommandParamsReturn<Spec>;
+//# sourceMappingURL=command-params.d.ts.map

package/types/ts/command-params.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-params.d.ts","sourceRoot":"","sources":["../../../ts/command-params.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,mBAAmB,EAAiB,MAAM,oBAAoB,CAAC;AAC7E,OAAO,KAAK,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC1D,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACxD,OAAO,EAAE,KAAK,OAAO,EAAE,KAAK,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEtE,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAE5D,OAAO,EAAE,KAAK,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAE5D;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,kBAAkB,GAAG,kBAAkB,GAAG,mBAAmB,GAAG,gBAAgB,GAAG,gBAAgB,CAAC;AAE/H;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;AAE7D;;GAEG;AACH,MAAM,MAAM,kBAAkB,CAAC,KAAK,SAAS,YAAY,EAAE,MAAM,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,KAAK,MAAM,CAAC;AAE5G;;GAEG;AACH,MAAM,MAAM,qBAAqB,CAAC,KAAK,SAAS,YAAY,EAAE,MAAM,IAAI;IAAE,KAAK,CAAC,EAAE,kBAAkB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAA;CAAE,CAAC;AAEtH;;GAEG;AACH,MAAM,MAAM,kBAAkB,CAAC,KAAK,SAAS,YAAY,IAAI,KAAK,SAAS,qBAAqB,CAAC,KAAK,EAAE,MAAM,MAAM,CAAC,GAAG,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,GAC9I,KAAK,CAAC,MAAM,CAAC,SAAS,OAAO,OAAO,GAAG,UAAU,CAAC,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,GACnF,KAAK,CAAC,MAAM,CAAC,SAAS,OAAO,IAAI,GAAG,UAAU,CAAC,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,IAAI,CAAC,CAAC,GAC7E,KAAK,CAAC,MAAM,CAAC,SAAS,OAAO,MAAM,GAAG,UAAU,CAAC,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,GACjF,KAAK,CAAC,MAAM,CAAC,SAAS,MAAM,GAAG,UAAU,CAAC,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,OAAO,CAAC,CAAC,GAC3E,KAAK,CAAC,MAAM,CAAC,SAAS,OAAO,MAAM,GAAG,UAAU,CAAC,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,GACjF,SAAS,SAAS,KAAK,CAAC,MAAM,CAAC,GAAG,UAAU,CAAC,KAAK,EAAE,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,GAC7E,KAAK,CAAC;AAEf;;GAEG;AACH,MAAM,MAAM,mBAAmB,CAAC,MAAM,SAAS,MAAM,IAAI;KACvD,CAAC,IAAI,MAAM,MAAM,GAAG,MAAM,CAAC,CAAC,CAAC,SAAS,YAAY,GAAG,kBAAkB,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK;CAC3F,CAAA;AAWD;;;GAGG;AACH,eAAO,MAAM,aAAa,GAAI,IAAI,SAAS,iBAAiB,QACrD,IAAI,sCAKP;IACF,IAAI,CAAC,EAAE,MAAM,EAAE,CAAC;IAChB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,KAAK,IAAI,CAAC;CACjC,KACC,mBAAmB,CAAC,IAAI,CA8H1B,CAAC"}

package/types/ts/command-params.js

@@ -0,0 +1,158 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.commandParams = void 0;
+const guard_1 = require("@rickosborne/guard");
+const boolean_param_js_1 = require("./boolean-param.js");
+const label_for_param_js_1 = require("./label-for-param.js");
+const param_handler_js_1 = require("./param-handler.js");
+const toReturnType = (text, param) => {
+    const paramHandler = (0, param_handler_js_1.findParamHandler)(param);
+    const parser = (param.parse ?? paramHandler.parseArg);
+    if (parser != null) {
+        return parser(text, param);
+    }
+    throw new Error(`Unhandled param type: ${String(param.type)}`);
+};
+/**
+ * Parse the (maybe-given) command-line arguments according to the
+ * given param specs and construct a return type of the converted values.
+ */
+const commandParams = (spec, { args = process.argv.slice(2), ignoreUnknown, onError, } = {}) => {
+    const result = {};
+    const positionals = Object.entries(spec)
+        .filter(([, s]) => s.positional === true)
+        .map(([key, s]) => ({ key, spec: s }));
+    if (positionals.length > 1) {
+        throw new Error(`Too many positionals: ${positionals.map(({ key }) => key).join(" ")}`);
+    }
+    const positional = positionals.shift();
+    let onlyPositionalsRemain = false;
+    try {
+        while (args.length > 0) {
+            const arg = args.shift();
+            let param;
+            let resultKey;
+            let typedValue;
+            if (arg === "--" && !onlyPositionalsRemain) {
+                onlyPositionalsRemain = true;
+                continue;
+            }
+            if (onlyPositionalsRemain || !arg.startsWith("-")) {
+                if (positional == null) {
+                    // noinspection ExceptionCaughtLocallyJS
+                    throw new Error(`Unexpected positional: ${JSON.stringify(arg)}`);
+                }
+                param = positional.spec;
+                resultKey = positional.key;
+                typedValue = toReturnType(arg, positional.spec);
+            }
+            else {
+                let no = false;
+                let name;
+                if (arg.startsWith("--no-")) {
+                    name = arg.substring(5);
+                    no = true;
+                }
+                else if (arg.startsWith("--")) {
+                    name = arg.substring(2);
+                }
+                else if (arg.startsWith("-no-")) {
+                    name = arg.substring(4);
+                    no = true;
+                }
+                else {
+                    name = arg.substring(1);
+                }
+                let suffix;
+                if (name.includes("=")) {
+                    [name, suffix] = name.split("=", 2);
+                }
+                const specs = Object.entries(spec)
+                    .filter(([n, s]) => "name" in s && s.name === name || ("names" in s && (s.names?.includes(name) ?? false)) || n === name);
+                if (specs.length < 1) {
+                    if (ignoreUnknown) {
+                        continue;
+                    }
+                    // noinspection ExceptionCaughtLocallyJS
+                    throw new Error(`Unexpected arg: ${JSON.stringify(name)}`);
+                }
+                if (specs.length > 1) {
+                    // noinspection ExceptionCaughtLocallyJS
+                    throw new Error(`More than one matching spec: ${name}`);
+                }
+                [resultKey, param] = specs[0];
+                (0, guard_1.assertDefined)(param, `param: ${name}`);
+                let stringValue;
+                if (param.type === Boolean) {
+                    if (no) {
+                        if (suffix != null) {
+                            // noinspection ExceptionCaughtLocallyJS
+                            throw new Error(`Combo of "no" plus "=" does not make any sense for ${(0, label_for_param_js_1.labelForParam)(param)}`);
+                        }
+                        stringValue = param.falseText ?? param.falses?.[0] ?? boolean_param_js_1.FALSES[0];
+                    }
+                    else {
+                        stringValue = suffix ?? param.trueText ?? param.trues?.[0] ?? boolean_param_js_1.TRUES[0];
+                    }
+                }
+                else if (no) {
+                    // noinspection ExceptionCaughtLocallyJS
+                    throw new Error(`"no" does not make sense for ${(0, label_for_param_js_1.labelForParam)(param)}`);
+                }
+                else {
+                    stringValue = suffix ?? args.shift();
+                }
+                (0, guard_1.assertDefined)(stringValue, () => `value for ${(0, label_for_param_js_1.labelForParam)(param)}`);
+                typedValue = toReturnType(stringValue, param);
+            }
+            if (param == null || resultKey == null) {
+                if (ignoreUnknown) {
+                    continue;
+                }
+                // noinspection ExceptionCaughtLocallyJS
+                throw new Error(`Unexpected arg: ${JSON.stringify(arg)}`);
+            }
+            (0, guard_1.assertDefined)(typedValue, `typedValue for ${resultKey}`);
+            const existing = result[resultKey];
+            if (param.multiple === true) {
+                const values = existing ?? [];
+                if (!Array.isArray(values)) {
+                    // noinspection ExceptionCaughtLocallyJS
+                    throw new Error(`Expected an array: ${resultKey}`);
+                }
+                result[resultKey] ??= values;
+                values.push(typedValue);
+            }
+            else {
+                if (existing != null) {
+                    // noinspection ExceptionCaughtLocallyJS
+                    throw new Error(`Too many ${(0, label_for_param_js_1.labelForParam)(param)}: ${JSON.stringify(existing)} ${JSON.stringify(arg)}`);
+                }
+                result[resultKey] = typedValue;
+            }
+        }
+        const requiredKeys = Object.entries(spec)
+            .filter(([, s]) => s.optional !== true)
+            .map(([key]) => key);
+        const missing = requiredKeys.filter((key) => !(key in result));
+        if (missing.length > 0) {
+            const message = missing.map((key) => (0, label_for_param_js_1.labelForParam)(spec[key])).join(" ");
+            // noinspection ExceptionCaughtLocallyJS
+            throw new Error(`Missing required params: ${message}`);
+        }
+    }
+    catch (err) {
+        const error = err instanceof Error ? err : new Error("Unknown error");
+        if (onError != null) {
+            onError(error);
+            return undefined;
+        }
+        else {
+            console.error(error.message);
+            process.exit(1);
+        }
+    }
+    return result;
+};
+exports.commandParams = commandParams;
+//# sourceMappingURL=command-params.js.map

package/types/ts/command-params.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"command-params.js","sourceRoot":"","sources":["../../../ts/command-params.ts"],"names":[],"mappings":"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"}

package/types/ts/common.d.ts

@@ -0,0 +1,63 @@
+import type { Either } from "@rickosborne/typical";
+/**
+ * Mixin for a parameter which is not required.
+ */
+type OptionalParam = {
+    optional: true;
+};
+/**
+ * Extend a param's return type to allow for undefined if the param
+ * is optional.
+ * @internal
+ */
+export type IfOptional<T, U> = T extends OptionalParam ? (U | undefined) : U;
+/**
+ * Mixin for a parameter which may be repeated.
+ */
+type RepeatedParam = {
+    multiple: true;
+};
+/**
+ * Extend a parameter's return type to an array if the param may be repeated.
+ * @internal
+ */
+export type IfRepeated<T, U> = T extends RepeatedParam ? U[] : U;
+type CommandParamWithNames = {
+    name?: string;
+    names?: string;
+    positional?: false;
+};
+/**
+ * A parameter which accepts positional values.
+ */
+export type PositionalCommandParam = {
+    positional: true;
+};
+/**
+ * Mixin of properties which can be used to build `--help` text.
+ */
+export type DescribedParam = {
+    help?: string;
+    placeholder?: string;
+};
+/**
+ * Mixin for any type of command-line parameter.
+ */
+export type CommandParamBase = Either<CommandParamWithNames, PositionalCommandParam> & Partial<OptionalParam> & Partial<RepeatedParam> & DescribedParam;
+/**
+ * @internal
+ */
+export type TypedCommandParam = CommandParamBase & {
+    type?: unknown;
+};
+/**
+ * Central logic for a single type of {@link CommandParam}
+ * @internal
+ */
+export type ParamHandler<P extends TypedCommandParam, V> = {
+    matchesParam(this: void, param: TypedCommandParam): param is P;
+    parseArg(this: void, text: string, param: P): V;
+    placeholderForParam(this: void, param: P): string | undefined;
+};
+export {};
+//# sourceMappingURL=common.d.ts.map

package/types/ts/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../../ts/common.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,sBAAsB,CAAC;AAEnD;;GAEG;AACH,KAAK,aAAa,GAAG;IACpB,QAAQ,EAAE,IAAI,CAAC;CACf,CAAC;AAEF;;;;GAIG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,aAAa,GAAG,CAAC,CAAC,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;AAE7E;;GAEG;AACH,KAAK,aAAa,GAAG;IACpB,QAAQ,EAAE,IAAI,CAAC;CACf,CAAC;AAEF;;;GAGG;AACH,MAAM,MAAM,UAAU,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,aAAa,GAAG,CAAC,EAAE,GAAG,CAAC,CAAC;AAEjE,KAAK,qBAAqB,GAAG;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,KAAK,CAAC;CACnB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,sBAAsB,GAAG;IACpC,UAAU,EAAE,IAAI,CAAC;CACjB,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,cAAc,GAAG;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,CAAC,EAAE,MAAM,CAAC;CACrB,CAAA;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,CAAC,qBAAqB,EAAE,sBAAsB,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,GAAG,cAAc,CAAC;AAExJ;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG,gBAAgB,GAAG;IAAE,IAAI,CAAC,EAAE,OAAO,CAAA;CAAE,CAAC;AAGtE;;;GAGG;AACH,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,iBAAiB,EAAE,CAAC,IAAI;IAC1D,YAAY,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,iBAAiB,GAAG,KAAK,IAAI,CAAC,CAAC;IAC/D,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,CAAC,CAAC;IAChD,mBAAmB,CAAC,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM,GAAG,SAAS,CAAC;CAC9D,CAAA"}

package/types/ts/common.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=common.js.map

package/types/ts/common.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.js","sourceRoot":"","sources":["../../../ts/common.ts"],"names":[],"mappings":""}

package/types/ts/date-param.d.ts

@@ -0,0 +1,34 @@
+import { type ParseLocalDateConfig } from "@rickosborne/foundation";
+import type { CommandParamBase, ParamHandler, TypedCommandParam } from "./common.js";
+/**
+ * Command-line parameter which can accept a date (and optionally time) value.
+ */
+export type DateCommandParam = CommandParamBase & ParseLocalDateConfig & {
+    /**
+     * Maximum acceptable value.
+     */
+    maximum?: Date;
+    /**
+     * Minimum acceptable value.
+     */
+    minimum?: Date;
+    /**
+     * Convert the text argument to the date it represents.
+     * @defaultValue {@link parseDateArg}
+     */
+    parse?: (this: void, text: string, param: DateCommandParam) => Date;
+    type: typeof Date;
+};
+/**
+ * @internal
+ */
+export declare const parseDateArg: (text: string, param: DateCommandParam) => Date;
+/**
+ * @internal
+ */
+export declare const isDateParam: (param: TypedCommandParam) => param is DateCommandParam;
+/**
+ * @internal
+ */
+export declare const dateParamHandler: ParamHandler<DateCommandParam, Date>;
+//# sourceMappingURL=date-param.d.ts.map

package/types/ts/date-param.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"date-param.d.ts","sourceRoot":"","sources":["../../../ts/date-param.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,oBAAoB,EAAkB,MAAM,yBAAyB,CAAC;AACpF,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAGrF;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,gBAAgB,GAAG,oBAAoB,GAAG;IACxE;;OAEG;IACH,OAAO,CAAC,EAAE,IAAI,CAAC;IACf;;OAEG;IACH,OAAO,CAAC,EAAE,IAAI,CAAC;IACf;;;OAGG;IACH,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,KAAK,IAAI,CAAC;IACpE,IAAI,EAAE,OAAO,IAAI,CAAC;CAClB,CAAA;AAED;;GAEG;AACH,eAAO,MAAM,YAAY,SAAU,MAAM,SAAS,gBAAgB,KAAG,IASpE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,UAAW,iBAAiB,KAAG,KAAK,IAAI,gBAE/D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,YAAY,CAAC,gBAAgB,EAAE,IAAI,CAMjE,CAAC"}

package/types/ts/date-param.js

@@ -0,0 +1,37 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dateParamHandler = exports.isDateParam = exports.parseDateArg = void 0;
+const foundation_1 = require("@rickosborne/foundation");
+const label_for_param_js_1 = require("./label-for-param.js");
+/**
+ * @internal
+ */
+const parseDateArg = (text, param) => {
+    const date = (0, foundation_1.parseLocalDate)(text, param);
+    if (param.minimum != null && date < param.minimum) {
+        throw new RangeError(`${(0, label_for_param_js_1.labelForParam)(param)}: minimum=${param.minimum.toISOString()}`);
+    }
+    if (param.maximum != null && date > param.maximum) {
+        throw new RangeError(`${(0, label_for_param_js_1.labelForParam)(param)}: maximum=${param.maximum.toISOString()}`);
+    }
+    return date;
+};
+exports.parseDateArg = parseDateArg;
+/**
+ * @internal
+ */
+const isDateParam = (param) => {
+    return param.type === Date;
+};
+exports.isDateParam = isDateParam;
+/**
+ * @internal
+ */
+exports.dateParamHandler = {
+    matchesParam: exports.isDateParam,
+    parseArg: exports.parseDateArg,
+    placeholderForParam(param) {
+        return param.placeholder ?? param.time ? "(datetime)" : "(date)";
+    },
+};
+//# sourceMappingURL=date-param.js.map

package/types/ts/date-param.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"date-param.js","sourceRoot":"","sources":["../../../ts/date-param.ts"],"names":[],"mappings":";;;AAAA,wDAAoF;AAEpF,6DAAqD;AAsBrD;;GAEG;AACI,MAAM,YAAY,GAAG,CAAC,IAAY,EAAE,KAAuB,EAAQ,EAAE;IAC3E,MAAM,IAAI,GAAG,IAAA,2BAAc,EAAC,IAAI,EAAE,KAAK,CAAC,CAAC;IACzC,IAAI,KAAK,CAAC,OAAO,IAAI,IAAI,IAAI,IAAI,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC;QACnD,MAAM,IAAI,UAAU,CAAC,GAAI,IAAA,kCAAa,EAAC,KAAK,CAAE,aAAc,KAAK,CAAC,OAAO,CAAC,WAAW,EAAG,EAAE,CAAC,CAAC;IAC7F,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,IAAI,IAAI,IAAI,IAAI,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC;QACnD,MAAM,IAAI,UAAU,CAAC,GAAI,IAAA,kCAAa,EAAC,KAAK,CAAE,aAAc,KAAK,CAAC,OAAO,CAAC,WAAW,EAAG,EAAE,CAAC,CAAC;IAC7F,CAAC;IACD,OAAO,IAAI,CAAC;AACb,CAAC,CAAC;AATW,QAAA,YAAY,gBASvB;AAEF;;GAEG;AACI,MAAM,WAAW,GAAG,CAAC,KAAwB,EAA6B,EAAE;IAClF,OAAO,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC;AAC5B,CAAC,CAAC;AAFW,QAAA,WAAW,eAEtB;AAEF;;GAEG;AACU,QAAA,gBAAgB,GAAyC;IACrE,YAAY,EAAE,mBAAW;IACzB,QAAQ,EAAE,oBAAY;IACtB,mBAAmB,CAAC,KAAuB;QAC1C,OAAO,KAAK,CAAC,WAAW,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC;IAClE,CAAC;CACD,CAAC"}

package/types/ts/file-param.d.ts

@@ -0,0 +1,50 @@
+import { Stats } from "node:fs";
+import type { CommandParamBase, ParamHandler, TypedCommandParam } from "./common.js";
+/**
+ * A command-line parameter which references a file.
+ */
+export type FileCommandParam = CommandParamBase & {
+    /**
+     * If true, the file must exist.  If false, the file must
+     * not exist.  If undefined, an error will be thrown if
+     * the path exists but is not a file.
+     */
+    existing?: boolean;
+    /**
+     * Validate and transform the argument before it is returned.
+     * @defaultValue {@link parseFileArg}
+     */
+    parse?: (this: void, text: string, param: FileCommandParam) => FileArg;
+    /**
+     * Prepend this path if it is not already provided.
+     */
+    path?: string;
+    type: "file";
+};
+/**
+ * File argument resolved from a file command-line parameter.
+ */
+export type FileArg = {
+    /**
+     * Path to the file.
+     */
+    filePath: string;
+    /**
+     * If the file exists, the filesystem stats for it.
+     */
+    stats: Stats | undefined;
+};
+/**
+ * Validate and transform the argument before it is returned.
+ * @internal
+ */
+export declare const parseFileArg: (text: string, param: FileCommandParam) => FileArg;
+/**
+ * @internal
+ */
+export declare const isFileParam: (param: TypedCommandParam) => param is FileCommandParam;
+/**
+ * @internal
+ */
+export declare const fileParamHandler: ParamHandler<FileCommandParam, FileArg>;
+//# sourceMappingURL=file-param.d.ts.map

package/types/ts/file-param.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-param.d.ts","sourceRoot":"","sources":["../../../ts/file-param.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAEhC,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAErF;;GAEG;AACH,MAAM,MAAM,gBAAgB,GAAG,gBAAgB,GAAG;IACjD;;;;OAIG;IACH,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB;;;OAGG;IACH,KAAK,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,gBAAgB,KAAK,OAAO,CAAC;IACvE;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACb,CAAC;AAEF;;GAEG;AACH,MAAM,MAAM,OAAO,GAAG;IACrB;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;IACjB;;OAEG;IACH,KAAK,EAAE,KAAK,GAAG,SAAS,CAAC;CACzB,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,YAAY,SAAU,MAAM,SAAS,gBAAgB,KAAG,OAapE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,WAAW,UAAW,iBAAiB,KAAG,KAAK,IAAI,gBAE/D,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,YAAY,CAAC,gBAAgB,EAAE,OAAO,CAMpE,CAAC"}