| 123456789101112131415161718192021222324252627282930313233343536373839404142434445464748495051525354555657585960616263646566676869707172737475767778798081828384858687888990919293949596979899100101102103104105106107108109110111112113114115116117118119120121122123124125126127128129130131132133134135136137138139140141142143144145146147148149150151152153154155156157158159160161162163164165166167168169170171172173174175176177178179180181182183184185186187188189190191192193194195196197198199200201202203204205206207208209210211212213214215216217218219220221222223224225226227228229230231232233234235236 | import { isCommandBuilderCallback } from './command.js';import { assertNotStrictEqual } from './typings/common-types.js';import * as templates from './completion-templates.js';import { isPromise } from './utils/is-promise.js';import { parseCommand } from './parse-command.js';export class Completion {    constructor(yargs, usage, command, shim) {        var _a, _b, _c;        this.yargs = yargs;        this.usage = usage;        this.command = command;        this.shim = shim;        this.completionKey = 'get-yargs-completions';        this.aliases = null;        this.customCompletionFunction = null;        this.indexAfterLastReset = 0;        this.zshShell =            (_c = (((_a = this.shim.getEnv('SHELL')) === null || _a === void 0 ? void 0 : _a.includes('zsh')) ||                ((_b = this.shim.getEnv('ZSH_NAME')) === null || _b === void 0 ? void 0 : _b.includes('zsh')))) !== null && _c !== void 0 ? _c : false;    }    defaultCompletion(args, argv, current, done) {        const handlers = this.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)) {                    this.indexAfterLastReset = i + 1;                    const y = this.yargs.getInternalMethods().reset();                    builder(y, true);                    return y.argv;                }            }        }        const completions = [];        this.commandCompletions(completions, args, current);        this.optionCompletions(completions, args, argv, current);        this.choicesFromOptionsCompletions(completions, args, argv, current);        this.choicesFromPositionalsCompletions(completions, args, argv, current);        done(null, completions);    }    commandCompletions(completions, args, current) {        const parentCommands = this.yargs            .getInternalMethods()            .getContext().commands;        if (!current.match(/^-/) &&            parentCommands[parentCommands.length - 1] !== current &&            !this.previousArgHasChoices(args)) {            this.usage.getCommands().forEach(usageCommand => {                const commandName = parseCommand(usageCommand[0]).cmd;                if (args.indexOf(commandName) === -1) {                    if (!this.zshShell) {                        completions.push(commandName);                    }                    else {                        const desc = usageCommand[1] || '';                        completions.push(commandName.replace(/:/g, '\\:') + ':' + desc);                    }                }            });        }    }    optionCompletions(completions, args, argv, current) {        if ((current.match(/^-/) || (current === '' && completions.length === 0)) &&            !this.previousArgHasChoices(args)) {            const options = this.yargs.getOptions();            const positionalKeys = this.yargs.getGroups()[this.usage.getPositionalGroupName()] || [];            Object.keys(options.key).forEach(key => {                const negable = !!options.configuration['boolean-negation'] &&                    options.boolean.includes(key);                const isPositionalKey = positionalKeys.includes(key);                if (!isPositionalKey &&                    !options.hiddenOptions.includes(key) &&                    !this.argsContainKey(args, key, negable)) {                    this.completeOptionKey(key, completions, current);                    if (negable && !!options.default[key])                        this.completeOptionKey(`no-${key}`, completions, current);                }            });        }    }    choicesFromOptionsCompletions(completions, args, argv, current) {        if (this.previousArgHasChoices(args)) {            const choices = this.getPreviousArgChoices(args);            if (choices && choices.length > 0) {                completions.push(...choices.map(c => c.replace(/:/g, '\\:')));            }        }    }    choicesFromPositionalsCompletions(completions, args, argv, current) {        if (current === '' &&            completions.length > 0 &&            this.previousArgHasChoices(args)) {            return;        }        const positionalKeys = this.yargs.getGroups()[this.usage.getPositionalGroupName()] || [];        const offset = Math.max(this.indexAfterLastReset, this.yargs.getInternalMethods().getContext().commands.length +            1);        const positionalKey = positionalKeys[argv._.length - offset - 1];        if (!positionalKey) {            return;        }        const choices = this.yargs.getOptions().choices[positionalKey] || [];        for (const choice of choices) {            if (choice.startsWith(current)) {                completions.push(choice.replace(/:/g, '\\:'));            }        }    }    getPreviousArgChoices(args) {        if (args.length < 1)            return;        let previousArg = args[args.length - 1];        let filter = '';        if (!previousArg.startsWith('-') && args.length > 1) {            filter = previousArg;            previousArg = args[args.length - 2];        }        if (!previousArg.startsWith('-'))            return;        const previousArgKey = previousArg.replace(/^-+/, '');        const options = this.yargs.getOptions();        const possibleAliases = [            previousArgKey,            ...(this.yargs.getAliases()[previousArgKey] || []),        ];        let choices;        for (const possibleAlias of possibleAliases) {            if (Object.prototype.hasOwnProperty.call(options.key, possibleAlias) &&                Array.isArray(options.choices[possibleAlias])) {                choices = options.choices[possibleAlias];                break;            }        }        if (choices) {            return choices.filter(choice => !filter || choice.startsWith(filter));        }    }    previousArgHasChoices(args) {        const choices = this.getPreviousArgChoices(args);        return choices !== undefined && choices.length > 0;    }    argsContainKey(args, key, negable) {        const argsContains = (s) => args.indexOf((/^[^0-9]$/.test(s) ? '-' : '--') + s) !== -1;        if (argsContains(key))            return true;        if (negable && argsContains(`no-${key}`))            return true;        if (this.aliases) {            for (const alias of this.aliases[key]) {                if (argsContains(alias))                    return true;            }        }        return false;    }    completeOptionKey(key, completions, current) {        const descs = this.usage.getDescriptions();        const startsByTwoDashes = (s) => /^--/.test(s);        const isShortOption = (s) => /^[^0-9]$/.test(s);        const dashes = !startsByTwoDashes(current) && isShortOption(key) ? '-' : '--';        if (!this.zshShell) {            completions.push(dashes + key);        }        else {            const desc = descs[key] || '';            completions.push(dashes +                `${key.replace(/:/g, '\\:')}:${desc.replace('__yargsString__:', '')}`);        }    }    customCompletion(args, argv, current, done) {        assertNotStrictEqual(this.customCompletionFunction, null, this.shim);        if (isSyncCompletionFunction(this.customCompletionFunction)) {            const result = this.customCompletionFunction(current, argv);            if (isPromise(result)) {                return result                    .then(list => {                    this.shim.process.nextTick(() => {                        done(null, list);                    });                })                    .catch(err => {                    this.shim.process.nextTick(() => {                        done(err, undefined);                    });                });            }            return done(null, result);        }        else if (isFallbackCompletionFunction(this.customCompletionFunction)) {            return this.customCompletionFunction(current, argv, (onCompleted = done) => this.defaultCompletion(args, argv, current, onCompleted), completions => {                done(null, completions);            });        }        else {            return this.customCompletionFunction(current, argv, completions => {                done(null, completions);            });        }    }    getCompletion(args, done) {        const current = args.length ? args[args.length - 1] : '';        const argv = this.yargs.parse(args, true);        const completionFunction = this.customCompletionFunction            ? (argv) => this.customCompletion(args, argv, current, done)            : (argv) => this.defaultCompletion(args, argv, current, done);        return isPromise(argv)            ? argv.then(completionFunction)            : completionFunction(argv);    }    generateCompletionScript($0, cmd) {        let script = this.zshShell            ? templates.completionZshTemplate            : templates.completionShTemplate;        const name = this.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);    }    registerFunction(fn) {        this.customCompletionFunction = fn;    }    setParsed(parsed) {        this.aliases = parsed.aliases;    }}export function completion(yargs, usage, command, shim) {    return new Completion(yargs, usage, command, shim);}function isSyncCompletionFunction(completionFunction) {    return completionFunction.length < 3;}function isFallbackCompletionFunction(completionFunction) {    return completionFunction.length > 3;}
 |