@fnndsc/brasa 0.56.2 → 0.56.3

package/dist/builtins/games/text.js

@@ -3,13 +3,17 @@
  *
  * Each reads what was piped in, else its arguments, and answers in kind:
  * `fortune | rev`, `rot13 hello`, `seq 1 2 9`. `yes` is bounded — a shell
- * that never ends is not a toy — and says how many it printed.
+ * that never ends is not a toy — and says how many it printed. Each is
+ * declared in one record (`revCommand`, `tacCommand`, `yesCommand`,
+ * `seqCommand`, `shufCommand`, `rot13Command`).
  *
  * @module
  */
 import chalk from 'chalk';
 import { text_input } from './stdin.js';
 import { envelope_ok, envelope_error } from '@fnndsc/menu';
+import { command_declare } from '../../core/commandDeclaration.js';
+import { declaredCommand_run } from '../../core/commandParse.js';
 /** Lines `yes` prints when not told how many. */
 export const YES_DEFAULT = 10;
 /** The most lines `yes` prints however it is asked. */
@@ -36,11 +40,16 @@ export function text_rot13(text) {
 /**
  * The numbers `seq` prints: `seq LAST`, `seq FIRST LAST`, `seq FIRST STEP LAST`.
  *
+ * @param nums - One to three numbers, as the line gave them.
  * @returns The numbers, or a refusal.
+ *
+ * @example
+ * ```ts
+ * seq_numbers([2, 5]); // { numbers: [2, 3, 4, 5] }
+ * ```
  */
-export function seq_numbers(args) {
-    const nums = args.map(Number);
-    if (nums.length === 0 || nums.length > 3 || nums.some((n) => !Number.isFinite(n))) {
+export function seq_numbers(nums) {
+    if (nums.length === 0 || nums.length > 3) {
         return { refusal: 'seq: usage: seq [FIRST [STEP]] LAST' };
     }
     const [first, step, last] = nums.length === 1 ? [1, 1, nums[0]]
@@ -65,66 +74,338 @@ export function lines_shuffle(lines, random = Math.random) {
     }
     return out;
 }
-/** `rev [text]` */
+/** The words of a toy that works on text: what is piped in, else these. */
+const TEXT_OPERAND = { name: 'text', kind: 'word', optional: true, repeat: true, summary: 'The text to work on (default: what is piped in)' };
+/** What a `rev` line may hold. */
+const REV_GRAMMAR = { operands: [TEXT_OPERAND] };
+/**
+ * `rev [text]`: the declaration.
+ *
+ * @example
+ * ```ts
+ * commands_register({ declarations: [revCommand] });
+ * ```
+ */
+export const revCommand = command_declare({
+    name: 'rev',
+    grammar: REV_GRAMMAR,
+    help: {
+        summary: 'Reverse each line',
+        description: 'Reverses the characters of each line, keeping the lines in order. Reads what is piped in, else the words given.',
+        examples: ['rev stressed', 'fortune | rev'],
+        posix: { group: 'Text', differs: 'reads a pipe or its words' },
+    },
+    holds: [],
+    handler: async (args) => rev_run(args.operands.text),
+});
+/**
+ * `rev` over words already split: the declaration's parse and handler.
+ *
+ * @param args - The words after `rev`.
+ * @returns The reversed text, or the refusal of a bad line.
+ *
+ * @example
+ * ```ts
+ * await builtin_rev(['stressed']);
+ * ```
+ */
 export async function builtin_rev(args) {
-    const text = text_input(args);
+    return declaredCommand_run(revCommand, args);
+}
+/**
+ * Reverses each line of the piped text, else of the words.
+ *
+ * @param words - The words given.
+ * @returns The reversed text, or a refusal when there is none.
+ *
+ * @example
+ * ```ts
+ * await rev_run(['stressed']); // desserts
+ * ```
+ */
+export async function rev_run(words) {
+    const text = text_input(words);
     if (text === null)
         return envelope_error('', undefined, 'rev: nothing to reverse (pipe text in, or give it)\n');
     const out = text_rev(text.replace(/\n$/, ''));
     return envelope_ok(`${out}\n`, { kind: 'games.rev', data: { text: out } });
 }
-/** `tac [text]` */
+/** What a `tac` line may hold. */
+const TAC_GRAMMAR = { operands: [TEXT_OPERAND] };
+/**
+ * `tac [text]`: the declaration.
+ *
+ * @example
+ * ```ts
+ * commands_register({ declarations: [tacCommand] });
+ * ```
+ */
+export const tacCommand = command_declare({
+    name: 'tac',
+    grammar: TAC_GRAMMAR,
+    help: {
+        summary: 'Lines last to first',
+        description: 'cat backwards: prints the lines in reverse order. Reads what is piped in.',
+        examples: ['help games | tac', 'seq 5 | tac'],
+        posix: { group: 'Text', differs: 'reads a pipe or its words' },
+    },
+    holds: [],
+    handler: async (args) => tac_run(args.operands.text),
+});
+/**
+ * `tac` over words already split: the declaration's parse and handler.
+ *
+ * @param args - The words after `tac`.
+ * @returns The lines last to first, or the refusal of a bad line.
+ *
+ * @example
+ * ```ts
+ * await builtin_tac(['a']);
+ * ```
+ */
 export async function builtin_tac(args) {
-    const text = text_input(args);
+    return declaredCommand_run(tacCommand, args);
+}
+/**
+ * Turns the lines of the piped text, else of the words, last to first.
+ *
+ * @param words - The words given.
+ * @returns The turned lines, or a refusal when there are none.
+ *
+ * @example
+ * ```ts
+ * await tac_run(['a', 'b']);
+ * ```
+ */
+export async function tac_run(words) {
+    const text = text_input(words);
     if (text === null)
         return envelope_error('', undefined, 'tac: nothing to turn over (pipe lines in)\n');
     const out = text_tac(text.endsWith('\n') ? text : `${text}\n`);
     return envelope_ok(out, { kind: 'games.tac', data: { text: out } });
 }
-/** `yes [word] [-n N]` */
+/** What a `yes` line may hold. */
+const YES_GRAMMAR = {
+    operands: [{ name: 'words', kind: 'word', optional: true, repeat: true, summary: 'The word to repeat (default y)' }],
+    options: {
+        count: { short: 'n', summary: 'Lines to print (default 10, at most 10000)', value: { name: 'N', kind: 'int', min: 1 } },
+    },
+};
+/**
+ * `yes [word] [-n N]`: the declaration.
+ *
+ * @example
+ * ```ts
+ * commands_register({ declarations: [yesCommand] });
+ * ```
+ */
+export const yesCommand = command_declare({
+    name: 'yes',
+    grammar: YES_GRAMMAR,
+    help: {
+        summary: 'Repeat a word (ten times, not forever)',
+        description: 'Prints a word on its own line, over and over — but bounded: ten times unless -n N asks for more (up to 10000), and it says how many it printed. The real yes runs until killed; a session is not the place.',
+        examples: ['yes', 'yes no -n 3', 'yes | head -n 2'],
+        posix: { group: 'Text', differs: 'bounded: ten lines unless told how many, never forever' },
+    },
+    handler: async (args) => yes_run(args.operands.words, args.options.count),
+});
+/**
+ * `yes` over words already split: the declaration's parse and handler.
+ *
+ * @param args - The words after `yes`.
+ * @returns The repeated lines, or the refusal of a bad line.
+ *
+ * @example
+ * ```ts
+ * await builtin_yes(['no', '-n', '3']);
+ * ```
+ */
 export async function builtin_yes(args) {
-    let count = YES_DEFAULT;
-    const words = [];
-    for (let i = 0; i < args.length; i++) {
-        if (args[i] === '-n') {
-            const n = Number(args[i + 1]);
-            if (!Number.isInteger(n) || n < 1)
-                return envelope_error('', undefined, 'yes: -n wants a positive whole number\n');
-            count = Math.min(n, YES_MAX);
-            i++;
-        }
-        else {
-            words.push(args[i]);
-        }
-    }
+    return declaredCommand_run(yesCommand, args);
+}
+/**
+ * Prints a word a bounded number of times.
+ *
+ * @param words - The words to repeat, joined by a space; none means `y`.
+ * @param requested - How many lines were asked for, or undefined for the default.
+ * @returns The lines and a note saying how many.
+ *
+ * @example
+ * ```ts
+ * await yes_run(['no'], 3);
+ * ```
+ */
+export async function yes_run(words, requested) {
+    const count = Math.min(requested ?? YES_DEFAULT, YES_MAX);
     const word = words.length > 0 ? words.join(' ') : 'y';
     const lines = `${word}\n`.repeat(count);
     // Bounded on purpose, and it says so: the real yes runs until killed.
     const note = chalk.gray(`yes: ${count} of forever (-n N for more, up to ${YES_MAX})\n`);
     return envelope_ok(lines + note, { kind: 'games.yes', data: { word, count } });
 }
-/** `seq [FIRST [STEP]] LAST` */
+/** What a `seq` line may hold. */
+const SEQ_GRAMMAR = {
+    operands: [{ name: 'numbers', kind: 'number', repeat: true, summary: '[FIRST [STEP]] LAST' }],
+};
+/**
+ * `seq [FIRST [STEP]] LAST`: the declaration.
+ *
+ * @example
+ * ```ts
+ * commands_register({ declarations: [seqCommand] });
+ * ```
+ */
+export const seqCommand = command_declare({
+    name: 'seq',
+    grammar: SEQ_GRAMMAR,
+    help: {
+        summary: 'Count from one number to another',
+        description: 'Prints the numbers from FIRST to LAST by STEP, one per line, as seq does: seq 5 is 1 to 5, seq 2 10 is 2 to 10, seq 10 -2 0 counts down. At most 100000 numbers.',
+        examples: ['seq 5', 'seq 0 5 30', 'seq 10 -1 1 | tac'],
+        posix: { group: 'Text', differs: 'as seq' },
+    },
+    holds: [],
+    handler: async (args) => seq_run(args.operands.numbers),
+});
+/**
+ * `seq` over words already split: the declaration's parse and handler.
+ *
+ * @param args - The words after `seq`.
+ * @returns The numbers, or the refusal of a bad line.
+ *
+ * @example
+ * ```ts
+ * await builtin_seq(['3']);
+ * ```
+ */
 export async function builtin_seq(args) {
-    const answer = seq_numbers(args);
+    return declaredCommand_run(seqCommand, args);
+}
+/**
+ * Prints a sequence of numbers.
+ *
+ * @param nums - FIRST, STEP and LAST as the line gave them (one to three).
+ * @returns The numbers one per line, or a refusal.
+ *
+ * @example
+ * ```ts
+ * await seq_run([1, 2, 9]);
+ * ```
+ */
+export async function seq_run(nums) {
+    const answer = seq_numbers(nums);
     if ('refusal' in answer)
         return envelope_error('', undefined, `${answer.refusal}\n`);
     const note = answer.numbers.length >= SEQ_MAX ? chalk.gray(`seq: stopped at ${SEQ_MAX} numbers\n`) : '';
     return envelope_ok(`${answer.numbers.join('\n')}\n${note}`, { kind: 'games.seq', data: { numbers: answer.numbers } });
 }
-/** `shuf [words...]`: lines piped in, or the words given, in a random order. */
+/** What a `shuf` line may hold. */
+const SHUF_GRAMMAR = {
+    operands: [{ name: 'words', kind: 'word', optional: true, repeat: true, summary: 'The words to shuffle (default: the lines piped in)' }],
+};
+/**
+ * `shuf [words...]`: the declaration.
+ *
+ * @example
+ * ```ts
+ * commands_register({ declarations: [shufCommand] });
+ * ```
+ */
+export const shufCommand = command_declare({
+    name: 'shuf',
+    grammar: SHUF_GRAMMAR,
+    help: {
+        summary: 'Shuffle lines',
+        description: 'Prints the lines piped in, or the words given, in a random order.',
+        examples: ['shuf a b c d', 'ls | shuf', 'seq 10 | shuf'],
+        posix: { group: 'Text', differs: 'reads a pipe or its words' },
+    },
+    handler: async (args) => shuf_run(args.operands.words),
+});
+/**
+ * `shuf` over words already split: the declaration's parse and handler.
+ *
+ * @param args - The words after `shuf`.
+ * @returns The shuffled lines, or the refusal of a bad line.
+ *
+ * @example
+ * ```ts
+ * await builtin_shuf(['a', 'b']);
+ * ```
+ */
 export async function builtin_shuf(args) {
+    return declaredCommand_run(shufCommand, args);
+}
+/**
+ * Shuffles the lines piped in, else the words given.
+ *
+ * @param words - The words given.
+ * @returns The lines in a random order, or a refusal when there are none.
+ *
+ * @example
+ * ```ts
+ * await shuf_run(['a', 'b', 'c']);
+ * ```
+ */
+export async function shuf_run(words) {
     const piped = text_input([]);
     const lines = piped !== null
         ? piped.replace(/\n$/, '').split('\n')
-        : args;
+        : [...words];
     if (lines.length === 0)
         return envelope_error('', undefined, 'shuf: nothing to shuffle (pipe lines in, or give words)\n');
     const out = lines_shuffle(lines);
     return envelope_ok(`${out.join('\n')}\n`, { kind: 'games.shuf', data: { lines: out } });
 }
-/** `rot13 [text]` */
+/** What a `rot13` line may hold. */
+const ROT13_GRAMMAR = { operands: [TEXT_OPERAND] };
+/**
+ * `rot13 [text]`: the declaration.
+ *
+ * @example
+ * ```ts
+ * commands_register({ declarations: [rot13Command] });
+ * ```
+ */
+export const rot13Command = command_declare({
+    name: 'rot13',
+    grammar: ROT13_GRAMMAR,
+    help: {
+        summary: 'Turn letters half the alphabet round',
+        description: 'ROT13: each letter moved thirteen places, so applying it twice gives the text back. Reads what is piped in, else the words given.',
+        examples: ['rot13 hello', 'fortune | rot13 | rot13'],
+    },
+    holds: [],
+    handler: async (args) => rot13_run(args.operands.text),
+});
+/**
+ * `rot13` over words already split: the declaration's parse and handler.
+ *
+ * @param args - The words after `rot13`.
+ * @returns The turned text, or the refusal of a bad line.
+ *
+ * @example
+ * ```ts
+ * await builtin_rot13(['hello']);
+ * ```
+ */
 export async function builtin_rot13(args) {
-    const text = text_input(args);
+    return declaredCommand_run(rot13Command, args);
+}
+/**
+ * Turns the piped text, else the words, thirteen places round the alphabet.
+ *
+ * @param words - The words given.
+ * @returns The turned text, or a refusal when there is none.
+ *
+ * @example
+ * ```ts
+ * await rot13_run(['hello']); // uryyb
+ * ```
+ */
+export async function rot13_run(words) {
+    const text = text_input(words);
     if (text === null)
         return envelope_error('', undefined, 'rot13: nothing to turn (pipe text in, or give it)\n');
     const out = text_rot13(text.replace(/\n$/, ''));

package/dist/builtins/games/text.js.map

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

package/dist/builtins/games/trek.d.ts

@@ -1,8 +1,72 @@
 import { CommandEnvelope } from '@fnndsc/menu';
 /**
- * `trek [--classic] [-f | -s] [--seed N]`.
+ * `trek [--classic] [-f | -s] [--seed N] [--credits]`: the declaration.
  *
- * @param args - The words after the command.
- * @returns The game's end.
+ * @example
+ * ```ts
+ * commands_register({ declarations: [trekCommand] });
+ * ```
+ */
+export declare const trekCommand: import("../../core/commandDeclaration.js").CommandDeclaration<{
+    readonly options: {
+        readonly classic: {
+            readonly long: "classic";
+            readonly summary: "Show the scans as printed in 1976, without glyphs or colour";
+        };
+        readonly fast: {
+            readonly short: "f";
+            readonly summary: "The original fast mode";
+        };
+        readonly slow: {
+            readonly short: "s";
+            readonly summary: "The original slow mode";
+        };
+        readonly seed: {
+            readonly long: "seed";
+            readonly summary: "Replay the galaxy of this seed";
+            readonly value: {
+                readonly name: "N";
+                readonly kind: "int";
+            };
+        };
+        readonly credits: {
+            readonly long: "credits";
+            readonly summary: "Name who made the game, instead of playing it";
+        };
+    };
+}>;
+/**
+ * `trek` over words already split: the declaration's parse and handler.
+ *
+ * @param args - The words after `trek`.
+ * @returns The game's end, or the refusal of a bad line.
+ *
+ * @example
+ * ```ts
+ * await builtin_trek(['--seed', '42']);
+ * ```
  */
 export declare function builtin_trek(args: string[]): Promise<CommandEnvelope>;
+/**
+ * Plays `trek`, or names who made it.
+ *
+ * @param options - The line's options.
+ * @param options.classic - The original look.
+ * @param options.fast - The original fast mode.
+ * @param options.slow - The original slow mode (it wins over fast).
+ * @param options.seed - The galaxy's seed; absent, the clock's.
+ * @param options.credits - Name the makers instead of playing.
+ * @returns The game's end.
+ *
+ * @example
+ * ```ts
+ * await trek_run({ classic: true, fast: false, slow: false, seed: 42, credits: false });
+ * ```
+ */
+export declare function trek_run(options: {
+    readonly classic: boolean;
+    readonly fast: boolean;
+    readonly slow: boolean;
+    readonly seed: number | undefined;
+    readonly credits: boolean;
+}): Promise<CommandEnvelope>;

package/dist/builtins/games/trek.js

@@ -13,7 +13,9 @@
  */
 import chalk from 'chalk';
 import { envelope_error, envelope_ok } from '@fnndsc/menu';
-import { TREK_CREDITS, trek_play, trekArgs_parse } from 'bsd-trek';
+import { TREK_CREDITS, trek_play } from 'bsd-trek';
+import { command_declare } from '../../core/commandDeclaration.js';
+import { declaredCommand_run } from '../../core/commandParse.js';
 import { repl_question } from '../../core/question.js';
 import { sink_get } from '../../core/sink.js';
 /** The session's saved game: `dump` writes it, a `restart` length reads it back. */
@@ -39,21 +41,72 @@ const SESSION_TERMINAL = {
     seconds_sleep: (seconds) => new Promise((resolve) => { setTimeout(resolve, seconds * 1000); }),
     state_show: (state) => { sink_get().event_write?.('games.trek.state', state); },
 };
+/** What a `trek` line may hold: the look, the pace, the galaxy's seed, the credits. */
+const TREK_GRAMMAR = {
+    options: {
+        classic: { long: 'classic', summary: 'Show the scans as printed in 1976, without glyphs or colour' },
+        fast: { short: 'f', summary: 'The original fast mode' },
+        slow: { short: 's', summary: 'The original slow mode' },
+        seed: { long: 'seed', summary: 'Replay the galaxy of this seed', value: { name: 'N', kind: 'int' } },
+        credits: { long: 'credits', summary: 'Name who made the game, instead of playing it' },
+    },
+};
 /**
- * `trek [--classic] [-f | -s] [--seed N]`.
+ * `trek [--classic] [-f | -s] [--seed N] [--credits]`: the declaration.
  *
- * @param args - The words after the command.
- * @returns The game's end.
+ * @example
+ * ```ts
+ * commands_register({ declarations: [trekCommand] });
+ * ```
+ */
+export const trekCommand = command_declare({
+    name: 'trek',
+    grammar: TREK_GRAMMAR,
+    help: {
+        summary: 'The 1976 Berkeley space war game (BSD trek)',
+        description: 'Command a starship against an invading fleet across an 8×8 galaxy of quadrants, by question: srscan, lrscan, move, phasers, torpedo, shield, dock, computer and the rest (? at any prompt lists the answers it takes). Answers can be typed ahead on one line, as in the original. The scans wear glyphs and colours; --classic shows them as printed in 1976. -f and -s are the original fast and slow modes; --seed N replays a galaxy; --credits (or credits in the game) names who made it. terminate ends a game; answer no to Another game to leave.',
+        examples: ['trek', 'trek --classic', 'trek --seed 42', 'trek --credits'],
+    },
+    handler: async (args) => trek_run(args.options),
+});
+/**
+ * `trek` over words already split: the declaration's parse and handler.
+ *
+ * @param args - The words after `trek`.
+ * @returns The game's end, or the refusal of a bad line.
+ *
+ * @example
+ * ```ts
+ * await builtin_trek(['--seed', '42']);
+ * ```
  */
 export async function builtin_trek(args) {
-    const asked = trekArgs_parse(args);
-    if ('refusal' in asked)
-        return envelope_error('', undefined, `${asked.refusal}\n`);
-    if (asked.credits)
+    return declaredCommand_run(trekCommand, args);
+}
+/**
+ * Plays `trek`, or names who made it.
+ *
+ * @param options - The line's options.
+ * @param options.classic - The original look.
+ * @param options.fast - The original fast mode.
+ * @param options.slow - The original slow mode (it wins over fast).
+ * @param options.seed - The galaxy's seed; absent, the clock's.
+ * @param options.credits - Name the makers instead of playing.
+ * @returns The game's end.
+ *
+ * @example
+ * ```ts
+ * await trek_run({ classic: true, fast: false, slow: false, seed: 42, credits: false });
+ * ```
+ */
+export async function trek_run(options) {
+    if (options.credits)
         return envelope_ok(TREK_CREDITS, { kind: 'games.trek.credits', data: {} });
+    const seed = options.seed ?? Math.floor(Date.now() / 1000);
+    const fast = options.slow ? 0 : options.fast ? 2 : 1;
     try {
-        const code = await trek_play(SESSION_TERMINAL, { seed: asked.seed, fast: asked.fast, trace: 0, styled: !asked.classic && chalk.level > 0 }, TREK_DUMP);
-        return envelope_ok('', { kind: 'games.trek', data: { seed: asked.seed, exit: code } });
+        const code = await trek_play(SESSION_TERMINAL, { seed, fast, trace: 0, styled: !options.classic && chalk.level > 0 }, TREK_DUMP);
+        return envelope_ok('', { kind: 'games.trek', data: { seed, exit: code } });
     }
     catch (error) {
         return envelope_error('', undefined, `trek: cannot ask here (${error instanceof Error ? error.message : String(error)})\n`);

package/dist/builtins/games/trek.js.map

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