@villedemontreal/caporal 3.1.7

package/dist/src/option/__tests__/global.spec.js

@@ -0,0 +1,121 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+/* eslint-disable no-console */
+const index_1 = require("../../index");
+const program_1 = require("../../program");
+const logger_1 = require("../../logger");
+const __1 = require("..");
+const vitest_1 = require("vitest");
+let prog = index_1.program;
+(0, vitest_1.describe)("option / global", () => {
+    const logSpy = vitest_1.vi.spyOn(console, "log");
+    // @ts-expect-error TS says _stdout does note exist on console but it does
+    const logStdoutSpy = vitest_1.vi.spyOn(console._stdout, "write"); // winston use this
+    const loggerInfoSpy = vitest_1.vi.spyOn(logger_1.logger, "info");
+    (0, vitest_1.beforeEach)(() => {
+        prog = new program_1.Program();
+        prog.name("test-prog");
+        prog.bin("test-prog");
+        prog.version("xyz");
+        logSpy.mockClear();
+        logStdoutSpy.mockClear();
+        logger_1.logger.level = "info";
+        logger_1.logger.colorsEnabled = true;
+        (0, __1.resetGlobalOptions)();
+    });
+    (0, vitest_1.afterAll)(() => {
+        logger_1.logger.colorsEnabled = true;
+    });
+    (0, vitest_1.it)("-V should show program version and exit", async () => {
+        await prog.run(["-V"]);
+        (0, vitest_1.expect)(logSpy).toHaveBeenLastCalledWith("xyz");
+    });
+    (0, vitest_1.it)("--version should show program version and exit", async () => {
+        await prog.run(["--version"]);
+        (0, vitest_1.expect)(logSpy).toHaveBeenLastCalledWith("xyz");
+    });
+    (0, vitest_1.it)("--no-color should disable colors in output", async () => {
+        const action = function ({ logger }) {
+            logger.info("Hey!");
+        };
+        prog.argument("[first-arg]", "First argument").action(action);
+        await prog.run(["--no-color", "foo"]);
+        (0, vitest_1.expect)(loggerInfoSpy).toHaveBeenLastCalledWith("Hey!");
+    });
+    (0, vitest_1.it)("--color false should disable colors in output", async () => {
+        const action = function ({ logger }) {
+            logger.info("Joe!");
+        };
+        prog.argument("[first-arg]", "First argument").action(action);
+        await prog.run(["--color", "false", "foo"]);
+        (0, vitest_1.expect)(loggerInfoSpy).toHaveBeenLastCalledWith("Joe!");
+    });
+    (0, vitest_1.it)("-v should enable verbosity", async () => {
+        const action = function ({ logger }) {
+            logger.info("my-info");
+            logger.debug("my-debug");
+        };
+        prog.argument("[first-arg]", "First argument").action(action);
+        await prog.run(["foo"]);
+        (0, vitest_1.expect)(logStdoutSpy).toHaveBeenLastCalledWith(vitest_1.expect.stringContaining("my-info"));
+        await prog.run(["foo", "-v"]);
+        (0, vitest_1.expect)(logStdoutSpy).toHaveBeenLastCalledWith(vitest_1.expect.stringContaining("my-debug"));
+    });
+    (0, vitest_1.it)("--verbose should enable verbosity", async () => {
+        const action = function ({ logger }) {
+            logger.info("my-info");
+            logger.debug("my-debug");
+        };
+        prog.argument("[first-arg]", "First argument").action(action);
+        await prog.run(["foo"]);
+        (0, vitest_1.expect)(logStdoutSpy).toHaveBeenLastCalledWith(vitest_1.expect.stringContaining("my-info"));
+        await prog.run(["foo", "--verbose"]);
+        (0, vitest_1.expect)(logStdoutSpy).toHaveBeenLastCalledWith(vitest_1.expect.stringContaining("my-debug"));
+    });
+    (0, vitest_1.it)("--quiet should make the program only output warnings and errors", async () => {
+        const action = function ({ logger }) {
+            logger.info("my-info");
+            logger.debug("my-debug");
+            logger.warn("my-warn");
+            logger.error("my-error");
+        };
+        prog.argument("[first-arg]", "First argument").action(action);
+        await prog.run(["foo", "--quiet"]);
+        (0, vitest_1.expect)(logStdoutSpy).not.toHaveBeenCalledWith(vitest_1.expect.stringContaining("my-info"));
+        (0, vitest_1.expect)(logStdoutSpy).not.toHaveBeenCalledWith(vitest_1.expect.stringContaining("my-debug"));
+        (0, vitest_1.expect)(logStdoutSpy).toHaveBeenCalledWith(vitest_1.expect.stringContaining("my-warn"));
+        (0, vitest_1.expect)(logStdoutSpy).toHaveBeenCalledWith(vitest_1.expect.stringContaining("my-error"));
+    });
+    (0, vitest_1.it)("--silent should output nothing", async () => {
+        const action = function ({ logger }) {
+            logger.info("my-info");
+            logger.debug("my-debug");
+            logger.warn("my-warn");
+            logger.error("my-error");
+        };
+        prog.argument("[first-arg]", "First argument").action(action);
+        await prog.run(["foo", "--silent"]);
+        (0, vitest_1.expect)(logStdoutSpy).not.toHaveBeenCalled();
+    });
+    (0, vitest_1.it)("disableGlobalOption() should disable a global option by name or notation", async () => {
+        // by notation
+        (0, vitest_1.expect)((0, __1.findGlobalOption)("version")).toBeTruthy();
+        const result = (0, __1.disableGlobalOption)("-V");
+        (0, vitest_1.expect)(result).toBe(true);
+        (0, vitest_1.expect)((0, __1.findGlobalOption)("version")).toBeUndefined();
+        // by name
+        (0, vitest_1.expect)((0, __1.findGlobalOption)("help")).toBeTruthy();
+        const result2 = (0, __1.disableGlobalOption)("help");
+        (0, vitest_1.expect)(result2).toBe(true);
+        (0, vitest_1.expect)((0, __1.findGlobalOption)("help")).toBeUndefined();
+    });
+    (0, vitest_1.it)("disableGlobalOption() should return false for an unknown global option", async () => {
+        // by notation
+        const result = (0, __1.disableGlobalOption)("--unknown");
+        (0, vitest_1.expect)(result).toBe(false);
+        // by name
+        const result2 = (0, __1.disableGlobalOption)("unknown");
+        (0, vitest_1.expect)(result2).toBe(false);
+    });
+});
+//# sourceMappingURL=global.spec.js.map

