@fnndsc/brasa 0.31.5 → 0.32.1

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

@@ -0,0 +1,27 @@
+/** One category on the shelf. */
+export interface GamesCategory {
+    /** The heading, as the page prints it. */
+    title: string;
+    /** What the category holds, in a line. */
+    note: string;
+    /** The commands, in the order the page lists them. */
+    commands: ReadonlyArray<string>;
+}
+/** The shelf, in reading order. A command appears once. */
+export declare const GAMES_SHELF: ReadonlyArray<GamesCategory>;
+/** A command's one-line summary, when it has a help entry. */
+export type SummaryLookup = (command: string) => string | undefined;
+/**
+ * The commands on the shelf that exist: those with a help entry.
+ *
+ * @param summary_of - The help lookup.
+ * @returns The names, shelf order.
+ */
+export declare function gamesShelf_names(summary_of: SummaryLookup): string[];
+/**
+ * Renders `help games`: the shelf by category, in the style of bare `help`.
+ *
+ * @param summary_of - The help lookup; a command without one is left off.
+ * @returns The page.
+ */
+export declare function gamesShelf_render(summary_of: SummaryLookup): string;

package/dist/builtins/games/shelf.js

@@ -0,0 +1,71 @@
+/**
+ * @file The games shelf: `/usr/games`, as BSD shipped it.
+ *
+ * BSD kept its small pleasures apart from its tools — `fortune`, `pom`,
+ * `wtf`, `worms` — in `/usr/games`, with their own manual section. chell
+ * keeps the same shelf: `help games` lists it in categories, `ls /usr/games`
+ * walks it, and each command's help is the one declaration it has (in
+ * `help.ts`, where every command's is). The shelf names the commands and
+ * their categories only; a name here with no help entry is not listed, so
+ * the page never promises a command that has not landed.
+ *
+ * @module
+ */
+import chalk from 'chalk';
+/** The shelf, in reading order. A command appears once. */
+export const GAMES_SHELF = [
+    {
+        title: 'Text toys',
+        note: 'pipe fodder: fortune | cowsay, and friends',
+        commands: ['fortune', 'cowsay', 'cowthink', 'figlet', 'banner', 'lolcat', 'rev', 'tac', 'yes', 'seq', 'factor', 'primes', 'shuf', 'roll', 'rot13', 'morse', 'calc', 'units'],
+    },
+    {
+        title: 'Time and sky',
+        note: 'the calendar, the weather, the moon and the stardate',
+        commands: ['cal', 'date', 'weather', 'stardate', 'pom', 'sunrise', 'ddate', 'leave', 'timer', 'stopwatch'],
+    },
+    {
+        title: "The lab's own",
+        note: 'small tools that happen to be fun',
+        commands: ['motd', 'wtf', 'chrisfetch', 'who', 'uptime', 'ping', 'qr', 'file', 'xxd', 'strings', 'sha256sum', 'md5sum', 'say'],
+    },
+    {
+        title: 'Showpieces and games',
+        note: 'drawn in ARGUS; the console gets the text',
+        commands: ['sl', 'cmatrix', 'asciiquarium', 'rain', 'tetris', '2048', 'snake', 'quiz', 'hangman'],
+    },
+];
+/**
+ * The commands on the shelf that exist: those with a help entry.
+ *
+ * @param summary_of - The help lookup.
+ * @returns The names, shelf order.
+ */
+export function gamesShelf_names(summary_of) {
+    return GAMES_SHELF.flatMap((category) => category.commands.filter((command) => summary_of(command) !== undefined));
+}
+/**
+ * Renders `help games`: the shelf by category, in the style of bare `help`.
+ *
+ * @param summary_of - The help lookup; a command without one is left off.
+ * @returns The page.
+ */
+export function gamesShelf_render(summary_of) {
+    let out = '\n';
+    out += `${chalk.bold.cyan('/usr/games — the shelf')}\n`;
+    out += `${chalk.gray('─'.repeat(60))}\n`;
+    out += `${chalk.gray('Small pleasures, kept apart from the tools as BSD kept them. Every one is built in: no host binary, same words in chell and ARGUS.')}\n\n`;
+    for (const category of GAMES_SHELF) {
+        const present = category.commands.filter((command) => summary_of(command) !== undefined);
+        if (present.length === 0)
+            continue;
+        out += `${chalk.bold.yellow(category.title)}  ${chalk.gray(category.note)}\n`;
+        for (const command of present) {
+            out += `  ${chalk.cyan(command.padEnd(20))} ${chalk.gray(summary_of(command) ?? '')}\n`;
+        }
+        out += '\n';
+    }
+    out += `${chalk.gray('Type "help <command>" for one of them; "ls /usr/games" walks the shelf.')}\n\n`;
+    return out;
+}
+//# sourceMappingURL=shelf.js.map

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

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

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

