@fnndsc/brasa 0.31.5 → 0.32.0

package/dist/builtins/games/cowsay.js

@@ -0,0 +1,127 @@
+/**
+ * @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 { envelope_ok, envelope_error } from '@fnndsc/cumin';
+import { text_input } from './stdin.js';
+/** The brain, as ASCII has long drawn it. */
+export const BRAIN = [
+    '        _---~~(~~-_.',
+    '      _{        )   )',
+    '    ,   ) -~~- ( ,-\' )_',
+    '   (  `-,_..`., )-- \'_,)',
+    '  ( ` _)  (  -~( -_ `,  }',
+    '  (_-  _  ~_-~~~~`,  ,\' )',
+    '    `~ -^(    __;-,((()))',
+    '          ~~~~ {_ -_(())',
+    '                 `\\  }',
+    '                   { }',
+];
+/** Default wrap width, as cowsay's. */
+export const COWSAY_WIDTH = 40;
+/** Wraps text at a width, keeping the lines it already had. */
+export function text_wrap(text, width) {
+    const out = [];
+    for (const paragraph of text.split('\n')) {
+        const words = paragraph.split(/\s+/).filter((w) => w.length > 0);
+        if (words.length === 0) {
+            out.push('');
+            continue;
+        }
+        let line = '';
+        for (const word of words) {
+            if (line.length === 0)
+                line = word;
+            else if (line.length + 1 + word.length <= width)
+                line += ` ${word}`;
+            else {
+                out.push(line);
+                line = word;
+            }
+        }
+        out.push(line);
+    }
+    return out;
+}
+/**
+ * Draws the bubble: said (speech) or thought.
+ *
+ * @param lines - The wrapped lines.
+ * @param thought - True for a thought bubble (round sides, `o` trail).
+ */
+export function bubble_draw(lines, thought) {
+    const width = Math.max(1, ...lines.map((l) => l.length));
+    const pad = (l) => l.padEnd(width, ' ');
+    const top = ` ${'_'.repeat(width + 2)}`;
+    const bottom = ` ${'-'.repeat(width + 2)}`;
+    if (thought)
+        return [top, ...lines.map((l) => `( ${pad(l)} )`), bottom];
+    if (lines.length === 1)
+        return [top, `< ${pad(lines[0])} >`, bottom];
+    return [
+        top,
+        ...lines.map((l, i) => {
+            const [left, right] = i === 0 ? ['/', '\\'] : i === lines.length - 1 ? ['\\', '/'] : ['|', '|'];
+            return `${left} ${pad(l)} ${right}`;
+        }),
+        bottom,
+    ];
+}
+/**
+ * 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 function cowsay_render(text, thought = false, width = COWSAY_WIDTH) {
+    const lines = text_wrap(text, Math.max(8, width));
+    const trail = thought ? ['        o', '         o'] : ['        \\', '         \\'];
+    return [...bubble_draw(lines, thought), ...trail, ...BRAIN].join('\n') + '\n';
+}
+/** Parses `-W N` out of the arguments; the rest is the text. */
+function cowsayArgs_parse(args) {
+    let width = COWSAY_WIDTH;
+    const words = [];
+    for (let i = 0; i < args.length; i++) {
+        if (args[i] === '-W') {
+            const n = Number(args[i + 1]);
+            if (!Number.isInteger(n) || n < 8)
+                return { refusal: 'cowsay: -W wants a width of 8 or more' };
+            width = n;
+            i++;
+        }
+        else if (args[i]?.startsWith('-') && (args[i]?.length ?? 0) > 1) {
+            return { refusal: `cowsay: unknown flag '${args[i]}' (only -W N)` };
+        }
+        else {
+            words.push(args[i]);
+        }
+    }
+    return { width, words };
+}
+async function cow_run(args, thought, name) {
+    const parsed = cowsayArgs_parse(args);
+    if ('refusal' in parsed)
+        return envelope_error('', undefined, `${parsed.refusal}\n`);
+    const text = text_input(parsed.words);
+    if (text === null)
+        return envelope_error('', undefined, `${name}: nothing to say (pipe text in, or give it: fortune | ${name})\n`);
+    const said = text.replace(/\n$/, '');
+    return envelope_ok(cowsay_render(said, thought, parsed.width), { kind: 'games.cowsay', data: { text: said, thought } });
+}
+/** `cowsay [-W N] [text]` */
+export async function builtin_cowsay(args) {
+    return cow_run(args, false, 'cowsay');
+}
+/** `cowthink [-W N] [text]` */
+export async function builtin_cowthink(args) {
+    return cow_run(args, true, 'cowthink');
+}
+//# sourceMappingURL=cowsay.js.map

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

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

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

