@actsecurity/cli 0.2.66

package/dist/cjs/readRelative.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createPackageFileReader = createPackageFileReader;
+const promises_1 = require("fs/promises");
+const path_1 = require("path");
+class CommonJsPackageFileReader {
+    rootPath;
+    constructor(currentFile, levelsUp) {
+        const dirPath = currentFile.slice(0, currentFile.lastIndexOf(path_1.sep));
+        this.rootPath = (0, path_1.join)(dirPath, ...backSegments(levelsUp));
+    }
+    async readFile(pathParts) {
+        const fullPath = (0, path_1.join)(this.rootPath, ...pathParts);
+        return (0, promises_1.readFile)(fullPath, 'utf8');
+    }
+}
+class EsmPackageFileReader {
+    currentFile;
+    levelsUp;
+    rootPath;
+    constructor(currentFile, levelsUp) {
+        this.currentFile = currentFile;
+        this.levelsUp = levelsUp;
+    }
+    /**
+     * Lookup the root path of the project, going up the specified number of levels from the current file.
+     *
+     * @returns the root path of the project, calculated once and cached
+     */
+    async getRootPath() {
+        if (!this.rootPath) {
+            const dirPath = this.currentFile.slice(0, this.currentFile.lastIndexOf('/'));
+            const { fileURLToPath } = await Promise.resolve().then(() => require('node:url'));
+            const startPath = fileURLToPath(dirPath);
+            this.rootPath = (0, path_1.join)(startPath, ...backSegments(this.levelsUp));
+        }
+        return this.rootPath;
+    }
+    async readFile(pathParts) {
+        const { join } = await Promise.resolve().then(() => require('node:path'));
+        const root = await this.getRootPath();
+        const fullPath = join(root, ...pathParts);
+        return (0, promises_1.readFile)(fullPath, 'utf8');
+    }
+}
+/**
+ * A relatively sane way to read a file from a relative path inside your packaged cli app. For instance to
+ * read the package.json inside your package. Works on ESM and CommonJS modules. Use __filename
+ * or import.meta.url to get the path of the file you are in and pass it to this function. Set the `levelsUp`
+ * based on how your project is packaged. For instance, if your file is packaged in `dist/cli.js` and you would use `1` if
+ * you packaged your file is in `dist/src/cli.js` and you would use `2`. Whatever you need to get to the root.
+ *
+ * You get back a `PackageFileReader` which has a `readFile` method. You can then call that method
+ * with the path parts to the file you want to read, relative to the root of your project.
+ * For instance, to read the `package.json` file in the root of your project, you would call:
+ * ```ts
+ *   const reader = await createPackageFileReader(import.meta.url, 1) // if your file is in dist/cli.js
+ *   const packageJson = await reader.readFile(['package.json'])
+ * ```
+ *
+ * @param currentFile the path to start from use `import.meta.url` for esm or `__filename` for CommonJS in most cases
+ * @param levelsUp since __import.meta.url or __filename is the file you are in, you need to go up a few levels to ge to the root of your project. Use 0 for the current directory of the file you're calling from.
+ * @returns a `PackageFileReader` you can use to read files relative to the root of your project.
+ */
+function createPackageFileReader(currentFile, levelsUp) {
+    const isEsm = currentFile.startsWith('file://');
+    if (isEsm) {
+        return new EsmPackageFileReader(currentFile, levelsUp);
+    }
+    return new CommonJsPackageFileReader(currentFile, levelsUp);
+}
+/**
+ * Create an array of `..` segments to go up the specified number of levels in a path.
+ *
+ * @param levelsUp the number of levels to go up
+ * @returns an array of `..` segments
+ */
+function backSegments(levelsUp) {
+    return Array(levelsUp).fill('..');
+}
+//# sourceMappingURL=readRelative.js.map

package/dist/cjs/readRelative.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"readRelative.js","sourceRoot":"","sources":["../../src/readRelative.ts"],"names":[],"mappings":";;AAkFA,0DAMC;AAxFD,0CAAsC;AACtC,+BAAgC;AAiBhC,MAAM,yBAAyB;IACrB,QAAQ,CAAQ;IACxB,YAAY,WAAmB,EAAE,QAAgB;QAC/C,MAAM,OAAO,GAAG,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,WAAW,CAAC,WAAW,CAAC,UAAG,CAAC,CAAC,CAAA;QAClE,IAAI,CAAC,QAAQ,GAAG,IAAA,WAAI,EAAC,OAAO,EAAE,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC,CAAA;IAC1D,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,SAAmB;QAChC,MAAM,QAAQ,GAAG,IAAA,WAAI,EAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,SAAS,CAAC,CAAA;QAClD,OAAO,IAAA,mBAAQ,EAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;IACnC,CAAC;CACF;AAED,MAAM,oBAAoB;IAId;IACA;IAJF,QAAQ,CAAoB;IAEpC,YACU,WAAmB,EACnB,QAAgB;QADhB,gBAAW,GAAX,WAAW,CAAQ;QACnB,aAAQ,GAAR,QAAQ,CAAQ;IACvB,CAAC;IAEJ;;;;OAIG;IACK,KAAK,CAAC,WAAW;QACvB,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,MAAM,OAAO,GAAG,IAAI,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAA;YAC5E,MAAM,EAAE,aAAa,EAAE,GAAG,2CAAa,UAAU,EAAC,CAAA;YAClD,MAAM,SAAS,GAAG,aAAa,CAAC,OAAO,CAAC,CAAA;YACxC,IAAI,CAAC,QAAQ,GAAG,IAAA,WAAI,EAAC,SAAS,EAAE,GAAG,YAAY,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAA;QACjE,CAAC;QAED,OAAO,IAAI,CAAC,QAAQ,CAAA;IACtB,CAAC;IAED,KAAK,CAAC,QAAQ,CAAC,SAAmB;QAChC,MAAM,EAAE,IAAI,EAAE,GAAG,2CAAa,WAAW,EAAC,CAAA;QAC1C,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,WAAW,EAAE,CAAA;QACrC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,EAAE,GAAG,SAAS,CAAC,CAAA;QACzC,OAAO,IAAA,mBAAQ,EAAC,QAAQ,EAAE,MAAM,CAAC,CAAA;IACnC,CAAC;CACF;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,SAAgB,uBAAuB,CAAC,WAAmB,EAAE,QAAgB;IAC3E,MAAM,KAAK,GAAG,WAAW,CAAC,UAAU,CAAC,SAAS,CAAC,CAAA;IAC/C,IAAI,KAAK,EAAE,CAAC;QACV,OAAO,IAAI,oBAAoB,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAA;IACxD,CAAC;IACD,OAAO,IAAI,yBAAyB,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAA;AAC7D,CAAC;AAED;;;;;GAKG;AACH,SAAS,YAAY,CAAC,QAAgB;IACpC,OAAO,KAAK,CAAC,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;AACnC,CAAC"}

