@elaraai/e3-ui-cli 1.0.72 → 1.0.73

package/dist/tui/lifecycle.d.ts

@@ -0,0 +1,61 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/** The exit code for an unexpected failure (EX_SOFTWARE). */
+export declare const EXIT_SOFTWARE = 70;
+/** A line logger. */
+export type Logger = (line: string) => void;
+/**
+ * The debug logger: appends to `$XDG_STATE_HOME/e3-ui/debug.log` (beside
+ * the state file) when `E3_UI_DEBUG=1`, else a no-op.
+ *
+ * @param env - The environment
+ * @returns The logger and the log path (null when disabled)
+ */
+export declare function createDebugLogger(env: NodeJS.ProcessEnv): {
+    log: Logger;
+    file: string | null;
+};
+/** What the handlers call. */
+export interface LifecycleHooks {
+    /** A termination signal arrived: unmount and stop. */
+    onSignal: (signal: NodeJS.Signals) => void;
+    /** An unexpected error: the terminal is restored by the caller, then this reports it. */
+    onFatal: (error: unknown) => void;
+}
+/**
+ * Installs the process handlers.
+ *
+ * @param hooks - The callbacks
+ * @returns A function that removes them
+ */
+export declare function installLifecycle(hooks: LifecycleHooks): () => void;
+/**
+ * The stack (or message) of an unexpected error, for stderr after the
+ * terminal is restored.
+ *
+ * @param error - The error
+ * @returns The text
+ */
+export declare function fatalText(error: unknown): string;
+/**
+ * A one-line terminal description for the about view
+ * (`kitty 0.36 · 120×36 · truecolor · mouse ● · kitty keyboard ○`).
+ *
+ * @param env - The environment
+ * @param size - The terminal size
+ * @param colorLevel - The colour level
+ * @param mouse - Whether mouse reporting is on
+ * @param glyphs - The glyphs for the dots
+ * @returns The description
+ */
+export declare function describeTerminal(env: NodeJS.ProcessEnv, size: {
+    columns: number;
+    rows: number;
+}, colorLevel: number, mouse: boolean, glyphs: {
+    dot: string;
+    empty: string;
+    sep: string;
+}): string;
+//# sourceMappingURL=lifecycle.d.ts.map

package/dist/tui/lifecycle.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"lifecycle.d.ts","sourceRoot":"","sources":["../../src/tui/lifecycle.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAkBH,6DAA6D;AAC7D,eAAO,MAAM,aAAa,KAAK,CAAC;AAEhC,qBAAqB;AACrB,MAAM,MAAM,MAAM,GAAG,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;AAE5C;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAgB9F;AAED,8BAA8B;AAC9B,MAAM,WAAW,cAAc;IAC3B,sDAAsD;IACtD,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,OAAO,KAAK,IAAI,CAAC;IAC3C,yFAAyF;IACzF,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;CACrC;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,cAAc,GAAG,MAAM,IAAI,CAalE;AAED;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAGhD;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,gBAAgB,CAC5B,GAAG,EAAE,MAAM,CAAC,UAAU,EACtB,IAAI,EAAE;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,EACvC,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,OAAO,EACd,MAAM,EAAE;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GACpD,MAAM,CAMR"}

package/dist/tui/lifecycle.js

