inray 0.0.4 → 0.0.6

package/dist/cli/src/lib/option.d.ts

@@ -0,0 +1,189 @@
+/**
+ * Original library: commander.js (v15.0.0)
+ * - Copyright (c) 2011 TJ Holowaychuk
+ * - Copyright (c) John Gee and "commander.js" authors
+ *
+ * Modified and integrated in "Inray":
+ * - Evgeniy Bushin
+ */
+/***/
+import type { ArgumentParseFunction } from './argument.ts';
+export type OptionValues = Record<string, any>;
+export declare class Option {
+    flags: string;
+    description: string;
+    required: boolean;
+    optional: boolean;
+    variadic: boolean;
+    mandatory: boolean;
+    short?: string;
+    long?: string;
+    negate: boolean;
+    defaultValue?: any;
+    defaultValueDescription?: string;
+    presetArg?: unknown;
+    envVar?: string;
+    parseArg?: ArgumentParseFunction;
+    hidden: boolean;
+    argChoices?: string[];
+    helpGroupHeading?: string;
+    conflictsWith: string[];
+    implied: OptionValues | undefined;
+    /**
+     * Initialize a new `Option` with the given `flags` and `description`.
+     *
+     * @param {string} flags
+     * @param {string} [description]
+     */
+    constructor(flags: string, description?: string);
+    /**
+     * Set the default value, and optionally supply the description to be displayed in the help.
+     *
+     * @param {*} value
+     * @param {string} [description]
+     * @return {Option}
+     */
+    default(value: unknown, description?: string): this;
+    /**
+     * Preset to use when option used without option-argument, especially optional but also boolean and negated.
+     * The custom processing (parseArg) is called.
+     *
+     * @example
+     * new Option('--color').default('GREYSCALE').preset('RGB');
+     * new Option('--donate [amount]').preset('20').argParser(parseFloat);
+     *
+     * @param {*} arg
+     * @return {Option}
+     */
+    preset(arg: unknown): this;
+    /**
+     * Add option name(s) that conflict with this option.
+     * An error will be displayed if conflicting options are found during parsing.
+     *
+     * @example
+     * new Option('--rgb').conflicts('cmyk');
+     * new Option('--js').conflicts(['ts', 'jsx']);
+     *
+     * @param {(string | string[])} names
+     * @return {Option}
+     */
+    conflicts(names: string | string[]): this;
+    /**
+     * Specify implied option values for when this option is set and the implied options are not.
+     *
+     * The custom processing (parseArg) is not called on the implied values.
+     *
+     * @example
+     * program
+     *   .addOption(new Option('--log', 'write logging information to file'))
+     *   .addOption(new Option('--trace', 'log extra details').implies({ log: 'trace.txt' }));
+     *
+     * @param {object} impliedOptionValues
+     * @return {Option}
+     */
+    implies(impliedOptionValues: OptionValues): this;
+    /**
+     * Set environment variable to check for option value.
+     *
+     * An environment variable is only used if when processed the current option value is
+     * undefined, or the source of the current value is 'default' or 'config' or 'env'.
+     *
+     * @param {string} name
+     * @return {Option}
+     */
+    env(name: string): this;
+    /**
+     * Set the custom handler for processing CLI option arguments into option values.
+     *
+     * @param {Function} [fn]
+     * @return {Option}
+     */
+    argParser(fn: ArgumentParseFunction): this;
+    /**
+     * Whether the option is mandatory and must have a value after parsing.
+     *
+     * @param {boolean} [mandatory=true]
+     * @return {Option}
+     */
+    makeOptionMandatory(mandatory?: boolean): this;
+    /**
+     * Hide option in help.
+     *
+     * @param {boolean} [hide=true]
+     * @return {Option}
+     */
+    hideHelp(hide?: boolean): this;
+    /**
+     * @package
+     */
+    _collectValue(value: any, previous: any | Array<any>): Array<any>;
+    /**
+     * Only allow option value to be one of choices.
+     *
+     * @param {string[]} values
+     * @return {Option}
+     */
+    choices(values: readonly string[]): this;
+    /**
+     * Return option name.
+     *
+     * @return {string}
+     */
+    name(): string;
+    /**
+     * Return option name, in a camelcase format that can be used
+     * as an object attribute key.
+     *
+     * @return {string}
+     */
+    attributeName(): string;
+    /**
+     * Set the help group heading.
+     *
+     * @param {string} heading
+     * @return {Option}
+     */
+    helpGroup(heading: string): this;
+    /**
+     * Check if `arg` matches the short or long flag.
+     *
+     * @param {string} arg
+     * @return {boolean}
+     * @package
+     */
+    is(arg: string): boolean;
+    /**
+     * Return whether a boolean option.
+     *
+     * Options are one of boolean, negated, required argument, or optional argument.
+     *
+     * @return {boolean}
+     * @package
+     */
+    isBoolean(): boolean;
+}
+/**
+ * This class is to make it easier to work with dual options, without changing the existing
+ * implementation. We support separate dual options for separate positive and negative options,
+ * like `--build` and `--no-build`, which share a single option value. This works nicely for some
+ * use cases, but is tricky for others where we want separate behaviours despite
+ * the single shared option value.
+ */
+export declare class DualOptions {
+    positiveOptions: Map<string, Option>;
+    negativeOptions: Map<string, Option>;
+    dualOptions: Set<string>;
+    /**
+     * @param {Option[]} options
+     */
+    constructor(options: readonly Option[]);
+    /**
+     * Did the value come from the option, and not from possible matching dual option?
+     *
+     * @param {*} value
+     * @param {Option} option
+     * @returns {boolean}
+     */
+    valueFromOption(value: any, option: Option): boolean;
+}
+//# sourceMappingURL=option.d.ts.map