package/dist/cjs/stdin.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Read from stdin until the stream ends, timeout, or an error occurs
+ *
+ * @returns the string input from stdin
+ */
+export declare function readStdin(readWait: number | undefined): Promise<string>;
+//# sourceMappingURL=stdin.d.ts.map

package/dist/cjs/stdin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdin.d.ts","sourceRoot":"","sources":["../../src/stdin.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,wBAAsB,SAAS,CAAC,QAAQ,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,MAAM,CAAC,CA+B7E"}

package/dist/cjs/stdin.js

@@ -0,0 +1,38 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readStdin = readStdin;
+const process_1 = require("process");
+/**
+ * Read from stdin until the stream ends, timeout, or an error occurs
+ *
+ * @returns the string input from stdin
+ */
+async function readStdin(readWait) {
+    return new Promise((resolve, reject) => {
+        // If the input is not a TTY, we are most likely receiving data from a pipe.
+        const definitelyReceivingData = !process.stdin.isTTY;
+        if (!readWait || readWait <= 0) {
+            readWait = definitelyReceivingData ? 10_000 : 20;
+        }
+        let data = '';
+        const timeout = setTimeout(() => {
+            if (data.length === 0) {
+                process_1.stdin.pause();
+                process_1.stdin.removeAllListeners('data');
+                resolve(data);
+            }
+        }, readWait);
+        process_1.stdin.on('data', (chunk) => {
+            data += chunk;
+        });
+        process_1.stdin.on('end', () => {
+            resolve(data);
+            clearTimeout(timeout);
+        });
+        process_1.stdin.on('error', (err) => {
+            reject(err);
+            clearTimeout(timeout);
+        });
+    });
+}
+//# sourceMappingURL=stdin.js.map

package/dist/cjs/stdin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"stdin.js","sourceRoot":"","sources":["../../src/stdin.ts"],"names":[],"mappings":";;AAOA,8BA+BC;AAtCD,qCAA+B;AAE/B;;;;GAIG;AACI,KAAK,UAAU,SAAS,CAAC,QAA4B;IAC1D,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACrC,4EAA4E;QAC5E,MAAM,uBAAuB,GAAG,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAA;QACpD,IAAI,CAAC,QAAQ,IAAI,QAAQ,IAAI,CAAC,EAAE,CAAC;YAC/B,QAAQ,GAAG,uBAAuB,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAA;QAClD,CAAC;QAED,IAAI,IAAI,GAAG,EAAE,CAAA;QACb,MAAM,OAAO,GAAG,UAAU,CAAC,GAAG,EAAE;YAC9B,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACtB,eAAK,CAAC,KAAK,EAAE,CAAA;gBACb,eAAK,CAAC,kBAAkB,CAAC,MAAM,CAAC,CAAA;gBAChC,OAAO,CAAC,IAAI,CAAC,CAAA;YACf,CAAC;QACH,CAAC,EAAE,QAAQ,CAAC,CAAA;QAEZ,eAAK,CAAC,EAAE,CAAC,MAAM,EAAE,CAAC,KAAK,EAAE,EAAE;YACzB,IAAI,IAAI,KAAK,CAAA;QACf,CAAC,CAAC,CAAA;QAEF,eAAK,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,EAAE;YACnB,OAAO,CAAC,IAAI,CAAC,CAAA;YACb,YAAY,CAAC,OAAO,CAAC,CAAA;QACvB,CAAC,CAAC,CAAA;QAEF,eAAK,CAAC,EAAE,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,EAAE;YACxB,MAAM,CAAC,GAAG,CAAC,CAAA;YACX,YAAY,CAAC,OAAO,CAAC,CAAA;QACvB,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/dist/cjs/utils.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Optionally print a message and exit the process with the given exit code.
+ *
+ * @param exitCode the exit code to use
+ * @param message the message to print
+ */
+export declare function exit(exitCode: number, message: string | undefined): void;
+/**
+ * A utility type to ensure that T has exactly the keys of U, no more and no less.
+ */
+export type NoExtraKeys<T, Shape> = {
+    [K in keyof T]: K extends keyof Shape ? T[K] : never;
+};
+//# sourceMappingURL=utils.d.ts.map

package/dist/cjs/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/utils.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,wBAAgB,IAAI,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,QASjE;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,EAAE,KAAK,IAAI;KACjC,CAAC,IAAI,MAAM,CAAC,GAAG,CAAC,SAAS,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,KAAK;CACrD,CAAA"}

package/dist/cjs/utils.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.exit = exit;
+/**
+ * Optionally print a message and exit the process with the given exit code.
+ *
+ * @param exitCode the exit code to use
+ * @param message the message to print
+ */
+function exit(exitCode, message) {
+    if (message) {
+        if (exitCode === 0) {
+            console.log(message);
+        }
+        else {
+            console.error(message);
+        }
+    }
+    process.exit(exitCode);
+}
+//# sourceMappingURL=utils.js.map

