burgee 0.0.0 → 0.3.0

package/dist/yargs-factory.js

@@ -0,0 +1,1606 @@
+var _a;
+import { ExitCode } from './exit-code.js';
+import { Manifest } from './manifest.js';
+import { serveMcp } from './mcp.js';
+import { schemaOf } from './schema.js';
+import { projectManifest, render } from './yargs-burgee.js';
+import { command as Command, isCommandBuilderCallback } from './yargs-command.js';
+import { completion as Completion } from './yargs-completion.js';
+import { applyMiddleware, GlobalMiddleware } from './yargs-middleware.js';
+import { tokenizeArgString } from './yargs-parser.js';
+import { usage as Usage } from './yargs-usage.js';
+import { applyExtends, argsert, isPromise, maybeAsyncResult, objectKeys, objFilter, setBlocking, YError } from './yargs-utils.js';
+import { validation as Validation } from './yargs-validation.js';
+const DEFAULT_LOCALE = 'en_US';
+export function YargsFactory(shim) {
+    return (processArgs = [], cwd = shim.process.cwd(), parentRequire) => {
+        const yargs = new YargsInstance(processArgs, cwd, parentRequire, shim);
+        Object.defineProperty(yargs, 'argv', {
+            get: () => yargs.parse(),
+            enumerable: true,
+        });
+        yargs.help();
+        yargs.version();
+        return yargs;
+    };
+}
+export class YargsInstance {
+    $0;
+    argv;
+    customScriptName = false;
+    parsed = false;
+    #command;
+    #cwd;
+    #context = { commands: [], fullCommands: [] };
+    #completion = null;
+    #completionCommand = null;
+    #defaultShowHiddenOpt = 'show-hidden';
+    #exitError = null;
+    #detectLocale = true;
+    #emittedWarnings = {};
+    #exitProcess = true;
+    #frozens = [];
+    #globalMiddleware;
+    #groups = {};
+    #hasOutput = false;
+    #helpOpt = null;
+    #isGlobalContext = true;
+    #logger;
+    #output = '';
+    #options;
+    #parentRequire;
+    #parserConfig = {};
+    #parseFn = null;
+    #parseContext = null;
+    #pkgs = {};
+    #preservedGroups = {};
+    #processArgs;
+    #recommendCommands = false;
+    #shim;
+    #strict = false;
+    #strictCommands = false;
+    #strictOptions = false;
+    #usage;
+    #usageConfig = {};
+    #versionOpt = null;
+    #validation;
+    #burgee = undefined;
+    #effects = undefined;
+    #manifest = undefined;
+    constructor(processArgs = [], cwd, parentRequire, shim) {
+        this.#shim = shim;
+        this.#processArgs = processArgs;
+        this.#cwd = cwd;
+        this.#parentRequire = parentRequire;
+        this.#globalMiddleware = new GlobalMiddleware(this);
+        this.$0 = this.#getDollarZero();
+        this.#options = undefined;
+        this.#usage = undefined;
+        this.#validation = undefined;
+        this.#command = undefined;
+        this.#reset();
+        this.#options.showHiddenOpt = this.#defaultShowHiddenOpt;
+        this.#logger = this.#createLogger();
+        this.#shim.y18n.setLocale(DEFAULT_LOCALE);
+    }
+    addHelpOpt(opt, msg) {
+        const defaultHelpOpt = 'help';
+        argsert('[string|boolean] [string]', [opt, msg], arguments.length);
+        if (this.#helpOpt) {
+            this.#deleteFromParserHintObject(this.#helpOpt);
+            this.#helpOpt = null;
+        }
+        if (opt === false && msg === undefined)
+            return this;
+        this.#helpOpt = typeof opt === 'string' ? opt : defaultHelpOpt;
+        this.boolean(this.#helpOpt);
+        this.describe(this.#helpOpt, msg || this.#usage.deferY18nLookup('Show help'));
+        return this;
+    }
+    help(opt, msg) {
+        return this.addHelpOpt(opt, msg);
+    }
+    addShowHiddenOpt(opt, msg) {
+        argsert('[string|boolean] [string]', [opt, msg], arguments.length);
+        if (opt === false && msg === undefined)
+            return this;
+        const showHiddenOpt = typeof opt === 'string' ? opt : this.#defaultShowHiddenOpt;
+        this.boolean(showHiddenOpt);
+        this.describe(showHiddenOpt, msg || this.#usage.deferY18nLookup('Show hidden options'));
+        this.#options.showHiddenOpt = showHiddenOpt;
+        return this;
+    }
+    showHidden(opt, msg) {
+        return this.addShowHiddenOpt(opt, msg);
+    }
+    alias(key, value) {
+        argsert('<object|string|array> [string|array]', [key, value], arguments.length);
+        this.#populateParserHintArrayDictionary(this.alias.bind(this), 'alias', key, value);
+        return this;
+    }
+    array(keys) {
+        argsert('<array|string>', [keys], arguments.length);
+        this.#populateParserHintArray('array', keys);
+        this.#trackManuallySetKeys(keys);
+        return this;
+    }
+    boolean(keys) {
+        argsert('<array|string>', [keys], arguments.length);
+        this.#populateParserHintArray('boolean', keys);
+        this.#trackManuallySetKeys(keys);
+        return this;
+    }
+    check(f, global) {
+        argsert('<function> [boolean]', [f, global], arguments.length);
+        this.middleware((argv, _yargs) => maybeAsyncResult(() => f(argv, _yargs.getOptions()), (result) => {
+            if (!result)
+                this.#usage.fail(this.#shim.y18n.__('Argument check failed: %s', f.toString()));
+            else if (typeof result === 'string' || result instanceof Error)
+                this.#usage.fail(result.toString(), result);
+            return argv;
+        }, (err) => {
+            this.#usage.fail(err.message ? err.message : err.toString(), err);
+            return argv;
+        }), false, global);
+        return this;
+    }
+    choices(key, value) {
+        argsert('<object|string|array> [string|array]', [key, value], arguments.length);
+        this.#populateParserHintArrayDictionary(this.choices.bind(this), 'choices', key, value);
+        return this;
+    }
+    coerce(keys, value) {
+        argsert('<object|string|array> [function]', [keys, value], arguments.length);
+        if (Array.isArray(keys)) {
+            if (!value)
+                throw new YError('coerce callback must be provided');
+            for (const key of keys)
+                this.coerce(key, value);
+            return this;
+        }
+        else if (typeof keys === 'object') {
+            for (const key of Object.keys(keys))
+                this.coerce(key, keys[key]);
+            return this;
+        }
+        if (!value)
+            throw new YError('coerce callback must be provided');
+        const coerceKey = keys;
+        this.#options.key[coerceKey] = true;
+        this.#globalMiddleware.addCoerceMiddleware((argv, yargs) => {
+            const coerceKeyAliases = yargs.getAliases()[coerceKey] ?? [];
+            const argvKeys = [coerceKey, ...coerceKeyAliases].filter((key) => Object.prototype.hasOwnProperty.call(argv, key));
+            if (argvKeys.length === 0)
+                return argv;
+            return maybeAsyncResult(() => value(argv[argvKeys[0]]), (result) => {
+                argvKeys.forEach((key) => {
+                    argv[key] = result;
+                });
+                return argv;
+            }, (err) => {
+                throw new YError(err.message);
+            });
+        }, coerceKey);
+        return this;
+    }
+    conflicts(key1, key2) {
+        argsert('<string|object> [string|array]', [key1, key2], arguments.length);
+        this.#validation.conflicts(key1, key2);
+        return this;
+    }
+    config(key = 'config', msg, parseFn) {
+        argsert('[object|string] [string|function] [function]', [key, msg, parseFn], arguments.length);
+        if (typeof key === 'object' && !Array.isArray(key)) {
+            key = applyExtends(key, this.#cwd, this.#getParserConfiguration()['deep-merge-config'] || false);
+            this.#options.configObjects = (this.#options.configObjects || []).concat(key);
+            return this;
+        }
+        if (typeof msg === 'function') {
+            parseFn = msg;
+            msg = undefined;
+        }
+        this.describe(key, msg || this.#usage.deferY18nLookup('Path to JSON config file'));
+        (Array.isArray(key) ? key : [key]).forEach((k) => {
+            this.#options.config[k] = parseFn || true;
+        });
+        return this;
+    }
+    completion(cmd, desc, fn) {
+        argsert('[string] [string|boolean|function] [function]', [cmd, desc, fn], arguments.length);
+        if (typeof desc === 'function') {
+            fn = desc;
+            desc = undefined;
+        }
+        this.#completionCommand = cmd || this.#completionCommand || 'completion';
+        if (!desc && desc !== false)
+            desc = 'generate completion script';
+        this.command(this.#completionCommand, desc);
+        if (fn)
+            this.#completion.registerFunction(fn);
+        return this;
+    }
+    command(cmd, description, builder, handler, middlewares, deprecated) {
+        argsert('<string|array|object> [string|boolean] [function|object] [function] [array] [boolean|string]', [cmd, description, builder, handler, middlewares, deprecated], arguments.length);
+        this.#command.addHandler(cmd, description, builder, handler, middlewares, deprecated);
+        return this;
+    }
+    commands(cmd, description, builder, handler, middlewares, deprecated) {
+        return this.command(cmd, description, builder, handler, middlewares, deprecated);
+    }
+    commandDir(dir, opts) {
+        argsert('<string> [object]', [dir, opts], arguments.length);
+        const req = this.#parentRequire || this.#shim.require;
+        this.#command.addDirectory(dir, req, this.#shim.getCallerFile(), opts);
+        return this;
+    }
+    count(keys) {
+        argsert('<array|string>', [keys], arguments.length);
+        this.#populateParserHintArray('count', keys);
+        this.#trackManuallySetKeys(keys);
+        return this;
+    }
+    default(key, value, defaultDescription) {
+        argsert('<object|string|array> [*] [string]', [key, value, defaultDescription], arguments.length);
+        if (defaultDescription) {
+            this.#shim.assert.strictEqual(typeof key, 'string');
+            this.#options.defaultDescription[key] = defaultDescription;
+        }
+        if (typeof value === 'function') {
+            this.#shim.assert.strictEqual(typeof key, 'string');
+            if (!this.#options.defaultDescription[key])
+                this.#options.defaultDescription[key] = this.#usage.functionDescription(value);
+            value = value.call();
+        }
+        this.#populateParserHintSingleValueDictionary(this.default.bind(this), 'default', key, value);
+        return this;
+    }
+    defaults(key, value, defaultDescription) {
+        return this.default(key, value, defaultDescription);
+    }
+    demandCommand(min = 1, max, minMsg, maxMsg) {
+        argsert('[number] [number|string] [string|null|undefined] [string|null|undefined]', [min, max, minMsg, maxMsg], arguments.length);
+        if (typeof max !== 'number') {
+            minMsg = max;
+            max = Infinity;
+        }
+        this.global('_', false);
+        this.#options.demandedCommands._ = { min, max, minMsg, maxMsg };
+        return this;
+    }
+    demand(keys, max, msg) {
+        if (Array.isArray(max)) {
+            max.forEach((key) => {
+                this.#shim.assert.notStrictEqual(msg, true);
+                this.demandOption(key, msg);
+            });
+            max = Infinity;
+        }
+        else if (typeof max !== 'number') {
+            msg = max;
+            max = Infinity;
+        }
+        if (typeof keys === 'number') {
+            this.#shim.assert.notStrictEqual(msg, true);
+            this.demandCommand(keys, max, msg, msg);
+        }
+        else if (Array.isArray(keys)) {
+            keys.forEach((key) => {
+                this.#shim.assert.notStrictEqual(msg, true);
+                this.demandOption(key, msg);
+            });
+        }
+        else if (typeof msg === 'string')
+            this.demandOption(keys, msg);
+        else if (msg === true || typeof msg === 'undefined')
+            this.demandOption(keys);
+        return this;
+    }
+    demandOption(keys, msg) {
+        argsert('<object|string|array> [string]', [keys, msg], arguments.length);
+        this.#populateParserHintSingleValueDictionary(this.demandOption.bind(this), 'demandedOptions', keys, msg);
+        return this;
+    }
+    deprecateOption(option, message) {
+        argsert('<string> [string|boolean]', [option, message], arguments.length);
+        this.#options.deprecatedOptions[option] = message;
+        return this;
+    }
+    describe(keys, description) {
+        argsert('<object|string|array> [string]', [keys, description], arguments.length);
+        this.#setKey(keys, true);
+        this.#usage.describe(keys, description);
+        return this;
+    }
+    detectLocale(detect) {
+        argsert('<boolean>', [detect], arguments.length);
+        this.#detectLocale = detect;
+        return this;
+    }
+    env(prefix) {
+        argsert('[string|boolean]', [prefix], arguments.length);
+        if (prefix === false)
+            delete this.#options.envPrefix;
+        else
+            this.#options.envPrefix = prefix || '';
+        return this;
+    }
+    epilogue(msg) {
+        argsert('<string>', [msg], arguments.length);
+        this.#usage.epilog(msg);
+        return this;
+    }
+    epilog(msg) {
+        return this.epilogue(msg);
+    }
+    example(cmd, description) {
+        argsert('<string|array> [string]', [cmd, description], arguments.length);
+        if (Array.isArray(cmd))
+            cmd.forEach((exampleParams) => this.example(...exampleParams));
+        else
+            this.#usage.example(cmd, description);
+        return this;
+    }
+    exit(code, err) {
+        this.#hasOutput = true;
+        this.#exitError = err;
+        const burgee = this.#burgee;
+        if (burgee !== undefined && code !== 0 && burgee.json)
+            this.#failureEnvelope(err);
+        if (burgee?.exit !== undefined) {
+            if (burgee.exited)
+                return;
+            burgee.exited = true;
+            burgee.exit(code === 0 ? ExitCode.OK : err instanceof YError || err === undefined || typeof err === 'string' ? ExitCode.USAGE : ExitCode.RUNTIME);
+            return;
+        }
+        if (this.#exitProcess)
+            this.#shim.process.exit(code);
+    }
+    exitProcess(enabled = true) {
+        argsert('[boolean]', [enabled], arguments.length);
+        this.#exitProcess = enabled;
+        return this;
+    }
+    fail(f) {
+        argsert('<function|boolean>', [f], arguments.length);
+        if (typeof f === 'boolean' && f !== false)
+            throw new YError("Invalid first argument. Expected function or boolean 'false'");
+        this.#usage.failFn(f);
+        return this;
+    }
+    getAliases() {
+        return this.parsed ? this.parsed.aliases : {};
+    }
+    async getCompletion(args, done) {
+        argsert('<array> [function]', [args, done], arguments.length);
+        if (!done) {
+            return new Promise((resolve, reject) => {
+                this.#completion.getCompletion(args, (err, completions) => {
+                    if (err)
+                        reject(err);
+                    else
+                        resolve(completions);
+                });
+            });
+        }
+        return this.#completion.getCompletion(args, done);
+    }
+    getDemandedOptions() {
+        argsert([], 0);
+        return this.#options.demandedOptions;
+    }
+    getDemandedCommands() {
+        argsert([], 0);
+        return this.#options.demandedCommands;
+    }
+    getDeprecatedOptions() {
+        argsert([], 0);
+        return this.#options.deprecatedOptions;
+    }
+    getDetectLocale() {
+        return this.#detectLocale;
+    }
+    getExitProcess() {
+        return this.#exitProcess;
+    }
+    getGroups() {
+        return Object.assign({}, this.#groups, this.#preservedGroups);
+    }
+    getHelp() {
+        this.#hasOutput = true;
+        if (!this.#usage.hasCachedHelpMessage()) {
+            if (!this.parsed) {
+                const parse = this.#runYargsParserAndExecuteCommands(this.#processArgs, undefined, undefined, 0, true);
+                if (isPromise(parse))
+                    return parse.then(() => this.#usage.help());
+            }
+            const builderResponse = this.#command.runDefaultBuilderOn(this);
+            if (isPromise(builderResponse))
+                return builderResponse.then(() => this.#usage.help());
+        }
+        return Promise.resolve(this.#usage.help());
+    }
+    getOptions() {
+        return this.#options;
+    }
+    getStrict() {
+        return this.#strict;
+    }
+    getStrictCommands() {
+        return this.#strictCommands;
+    }
+    getStrictOptions() {
+        return this.#strictOptions;
+    }
+    global(globals, global) {
+        argsert('<string|array> [boolean]', [globals, global], arguments.length);
+        globals = [].concat(globals);
+        if (global !== false)
+            this.#options.local = this.#options.local.filter((l) => globals.indexOf(l) === -1);
+        else {
+            globals.forEach((g) => {
+                if (!this.#options.local.includes(g))
+                    this.#options.local.push(g);
+            });
+        }
+        return this;
+    }
+    group(opts, groupName) {
+        argsert('<string|array> <string>', [opts, groupName], arguments.length);
+        const existing = this.#preservedGroups[groupName] || this.#groups[groupName];
+        if (this.#preservedGroups[groupName])
+            delete this.#preservedGroups[groupName];
+        const seen = {};
+        this.#groups[groupName] = (existing || []).concat(opts).filter((key) => {
+            if (seen[key])
+                return false;
+            return (seen[key] = true);
+        });
+        return this;
+    }
+    hide(key) {
+        argsert('<string>', [key], arguments.length);
+        this.#options.hiddenOptions.push(key);
+        return this;
+    }
+    implies(key, value) {
+        argsert('<string|object> [number|string|array]', [key, value], arguments.length);
+        this.#validation.implies(key, value);
+        return this;
+    }
+    locale(locale) {
+        argsert('[string]', [locale], arguments.length);
+        if (locale === undefined) {
+            this.#guessLocale();
+            return this.#shim.y18n.getLocale();
+        }
+        this.#detectLocale = false;
+        this.#shim.y18n.setLocale(locale);
+        return this;
+    }
+    middleware(callback, applyBeforeValidation, global) {
+        return this.#globalMiddleware.addMiddleware(callback, !!applyBeforeValidation, global);
+    }
+    nargs(key, value) {
+        argsert('<string|object|array> [number]', [key, value], arguments.length);
+        this.#populateParserHintSingleValueDictionary(this.nargs.bind(this), 'narg', key, value);
+        return this;
+    }
+    normalize(keys) {
+        argsert('<array|string>', [keys], arguments.length);
+        this.#populateParserHintArray('normalize', keys);
+        return this;
+    }
+    number(keys) {
+        argsert('<array|string>', [keys], arguments.length);
+        this.#populateParserHintArray('number', keys);
+        this.#trackManuallySetKeys(keys);
+        return this;
+    }
+    option(key, opt) {
+        argsert('<string|object> [object]', [key, opt], arguments.length);
+        if (typeof key === 'object') {
+            Object.keys(key).forEach((k) => {
+                this.options(k, key[k]);
+            });
+        }
+        else {
+            if (typeof opt !== 'object')
+                opt = {};
+            this.#trackManuallySetKeys(key);
+            if (this.#versionOpt && (key === 'version' || opt?.alias === 'version')) {
+                this.#emitWarning([
+                    '"version" is a reserved word.',
+                    'Please do one of the following:',
+                    '- Disable version with `yargs.version(false)` if using "version" as an option',
+                    '- Use the built-in `yargs.version` method instead (if applicable)',
+                    '- Use a different option key',
+                    'https://yargs.js.org/docs/#api-reference-version',
+                ].join('\n'), undefined, 'versionWarning');
+            }
+            this.#options.key[key] = true;
+            if (opt.alias)
+                this.alias(key, opt.alias);
+            const deprecate = opt.deprecate || opt.deprecated;
+            if (deprecate)
+                this.deprecateOption(key, deprecate);
+            const demand = opt.demand || opt.required || opt.require;
+            if (demand)
+                this.demand(key, demand);
+            if (opt.demandOption)
+                this.demandOption(key, typeof opt.demandOption === 'string' ? opt.demandOption : undefined);
+            if (opt.conflicts)
+                this.conflicts(key, opt.conflicts);
+            if ('default' in opt)
+                this.default(key, opt.default);
+            if (opt.implies !== undefined)
+                this.implies(key, opt.implies);
+            if (opt.nargs !== undefined)
+                this.nargs(key, opt.nargs);
+            if (opt.config)
+                this.config(key, opt.configParser);
+            if (opt.normalize)
+                this.normalize(key);
+            if (opt.choices)
+                this.choices(key, opt.choices);
+            if (opt.coerce)
+                this.coerce(key, opt.coerce);
+            if (opt.group)
+                this.group(key, opt.group);
+            if (opt.boolean || opt.type === 'boolean') {
+                this.boolean(key);
+                if (opt.alias)
+                    this.boolean(opt.alias);
+            }
+            if (opt.array || opt.type === 'array') {
+                this.array(key);
+                if (opt.alias)
+                    this.array(opt.alias);
+            }
+            if (opt.number || opt.type === 'number') {
+                this.number(key);
+                if (opt.alias)
+                    this.number(opt.alias);
+            }
+            if (opt.string || opt.type === 'string') {
+                this.string(key);
+                if (opt.alias)
+                    this.string(opt.alias);
+            }
+            if (opt.count || opt.type === 'count')
+                this.count(key);
+            if (typeof opt.global === 'boolean')
+                this.global(key, opt.global);
+            if (opt.defaultDescription)
+                this.#options.defaultDescription[key] = opt.defaultDescription;
+            if (opt.skipValidation)
+                this.skipValidation(key);
+            const desc = opt.describe || opt.description || opt.desc;
+            const descriptions = this.#usage.getDescriptions();
+            if (!Object.prototype.hasOwnProperty.call(descriptions, key) || typeof desc === 'string')
+                this.describe(key, desc);
+            if (opt.hidden)
+                this.hide(key);
+            if (opt.requiresArg)
+                this.requiresArg(key);
+        }
+        return this;
+    }
+    options(key, opt) {
+        return this.option(key, opt);
+    }
+    parse(args, shortCircuit, _parseFn) {
+        argsert('[string|array] [function|boolean|object] [function]', [args, shortCircuit, _parseFn], arguments.length);
+        if (shortCircuit === true)
+            return this.#parse(args, shortCircuit, _parseFn);
+        const before = this.#burgee === undefined ? undefined : { ...this.#burgee };
+        const restore = () => {
+            this.#burgee = before;
+        };
+        const seam = this.#burgee?.exit === undefined ? undefined : this.#burgee;
+        if (seam === undefined) {
+            try {
+                const result = this.#parse(args, shortCircuit, _parseFn);
+                if (isPromise(result))
+                    return result.finally(restore);
+                restore();
+                return result;
+            }
+            catch (err) {
+                restore();
+                throw err;
+            }
+        }
+        seam.exited = false;
+        const finish = (argv) => {
+            if (!this.#burgee?.exited)
+                seam.exit?.(ExitCode.OK);
+            restore();
+            return argv;
+        };
+        const fail = (err) => {
+            if (err instanceof YError) {
+                restore();
+                throw err;
+            }
+            const message = err instanceof Error ? err.message : String(err);
+            if (this.#burgee?.json)
+                this.#failureEnvelope(err instanceof Error ? err : message);
+            else
+                this.#logger.error(message);
+            if (!this.#burgee?.exited)
+                seam.exit?.(ExitCode.RUNTIME);
+            restore();
+            return undefined;
+        };
+        try {
+            const result = this.#parse(args, shortCircuit, _parseFn);
+            return isPromise(result) ? result.then(finish, fail) : finish(result);
+        }
+        catch (err) {
+            return fail(err);
+        }
+    }
+    #parse(args, shortCircuit, _parseFn) {
+        this.#freeze();
+        if (typeof args === 'undefined')
+            args = this.#processArgs;
+        if (typeof shortCircuit === 'object') {
+            this.#parseContext = shortCircuit;
+            shortCircuit = _parseFn;
+        }
+        if (typeof shortCircuit === 'function') {
+            this.#parseFn = shortCircuit;
+            shortCircuit = false;
+        }
+        if (!shortCircuit) {
+            args = this.#takeJson(args);
+            this.#processArgs = args;
+        }
+        if (this.#parseFn)
+            this.#exitProcess = false;
+        if (!shortCircuit) {
+            const served = this.#burgeeSurface(args);
+            if (served !== false) {
+                const settle = () => {
+                    const argv = this.#runYargsParserAndExecuteCommands(args, true);
+                    this.#unfreeze();
+                    return argv;
+                };
+                if (isPromise(served))
+                    return served.then(settle);
+                return settle();
+            }
+        }
+        const parsed = this.#runYargsParserAndExecuteCommands(args, !!shortCircuit);
+        const tmpParsed = this.parsed;
+        this.#completion.setParsed(this.parsed);
+        if (isPromise(parsed)) {
+            return parsed
+                .then((argv) => {
+                if (this.#parseFn)
+                    this.#parseFn.call(this, this.#exitError, argv, this.#output);
+                return argv;
+            })
+                .catch((err) => {
+                if (this.#parseFn)
+                    this.#parseFn(err, this.parsed.argv, this.#output);
+                throw err;
+            })
+                .finally(() => {
+                this.#unfreeze();
+                this.parsed = tmpParsed;
+            });
+        }
+        if (this.#parseFn)
+            this.#parseFn.call(this, this.#exitError, parsed, this.#output);
+        this.#unfreeze();
+        this.parsed = tmpParsed;
+        return parsed;
+    }
+    parseAsync(args, shortCircuit, _parseFn) {
+        const maybePromise = this.parse(args, shortCircuit, _parseFn);
+        return !isPromise(maybePromise) ? Promise.resolve(maybePromise) : maybePromise;
+    }
+    parseSync(args, shortCircuit, _parseFn) {
+        const maybePromise = this.parse(args, shortCircuit, _parseFn);
+        if (isPromise(maybePromise))
+            throw new YError('.parseSync() must not be used with asynchronous builders, handlers, or middleware');
+        return maybePromise;
+    }
+    parserConfiguration(config) {
+        argsert('<object>', [config], arguments.length);
+        this.#parserConfig = config;
+        return this;
+    }
+    pkgConf(key, rootPath) {
+        argsert('<string> [string]', [key, rootPath], arguments.length);
+        let conf = null;
+        const obj = this.#pkgUp(rootPath || this.#cwd);
+        if (obj[key] && typeof obj[key] === 'object') {
+            conf = applyExtends(obj[key], rootPath || this.#cwd, this.#getParserConfiguration()['deep-merge-config'] || false);
+            this.#options.configObjects = (this.#options.configObjects || []).concat(conf);
+        }
+        return this;
+    }
+    positional(key, opts) {
+        argsert('<string> <object>', [key, opts], arguments.length);
+        const supportedOpts = ['default', 'defaultDescription', 'implies', 'normalize', 'choices', 'conflicts', 'coerce', 'type', 'describe', 'desc', 'description', 'alias'];
+        opts = objFilter(opts, (k, v) => {
+            if (k === 'type' && !['string', 'number', 'boolean'].includes(v))
+                return false;
+            return supportedOpts.includes(k);
+        });
+        const fullCommand = this.#context.fullCommands[this.#context.fullCommands.length - 1];
+        const parseOptions = fullCommand ? this.#command.cmdToParseOptions(fullCommand) : { array: [], alias: {}, default: {}, demand: {} };
+        objectKeys(parseOptions).forEach((pk) => {
+            const parseOption = parseOptions[pk];
+            if (Array.isArray(parseOption)) {
+                if (parseOption.indexOf(key) !== -1)
+                    opts[pk] = true;
+            }
+            else if (parseOption[key] && !(pk in opts))
+                opts[pk] = parseOption[key];
+        });
+        this.group(key, this.#usage.getPositionalGroupName());
+        return this.option(key, opts);
+    }
+    recommendCommands(recommend = true) {
+        argsert('[boolean]', [recommend], arguments.length);
+        this.#recommendCommands = recommend;
+        return this;
+    }
+    required(keys, max, msg) {
+        return this.demand(keys, max, msg);
+    }
+    require(keys, max, msg) {
+        return this.demand(keys, max, msg);
+    }
+    requiresArg(keys) {
+        argsert('<array|string|object> [number]', [keys], arguments.length);
+        if (typeof keys === 'string' && this.#options.narg[keys])
+            return this;
+        this.#populateParserHintSingleValueDictionary(this.requiresArg.bind(this), 'narg', keys, NaN);
+        return this;
+    }
+    showCompletionScript($0, cmd) {
+        argsert('[string] [string]', [$0, cmd], arguments.length);
+        $0 = $0 || this.$0;
+        this.#logger.log(this.#completion.generateCompletionScript($0, cmd || this.#completionCommand || 'completion'));
+        return this;
+    }
+    showHelp(level) {
+        argsert('[string|function]', [level], arguments.length);
+        this.#hasOutput = true;
+        if (!this.#usage.hasCachedHelpMessage()) {
+            if (!this.parsed) {
+                const parse = this.#runYargsParserAndExecuteCommands(this.#processArgs, undefined, undefined, 0, true);
+                if (isPromise(parse)) {
+                    parse.then(() => {
+                        this.#usage.showHelp(level);
+                    });
+                    return this;
+                }
+            }
+            const builderResponse = this.#command.runDefaultBuilderOn(this);
+            if (isPromise(builderResponse)) {
+                builderResponse.then(() => {
+                    this.#usage.showHelp(level);
+                });
+                return this;
+            }
+        }
+        this.#usage.showHelp(level);
+        return this;
+    }
+    scriptName(scriptName) {
+        this.customScriptName = true;
+        this.$0 = scriptName;
+        return this;
+    }
+    showHelpOnFail(enabled, message) {
+        argsert('[boolean|string] [string]', [enabled, message], arguments.length);
+        this.#usage.showHelpOnFail(enabled, message);
+        return this;
+    }
+    showVersion(level) {
+        argsert('[string|function]', [level], arguments.length);
+        this.#usage.showVersion(level);
+        return this;
+    }
+    skipValidation(keys) {
+        argsert('<array|string>', [keys], arguments.length);
+        this.#populateParserHintArray('skipValidation', keys);
+        return this;
+    }
+    strict(enabled) {
+        argsert('[boolean]', [enabled], arguments.length);
+        this.#strict = enabled !== false;
+        return this;
+    }
+    strictCommands(enabled) {
+        argsert('[boolean]', [enabled], arguments.length);
+        this.#strictCommands = enabled !== false;
+        return this;
+    }
+    strictOptions(enabled) {
+        argsert('[boolean]', [enabled], arguments.length);
+        this.#strictOptions = enabled !== false;
+        return this;
+    }
+    string(keys) {
+        argsert('<array|string>', [keys], arguments.length);
+        this.#populateParserHintArray('string', keys);
+        this.#trackManuallySetKeys(keys);
+        return this;
+    }
+    terminalWidth() {
+        argsert([], 0);
+        return this.#shim.process.stdColumns;
+    }
+    updateLocale(obj) {
+        return this.updateStrings(obj);
+    }
+    updateStrings(obj) {
+        argsert('<object>', [obj], arguments.length);
+        this.#detectLocale = false;
+        this.#shim.y18n.updateLocale(obj);
+        return this;
+    }
+    usage(msg, description, builder, handler) {
+        argsert('<string|null|undefined> [string|boolean] [function|object] [function]', [msg, description, builder, handler], arguments.length);
+        if (description !== undefined) {
+            this.#shim.assert.notStrictEqual(msg, null);
+            if (/^\$0( |$)/.exec(msg || ''))
+                return this.command(msg, description, builder, handler);
+            throw new YError('.usage() description must start with $0 if being used as alias for .command()');
+        }
+        this.#usage.usage(msg);
+        return this;
+    }
+    usageConfiguration(config) {
+        argsert('<object>', [config], arguments.length);
+        this.#usageConfig = config;
+        return this;
+    }
+    version(opt, msg, ver) {
+        const defaultVersionOpt = 'version';
+        argsert('[boolean|string] [string] [string]', [opt, msg, ver], arguments.length);
+        if (this.#versionOpt) {
+            this.#deleteFromParserHintObject(this.#versionOpt);
+            this.#usage.version(undefined);
+            this.#versionOpt = null;
+        }
+        if (arguments.length === 0) {
+            ver = this.#guessVersion();
+            opt = defaultVersionOpt;
+        }
+        else if (arguments.length === 1) {
+            if (opt === false)
+                return this;
+            ver = opt;
+            opt = defaultVersionOpt;
+        }
+        else if (arguments.length === 2) {
+            ver = msg;
+            msg = undefined;
+        }
+        this.#versionOpt = typeof opt === 'string' ? opt : defaultVersionOpt;
+        msg = msg || this.#usage.deferY18nLookup('Show version number');
+        this.#usage.version(ver || undefined);
+        this.boolean(this.#versionOpt);
+        this.describe(this.#versionOpt, msg);
+        return this;
+    }
+    wrap(cols) {
+        argsert('<number|null|undefined>', [cols], arguments.length);
+        this.#usage.wrap(cols);
+        return this;
+    }
+    #copyDoubleDash(argv) {
+        if (!argv._ || !argv['--'])
+            return argv;
+        argv._.push.apply(argv._, argv['--']);
+        try {
+            delete argv['--'];
+        }
+        catch {
+        }
+        return argv;
+    }
+    #createLogger() {
+        return {
+            log: (...args) => {
+                const out = this.#burgee?.stdout;
+                if (out !== undefined)
+                    out.write(`${args.join(' ')}\n`);
+                else if (!this.#hasParseCallback())
+                    console.log(...args);
+                this.#hasOutput = true;
+                if (this.#output.length)
+                    this.#output += '\n';
+                this.#output += args.join(' ');
+            },
+            error: (...args) => {
+                const burgee = this.#burgee;
+                const line = args.join(' ');
+                if (burgee?.json) {
+                    if (line.trim() !== '')
+                        burgee.lastError = line;
+                }
+                else if (burgee?.stderr !== undefined)
+                    burgee.stderr.write(`${line}\n`);
+                else if (!this.#hasParseCallback())
+                    console.error(...args);
+                this.#hasOutput = true;
+                if (this.#output.length)
+                    this.#output += '\n';
+                this.#output += line;
+            },
+        };
+    }
+    #deleteFromParserHintObject(optionKey) {
+        objectKeys(this.#options).forEach((hintKey) => {
+            if (hintKey === 'configObjects')
+                return;
+            const hint = this.#options[hintKey];
+            if (Array.isArray(hint)) {
+                if (hint.includes(optionKey))
+                    hint.splice(hint.indexOf(optionKey), 1);
+            }
+            else if (typeof hint === 'object')
+                delete hint[optionKey];
+        });
+        delete this.#usage.getDescriptions()[optionKey];
+    }
+    #emitWarning(warning, type, deduplicationId) {
+        if (!this.#emittedWarnings[deduplicationId]) {
+            this.#shim.process.emitWarning(warning, type);
+            this.#emittedWarnings[deduplicationId] = true;
+        }
+    }
+    #freeze() {
+        this.#frozens.push({
+            options: this.#options,
+            configObjects: this.#options.configObjects.slice(0),
+            exitProcess: this.#exitProcess,
+            groups: this.#groups,
+            strict: this.#strict,
+            strictCommands: this.#strictCommands,
+            strictOptions: this.#strictOptions,
+            completionCommand: this.#completionCommand,
+            output: this.#output,
+            exitError: this.#exitError,
+            hasOutput: this.#hasOutput,
+            parsed: this.parsed,
+            parseFn: this.#parseFn,
+            parseContext: this.#parseContext,
+        });
+        this.#usage.freeze();
+        this.#validation.freeze();
+        this.#command.freeze();
+        this.#globalMiddleware.freeze();
+    }
+    #getDollarZero() {
+        let $0 = '';
+        let default$0;
+        if (/\b(node|iojs|electron|bun)(\.exe)?$/.test(this.#shim.process.argv()[0]))
+            default$0 = this.#shim.process.argv().slice(1, 2);
+        else
+            default$0 = this.#shim.process.argv().slice(0, 1);
+        $0 = default$0
+            .map((x) => {
+            const b = this.#rebase(this.#cwd, x);
+            return /^(\/|([a-zA-Z]:)?\\)/.exec(x) && b.length < x.length ? b : x;
+        })
+            .join(' ')
+            .trim();
+        if (this.#shim.getEnv('_') && this.#shim.getProcessArgvBin() === this.#shim.getEnv('_')) {
+            $0 = this.#shim.getEnv('_').replace(`${this.#shim.path.dirname(this.#shim.process.execPath())}/`, '');
+        }
+        return $0;
+    }
+    #getParserConfiguration() {
+        return this.#parserConfig;
+    }
+    #getUsageConfiguration() {
+        return this.#usageConfig;
+    }
+    #guessLocale() {
+        if (!this.#detectLocale)
+            return;
+        const locale = this.#shim.getEnv('LC_ALL') || this.#shim.getEnv('LC_MESSAGES') || this.#shim.getEnv('LANG') || this.#shim.getEnv('LANGUAGE') || 'en_US';
+        this.locale(locale.replace(/[.:].*/, ''));
+    }
+    #guessVersion() {
+        const obj = this.#pkgUp();
+        return obj.version || 'unknown';
+    }
+    #parsePositionalNumbers(argv) {
+        const args = argv['--'] ? argv['--'] : argv._;
+        for (let i = 0, arg; (arg = args[i]) !== undefined; i++) {
+            if (this.#shim.Parser.looksLikeNumber(arg) && Number.isSafeInteger(Math.floor(parseFloat(`${arg}`))))
+                args[i] = Number(arg);
+        }
+        return argv;
+    }
+    #pkgUp(rootPath) {
+        const npath = rootPath || '*';
+        if (this.#pkgs[npath])
+            return this.#pkgs[npath];
+        let obj = {};
+        try {
+            let startDir = rootPath || this.#shim.mainFilename;
+            if (this.#shim.path.extname(startDir))
+                startDir = this.#shim.path.dirname(startDir);
+            const pkgJsonPath = this.#shim.findUp(startDir, (_dir, names) => {
+                if (names.includes('package.json'))
+                    return 'package.json';
+                return undefined;
+            });
+            this.#shim.assert.notStrictEqual(pkgJsonPath, undefined);
+            obj = JSON.parse(this.#shim.readFileSync(pkgJsonPath, 'utf8'));
+        }
+        catch {
+        }
+        this.#pkgs[npath] = obj || {};
+        return this.#pkgs[npath];
+    }
+    #populateParserHintArray(type, keys) {
+        keys = [].concat(keys);
+        keys.forEach((key) => {
+            key = this.#sanitizeKey(key);
+            this.#options[type].push(key);
+        });
+    }
+    #populateParserHintSingleValueDictionary(builder, type, key, value) {
+        this.#populateParserHintDictionary(builder, type, key, value, (t, k, v) => {
+            this.#options[t][k] = v;
+        });
+    }
+    #populateParserHintArrayDictionary(builder, type, key, value) {
+        this.#populateParserHintDictionary(builder, type, key, value, (t, k, v) => {
+            this.#options[t][k] = (this.#options[t][k] || []).concat(v);
+        });
+    }
+    #populateParserHintDictionary(builder, type, key, value, singleKeyHandler) {
+        if (Array.isArray(key)) {
+            key.forEach((k) => {
+                builder(k, value);
+            });
+        }
+        else if (typeof key === 'object') {
+            for (const k of objectKeys(key))
+                builder(k, key[k]);
+        }
+        else
+            singleKeyHandler(type, this.#sanitizeKey(key), value);
+    }
+    #sanitizeKey(key) {
+        if (key === '__proto__')
+            return '___proto___';
+        return key;
+    }
+    #setKey(key, set) {
+        this.#populateParserHintSingleValueDictionary(this.#setKey.bind(this), 'key', key, set);
+        return this;
+    }
+    #unfreeze() {
+        const frozen = this.#frozens.pop();
+        this.#shim.assert.notStrictEqual(frozen, undefined);
+        const f = frozen;
+        this.#options = f.options;
+        this.#exitProcess = f.exitProcess;
+        this.#groups = f.groups;
+        this.#output = f.output;
+        this.#exitError = f.exitError;
+        this.#hasOutput = f.hasOutput;
+        this.parsed = f.parsed;
+        this.#strict = f.strict;
+        this.#strictCommands = f.strictCommands;
+        this.#strictOptions = f.strictOptions;
+        this.#completionCommand = f.completionCommand;
+        this.#parseFn = f.parseFn;
+        this.#parseContext = f.parseContext;
+        this.#options.configObjects = f.configObjects;
+        this.#usage.unfreeze();
+        this.#validation.unfreeze();
+        this.#command.unfreeze();
+        this.#globalMiddleware.unfreeze();
+    }
+    #validateAsync(validation, argv) {
+        return maybeAsyncResult(argv, (result) => {
+            validation(result);
+            return result;
+        });
+    }
+    getInternalMethods() {
+        return {
+            getCommandInstance: this.#getCommandInstance.bind(this),
+            getContext: this.#getContext.bind(this),
+            getHasOutput: this.#getHasOutput.bind(this),
+            getLoggerInstance: this.#getLoggerInstance.bind(this),
+            getParseContext: this.#getParseContext.bind(this),
+            getParserConfiguration: this.#getParserConfiguration.bind(this),
+            getUsageConfiguration: this.#getUsageConfiguration.bind(this),
+            getUsageInstance: this.#getUsageInstance.bind(this),
+            getValidationInstance: this.#getValidationInstance.bind(this),
+            hasParseCallback: this.#hasParseCallback.bind(this),
+            isGlobalContext: this.#isGlobalContextFn.bind(this),
+            postProcess: this.#postProcess.bind(this),
+            reset: this.#reset.bind(this),
+            runValidation: this.#runValidation.bind(this),
+            runYargsParserAndExecuteCommands: this.#runYargsParserAndExecuteCommands.bind(this),
+            setHasOutput: this.#setHasOutput.bind(this),
+            runHandler: this.#runHandler.bind(this),
+        };
+    }
+    get manifest() {
+        this.#manifest ??= new Manifest();
+        projectManifest(this.#manifest, this.#snapshot());
+        return this.#manifest;
+    }
+    effects(value) {
+        this.#effects = value;
+        return this;
+    }
+    use(plugin) {
+        this.manifest.use(plugin);
+        return this;
+    }
+    burgee(seam) {
+        this.#burgee = { ...(this.#burgee ?? { json: false, lastError: '' }), ...seam };
+        return this;
+    }
+    #snapshot() {
+        const o = this.#options;
+        const skip = [this.#helpOpt, this.#versionOpt, o.showHiddenOpt].filter((k) => typeof k === 'string');
+        const handlers = this.#command.getCommandHandlers();
+        const commands = [];
+        let positionals = { demanded: [], optional: [] };
+        let hasHandler = false;
+        let description;
+        const isDefault = (h) => /^\$0( |$)/.test(h.original);
+        for (const [name, handler] of Object.entries(handlers)) {
+            if (isDefault(handler))
+                continue;
+            const child = this.#childOf(handler);
+            commands.push({ name, description: handler.description, deprecated: handler.deprecated, child: child.#snapshotOf(handler, name) });
+        }
+        const root = Object.values(handlers).find(isDefault);
+        if (root !== undefined) {
+            hasHandler = true;
+            positionals = { demanded: root.demanded, optional: root.optional };
+            if (typeof root.description === 'string')
+                description = root.description;
+        }
+        const first = this.#usage.getUsage()[0];
+        if (description === undefined && first !== undefined && first[1] !== '')
+            description = first[1];
+        return {
+            name: this.customScriptName ? this.$0 : this.#shim.path.basename(this.$0) || 'program',
+            version: typeof this.#usage.getVersion() === 'string' ? this.#usage.getVersion() : undefined,
+            description,
+            effects: this.#effects,
+            hasHandler,
+            keys: Object.keys(o.key),
+            aliases: o.alias,
+            boolean: o.boolean,
+            number: o.number,
+            string: o.string,
+            count: o.count,
+            array: o.array,
+            hiddenOptions: o.hiddenOptions,
+            demanded: o.demandedOptions,
+            deprecated: o.deprecatedOptions,
+            choices: o.choices,
+            defaults: o.default,
+            descriptions: this.#usage.getDescriptions(),
+            skip,
+            positionals,
+            commands,
+        };
+    }
+    #snapshotOf(handler, name) {
+        const snap = this.#snapshot();
+        snap.name = name;
+        snap.hasHandler = true;
+        snap.positionals = { demanded: handler.demanded, optional: handler.optional };
+        snap.description = typeof handler.description === 'string' ? handler.description : undefined;
+        snap.version = undefined;
+        return snap;
+    }
+    #childOf(handler) {
+        const child = new _a([], this.#cwd, this.#parentRequire, this.#shim);
+        child.#context.fullCommands.push(handler.original);
+        const builder = handler.builder;
+        try {
+            if (isCommandBuilderCallback(builder)) {
+                const out = builder(child, true);
+                if (!isPromise(out) && out instanceof _a)
+                    return out;
+            }
+            else if (typeof builder === 'object' && builder !== null) {
+                for (const key of Object.keys(builder))
+                    child.option(key, builder[key]);
+            }
+        }
+        catch {
+        }
+        return child;
+    }
+    #takeJson(args) {
+        const list = typeof args === 'string' ? tokenizeArgString(args) : args;
+        const terminator = list.indexOf('--');
+        const index = list.indexOf('--json');
+        if (index === -1 || (terminator !== -1 && index > terminator))
+            return args;
+        if (this.#declares('json'))
+            return args;
+        this.#burgee = { ...(this.#burgee ?? { lastError: '' }), json: true };
+        return [...list.slice(0, index), ...list.slice(index + 1)];
+    }
+    #declares(key) {
+        if (this.#options.key[key] || Object.values(this.#options.alias).some((list) => list.includes(key)))
+            return true;
+        if (this.#command.getCommands().includes(key))
+            return true;
+        return this.manifest.commands.some((node) => Object.prototype.hasOwnProperty.call(node.options, key));
+    }
+    #burgeeSurface(args) {
+        const list = typeof args === 'string' ? tokenizeArgString(args) : args;
+        const terminator = list.indexOf('--');
+        const head = terminator === -1 ? list : list.slice(0, terminator);
+        if (head[0] === 'completion' && this.#completionCommand === null && !this.#declares('completion')) {
+            return import('./completions.js').then(({ renderCompletion, renderFigSpec, SHELLS }) => {
+                const shell = head[1] ?? '';
+                if (shell === 'fig') {
+                    this.#logger.log(JSON.stringify(renderFigSpec(this.manifest), null, 2));
+                    this.exit(0);
+                    return true;
+                }
+                const known = SHELLS.find((s) => s === shell);
+                if (known === undefined)
+                    return false;
+                this.#logger.log(renderCompletion(this.manifest, known).replace(/\n$/, ''));
+                this.exit(0);
+                return true;
+            });
+        }
+        if (head.includes('--schema') && !this.#declares('schema')) {
+            this.#logger.log(JSON.stringify(schemaOf(this.manifest), null, 2));
+            this.exit(0);
+            return true;
+        }
+        if (head[0] === '--mcp' && !this.#declares('mcp')) {
+            const invoke = async (argv) => {
+                const out = [];
+                const err = [];
+                let code = 0;
+                const before = this.#burgee;
+                this.#burgee = { json: false, lastError: '', stdout: { write: (s) => out.push(s) }, stderr: { write: (s) => err.push(s) }, exit: (c) => void (code = c) };
+                try {
+                    await this.parseAsync([...argv, '--json']);
+                }
+                finally {
+                    this.#burgee = before;
+                }
+                return { stdout: out.join(''), stderr: err.join(''), code };
+            };
+            const write = this.#burgee?.stdout ?? this.#shim.process.stdout();
+            return serveMcp(this.manifest, { input: this.#shim.process.stdin(), output: { write: (s) => void write.write(s) }, invoke }).then(() => {
+                this.exit(0);
+                return true;
+            });
+        }
+        return false;
+    }
+    #runHandler(handler, argv, original) {
+        const manifest = this.#manifest;
+        const settle = (value) => {
+            this.#settle(value, argv);
+            return value;
+        };
+        if (manifest === undefined || manifest.plugins.length === 0) {
+            const result = handler(argv);
+            return isPromise(result) ? result.then(settle) : settle(result);
+        }
+        const name = original.replace(/^\$0 ?/, '').split(' ')[0] ?? '';
+        const options = {};
+        for (const key of Object.keys(this.#options.key))
+            options[key] = argv[key];
+        return manifest
+            .fire('preRun', name, options)
+            .then(() => handler(argv))
+            .then(async (value) => {
+            await manifest.fire('postRun', name, options);
+            return settle(value);
+        });
+    }
+    #settle(value, argv) {
+        const burgee = this.#burgee;
+        if (burgee === undefined)
+            return;
+        if (burgee.json) {
+            this.#logger.log(JSON.stringify({ ok: true, data: value ?? null, meta: { provenance: this.#provenance(argv) } }));
+            return;
+        }
+        const text = render(value);
+        if (text !== '')
+            this.#logger.log(text.replace(/\n$/, ''));
+    }
+    #failureEnvelope(err) {
+        const burgee = this.#burgee;
+        const message = err instanceof Error ? err.message : typeof err === 'string' ? err : burgee.lastError;
+        const code = err instanceof YError || err === undefined || typeof err === 'string' ? 'usage' : 'runtime';
+        this.#logger.log(JSON.stringify({ ok: false, error: { code, message } }));
+    }
+    #provenance(argv) {
+        const out = {};
+        const defaulted = this.parsed?.defaulted ?? {};
+        const prefix = this.#options.envPrefix;
+        const positional = new Set(this.getGroups()[this.#usage.getPositionalGroupName()] ?? []);
+        for (const key of Object.keys(this.#options.key)) {
+            if (key === this.#helpOpt || key === this.#versionOpt || positional.has(key))
+                continue;
+            if (!Object.prototype.hasOwnProperty.call(argv, key) || argv[key] === undefined)
+                continue;
+            let source = 'flag';
+            if (defaulted[key])
+                source = 'default';
+            else if (this.#options.configObjects.some((c) => Object.prototype.hasOwnProperty.call(c, key)))
+                source = 'config';
+            else if (prefix !== undefined && this.#shim.getEnv(`${prefix}${prefix === '' ? '' : '_'}${key.replace(/[A-Z]/g, (c) => `_${c}`).toUpperCase()}`) !== undefined)
+                source = 'env';
+            out[key] = { source };
+        }
+        return out;
+    }
+    #getCommandInstance() {
+        return this.#command;
+    }
+    #getContext() {
+        return this.#context;
+    }
+    #getHasOutput() {
+        return this.#hasOutput;
+    }
+    #getLoggerInstance() {
+        return this.#logger;
+    }
+    #getParseContext() {
+        return this.#parseContext || {};
+    }
+    #getUsageInstance() {
+        return this.#usage;
+    }
+    #getValidationInstance() {
+        return this.#validation;
+    }
+    #hasParseCallback() {
+        return !!this.#parseFn;
+    }
+    #isGlobalContextFn() {
+        return this.#isGlobalContext;
+    }
+    #postProcess(argv, populateDoubleDash, calledFromCommand, runGlobalMiddleware) {
+        if (calledFromCommand)
+            return argv;
+        if (isPromise(argv))
+            return argv;
+        if (!populateDoubleDash)
+            argv = this.#copyDoubleDash(argv);
+        const parsePositionalNumbers = this.#getParserConfiguration()['parse-positional-numbers'] || this.#getParserConfiguration()['parse-positional-numbers'] === undefined;
+        if (parsePositionalNumbers)
+            argv = this.#parsePositionalNumbers(argv);
+        if (runGlobalMiddleware)
+            argv = applyMiddleware(argv, this, this.#globalMiddleware.getMiddleware(), false);
+        return argv;
+    }
+    #reset(aliases = {}) {
+        this.#options = this.#options || {};
+        const tmpOptions = {};
+        tmpOptions.local = this.#options.local || [];
+        tmpOptions.configObjects = this.#options.configObjects || [];
+        const localLookup = {};
+        tmpOptions.local.forEach((l) => {
+            localLookup[l] = true;
+            (aliases[l] || []).forEach((a) => {
+                localLookup[a] = true;
+            });
+        });
+        Object.assign(this.#preservedGroups, Object.keys(this.#groups).reduce((acc, groupName) => {
+            const keys = this.#groups[groupName].filter((key) => !(key in localLookup));
+            if (keys.length > 0)
+                acc[groupName] = keys;
+            return acc;
+        }, {}));
+        this.#groups = {};
+        const arrayOptions = ['array', 'boolean', 'string', 'skipValidation', 'count', 'normalize', 'number', 'hiddenOptions'];
+        const objectOptions = ['narg', 'key', 'alias', 'default', 'defaultDescription', 'config', 'choices', 'demandedOptions', 'demandedCommands', 'deprecatedOptions'];
+        arrayOptions.forEach((k) => {
+            tmpOptions[k] = (this.#options[k] || []).filter((key) => !localLookup[key]);
+        });
+        objectOptions.forEach((k) => {
+            tmpOptions[k] = objFilter(this.#options[k], (key) => !localLookup[key]);
+        });
+        tmpOptions.envPrefix = this.#options.envPrefix;
+        this.#options = tmpOptions;
+        this.#usage = this.#usage ? this.#usage.reset(localLookup) : Usage(this, this.#shim);
+        this.#validation = this.#validation ? this.#validation.reset(localLookup) : Validation(this, this.#usage, this.#shim);
+        this.#command = this.#command ? this.#command.reset() : Command(this.#usage, this.#validation, this.#globalMiddleware, this.#shim);
+        if (!this.#completion)
+            this.#completion = Completion(this, this.#usage, this.#command, this.#shim);
+        this.#globalMiddleware.reset();
+        this.#completionCommand = null;
+        this.#output = '';
+        this.#exitError = null;
+        this.#hasOutput = false;
+        this.parsed = false;
+        return this;
+    }
+    #rebase(base, dir) {
+        return this.#shim.path.relative(base, dir);
+    }
+    #runYargsParserAndExecuteCommands(args, shortCircuit, calledFromCommand, commandIndex = 0, helpOnly = false) {
+        let skipValidation = !!calledFromCommand || helpOnly;
+        args = args || this.#processArgs;
+        this.#options.__ = this.#shim.y18n.__;
+        this.#options.configuration = this.#getParserConfiguration();
+        const populateDoubleDash = !!this.#options.configuration['populate--'];
+        const config = Object.assign({}, this.#options.configuration, { 'populate--': true });
+        const parsed = this.#shim.Parser.detailed(args, Object.assign({}, this.#options, { configuration: { 'parse-positional-numbers': false, ...config } }));
+        const argv = Object.assign(parsed.argv, this.#parseContext);
+        let argvPromise = undefined;
+        const aliases = parsed.aliases;
+        let helpOptSet = false;
+        let versionOptSet = false;
+        Object.keys(argv).forEach((key) => {
+            if (key === this.#helpOpt && argv[key])
+                helpOptSet = true;
+            else if (key === this.#versionOpt && argv[key])
+                versionOptSet = true;
+        });
+        argv.$0 = this.$0;
+        this.parsed = parsed;
+        if (commandIndex === 0)
+            this.#usage.clearCachedHelpMessage();
+        try {
+            this.#guessLocale();
+            if (shortCircuit)
+                return this.#postProcess(argv, populateDoubleDash, !!calledFromCommand, false);
+            if (this.#helpOpt) {
+                const helpCmds = [this.#helpOpt].concat(aliases[this.#helpOpt] || []).filter((k) => k.length > 1);
+                if (helpCmds.includes(`${argv._[argv._.length - 1]}`)) {
+                    argv._.pop();
+                    helpOptSet = true;
+                }
+            }
+            this.#isGlobalContext = false;
+            const handlerKeys = this.#command.getCommands();
+            const requestCompletions = this.#completion?.completionKey
+                ? [this.#completion?.completionKey, ...(this.getAliases()[this.#completion?.completionKey] ?? [])].some((key) => Object.prototype.hasOwnProperty.call(argv, key))
+                : false;
+            const skipRecommendation = helpOptSet || requestCompletions || helpOnly;
+            if (argv._.length) {
+                if (handlerKeys.length) {
+                    let firstUnknownCommand;
+                    for (let i = commandIndex || 0, cmd; argv._[i] !== undefined; i++) {
+                        cmd = String(argv._[i]);
+                        if (handlerKeys.includes(cmd) && cmd !== this.#completionCommand) {
+                            const innerArgv = this.#command.runCommand(cmd, this, parsed, i + 1, helpOnly, helpOptSet || versionOptSet || helpOnly);
+                            return this.#postProcess(innerArgv, populateDoubleDash, !!calledFromCommand, false);
+                        }
+                        else if (!firstUnknownCommand && cmd !== this.#completionCommand) {
+                            firstUnknownCommand = cmd;
+                            break;
+                        }
+                    }
+                    if (!this.#command.hasDefaultCommand() && this.#recommendCommands && firstUnknownCommand && !skipRecommendation) {
+                        this.#validation.recommendCommands(firstUnknownCommand, handlerKeys);
+                    }
+                }
+                if (this.#completionCommand && argv._.includes(this.#completionCommand) && !requestCompletions) {
+                    if (this.#exitProcess)
+                        setBlocking(true);
+                    this.showCompletionScript();
+                    this.exit(0);
+                }
+            }
+            if (this.#command.hasDefaultCommand() && !skipRecommendation) {
+                const innerArgv = this.#command.runCommand(null, this, parsed, 0, helpOnly, helpOptSet || versionOptSet || helpOnly);
+                return this.#postProcess(innerArgv, populateDoubleDash, !!calledFromCommand, false);
+            }
+            if (requestCompletions) {
+                if (this.#exitProcess)
+                    setBlocking(true);
+                args = [].concat(args);
+                const completionArgs = args.slice(args.indexOf(`--${this.#completion.completionKey}`) + 1);
+                this.#completion.getCompletion(completionArgs, (err, completions) => {
+                    if (err)
+                        throw new YError(err.message);
+                    (completions || []).forEach((completion) => {
+                        this.#logger.log(completion);
+                    });
+                    this.exit(0);
+                });
+                return this.#postProcess(argv, !populateDoubleDash, !!calledFromCommand, false);
+            }
+            if (!this.#hasOutput) {
+                if (helpOptSet) {
+                    if (this.#exitProcess)
+                        setBlocking(true);
+                    skipValidation = true;
+                    this.showHelp((message) => {
+                        this.#logger.log(message);
+                        this.exit(0);
+                    });
+                }
+                else if (versionOptSet) {
+                    if (this.#exitProcess)
+                        setBlocking(true);
+                    skipValidation = true;
+                    this.#usage.showVersion('log');
+                    this.exit(0);
+                }
+            }
+            if (!skipValidation && this.#options.skipValidation.length > 0) {
+                skipValidation = Object.keys(argv).some((key) => this.#options.skipValidation.indexOf(key) >= 0 && argv[key] === true);
+            }
+            if (!skipValidation) {
+                if (parsed.error)
+                    throw new YError(parsed.error.message);
+                if (!requestCompletions) {
+                    const validation = this.#runValidation(aliases, {}, parsed.error);
+                    if (!calledFromCommand)
+                        argvPromise = applyMiddleware(argv, this, this.#globalMiddleware.getMiddleware(), true);
+                    argvPromise = this.#validateAsync(validation, argvPromise ?? argv);
+                    if (isPromise(argvPromise) && !calledFromCommand) {
+                        argvPromise = argvPromise.then(() => applyMiddleware(argv, this, this.#globalMiddleware.getMiddleware(), false));
+                    }
+                }
+            }
+        }
+        catch (err) {
+            if (err instanceof YError)
+                this.#usage.fail(err.message, err);
+            else
+                throw err;
+        }
+        return this.#postProcess(argvPromise ?? argv, populateDoubleDash, !!calledFromCommand, true);
+    }
+    #runValidation(aliases, positionalMap, parseErrors, isDefaultCommand) {
+        const demandedOptions = { ...this.getDemandedOptions() };
+        return (argv) => {
+            if (parseErrors)
+                throw new YError(parseErrors.message);
+            this.#validation.nonOptionCount(argv);
+            this.#validation.requiredArguments(argv, demandedOptions);
+            let failedStrictCommands = false;
+            if (this.#strictCommands)
+                failedStrictCommands = this.#validation.unknownCommands(argv);
+            if (this.#strict && !failedStrictCommands)
+                this.#validation.unknownArguments(argv, aliases, positionalMap, !!isDefaultCommand);
+            else if (this.#strictOptions)
+                this.#validation.unknownArguments(argv, aliases, {}, false, false);
+            this.#validation.limitedChoices(argv);
+            this.#validation.implications(argv);
+            this.#validation.conflicting(argv);
+        };
+    }
+    #setHasOutput() {
+        this.#hasOutput = true;
+    }
+    #trackManuallySetKeys(keys) {
+        if (typeof keys === 'string')
+            this.#options.key[keys] = true;
+        else {
+            for (const k of keys)
+                this.#options.key[k] = true;
+        }
+    }
+}
+_a = YargsInstance;
+export function isYargsInstance(y) {
+    return !!y && typeof y.getInternalMethods === 'function';
+}