| 1234567891011121314151617181920212223242526272829303132333435363738394041424344454647484950515253545556575859606162636465666768697071727374757677787980818283848586878889909192939495969798991001011021031041051061071081091101111121131141151161171181191201211221231241251261271281291301311321331341351361371381391401411421431441451461471481491501511521531541551561571581591601611621631641651661671681691701711721731741751761771781791801811821831841851861871881891901911921931941951961971981992002012022032042052062072082092102112122132142152162172182192202212222232242252262272282292302312322332342352362372382392402412422432442452462472482492502512522532542552562572582592602612622632642652662672682692702712722732742752762772782792802812822832842852862872882892902912922932942952962972982993003013023033043053063073083093103113123133143153163173183193203213223233243253263273283293303313323333343353363373383393403413423433443453463473483493503513523533543553563573583593603613623633643653663673683693703713723733743753763773783793803813823833843853863873883893903913923933943953963973983994004014024034044054064074084094104114124134144154164174184194204214224234244254264274284294304314324334344354364374384394404414424434444454464474484494504514524534544554564574584594604614624634644654664674684694704714724734744754764774784794804814824834844854864874884894904914924934944954964974984995005015025035045055065075085095105115125135145155165175185195205215225235245255265275285295305315325335345355365375385395405415425435445455465475485495505515525535545555565575585595605615625635645655665675685695705715725735745755765775785795805815825835845855865875885895905915925935945955965975985996006016026036046056066076086096106116126136146156166176186196206216226236246256266276286296306316326336346356366376386396406416426436446456466476486496506516526536546556566576586596606616626636646656666676686696706716726736746756766776786796806816826836846856866876886896906916926936946956966976986997007017027037047057067077087097107117127137147157167177187197207217227237247257267277287297307317327337347357367377387397407417427437447457467477487497507517527537547557567577587597607617627637647657667677687697707717727737747757767777787797807817827837847857867877887897907917927937947957967977987998008018028038048058068078088098108118128138148158168178188198208218228238248258268278288298308318328338348358368378388398408418428438448458468478488498508518528538548558568578588598608618628638648658668678688698708718728738748758768778788798808818828838848858868878888898908918928938948958968978988999009019029039049059069079089099109119129139149159169179189199209219229239249259269279289299309319329339349359369379389399409419429439449459469479489499509519529539549559569579589599609619629639649659669679689699709719729739749759769779789799809819829839849859869879889899909919929939949959969979989991000100110021003100410051006100710081009101010111012101310141015101610171018101910201021102210231024102510261027102810291030103110321033103410351036103710381039104010411042104310441045104610471048104910501051105210531054105510561057105810591060106110621063106410651066106710681069107010711072107310741075107610771078107910801081108210831084108510861087108810891090109110921093109410951096109710981099110011011102110311041105110611071108110911101111111211131114111511161117111811191120112111221123112411251126112711281129113011311132113311341135113611371138113911401141114211431144114511461147114811491150115111521153115411551156115711581159116011611162116311641165116611671168116911701171117211731174117511761177117811791180118111821183118411851186118711881189119011911192119311941195119611971198119912001201120212031204120512061207120812091210121112121213121412151216121712181219122012211222122312241225122612271228122912301231123212331234123512361237123812391240124112421243124412451246124712481249125012511252125312541255125612571258125912601261126212631264126512661267126812691270127112721273127412751276127712781279128012811282128312841285128612871288128912901291129212931294129512961297129812991300130113021303130413051306130713081309131013111312131313141315131613171318131913201321132213231324132513261327132813291330133113321333133413351336133713381339134013411342134313441345134613471348134913501351135213531354135513561357135813591360136113621363136413651366136713681369137013711372137313741375137613771378137913801381138213831384138513861387138813891390139113921393139413951396139713981399140014011402140314041405140614071408140914101411141214131414141514161417141814191420142114221423142414251426142714281429143014311432143314341435143614371438143914401441144214431444144514461447144814491450145114521453145414551456145714581459146014611462146314641465146614671468146914701471147214731474147514761477147814791480148114821483148414851486148714881489149014911492149314941495149614971498149915001501150215031504150515061507150815091510151115121513151415151516151715181519152015211522152315241525152615271528152915301531153215331534153515361537153815391540154115421543154415451546154715481549155015511552155315541555155615571558155915601561156215631564156515661567156815691570157115721573157415751576157715781579158015811582158315841585158615871588158915901591159215931594159515961597159815991600160116021603160416051606160716081609161016111612161316141615161616171618161916201621162216231624162516261627162816291630163116321633163416351636163716381639164016411642164316441645164616471648164916501651165216531654165516561657165816591660166116621663166416651666166716681669167016711672167316741675167616771678167916801681168216831684168516861687168816891690169116921693169416951696169716981699170017011702170317041705170617071708170917101711171217131714171517161717171817191720172117221723172417251726172717281729173017311732173317341735173617371738173917401741174217431744174517461747174817491750175117521753175417551756175717581759176017611762176317641765176617671768176917701771177217731774177517761777177817791780178117821783178417851786178717881789179017911792179317941795179617971798179918001801180218031804180518061807180818091810181118121813181418151816181718181819182018211822182318241825182618271828182918301831183218331834183518361837183818391840184118421843184418451846184718481849185018511852185318541855185618571858185918601861186218631864186518661867186818691870187118721873187418751876187718781879188018811882188318841885188618871888188918901891189218931894189518961897189818991900190119021903190419051906190719081909191019111912191319141915191619171918191919201921192219231924192519261927192819291930193119321933193419351936193719381939194019411942194319441945194619471948194919501951195219531954195519561957195819591960196119621963196419651966196719681969197019711972197319741975197619771978197919801981198219831984198519861987198819891990199119921993199419951996199719981999200020012002200320042005200620072008200920102011201220132014201520162017201820192020202120222023202420252026202720282029203020312032203320342035203620372038203920402041204220432044204520462047204820492050205120522053205420552056205720582059206020612062206320642065206620672068206920702071207220732074207520762077207820792080208120822083208420852086208720882089209020912092209320942095209620972098209921002101210221032104210521062107210821092110211121122113211421152116211721182119212021212122212321242125212621272128212921302131213221332134213521362137213821392140214121422143214421452146214721482149215021512152215321542155215621572158215921602161216221632164216521662167216821692170217121722173217421752176217721782179218021812182218321842185218621872188218921902191219221932194219521962197219821992200220122022203220422052206220722082209221022112212221322142215221622172218221922202221222222232224222522262227222822292230223122322233223422352236223722382239224022412242224322442245224622472248224922502251225222532254225522562257225822592260226122622263226422652266226722682269227022712272227322742275227622772278227922802281228222832284228522862287228822892290229122922293229422952296229722982299230023012302230323042305230623072308230923102311231223132314231523162317231823192320232123222323232423252326232723282329233023312332233323342335233623372338233923402341234223432344234523462347234823492350235123522353235423552356235723582359236023612362236323642365236623672368236923702371237223732374237523762377237823792380238123822383238423852386238723882389239023912392239323942395239623972398239924002401240224032404240524062407240824092410241124122413241424152416241724182419242024212422242324242425242624272428242924302431243224332434243524362437243824392440244124422443244424452446244724482449245024512452245324542455245624572458245924602461246224632464246524662467246824692470247124722473247424752476247724782479248024812482248324842485248624872488248924902491249224932494249524962497249824992500250125022503250425052506250725082509251025112512251325142515251625172518251925202521252225232524252525262527252825292530253125322533253425352536253725382539254025412542254325442545254625472548254925502551255225532554255525562557255825592560256125622563256425652566256725682569257025712572257325742575257625772578257925802581258225832584258525862587258825892590259125922593259425952596259725982599260026012602260326042605260626072608260926102611261226132614261526162617261826192620262126222623262426252626262726282629263026312632263326342635263626372638263926402641264226432644264526462647264826492650265126522653265426552656265726582659266026612662266326642665266626672668266926702671267226732674267526762677267826792680268126822683268426852686268726882689269026912692269326942695269626972698269927002701270227032704270527062707270827092710271127122713271427152716271727182719272027212722272327242725272627272728272927302731273227332734273527362737273827392740274127422743274427452746274727482749275027512752275327542755275627572758275927602761276227632764276527662767276827692770277127722773277427752776277727782779278027812782278327842785278627872788278927902791279227932794279527962797279827992800280128022803280428052806280728082809281028112812281328142815281628172818281928202821282228232824282528262827282828292830283128322833283428352836283728382839284028412842284328442845284628472848284928502851285228532854285528562857285828592860286128622863286428652866286728682869287028712872287328742875287628772878287928802881288228832884288528862887288828892890289128922893289428952896289728982899290029012902290329042905290629072908290929102911291229132914291529162917291829192920 | 
							- 'use strict';
 
- var assert = require('assert');
 
- class YError extends Error {
 
-     constructor(msg) {
 
-         super(msg || 'yargs error');
 
-         this.name = 'YError';
 
-         Error.captureStackTrace(this, YError);
 
-     }
 
- }
 
- let previouslyVisitedConfigs = [];
 
- let shim;
 
- function applyExtends(config, cwd, mergeExtends, _shim) {
 
-     shim = _shim;
 
-     let defaultConfig = {};
 
-     if (Object.prototype.hasOwnProperty.call(config, 'extends')) {
 
-         if (typeof config.extends !== 'string')
 
-             return defaultConfig;
 
-         const isPath = /\.json|\..*rc$/.test(config.extends);
 
-         let pathToDefault = null;
 
-         if (!isPath) {
 
-             try {
 
-                 pathToDefault = require.resolve(config.extends);
 
-             }
 
-             catch (_err) {
 
-                 return config;
 
-             }
 
-         }
 
-         else {
 
-             pathToDefault = getPathToDefaultConfig(cwd, config.extends);
 
-         }
 
-         checkForCircularExtends(pathToDefault);
 
-         previouslyVisitedConfigs.push(pathToDefault);
 
-         defaultConfig = isPath
 
-             ? JSON.parse(shim.readFileSync(pathToDefault, 'utf8'))
 
-             : require(config.extends);
 
-         delete config.extends;
 
-         defaultConfig = applyExtends(defaultConfig, shim.path.dirname(pathToDefault), mergeExtends, shim);
 
-     }
 
-     previouslyVisitedConfigs = [];
 
-     return mergeExtends
 
-         ? mergeDeep(defaultConfig, config)
 
-         : Object.assign({}, defaultConfig, config);
 
- }
 
- function checkForCircularExtends(cfgPath) {
 
-     if (previouslyVisitedConfigs.indexOf(cfgPath) > -1) {
 
-         throw new YError(`Circular extended configurations: '${cfgPath}'.`);
 
-     }
 
- }
 
- function getPathToDefaultConfig(cwd, pathToExtend) {
 
-     return shim.path.resolve(cwd, pathToExtend);
 
- }
 
- function mergeDeep(config1, config2) {
 
-     const target = {};
 
-     function isObject(obj) {
 
-         return obj && typeof obj === 'object' && !Array.isArray(obj);
 
-     }
 
-     Object.assign(target, config1);
 
-     for (const key of Object.keys(config2)) {
 
-         if (isObject(config2[key]) && isObject(target[key])) {
 
-             target[key] = mergeDeep(config1[key], config2[key]);
 
-         }
 
-         else {
 
-             target[key] = config2[key];
 
-         }
 
-     }
 
-     return target;
 
- }
 
- function parseCommand(cmd) {
 
-     const extraSpacesStrippedCommand = cmd.replace(/\s{2,}/g, ' ');
 
-     const splitCommand = extraSpacesStrippedCommand.split(/\s+(?![^[]*]|[^<]*>)/);
 
-     const bregex = /\.*[\][<>]/g;
 
-     const firstCommand = splitCommand.shift();
 
-     if (!firstCommand)
 
-         throw new Error(`No command found in: ${cmd}`);
 
-     const parsedCommand = {
 
-         cmd: firstCommand.replace(bregex, ''),
 
-         demanded: [],
 
-         optional: [],
 
-     };
 
-     splitCommand.forEach((cmd, i) => {
 
-         let variadic = false;
 
-         cmd = cmd.replace(/\s/g, '');
 
-         if (/\.+[\]>]/.test(cmd) && i === splitCommand.length - 1)
 
-             variadic = true;
 
-         if (/^\[/.test(cmd)) {
 
-             parsedCommand.optional.push({
 
-                 cmd: cmd.replace(bregex, '').split('|'),
 
-                 variadic,
 
-             });
 
-         }
 
-         else {
 
-             parsedCommand.demanded.push({
 
-                 cmd: cmd.replace(bregex, '').split('|'),
 
-                 variadic,
 
-             });
 
-         }
 
-     });
 
-     return parsedCommand;
 
- }
 
- const positionName = ['first', 'second', 'third', 'fourth', 'fifth', 'sixth'];
 
- function argsert(arg1, arg2, arg3) {
 
-     function parseArgs() {
 
-         return typeof arg1 === 'object'
 
-             ? [{ demanded: [], optional: [] }, arg1, arg2]
 
-             : [
 
-                 parseCommand(`cmd ${arg1}`),
 
-                 arg2,
 
-                 arg3,
 
-             ];
 
-     }
 
-     try {
 
-         let position = 0;
 
-         const [parsed, callerArguments, _length] = parseArgs();
 
-         const args = [].slice.call(callerArguments);
 
-         while (args.length && args[args.length - 1] === undefined)
 
-             args.pop();
 
-         const length = _length || args.length;
 
-         if (length < parsed.demanded.length) {
 
-             throw new YError(`Not enough arguments provided. Expected ${parsed.demanded.length} but received ${args.length}.`);
 
-         }
 
-         const totalCommands = parsed.demanded.length + parsed.optional.length;
 
-         if (length > totalCommands) {
 
-             throw new YError(`Too many arguments provided. Expected max ${totalCommands} but received ${length}.`);
 
-         }
 
-         parsed.demanded.forEach(demanded => {
 
-             const arg = args.shift();
 
-             const observedType = guessType(arg);
 
-             const matchingTypes = demanded.cmd.filter(type => type === observedType || type === '*');
 
-             if (matchingTypes.length === 0)
 
-                 argumentTypeError(observedType, demanded.cmd, position);
 
-             position += 1;
 
-         });
 
-         parsed.optional.forEach(optional => {
 
-             if (args.length === 0)
 
-                 return;
 
-             const arg = args.shift();
 
-             const observedType = guessType(arg);
 
-             const matchingTypes = optional.cmd.filter(type => type === observedType || type === '*');
 
-             if (matchingTypes.length === 0)
 
-                 argumentTypeError(observedType, optional.cmd, position);
 
-             position += 1;
 
-         });
 
-     }
 
-     catch (err) {
 
-         console.warn(err.stack);
 
-     }
 
- }
 
- function guessType(arg) {
 
-     if (Array.isArray(arg)) {
 
-         return 'array';
 
-     }
 
-     else if (arg === null) {
 
-         return 'null';
 
-     }
 
-     return typeof arg;
 
- }
 
- function argumentTypeError(observedType, allowedTypes, position) {
 
-     throw new YError(`Invalid ${positionName[position] || 'manyith'} argument. Expected ${allowedTypes.join(' or ')} but received ${observedType}.`);
 
- }
 
- function isPromise(maybePromise) {
 
-     return (!!maybePromise &&
 
-         !!maybePromise.then &&
 
-         typeof maybePromise.then === 'function');
 
- }
 
- function assertNotStrictEqual(actual, expected, shim, message) {
 
-     shim.assert.notStrictEqual(actual, expected, message);
 
- }
 
