@elaraai/e3-ui-cli 1.0.71 → 1.0.73

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"}

package/dist/tui/render/glyphs.d.ts

@@ -0,0 +1,122 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * The glyph sets — one unicode, one ASCII — every view draws with. Chosen
+ * once at start-up by {@link selectGlyphs}: `--ascii`, `E3_UI_ASCII=1`, a
+ * non-UTF-8 locale or `TERM=linux` select the ASCII set.
+ *
+ * @packageDocumentation
+ */
+/**
+ * The named glyphs of a set.
+ *
+ * @property expanded - An expanded tree row's twist (`▾`)
+ * @property collapsed - A collapsed tree row's twist (`▸`)
+ * @property leaf - A leaf row's marker (`·`)
+ * @property add - The append ghost row's marker (`+`)
+ * @property dot - Complete / up-to-date / connected (`●`)
+ * @property half - Waiting / stale / reconnecting (`◐`)
+ * @property quarter - In progress / running (`◔`)
+ * @property empty - Ready / unset / never (`○`)
+ * @property cross - Failed / error / offline (`✗`)
+ * @property diamond - Dirty / pending edits (`◆`)
+ * @property sel - The selection bar (`▌`)
+ * @property tabL - The active tab's left bracket (`▌`)
+ * @property tabR - The active tab's right bracket (`▐`)
+ * @property rule - The full-width rule (`─`)
+ * @property dashed - The dashed section rule (`┄`)
+ * @property vbar - The scrollbar track (`│`)
+ * @property scrollUp - The scrollbar's top cap (`▲`)
+ * @property thumb - The scrollbar's thumb (`█`)
+ * @property scrollDown - The scrollbar's bottom cap (`▼`)
+ * @property placeholder - An unloaded row's fill (`░`)
+ * @property loading - The loading marker (`▒`)
+ * @property spinner - The braille spinner frames
+ * @property crumb - The breadcrumb separator (`›`)
+ * @property prompt - The command box prompt (`›`)
+ * @property sep - The inline separator (`·`)
+ * @property enter - The Enter key (`⏎`)
+ * @property up - The up arrow (`↑`)
+ * @property down - The down arrow (`↓`)
+ * @property left - The left arrow (`←`)
+ * @property right - The right arrow (`→`)
+ * @property backspace - The backspace key (`⌫`)
+ * @property shift - The shift key (`⇧`)
+ * @property edited - The changed-row marker (`┆`)
+ * @property square - The stop marker (`■`)
+ * @property bullet - The note marker (`▪`)
+ * @property bars - The accounted bar's steps, low to high (`▁▃▅▇`)
+ * @property ellipsis - The truncation marker (`…`)
+ * @property cursor - The command box caret (`_`)
+ * @property hidden - A hidden collapsed marker for the shift-left hint
+ */
+export interface Glyphs {
+    expanded: string;
+    collapsed: string;
+    leaf: string;
+    add: string;
+    dot: string;
+    half: string;
+    quarter: string;
+    empty: string;
+    cross: string;
+    diamond: string;
+    sel: string;
+    tabL: string;
+    tabR: string;
+    rule: string;
+    dashed: string;
+    vbar: string;
+    scrollUp: string;
+    thumb: string;
+    scrollDown: string;
+    placeholder: string;
+    loading: string;
+    spinner: readonly string[];
+    crumb: string;
+    prompt: string;
+    sep: string;
+    enter: string;
+    up: string;
+    down: string;
+    left: string;
+    right: string;
+    backspace: string;
+    shift: string;
+    edited: string;
+    square: string;
+    bullet: string;
+    bars: readonly string[];
+    ellipsis: string;
+    cursor: string;
+}
+/** The unicode glyph set (the design's mocks). */
+export declare const UNICODE: Glyphs;
+/** The ASCII glyph set (`--ascii`, `E3_UI_ASCII=1`, non-UTF-8 locales, `TERM=linux`). */
+export declare const ASCII: Glyphs;
+/** What {@link selectGlyphs} looks at. */
+export interface GlyphSelection {
+    /** `--ascii` was given. */
+    ascii?: boolean | undefined;
+    /** The environment (`E3_UI_ASCII`, `LANG` / `LC_ALL` / `LC_CTYPE`, `TERM`). */
+    env: NodeJS.ProcessEnv;
+}
+/**
+ * Whether the locale declares a UTF-8 charset (a missing locale counts as
+ * UTF-8 — every modern terminal is — while an explicit non-UTF-8 charset
+ * selects ASCII).
+ *
+ * @param env - The environment
+ * @returns `true` unless a locale variable names a non-UTF-8 charset
+ */
+export declare function localeIsUtf8(env: NodeJS.ProcessEnv): boolean;
+/**
+ * Selects the glyph set for this session.
+ *
+ * @param selection - The flag and the environment
+ * @returns {@link ASCII} for `--ascii`, `E3_UI_ASCII=1`, a non-UTF-8 locale or `TERM=linux`; else {@link UNICODE}
+ */
+export declare function selectGlyphs(selection: GlyphSelection): Glyphs;
+//# sourceMappingURL=glyphs.d.ts.map