package/dist/cli/src/lib/option.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"option.d.ts","sourceRoot":"","sources":["../../../../src/cli/src/lib/option.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,KAAK;AAEL,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAC;AAG3D,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAE/C,qBAAa,MAAM;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IAEpB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,OAAO,CAAC;IAEnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,MAAM,EAAE,OAAO,CAAC;IAEhB,YAAY,CAAC,EAAE,GAAG,CAAC;IACnB,uBAAuB,CAAC,EAAE,MAAM,CAAC;IACjC,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,QAAQ,CAAC,EAAE,qBAAqB,CAAC;IACjC,MAAM,EAAE,OAAO,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAE1B,aAAa,EAAE,MAAM,EAAE,CAAC;IACxB,OAAO,EAAE,YAAY,GAAG,SAAS,CAAC;IAElC;;;;;OAKG;gBACS,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM;IA4B/C;;;;;;OAMG;IACH,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,WAAW,CAAC,EAAE,MAAM,GAAG,IAAI;IAMnD;;;;;;;;;;OAUG;IACH,MAAM,CAAC,GAAG,EAAE,OAAO,GAAG,IAAI;IAK1B;;;;;;;;;;OAUG;IACH,SAAS,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,GAAG,IAAI;IAKzC;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,mBAAmB,EAAE,YAAY,GAAG,IAAI;IAUhD;;;;;;;;OAQG;IACH,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI;IAKvB;;;;;OAKG;IACH,SAAS,CAAC,EAAE,EAAE,qBAAqB,GAAG,IAAI;IAK1C;;;;;OAKG;IACH,mBAAmB,CAAC,SAAS,UAAO,GAAG,IAAI;IAK3C;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,UAAO,GAAG,IAAI;IAK3B;;OAEG;IACH,aAAa,CAAC,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,GAAG,KAAK,CAAC,GAAG,CAAC;IAQjE;;;;;OAKG;IACH,OAAO,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,GAAG,IAAI;IAcxC;;;;OAIG;IACH,IAAI,IAAI,MAAM;IAOd;;;;;OAKG;IACH,aAAa,IAAI,MAAM;IAOvB;;;;;OAKG;IACH,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAKhC;;;;;;OAMG;IACH,EAAE,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIxB;;;;;;;OAOG;IACH,SAAS,IAAI,OAAO;CAGrB;AAED;;;;;;GAMG;AACH,qBAAa,WAAW;IACtB,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,eAAe,EAAE,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IACrC,WAAW,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;IAEzB;;OAEG;gBACS,OAAO,EAAE,SAAS,MAAM,EAAE;IAkBtC;;;;;;OAMG;IACH,eAAe,CAAC,KAAK,EAAE,GAAG,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO;CASrD"}

package/dist/cli/src/lib/option.js