- function assertSingleKey(actual, shim) {
 
-     shim.assert.strictEqual(typeof actual, 'string');
 
- }
 
- function objectKeys(object) {
 
-     return Object.keys(object);
 
- }
 
- function objFilter(original = {}, filter = () => true) {
 
-     const obj = {};
 
-     objectKeys(original).forEach(key => {
 
-         if (filter(key, original[key])) {
 
-             obj[key] = original[key];
 
-         }
 
-     });
 
-     return obj;
 
- }
 
- function globalMiddlewareFactory(globalMiddleware, context) {
 
-     return function (callback, applyBeforeValidation = false) {
 
-         argsert('<array|function> [boolean]', [callback, applyBeforeValidation], arguments.length);
 
-         if (Array.isArray(callback)) {
 
-             for (let i = 0; i < callback.length; i++) {
 
-                 if (typeof callback[i] !== 'function') {
 
-                     throw Error('middleware must be a function');
 
-                 }
 
-                 callback[i].applyBeforeValidation = applyBeforeValidation;
 
-             }
 
-             Array.prototype.push.apply(globalMiddleware, callback);
 
-         }
 
-         else if (typeof callback === 'function') {
 
-             callback.applyBeforeValidation = applyBeforeValidation;
 
-             globalMiddleware.push(callback);
 
-         }
 
-         return context;
 
-     };
 
- }
 
- function commandMiddlewareFactory(commandMiddleware) {
 
-     if (!commandMiddleware)
 
-         return [];
 
-     return commandMiddleware.map(middleware => {
 
-         middleware.applyBeforeValidation = false;
 
-         return middleware;
 
-     });
 
- }
 
- function applyMiddleware(argv, yargs, middlewares, beforeValidation) {
 
-     const beforeValidationError = new Error('middleware cannot return a promise when applyBeforeValidation is true');
 
-     return middlewares.reduce((acc, middleware) => {
 
-         if (middleware.applyBeforeValidation !== beforeValidation) {
 
-             return acc;
 
-         }
 
-         if (isPromise(acc)) {
 
-             return acc
 
-                 .then(initialObj => Promise.all([
 
-                 initialObj,
 
-                 middleware(initialObj, yargs),
 
-             ]))
 
-                 .then(([initialObj, middlewareObj]) => Object.assign(initialObj, middlewareObj));
 
-         }
 
-         else {
 
-             const result = middleware(acc, yargs);
 
-             if (beforeValidation && isPromise(result))
 
-                 throw beforeValidationError;
 
-             return isPromise(result)
 
-                 ? result.then(middlewareObj => Object.assign(acc, middlewareObj))
 
-                 : Object.assign(acc, result);
 
-         }
 
-     }, argv);
 
- }
 
- function getProcessArgvBinIndex() {
 
-     if (isBundledElectronApp())
 
-         return 0;
 
-     return 1;
 
- }
 
- function isBundledElectronApp() {
 
-     return isElectronApp() && !process.defaultApp;
 
- }
 
- function isElectronApp() {
 
-     return !!process.versions.electron;
 
- }
 
- function hideBin(argv) {
 
-     return argv.slice(getProcessArgvBinIndex() + 1);
 
- }
 
- function getProcessArgvBin() {
 
-     return process.argv[getProcessArgvBinIndex()];
 
- }
 
- var processArgv = /*#__PURE__*/Object.freeze({
 
-   __proto__: null,
 
-   hideBin: hideBin,
 
-   getProcessArgvBin: getProcessArgvBin
 
- });
 
- function whichModule(exported) {
 
-     if (typeof require === 'undefined')
 
-         return null;
 
-     for (let i = 0, files = Object.keys(require.cache), mod; i < files.length; i++) {
 
-         mod = require.cache[files[i]];
 
-         if (mod.exports === exported)
 
-             return mod;
 
-     }
 
-     return null;
 
- }
 
- const DEFAULT_MARKER = /(^\*)|(^\$0)/;
 
- function command(yargs, usage, validation, globalMiddleware = [], shim) {
 
-     const self = {};
 
-     let handlers = {};
 
-     let aliasMap = {};
 
-     let defaultCommand;
 
-     self.addHandler = function addHandler(cmd, description, builder, handler, commandMiddleware, deprecated) {
 
-         let aliases = [];
 
-         const middlewares = commandMiddlewareFactory(commandMiddleware);
 
-         handler = handler || (() => { });
 
-         if (Array.isArray(cmd)) {
 
-             if (isCommandAndAliases(cmd)) {
 
-                 [cmd, ...aliases] = cmd;
 
-             }
 
-             else {
 
-                 for (const command of cmd) {
 
-                     self.addHandler(command);
 
-                 }
 
-             }
 
-         }
 
-         else if (isCommandHandlerDefinition(cmd)) {
 
-             let command = Array.isArray(cmd.command) || typeof cmd.command === 'string'
 
-                 ? cmd.command
 
-                 : moduleName(cmd);
 
-             if (cmd.aliases)
 
-                 command = [].concat(command).concat(cmd.aliases);
 
-             self.addHandler(command, extractDesc(cmd), cmd.builder, cmd.handler, cmd.middlewares, cmd.deprecated);
 
-             return;
 
-         }
 
-         else if (isCommandBuilderDefinition(builder)) {
 
-             self.addHandler([cmd].concat(aliases), description, builder.builder, builder.handler, builder.middlewares, builder.deprecated);
 
-             return;
 
-         }
 
-         if (typeof cmd === 'string') {
 
-             const parsedCommand = parseCommand(cmd);
 
-             aliases = aliases.map(alias => parseCommand(alias).cmd);
 
-             let isDefault = false;
 
-             const parsedAliases = [parsedCommand.cmd].concat(aliases).filter(c => {
 
-                 if (DEFAULT_MARKER.test(c)) {
 
-                     isDefault = true;
 
-                     return false;
 
-                 }
 
-                 return true;
 
-             });
 
-             if (parsedAliases.length === 0 && isDefault)
 
-                 parsedAliases.push('$0');
 
-             if (isDefault) {
 
-                 parsedCommand.cmd = parsedAliases[0];
 
-                 aliases = parsedAliases.slice(1);
 
-                 cmd = cmd.replace(DEFAULT_MARKER, parsedCommand.cmd);
 
-             }
 
-             aliases.forEach(alias => {
 
-                 aliasMap[alias] = parsedCommand.cmd;
 
-             });
 
-             if (description !== false) {
 
-                 usage.command(cmd, description, isDefault, aliases, deprecated);
 
-             }
 
-             handlers[parsedCommand.cmd] = {
 
-                 original: cmd,
 
-                 description,
 
-                 handler,
 
-                 builder: builder || {},
 
-                 middlewares,
 
-                 deprecated,
 
-                 demanded: parsedCommand.demanded,
 
-                 optional: parsedCommand.optional,
 
-             };
 
-             if (isDefault)
 
-                 defaultCommand = handlers[parsedCommand.cmd];
 
-         }
 
-     };
 
-     self.addDirectory = function addDirectory(dir, context, req, callerFile, opts) {
 
-         opts = opts || {};
 
-         if (typeof opts.recurse !== 'boolean')
 
-             opts.recurse = false;
 
-         if (!Array.isArray(opts.extensions))
 
-             opts.extensions = ['js'];
 
-         const parentVisit = typeof opts.visit === 'function' ? opts.visit : (o) => o;
 
-         opts.visit = function visit(obj, joined, filename) {
 
-             const visited = parentVisit(obj, joined, filename);
 
-             if (visited) {
 
-                 if (~context.files.indexOf(joined))
 
-                     return visited;
 
-                 context.files.push(joined);
 
-                 self.addHandler(visited);
 
-             }
 
-             return visited;
 
-         };
 
-         shim.requireDirectory({ require: req, filename: callerFile }, dir, opts);
 
-     };
 
-     function moduleName(obj) {
 
-         const mod = whichModule(obj);
 
-         if (!mod)
 
-             throw new Error(`No command name given for module: ${shim.inspect(obj)}`);
 
-         return commandFromFilename(mod.filename);
 
-     }
 
-     function commandFromFilename(filename) {
 
-         return shim.path.basename(filename, shim.path.extname(filename));
 
-     }
 
-     function extractDesc({ describe, description, desc, }) {
 
-         for (const test of [describe, description, desc]) {
 
-             if (typeof test === 'string' || test === false)
 
-                 return test;
 
-             assertNotStrictEqual(test, true, shim);
 
-         }
 
-         return false;
 
-     }
 
-     self.getCommands = () => Object.keys(handlers).concat(Object.keys(aliasMap));
 
-     self.getCommandHandlers = () => handlers;
 
-     self.hasDefaultCommand = () => !!defaultCommand;
 
-     self.runCommand = function runCommand(command, yargs, parsed, commandIndex) {
 
-         let aliases = parsed.aliases;
 
-         const commandHandler = handlers[command] || handlers[aliasMap[command]] || defaultCommand;
 
-         const currentContext = yargs.getContext();
 
-         let numFiles = currentContext.files.length;
 
-         const parentCommands = currentContext.commands.slice();
 
-         let innerArgv = parsed.argv;
 
-         let positionalMap = {};
 
-         if (command) {
 
-             currentContext.commands.push(command);
 
-             currentContext.fullCommands.push(commandHandler.original);
 
-         }
 
-         const builder = commandHandler.builder;
 
-         if (isCommandBuilderCallback(builder)) {
 
-             const builderOutput = builder(yargs.reset(parsed.aliases));
 
-             const innerYargs = isYargsInstance(builderOutput) ? builderOutput : yargs;
 
-             if (shouldUpdateUsage(innerYargs)) {
 
-                 innerYargs
 
-                     .getUsageInstance()
 
-                     .usage(usageFromParentCommandsCommandHandler(parentCommands, commandHandler), commandHandler.description);
 
-             }
 
-             innerArgv = innerYargs._parseArgs(null, null, true, commandIndex);
 
-             aliases = innerYargs.parsed.aliases;
 
-         }
 
-         else if (isCommandBuilderOptionDefinitions(builder)) {
 
-             const innerYargs = yargs.reset(parsed.aliases);
 
-             if (shouldUpdateUsage(innerYargs)) {
 
-                 innerYargs
 
-                     .getUsageInstance()
 
-                     .usage(usageFromParentCommandsCommandHandler(parentCommands, commandHandler), commandHandler.description);
 
-             }
 
-             Object.keys(commandHandler.builder).forEach(key => {
 
-                 innerYargs.option(key, builder[key]);
 
-             });
 
-             innerArgv = innerYargs._parseArgs(null, null, true, commandIndex);
 
-             aliases = innerYargs.parsed.aliases;
 
-         }
 
-         if (!yargs._hasOutput()) {
 
-             positionalMap = populatePositionals(commandHandler, innerArgv, currentContext);
 
-         }
 
-         const middlewares = globalMiddleware
 
-             .slice(0)
 
-             .concat(commandHandler.middlewares);
 
-         applyMiddleware(innerArgv, yargs, middlewares, true);
 
-         if (!yargs._hasOutput()) {
 
-             yargs._runValidation(innerArgv, aliases, positionalMap, yargs.parsed.error, !command);
 
-         }
 
-         if (commandHandler.handler && !yargs._hasOutput()) {
 
-             yargs._setHasOutput();
 
-             const populateDoubleDash = !!yargs.getOptions().configuration['populate--'];
 
-             yargs._postProcess(innerArgv, populateDoubleDash);
 
-             innerArgv = applyMiddleware(innerArgv, yargs, middlewares, false);
 
-             let handlerResult;
 
-             if (isPromise(innerArgv)) {
 
-                 handlerResult = innerArgv.then(argv => commandHandler.handler(argv));
 
-             }
 
-             else {
 
-                 handlerResult = commandHandler.handler(innerArgv);
 
-             }
 
-             const handlerFinishCommand = yargs.getHandlerFinishCommand();
 
-             if (isPromise(handlerResult)) {
 
-                 yargs.getUsageInstance().cacheHelpMessage();
 
-                 handlerResult
 
-                     .then(value => {
 
-                     if (handlerFinishCommand) {
 
-                         handlerFinishCommand(value);
 
-                     }
 
-                 })
 
-                     .catch(error => {
 
-                     try {
 
-                         yargs.getUsageInstance().fail(null, error);
 
-                     }
 
-                     catch (err) {
 
-                     }
 
-                 })
 
-                     .then(() => {
 
-                     yargs.getUsageInstance().clearCachedHelpMessage();
 
-                 });
 
-             }
 
-             else {
 
-                 if (handlerFinishCommand) {
 
-                     handlerFinishCommand(handlerResult);
 
-                 }
 
-             }
 
-         }
 
-         if (command) {
 
-             currentContext.commands.pop();
 
-             currentContext.fullCommands.pop();
 
-         }
 
-         numFiles = currentContext.files.length - numFiles;
 
-         if (numFiles > 0)
 
-             currentContext.files.splice(numFiles * -1, numFiles);
 
-         return innerArgv;
 
-     };
 
-     function shouldUpdateUsage(yargs) {
 
-         return (!yargs.getUsageInstance().getUsageDisabled() &&
 
-             yargs.getUsageInstance().getUsage().length === 0);
 
-     }
 
-     function usageFromParentCommandsCommandHandler(parentCommands, commandHandler) {
 
-         const c = DEFAULT_MARKER.test(commandHandler.original)
 
-             ? commandHandler.original.replace(DEFAULT_MARKER, '').trim()
 
-             : commandHandler.original;
 
-         const pc = parentCommands.filter(c => {
 
-             return !DEFAULT_MARKER.test(c);
 
-         });
 
-         pc.push(c);
 
-         return `$0 ${pc.join(' ')}`;
 
-     }
 
-     self.runDefaultBuilderOn = function (yargs) {
 
-         assertNotStrictEqual(defaultCommand, undefined, shim);
 
-         if (shouldUpdateUsage(yargs)) {
 
-             const commandString = DEFAULT_MARKER.test(defaultCommand.original)
 
-                 ? defaultCommand.original
 
-                 : defaultCommand.original.replace(/^[^[\]<>]*/, '$0 ');
 
-             yargs.getUsageInstance().usage(commandString, defaultCommand.description);
 
-         }
 
-         const builder = defaultCommand.builder;
 
-         if (isCommandBuilderCallback(builder)) {
 
-             builder(yargs);
 
-         }
 
-         else if (!isCommandBuilderDefinition(builder)) {
 
-             Object.keys(builder).forEach(key => {
 
-                 yargs.option(key, builder[key]);
 
-             });
 
-         }
 
-     };
 
-     function populatePositionals(commandHandler, argv, context) {
 
-         argv._ = argv._.slice(context.commands.length);
 
-         const demanded = commandHandler.demanded.slice(0);
 
-         const optional = commandHandler.optional.slice(0);
 
-         const positionalMap = {};
 
-         validation.positionalCount(demanded.length, argv._.length);
 
-         while (demanded.length) {
 
-             const demand = demanded.shift();
 
-             populatePositional(demand, argv, positionalMap);
 
-         }
 
-         while (optional.length) {
 
-             const maybe = optional.shift();
 
-             populatePositional(maybe, argv, positionalMap);
 
-         }
 
-         argv._ = context.commands.concat(argv._.map(a => '' + a));
 
-         postProcessPositionals(argv, positionalMap, self.cmdToParseOptions(commandHandler.original));
 
-         return positionalMap;
 
-     }
 
-     function populatePositional(positional, argv, positionalMap) {
 
-         const cmd = positional.cmd[0];
 
-         if (positional.variadic) {
 
-             positionalMap[cmd] = argv._.splice(0).map(String);
 
-         }
 
-         else {
 
-             if (argv._.length)
 
-                 positionalMap[cmd] = [String(argv._.shift())];
 
-         }
 
-     }
 
-     function postProcessPositionals(argv, positionalMap, parseOptions) {
 
-         const options = Object.assign({}, yargs.getOptions());
 
-         options.default = Object.assign(parseOptions.default, options.default);
 
-         for (const key of Object.keys(parseOptions.alias)) {
 
-             options.alias[key] = (options.alias[key] || []).concat(parseOptions.alias[key]);
 
-         }
 
-         options.array = options.array.concat(parseOptions.array);
 
-         options.config = {};
 
-         const unparsed = [];
 
-         Object.keys(positionalMap).forEach(key => {
 
-             positionalMap[key].map(value => {
 
-                 if (options.configuration['unknown-options-as-args'])
 
-                     options.key[key] = true;
 
-                 unparsed.push(`--${key}`);
 
-                 unparsed.push(value);
 
-             });
 
-         });
 
-         if (!unparsed.length)
 
-             return;
 
-         const config = Object.assign({}, options.configuration, {
 
-             'populate--': true,
 
-         });
 
-         const parsed = shim.Parser.detailed(unparsed, Object.assign({}, options, {
 
-             configuration: config,
 
-         }));
 
-         if (parsed.error) {
 
-             yargs.getUsageInstance().fail(parsed.error.message, parsed.error);
 
-         }
 
-         else {
 
-             const positionalKeys = Object.keys(positionalMap);
 
-             Object.keys(positionalMap).forEach(key => {
 
-                 positionalKeys.push(...parsed.aliases[key]);
 
-             });
 
-             Object.keys(parsed.argv).forEach(key => {
 
-                 if (positionalKeys.indexOf(key) !== -1) {
 
-                     if (!positionalMap[key])
 
-                         positionalMap[key] = parsed.argv[key];
 
-                     argv[key] = parsed.argv[key];
 
-                 }
 
-             });
 
-         }
 
-     }
 
-     self.cmdToParseOptions = function (cmdString) {
 
-         const parseOptions = {
 
-             array: [],
 
-             default: {},
 
-             alias: {},
 
-             demand: {},
 
-         };
 
-         const parsed = parseCommand(cmdString);
 
-         parsed.demanded.forEach(d => {
 
-             const [cmd, ...aliases] = d.cmd;
 
-             if (d.variadic) {
 
-                 parseOptions.array.push(cmd);
 
-                 parseOptions.default[cmd] = [];
 
-             }
 
-             parseOptions.alias[cmd] = aliases;
 
-             parseOptions.demand[cmd] = true;
 
-         });
 
-         parsed.optional.forEach(o => {
 
-             const [cmd, ...aliases] = o.cmd;
 
-             if (o.variadic) {
 
-                 parseOptions.array.push(cmd);
 
-                 parseOptions.default[cmd] = [];
 
-             }
 
-             parseOptions.alias[cmd] = aliases;
 
-         });
 
-         return parseOptions;
 
-     };
 
-     self.reset = () => {
 
-         handlers = {};
 
-         aliasMap = {};
 
-         defaultCommand = undefined;
 
-         return self;
 
-     };
 
-     const frozens = [];
 
-     self.freeze = () => {
 
-         frozens.push({
 
-             handlers,
 
-             aliasMap,
 
-             defaultCommand,
 
-         });
 
-     };
 
-     self.unfreeze = () => {
 
-         const frozen = frozens.pop();
 
-         assertNotStrictEqual(frozen, undefined, shim);
 
-         ({ handlers, aliasMap, defaultCommand } = frozen);
 
-     };
 
-     return self;
 
- }
 