package/dist/tui/render/glyphs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"glyphs.d.ts","sourceRoot":"","sources":["../../../src/tui/render/glyphs.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;GAMG;AAEH;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA0CG;AACH,MAAM,WAAW,MAAM;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,EAAE,MAAM,CAAC;IAChB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,UAAU,EAAE,MAAM,CAAC;IACnB,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,SAAS,MAAM,EAAE,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACxB,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAClB;AAED,kDAAkD;AAClD,eAAO,MAAM,OAAO,EAAE,MAuCrB,CAAC;AAEF,yFAAyF;AACzF,eAAO,MAAM,KAAK,EAAE,MAuCnB,CAAC;AAEF,0CAA0C;AAC1C,MAAM,WAAW,cAAc;IAC3B,2BAA2B;IAC3B,KAAK,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5B,+EAA+E;IAC/E,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;CAC1B;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,GAAG,OAAO,CAO5D;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,SAAS,EAAE,cAAc,GAAG,MAAM,CAM9D"}

package/dist/tui/render/glyphs.js

@@ -0,0 +1,122 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/** The unicode glyph set (the design's mocks). */
+export const UNICODE = {
+    expanded: '▾',
+    collapsed: '▸',
+    leaf: '·',
+    add: '+',
+    dot: '●',
+    half: '◐',
+    quarter: '◔',
+    empty: '○',
+    cross: '✗',
+    diamond: '◆',
+    sel: '▌',
+    tabL: '▌',
+    tabR: '▐',
+    rule: '─',
+    dashed: '┄',
+    vbar: '│',
+    scrollUp: '▲',
+    thumb: '█',
+    scrollDown: '▼',
+    placeholder: '░',
+    loading: '▒',
+    spinner: ['⠋', '⠙', '⠹', '⠸', '⠼', '⠴', '⠦', '⠧', '⠇', '⠏'],
+    crumb: '›',
+    prompt: '›',
+    sep: '·',
+    enter: '⏎',
+    up: '↑',
+    down: '↓',
+    left: '←',
+    right: '→',
+    backspace: '⌫',
+    shift: '⇧',
+    edited: '┆',
+    square: '■',
+    bullet: '▪',
+    bars: ['▁', '▃', '▅', '▇'],
+    ellipsis: '…',
+    cursor: '_',
+};
+/** The ASCII glyph set (`--ascii`, `E3_UI_ASCII=1`, non-UTF-8 locales, `TERM=linux`). */
+export const ASCII = {
+    expanded: 'v',
+    collapsed: '>',
+    leaf: '-',
+    add: '+',
+    dot: '*',
+    half: 'o',
+    quarter: 'o',
+    empty: '.',
+    cross: 'x',
+    diamond: '+',
+    sel: '>',
+    tabL: '[',
+    tabR: ']',
+    rule: '-',
+    dashed: '.',
+    vbar: '|',
+    scrollUp: '^',
+    thumb: '#',
+    scrollDown: 'v',
+    placeholder: ':',
+    loading: ';',
+    spinner: ['-', '\\', '|', '/'],
+    crumb: '>',
+    prompt: '>',
+    sep: '.',
+    enter: 'Enter',
+    up: 'Up',
+    down: 'Down',
+    left: 'Left',
+    right: 'Right',
+    backspace: 'Bksp',
+    shift: 'Shift-',
+    edited: '|',
+    square: '#',
+    bullet: '*',
+    bars: ['_', '.', ':', '|'],
+    ellipsis: '...',
+    cursor: '_',
+};
+/**
+ * Whether the locale declares a UTF-8 charset (a missing locale counts as
+ * UTF-8 — every modern terminal is — while an explicit non-UTF-8 charset
+ * selects ASCII).
+ *
+ * @param env - The environment
+ * @returns `true` unless a locale variable names a non-UTF-8 charset
+ */
+export function localeIsUtf8(env) {
+    const locale = env['LC_ALL'] || env['LC_CTYPE'] || env['LANG'];
+    if (locale === undefined || locale === '' || locale === 'C' || locale === 'POSIX')
+        return true;
+    const dot = locale.indexOf('.');
+    if (dot === -1)
+        return true;
+    const charset = locale.slice(dot + 1).toLowerCase().replace(/[^a-z0-9]/g, '');
+    return charset === 'utf8';
+}
+/**
+ * Selects the glyph set for this session.
+ *
+ * @param selection - The flag and the environment
+ * @returns {@link ASCII} for `--ascii`, `E3_UI_ASCII=1`, a non-UTF-8 locale or `TERM=linux`; else {@link UNICODE}
+ */
+export function selectGlyphs(selection) {
+    if (selection.ascii === true)
+        return ASCII;
+    if (selection.env['E3_UI_ASCII'] === '1')
+        return ASCII;
+    if (selection.env['TERM'] === 'linux')
+        return ASCII;
+    if (!localeIsUtf8(selection.env))
+        return ASCII;
+    return UNICODE;
+}
+//# sourceMappingURL=glyphs.js.map