package/dist/cjs/utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.js","sourceRoot":"","sources":["../../src/utils.ts"],"names":[],"mappings":";;AAMA,oBASC;AAfD;;;;;GAKG;AACH,SAAgB,IAAI,CAAC,QAAgB,EAAE,OAA2B;IAChE,IAAI,OAAO,EAAE,CAAC;QACZ,IAAI,QAAQ,KAAK,CAAC,EAAE,CAAC;YACnB,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAA;QACtB,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,KAAK,CAAC,OAAO,CAAC,CAAA;QACxB,CAAC;IACH,CAAC;IACD,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;AACxB,CAAC"}

package/dist/esm/arguments/argument.d.ts

@@ -0,0 +1,63 @@
+export type ValidValue<T> = {
+    valid: true;
+    value: T;
+};
+export type InvalidValue = {
+    valid: false;
+    message: string;
+};
+export type ValidatedValues<T> = ValidValue<T> | InvalidValue;
+export type Argument<ArgumentType> = {
+    /**
+     * A description of the argument, used in help text.
+     */
+    description: string;
+    /**
+     * The default value of the argument, if any.
+     * If not provided, the argument will be undefined until a value is provided.
+     */
+    defaultValue: ArgumentType;
+    /**
+     * Validate all values passed to the argument at once.
+     * @param currentValue the current value of the argument
+     * @param values the array of strings passed to the argument
+     * @param isCurrentlyDefaulted true if the current value has not been set by the user and is still the default value
+     * @returns if the value is invalid, returns { valid: false, message: string } and message will be shown to the user.
+     *          if the value is valid, returns { valid: true, values`: ArgumentType[] } where value is the parsed value.
+     */
+    validateValues: (currentValue: ArgumentType, values: string[], isCurrentlyDefaulted: boolean) => Promise<ValidValue<ArgumentType> | InvalidValue> | ValidValue<ArgumentType> | InvalidValue;
+    /**
+     * Reduces the current value and a new values into a single value.
+     *
+     * @param current the current value of the argument, can be undefined if there is no default value
+     * @param newValues the new values being added as parsed by validateValues
+     * @param isCurrentlyDefaulted true if the current value has not been set by the user and is still the default value
+     * @returns the new value of the argument
+     */
+    reduceValues: (currentValue: ArgumentType, newValues: NonNullable<ArgumentType>, isCurrentlyDefaulted: boolean) => Promise<ArgumentType> | ArgumentType;
+    /**
+     * If this callback is provided, it will be called when the argument is present
+     *
+     * @param currentValue the current value of the argument
+     * @returns the value to set the argument to
+     */
+    present?(currentValue: ArgumentType): Promise<ArgumentType> | ArgumentType;
+    /**
+     * If this function is provided, it will be called to determine if the argument
+     * can accept multiple values.
+     *
+     * If not provided, the argument will only accept a single value.
+     *
+     * @returns true if the argument can accept multiple values, false otherwise
+     */
+    acceptMultipleValues?(): boolean;
+    /**
+     * A single-character alias for the argument, e.g. 'f' for --foo
+     *
+     * This is only valid if the argument does not take a value (e.g. boolean flags).
+     */
+    character?: string;
+};
+export type PerArgumentArgs = Pick<Argument<any>, 'description'>;
+export type CustomArgument<ArgumentType> = Omit<Argument<ArgumentType>, 'character'>;
+//# sourceMappingURL=argument.d.ts.map

package/dist/esm/arguments/argument.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"argument.d.ts","sourceRoot":"","sources":["../../../src/arguments/argument.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,CAAC,CAAC,IAAI;IAAE,KAAK,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,CAAC,CAAA;CAAE,CAAA;AACrD,MAAM,MAAM,YAAY,GAAG;IAAE,KAAK,EAAE,KAAK,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAA;AAC5D,MAAM,MAAM,eAAe,CAAC,CAAC,IAAI,UAAU,CAAC,CAAC,CAAC,GAAG,YAAY,CAAA;AAE7D,MAAM,MAAM,QAAQ,CAAC,YAAY,IAAI;IACnC;;OAEG;IACH,WAAW,EAAE,MAAM,CAAA;IAEnB;;;OAGG;IACH,YAAY,EAAE,YAAY,CAAA;IAE1B;;;;;;;OAOG;IACH,cAAc,EAAE,CACd,YAAY,EAAE,YAAY,EAC1B,MAAM,EAAE,MAAM,EAAE,EAChB,oBAAoB,EAAE,OAAO,KAC1B,OAAO,CAAC,UAAU,CAAC,YAAY,CAAC,GAAG,YAAY,CAAC,GAAG,UAAU,CAAC,YAAY,CAAC,GAAG,YAAY,CAAA;IAE/F;;;;;;;OAOG;IACH,YAAY,EAAE,CACZ,YAAY,EAAE,YAAY,EAC1B,SAAS,EAAE,WAAW,CAAC,YAAY,CAAC,EACpC,oBAAoB,EAAE,OAAO,KAC1B,OAAO,CAAC,YAAY,CAAC,GAAG,YAAY,CAAA;IAEzC;;;;;OAKG;IACH,OAAO,CAAC,CAAC,YAAY,EAAE,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC,GAAG,YAAY,CAAA;IAE1E;;;;;;;OAOG;IACH,oBAAoB,CAAC,IAAI,OAAO,CAAA;IAEhC;;;;OAIG;IACH,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB,CAAA;AAED,MAAM,MAAM,eAAe,GAAG,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,aAAa,CAAC,CAAA;AAChE,MAAM,MAAM,cAAc,CAAC,YAAY,IAAI,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,EAAE,WAAW,CAAC,CAAA"}

package/dist/esm/arguments/argument.js

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

package/dist/esm/arguments/argument.js.map

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

package/dist/esm/arguments/arrayValueArgument.d.ts