- function isCommandBuilderDefinition(builder) {
 
-     return (typeof builder === 'object' &&
 
-         !!builder.builder &&
 
-         typeof builder.handler === 'function');
 
- }
 
- function isCommandAndAliases(cmd) {
 
-     if (cmd.every(c => typeof c === 'string')) {
 
-         return true;
 
-     }
 
-     else {
 
-         return false;
 
-     }
 
- }
 
- function isCommandBuilderCallback(builder) {
 
-     return typeof builder === 'function';
 
- }
 
- function isCommandBuilderOptionDefinitions(builder) {
 
-     return typeof builder === 'object';
 
- }
 
- function isCommandHandlerDefinition(cmd) {
 
-     return typeof cmd === 'object' && !Array.isArray(cmd);
 
- }
 
- function setBlocking(blocking) {
 
-     if (typeof process === 'undefined')
 
-         return;
 
-     [process.stdout, process.stderr].forEach(_stream => {
 
-         const stream = _stream;
 
-         if (stream._handle &&
 
-             stream.isTTY &&
 
-             typeof stream._handle.setBlocking === 'function') {
 
-             stream._handle.setBlocking(blocking);
 
-         }
 
-     });
 
- }
 
- function usage(yargs, y18n, shim) {
 
-     const __ = y18n.__;
 
-     const self = {};
 
-     const fails = [];
 
-     self.failFn = function failFn(f) {
 
-         fails.push(f);
 
-     };
 
-     let failMessage = null;
 
-     let showHelpOnFail = true;
 
-     self.showHelpOnFail = function showHelpOnFailFn(arg1 = true, arg2) {
 
-         function parseFunctionArgs() {
 
-             return typeof arg1 === 'string' ? [true, arg1] : [arg1, arg2];
 
-         }
 
-         const [enabled, message] = parseFunctionArgs();
 
-         failMessage = message;
 
-         showHelpOnFail = enabled;
 
-         return self;
 
-     };
 
-     let failureOutput = false;
 
-     self.fail = function fail(msg, err) {
 
-         const logger = yargs._getLoggerInstance();
 
-         if (fails.length) {
 
-             for (let i = fails.length - 1; i >= 0; --i) {
 
-                 fails[i](msg, err, self);
 
-             }
 
-         }
 
-         else {
 
-             if (yargs.getExitProcess())
 
-                 setBlocking(true);
 
-             if (!failureOutput) {
 
-                 failureOutput = true;
 
-                 if (showHelpOnFail) {
 
-                     yargs.showHelp('error');
 
-                     logger.error();
 
-                 }
 
-                 if (msg || err)
 
-                     logger.error(msg || err);
 
-                 if (failMessage) {
 
-                     if (msg || err)
 
-                         logger.error('');
 
-                     logger.error(failMessage);
 
-                 }
 
-             }
 
-             err = err || new YError(msg);
 
-             if (yargs.getExitProcess()) {
 
-                 return yargs.exit(1);
 
-             }
 
-             else if (yargs._hasParseCallback()) {
 
-                 return yargs.exit(1, err);
 
-             }
 
-             else {
 
-                 throw err;
 
-             }
 
-         }
 
-     };
 
-     let usages = [];
 
-     let usageDisabled = false;
 
-     self.usage = (msg, description) => {
 
-         if (msg === null) {
 
-             usageDisabled = true;
 
-             usages = [];
 
-             return self;
 
-         }
 
-         usageDisabled = false;
 
-         usages.push([msg, description || '']);
 
-         return self;
 
-     };
 
-     self.getUsage = () => {
 
-         return usages;
 
-     };
 
-     self.getUsageDisabled = () => {
 
-         return usageDisabled;
 
-     };
 
-     self.getPositionalGroupName = () => {
 
-         return __('Positionals:');
 
-     };
 
-     let examples = [];
 
-     self.example = (cmd, description) => {
 
-         examples.push([cmd, description || '']);
 
-     };
 
-     let commands = [];
 
-     self.command = function command(cmd, description, isDefault, aliases, deprecated = false) {
 
-         if (isDefault) {
 
-             commands = commands.map(cmdArray => {
 
-                 cmdArray[2] = false;
 
-                 return cmdArray;
 
-             });
 
-         }
 
-         commands.push([cmd, description || '', isDefault, aliases, deprecated]);
 
-     };
 
-     self.getCommands = () => commands;
 
-     let descriptions = {};
 
-     self.describe = function describe(keyOrKeys, desc) {
 
-         if (Array.isArray(keyOrKeys)) {
 
-             keyOrKeys.forEach(k => {
 
-                 self.describe(k, desc);
 
-             });
 
-         }
 
-         else if (typeof keyOrKeys === 'object') {
 
-             Object.keys(keyOrKeys).forEach(k => {
 
-                 self.describe(k, keyOrKeys[k]);
 
-             });
 
-         }
 
-         else {
 
-             descriptions[keyOrKeys] = desc;
 
-         }
 
-     };
 
-     self.getDescriptions = () => descriptions;
 
-     let epilogs = [];
 
-     self.epilog = msg => {
 
-         epilogs.push(msg);
 
-     };
 
-     let wrapSet = false;
 
-     let wrap;
 
-     self.wrap = cols => {
 
-         wrapSet = true;
 
-         wrap = cols;
 
-     };
 
-     function getWrap() {
 
-         if (!wrapSet) {
 
-             wrap = windowWidth();
 
-             wrapSet = true;
 
-         }
 
-         return wrap;
 
-     }
 
-     const deferY18nLookupPrefix = '__yargsString__:';
 
-     self.deferY18nLookup = str => deferY18nLookupPrefix + str;
 
-     self.help = function help() {
 
-         if (cachedHelpMessage)
 
-             return cachedHelpMessage;
 
-         normalizeAliases();
 
-         const base$0 = yargs.customScriptName
 
-             ? yargs.$0
 
-             : shim.path.basename(yargs.$0);
 
-         const demandedOptions = yargs.getDemandedOptions();
 
-         const demandedCommands = yargs.getDemandedCommands();
 
-         const deprecatedOptions = yargs.getDeprecatedOptions();
 
-         const groups = yargs.getGroups();
 
-         const options = yargs.getOptions();
 
-         let keys = [];
 
-         keys = keys.concat(Object.keys(descriptions));
 
-         keys = keys.concat(Object.keys(demandedOptions));
 
-         keys = keys.concat(Object.keys(demandedCommands));
 
-         keys = keys.concat(Object.keys(options.default));
 
-         keys = keys.filter(filterHiddenOptions);
 
-         keys = Object.keys(keys.reduce((acc, key) => {
 
-             if (key !== '_')
 
-                 acc[key] = true;
 
-             return acc;
 
-         }, {}));
 
-         const theWrap = getWrap();
 
-         const ui = shim.cliui({
 
-             width: theWrap,
 
-             wrap: !!theWrap,
 
-         });
 
-         if (!usageDisabled) {
 
-             if (usages.length) {
 
-                 usages.forEach(usage => {
 
-                     ui.div(`${usage[0].replace(/\$0/g, base$0)}`);
 
-                     if (usage[1]) {
 
-                         ui.div({ text: `${usage[1]}`, padding: [1, 0, 0, 0] });
 
-                     }
 
-                 });
 
-                 ui.div();
 
-             }
 
-             else if (commands.length) {
 
-                 let u = null;
 
-                 if (demandedCommands._) {
 
-                     u = `${base$0} <${__('command')}>\n`;
 
-                 }
 
-                 else {
 
-                     u = `${base$0} [${__('command')}]\n`;
 
-                 }
 
-                 ui.div(`${u}`);
 
-             }
 
-         }
 
-         if (commands.length) {
 
-             ui.div(__('Commands:'));
 
-             const context = yargs.getContext();
 
-             const parentCommands = context.commands.length
 
-                 ? `${context.commands.join(' ')} `
 
-                 : '';
 
-             if (yargs.getParserConfiguration()['sort-commands'] === true) {
 
-                 commands = commands.sort((a, b) => a[0].localeCompare(b[0]));
 
-             }
 
-             commands.forEach(command => {
 
-                 const commandString = `${base$0} ${parentCommands}${command[0].replace(/^\$0 ?/, '')}`;
 
-                 ui.span({
 
-                     text: commandString,
 
-                     padding: [0, 2, 0, 2],
 
-                     width: maxWidth(commands, theWrap, `${base$0}${parentCommands}`) + 4,
 
-                 }, { text: command[1] });
 
-                 const hints = [];
 
-                 if (command[2])
 
-                     hints.push(`[${__('default')}]`);
 
-                 if (command[3] && command[3].length) {
 
-                     hints.push(`[${__('aliases:')} ${command[3].join(', ')}]`);
 
-                 }
 
-                 if (command[4]) {
 
-                     if (typeof command[4] === 'string') {
 
-                         hints.push(`[${__('deprecated: %s', command[4])}]`);
 
-                     }
 
-                     else {
 
-                         hints.push(`[${__('deprecated')}]`);
 
-                     }
 
-                 }
 
-                 if (hints.length) {
 
-                     ui.div({
 
-                         text: hints.join(' '),
 
-                         padding: [0, 0, 0, 2],
 
-                         align: 'right',
 
-                     });
 
-                 }
 
-                 else {
 
-                     ui.div();
 
-                 }
 
-             });
 
-             ui.div();
 
-         }
 
-         const aliasKeys = (Object.keys(options.alias) || []).concat(Object.keys(yargs.parsed.newAliases) || []);
 
-         keys = keys.filter(key => !yargs.parsed.newAliases[key] &&
 
-             aliasKeys.every(alias => (options.alias[alias] || []).indexOf(key) === -1));
 
-         const defaultGroup = __('Options:');
 
-         if (!groups[defaultGroup])
 
-             groups[defaultGroup] = [];
 
-         addUngroupedKeys(keys, options.alias, groups, defaultGroup);
 
-         const isLongSwitch = (sw) => /^--/.test(getText(sw));
 
-         const displayedGroups = Object.keys(groups)
 
-             .filter(groupName => groups[groupName].length > 0)
 
-             .map(groupName => {
 
-             const normalizedKeys = groups[groupName]
 
-                 .filter(filterHiddenOptions)
 
-                 .map(key => {
 
-                 if (~aliasKeys.indexOf(key))
 
-                     return key;
 
-                 for (let i = 0, aliasKey; (aliasKey = aliasKeys[i]) !== undefined; i++) {
 
-                     if (~(options.alias[aliasKey] || []).indexOf(key))
 
-                         return aliasKey;
 
-                 }
 
-                 return key;
 
-             });
 
-             return { groupName, normalizedKeys };
 
-         })
 
-             .filter(({ normalizedKeys }) => normalizedKeys.length > 0)
 
-             .map(({ groupName, normalizedKeys }) => {
 
-             const switches = normalizedKeys.reduce((acc, key) => {
 
-                 acc[key] = [key]
 
-                     .concat(options.alias[key] || [])
 
-                     .map(sw => {
 
-                     if (groupName === self.getPositionalGroupName())
 
-                         return sw;
 
-                     else {
 
-                         return ((/^[0-9]$/.test(sw)
 
-                             ? ~options.boolean.indexOf(key)
 
-                                 ? '-'
 
-                                 : '--'
 
-                             : sw.length > 1
 
-                                 ? '--'
 
-                                 : '-') + sw);
 
-                     }
 
-                 })
 
-                     .sort((sw1, sw2) => isLongSwitch(sw1) === isLongSwitch(sw2)
 
-                     ? 0
 
-                     : isLongSwitch(sw1)
 
-                         ? 1
 
-                         : -1)
 
-                     .join(', ');
 
-                 return acc;
 
-             }, {});
 
-             return { groupName, normalizedKeys, switches };
 
-         });
 
-         const shortSwitchesUsed = displayedGroups
 
-             .filter(({ groupName }) => groupName !== self.getPositionalGroupName())
 
-             .some(({ normalizedKeys, switches }) => !normalizedKeys.every(key => isLongSwitch(switches[key])));
 
-         if (shortSwitchesUsed) {
 
-             displayedGroups
 
-                 .filter(({ groupName }) => groupName !== self.getPositionalGroupName())
 
-                 .forEach(({ normalizedKeys, switches }) => {
 
-                 normalizedKeys.forEach(key => {
 
-                     if (isLongSwitch(switches[key])) {
 
-                         switches[key] = addIndentation(switches[key], '-x, '.length);
 
-                     }
 
-                 });
 
-             });
 
-         }
 
-         displayedGroups.forEach(({ groupName, normalizedKeys, switches }) => {
 
-             ui.div(groupName);
 
-             normalizedKeys.forEach(key => {
 
-                 const kswitch = switches[key];
 
-                 let desc = descriptions[key] || '';
 
-                 let type = null;
 
-                 if (~desc.lastIndexOf(deferY18nLookupPrefix))
 
-                     desc = __(desc.substring(deferY18nLookupPrefix.length));
 
-                 if (~options.boolean.indexOf(key))
 
-                     type = `[${__('boolean')}]`;
 
-                 if (~options.count.indexOf(key))
 
-                     type = `[${__('count')}]`;
 
-                 if (~options.string.indexOf(key))
 
-                     type = `[${__('string')}]`;
 
-                 if (~options.normalize.indexOf(key))
 
-                     type = `[${__('string')}]`;
 
-                 if (~options.array.indexOf(key))
 
-                     type = `[${__('array')}]`;
 
-                 if (~options.number.indexOf(key))
 
-                     type = `[${__('number')}]`;
 
-                 const deprecatedExtra = (deprecated) => typeof deprecated === 'string'
 
-                     ? `[${__('deprecated: %s', deprecated)}]`
 
-                     : `[${__('deprecated')}]`;
 
-                 const extra = [
 
-                     key in deprecatedOptions
 
-                         ? deprecatedExtra(deprecatedOptions[key])
 
-                         : null,
 
-                     type,
 
-                     key in demandedOptions ? `[${__('required')}]` : null,
 
-                     options.choices && options.choices[key]
 
-                         ? `[${__('choices:')} ${self.stringifiedValues(options.choices[key])}]`
 
-                         : null,
 
-                     defaultString(options.default[key], options.defaultDescription[key]),
 
-                 ]
 
-                     .filter(Boolean)
 
-                     .join(' ');
 
-                 ui.span({
 
-                     text: getText(kswitch),
 
-                     padding: [0, 2, 0, 2 + getIndentation(kswitch)],
 
-                     width: maxWidth(switches, theWrap) + 4,
 
-                 }, desc);
 
-                 if (extra)
 
-                     ui.div({ text: extra, padding: [0, 0, 0, 2], align: 'right' });
 
-                 else
 
-                     ui.div();
 
-             });
 
-             ui.div();
 
-         });
 
-         if (examples.length) {
 
-             ui.div(__('Examples:'));
 
-             examples.forEach(example => {
 
-                 example[0] = example[0].replace(/\$0/g, base$0);
 
-             });
 
-             examples.forEach(example => {
 
-                 if (example[1] === '') {
 
-                     ui.div({
 
-                         text: example[0],
 
-                         padding: [0, 2, 0, 2],
 
-                     });
 
-                 }
 
-                 else {
 
-                     ui.div({
 
-                         text: example[0],
 
-                         padding: [0, 2, 0, 2],
 
-                         width: maxWidth(examples, theWrap) + 4,
 
-                     }, {
 
-                         text: example[1],
 
-                     });
 
-                 }
 
-             });
 
-             ui.div();
 
-         }
 
-         if (epilogs.length > 0) {
 
-             const e = epilogs
 
-                 .map(epilog => epilog.replace(/\$0/g, base$0))
 
-                 .join('\n');
 
-             ui.div(`${e}\n`);
 
-         }
 
-         return ui.toString().replace(/\s*$/, '');
 
-     };
 
-     function maxWidth(table, theWrap, modifier) {
 
-         let width = 0;
 
-         if (!Array.isArray(table)) {
 
-             table = Object.values(table).map(v => [v]);
 
-         }
 
-         table.forEach(v => {
 
-             width = Math.max(shim.stringWidth(modifier ? `${modifier} ${getText(v[0])}` : getText(v[0])) + getIndentation(v[0]), width);
 
-         });
 
-         if (theWrap)
 
-             width = Math.min(width, parseInt((theWrap * 0.5).toString(), 10));
 
-         return width;
 
-     }
 
-     function normalizeAliases() {
 
-         const demandedOptions = yargs.getDemandedOptions();
 
-         const options = yargs.getOptions();
 
-         (Object.keys(options.alias) || []).forEach(key => {
 
-             options.alias[key].forEach(alias => {
 
-                 if (descriptions[alias])
 
-                     self.describe(key, descriptions[alias]);
 
-                 if (alias in demandedOptions)
 
-                     yargs.demandOption(key, demandedOptions[alias]);
 
-                 if (~options.boolean.indexOf(alias))
 
-                     yargs.boolean(key);
 
-                 if (~options.count.indexOf(alias))
 
-                     yargs.count(key);
 
-                 if (~options.string.indexOf(alias))
 
-                     yargs.string(key);
 
-                 if (~options.normalize.indexOf(alias))
 
-                     yargs.normalize(key);
 
-                 if (~options.array.indexOf(alias))
 
-                     yargs.array(key);
 
-                 if (~options.number.indexOf(alias))
 
-                     yargs.number(key);
 
-             });
 
-         });
 
-     }
 
-     let cachedHelpMessage;
 
-     self.cacheHelpMessage = function () {
 
-         cachedHelpMessage = this.help();
 
-     };
 
-     self.clearCachedHelpMessage = function () {
 
-         cachedHelpMessage = undefined;
 
-     };
 
-     function addUngroupedKeys(keys, aliases, groups, defaultGroup) {
 
-         let groupedKeys = [];
 
-         let toCheck = null;
 
-         Object.keys(groups).forEach(group => {
 
-             groupedKeys = groupedKeys.concat(groups[group]);
 
-         });
 
-         keys.forEach(key => {
 
-             toCheck = [key].concat(aliases[key]);
 
-             if (!toCheck.some(k => groupedKeys.indexOf(k) !== -1)) {
 
-                 groups[defaultGroup].push(key);
 
-             }
 
-         });
 
-         return groupedKeys;
 
-     }
 
-     function filterHiddenOptions(key) {
 
-         return (yargs.getOptions().hiddenOptions.indexOf(key) < 0 ||
 
-             yargs.parsed.argv[yargs.getOptions().showHiddenOpt]);
 
-     }
 
-     self.showHelp = (level) => {
 
-         const logger = yargs._getLoggerInstance();
 
-         if (!level)
 
-             level = 'error';
 
-         const emit = typeof level === 'function' ? level : logger[level];
 
-         emit(self.help());
 
-     };
 
-     self.functionDescription = fn => {
 
-         const description = fn.name
 
-             ? shim.Parser.decamelize(fn.name, '-')
 
-             : __('generated-value');
 
-         return ['(', description, ')'].join('');
 
-     };
 
-     self.stringifiedValues = function stringifiedValues(values, separator) {
 
-         let string = '';
 
-         const sep = separator || ', ';
 
-         const array = [].concat(values);
 
-         if (!values || !array.length)
 
-             return string;
 
-         array.forEach(value => {
 
-             if (string.length)
 
-                 string += sep;
 
-             string += JSON.stringify(value);
 
-         });
 
-         return string;
 
-     };
 
-     function defaultString(value, defaultDescription) {
 
-         let string = `[${__('default:')} `;
 
-         if (value === undefined && !defaultDescription)
 
-             return null;
 
-         if (defaultDescription) {
 
-             string += defaultDescription;
 
-         }
 
-         else {
 
-             switch (typeof value) {
 
-                 case 'string':
 
-                     string += `"${value}"`;
 
-                     break;
 
-                 case 'object':
 
-                     string += JSON.stringify(value);
 
-                     break;
 
-                 default:
 
-                     string += value;
 
-             }
 
-         }
 
-         return `${string}]`;
 
-     }
 
-     function windowWidth() {
 
-         const maxWidth = 80;
 
-         if (shim.process.stdColumns) {
 
-             return Math.min(maxWidth, shim.process.stdColumns);
 
-         }
 
-         else {
 
-             return maxWidth;
 
-         }
 
-     }
 
-     let version = null;
 
-     self.version = ver => {
 
-         version = ver;
 
-     };
 
-     self.showVersion = () => {
 
-         const logger = yargs._getLoggerInstance();
 
-         logger.log(version);
 
-     };
 
-     self.reset = function reset(localLookup) {
 
-         failMessage = null;
 
-         failureOutput = false;
 
-         usages = [];
 
-         usageDisabled = false;
 
-         epilogs = [];
 
-         examples = [];
 
-         commands = [];
 
-         descriptions = objFilter(descriptions, k => !localLookup[k]);
 
-         return self;
 
-     };
 
-     const frozens = [];
 
-     self.freeze = function freeze() {
 
-         frozens.push({
 
-             failMessage,
 
-             failureOutput,
 
-             usages,
 
-             usageDisabled,
 
-             epilogs,
 
-             examples,
 
-             commands,
 
-             descriptions,
 
-         });
 
-     };
 
-     self.unfreeze = function unfreeze() {
 
-         const frozen = frozens.pop();
 
-         assertNotStrictEqual(frozen, undefined, shim);
 
-         ({
 
-             failMessage,
 
-             failureOutput,
 
-             usages,
 
-             usageDisabled,
 
-             epilogs,
 
-             examples,
 
-             commands,
 
-             descriptions,
 
-         } = frozen);
 
-     };
 
-     return self;
 
- }
 