package/dist/tui/render/glyphs.js.map

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

package/dist/tui/render/layout.d.ts

@@ -0,0 +1,145 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * Layout arithmetic — the shell's fixed rows, the breakpoints, the column
+ * plans of every table, and the scrollbar geometry.
+ *
+ * Every row is exactly one terminal line (no wrapping) so scroll math is
+ * exact and the frame never exceeds the viewport: the shell is one header
+ * row, a rule, the body, then — bottom-anchored — an optional commit bar,
+ * an optional completion list, the three-row command box and one hint
+ * row. Widths ≥ 100 columns get the full tables, 80–99 tighter columns,
+ * 60–79 drop the secondary columns, and below 60×16 the app refuses.
+ *
+ * @packageDocumentation
+ */
+/** The smallest terminal the app runs in. */
+export declare const MIN_COLUMNS = 60;
+/** The smallest terminal the app runs in. */
+export declare const MIN_ROWS = 16;
+/** Completion rows above the command box, at most. */
+export declare const MAX_COMPLETION_ROWS = 8;
+/** A terminal size in cells. */
+export interface Size {
+    columns: number;
+    rows: number;
+}
+/** The width class: `wide` ≥ 100, `medium` 80–99, `narrow` 60–79, `refuse` below 60 (or under 16 rows). */
+export type Breakpoint = 'wide' | 'medium' | 'narrow' | 'refuse';
+/**
+ * The width class of a terminal size.
+ *
+ * @param size - The terminal size
+ * @returns The breakpoint
+ */
+export declare function breakpoint(size: Size): Breakpoint;
+/**
+ * The shell's row plan for a size and the bottom-anchored extras.
+ *
+ * @property columns - Terminal columns
+ * @property rows - Terminal rows
+ * @property bodyTop - The first body row (below the header and its rule)
+ * @property bodyRows - Rows the view body may draw
+ * @property commitRows - Rows of the commit bar (0 or 2: a dashed rule + the bar)
+ * @property completionRows - Rows of the completion list
+ * @property commandTop - The first row of the command box (its top rule)
+ * @property hintRow - The hint row (the last row)
+ */
+export interface ShellLayout {
+    columns: number;
+    rows: number;
+    bodyTop: number;
+    bodyRows: number;
+    commitRows: number;
+    completionRows: number;
+    commandTop: number;
+    hintRow: number;
+}
+/**
+ * Computes the shell's row plan.
+ *
+ * @param size - The terminal size
+ * @param extras - Whether the commit bar shows, and how many completion rows
+ * @returns The plan (the body absorbs the remainder, never below 0)
+ */
+export declare function shellLayout(size: Size, extras: {
+    commit: boolean;
+    completion: number;
+}): ShellLayout;
+/**
+ * The scrollbar geometry of the design (§8): the thumb spans
+ * `max(1, round(track · visible / total))` cells at
+ * `round((track − thumb) · top / (total − visible))`.
+ *
+ * @param track - The track height in cells (between the caps)
+ * @param total - Total rows
+ * @param visible - Visible rows
+ * @param top - The first visible row
+ * @returns The thumb size and its offset within the track (`null` when everything fits)
+ */
+export declare function scrollbar(track: number, total: number, visible: number, top: number): {
+    thumb: number;
+    pos: number;
+} | null;
+/**
+ * One column of a table plan.
+ *
+ * @property key - The column identity
+ * @property title - The header text
+ * @property width - The width in cells (`0` = the remaining width)
+ * @property align - Text alignment
+ * @property grow - When set, the column widens to its longest cell plus a gap, up to this many cells
+ */
+export interface ColumnSpec {
+    key: string;
+    title: string;
+    width: number;
+    align?: 'left' | 'right' | undefined;
+    grow?: number | undefined;
+}
+/** The tables with a per-breakpoint column plan. */
+export type TableKind = 'tasks' | 'inputs' | 'workspaces' | 'repos' | 'runs' | 'completion' | 'jump';
+/**
+ * The column plan of a table at a width class. Widths are the design's
+ * (120 columns); the last column takes the remaining width.
+ *
+ * @param table - The table
+ * @param bp - The width class
+ * @returns The columns, secondary ones dropped as the terminal narrows
+ */
+export declare function columnPlan(table: TableKind, bp: Breakpoint): ColumnSpec[];
+/**
+ * Fits a plan to a row width: while the fixed columns plus the gutter leave
+ * the remainder column fewer than `minRemainder` cells, the widest fixed
+ * column after the first is narrowed (never below 8). At the design width
+ * every plan is untouched.
+ *
+ * @param plan - The column plan
+ * @param width - The row width
+ * @param minRemainder - Cells the remainder column keeps at least (default 12)
+ * @param gutter - Cells before the first column (default 2: the margin + selection bar)
+ * @returns The fitted plan (a copy)
+ */
+export declare function fitPlan(plan: ColumnSpec[], width: number, minRemainder?: number, gutter?: number): ColumnSpec[];
+/**
+ * The value tree's label column width — at most 45 % of the row, the
+ * design's `LW = 44` at 120 columns.
+ *
+ * @param columns - The row width
+ * @returns The label width in cells
+ */
+export declare function labelWidth(columns: number): number;
+/**
+ * Keeps a selection visible: the top row that shows `sel` within `visible`
+ * rows, moving as little as possible from the current `top`.
+ *
+ * @param top - The current first visible row
+ * @param sel - The selected row
+ * @param visible - Visible rows
+ * @param total - Total rows
+ * @returns The new top
+ */
+export declare function scrollIntoView(top: number, sel: number, visible: number, total: number): number;
+//# sourceMappingURL=layout.d.ts.map