@@ -0,0 +1,17 @@
+import { type Argument, type PerArgumentArgs, type ValidatedValues } from './argument.js';
+type ArrayValueValidator<ValueType> = (rawValue: string) => Promise<ValidatedValues<ValueType>> | ValidatedValues<ValueType>;
+type ArrayWithDefault<ValueType> = {
+    defaultValue: ValueType[];
+} & PerArgumentArgs;
+type ArrayWithoutDefault<ValueType> = {
+    defaultValue?: undefined;
+} & PerArgumentArgs;
+/**
+ * Creates an array value argument factory for a specific type
+ */
+export declare function arrayValueArgument<ValueType>(validator: ArrayValueValidator<ValueType>, descriptionSuffix?: string): {
+    (options: ArrayWithDefault<ValueType>): Argument<ValueType[]>;
+    (options: ArrayWithoutDefault<ValueType>): Argument<ValueType[] | undefined>;
+};
+export {};
+//# sourceMappingURL=arrayValueArgument.d.ts.map

package/dist/esm/arguments/arrayValueArgument.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"arrayValueArgument.d.ts","sourceRoot":"","sources":["../../../src/arguments/arrayValueArgument.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,eAAe,EAAE,KAAK,eAAe,EAAE,MAAM,eAAe,CAAA;AAEzF,KAAK,mBAAmB,CAAC,SAAS,IAAI,CACpC,QAAQ,EAAE,MAAM,KACb,OAAO,CAAC,eAAe,CAAC,SAAS,CAAC,CAAC,GAAG,eAAe,CAAC,SAAS,CAAC,CAAA;AAErE,KAAK,gBAAgB,CAAC,SAAS,IAAI;IAAE,YAAY,EAAE,SAAS,EAAE,CAAA;CAAE,GAAG,eAAe,CAAA;AAClF,KAAK,mBAAmB,CAAC,SAAS,IAAI;IAAE,YAAY,CAAC,EAAE,SAAS,CAAA;CAAE,GAAG,eAAe,CAAA;AAKpF;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,EAC1C,SAAS,EAAE,mBAAmB,CAAC,SAAS,CAAC,EACzC,iBAAiB,GAAE,MAAW;cAEG,gBAAgB,CAAC,SAAS,CAAC,GAAG,QAAQ,CAAC,SAAS,EAAE,CAAC;cAEzE,mBAAmB,CAAC,SAAS,CAAC,GACtC,QAAQ,CAAC,SAAS,EAAE,GAAG,SAAS,CAAC;EA2CrC"}

package/dist/esm/arguments/arrayValueArgument.js

@@ -0,0 +1,36 @@
+import {} from './argument.js';
+/**
+ * Creates an array value argument factory for a specific type
+ */
+export function arrayValueArgument(validator, descriptionSuffix = '') {
+    function createArgument(options) {
+        return {
+            description: options.description + descriptionSuffix,
+            validateValues: async (current, values, isCurrentlyDefaulted) => {
+                if (values.length === 0) {
+                    return { valid: false, message: 'at least one value is required' };
+                }
+                const validatedValues = [];
+                for (const rawValue of values) {
+                    const result = await validator(rawValue);
+                    if (!result.valid) {
+                        return result;
+                    }
+                    validatedValues.push(result.value);
+                }
+                return { valid: true, value: validatedValues };
+            },
+            reduceValues: async (current, newValues, isCurrentlyDefaulted) => {
+                if (isCurrentlyDefaulted || !current) {
+                    return newValues;
+                }
+                current.push(...newValues);
+                return current;
+            },
+            defaultValue: options.defaultValue,
+            acceptMultipleValues: () => true
+        };
+    }
+    return createArgument;
+}
+//# sourceMappingURL=arrayValueArgument.js.map

package/dist/esm/arguments/arrayValueArgument.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"arrayValueArgument.js","sourceRoot":"","sources":["../../../src/arguments/arrayValueArgument.ts"],"names":[],"mappings":"AAAA,OAAO,EAA6D,MAAM,eAAe,CAAA;AAYzF;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAChC,SAAyC,EACzC,oBAA4B,EAAE;IAM9B,SAAS,cAAc,CACrB,OAA4C;QAE5C,OAAO;YACL,WAAW,EAAE,OAAO,CAAC,WAAW,GAAG,iBAAiB;YACpD,cAAc,EAAE,KAAK,EACnB,OAAgC,EAChC,MAAgB,EAChB,oBAA6B,EACU,EAAE;gBACzC,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;oBACxB,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,gCAAgC,EAAE,CAAA;gBACpE,CAAC;gBAED,MAAM,eAAe,GAAgB,EAAE,CAAA;gBACvC,KAAK,MAAM,QAAQ,IAAI,MAAM,EAAE,CAAC;oBAC9B,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,QAAQ,CAAC,CAAA;oBACxC,IAAI,CAAC,MAAM,CAAC,KAAK,EAAE,CAAC;wBAClB,OAAO,MAAM,CAAA;oBACf,CAAC;oBACD,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAA;gBACpC,CAAC;gBAED,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,eAAe,EAAE,CAAA;YAChD,CAAC;YACD,YAAY,EAAE,KAAK,EACjB,OAAgC,EAChC,SAAsB,EACtB,oBAA8B,EAC9B,EAAE;gBACF,IAAI,oBAAoB,IAAI,CAAC,OAAO,EAAE,CAAC;oBACrC,OAAO,SAAS,CAAA;gBAClB,CAAC;gBACD,OAAO,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,CAAA;gBAC1B,OAAO,OAAO,CAAA;YAChB,CAAC;YACD,YAAY,EAAE,OAAO,CAAC,YAAY;YAClC,oBAAoB,EAAE,GAAG,EAAE,CAAC,IAAI;SACjC,CAAA;IACH,CAAC;IAED,OAAO,cAAc,CAAA;AACvB,CAAC"}

package/dist/esm/arguments/booleanArgument.d.ts

@@ -0,0 +1,11 @@
+import { type Argument, type PerArgumentArgs } from './argument.js';
+/**
+ * Creates a boolean argument that is false by default and true if present.
+ *
+ * @param options the description and the single character that can be used to set the value to true
+ * @returns a boolean argument
+ */
+export declare function booleanArgument(options: {
+    character: string;
+} & PerArgumentArgs): Argument<boolean>;
+//# sourceMappingURL=booleanArgument.d.ts.map