package/dist/src/option/__tests__/global.spec.js.map

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

package/dist/src/option/__tests__/option.spec.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=option.spec.d.ts.map

package/dist/src/option/__tests__/option.spec.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"option.spec.d.ts","sourceRoot":"","sources":["../../../../src/option/__tests__/option.spec.ts"],"names":[],"mappings":""}

package/dist/src/option/__tests__/option.spec.js

@@ -0,0 +1,111 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const __1 = require("..");
+const error_1 = require("../../error");
+const vitest_1 = require("vitest");
+(0, vitest_1.describe)("createOption()", () => {
+    (0, vitest_1.it)("should create a basic short option", () => {
+        const opt = (0, __1.createOption)("-f <file>", "My simple option");
+        (0, vitest_1.expect)(opt).toMatchObject({
+            allNames: ["f"],
+            allNotations: ["-f"],
+            shortName: "f",
+            shortNotation: "-f",
+            description: "My simple option",
+            choices: [],
+            name: "f",
+            valueType: 1,
+            boolean: false,
+            valueRequired: true,
+            required: false,
+            synopsis: "-f <file>",
+            variadic: false,
+            visible: true,
+        });
+    });
+    (0, vitest_1.it)("should create a basic long option", () => {
+        const opt = (0, __1.createOption)("--file <file>", "My simple option");
+        (0, vitest_1.expect)(opt).toMatchObject({
+            allNames: ["file"],
+            allNotations: ["--file"],
+            longName: "file",
+            longNotation: "--file",
+            description: "My simple option",
+            choices: [],
+            name: "file",
+            valueType: 1,
+            boolean: false,
+            valueRequired: true,
+            required: false,
+            synopsis: "--file <file>",
+            variadic: false,
+            visible: true,
+        });
+    });
+    (0, vitest_1.it)("should create a short option without value", () => {
+        const opt = (0, __1.createOption)("-f", "My simple option");
+        (0, vitest_1.expect)(opt).toMatchObject({
+            allNames: ["f"],
+            allNotations: ["-f"],
+            shortName: "f",
+            shortNotation: "-f",
+            description: "My simple option",
+            choices: [],
+            name: "f",
+            boolean: true,
+            valueRequired: false,
+            valueType: 2,
+            default: false,
+            required: false,
+            synopsis: "-f",
+            variadic: false,
+            visible: true,
+        });
+    });
+    (0, vitest_1.it)("should create a short option with optional value", () => {
+        const opt = (0, __1.createOption)("-p [mean]", "My simple option");
+        (0, vitest_1.expect)(opt).toMatchObject({
+            allNames: ["p"],
+            allNotations: ["-p"],
+            shortName: "p",
+            shortNotation: "-p",
+            description: "My simple option",
+            choices: [],
+            name: "p",
+            boolean: false,
+            valueRequired: false,
+            valueType: 0,
+            required: false,
+            synopsis: "-p [mean]",
+            variadic: false,
+            visible: true,
+        });
+    });
+    (0, vitest_1.it)("should set choices if validator is an array", () => {
+        const opt = (0, __1.createOption)("-p [mean]", "My simple option", {
+            validator: ["card", "cash"],
+        });
+        (0, vitest_1.expect)(opt).toMatchObject({
+            allNames: ["p"],
+            allNotations: ["-p"],
+            shortName: "p",
+            shortNotation: "-p",
+            description: "My simple option",
+            choices: ["card", "cash"],
+            name: "p",
+            boolean: false,
+            typeHint: 'one of "card","cash"',
+            valueRequired: false,
+            validator: ["card", "cash"],
+            valueType: 0,
+            required: false,
+            synopsis: "-p [mean]",
+            variadic: false,
+            visible: true,
+        });
+    });
+    vitest_1.it.each([["bad synopsis"], ["another"], ["---fooo"]])("should throw for a malformed synopsis '%s'", (a) => {
+        (0, vitest_1.expect)(() => (0, __1.createOption)(a, "My simple option")).toThrowError(error_1.OptionSynopsisSyntaxError);
+    });
+});
+//# sourceMappingURL=option.spec.js.map