package/dist/tui/render/layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../../src/tui/render/layout.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;;;;;;;;;;;GAYG;AAEH,6CAA6C;AAC7C,eAAO,MAAM,WAAW,KAAK,CAAC;AAC9B,6CAA6C;AAC7C,eAAO,MAAM,QAAQ,KAAK,CAAC;AAC3B,sDAAsD;AACtD,eAAO,MAAM,mBAAmB,IAAI,CAAC;AAErC,gCAAgC;AAChC,MAAM,WAAW,IAAI;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;CAChB;AAED,2GAA2G;AAC3G,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAEjE;;;;;GAKG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,UAAU,CAKjD;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,WAAW;IACxB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,OAAO,EAAE,MAAM,CAAC;CACnB;AAED;;;;;;GAMG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE;IAAE,MAAM,EAAE,OAAO,CAAC;IAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAAG,WAAW,CAepG;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,SAAS,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG;IAAE,KAAK,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAAG,IAAI,CAK3H;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,UAAU;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS,CAAC;IACrC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC7B;AAED,oDAAoD;AACpD,MAAM,MAAM,SAAS,GAAG,OAAO,GAAG,QAAQ,GAAG,YAAY,GAAG,OAAO,GAAG,MAAM,GAAG,YAAY,GAAG,MAAM,CAAC;AAErG;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,SAAS,EAAE,EAAE,EAAE,UAAU,GAAG,UAAU,EAAE,CA8DzE;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,OAAO,CAAC,IAAI,EAAE,UAAU,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,YAAY,SAAK,EAAE,MAAM,SAAI,GAAG,UAAU,EAAE,CAYtG;AAED;;;;;;GAMG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,GAAG,MAAM,CAElD;AAED;;;;;;;;;GASG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAO/F"}

package/dist/tui/render/layout.js

