@elaraai/e3-ui-cli 1.0.72 → 1.0.74

package/dist/tui/model/status.js

@@ -0,0 +1,137 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+import { formatDuration } from '../render/text.js';
+/** `● up-to-date`, `✗ failed · exit 2`, … */
+export function statusText(cell, sep = ' · ') {
+    return `${cell.glyph} ${cell.word}${cell.detail !== '' ? `${sep}${cell.detail}` : ''}`;
+}
+/**
+ * A task's status cell.
+ *
+ * @param status - The task status variant
+ * @param g - The glyph set
+ * @returns The cell
+ */
+export function taskStatusCell(status, g) {
+    switch (status.type) {
+        case 'up-to-date':
+            return { glyph: g.dot, tone: 'pos', word: 'up-to-date', detail: status.value.cached ? 'cached' : '' };
+        case 'ready':
+            return { glyph: g.empty, tone: 'muted', word: 'ready', detail: '' };
+        case 'waiting':
+            return { glyph: g.half, tone: 'warn', word: 'waiting', detail: status.value.reason };
+        case 'in-progress':
+            return { glyph: g.quarter, tone: 'info', word: 'in-progress', detail: status.value.pid.type === 'some' ? `pid ${status.value.pid.value}` : '' };
+        case 'failed':
+            return { glyph: g.cross, tone: 'neg', word: 'failed', detail: `exit ${status.value.exitCode}` };
+        case 'error':
+            return { glyph: g.cross, tone: 'neg', word: 'error', detail: status.value.message };
+        case 'stale-running':
+            return { glyph: g.half, tone: 'warn', word: 'stale-running', detail: status.value.pid.type === 'some' ? `pid ${status.value.pid.value} gone` : '' };
+    }
+}
+/**
+ * A dataset's status cell.
+ *
+ * @param status - `unset` / `stale` / `up-to-date`
+ * @param g - The glyph set
+ * @returns The cell
+ */
+export function datasetStatusCell(status, g) {
+    switch (status) {
+        case 'up-to-date': return { glyph: g.dot, tone: 'pos', word: 'up-to-date', detail: '' };
+        case 'stale': return { glyph: g.half, tone: 'warn', word: 'stale', detail: '' };
+        default: return { glyph: g.empty, tone: 'muted', word: 'unset', detail: '' };
+    }
+}
+/**
+ * An execution's status cell (`✗ FAILED`, `◔ RUNNING`, `● COMPLETED`, `■ ABORTED`).
+ *
+ * @param status - The execution status
+ * @param g - The glyph set
+ * @returns The cell
+ */
+export function executionStatusCell(status, g) {
+    switch (status) {
+        case 'running': return { glyph: g.quarter, tone: 'info', word: 'RUNNING', detail: '' };
+        case 'completed': return { glyph: g.dot, tone: 'pos', word: 'COMPLETED', detail: '' };
+        case 'failed': return { glyph: g.cross, tone: 'neg', word: 'FAILED', detail: '' };
+        case 'aborted': return { glyph: g.square, tone: 'warn', word: 'ABORTED', detail: '' };
+    }
+}
+/**
+ * A run-history item's status cell.
+ *
+ * @param status - The history status
+ * @param g - The glyph set
+ * @returns The cell
+ */
+export function historyStatusCell(status, g) {
+    switch (status) {
+        case 'running': return { glyph: g.quarter, tone: 'info', word: 'running', detail: '' };
+        case 'success': return { glyph: g.dot, tone: 'pos', word: 'success', detail: '' };
+        case 'failed': return { glyph: g.cross, tone: 'neg', word: 'failed', detail: '' };
+        case 'error': return { glyph: g.half, tone: 'warn', word: 'error', detail: '' };
+    }
+}
+/**
+ * The connection pill.
+ *
+ * @param connection - The connection state
+ * @param g - The glyph set
+ * @returns The cell (`● CONNECTED`, `◐ RECONNECTING 3/4`, `✗ OFFLINE`)
+ */
+export function connectionCell(connection, g) {
+    switch (connection.kind) {
+        case 'connected': return { glyph: g.dot, tone: 'pos', word: 'CONNECTED', detail: '' };
+        case 'reconnecting': return { glyph: g.half, tone: 'warn', word: `RECONNECTING ${connection.attempt}/${connection.of}`, detail: '' };
+        case 'offline': return { glyph: g.cross, tone: 'neg', word: 'OFFLINE', detail: '' };
+        default: return null;
+    }
+}
+/**
+ * An execution's wall-clock duration in milliseconds: the summary's, or
+ * `completedAt − startedAt` when the summary reports none (the server
+ * only times the runs it launched itself).
+ *
+ * @param state - The execution state
+ * @returns The duration, or `null` while it is still running
+ */
+export function executionDuration(state) {
+    if (state.summary.type === 'some' && state.summary.value.duration > 0)
+        return state.summary.value.duration;
+    if (state.completedAt.type === 'some') {
+        const ms = Date.parse(state.completedAt.value) - Date.parse(state.startedAt);
+        if (Number.isFinite(ms) && ms >= 0)
+            return ms;
+    }
+    return state.summary.type === 'some' ? state.summary.value.duration : null;
+}
+/**
+ * One dataflow event as the feed shows it — the cloud UI's
+ * `formatEventMessage` cases: the dot + word, the task, and the detail
+ * (duration, exit code, message, reason).
+ *
+ * @param event - The event
+ * @param g - The glyph set
+ * @returns The cell plus the task name
+ */
+export function eventCell(event, g) {
+    switch (event.type) {
+        case 'start':
+            return { glyph: g.quarter, tone: 'info', word: 'start', detail: '', task: event.value.task, timestamp: event.value.timestamp };
+        case 'complete':
+            return { glyph: g.dot, tone: 'pos', word: 'complete', detail: formatDuration(event.value.duration), task: event.value.task, timestamp: event.value.timestamp };
+        case 'cached':
+            return { glyph: g.dot, tone: 'pos', word: 'cached', detail: '', task: event.value.task, timestamp: event.value.timestamp };
+        case 'failed':
+            return { glyph: g.cross, tone: 'neg', word: 'failed', detail: `exit ${event.value.exitCode} · ${formatDuration(event.value.duration)}`, task: event.value.task, timestamp: event.value.timestamp };
+        case 'error':
+            return { glyph: g.cross, tone: 'neg', word: 'error', detail: event.value.message, task: event.value.task, timestamp: event.value.timestamp };
+        case 'input_unavailable':
+            return { glyph: g.half, tone: 'warn', word: 'waiting', detail: event.value.reason, task: event.value.task, timestamp: event.value.timestamp };
+    }
+}
+//# sourceMappingURL=status.js.map

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

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

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

