@fnndsc/brasa 0.31.5 → 0.32.1

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

@@ -0,0 +1,18 @@
+/**
+ * @file `morse`: text to code and back.
+ *
+ * `morse hello` taps it out; `morse -d .... . .-.. .-.. ---` reads it. One
+ * space between letters, a slash between words, as operators write it. The
+ * typed model carries the code so a surface with a speaker can sound it.
+ *
+ * @module
+ */
+import { CommandEnvelope } from '@fnndsc/cumin';
+/** The International code. */
+export declare const MORSE: Readonly<Record<string, string>>;
+/** Text to code: letters a space apart, words a slash apart; an unknown character is dropped. */
+export declare function morse_encode(text: string): string;
+/** Code to text: a group the code does not know becomes `?`. */
+export declare function morse_decode(code: string): string;
+/** `morse [-d] [text]` */
+export declare function builtin_morse(args: string[]): Promise<CommandEnvelope>;

package/dist/builtins/games/morse.js

@@ -0,0 +1,46 @@
+/**
+ * @file `morse`: text to code and back.
+ *
+ * `morse hello` taps it out; `morse -d .... . .-.. .-.. ---` reads it. One
+ * space between letters, a slash between words, as operators write it. The
+ * typed model carries the code so a surface with a speaker can sound it.
+ *
+ * @module
+ */
+import { envelope_ok, envelope_error } from '@fnndsc/cumin';
+import { text_input } from './stdin.js';
+/** The International code. */
+export const MORSE = {
+    A: '.-', B: '-...', C: '-.-.', D: '-..', E: '.', F: '..-.', G: '--.', H: '....', I: '..', J: '.---',
+    K: '-.-', L: '.-..', M: '--', N: '-.', O: '---', P: '.--.', Q: '--.-', R: '.-.', S: '...', T: '-',
+    U: '..-', V: '...-', W: '.--', X: '-..-', Y: '-.--', Z: '--..',
+    '0': '-----', '1': '.----', '2': '..---', '3': '...--', '4': '....-', '5': '.....', '6': '-....', '7': '--...', '8': '---..', '9': '----.',
+    '.': '.-.-.-', ',': '--..--', '?': '..--..', '!': '-.-.--', '/': '-..-.', '(': '-.--.', ')': '-.--.-', '&': '.-...', ':': '---...',
+    ';': '-.-.-.', '=': '-...-', '+': '.-.-.', '-': '-....-', '_': '..--.-', '"': '.-..-.', '$': '...-..-', '@': '.--.-.', '\'': '.----.',
+};
+const MORSE_BACK = Object.fromEntries(Object.entries(MORSE).map(([letter, code]) => [code, letter]));
+/** Text to code: letters a space apart, words a slash apart; an unknown character is dropped. */
+export function morse_encode(text) {
+    return text.toUpperCase().trim().split(/\s+/).map((word) => [...word].map((c) => MORSE[c] ?? '').filter((c) => c.length > 0).join(' ')).filter((w) => w.length > 0).join(' / ');
+}
+/** Code to text: a group the code does not know becomes `?`. */
+export function morse_decode(code) {
+    return code.trim().split(/\s*\/\s*|\s{3,}/).map((word) => word.trim().split(/\s+/).filter((g) => g.length > 0).map((g) => MORSE_BACK[g] ?? '?').join('')).join(' ');
+}
+/** `morse [-d] [text]` */
+export async function builtin_morse(args) {
+    const decode = args[0] === '-d' || args[0] === '--decode';
+    const text = text_input(decode ? args.slice(1) : args);
+    if (text === null)
+        return envelope_error('', undefined, 'morse: usage: morse <text>  |  morse -d <code>\n');
+    const said = text.replace(/\n$/, '');
+    if (decode) {
+        const plain = morse_decode(said);
+        return envelope_ok(`${plain}\n`, { kind: 'games.morse', data: { text: plain, code: said.trim(), direction: 'decode' } });
+    }
+    const code = morse_encode(said);
+    if (code === '')
+        return envelope_error('', undefined, 'morse: nothing in that the code can carry\n');
+    return envelope_ok(`${code}\n`, { kind: 'games.morse', data: { text: said, code, direction: 'encode' } });
+}
+//# sourceMappingURL=morse.js.map

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

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

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