- function isIndentedText(text) {
 
-     return typeof text === 'object';
 
- }
 
- function addIndentation(text, indent) {
 
-     return isIndentedText(text)
 
-         ? { text: text.text, indentation: text.indentation + indent }
 
-         : { text, indentation: indent };
 
- }
 
- function getIndentation(text) {
 
-     return isIndentedText(text) ? text.indentation : 0;
 
- }
 
- function getText(text) {
 
-     return isIndentedText(text) ? text.text : text;
 
- }
 
- const completionShTemplate = `###-begin-{{app_name}}-completions-###
 
- #
 
- # yargs command completion script
 
- #
 
- # Installation: {{app_path}} {{completion_command}} >> ~/.bashrc
 
- #    or {{app_path}} {{completion_command}} >> ~/.bash_profile on OSX.
 
- #
 
- _yargs_completions()
 
- {
 
-     local cur_word args type_list
 
-     cur_word="\${COMP_WORDS[COMP_CWORD]}"
 
-     args=("\${COMP_WORDS[@]}")
 
-     # ask yargs to generate completions.
 
-     type_list=$({{app_path}} --get-yargs-completions "\${args[@]}")
 
-     COMPREPLY=( $(compgen -W "\${type_list}" -- \${cur_word}) )
 
-     # if no match was found, fall back to filename completion
 
-     if [ \${#COMPREPLY[@]} -eq 0 ]; then
 
-       COMPREPLY=()
 
-     fi
 
-     return 0
 
- }
 
- complete -o default -F _yargs_completions {{app_name}}
 
- ###-end-{{app_name}}-completions-###
 
- `;
 
- const completionZshTemplate = `###-begin-{{app_name}}-completions-###
 
- #
 
- # yargs command completion script
 
- #
 
- # Installation: {{app_path}} {{completion_command}} >> ~/.zshrc
 
- #    or {{app_path}} {{completion_command}} >> ~/.zsh_profile on OSX.
 
- #
 
- _{{app_name}}_yargs_completions()
 
- {
 
-   local reply
 
-   local si=$IFS
 
-   IFS=$'\n' reply=($(COMP_CWORD="$((CURRENT-1))" COMP_LINE="$BUFFER" COMP_POINT="$CURSOR" {{app_path}} --get-yargs-completions "\${words[@]}"))
 
-   IFS=$si
 
-   _describe 'values' reply
 
- }
 
- compdef _{{app_name}}_yargs_completions {{app_name}}
 
- ###-end-{{app_name}}-completions-###
 
- `;
 
- function completion(yargs, usage, command, shim) {
 
-     const self = {
 
-         completionKey: 'get-yargs-completions',
 
-     };
 
-     let aliases;
 
-     self.setParsed = function setParsed(parsed) {
 
-         aliases = parsed.aliases;
 
-     };
 
-     const zshShell = (shim.getEnv('SHELL') && shim.getEnv('SHELL').indexOf('zsh') !== -1) ||
 
-         (shim.getEnv('ZSH_NAME') && shim.getEnv('ZSH_NAME').indexOf('zsh') !== -1);
 
-     self.getCompletion = function getCompletion(args, done) {
 
-         const completions = [];
 
-         const current = args.length ? args[args.length - 1] : '';
 
-         const argv = yargs.parse(args, true);
 
-         const parentCommands = yargs.getContext().commands;
 
-         function runCompletionFunction(argv) {
 
-             assertNotStrictEqual(completionFunction, null, shim);
 
-             if (isSyncCompletionFunction(completionFunction)) {
 
-                 const result = completionFunction(current, argv);
 
-                 if (isPromise(result)) {
 
-                     return result
 
-                         .then(list => {
 
-                         shim.process.nextTick(() => {
 
-                             done(list);
 
-                         });
 
-                     })
 
-                         .catch(err => {
 
-                         shim.process.nextTick(() => {
 
-                             throw err;
 
-                         });
 
-                     });
 
-                 }
 
-                 return done(result);
 
-             }
 
-             else {
 
-                 return completionFunction(current, argv, completions => {
 
-                     done(completions);
 
-                 });
 
-             }
 
-         }
 
-         if (completionFunction) {
 
-             return isPromise(argv)
 
-                 ? argv.then(runCompletionFunction)
 
-                 : runCompletionFunction(argv);
 
-         }
 
-         const handlers = command.getCommandHandlers();
 
-         for (let i = 0, ii = args.length; i < ii; ++i) {
 
-             if (handlers[args[i]] && handlers[args[i]].builder) {
 
-                 const builder = handlers[args[i]].builder;
 
-                 if (isCommandBuilderCallback(builder)) {
 
-                     const y = yargs.reset();
 
-                     builder(y);
 
-                     return y.argv;
 
-                 }
 
-             }
 
-         }
 
-         if (!current.match(/^-/) &&
 
-             parentCommands[parentCommands.length - 1] !== current) {
 
-             usage.getCommands().forEach(usageCommand => {
 
-                 const commandName = parseCommand(usageCommand[0]).cmd;
 
-                 if (args.indexOf(commandName) === -1) {
 
-                     if (!zshShell) {
 
-                         completions.push(commandName);
 
-                     }
 
-                     else {
 
-                         const desc = usageCommand[1] || '';
 
-                         completions.push(commandName.replace(/:/g, '\\:') + ':' + desc);
 
-                     }
 
-                 }
 
-             });
 
-         }
 
-         if (current.match(/^-/) || (current === '' && completions.length === 0)) {
 
-             const descs = usage.getDescriptions();
 
-             const options = yargs.getOptions();
 
-             Object.keys(options.key).forEach(key => {
 
-                 const negable = !!options.configuration['boolean-negation'] &&
 
-                     options.boolean.includes(key);
 
-                 let keyAndAliases = [key].concat(aliases[key] || []);
 
-                 if (negable)
 
-                     keyAndAliases = keyAndAliases.concat(keyAndAliases.map(key => `no-${key}`));
 
-                 function completeOptionKey(key) {
 
-                     const notInArgs = keyAndAliases.every(val => args.indexOf(`--${val}`) === -1);
 
-                     if (notInArgs) {
 
-                         const startsByTwoDashes = (s) => /^--/.test(s);
 
-                         const isShortOption = (s) => /^[^0-9]$/.test(s);
 
-                         const dashes = !startsByTwoDashes(current) && isShortOption(key) ? '-' : '--';
 
-                         if (!zshShell) {
 
-                             completions.push(dashes + key);
 
-                         }
 
-                         else {
 
-                             const desc = descs[key] || '';
 
-                             completions.push(dashes +
 
-                                 `${key.replace(/:/g, '\\:')}:${desc.replace('__yargsString__:', '')}`);
 
-                         }
 
-                     }
 
-                 }
 
-                 completeOptionKey(key);
 
-                 if (negable && !!options.default[key])
 
-                     completeOptionKey(`no-${key}`);
 
-             });
 
-         }
 
-         done(completions);
 
-     };
 
-     self.generateCompletionScript = function generateCompletionScript($0, cmd) {
 
-         let script = zshShell
 
-             ? completionZshTemplate
 
-             : completionShTemplate;
 
-         const name = shim.path.basename($0);
 
-         if ($0.match(/\.js$/))
 
-             $0 = `./${$0}`;
 
-         script = script.replace(/{{app_name}}/g, name);
 
-         script = script.replace(/{{completion_command}}/g, cmd);
 
-         return script.replace(/{{app_path}}/g, $0);
 
-     };
 
-     let completionFunction = null;
 
-     self.registerFunction = fn => {
 
-         completionFunction = fn;
 
-     };
 
-     return self;
 
- }
 