@@ -0,0 +1,99 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * Lifecycle — the process-level handlers the terminal UI installs:
+ * SIGINT / SIGTERM / SIGHUP unmount cleanly (Ctrl-C is a key while the
+ * UI runs, so SIGINT only arrives from outside), `uncaughtException` /
+ * `unhandledRejection` restore the terminal first, then print the stack
+ * and exit 70; and the `E3_UI_DEBUG=1` file logger, which never writes to
+ * stdout or stderr while the UI owns the screen.
+ *
+ * @packageDocumentation
+ */
+import * as fs from 'node:fs';
+import * as path from 'node:path';
+import * as os from 'node:os';
+import { statePath } from './state/persist.js';
+/** The exit code for an unexpected failure (EX_SOFTWARE). */
+export const EXIT_SOFTWARE = 70;
+/**
+ * The debug logger: appends to `$XDG_STATE_HOME/e3-ui/debug.log` (beside
+ * the state file) when `E3_UI_DEBUG=1`, else a no-op.
+ *
+ * @param env - The environment
+ * @returns The logger and the log path (null when disabled)
+ */
+export function createDebugLogger(env) {
+    if (env['E3_UI_DEBUG'] !== '1')
+        return { log: () => undefined, file: null };
+    const file = path.join(path.dirname(statePath(env, process.platform, os.homedir())), 'debug.log');
+    let ready = false;
+    const log = (line) => {
+        try {
+            if (!ready) {
+                fs.mkdirSync(path.dirname(file), { recursive: true, mode: 0o700 });
+                ready = true;
+            }
+            fs.appendFileSync(file, `${new Date().toISOString()} ${line}\n`, { mode: 0o600 });
+        }
+        catch {
+            // The log must never take the UI down.
+        }
+    };
+    return { log, file };
+}
+/**
+ * Installs the process handlers.
+ *
+ * @param hooks - The callbacks
+ * @returns A function that removes them
+ */
+export function installLifecycle(hooks) {
+    const signals = ['SIGINT', 'SIGTERM', 'SIGHUP'];
+    const onSignal = (signal) => hooks.onSignal(signal);
+    const onException = (error) => hooks.onFatal(error);
+    const onRejection = (reason) => hooks.onFatal(reason);
+    for (const signal of signals)
+        process.on(signal, onSignal);
+    process.on('uncaughtException', onException);
+    process.on('unhandledRejection', onRejection);
+    return () => {
+        for (const signal of signals)
+            process.off(signal, onSignal);
+        process.off('uncaughtException', onException);
+        process.off('unhandledRejection', onRejection);
+    };
+}
+/**
+ * The stack (or message) of an unexpected error, for stderr after the
+ * terminal is restored.
+ *
+ * @param error - The error
+ * @returns The text
+ */
+export function fatalText(error) {
+    if (error instanceof Error)
+        return error.stack ?? `${error.name}: ${error.message}`;
+    return String(error);
+}
+/**
+ * A one-line terminal description for the about view
+ * (`kitty 0.36 · 120×36 · truecolor · mouse ● · kitty keyboard ○`).
+ *
+ * @param env - The environment
+ * @param size - The terminal size
+ * @param colorLevel - The colour level
+ * @param mouse - Whether mouse reporting is on
+ * @param glyphs - The glyphs for the dots
+ * @returns The description
+ */
+export function describeTerminal(env, size, colorLevel, mouse, glyphs) {
+    const program = env['TERM_PROGRAM'] ?? env['TERMINAL_EMULATOR'] ?? (env['TERM'] === 'xterm-kitty' ? 'kitty' : env['TERM'] ?? 'terminal');
+    const version = env['TERM_PROGRAM_VERSION'] !== undefined ? ` ${env['TERM_PROGRAM_VERSION']}` : '';
+    const colour = colorLevel >= 3 ? 'truecolor' : colorLevel === 2 ? '256 colours' : colorLevel === 1 ? '16 colours' : 'no colour';
+    const on = (flag) => (flag ? glyphs.dot : glyphs.empty);
+    return `${program}${version} ${glyphs.sep} ${size.columns}×${size.rows} ${glyphs.sep} ${colour} ${glyphs.sep} mouse ${on(mouse)}`;
+}
+//# sourceMappingURL=lifecycle.js.map

package/dist/tui/lifecycle.js.map

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

package/dist/tui/model/catalogue.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+import type { Catalogue } from '../input/completion.js';
+import type { Glyphs } from '../render/glyphs.js';
+import type { TuiState } from '../state/actions.js';
+/**
+ * The entry of a dataset in the workspace's dataset list (type / size), by
+ * dotted path. The recursive listing shows a task's subtree as one leaf at
+ * `.tasks.<name>` carrying the output's type / hash / size, while the status
+ * names the output `.tasks.<name>.output` — both spellings resolve.
+ */
+export declare function datasetEntries(state: TuiState, ws: string): Map<string, {
+    type: string;
+    size: number | null;
+    hash: string | null;
+}>;
+/**
+ * Builds the catalogue.
+ *
+ * @param state - The store state
+ * @param g - The glyph set
+ * @param tags - Variant tags offered by `/tag` on the selected row
+ * @returns The catalogue
+ */
+export declare function buildCatalogue(state: TuiState, g: Glyphs, tags?: string[]): Catalogue;
+//# sourceMappingURL=catalogue.d.ts.map

