@rickosborne/clamp 2025.1.7

package/cjs/ts/number-param.js

@@ -0,0 +1,56 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.numberParamHandler = exports.isNumberParam = exports.parseNumberArg = void 0;
+const label_for_param_js_1 = require("./label-for-param.js");
+/**
+ * Convert a text argument to a number.
+ * @internal
+ */
+const parseNumberArg = (text, param) => {
+    const num = param.integer === true ? parseInt(text, param.radix) : parseFloat(text);
+    if (param.minimum != null && num < param.minimum) {
+        throw new RangeError(`${(0, label_for_param_js_1.labelForParam)(param)}: minimum=${param.minimum}`);
+    }
+    if (param.maximum != null && num > param.maximum) {
+        throw new RangeError(`${(0, label_for_param_js_1.labelForParam)(param)}: maximum=${param.minimum}`);
+    }
+    return parseFloat(text);
+};
+exports.parseNumberArg = parseNumberArg;
+/**
+ * @internal
+ */
+const isNumberParam = (param) => {
+    return param.type === Number;
+};
+exports.isNumberParam = isNumberParam;
+/**
+ * @internal
+ */
+exports.numberParamHandler = {
+    matchesParam: exports.isNumberParam,
+    parseArg: exports.parseNumberArg,
+    placeholderForParam(param) {
+        if (param.placeholder != null) {
+            return param.placeholder;
+        }
+        let range;
+        if (param.minimum != null && param.maximum != null) {
+            range = `:[${param.minimum},${param.maximum}]`;
+        }
+        else if (param.minimum != null) {
+            range = `≥${param.minimum}`;
+        }
+        else if (param.maximum != null) {
+            range = `≤${param.maximum}`;
+        }
+        else {
+            range = "";
+        }
+        if (param.integer) {
+            return `(int${range})`;
+        }
+        return `(number${range})`;
+    },
+};
+//# sourceMappingURL=number-param.js.map

package/cjs/ts/number-param.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"number-param.js","sourceRoot":"","sources":["../../../ts/number-param.ts"],"names":[],"mappings":";;;AACA,6DAAqD;AA+BrD;;;GAGG;AACI,MAAM,cAAc,GAAG,CAAC,IAAY,EAAE,KAAyB,EAAU,EAAE;IACjF,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IACpF,IAAI,KAAK,CAAC,OAAO,IAAI,IAAI,IAAI,GAAG,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC;QAClD,MAAM,IAAI,UAAU,CAAC,GAAG,IAAA,kCAAa,EAAC,KAAK,CAAC,aAAa,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IAC3E,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,IAAI,IAAI,IAAI,GAAG,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC;QAClD,MAAM,IAAI,UAAU,CAAC,GAAG,IAAA,kCAAa,EAAC,KAAK,CAAC,aAAa,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IAC3E,CAAC;IACD,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;AACzB,CAAC,CAAC;AATW,QAAA,cAAc,kBASzB;AAEF;;GAEG;AACI,MAAM,aAAa,GAAG,CAAC,KAAwB,EAA+B,EAAE;IACtF,OAAO,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC;AAC9B,CAAC,CAAC;AAFW,QAAA,aAAa,iBAExB;AAEF;;GAEG;AACU,QAAA,kBAAkB,GAA6C;IAC3E,YAAY,EAAE,qBAAa;IAC3B,QAAQ,EAAE,sBAAc;IACxB,mBAAmB,CAAC,KAAyB;QAC5C,IAAI,KAAK,CAAC,WAAW,IAAI,IAAI,EAAE,CAAC;YAC/B,OAAO,KAAK,CAAC,WAAW,CAAC;QAC1B,CAAC;QACD,IAAI,KAAa,CAAC;QAClB,IAAI,KAAK,CAAC,OAAO,IAAI,IAAI,IAAI,KAAK,CAAC,OAAO,IAAI,IAAI,EAAE,CAAC;YACpD,KAAK,GAAG,KAAK,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,OAAO,GAAG,CAAC;QAChD,CAAC;aAAM,IAAI,KAAK,CAAC,OAAO,IAAI,IAAI,EAAE,CAAC;YAClC,KAAK,GAAG,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QAC7B,CAAC;aAAM,IAAI,KAAK,CAAC,OAAO,IAAI,IAAI,EAAE,CAAC;YAClC,KAAK,GAAG,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QAC7B,CAAC;aAAM,CAAC;YACP,KAAK,GAAG,EAAE,CAAC;QACZ,CAAC;QACD,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;YACnB,OAAO,OAAO,KAAK,GAAG,CAAC;QACxB,CAAC;QACD,OAAO,UAAU,KAAK,GAAG,CAAC;IAC3B,CAAC;CACD,CAAC"}