package/dist/src/option/__tests__/option.spec.js.map

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

package/dist/src/option/find.d.ts

@@ -0,0 +1,14 @@
+/**
+ * @packageDocumentation
+ * @internal
+ */
+import type { Command } from "../command";
+import type { Option } from "../types";
+/**
+ * Find an option from its name for a given command
+ *
+ * @param cmd Command object
+ * @param name Option name, short or long, camel-cased
+ */
+export declare function findOption(cmd: Command, name: string): Option | undefined;
+//# sourceMappingURL=find.d.ts.map

package/dist/src/option/find.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"find.d.ts","sourceRoot":"","sources":["../../../src/option/find.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AACzC,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAA;AAEtC;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,GAAG,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEzE"}

package/dist/src/option/find.js

@@ -0,0 +1,17 @@
+"use strict";
+/**
+ * @packageDocumentation
+ * @internal
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findOption = findOption;
+/**
+ * Find an option from its name for a given command
+ *
+ * @param cmd Command object
+ * @param name Option name, short or long, camel-cased
+ */
+function findOption(cmd, name) {
+    return cmd.options.find((o) => o.allNames.find((opt) => opt === name));
+}
+//# sourceMappingURL=find.js.map

package/dist/src/option/find.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"find.js","sourceRoot":"","sources":["../../../src/option/find.ts"],"names":[],"mappings":";AAAA;;;GAGG;;AAWH,gCAEC;AARD;;;;;GAKG;AACH,SAAgB,UAAU,CAAC,GAAY,EAAE,IAAY;IACnD,OAAO,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,GAAG,KAAK,IAAI,CAAC,CAAC,CAAA;AACxE,CAAC"}

package/dist/src/option/index.d.ts

