nx/dist/src/command-line/completion/metadata.js

The core Nx plugin contains the core functionality of Nx like the project graph, nx commands and task orchestration.

"use strict";
// Per-command completion metadata. Path-keyed because yargs doesn't
// preserve command-object references through its parse.
Object.defineProperty(exports, "__esModule", { value: true });
exports.registerCompletion = registerCompletion;
exports.getRegisteredTopLevelPaths = getRegisteredTopLevelPaths;
exports.findCompletionMetadata = findCompletionMetadata;
exports.findFlagCompletion = findFlagCompletion;
exports.resolveCompletion = resolveCompletion;
const REGISTRY = new Map();
function registerCompletion(path, metadata) {
    REGISTRY.set(path, metadata);
}
/** Single-token registered paths (infix targets etc.). */
function getRegisteredTopLevelPaths() {
    const paths = [];
    for (const path of REGISTRY.keys()) {
        if (!path.includes(' '))
            paths.push(path);
    }
    return paths;
}
/** Longest-prefix match against the leading non-flag args. */
function findCompletionMetadata(args) {
    const nonFlag = [];
    for (const arg of args) {
        if (arg.startsWith('-'))
            break;
        nonFlag.push(arg);
    }
    for (let i = nonFlag.length; i > 0; i--) {
        const path = nonFlag.slice(0, i).join(' ');
        const metadata = REGISTRY.get(path);
        if (metadata) {
            const positionalIndex = Math.max(0, nonFlag.length - i - 1);
            return { metadata, positionalIndex };
        }
    }
    return null;
}
function findFlagCompletion(metadata, flag) {
    return metadata?.flags?.[flag] ?? null;
}
/** Positional/flag-value dispatch. Returns null when no handler applies. */
function resolveCompletion(args, current, previousToken) {
    if (args.length === 0)
        return null;
    const match = findCompletionMetadata(args);
    const meta = match?.metadata ?? null;
    if (previousToken && previousToken.startsWith('-')) {
        const handler = findFlagCompletion(meta, previousToken.replace(/^-+/, ''));
        if (handler)
            return handler(current, args);
        // The user is typing a flag's value but we don't have a handler for
        // this flag. Emit no candidates so the shell wrapper falls back to its
        // native default (filename/dirname completion in bash via `-o default`).
        // Crucially, do NOT fall through to positional dispatch — that would
        // offer wrong candidates (e.g. project names for `nx g app --directory <TAB>`).
        return [];
    }
    if (match) {
        const positional = match.metadata.positionals?.[match.positionalIndex];
        if (positional?.complete)
            return positional.complete(current, args);
        if (positional?.choices) {
            return positional.choices.filter((c) => c.startsWith(current));
        }
        return null;
    }
    return null;
}