@fnndsc/brasa 0.31.5 → 0.32.0

package/dist/buildinfo.json

@@ -1 +1 @@
-{"hash":"8b4c28"}
+{"hash":"ff1316"}

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

@@ -0,0 +1,21 @@
+import { CommandEnvelope } from '@fnndsc/cumin';
+/** Bytes `xxd` shows when not told. */
+export declare const XXD_DEFAULT: number;
+/** Strings `strings` shows when not told. */
+export declare const STRINGS_DEFAULT: number;
+/** What a file is, by its first bytes. */
+export declare function magic_of(bytes: Buffer, name?: string): string;
+/** The canonical hex dump of some bytes, offsets from `base`. */
+export declare function hexdump_render(bytes: Buffer, base?: number): string;
+/** The printable runs of at least `min` characters in some bytes. */
+export declare function strings_find(bytes: Buffer, min?: number): string[];
+/** `file <path>...` */
+export declare function builtin_file(args: string[]): Promise<CommandEnvelope>;
+/** `xxd [-s OFFSET] [-l LENGTH] <path>` */
+export declare function builtin_xxd(args: string[]): Promise<CommandEnvelope>;
+/** `strings [-n MIN] [-l LIMIT] <path>` */
+export declare function builtin_strings(args: string[]): Promise<CommandEnvelope>;
+/** `sha256sum <path>...` */
+export declare function builtin_sha256sum(args: string[]): Promise<CommandEnvelope>;
+/** `md5sum <path>...` */
+export declare function builtin_md5sum(args: string[]): Promise<CommandEnvelope>;

package/dist/builtins/games/bytes.js