@@ -0,0 +1,364 @@
+/**
+ * Original library: commander.js (v15.0.0)
+ * - Copyright (c) 2011 TJ Holowaychuk
+ * - Copyright (c) John Gee and "commander.js" authors
+ *
+ * Modified and integrated in "Inray":
+ * - Evgeniy Bushin
+ */
+/***/
+import { InvalidArgumentError } from "./error.js";
+export class Option {
+    flags;
+    description;
+    required;
+    optional;
+    variadic;
+    mandatory;
+    short;
+    long;
+    negate;
+    defaultValue;
+    defaultValueDescription;
+    presetArg;
+    envVar;
+    parseArg; // TODO с T , Function
+    hidden;
+    argChoices;
+    helpGroupHeading;
+    conflictsWith;
+    implied;
+    /**
+     * Initialize a new `Option` with the given `flags` and `description`.
+     *
+     * @param {string} flags
+     * @param {string} [description]
+     */
+    constructor(flags, description) {
+        this.flags = flags;
+        this.description = description || '';
+        this.required = flags.includes('<'); // A value must be supplied when the option is specified.
+        this.optional = flags.includes('['); // A value is optional when the option is specified.
+        // variadic test ignores <value,...> et al which might be used to describe custom splitting of single argument
+        this.variadic = /\w\.\.\.[>\]]$/.test(flags); // The option can take multiple values.
+        this.mandatory = false; // The option must have a value after parsing, which usually means it must be specified on command line.
+        const optionFlags = splitOptionFlags(flags);
+        this.short = optionFlags.shortFlag; // May be a short flag, undefined, or even a long flag (if option has two long flags).
+        this.long = optionFlags.longFlag;
+        this.negate = false;
+        if (this.long) {
+            this.negate = this.long.startsWith('--no-');
+        }
+        this.defaultValue = undefined;
+        this.defaultValueDescription = undefined;
+        this.presetArg = undefined;
+        this.envVar = undefined;
+        this.parseArg = undefined;
+        this.hidden = false;
+        this.argChoices = undefined;
+        this.conflictsWith = [];
+        this.implied = undefined;
+        this.helpGroupHeading = undefined; // soft initialised when option added to command
+    }
+    /**
+     * Set the default value, and optionally supply the description to be displayed in the help.
+     *
+     * @param {*} value
+     * @param {string} [description]
+     * @return {Option}
+     */
+    default(value, description) {
+        this.defaultValue = value;
+        this.defaultValueDescription = description;
+        return this;
+    }
+    /**
+     * Preset to use when option used without option-argument, especially optional but also boolean and negated.
+     * The custom processing (parseArg) is called.
+     *
+     * @example
+     * new Option('--color').default('GREYSCALE').preset('RGB');
+     * new Option('--donate [amount]').preset('20').argParser(parseFloat);
+     *
+     * @param {*} arg
+     * @return {Option}
+     */
+    preset(arg) {
+        this.presetArg = arg;
+        return this;
+    }
+    /**
+     * Add option name(s) that conflict with this option.
+     * An error will be displayed if conflicting options are found during parsing.
+     *
+     * @example
+     * new Option('--rgb').conflicts('cmyk');
+     * new Option('--js').conflicts(['ts', 'jsx']);
+     *
+     * @param {(string | string[])} names
+     * @return {Option}
+     */
+    conflicts(names) {
+        this.conflictsWith = this.conflictsWith.concat(names);
+        return this;
+    }
+    /**
+     * Specify implied option values for when this option is set and the implied options are not.
+     *
+     * The custom processing (parseArg) is not called on the implied values.
+     *
+     * @example
+     * program
+     *   .addOption(new Option('--log', 'write logging information to file'))
+     *   .addOption(new Option('--trace', 'log extra details').implies({ log: 'trace.txt' }));
+     *
+     * @param {object} impliedOptionValues
+     * @return {Option}
+     */
+    implies(impliedOptionValues) {
+        let newImplied = impliedOptionValues;
+        if (typeof impliedOptionValues === 'string') {
+            // string is not documented, but easy mistake and we can do what user probably intended.
+            newImplied = { [impliedOptionValues]: true };
+        }
+        this.implied = Object.assign(this.implied || {}, newImplied);
+        return this;
+    }
+    /**
+     * Set environment variable to check for option value.
+     *
+     * An environment variable is only used if when processed the current option value is
+     * undefined, or the source of the current value is 'default' or 'config' or 'env'.
+     *
+     * @param {string} name
+     * @return {Option}
+     */
+    env(name) {
+        this.envVar = name;
+        return this;
+    }
+    /**
+     * Set the custom handler for processing CLI option arguments into option values.
+     *
+     * @param {Function} [fn]
+     * @return {Option}
+     */
+    argParser(fn) {
+        this.parseArg = fn;
+        return this;
+    }
+    /**
+     * Whether the option is mandatory and must have a value after parsing.
+     *
+     * @param {boolean} [mandatory=true]
+     * @return {Option}
+     */
+    makeOptionMandatory(mandatory = true) {
+        this.mandatory = !!mandatory;
+        return this;
+    }
+    /**
+     * Hide option in help.
+     *
+     * @param {boolean} [hide=true]
+     * @return {Option}
+     */
+    hideHelp(hide = true) {
+        this.hidden = !!hide;
+        return this;
+    }
+    /**
+     * @package
+     */
+    _collectValue(value, previous) {
+        if (previous === this.defaultValue || !Array.isArray(previous)) {
+            return [value];
+        }
+        previous.push(value);
+        return previous;
+    }
+    /**
+     * Only allow option value to be one of choices.
+     *
+     * @param {string[]} values
+     * @return {Option}
+     */
+    choices(values) {
+        this.argChoices = values.slice();
+        this.parseArg = (arg, previous) => {
+            if (this.argChoices && !this.argChoices.includes(arg)) {
+                throw new InvalidArgumentError(`Allowed choices are ${this.argChoices.join(', ')}.`);
+            }
+            if (this.variadic) {
+                return this._collectValue(arg, previous);
+            }
+            return arg;
+        };
+        return this;
+    }
+    /**
+     * Return option name.
+     *
+     * @return {string}
+     */
+    name() {
+        if (this.long) {
+            return this.long.replace(/^--/, '');
+        }
+        return this.short?.replace(/^-/, '') ?? ''; // TODO
+    }
+    /**
+     * Return option name, in a camelcase format that can be used
+     * as an object attribute key.
+     *
+     * @return {string}
+     */
+    attributeName() {
+        if (this.negate) {
+            return camelcase(this.name().replace(/^no-/, ''));
+        }
+        return camelcase(this.name());
+    }
+    /**
+     * Set the help group heading.
+     *
+     * @param {string} heading
+     * @return {Option}
+     */
+    helpGroup(heading) {
+        this.helpGroupHeading = heading;
+        return this;
+    }
+    /**
+     * Check if `arg` matches the short or long flag.
+     *
+     * @param {string} arg
+     * @return {boolean}
+     * @package
+     */
+    is(arg) {
+        return this.short === arg || this.long === arg;
+    }
+    /**
+     * Return whether a boolean option.
+     *
+     * Options are one of boolean, negated, required argument, or optional argument.
+     *
+     * @return {boolean}
+     * @package
+     */
+    isBoolean() {
+        return !this.required && !this.optional && !this.negate;
+    }
+}
+/**
+ * This class is to make it easier to work with dual options, without changing the existing
+ * implementation. We support separate dual options for separate positive and negative options,
+ * like `--build` and `--no-build`, which share a single option value. This works nicely for some
+ * use cases, but is tricky for others where we want separate behaviours despite
+ * the single shared option value.
+ */
+export class DualOptions {
+    positiveOptions;
+    negativeOptions;
+    dualOptions;
+    /**
+     * @param {Option[]} options
+     */
+    constructor(options) {
+        this.positiveOptions = new Map();
+        this.negativeOptions = new Map();
+        this.dualOptions = new Set();
+        options.forEach((option) => {
+            if (option.negate) {
+                this.negativeOptions.set(option.attributeName(), option);
+            }
+            else {
+                this.positiveOptions.set(option.attributeName(), option);
+            }
+        });
+        this.negativeOptions.forEach((_value, key) => {
+            if (this.positiveOptions.has(key)) {
+                this.dualOptions.add(key);
+            }
+        });
+    }
+    /**
+     * Did the value come from the option, and not from possible matching dual option?
+     *
+     * @param {*} value
+     * @param {Option} option
+     * @returns {boolean}
+     */
+    valueFromOption(value, option) {
+        const optionKey = option.attributeName();
+        if (!this.dualOptions.has(optionKey))
+            return true;
+        // Use the value to deduce if (probably) came from the option.
+        const preset = this.negativeOptions.get(optionKey)?.presetArg;
+        const negativeValue = preset !== undefined ? preset : false;
+        return option.negate === (negativeValue === value);
+    }
+}
+/**
+ * Convert string from kebab-case to camelCase.
+ *
+ * @param {string} str
+ * @return {string}
+ * @private
+ */
+function camelcase(str) {
+    return str.split('-').reduce((str, word) => {
+        return str + word[0].toUpperCase() + word.slice(1);
+    });
+}
+/**
+ * Split the short and long flag out of something like '-m,--mixed <value>'
+ *
+ * @private
+ */
+function splitOptionFlags(flags) {
+    let shortFlag;
+    let longFlag;
+    // short flag, single dash and single character
+    const shortFlagExp = /^-[^-]$/;
+    // long flag, double dash and at least one character
+    const longFlagExp = /^--[^-]/;
+    const flagParts = flags.split(/[ |,]+/).concat('guard');
+    // Normal is short and/or long.
+    if (shortFlagExp.test(flagParts[0]))
+        shortFlag = flagParts.shift();
+    if (longFlagExp.test(flagParts[0]))
+        longFlag = flagParts.shift();
+    // Long then short. Rarely used but fine.
+    if (!shortFlag && shortFlagExp.test(flagParts[0]))
+        shortFlag = flagParts.shift();
+    // Allow two long flags, like '--ws, --workspace'
+    // This is the supported way to have a shortish option flag.
+    if (!shortFlag && longFlagExp.test(flagParts[0])) {
+        shortFlag = longFlag;
+        longFlag = flagParts.shift();
+    }
+    // Check for unprocessed flag. Fail noisily rather than silently ignore.
+    if (flagParts[0].startsWith('-')) {
+        const unsupportedFlag = flagParts[0];
+        const baseError = `option creation failed due to '${unsupportedFlag}' in option flags '${flags}'`;
+        if (/^-[^-][^-]/.test(unsupportedFlag))
+            throw new Error(`${baseError}
+- a short flag is a single dash and a single character
+  - either use a single dash and a single character (for a short flag)
+  - or use a double dash for a long option (and can have two, like '--ws, --workspace')`);
+        if (shortFlagExp.test(unsupportedFlag))
+            throw new Error(`${baseError}
+- too many short flags`);
+        if (longFlagExp.test(unsupportedFlag))
+            throw new Error(`${baseError}
+- too many long flags`);
+        throw new Error(`${baseError}
+- unrecognised flag format`);
+    }
+    if (shortFlag === undefined && longFlag === undefined)
+        throw new Error(`option creation failed due to no flags found in '${flags}'.`);
+    return { shortFlag, longFlag };
+}
+//# sourceMappingURL=option.js.map