@@ -0,0 +1,38 @@
+/**
+ * @file The showpieces — `sl`, `cmatrix`, `rain`, `asciiquarium` — and the
+ * arcade: `tetris`, `snake`.
+ *
+ * Each is a program a surface with a canvas runs: ARGUS opens its GAMES
+ * pane on the `games.show` model and draws. The console gets the text: a
+ * still of the show, or the words that there is nothing to play here and
+ * where there is.
+ *
+ * @module
+ */
+import { CommandEnvelope } from '@fnndsc/cumin';
+/** The programs a GAMES pane can run. */
+export type ShowProgram = 'sl' | 'cmatrix' | 'rain' | 'aquarium' | 'tetris' | 'snake';
+/**
+ * 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
+ * ASCII Art blog (startrekasciiart.blogspot.com, "Constitution Class -
+ * Refit", 2011; artist uncredited there; re-use granted with attribution
+ * retained). Nose to the right: it flies left to right.
+ */
+export declare const STARSHIP: ReadonlyArray<string>;
+/** The glyphs `cmatrix` rains. */
+export declare const MATRIX_GLYPHS: string;
+/** A still of a show, for a console with no canvas. */
+export declare function still_of(program: ShowProgram, random?: () => number): string[];
+/** `sl`: a starship crosses the screen. */
+export declare function builtin_sl(args: string[]): Promise<CommandEnvelope>;
+/** `cmatrix`: the glyph rain. */
+export declare function builtin_cmatrix(args: string[]): Promise<CommandEnvelope>;
+/** `rain`: rain. */
+export declare function builtin_rain(args: string[]): Promise<CommandEnvelope>;
+/** `asciiquarium`: fish. */
+export declare function builtin_asciiquarium(args: string[]): Promise<CommandEnvelope>;
+/** `tetris`: falling blocks, in ARGUS. */
+export declare function builtin_tetris(args: string[]): Promise<CommandEnvelope>;
+/** `snake`: the snake, in ARGUS. */
+export declare function builtin_snake(args: string[]): Promise<CommandEnvelope>;

package/dist/builtins/games/show.js