package/dist/tui/model/catalogue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalogue.d.ts","sourceRoot":"","sources":["../../../src/tui/model/catalogue.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAWH,OAAO,KAAK,EAAE,SAAS,EAAiB,MAAM,wBAAwB,CAAC;AACvE,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAElD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAIpD;;;;;GAKG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,GAAG,GAAG,CAAC,MAAM,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAA;CAAE,CAAC,CAmBnI;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,SAAS,CA+CrF"}

package/dist/tui/model/catalogue.js

@@ -0,0 +1,94 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+import { formatSize } from '../render/text.js';
+import { compactType } from './types.js';
+import { datasetStatusCell, statusText, taskStatusCell } from './status.js';
+/**
+ * The entry of a dataset in the workspace's dataset list (type / size), by
+ * dotted path. The recursive listing shows a task's subtree as one leaf at
+ * `.tasks.<name>` carrying the output's type / hash / size, while the status
+ * names the output `.tasks.<name>.output` — both spellings resolve.
+ */
+export function datasetEntries(state, ws) {
+    const raw = new Map();
+    for (const entry of state.data.datasets[ws] ?? []) {
+        if (entry.type !== 'dataset')
+            continue;
+        raw.set(`.${entry.value.path.replace(/^\./, '')}`, {
+            type: entry.value.type,
+            size: entry.value.size.type === 'some' ? Number(entry.value.size.value) : null,
+            hash: entry.value.hash.type === 'some' ? entry.value.hash.value : null,
+        });
+    }
+    for (const task of state.data.status[ws]?.result.tasks ?? []) {
+        if (raw.has(task.output))
+            continue;
+        const leaf = raw.get(task.output.replace(/\.output$/, ''));
+        if (leaf !== undefined)
+            raw.set(task.output, leaf);
+    }
+    const uiTasks = new Set((state.data.taskList[ws] ?? []).filter(t => t.kind.type === 'some' && t.kind.value === 'ui').map(t => `.tasks.${t.name}.output`));
+    const out = new Map();
+    for (const [path, entry] of raw)
+        out.set(path, { type: compactType(entry.type, uiTasks.has(path)), size: entry.size, hash: entry.hash });
+    return out;
+}
+/**
+ * Builds the catalogue.
+ *
+ * @param state - The store state
+ * @param g - The glyph set
+ * @param tags - Variant tags offered by `/tag` on the selected row
+ * @returns The catalogue
+ */
+export function buildCatalogue(state, g, tags) {
+    const items = [];
+    for (const w of state.data.workspaces ?? []) {
+        const pkg = w.packageName.type === 'some' ? `${w.packageName.value}${w.packageVersion.type === 'some' ? `@${w.packageVersion.value}` : ''}` : '';
+        items.push({ kind: 'workspace', name: w.name, workspace: null, status: w.deployed ? `${g.dot} DEPLOYED` : `${g.empty} EMPTY`, type: pkg, detail: '' });
+    }
+    for (const [ws, { result }] of Object.entries(state.data.status)) {
+        const entries = datasetEntries(state, ws);
+        for (const task of result.tasks) {
+            const entry = entries.get(task.output);
+            items.push({
+                kind: 'task',
+                name: task.name,
+                workspace: ws,
+                status: statusText(taskStatusCell(task.status, g)),
+                type: entry?.type ?? '',
+                detail: entry?.size != null ? formatSize(entry.size) : '—',
+            });
+        }
+        for (const dataset of result.datasets) {
+            const entry = entries.get(dataset.path);
+            const status = statusText(datasetStatusCell(dataset.status.type, g));
+            if (!dataset.isTaskOutput && dataset.path.startsWith('.inputs.')) {
+                items.push({
+                    kind: 'input',
+                    name: dataset.path.slice('.inputs.'.length),
+                    workspace: ws,
+                    status,
+                    type: entry?.type ?? '',
+                    detail: entry?.size != null ? formatSize(entry.size) : '—',
+                });
+            }
+            items.push({
+                kind: 'dataset',
+                name: dataset.path,
+                workspace: ws,
+                status,
+                type: '',
+                detail: entry?.size != null ? formatSize(entry.size) : '—',
+            });
+        }
+    }
+    for (const name of state.data.repos?.names ?? []) {
+        const status = state.data.repos?.status[name];
+        items.push({ kind: 'repo', name, workspace: null, status: status !== undefined ? `${status.workspaceCount} workspaces` : '', type: '', detail: '' });
+    }
+    return { items, tags };
+}
+//# sourceMappingURL=catalogue.js.map