package/cjs/ts/param-handler.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findParamHandler = void 0;
+const boolean_param_js_1 = require("./boolean-param.js");
+const date_param_js_1 = require("./date-param.js");
+const file_param_js_1 = require("./file-param.js");
+const number_param_js_1 = require("./number-param.js");
+const string_param_js_1 = require("./string-param.js");
+const paramHandlers = [
+    string_param_js_1.stringParamHandler,
+    boolean_param_js_1.booleanParamHandler,
+    number_param_js_1.numberParamHandler,
+    file_param_js_1.fileParamHandler,
+    date_param_js_1.dateParamHandler,
+];
+/**
+ * @internal
+ */
+const findParamHandler = (param) => {
+    var _a;
+    const paramHandler = paramHandlers.find((ph) => ph.matchesParam(param));
+    if (paramHandler == null) {
+        throw new TypeError(`Unknown parameter type: ${(_a = param.type) === null || _a === void 0 ? void 0 : _a.toString()}`);
+    }
+    return paramHandler;
+};
+exports.findParamHandler = findParamHandler;
+//# sourceMappingURL=param-handler.js.map

package/cjs/ts/param-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"param-handler.js","sourceRoot":"","sources":["../../../ts/param-handler.ts"],"names":[],"mappings":";;;AAAA,yDAAyD;AAEzD,mDAAmD;AACnD,mDAAmD;AACnD,uDAAuD;AACvD,uDAAuD;AAEvD,MAAM,aAAa,GAA+C;IACjE,oCAAkB;IAClB,sCAAmB;IACnB,oCAAkB;IAClB,gCAAgB;IAChB,gCAAgB;CAChB,CAAC;AAEF;;GAEG;AACI,MAAM,gBAAgB,GAAG,CAA8B,KAAQ,EAA4B,EAAE;;IACnG,MAAM,YAAY,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,EAAE,EAAW,EAAE,CAAC,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,CAAyC,CAAC;IACzH,IAAI,YAAY,IAAI,IAAI,EAAE,CAAC;QAC1B,MAAM,IAAI,SAAS,CAAC,2BAA4B,MAAA,KAAK,CAAC,IAAI,0CAAE,QAAQ,EAAG,EAAE,CAAC,CAAC;IAC5E,CAAC;IACD,OAAO,YAAY,CAAC;AACrB,CAAC,CAAC;AANW,QAAA,gBAAgB,oBAM3B"}

package/cjs/ts/string-param.js

@@ -0,0 +1,34 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.stringParamHandler = exports.isStringParam = exports.parseStringArg = void 0;
+/**
+ * Transform a string argument before returning it.
+ * @internal
+ */
+const parseStringArg = (text, param) => {
+    let s = text;
+    if (param.trim === true) {
+        s = s.trim();
+    }
+    return s;
+};
+exports.parseStringArg = parseStringArg;
+/**
+ * @internal
+ */
+const isStringParam = (param) => {
+    return param.type === String || param.type == null;
+};
+exports.isStringParam = isStringParam;
+/**
+ * @internal
+ */
+exports.stringParamHandler = {
+    matchesParam: exports.isStringParam,
+    parseArg: exports.parseStringArg,
+    placeholderForParam(param) {
+        var _a;
+        return (_a = param.placeholder) !== null && _a !== void 0 ? _a : "(text)";
+    },
+};
+//# sourceMappingURL=string-param.js.map