@@ -0,0 +1,75 @@
+/**
+ * @file The showpieces — `sl`, `cmatrix`, `rain`, `asciiquarium` — and the
+ * arcade: `tetris`, `snake`.
+ *
+ * Each is a program a surface with a canvas runs: ARGUS opens its GAMES
+ * pane on the `games.show` model and draws. The console gets the text: a
+ * still of the show, or the words that there is nothing to play here and
+ * where there is.
+ *
+ * @module
+ */
+import { envelope_ok } from '@fnndsc/cumin';
+import chalk from 'chalk';
+/**
+ * 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
+ * ASCII Art blog (startrekasciiart.blogspot.com, "Constitution Class -
+ * Refit", 2011; artist uncredited there; re-use granted with attribution
+ * retained). Nose to the right: it flies left to right.
+ */
+export const STARSHIP = [
+    '___________________          _-_         ',
+    '\\__(==========/_=_/ ____.---\'---`---.____',
+    '            \\_ \\    \\----._________.----/',
+    '              \\ \\   /  /    `-_-\'        ',
+    '          __,--`.`-\'..\'-_                ',
+    '         /____          ||               ',
+    '              `--.____,-\'                ',
+];
+/** The glyphs `cmatrix` rains. */
+export const MATRIX_GLYPHS = 'ﾊﾐﾋｰｳｼﾅﾓﾆｻﾜﾂｵﾘｱﾎﾃﾏｹﾒｴｶｷﾑﾕﾗｾﾈｽﾀﾇﾍ0123456789Z:・.=*+-<>¦|';
+/** A still of a show, for a console with no canvas. */
+export function still_of(program, random = Math.random) {
+    const pick = (s) => s[Math.floor(random() * s.length)];
+    switch (program) {
+        case 'sl': return [...STARSHIP];
+        case 'cmatrix': return Array.from({ length: 6 }, () => Array.from({ length: 40 }, () => (random() < 0.35 ? pick(MATRIX_GLYPHS) : ' ')).join(''));
+        case 'rain': return Array.from({ length: 5 }, (_, row) => Array.from({ length: 40 }, () => (random() < 0.12 ? (row === 4 ? 'o' : '|') : ' ')).join(''));
+        case 'aquarium': return [
+            '  ~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~~',
+            '        ><>           o              ',
+            '                 <><      o          ',
+            '    ><>                        ><>   ',
+            '  )(   )(      )(        )(   )(  )( ',
+            '  ^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^^',
+        ];
+        case 'tetris': return [
+            '  |          |', '  |    ##    |', '  |   ##     |', '  |          |', '  |  # #  ## |', '  | ####  ###|', '  +----------+',
+        ];
+        case 'snake': return ['  . . . . . . . .', '  . @ o o o . . .', '  . . . . o . . .', '  . . * . . . . .'];
+    }
+}
+/** What the console says beside a still: where the moving one is. */
+function note_of(program, arcade) {
+    return arcade
+        ? chalk.gray(`${program} plays in ARGUS: type it there and the GAMES pane opens with the keys live (arrows; Esc gives the keyboard back).`)
+        : chalk.gray(`a still; ARGUS draws ${program} moving in its GAMES pane.`);
+}
+function show_run(program, args, arcade) {
+    const still = still_of(program);
+    return envelope_ok(`${still.join('\n')}\n${note_of(program, arcade)}\n`, { kind: 'games.show', data: { program, args, arcade } });
+}
+/** `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, in ARGUS. */
+export async function builtin_tetris(args) { return show_run('tetris', args, true); }
+/** `snake`: the snake, in ARGUS. */
+export async function builtin_snake(args) { return show_run('snake', args, true); }
+//# sourceMappingURL=show.js.map

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