package/dist/tui/model/catalogue.js.map

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

package/dist/tui/model/help.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * The help view's content — one tab per page (plus what works everywhere),
+ * so the commands and keys listed are exactly the ones that work where you
+ * are. `?` opens the tab of the page it was pressed on.
+ *
+ * @packageDocumentation
+ */
+import type { HelpTab, ViewKind } from '../state/actions.js';
+/** A help column: a heading and `[key, effect]` rows. */
+export interface HelpColumn {
+    title: string;
+    rows: [string, string][];
+}
+/** The tabs in order, with their labels. */
+export declare const HELP_TABS: readonly {
+    tab: HelpTab;
+    label: string;
+}[];
+/**
+ * The help tab a page opens on.
+ *
+ * @param from - The page `?` was pressed on
+ * @returns Its tab (`everywhere` for the launch / refusal / help / about screens)
+ */
+export declare function helpTabFor(from: ViewKind): HelpTab;
+/**
+ * The columns of a help tab.
+ *
+ * @param tab - The tab
+ * @returns Three columns (some may be empty)
+ */
+export declare function helpColumns(tab: HelpTab): HelpColumn[];
+//# sourceMappingURL=help.d.ts.map

package/dist/tui/model/help.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"help.d.ts","sourceRoot":"","sources":["../../../src/tui/model/help.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAE7D,yDAAyD;AACzD,MAAM,WAAW,UAAU;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,CAAC;CAC5B;AAED,4CAA4C;AAC5C,eAAO,MAAM,SAAS,EAAE,SAAS;IAAE,GAAG,EAAE,OAAO,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,EAO/D,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,QAAQ,GAAG,OAAO,CASlD;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,GAAG,EAAE,OAAO,GAAG,UAAU,EAAE,CA6KtD"}

package/dist/tui/model/help.js