@@ -0,0 +1,126 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * The value tree's model — the flat rows a dataset's content becomes
+ * (`flattenRows` inline, `flattenPaged` paged, from the row model
+ * `@elaraai/east-ui` shares with the browser), and the *anchor* that keeps
+ * the selection on the same logical row while pages arrive and leave: a
+ * paged tree's flat indices shift whenever a placeholder root becomes its
+ * expanded rows (or the reverse), so the selection is remembered as a
+ * global root row plus an offset into its subtree and re-applied after
+ * every page change. The model is memoized on what the flatten reads, so
+ * a keypress that only moves the selection never re-flattens the value
+ * ({@link treeModel}).
+ *
+ * @packageDocumentation
+ */
+import type { EastTypeValue } from '@elaraai/east';
+import { type PagedFlat, type RowModel, type ValueTreePaging } from '@elaraai/east-ui/internal';
+import type { DatasetData, TreeUi, TuiState, View } from '../state/actions.js';
+/** Root rows fetched per page. */
+export declare const PAGE_SIZE = 500;
+/** Whether a dataset root type pages (Array / Set / Dict). */
+export declare function isCollectionType(type: EastTypeValue): boolean;
+/**
+ * The key type of a keyed collection (`/find` works over it).
+ *
+ * @param type - The dataset's root type
+ * @returns The Dict key type / Set element type, or null
+ */
+export declare function keyTypeOf(type: EastTypeValue): EastTypeValue | null;
+/**
+ * The keys of a decoded keyed collection in canonical order (the inline
+ * counterpart of the server's row space).
+ *
+ * @param type - The dataset's root type
+ * @param decoded - The decoded value
+ * @returns The keys, or null for a non-keyed root
+ */
+export declare function collectionKeys(type: EastTypeValue, decoded: unknown): unknown[] | null;
+/** The dataset a view shows, if any. */
+export declare function viewDataset(state: TuiState): {
+    ws: string;
+    path: string;
+    editable: boolean;
+} | null;
+/** The tree's flat rows: inline (all loaded) or paged (loaded pages + placeholders). */
+export interface TreeModel {
+    /** Flat rows in total. */
+    total: number;
+    /** The loaded rows in flat order (every row when inline). */
+    rows: RowModel[];
+    paged: {
+        flat: PagedFlat;
+        paging: ValueTreePaging;
+    } | null;
+    /** Root rows (depth 0) in total. */
+    rootCount: number;
+    /** The row at a flat index. */
+    at(index: number): {
+        kind: 'model';
+        row: RowModel;
+    } | {
+        kind: 'placeholder';
+        globalRow: number;
+    } | null;
+    /** The flat index of a root row ordinal. */
+    flatOfRoot(root: number): number | undefined;
+    /** The flat index of a row id, when loaded. */
+    flatOfId(id: string): number | undefined;
+    keyType: EastTypeValue | null;
+}
+/**
+ * How many times the tree model has been flattened — the memo's misses.
+ * A pure move (selection, scroll, page request) must not add to it; a
+ * toggle, a page arriving, or a new value adds one.
+ *
+ * @returns The build count since the module loaded
+ */
+export declare function treeModelBuilds(): number;
+/**
+ * The tree model for a dataset's current content — flattened once per
+ * (content, expand-set, base depth, editable) and shared by everything
+ * that reads it in one keypress: the key handler, the list model, the
+ * rows renderer and the mouse pane. A single-entry memo suffices: the
+ * TUI shows one tree at a time, and every reader asks for the same one.
+ *
+ * @param data - The dataset data
+ * @param tree - The tree UI (expand-set, base depth)
+ * @param editable - Whether append / remove rows are offered
+ * @returns The model, or null when the content is not a tree
+ */
+export declare function treeModel(data: DatasetData | undefined, tree: TreeUi, editable: boolean): TreeModel | null;
+/** The selection of a paged tree as a logical position. */
+export interface TreeAnchor {
+    ws: string;
+    path: string;
+    /** The global root row the selection sits under. */
+    root: number;
+    /** Flat rows from that root to the selection. */
+    offset: number;
+    /** Flat rows from the window's top to the selection. */
+    topOffset: number;
+}
+/**
+ * Captures where the selection of the shown paged tree sits, before its
+ * pages change.
+ *
+ * @param state - The store state
+ * @param ws - The dataset's workspace
+ * @param path - The dataset's path
+ * @returns The anchor, or null when the view shows something else
+ */
+export declare function captureAnchor(state: TuiState, ws: string, path: string): TreeAnchor | null;
+/**
+ * Re-applies an anchor after the pages changed: the selection lands on
+ * the same root (at the same offset into its subtree, clamped) and the
+ * window keeps it on the same screen line.
+ *
+ * @param state - The store state after the change
+ * @param anchor - The captured anchor
+ * @returns The view to set, or null when nothing moves
+ */
+export declare function applyAnchor(state: TuiState, anchor: TreeAnchor): View | null;
+//# sourceMappingURL=tree.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"tree.d.ts","sourceRoot":"","sources":["../../../src/tui/model/tree.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AACnD,OAAO,EAOH,KAAK,SAAS,EACd,KAAK,QAAQ,EACb,KAAK,eAAe,EACvB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,qBAAqB,CAAC;AAE/E,kCAAkC;AAClC,eAAO,MAAM,SAAS,MAAM,CAAC;AAE7B,8DAA8D;AAC9D,wBAAgB,gBAAgB,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAE7D;AAED;;;;;GAKG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,aAAa,GAAG,aAAa,GAAG,IAAI,CAInE;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,aAAa,EAAE,OAAO,EAAE,OAAO,GAAG,OAAO,EAAE,GAAG,IAAI,CAItF;AAED,wCAAwC;AACxC,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,GAAG;IAAE,EAAE,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAKnG;AAED,wFAAwF;AACxF,MAAM,WAAW,SAAS;IACtB,0BAA0B;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,6DAA6D;IAC7D,IAAI,EAAE,QAAQ,EAAE,CAAC;IACjB,KAAK,EAAE;QAAE,IAAI,EAAE,SAAS,CAAC;QAAC,MAAM,EAAE,eAAe,CAAA;KAAE,GAAG,IAAI,CAAC;IAC3D,oCAAoC;IACpC,SAAS,EAAE,MAAM,CAAC;IAClB,+BAA+B;IAC/B,EAAE,CAAC,KAAK,EAAE,MAAM,GAAG;QAAE,IAAI,EAAE,OAAO,CAAC;QAAC,GAAG,EAAE,QAAQ,CAAA;KAAE,GAAG;QAAE,IAAI,EAAE,aAAa,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACxG,4CAA4C;IAC5C,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IAC7C,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;IACzC,OAAO,EAAE,aAAa,GAAG,IAAI,CAAC;CACjC;AAgCD;;;;;;GAMG;AACH,wBAAgB,eAAe,IAAI,MAAM,CAExC;AAwCD;;;;;;;;;;;GAWG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,WAAW,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,SAAS,GAAG,IAAI,CAmB1G;AAED,2DAA2D;AAC3D,MAAM,WAAW,UAAU;IACvB,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,oDAAoD;IACpD,IAAI,EAAE,MAAM,CAAC;IACb,iDAAiD;IACjD,MAAM,EAAE,MAAM,CAAC;IACf,wDAAwD;IACxD,SAAS,EAAE,MAAM,CAAC;CACrB;AAED;;;;;;;;GAQG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,UAAU,GAAG,IAAI,CAoB1F;AAED;;;;;;;;GAQG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,QAAQ,EAAE,MAAM,EAAE,UAAU,GAAG,IAAI,GAAG,IAAI,CAyB5E"}