@@ -0,0 +1,55 @@
+/**
+ * @file Number toys from the shelf: `factor`, `primes`, `roll`, `calc`, `units`.
+ *
+ * `calc` is a small arithmetic reader of its own — no `eval` — with the
+ * usual operators, parentheses, a few functions and `pi` and `e`. `units`
+ * converts within a modest table: length, mass, time, data and temperature.
+ *
+ * @module
+ */
+import { CommandEnvelope } from '@fnndsc/cumin';
+/** The most primes `primes` lists in one call. */
+export declare const PRIMES_MAX: number;
+/** The prime factors of n, smallest first, with repeats. */
+export declare function factors_of(n: number): number[];
+/** The primes in [from, to], at most PRIMES_MAX of them. */
+export declare function primes_between(from: number, to: number): number[];
+/**
+ * Rolls dice written as `NdS[+M]`, e.g. `2d6+1`, `d20`.
+ *
+ * @returns Each die's face and the total, or a refusal.
+ */
+export declare function dice_roll(spec: string, random?: () => number): {
+    rolls: number[];
+    modifier: number;
+    total: number;
+} | {
+    refusal: string;
+};
+/**
+ * Evaluates an arithmetic expression: + - * / % ^, parentheses, unary minus,
+ * the functions above, pi and e. Throws with a reason on a malformed one.
+ */
+export declare function calc_evaluate(expression: string): number;
+/**
+ * Converts a quantity between two units of one kind.
+ *
+ * @returns The converted value, or a refusal naming what went wrong.
+ */
+export declare function units_convert(value: number, from: string, to: string): {
+    value: number;
+} | {
+    refusal: string;
+};
+/** The unit names `units` knows, for its help and its refusals. */
+export declare function units_known(): string[];
+/** `factor N...` */
+export declare function builtin_factor(args: string[]): Promise<CommandEnvelope>;
+/** `primes [FROM] TO` */
+export declare function builtin_primes(args: string[]): Promise<CommandEnvelope>;
+/** `roll [NdS[+M]]...` — 1d6 when bare. */
+export declare function builtin_roll(args: string[]): Promise<CommandEnvelope>;
+/** `calc EXPRESSION` */
+export declare function builtin_calc(args: string[]): Promise<CommandEnvelope>;
+/** `units VALUE FROM [to] TO` */
+export declare function builtin_units(args: string[]): Promise<CommandEnvelope>;

package/dist/builtins/games/numbers.js