@@ -0,0 +1,65 @@
+/**
+ * @packageDocumentation
+ * @module caporal/option
+ */
+import { Option, CreateOptionProgramOpts, CreateOptionCommandOpts, Action, GlobalOptions, ParserProcessedResult } from "../types";
+import type { Command } from "../command";
+import type { Program } from "../program";
+/**
+ * Create an Option object
+ *
+ * @internal
+ * @param synopsis
+ * @param description
+ * @param options
+ */
+export declare function createOption(synopsis: string, description: string, options?: CreateOptionProgramOpts | CreateOptionCommandOpts): Option;
+export { showHelp };
+/**
+ * Display help. Return false to prevent further processing.
+ *
+ * @internal
+ */
+declare const showHelp: Action;
+/**
+ * Get the list of registered global flags
+ *
+ * @internal
+ */
+export declare function getGlobalOptions(): GlobalOptions;
+export declare function resetGlobalOptions(): GlobalOptions;
+/**
+ * Disable a global option
+ *
+ * @param name Can be the option short/long name or notation
+ */
+export declare function disableGlobalOption(name: string): boolean;
+/**
+ * Add a global option to the program.
+ * A global option is available at the program level,
+ * and associated with one given {@link Action}.
+ *
+ * @param a {@link Option} instance, for example created using {@link createOption()}
+ */
+export declare function addGlobalOption(opt: Option, action?: Action): GlobalOptions;
+/**
+ * Process global options, if any
+ * @internal
+ */
+export declare function processGlobalOptions(parsed: ParserProcessedResult, program: Program, command?: Command): Promise<boolean>;
+/**
+ * Find a global Option action from the option name (short or long)
+ *
+ * @param name Short or long name
+ * @internal
+ */
+export declare function findGlobalOptAction(name: string): Action | undefined;
+/**
+ * Find a global Option by it's name (short or long)
+ *
+ * @param name Short or long name
+ * @internal
+ */
+export declare function findGlobalOption(name: string): Option | undefined;
+export declare function isOptionObject(obj: unknown): obj is Option;
+//# sourceMappingURL=index.d.ts.map

package/dist/src/option/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/option/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EACL,MAAM,EAEN,uBAAuB,EACvB,uBAAuB,EACvB,MAAM,EAEN,aAAa,EACb,qBAAqB,EACtB,MAAM,UAAU,CAAA;AAIjB,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AACzC,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAIzC;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC1B,QAAQ,EAAE,MAAM,EAChB,WAAW,EAAE,MAAM,EACnB,OAAO,GAAE,uBAAuB,GAAG,uBAA4B,GAC9D,MAAM,CA6BR;AAED,OAAO,EAAE,QAAQ,EAAE,CAAA;AAEnB;;;;GAIG;AACH,QAAA,MAAM,QAAQ,EAAE,MAyDb,CAAA;AASH;;;;GAIG;AACH,wBAAgB,gBAAgB,IAAI,aAAa,CAKhD;AA8CD,wBAAgB,kBAAkB,IAAI,aAAa,CAElD;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAQzD;AAED;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,MAAM,GAAG,aAAa,CAE3E;AAED;;;GAGG;AACH,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,qBAAqB,EAC7B,OAAO,EAAE,OAAO,EAChB,OAAO,CAAC,EAAE,OAAO,GAChB,OAAO,CAAC,OAAO,CAAC,CAYlB;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAOpE;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAOjE;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,GAAG,IAAI,MAAM,CAE1D"}

package/dist/src/option/index.js