package/dist/esm/arguments/booleanArgument.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"booleanArgument.d.ts","sourceRoot":"","sources":["../../../src/arguments/booleanArgument.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,eAAe,EAAwB,MAAM,eAAe,CAAA;AAEzF;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE;IAAE,SAAS,EAAE,MAAM,CAAA;CAAE,GAAG,eAAe,GAC/C,QAAQ,CAAC,OAAO,CAAC,CAkBnB"}

package/dist/esm/arguments/booleanArgument.js

@@ -0,0 +1,23 @@
+import {} from './argument.js';
+/**
+ * Creates a boolean argument that is false by default and true if present.
+ *
+ * @param options the description and the single character that can be used to set the value to true
+ * @returns a boolean argument
+ */
+export function booleanArgument(options) {
+    return {
+        description: options.description,
+        character: options.character,
+        validateValues: (currentValue, value, isCurrentlyDefaulted) => {
+            if (value.length == 0) {
+                return { valid: true, value: true };
+            }
+            return { valid: false, message: `does not accept values but received ${value.join(', ')}` };
+        },
+        reduceValues: (current, newValue, isCurrentlyDefaulted) => current,
+        present: (currentValue) => true,
+        defaultValue: false
+    };
+}
+//# sourceMappingURL=booleanArgument.js.map

package/dist/esm/arguments/booleanArgument.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"booleanArgument.js","sourceRoot":"","sources":["../../../src/arguments/booleanArgument.ts"],"names":[],"mappings":"AAAA,OAAO,EAA6D,MAAM,eAAe,CAAA;AAEzF;;;;;GAKG;AACH,MAAM,UAAU,eAAe,CAC7B,OAAgD;IAEhD,OAAO;QACL,WAAW,EAAE,OAAO,CAAC,WAAW;QAChC,SAAS,EAAE,OAAO,CAAC,SAAS;QAC5B,cAAc,EAAE,CACd,YAAqB,EACrB,KAAe,EACf,oBAA6B,EACH,EAAE;YAC5B,IAAI,KAAK,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;gBACtB,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,CAAA;YACrC,CAAC;YACD,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,uCAAuC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,EAAE,CAAA;QAC7F,CAAC;QACD,YAAY,EAAE,CAAC,OAAgB,EAAE,QAAiB,EAAE,oBAA6B,EAAE,EAAE,CAAC,OAAO;QAC7F,OAAO,EAAE,CAAC,YAAqB,EAAE,EAAE,CAAC,IAAI;QACxC,YAAY,EAAE,KAAK;KACpB,CAAA;AACH,CAAC"}

package/dist/esm/arguments/enumArgument.d.ts

@@ -0,0 +1,20 @@
+import { type NoExtraKeys } from '../utils.js';
+import { type Argument, type PerArgumentArgs } from './argument.js';
+type EnumType<T extends {
+    validValues: string[];
+    defaultValue?: string | undefined;
+}> = T['defaultValue'] extends string ? T['validValues'][number] | T['defaultValue'] : T['validValues'][number];
+type EnumOptions = {
+    defaultValue?: string;
+    validValues: string[];
+} & PerArgumentArgs;
+export declare function enumArgument<const O extends {
+    defaultValue: string;
+    validValues: string[];
+} & PerArgumentArgs>(options: NoExtraKeys<O, EnumOptions>): Argument<EnumType<O>>;
+export declare function enumArgument<const O extends {
+    defaultValue?: undefined;
+    validValues: string[];
+} & PerArgumentArgs>(options: NoExtraKeys<O, EnumOptions>): Argument<EnumType<O> | undefined>;
+export {};
+//# sourceMappingURL=enumArgument.d.ts.map

package/dist/esm/arguments/enumArgument.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enumArgument.d.ts","sourceRoot":"","sources":["../../../src/arguments/enumArgument.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,aAAa,CAAA;AAC9C,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,eAAe,EAAwB,MAAM,eAAe,CAAA;AAEzF,KAAK,QAAQ,CAAC,CAAC,SAAS;IAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,IAClF,CAAC,CAAC,cAAc,CAAC,SAAS,MAAM,GAC5B,CAAC,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,cAAc,CAAC,GAC5C,CAAC,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC,CAAA;AAE9B,KAAK,WAAW,GAAG;IAAE,YAAY,CAAC,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,eAAe,CAAA;AAErF,wBAAgB,YAAY,CAC1B,KAAK,CAAC,CAAC,SAAS;IAAE,YAAY,EAAE,MAAM,CAAC;IAAC,WAAW,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,eAAe,EACjF,OAAO,EAAE,WAAW,CAAC,CAAC,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAA;AAC9D,wBAAgB,YAAY,CAC1B,KAAK,CAAC,CAAC,SAAS;IAAE,YAAY,CAAC,EAAE,SAAS,CAAC;IAAC,WAAW,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,eAAe,EACrF,OAAO,EAAE,WAAW,CAAC,CAAC,EAAE,WAAW,CAAC,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,SAAS,CAAC,CAAA"}

package/dist/esm/arguments/enumArgument.js

@@ -0,0 +1,34 @@
+import {} from '../utils.js';
+import {} from './argument.js';
+export function enumArgument(options) {
+    return {
+        description: options.description +
+            `. One value required, valid values are: ${options.validValues.join(', ')}`,
+        validateValues: (currentValue, values, isCurrentlyDefaulted) => {
+            if (values.length == 0) {
+                return { valid: false, message: 'a value is required' };
+            }
+            if (currentValue != options.defaultValue) {
+                return { valid: false, message: 'expects a single value but was set multiple times' };
+            }
+            if (values.length > 1) {
+                return {
+                    valid: false,
+                    message: 'expects a single value but received ' + values.join(', ')
+                };
+            }
+            const value = values[0];
+            const match = options.validValues.find((v) => v.toLowerCase() === value.toLowerCase());
+            if (!match) {
+                return {
+                    valid: false,
+                    message: `${value} is not one of the allowed values: ${options.validValues.join(', ')}`
+                };
+            }
+            return { valid: true, value: match };
+        },
+        reduceValues: (current, newValue, isCurrentlyDefaulted) => newValue,
+        defaultValue: options.defaultValue
+    };
+}
+//# sourceMappingURL=enumArgument.js.map