@@ -0,0 +1 @@
+{"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

@@ -0,0 +1,69 @@
+/**
+ * @file Time and sky from the shelf: `pom`, `stardate`, `ddate`, `sunrise`.
+ *
+ * `pom` is BSD's phase of the moon; `stardate` reckons the day two ways;
+ * `ddate` is the Discordian calendar, holy days included; `sunrise` asks
+ * Open-Meteo (the service `weather` already uses, no key) when the sun
+ * rises and sets at a place.
+ *
+ * @module
+ */
+import { CommandEnvelope } from '@fnndsc/cumin';
+import { type WeatherFetch, type WeatherPlace } from '../sys/weather.js';
+/** A date as a Julian day. */
+export declare function julianDay_of(date: Date): number;
+/** The moon's state on a date. */
+export interface MoonPhase {
+    /** 0 at new, 0.5 at full, in [0, 1). */
+    phase: number;
+    /** The lit fraction, 0..1. */
+    illumination: number;
+    /** The phase's name. */
+    name: string;
+    /** Days to the next full moon and the next new moon. */
+    toFull: number;
+    toNew: number;
+}
+/** Where the moon stands on a date. */
+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]` */
+export declare function builtin_pom(args: string[]): Promise<CommandEnvelope>;
+/** The stardate two ways: the Kelvin films' `YYYY.DDD`, and TNG's thousand-per-year from 2323. */
+export declare function stardate_of(date: Date): {
+    kelvin: string;
+    tng: string;
+};
+/** `stardate` */
+export declare function builtin_stardate(args: string[]): Promise<CommandEnvelope>;
+/** The Discordian date of a Gregorian one. */
+export interface DiscordianDate {
+    yold: number;
+    season: string;
+    day: number;
+    weekday: string;
+    holyday: string | null;
+    tibs: boolean;
+}
+export declare function ddate_of(date: Date): DiscordianDate;
+/** 1st, 2nd, 3rd, 4th … 11th, 12th, 13th … 21st. */
+export declare function ordinal_of(n: number): string;
+/** `ddate [YYYY-MM-DD]` */
+export declare function builtin_ddate(args: string[]): Promise<CommandEnvelope>;
+/** What Open-Meteo says of one day's sun. */
+export interface SunDay {
+    date: string;
+    sunrise: string;
+    sunset: string;
+    daylightSeconds: number;
+}
+/**
+ * Asks Open-Meteo when the sun rises and sets at a place, today and tomorrow.
+ *
+ * @param fetchFn - The fetch to use.
+ * @param place - Where.
+ */
+export declare function sun_fetch(fetchFn: WeatherFetch, place: WeatherPlace): Promise<SunDay[]>;
+/** `sunrise [place]` */
+export declare function builtin_sunrise(args: string[], fetchFn?: WeatherFetch): Promise<CommandEnvelope>;

package/dist/builtins/games/sky.js

@@ -0,0 +1,190 @@
+/**
+ * @file Time and sky from the shelf: `pom`, `stardate`, `ddate`, `sunrise`.
+ *
+ * `pom` is BSD's phase of the moon; `stardate` reckons the day two ways;
+ * `ddate` is the Discordian calendar, holy days included; `sunrise` asks
+ * Open-Meteo (the service `weather` already uses, no key) when the sun
+ * rises and sets at a place.
+ *
+ * @module
+ */
+import { envelope_ok, envelope_error } from '@fnndsc/cumin';
+import chalk from 'chalk';
+import { WEATHER_DEFAULT_PLACE, place_find } from '../sys/weather.js';
+/* --------------------------------------------------------------- moon */
+/** A reference new moon: 2000-01-06 18:14 UTC, as a Julian day. */
+const NEW_MOON_JD = 2451550.1;
+/** The synodic month, in days. */
+const SYNODIC_DAYS = 29.530588853;
+/** A date as a Julian day. */
+export function julianDay_of(date) {
+    return date.getTime() / 86_400_000 + 2440587.5;
+}
+/** Where the moon stands on a date. */
+export function moon_phase(date) {
+    const cycles = (julianDay_of(date) - NEW_MOON_JD) / SYNODIC_DAYS;
+    const phase = cycles - Math.floor(cycles);
+    const illumination = (1 - Math.cos(2 * Math.PI * phase)) / 2;
+    const near = (p) => Math.abs(phase - p) < 0.034 || Math.abs(phase - p - 1) < 0.034;
+    const name = near(0) ? 'New Moon' : near(0.25) ? 'First Quarter' : near(0.5) ? 'Full Moon' : near(0.75) ? 'Last Quarter'
+        : phase < 0.25 ? 'Waxing Crescent' : phase < 0.5 ? 'Waxing Gibbous' : phase < 0.75 ? 'Waning Gibbous' : 'Waning Crescent';
+    const toFull = ((0.5 - phase + 1) % 1) * SYNODIC_DAYS;
+    const toNew = ((1 - phase) % 1) * SYNODIC_DAYS;
+    return { phase, illumination, name, toFull, toNew };
+}
+/** A small moon, lit from the side the phase lights. */
+export function moon_draw(phase) {
+    const lit = phase.illumination;
+    const waxing = phase.phase < 0.5;
+    const rows = [];
+    const radius = 4;
+    for (let y = -radius; y <= radius; y++) {
+        let row = '';
+        for (let x = -radius * 2; x <= radius * 2; x++) {
+            const dx = x / 2;
+            const inside = dx * dx + y * y <= radius * radius + 0.5;
+            if (!inside) {
+                row += ' ';
+                continue;
+            }
+            const half = Math.sqrt(Math.max(0, radius * radius - y * y));
+            // The terminator: a chord moving across the disc as the phase goes.
+            const edge = (1 - 2 * lit) * half;
+            const bright = waxing ? dx >= edge : dx <= -edge;
+            row += bright ? '@' : '.';
+        }
+        rows.push(row.trimEnd());
+    }
+    return rows;
+}
+/** `pom [YYYY-MM-DD]` */
+export async function builtin_pom(args) {
+    const date = args.length > 0 ? new Date(args.join(' ')) : new Date();
+    if (Number.isNaN(date.getTime()))
+        return envelope_error('', undefined, `pom: '${args.join(' ')}' is not a date (try pom 2026-12-25)\n`);
+    const moon = moon_phase(date);
+    const percent = Math.round(moon.illumination * 100);
+    const trend = moon.name === 'Full Moon' || moon.name === 'New Moon' ? '' : moon.phase < 0.5 ? ' (waxing)' : ' (waning)';
+    const lines = [
+        `The Moon is ${chalk.bold(moon.name)}${trend}: ${percent}% of the Full`,
+        `${chalk.gray(`next full moon in ${moon.toFull.toFixed(1)} days, next new moon in ${moon.toNew.toFixed(1)} days`)}`,
+        ...moon_draw(moon).map((row) => `   ${row}`),
+    ];
+    return envelope_ok(`${lines.join('\n')}\n`, { kind: 'games.pom', data: { date: date.toISOString(), ...moon } });
+}
+/* ----------------------------------------------------------- stardate */
+/** Days into the year, 1-based, and the year's length. */
+function yearDay_of(date) {
+    const start = Date.UTC(date.getUTCFullYear(), 0, 1);
+    const next = Date.UTC(date.getUTCFullYear() + 1, 0, 1);
+    const elapsed = date.getTime() - start;
+    const days = Math.round((next - start) / 86_400_000);
+    return { day: Math.floor(elapsed / 86_400_000) + 1, days, fraction: elapsed / (next - start) };
+}
+/** The stardate two ways: the Kelvin films' `YYYY.DDD`, and TNG's thousand-per-year from 2323. */
+export function stardate_of(date) {
+    const { day, fraction } = yearDay_of(date);
+    const year = date.getUTCFullYear();
+    const kelvin = `${year}.${String(day).padStart(3, '0')}`;
+    const tng = (year - 2323) * 1000 + fraction * 1000;
+    return { kelvin, tng: tng.toFixed(1) };
+}
+/** `stardate` */
+export async function builtin_stardate(args) {
+    const date = args.length > 0 ? new Date(args.join(' ')) : new Date();
+    if (Number.isNaN(date.getTime()))
+        return envelope_error('', undefined, `stardate: '${args.join(' ')}' is not a date\n`);
+    const sd = stardate_of(date);
+    const lines = [
+        `Stardate ${chalk.bold(sd.kelvin)}`,
+        chalk.gray(`(Kelvin reckoning: the year and the day of it; by TNG's count it is ${sd.tng} — that era is still ahead of us)`),
+    ];
+    return envelope_ok(`${lines.join('\n')}\n`, { kind: 'games.stardate', data: { date: date.toISOString(), ...sd } });
+}
+/* -------------------------------------------------------------- ddate */
+const SEASONS = ['Chaos', 'Discord', 'Confusion', 'Bureaucracy', 'The Aftermath'];
+const WEEKDAYS = ['Sweetmorn', 'Boomtime', 'Pungenday', 'Prickle-Prickle', 'Setting Orange'];
+const APOSTLE_DAYS = ['Mungday', 'Mojoday', 'Syaday', 'Zaraday', 'Maladay'];
+const SEASON_DAYS = ['Chaoflux', 'Discoflux', 'Confuflux', 'Bureflux', 'Afflux'];
+export function ddate_of(date) {
+    const year = date.getFullYear();
+    const yold = year + 1166;
+    const start = new Date(year, 0, 1);
+    const doy = Math.round((new Date(year, date.getMonth(), date.getDate()).getTime() - start.getTime()) / 86_400_000) + 1;
+    const leap = (year % 4 === 0 && year % 100 !== 0) || year % 400 === 0;
+    if (leap && doy === 60)
+        return { yold, season: 'Chaos', day: 0, weekday: '', holyday: "St. Tib's Day", tibs: true };
+    const adjusted = leap && doy > 60 ? doy - 1 : doy;
+    const season = Math.floor((adjusted - 1) / 73);
+    const day = ((adjusted - 1) % 73) + 1;
+    const weekday = WEEKDAYS[(adjusted - 1) % 5];
+    const holyday = day === 5 ? APOSTLE_DAYS[season] : day === 50 ? SEASON_DAYS[season] : null;
+    return { yold, season: SEASONS[season], day, weekday, holyday, tibs: false };
+}
+/** 1st, 2nd, 3rd, 4th … 11th, 12th, 13th … 21st. */
+export function ordinal_of(n) {
+    const rest = n % 100;
+    if (rest >= 11 && rest <= 13)
+        return `${n}th`;
+    return `${n}${['th', 'st', 'nd', 'rd'][n % 10] ?? 'th'}`;
+}
+/** `ddate [YYYY-MM-DD]` */
+export async function builtin_ddate(args) {
+    const date = args.length > 0 ? new Date(args.join(' ')) : new Date();
+    if (Number.isNaN(date.getTime()))
+        return envelope_error('', undefined, `ddate: '${args.join(' ')}' is not a date\n`);
+    const d = ddate_of(date);
+    const line = d.tibs
+        ? `Today is St. Tib's Day in the YOLD ${d.yold}`
+        : `Today is ${d.weekday}, the ${ordinal_of(d.day)} day of ${d.season} in the YOLD ${d.yold}${d.holyday === null ? '' : `\nCelebrate ${d.holyday}!`}`;
+    return envelope_ok(`${line}\n`, { kind: 'games.ddate', data: { date: date.toISOString(), ...d } });
+}
+/* ------------------------------------------------------------ sunrise */
+const FORECAST_URL = 'https://api.open-meteo.com/v1/forecast';
+const FETCH_TIMEOUT_MS = 8_000;
+/**
+ * Asks Open-Meteo when the sun rises and sets at a place, today and tomorrow.
+ *
+ * @param fetchFn - The fetch to use.
+ * @param place - Where.
+ */
+export async function sun_fetch(fetchFn, place) {
+    const url = `${FORECAST_URL}?latitude=${place.latitude}&longitude=${place.longitude}&daily=sunrise,sunset,daylight_duration&timezone=auto&forecast_days=2`;
+    const response = await fetchFn(url, { signal: AbortSignal.timeout(FETCH_TIMEOUT_MS) });
+    if (!response.ok)
+        throw new Error(`open-meteo answered ${response.status}`);
+    const answer = (await response.json());
+    const daily = answer.daily ?? {};
+    return (daily.time ?? []).map((date, i) => ({
+        date,
+        sunrise: daily.sunrise?.[i] ?? '',
+        sunset: daily.sunset?.[i] ?? '',
+        daylightSeconds: daily.daylight_duration?.[i] ?? 0,
+    }));
+}
+/** `HH:MM` out of an ISO local time. */
+const clock_of = (iso) => iso.slice(11, 16) || '?';
+/** `sunrise [place]` */
+export async function builtin_sunrise(args, fetchFn = (url, init) => fetch(url, init)) {
+    const name = args.length > 0 ? args.join(' ') : WEATHER_DEFAULT_PLACE;
+    try {
+        const place = await place_find(fetchFn, name);
+        if (place === null)
+            return envelope_error('', undefined, `sunrise: no place called '${name}' that open-meteo knows\n`);
+        const days = await sun_fetch(fetchFn, place);
+        if (days.length === 0)
+            return envelope_error('', undefined, `sunrise: open-meteo had no days for ${place.name}\n`);
+        const where = [place.name, place.region, place.country].filter((p) => p.length > 0).join(', ');
+        const lines = [chalk.bold(where)];
+        for (const [i, day] of days.entries()) {
+            const hours = Math.floor(day.daylightSeconds / 3600);
+            const minutes = Math.round((day.daylightSeconds % 3600) / 60);
+            lines.push(`${i === 0 ? 'today   ' : 'tomorrow'} ${day.date}  sunrise ${chalk.yellow(clock_of(day.sunrise))}  sunset ${chalk.yellow(clock_of(day.sunset))}  ${chalk.gray(`${hours}h ${String(minutes).padStart(2, '0')}m of daylight`)}`);
+        }
+        return envelope_ok(`${lines.join('\n')}\n`, { kind: 'games.sunrise', data: { place, days } });
+    }
+    catch (error) {
+        return envelope_error('', undefined, `sunrise: ${error instanceof Error ? error.message : String(error)}\n`);
+    }
+}
+//# sourceMappingURL=sky.js.map

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

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

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