- function isSyncCompletionFunction(completionFunction) {
 
-     return completionFunction.length < 3;
 
- }
 
- function levenshtein(a, b) {
 
-     if (a.length === 0)
 
-         return b.length;
 
-     if (b.length === 0)
 
-         return a.length;
 
-     const matrix = [];
 
-     let i;
 
-     for (i = 0; i <= b.length; i++) {
 
-         matrix[i] = [i];
 
-     }
 
-     let j;
 
-     for (j = 0; j <= a.length; j++) {
 
-         matrix[0][j] = j;
 
-     }
 
-     for (i = 1; i <= b.length; i++) {
 
-         for (j = 1; j <= a.length; j++) {
 
-             if (b.charAt(i - 1) === a.charAt(j - 1)) {
 
-                 matrix[i][j] = matrix[i - 1][j - 1];
 
-             }
 
-             else {
 
-                 matrix[i][j] = Math.min(matrix[i - 1][j - 1] + 1, Math.min(matrix[i][j - 1] + 1, matrix[i - 1][j] + 1));
 
-             }
 
-         }
 
-     }
 
-     return matrix[b.length][a.length];
 
- }
 
- const specialKeys = ['$0', '--', '_'];
 
- function validation(yargs, usage, y18n, shim) {
 
-     const __ = y18n.__;
 
-     const __n = y18n.__n;
 
-     const self = {};
 
-     self.nonOptionCount = function nonOptionCount(argv) {
 
-         const demandedCommands = yargs.getDemandedCommands();
 
-         const positionalCount = argv._.length + (argv['--'] ? argv['--'].length : 0);
 
-         const _s = positionalCount - yargs.getContext().commands.length;
 
-         if (demandedCommands._ &&
 
-             (_s < demandedCommands._.min || _s > demandedCommands._.max)) {
 
-             if (_s < demandedCommands._.min) {
 
-                 if (demandedCommands._.minMsg !== undefined) {
 
-                     usage.fail(demandedCommands._.minMsg
 
-                         ? demandedCommands._.minMsg
 
-                             .replace(/\$0/g, _s.toString())
 
-                             .replace(/\$1/, demandedCommands._.min.toString())
 
-                         : null);
 
-                 }
 
-                 else {
 
-                     usage.fail(__n('Not enough non-option arguments: got %s, need at least %s', 'Not enough non-option arguments: got %s, need at least %s', _s, _s.toString(), demandedCommands._.min.toString()));
 
-                 }
 
-             }
 
-             else if (_s > demandedCommands._.max) {
 
-                 if (demandedCommands._.maxMsg !== undefined) {
 
-                     usage.fail(demandedCommands._.maxMsg
 
-                         ? demandedCommands._.maxMsg
 
-                             .replace(/\$0/g, _s.toString())
 
-                             .replace(/\$1/, demandedCommands._.max.toString())
 
-                         : null);
 
-                 }
 
-                 else {
 
-                     usage.fail(__n('Too many non-option arguments: got %s, maximum of %s', 'Too many non-option arguments: got %s, maximum of %s', _s, _s.toString(), demandedCommands._.max.toString()));
 
-                 }
 
-             }
 
-         }
 
-     };
 
-     self.positionalCount = function positionalCount(required, observed) {
 
-         if (observed < required) {
 
-             usage.fail(__n('Not enough non-option arguments: got %s, need at least %s', 'Not enough non-option arguments: got %s, need at least %s', observed, observed + '', required + ''));
 
-         }
 
-     };
 
-     self.requiredArguments = function requiredArguments(argv) {
 
-         const demandedOptions = yargs.getDemandedOptions();
 
-         let missing = null;
 
-         for (const key of Object.keys(demandedOptions)) {
 
-             if (!Object.prototype.hasOwnProperty.call(argv, key) ||
 
-                 typeof argv[key] === 'undefined') {
 
-                 missing = missing || {};
 
-                 missing[key] = demandedOptions[key];
 
-             }
 
-         }
 
-         if (missing) {
 
-             const customMsgs = [];
 
-             for (const key of Object.keys(missing)) {
 
-                 const msg = missing[key];
 
-                 if (msg && customMsgs.indexOf(msg) < 0) {
 
-                     customMsgs.push(msg);
 
-                 }
 
-             }
 
-             const customMsg = customMsgs.length ? `\n${customMsgs.join('\n')}` : '';
 
-             usage.fail(__n('Missing required argument: %s', 'Missing required arguments: %s', Object.keys(missing).length, Object.keys(missing).join(', ') + customMsg));
 
-         }
 
-     };
 
-     self.unknownArguments = function unknownArguments(argv, aliases, positionalMap, isDefaultCommand, checkPositionals = true) {
 
-         const commandKeys = yargs.getCommandInstance().getCommands();
 
-         const unknown = [];
 
-         const currentContext = yargs.getContext();
 
-         Object.keys(argv).forEach(key => {
 
-             if (specialKeys.indexOf(key) === -1 &&
 
-                 !Object.prototype.hasOwnProperty.call(positionalMap, key) &&
 
-                 !Object.prototype.hasOwnProperty.call(yargs._getParseContext(), key) &&
 
-                 !self.isValidAndSomeAliasIsNotNew(key, aliases)) {
 
-                 unknown.push(key);
 
-             }
 
-         });
 
-         if (checkPositionals &&
 
-             (currentContext.commands.length > 0 ||
 
-                 commandKeys.length > 0 ||
 
-                 isDefaultCommand)) {
 
-             argv._.slice(currentContext.commands.length).forEach(key => {
 
-                 if (commandKeys.indexOf('' + key) === -1) {
 
-                     unknown.push('' + key);
 
-                 }
 
-             });
 
-         }
 
-         if (unknown.length > 0) {
 
-             usage.fail(__n('Unknown argument: %s', 'Unknown arguments: %s', unknown.length, unknown.join(', ')));
 
-         }
 
-     };
 
-     self.unknownCommands = function unknownCommands(argv) {
 
-         const commandKeys = yargs.getCommandInstance().getCommands();
 
-         const unknown = [];
 
-         const currentContext = yargs.getContext();
 
-         if (currentContext.commands.length > 0 || commandKeys.length > 0) {
 
-             argv._.slice(currentContext.commands.length).forEach(key => {
 
-                 if (commandKeys.indexOf('' + key) === -1) {
 
-                     unknown.push('' + key);
 
-                 }
 
-             });
 
-         }
 
-         if (unknown.length > 0) {
 
-             usage.fail(__n('Unknown command: %s', 'Unknown commands: %s', unknown.length, unknown.join(', ')));
 
-             return true;
 
-         }
 
-         else {
 
-             return false;
 
-         }
 
-     };
 
-     self.isValidAndSomeAliasIsNotNew = function isValidAndSomeAliasIsNotNew(key, aliases) {
 
-         if (!Object.prototype.hasOwnProperty.call(aliases, key)) {
 
-             return false;
 
-         }
 
-         const newAliases = yargs.parsed.newAliases;
 
-         for (const a of [key, ...aliases[key]]) {
 
-             if (!Object.prototype.hasOwnProperty.call(newAliases, a) ||
 
-                 !newAliases[key]) {
 
-                 return true;
 
-             }
 
-         }
 
-         return false;
 
-     };
 
-     self.limitedChoices = function limitedChoices(argv) {
 
-         const options = yargs.getOptions();
 
-         const invalid = {};
 
-         if (!Object.keys(options.choices).length)
 
-             return;
 
-         Object.keys(argv).forEach(key => {
 
-             if (specialKeys.indexOf(key) === -1 &&
 
-                 Object.prototype.hasOwnProperty.call(options.choices, key)) {
 
-                 [].concat(argv[key]).forEach(value => {
 
-                     if (options.choices[key].indexOf(value) === -1 &&
 
-                         value !== undefined) {
 
-                         invalid[key] = (invalid[key] || []).concat(value);
 
-                     }
 
-                 });
 
-             }
 
-         });
 
-         const invalidKeys = Object.keys(invalid);
 
-         if (!invalidKeys.length)
 
-             return;
 
-         let msg = __('Invalid values:');
 
-         invalidKeys.forEach(key => {
 
-             msg += `\n  ${__('Argument: %s, Given: %s, Choices: %s', key, usage.stringifiedValues(invalid[key]), usage.stringifiedValues(options.choices[key]))}`;
 
-         });
 
-         usage.fail(msg);
 
-     };
 
-     let checks = [];
 
-     self.check = function check(f, global) {
 
-         checks.push({
 
-             func: f,
 
-             global,
 
-         });
 
-     };
 
-     self.customChecks = function customChecks(argv, aliases) {
 
-         for (let i = 0, f; (f = checks[i]) !== undefined; i++) {
 
-             const func = f.func;
 
-             let result = null;
 
-             try {
 
-                 result = func(argv, aliases);
 
-             }
 
-             catch (err) {
 
-                 usage.fail(err.message ? err.message : err, err);
 
-                 continue;
 
-             }
 
-             if (!result) {
 
-                 usage.fail(__('Argument check failed: %s', func.toString()));
 
-             }
 
-             else if (typeof result === 'string' || result instanceof Error) {
 
-                 usage.fail(result.toString(), result);
 
-             }
 
-         }
 
-     };
 
-     let implied = {};
 
-     self.implies = function implies(key, value) {
 
-         argsert('<string|object> [array|number|string]', [key, value], arguments.length);
 
-         if (typeof key === 'object') {
 
-             Object.keys(key).forEach(k => {
 
-                 self.implies(k, key[k]);
 
-             });
 
-         }
 
-         else {
 
-             yargs.global(key);
 
-             if (!implied[key]) {
 
-                 implied[key] = [];
 
-             }
 
-             if (Array.isArray(value)) {
 
-                 value.forEach(i => self.implies(key, i));
 
-             }
 
-             else {
 
-                 assertNotStrictEqual(value, undefined, shim);
 
-                 implied[key].push(value);
 
-             }
 
-         }
 
-     };
 
-     self.getImplied = function getImplied() {
 
-         return implied;
 
-     };
 
-     function keyExists(argv, val) {
 
-         const num = Number(val);
 
-         val = isNaN(num) ? val : num;
 
-         if (typeof val === 'number') {
 
-             val = argv._.length >= val;
 
-         }
 
-         else if (val.match(/^--no-.+/)) {
 
-             val = val.match(/^--no-(.+)/)[1];
 
-             val = !argv[val];
 
-         }
 
-         else {
 
-             val = argv[val];
 
-         }
 
-         return val;
 
-     }
 
-     self.implications = function implications(argv) {
 
-         const implyFail = [];
 
-         Object.keys(implied).forEach(key => {
 
-             const origKey = key;
 
-             (implied[key] || []).forEach(value => {
 
-                 let key = origKey;
 
-                 const origValue = value;
 
-                 key = keyExists(argv, key);
 
-                 value = keyExists(argv, value);
 
-                 if (key && !value) {
 
-                     implyFail.push(` ${origKey} -> ${origValue}`);
 
-                 }
 
-             });
 
-         });
 
-         if (implyFail.length) {
 
-             let msg = `${__('Implications failed:')}\n`;
 
-             implyFail.forEach(value => {
 
-                 msg += value;
 
-             });
 
-             usage.fail(msg);
 
-         }
 
-     };
 
-     let conflicting = {};
 
-     self.conflicts = function conflicts(key, value) {
 
-         argsert('<string|object> [array|string]', [key, value], arguments.length);
 
-         if (typeof key === 'object') {
 
-             Object.keys(key).forEach(k => {
 
-                 self.conflicts(k, key[k]);
 
-             });
 
-         }
 
-         else {
 
-             yargs.global(key);
 
-             if (!conflicting[key]) {
 
-                 conflicting[key] = [];
 
-             }
 
-             if (Array.isArray(value)) {
 
-                 value.forEach(i => self.conflicts(key, i));
 
-             }
 
-             else {
 
-                 conflicting[key].push(value);
 
-             }
 
-         }
 
-     };
 
-     self.getConflicting = () => conflicting;
 
-     self.conflicting = function conflictingFn(argv) {
 
-         Object.keys(argv).forEach(key => {
 
-             if (conflicting[key]) {
 
-                 conflicting[key].forEach(value => {
 
-                     if (value && argv[key] !== undefined && argv[value] !== undefined) {
 
-                         usage.fail(__('Arguments %s and %s are mutually exclusive', key, value));
 
-                     }
 
-                 });
 
-             }
 
-         });
 
-     };
 
-     self.recommendCommands = function recommendCommands(cmd, potentialCommands) {
 
-         const threshold = 3;
 
-         potentialCommands = potentialCommands.sort((a, b) => b.length - a.length);
 
-         let recommended = null;
 
-         let bestDistance = Infinity;
 
-         for (let i = 0, candidate; (candidate = potentialCommands[i]) !== undefined; i++) {
 
-             const d = levenshtein(cmd, candidate);
 
-             if (d <= threshold && d < bestDistance) {
 
-                 bestDistance = d;
 
-                 recommended = candidate;
 
-             }
 
-         }
 
-         if (recommended)
 
-             usage.fail(__('Did you mean %s?', recommended));
 
-     };
 
-     self.reset = function reset(localLookup) {
 
-         implied = objFilter(implied, k => !localLookup[k]);
 
-         conflicting = objFilter(conflicting, k => !localLookup[k]);
 
-         checks = checks.filter(c => c.global);
 
-         return self;
 
-     };
 
-     const frozens = [];
 
-     self.freeze = function freeze() {
 
-         frozens.push({
 
-             implied,
 
-             checks,
 
-             conflicting,
 
-         });
 
-     };
 
-     self.unfreeze = function unfreeze() {
 
-         const frozen = frozens.pop();
 
-         assertNotStrictEqual(frozen, undefined, shim);
 
-         ({ implied, checks, conflicting } = frozen);
 
-     };
 
-     return self;
 
- }
 
