@fnndsc/brasa 0.56.2 → 0.56.4

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

@@ -1,4 +1,5 @@
 import { CommandEnvelope } from '@fnndsc/menu';
+import { type CommandDeclaration } from '../../core/commandDeclaration.js';
 /** The programs a GAMES pane can run. */
 export type ShowProgram = 'sl' | 'cmatrix' | 'rain' | 'aquarium' | 'tetris' | 'snake';
 /**
@@ -13,15 +14,139 @@ export declare const STARSHIP: ReadonlyArray<string>;
 export declare const MATRIX_GLYPHS: string;
 /** A still of a show, for a console with no canvas. */
 export declare function still_render(program: ShowProgram, random?: () => number): string[];
-/** `sl`: a starship crosses the screen. */
+/** What a showpiece's line may hold: the one switch that sends it to ARGUS's GAMES pane. */
+declare const SHOW_GRAMMAR: {
+    readonly options: {
+        readonly pane: {
+            readonly long: "pane";
+            readonly summary: "Draw it in ARGUS's GAMES pane instead of the terminal";
+        };
+    };
+};
+/**
+ * `sl [--pane]`: the declaration.
+ *
+ * @example
+ * ```ts
+ * commands_register({ declarations: [slCommand] });
+ * ```
+ */
+export declare const slCommand: CommandDeclaration<typeof SHOW_GRAMMAR>;
+/**
+ * `sl` over words already split: the declaration's parse and handler.
+ *
+ * @param args - The words after `sl`.
+ * @returns The show, or the refusal of a bad line.
+ *
+ * @example
+ * ```ts
+ * await builtin_sl(['--pane']);
+ * ```
+ */
 export declare function builtin_sl(args: string[]): Promise<CommandEnvelope>;
-/** `cmatrix`: the glyph rain. */
+/**
+ * `cmatrix [--pane]`: the declaration.
+ *
+ * @example
+ * ```ts
+ * commands_register({ declarations: [cmatrixCommand] });
+ * ```
+ */
+export declare const cmatrixCommand: CommandDeclaration<typeof SHOW_GRAMMAR>;
+/**
+ * `cmatrix` over words already split: the declaration's parse and handler.
+ *
+ * @param args - The words after `cmatrix`.
+ * @returns The show, or the refusal of a bad line.
+ *
+ * @example
+ * ```ts
+ * await builtin_cmatrix(['--pane']);
+ * ```
+ */
 export declare function builtin_cmatrix(args: string[]): Promise<CommandEnvelope>;
-/** `rain`: rain. */
+/**
+ * `rain [--pane]`: the declaration.
+ *
+ * @example
+ * ```ts
+ * commands_register({ declarations: [rainCommand] });
+ * ```
+ */
+export declare const rainCommand: CommandDeclaration<typeof SHOW_GRAMMAR>;
+/**
+ * `rain` over words already split: the declaration's parse and handler.
+ *
+ * @param args - The words after `rain`.
+ * @returns The show, or the refusal of a bad line.
+ *
+ * @example
+ * ```ts
+ * await builtin_rain(['--pane']);
+ * ```
+ */
 export declare function builtin_rain(args: string[]): Promise<CommandEnvelope>;
-/** `asciiquarium`: fish. */
+/**
+ * `asciiquarium [--pane]`: the declaration.
+ *
+ * @example
+ * ```ts
+ * commands_register({ declarations: [asciiquariumCommand] });
+ * ```
+ */
+export declare const asciiquariumCommand: CommandDeclaration<typeof SHOW_GRAMMAR>;
+/**
+ * `asciiquarium` over words already split: the declaration's parse and handler.
+ *
+ * @param args - The words after `asciiquarium`.
+ * @returns The show, or the refusal of a bad line.
+ *
+ * @example
+ * ```ts
+ * await builtin_asciiquarium(['--pane']);
+ * ```
+ */
 export declare function builtin_asciiquarium(args: string[]): Promise<CommandEnvelope>;
-/** `tetris`: falling blocks. */
+/**
+ * `tetris [--pane]`: the declaration.
+ *
+ * @example
+ * ```ts
+ * commands_register({ declarations: [tetrisCommand] });
+ * ```
+ */
+export declare const tetrisCommand: CommandDeclaration<typeof SHOW_GRAMMAR>;
+/**
+ * `tetris` over words already split: the declaration's parse and handler.
+ *
+ * @param args - The words after `tetris`.
+ * @returns The show, or the refusal of a bad line.
+ *
+ * @example
+ * ```ts
+ * await builtin_tetris(['--pane']);
+ * ```
+ */
 export declare function builtin_tetris(args: string[]): Promise<CommandEnvelope>;