@@ -0,0 +1,210 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/** The tabs in order, with their labels. */
+export const HELP_TABS = [
+    { tab: 'everywhere', label: 'Everywhere' },
+    { tab: 'repos', label: 'Repos' },
+    { tab: 'workspaces', label: 'Workspaces' },
+    { tab: 'dashboard', label: 'Dashboard' },
+    { tab: 'task', label: 'Task' },
+    { tab: 'input', label: 'Input' },
+];
+/**
+ * The help tab a page opens on.
+ *
+ * @param from - The page `?` was pressed on
+ * @returns Its tab (`everywhere` for the launch / refusal / help / about screens)
+ */
+export function helpTabFor(from) {
+    switch (from) {
+        case 'repos': return 'repos';
+        case 'workspaces': return 'workspaces';
+        case 'dashboard': return 'dashboard';
+        case 'task': return 'task';
+        case 'input': return 'input';
+        default: return 'everywhere';
+    }
+}
+/**
+ * The columns of a help tab.
+ *
+ * @param tab - The tab
+ * @returns Three columns (some may be empty)
+ */
+export function helpColumns(tab) {
+    switch (tab) {
+        case 'everywhere':
+            return [
+                {
+                    title: 'COMMANDS',
+                    rows: [
+                        ['/task <name>', 'open a task'],
+                        ['/input <name>', 'open an input'],
+                        ['/dataset <path>', 'open a dataset'],
+                        ['/workspace <name>', 'switch workspace'],
+                        ['/workspaces  /repos', 'the lists'],
+                        ['/repo <path|url>', 'open another repo'],
+                        ['/login <url>', 'device-flow login'],
+                        ['/refresh', 'poll everything now'],
+                        ['/help  /about  /quit', ''],
+                        ['', ''],
+                        ['typing without /', 'fuzzy-jumps anywhere'],
+                    ],
+                },
+                {
+                    title: 'KEYS',
+                    rows: [
+                        ['?', 'help for this page'],
+                        ['q  ^c', 'quit'],
+                        ['esc  ⌫', 'back'],
+                        ['tab  ⇧tab', 'next / prev tab'],
+                        ['1 2 3 …', 'tabs'],
+                        ['R', 'refresh now'],
+                        ['/', 'a command'],
+                        ['↑↓  j k', 'move'],
+                        ['pgup pgdn  ^u ^d', 'page'],
+                        ['gg  G', 'top / bottom'],
+                    ],
+                },
+                {
+                    title: 'MOUSE',
+                    rows: [
+                        ['wheel', 'scroll'],
+                        ['click', 'select'],
+                        ['click ▸', 'toggle'],
+                        ['drag ▮', 'scrollbar'],
+                        ['click tab / crumb', 'act'],
+                        ['', ''],
+                        ['--no-mouse', 'keyboard only'],
+                    ],
+                },
+            ];
+        case 'repos':
+            return [
+                { title: 'COMMANDS', rows: [['/repo <name>', 'open a repository'], ['/login <url>', 'device-flow login'], ['/refresh', 'poll now']] },
+                { title: 'KEYS', rows: [['↑↓  j k', 'move'], ['⏎  →', 'open the repository'], ['q', 'quit']] },
+                { title: '', rows: [] },
+            ];
+        case 'workspaces':
+            return [
+                { title: 'COMMANDS', rows: [['/workspace <name>', 'open a workspace'], ['/repos', 'back to the repositories'], ['/refresh', 'poll now']] },
+                { title: 'KEYS', rows: [['↑↓  j k', 'move'], ['⏎  →', 'open the workspace'], ['q', 'quit']] },
+                { title: '', rows: [] },
+            ];
+        case 'dashboard':
+            return [
+                {
+                    title: 'COMMANDS',
+                    rows: [
+                        ['/run [--force]', 'run the dataflow'],
+                        ['/run --filter <glob>', 'only matching tasks'],
+                        ['/run --concurrency <n>', ''],
+                        ['/stop', 'cancel the dataflow'],
+                        ['/task  /input', 'open a row'],
+                        ['/logs <task> [stderr]', 'a task\'s logs'],
+                        ['/runs <task>', 'a task\'s runs'],
+                        ['/workspace <name>', 'switch workspace'],
+                    ],
+                },
+                {
+                    title: 'KEYS',
+                    rows: [
+                        ['↑↓  j k', 'move'],
+                        ['⏎  →', 'open the task / input'],
+                        ['r', 'prefill /run'],
+                        ['x', 'prefill /stop'],
+                        ['w', 'workspaces'],
+                        ['R', 'refresh now'],
+                    ],
+                },
+                { title: 'ROWS', rows: [['tasks', '● up-to-date ◐ waiting ◔ running'], ['', '○ ready ✗ failed'], ['inputs', '● up-to-date ◐ stale ○ unset'], ['execution', '⏎ on a failed row → logs']] },
+            ];
+        case 'task':
+            return [
+                {
+                    title: 'COMMANDS',
+                    rows: [
+                        ['/find <"key">', 'exact key'],
+                        ['/find <prefix>', 'key prefix'],
+                        ['/find f1|f2', 'struct-key fields'],
+                        ['/goto <row>  /goto N%', 'jump'],
+                        ['/save [file]', 'write .beast2 / .log'],
+                        ['/logs [stderr]  /runs', 'switch tab'],
+                    ],
+                },
+                {
+                    title: 'KEYS · VALUE TREE',
+                    rows: [
+                        ['↑↓  j k', 'move'],
+                        ['→  l', 'expand'],
+                        ['←  h', 'collapse'],
+                        ['⏎  space', 'toggle'],
+                        ['⇧←', 'collapse subtree'],
+                        ['pgup pgdn  ^u ^d', 'page'],
+                        ['gg  G', 'top / bottom'],
+                        ['n  N', 'next / prev match'],
+                        ['s', 'save .beast2'],
+                        ['1 2 3 4 5', 'Output Stdout Stderr Runs Reads'],
+                        ['tab  ⇧tab', 'next / prev tab'],
+                    ],
+                },
+                {
+                    title: 'KEYS · STDOUT / STDERR',
+                    rows: [
+                        ['↑↓  pgup pgdn', 'scroll'],
+                        ['G', 'end'],
+                        ['F', 'follow the tail'],
+                        ['← →  tab', 'the other tabs'],
+                        ['n  N', 'next / prev match'],
+                        ['s', 'save .log'],
+                        ['c', 'copy'],
+                        ['', ''],
+                        ['KEYS · RUNS', ''],
+                        ['⏎', 'expand the inputs'],
+                    ],
+                },
+            ];
+        case 'input':
+            return [
+                {
+                    title: 'COMMANDS',
+                    rows: [
+                        ['/tag <name>', 'switch a variant tag'],
+                        ['/tag some  /tag none', 'set / clear an option'],
+                        ['/add [key]', 'add an item / entry'],
+                        ['/remove', 'remove the item'],
+                        ['/apply  /discard', 'the pending edits'],
+                        ['/find  /goto', 'as in a task'],
+                    ],
+                },
+                {
+                    title: 'KEYS',
+                    rows: [
+                        ['e', 'edit the leaf'],
+                        ['a', 'add'],
+                        ['x', 'remove'],
+                        ['t', 'tag / set / clear'],
+                        ['⏎', 'apply all'],
+                        ['esc', 'discard'],
+                        ['↑↓  → ←', 'move / expand / collapse'],
+                    ],
+                },
+                {
+                    title: 'EDITING',
+                    rows: [
+                        ['⏎', 'commit the leaf'],
+                        ['esc', 'cancel the leaf'],
+                        ['space', 'toggle a boolean'],
+                        ['', ''],
+                        ['◆ N DIRTY', 'the header pill'],
+                        ['┆', 'a changed row'],
+                        ['conflict', 'the server changed:'],
+                        ['', '⏎ reload · esc keep'],
+                    ],
+                },
+            ];
+    }
+}
+//# sourceMappingURL=help.js.map