package/dist/esm/arguments/enumArgument.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enumArgument.js","sourceRoot":"","sources":["../../../src/arguments/enumArgument.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,MAAM,aAAa,CAAA;AAC9C,OAAO,EAA6D,MAAM,eAAe,CAAA;AAezF,MAAM,UAAU,YAAY,CAE1B,OAAoC;IACpC,OAAO;QACL,WAAW,EACT,OAAO,CAAC,WAAW;YACnB,2CAA2C,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QAC7E,cAAc,EAAE,CACd,YAAqC,EACrC,MAAgB,EAChB,oBAA6B,EACC,EAAE;YAChC,IAAI,MAAM,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;gBACvB,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,qBAAqB,EAAE,CAAA;YACzD,CAAC;YACD,IAAI,YAAY,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;gBACzC,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,mDAAmD,EAAE,CAAA;YACvF,CAAC;YACD,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACtB,OAAO;oBACL,KAAK,EAAE,KAAK;oBACZ,OAAO,EAAE,sCAAsC,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC;iBACpE,CAAA;YACH,CAAC;YACD,MAAM,KAAK,GAAG,MAAM,CAAC,CAAC,CAAC,CAAA;YACvB,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,KAAK,CAAC,WAAW,EAAE,CAAC,CAAA;YACtF,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,OAAO;oBACL,KAAK,EAAE,KAAK;oBACZ,OAAO,EAAE,GAAG,KAAK,sCAAsC,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;iBACxF,CAAA;YACH,CAAC;YAED,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,KAAoB,EAAE,CAAA;QACrD,CAAC;QACD,YAAY,EAAE,CACZ,OAAgC,EAChC,QAAqB,EACrB,oBAA6B,EAC7B,EAAE,CAAC,QAAQ;QACb,YAAY,EAAE,OAAO,CAAC,YAAY;KACnC,CAAA;AACH,CAAC"}

package/dist/esm/arguments/enumArrayArgument.d.ts

@@ -0,0 +1,20 @@
+import { type NoExtraKeys } from '../utils.js';
+import { type Argument, type PerArgumentArgs } from './argument.js';
+type EnumArrayType<T extends {
+    validValues: string[];
+    defaultValue?: string[] | undefined;
+}> = T['defaultValue'] extends string[] ? T['validValues'][number] | T['defaultValue'][number] : T['validValues'][number];
+type EnumArrayOptions = {
+    defaultValue?: string[];
+    validValues: string[];
+} & PerArgumentArgs;
+export declare function enumArrayArgument<const O extends {
+    defaultValue: string[];
+    validValues: string[];
+} & PerArgumentArgs>(options: NoExtraKeys<O, EnumArrayOptions>): Argument<EnumArrayType<O>[]>;
+export declare function enumArrayArgument<const O extends {
+    defaultValue?: undefined;
+    validValues: string[];
+} & PerArgumentArgs>(options: NoExtraKeys<O, EnumArrayOptions>): Argument<EnumArrayType<O>[] | undefined>;
+export {};
+//# sourceMappingURL=enumArrayArgument.d.ts.map

package/dist/esm/arguments/enumArrayArgument.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"enumArrayArgument.d.ts","sourceRoot":"","sources":["../../../src/arguments/enumArrayArgument.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,WAAW,EAAE,MAAM,aAAa,CAAA;AAC9C,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,eAAe,EAAwB,MAAM,eAAe,CAAA;AAEzF,KAAK,aAAa,CAAC,CAAC,SAAS;IAAE,WAAW,EAAE,MAAM,EAAE,CAAC;IAAC,YAAY,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CAAA;CAAE,IACzF,CAAC,CAAC,cAAc,CAAC,SAAS,MAAM,EAAE,GAC9B,CAAC,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,cAAc,CAAC,CAAC,MAAM,CAAC,GACpD,CAAC,CAAC,aAAa,CAAC,CAAC,MAAM,CAAC,CAAA;AAE9B,KAAK,gBAAgB,GAAG;IAAE,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IAAC,WAAW,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,eAAe,CAAA;AAE5F,wBAAgB,iBAAiB,CAC/B,KAAK,CAAC,CAAC,SAAS;IAAE,YAAY,EAAE,MAAM,EAAE,CAAC;IAAC,WAAW,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,eAAe,EACnF,OAAO,EAAE,WAAW,CAAC,CAAC,EAAE,gBAAgB,CAAC,GAAG,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,CAAC,CAAA;AAC1E,wBAAgB,iBAAiB,CAC/B,KAAK,CAAC,CAAC,SAAS;IAAE,YAAY,CAAC,EAAE,SAAS,CAAC;IAAC,WAAW,EAAE,MAAM,EAAE,CAAA;CAAE,GAAG,eAAe,EACrF,OAAO,EAAE,WAAW,CAAC,CAAC,EAAE,gBAAgB,CAAC,GAAG,QAAQ,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,GAAG,SAAS,CAAC,CAAA"}

package/dist/esm/arguments/enumArrayArgument.js