@@ -0,0 +1,25 @@
+/**
+ * @file `figlet` and `banner`: big letters.
+ *
+ * One bundled face, five rows tall, drawn in `#` the way `banner` always
+ * was; `figlet` fills with `█` for a solid look. Letters, digits and the
+ * punctuation a title needs. A glyph is five strings of equal width; the
+ * row of a word is its glyphs' rows side by side with one column between.
+ *
+ * @module
+ */
+import { CommandEnvelope } from '@fnndsc/cumin';
+/** The rows of the face, five. */
+export declare const FACE_ROWS: number;
+/**
+ * Sets a text in the face.
+ *
+ * @param text - The words; lowercase is set as capitals, an unknown character as `?`.
+ * @param ink - The character to draw with.
+ * @returns The five rows (more for several lines).
+ */
+export declare function figlet_render(text: string, ink?: string): string[];
+/** `figlet [text]`: big letters, solid. */
+export declare function builtin_figlet(args: string[]): Promise<CommandEnvelope>;
+/** `banner [text]`: big letters in `#`, as banner always drew them. */
+export declare function builtin_banner(args: string[]): Promise<CommandEnvelope>;

package/dist/builtins/games/figlet.js

@@ -0,0 +1,109 @@
+/**
+ * @file `figlet` and `banner`: big letters.
+ *
+ * One bundled face, five rows tall, drawn in `#` the way `banner` always
+ * was; `figlet` fills with `█` for a solid look. Letters, digits and the
+ * punctuation a title needs. A glyph is five strings of equal width; the
+ * row of a word is its glyphs' rows side by side with one column between.
+ *
+ * @module
+ */
+import { envelope_ok, envelope_error } from '@fnndsc/cumin';
+import { text_input } from './stdin.js';
+/** The face: each glyph five rows, `#` for ink. */
+const FACE = {
+    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': [' ### ', '#   #', ' ####', '    #', ' ### '],
+    ' ': ['   ', '   ', '   ', '   ', '   '],
+    '.': [' ', ' ', ' ', ' ', '#'],
+    ',': [' ', ' ', ' ', '#', '#'],
+    '!': ['#', '#', '#', ' ', '#'],
+    '?': [' ### ', '#   #', '   # ', '     ', '  #  '],
+    '-': ['     ', '     ', '#####', '     ', '     '],
+    '_': ['     ', '     ', '     ', '     ', '#####'],
+    ':': [' ', '#', ' ', '#', ' '],
+    '/': ['    #', '   # ', '  #  ', ' #   ', '#    '],
+    '+': ['     ', '  #  ', '#####', '  #  ', '     '],
+    '=': ['     ', '#####', '     ', '#####', '     '],
+    '*': ['     ', '# # #', ' ### ', '# # #', '     '],
+    '#': [' # # ', '#####', ' # # ', '#####', ' # # '],
+    '(': [' #', '# ', '# ', '# ', ' #'],
+    ')': ['# ', ' #', ' #', ' #', '# '],
+    '\'': ['#', '#', ' ', ' ', ' '],
+    '"': ['# #', '# #', '   ', '   ', '   '],
+    '&': [' ## ', '#  #', ' ## ', '# # ', ' # #'],
+    '@': [' ### ', '#  ##', '# # #', '#  # ', ' ### '],
+    '%': ['#   #', '   # ', '  #  ', ' #   ', '#   #'],
+};
+/** The rows of the face, five. */
+export const FACE_ROWS = 5;
+/**
+ * Sets a text in the face.
+ *
+ * @param text - The words; lowercase is set as capitals, an unknown character as `?`.
+ * @param ink - The character to draw with.
+ * @returns The five rows (more for several lines).
+ */
+export function figlet_render(text, ink = '#') {
+    const rows = [];
+    for (const line of text.split('\n')) {
+        const glyphs = [...line.toUpperCase()].map((c) => FACE[c] ?? FACE['?']);
+        for (let r = 0; r < FACE_ROWS; r++) {
+            const row = glyphs.map((g) => g[r] ?? '').join(' ').replace(/#/g, ink).trimEnd();
+            rows.push(row);
+        }
+        rows.push('');
+    }
+    rows.pop();
+    return rows;
+}
+async function big_run(args, ink, name) {
+    const text = text_input(args);
+    if (text === null)
+        return envelope_error('', undefined, `${name}: nothing to set (give words, or pipe them in)\n`);
+    const said = text.replace(/\n$/, '');
+    return envelope_ok(`${figlet_render(said, ink).join('\n')}\n`, { kind: 'games.figlet', data: { text: said, ink } });
+}
+/** `figlet [text]`: big letters, solid. */
+export async function builtin_figlet(args) {
+    return big_run(args, '█', 'figlet');
+}
+/** `banner [text]`: big letters in `#`, as banner always drew them. */
+export async function builtin_banner(args) {
+    return big_run(args, '#', 'banner');
+}
+//# sourceMappingURL=figlet.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"figlet.js","sourceRoot":"","sources":["../../../src/builtins/games/figlet.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AACH,OAAO,EAAmB,WAAW,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AAC7E,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,mDAAmD;AACnD,MAAM,IAAI,GAAoD;IAC5D,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC;IAChD,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC;IAChD,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC;IAChD,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC;IAChD,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC;IAChD,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC;IAChD,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC;IAChD,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC;IAChD,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC;IAChD,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC;IAChD,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC;IAChD,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC;IAChD,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC;IAChD,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC;IAChD,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC;IAChD,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC;IAChD,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC;IAChD,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC;IAChD,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC;IAChD,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC;IAChD,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC;IAChD,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC;IAChD,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC;IAChD,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC;IAChD,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC;IAChD,CAAC,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC;IAChD,GAAG,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC;IAClD,GAAG,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC;IAClD,GAAG,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC;IAClD,GAAG,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC;IAClD,GAAG,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC;IAClD,GAAG,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC;IAClD,GAAG,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC;IAClD,GAAG,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC;IAClD,GAAG,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC;IAClD,GAAG,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC;IAClD,GAAG,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC;IACxC,GAAG,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC;IAC9B,GAAG,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC;IAC9B,GAAG,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC;IAC9B,GAAG,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC;IAClD,GAAG,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC;IAClD,GAAG,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC;IAClD,GAAG,EAAE,CAAC,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,GAAG,CAAC;IAC9B,GAAG,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC;IAClD,GAAG,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC;IAClD,GAAG,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC;IAClD,GAAG,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC;IAClD,GAAG,EAAE,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,E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"}

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

@@ -0,0 +1,51 @@
+/**
+ * @file The lab's own toys: `who`, `uptime`, `ping`, `chrisfetch`, `say`.
+ *
+ * Small tools that happen to be fun. `who` names the surfaces on this
+ * session, `uptime` how long the process has been up, `ping` the round
+ * trip to CUBE, `chrisfetch` the brain beside the session's facts, and
+ * `say` hands words to a surface with a voice (the console prints them).
+ *
+ * @module
+ */
+import { CommandEnvelope } from '@fnndsc/cumin';
+/** Round trips `ping` makes when not told. */
+export declare const PING_COUNT: number;
+/** The most round trips `ping` makes however asked. */
+export declare const PING_MAX: number;
+/** A span of seconds in words: `2d 3h 04m`, `17m 05s`. */
+export declare function uptime_words(seconds: number): string;
+/** `who`: the surfaces attached to this session. */
+export declare function builtin_who(_args: string[]): Promise<CommandEnvelope>;
+/** `uptime`: how long this process has been up, and who is here. */
+export declare function builtin_uptime(_args: string[]): Promise<CommandEnvelope>;
+/** One round trip's outcome. */
+export interface PingSample {
+    seq: number;
+    ms: number | null;
+    status: number | null;
+}
+/** What `ping` uses to reach CUBE; a test hands in its own. */
+export type PingFetch = (url: string, init: {
+    method: string;
+    signal: AbortSignal;
+}) => Promise<{
+    status: number;
+}>;
+/**
+ * Round-trips to a URL `count` times.
+ *
+ * @param url - Where.
+ * @param count - How many.
+ * @param fetchFn - The fetch to use.
+ * @param onSample - Told each sample as it lands, for a surface that streams.
+ */
+export declare function ping_run(url: string, count: number, fetchFn: PingFetch, onSample?: (s: PingSample) => void): Promise<PingSample[]>;
+/** The summary line, as ping prints it. */
+export declare function ping_summary(samples: PingSample[]): string;
+/** `ping [-c N]`: round trips to CUBE. */
+export declare function builtin_ping(args: string[], fetchFn?: PingFetch): Promise<CommandEnvelope>;
+/** `chrisfetch`: the brain beside the session's facts, neofetch style. */
+export declare function builtin_chrisfetch(_args: string[]): Promise<CommandEnvelope>;
+/** `say [text]`: a surface with a voice speaks it; the console prints it. */
+export declare function builtin_say(args: string[]): Promise<CommandEnvelope>;

package/dist/builtins/games/lab.js

@@ -0,0 +1,161 @@
+/**
+ * @file The lab's own toys: `who`, `uptime`, `ping`, `chrisfetch`, `say`.
+ *
+ * Small tools that happen to be fun. `who` names the surfaces on this
+ * session, `uptime` how long the process has been up, `ping` the round
+ * trip to CUBE, `chrisfetch` the brain beside the session's facts, and
+ * `say` hands words to a surface with a voice (the console prints them).
+ *
+ * @module
+ */
+import { envelope_ok, envelope_error, chrisContext, requestLedger_snapshot } from '@fnndsc/cumin';
+import chalk from 'chalk';
+import { surface_get } from '../../core/surface.js';
+import { motd_gather } from '../sys/motd.js';
+import { BRAIN } from './cowsay.js';
+import { text_input } from './stdin.js';
+/** Round trips `ping` makes when not told. */
+export const PING_COUNT = 3;
+/** The most round trips `ping` makes however asked. */
+export const PING_MAX = 20;
+/** How long one round trip may take before it is called lost. */
+const PING_TIMEOUT_MS = 8_000;
+/** A span of seconds in words: `2d 3h 04m`, `17m 05s`. */
+export function uptime_words(seconds) {
+    const s = Math.floor(seconds);
+    const days = Math.floor(s / 86400);
+    const hours = Math.floor((s % 86400) / 3600);
+    const minutes = Math.floor((s % 3600) / 60);
+    const secs = s % 60;
+    if (days > 0)
+        return `${days}d ${hours}h ${String(minutes).padStart(2, '0')}m`;
+    if (hours > 0)
+        return `${hours}h ${String(minutes).padStart(2, '0')}m`;
+    return `${minutes}m ${String(secs).padStart(2, '0')}s`;
+}
+/** `who`: the surfaces attached to this session. */
+export async function builtin_who(_args) {
+    const peers = surface_get().peers?.() ?? null;
+    const user = (await chrisContext.ChRISuser_get()) ?? '?';
+    if (peers === null) {
+        return envelope_ok(`${user}  this terminal\n`, { kind: 'games.who', data: { user, peers: [] } });
+    }
+    const lines = peers.map((p) => `${user.padEnd(16)} ${p.kind.padEnd(8)} ${p.id}${p.you ? chalk.gray('  (you)') : ''}`);
+    return envelope_ok(`${lines.join('\n')}\n`, { kind: 'games.who', data: { user, peers } });
+}
+/** `uptime`: how long this process has been up, and who is here. */
+export async function builtin_uptime(_args) {
+    const seconds = process.uptime();
+    const peers = surface_get().peers?.() ?? null;
+    const since = new Date(Date.now() - seconds * 1000);
+    const now = new Date().toTimeString().slice(0, 8);
+    const who = peers === null ? '' : `, ${peers.length} surface${peers.length === 1 ? '' : 's'}`;
+    const line = ` ${now}  up ${uptime_words(seconds)}${who}  (since ${since.toISOString().replace('T', ' ').slice(0, 19)}Z, pid ${process.pid})`;
+    return envelope_ok(`${line}\n`, { kind: 'games.uptime', data: { seconds, since: since.toISOString(), pid: process.pid, surfaces: peers?.length ?? null } });
+}
+/**
+ * Round-trips to a URL `count` times.
+ *
+ * @param url - Where.
+ * @param count - How many.
+ * @param fetchFn - The fetch to use.
+ * @param onSample - Told each sample as it lands, for a surface that streams.
+ */
+export async function ping_run(url, count, fetchFn, onSample) {
+    const samples = [];
+    for (let seq = 1; seq <= count; seq++) {
+        const started = performance.now();
+        const controller = new AbortController();
+        const timer = setTimeout(() => controller.abort(), PING_TIMEOUT_MS);
+        let sample;
+        try {
+            const response = await fetchFn(url, { method: 'GET', signal: controller.signal });
+            sample = { seq, ms: Math.round((performance.now() - started) * 10) / 10, status: response.status };
+        }
+        catch {
+            sample = { seq, ms: null, status: null };
+        }
+        finally {
+            clearTimeout(timer);
+        }
+        samples.push(sample);
+        onSample?.(sample);
+    }
+    return samples;
+}
+/** The summary line, as ping prints it. */
+export function ping_summary(samples) {
+    const got = samples.map((s) => s.ms).filter((ms) => ms !== null);
+    const lost = samples.length - got.length;
+    const loss = samples.length === 0 ? '0' : String(Math.round((lost / samples.length) * 100));
+    let out = `${samples.length} sent, ${got.length} answered, ${loss}% lost`;
+    if (got.length > 0) {
+        const min = Math.min(...got);
+        const max = Math.max(...got);
+        const avg = got.reduce((a, b) => a + b, 0) / got.length;
+        out += `\nround-trip min/avg/max = ${min}/${avg.toFixed(1)}/${max} ms`;
+    }
+    return out;
+}
+/** `ping [-c N]`: round trips to CUBE. */
+export async function builtin_ping(args, fetchFn = (url, init) => fetch(url, init)) {
+    let count = PING_COUNT;
+    for (let i = 0; i < args.length; i++) {
+        if (args[i] === '-c') {
+            const n = Number(args[i + 1]);
+            if (!Number.isInteger(n) || n < 1)
+                return envelope_error('', undefined, 'ping: -c wants a positive whole number\n');
+            count = Math.min(n, PING_MAX);
+            i++;
+        }
+        else if (args[i] !== 'cube') {
+            return envelope_error('', undefined, `ping: only CUBE is pinged from here (ping [-c N] [cube]); '${args[i]}' is not that\n`);
+        }
+    }
+    const url = await chrisContext.ChRISURL_get();
+    if (url === null)
+        return envelope_error('', undefined, 'ping: not connected to a CUBE\n');
+    const lines = [`PING cube (${url})`];
+    const samples = await ping_run(url, count, fetchFn, (s) => {
+        lines.push(s.ms === null ? `seq=${s.seq} lost (no answer in ${PING_TIMEOUT_MS / 1000}s)` : `seq=${s.seq} http=${s.status} time=${s.ms} ms`);
+    });
+    const ledger = requestLedger_snapshot({ last: 0 });
+    const recent = ledger.total > 0 ? `\nthis session's own calls: ${ledger.total} to CUBE, ${(ledger.ms / ledger.total).toFixed(0)} ms each on average` : '';
+    return envelope_ok(`${lines.join('\n')}\n--- cube ping statistics ---\n${ping_summary(samples)}${recent}\n`, { kind: 'games.ping', data: { url, samples } });
+}
+/** `chrisfetch`: the brain beside the session's facts, neofetch style. */
+export async function builtin_chrisfetch(_args) {
+    const user = (await chrisContext.ChRISuser_get()) ?? '?';
+    const url = await chrisContext.ChRISURL_get();
+    const host = url === null ? '(not connected)' : url.replace(/^https?:\/\//, '').replace(/\/api\/v1\/?$/, '');
+    const motd = motd_gather(user, 'chrisfetch');
+    const peers = surface_get().peers?.() ?? null;
+    const facts = [
+        ['CUBE', host],
+        ['Feeds', `${motd.feeds.total} (${motd.feeds.own} own, ${motd.feeds.shared} shared, ${motd.feeds.public} public)`],
+        ['Jobs', `${motd.jobs.total.toLocaleString('en-US')} run · ${motd.jobs.running} running · ${motd.jobs.scheduled} scheduled`],
+        ['Failed', motd.failureRate === null ? 'none settled yet' : `${(motd.failureRate * 100).toFixed(1)} %`],
+        ['Index', motd.index.state === 'current' ? 'whole' : `${motd.index.state} (${motd.index.loaded}/${motd.index.total})`],
+        ['Surfaces', peers === null ? 'this terminal' : `${peers.length} attached (${peers.filter((p) => p.kind === 'browser').length} browser, ${peers.filter((p) => p.kind === 'chell').length} chell)`],
+        ['Uptime', uptime_words(process.uptime())],
+        ['Node', process.version],
+    ];
+    const title = `${chalk.bold.cyan(user)}@${chalk.bold.cyan(host.split(':')[0] ?? host)}`;
+    const right = [title, chalk.gray('─'.repeat(Math.min(40, user.length + host.length + 1))), ...facts.map(([k, v]) => `${chalk.cyan(k.padEnd(9))}${v}`)];
+    const rows = Math.max(BRAIN.length, right.length);
+    const lines = [];
+    for (let i = 0; i < rows; i++) {
+        const left = (BRAIN[i] ?? '').padEnd(27);
+        lines.push(`${chalk.cyan(left)}  ${right[i] ?? ''}`.trimEnd());
+    }
+    return envelope_ok(`${lines.join('\n')}\n`, { kind: 'games.chrisfetch', data: { user, cube: url, feeds: motd.feeds, jobs: motd.jobs, failureRate: motd.failureRate, index: motd.index, surfaces: peers, uptimeSeconds: process.uptime() } });
+}
+/** `say [text]`: a surface with a voice speaks it; the console prints it. */
+export async function builtin_say(args) {
+    const text = text_input(args);
+    if (text === null)
+        return envelope_error('', undefined, 'say: nothing to say (say hello, or fortune | say)\n');
+    const said = text.replace(/\n$/, '').replace(/\s+/g, ' ').trim();
+    return envelope_ok(`${chalk.gray('♪')} ${said}\n`, { kind: 'games.say', data: { text: said } });
+}
+//# sourceMappingURL=lab.js.map

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

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

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

@@ -0,0 +1,26 @@
+/**
+ * @file `lolcat`: text in a rainbow.
+ *
+ * Each character takes the next hue along a sine rainbow, the hue drifting
+ * down the lines, as the original does. The colour is 24-bit ANSI, which
+ * every surface here renders; `-p N` sets the spread (characters per cycle),
+ * `-S N` the starting phase.
+ *
+ * @module
+ */
+import { CommandEnvelope } from '@fnndsc/cumin';
+/** Characters per rainbow cycle when none is asked. */
+export declare const LOLCAT_SPREAD: number;
+/** The colour at a point along the rainbow. */
+export declare function rainbow_rgb(position: number, spread: number): [number, number, number];
+/**
+ * Paints a text.
+ *
+ * @param text - The lines.
+ * @param spread - Characters per cycle.
+ * @param phase - Where the first character starts.
+ * @returns The text with a colour per character; plain spaces stay plain.
+ */
+export declare function lolcat_paint(text: string, spread?: number, phase?: number): string;
+/** `lolcat [-p SPREAD] [-S PHASE] [text]` */
+export declare function builtin_lolcat(args: string[]): Promise<CommandEnvelope>;

package/dist/builtins/games/lolcat.js

@@ -0,0 +1,71 @@
+/**
+ * @file `lolcat`: text in a rainbow.
+ *
+ * Each character takes the next hue along a sine rainbow, the hue drifting
+ * down the lines, as the original does. The colour is 24-bit ANSI, which
+ * every surface here renders; `-p N` sets the spread (characters per cycle),
+ * `-S N` the starting phase.
+ *
+ * @module
+ */
+import { envelope_ok, envelope_error } from '@fnndsc/cumin';
+import chalk from 'chalk';
+import { text_input } from './stdin.js';
+/** 24-bit colour whatever the host thinks of its terminal: every surface here renders it. */
+const paint = new chalk.Instance({ level: 3 });
+/** Characters per rainbow cycle when none is asked. */
+export const LOLCAT_SPREAD = 24;
+/** The colour at a point along the rainbow. */
+export function rainbow_rgb(position, spread) {
+    const t = (position / spread) * 2 * Math.PI;
+    const channel = (phase) => Math.round(Math.sin(t + phase) * 100 + 155);
+    return [channel(0), channel(2 * Math.PI / 3), channel(4 * Math.PI / 3)];
+}
+/**
+ * Paints a text.
+ *
+ * @param text - The lines.
+ * @param spread - Characters per cycle.
+ * @param phase - Where the first character starts.
+ * @returns The text with a colour per character; plain spaces stay plain.
+ */
+export function lolcat_paint(text, spread = LOLCAT_SPREAD, phase = 0) {
+    const clean = text.replace(/\x1b\[[0-9;]*m/g, '');
+    return clean.split('\n').map((line, row) => [...line].map((c, col) => {
+        if (c === ' ')
+            return c;
+        const [r, g, b] = rainbow_rgb(phase + col + row * 3, spread);
+        return paint.rgb(r, g, b)(c);
+    }).join('')).join('\n');
+}
+/** `lolcat [-p SPREAD] [-S PHASE] [text]` */
+export async function builtin_lolcat(args) {
+    let spread = LOLCAT_SPREAD;
+    let phase = Math.floor(Math.random() * 256);
+    const words = [];
+    for (let i = 0; i < args.length; i++) {
+        const flag = args[i];
+        if (flag === '-p' || flag === '-S') {
+            const n = Number(args[i + 1]);
+            if (!Number.isFinite(n) || (flag === '-p' && n < 1))
+                return envelope_error('', undefined, `lolcat: ${flag} wants a number${flag === '-p' ? ' of 1 or more' : ''}\n`);
+            if (flag === '-p')
+                spread = n;
+            else
+                phase = n;
+            i++;
+        }
+        else if (flag.startsWith('-') && flag.length > 1) {
+            return envelope_error('', undefined, `lolcat: unknown flag '${flag}' (only -p SPREAD and -S PHASE)\n`);
+        }
+        else {
+            words.push(flag);
+        }
+    }
+    const text = text_input(words);
+    if (text === null)
+        return envelope_error('', undefined, 'lolcat: nothing to paint (pipe text in: fortune | lolcat)\n');
+    const said = text.replace(/\n$/, '');
+    return envelope_ok(`${lolcat_paint(said, spread, phase)}\n`, { kind: 'games.lolcat', data: { text: said, spread, phase } });
+}
+//# sourceMappingURL=lolcat.js.map

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

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