package/dist/cli/src/lib/option.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"option.js","sourceRoot":"","sources":["../../../../src/cli/src/lib/option.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,KAAK;AAGL,OAAO,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAIlD,MAAM,OAAO,MAAM;IACjB,KAAK,CAAS;IACd,WAAW,CAAS;IAEpB,QAAQ,CAAU;IAClB,QAAQ,CAAU;IAClB,QAAQ,CAAU;IAClB,SAAS,CAAU;IAEnB,KAAK,CAAU;IACf,IAAI,CAAU;IAEd,MAAM,CAAU;IAEhB,YAAY,CAAO;IACnB,uBAAuB,CAAU;IACjC,SAAS,CAAW;IACpB,MAAM,CAAU;IAChB,QAAQ,CAAyB,CAAC,sBAAsB;IACxD,MAAM,CAAU;IAChB,UAAU,CAAY;IACtB,gBAAgB,CAAU;IAE1B,aAAa,CAAW;IACxB,OAAO,CAA2B;IAElC;;;;;OAKG;IACH,YAAY,KAAa,EAAE,WAAoB;QAC7C,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,WAAW,GAAG,WAAW,IAAI,EAAE,CAAC;QAErC,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,yDAAyD;QAC9F,IAAI,CAAC,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,oDAAoD;QACzF,8GAA8G;QAC9G,IAAI,CAAC,QAAQ,GAAG,gBAAgB,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,uCAAuC;QACrF,IAAI,CAAC,SAAS,GAAG,KAAK,CAAC,CAAC,wGAAwG;QAChI,MAAM,WAAW,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;QAC5C,IAAI,CAAC,KAAK,GAAG,WAAW,CAAC,SAAS,CAAC,CAAC,sFAAsF;QAC1H,IAAI,CAAC,IAAI,GAAG,WAAW,CAAC,QAAQ,CAAC;QACjC,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QAC9C,CAAC;QACD,IAAI,CAAC,YAAY,GAAG,SAAS,CAAC;QAC9B,IAAI,CAAC,uBAAuB,GAAG,SAAS,CAAC;QACzC,IAAI,CAAC,SAAS,GAAG,SAAS,CAAC;QAC3B,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;QACxB,IAAI,CAAC,QAAQ,GAAG,SAAS,CAAC;QAC1B,IAAI,CAAC,MAAM,GAAG,KAAK,CAAC;QACpB,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;QAC5B,IAAI,CAAC,aAAa,GAAG,EAAE,CAAC;QACxB,IAAI,CAAC,OAAO,GAAG,SAAS,CAAC;QACzB,IAAI,CAAC,gBAAgB,GAAG,SAAS,CAAC,CAAC,gDAAgD;IACrF,CAAC;IAED;;;;;;OAMG;IACH,OAAO,CAAC,KAAc,EAAE,WAAoB;QAC1C,IAAI,CAAC,YAAY,GAAG,KAAK,CAAC;QAC1B,IAAI,CAAC,uBAAuB,GAAG,WAAW,CAAC;QAC3C,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;;;;OAUG;IACH,MAAM,CAAC,GAAY;QACjB,IAAI,CAAC,SAAS,GAAG,GAAG,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;;;;OAUG;IACH,SAAS,CAAC,KAAwB;QAChC,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACtD,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;;;;;;OAYG;IACH,OAAO,CAAC,mBAAiC;QACvC,IAAI,UAAU,GAAG,mBAAmB,CAAC;QACrC,IAAI,OAAO,mBAAmB,KAAK,QAAQ,EAAE,CAAC;YAC5C,wFAAwF;YACxF,UAAU,GAAG,EAAE,CAAC,mBAAmB,CAAC,EAAE,IAAI,EAAE,CAAC;QAC/C,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,IAAI,EAAE,EAAE,UAAU,CAAC,CAAC;QAC7D,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;;;OAQG;IACH,GAAG,CAAC,IAAY;QACd,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACH,SAAS,CAAC,EAAyB;QACjC,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC;QACnB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACH,mBAAmB,CAAC,SAAS,GAAG,IAAI;QAClC,IAAI,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;OAKG;IACH,QAAQ,CAAC,IAAI,GAAG,IAAI;QAClB,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,CAAC;QACrB,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;OAEG;IACH,aAAa,CAAC,KAAU,EAAE,QAA0B;QAClD,IAAI,QAAQ,KAAK,IAAI,CAAC,YAAY,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC/D,OAAO,CAAC,KAAK,CAAC,CAAC;QACjB,CAAC;QACD,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACrB,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;;;;OAKG;IACH,OAAO,CAAC,MAAyB;QAC/B,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC;QACjC,IAAI,CAAC,QAAQ,GAAG,CAAC,GAAQ,EAAE,QAA0B,EAAE,EAAE;YACvD,IAAI,IAAI,CAAC,UAAU,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC;gBACtD,MAAM,IAAI,oBAAoB,CAAC,uBAAuB,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;YACvF,CAAC;YACD,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBAClB,OAAO,IAAI,CAAC,aAAa,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;YAC3C,CAAC;YACD,OAAO,GAAG,CAAC;QACb,CAAC,CAAC;QACF,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;OAIG;IACH,IAAI;QACF,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC;YACd,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACtC,CAAC;QACD,OAAO,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO;IACrD,CAAC;IAED;;;;;OAKG;IACH,aAAa;QACX,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,OAAO,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,CAAC;QACpD,CAAC;QACD,OAAO,SAAS,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;IAChC,CAAC;IAED;;;;;OAKG;IACH,SAAS,CAAC,OAAe;QACvB,IAAI,CAAC,gBAAgB,GAAG,OAAO,CAAC;QAChC,OAAO,IAAI,CAAC;IACd,CAAC;IAED;;;;;;OAMG;IACH,EAAE,CAAC,GAAW;QACZ,OAAO,IAAI,CAAC,KAAK,KAAK,GAAG,IAAI,IAAI,CAAC,IAAI,KAAK,GAAG,CAAC;IACjD,CAAC;IAED;;;;;;;OAOG;IACH,SAAS;QACP,OAAO,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,QAAQ,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC;IAC1D,CAAC;CACF;AAED;;;;;;GAMG;AACH,MAAM,OAAO,WAAW;IACtB,eAAe,CAAsB;IACrC,eAAe,CAAsB;IACrC,WAAW,CAAc;IAEzB;;OAEG;IACH,YAAY,OAA0B;QACpC,IAAI,CAAC,eAAe,GAAG,IAAI,GAAG,EAAE,CAAC;QACjC,IAAI,CAAC,eAAe,GAAG,IAAI,GAAG,EAAE,CAAC;QACjC,IAAI,CAAC,WAAW,GAAG,IAAI,GAAG,EAAE,CAAC;QAC7B,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE;YACzB,IAAI,MAAM,CAAC,MAAM,EAAE,CAAC;gBAClB,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,aAAa,EAAE,EAAE,MAAM,CAAC,CAAC;YAC3D,CAAC;iBAAM,CAAC;gBACN,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,aAAa,EAAE,EAAE,MAAM,CAAC,CAAC;YAC3D,CAAC;QACH,CAAC,CAAC,CAAC;QACH,IAAI,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE;YAC3C,IAAI,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;gBAClC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;YAC5B,CAAC;QACH,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;;OAMG;IACH,eAAe,CAAC,KAAU,EAAE,MAAc;QACxC,MAAM,SAAS,GAAG,MAAM,CAAC,aAAa,EAAE,CAAC;QACzC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC;YAAE,OAAO,IAAI,CAAC;QAElD,8DAA8D;QAC9D,MAAM,MAAM,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,SAAS,CAAC;QAC9D,MAAM,aAAa,GAAG,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC;QAC5D,OAAO,MAAM,CAAC,MAAM,KAAK,CAAC,aAAa,KAAK,KAAK,CAAC,CAAC;IACrD,CAAC;CACF;AAED;;;;;;GAMG;AACH,SAAS,SAAS,CAAC,GAAW;IAC5B,OAAO,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,IAAI,EAAE,EAAE;QACzC,OAAO,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;;GAIG;AACH,SAAS,gBAAgB,CAAC,KAAa;IAIrC,IAAI,SAAS,CAAC;IACd,IAAI,QAAQ,CAAC;IACb,+CAA+C;IAC/C,MAAM,YAAY,GAAG,SAAS,CAAC;IAC/B,oDAAoD;IACpD,MAAM,WAAW,GAAG,SAAS,CAAC;IAE9B,MAAM,SAAS,GAAG,KAAK,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;IACxD,+BAA+B;IAC/B,IAAI,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;QAAE,SAAS,GAAG,SAAS,CAAC,KAAK,EAAE,CAAC;IACnE,IAAI,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;QAAE,QAAQ,GAAG,SAAS,CAAC,KAAK,EAAE,CAAC;IACjE,yCAAyC;IACzC,IAAI,CAAC,SAAS,IAAI,YAAY,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC;QAAE,SAAS,GAAG,SAAS,CAAC,KAAK,EAAE,CAAC;IACjF,iDAAiD;IACjD,4DAA4D;IAC5D,IAAI,CAAC,SAAS,IAAI,WAAW,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACjD,SAAS,GAAG,QAAQ,CAAC;QACrB,QAAQ,GAAG,SAAS,CAAC,KAAK,EAAE,CAAC;IAC/B,CAAC;IAED,wEAAwE;IACxE,IAAI,SAAS,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QACjC,MAAM,eAAe,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;QACrC,MAAM,SAAS,GAAG,kCAAkC,eAAe,sBAAsB,KAAK,GAAG,CAAC;QAClG,IAAI,YAAY,CAAC,IAAI,CAAC,eAAe,CAAC;YACpC,MAAM,IAAI,KAAK,CACb,GAAG,SAAS;;;wFAGoE,CACjF,CAAC;QACJ,IAAI,YAAY,CAAC,IAAI,CAAC,eAAe,CAAC;YACpC,MAAM,IAAI,KAAK,CAAC,GAAG,SAAS;uBACX,CAAC,CAAC;QACrB,IAAI,WAAW,CAAC,IAAI,CAAC,eAAe,CAAC;YACnC,MAAM,IAAI,KAAK,CAAC,GAAG,SAAS;sBACZ,CAAC,CAAC;QAEpB,MAAM,IAAI,KAAK,CAAC,GAAG,SAAS;2BACL,CAAC,CAAC;IAC3B,CAAC;IACD,IAAI,SAAS,KAAK,SAAS,IAAI,QAAQ,KAAK,SAAS;QACnD,MAAM,IAAI,KAAK,CAAC,oDAAoD,KAAK,IAAI,CAAC,CAAC;IAEjF,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;AACjC,CAAC"}