@@ -0,0 +1,42 @@
+import {} from '../utils.js';
+import {} from './argument.js';
+export function enumArrayArgument(options) {
+    return {
+        description: options.description +
+            `. One or more values required, valid values are: ${options.validValues.join(', ')}`,
+        validateValues: async (currentValue, values, isCurrentlyDefaulted) => {
+            if (values.length == 0) {
+                return { valid: false, message: 'At least one value is required' };
+            }
+            const invalidValues = [];
+            const validValues = [];
+            for (const value of values) {
+                const match = options.validValues.find((v) => v.toLowerCase() === value.toLowerCase());
+                if (!match) {
+                    invalidValues.push(value);
+                }
+                else {
+                    validValues.push(match);
+                }
+            }
+            if (invalidValues.length > 0) {
+                return {
+                    valid: false,
+                    message: `${invalidValues.map((v) => `${v}`).join(', ')} is not one of the allowed values: ${options.validValues.join(', ')}`
+                };
+            }
+            return { valid: true, value: validValues };
+        },
+        reduceValues: async (current, newValues, isCurrentlyDefaulted) => {
+            if (isCurrentlyDefaulted || !current) {
+                // If the current value is the default or undefined, replace it entirely
+                return newValues;
+            }
+            current.push(...newValues);
+            return current;
+        },
+        defaultValue: options.defaultValue,
+        acceptMultipleValues: () => true
+    };
+}
+//# sourceMappingURL=enumArrayArgument.js.map

package/dist/esm/arguments/enumArrayArgument.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"enumArrayArgument.js","sourceRoot":"","sources":["../../../src/arguments/enumArrayArgument.ts"],"names":[],"mappings":"AAAA,OAAO,EAAoB,MAAM,aAAa,CAAA;AAC9C,OAAO,EAA6D,MAAM,eAAe,CAAA;AAezF,MAAM,UAAU,iBAAiB,CAG/B,OAAyC;IAEzC,OAAO;QACL,WAAW,EACT,OAAO,CAAC,WAAW;YACnB,oDAAoD,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;QACtF,cAAc,EAAE,KAAK,EACnB,YAA4C,EAC5C,MAAgB,EAChB,oBAA6B,EACiB,EAAE;YAChD,IAAI,MAAM,CAAC,MAAM,IAAI,CAAC,EAAE,CAAC;gBACvB,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,gCAAgC,EAAE,CAAA;YACpE,CAAC;YACD,MAAM,aAAa,GAAa,EAAE,CAAA;YAClC,MAAM,WAAW,GAAuB,EAAE,CAAA;YAC1C,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;gBAC3B,MAAM,KAAK,GAAG,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,EAAE,KAAK,KAAK,CAAC,WAAW,EAAE,CAAC,CAAA;gBACtF,IAAI,CAAC,KAAK,EAAE,CAAC;oBACX,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;gBAC3B,CAAC;qBAAM,CAAC;oBACN,WAAW,CAAC,IAAI,CAAC,KAAyB,CAAC,CAAA;gBAC7C,CAAC;YACH,CAAC;YAED,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBAC7B,OAAO;oBACL,KAAK,EAAE,KAAK;oBACZ,OAAO,EAAE,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,sCAAsC,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;iBAC9H,CAAA;YACH,CAAC;YAED,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,WAAW,EAAE,CAAA;QAC5C,CAAC;QACD,YAAY,EAAE,KAAK,EACjB,OAAuC,EACvC,SAA6B,EAC7B,oBAA8B,EAC9B,EAAE;YACF,IAAI,oBAAoB,IAAI,CAAC,OAAO,EAAE,CAAC;gBACrC,wEAAwE;gBACxE,OAAO,SAAS,CAAA;YAClB,CAAC;YACD,OAAO,CAAC,IAAI,CAAC,GAAG,SAAS,CAAC,CAAA;YAC1B,OAAO,OAAO,CAAA;QAChB,CAAC;QACD,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,oBAAoB,EAAE,GAAG,EAAE,CAAC,IAAI;KACjC,CAAA;AACH,CAAC"}

package/dist/esm/arguments/mapArgument.d.ts

@@ -0,0 +1,20 @@
+import { type Argument, type PerArgumentArgs } from './argument.js';
+type MapResult = Record<string, string[]>;
+type MapWithDefault = {
+    defaultValue: MapResult;
+} & PerArgumentArgs;
+type MapWithoutDefault = {
+    defaultValue?: undefined;
+} & PerArgumentArgs;
+/**
+ * Creates a map argument where the first value is the key and the rest are values.
+ *
+ * --arg-name key1 key1Value1 key1Value2 --arg-name key2 key2Value1 key2Value2
+ *
+ * @param options the description and optional default value
+ * @returns a map argument
+ */
+export declare function mapArgument(options: MapWithDefault): Argument<MapResult>;
+export declare function mapArgument(options: MapWithoutDefault): Argument<MapResult | undefined>;
+export {};
+//# sourceMappingURL=mapArgument.d.ts.map

package/dist/esm/arguments/mapArgument.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapArgument.d.ts","sourceRoot":"","sources":["../../../src/arguments/mapArgument.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,QAAQ,EAAE,KAAK,eAAe,EAAwB,MAAM,eAAe,CAAA;AAEzF,KAAK,SAAS,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,CAAC,CAAA;AAEzC,KAAK,cAAc,GAAG;IAAE,YAAY,EAAE,SAAS,CAAA;CAAE,GAAG,eAAe,CAAA;AACnE,KAAK,iBAAiB,GAAG;IAAE,YAAY,CAAC,EAAE,SAAS,CAAA;CAAE,GAAG,eAAe,CAAA;AAGvE;;;;;;;GAOG;AACH,wBAAgB,WAAW,CAAC,OAAO,EAAE,cAAc,GAAG,QAAQ,CAAC,SAAS,CAAC,CAAA;AACzE,wBAAgB,WAAW,CAAC,OAAO,EAAE,iBAAiB,GAAG,QAAQ,CAAC,SAAS,GAAG,SAAS,CAAC,CAAA"}

package/dist/esm/arguments/mapArgument.js