@@ -0,0 +1,224 @@
+/**
+ * @file Bytes of a CFS file: `file`, `xxd`, `strings`, `sha256sum`, `md5sum`.
+ *
+ * The way people learn what a file is: by its magic, in hex, by the words
+ * in it, by its digest. Each reads the file the way `cat` does, through
+ * the session's filesystem, so a path is a CFS path. `xxd` and `strings`
+ * are bounded and say what they showed.
+ *
+ * @module
+ */
+import { createHash } from 'node:crypto';
+import { envelope_ok, envelope_error, errorStack } from '@fnndsc/cumin';
+import { files_cat, files_catBinary } from '@fnndsc/chili/commands/fs/cat.js';
+import chalk from 'chalk';
+import { path_resolve, error_stripDebugPrefix } from '../utils.js';
+/** Bytes `xxd` shows when not told. */
+export const XXD_DEFAULT = 256;
+/** Strings `strings` shows when not told. */
+export const STRINGS_DEFAULT = 200;
+/** What a file is, by its first bytes. */
+export function magic_of(bytes, name = '') {
+    const at = (i) => bytes[i] ?? -1;
+    const ascii = (from, to) => bytes.subarray(from, to).toString('latin1');
+    if (bytes.length === 0)
+        return 'empty';
+    if (bytes.length > 132 && ascii(128, 132) === 'DICM')
+        return 'DICOM medical image (part 10, with preamble)';
+    if (at(0) === 0x1f && at(1) === 0x8b)
+        return /\.nii\.gz$/i.test(name) ? 'gzip compressed data, a NIfTI volume by its name' : 'gzip compressed data';
+    if (bytes.length >= 348 && (ascii(344, 348) === 'n+1\0' || ascii(344, 348) === 'ni1\0'))
+        return 'NIfTI-1 neuroimaging volume';
+    if (bytes.length >= 8 && ascii(4, 8) === 'n+2\0')
+        return 'NIfTI-2 neuroimaging volume';
+    if (ascii(0, 4) === '\x89PNG')
+        return 'PNG image';
+    if (at(0) === 0xff && at(1) === 0xd8)
+        return 'JPEG image';
+    if (ascii(0, 4) === 'GIF8')
+        return 'GIF image';
+    if (ascii(0, 4) === '%PDF')
+        return 'PDF document';
+    if (ascii(0, 2) === 'PK')
+        return 'ZIP archive';
+    if (ascii(0, 4) === 'MThd')
+        return 'MIDI';
+    if (ascii(0, 4) === 'RIFF')
+        return 'RIFF (WAV or AVI)';
+    if (ascii(0, 2) === 'BM')
+        return 'BMP image';
+    if (ascii(0, 7) === '!<arch>')
+        return 'ar archive';
+    if (ascii(0, 4) === '\x7fELF')
+        return 'ELF executable';
+    if (ascii(0, 5) === 'ustar' || ascii(257, 262) === 'ustar')
+        return 'tar archive';
+    if (at(0) === 0x42 && at(1) === 0x5a && at(2) === 0x68)
+        return 'bzip2 compressed data';
+    if (ascii(0, 6) === '\xfd7zXZ\0')
+        return 'xz compressed data';
+    const head = bytes.subarray(0, 4096);
+    let printable = 0;
+    for (const b of head)
+        if (b === 9 || b === 10 || b === 13 || (b >= 32 && b < 127) || b >= 128)
+            printable++;
+    if (printable / head.length > 0.95) {
+        const text = head.toString('utf-8');
+        if (/^\s*[{[]/.test(text))
+            return 'JSON text';
+        if (/^#!/.test(text))
+            return `script text (${text.split('\n')[0]?.slice(2).trim() ?? ''})`;
+        if (/^\s*<\?xml/i.test(text))
+            return 'XML text';
+        if (/^\s*<(!doctype html|html)/i.test(text))
+            return 'HTML text';
+        const lines = text.split('\n').slice(0, 5);
+        if (lines.length > 1 && lines.every((l) => l.split(',').length > 1))
+            return 'CSV text';
+        return head.some((b) => b >= 128) ? 'UTF-8 text' : 'ASCII text';
+    }
+    return 'data';
+}
+/** The canonical hex dump of some bytes, offsets from `base`. */
+export function hexdump_render(bytes, base = 0) {
+    const lines = [];
+    for (let off = 0; off < bytes.length; off += 16) {
+        const chunk = bytes.subarray(off, off + 16);
+        const hex = [];
+        for (let i = 0; i < 16; i += 2) {
+            const a = chunk[i];
+            const b = chunk[i + 1];
+            hex.push(a === undefined ? '    ' : b === undefined ? `${a.toString(16).padStart(2, '0')}  ` : `${a.toString(16).padStart(2, '0')}${b.toString(16).padStart(2, '0')}`);
+        }
+        const text = [...chunk].map((b) => (b >= 32 && b < 127 ? String.fromCharCode(b) : '.')).join('');
+        lines.push(`${(base + off).toString(16).padStart(8, '0')}: ${hex.join(' ')}  ${text}`);
+    }
+    return lines.join('\n');
+}
+/** The printable runs of at least `min` characters in some bytes. */
+export function strings_find(bytes, min = 4) {
+    const out = [];
+    let run = '';
+    for (const b of bytes) {
+        if (b >= 32 && b < 127) {
+            run += String.fromCharCode(b);
+            continue;
+        }
+        if (run.length >= min)
+            out.push(run);
+        run = '';
+    }
+    if (run.length >= min)
+        out.push(run);
+    return out;
+}
+/** Reads a CFS file's bytes, or answers why not. */
+async function bytes_read(pathArg, name) {
+    const target = await path_resolve(pathArg);
+    const result = await files_catBinary(target);
+    if (result.ok)
+        return { path: target, bytes: result.value };
+    // A projected file (/etc/cube, a /proc log) has words but no bytes of its
+    // own: its text is read instead, and the refusal of the first read is
+    // dropped — it was a question, not a failure.
+    const first = errorStack.stack_pop();
+    const text = await files_cat(target);
+    if (text.ok)
+        return { path: target, bytes: Buffer.from(text.value, 'utf-8') };
+    const last = errorStack.stack_pop() ?? first;
+    const why = last === undefined ? 'cannot read' : error_stripDebugPrefix(last.message);
+    return { error: envelope_error('', undefined, `${name}: ${pathArg}: ${why}\n`) };
+}
+/** Takes `-FLAG N` pairs off the arguments. */
+function numberFlags_take(args, flags) {
+    const values = {};
+    const rest = [];
+    for (let i = 0; i < args.length; i++) {
+        const a = args[i];
+        if (flags.includes(a)) {
+            const n = Number(args[i + 1]);
+            if (!Number.isInteger(n) || n < 0)
+                return { refusal: `${a} wants a whole number` };
+            values[a] = n;
+            i++;
+        }
+        else {
+            rest.push(a);
+        }
+    }
+    return { values, rest };
+}
+/** `file <path>...` */
+export async function builtin_file(args) {
+    if (args.length === 0)
+        return envelope_error('', undefined, 'file: usage: file <path>...\n');
+    const lines = [];
+    const data = [];
+    for (const arg of args) {
+        const read = await bytes_read(arg, 'file');
+        if ('error' in read)
+            return read.error;
+        const kind = magic_of(read.bytes, read.path);
+        lines.push(`${arg}: ${kind}${read.bytes.length > 0 ? chalk.gray(`  (${read.bytes.length.toLocaleString('en-US')} bytes)`) : ''}`);
+        data.push({ path: read.path, kind, bytes: read.bytes.length });
+    }
+    return envelope_ok(`${lines.join('\n')}\n`, { kind: 'games.file', data: { files: data } });
+}
+/** `xxd [-s OFFSET] [-l LENGTH] <path>` */
+export async function builtin_xxd(args) {
+    const parsed = numberFlags_take(args, ['-s', '-l']);
+    if ('refusal' in parsed)
+        return envelope_error('', undefined, `xxd: ${parsed.refusal}\n`);
+    if (parsed.rest.length !== 1)
+        return envelope_error('', undefined, 'xxd: usage: xxd [-s OFFSET] [-l LENGTH] <path>\n');
+    const read = await bytes_read(parsed.rest[0], 'xxd');
+    if ('error' in read)
+        return read.error;
+    const offset = parsed.values['-s'] ?? 0;
+    const length = parsed.values['-l'] ?? XXD_DEFAULT;
+    const shown = read.bytes.subarray(offset, offset + length);
+    const more = read.bytes.length - offset - shown.length;
+    const note = more > 0 ? chalk.gray(`\nxxd: ${shown.length} of ${read.bytes.length.toLocaleString('en-US')} bytes shown (-l ${length}; -s to start elsewhere)`) : '';
+    return envelope_ok(`${hexdump_render(shown, offset)}${note}\n`, { kind: 'games.xxd', data: { path: read.path, offset, shown: shown.length, total: read.bytes.length } });
+}
+/** `strings [-n MIN] [-l LIMIT] <path>` */
+export async function builtin_strings(args) {
+    const parsed = numberFlags_take(args, ['-n', '-l']);
+    if ('refusal' in parsed)
+        return envelope_error('', undefined, `strings: ${parsed.refusal}\n`);
+    if (parsed.rest.length !== 1)
+        return envelope_error('', undefined, 'strings: usage: strings [-n MIN] [-l LIMIT] <path>\n');
+    const read = await bytes_read(parsed.rest[0], 'strings');
+    if ('error' in read)
+        return read.error;
+    const min = Math.max(1, parsed.values['-n'] ?? 4);
+    const limit = parsed.values['-l'] ?? STRINGS_DEFAULT;
+    const found = strings_find(read.bytes, min);
+    const shown = found.slice(0, limit);
+    const note = found.length > shown.length ? chalk.gray(`\nstrings: ${shown.length} of ${found.length} shown (-l for more)`) : '';
+    return envelope_ok(`${shown.join('\n')}${note}\n`, { kind: 'games.strings', data: { path: read.path, shown: shown.length, total: found.length } });
+}
+async function digest_run(args, algorithm, name) {
+    if (args.length === 0)
+        return envelope_error('', undefined, `${name}: usage: ${name} <path>...\n`);
+    const lines = [];
+    const data = [];
+    for (const arg of args) {
+        const read = await bytes_read(arg, name);
+        if ('error' in read)
+            return read.error;
+        const digest = createHash(algorithm).update(read.bytes).digest('hex');
+        lines.push(`${digest}  ${arg}`);
+        data.push({ path: read.path, digest });
+    }
+    return envelope_ok(`${lines.join('\n')}\n`, { kind: `games.${name}`, data: { algorithm, files: data } });
+}
+/** `sha256sum <path>...` */
+export async function builtin_sha256sum(args) {
+    return digest_run(args, 'sha256', 'sha256sum');
+}
+/** `md5sum <path>...` */
+export async function builtin_md5sum(args) {
+    return digest_run(args, 'md5', 'md5sum');
+}
+//# sourceMappingURL=bytes.js.map

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

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

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

@@ -0,0 +1,64 @@
+/**
+ * @file Chimes: `timer`, `leave` and `stopwatch`.
+ *
+ * A chime is a word said later. The kernel keeps it on a clock and, when
+ * the time comes, publishes it on the ambient channel as an envelope of
+ * its own — the same road a refreshed listing takes — so every surface on
+ * the session hears it: ARGUS notes it in the console and speaks it, a
+ * remote chell prints it. Nothing holds the lane while it waits. A chime
+ * lives as long as the process: a session's chimes end with it.
+ *
+ * @module
+ */
+import { CommandEnvelope } from '@fnndsc/cumin';
+/** A chime waiting its turn. */
+export interface Chime {
+    id: number;
+    /** When it sounds, epoch ms. */
+    at: number;
+    text: string;
+    /** What set it. */
+    source: 'timer' | 'leave';
+}
+/** The longest a chime may wait. */
+export declare const CHIME_MAX_MS: number;
+/** What sounding a chime does; a test hands in its own ear. */
+export type ChimeSound = (chime: Chime) => void;
+/**
+ * Sets a chime.
+ *
+ * @param delayMs - How long from now.
+ * @param text - What it says.
+ * @param source - What set it.
+ * @param sound - How it sounds (the ambient channel by default).
+ * @returns The chime.
+ */
+export declare function chime_set(delayMs: number, text: string, source: Chime['source'], sound?: ChimeSound): Chime;
+/** The chimes still waiting, soonest first. */
+export declare function chimes_list(): Chime[];
+/**
+ * Cancels one chime, or every chime of a source, or all of them.
+ *
+ * @returns How many were cancelled.
+ */
+export declare function chimes_cancel(which: number | Chime['source'] | 'all'): number;
+/**
+ * Reads a duration: `90s`, `5m`, `1h30m`, `2:30` (m:ss), `1:00:00`, or a bare number of minutes.
+ *
+ * @returns Milliseconds, or null when the words are not a duration.
+ */
+export declare function duration_parse(text: string): number | null;
+/** A span in words: `1h 05m`, `4m 30s`, `12s`. */
+export declare function span_words(ms: number): string;
+/** `timer <duration> [words] | timer | timer cancel [id|all]` */
+export declare function builtin_timer(args: string[]): Promise<CommandEnvelope>;
+/** Reads `+hhmm` (from now) or `hhmm` (a clock time, today or tomorrow) as a delay. */
+export declare function leave_delay(text: string, now?: Date): number | null;
+/** `leave [+hhmm | hhmm] | leave cancel` — BSD's leave: a word five minutes before, one at the time, and one after. */
+export declare function builtin_leave(args: string[]): Promise<CommandEnvelope>;
+/** The stopwatch's elapsed time now. */
+export declare function stopwatch_elapsed(now?: number): number;
+/** Resets the stopwatch (a test's seam, and `stopwatch reset`). */
+export declare function stopwatch_reset(): void;
+/** `stopwatch [start|stop|lap|reset]` — bare, it shows the time. */
+export declare function builtin_stopwatch(args: string[]): Promise<CommandEnvelope>;

package/dist/builtins/games/chimes.js

@@ -0,0 +1,223 @@
+/**
+ * @file Chimes: `timer`, `leave` and `stopwatch`.
+ *
+ * A chime is a word said later. The kernel keeps it on a clock and, when
+ * the time comes, publishes it on the ambient channel as an envelope of
+ * its own — the same road a refreshed listing takes — so every surface on
+ * the session hears it: ARGUS notes it in the console and speaks it, a
+ * remote chell prints it. Nothing holds the lane while it waits. A chime
+ * lives as long as the process: a session's chimes end with it.
+ *
+ * @module
+ */
+import { envelope_ok, envelope_error } from '@fnndsc/cumin';
+import chalk from 'chalk';
+import { ambient_publish } from '../../core/ambient.js';
+/** The longest a chime may wait. */
+export const CHIME_MAX_MS = 24 * 3600 * 1000;
+const pending = new Map();
+let nextId = 1;
+const chime_sound = (chime) => {
+    ambient_publish({
+        kind: 'envelope',
+        envelope: envelope_ok(`${chalk.yellow('🔔')} ${chime.text}\n`, { kind: 'games.chime', data: { id: chime.id, text: chime.text, source: chime.source, at: new Date(chime.at).toISOString() } }),
+    });
+};
+/**
+ * Sets a chime.
+ *
+ * @param delayMs - How long from now.
+ * @param text - What it says.
+ * @param source - What set it.
+ * @param sound - How it sounds (the ambient channel by default).
+ * @returns The chime.
+ */
+export function chime_set(delayMs, text, source, sound = chime_sound) {
+    const chime = { id: nextId++, at: Date.now() + delayMs, text, source };
+    const handle = setTimeout(() => {
+        pending.delete(chime.id);
+        sound(chime);
+    }, delayMs);
+    // A waiting chime must not hold the process open on its own.
+    handle.unref();
+    pending.set(chime.id, { chime, handle });
+    return chime;
+}
+/** The chimes still waiting, soonest first. */
+export function chimes_list() {
+    return [...pending.values()].map((p) => p.chime).sort((a, b) => a.at - b.at);
+}
+/**
+ * Cancels one chime, or every chime of a source, or all of them.
+ *
+ * @returns How many were cancelled.
+ */
+export function chimes_cancel(which) {
+    let count = 0;
+    for (const [id, entry] of pending) {
+        if (which === 'all' || which === id || which === entry.chime.source) {
+            clearTimeout(entry.handle);
+            pending.delete(id);
+            count++;
+        }
+    }
+    return count;
+}
+/**
+ * Reads a duration: `90s`, `5m`, `1h30m`, `2:30` (m:ss), `1:00:00`, or a bare number of minutes.
+ *
+ * @returns Milliseconds, or null when the words are not a duration.
+ */
+export function duration_parse(text) {
+    const t = text.trim().toLowerCase();
+    if (/^\d+$/.test(t))
+        return Number(t) * 60_000;
+    const clock = /^(\d+):(\d{1,2})(?::(\d{1,2}))?$/.exec(t);
+    if (clock !== null) {
+        const parts = [clock[1], clock[2], clock[3]].filter((p) => p !== undefined).map(Number);
+        const seconds = parts.length === 3 ? parts[0] * 3600 + parts[1] * 60 + parts[2] : parts[0] * 60 + parts[1];
+        return seconds * 1000;
+    }
+    const units = /^(?:(\d+(?:\.\d+)?)h)?(?:(\d+(?:\.\d+)?)m)?(?:(\d+(?:\.\d+)?)s)?$/.exec(t);
+    if (units === null || units[0] === '')
+        return null;
+    const [, h, m, s] = units;
+    return Math.round(((Number(h ?? 0)) * 3600 + Number(m ?? 0) * 60 + Number(s ?? 0)) * 1000);
+}
+/** A span in words: `1h 05m`, `4m 30s`, `12s`. */
+export function span_words(ms) {
+    const total = Math.max(0, Math.round(ms / 1000));
+    const h = Math.floor(total / 3600);
+    const m = Math.floor((total % 3600) / 60);
+    const s = total % 60;
+    if (h > 0)
+        return `${h}h ${String(m).padStart(2, '0')}m`;
+    if (m > 0)
+        return `${m}m ${String(s).padStart(2, '0')}s`;
+    return `${s}s`;
+}
+function chimes_render() {
+    const list = chimes_list();
+    if (list.length === 0)
+        return `${chalk.gray('no chimes waiting')}\n`;
+    return list.map((c) => `${String(c.id).padStart(3)}  ${c.source.padEnd(5)}  in ${span_words(c.at - Date.now()).padEnd(8)}  ${c.text}`).join('\n') + '\n';
+}
+/** `timer <duration> [words] | timer | timer cancel [id|all]` */
+export async function builtin_timer(args) {
+    if (args.length === 0)
+        return envelope_ok(chimes_render(), { kind: 'games.chimes', data: { chimes: chimes_list() } });
+    if (args[0] === 'cancel') {
+        const which = args[1] === undefined ? 'timer' : args[1] === 'all' ? 'all' : Number(args[1]);
+        if (typeof which === 'number' && !Number.isInteger(which))
+            return envelope_error('', undefined, 'timer: cancel wants a chime id, or all\n');
+        const n = chimes_cancel(which);
+        return envelope_ok(`${n} chime${n === 1 ? '' : 's'} cancelled\n`, { kind: 'games.chimes', data: { cancelled: n } });
+    }
+    const ms = duration_parse(args[0]);
+    if (ms === null || ms <= 0)
+        return envelope_error('', undefined, `timer: '${args[0]}' is not a duration (try 90s, 5m, 1h30m, 2:30)\n`);
+    if (ms > CHIME_MAX_MS)
+        return envelope_error('', undefined, 'timer: a day is the most a timer waits\n');
+    const words = args.slice(1).join(' ') || `timer: ${span_words(ms)} is up`;
+    const chime = chime_set(ms, words, 'timer');
+    return envelope_ok(`timer ${chime.id} set: ${span_words(ms)} from now (${new Date(chime.at).toTimeString().slice(0, 8)}) — ${words}\n`, { kind: 'games.chimes', data: { set: chime } });
+}
+/** Reads `+hhmm` (from now) or `hhmm` (a clock time, today or tomorrow) as a delay. */
+export function leave_delay(text, now = new Date()) {
+    const m = /^(\+)?(\d{1,2}):?(\d{2})$/.exec(text.trim());
+    if (m === null)
+        return null;
+    const hours = Number(m[2]);
+    const minutes = Number(m[3]);
+    if (minutes > 59 || hours > 23 && m[1] === undefined)
+        return null;
+    if (m[1] === '+')
+        return (hours * 60 + minutes) * 60_000;
+    const at = new Date(now);
+    at.setHours(hours, minutes, 0, 0);
+    if (at.getTime() <= now.getTime())
+        at.setDate(at.getDate() + 1);
+    return at.getTime() - now.getTime();
+}
+/** `leave [+hhmm | hhmm] | leave cancel` — BSD's leave: a word five minutes before, one at the time, and one after. */
+export async function builtin_leave(args) {
+    if (args.length === 0) {
+        const mine = chimes_list().filter((c) => c.source === 'leave');
+        if (mine.length === 0)
+            return envelope_ok(`${chalk.gray('no leave set (leave +0030, or leave 1730)')}\n`, { kind: 'games.chimes', data: { chimes: [] } });
+        const last = mine[mine.length - 1];
+        return envelope_ok(`leaving at ${new Date(last.at - 60_000).toTimeString().slice(0, 5)} — in ${span_words(last.at - 60_000 - Date.now())}\n`, { kind: 'games.chimes', data: { chimes: mine } });
+    }
+    if (args[0] === 'cancel') {
+        const n = chimes_cancel('leave');
+        return envelope_ok(`${n === 0 ? 'no leave was set' : 'leave cancelled'}\n`, { kind: 'games.chimes', data: { cancelled: n } });
+    }
+    const delay = leave_delay(args[0]);
+    if (delay === null)
+        return envelope_error('', undefined, `leave: '${args[0]}' is not a time (leave +hhmm from now, or leave hhmm)\n`);
+    chimes_cancel('leave');
+    const at = new Date(Date.now() + delay);
+    if (delay > 5 * 60_000)
+        chime_set(delay - 5 * 60_000, 'You have to leave in 5 minutes.', 'leave');
+    if (delay > 60_000)
+        chime_set(delay - 60_000, 'Just one more minute!', 'leave');
+    chime_set(delay, 'Time to leave!', 'leave');
+    chime_set(delay + 60_000, "You're going to be late!", 'leave');
+    return envelope_ok(`Alarm set for ${at.toTimeString().slice(0, 5)} (in ${span_words(delay)}).\n`, { kind: 'games.chimes', data: { at: at.toISOString() } });
+}
+const watch = { startedAt: null, accumulated: 0, laps: [] };
+/** The stopwatch's elapsed time now. */
+export function stopwatch_elapsed(now = Date.now()) {
+    return watch.accumulated + (watch.startedAt === null ? 0 : now - watch.startedAt);
+}
+/** Resets the stopwatch (a test's seam, and `stopwatch reset`). */
+export function stopwatch_reset() {
+    watch.startedAt = null;
+    watch.accumulated = 0;
+    watch.laps = [];
+}
+const clock_words = (ms) => {
+    const total = Math.floor(ms / 1000);
+    const h = Math.floor(total / 3600);
+    const m = Math.floor((total % 3600) / 60);
+    const s = total % 60;
+    const tenths = Math.floor((ms % 1000) / 100);
+    return `${h > 0 ? `${h}:` : ''}${String(m).padStart(2, '0')}:${String(s).padStart(2, '0')}.${tenths}`;
+};
+/** `stopwatch [start|stop|lap|reset]` — bare, it shows the time. */
+export async function builtin_stopwatch(args) {
+    const verb = args[0] ?? 'show';
+    const now = Date.now();
+    const running = watch.startedAt !== null;
+    if (verb === 'start') {
+        if (running)
+            return envelope_ok(`already running: ${clock_words(stopwatch_elapsed(now))}\n`, { kind: 'games.stopwatch', data: { elapsedMs: stopwatch_elapsed(now), running } });
+        watch.startedAt = now;
+        return envelope_ok(`stopwatch started${watch.accumulated > 0 ? ` (resuming at ${clock_words(watch.accumulated)})` : ''}\n`, { kind: 'games.stopwatch', data: { elapsedMs: watch.accumulated, running: true } });
+    }
+    if (verb === 'stop') {
+        if (!running)
+            return envelope_ok(`stopped at ${clock_words(watch.accumulated)}\n`, { kind: 'games.stopwatch', data: { elapsedMs: watch.accumulated, running: false } });
+        watch.accumulated += now - watch.startedAt;
+        watch.startedAt = null;
+        return envelope_ok(`stopped at ${clock_words(watch.accumulated)}\n`, { kind: 'games.stopwatch', data: { elapsedMs: watch.accumulated, running: false } });
+    }
+    if (verb === 'lap') {
+        if (!running)
+            return envelope_error('', undefined, 'stopwatch: not running (stopwatch start)\n');
+        const elapsed = stopwatch_elapsed(now);
+        watch.laps.push(elapsed);
+        const previous = watch.laps.length > 1 ? watch.laps[watch.laps.length - 2] : 0;
+        return envelope_ok(`lap ${watch.laps.length}: ${clock_words(elapsed - previous)}  (${clock_words(elapsed)} total)\n`, { kind: 'games.stopwatch', data: { elapsedMs: elapsed, laps: watch.laps, running } });
+    }
+    if (verb === 'reset') {
+        stopwatch_reset();
+        return envelope_ok('stopwatch reset\n', { kind: 'games.stopwatch', data: { elapsedMs: 0, running: false } });
+    }
+    if (verb !== 'show')
+        return envelope_error('', undefined, `stopwatch: unknown word '${verb}' (start, stop, lap, reset)\n`);
+    const elapsed = stopwatch_elapsed(now);
+    const laps = watch.laps.map((l, i) => `  lap ${i + 1}  ${clock_words(l - (watch.laps[i - 1] ?? 0))}`).join('\n');
+    return envelope_ok(`${clock_words(elapsed)}${running ? ' (running)' : watch.accumulated > 0 ? ' (stopped)' : ''}\n${laps ? `${laps}\n` : ''}`, { kind: 'games.stopwatch', data: { elapsedMs: elapsed, laps: watch.laps, running } });
+}
+//# sourceMappingURL=chimes.js.map

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

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

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

@@ -0,0 +1,36 @@
+/**
+ * @file `cowsay`, with the ChRIS brain for a cow.
+ *
+ * The classic: a speech bubble over a creature. Ours thinks rather than
+ * lows — the brain is the mascot, and `fortune | cowsay` is what the shelf
+ * is for. `-W N` wraps at N columns; `cowthink` is the same with a thought
+ * bubble.
+ *
+ * @module
+ */
+import { CommandEnvelope } from '@fnndsc/cumin';
+/** The brain, as ASCII has long drawn it. */
+export declare const BRAIN: ReadonlyArray<string>;
+/** Default wrap width, as cowsay's. */
+export declare const COWSAY_WIDTH: number;
+/** Wraps text at a width, keeping the lines it already had. */
+export declare function text_wrap(text: string, width: number): string[];
+/**
+ * Draws the bubble: said (speech) or thought.
+ *
+ * @param lines - The wrapped lines.
+ * @param thought - True for a thought bubble (round sides, `o` trail).
+ */
+export declare function bubble_draw(lines: string[], thought: boolean): string[];
+/**
+ * The whole picture: the bubble, its trail, the brain.
+ *
+ * @param text - What the brain says.
+ * @param thought - Thought bubble rather than speech.
+ * @param width - Wrap width.
+ */
+export declare function cowsay_render(text: string, thought?: boolean, width?: number): string;
+/** `cowsay [-W N] [text]` */
+export declare function builtin_cowsay(args: string[]): Promise<CommandEnvelope>;
+/** `cowthink [-W N] [text]` */
+export declare function builtin_cowthink(args: string[]): Promise<CommandEnvelope>;