- let shim$1;
 
- function YargsWithShim(_shim) {
 
-     shim$1 = _shim;
 
-     return Yargs;
 
- }
 
- function Yargs(processArgs = [], cwd = shim$1.process.cwd(), parentRequire) {
 
-     const self = {};
 
-     let command$1;
 
-     let completion$1 = null;
 
-     let groups = {};
 
-     const globalMiddleware = [];
 
-     let output = '';
 
-     const preservedGroups = {};
 
-     let usage$1;
 
-     let validation$1;
 
-     let handlerFinishCommand = null;
 
-     const y18n = shim$1.y18n;
 
-     self.middleware = globalMiddlewareFactory(globalMiddleware, self);
 
-     self.scriptName = function (scriptName) {
 
-         self.customScriptName = true;
 
-         self.$0 = scriptName;
 
-         return self;
 
-     };
 
-     let default$0;
 
-     if (/\b(node|iojs|electron)(\.exe)?$/.test(shim$1.process.argv()[0])) {
 
-         default$0 = shim$1.process.argv().slice(1, 2);
 
-     }
 
-     else {
 
-         default$0 = shim$1.process.argv().slice(0, 1);
 
-     }
 
-     self.$0 = default$0
 
-         .map(x => {
 
-         const b = rebase(cwd, x);
 
-         return x.match(/^(\/|([a-zA-Z]:)?\\)/) && b.length < x.length ? b : x;
 
-     })
 
-         .join(' ')
 
-         .trim();
 
-     if (shim$1.getEnv('_') && shim$1.getProcessArgvBin() === shim$1.getEnv('_')) {
 
-         self.$0 = shim$1
 
-             .getEnv('_')
 
-             .replace(`${shim$1.path.dirname(shim$1.process.execPath())}/`, '');
 
-     }
 
-     const context = { resets: -1, commands: [], fullCommands: [], files: [] };
 
-     self.getContext = () => context;
 
-     let hasOutput = false;
 
-     let exitError = null;
 
-     self.exit = (code, err) => {
 
-         hasOutput = true;
 
-         exitError = err;
 
-         if (exitProcess)
 
-             shim$1.process.exit(code);
 
-     };
 
-     let completionCommand = null;
 
-     self.completion = function (cmd, desc, fn) {
 
-         argsert('[string] [string|boolean|function] [function]', [cmd, desc, fn], arguments.length);
 
-         if (typeof desc === 'function') {
 
-             fn = desc;
 
-             desc = undefined;
 
-         }
 
-         completionCommand = cmd || completionCommand || 'completion';
 
-         if (!desc && desc !== false) {
 
-             desc = 'generate completion script';
 
-         }
 
-         self.command(completionCommand, desc);
 
-         if (fn)
 
-             completion$1.registerFunction(fn);
 
-         return self;
 
-     };
 
-     let options;
 
-     self.resetOptions = self.reset = function resetOptions(aliases = {}) {
 
-         context.resets++;
 
-         options = options || {};
 
-         const tmpOptions = {};
 
-         tmpOptions.local = options.local ? options.local : [];
 
-         tmpOptions.configObjects = options.configObjects
 
-             ? options.configObjects
 
-             : [];
 
-         const localLookup = {};
 
-         tmpOptions.local.forEach(l => {
 
-             localLookup[l] = true;
 
-             (aliases[l] || []).forEach(a => {
 
-                 localLookup[a] = true;
 
-             });
 
-         });
 
-         Object.assign(preservedGroups, Object.keys(groups).reduce((acc, groupName) => {
 
-             const keys = groups[groupName].filter(key => !(key in localLookup));
 
-             if (keys.length > 0) {
 
-                 acc[groupName] = keys;
 
-             }
 
-             return acc;
 
-         }, {}));
 
-         groups = {};
 
-         const arrayOptions = [
 
-             'array',
 
-             'boolean',
 
-             'string',
 
-             'skipValidation',
 
-             'count',
 
-             'normalize',
 
-             'number',
 
-             'hiddenOptions',
 
-         ];
 
-         const objectOptions = [
 
-             'narg',
 
-             'key',
 
-             'alias',
 
-             'default',
 
-             'defaultDescription',
 
-             'config',
 
-             'choices',
 
-             'demandedOptions',
 
-             'demandedCommands',
 
-             'coerce',
 
-             'deprecatedOptions',
 
-         ];
 
-         arrayOptions.forEach(k => {
 
-             tmpOptions[k] = (options[k] || []).filter((k) => !localLookup[k]);
 
-         });
 
-         objectOptions.forEach((k) => {
 
-             tmpOptions[k] = objFilter(options[k], k => !localLookup[k]);
 
-         });
 
-         tmpOptions.envPrefix = options.envPrefix;
 
-         options = tmpOptions;
 
-         usage$1 = usage$1 ? usage$1.reset(localLookup) : usage(self, y18n, shim$1);
 
-         validation$1 = validation$1
 
-             ? validation$1.reset(localLookup)
 
-             : validation(self, usage$1, y18n, shim$1);
 
-         command$1 = command$1
 
-             ? command$1.reset()
 
-             : command(self, usage$1, validation$1, globalMiddleware, shim$1);
 
-         if (!completion$1)
 
-             completion$1 = completion(self, usage$1, command$1, shim$1);
 
-         completionCommand = null;
 
-         output = '';
 
-         exitError = null;
 
-         hasOutput = false;
 
-         self.parsed = false;
 
-         return self;
 
-     };
 
-     self.resetOptions();
 
-     const frozens = [];
 
-     function freeze() {
 
-         frozens.push({
 
-             options,
 
-             configObjects: options.configObjects.slice(0),
 
-             exitProcess,
 
-             groups,
 
-             strict,
 
-             strictCommands,
 
-             strictOptions,
 
-             completionCommand,
 
-             output,
 
-             exitError,
 
-             hasOutput,
 
-             parsed: self.parsed,
 
-             parseFn,
 
-             parseContext,
 
-             handlerFinishCommand,
 
-         });
 
-         usage$1.freeze();
 
-         validation$1.freeze();
 
-         command$1.freeze();
 
-     }
 
-     function unfreeze() {
 
-         const frozen = frozens.pop();
 
-         assertNotStrictEqual(frozen, undefined, shim$1);
 
-         let configObjects;
 
-         ({
 
-             options,
 
-             configObjects,
 
-             exitProcess,
 
-             groups,
 
-             output,
 
-             exitError,
 
-             hasOutput,
 
-             parsed: self.parsed,
 
-             strict,
 
-             strictCommands,
 
-             strictOptions,
 
-             completionCommand,
 
-             parseFn,
 
-             parseContext,
 
-             handlerFinishCommand,
 
-         } = frozen);
 
-         options.configObjects = configObjects;
 
-         usage$1.unfreeze();
 
-         validation$1.unfreeze();
 
-         command$1.unfreeze();
 
-     }
 
-     self.boolean = function (keys) {
 
-         argsert('<array|string>', [keys], arguments.length);
 
-         populateParserHintArray('boolean', keys);
 
-         return self;
 
-     };
 
-     self.array = function (keys) {
 
-         argsert('<array|string>', [keys], arguments.length);
 
-         populateParserHintArray('array', keys);
 
-         return self;
 
-     };
 
-     self.number = function (keys) {
 
-         argsert('<array|string>', [keys], arguments.length);
 
-         populateParserHintArray('number', keys);
 
-         return self;
 
-     };
 
-     self.normalize = function (keys) {
 
-         argsert('<array|string>', [keys], arguments.length);
 
-         populateParserHintArray('normalize', keys);
 
-         return self;
 
-     };
 
-     self.count = function (keys) {
 
-         argsert('<array|string>', [keys], arguments.length);
 
-         populateParserHintArray('count', keys);
 
-         return self;
 
-     };
 
-     self.string = function (keys) {
 
-         argsert('<array|string>', [keys], arguments.length);
 
-         populateParserHintArray('string', keys);
 
-         return self;
 
-     };
 
-     self.requiresArg = function (keys) {
 
-         argsert('<array|string|object> [number]', [keys], arguments.length);
 
-         if (typeof keys === 'string' && options.narg[keys]) {
 
-             return self;
 
-         }
 
-         else {
 
-             populateParserHintSingleValueDictionary(self.requiresArg, 'narg', keys, NaN);
 
-         }
 
-         return self;
 
-     };
 
-     self.skipValidation = function (keys) {
 
-         argsert('<array|string>', [keys], arguments.length);
 
-         populateParserHintArray('skipValidation', keys);
 
-         return self;
 
-     };
 
-     function populateParserHintArray(type, keys) {
 
-         keys = [].concat(keys);
 
-         keys.forEach(key => {
 
-             key = sanitizeKey(key);
 
-             options[type].push(key);
 
-         });
 
-     }
 
-     self.nargs = function (key, value) {
 
-         argsert('<string|object|array> [number]', [key, value], arguments.length);
 
-         populateParserHintSingleValueDictionary(self.nargs, 'narg', key, value);
 
-         return self;
 
-     };
 
-     self.choices = function (key, value) {
 
-         argsert('<object|string|array> [string|array]', [key, value], arguments.length);
 
-         populateParserHintArrayDictionary(self.choices, 'choices', key, value);
 
-         return self;
 
-     };
 
-     self.alias = function (key, value) {
 
-         argsert('<object|string|array> [string|array]', [key, value], arguments.length);
 
-         populateParserHintArrayDictionary(self.alias, 'alias', key, value);
 
-         return self;
 
-     };
 
-     self.default = self.defaults = function (key, value, defaultDescription) {
 
-         argsert('<object|string|array> [*] [string]', [key, value, defaultDescription], arguments.length);
 
-         if (defaultDescription) {
 
-             assertSingleKey(key, shim$1);
 
-             options.defaultDescription[key] = defaultDescription;
 
-         }
 
-         if (typeof value === 'function') {
 
-             assertSingleKey(key, shim$1);
 
-             if (!options.defaultDescription[key])
 
-                 options.defaultDescription[key] = usage$1.functionDescription(value);
 
-             value = value.call();
 
-         }
 
-         populateParserHintSingleValueDictionary(self.default, 'default', key, value);
 
-         return self;
 
-     };
 
-     self.describe = function (key, desc) {
 
-         argsert('<object|string|array> [string]', [key, desc], arguments.length);
 
-         setKey(key, true);
 
-         usage$1.describe(key, desc);
 
-         return self;
 
-     };
 
-     function setKey(key, set) {
 
-         populateParserHintSingleValueDictionary(setKey, 'key', key, set);
 
-         return self;
 
-     }
 
-     function demandOption(keys, msg) {
 
-         argsert('<object|string|array> [string]', [keys, msg], arguments.length);
 
-         populateParserHintSingleValueDictionary(self.demandOption, 'demandedOptions', keys, msg);
 
-         return self;
 
-     }
 
-     self.demandOption = demandOption;
 
-     self.coerce = function (keys, value) {
 
-         argsert('<object|string|array> [function]', [keys, value], arguments.length);
 
-         populateParserHintSingleValueDictionary(self.coerce, 'coerce', keys, value);
 
-         return self;
 
-     };
 
-     function populateParserHintSingleValueDictionary(builder, type, key, value) {
 
-         populateParserHintDictionary(builder, type, key, value, (type, key, value) => {
 
-             options[type][key] = value;
 
-         });
 
-     }
 
-     function populateParserHintArrayDictionary(builder, type, key, value) {
 
-         populateParserHintDictionary(builder, type, key, value, (type, key, value) => {
 
-             options[type][key] = (options[type][key] || []).concat(value);
 
-         });
 
-     }
 
-     function populateParserHintDictionary(builder, type, key, value, singleKeyHandler) {
 
-         if (Array.isArray(key)) {
 
-             key.forEach(k => {
 
-                 builder(k, value);
 
-             });
 
-         }
 
-         else if (((key) => typeof key === 'object')(key)) {
 
-             for (const k of objectKeys(key)) {
 
-                 builder(k, key[k]);
 
-             }
 
-         }
 
-         else {
 
-             singleKeyHandler(type, sanitizeKey(key), value);
 
-         }
 
-     }
 
-     function sanitizeKey(key) {
 
-         if (key === '__proto__')
 
-             return '___proto___';
 
-         return key;
 
-     }
 
-     function deleteFromParserHintObject(optionKey) {
 
-         objectKeys(options).forEach((hintKey) => {
 
-             if (((key) => key === 'configObjects')(hintKey))
 
-                 return;
 
-             const hint = options[hintKey];
 
-             if (Array.isArray(hint)) {
 
-                 if (~hint.indexOf(optionKey))
 
-                     hint.splice(hint.indexOf(optionKey), 1);
 
-             }
 
-             else if (typeof hint === 'object') {
 
-                 delete hint[optionKey];
 
-             }
 
-         });
 
-         delete usage$1.getDescriptions()[optionKey];
 
-     }
 
-     self.config = function 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, cwd, self.getParserConfiguration()['deep-merge-config'] || false, shim$1);
 
-             options.configObjects = (options.configObjects || []).concat(key);
 
-             return self;
 
-         }
 
-         if (typeof msg === 'function') {
 
-             parseFn = msg;
 
-             msg = undefined;
 
-         }
 
-         self.describe(key, msg || usage$1.deferY18nLookup('Path to JSON config file'));
 
-         (Array.isArray(key) ? key : [key]).forEach(k => {
 
-             options.config[k] = parseFn || true;
 
-         });
 
-         return self;
 
-     };
 
-     self.example = function (cmd, description) {
 
-         argsert('<string|array> [string]', [cmd, description], arguments.length);
 
-         if (Array.isArray(cmd)) {
 
-             cmd.forEach(exampleParams => self.example(...exampleParams));
 
-         }
 
-         else {
 
-             usage$1.example(cmd, description);
 
-         }
 
-         return self;
 
-     };
 
-     self.command = function (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);
 
-         command$1.addHandler(cmd, description, builder, handler, middlewares, deprecated);
 
-         return self;
 
-     };
 
-     self.commandDir = function (dir, opts) {
 
-         argsert('<string> [object]', [dir, opts], arguments.length);
 
-         const req = parentRequire || shim$1.require;
 
-         command$1.addDirectory(dir, self.getContext(), req, shim$1.getCallerFile(), opts);
 
-         return self;
 
-     };
 
-     self.demand = self.required = self.require = function demand(keys, max, msg) {
 
-         if (Array.isArray(max)) {
 
-             max.forEach(key => {
 
-                 assertNotStrictEqual(msg, true, shim$1);
 
-                 demandOption(key, msg);
 
-             });
 
-             max = Infinity;
 
-         }
 
-         else if (typeof max !== 'number') {
 
-             msg = max;
 
-             max = Infinity;
 
-         }
 
-         if (typeof keys === 'number') {
 
-             assertNotStrictEqual(msg, true, shim$1);
 
-             self.demandCommand(keys, max, msg, msg);
 
-         }
 
-         else if (Array.isArray(keys)) {
 
-             keys.forEach(key => {
 
-                 assertNotStrictEqual(msg, true, shim$1);
 
-                 demandOption(key, msg);
 
-             });
 
-         }
 
-         else {
 
-             if (typeof msg === 'string') {
 
-                 demandOption(keys, msg);
 
-             }
 
-             else if (msg === true || typeof msg === 'undefined') {
 
-                 demandOption(keys);
 
-             }
 
-         }
 
-         return self;
 
-     };
 