package/cjs/ts/string-param.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-param.js","sourceRoot":"","sources":["../../../ts/string-param.ts"],"names":[],"mappings":";;;AAkBA;;;GAGG;AACI,MAAM,cAAc,GAAG,CAAC,IAAY,EAAE,KAAyB,EAAU,EAAE;IACjF,IAAI,CAAC,GAAG,IAAI,CAAC;IACb,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;QACzB,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACd,CAAC;IACD,OAAO,CAAC,CAAC;AACV,CAAC,CAAC;AANW,QAAA,cAAc,kBAMzB;AAEF;;GAEG;AACI,MAAM,aAAa,GAAG,CAAC,KAAwB,EAA+B,EAAE;IACtF,OAAO,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,KAAK,CAAC,IAAI,IAAI,IAAI,CAAC;AACpD,CAAC,CAAC;AAFW,QAAA,aAAa,iBAExB;AAEF;;GAEG;AACU,QAAA,kBAAkB,GAA6C;IAC3E,YAAY,EAAE,qBAAa;IAC3B,QAAQ,EAAE,sBAAc;IACxB,mBAAmB,CAAC,KAAyB;;QAC5C,OAAO,MAAA,KAAK,CAAC,WAAW,mCAAI,QAAQ,CAAC;IACtC,CAAC;CACD,CAAC"}

package/cjs/tsconfig.cjs.tsbuildinfo

@@ -0,0 +1 @@
+{"root":["../../index.ts","../../ts/boolean-param.ts","../../ts/command-params.ts","../../ts/common.ts","../../ts/date-param.ts","../../ts/file-param.ts","../../ts/help-for-param.ts","../../ts/label-for-param.ts","../../ts/number-param.ts","../../ts/param-handler.ts","../../ts/string-param.ts"],"version":"5.7.2"}

package/esm/index.js

@@ -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.js.map

package/esm/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","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/esm/package.json

@@ -0,0 +1,6 @@
+{
+	"engines": {
+		"node": ">=16"
+	},
+	"type": "module"
+}

package/esm/ts/boolean-param.js

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"boolean-param.js","sourceRoot":"","sources":["../../../ts/boolean-param.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD;;;GAGG;AACH,MAAM,CAAC,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,CAAE,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,EAAE,KAAK,CAAE,CAAC,CAAC;AAErE,uCAAuC;AACvC;;;GAGG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,CAAE,GAAG,EAAE,OAAO,EAAE,GAAG,EAAE,GAAG,EAAE,IAAI,CAAE,CAAC,CAAC;AAkCtE;;GAEG;AACH,MAAM,CAAC,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,KAAK,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,MAAM,CAAC;IAC3C,IAAI,WAAW,CAAC,QAAQ,CAAC,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO,KAAK,CAAC;IACd,CAAC;IACD,MAAM,IAAI,UAAU,CAAC,GAAI,aAAa,CAAC,KAAK,CAAE,iBAAiB,CAAC,CAAC;AAClE,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAA+C;IAC9E,YAAY,CAAC,KAAwB;QACpC,OAAO,KAAK,CAAC,IAAI,KAAK,OAAO,CAAC;IAC/B,CAAC;IACD,QAAQ,EAAE,eAAe;IACzB,mBAAmB;QAClB,OAAO,SAAS,CAAC;IAClB,CAAC;CACD,CAAC"}

package/esm/ts/command-params.js