package/dist/tui/model/tree.js

@@ -0,0 +1,217 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+import { DEFAULT_OPEN_DEPTH, flatIndexOfRoot, flattenPaged, flattenRows, pagedFlatIndexOfRoot, pagedRowAt, } from '@elaraai/east-ui/internal';
+/** Root rows fetched per page. */
+export const PAGE_SIZE = 500;
+/** Whether a dataset root type pages (Array / Set / Dict). */
+export function isCollectionType(type) {
+    return type.type === 'Array' || type.type === 'Set' || type.type === 'Dict';
+}
+/**
+ * The key type of a keyed collection (`/find` works over it).
+ *
+ * @param type - The dataset's root type
+ * @returns The Dict key type / Set element type, or null
+ */
+export function keyTypeOf(type) {
+    if (type.type === 'Dict')
+        return type.value.key;
+    if (type.type === 'Set')
+        return type.value;
+    return null;
+}
+/**
+ * The keys of a decoded keyed collection in canonical order (the inline
+ * counterpart of the server's row space).
+ *
+ * @param type - The dataset's root type
+ * @param decoded - The decoded value
+ * @returns The keys, or null for a non-keyed root
+ */
+export function collectionKeys(type, decoded) {
+    if (type.type === 'Dict')
+        return [...decoded.keys()];
+    if (type.type === 'Set')
+        return [...decoded.values()];
+    return null;
+}
+/** The dataset a view shows, if any. */
+export function viewDataset(state) {
+    const v = state.view;
+    if (v.kind === 'task' && v.tab === 'output')
+        return { ws: v.ws, path: `.tasks.${v.task}.output`, editable: false };
+    if (v.kind === 'input')
+        return { ws: v.ws, path: `.inputs.${v.name}`, editable: true };
+    return null;
+}
+let memo = null;
+let builds = 0;
+function sameKey(a, b) {
+    return a.type === b.type && a.kind === b.kind && a.root === b.root && a.pages === b.pages && a.totalRows === b.totalRows
+        && a.open === b.open && a.baseDepth === b.baseDepth && a.editable === b.editable;
+}
+/**
+ * How many times the tree model has been flattened — the memo's misses.
+ * A pure move (selection, scroll, page request) must not add to it; a
+ * toggle, a page arriving, or a new value adds one.
+ *
+ * @returns The build count since the module loaded
+ */
+export function treeModelBuilds() {
+    return builds;
+}
+/** Flattens the content into a model (the memo's miss path). */
+function buildTreeModel(type, mode, tree, editable) {
+    const openDepth = tree.baseDepth ?? DEFAULT_OPEN_DEPTH;
+    const keyType = keyTypeOf(type);
+    if (mode.kind === 'inline') {
+        const rows = flattenRows(mode.root, tree.open, openDepth, editable, editable);
+        const roots = rows.filter(r => r.depth === 0).length;
+        return {
+            total: rows.length,
+            rows,
+            paged: null,
+            rootCount: roots,
+            at: (i) => (i >= 0 && i < rows.length ? { kind: 'model', row: rows[i] } : null),
+            flatOfRoot: (root) => flatIndexOfRoot(rows, root),
+            flatOfId: (id) => { const i = rows.findIndex(r => r.id === id); return i === -1 ? undefined : i; },
+            keyType,
+        };
+    }
+    const paging = { totalRows: mode.totalRows, pageSize: PAGE_SIZE, pages: mode.pages, onNeedRows: () => undefined };
+    const flat = flattenPaged(paging, tree.open, openDepth);
+    return {
+        total: flat.totalFlat,
+        rows: flat.loadedRows,
+        paged: { flat, paging },
+        rootCount: mode.totalRows,
+        at: (i) => (i >= 0 && i < flat.totalFlat ? pagedRowAt(flat, paging, i) : null),
+        flatOfRoot: (root) => pagedFlatIndexOfRoot(flat, paging, root),
+        flatOfId: (id) => {
+            for (const [p, models] of flat.pageModels) {
+                const j = models.findIndex(r => r.id === id);
+                if (j !== -1)
+                    return flat.prefix[p] + j;
+            }
+            return undefined;
+        },
+        keyType,
+    };
+}
+/**
+ * The tree model for a dataset's current content — flattened once per
+ * (content, expand-set, base depth, editable) and shared by everything
+ * that reads it in one keypress: the key handler, the list model, the
+ * rows renderer and the mouse pane. A single-entry memo suffices: the
+ * TUI shows one tree at a time, and every reader asks for the same one.
+ *
+ * @param data - The dataset data
+ * @param tree - The tree UI (expand-set, base depth)
+ * @param editable - Whether append / remove rows are offered
+ * @returns The model, or null when the content is not a tree
+ */
+export function treeModel(data, tree, editable) {
+    if (data === undefined || data.type === null)
+        return null;
+    const mode = data.mode;
+    if (mode.kind !== 'inline' && mode.kind !== 'paged')
+        return null;
+    const key = {
+        type: data.type,
+        kind: mode.kind,
+        root: mode.kind === 'inline' ? mode.root : null,
+        pages: mode.kind === 'paged' ? mode.pages : null,
+        totalRows: mode.kind === 'paged' ? mode.totalRows : 0,
+        open: tree.open,
+        baseDepth: tree.baseDepth,
+        editable,
+    };
+    if (memo !== null && sameKey(memo.key, key))
+        return memo.model;
+    builds += 1;
+    const model = buildTreeModel(data.type, mode, tree, editable);
+    memo = { key, model };
+    return model;
+}
+/**
+ * Captures where the selection of the shown paged tree sits, before its
+ * pages change.
+ *
+ * @param state - The store state
+ * @param ws - The dataset's workspace
+ * @param path - The dataset's path
+ * @returns The anchor, or null when the view shows something else
+ */
+export function captureAnchor(state, ws, path) {
+    const shown = viewDataset(state);
+    const v = state.view;
+    if (shown === null || shown.ws !== ws || shown.path !== path || (v.kind !== 'task' && v.kind !== 'input'))
+        return null;
+    const data = state.data.dataset[ws]?.[path];
+    if (data?.mode.kind !== 'paged')
+        return null;
+    const model = treeModel(data, v.tree, shown.editable);
+    if (model === null || model.total === 0)
+        return null;
+    const sel = Math.max(0, Math.min(v.tree.sel, model.total - 1));
+    const at = model.at(sel);
+    if (at === null)
+        return null;
+    if (at.kind === 'placeholder')
+        return { ws, path, root: at.globalRow, offset: 0, topOffset: sel - v.tree.top };
+    // The nearest depth-0 row at or before the selection is its root.
+    for (let i = sel; i >= 0; i--) {
+        const row = model.at(i);
+        if (row === null)
+            break;
+        if (row.kind === 'placeholder')
+            return { ws, path, root: row.globalRow, offset: 0, topOffset: sel - v.tree.top };
+        if (row.row.depth === 0)
+            return { ws, path, root: row.row.posinset - 1, offset: sel - i, topOffset: sel - v.tree.top };
+    }
+    return null;
+}
+/**
+ * Re-applies an anchor after the pages changed: the selection lands on
+ * the same root (at the same offset into its subtree, clamped) and the
+ * window keeps it on the same screen line.
+ *
+ * @param state - The store state after the change
+ * @param anchor - The captured anchor
+ * @returns The view to set, or null when nothing moves
+ */
+export function applyAnchor(state, anchor) {
+    const shown = viewDataset(state);
+    const v = state.view;
+    if (shown === null || shown.ws !== anchor.ws || shown.path !== anchor.path || (v.kind !== 'task' && v.kind !== 'input'))
+        return null;
+    const data = state.data.dataset[anchor.ws]?.[anchor.path];
+    if (data?.mode.kind !== 'paged')
+        return null;
+    const model = treeModel(data, v.tree, shown.editable);
+    if (model === null || model.total === 0)
+        return null;
+    const flat = model.flatOfRoot(anchor.root);
+    if (flat === undefined)
+        return null;
+    let sel = flat;
+    const at = model.at(flat);
+    if (at !== null && at.kind === 'model') {
+        // Stay inside the root's subtree.
+        let end = flat;
+        while (end + 1 < model.total) {
+            const next = model.at(end + 1);
+            if (next === null || next.kind === 'placeholder' || next.row.depth === 0)
+                break;
+            end++;
+        }
+        sel = Math.min(flat + anchor.offset, end);
+    }
+    const top = Math.max(0, Math.min(sel - anchor.topOffset, Math.max(0, model.total - 1)));
+    if (sel === v.tree.sel && top === v.tree.top)
+        return null;
+    return { ...v, tree: { ...v.tree, sel, top } };
+}
+//# sourceMappingURL=tree.js.map

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

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

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

