@fnndsc/brasa 0.56.1 → 0.56.3

package/dist/core/commandParse.js

@@ -0,0 +1,468 @@
+/**
+ * @file Parses a declared command's line against its grammar, and runs it.
+ *
+ * The words reach here with references already expanded. Then, in order:
+ * 1. The line's shape is parsed, GNU `getopt_long` for every command: `-f`,
+ *    bundled short switches (`-rf`), `--force`; `--name x` and `--name=x`;
+ *    `--` ends the options; options may stand anywhere among the operands;
+ *    a word like `-3` is an operand when an operand of the line is numeric,
+ *    or the value of the option that says `numeral` (`head -3`); a value
+ *    that may be left out (`--highlight[=lang]`) is only in its own word;
+ *    a value option that `asks`, given no value, is a question (null).
+ *    Subcommand words and option names are literal and never globbed.
+ * 2. Operands expand by kind: only a path operand that declares `glob` has
+ *    its wildcards matched.
+ * 3. Values are checked by kind.
+ * A line that fails a step is refused in plain words, with the usage, before
+ * the handler runs.
+ *
+ * Key components:
+ * - commandLine_parse: a line's words to the typed object a handler reads.
+ * - declaredCommand_run: parses and runs, refusing a bad line.
+ * - declaredHandler_make: the registry's handler for a declared command.
+ *
+ * Typical usage:
+ * ```ts
+ * const parsed: LineParse = await commandLine_parse(lsCommand, shellWords_tokenize('-l docs'));
+ * const envelope: CommandEnvelope = await declaredCommand_run(lsCommand, ['-l', 'docs']);
+ * ```
+ *
+ * Dependencies: the argument kinds (each a value check and a pathname
+ * expansion), the usage renderer, and the shell words' quoting.
+ *
+ * @module
+ */
+import chalk from 'chalk';
+import { envelope_error } from '@fnndsc/menu';
+import { argumentKind_get, argumentWord_check } from './argumentKinds.js';
+import { commandUsage_render } from './commandUsage.js';
+import { exitCode_set } from './handlerRun.js';
+/** A word that reads as a negative number. */
+const NEGATIVE_NUMBER = /^-\d+(?:\.\d+)?$/;
+/** A dash and digits: an option that says `numeral` with that value (`head -5`). */
+const DASH_DIGITS = /^-\d+$/;
+/** A refusal raised while a line is parsed: its words, after `<command>: `. */
+class LineRefusal extends Error {
+    /** The subcommand the line chose by then, for the usage that follows. */
+    subcommand;
+    /**
+     * @param message - What was wrong.
+     * @param subcommand - The subcommand chosen, if one was.
+     */
+    constructor(message, subcommand) {
+        super(message);
+        this.subcommand = subcommand;
+    }
+}
+/**
+ * The options in reach once a subcommand is chosen, or none is: its own (the
+ * bare command's for none), then the command's.
+ *
+ * @param grammar - The command's grammar.
+ * @param subcommand - The subcommand's grammar, or null for the bare command.
+ * @returns The options.
+ */
+function optionEntries_list(grammar, subcommand) {
+    const own = subcommand === null ? (grammar.bare?.options ?? {}) : (subcommand.options ?? {});
+    const command = grammar.options ?? {};
+    return [...Object.entries(own), ...Object.entries(command)]
+        .map(([key, option]) => ({ key, option }));
+}
+/**
+ * Whether any operand in reach is numeric, so a negative number is one.
+ *
+ * @param operands - The operands.
+ * @returns True when one is.
+ */
+function operands_takeNumbers(operands) {
+    return operands.some((operand) => argumentKind_get(operand.kind)?.numeric === true);
+}
+/**
+ * Records one option's value: a switch is set; a value is kept with any before it.
+ *
+ * @param options - The options so far.
+ * @param entry - The option.
+ * @param value - Its value, or null for a switch.
+ */
+function option_record(options, entry, value) {
+    if (value === null) {
+        options.set(entry.key, true);
+        return;
+    }
+    const held = options.get(entry.key);
+    options.set(entry.key, [...(Array.isArray(held) ? held : []), value]);
+}
+/**
+ * Whether a value option stands with no value: nothing follows it, or, for
+ * one that asks, another option does.
+ *
+ * @param option - The option.
+ * @param next - The word after it, if any.
+ * @returns True when it has no value.
+ */
+function value_isAbsent(option, next) {
+    if (next === undefined)
+        return true;
+    return option.asks === true && next.value.startsWith('-') && next.value.length > 1;
+}
+/**
+ * Reads one long option word, `--name` or `--name=value`, taking its value
+ * from the next word when it wants one.
+ *
+ * @param words - The line's words.
+ * @param at - Where the option stands.
+ * @param walk - Where the parse stands.
+ * @param options - The options so far.
+ * @returns Where the next word stands.
+ * @throws {LineRefusal} For an unknown option, a missing value, or a value given to a switch.
+ */
+function longOption_read(words, at, walk, options) {
+    const text = words[at].value.slice(2);
+    const equals = text.indexOf('=');
+    const name = equals === -1 ? text : text.slice(0, equals);
+    const inline = equals === -1 ? null : text.slice(equals + 1);
+    const entry = walk.entries.find((one) => one.option.long === name);
+    if (entry === undefined)
+        throw new LineRefusal(`unrecognized option '--${name}'`, walk.subcommand);
+    if (entry.option.value === undefined) {
+        if (inline !== null)
+            throw new LineRefusal(`option '--${name}' takes no value`, walk.subcommand);
+        option_record(options, entry, null);
+        return at + 1;
+    }
+    if (inline !== null || entry.option.value.optional === true) {
+        // An optional value is only ever in the option's own word.
+        option_record(options, entry, inline ?? '');
+        return at + 1;
+    }
+    const next = words[at + 1];
+    if (value_isAbsent(entry.option, next)) {
+        if (entry.option.asks !== true)
+            throw new LineRefusal(`option '--${name}' wants a value (<${entry.option.value.name}>)`, walk.subcommand);
+        options.set(entry.key, null);
+        return at + 1;
+    }
+    option_record(options, entry, next.value);
+    return at + 2;
+}
+/**
+ * Reads one word of short options, `-l` or bundled `-rf`; an option that
+ * takes a value takes the rest of the word, or the next word.
+ *
+ * @param words - The line's words.
+ * @param at - Where the word stands.
+ * @param walk - Where the parse stands.
+ * @param options - The options so far.
+ * @returns Where the next word stands.
+ * @throws {LineRefusal} For an unknown option or a missing value.
+ */
+function shortOptions_read(words, at, walk, options) {
+    const text = words[at].value;
+    for (let index = 1; index < text.length; index += 1) {
+        const letter = text[index];
+        const entry = walk.entries.find((one) => one.option.short === letter);
+        if (entry === undefined)
+            throw new LineRefusal(`invalid option -- '${letter}'`, walk.subcommand);
+        if (entry.option.value === undefined) {
+            option_record(options, entry, null);
+            continue;
+        }
+        const rest = text.slice(index + 1);
+        if (rest !== '' || entry.option.value.optional === true) {
+            option_record(options, entry, rest);
+            return at + 1;
+        }
+        const next = words[at + 1];
+        if (value_isAbsent(entry.option, next)) {
+            if (entry.option.asks !== true)
+                throw new LineRefusal(`option '-${letter}' wants a value (<${entry.option.value.name}>)`, walk.subcommand);
+            options.set(entry.key, null);
+            return at + 1;
+        }
+        option_record(options, entry, next.value);
+        return at + 2;
+    }
+    return at + 1;
+}
+/**
+ * Takes a word that is not an option: the subcommand, when the line has
+ * none yet and the grammar has them; otherwise an operand.
+ *
+ * @param grammar - The command's grammar.
+ * @param word - The word.
+ * @param walk - Where the parse stands.
+ * @param operands - The operands so far.
+ * @param options - The options so far, which a chosen subcommand must take.
+ * @throws {LineRefusal} For a word that names no subcommand of a command that takes no bare operand, or a subcommand that does not take an option given before it.
+ */
+function plainWord_take(grammar, word, walk, operands, options) {
+    const subcommands = grammar.subcommands;
+    if (subcommands !== undefined && walk.subcommand === null && operands.length === 0 && !walk.optionsEnded) {
+        const chosen = Object.hasOwn(subcommands, word.value) ? subcommands[word.value] : undefined;
+        if (chosen !== undefined) {
+            const entries = optionEntries_list(grammar, chosen);
+            // An option the bare command takes, given before a subcommand that does not take it, is refused, not dropped.
+            for (const key of options.keys()) {
+                if (entries.some((entry) => entry.key === key))
+                    continue;
+                const given = walk.entries.find((entry) => entry.key === key)?.option;
+                const name = given?.long !== undefined ? `--${given.long}` : `-${given?.short ?? key}`;
+                throw new LineRefusal(`option '${name}' is not one ${word.value} takes`, word.value);
+            }
+            walk.subcommand = word.value;
+            walk.scope = chosen;
+            walk.entries = entries;
+            return;
+        }
+        if ((grammar.operands ?? []).length === 0) {
+            throw new LineRefusal(`unknown subcommand '${word.value}' (${Object.keys(subcommands).join(', ')})`, null);
+        }
+    }
+    operands.push(word);
+}
+/**
+ * Parses a line's shape: which subcommand, which options with which values,
+ * and which words are operands.
+ *
+ * @param grammar - The command's grammar.
+ * @param words - The words after the command.
+ * @returns The shape.
+ * @throws {LineRefusal} For an unknown option, a missing value, or an unknown subcommand.
+ */
+function lineShape_parse(grammar, words) {
+    const walk = { subcommand: null, scope: null, entries: optionEntries_list(grammar, null), optionsEnded: false };
+    const options = new Map();
+    const operands = [];
+    let at = 0;
+    while (at < words.length) {
+        const word = words[at];
+        const text = word.value;
+        const reach = walk.scope?.operands ?? grammar.operands ?? [];
+        if (walk.optionsEnded) {
+            plainWord_take(grammar, word, walk, operands, options);
+            at += 1;
+        }
+        else if (text === '--') {
+            walk.optionsEnded = true;
+            at += 1;
+        }
+        else if (text.startsWith('--')) {
+            at = longOption_read(words, at, walk, options);
+        }
+        else if (DASH_DIGITS.test(text) && walk.entries.some((entry) => entry.option.numeral === true)) {
+            option_record(options, walk.entries.find((entry) => entry.option.numeral === true), text.slice(1));
+            at += 1;
+        }
+        else if (text.startsWith('-') && text.length > 1 && !(NEGATIVE_NUMBER.test(text) && operands_takeNumbers(reach))) {
+            at = shortOptions_read(words, at, walk, options);
+        }
+        else {
+            plainWord_take(grammar, word, walk, operands, options);
+            at += 1;
+        }
+    }
+    if (grammar.subcommands !== undefined && walk.subcommand === null && grammar.bare === undefined && (grammar.operands ?? []).length === 0) {
+        throw new LineRefusal(`missing subcommand (${Object.keys(grammar.subcommands).join(', ')})`, null);
+    }
+    return { subcommand: walk.subcommand, options, operands };
+}
+/**
+ * Hands the operand words to the operands, in order: each required operand
+ * one word, each optional one a word while words are left over, and the one
+ * that repeats every word left after that.
+ *
+ * @param operands - The operands, in order.
+ * @param words - The operand words.
+ * @param subcommand - The subcommand, for a refusal.
+ * @returns Each operand's words, by name.
+ * @throws {LineRefusal} For too few words, or too many.
+ */
+function operandWords_assign(operands, words, subcommand) {
+    const required = operands.filter((operand) => operand.optional !== true).length;
+    if (words.length < required) {
+        const missing = operands.filter((operand) => operand.optional !== true)[words.length];
+        throw new LineRefusal(`missing operand <${missing?.name ?? 'operand'}>`, subcommand);
+    }
+    let spare = words.length - required;
+    let at = 0;
+    const assigned = new Map();
+    for (const operand of operands) {
+        let take = operand.optional === true ? 0 : 1;
+        if (operand.repeat === true) {
+            take += spare;
+            spare = 0;
+        }
+        else if (operand.optional === true && spare > 0) {
+            take = 1;
+            spare -= 1;
+        }
+        assigned.set(operand.name, words.slice(at, at + take));
+        at += take;
+    }
+    const extra = words[at];
+    if (extra !== undefined)
+        throw new LineRefusal(`unexpected operand '${extra.value}'`, subcommand);
+    return assigned;
+}
+/**
+ * Expands one operand's words by its kind: a path operand that declares
+ * `glob` has its wildcards matched; every other word stands as written.
+ *
+ * @param operand - The operand.
+ * @param words - Its words.
+ * @param subcommand - The subcommand, for a refusal.
+ * @returns Its words after expansion, and whether any came from it.
+ * @throws {LineRefusal} When the expansion fails, or gives one-word operand several words.
+ */
+async function operandWords_expand(operand, words, subcommand) {
+    const kind = argumentKind_get(operand.kind);
+    if (operand.glob !== true || kind?.words_expand === undefined || !words.some((word) => word.pathnameExpansion)) {
+        return { words, expanded: false };
+    }
+    const result = await kind.words_expand(words);
+    if (!result.ok)
+        throw new LineRefusal(result.reason, subcommand);
+    if (operand.repeat !== true && result.words.length > 1) {
+        throw new LineRefusal(`<${operand.name}> takes one path; '${words[0]?.value ?? ''}' matches ${result.words.length}`, subcommand);
+    }
+    return { words: result.words, expanded: result.words.some((word) => word.pathnameExpanded) };
+}
+/**
+ * Checks one word against its argument, refusing it in the line's words.
+ *
+ * @param argument - The argument.
+ * @param word - The word.
+ * @param where - The argument as the refusal names it (`<path>`, `'--sort'`).
+ * @param subcommand - The subcommand, for a refusal.
+ * @returns The value.
+ * @throws {LineRefusal} When the word is not one of the kind.
+ */
+function word_check(argument, word, where, subcommand) {
+    const checked = argumentWord_check(argument, word);
+    if (!checked.ok)
+        throw new LineRefusal(`invalid argument '${word}' for ${where} (${checked.reason})`, subcommand);
+    return checked.value;
+}
+/**
+ * The options' values, checked: a switch true or false, a value option its
+ * last value (or every value when it repeats), absent as undefined (or none).
+ *
+ * @param entries - The options in reach.
+ * @param given - What the line gave.
+ * @param subcommand - The subcommand, for a refusal.
+ * @returns The values, by property.
+ * @throws {LineRefusal} For a value not of its kind.
+ */
+function optionValues_check(entries, given, subcommand) {
+    const values = {};
+    for (const { key, option } of entries) {
+        const held = given.get(key);
+        if (option.value === undefined) {
+            values[key] = held === true;
+            continue;
+        }
+        if (held === null) {
+            values[key] = option.repeat === true ? [] : null;
+            continue;
+        }
+        const where = option.long !== undefined ? `'--${option.long}'` : `'-${option.short ?? ''}'`;
+        const checked = (Array.isArray(held) ? held : []).map((word) => word_check(option.value, word, where, subcommand));
+        values[key] = option.repeat === true ? checked : checked.at(-1);
+    }
+    return values;
+}
+/**
+ * Parses a declared command's line into the object its handler reads.
+ *
+ * @param declaration - The command.
+ * @param words - The words after the command, references expanded, quoting kept.
+ * @returns The handler's argument, or the refusal (`ls: unrecognized option '--x'; usage: …`).
+ *
+ * @example
+ * ```ts
+ * const parsed: LineParse = await commandLine_parse(lsCommand, [shellWord_literal('-l')]);
+ * if (parsed.ok) parsed.args.options['long']; // true
+ * ```
+ */
+export async function commandLine_parse(declaration, words) {
+    const grammar = declaration.grammar;
+    try {
+        const shape = lineShape_parse(grammar, words);
+        const scope = shape.subcommand === null ? null : (grammar.subcommands?.[shape.subcommand] ?? null);
+        // An operand that stands only without an option is gone when the option is given.
+        const operandGrammars = (scope !== null ? (scope.operands ?? []) : (grammar.operands ?? []))
+            .filter((operand) => operand.unless === undefined || !shape.options.has(operand.unless));
+        const assigned = operandWords_assign(operandGrammars, shape.operands, shape.subcommand);
+        const operands = {};
+        const expanded = {};
+        for (const operand of operandGrammars) {
+            const own = await operandWords_expand(operand, assigned.get(operand.name) ?? [], shape.subcommand);
+            if (operand.glob === true)
+                expanded[operand.name] = own.expanded;
+            const values = own.words.map((word) => word_check(operand, word.value, `<${operand.name}>`, shape.subcommand));
+            operands[operand.name] = operand.repeat === true ? values : values[0];
+        }
+        const options = optionValues_check(optionEntries_list(grammar, scope), shape.options, shape.subcommand);
+        return { ok: true, args: { subcommand: shape.subcommand, operands, options, expanded } };
+    }
+    catch (error) {
+        if (!(error instanceof LineRefusal))
+            throw error;
+        const where = error.subcommand === null ? declaration.name : `${declaration.name}: ${error.subcommand}`;
+        return { ok: false, refusal: `${where}: ${error.message}; usage: ${commandUsage_render(declaration, error.subcommand)}` };
+    }
+}
+/**
+ * Words as a line hands them on: the shell words the line carried, quoting
+ * kept, when they came with it; otherwise each string as a literal word,
+ * which globs nothing (a caller that split its own words expands nothing).
+ *
+ * @param args - The arguments.
+ * @returns The words.
+ */
+function argumentWords_read(args) {
+    const carried = args.words;
+    if (carried !== undefined && carried.length === args.length)
+        return [...carried];
+    return args.map((value) => ({ value, globPattern: value.replace(/[\\*?[\]]/g, '\\$&'), pathnameExpansion: false, pathnameExpanded: false }));
+}
+/**
+ * Parses a line against its declaration and runs the handler on it; a bad
+ * line is refused on the error channel, the handler never called.
+ *
+ * @param declaration - The command.
+ * @param args - The words after the command.
+ * @returns The handler's envelope, or the refusal's.
+ *
+ * @example
+ * ```ts
+ * await declaredCommand_run(lsCommand, ['--nosuch']); // renderedErr: "ls: unrecognized option '--nosuch'; usage: …"
+ * ```
+ */
+export async function declaredCommand_run(declaration, args) {
+    const parsed = await commandLine_parse(declaration, argumentWords_read(args));
+    if (!parsed.ok) {
+        exitCode_set(1);
+        return envelope_error('', undefined, `${chalk.red(parsed.refusal)}\n`);
+    }
+    // The grammar's types are put on the object here, the one place the
+    // parse meets them: the parse built it from that same grammar.
+    return declaration.handler(parsed.args);
+}
+/**
+ * The registry's handler for a declared command: the words a line hands
+ * on, parsed against the declaration.
+ *
+ * @param declaration - The command.
+ * @returns The handler.
+ *
+ * @example
+ * ```ts
+ * const handler = declaredHandler_make(lsCommand);
+ * await handler(['-l']);
+ * ```
+ */
+export function declaredHandler_make(declaration) {
+    return (args) => declaredCommand_run(declaration, args);
+}
+//# sourceMappingURL=commandParse.js.map