-     self.demandCommand = function 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;
 
-         }
 
-         self.global('_', false);
 
-         options.demandedCommands._ = {
 
-             min,
 
-             max,
 
-             minMsg,
 
-             maxMsg,
 
-         };
 
-         return self;
 
-     };
 
-     self.getDemandedOptions = () => {
 
-         argsert([], 0);
 
-         return options.demandedOptions;
 
-     };
 
-     self.getDemandedCommands = () => {
 
-         argsert([], 0);
 
-         return options.demandedCommands;
 
-     };
 
-     self.deprecateOption = function deprecateOption(option, message) {
 
-         argsert('<string> [string|boolean]', [option, message], arguments.length);
 
-         options.deprecatedOptions[option] = message;
 
-         return self;
 
-     };
 
-     self.getDeprecatedOptions = () => {
 
-         argsert([], 0);
 
-         return options.deprecatedOptions;
 
-     };
 
-     self.implies = function (key, value) {
 
-         argsert('<string|object> [number|string|array]', [key, value], arguments.length);
 
-         validation$1.implies(key, value);
 
-         return self;
 
-     };
 
-     self.conflicts = function (key1, key2) {
 
-         argsert('<string|object> [string|array]', [key1, key2], arguments.length);
 
-         validation$1.conflicts(key1, key2);
 
-         return self;
 
-     };
 
-     self.usage = function (msg, description, builder, handler) {
 
-         argsert('<string|null|undefined> [string|boolean] [function|object] [function]', [msg, description, builder, handler], arguments.length);
 
-         if (description !== undefined) {
 
-             assertNotStrictEqual(msg, null, shim$1);
 
-             if ((msg || '').match(/^\$0( |$)/)) {
 
-                 return self.command(msg, description, builder, handler);
 
-             }
 
-             else {
 
-                 throw new YError('.usage() description must start with $0 if being used as alias for .command()');
 
-             }
 
-         }
 
-         else {
 
-             usage$1.usage(msg);
 
-             return self;
 
-         }
 
-     };
 
-     self.epilogue = self.epilog = function (msg) {
 
-         argsert('<string>', [msg], arguments.length);
 
-         usage$1.epilog(msg);
 
-         return self;
 
-     };
 
-     self.fail = function (f) {
 
-         argsert('<function>', [f], arguments.length);
 
-         usage$1.failFn(f);
 
-         return self;
 
-     };
 
-     self.onFinishCommand = function (f) {
 
-         argsert('<function>', [f], arguments.length);
 
-         handlerFinishCommand = f;
 
-         return self;
 
-     };
 
-     self.getHandlerFinishCommand = () => handlerFinishCommand;
 
-     self.check = function (f, _global) {
 
-         argsert('<function> [boolean]', [f, _global], arguments.length);
 
-         validation$1.check(f, _global !== false);
 
-         return self;
 
-     };
 
-     self.global = function global(globals, global) {
 
-         argsert('<string|array> [boolean]', [globals, global], arguments.length);
 
-         globals = [].concat(globals);
 
-         if (global !== false) {
 
-             options.local = options.local.filter(l => globals.indexOf(l) === -1);
 
-         }
 
-         else {
 
-             globals.forEach(g => {
 
-                 if (options.local.indexOf(g) === -1)
 
-                     options.local.push(g);
 
-             });
 
-         }
 
-         return self;
 
-     };
 
-     self.pkgConf = function pkgConf(key, rootPath) {
 
-         argsert('<string> [string]', [key, rootPath], arguments.length);
 
-         let conf = null;
 
-         const obj = pkgUp(rootPath || cwd);
 
-         if (obj[key] && typeof obj[key] === 'object') {
 
-             conf = applyExtends(obj[key], rootPath || cwd, self.getParserConfiguration()['deep-merge-config'] || false, shim$1);
 
-             options.configObjects = (options.configObjects || []).concat(conf);
 
-         }
 
-         return self;
 
-     };
 
-     const pkgs = {};
 
-     function pkgUp(rootPath) {
 
-         const npath = rootPath || '*';
 
-         if (pkgs[npath])
 
-             return pkgs[npath];
 
-         let obj = {};
 
-         try {
 
-             let startDir = rootPath || shim$1.mainFilename;
 
-             if (!rootPath && shim$1.path.extname(startDir)) {
 
-                 startDir = shim$1.path.dirname(startDir);
 
-             }
 
-             const pkgJsonPath = shim$1.findUp(startDir, (dir, names) => {
 
-                 if (names.includes('package.json')) {
 
-                     return 'package.json';
 
-                 }
 
-                 else {
 
-                     return undefined;
 
-                 }
 
-             });
 
-             assertNotStrictEqual(pkgJsonPath, undefined, shim$1);
 
-             obj = JSON.parse(shim$1.readFileSync(pkgJsonPath, 'utf8'));
 
-         }
 
-         catch (_noop) { }
 
-         pkgs[npath] = obj || {};
 
-         return pkgs[npath];
 
-     }
 
-     let parseFn = null;
 
-     let parseContext = null;
 
-     self.parse = function parse(args, shortCircuit, _parseFn) {
 
-         argsert('[string|array] [function|boolean|object] [function]', [args, shortCircuit, _parseFn], arguments.length);
 
-         freeze();
 
-         if (typeof args === 'undefined') {
 
-             const argv = self._parseArgs(processArgs);
 
-             const tmpParsed = self.parsed;
 
-             unfreeze();
 
-             self.parsed = tmpParsed;
 
-             return argv;
 
-         }
 
-         if (typeof shortCircuit === 'object') {
 
-             parseContext = shortCircuit;
 
-             shortCircuit = _parseFn;
 
-         }
 
-         if (typeof shortCircuit === 'function') {
 
-             parseFn = shortCircuit;
 
-             shortCircuit = false;
 
-         }
 
-         if (!shortCircuit)
 
-             processArgs = args;
 
-         if (parseFn)
 
-             exitProcess = false;
 
-         const parsed = self._parseArgs(args, !!shortCircuit);
 
-         completion$1.setParsed(self.parsed);
 
-         if (parseFn)
 
-             parseFn(exitError, parsed, output);
 
-         unfreeze();
 
-         return parsed;
 
-     };
 
-     self._getParseContext = () => parseContext || {};
 
-     self._hasParseCallback = () => !!parseFn;
 
-     self.option = self.options = function option(key, opt) {
 
-         argsert('<string|object> [object]', [key, opt], arguments.length);
 
-         if (typeof key === 'object') {
 
-             Object.keys(key).forEach(k => {
 
-                 self.options(k, key[k]);
 
-             });
 
-         }
 
-         else {
 
-             if (typeof opt !== 'object') {
 
-                 opt = {};
 
-             }
 
-             options.key[key] = true;
 
-             if (opt.alias)
 
-                 self.alias(key, opt.alias);
 
-             const deprecate = opt.deprecate || opt.deprecated;
 
-             if (deprecate) {
 
-                 self.deprecateOption(key, deprecate);
 
-             }
 
-             const demand = opt.demand || opt.required || opt.require;
 
-             if (demand) {
 
-                 self.demand(key, demand);
 
-             }
 
-             if (opt.demandOption) {
 
-                 self.demandOption(key, typeof opt.demandOption === 'string' ? opt.demandOption : undefined);
 
-             }
 
-             if (opt.conflicts) {
 
-                 self.conflicts(key, opt.conflicts);
 
-             }
 
-             if ('default' in opt) {
 
-                 self.default(key, opt.default);
 
-             }
 
-             if (opt.implies !== undefined) {
 
-                 self.implies(key, opt.implies);
 
-             }
 
-             if (opt.nargs !== undefined) {
 
-                 self.nargs(key, opt.nargs);
 
-             }
 
-             if (opt.config) {
 
-                 self.config(key, opt.configParser);
 
-             }
 
-             if (opt.normalize) {
 
-                 self.normalize(key);
 
-             }
 
-             if (opt.choices) {
 
-                 self.choices(key, opt.choices);
 
-             }
 
-             if (opt.coerce) {
 
-                 self.coerce(key, opt.coerce);
 
-             }
 
-             if (opt.group) {
 
-                 self.group(key, opt.group);
 
-             }
 
-             if (opt.boolean || opt.type === 'boolean') {
 
-                 self.boolean(key);
 
-                 if (opt.alias)
 
-                     self.boolean(opt.alias);
 
-             }
 
-             if (opt.array || opt.type === 'array') {
 
-                 self.array(key);
 
-                 if (opt.alias)
 
-                     self.array(opt.alias);
 
-             }
 
-             if (opt.number || opt.type === 'number') {
 
-                 self.number(key);
 
-                 if (opt.alias)
 
-                     self.number(opt.alias);
 
-             }
 
-             if (opt.string || opt.type === 'string') {
 
-                 self.string(key);
 
-                 if (opt.alias)
 
-                     self.string(opt.alias);
 
-             }
 
-             if (opt.count || opt.type === 'count') {
 
-                 self.count(key);
 
-             }
 
-             if (typeof opt.global === 'boolean') {
 
-                 self.global(key, opt.global);
 
-             }
 
-             if (opt.defaultDescription) {
 
-                 options.defaultDescription[key] = opt.defaultDescription;
 
-             }
 
-             if (opt.skipValidation) {
 
-                 self.skipValidation(key);
 
-             }
 
-             const desc = opt.describe || opt.description || opt.desc;
 
-             self.describe(key, desc);
 
-             if (opt.hidden) {
 
-                 self.hide(key);
 
-             }
 
-             if (opt.requiresArg) {
 
-                 self.requiresArg(key);
 
-             }
 
-         }
 
-         return self;
 
-     };
 
-     self.getOptions = () => options;
 
-     self.positional = function (key, opts) {
 
-         argsert('<string> <object>', [key, opts], arguments.length);
 
-         if (context.resets === 0) {
 
-             throw new YError(".positional() can only be called in a command's builder function");
 
-         }
 
-         const supportedOpts = [
 
-             'default',
 
-             'defaultDescription',
 
-             'implies',
 
-             'normalize',
 
-             'choices',
 
-             'conflicts',
 
-             'coerce',
 
-             'type',
 
-             'describe',
 
-             'desc',
 
-             'description',
 
-             'alias',
 
-         ];
 
-         opts = objFilter(opts, (k, v) => {
 
-             let accept = supportedOpts.indexOf(k) !== -1;
 
-             if (k === 'type' && ['string', 'number', 'boolean'].indexOf(v) === -1)
 
-                 accept = false;
 
-             return accept;
 
-         });
 
-         const fullCommand = context.fullCommands[context.fullCommands.length - 1];
 
-         const parseOptions = fullCommand
 
-             ? command$1.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];
 
-             }
 
-         });
 
-         self.group(key, usage$1.getPositionalGroupName());
 
-         return self.option(key, opts);
 
-     };
 
-     self.group = function group(opts, groupName) {
 
-         argsert('<string|array> <string>', [opts, groupName], arguments.length);
 
-         const existing = preservedGroups[groupName] || groups[groupName];
 
-         if (preservedGroups[groupName]) {
 
-             delete preservedGroups[groupName];
 
-         }
 
-         const seen = {};
 
-         groups[groupName] = (existing || []).concat(opts).filter(key => {
 
-             if (seen[key])
 
-                 return false;
 
-             return (seen[key] = true);
 
-         });
 
-         return self;
 
-     };
 
-     self.getGroups = () => Object.assign({}, groups, preservedGroups);
 
-     self.env = function (prefix) {
 
-         argsert('[string|boolean]', [prefix], arguments.length);
 
-         if (prefix === false)
 
-             delete options.envPrefix;
 
-         else
 
-             options.envPrefix = prefix || '';
 
-         return self;
 
-     };
 
-     self.wrap = function (cols) {
 
-         argsert('<number|null|undefined>', [cols], arguments.length);
 
-         usage$1.wrap(cols);
 
-         return self;
 
-     };
 
-     let strict = false;
 
-     self.strict = function (enabled) {
 
-         argsert('[boolean]', [enabled], arguments.length);
 
-         strict = enabled !== false;
 
-         return self;
 
-     };
 
-     self.getStrict = () => strict;
 
-     let strictCommands = false;
 
-     self.strictCommands = function (enabled) {
 
-         argsert('[boolean]', [enabled], arguments.length);
 
-         strictCommands = enabled !== false;
 
-         return self;
 
-     };
 
-     self.getStrictCommands = () => strictCommands;
 
-     let strictOptions = false;
 
-     self.strictOptions = function (enabled) {
 
-         argsert('[boolean]', [enabled], arguments.length);
 
-         strictOptions = enabled !== false;
 
-         return self;
 
-     };
 
-     self.getStrictOptions = () => strictOptions;
 
-     let parserConfig = {};
 
-     self.parserConfiguration = function parserConfiguration(config) {
 
-         argsert('<object>', [config], arguments.length);
 
-         parserConfig = config;
 
-         return self;
 
-     };
 
-     self.getParserConfiguration = () => parserConfig;
 
-     self.showHelp = function (level) {
 
-         argsert('[string|function]', [level], arguments.length);
 
-         if (!self.parsed)
 
-             self._parseArgs(processArgs);
 
-         if (command$1.hasDefaultCommand()) {
 
-             context.resets++;
 
-             command$1.runDefaultBuilderOn(self);
 
-         }
 
-         usage$1.showHelp(level);
 
-         return self;
 
-     };
 
-     let versionOpt = null;
 
-     self.version = function version(opt, msg, ver) {
 
-         const defaultVersionOpt = 'version';
 
-         argsert('[boolean|string] [string] [string]', [opt, msg, ver], arguments.length);
 
-         if (versionOpt) {
 
-             deleteFromParserHintObject(versionOpt);
 
-             usage$1.version(undefined);
 
-             versionOpt = null;
 
-         }
 
-         if (arguments.length === 0) {
 
-             ver = guessVersion();
 
-             opt = defaultVersionOpt;
 
-         }
 
-         else if (arguments.length === 1) {
 
-             if (opt === false) {
 
-                 return self;
 
-             }
 
-             ver = opt;
 
-             opt = defaultVersionOpt;
 
-         }
 
-         else if (arguments.length === 2) {
 
-             ver = msg;
 
-             msg = undefined;
 
-         }
 
-         versionOpt = typeof opt === 'string' ? opt : defaultVersionOpt;
 
-         msg = msg || usage$1.deferY18nLookup('Show version number');
 
-         usage$1.version(ver || undefined);
 
-         self.boolean(versionOpt);
 
-         self.describe(versionOpt, msg);
 
-         return self;
 
-     };
 
-     function guessVersion() {
 
-         const obj = pkgUp();
 
-         return obj.version || 'unknown';
 
-     }
 
-     let helpOpt = null;
 
-     self.addHelpOpt = self.help = function addHelpOpt(opt, msg) {
 
-         const defaultHelpOpt = 'help';
 
-         argsert('[string|boolean] [string]', [opt, msg], arguments.length);
 
-         if (helpOpt) {
 
-             deleteFromParserHintObject(helpOpt);
 
-             helpOpt = null;
 
-         }
 
-         if (arguments.length === 1) {
 
-             if (opt === false)
 
-                 return self;
 
-         }
 
-         helpOpt = typeof opt === 'string' ? opt : defaultHelpOpt;
 
-         self.boolean(helpOpt);
 
-         self.describe(helpOpt, msg || usage$1.deferY18nLookup('Show help'));
 
-         return self;
 
-     };
 
-     const defaultShowHiddenOpt = 'show-hidden';
 