-/** `snake`: the snake. */
+/**
+ * `snake [--pane]`: the declaration.
+ *
+ * @example
+ * ```ts
+ * commands_register({ declarations: [snakeCommand] });
+ * ```
+ */
+export declare const snakeCommand: CommandDeclaration<typeof SHOW_GRAMMAR>;
+/**
+ * `snake` over words already split: the declaration's parse and handler.
+ *
+ * @param args - The words after `snake`.
+ * @returns The show, or the refusal of a bad line.
+ *
+ * @example
+ * ```ts
+ * await builtin_snake(['--pane']);
+ * ```
+ */
 export declare function builtin_snake(args: string[]): Promise<CommandEnvelope>;
+export {};

package/dist/builtins/games/show.js

@@ -11,7 +11,9 @@
  * @module
  */
 import chalk from 'chalk';
-import { envelope_ok, envelope_error } from '@fnndsc/menu';
+import { envelope_ok } from '@fnndsc/menu';
+import { command_declare } from '../../core/commandDeclaration.js';
+import { declaredCommand_run } from '../../core/commandParse.js';
 /**
  * The starship `sl` sends across the screen (a typo's punishment, as the
  * train was): the Constitution-class refit, side view, from the Star Trek
@@ -57,25 +59,211 @@ function note_render(program, arcade, pane) {
         return chalk.gray(`${program}: ARGUS draws it in its GAMES pane${arcade ? ' with the keys live (arrows; Esc gives the keyboard back)' : ''}.`);
     return chalk.gray(`${program}: a terminal plays it in place${arcade ? ' (arrows steer)' : ''}; q, Esc or Ctrl-C leaves. --pane draws it in ARGUS's GAMES pane.`);
 }
-function show_run(program, args, arcade) {
-    const unknown = args.find((arg) => arg.startsWith('-') && arg !== '--pane');
-    if (unknown !== undefined)
-        return envelope_error(`${program}: unknown option '${unknown}' (--pane)\n`);
-    const pane = args.includes('--pane');
-    const rest = args.filter((arg) => arg !== '--pane');
+/** What a showpiece's line may hold: the one switch that sends it to ARGUS's GAMES pane. */
+const SHOW_GRAMMAR = {
+    options: {
+        pane: { long: 'pane', summary: "Draw it in ARGUS's GAMES pane instead of the terminal" },
+    },
+};
+/**
+ * Declares a showpiece: one program on the cell grid, with the one `--pane` switch.
+ *
+ * @param name - The word that runs it.
+ * @param program - The program a GAMES pane runs.
+ * @param arcade - Whether the keys play it (an arcade game) or it only shows.
+ * @param prose - Its summary, description and examples.
+ * @returns The declaration.
+ *
+ * @example
+ * ```ts
+ * export const slCommand = showCommand_make('sl', 'sl', false, { summary: 'A starship crosses the screen', description: '…', examples: ['sl'] });
+ * ```
+ */
+function showCommand_make(name, program, arcade, prose) {
+    return command_declare({
+        name,
+        grammar: SHOW_GRAMMAR,
+        help: prose,
+        handler: async (args) => show_run(program, arcade, args.options.pane),
+    });
+}
+/**
+ * Runs a showpiece: a still of it, and how the moving one is played.
+ *
+ * @param program - The program.
+ * @param arcade - Whether the keys play it.
+ * @param pane - Whether ARGUS's GAMES pane draws it.
+ * @returns The still and the note, on the `games.show` model.
+ *
+ * @example
+ * ```ts
+ * show_run('sl', false, true);
+ * ```
+ */
+function show_run(program, arcade, pane) {
     const still = still_render(program);
-    return envelope_ok(`${still.join('\n')}\n${note_render(program, arcade, pane)}\n`, { kind: 'games.show', data: { program, args: rest, arcade, pane } });
+    return envelope_ok(`${still.join('\n')}\n${note_render(program, arcade, pane)}\n`, { kind: 'games.show', data: { program, args: [], arcade, pane } });
+}
+/**
+ * `sl [--pane]`: the declaration.
+ *
+ * @example
+ * ```ts
+ * commands_register({ declarations: [slCommand] });
+ * ```
+ */
+export const slCommand = showCommand_make('sl', 'sl', false, {
+    summary: 'A starship crosses the screen (the punishment for mistyping ls)',
+    description: "The train of old, refitted: a starship glides across the terminal. q, Esc or Ctrl-C gives the screen back. --pane draws it in ARGUS's GAMES pane instead (the transcript console always does).",
+    examples: ['sl', 'sl --pane'],
+});
+/**
+ * `sl` over words already split: the declaration's parse and handler.
+ *
+ * @param args - The words after `sl`.
+ * @returns The show, or the refusal of a bad line.
+ *
+ * @example
+ * ```ts
+ * await builtin_sl(['--pane']);
+ * ```
+ */
+export async function builtin_sl(args) {
+    return declaredCommand_run(slCommand, args);
+}
+/**
+ * `cmatrix [--pane]`: the declaration.
+ *
+ * @example
+ * ```ts
+ * commands_register({ declarations: [cmatrixCommand] });
+ * ```
+ */
+export const cmatrixCommand = showCommand_make('cmatrix', 'cmatrix', false, {
+    summary: 'The glyph rain',
+    description: "Columns of glyphs falling down the terminal. q, Esc or Ctrl-C gives the screen back. --pane draws it in ARGUS's GAMES pane instead (the transcript console always does).",
+    examples: ['cmatrix', 'cmatrix --pane'],
+});
+/**
+ * `cmatrix` over words already split: the declaration's parse and handler.
+ *
+ * @param args - The words after `cmatrix`.
+ * @returns The show, or the refusal of a bad line.
+ *
+ * @example
+ * ```ts
+ * await builtin_cmatrix(['--pane']);
+ * ```
+ */
+export async function builtin_cmatrix(args) {
+    return declaredCommand_run(cmatrixCommand, args);
+}
+/**
+ * `rain [--pane]`: the declaration.
+ *
+ * @example
+ * ```ts
+ * commands_register({ declarations: [rainCommand] });
+ * ```
+ */
+export const rainCommand = showCommand_make('rain', 'rain', false, {
+    summary: 'Rain',
+    description: "Drops falling and ringing out on the floor of the terminal. q, Esc or Ctrl-C gives the screen back. --pane draws it in ARGUS's GAMES pane instead (the transcript console always does).",
+    examples: ['rain'],
+});
+/**
+ * `rain` over words already split: the declaration's parse and handler.
+ *
+ * @param args - The words after `rain`.
+ * @returns The show, or the refusal of a bad line.
+ *
+ * @example
+ * ```ts
+ * await builtin_rain(['--pane']);
+ * ```
+ */
+export async function builtin_rain(args) {
+    return declaredCommand_run(rainCommand, args);
+}
+/**
+ * `asciiquarium [--pane]`: the declaration.
+ *
+ * @example
+ * ```ts
+ * commands_register({ declarations: [asciiquariumCommand] });
+ * ```
+ */
+export const asciiquariumCommand = showCommand_make('asciiquarium', 'aquarium', false, {
+    summary: 'An aquarium: fish, weed, bubbles',
+    description: "Fish swimming both ways, weed swaying, bubbles rising, in the terminal. q, Esc or Ctrl-C gives the screen back. --pane draws it in ARGUS's GAMES pane instead (the transcript console always does).",
+    examples: ['asciiquarium'],
+});
+/**
+ * `asciiquarium` over words already split: the declaration's parse and handler.
+ *
+ * @param args - The words after `asciiquarium`.
+ * @returns The show, or the refusal of a bad line.
+ *
+ * @example
+ * ```ts
+ * await builtin_asciiquarium(['--pane']);
+ * ```
+ */
+export async function builtin_asciiquarium(args) {
+    return declaredCommand_run(asciiquariumCommand, args);
+}
+/**
+ * `tetris [--pane]`: the declaration.
+ *
+ * @example
+ * ```ts
+ * commands_register({ declarations: [tetrisCommand] });
+ * ```
+ */
+export const tetrisCommand = showCommand_make('tetris', 'tetris', true, {
+    summary: 'Falling blocks',
+    description: "Played in the terminal: left/right move, up rotates, down drops. q, Esc or Ctrl-C gives the screen back. --pane draws it in ARGUS's GAMES pane instead (the transcript console always does).",
+    examples: ['tetris', 'tetris --pane'],
+});
+/**
+ * `tetris` over words already split: the declaration's parse and handler.
+ *
+ * @param args - The words after `tetris`.
+ * @returns The show, or the refusal of a bad line.
+ *
+ * @example
+ * ```ts
+ * await builtin_tetris(['--pane']);
+ * ```
+ */
+export async function builtin_tetris(args) {
+    return declaredCommand_run(tetrisCommand, args);
+}
+/**
+ * `snake [--pane]`: the declaration.
+ *
+ * @example
+ * ```ts
+ * commands_register({ declarations: [snakeCommand] });
+ * ```
+ */
+export const snakeCommand = showCommand_make('snake', 'snake', true, {
+    summary: 'The snake',
+    description: "Played in the terminal: arrows (or hjkl, wasd) steer; eat the food, do not eat yourself. q, Esc or Ctrl-C gives the screen back. --pane draws it in ARGUS's GAMES pane instead (the transcript console always does).",
+    examples: ['snake'],
+});
+/**
+ * `snake` over words already split: the declaration's parse and handler.
+ *
+ * @param args - The words after `snake`.
+ * @returns The show, or the refusal of a bad line.
+ *
+ * @example
+ * ```ts
+ * await builtin_snake(['--pane']);
+ * ```
+ */
+export async function builtin_snake(args) {
+    return declaredCommand_run(snakeCommand, args);
 }