@@ -0,0 +1,21 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * East type text for tables — `Array<Struct>`, `Dict<String, Struct>`,
+ * `UIComponentType`: the top-level kind with its generic arguments' kinds
+ * only, so a type fits a column.
+ *
+ * @packageDocumentation
+ */
+import type { EastTypeValue } from '@elaraai/east';
+/**
+ * The compact text of a type.
+ *
+ * @param tv - The type value
+ * @param ui - Whether the dataset is a `ui` task's output (printed `UIComponentType`)
+ * @returns The compact text
+ */
+export declare function compactType(tv: EastTypeValue, ui?: boolean): string;
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/tui/model/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAWnD;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,EAAE,EAAE,aAAa,EAAE,EAAE,UAAQ,GAAG,MAAM,CAuBjE"}

package/dist/tui/model/types.js

@@ -0,0 +1,46 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/** The kind name of a type (`Struct`, `String`, …). */
+function kindOf(tv) {
+    if (tv.type === 'Variant') {
+        const cases = tv.value.map(c => c.name);
+        if (cases.length === 2 && cases.includes('some') && cases.includes('none'))
+            return 'Option';
+    }
+    return tv.type;
+}
+/**
+ * The compact text of a type.
+ *
+ * @param tv - The type value
+ * @param ui - Whether the dataset is a `ui` task's output (printed `UIComponentType`)
+ * @returns The compact text
+ */
+export function compactType(tv, ui = false) {
+    if (ui)
+        return 'UIComponentType';
+    switch (tv.type) {
+        case 'Array':
+        case 'Set':
+            return `${tv.type}<${kindOf(tv.value)}>`;
+        case 'Dict': {
+            const { key, value } = tv.value;
+            return `Dict<${kindOf(key)}, ${kindOf(value)}>`;
+        }
+        case 'Variant': {
+            const kind = kindOf(tv);
+            if (kind === 'Option') {
+                const someCase = tv.value.find(c => c.name === 'some');
+                return someCase !== undefined ? `Option<${kindOf(someCase.type)}>` : 'Option';
+            }
+            return 'Variant';
+        }
+        case 'Recursive':
+            return 'Recursive';
+        default:
+            return tv.type;
+    }
+}
+//# sourceMappingURL=types.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/tui/model/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAYH,uDAAuD;AACvD,SAAS,MAAM,CAAC,EAAiB;IAC7B,IAAI,EAAE,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;QACxB,MAAM,KAAK,GAAI,EAAE,CAAC,KAA4B,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC;QAChE,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC;YAAE,OAAO,QAAQ,CAAC;IAChG,CAAC;IACD,OAAO,EAAE,CAAC,IAAI,CAAC;AACnB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAAC,EAAiB,EAAE,EAAE,GAAG,KAAK;IACrD,IAAI,EAAE;QAAE,OAAO,iBAAiB,CAAC;IACjC,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC;QACd,KAAK,OAAO,CAAC;QACb,KAAK,KAAK;YACN,OAAO,GAAG,EAAE,CAAC,IAAI,IAAI,MAAM,CAAC,EAAE,CAAC,KAAsB,CAAC,GAAG,CAAC;QAC9D,KAAK,MAAM,CAAC,CAAC,CAAC;YACV,MAAM,EAAE,GAAG,EAAE,KAAK,EAAE,GAAG,EAAE,CAAC,KAAqD,CAAC;YAChF,OAAO,QAAQ,MAAM,CAAC,GAAG,CAAC,KAAK,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC;QACpD,CAAC;QACD,KAAK,SAAS,CAAC,CAAC,CAAC;YACb,MAAM,IAAI,GAAG,MAAM,CAAC,EAAE,CAAC,CAAC;YACxB,IAAI,IAAI,KAAK,QAAQ,EAAE,CAAC;gBACpB,MAAM,QAAQ,GAAI,EAAE,CAAC,KAAiD,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,CAAC;gBACpG,OAAO,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,UAAU,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,QAAQ,CAAC;YAClF,CAAC;YACD,OAAO,SAAS,CAAC;QACrB,CAAC;QACD,KAAK,WAAW;YACZ,OAAO,WAAW,CAAC;QACvB;YACI,OAAO,EAAE,CAAC,IAAI,CAAC;IACvB,CAAC;AACL,CAAC"}