-     options.showHiddenOpt = defaultShowHiddenOpt;
 
-     self.addShowHiddenOpt = self.showHidden = function addShowHiddenOpt(opt, msg) {
 
-         argsert('[string|boolean] [string]', [opt, msg], arguments.length);
 
-         if (arguments.length === 1) {
 
-             if (opt === false)
 
-                 return self;
 
-         }
 
-         const showHiddenOpt = typeof opt === 'string' ? opt : defaultShowHiddenOpt;
 
-         self.boolean(showHiddenOpt);
 
-         self.describe(showHiddenOpt, msg || usage$1.deferY18nLookup('Show hidden options'));
 
-         options.showHiddenOpt = showHiddenOpt;
 
-         return self;
 
-     };
 
-     self.hide = function hide(key) {
 
-         argsert('<string>', [key], arguments.length);
 
-         options.hiddenOptions.push(key);
 
-         return self;
 
-     };
 
-     self.showHelpOnFail = function showHelpOnFail(enabled, message) {
 
-         argsert('[boolean|string] [string]', [enabled, message], arguments.length);
 
-         usage$1.showHelpOnFail(enabled, message);
 
-         return self;
 
-     };
 
-     let exitProcess = true;
 
-     self.exitProcess = function (enabled = true) {
 
-         argsert('[boolean]', [enabled], arguments.length);
 
-         exitProcess = enabled;
 
-         return self;
 
-     };
 
-     self.getExitProcess = () => exitProcess;
 
-     self.showCompletionScript = function ($0, cmd) {
 
-         argsert('[string] [string]', [$0, cmd], arguments.length);
 
-         $0 = $0 || self.$0;
 
-         _logger.log(completion$1.generateCompletionScript($0, cmd || completionCommand || 'completion'));
 
-         return self;
 
-     };
 
-     self.getCompletion = function (args, done) {
 
-         argsert('<array> <function>', [args, done], arguments.length);
 
-         completion$1.getCompletion(args, done);
 
-     };
 
-     self.locale = function (locale) {
 
-         argsert('[string]', [locale], arguments.length);
 
-         if (!locale) {
 
-             guessLocale();
 
-             return y18n.getLocale();
 
-         }
 
-         detectLocale = false;
 
-         y18n.setLocale(locale);
 
-         return self;
 
-     };
 
-     self.updateStrings = self.updateLocale = function (obj) {
 
-         argsert('<object>', [obj], arguments.length);
 
-         detectLocale = false;
 
-         y18n.updateLocale(obj);
 
-         return self;
 
-     };
 
-     let detectLocale = true;
 
-     self.detectLocale = function (detect) {
 
-         argsert('<boolean>', [detect], arguments.length);
 
-         detectLocale = detect;
 
-         return self;
 
-     };
 
-     self.getDetectLocale = () => detectLocale;
 
-     const _logger = {
 
-         log(...args) {
 
-             if (!self._hasParseCallback())
 
-                 console.log(...args);
 
-             hasOutput = true;
 
-             if (output.length)
 
-                 output += '\n';
 
-             output += args.join(' ');
 
-         },
 
-         error(...args) {
 
-             if (!self._hasParseCallback())
 
-                 console.error(...args);
 
-             hasOutput = true;
 
-             if (output.length)
 
-                 output += '\n';
 
-             output += args.join(' ');
 
-         },
 
-     };
 
-     self._getLoggerInstance = () => _logger;
 
-     self._hasOutput = () => hasOutput;
 
-     self._setHasOutput = () => {
 
-         hasOutput = true;
 
-     };
 
-     let recommendCommands;
 
-     self.recommendCommands = function (recommend = true) {
 
-         argsert('[boolean]', [recommend], arguments.length);
 
-         recommendCommands = recommend;
 
-         return self;
 
-     };
 
-     self.getUsageInstance = () => usage$1;
 
-     self.getValidationInstance = () => validation$1;
 
-     self.getCommandInstance = () => command$1;
 
-     self.terminalWidth = () => {
 
-         argsert([], 0);
 
-         return shim$1.process.stdColumns;
 
-     };
 
-     Object.defineProperty(self, 'argv', {
 
-         get: () => self._parseArgs(processArgs),
 
-         enumerable: true,
 
-     });
 
-     self._parseArgs = function parseArgs(args, shortCircuit, _calledFromCommand, commandIndex) {
 
-         let skipValidation = !!_calledFromCommand;
 
-         args = args || processArgs;
 
-         options.__ = y18n.__;
 
-         options.configuration = self.getParserConfiguration();
 
-         const populateDoubleDash = !!options.configuration['populate--'];
 
-         const config = Object.assign({}, options.configuration, {
 
-             'populate--': true,
 
-         });
 
-         const parsed = shim$1.Parser.detailed(args, Object.assign({}, options, {
 
-             configuration: Object.assign({ 'parse-positional-numbers': false }, config),
 
-         }));
 
-         let argv = parsed.argv;
 
-         if (parseContext)
 
-             argv = Object.assign({}, argv, parseContext);
 
-         const aliases = parsed.aliases;
 
-         argv.$0 = self.$0;
 
-         self.parsed = parsed;
 
-         try {
 
-             guessLocale();
 
-             if (shortCircuit) {
 
-                 return self._postProcess(argv, populateDoubleDash, _calledFromCommand);
 
-             }
 
-             if (helpOpt) {
 
-                 const helpCmds = [helpOpt]
 
-                     .concat(aliases[helpOpt] || [])
 
-                     .filter(k => k.length > 1);
 
-                 if (~helpCmds.indexOf('' + argv._[argv._.length - 1])) {
 
-                     argv._.pop();
 
-                     argv[helpOpt] = true;
 
-                 }
 
-             }
 
-             const handlerKeys = command$1.getCommands();
 
-             const requestCompletions = completion$1.completionKey in argv;
 
-             const skipRecommendation = argv[helpOpt] || requestCompletions;
 
-             const skipDefaultCommand = skipRecommendation &&
 
-                 (handlerKeys.length > 1 || handlerKeys[0] !== '$0');
 
-             if (argv._.length) {
 
-                 if (handlerKeys.length) {
 
-                     let firstUnknownCommand;
 
-                     for (let i = commandIndex || 0, cmd; argv._[i] !== undefined; i++) {
 
-                         cmd = String(argv._[i]);
 
-                         if (~handlerKeys.indexOf(cmd) && cmd !== completionCommand) {
 
-                             const innerArgv = command$1.runCommand(cmd, self, parsed, i + 1);
 
-                             return self._postProcess(innerArgv, populateDoubleDash);
 
-                         }
 
-                         else if (!firstUnknownCommand && cmd !== completionCommand) {
 
-                             firstUnknownCommand = cmd;
 
-                             break;
 
-                         }
 
-                     }
 
-                     if (command$1.hasDefaultCommand() && !skipDefaultCommand) {
 
-                         const innerArgv = command$1.runCommand(null, self, parsed);
 
-                         return self._postProcess(innerArgv, populateDoubleDash);
 
-                     }
 
-                     if (recommendCommands && firstUnknownCommand && !skipRecommendation) {
 
-                         validation$1.recommendCommands(firstUnknownCommand, handlerKeys);
 
-                     }
 
-                 }
 
-                 if (completionCommand &&
 
-                     ~argv._.indexOf(completionCommand) &&
 
-                     !requestCompletions) {
 
-                     if (exitProcess)
 
-                         setBlocking(true);
 
-                     self.showCompletionScript();
 
-                     self.exit(0);
 
-                 }
 
-             }
 
-             else if (command$1.hasDefaultCommand() && !skipDefaultCommand) {
 
-                 const innerArgv = command$1.runCommand(null, self, parsed);
 
-                 return self._postProcess(innerArgv, populateDoubleDash);
 
-             }
 
-             if (requestCompletions) {
 
-                 if (exitProcess)
 
-                     setBlocking(true);
 
-                 args = [].concat(args);
 
-                 const completionArgs = args.slice(args.indexOf(`--${completion$1.completionKey}`) + 1);
 
-                 completion$1.getCompletion(completionArgs, completions => {
 
-                     (completions || []).forEach(completion => {
 
-                         _logger.log(completion);
 
-                     });
 
-                     self.exit(0);
 
-                 });
 
-                 return self._postProcess(argv, !populateDoubleDash, _calledFromCommand);
 
-             }
 
-             if (!hasOutput) {
 
-                 Object.keys(argv).forEach(key => {
 
-                     if (key === helpOpt && argv[key]) {
 
-                         if (exitProcess)
 
-                             setBlocking(true);
 
-                         skipValidation = true;
 
-                         self.showHelp('log');
 
-                         self.exit(0);
 
-                     }
 
-                     else if (key === versionOpt && argv[key]) {
 
-                         if (exitProcess)
 
-                             setBlocking(true);
 
-                         skipValidation = true;
 
-                         usage$1.showVersion();
 
-                         self.exit(0);
 
-                     }
 
-                 });
 
-             }
 
-             if (!skipValidation && options.skipValidation.length > 0) {
 
-                 skipValidation = Object.keys(argv).some(key => options.skipValidation.indexOf(key) >= 0 && argv[key] === true);
 
-             }
 
-             if (!skipValidation) {
 
-                 if (parsed.error)
 
-                     throw new YError(parsed.error.message);
 
-                 if (!requestCompletions) {
 
-                     self._runValidation(argv, aliases, {}, parsed.error);
 
-                 }
 
-             }
 
-         }
 
-         catch (err) {
 
-             if (err instanceof YError)
 
-                 usage$1.fail(err.message, err);
 
-             else
 
-                 throw err;
 
-         }
 
-         return self._postProcess(argv, populateDoubleDash, _calledFromCommand);
 
-     };
 
-     self._postProcess = function (argv, populateDoubleDash, calledFromCommand = false) {
 
-         if (isPromise(argv))
 
-             return argv;
 
-         if (calledFromCommand)
 
-             return argv;
 
-         if (!populateDoubleDash) {
 
-             argv = self._copyDoubleDash(argv);
 
-         }
 
-         const parsePositionalNumbers = self.getParserConfiguration()['parse-positional-numbers'] ||
 
-             self.getParserConfiguration()['parse-positional-numbers'] === undefined;
 
-         if (parsePositionalNumbers) {
 
-             argv = self._parsePositionalNumbers(argv);
 
-         }
 
-         return argv;
 
-     };
 
-     self._copyDoubleDash = function (argv) {
 
-         if (!argv._ || !argv['--'])
 
-             return argv;
 
-         argv._.push.apply(argv._, argv['--']);
 
-         try {
 
-             delete argv['--'];
 
-         }
 
-         catch (_err) { }
 
-         return argv;
 
-     };
 
-     self._parsePositionalNumbers = function (argv) {
 
-         const args = argv['--'] ? argv['--'] : argv._;
 
-         for (let i = 0, arg; (arg = args[i]) !== undefined; i++) {
 
-             if (shim$1.Parser.looksLikeNumber(arg) &&
 
-                 Number.isSafeInteger(Math.floor(parseFloat(`${arg}`)))) {
 
-                 args[i] = Number(arg);
 
-             }
 
-         }
 
-         return argv;
 
-     };
 
-     self._runValidation = function runValidation(argv, aliases, positionalMap, parseErrors, isDefaultCommand = false) {
 
-         if (parseErrors)
 
-             throw new YError(parseErrors.message);
 
-         validation$1.nonOptionCount(argv);
 
-         validation$1.requiredArguments(argv);
 
-         let failedStrictCommands = false;
 
-         if (strictCommands) {
 
-             failedStrictCommands = validation$1.unknownCommands(argv);
 
-         }
 
-         if (strict && !failedStrictCommands) {
 
-             validation$1.unknownArguments(argv, aliases, positionalMap, isDefaultCommand);
 
-         }
 
-         else if (strictOptions) {
 
-             validation$1.unknownArguments(argv, aliases, {}, false, false);
 
-         }
 
-         validation$1.customChecks(argv, aliases);
 
-         validation$1.limitedChoices(argv);
 
-         validation$1.implications(argv);
 
-         validation$1.conflicting(argv);
 
-     };
 
-     function guessLocale() {
 
-         if (!detectLocale)
 
-             return;
 
-         const locale = shim$1.getEnv('LC_ALL') ||
 
-             shim$1.getEnv('LC_MESSAGES') ||
 
-             shim$1.getEnv('LANG') ||
 
-             shim$1.getEnv('LANGUAGE') ||
 
-             'en_US';
 
-         self.locale(locale.replace(/[.:].*/, ''));
 
-     }
 
-     self.help();
 
-     self.version();
 
-     return self;
 
- }
 
- const rebase = (base, dir) => shim$1.path.relative(base, dir);
 
- function isYargsInstance(y) {
 
-     return !!y && typeof y._parseArgs === 'function';
 
- }
 
- var _a, _b;
 
- const { readFileSync } = require('fs');
 
- const { inspect } = require('util');
 
- const { resolve } = require('path');
 
- const y18n = require('y18n');
 
- const Parser = require('yargs-parser');
 
- var cjsPlatformShim = {
 
-     assert: {
 
-         notStrictEqual: assert.notStrictEqual,
 
-         strictEqual: assert.strictEqual,
 
-     },
 
-     cliui: require('cliui'),
 
-     findUp: require('escalade/sync'),
 
-     getEnv: (key) => {
 
-         return process.env[key];
 
-     },
 
-     getCallerFile: require('get-caller-file'),
 
-     getProcessArgvBin: getProcessArgvBin,
 
-     inspect,
 
-     mainFilename: (_b = (_a = require === null || require === void 0 ? void 0 : require.main) === null || _a === void 0 ? void 0 : _a.filename) !== null && _b !== void 0 ? _b : process.cwd(),
 
-     Parser,
 
-     path: require('path'),
 
-     process: {
 
-         argv: () => process.argv,
 
-         cwd: process.cwd,
 
-         execPath: () => process.execPath,
 
-         exit: (code) => {
 
-             process.exit(code);
 
-         },
 
-         nextTick: process.nextTick,
 
-         stdColumns: typeof process.stdout.columns !== 'undefined'
 
-             ? process.stdout.columns
 
-             : null,
 
-     },
 
-     readFileSync,
 
-     require: require,
 
-     requireDirectory: require('require-directory'),
 
-     stringWidth: require('string-width'),
 
-     y18n: y18n({
 
-         directory: resolve(__dirname, '../locales'),
 
-         updateFiles: false,
 
-     }),
 
- };
 
- const minNodeVersion = process && process.env && process.env.YARGS_MIN_NODE_VERSION
 
-     ? Number(process.env.YARGS_MIN_NODE_VERSION)
 
-     : 10;
 
- if (process && process.version) {
 
-     const major = Number(process.version.match(/v([^.]+)/)[1]);
 
-     if (major < minNodeVersion) {
 
-         throw Error(`yargs supports a minimum Node.js version of ${minNodeVersion}. Read our version support policy: https://github.com/yargs/yargs#supported-nodejs-versions`);
 
-     }
 
- }
 
- const Parser$1 = require('yargs-parser');
 
- const Yargs$1 = YargsWithShim(cjsPlatformShim);
 
- var cjs = {
 
-     applyExtends,
 
-     cjsPlatformShim,
 
-     Yargs: Yargs$1,
 
-     argsert,
 
-     globalMiddlewareFactory,
 
-     isPromise,
 
-     objFilter,
 
-     parseCommand,
 
-     Parser: Parser$1,
 
-     processArgv,
 
-     rebase,
 
-     YError,
 
- };
 
- module.exports = cjs;
 
 
  |