-/** `sl`: a starship crosses the screen. */
-export async function builtin_sl(args) { return show_run('sl', args, false); }
-/** `cmatrix`: the glyph rain. */
-export async function builtin_cmatrix(args) { return show_run('cmatrix', args, false); }
-/** `rain`: rain. */
-export async function builtin_rain(args) { return show_run('rain', args, false); }
-/** `asciiquarium`: fish. */
-export async function builtin_asciiquarium(args) { return show_run('aquarium', args, false); }
-/** `tetris`: falling blocks. */
-export async function builtin_tetris(args) { return show_run('tetris', args, true); }
-/** `snake`: the snake. */
-export async function builtin_snake(args) { return show_run('snake', args, true); }
 //# sourceMappingURL=show.js.map

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

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

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

@@ -1,5 +1,6 @@
 import { type WeatherFetch, type WeatherPlace } from '../sys/weather.js';
 import { CommandEnvelope } from '@fnndsc/menu';
+import { type CommandDeclaration } from '../../core/commandDeclaration.js';
 /** A date as a Julian day. */
 export declare function julianDay_compute(date: Date): number;
 /** The moon's state on a date. */
@@ -18,15 +19,93 @@ export interface MoonPhase {
 export declare function moon_phase(date: Date): MoonPhase;
 /** A small moon, lit from the side the phase lights. */
 export declare function moon_draw(phase: MoonPhase): string[];
-/** `pom [YYYY-MM-DD]` */
+/**
+ * `pom [date]`: the declaration.
+ *
+ * @example
+ * ```ts
+ * commands_register({ declarations: [pomCommand] });
+ * ```
+ */
+export declare const pomCommand: CommandDeclaration<{
+    readonly operands: readonly [{
+        readonly name: "date";
+        readonly kind: "word";
+        readonly optional: true;
+        readonly repeat: true;
+        readonly summary: "The date to look at (default: today)";
+    }];
+}>;
+/**
+ * `pom` over words already split: the declaration's parse and handler.
+ *
+ * @param args - The words after `pom`.
+ * @returns The answer, or the refusal of a bad line.
+ *
+ * @example
+ * ```ts
+ * await builtin_pom(['2026-12-25']);
+ * ```
+ */
 export declare function builtin_pom(args: string[]): Promise<CommandEnvelope>;
+/**
+ * Runs `pom` on a date.
+ *
+ * @param words - The date's words, none for today.
+ * @returns The answer, or a refusal for words that are not a date.
+ *
+ * @example
+ * ```ts
+ * await pom_run(['2026-12-25']);
+ * ```
+ */
+export declare function pom_run(words: readonly string[]): Promise<CommandEnvelope>;
 /** The stardate two ways: the Kelvin films' `YYYY.DDD`, and TNG's thousand-per-year from 2323. */
 export declare function stardate_derive(date: Date): {
     kelvin: string;
     tng: string;
 };
-/** `stardate` */
+/**
+ * `stardate [date]`: the declaration.
+ *
+ * @example
+ * ```ts
+ * commands_register({ declarations: [stardateCommand] });
+ * ```
+ */
+export declare const stardateCommand: CommandDeclaration<{
+    readonly operands: readonly [{
+        readonly name: "date";
+        readonly kind: "word";
+        readonly optional: true;
+        readonly repeat: true;
+        readonly summary: "The date to reckon (default: today)";
+    }];
+}>;
+/**
+ * `stardate` over words already split: the declaration's parse and handler.
+ *
+ * @param args - The words after `stardate`.
+ * @returns The answer, or the refusal of a bad line.
+ *
+ * @example
+ * ```ts
+ * await builtin_stardate(['2366-01-01']);
+ * ```
+ */
 export declare function builtin_stardate(args: string[]): Promise<CommandEnvelope>;
+/**
+ * Runs `stardate` on a date.
+ *
+ * @param words - The date's words, none for today.
+ * @returns The answer, or a refusal for words that are not a date.
+ *
+ * @example
+ * ```ts
+ * await stardate_run(['2366-01-01']);
+ * ```
+ */
+export declare function stardate_run(words: readonly string[]): Promise<CommandEnvelope>;
 /** The Discordian date of a Gregorian one. */
 export interface DiscordianDate {
     yold: number;
@@ -39,8 +118,47 @@ export interface DiscordianDate {
 export declare function ddate_derive(date: Date): DiscordianDate;
 /** 1st, 2nd, 3rd, 4th … 11th, 12th, 13th … 21st. */
 export declare function ordinal_format(n: number): string;
-/** `ddate [YYYY-MM-DD]` */
+/**
+ * `ddate [date]`: the declaration.
+ *
+ * @example
+ * ```ts
+ * commands_register({ declarations: [ddateCommand] });
+ * ```
+ */
+export declare const ddateCommand: CommandDeclaration<{
+    readonly operands: readonly [{
+        readonly name: "date";
+        readonly kind: "word";
+        readonly optional: true;
+        readonly repeat: true;
+        readonly summary: "The date to convert (default: today)";
+    }];
+}>;
+/**
+ * `ddate` over words already split: the declaration's parse and handler.
+ *
+ * @param args - The words after `ddate`.
+ * @returns The answer, or the refusal of a bad line.
+ *
+ * @example
+ * ```ts
+ * await builtin_ddate(['2028-02-29']);
+ * ```
+ */
 export declare function builtin_ddate(args: string[]): Promise<CommandEnvelope>;
+/**
+ * Runs `ddate` on a date.
+ *
+ * @param words - The date's words, none for today.
+ * @returns The answer, or a refusal for words that are not a date.
+ *
+ * @example
+ * ```ts
+ * await ddate_run(['2028-02-29']);
+ * ```
+ */
+export declare function ddate_run(words: readonly string[]): Promise<CommandEnvelope>;
 /** What Open-Meteo says of one day's sun. */
 export interface SunDay {
     date: string;
@@ -55,5 +173,61 @@ export interface SunDay {
  * @param place - Where.
  */
 export declare function sun_fetch(fetchFn: WeatherFetch, place: WeatherPlace): Promise<SunDay[]>;
-/** `sunrise [place]` */
+/** What `sunrise` takes: a place, in as many words as it is named. */
+declare const SUNRISE_GRAMMAR: {
+    readonly operands: readonly [{
+        readonly name: "place";
+        readonly kind: "word";
+        readonly optional: true;
+        readonly repeat: true;
+        readonly summary: "The place (default: Boston)";
+    }];
+};
+/**
+ * Declares `sunrise` over a fetch (a test hands in its own).
+ *
+ * @param fetchFn - The fetch the command asks Open-Meteo with.
+ * @returns The declaration.
+ *
+ * @example
+ * ```ts
+ * const command = sunriseCommand_make(fakeFetch);
+ * ```
+ */
+export declare function sunriseCommand_make(fetchFn: WeatherFetch): CommandDeclaration<typeof SUNRISE_GRAMMAR>;
+/**
+ * `sunrise [place]`: the declaration.
+ *
+ * @example
+ * ```ts
+ * commands_register({ declarations: [sunriseCommand] });
+ * ```
+ */
+export declare const sunriseCommand: CommandDeclaration<typeof SUNRISE_GRAMMAR>;
+/**
+ * `sunrise` over words already split: the declaration's parse and handler.
+ *
+ * @param args - The words after `sunrise`.
+ * @param fetchFn - The fetch to use.
+ * @returns The sun's days, or the refusal of a bad line.
+ *
+ * @example
+ * ```ts
+ * await builtin_sunrise(['Cape', 'Town']);
+ * ```
+ */
 export declare function builtin_sunrise(args: string[], fetchFn?: WeatherFetch): Promise<CommandEnvelope>;
+/**
+ * When the sun rises and sets at a place, today and tomorrow.
+ *
+ * @param words - The place's words, none for the default place.
+ * @param fetchFn - The fetch to use.
+ * @returns The sun's days, or a refusal.
+ *
+ * @example
+ * ```ts
+ * await sunrise_run(['Tromsø'], fetch);
+ * ```
+ */
+export declare function sunrise_run(words: readonly string[], fetchFn: WeatherFetch): Promise<CommandEnvelope>;
+export {};