@@ -0,0 +1,209 @@
+/**
+ * Copyright (c) 2025 Elara AI Pty Ltd
+ * Dual-licensed under AGPL-3.0 and commercial license. See LICENSE for details.
+ */
+/**
+ * Layout arithmetic — the shell's fixed rows, the breakpoints, the column
+ * plans of every table, and the scrollbar geometry.
+ *
+ * Every row is exactly one terminal line (no wrapping) so scroll math is
+ * exact and the frame never exceeds the viewport: the shell is one header
+ * row, a rule, the body, then — bottom-anchored — an optional commit bar,
+ * an optional completion list, the three-row command box and one hint
+ * row. Widths ≥ 100 columns get the full tables, 80–99 tighter columns,
+ * 60–79 drop the secondary columns, and below 60×16 the app refuses.
+ *
+ * @packageDocumentation
+ */
+/** The smallest terminal the app runs in. */
+export const MIN_COLUMNS = 60;
+/** The smallest terminal the app runs in. */
+export const MIN_ROWS = 16;
+/** Completion rows above the command box, at most. */
+export const MAX_COMPLETION_ROWS = 8;
+/**
+ * The width class of a terminal size.
+ *
+ * @param size - The terminal size
+ * @returns The breakpoint
+ */
+export function breakpoint(size) {
+    if (size.columns < MIN_COLUMNS || size.rows < MIN_ROWS)
+        return 'refuse';
+    if (size.columns >= 100)
+        return 'wide';
+    if (size.columns >= 80)
+        return 'medium';
+    return 'narrow';
+}
+/**
+ * Computes the shell's row plan.
+ *
+ * @param size - The terminal size
+ * @param extras - Whether the commit bar shows, and how many completion rows
+ * @returns The plan (the body absorbs the remainder, never below 0)
+ */
+export function shellLayout(size, extras) {
+    const commitRows = extras.commit ? 2 : 0;
+    const completionRows = Math.max(0, Math.min(MAX_COMPLETION_ROWS, extras.completion));
+    const chrome = 2 + commitRows + completionRows + 3 + 1;
+    const bodyRows = Math.max(0, size.rows - chrome);
+    return {
+        columns: size.columns,
+        rows: size.rows,
+        bodyTop: 2,
+        bodyRows,
+        commitRows,
+        completionRows,
+        commandTop: 2 + bodyRows + commitRows + completionRows,
+        hintRow: size.rows - 1,
+    };
+}
+/**
+ * The scrollbar geometry of the design (§8): the thumb spans
+ * `max(1, round(track · visible / total))` cells at
+ * `round((track − thumb) · top / (total − visible))`.
+ *
+ * @param track - The track height in cells (between the caps)
+ * @param total - Total rows
+ * @param visible - Visible rows
+ * @param top - The first visible row
+ * @returns The thumb size and its offset within the track (`null` when everything fits)
+ */
+export function scrollbar(track, total, visible, top) {
+    if (track <= 0 || total <= visible)
+        return null;
+    const thumb = Math.max(1, Math.round(track * Math.min(1, visible / total)));
+    const pos = Math.round((track - thumb) * (Math.min(top, total - visible) / (total - visible)));
+    return { thumb, pos: Math.max(0, Math.min(track - thumb, pos)) };
+}
+/**
+ * The column plan of a table at a width class. Widths are the design's
+ * (120 columns); the last column takes the remaining width.
+ *
+ * @param table - The table
+ * @param bp - The width class
+ * @returns The columns, secondary ones dropped as the terminal narrows
+ */
+export function columnPlan(table, bp) {
+    const narrow = bp === 'narrow';
+    const medium = bp === 'medium';
+    switch (table) {
+        case 'tasks':
+            return [
+                { key: 'name', title: 'NAME', width: 12, grow: 24 },
+                { key: 'status', title: 'STATUS', width: narrow ? 16 : 20 },
+                ...(narrow ? [] : [{ key: 'dependsOn', title: 'DEPENDS ON', width: medium ? 14 : 20 }]),
+                ...(narrow || medium ? [] : [{ key: 'inputs', title: 'INPUTS', width: 18 }]),
+                { key: 'output', title: 'OUTPUT', width: narrow || medium ? 16 : 26 },
+                { key: 'size', title: 'SIZE · LAST RUN', width: 0 },
+            ];
+        case 'inputs':
+            return [
+                { key: 'name', title: 'NAME', width: 14, grow: 24 },
+                { key: 'status', title: 'STATUS', width: 16 },
+                { key: 'type', title: 'TYPE', width: narrow ? 18 : medium ? 22 : 26 },
+                { key: 'size', title: 'SIZE', width: narrow ? 0 : 10 },
+                ...(narrow ? [] : [{ key: 'hash', title: 'HASH', width: 0 }]),
+            ];
+        case 'workspaces':
+            return [
+                { key: 'name', title: 'NAME', width: narrow || medium ? 12 : 14, grow: 24 },
+                { key: 'state', title: 'STATE', width: narrow || medium ? 12 : 14 },
+                { key: 'package', title: 'PACKAGE', width: narrow || medium ? 16 : 22 },
+                ...(narrow ? [] : [{ key: 'tasks', title: 'TASKS', width: medium ? 16 : 30 }]),
+                { key: 'lastRun', title: 'LAST RUN', width: 0 },
+            ];
+        case 'repos':
+            return [
+                { key: 'name', title: 'NAME', width: narrow || medium ? 18 : 22 },
+                { key: 'workspaces', title: 'WORKSPACES', width: narrow || medium ? 12 : 14 },
+                { key: 'packages', title: 'PACKAGES', width: narrow || medium ? 10 : 12 },
+                ...(narrow ? [] : [{ key: 'objects', title: 'OBJECTS', width: medium ? 10 : 12 }]),
+                { key: 'lastDeploy', title: 'LAST DEPLOY', width: 0 },
+            ];
+        case 'runs':
+            return [
+                { key: 'status', title: 'STATUS', width: 12 },
+                { key: 'started', title: 'STARTED', width: 22 },
+                { key: 'duration', title: 'DURATION', width: 10 },
+                { key: 'exit', title: 'EXIT', width: 6 },
+                { key: 'inputs', title: 'INPUTS', width: narrow ? 0 : 14 },
+                ...(narrow ? [] : [{ key: 'note', title: '', width: 0 }]),
+            ];
+        case 'completion':
+            return [
+                { key: 'command', title: '', width: 12 },
+                { key: 'name', title: '', width: 14 },
+                { key: 'status', title: '', width: 18 },
+                ...(narrow ? [] : [{ key: 'type', title: '', width: 24 }]),
+                { key: 'detail', title: '', width: 0 },
+            ];
+        case 'jump':
+            return [
+                { key: 'kind', title: '', width: 12 },
+                { key: 'name', title: '', width: 16 },
+                { key: 'workspace', title: '', width: 10 },
+                { key: 'detail', title: '', width: 0 },
+            ];
+    }
+}
+/**
+ * Fits a plan to a row width: while the fixed columns plus the gutter leave
+ * the remainder column fewer than `minRemainder` cells, the widest fixed
+ * column after the first is narrowed (never below 8). At the design width
+ * every plan is untouched.
+ *
+ * @param plan - The column plan
+ * @param width - The row width
+ * @param minRemainder - Cells the remainder column keeps at least (default 12)
+ * @param gutter - Cells before the first column (default 2: the margin + selection bar)
+ * @returns The fitted plan (a copy)
+ */
+export function fitPlan(plan, width, minRemainder = 12, gutter = 2) {
+    const out = plan.map(c => ({ ...c }));
+    const fixed = () => out.reduce((n, c) => n + c.width, 0) + gutter;
+    for (let guard = 0; guard < 4096 && fixed() + minRemainder > width; guard++) {
+        let widest = null;
+        for (const c of out.slice(1)) {
+            if (c.width > 8 && (widest === null || c.width > widest.width))
+                widest = c;
+        }
+        if (widest === null)
+            break;
+        widest.width--;
+    }
+    return out;
+}
+/**
+ * The value tree's label column width — at most 45 % of the row, the
+ * design's `LW = 44` at 120 columns.
+ *
+ * @param columns - The row width
+ * @returns The label width in cells
+ */
+export function labelWidth(columns) {
+    return Math.min(44, Math.max(16, Math.floor(columns * 0.45) - 10));
+}
+/**
+ * Keeps a selection visible: the top row that shows `sel` within `visible`
+ * rows, moving as little as possible from the current `top`.
+ *
+ * @param top - The current first visible row
+ * @param sel - The selected row
+ * @param visible - Visible rows
+ * @param total - Total rows
+ * @returns The new top
+ */
+export function scrollIntoView(top, sel, visible, total) {
+    const maxTop = Math.max(0, total - visible);
+    let next = Math.max(0, Math.min(top, maxTop));
+    if (visible <= 0)
+        return next;
+    if (sel < next)
+        next = sel;
+    else if (sel >= next + visible)
+        next = sel - visible + 1;
+    return Math.max(0, Math.min(next, maxTop));
+}
+//# sourceMappingURL=layout.js.map