@@ -0,0 +1,33 @@
+import {} from './argument.js';
+export function mapArgument(options) {
+    return {
+        description: options.description + `. Each instance requires a key and at least one value.`,
+        validateValues: async (currentValue, values, isCurrentlyDefaulted) => {
+            const [first, ...rest] = values;
+            if (!first) {
+                return { valid: false, message: 'a key is required and at least one value is required' };
+            }
+            if (rest.length < 1) {
+                return { valid: false, message: `${first} requires at least one value` };
+            }
+            if (!isCurrentlyDefaulted && currentValue && first in currentValue) {
+                return { valid: false, message: `${first} is set multiple times` };
+            }
+            return {
+                valid: true,
+                value: {
+                    [first]: rest
+                }
+            };
+        },
+        reduceValues: async (current, newValue, isCurrentlyDefaulted) => {
+            if (isCurrentlyDefaulted || !current) {
+                return { ...newValue };
+            }
+            return { ...current, ...newValue };
+        },
+        defaultValue: options.defaultValue,
+        acceptMultipleValues: () => true
+    };
+}
+//# sourceMappingURL=mapArgument.js.map

package/dist/esm/arguments/mapArgument.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapArgument.js","sourceRoot":"","sources":["../../../src/arguments/mapArgument.ts"],"names":[],"mappings":"AAAA,OAAO,EAA6D,MAAM,eAAe,CAAA;AAkBzF,MAAM,UAAU,WAAW,CACzB,OAA+B;IAE/B,OAAO;QACL,WAAW,EAAE,OAAO,CAAC,WAAW,GAAG,wDAAwD;QAC3F,cAAc,EAAE,KAAK,EACnB,YAAmC,EACnC,MAAgB,EAChB,oBAA6B,EACQ,EAAE;YACvC,MAAM,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,GAAG,MAAM,CAAA;YAC/B,IAAI,CAAC,KAAK,EAAE,CAAC;gBACX,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,sDAAsD,EAAE,CAAA;YAC1F,CAAC;YACD,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACpB,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,KAAK,8BAA8B,EAAE,CAAA;YAC1E,CAAC;YACD,IAAI,CAAC,oBAAoB,IAAI,YAAY,IAAI,KAAK,IAAI,YAAY,EAAE,CAAC;gBACnE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,GAAG,KAAK,wBAAwB,EAAE,CAAA;YACpE,CAAC;YACD,OAAO;gBACL,KAAK,EAAE,IAAI;gBACX,KAAK,EAAE;oBACL,CAAC,KAAK,CAAC,EAAE,IAAI;iBACd;aACF,CAAA;QACH,CAAC;QACD,YAAY,EAAE,KAAK,EACjB,OAA8B,EAC9B,QAAmB,EACnB,oBAA6B,EAC7B,EAAE;YACF,IAAI,oBAAoB,IAAI,CAAC,OAAO,EAAE,CAAC;gBACrC,OAAO,EAAE,GAAG,QAAQ,EAAE,CAAA;YACxB,CAAC;YACD,OAAO,EAAE,GAAG,OAAO,EAAE,GAAG,QAAQ,EAAE,CAAA;QACpC,CAAC;QACD,YAAY,EAAE,OAAO,CAAC,YAAY;QAClC,oBAAoB,EAAE,GAAG,EAAE,CAAC,IAAI;KACjC,CAAA;AACH,CAAC"}

package/dist/esm/arguments/numberArguments.d.ts

@@ -0,0 +1,17 @@
+export declare const numberArgument: {
+    (options: {
+        defaultValue: number;
+    } & import("./argument.js").PerArgumentArgs): import("./argument.js").Argument<number>;
+    (options: {
+        defaultValue?: undefined;
+    } & import("./argument.js").PerArgumentArgs): import("./argument.js").Argument<number | undefined>;
+};
+export declare const numberArrayArgument: {
+    (options: {
+        defaultValue: number[];
+    } & import("./argument.js").PerArgumentArgs): import("./argument.js").Argument<number[]>;
+    (options: {
+        defaultValue?: undefined;
+    } & import("./argument.js").PerArgumentArgs): import("./argument.js").Argument<number[] | undefined>;
+};
+//# sourceMappingURL=numberArguments.d.ts.map

package/dist/esm/arguments/numberArguments.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"numberArguments.d.ts","sourceRoot":"","sources":["../../../src/arguments/numberArguments.ts"],"names":[],"mappings":"AAYA,eAAO,MAAM,cAAc;;;;;;;CAAwE,CAAA;AAEnG,eAAO,MAAM,mBAAmB;;;;;;;CAG/B,CAAA"}

package/dist/esm/arguments/numberArguments.js

@@ -0,0 +1,13 @@
+import {} from './argument.js';
+import { arrayValueArgument } from './arrayValueArgument.js';
+import { singleValueArgument } from './singleValueArgument.js';
+function validateNumber(rawValue) {
+    const num = Number(rawValue);
+    if (isNaN(num)) {
+        return { valid: false, message: `expects a number but received ${rawValue}` };
+    }
+    return { valid: true, value: num };
+}
+export const numberArgument = singleValueArgument(validateNumber, '. One number required.');
+export const numberArrayArgument = arrayValueArgument(validateNumber, '. One or more numbers required.');
+//# sourceMappingURL=numberArguments.js.map

package/dist/esm/arguments/numberArguments.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"numberArguments.js","sourceRoot":"","sources":["../../../src/arguments/numberArguments.ts"],"names":[],"mappings":"AAAA,OAAO,EAAwB,MAAM,eAAe,CAAA;AACpD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAC5D,OAAO,EAAE,mBAAmB,EAAE,MAAM,0BAA0B,CAAA;AAE9D,SAAS,cAAc,CAAC,QAAgB;IACtC,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAA;IAC5B,IAAI,KAAK,CAAC,GAAG,CAAC,EAAE,CAAC;QACf,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,iCAAiC,QAAQ,EAAE,EAAE,CAAA;IAC/E,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,CAAA;AACpC,CAAC;AAED,MAAM,CAAC,MAAM,cAAc,GAAG,mBAAmB,CAAS,cAAc,EAAE,wBAAwB,CAAC,CAAA;AAEnG,MAAM,CAAC,MAAM,mBAAmB,GAAG,kBAAkB,CACnD,cAAc,EACd,iCAAiC,CAClC,CAAA"}