@@ -0,0 +1,230 @@
+"use strict";
+/**
+ * @packageDocumentation
+ * @module caporal/option
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.showHelp = void 0;
+exports.createOption = createOption;
+exports.getGlobalOptions = getGlobalOptions;
+exports.resetGlobalOptions = resetGlobalOptions;
+exports.disableGlobalOption = disableGlobalOption;
+exports.addGlobalOption = addGlobalOption;
+exports.processGlobalOptions = processGlobalOptions;
+exports.findGlobalOptAction = findGlobalOptAction;
+exports.findGlobalOption = findGlobalOption;
+exports.isOptionObject = isOptionObject;
+const types_1 = require("../types");
+const utils_1 = require("../validator/utils");
+const utils_2 = require("./utils");
+const logger_1 = require("../logger");
+const help_1 = require("../help");
+const autocomplete_1 = require("../autocomplete");
+/**
+ * Create an Option object
+ *
+ * @internal
+ * @param synopsis
+ * @param description
+ * @param options
+ */
+function createOption(synopsis, description, options = {}) {
+    // eslint-disable-next-line prefer-const
+    let { validator, required, hidden } = options;
+    // force casting
+    required = Boolean(required);
+    (0, utils_1.checkValidator)(validator);
+    const syno = (0, utils_2.parseOptionSynopsis)(synopsis);
+    let boolean = syno.valueType === types_1.OptionValueType.None || (0, utils_1.isBoolValidator)(validator);
+    if (validator && !(0, utils_1.isBoolValidator)(validator)) {
+        boolean = false;
+    }
+    const opt = {
+        kind: "option",
+        default: boolean == true ? Boolean(options.default) : options.default,
+        description,
+        choices: Array.isArray(validator) ? validator : [],
+        ...syno,
+        required,
+        visible: !hidden,
+        boolean,
+        validator,
+    };
+    opt.typeHint = (0, utils_1.getTypeHint)(opt);
+    return opt;
+}
+/**
+ * Display help. Return false to prevent further processing.
+ *
+ * @internal
+ */
+const showHelp = async ({ program, command }) => {
+    const help = await (0, help_1.getHelp)(program, command);
+    // eslint-disable-next-line no-console
+    console.log(help);
+    program.emit("help", help);
+    return false;
+}, 
+/**
+ * Display program version. Return false to prevent further processing.
+ *
+ * @internal
+ */
+showVersion = ({ program }) => {
+    // eslint-disable-next-line no-console
+    console.log(program.getVersion());
+    program.emit("version", program.getVersion());
+    return false;
+}, 
+/**
+ * Disable colors in output
+ *
+ * @internal
+ */
+disableColors = ({ logger }) => {
+    logger.disableColors();
+}, 
+/**
+ * Set verbosity to the maximum
+ *
+ * @internal
+ */
+setVerbose = ({ logger }) => {
+    logger.level = "silly";
+}, 
+/**
+ * Makes the program quiet, eg displaying logs with level >= warning
+ */
+setQuiet = ({ logger }) => {
+    logger.level = "warn";
+}, 
+/**
+ * Makes the program totally silent
+ */
+setSilent = ({ logger }) => {
+    logger.silent = true;
+}, 
+/**
+ * Install completion
+ */
+installComp = ({ program }) => {
+    return (0, autocomplete_1.installCompletion)(program);
+}, 
+/**
+ * Uninstall completion
+ */
+uninstallComp = ({ program }) => {
+    return (0, autocomplete_1.uninstallCompletion)(program);
+};
+exports.showHelp = showHelp;
+/**
+ * Global options container
+ *
+ * @internal
+ */
+let globalOptions;
+/**
+ * Get the list of registered global flags
+ *
+ * @internal
+ */
+function getGlobalOptions() {
+    if (globalOptions === undefined) {
+        globalOptions = setupGlobalOptions();
+    }
+    return globalOptions;
+}
+/**
+ * Set up the global flags
+ *
+ * @internal
+ */
+function setupGlobalOptions() {
+    const help = createOption("-h, --help", "Display global help or command-related help."), verbose = createOption("-v, --verbose", "Verbose mode: will also output debug messages."), quiet = createOption("--quiet", "Quiet mode - only displays warn and error messages."), silent = createOption("--silent", "Silent mode: does not output anything, giving no indication of success or failure other than the exit code."), version = createOption("-V, --version", "Display version."), color = createOption("--no-color", "Disable use of colors in output."), installCompOpt = createOption("--install-completion", "Install completion for your shell.", { hidden: true }), uninstallCompOpt = createOption("--uninstall-completion", "Uninstall completion for your shell.", { hidden: true });
+    return new Map([
+        [help, showHelp],
+        [version, showVersion],
+        [color, disableColors],
+        [verbose, setVerbose],
+        [quiet, setQuiet],
+        [silent, setSilent],
+        [installCompOpt, installComp],
+        [uninstallCompOpt, uninstallComp],
+    ]);
+}
+function resetGlobalOptions() {
+    return (globalOptions = setupGlobalOptions());
+}
+/**
+ * Disable a global option
+ *
+ * @param name Can be the option short/long name or notation
+ */
+function disableGlobalOption(name) {
+    const opts = getGlobalOptions();
+    for (const [opt] of opts) {
+        if (opt.allNames.includes(name) || opt.allNotations.includes(name)) {
+            return opts.delete(opt);
+        }
+    }
+    return false;
+}
+/**
+ * Add a global option to the program.
+ * A global option is available at the program level,
+ * and associated with one given {@link Action}.
+ *
+ * @param a {@link Option} instance, for example created using {@link createOption()}
+ */
+function addGlobalOption(opt, action) {
+    return getGlobalOptions().set(opt, action);
+}
+/**
+ * Process global options, if any
+ * @internal
+ */
+async function processGlobalOptions(parsed, program, command) {
+    const { options } = parsed;
+    const actionsParams = { ...parsed, logger: logger_1.logger, program, command };
+    const promises = Object.entries(options).map(([opt]) => {
+        const action = findGlobalOptAction(opt);
+        if (action) {
+            return action(actionsParams);
+        }
+        return undefined;
+    });
+    const results = await Promise.all(promises);
+    return results.some((r) => r === false);
+}
+/**
+ * Find a global Option action from the option name (short or long)
+ *
+ * @param name Short or long name
+ * @internal
+ */
+function findGlobalOptAction(name) {
+    for (const [opt, action] of getGlobalOptions()) {
+        if (opt.allNames.includes(name)) {
+            return action;
+        }
+    }
+    return undefined;
+}
+/**
+ * Find a global Option by it's name (short or long)
+ *
+ * @param name Short or long name
+ * @internal
+ */
+function findGlobalOption(name) {
+    for (const [opt] of getGlobalOptions()) {
+        if (opt.allNames.includes(name)) {
+            return opt;
+        }
+    }
+    return undefined;
+}
+function isOptionObject(obj) {
+    return typeof obj == "object" && obj !== null && obj.kind == "option";
+}
+//# sourceMappingURL=index.js.map