@@ -0,0 +1,34 @@
+/**
+ * @file What a piped builtin reads: the text the segment before it wrote.
+ *
+ * A pipeline's first segment always ran in the kernel; the rest went to the
+ * surface's host shell, so `fortune | cowsay` reached the host's cowsay (or,
+ * in a browser, nothing). A segment that names a builtin now runs in the
+ * kernel too, and reads what came before it here. The slot is set by the
+ * pipe for the length of one segment and taken by the builtin that wants
+ * it; a builtin that does not read it leaves it to be cleared, as a shell
+ * command that ignores stdin does.
+ *
+ * @module
+ */
+/**
+ * Sets what the next builtin may read; the pipe calls this before a segment
+ * and clears it after.
+ *
+ * @param text - The previous segment's output, or null for none.
+ */
+export declare function stdin_set(text: string | null): void;
+/**
+ * Takes the piped text, once.
+ *
+ * @returns The text, or null when the builtin was not piped into.
+ */
+export declare function stdin_take(): string | null;
+/**
+ * The text a toy works on: what was piped in, else its arguments joined,
+ * else nothing.
+ *
+ * @param args - The builtin's arguments.
+ * @returns The text, or null when there is none either way.
+ */
+export declare function text_input(args: ReadonlyArray<string>): string | null;