@@ -0,0 +1,270 @@
+/**
+ * @file Number toys from the shelf: `factor`, `primes`, `roll`, `calc`, `units`.
+ *
+ * `calc` is a small arithmetic reader of its own — no `eval` — with the
+ * usual operators, parentheses, a few functions and `pi` and `e`. `units`
+ * converts within a modest table: length, mass, time, data and temperature.
+ *
+ * @module
+ */
+import { envelope_ok, envelope_error } from '@fnndsc/cumin';
+import { text_input } from './stdin.js';
+/** The most primes `primes` lists in one call. */
+export const PRIMES_MAX = 10_000;
+/** The prime factors of n, smallest first, with repeats. */
+export function factors_of(n) {
+    const out = [];
+    let rest = n;
+    for (let p = 2; p * p <= rest; p++) {
+        while (rest % p === 0) {
+            out.push(p);
+            rest /= p;
+        }
+    }
+    if (rest > 1)
+        out.push(rest);
+    return out;
+}
+/** The primes in [from, to], at most PRIMES_MAX of them. */
+export function primes_between(from, to) {
+    const out = [];
+    const isPrime = (n) => {
+        if (n < 2)
+            return false;
+        for (let p = 2; p * p <= n; p++)
+            if (n % p === 0)
+                return false;
+        return true;
+    };
+    for (let n = Math.max(2, from); n <= to && out.length < PRIMES_MAX; n++)
+        if (isPrime(n))
+            out.push(n);
+    return out;
+}
+/**
+ * Rolls dice written as `NdS[+M]`, e.g. `2d6+1`, `d20`.
+ *
+ * @returns Each die's face and the total, or a refusal.
+ */
+export function dice_roll(spec, random = Math.random) {
+    const m = /^(\d*)d(\d+)([+-]\d+)?$/i.exec(spec.trim());
+    if (m === null)
+        return { refusal: `roll: '${spec}' is not dice (try 2d6, d20, 3d8+2)` };
+    const count = m[1] === '' || m[1] === undefined ? 1 : Number(m[1]);
+    const sides = Number(m[2]);
+    const modifier = m[3] === undefined ? 0 : Number(m[3]);
+    if (count < 1 || count > 100 || sides < 2 || sides > 1000)
+        return { refusal: 'roll: 1 to 100 dice of 2 to 1000 sides' };
+    const rolls = Array.from({ length: count }, () => 1 + Math.floor(random() * sides));
+    return { rolls, modifier, total: rolls.reduce((a, b) => a + b, 0) + modifier };
+}
+/* ------------------------------------------------------------- calc */
+const CALC_FUNCTIONS = {
+    sqrt: Math.sqrt, abs: Math.abs, ln: Math.log, log: Math.log10, log2: Math.log2, exp: Math.exp,
+    sin: Math.sin, cos: Math.cos, tan: Math.tan, asin: Math.asin, acos: Math.acos, atan: Math.atan,
+    floor: Math.floor, ceil: Math.ceil, round: Math.round,
+};
+const CALC_CONSTANTS = { pi: Math.PI, e: Math.E, tau: 2 * Math.PI };
+/**
+ * Evaluates an arithmetic expression: + - * / % ^, parentheses, unary minus,
+ * the functions above, pi and e. Throws with a reason on a malformed one.
+ */
+export function calc_evaluate(expression) {
+    const src = expression.replace(/\s+/g, '');
+    let at = 0;
+    const peek = () => src[at] ?? '';
+    const fail = (why) => { throw new Error(`calc: ${why} at position ${at + 1}`); };
+    const number = () => {
+        const m = /^(\d+\.?\d*|\.\d+)(e[+-]?\d+)?/i.exec(src.slice(at));
+        if (m === null)
+            return fail('expected a number');
+        at += m[0].length;
+        return Number(m[0]);
+    };
+    const atom = () => {
+        if (peek() === '(') {
+            at++;
+            const v = expr();
+            if (peek() !== ')')
+                return fail("expected ')'");
+            at++;
+            return v;
+        }
+        if (peek() === '-') {
+            at++;
+            return -atom();
+        }
+        if (peek() === '+') {
+            at++;
+            return atom();
+        }
+        const word = /^[a-z][a-z0-9]*/i.exec(src.slice(at));
+        if (word !== null) {
+            const name = word[0].toLowerCase();
+            at += name.length;
+            if (name in CALC_CONSTANTS)
+                return CALC_CONSTANTS[name];
+            const fn = CALC_FUNCTIONS[name];
+            if (fn === undefined)
+                return fail(`unknown name '${name}'`);
+            if (peek() !== '(')
+                return fail(`'${name}' wants parentheses`);
+            at++;
+            const v = expr();
+            if (peek() !== ')')
+                return fail("expected ')'");
+            at++;
+            return fn(v);
+        }
+        return number();
+    };
+    const power = () => {
+        const base = atom();
+        if (peek() === '^') {
+            at++;
+            return Math.pow(base, power());
+        }
+        return base;
+    };
+    const term = () => {
+        let v = power();
+        while (peek() === '*' || peek() === '/' || peek() === '%') {
+            const op = peek();
+            at++;
+            const r = power();
+            v = op === '*' ? v * r : op === '/' ? v / r : v % r;
+        }
+        return v;
+    };
+    const expr = () => {
+        let v = term();
+        while (peek() === '+' || peek() === '-') {
+            const op = peek();
+            at++;
+            const r = term();
+            v = op === '+' ? v + r : v - r;
+        }
+        return v;
+    };
+    if (src === '')
+        fail('nothing to compute');
+    const value = expr();
+    if (at < src.length)
+        fail(`unexpected '${peek()}'`);
+    return value;
+}
+const UNITS = {
+    m: { kind: 'length', factor: 1 }, meter: { kind: 'length', factor: 1 }, metre: { kind: 'length', factor: 1 },
+    km: { kind: 'length', factor: 1000 }, cm: { kind: 'length', factor: 0.01 }, mm: { kind: 'length', factor: 0.001 }, um: { kind: 'length', factor: 1e-6 },
+    in: { kind: 'length', factor: 0.0254 }, inch: { kind: 'length', factor: 0.0254 }, ft: { kind: 'length', factor: 0.3048 }, foot: { kind: 'length', factor: 0.3048 }, feet: { kind: 'length', factor: 0.3048 },
+    yd: { kind: 'length', factor: 0.9144 }, mi: { kind: 'length', factor: 1609.344 }, mile: { kind: 'length', factor: 1609.344 }, nmi: { kind: 'length', factor: 1852 },
+    kg: { kind: 'mass', factor: 1 }, g: { kind: 'mass', factor: 0.001 }, mg: { kind: 'mass', factor: 1e-6 }, lb: { kind: 'mass', factor: 0.45359237 }, oz: { kind: 'mass', factor: 0.028349523125 }, st: { kind: 'mass', factor: 6.35029318 },
+    s: { kind: 'time', factor: 1 }, sec: { kind: 'time', factor: 1 }, ms: { kind: 'time', factor: 0.001 }, us: { kind: 'time', factor: 1e-6 }, min: { kind: 'time', factor: 60 }, h: { kind: 'time', factor: 3600 }, hr: { kind: 'time', factor: 3600 },
+    d: { kind: 'time', factor: 86400 }, day: { kind: 'time', factor: 86400 }, wk: { kind: 'time', factor: 604800 }, week: { kind: 'time', factor: 604800 }, yr: { kind: 'time', factor: 31557600 }, year: { kind: 'time', factor: 31557600 },
+    B: { kind: 'data', factor: 1 }, byte: { kind: 'data', factor: 1 }, kB: { kind: 'data', factor: 1e3 }, MB: { kind: 'data', factor: 1e6 }, GB: { kind: 'data', factor: 1e9 }, TB: { kind: 'data', factor: 1e12 },
+    KiB: { kind: 'data', factor: 1024 }, MiB: { kind: 'data', factor: 1024 ** 2 }, GiB: { kind: 'data', factor: 1024 ** 3 }, TiB: { kind: 'data', factor: 1024 ** 4 }, bit: { kind: 'data', factor: 0.125 },
+    C: { kind: 'temperature', factor: 1 }, F: { kind: 'temperature', factor: 1 }, K: { kind: 'temperature', factor: 1 },
+};
+/** Temperature is affine, not a factor: converted by hand. */
+function temperature_convert(value, from, to) {
+    const celsius = from === 'C' ? value : from === 'F' ? (value - 32) * 5 / 9 : value - 273.15;
+    return to === 'C' ? celsius : to === 'F' ? celsius * 9 / 5 + 32 : celsius + 273.15;
+}
+/**
+ * Converts a quantity between two units of one kind.
+ *
+ * @returns The converted value, or a refusal naming what went wrong.
+ */
+export function units_convert(value, from, to) {
+    const a = UNITS[from] ?? UNITS[from.toLowerCase()];
+    const b = UNITS[to] ?? UNITS[to.toLowerCase()];
+    if (a === undefined)
+        return { refusal: `units: unknown unit '${from}'` };
+    if (b === undefined)
+        return { refusal: `units: unknown unit '${to}'` };
+    if (a.kind !== b.kind)
+        return { refusal: `units: cannot convert ${a.kind} to ${b.kind}` };
+    if (a.kind === 'temperature')
+        return { value: temperature_convert(value, from.toUpperCase(), to.toUpperCase()) };
+    return { value: value * a.factor / b.factor };
+}
+/** The unit names `units` knows, for its help and its refusals. */
+export function units_known() {
+    return Object.keys(UNITS);
+}
+/* --------------------------------------------------------- builtins */
+/** `factor N...` */
+export async function builtin_factor(args) {
+    const words = text_input(args)?.trim().split(/\s+/) ?? [];
+    if (words.length === 0)
+        return envelope_error('', undefined, 'factor: usage: factor N [N...]\n');
+    const lines = [];
+    const data = [];
+    for (const word of words) {
+        const n = Number(word);
+        if (!Number.isInteger(n) || n < 1 || n > Number.MAX_SAFE_INTEGER)
+            return envelope_error('', undefined, `factor: '${word}' is not a positive whole number\n`);
+        const factors = n === 1 ? [] : factors_of(n);
+        data.push({ n, factors });
+        lines.push(`${n}: ${factors.join(' ')}`.trimEnd());
+    }
+    return envelope_ok(`${lines.join('\n')}\n`, { kind: 'games.factor', data: { numbers: data } });
+}
+/** `primes [FROM] TO` */
+export async function builtin_primes(args) {
+    const nums = args.map(Number);
+    if (nums.length === 0 || nums.length > 2 || nums.some((n) => !Number.isInteger(n))) {
+        return envelope_error('', undefined, 'primes: usage: primes [FROM] TO\n');
+    }
+    const [from, to] = nums.length === 1 ? [2, nums[0]] : [nums[0], nums[1]];
+    const primes = primes_between(from, to);
+    const note = primes.length >= PRIMES_MAX ? `primes: stopped at ${PRIMES_MAX}\n` : '';
+    return envelope_ok(`${primes.join(' ')}\n${note}`, { kind: 'games.primes', data: { from, to, primes } });
+}
+/** `roll [NdS[+M]]...` — 1d6 when bare. */
+export async function builtin_roll(args) {
+    const specs = args.length === 0 ? ['1d6'] : args;
+    const lines = [];
+    const data = [];
+    for (const spec of specs) {
+        const r = dice_roll(spec);
+        if ('refusal' in r)
+            return envelope_error('', undefined, `${r.refusal}\n`);
+        const mod = r.modifier === 0 ? '' : ` ${r.modifier > 0 ? '+' : '-'} ${Math.abs(r.modifier)}`;
+        lines.push(r.rolls.length === 1 && r.modifier === 0 ? `${spec}: ${r.total}` : `${spec}: ${r.rolls.join(' + ')}${mod} = ${r.total}`);
+        data.push({ dice: spec, rolls: r.rolls, total: r.total });
+    }
+    return envelope_ok(`${lines.join('\n')}\n`, { kind: 'games.roll', data: { rolls: data } });
+}
+/** `calc EXPRESSION` */
+export async function builtin_calc(args) {
+    const expression = text_input(args);
+    if (expression === null)
+        return envelope_error('', undefined, 'calc: usage: calc <expression>   (e.g. calc 2^10, calc sqrt(2)*pi)\n');
+    try {
+        const value = calc_evaluate(expression.trim());
+        const shown = Number.isInteger(value) ? String(value) : String(Number(value.toPrecision(12)));
+        return envelope_ok(`${shown}\n`, { kind: 'games.calc', data: { expression: expression.trim(), value } });
+    }
+    catch (error) {
+        return envelope_error('', undefined, `${error instanceof Error ? error.message : String(error)}\n`);
+    }
+}
+/** `units VALUE FROM [to] TO` */
+export async function builtin_units(args) {
+    // `units 10 mm to in`, `units 10 mm in in`: the joining word is dropped.
+    const words = args.length === 4 && /^(to|in|as)$/i.test(args[2]) ? [args[0], args[1], args[3]] : [...args];
+    if (words.length === 1 && (words[0] === 'list' || words[0] === '--list')) {
+        return envelope_ok(`${units_known().join(' ')}\n`, { kind: 'games.units', data: { known: units_known() } });
+    }
+    if (words.length !== 3 || !Number.isFinite(Number(words[0]))) {
+        return envelope_error('', undefined, 'units: usage: units VALUE FROM [to] TO   (units list names the units)\n');
+    }
+    const value = Number(words[0]);
+    const r = units_convert(value, words[1], words[2]);
+    if ('refusal' in r)
+        return envelope_error('', undefined, `${r.refusal}\n`);
+    const shown = String(Number(r.value.toPrecision(10)));
+    return envelope_ok(`${value} ${words[1]} = ${shown} ${words[2]}\n`, { kind: 'games.units', data: { value, from: words[1], to: words[2], result: r.value } });
+}
+//# sourceMappingURL=numbers.js.map

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

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

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