package/dist/cli/src/lib/suggestSimilar.d.ts

@@ -0,0 +1,18 @@
+/**
+ * Original library: commander.js (v15.0.0)
+ * - Copyright (c) 2011 TJ Holowaychuk
+ * - Copyright (c) John Gee and "commander.js" authors
+ *
+ * Modified and integrated in "Inray":
+ * - Evgeniy Bushin
+ */
+/***/
+/**
+ * Find close matches, restricted to same number of edits.
+ *
+ * @param {string} word
+ * @param {string[]} candidates
+ * @returns {string}
+ */
+export declare function suggestSimilar(word: string, candidates: string[]): string;
+//# sourceMappingURL=suggestSimilar.d.ts.map

package/dist/cli/src/lib/suggestSimilar.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"suggestSimilar.d.ts","sourceRoot":"","sources":["../../../../src/cli/src/lib/suggestSimilar.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,KAAK;AAgDL;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,GAAG,MAAM,CA2CzE"}

package/dist/cli/src/lib/suggestSimilar.js

@@ -0,0 +1,99 @@
+/**
+ * Original library: commander.js (v15.0.0)
+ * - Copyright (c) 2011 TJ Holowaychuk
+ * - Copyright (c) John Gee and "commander.js" authors
+ *
+ * Modified and integrated in "Inray":
+ * - Evgeniy Bushin
+ */
+/***/
+const maxDistance = 3;
+function editDistance(a, b) {
+    // https://en.wikipedia.org/wiki/Damerau–Levenshtein_distance
+    // Calculating optimal string alignment distance, no substring is edited more than once.
+    // (Simple implementation.)
+    // Quick early exit, return worst case.
+    if (Math.abs(a.length - b.length) > maxDistance)
+        return Math.max(a.length, b.length);
+    // distance between prefix substrings of a and b
+    const d = [];
+    // pure deletions turn a into empty string
+    for (let i = 0; i <= a.length; i++) {
+        d[i] = [i];
+    }
+    // pure insertions turn empty string into b
+    for (let j = 0; j <= b.length; j++) {
+        d[0][j] = j;
+    }
+    // fill matrix
+    for (let j = 1; j <= b.length; j++) {
+        for (let i = 1; i <= a.length; i++) {
+            let cost;
+            if (a[i - 1] === b[j - 1]) {
+                cost = 0;
+            }
+            else {
+                cost = 1;
+            }
+            d[i][j] = Math.min(d[i - 1][j] + 1, // deletion
+            d[i][j - 1] + 1, // insertion
+            d[i - 1][j - 1] + cost // substitution
+            );
+            // transposition
+            if (i > 1 && j > 1 && a[i - 1] === b[j - 2] && a[i - 2] === b[j - 1]) {
+                d[i][j] = Math.min(d[i][j], d[i - 2][j - 2] + 1);
+            }
+        }
+    }
+    return d[a.length][b.length];
+}
+/**
+ * Find close matches, restricted to same number of edits.
+ *
+ * @param {string} word
+ * @param {string[]} candidates
+ * @returns {string}
+ */
+export function suggestSimilar(word, candidates) {
+    if (!candidates || candidates.length === 0)
+        return '';
+    // remove possible duplicates
+    candidates = Array.from(new Set(candidates));
+    const searchingOptions = word.startsWith('--');
+    if (searchingOptions) {
+        word = word.slice(2);
+        candidates = candidates.map((candidate) => candidate.slice(2));
+    }
+    let similar = [];
+    let bestDistance = maxDistance;
+    const minSimilarity = 0.4;
+    candidates.forEach((candidate) => {
+        if (candidate.length <= 1)
+            return; // no one character guesses
+        const distance = editDistance(word, candidate);
+        const length = Math.max(word.length, candidate.length);
+        const similarity = (length - distance) / length;
+        if (similarity > minSimilarity) {
+            if (distance < bestDistance) {
+                // better edit distance, throw away previous worse matches
+                bestDistance = distance;
+                similar = [candidate];
+            }
+            else if (distance === bestDistance) {
+                similar.push(candidate);
+            }
+        }
+    });
+    similar.sort((a, b) => a.localeCompare(b));
+    if (searchingOptions) {
+        similar = similar.map((candidate) => `--${candidate}`);
+    }
+    if (similar.length > 1) {
+        return `\n(Did you mean one of ${similar.join(', ')}?)`;
+    }
+    if (similar.length === 1) {
+        return `\n(Did you mean ${similar[0]}?)`;
+    }
+    return '';
+}
+//# sourceMappingURL=suggestSimilar.js.map