package/dist/core/commandParse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"commandParse.js","sourceRoot":"","sources":["../../src/core/commandParse.ts"],"names":[],"mappings":"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"}

package/dist/core/commandRegistry.d.ts

@@ -14,6 +14,13 @@
  * builtin too; that is how the tables behaved, and changing it is a decision of
  * its own, not a side effect of moving the lookup here.
  *
+ * A command may instead register its declaration (`commandDeclaration.ts`):
+ * one record holding its grammar, kinds, handler, holds and help prose. The
+ * registry answers its name with a handler that parses the line against the
+ * grammar first, and its help is generated from the same record, so help and
+ * behaviour cannot drift apart. Completion and the tool schema read the
+ * declaration itself (`commandDeclaration_get`).
+ *
  * Listing order is kept explicitly (`commandOrder_set`), apart from which
  * group registered a name, so the core's and a backend's commands registering
  * separately do not reorder what the shell offers; an unlisted name lists
@@ -23,6 +30,7 @@
  * @module
  */
 import type { CommandEnvelope } from '@fnndsc/menu';
+import { type AnyCommandDeclaration } from './commandDeclaration.js';
 /** A builtin that returns its outcome as an envelope. */
 export type EnvelopeHandler = (args: string[]) => Promise<CommandEnvelope>;
 /** A builtin that may print, and returns an envelope or nothing. */