@@ -0,0 +1,154 @@
+import { assertDefined } from "@rickosborne/guard";
+import { FALSES, TRUES } from "./boolean-param.js";
+import { labelForParam } from "./label-for-param.js";
+import { findParamHandler } from "./param-handler.js";
+const toReturnType = (text, param) => {
+    const paramHandler = 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.
+ */
+export 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];
+                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 ${labelForParam(param)}`);
+                        }
+                        stringValue = param.falseText ?? param.falses?.[0] ?? FALSES[0];
+                    }
+                    else {
+                        stringValue = suffix ?? param.trueText ?? param.trues?.[0] ?? TRUES[0];
+                    }
+                }
+                else if (no) {
+                    // noinspection ExceptionCaughtLocallyJS
+                    throw new Error(`"no" does not make sense for ${labelForParam(param)}`);
+                }
+                else {
+                    stringValue = suffix ?? args.shift();
+                }
+                assertDefined(stringValue, () => `value for ${labelForParam(param)}`);
+                typedValue = toReturnType(stringValue, param);
+            }
+            if (param == null || resultKey == null) {
+                if (ignoreUnknown) {
+                    continue;
+                }
+                // noinspection ExceptionCaughtLocallyJS
+                throw new Error(`Unexpected arg: ${JSON.stringify(arg)}`);
+            }
+            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 ${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) => 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;
+};
+//# sourceMappingURL=command-params.js.map

package/esm/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/esm/ts/common.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=common.js.map

package/esm/ts/common.js.map

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

package/esm/ts/date-param.js

@@ -0,0 +1,32 @@
+import { parseLocalDate } from "@rickosborne/foundation";
+import { labelForParam } from "./label-for-param.js";
+/**
+ * @internal
+ */
+export const parseDateArg = (text, param) => {
+    const date = parseLocalDate(text, param);
+    if (param.minimum != null && date < param.minimum) {
+        throw new RangeError(`${labelForParam(param)}: minimum=${param.minimum.toISOString()}`);
+    }
+    if (param.maximum != null && date > param.maximum) {
+        throw new RangeError(`${labelForParam(param)}: maximum=${param.maximum.toISOString()}`);
+    }
+    return date;
+};
+/**
+ * @internal
+ */
+export const isDateParam = (param) => {
+    return param.type === Date;
+};
+/**
+ * @internal
+ */
+export const dateParamHandler = {
+    matchesParam: isDateParam,
+    parseArg: parseDateArg,
+    placeholderForParam(param) {
+        return param.placeholder ?? param.time ? "(datetime)" : "(date)";
+    },
+};
+//# sourceMappingURL=date-param.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"date-param.js","sourceRoot":"","sources":["../../../ts/date-param.ts"],"names":[],"mappings":"AAAA,OAAO,EAA6B,cAAc,EAAE,MAAM,yBAAyB,CAAC;AAEpF,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAsBrD;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,IAAY,EAAE,KAAuB,EAAQ,EAAE;IAC3E,MAAM,IAAI,GAAG,cAAc,CAAC,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,aAAa,CAAC,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,aAAa,CAAC,KAAK,CAAE,aAAc,KAAK,CAAC,OAAO,CAAC,WAAW,EAAG,EAAE,CAAC,CAAC;IAC7F,CAAC;IACD,OAAO,IAAI,CAAC;AACb,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,KAAwB,EAA6B,EAAE;IAClF,OAAO,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC;AAC5B,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAyC;IACrE,YAAY,EAAE,WAAW;IACzB,QAAQ,EAAE,YAAY;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/esm/ts/file-param.js

@@ -0,0 +1,37 @@
+import { statsForFile } from "@rickosborne/term";
+import * as path from "node:path";
+/**
+ * Validate and transform the argument before it is returned.
+ * @internal
+ */
+export const parseFileArg = (text, param) => {
+    let filePath = text;
+    if (param.path != null && !filePath.startsWith(param.path)) {
+        filePath = path.join(param.path, filePath);
+    }
+    const stats = statsForFile(filePath);
+    const exists = stats != null;
+    if (param.existing !== undefined) {
+        if (exists !== param.existing) {
+            throw new Error(`File ${exists ? "exists" : "does not exist"}: ${filePath}`);
+        }
+    }
+    return { filePath, stats };
+};
+/**
+ * @internal
+ */
+export const isFileParam = (param) => {
+    return param.type === "file";
+};
+/**
+ * @internal
+ */
+export const fileParamHandler = {
+    matchesParam: isFileParam,
+    parseArg: parseFileArg,
+    placeholderForParam(param) {
+        return param.placeholder ?? "(path)";
+    },
+};
+//# sourceMappingURL=file-param.js.map

package/esm/ts/file-param.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"file-param.js","sourceRoot":"","sources":["../../../ts/file-param.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEjD,OAAO,KAAK,IAAI,MAAM,WAAW,CAAC;AAuClC;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,IAAY,EAAE,KAAuB,EAAW,EAAE;IAC9E,IAAI,QAAQ,GAAG,IAAI,CAAC;IACpB,IAAI,KAAK,CAAC,IAAI,IAAI,IAAI,IAAI,CAAC,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5D,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC5C,CAAC;IACD,MAAM,KAAK,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;IACrC,MAAM,MAAM,GAAG,KAAK,IAAI,IAAI,CAAC;IAC7B,IAAI,KAAK,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QAClC,IAAI,MAAM,KAAK,KAAK,CAAC,QAAQ,EAAE,CAAC;YAC/B,MAAM,IAAI,KAAK,CAAC,QAAS,MAAM,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,gBAAiB,KAAM,QAAS,EAAE,CAAC,CAAC;QAClF,CAAC;IACF,CAAC;IACD,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC;AAC5B,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,KAAwB,EAA6B,EAAE;IAClF,OAAO,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC;AAC9B,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAA4C;IACxE,YAAY,EAAE,WAAW;IACzB,QAAQ,EAAE,YAAY;IACtB,mBAAmB,CAAC,KAAuB;QAC1C,OAAO,KAAK,CAAC,WAAW,IAAI,QAAQ,CAAC;IACtC,CAAC;CACD,CAAC"}

package/esm/ts/help-for-param.js

@@ -0,0 +1,29 @@
+import { findParamHandler } from "./param-handler.js";
+/**
+ * @internal
+ */
+export const helpForParam = (names, param) => {
+    const { help } = param;
+    if (help == null) {
+        return undefined;
+    }
+    const handler = findParamHandler(param);
+    const placeholder = handler.placeholderForParam(param);
+    const lines = [];
+    for (const name of names.slice().sort()) {
+        let line = "  ";
+        if (name.length === 1) {
+            line = line.concat("-", name);
+        }
+        else {
+            line = line.concat("--", name);
+        }
+        if (placeholder != null) {
+            line = line.concat(" ", placeholder);
+        }
+        lines.push(line);
+    }
+    lines.push("    ".concat(help));
+    return lines.join("\n");
+};
+//# sourceMappingURL=help-for-param.js.map

package/esm/ts/help-for-param.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"help-for-param.js","sourceRoot":"","sources":["../../../ts/help-for-param.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAEtD;;GAEG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,KAAe,EAAE,KAAmB,EAAsB,EAAE;IACxF,MAAM,EAAE,IAAI,EAAE,GAAG,KAAK,CAAC;IACvB,IAAI,IAAI,IAAI,IAAI,EAAE,CAAC;QAClB,OAAO,SAAS,CAAC;IAClB,CAAC;IACD,MAAM,OAAO,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;IACxC,MAAM,WAAW,GAAG,OAAO,CAAC,mBAAmB,CAAC,KAAK,CAAC,CAAC;IACvD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC;QACzC,IAAI,IAAI,GAAG,IAAI,CAAC;QAChB,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC/B,CAAC;aAAM,CAAC;YACP,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QAChC,CAAC;QACD,IAAI,WAAW,IAAI,IAAI,EAAE,CAAC;YACzB,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,WAAW,CAAC,CAAC;QACtC,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAClB,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IAChC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACzB,CAAC,CAAC"}

package/esm/ts/label-for-param.js

@@ -0,0 +1,13 @@
+/**
+ * @internal
+ */
+export const labelForParam = (param) => {
+    if (param.positional === true) {
+        return "...";
+    }
+    const names = param.names ?? param.name == null ? [] : [param.name];
+    return names
+        .map((name) => (name.length === 1 ? "-" : "--").concat(name))
+        .join("|");
+};
+//# sourceMappingURL=label-for-param.js.map

package/esm/ts/label-for-param.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"label-for-param.js","sourceRoot":"","sources":["../../../ts/label-for-param.ts"],"names":[],"mappings":"AAEA;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,KAAmB,EAAU,EAAE;IAC5D,IAAI,KAAK,CAAC,UAAU,KAAK,IAAI,EAAE,CAAC;QAC/B,OAAO,KAAK,CAAC;IACd,CAAC;IACD,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,IAAI,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAE,KAAK,CAAC,IAAI,CAAE,CAAC;IACtE,OAAO,KAAK;SACV,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;SAC5D,IAAI,CAAC,GAAG,CAAC,CAAC;AACb,CAAC,CAAC"}

package/esm/ts/number-param.js

@@ -0,0 +1,51 @@
+import { labelForParam } from "./label-for-param.js";
+/**
+ * Convert a text argument to a number.
+ * @internal
+ */
+export const parseNumberArg = (text, param) => {
+    const num = param.integer === true ? parseInt(text, param.radix) : parseFloat(text);
+    if (param.minimum != null && num < param.minimum) {
+        throw new RangeError(`${labelForParam(param)}: minimum=${param.minimum}`);
+    }
+    if (param.maximum != null && num > param.maximum) {
+        throw new RangeError(`${labelForParam(param)}: maximum=${param.minimum}`);
+    }
+    return parseFloat(text);
+};
+/**
+ * @internal
+ */
+export const isNumberParam = (param) => {
+    return param.type === Number;
+};
+/**
+ * @internal
+ */
+export const numberParamHandler = {
+    matchesParam: isNumberParam,
+    parseArg: parseNumberArg,
+    placeholderForParam(param) {
+        if (param.placeholder != null) {
+            return param.placeholder;
+        }
+        let range;
+        if (param.minimum != null && param.maximum != null) {
+            range = `:[${param.minimum},${param.maximum}]`;
+        }
+        else if (param.minimum != null) {
+            range = `≥${param.minimum}`;
+        }
+        else if (param.maximum != null) {
+            range = `≤${param.maximum}`;
+        }
+        else {
+            range = "";
+        }
+        if (param.integer) {
+            return `(int${range})`;
+        }
+        return `(number${range})`;
+    },
+};
+//# sourceMappingURL=number-param.js.map

package/esm/ts/number-param.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"number-param.js","sourceRoot":"","sources":["../../../ts/number-param.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AA+BrD;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,IAAY,EAAE,KAAyB,EAAU,EAAE;IACjF,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;IACpF,IAAI,KAAK,CAAC,OAAO,IAAI,IAAI,IAAI,GAAG,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC;QAClD,MAAM,IAAI,UAAU,CAAC,GAAG,aAAa,CAAC,KAAK,CAAC,aAAa,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IAC3E,CAAC;IACD,IAAI,KAAK,CAAC,OAAO,IAAI,IAAI,IAAI,GAAG,GAAG,KAAK,CAAC,OAAO,EAAE,CAAC;QAClD,MAAM,IAAI,UAAU,CAAC,GAAG,aAAa,CAAC,KAAK,CAAC,aAAa,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IAC3E,CAAC;IACD,OAAO,UAAU,CAAC,IAAI,CAAC,CAAC;AACzB,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,KAAwB,EAA+B,EAAE;IACtF,OAAO,KAAK,CAAC,IAAI,KAAK,MAAM,CAAC;AAC9B,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAA6C;IAC3E,YAAY,EAAE,aAAa;IAC3B,QAAQ,EAAE,cAAc;IACxB,mBAAmB,CAAC,KAAyB;QAC5C,IAAI,KAAK,CAAC,WAAW,IAAI,IAAI,EAAE,CAAC;YAC/B,OAAO,KAAK,CAAC,WAAW,CAAC;QAC1B,CAAC;QACD,IAAI,KAAa,CAAC;QAClB,IAAI,KAAK,CAAC,OAAO,IAAI,IAAI,IAAI,KAAK,CAAC,OAAO,IAAI,IAAI,EAAE,CAAC;YACpD,KAAK,GAAG,KAAK,KAAK,CAAC,OAAO,IAAI,KAAK,CAAC,OAAO,GAAG,CAAC;QAChD,CAAC;aAAM,IAAI,KAAK,CAAC,OAAO,IAAI,IAAI,EAAE,CAAC;YAClC,KAAK,GAAG,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QAC7B,CAAC;aAAM,IAAI,KAAK,CAAC,OAAO,IAAI,IAAI,EAAE,CAAC;YAClC,KAAK,GAAG,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;QAC7B,CAAC;aAAM,CAAC;YACP,KAAK,GAAG,EAAE,CAAC;QACZ,CAAC;QACD,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC;YACnB,OAAO,OAAO,KAAK,GAAG,CAAC;QACxB,CAAC;QACD,OAAO,UAAU,KAAK,GAAG,CAAC;IAC3B,CAAC;CACD,CAAC"}

package/esm/ts/param-handler.js

@@ -0,0 +1,23 @@
+import { booleanParamHandler } from "./boolean-param.js";
+import { dateParamHandler } from "./date-param.js";
+import { fileParamHandler } from "./file-param.js";
+import { numberParamHandler } from "./number-param.js";
+import { stringParamHandler } from "./string-param.js";
+const paramHandlers = [
+    stringParamHandler,
+    booleanParamHandler,
+    numberParamHandler,
+    fileParamHandler,
+    dateParamHandler,
+];
+/**
+ * @internal
+ */
+export const findParamHandler = (param) => {
+    const paramHandler = paramHandlers.find((ph) => ph.matchesParam(param));
+    if (paramHandler == null) {
+        throw new TypeError(`Unknown parameter type: ${param.type?.toString()}`);
+    }
+    return paramHandler;
+};
+//# sourceMappingURL=param-handler.js.map

package/esm/ts/param-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"param-handler.js","sourceRoot":"","sources":["../../../ts/param-handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,MAAM,oBAAoB,CAAC;AAEzD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AAEvD,MAAM,aAAa,GAA+C;IACjE,kBAAkB;IAClB,mBAAmB;IACnB,kBAAkB;IAClB,gBAAgB;IAChB,gBAAgB;CAChB,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAA8B,KAAQ,EAA4B,EAAE;IACnG,MAAM,YAAY,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC,EAAE,EAAW,EAAE,CAAC,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,CAAyC,CAAC;IACzH,IAAI,YAAY,IAAI,IAAI,EAAE,CAAC;QAC1B,MAAM,IAAI,SAAS,CAAC,2BAA4B,KAAK,CAAC,IAAI,EAAE,QAAQ,EAAG,EAAE,CAAC,CAAC;IAC5E,CAAC;IACD,OAAO,YAAY,CAAC;AACrB,CAAC,CAAC"}

package/esm/ts/string-param.js

@@ -0,0 +1,28 @@
+/**
+ * Transform a string argument before returning it.
+ * @internal
+ */
+export const parseStringArg = (text, param) => {
+    let s = text;
+    if (param.trim === true) {
+        s = s.trim();
+    }
+    return s;
+};
+/**
+ * @internal
+ */
+export const isStringParam = (param) => {
+    return param.type === String || param.type == null;
+};
+/**
+ * @internal
+ */
+export const stringParamHandler = {
+    matchesParam: isStringParam,
+    parseArg: parseStringArg,
+    placeholderForParam(param) {
+        return param.placeholder ?? "(text)";
+    },
+};
+//# sourceMappingURL=string-param.js.map

package/esm/ts/string-param.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"string-param.js","sourceRoot":"","sources":["../../../ts/string-param.ts"],"names":[],"mappings":"AAkBA;;;GAGG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,IAAY,EAAE,KAAyB,EAAU,EAAE;IACjF,IAAI,CAAC,GAAG,IAAI,CAAC;IACb,IAAI,KAAK,CAAC,IAAI,KAAK,IAAI,EAAE,CAAC;QACzB,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IACd,CAAC;IACD,OAAO,CAAC,CAAC;AACV,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,KAAwB,EAA+B,EAAE;IACtF,OAAO,KAAK,CAAC,IAAI,KAAK,MAAM,IAAI,KAAK,CAAC,IAAI,IAAI,IAAI,CAAC;AACpD,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAA6C;IAC3E,YAAY,EAAE,aAAa;IAC3B,QAAQ,EAAE,cAAc;IACxB,mBAAmB,CAAC,KAAyB;QAC5C,OAAO,KAAK,CAAC,WAAW,IAAI,QAAQ,CAAC;IACtC,CAAC;CACD,CAAC"}

package/esm/tsconfig.module.tsbuildinfo

@@ -0,0 +1 @@
+{"root":["../../index.ts","../../ts/boolean-param.ts","../../ts/command-params.ts","../../ts/common.ts","../../ts/date-param.ts","../../ts/file-param.ts","../../ts/help-for-param.ts","../../ts/label-for-param.ts","../../ts/number-param.ts","../../ts/param-handler.ts","../../ts/string-param.ts"],"version":"5.7.2"}