package/dist/src/option/index.js.map

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

package/dist/src/option/mapping.d.ts

@@ -0,0 +1,7 @@
+/**
+ * @packageDocumentation
+ * @internal
+ */
+import type { Command } from "../command";
+export declare function getOptsMapping(cmd: Command): Record<string, string>;
+//# sourceMappingURL=mapping.d.ts.map

package/dist/src/option/mapping.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapping.d.ts","sourceRoot":"","sources":["../../../src/option/mapping.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAA;AAMzC,wBAAgB,cAAc,CAAC,GAAG,EAAE,OAAO,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAKnE"}

package/dist/src/option/mapping.js

@@ -0,0 +1,21 @@
+"use strict";
+/**
+ * @packageDocumentation
+ * @internal
+ */
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getOptsMapping = getOptsMapping;
+const map_1 = __importDefault(require("lodash/map"));
+const zipObject_1 = __importDefault(require("lodash/zipObject"));
+const invert_1 = __importDefault(require("lodash/invert"));
+const pickBy_1 = __importDefault(require("lodash/pickBy"));
+function getOptsMapping(cmd) {
+    const names = (0, map_1.default)(cmd.options, "name");
+    const aliases = (0, map_1.default)(cmd.options, (o) => o.shortName || o.longName);
+    const result = (0, zipObject_1.default)(names, aliases);
+    return (0, pickBy_1.default)({ ...result, ...(0, invert_1.default)(result) });
+}
+//# sourceMappingURL=mapping.js.map

package/dist/src/option/mapping.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mapping.js","sourceRoot":"","sources":["../../../src/option/mapping.ts"],"names":[],"mappings":";AAAA;;;GAGG;;;;;AAQH,wCAKC;AAVD,qDAA4B;AAC5B,iEAAwC;AACxC,2DAAkC;AAClC,2DAAkC;AAElC,SAAgB,cAAc,CAAC,GAAY;IACzC,MAAM,KAAK,GAAG,IAAA,aAAG,EAAC,GAAG,CAAC,OAAO,EAAE,MAAM,CAAC,CAAA;IACtC,MAAM,OAAO,GAAG,IAAA,aAAG,EAAC,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,QAAQ,CAAC,CAAA;IAClE,MAAM,MAAM,GAAG,IAAA,mBAAS,EAAC,KAAK,EAAE,OAAO,CAAC,CAAA;IACxC,OAAO,IAAA,gBAAM,EAAC,EAAE,GAAG,MAAM,EAAE,GAAG,IAAA,gBAAM,EAAC,MAAM,CAAC,EAAE,CAA2B,CAAA;AAC3E,CAAC"}