@@ -68,6 +76,11 @@ export interface CommandGroup {
      * side by side. A command not named here holds the whole session.
      */
     holds?: Record<string, readonly SessionPiece[]>;
+    /**
+     * Commands declared in one record each: handler, help and holds come from
+     * the declaration, so a declared name appears in none of the records above.
+     */
+    declarations?: ReadonlyArray<AnyCommandDeclaration>;
 }
 /**
  * A piece of session state a line may change: the working directory, or
@@ -109,6 +122,30 @@ export declare function commandOrder_set(order: {
  * @throws {Error} When a backend's group names a core command.
  */
 export declare function commands_register(group: CommandGroup, owner?: CommandOwner): void;
+/**
+ * A command's declaration, when it has one, by its name or an alias.
+ *
+ * @param name - The command name, or an alias of it (`feeds`).
+ * @returns The declaration (an alias's named as the alias), or undefined for a command not yet declared in one record.
+ *
+ * @example
+ * ```ts
+ * commandDeclaration_get('ls')?.grammar;
+ * commandDeclaration_get('feeds')?.name; // 'feeds', the feed command under that word
+ * ```
+ */
+export declare function commandDeclaration_get(name: string): AnyCommandDeclaration | undefined;
+/**
+ * Every declared command, in registration order.
+ *
+ * @returns The declarations.
+ *
+ * @example
+ * ```ts
+ * commandDeclarations_list().map((declaration) => declaration.name);
+ * ```
+ */
+export declare function commandDeclarations_list(): AnyCommandDeclaration[];
 /**
  * What a command holds of the session while it runs.
  * @param name - The command name.