@elaraai/e3-ui-cli 1.0.73 → 1.0.75

package/dist/tui/ui/views/dashboard.d.ts

@@ -10,12 +10,22 @@
  * failed task's logs. Status detail is inline (`✗ failed · exit 2`,
  * `◐ waiting`, `◔ in-progress`).
  *
+ * The column is built in two steps. {@link dashboardModel} derives what
+ * follows from the data and the width — the counts, the events the panel
+ * lists, the latest event per task, the dataset map, the fitted table
+ * plans, each row's cells and where each selectable row sits — once per
+ * data change: a single-entry cache keyed on the identity of the status,
+ * the execution, the dataset list, the task list, the width and the
+ * breakpoint. {@link dashboardLines} then renders only the lines on
+ * screen, restyling the selected row and stamping the clock and the
+ * spinner. A selection move costs the window, not the workspace.
+ *
  * @packageDocumentation
  */
 import type { DataflowEvent, WorkspaceStatusResult } from '@elaraai/e3-api-client';
 import type { Glyphs } from '../../render/glyphs.js';
-import { type Breakpoint } from '../../render/layout.js';
-import type { NavOp, TuiState } from '../../state/actions.js';
+import { type Breakpoint, type ColumnSpec } from '../../render/layout.js';
+import type { ExecutionData, NavOp, TuiState } from '../../state/actions.js';
 import { type Controller } from '../../controller.js';
 import type { Hit, Pane } from '../frame.js';
 import { type Line, type RenderCtx } from '../lines.js';
@@ -35,11 +45,6 @@ export interface DashboardRow {
     name: string;
     line: number;
 }
-/** The column under the title: its lines and the selectable rows. */
-export interface DashboardColumn {
-    lines: Line[];
-    rows: DashboardRow[];
-}
 /** Event rows the execution panel shows at most. */
 export declare const MAX_EVENT_ROWS = 6;
 /**
@@ -74,36 +79,86 @@ export declare function accountedBar(tasks: readonly TaskInfo[], g: Glyphs): {
  * @returns One event per task
  */
 export declare function latestPerTask(events: readonly DataflowEvent[]): DataflowEvent[];
+/** A task's row: the cells that follow from the data, and what the `SIZE · LAST RUN` cell is stamped from per frame. */
+export interface TaskRowModel {
+    task: TaskInfo;
+    /** The cells the data decides (`size` is stamped at render — it carries the clock and the spinner while the task runs). */
+    cells: TableRow['cells'];
+    /** The output's size text (`12.1 MB` / `—`). */
+    size: string;
+    /** The task's latest dataflow event, if any. */
+    event: DataflowEvent | undefined;
+}
 /**
- * The tasks table rows.
+ * The data-derived column: everything that follows from the workspace's
+ * data and the terminal width. Built by {@link dashboardModel}, rendered
+ * by {@link dashboardLines}.
  *
- * @param state - The store state
- * @param ws - The workspace
- * @param status - Its status
- * @param dctx - The dashboard context
- * @returns The rows, in the status order
+ * @property status - The status the model follows (undefined → `placeholder` is the whole column)
+ * @property placeholder - The column while there is no status: nothing deployed, an error, or loading
+ * @property counts - The counts block (the two stat groups and the accounted bar)
+ * @property execution - The execution the panel shows
+ * @property live - Whether the panel shows the live feed
+ * @property done - Events past `start` (the live feed's `N of M tasks`)
+ * @property events - The events the panel lists: the latest per task — the last ones while live, the failures after
+ * @property latest - The latest event per task
+ * @property taskPlan - The tasks table's fitted column plan
+ * @property tasks - The task rows
+ * @property inputPlan - The inputs table's fitted column plan
+ * @property inputs - The input rows
+ * @property inputNames - The input names, in row order
+ * @property rows - The selectable rows in column order (failures, tasks, inputs) with their line indices
+ * @property total - Lines in the column
+ * @property panelAt - The execution panel's first line
+ * @property tasksAt - The TASKS section line (the header follows, then the rows)
+ * @property inputsAt - The INPUTS section line
  */
-export declare function taskRows(state: TuiState, ws: string, status: WorkspaceStatusResult, dctx: DashboardCtx): TableRow[];
+export interface DashboardModel {
+    status: WorkspaceStatusResult | undefined;
+    placeholder: Line[];
+    counts: Line[];
+    execution: ExecutionData | undefined;
+    live: boolean;
+    done: number;
+    events: DataflowEvent[];
+    latest: ReadonlyMap<string, DataflowEvent>;
+    taskPlan: ColumnSpec[];
+    tasks: TaskRowModel[];
+    inputPlan: ColumnSpec[];
+    inputs: TableRow[];
+    inputNames: string[];
+    rows: DashboardRow[];
+    total: number;
+    panelAt: number;
+    tasksAt: number;
+    inputsAt: number;
+}
 /**
- * The inputs table rows (`.inputs.*` datasets that no task produces).
+ * The dashboard model for a workspace — built once per data change and
+ * returned as the same object until the status, the execution, the
+ * dataset list, the task list, the width or the breakpoint changes. The
+ * clock, the spinner and the selection are not inputs: they restyle lines
+ * at render ({@link dashboardLines}).
  *
  * @param state - The store state
  * @param ws - The workspace
- * @param status - Its status
- * @param dctx - The dashboard context
- * @returns The rows, in the status order
+ * @param dctx - The dashboard context (its width and breakpoint key the cache)
+ * @returns The model
  */
-export declare function inputRows(state: TuiState, ws: string, status: WorkspaceStatusResult, dctx: DashboardCtx): TableRow[];
+export declare function dashboardModel(state: TuiState, ws: string, dctx: DashboardCtx): DashboardModel;
 /**
- * Builds the column under the title.
+ * The column's lines in `[top, top + visible)` — the window the screen
+ * shows, rendered from the model with the selected row restyled and the
+ * clock and the spinner stamped in.
  *
- * @param state - The store state
- * @param ws - The workspace
+ * @param model - The dashboard model
  * @param dctx - The dashboard context
  * @param sel - The selected row index
- * @returns The lines and the selectable rows
+ * @param top - The first line
+ * @param visible - Lines in the window
+ * @returns The lines (fewer when the column ends first)
  */
-export declare function dashboardColumn(state: TuiState, ws: string, dctx: DashboardCtx, sel: number): DashboardColumn;
+export declare function dashboardLines(model: DashboardModel, dctx: DashboardCtx, sel: number, top: number, visible: number): Line[];
 /**
  * The dashboard body: the fixed title, then the column window with its
  * scrollbar — plus the window's clickable rows and pane for the mouse.

package/dist/tui/ui/views/dashboard.d.ts.map

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