@@ -0,0 +1,53 @@
+/**
+ * @file Games played by question and answer: `quiz`, `hangman`, `2048`.
+ *
+ * Each turn is a question the kernel asks the surface — the console in a
+ * terminal, the console's ask bar in ARGUS — so the same game plays
+ * anywhere a question can be answered. The boards and the scoring are pure
+ * functions, tested apart from the asking.
+ *
+ * @module
+ */
+import { CommandEnvelope } from '@fnndsc/cumin';
+/** One question and its acceptable answers (matched without case or punctuation). */
+export interface QuizItem {
+    q: string;
+    a: ReadonlyArray<string>;
+}
+/** The bank: the lab's own vocabulary. */
+export declare const QUIZ_BANK: ReadonlyArray<QuizItem>;
+/** How many a round asks. */
+export declare const QUIZ_ROUND: number;
+/** Whether an answer matches: case, spaces and punctuation set aside. */
+export declare function answer_matches(given: string, accepted: ReadonlyArray<string>): boolean;
+/** `quiz`: five questions from the bank; the score at the end. */
+export declare function builtin_quiz(_args: string[]): Promise<CommandEnvelope>;
+/** The words: the lab's. */
+export declare const HANGMAN_WORDS: ReadonlyArray<string>;
+/** The gallows, by misses. */
+export declare const GALLOWS: ReadonlyArray<ReadonlyArray<string>>;
+/** The word with the letters not yet guessed hidden. */
+export declare function word_mask(word: string, guessed: ReadonlySet<string>): string;
+/** `hangman`: a word from the lab, six misses allowed. */
+export declare function builtin_hangman(_args: string[]): Promise<CommandEnvelope>;
+/** A 4×4 board, 0 for empty. */
+export type Board = number[][];
+/** Slides and merges one row to the left; returns the row and the points scored. */
+export declare function row_slide(row: number[]): {
+    row: number[];
+    score: number;
+};
+/** Moves the whole board; returns the new board, the points, and whether anything moved. */
+export declare function board_move(board: Board, direction: 'left' | 'right' | 'up' | 'down'): {
+    board: Board;
+    score: number;
+    moved: boolean;
+};
+/** Puts a 2 (or, one time in ten, a 4) on an empty cell; false when there is none. */
+export declare function board_spawn(board: Board, random?: () => number): boolean;
+/** Whether any move is left. */
+export declare function board_canMove(board: Board): boolean;
+/** The board drawn. */
+export declare function board_render(board: Board, score: number): string;
+/** `2048`: w/a/s/d (or h/j/k/l) by question, q to stop. */
+export declare function builtin_2048(_args: string[]): Promise<CommandEnvelope>;