@bemoje/cli 0.0.4 → 0.0.6

package/index.esm.js

@@ -1,3119 +0,0 @@
-import { Argument, Command, Help, Option, CommanderError, InvalidArgumentError } from 'commander';
-export * from 'commander';
-import colors from 'ansi-colors';
-import fs, { writeFileSync, outputJson, remove } from 'fs-extra';
-export { remove as removeFile, outputFileSync as writeFileSafeSync, writeFileSync, outputJson as writeJsonFileSafe } from 'fs-extra';
-import isAsyncFunction from 'is-async-function';
-import os from 'os';
-import path from 'path';
-import Table from 'cli-table';
-import { execSync } from 'child_process';
-
-/**
- * Creates a parser function that parses a delimited string into a list of typed values.
- * The parser function takes a string and returns an array of typed values.
- *
- * @param delimiter - The delimiter used to split the string into individual values.
- * @param parser - The function used to parse each individual value in the string.
- * @returns A function that takes a delimited string and returns an array of typed values.
- * @template T - The type of the values in the list.
- */ function createTypedListParser(delimiter, parser) {
-    return function parseList(string) {
-        return string.split(delimiter).map((str)=>str.trim()).map(parser);
-    };
-}
-
-function parseInteger(string) {
-    const errMsg = 'Not an integer. Got: ';
-    if (string.includes('.')) throw new TypeError(errMsg + string);
-    string = string.replace(/[^-0-9]/g, '');
-    if (!string) throw new TypeError(errMsg + string);
-    const int = parseInt(string);
-    if (isNaN(int)) throw new TypeError(errMsg + string);
-    return int;
-}
-
-function parseNumber(string) {
-    if (string.endsWith('Infinity')) return Number(string);
-    string = string.replace(/[^-0-9.]/g, '');
-    if (!string) return NaN;
-    return Number(string);
-}
-
-function parseString(string) {
-    return string;
-}
-
-class ParserSelector {
-    constructor(builder){
-        this.builder = builder;
-    }
-    string() {
-        return this.custom(parseString);
-    }
-    number() {
-        return this.custom(parseNumber);
-    }
-    integer() {
-        return this.custom(parseInteger);
-    }
-    delimitedStrings(delimiter = ',') {
-        return this.delimited(delimiter, parseString);
-    }
-    delimitedNumbers(delimiter = ',') {
-        return this.delimited(delimiter, parseNumber);
-    }
-    delimitedIntegers(delimiter = ',') {
-        return this.delimited(delimiter, parseInteger);
-    }
-    delimited(delimiter = ',', parser) {
-        return this.custom(createTypedListParser(delimiter, parser));
-    }
-}
-
-class ArgumentParserSelector extends ParserSelector {
-    constructor(builder){
-        super(builder);
-    }
-    custom(parser) {
-        this.builder.cmd.meta.argParsers[this.builder.index] = parser;
-        return this.builder;
-    }
-}
-
-class ArgumentReader {
-    constructor(parent){
-        this.parent = parent;
-    }
-    get $() {
-        return this.parent.$;
-    }
-    get argument() {
-        return this.$;
-    }
-    get name() {
-        return this.$.name();
-    }
-    get choices() {
-        return this.$.argChoices;
-    }
-    get default() {
-        return this.$.defaultValue;
-    }
-    get description() {
-        return this.$.description;
-    }
-    get variadic() {
-        return this.$.variadic;
-    }
-    get required() {
-        return this.$.required;
-    }
-    get optional() {
-        return !this.$.required;
-    }
-}
-
-/**
- * Returns the last element of an array.
- * Throws an error if the array is empty.
- * @template T The type of elements in the array.
- * @param array The array to get the last element from.
- * @returns The last element of the array.
- * @throws If the array is empty.
- * @example const numbers = [1, 2, 3, 4, 5];
- * const lastNumber = arrLast(numbers);
- * //=> 5
- */ function arrLast(array) {
-    if (!array.length) throw new Error('Cannot get last element of empty array.');
-    return array[array.length - 1];
-}
-
-function ensureThat(value, validator, options = {}) {
-    const result = validator(value, ...options.args ?? []);
-    if (result === true) return value;
-    const message = typeof result === 'string' ? `${result}. Got: ${value}` : `Expected '${validator.name}'. Got: ${value}`;
-    throw new (options.Err ?? Error)(message);
-}
-
-/**
- * This function sets the name of a function and returns the function with the new name.
- * @template T - The type of the function.
- * @param name The new name to be set for the function.
- * @param fun The function whose name is to be set.
- * @returns The function with the new name.
- * @example ```ts
- * const myFun = () => 'Hello World';
- * funSetName('newFun', myFun).name;;
- * //=> 'newFun'
- * ```
- */ function funSetName(name, fun) {
-    Object.defineProperty(fun, 'name', {
-        value: name,
-        configurable: true,
-        writable: true,
-        enumerable: false
-    });
-    return fun;
-}
-
-/**
- * Checks if the provided value is a named function.
- */ function isNamedFunction(func) {
-    return typeof func === 'function' && !!func.name;
-}
-
-function isNamedFunctionArray(array) {
-    return Array.isArray(array) && array.every(isNamedFunction);
-}
-
-/**
- * Converts the first character of a string to uppercase.
- * @param string The string to be converted.
- * @example ```ts
- * strFirstCharToUpperCase('hello');
- * //=> 'Hello'
- * ```
- */ function strFirstCharToUpperCase(string) {
-    return string.charAt(0).toUpperCase() + string.substring(1);
-}
-
-/**
- * Creates a validator function that checks whether the input is an array where all elements are valid according to every validator provided.
- *
- * @param validators - An array of validator functions.
- * @param name - The name of the validator function. If not provided, the name will be derived from the validator functions.
- *
- * @throws TypeError - if no name is provided and not all validators are named functions.
- */ function createTypedArrayValidator(validators, name) {
-    if (!name) {
-        ensureThat(validators, isNamedFunctionArray);
-        name = 'isArrayWhereEach' + validators.map((fun)=>strFirstCharToUpperCase(fun.name)).join('And');
-    }
-    return funSetName(name, function(array) {
-        return Array.isArray(array) && array.every((value)=>validators.every((isValid)=>isValid(value)));
-    });
-}
-
-/**
- * Checks if the provided number is an integer.
- * @remarks This function uses the built-in `Number.isInteger` method.
- * @param int The number to check.
- * @returns A boolean indicating whether the provided number is an integer.
- * @example ```ts
- * isInteger(5);
- * //=> true
- * isInteger(5.5);
- * //=> false
- * ```
- */ const isInteger = Number.isInteger;
-
-function isString(value) {
-    return typeof value === 'string';
-}
-
-/**
- * Checks if the provided value is a valid number.
- * @remarks This function checks if the provided value is a finite number and not NaN.
- * @param number The value to check.
- * @returns A boolean indicating whether the provided value is a valid number.
- * @example ```ts
- * isValidNumber(123);
- * //=> true
- * isValidNumber(NaN);
- * //=> false
- * isValidNumber(Infinity);
- * //=> false
- * ```
- */ function isValidNumber(number) {
-    return isFinite(number) && !isNaN(number);
-}
-
-class ValidatorSelector {
-    constructor(builder){
-        this.builder = builder;
-    }
-    isString() {
-        return this.custom(isString);
-    }
-    isNumber() {
-        return this.custom(isValidNumber);
-    }
-    isInteger() {
-        return this.custom(isInteger);
-    }
-    isStringArray() {
-        return this.arrayWhereEach(isString);
-    }
-    isNumberArray() {
-        return this.arrayWhereEach(isValidNumber);
-    }
-    isIntegerArray() {
-        return this.arrayWhereEach(isInteger);
-    }
-    arrayWhereEach(...validators) {
-        return this.custom(createTypedArrayValidator(validators));
-    }
-}
-
-class ArgumentValidatorSelector extends ValidatorSelector {
-    constructor(builder){
-        super(builder);
-    }
-    custom(validator) {
-        arrLast(this.builder.cmd.meta.argValidators).push(validator);
-        return this.builder;
-    }
-}
-
-function realizeLazyProperty(obj, key, value) {
-    Object.defineProperty(obj, key, {
-        enumerable: true,
-        writable: false,
-        configurable: false,
-        value
-    });
-    return value;
-}
-
-/**
- * Wrapper around the @see Argument class from 'commander'.
- */ class ArgumentBuilder {
-    constructor(cmd, name){
-        this.cmd = cmd;
-        this.$ = new Argument(name);
-        this.index = cmd.meta.argValidators.length;
-        cmd.meta.argValidators[this.index] = [];
-    }
-    description(string) {
-        this.$.description = string;
-        return this;
-    }
-    default(value, description) {
-        this.$.default(value, description);
-        return this;
-    }
-    choices(values) {
-        this.$.choices(values);
-        return this;
-    }
-    get parser() {
-        return new ArgumentParserSelector(this);
-    }
-    get validator() {
-        return new ArgumentValidatorSelector(this);
-    }
-    get get() {
-        return realizeLazyProperty(this, 'get', new ArgumentReader(this));
-    }
-}
-
-/**
- * Creates a function that merges arrays based on a predicate function.
- */ function createArrayMerger(predicate) {
-    return function arrMerge(target, ...sources) {
-        for (const src of sources){
-            for(let i = 0; i < src.length; i++){
-                if (predicate(src[i], i, src)) {
-                    target[i] = src[i];
-                }
-            }
-        }
-        return target;
-    };
-}
-
-const arrAssign = createArrayMerger((value)=>value != null);
-
-/**
- * Checks if at least one element in the array satisfies the provided predicate.
- * @param predicate The predicate function to apply to each element.
- * @template T The type of elements in the input array.
- * @returns Returns `true` if at least one element in the array passes the test implemented by the provided function, otherwise `false`.
- * @param input The array to check.
- * @example ```ts
- * const numbers = [1, 2, 3, 4, 5];
- * const isEven = (num) => num % 2 === 0;
- * arrSome(numbers, isEven);
- * //=> true
- * ```
- */ function arrSome(input, predicate) {
-    for(let i = 0, len = input.length; i < len; i++){
-        if (predicate(input[i], i, input) === true) {
-            return true;
-        }
-    }
-    return false;
-}
-
-/**
- * Checks if the provided value is a plain object, i.e. an object created by the native base `Object` constructor.
- */ function isPlainObject(value) {
-    if (Object.prototype.toString.call(value) !== '[object Object]') return false;
-    if (!value?.constructor) return true;
-    if (Object.prototype.toString.call(value.constructor.prototype) !== '[object Object]') return false;
-    if (!Object.prototype.hasOwnProperty.call(value.constructor.prototype, 'isPrototypeOf')) return false;
-    return true;
-}
-
-/**
- * Checks if the provided value is a primitive type (null, undefined, bigint, boolean, number, string or symbol).
- * @param value The value to check.
- * @returns A boolean indicating whether the provided value is a primitive type.
- * @example
- * isPrimitive(123);
- * //=> true
- * isPrimitive({});
- * //=> false
- */ function isPrimitive(value) {
-    return typeof value !== 'object' && typeof value !== 'function' || value === null;
-}
-
-/**
- * Escapes special characters in a string to be used in a regular expression.
- * @param str The input string to escape.
- * @returns The escaped string.
- * @example ```ts
- * const input = 'Hello, world!';
- * regexEscapeString(input);;
- * //=> 'Hello, world!'
- * ```
- */ function regexEscapeString(str) {
-    return str.replace(/[.*+?^${}()|[\]\\]/g, '\\$&') // $& means the whole matched string
-    ;
-}
-
-class ErrorParser {
-    constructor(error){
-        this.error = error instanceof Error ? error : new Error(String(error));
-    }
-    get name() {
-        return this.error.name;
-    }
-    get message() {
-        return this.error.message;
-    }
-    get stack() {
-        return this.error.stack || '';
-    }
-    summary() {
-        return this.name + ': ' + this.message;
-    }
-    parseStackFrames() {
-        return errParseStack(this.stack);
-    }
-    prettyStack(parsedStackFrames) {
-        return errPrettyStack(this.error, parsedStackFrames);
-    }
-    toObject() {
-        return errToObject(this.error);
-    }
-    toJSON() {
-        return this.toObject();
-    }
-}
-function errPrettyStack(error, parsedStackFrames) {
-    const frames = parsedStackFrames ?? errParseStack(error.stack || '');
-    // width of the first column = the longest frame.cell string
-    const offset = 2 + frames.reduce((acc, frame)=>Math.max(acc, frame[0].length), 0);
-    // type and message
-    const result = [
-        colors.bold(colors.red(error.name)) + ': ' + ' '.repeat(Math.max(0, offset - error.name.length)) + colors.red(error.message)
-    ];
-    // stack trace
-    result.push(colors.yellow('stack') + ':');
-    result.push(frames.map((frame)=>{
-        const [call, file] = frame;
-        let s = '  ';
-        let fp;
-        if (file.startsWith('node:')) {
-            s += colors.gray(call);
-            fp = colors.gray(file);
-        } else if (file.includes('node_modules')) {
-            s += call;
-            const base = path.basename(file.split(':')[0]);
-            fp = file.replace(base, colors.yellow(base));
-        } else {
-            s += call;
-            const base = path.basename(file.split(':')[0]);
-            fp = file.replace(base, colors.red(base));
-        }
-        s += ' '.repeat(offset - call.length);
-        s += fp;
-        return s;
-    }).join('\n'));
-    // other properties
-    const ignore = [
-        'name',
-        'message',
-        'frames',
-        'stack'
-    ];
-    const keys = Object.getOwnPropertyNames(error).filter((key)=>!ignore.includes(key));
-    for (const k of keys){
-        if (typeof k === 'symbol') continue;
-        const key = k;
-        let s = colors.yellow(key.toString()) + ': ';
-        if (isPlainObject(error[key])) {
-            const json = JSON.stringify(error[key], null, 2);
-            if (json.length < 350) {
-                s += JSON.stringify(error[key], null, 2).split('\n').map((line)=>{
-                    const arr = line.split('": ');
-                    arr[0] = colors.gray(arr[0].replace('"', ''));
-                    return arr.join(': ');
-                }).join('\n');
-            } else {
-                s += JSON.stringify(error[key]);
-            }
-        } else if (isPrimitive(error[key])) {
-            s += String(error[key]);
-        } else if (error[key] != null && typeof error[key] === 'object') {
-            s += error[key].toString();
-        } else {
-            s += JSON.stringify(error[key]);
-        }
-        result.push(s.trim());
-    }
-    return '\n' + result.join('\n') + '\n';
-}
-function errParseStack(stack) {
-    if (!stack) return [];
-    const nodeRe = /^\s*at (?:((?:\[object object\])?[^\\/]+(?: \[as \S+\])?) )?\(?(.*?):(\d+)(?::(\d+))?\)?\s*$/i;
-    const recwd = new RegExp('^' + regexEscapeString(process.cwd() + path.sep), 'i');
-    const frames = [];
-    for (const line of stack.split('\n')){
-        const parts = nodeRe.exec(line);
-        if (!parts) continue;
-        frames.push([
-            parts[1] || '<unknown>',
-            `${(parts[2] || '').replace(recwd, '').replace(/\\\\?/g, '/')}:${+parts[3]}:${parts[4] ? +parts[4] : null}`
-        ]);
-    }
-    return frames;
-}
-function errToObject(error) {
-    const own = Object.getOwnPropertyNames(error).filter((key)=>typeof key === 'string');
-    const keys = new Set([
-        'name',
-        'message',
-        'frames',
-        ...own
-    ]);
-    keys.delete('stack');
-    const entries = Array.from(keys).filter((key)=>error[key] !== undefined).map((key)=>[
-            key,
-            error[key]
-        ]);
-    return Object.fromEntries(entries);
-} // try {
- //   throw new TypeError('wow ok oops')
- // } catch (error) {
- //   const err = new ErrorParser(error)
- //   console.log('----------------------')
- //   console.log({
- //     name: err.name,
- //     message: err.message,
- //     summary: err.summary,
- //   })
- //   console.log('----------------------')
- //   console.log(err.stack)
- //   console.log('----------------------')
- //   console.log(err.prettyStack())
- //   console.log('----------------------')
- //   console.log(err.toObject())
- //   console.log('----------------------')
- // }
-
-/**
- * Checks if the given value is a function.
- *
- * @example ```ts
- * isFunction(class {}); //=> true
- * isFunction(function () {}); //=> true
- * isFunction(() => {}); //=> true
- * ```
- */ function isFunction(value) {
-    return typeof value === 'function' && value !== Function.prototype;
-}
-
-/**
- * A class that creates an object with methods for disabling/enabling a given method on a given object.
- *
- * @example
- * const md = new MethodDisabler(process.stdout, 'write')
- *
- * md.disable()
- * assert(!md.isEnabled)
- * console.log('This will not print')
- *
- * md.enable()
- * assert(md.isEnabled)
- * console.log('This will print')
- *
- * assert(md.original === process.stdout.write)
- */ class MethodDisabler {
-    static #defaultDescriptor(value) {
-        return {
-            value,
-            writable: true,
-            enumerable: true,
-            configurable: true
-        };
-    }
-    static #noop = (...args)=>void 0;
-    static #memoized = new WeakMap();
-    #obj;
-    #key;
-    #original;
-    #hasOwn;
-    #originalDescriptor;
-    #noopDescriptor;
-    #isEnabled;
-    /**
-   * @param obj - The object on which the method is defined.
-   * @param key - The property name of the method.
-   */ constructor(obj, key){
-        this.#isEnabled = true;
-        ensureThat(obj[key], isFunction);
-        this.#obj = obj;
-        this.#key = key;
-        this.#original = obj[key];
-        this.#hasOwn = Object.hasOwn(obj, key);
-        this.#originalDescriptor = this.#hasOwn ? Object.getOwnPropertyDescriptor(obj, key) : MethodDisabler.#defaultDescriptor(this.#original);
-        this.#noopDescriptor = Object.assign({}, this.#originalDescriptor, {
-            value: MethodDisabler.#noop
-        });
-        // return stored if memoized
-        if (MethodDisabler.#memoized.get(obj)?.has(key)) {
-            return MethodDisabler.#memoized.get(obj)?.get(key);
-        }
-        //memoize
-        if (!MethodDisabler.#memoized.has(obj)) MethodDisabler.#memoized.set(obj, new Map());
-        const methods = MethodDisabler.#memoized.get(obj);
-        methods.set(key, this);
-    }
-    /**
-   * Disable the method.
-   */ disable() {
-        if (!this.isEnabled) return;
-        Object.defineProperty(this.#obj, this.#key, this.#noopDescriptor);
-        this.#isEnabled = false;
-    }
-    /**
-   * Enable the method.
-   */ enable() {
-        if (this.isEnabled) return;
-        if (this.#hasOwn) Object.defineProperty(this.#obj, this.#key, this.#originalDescriptor);
-        else delete this.#obj[this.#key];
-        this.#isEnabled = true;
-    }
-    /**
-   * The original method before it was disabled.
-   */ get original() {
-        return this.#original;
-    }
-    /**
-   * Whether the method is currently enabled.
-   */ get isEnabled() {
-        return this.#isEnabled;
-    }
-}
-
-/**
- * The OutputManager class manages the output of debug messages to the console.
- */ class OutputManager {
-    /**
-   * Returns the singleton instance of the OutputManager class.
-   * If the instance does not exist, it creates a new one.
-   */ static getInstance() {
-        if (!this.instance) this.instance = new OutputManager();
-        return this.instance;
-    }
-    /**
-   * Constructs a new instance of the OutputManager class.
-   * console.debug is disabled by default.
-   */ constructor(){
-        /**
-   * Ansi-colors object
-   */ this.colors = colors;
-        /**
-   * A MethodDisabler instance for disabling the write method of the process.stdout object.
-   */ this.stdout = new MethodDisabler(process.stdout, 'write');
-        /**
-   * A MethodDisabler instance for disabling the write method of the process.stderr object.
-   */ this.stderr = new MethodDisabler(process.stderr, 'write');
-        /**
-   * A MethodDisabler instance for disabling the debug method of the console object.
-   */ this.debug = new MethodDisabler(console, 'debug');
-        /**
-   * An array that holds queued debug messages.
-   */ this.debugMsgQueue = [];
-        this.debug.disable();
-        colors.enabled = (()=>{
-            const { FORCE_COLOR, NODE_DISABLE_COLORS, NO_COLOR, TERM } = process.env;
-            return !NODE_DISABLE_COLORS && NO_COLOR == null && TERM !== 'dumb' && (FORCE_COLOR != null && FORCE_COLOR !== '0' || process.stdout && process.stdout.isTTY);
-        })();
-    }
-    get queueSize() {
-        return this.debugMsgQueue.length;
-    }
-    /**
-   * Resets the OutputManager to its default state.
-   * - Enables colors.
-   * - Enables the write method of the process.stdout object.
-   * - Enables the write method of the process.stderr object.
-   * - Disables the debug method of the console object.
-   * @returns The OutputManager instance.
-   */ reset() {
-        this.colors.enabled = true;
-        this.stdout.enable();
-        this.stderr.enable();
-        this.debug.disable();
-        return this;
-    }
-    /**
-   * Outputs a debug message to the console.
-   * If the debug method is enabled, the message is immediately logged to the console.
-   * Otherwise, the message is added to the debug message queue.
-   * @param fn - A function that returns the debug message.
-   */ outputDebug(fn) {
-        if (this.debug.isEnabled) console.debug(fn());
-        else this.debugMsgQueue.push(fn);
-    }
-    /**
-   * Drains the debug message queue by logging all the messages to the console.
-   */ drainDebugMessageQueue() {
-        this.debugMsgQueue.forEach((fn)=>console.debug(fn()));
-        this.debugMsgQueue.splice(0, this.debugMsgQueue.length);
-    }
-}
-
-class CommandBuilderMetaData {
-    get actionHandler() {
-        return async function defaultActionHandler() {
-            this.outputHelp();
-        };
-    }
-    get errorHandler() {
-        return function defaultErrorHandler(error) {
-            const parsed = new ErrorParser(error);
-            if (OutputManager.getInstance().debug.isEnabled) {
-                console.error(parsed.prettyStack());
-                this.outputError(parsed.summary());
-            } else {
-                this.outputError(parsed.summary());
-            }
-        };
-    }
-    get hasCustomActionHandler() {
-        return Object.hasOwn(this, 'actionHandler');
-    }
-    get hasCustomErrorHandler() {
-        return Object.hasOwn(this, 'errorHandler');
-    }
-    constructor(){
-        this.subcommands = [];
-        this.globalOptions = [];
-        this.hiddenGlobalOptions = new Set();
-        this.presetOptionKeys = [];
-        this.argParsers = [];
-        this.argValidators = [];
-        this.optParsers = {};
-        this.optValidators = {};
-        this.rawArgs = [];
-        this.isNative = false;
-        this.isInitialized = false;
-    }
-}
-
-function splitCombinedArgvShorts(argv) {
-    return argv.map((arg)=>{
-        if (arg.length < 3 || !arg.startsWith('-') || arg.startsWith('--') || arg.includes('=')) {
-            return arg;
-        }
-        return Array.from(arg.replace('-', '')).map((s)=>'-' + s);
-    }).flat();
-}
-
-const commanderBackRefs = new WeakMap();
-const oldParse = Command.prototype.parse;
-Command.prototype.parse = function parse(argv, options) {
-    if (argv) {
-        argv = splitCombinedArgvShorts(argv.slice());
-        this.builder.meta.rawArgs = argv.slice(options?.from === 'user' ? 0 : 2);
-    } else {
-        this.builder.meta.rawArgs = process.argv.slice(2);
-    }
-    return oldParse.call(this, argv, options);
-};
-const oldParseAsync = Command.prototype.parseAsync;
-Command.prototype.parseAsync = async function(argv, options) {
-    if (argv) {
-        argv = splitCombinedArgvShorts(argv.slice());
-        this.builder.meta.rawArgs = argv.slice(options?.from === 'user' ? 0 : 2);
-    } else {
-        this.builder.meta.rawArgs = process.argv.slice(2);
-    }
-    return await oldParseAsync.call(this, argv, options);
-};
-Object.defineProperty(Command.prototype, 'builder', {
-    get () {
-        const ins = commanderBackRefs.get(this);
-        if (!ins) throw new Error(`CommandBuilder not found for command ${this.name()}`);
-        return ins;
-    }
-});
-
-/**
- * Represents a selector for enabling or disabling command features.
- */ class CommandFeatureSelector {
-    /**
-   * Creates a new instance of the CommandFeatureSelector class.
-   * @param cmd - The command builder instance.
-   */ constructor(cmd){
-        this.cmd = cmd;
-        this./**
-   * Indicates whether the app data feature is enabled.
-   */ isAppDataEnabled = false;
-        this./**
-   * Indicates whether the config feature is enabled.
-   */ isConfigEnabled = false;
-        this./**
-   * Indicates whether the presets feature is enabled.
-   */ isPresetsEnabled = false;
-        this./**
-   * Indicates whether the auto assign missing option flags feature is enabled.
-   */ isAutoAssignMissingOptionFlagsEnabled = false;
-        this./**
-   * Indicates whether the auto assign sub command aliases feature is enabled.
-   */ isAutoAssignSubCommandAliasesEnabled = false;
-    }
-    /**
-   * Inherits the feature settings from a parent CommandFeatureSelector instance.
-   * @param parentFeatures - The parent CommandFeatureSelector instance to inherit from.
-   */ inheritFrom(parentFeatures) {
-        if (!parentFeatures) return;
-        if (this.cmd.meta.isNative) this.isAutoAssignMissingOptionFlagsEnabled = true;
-        else this.isAutoAssignMissingOptionFlagsEnabled = parentFeatures.isAutoAssignMissingOptionFlagsEnabled;
-        this.isAutoAssignSubCommandAliasesEnabled = parentFeatures.isAutoAssignSubCommandAliasesEnabled;
-        this.isPresetsEnabled = parentFeatures.isPresetsEnabled;
-    }
-    /**
-   * Enables or disables the app data feature.
-   * @param boolean - Indicates whether the app data feature should be enabled or disabled.
-   * @returns The current CommandFeatureSelector instance.
-   * @throws Error if the command is native and the app data feature is being configured.
-   */ appData(boolean = true) {
-        return this.setProperty(boolean, 'isAppDataEnabled', 'appData', true);
-    }
-    /**
-   * Enables or disables the config feature.
-   * @param boolean - Indicates whether the config feature should be enabled or disabled.
-   * @returns The current CommandFeatureSelector instance.
-   * @throws Error if the command is native and the config feature is being configured.
-   */ config(boolean = true) {
-        return this.setProperty(boolean, 'isConfigEnabled', 'config', true);
-    }
-    /**
-   * Enables or disables the presets feature.
-   * @param boolean - Indicates whether the presets feature should be enabled or disabled.
-   * @returns The current CommandFeatureSelector instance.
-   * @throws Error if the command is native and the presets feature is being configured.
-   */ presets(boolean = true) {
-        return this.setProperty(boolean, 'isPresetsEnabled', 'presets', true);
-    }
-    /**
-   * Enables or disables the auto assign missing option flags feature.
-   * @param boolean - Indicates whether the auto assign missing option flags feature should be enabled or disabled.
-   * @returns The current CommandFeatureSelector instance.
-   */ autoAssignMissingOptionFlags(boolean = true) {
-        return this.setProperty(boolean, 'isAutoAssignMissingOptionFlagsEnabled', 'autoAssignMissingOptionFlags', false);
-    }
-    /**
-   * Enables or disables the auto assign sub command aliases feature.
-   * @param boolean - Indicates whether the auto assign sub command aliases feature should be enabled or disabled.
-   * @returns The current CommandFeatureSelector instance.
-   */ autoAssignSubCommandAliases(boolean = true) {
-        return this.setProperty(boolean, 'isAutoAssignSubCommandAliasesEnabled', 'autoAssignSubCommandAliases', false);
-    }
-    /**
-   * Helper method to enable or disable a feature.
-   * @param boolean - Indicates whether the auto assign sub command aliases feature should be enabled or disabled.
-   * @param prop - The property name to set.
-   * @param method - The method name to output in the debug message.
-   * @param throwIfNative - Indicates whether an error should be thrown if the command is native.
-   * @returns The current CommandFeatureSelector instance.
-   */ setProperty(boolean = true, prop, method, throwIfNative) {
-        if (this[prop] === boolean) return this;
-        if (throwIfNative && this.cmd.meta.isNative) throw new Error(`Cannot configure ${method} for native command.`);
-        Object.defineProperty(this, prop, {
-            value: boolean,
-            configurable: true,
-            writable: true,
-            enumerable: true
-        });
-        this.cmd.outputDebugMessage('featureEnabled', ()=>({
-                [method]: boolean
-            }));
-        return this;
-    }
-}
-
-const DefaultHelpConfig = {
-    helpWidth: undefined,
-    showGlobalOptions: true,
-    sortSubcommands: false,
-    sortOptions: false,
-    subcommandTerm,
-    argumentTerm,
-    commandUsage,
-    visibleOptions,
-    visibleGlobalOptions,
-    subcommandDescription,
-    optionDescription,
-    argumentDescription,
-    commandDescription,
-    formatHelp
-};
-function formatHelp(cmd) {
-    let result = Help.prototype.formatHelp.call(this, cmd, this);
-    result = movePresetOptionsUnderOwnHeader(result);
-    result = rearrangeSections(result);
-    result = fixLinebreaks(result);
-    result = addColors(result);
-    return result;
-    function movePresetOptionsUnderOwnHeader(result) {
-        const lines = result.split('\n');
-        const presetLines = lines.filter((line)=>line.includes('[Preset]:'));
-        const firstPresetIndex = lines.findIndex((line)=>line.includes('[Preset]'));
-        if (firstPresetIndex !== -1) {
-            lines.splice(firstPresetIndex, presetLines.length);
-            lines.push('', 'Preset Options:', ...presetLines);
-            result = lines.join('\n');
-        }
-        return result;
-    }
-    function rearrangeSections(result) {
-        const order = [
-            'Usage:',
-            'Version:',
-            'Description:',
-            'Commands:',
-            'Arguments:',
-            'Options:',
-            'Global Options:',
-            'Preset Options:'
-        ];
-        const blocks = {};
-        let lastAddedBlock = 'Description:';
-        result.split(/\n\n+/).forEach((block)=>{
-            const title = block.split(':')[0].trim() + ':';
-            if (/^[A-Z][\w ]+:/.test(title)) {
-                blocks[title] = block;
-                lastAddedBlock = title;
-                if (!order.includes(title)) order.push(title);
-            } else {
-                if (!order.includes(lastAddedBlock)) order.push(lastAddedBlock);
-                blocks[lastAddedBlock] = ((blocks[lastAddedBlock] || '') + '\n\n' + block).trim();
-            }
-        });
-        result = order.map((title)=>blocks[title]).join('\n\n').trim();
-        return result;
-    }
-    function fixLinebreaks(result) {
-        result = '\n' + result.trim() + '\n\n';
-        result = result.replace(/\n\n+/g, '\n\n');
-        return result;
-    }
-    function addColors(result) {
-        result = result.replace(/\|/g, colors.gray(colors.dim('|')));
-        result = result.replace(/^[A-Z][\w ]+:/gm, (s)=>colors.yellow(s));
-        return result;
-    }
-}
-function subcommandTerm(cmd) {
-    const args = cmd.registeredArguments.map((arg)=>this.argumentTerm(arg)).join(' ');
-    const parent = cmd.parent || cmd;
-    const hasAliases = !cmd.parent || parent.commands.some((c)=>!!c.alias());
-    if (!hasAliases) return cmd.name() + (args ? ' ' + args : '');
-    const padsize = Math.max(1, ...parent.commands.map((c)=>c.alias()?.length || 1));
-    let alias = cmd.alias() || ' ';
-    alias = alias.padEnd(padsize, ' ') + ' |';
-    return alias + cmd.name() + (args ? ' ' + args : '');
-}
-function argumentTerm(arg) {
-    let r = arg.name();
-    const rest = arg.variadic ? '...' : '';
-    if (arg.required) r = '<' + r + rest + '>';
-    else r = '[' + r + rest + ']';
-    return r;
-}
-function commandUsage(cmd) {
-    const args = cmd.registeredArguments.map((arg)=>this.argumentTerm(arg)).join(' ');
-    return [
-        cmd.builder.getPrefixString() + ' ' + (args ? args : '[command]'),
-        '[options]'
-    ].join(' ');
-}
-function visibleOptions(cmd) {
-    const builder = cmd.builder;
-    const opts = cmd.options.filter((opt)=>!opt.hidden && !builder.meta.globalOptions.includes(opt));
-    const presets = opts.filter((opt)=>opt.description.startsWith('[Preset]'));
-    return opts.filter((opt)=>!presets.includes(opt)).concat(presets);
-}
-function visibleGlobalOptions(cmd) {
-    const gopts = cmd.builder.getGlobalOptions();
-    if (gopts.find((opt)=>opt.long === '--help')) return gopts;
-    const help = cmd.options.find((opt)=>opt.long === '--help');
-    if (help) gopts.push(help);
-    return gopts;
-}
-function subcommandDescription(cmd) {
-    return colors.gray(Help.prototype.subcommandDescription.call(this, cmd));
-}
-function optionDescription(opt) {
-    return colors.gray(Help.prototype.optionDescription.call(this, opt));
-}
-function argumentDescription(arg) {
-    return colors.gray(Help.prototype.argumentDescription.call(this, arg));
-}
-function commandDescription(cmd) {
-    const v = cmd.builder.getVersion();
-    const version = v ? colors.yellow('Version: ') + v + '\n\n' : '';
-    const description = 'Description:\n' + Help.prototype.commandDescription.call(this, cmd);
-    return version + description;
-}
-
-function formatTableForTerminal(rows, headers) {
-    if (!rows.length || !rows[0].length) return '';
-    const table = new Table();
-    if (headers && headers.length) {
-        table.push(headers.map((s)=>colors.bold(colors.yellow(s))));
-    }
-    for (const row of rows)table.push(row);
-    return table.toString();
-}
-
-const isArray = Array.isArray;
-
-/**
- * Checks if the provided value is an object (null, arrays and functions not included).
- * @template T - The type of the value to check.
- * @param value The value to check.
- * @returns A boolean indicating whether the provided value is an object.
- * @example ```ts
- * isObject({});;
- * //=> true
- * isObject([1]);;
- * //=> false
- * isObject(123);;
- * //=> false
- * ```
- */ function isObject(value) {
-    return value != null && typeof value === 'object' && !Array.isArray(value);
-}
-
-/**
- * Determine whether the input is a string array.
- */ function isStringArray(value) {
-    return Array.isArray(value) && value.every((v)=>isString(v));
-}
-
-function isStringWithNoSpacesOrDashes(value) {
-    return isString(value) && /^[^\s-]+$/i.test(value);
-}
-
-/**
- * Checks if the current platform is OSX.
- * It checks the 'process' object and the 'platform' property to determine if the platform is 'darwin'.
- * @returns A boolean indicating whether the current platform is OSX.
- */ function isOSX() {
-    return process.platform === 'darwin';
-}
-
-/**
- * Returns whether Visual Studio Code is installed on the system.
- * @example isVsCodeInstalled() //=> true
- */ function isVsCodeInstalled() {
-    try {
-        const stdout = execSync('code --help').toString();
-        return stdout.startsWith('Visual Studio Code') && stdout.includes('-w --wait');
-    } catch (e) {
-        return false;
-    }
-}
-
-/**
- * Checks if the current platform is Windows.
- * @remarks
- * It checks the 'process' object and the 'platform' property to determine if the platform is 'win32'.
- * It also checks the 'OSTYPE' environment variable to see if it matches 'msys' or 'cygwin'.
- * @returns A boolean indicating whether the current platform is Windows.
- */ function isWindows() {
-    return isWin;
-}
-const isWin = process && (process.platform === 'win32' || /^(msys|cygwin)$/.test(process.env['OSTYPE'] || ''));
-
-/**
- * Get the default command to open a file in in a text editor.
- * If VSCode is installed, this is used. Otherwise, the default text editor of the OS is used.
- */ function defaultOpenInEditorCommand() {
-    if (!COMMAND) COMMAND = isVsCodeInstalled() ? 'code -w' : isWindows() ? 'notepad' : isOSX() ? 'open vi' : 'xdg-open';
-    return COMMAND;
-}
-let COMMAND = '';
-
-/**
- * Reads a file and returns the file's contents.
- * Identical to fs.readFileSync, except that it uses utf8 encoding by default.
- *
- * @param filepath - The path to the file.
- * @param encoding - The encoding to use when reading the file.
- * @returns The file's contents.
- */ function readFileSync(filepath, encoding = 'utf8') {
-    return fs.readFileSync(filepath, encoding);
-}
-
-/**
- * Ensures that a string starts with a specified substring. If the string already starts with the specified substring, it is returned as is. Otherwise, the substring is appended to the end of the string.
- * @param string The string to be processed.
- * @param startsWith The substring that the string should end with.
- * @example ```ts
- * strEnsureStartsWith('json', '.');
- * //=> '.json'
- * strEnsureStartsWith('.json', '.');
- * //=> '.json'
- * ```
- */ function strEnsureStartsWith(string, startsWith) {
-    return string.startsWith(startsWith) ? string : startsWith + string;
-}
-
-/**
- * Returns a path to the os tmpdir location.
- *
- * @param paths - The paths to join to the os tmpdir location.
- */ function getTempDataPath(...paths) {
-    return path.join(tempdir, ...paths);
-}
-const tempdir = fs.realpathSync(os.tmpdir());
-
-/**
- * Syncrhonously creates a temporary file and deletes it after the callback has finished.
- * @param fileExtension - The file extension to use for the temporary file.
- * @param callback - The callback to execute with the temporary file path. The callback can return a promise and the temporary file will not be deleted until the promise has resolved or rejected.
- */ function tempFileSync(fileExtension, callback) {
-    const fpath = getTempDataPath('temp', Date.now() + strEnsureStartsWith(fileExtension, '.'));
-    fs.ensureFileSync(fpath);
-    try {
-        const retval = callback(fpath);
-        fs.remove(fpath);
-        return retval;
-    } catch (error) {
-        fs.remove(fpath);
-    }
-}
-
-/**
- * Prompts the user to edit a string in the user's text editor.
- *
- * @example ```ts
- * promptUserEditInTextEditor({ editor: 'notepad' })
- * ```
- */ function promptUserEditInTextEditorSync(options) {
-    const { editor, content, extension } = applyDefaults(options);
-    return tempFileSync(extension, (tempfile)=>{
-        writeFileSync(tempfile, content);
-        execSync(`${editor} ${tempfile}`, {
-            stdio: 'inherit'
-        });
-        return readFileSync(tempfile);
-    });
-}
-function applyDefaults(options = {}) {
-    const content = options.content ?? '';
-    const extension = strEnsureStartsWith(options.extension ?? '.txt', '.');
-    const editor = options.editor ?? defaultOpenInEditorCommand();
-    return {
-        content,
-        extension,
-        editor
-    };
-}
-
-/**
- * Edit a JSON-stringify-compatible value in the user's editor and return the (JSON.parse'd) result.
- *
- * @param value - The value to edit (NOT a json string). Defaults to an empty object.
- * @param editor - Launch command to start your editor. Defaults to VSCode: 'code -w' (if installed).
- * - Otherwise this logic: isWindows() ? 'notepad' : isOSX() ? 'open vi' : 'xdg-open'
- *
- * @example ```ts
- * promptUserEditJsonInTextEditorSync([1, 2])
- * ```
- */ function promptUserEditJsonInTextEditorSync(value = {}, editor) {
-    const json = promptUserEditInTextEditorSync({
-        editor,
-        content: JSON.stringify(value, null, 2),
-        extension: '.json'
-    });
-    return JSON.parse(json);
-}
-
-/**
- * A class that represents a section of the JSON file used as a simple database.
- */ class AbstractJsonFileSection {
-    /**
-   * Creates an instance of AbstractJsonFileSection.
-   * @param file - The parent JsonFile instance.
-   * @param name - The name of the section.
-   * @param keysAreFixed - Indicates whether the keys in the section are fixed.
-   */ constructor(file, name, keysAreFixed){
-        this.file = file;
-        this.name = name;
-        this.keysAreFixed = keysAreFixed;
-        this.isInitialized = false;
-        this.defaultValues = {};
-        this.prefixBaseString = file.cmd.getPrefixArray().join('_');
-    }
-    /**
-   * The JsonDB associated with the section.
-   */ get db() {
-        return this.file.db;
-    }
-    /**
-   * The CommandBuilder associated with the section.
-   */ get cmd() {
-        return this.file.cmd;
-    }
-    /**
-   * Saves the section.
-   * @returns A promise that resolves when the section is saved.
-   */ async save() {
-        return await this.db.save();
-    }
-    /**
-   * Gets the object path prefix as dot-separated keys for this section of the JSON file database.
-   * @param key - An optional key to append to the prefix path.
-   * @returns The object path prefix.
-   * @throws An error if the keys are fixed and the specified key does not exist in the default values.
-   */ prefix(key) {
-        if (this.keysAreFixed && key && !Object.hasOwn(this.defaultValues, key)) {
-            throw new Error(`No entry with key '${key}'`);
-        }
-        return this.prefixBaseString + '.' + this.name + (key ? '.' + key : '');
-    }
-    /**
-   * Gets the value associated with the specified key.
-   * @param key - The key to get the value for.
-   * @returns The value associated with the key.
-   */ get(key) {
-        this.initialize(false);
-        return this.db.getSafe(this.prefix(key)) ?? this.defaultValues[key];
-    }
-    /**
-   * Gets all the values in the section.
-   * @returns All the values in the section.
-   */ getAll() {
-        this.initialize(false);
-        return this.db.getSafe(this.prefix()) ?? JSON.parse(JSON.stringify(this.defaultValues));
-    }
-    /**
-   * Gets the keys in the section.
-   * @returns The keys in the section.
-   */ get keys() {
-        // if (this.keysAreFixed) return Object.keys(this.defaultValues)
-        return Object.keys(this.getAll());
-    }
-    /**
-   * Gets the number of keys in the section.
-   * @returns The number of keys in the section.
-   */ count() {
-        return this.keys.length;
-    }
-    /**
-   * Sets the value associated with the specified key.
-   * @param key - The key to set the value for.
-   * @param value - The value to set.
-   * @param save - Indicates whether to save the section after setting the value.
-   */ set(key, value, save = true) {
-        this.initialize();
-        this.assertValid(key, value);
-        this.db.set(this.prefix(key), value, save);
-    }
-    /**
-   * Sets all the values in the section.
-   * @param values - The values to set.
-   * @param save - Indicates whether to save the section after setting the values.
-   */ setAll(values, save = true) {
-        const original = this.getAll();
-        for (const [key, value] of Object.entries(values)){
-            if (value === original[key]) continue;
-            if (JSON.stringify(value) === JSON.stringify(original[key])) continue;
-            this.set(key, value, false);
-        }
-        if (!this.keysAreFixed) {
-            for (const name of Object.keys(original)){
-                if (Object.hasOwn(values, name)) continue;
-                this.delete(name, false);
-            }
-        }
-        if (save) this.save();
-    }
-    /**
-   * Updates the value associated with the specified key.
-   * @param key - The key to set the value for.
-   * @param callback - The callback function that returns the new value.
-   * @param save - Indicates whether to save the section after setting the value.
-   */ update(key, callback, save = true) {
-        this.set(key, callback(this.get(key), key), save);
-    }
-    /**
-   * Resets the value associated with the specified key to its default value.
-   * @param key - The key to reset.
-   * @param save - Indicates whether to save the section after resetting the value.
-   */ reset(key, save = true) {
-        this.set(key, this.defaultValues[key], save);
-    }
-    /**
-   * Resets all the values in the section to their default values.
-   * @param save - Indicates whether to save the section after resetting the values.
-   */ resetAll(save = true) {
-        this.setAll(this.defaultValues, save);
-    }
-    /**
-   * Deletes the value associated with the specified key.
-   * @param key - The key to delete.
-   * @param save - Indicates whether to save the section after deleting the value.
-   */ delete(key, save = true) {
-        this.initialize();
-        this.db.delete(this.prefix(key), save);
-    }
-    /**
-   * Deletes all the values in the section.
-   * @param save - Indicates whether to save the section after deleting the values.
-   */ deleteAll(save = true) {
-        for (const key of this.keys){
-            this.delete(key, false);
-        }
-        if (save) this.save();
-    }
-    /**
-   * Edits the values in the section using a text editor.
-   * @param editor - The text editor to use. If not specified, the default text editor command will be used.
-   */ edit(editor) {
-        const original = this.getAll();
-        const parsed = promptUserEditJsonInTextEditorSync(original, editor || defaultOpenInEditorCommand());
-        this.setAll(parsed);
-    }
-}
-
-/**
- * A class that represents the appdata section of the JSON file used as simple database.
- */ class AppDataSection extends AbstractJsonFileSection {
-    /**
-   * Creates an instance of AppDataSection.
-   * @param file - The parent JsonFile instance.
-   * @param name - The name of the section.
-   */ constructor(file, name){
-        super(file, name, false);
-    }
-    /**
-   * Does nothing
-   */ assertValid() {
-        return;
-    }
-    /**
-   * Defines a property for the section.
-   * @param key - The key of the property.
-   */ defineProperty(key, value) {
-        if (typeof value === 'object') value = JSON.parse(JSON.stringify(value));
-        this.defaultValues[key] = value;
-        this.isInitialized = false;
-    }
-    /**
-   * Initializes the section.
-   * @param save - Indicates whether to save the section after initialization.
-   * @returns A string if an error occurred during initialization, otherwise void.
-   */ initialize(save = false) {
-        if (this.isInitialized) return;
-        const data = this.db.getSafe(this.prefix());
-        if (!data) this.db.set(this.prefix(), this.defaultValues, save);
-        this.isInitialized = true;
-    }
-}
-
-/**
- * Creates a function that merges objects based on a predicate function.
- */ function createObjectMerger(predicate) {
-    return function objMerge(target, ...sources) {
-        for (const src of sources){
-            for (const [key, value] of Object.entries(src)){
-                if (predicate(value, key, src)) {
-                    target[key] = value;
-                }
-            }
-        }
-        return target;
-    };
-}
-
-const objAssign = createObjectMerger((value)=>value != null);
-
-/**
- * A class that represents the user-config section of the JSON file used as simple database.
- */ class ConfigSection extends AbstractJsonFileSection {
-    /**
-   * Creates an instance of AbstractJsonFileSection.
-   * @param file - The parent JsonFile instance.
-   * @param name - The name of the section.
-   */ constructor(file, name){
-        super(file, name, true);
-        /**
-   * String parsers for when editing config from command-line.
-   */ this.parsers = {};
-        /**
-   * Descriptions for each property key.
-   */ this.descriptions = {};
-        /**
-   * Validators for each property key.
-   */ this.validators = {};
-    }
-    /**
-   * Asserts that a key-value pair is valid.
-   * @param key - The key to assert.
-   * @param value - The value to assert.
-   */ assertValid(key, value) {
-        if (!this.validators[key]) return;
-        ensureThat(value, this.validators[key]);
-    }
-    /**
-   * Defines a property for the section.
-   * @param key - The key of the property.
-   * @param options - The options for the property.
-   */ defineProperty(key, options) {
-        const { description, defaultValue, parse, validate } = options;
-        this.descriptions[key] = description;
-        this.defaultValues[key] = typeof defaultValue === 'object' ? JSON.parse(JSON.stringify(defaultValue)) : defaultValue;
-        if (parse) this.parsers[key] = parse;
-        if (validate) this.validators[key] = validate;
-        this.assertValid(key, options.defaultValue);
-    }
-    /**
-   * Initializes the section.
-   * @param save - Indicates whether to save the section after initialization.
-   * @returns A string if an error occurred during initialization, otherwise void.
-   */ initialize(save = false) {
-        if (this.isInitialized) return;
-        const data = this.db.getSafe(this.prefix());
-        const result = objAssign({}, JSON.parse(JSON.stringify(this.defaultValues)), data || {});
-        this.db.set(this.prefix(), result, save);
-        this.isInitialized = true;
-    }
-}
-
-/**
- * Reads a JSON file and then parses it into an object.
- * If an error occurs, it returns undefined.
- *
- * @param filepath - The path to the JSON file.
- * @param options - Options for reading the JSON file.
- */ function readJsonFileSafeSync(filepath, options) {
-    try {
-        return fs.readJsonSync(filepath, options);
-    } catch (error) {
-        return undefined;
-    }
-}
-
-/**
- * Represents a simple JSON file database.
- */ class JsonDB {
-    /**
-   * Creates a new instance of the JsonDB class.
-   * @param filepath - The filepath where the data file is stored or to be stored.
-   */ constructor(filepath, indents = 0){
-        this.filepath = filepath;
-        this.indents = indents;
-        this.data = readJsonFileSafeSync(this.filepath) ?? {};
-    }
-    /**
-   * Saves the data to the JSON file.
-   */ async save(indents = this.indents) {
-        return await outputJson(this.filepath, this.data, {
-            spaces: indents
-        });
-    }
-    /**
-   * Sets the filepath of the JSON file.
-   * @param filepath - The new filepath.
-   */ setFilepath(filepath, save = true) {
-        if (this.filepath === filepath) return;
-        this.filepath = filepath;
-        if (save) this.save();
-    }
-    /**
-   * Sets a value in the JSON database.
-   * @param prefix - Object path prefix as dot-separated keys.
-   * @param value - The value to set.
-   * @param save - Whether to save the data to the JSON file.
-   */ set(prefix, value = {}, save = true) {
-        if (!prefix) {
-            this.data = ensureThat(value, isObject);
-        } else {
-            const keys = prefix.split('.');
-            const lastKey = keys.pop();
-            let node = this.data;
-            for (const key of keys){
-                if (!Object.hasOwn(node, key)) {
-                    node[key] = {};
-                }
-                node = node[key];
-            }
-            node[lastKey] = this.cloneDeep(value);
-        }
-        if (save) this.save();
-    }
-    /**
-   * Gets a value from the JSON database.
-   * @param prefix - Object path prefix as dot-separated keys.
-   * @returns The value associated with the key.
-   * @throws An error if no entry is found at the specified key.
-   */ get(prefix) {
-        const value = this.getSafe(prefix);
-        if (value === undefined) throw new Error(`No entry at '${prefix}'`);
-        return this.cloneDeep(value);
-    }
-    /**
-   * Gets a value from the JSON database safely.
-   * @param prefix - Object path prefix as dot-separated keys.
-   * @returns The value associated with the key, or undefined if no entry is found.
-   */ getSafe(prefix) {
-        if (!prefix) return this.cloneDeep(this.data);
-        const keys = prefix.split('.');
-        let node = this.data;
-        for (const key of keys){
-            if (!Object.hasOwn(node, key)) {
-                return undefined;
-            }
-            node = node[key];
-        }
-        return this.cloneDeep(node);
-    }
-    /**
-   * Checks if a key exists in the JSON database.
-   * @param prefix - Object path prefix as dot-separated keys.
-   * @returns True if the key exists, false otherwise.
-   */ has(prefix) {
-        if (!prefix) return true;
-        return this.getSafe(prefix) !== undefined;
-    }
-    /**
-   * Deletes a value from the JSON database.
-   * @param prefix - Object path prefix as dot-separated keys.
-   * @param save - Whether to save the data to the JSON file.
-   */ delete(prefix, save = true) {
-        if (!prefix) {
-            this.data = {};
-        } else {
-            const keys = prefix.split('.');
-            const lastKey = keys.pop();
-            let node = this.data;
-            for (const key of keys){
-                if (!Object.hasOwn(node, key)) {
-                    return;
-                }
-                node = node[key];
-            }
-            delete node[lastKey];
-        }
-        if (save) this.save();
-    }
-    /**
-   * Creates a deep clone of an object.
-   * @param obj - The object to clone.
-   * @returns The cloned object.
-   */ cloneDeep(obj) {
-        if (typeof obj !== 'object') return obj;
-        return JSON.parse(JSON.stringify(obj));
-    }
-}
-
-/**
- * A class that represents the user-presets section of the JSON file used as simple database.
- */ class PresetsSection extends AbstractJsonFileSection {
-    /**
-   * Creates an instance of AppDataSection.
-   * @param file - The parent JsonFile instance.
-   * @param name - The name of the section.
-   */ constructor(file, name){
-        super(file, name, false);
-        this.defineProperty('defaults', {
-            description: 'All presets inherit from this preset',
-            presets: [],
-            args: this.cmd.arguments.map((arg)=>arg.defaultValue ?? null),
-            options: this.cmd.getOwnAndGlobalOptions().reduce((acc, opt)=>{
-                acc[opt.attributeName()] = opt.defaultValue ?? (opt.isBoolean() ? false : null);
-                return acc;
-            }, {})
-        });
-    }
-    /**
-   * Asserts that a key-value pair is valid.
-   * @param key - The key to assert.
-   * @param value - The preset options to validate.
-   */ assertValid(key, value) {
-        this.cmd.assertValidPreset(key, value);
-    }
-    /**
-   * Defines a property for the section.
-   * @param key - The key of the property.
-   * @param options - The options for the property.
-   */ defineProperty(key, options) {
-        if (this.defaultValues[key]) throw new Error(`Cannot redefine preset '${key}'.`);
-        this.defaultValues[key] = JSON.parse(JSON.stringify(options));
-        this.assertValid(key, options);
-        this.isInitialized = false;
-    }
-    /**
-   * Initializes the section.
-   * @param save - Indicates whether to save the section after initialization.
-   * @returns A string if an error occurred during initialization, otherwise void.
-   */ initialize(save = false) {
-        if (this.isInitialized) return;
-        const data = this.db.getSafe(this.prefix());
-        const presets = objAssign({}, this.defaultValues, data || {});
-        const presetNames = Object.keys(presets);
-        for (const preset of Object.values(presets)){
-            for (const pname of presetNames){
-                if (preset.options[pname]) {
-                    preset.presets.push(pname);
-                    delete preset.options[pname];
-                    save = true;
-                }
-            }
-        }
-        this.db.set(this.prefix(), presets, save);
-        this.isInitialized = true;
-    }
-    /**
-   * Sets all the values in the section.
-   * @param values - The values to set.
-   * @param save - Indicates whether to save the section after setting the values.
-   */ async setAll(presets, save = true) {
-        if (!presets['defaults']) presets['defaults'] = JSON.parse(JSON.stringify(this.defaultValues['defaults']));
-        super.setAll(presets, save);
-    }
-    /**
-   * Deletes the value associated with the specified key.
-   * @param key - The key to delete.
-   * @param save - Indicates whether to save the section after deleting the value.
-   */ delete(name, save = true) {
-        if (Object.hasOwn(this.defaultValues, name)) throw new Error('Cannot delete the builtin presets.');
-        super.delete(name, save);
-    }
-}
-
-/**
- * A class that represents the JSON file used as a simple database.
- */ class JsonFile {
-    /**
-   * @param cmd The parent CommandBuilder instance.
-   */ constructor(cmd){
-        this.cmd = cmd;
-    }
-    /**
-   * A lazy-loaded instance of the JsonDB instance containing the data.
-   * Upon first property access, it is stored as a property on the instance.
-   * If the command is a subcommand, the root command's JsonDB instance is returned.
-   */ get db() {
-        if (this.cmd.isRoot) {
-            return realizeLazyProperty(this, 'db', new JsonDB(this.cmd.dataFilepath, 2));
-        } else {
-            return this.cmd.root.db.db;
-        }
-    }
-    /**
-   * A lazy-loaded instance of the `config` section of the JSON file.
-   * Upon first property access, it is stored as a property on the instance.
-   */ get config() {
-        return realizeLazyProperty(this, 'config', new ConfigSection(this, 'config'));
-    }
-    /**
-   * A lazy-loaded instance of the `appData` section of the JSON file.
-   * Upon first property access, it is stored as a property on the instance.
-   */ get appData() {
-        return realizeLazyProperty(this, 'appData', new AppDataSection(this, 'appData'));
-    }
-    /**
-   * A lazy-loaded instance of the `presets` section of the JSON file.
-   */ get presets() {
-        return realizeLazyProperty(this, 'presets', new PresetsSection(this, 'presets'));
-    }
-}
-
-class OptionArgumentParserSelector extends ParserSelector {
-    constructor(builder){
-        super(builder);
-    }
-    custom(parser) {
-        const name = this.builder.$.attributeName();
-        this.builder.cmd.meta.optParsers[name] = parser;
-        return this.builder;
-    }
-}
-
-class OptionArgumentValidatorSelector extends ValidatorSelector {
-    constructor(builder){
-        super(builder);
-    }
-    custom(validator) {
-        const name = this.builder.$.attributeName();
-        const obj = this.builder.cmd.meta.optValidators;
-        if (!obj[name]) obj[name] = [];
-        obj[name].push(validator);
-        return this.builder;
-    }
-}
-
-/**
- * Extract the argument name from an option's 'flags' string.
- */ function getArgumentName(opt) {
-    const result = arrLast(opt.flags.trim().split(' '));
-    if (/-/.test(result)) return undefined;
-    return result;
-}
-/**
- * Check if an option has an argument.
- */ function hasArgument(opt) {
-    return /[<>[\]]/.test(opt.flags);
-}
-/**
- * Update an Option's 'flags' property from its 'short' and 'long' properties.
- * The flags property is not automatically updated when 'short' or 'long' are changed.
- */ function renderFlags(opt) {
-    const shortLong = [];
-    if (opt.short) shortLong.push(opt.short);
-    if (opt.long) shortLong.push(opt.long);
-    const argName = getArgumentName(opt);
-    return shortLong.join(', ') + (argName ? ' ' + argName : '');
-}
-/**
- * Set an Option's 'long' name. The 'flags' property is updated accordingly.
- * The '--' prefix is automatically added if not present.
- */ function setLong(opt, long) {
-    opt.long = strEnsureStartsWith(long, '--').replace(/^-+/, '--');
-    opt.flags = renderFlags(opt);
-}
-/**
- * Set an Option's 'short' name. The 'flags' property is updated accordingly.
- * The '-' prefix is automatically added if not present.
- */ function setShort(opt, short) {
-    opt.short = strEnsureStartsWith(short, '-').replace(/^-+/, '-');
-    opt.flags = renderFlags(opt);
-}
-const OptionHelpers = {
-    getArgumentName,
-    hasArgument,
-    renderFlags,
-    setLong,
-    setShort
-};
-
-class OptionReader {
-    constructor(parent){
-        this.parent = parent;
-    }
-    get $() {
-        return this.parent.$;
-    }
-    get option() {
-        return this.parent.$;
-    }
-    get description() {
-        return this.$.description;
-    }
-    get optional() {
-        return this.$.optional;
-    }
-    get mandatory() {
-        return this.$.mandatory;
-    }
-    get hidden() {
-        return this.$.hidden;
-    }
-    get variadic() {
-        return this.$.variadic;
-    }
-    get short() {
-        return this.$.short;
-    }
-    get long() {
-        return this.$.long;
-    }
-    get preset() {
-        return this.$.presetArg;
-    }
-    get default() {
-        return this.$.defaultValue;
-    }
-    get choices() {
-        return this.$.argChoices;
-    }
-    get env() {
-        return this.$.envVar;
-    }
-    get flags() {
-        return this.$.flags;
-    }
-    get name() {
-        return this.$.name();
-    }
-    get attributeName() {
-        return this.$.attributeName();
-    }
-    get defaultValueDescription() {
-        return this.$.defaultValueDescription;
-    }
-    get hasArgument() {
-        return OptionHelpers.hasArgument(this.parent.$);
-    }
-}
-
-/**
- * Wrapper around the @see Option class, for more intuitive construction.
- * @remarks Options are one of boolean, negated, required argument, or optional argument.
- */ class OptionBuilder {
-    constructor(cmd, flags){
-        this.cmd = cmd;
-        this.$ = new Option(flags);
-        if (!OptionHelpers.hasArgument(this.$) && this.$.long?.startsWith('--no-')) {
-            this.$.default(true);
-        }
-    }
-    description(string) {
-        this.$.description = string;
-        return this;
-    }
-    mandatory(mandatory = true) {
-        this.$.makeOptionMandatory(mandatory);
-        return this;
-    }
-    hideHelp(hide = true) {
-        this.$.hideHelp(hide);
-        return this;
-    }
-    hidden(hidden = true) {
-        this.$.hidden = hidden;
-        return this;
-    }
-    preset(arg) {
-        this.$.preset(arg);
-        return this;
-    }
-    default(value, description) {
-        this.$.default(value, description);
-        return this;
-    }
-    choices(values) {
-        if (!OptionHelpers.hasArgument(this.$)) {
-            throw new Error('Cannot set choices on option with no argument: ' + this.$.name());
-        }
-        this.$.choices(values);
-        return this;
-    }
-    conflicts(names) {
-        this.$.conflicts(names);
-        return this;
-    }
-    implies(optionValues) {
-        this.$.implies(optionValues);
-        return this;
-    }
-    env(name) {
-        this.$.env(name);
-        return this;
-    }
-    short(short) {
-        OptionHelpers.setShort(this.$, short);
-        return this;
-    }
-    get parser() {
-        if (!OptionHelpers.hasArgument(this.$)) {
-            throw new Error('Cannot set parser on option with no argument: ' + this.$.attributeName());
-        }
-        return new OptionArgumentParserSelector(this);
-    }
-    get validator() {
-        if (!OptionHelpers.hasArgument(this.$)) {
-            throw new Error('Cannot set validator on option with no argument: ' + this.$.attributeName());
-        }
-        return new OptionArgumentValidatorSelector(this);
-    }
-    get get() {
-        return realizeLazyProperty(this, 'get', new OptionReader(this));
-    }
-}
-
-/**
- * Updates the property descriptors of the specified properties on the given object.
- * @param object - The object whose property descriptors are to be updated.
- * @param properties - An array of property names for which the descriptors are to be updated.
- * @param update - A function that takes a property descriptor and a property name, and returns a new property descriptor.
- * @throws Will throw an error if any of the specified properties do not exist on the object.
- * @example ```ts
- * const obj = { a: 1, b: 2 };
- * objUpdatePropertyDescriptors(obj, ['a', 'b'], (descriptor, property) => {
- *   descriptor.writable = true;
- *   return obj;
- * });
- * ```
- */ function objUpdatePropertyDescriptors(object, properties, update) {
-    for (const p of properties){
-        if (!Reflect.has(object, p)) {
-            throw new Error(`Property, '${p}' does not exist on object.`);
-        }
-        const descriptor = update(Object.getOwnPropertyDescriptor(object, p), p);
-        Object.defineProperty(object, p, descriptor);
-    }
-}
-
-/**
- * Sets the specified properties of an object as non-enumerable.
- * @remarks This function modifies the original object by setting the specified properties as non-enumerable.
- * If the object or any of the property names are not valid, it throws an error.
- * @param object The object whose properties are to be set as non-enumerable.
- * @param properties The names of the properties to be set as non-enumerable.
- * @throws Will throw an error if any of the specified properties do not exist on the object.
- * @example ```ts
- * setNonEnumerable({ a: 1, b: 2, c: 3 }, 'a', 'b');
- * Object.keys({ a: 1, b: 2, c: 3 });;
- * //=> ['c']
- * ```
- */ function setNonEnumerable(object, ...properties) {
-    objUpdatePropertyDescriptors(object, properties, (descriptor)=>{
-        descriptor.enumerable = false;
-        return descriptor;
-    });
-}
-
-/**
- * Wrapper around the @see Command class, for more intuitive construction.
- */ class CommandBuilder {
-    static{
-        this.dataDirectory = path.join(os.homedir(), 'config', 'cli');
-    }
-    get db() {
-        return realizeLazyProperty(this, 'db', new JsonFile(this));
-    }
-    constructor(name, callback, parent, isNative = false){
-        this.features = new CommandFeatureSelector(this);
-        this.parent = null;
-        this.meta = new CommandBuilderMetaData();
-        this.meta.isNative = isNative;
-        this.$ = new Command(name);
-        commanderBackRefs.set(this.$, this);
-        if (parent) {
-            this.parent = parent;
-            this.parent.meta.subcommands.push(this);
-            this.parent.$.addCommand(this.$);
-        }
-        this.initializeHelp();
-        this.initializeActionWrapper();
-        if (callback) callback.call(this, this);
-        if (this.parent) {
-            this.$.copyInheritedSettings(this.parent.$);
-            this.features.inheritFrom(this.parent.features);
-            this.inheritParentHiddenGlobals();
-        }
-        if (!this.meta.isNative) {
-            this.assertCommandNameNotReserved(this.name);
-            this.addUtilCommands();
-        }
-        if (this.features.isAutoAssignSubCommandAliasesEnabled) {
-            this.assignSubCommandAliases();
-            if (!this.meta.isNative) {
-                this.assertNoDuplicateCommandNames();
-            }
-        }
-        if (this.features.isAutoAssignMissingOptionFlagsEnabled) {
-            this.assignMissingOptionFlags();
-            if (!this.meta.isNative) {
-                this.assertNoDuplicateOptionNames();
-            }
-        }
-        this.meta.isInitialized = true;
-    }
-    setRecommended() {
-        this.enableBuiltinOptions({
-            debug: true,
-            disableStderr: true,
-            disableStdout: true
-        });
-        this.autoAssignMissingOptionFlags();
-        this.autoAssignSubCommandAliases();
-        this.presetsEnabled();
-    }
-    deleteDataFile() {
-        const filepath = this.dataFilepath;
-        if (fs.existsSync(filepath)) remove(filepath);
-    }
-    version(string) {
-        this.assertNotInitialized();
-        this.$.version(string);
-        const opt = this.options.find((o)=>o.attributeName() === 'version');
-        if (opt) this.meta.globalOptions.push(opt);
-        return this;
-    }
-    description(...lines) {
-        this.assertNotInitialized();
-        const description = lines.join('\n');
-        const summary = description.split(/(\. ?|\n|$)/)[0];
-        this.$.summary(summary + '.');
-        this.$.description(description);
-        return this;
-    }
-    alias(alias) {
-        this.assertNotInitialized();
-        this.assertCommandNameNotReserved(alias);
-        this.$.alias(alias);
-        return this;
-    }
-    aliases(...aliases) {
-        this.assertNotInitialized();
-        aliases.forEach((alias)=>this.assertCommandNameNotReserved(alias));
-        this.$.aliases(aliases);
-        return this;
-    }
-    enableBuiltinOptions(options) {
-        this.assertNotInitialized();
-        if (!options || options.debug) this.globalOption('-D, --debug', 'Output debugging information.');
-        if (!options || options.disableColor) this.globalOption('-C, --disable-color', 'Disable color in terminal output.');
-        if (!options || options.disableStderr) this.globalOption('-E, --disable-stderr', 'Mute all output to stderr.');
-        if (!options || options.disableStdout) this.globalOption('-O, --disable-stdout', 'Mute all output to stdout.');
-        return this;
-    }
-    argument(name, cb) {
-        this.assertNotInitialized();
-        const ins = new ArgumentBuilder(this, name);
-        this.$.addArgument(ins.$);
-        if (typeof cb === 'function') {
-            cb(ins, this);
-        } else if (typeof cb === 'string') {
-            ins.description(cb);
-        }
-        return this;
-    }
-    option(flags, cb) {
-        this.assertNotInitialized();
-        const ins = new OptionBuilder(this, flags);
-        if (this.hasIdenticalParentOption(ins.$)) return this;
-        this.$.addOption(ins.$);
-        if (typeof cb === 'function') {
-            cb(ins, this);
-        } else if (typeof cb === 'string') {
-            ins.description(cb);
-        }
-        return this;
-    }
-    globalOption(flags, cb) {
-        return this.option(flags, (ins)=>{
-            const opt = ins.$;
-            this.meta.globalOptions.push(opt);
-            if (typeof cb === 'function') {
-                cb(ins, this);
-            } else if (typeof cb === 'string') {
-                ins.description(cb);
-            }
-            if (opt.hidden) this.meta.hiddenGlobalOptions.add(opt);
-        });
-    }
-    command(name, cb) {
-        this.assertNotInitialized();
-        new CommandBuilder(name, cb, this);
-        return this;
-    }
-    nativeCommand(name, cb) {
-        this.assertNotInitialized();
-        new CommandBuilder(name, cb, this, true);
-        return this;
-    }
-    action(fn) {
-        this.assertNotInitialized();
-        Object.defineProperty(this.meta, 'actionHandler', {
-            value: fn,
-            configurable: true
-        });
-        return this;
-    }
-    errorHandler(fn) {
-        this.assertNotInitialized();
-        Object.defineProperty(this.meta, 'errorHandler', {
-            value: fn,
-            configurable: true
-        });
-        return this;
-    }
-    appData(key, value) {
-        this.assertNotInitialized();
-        this.features.appData(true);
-        this.db.appData.defineProperty(key, value);
-        return this;
-    }
-    config(key, entry) {
-        this.assertNotInitialized();
-        this.features.config(true);
-        this.db.config.defineProperty(key, entry);
-        return this;
-    }
-    preset(name, preset) {
-        this.assertNotInitialized();
-        this.features.presets();
-        this.meta.presetOptionKeys.push(name);
-        this.db.presets.defineProperty(name, {
-            description: preset.description,
-            presets: preset.presets ?? [],
-            args: preset.args ?? [],
-            options: preset.options ?? {}
-        });
-        return this;
-    }
-    presetsEnabled(boolean = true) {
-        this.assertNotInitialized();
-        this.features.presets(boolean);
-        return this;
-    }
-    autoAssignMissingOptionFlags(boolean = true) {
-        this.assertNotInitialized();
-        this.features.autoAssignMissingOptionFlags(boolean);
-        return this;
-    }
-    autoAssignSubCommandAliases(boolean = true) {
-        this.assertNotInitialized();
-        this.features.autoAssignSubCommandAliases(boolean);
-        return this;
-    }
-    allowExcessArguments(bool = true) {
-        this.assertNotInitialized();
-        this.$.allowExcessArguments(bool);
-        return this;
-    }
-    allowUnknownOption(bool = true) {
-        this.assertNotInitialized();
-        this.$.allowUnknownOption(bool);
-        return this;
-    }
-    /**
-   * Register callback to use as replacement for calling process.exit.
-   */ exitOverride(callback) {
-        this.assertNotInitialized();
-        this.$.exitOverride(callback);
-        return this;
-    }
-    throwInsteadOfProcessExit() {
-        this.assertNotInitialized();
-        const onErr = (err)=>{
-            throw err;
-        };
-        this.exitOverride(onErr);
-        this.errorHandler(onErr);
-    }
-    /**
-   * Add hook for life cycle event.
-   */ hook(event, listener) {
-        this.assertNotInitialized();
-        this.$.hook(event, listener);
-        return this;
-    }
-    /**
-   * You can customise the help by overriding Help properties using configureHelp(),
-   * or with a subclass of Help by overriding createHelp().
-   */ configureHelp(configuration) {
-        this.assertNotInitialized();
-        this.$.configureHelp(configuration);
-        return this;
-    }
-    /**
-   * Display the help or a custom message after an error occurs.
-   */ showHelpAfterError(displayHelp) {
-        this.assertNotInitialized();
-        this.$.showHelpAfterError(displayHelp);
-        return this;
-    }
-    /**
-   * Display suggestion of similar commands for unknown commands, or options for unknown options.
-   */ showSuggestionAfterError(displaySuggestion) {
-        this.assertNotInitialized();
-        this.$.showSuggestionAfterError(displaySuggestion);
-        return this;
-    }
-    /**
-   * Add additional text to be displayed with the built-in help.
-   *
-   * Position is 'before' or 'after' to affect just this command,
-   * and 'beforeAll' or 'afterAll' to affect this command and all its subcommands.
-   */ addHelpText(position, text) {
-        this.assertNotInitialized();
-        this.$.addHelpText(position, text);
-        return this;
-    }
-    throwCommanderError(message, exitCode = 1, type = 'error') {
-        throw new CommanderError(exitCode, type, message);
-    }
-    hideGlobalOptions(...names) {
-        this.assertNotInitialized();
-        const globals = this.getGlobalOptions();
-        names = names.length ? names : globals.map((opt)=>opt.attributeName());
-        for (const name of names){
-            if (!name) continue;
-            let found = false;
-            for (const opt of globals){
-                if (opt.attributeName() === name) {
-                    this.meta.hiddenGlobalOptions.add(opt);
-                    found = true;
-                    break;
-                }
-            }
-            if (!found) this.throwCommanderError(`Unknown global option name: ${name} for command, ${this.name}`);
-        }
-        return this;
-    }
-    unhideGlobalOptions(...names) {
-        this.assertNotInitialized();
-        const globals = this.getGlobalOptions();
-        names = names.length ? names : globals.map((opt)=>opt.attributeName());
-        for (const name of names){
-            if (!name) continue;
-            let found = false;
-            for (const opt of globals){
-                if (opt.attributeName() === name) {
-                    this.meta.hiddenGlobalOptions.delete(opt);
-                    found = true;
-                    break;
-                }
-            }
-            if (!found) this.throwCommanderError(`Unknown global option name: ${name} for command, ${this.name}`);
-        }
-        return this;
-    }
-    /**
-   * Set the directory for searching for executable subcommands of this command.
-   */ executableDir(path) {
-        this.assertNotInitialized();
-        this.$.executableDir(path);
-        return this;
-    }
-    /**
-   * Store option value.
-   */ setOptionValue(key, value) {
-        this.assertNotInitialized();
-        this.$.setOptionValue(key, value);
-        return this;
-    }
-    /**
-   * Store option value and where the value came from.
-   */ setOptionValueWithSource(key, value, source) {
-        this.assertNotInitialized();
-        this.$.setOptionValueWithSource(key, value, source);
-        return this;
-    }
-    setDataFilepath(filepath) {
-        this.assertNotInitialized();
-        Object.defineProperty(this, 'dataFilepath', {
-            value: filepath
-        });
-        if (Object.hasOwn(this, 'db') && Object.hasOwn(this.db, 'db')) {
-            this.db.db.setFilepath(filepath);
-        }
-    }
-    /**
-   * Display error message and exit (or call exitOverride).
-   */ outputError(message, options) {
-        this.$.error(message, options);
-    }
-    /**
-   * Output help information for this command.
-   */ outputHelp() {
-        console.log(this.getRenderedHelp());
-    }
-    /**
-   * Display error message and exit (or call exitOverride).
-   */ outputDebugMessage(event, getProps = ()=>({})) {
-        OutputManager.getInstance().outputDebug(()=>({
-                event,
-                cmd: this.getPrefixString(),
-                ...getProps()
-            }));
-    }
-    parseArguments(args) {
-        const last = this.arguments.length - 1;
-        return args.map((arg, i)=>{
-            if (!arg) return arg;
-            const parse = this.meta.argParsers[i > last ? last : i];
-            return parse ? Array.isArray(arg) ? arg.map(parse) : parse(arg) : arg;
-        });
-    }
-    /**
-   * Parses (and validates) options using the parsers defined in the command builder.
-   */ parseOptions(opts) {
-        for (const [key, value] of Object.entries(opts)){
-            const parse = this.meta.optParsers[key];
-            opts[key] = parse ? Array.isArray(value) ? value.map(parse) : parse(value) : value;
-        }
-        return opts;
-    }
-    /**
-   * Validate ALREADY PARSED args using the validators defined in the command builder.
-   */ assertValidArguments(parsedArgs) {
-        const last = this.arguments.length - 1;
-        parsedArgs.forEach((arg, i)=>{
-            if (arg == null) return;
-            const index = i > last ? last : i;
-            const validators = this.meta.argValidators[index];
-            if (!validators) return;
-            for (const isValid of validators){
-                ensureThat(arg, isValid, {
-                    Err: InvalidArgumentError
-                });
-            }
-        });
-        return parsedArgs;
-    }
-    /**
-   * Validate ALREADY PARSED options using the validators defined in the command builder.
-   */ assertValidOptions(parsedOptions) {
-        for (const [key, value] of Object.entries(parsedOptions)){
-            if (!this.meta.optValidators[key]) continue;
-            if (value == null) continue;
-            for (const isValid of this.meta.optValidators[key]){
-                ensureThat(value, isValid);
-            }
-        }
-        return parsedOptions;
-    }
-    assertValidPreset(key, preset) {
-        const { description, presets, args, options } = preset;
-        ensureThat(key, isStringWithNoSpacesOrDashes);
-        ensureThat(description, isString);
-        ensureThat(presets, isStringArray);
-        ensureThat(args, isArray);
-        this.assertPresetArgsOptional(args);
-        this.assertValidArguments(args);
-        ensureThat(options, isObject);
-        this.assertValidOptions(options);
-    }
-    get name() {
-        return this.$.name();
-    }
-    /**
-   * Get the command at the root of the command tree.
-   */ get root() {
-        if (this.isRoot) return this;
-        return this.getAncestors().pop();
-    }
-    get isRoot() {
-        return !this.parent;
-    }
-    get arguments() {
-        return this.$.registeredArguments;
-    }
-    get options() {
-        return this.$.options;
-    }
-    get commander() {
-        return this.$;
-    }
-    get hasGrandChildren() {
-        return this.meta.subcommands.some((sub)=>!!sub.meta.subcommands.length);
-    }
-    /**
-   * Returns whether a command's last argument is variadic.
-   */ get isLastArgVariadic() {
-        if (!this.arguments.length) return false;
-        return arrLast(this.arguments).variadic;
-    }
-    get dataFilepath() {
-        return path.join(CommandBuilder.dataDirectory, this.root.name + '.json');
-    }
-    /**
-   * Get the executable search directory.
-   */ getExecutableDir() {
-        return this.$.executableDir();
-    }
-    /**
-   * Retrieve option value.
-   */ getOptionValue(key) {
-        return this.$.getOptionValue(key);
-    }
-    /**
-   * Get source of option value.
-   */ getOptionValueSource(key) {
-        return this.$.getOptionValueSource(key);
-    }
-    /**
-   * Get source of option value. See also .optsWithGlobals().
-   */ getOptionValueSourceWithGlobals(key) {
-        return this.$.getOptionValueSourceWithGlobals(key);
-    }
-    getActionHandler() {
-        return this.meta.actionHandler;
-    }
-    getDescription() {
-        return this.$.description();
-    }
-    getSummary() {
-        return this.$.summary();
-    }
-    getVersion() {
-        return this.$.version();
-    }
-    getAlias() {
-        return this.$.alias();
-    }
-    getAliases() {
-        return this.$.aliases();
-    }
-    /**
-   * Get a commands prefix array based on all its parent/ancestor commands.
-   */ getPrefixArray() {
-        return this.getAncestors({
-            includeSelf: true
-        }).reverse().map((node)=>node.name);
-    }
-    /**
-   * Get a commands prefix string based on all its parent/ancestor commands.
-   */ getPrefixString() {
-        return this.getPrefixArray().join(' ');
-    }
-    getGlobalOptions() {
-        const result = [];
-        for (const anc of this.getAncestors({
-            includeSelf: true
-        }).reverse()){
-            for (const gopt of anc.meta.globalOptions){
-                if (!this.meta.hiddenGlobalOptions.has(gopt)) {
-                    result.push(gopt);
-                }
-            }
-        }
-        return result;
-    }
-    getOwnAndGlobalOptions() {
-        return this.options.concat(this.getGlobalOptions());
-    }
-    *getChildrenIterator(options) {
-        if (options?.includeSelf) yield this;
-        for (const sub of this.meta.subcommands){
-            yield sub;
-            yield* sub.getChildrenIterator();
-        }
-    }
-    getChildren(options) {
-        return [
-            ...this.getChildrenIterator(options)
-        ];
-    }
-    *getAncestorsIterator(options) {
-        if (options?.includeSelf) yield this;
-        let node = this.parent;
-        while(node){
-            yield node;
-            node = node.parent;
-        }
-    }
-    /**
-   * Get a command's ancestors, optionally starting from the command itself.
-   */ getAncestors(options) {
-        return [
-            ...this.getAncestorsIterator(options)
-        ];
-    }
-    *getSiblingsIterator() {
-        if (!this.parent) return;
-        for (const sub of this.parent.meta.subcommands){
-            if (sub === this) continue;
-            yield sub;
-        }
-    }
-    /**
-   * Returns an array of sibling CommandBuilder objects.
-   */ getSiblings() {
-        return [
-            ...this.getSiblingsIterator()
-        ];
-    }
-    getClosestNonNativeParent() {
-        for (const anc of this.getAncestorsIterator({
-            includeSelf: true
-        })){
-            if (!anc.meta.isNative) return anc;
-        }
-        this.throwCommanderError('No non-native parent found');
-    }
-    getRenderedHelp() {
-        return this.$.helpInformation();
-    }
-    getOptsWithGlobalsParsed() {
-        return this.parseOptions(this.$.optsWithGlobals());
-    }
-    getParsedValidArgsOptsWithPresets() {
-        const [presetArgs, presetOpts, presetOrder] = this.getPresetArgsAndOpts();
-        const args = this.getParsedValidArgsWithPresets(presetArgs);
-        const opts = this.getParsedValidOptsWithPresets(presetOpts);
-        this.debugLogArgsOpts(args, opts, presetArgs, presetOpts, presetOrder);
-        return [
-            args,
-            opts
-        ];
-    }
-    getParsedValidArgsWithPresets(presetArgs) {
-        const result = arrAssign([], ...presetArgs, this.parseArguments(this.$.args));
-        this.combineVariadicArgs(result);
-        this.assertValidArguments(result);
-        return this.padArgsWithUndefinedUntilExpectedLength(result);
-    }
-    getParsedValidOptsWithPresets(presetOpts) {
-        const parsed = this.getOptsWithGlobalsParsed();
-        const opts = presetOpts.length ? objAssign({}, ...presetOpts, parsed) : parsed;
-        this.deleteOptionsWithDefaultOrNoValue(opts);
-        this.assertValidOptions(opts);
-        return opts;
-    }
-    getPresetArgsAndOpts() {
-        if (!this.features.isPresetsEnabled) return [
-            [],
-            [],
-            []
-        ];
-        const presets = this.db.presets.getAll();
-        const opts = this.$.optsWithGlobals();
-        const selectedPresets = Object.keys(presets).filter((name)=>opts[name] === true);
-        const presetOrder = Object.keys(opts).filter((key)=>selectedPresets.includes(key));
-        const presetArgs = presetOrder.map((name)=>presets[name].args);
-        const presetOpts = presetOrder.map((name)=>presets[name].options);
-        return [
-            presetArgs,
-            presetOpts,
-            presetOrder
-        ];
-    }
-    combineVariadicArgs(result) {
-        if (this.isLastArgVariadic && result.length && !Array.isArray(arrLast(result))) {
-            const rest = result.splice(this.arguments.length - 1);
-            result.push(rest.filter((arg)=>arg != null));
-        }
-        return result;
-    }
-    debugLogArgsOpts(args, opts, presetArgs, presetOpts, presetOrder) {
-        if (opts['debug']) {
-            if (this.features.isPresetsEnabled) {
-                this.outputDebugMessage('parsePresets', ()=>({
-                        presetOrder,
-                        presetArgs,
-                        presetOpts
-                    }));
-            }
-            this.outputDebugMessage('parseArgsOpts', ()=>{
-                return {
-                    args,
-                    opts,
-                    command: [
-                        this.root.name,
-                        ...this.meta.rawArgs
-                    ].join(' ')
-                };
-            });
-        }
-    }
-    deleteOptionsWithDefaultOrNoValue(opts) {
-        const names = new Set(this.getOwnAndGlobalOptions().map((o)=>o.attributeName()));
-        for (const [key, value] of Object.entries(opts)){
-            if (!names.has(key) || value === false || value == null) {
-                setNonEnumerable(opts, key);
-            }
-        }
-        for (const key of this.meta.presetOptionKeys){
-            if (Object.hasOwn(opts, key)) {
-                setNonEnumerable(opts, key);
-            }
-        }
-        return opts;
-    }
-    handleOutputOptions() {
-        const opts = this.$.optsWithGlobals();
-        const om = OutputManager.getInstance().reset();
-        if (opts['disableColor']) om.colors.enabled = false;
-        if (opts['disableStderr']) om.stderr.disable();
-        if (opts['disableStdout']) om.stdout.disable();
-        if (opts['debug']) {
-            om.debug.enable();
-            om.drainDebugMessageQueue();
-        }
-    }
-    padArgsWithUndefinedUntilExpectedLength(args) {
-        while(args.length < this.arguments.length)args.push(undefined);
-        return args;
-    }
-    assertPresetArgsOptional(args) {
-        args.forEach((arg, i)=>{
-            if (arg != null && i < this.arguments.length && this.arguments[i].required) {
-                this.throwCommanderError(`Cannot preset required arguments.`);
-            }
-        });
-    }
-    addUtilCommands() {
-        if (!this.hasGrandChildren && !this.features.isConfigEnabled && !this.features.isPresetsEnabled && !this.features.isAppDataEnabled) {
-            return;
-        }
-        this.nativeCommand('util', (u)=>{
-            const cmd = u.getClosestNonNativeParent();
-            u.alias('u');
-            u.description('Utility commands.');
-            if (cmd.features.isConfigEnabled) {
-                u.nativeCommand('config', createConfigCommand);
-            }
-            if (cmd.features.isPresetsEnabled && cmd.meta.hasCustomActionHandler) {
-                u.nativeCommand('presets', createPresetsCommand);
-            }
-            if (cmd.hasGrandChildren) {
-                u.nativeCommand('list', createUtilListCommand);
-            }
-            if (cmd.features.isConfigEnabled || cmd.features.isPresetsEnabled || cmd.features.isAppDataEnabled) {
-                u.nativeCommand('filepath', createUtilFilepathCommand);
-            }
-            function createUtilFilepathCommand(f) {
-                f.alias('f');
-                f.description('Print filepath to JSON file containing user data, eg. config and presets.');
-                f.action(async ()=>console.log(cmd.dataFilepath));
-            }
-            function createUtilListCommand(l) {
-                l.alias('l');
-                l.description('List nested subcommands.');
-                l.option('--all', 'Include utility commands.');
-                l.action(async (opts)=>{
-                    const filter = opts.all ? undefined : (prefix)=>{
-                        return !/ (config|presets|util)( .+)?$/gi.test(prefix);
-                    };
-                    const table = [];
-                    for (const c of cmd.getChildrenIterator({
-                        includeSelf: true
-                    })){
-                        const prefix = c.getPrefixString();
-                        if (filter && !filter(prefix)) continue;
-                        table.push([
-                            prefix,
-                            c.getSummary()
-                        ]);
-                    }
-                    const ansi = table.map((row)=>{
-                        const arr = row[0].split(' ');
-                        const last = arr.pop();
-                        let col = colors.magenta;
-                        if (row[1].startsWith('[Preset]')) {
-                            col = colors.green;
-                        } else if (/ (util|config|presets) /.test(row[0])) {
-                            col = colors.gray;
-                        } else if (/ (util|config|presets)/.test(row[0])) {
-                            col = colors.dim;
-                        }
-                        row[0] = arr.map(colors.dim).concat(col(last)).join(' ');
-                        return row;
-                    });
-                    console.log(formatTableForTerminal(ansi, [
-                        'Command',
-                        'Summary'
-                    ]));
-                });
-            }
-            function createPresetsCommand(p) {
-                const db = cmd.db.presets;
-                p.alias('p');
-                p.description('Edit presets in your text editor', '', 'A preset consists of pre-set arguments and/or options for a command.', 'Additionally, a preset can have other presets as dependencies.', 'When running the command, multiple presets can be stacked.', 'Required arguments cannot be pre-set.');
-                p.nativeCommand('edit', (e)=>{
-                    e.alias('e');
-                    e.description('Edit as JSON in a text editor.');
-                    e.option('--editor [cmd]', 'The command to launch your preferred text editor.');
-                    e.action(async (opts)=>{
-                        db.edit(opts.editor);
-                        console.info(db.getAll());
-                    });
-                });
-                p.nativeCommand('list', (l)=>{
-                    l.alias('l');
-                    l.description('List all presets.');
-                    l.action(async ()=>console.dir(db.getAll(), {
-                            depth: null
-                        }));
-                });
-                for (const [key, preset] of Object.entries(db.getAll())){
-                    if (key === 'defaults') continue;
-                    cmd.option(`--${key}`, (o)=>{
-                        o.description('[Preset]: ' + preset.description);
-                        const implied = {
-                            defaults: true
-                        };
-                        const recurse = (preset)=>{
-                            if (implied[preset]) return;
-                            implied[preset] = true;
-                            db.get(preset).presets.forEach((k)=>recurse(k));
-                        };
-                        recurse(key);
-                        o.implies(implied);
-                    });
-                }
-            }
-            function createConfigCommand(c) {
-                const db = cmd.db.config;
-                c.alias('c');
-                c.description('Manage configuration file.');
-                c.nativeCommand('edit', (e)=>{
-                    e.alias('e');
-                    e.description('Edit as JSON in a text editor.');
-                    e.option('--editor [cmd]', 'The command to launch your preferred text editor.');
-                    e.action(async (opts)=>{
-                        db.edit(opts.editor);
-                        console.info(db.getAll());
-                    });
-                });
-                c.nativeCommand('list', (l)=>{
-                    l.alias('l');
-                    l.description('Print entire config with details.');
-                    l.action(async ()=>{
-                        const result = db.keys.map((key)=>({
-                                key,
-                                description: db.descriptions[key],
-                                value: db.get(key),
-                                defaultValue: db.defaultValues
-                            }));
-                        console.dir(result, {
-                            depth: null
-                        });
-                    });
-                });
-                c.nativeCommand('get', (g)=>{
-                    g.alias('g');
-                    g.description('Print value(s) from the config.');
-                    g.argument('[key]', 'The key to print the value of. Omit to print all values.');
-                    g.action(async (key)=>console.log(key ? db.get(key) : db.getAll()));
-                });
-                c.nativeCommand('set', (s)=>{
-                    s.alias('s');
-                    s.description('Set a value in the config.');
-                    s.argument('<key>', 'The key to set the value of.');
-                    s.argument('<value>', 'The new value.');
-                    s.action(async (key, val)=>{
-                        const parse = db.parsers[key];
-                        const value = typeof parse === 'function' ? parse(val) : val;
-                        db.set(key, value);
-                        console.info({
-                            [key]: value
-                        });
-                    });
-                });
-                c.nativeCommand('reset', (r)=>{
-                    r.alias('r');
-                    r.description('Reset to defaults.');
-                    r.argument('[key]', 'The key for which to reset the value. Omit to reset entire config.');
-                    r.action(async (key)=>{
-                        if (key) db.reset(key);
-                        else db.resetAll();
-                        console.info(db.getAll());
-                    });
-                });
-            /*
-        config.option('--editor [cmd]', (o) => {
-          o.description('The command to launch your preferred text editor.')
-        })
-        config.argument('[action]', (a) => {
-          a.description('The action to perform.')
-          a.choices(['edit', 'list', 'get', 'set', 'reset'])
-          a.default('edit')
-        })
-        config.argument('[key]', (a) => {
-          a.description('Property key (if applicable)')
-        })
-        config.argument('[value]', (a) => {
-          a.description('Value to set (if applicable)')
-        })
-        config.action(
-          async (action: string, key: string, value: string, opts: { editor: string }, config: CommandBuilder) => {
-            const cmd = config.getClosestNonNativeParent()
-            const cfg = cmd.db.config
-            if (!action || action === 'edit') {
-              cfg.edit(opts.editor)
-              return console.info(cfg.getAll())
-            } else if (action === 'list') {
-              return console.dir(
-                cfg.keys.map((key: string) => {
-                  return {
-                    key,
-                    description: cfg.descriptions[key],
-                    value: cfg.get(key),
-                    defaultValue: cfg.defaultValues,
-                  }
-                })
-              )
-            } else if (action === 'get') {
-              if (key) return console.log(cfg.get(key))
-              else return console.log(cfg.getAll())
-            } else if (action === 'set') {
-              const from = cfg.get(key)
-              const parse = cfg.parsers[key]
-              const to = typeof parse === 'function' ? cfg.parsers[key](value) : value
-              cfg.set(key, to)
-              return console.info({ changed: key, from, to })
-            } else if (action === 'reset') {
-              if (key) cfg.reset(key)
-              else cfg.resetAll()
-              return console.info(cfg.getAll())
-            }
-          }
-        )*/ }
-        });
-    }
-    /**
-   * Makes aliases for the command.
-   * The idea is to be able to navigate the command tree by only typing the first letter(s) of the command names.
-   *
-   * Example: A command 'cola' would get these aliases: ['c', 'co', 'col'].
-   * However, if there are namespace clashes with sibling subcommands that start with the same letter,
-   * eg. like 'cola' and 'coal' where the first two letters clash, cola's aliases are reduced to only ['col'] and similarly for 'coal'.
-   *
-   * This method creates the aliases, ensuring there are no clashes with sublings, why it is important that the
-   * entire command tree is built before invoking this method.
-   */ assignSubCommandAliases() {
-        if (this.getAlias() || this.name.length <= 1) return this;
-        const sibAliases = this.getSiblings().map((sib)=>sib.getAliases()).flat();
-        for(let i = 0; i < this.name.length - 1; i++){
-            let cmdAlias = this.name.substring(0, i + 1);
-            let isClash = arrSome(sibAliases, (sibAlias)=>{
-                return cmdAlias === sibAlias;
-            });
-            if (isClash && i === 0) {
-                cmdAlias = cmdAlias.charAt(0).toUpperCase();
-                isClash = arrSome(sibAliases, (sibAlias)=>{
-                    return cmdAlias === sibAlias;
-                });
-            }
-            if (isClash) continue;
-            this.alias(cmdAlias);
-            return this;
-        }
-        return this;
-    }
-    /**
-   * Automatically set 'short' and 'long' names to options that don't have one assigned yet.
-   *
-   * First, it tries to assign a short name based on the first letter of the option's attribute name
-   * Both lower and upper case are tried. If these is not available, the next letter of the option name is tried.
-   *
-   * If none of the letters of the option name are available, the option is skipped until all other
-   * options have had letters from their names attempted assigned.
-   * Those that remain are assigned the first available letter of the alphabet + 0-9.
-   * If there are 64 options for the command and no more alphanumeric characters are available,
-   * the option is not assigned a short name.
-   */ assignMissingOptionFlags() {
-        const taken = new Set();
-        for (const anc of this.getAncestorsIterator({
-            includeSelf: true
-        })){
-            anc.options.forEach((opt)=>{
-                if (!opt.short) return;
-                taken.add(opt.short.replace(/^-/g, ''));
-            });
-        }
-        const failed = new Set();
-        // assign letter from option name
-        this.options.forEach((opt)=>{
-            if (opt.short) return;
-            const name = opt.attributeName();
-            for(let c = 0; c < name.length; c++){
-                let char = name.charAt(c).toLowerCase();
-                if (taken.has(char)) {
-                    char = char.toUpperCase();
-                    if (taken.has(char)) continue;
-                }
-                OptionHelpers.setShort(opt, char);
-                taken.add(char);
-                return;
-            }
-            failed.add(opt);
-        });
-        // assign random alphanumeric character.
-        const name = 'abcdefghijklmnopqrstuvwxyz1234567890';
-        failed.forEach((opt)=>{
-            for(let c = 0; c < name.length; c++){
-                let char = name.charAt(c);
-                if (taken.has(char)) {
-                    char = char.toUpperCase();
-                    if (taken.has(char)) continue;
-                }
-                OptionHelpers.setShort(opt, char);
-                taken.add(char);
-                return;
-            }
-        });
-    }
-    assertNoDuplicateCommandNames() {
-        const names = this.$.commands.map((sub)=>sub.aliases().concat(sub.name())).flat();
-        if (names.length !== new Set(names).size) {
-            this.throwCommanderError(`Duplicate subcommand names/aliases found for command, ${this.name}: ${names.join(', ')}`);
-        }
-    }
-    hasIdenticalParentOption(option) {
-        const flags = option.flags;
-        for (const anc of this.getAncestorsIterator({
-            includeSelf: true
-        })){
-            for (const opt of anc.$.options){
-                if (flags === opt.flags) {
-                    return true;
-                }
-            }
-        }
-        return false;
-    }
-    assertNoDuplicateOptionNames() {
-        const throwErr = (cmd, opt, anc)=>{
-            this.throwCommanderError(`Duplicate option names > cmd: ${cmd.name}, ${anc ? `anc: ${anc.name}, ` : ''}opt: ${opt}`);
-        };
-        const set = new Set();
-        for (const opt of this.options){
-            if (opt.name() === 'help') continue;
-            if (opt.short) {
-                if (set.has(opt.short)) throwErr(this, opt.short);
-                set.add(opt.short);
-            }
-            if (opt.long) {
-                if (set.has(opt.long)) throwErr(this, opt.long);
-                set.add(opt.long);
-            }
-            if (opt.attributeName()) {
-                if (set.has(opt.attributeName())) throwErr(this, opt.attributeName());
-                set.add(opt.attributeName());
-            }
-        }
-        for (const anc of this.getAncestorsIterator()){
-            for (const opt of anc.$.options){
-                if (opt.short && set.has(opt.short)) {
-                    if (opt.short !== 'V') continue;
-                    throwErr(this, opt.short, anc);
-                }
-                if (opt.long && set.has(opt.long)) {
-                    throwErr(this, opt.long, anc);
-                }
-                if (opt.attributeName() && set.has(opt.attributeName())) {
-                    throwErr(this, opt.attributeName(), anc);
-                }
-            }
-        }
-    }
-    initializeActionWrapper() {
-        this.$.action(()=>{
-            const isAsync = isAsyncFunction(this.meta.actionHandler) || /^\(.+\) ?=> ?tslib_1\.__awaiter\(/.test(this.meta.actionHandler.toString().trim());
-            if (isAsync) {
-                try {
-                    this.handleOutputOptions();
-                    const [args, opts] = this.getParsedValidArgsOptsWithPresets();
-                    if (opts['help']) return Promise.resolve(this.outputHelp());
-                    return Promise.resolve(this.meta.actionHandler.call(this, ...args, opts, this));
-                } catch (error) {
-                    this.meta.errorHandler.call(this, error, this);
-                    return Promise.reject(error);
-                }
-            } else {
-                try {
-                    this.handleOutputOptions();
-                    const [args, opts] = this.getParsedValidArgsOptsWithPresets();
-                    if (opts['help']) return this.outputHelp();
-                    this.meta.actionHandler.call(this, ...args, opts, this);
-                } catch (error) {
-                    this.meta.errorHandler.call(this, error, this);
-                }
-            }
-        });
-    }
-    initializeHelp() {
-        if (this.isRoot) this.globalOption('-h, --help', 'show help');
-        this.$.addHelpCommand('?', 'show help');
-        this.$.configureHelp(DefaultHelpConfig);
-    }
-    inheritParentHiddenGlobals() {
-        if (!this.parent) return;
-        for (const opt of this.parent.meta.hiddenGlobalOptions){
-            this.meta.hiddenGlobalOptions.add(opt);
-        }
-    }
-    assertCommandNameNotReserved(name) {
-        if (this.isRoot) return;
-        if (this.meta.isNative) return;
-        if (name === 'u' || name === 'util') {
-            this.throwCommanderError(`Name '${name}' is reserved and is not available as name or alias.`);
-        }
-    }
-    assertNotInitialized() {
-        if (this.meta.isInitialized) this.throwCommanderError('Command already initialized: ' + this.name);
-    }
-}
-process.argv = splitCombinedArgvShorts(process.argv.slice());
-
-function CLI(name, callback) {
-    return ()=>new CommandBuilder(name, callback).commander;
-}
-
-/**
- * Reads a file and returns the file's contents.
- *
- * Identical to fs.readFileSync, except that:
- * - it uses utf8 encoding by default
- * - if operation fails, returns undefined instead of throwing
- *
- * @param filepath - The path to the file.
- * @param encoding - The encoding to use when reading the file.
- * @returns The file's contents or undefined if the file does not exist.
- */ function readFileSafeSync(filepath, encoding = 'utf8') {
-    try {
-        return fs.readFileSync(filepath, encoding);
-    } catch (error) {
-        return undefined;
-    }
-}
-
-function execInherit(command) {
-    return new Promise((resolve, reject)=>{
-        try {
-            const buffer = execSync(command, {
-                stdio: 'inherit'
-            });
-            const string = buffer && buffer.toString ? buffer.toString().trim() : '';
-            resolve(string);
-        } catch (error) {
-            const oError = error instanceof Error ? error : new Error(String(error));
-            reject(oError);
-        }
-    });
-}
-
-/**
- * Checks if the given string is in lower case.
- * @param input The string to be checked.
- * @example ```ts
- * strIsLowerCase('hello');
- * //=> true
- * strIsLowerCase('Hello');
- * //=> false
- * ```
- */ function strIsLowerCase(input) {
-    return input === input.toLowerCase();
-}
-
-/**
- * Checks if the given string is in upper case.
- * @param input The string to be checked.
- * @example ```ts
- * strIsUpperCase('HELLO');;
- * //=> true
- * strIsUpperCase('HEllo');;
- * //=> false
- * ```
- */ function strIsUpperCase(input) {
-    return input === input.toUpperCase();
-}
-
-/**
- * Returns an array of words in the string
- * @param word The camel case word to split.
- * @throws Throws an error if the input is not a string.
- * @param input input string
- * @example ```ts
- * strSplitCamelCase('someCamel10Case')
- * //=> ['some', 'Camel10', 'Case']
- * ```
- */ function strSplitCamelCase(word) {
-    if (!word) return [];
-    if (word.length <= 2) return [
-        word
-    ];
-    const result = [];
-    const lastCharIndex = word.length - 1;
-    let lastSplitIndex = 0;
-    let foundCamelCase = false;
-    for(let i = 1; i < word.length; i++){
-        if (isWordSplitIndex(word, i)) {
-            const sub = word.substring(lastSplitIndex, i);
-            if (sub) {
-                result.push(sub);
-                lastSplitIndex = i;
-                foundCamelCase = true;
-            }
-        }
-        if (foundCamelCase && i === lastCharIndex) {
-            const sub = word.substring(lastSplitIndex);
-            if (sub) result.push(sub);
-        }
-    }
-    if (!foundCamelCase) result.push(word);
-    return result;
-}
-const regInteger = /\d+/g;
-const regSpecial = /[^\w]+/g;
-function isWordSplitIndex(word, index) {
-    return strIsLowerCase(word[index - 1]) && strIsUpperCase(word[index]) && !regInteger.test(word[index - 1]) && !regInteger.test(word[index]) && !regSpecial.test(word[index - 1]) && !regSpecial.test(word[index]);
-}
-
-/**
- * Creates a parser function that parses a string into a boolean.
- *
- * @param trueValues - An array of strings that are considered true. Defaults to ['TRUE', 'T', 'YES', 'Y', '1'].
- * @param falseValues - An array of strings that are considered false. Defaults to ['', 'FALSE', 'F', 'NO', 'N', '0'].
- */ function createBooleanParser(trueValues = [
-    'TRUE',
-    'T',
-    'YES',
-    'Y',
-    '1'
-], falseValues = [
-    '',
-    'FALSE',
-    'F',
-    'NO',
-    'N',
-    '0'
-]) {
-    return function parseBoolean(string) {
-        string = string.toUpperCase();
-        if (falseValues.includes(string)) return false;
-        if (trueValues.includes(string)) return true;
-        throw new TypeError(`The value ${string} is not a valid boolean value. Accepted values are: ${[
-            ...trueValues,
-            ...falseValues
-        ].join(', ')}`);
-    };
-}
-
-/**
- * Parses a string into a boolean.
- *
- * Accepted values (case insensitive):
- * - true: 'TRUE', 'T', 'YES', 'Y', '1'
- * - false: 'FALSE', 'F', 'NO', 'N', '0'
- *
- * @throws Will throw an error if the input string is not a valid input.
- */ const parseBoolean = createBooleanParser([
-    'TRUE',
-    'T',
-    'YES',
-    'Y',
-    '1'
-], [
-    'FALSE',
-    'F',
-    'NO',
-    'N',
-    '0'
-]);
-
-function isBoolean(value) {
-    return typeof value === 'boolean';
-}
-
-export { AbstractJsonFileSection, AppDataSection, ArgumentBuilder, ArgumentParserSelector, ArgumentReader, ArgumentValidatorSelector, CLI, CommandBuilder, CommandBuilderMetaData, CommandFeatureSelector, ConfigSection, DefaultHelpConfig, ErrorParser, JsonDB, JsonFile, MethodDisabler, OptionArgumentParserSelector, OptionArgumentValidatorSelector, OptionBuilder, OptionHelpers, OptionReader, OutputManager, ParserSelector, PresetsSection, ValidatorSelector, arrAssign, arrLast, arrSome, commanderBackRefs, createArrayMerger, createBooleanParser, createObjectMerger, createTypedArrayValidator, createTypedListParser, defaultOpenInEditorCommand, ensureThat, errParseStack, errPrettyStack, errToObject, execInherit, formatTableForTerminal, funSetName, getTempDataPath, isArray, isBoolean, isFunction, isInteger, isNamedFunction, isNamedFunctionArray, isOSX, isObject, isPlainObject, isPrimitive, isString, isStringArray, isStringWithNoSpacesOrDashes, isValidNumber, isVsCodeInstalled, isWindows, objAssign, objUpdatePropertyDescriptors, parseBoolean, parseInteger, parseNumber, parseString, promptUserEditInTextEditorSync, promptUserEditJsonInTextEditorSync, readFileSafeSync, readFileSync, readJsonFileSafeSync, realizeLazyProperty, regexEscapeString, setNonEnumerable, splitCombinedArgvShorts, strEnsureStartsWith, strFirstCharToUpperCase, strIsLowerCase, strIsUpperCase, strSplitCamelCase, tempFileSync };