package/dist/builtins/games/stdin.js

@@ -0,0 +1,48 @@
+/**
+ * @file What a piped builtin reads: the text the segment before it wrote.
+ *
+ * A pipeline's first segment always ran in the kernel; the rest went to the
+ * surface's host shell, so `fortune | cowsay` reached the host's cowsay (or,
+ * in a browser, nothing). A segment that names a builtin now runs in the
+ * kernel too, and reads what came before it here. The slot is set by the
+ * pipe for the length of one segment and taken by the builtin that wants
+ * it; a builtin that does not read it leaves it to be cleared, as a shell
+ * command that ignores stdin does.
+ *
+ * @module
+ */
+/** The text piped into the segment now running, or null when nothing was. */
+let piped = null;
+/**
+ * Sets what the next builtin may read; the pipe calls this before a segment
+ * and clears it after.
+ *
+ * @param text - The previous segment's output, or null for none.
+ */
+export function stdin_set(text) {
+    piped = text;
+}
+/**
+ * Takes the piped text, once.
+ *
+ * @returns The text, or null when the builtin was not piped into.
+ */
+export function stdin_take() {
+    const text = piped;
+    piped = null;
+    return text;
+}
+/**
+ * The text a toy works on: what was piped in, else its arguments joined,
+ * else nothing.
+ *
+ * @param args - The builtin's arguments.
+ * @returns The text, or null when there is none either way.
+ */
+export function text_input(args) {
+    const fromPipe = stdin_take();
+    if (fromPipe !== null)
+        return fromPipe;
+    return args.length > 0 ? args.join(' ') : null;
+}
+//# sourceMappingURL=stdin.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"stdin.js","sourceRoot":"","sources":["../../../src/builtins/games/stdin.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,6EAA6E;AAC7E,IAAI,KAAK,GAAkB,IAAI,CAAC;AAEhC;;;;;GAKG;AACH,MAAM,UAAU,SAAS,CAAC,IAAmB;IAC3C,KAAK,GAAG,IAAI,CAAC;AACf,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,UAAU;IACxB,MAAM,IAAI,GAAkB,KAAK,CAAC;IAClC,KAAK,GAAG,IAAI,CAAC;IACb,OAAO,IAAI,CAAC;AACd,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,UAAU,CAAC,IAA2B;IACpD,MAAM,QAAQ,GAAkB,UAAU,EAAE,CAAC;IAC7C,IAAI,QAAQ,KAAK,IAAI;QAAE,OAAO,QAAQ,CAAC;IACvC,OAAO,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACjD,CAAC"}

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