package/dist/tui/model/help.js.map

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

package/dist/tui/model/index.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * View models — the pure selectors every view renders from and the
+ * controller navigates with. A view model is `{ rows, visible }` at
+ * minimum: the rows the primary list has and how many fit, so `list/move`
+ * is driven from one place.
+ *
+ * @packageDocumentation
+ */
+import { type ShellLayout } from '../render/layout.js';
+import type { TuiState } from '../state/actions.js';
+/** The rows of the current view's primary list and how many are visible. */
+export interface ListModel {
+    count: number;
+    visible: number;
+}
+/**
+ * The shell layout for the state (the commit bar shows while editing, the
+ * completion list while it has items).
+ *
+ * @param state - The store state
+ * @returns The layout
+ */
+export declare function layoutOf(state: TuiState): ShellLayout;
+/**
+ * Registers a view's list model (called by each view model module on load).
+ *
+ * @param kind - The view kind
+ * @param model - The selector
+ */
+export declare function registerListModel(kind: string, model: (state: TuiState, layout: ShellLayout) => ListModel): void;
+/**
+ * The current view's primary list model.
+ *
+ * @param state - The store state
+ * @returns The rows and visible count (0 / 0 for views without a list)
+ */
+export declare function listModel(state: TuiState): ListModel;
+//# sourceMappingURL=index.d.ts.map

package/dist/tui/model/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/tui/model/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;GAOG;AAEH,OAAO,EAAe,KAAK,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACpE,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AAEpD,4EAA4E;AAC5E,MAAM,WAAW,SAAS;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;GAMG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,QAAQ,GAAG,WAAW,CAKrD;AAKD;;;;;GAKG;AACH,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,KAAK,SAAS,GAAG,IAAI,CAEhH;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,QAAQ,GAAG,SAAS,CAIpD"}