@@ -0,0 +1,46 @@
+/**
+ * @file Text toys from the shelf: `rev`, `tac`, `yes`, `seq`, `shuf`, `rot13`.
+ *
+ * Each reads what was piped in, else its arguments, and answers in kind:
+ * `fortune | rev`, `rot13 hello`, `seq 1 2 9`. `yes` is bounded — a shell
+ * that never ends is not a toy — and says how many it printed.
+ *
+ * @module
+ */
+import { CommandEnvelope } from '@fnndsc/cumin';
+/** Lines `yes` prints when not told how many. */
+export declare const YES_DEFAULT: number;
+/** The most lines `yes` prints however it is asked. */
+export declare const YES_MAX: number;
+/** The most numbers `seq` prints. */
+export declare const SEQ_MAX: number;
+/** Reverses each line's characters, keeping the lines. */
+export declare function text_rev(text: string): string;
+/** Reverses the order of the lines. */
+export declare function text_tac(text: string): string;
+/** The ROT13 of a text; letters only, case kept. */
+export declare function text_rot13(text: string): string;
+/**
+ * The numbers `seq` prints: `seq LAST`, `seq FIRST LAST`, `seq FIRST STEP LAST`.
+ *
+ * @returns The numbers, or a refusal.
+ */
+export declare function seq_numbers(args: ReadonlyArray<string>): {
+    numbers: number[];
+} | {
+    refusal: string;
+};
+/** Shuffles lines (Fisher–Yates), with an optional source of chance for tests. */
+export declare function lines_shuffle(lines: string[], random?: () => number): string[];
+/** `rev [text]` */
+export declare function builtin_rev(args: string[]): Promise<CommandEnvelope>;
+/** `tac [text]` */
+export declare function builtin_tac(args: string[]): Promise<CommandEnvelope>;
+/** `yes [word] [-n N]` */
+export declare function builtin_yes(args: string[]): Promise<CommandEnvelope>;
+/** `seq [FIRST [STEP]] LAST` */
+export declare function builtin_seq(args: string[]): Promise<CommandEnvelope>;
+/** `shuf [words...]`: lines piped in, or the words given, in a random order. */
+export declare function builtin_shuf(args: string[]): Promise<CommandEnvelope>;
+/** `rot13 [text]` */
+export declare function builtin_rot13(args: string[]): Promise<CommandEnvelope>;