take4-console 0.15.0

package/dist/Screen/controls/Checkbox.mjs

@@ -0,0 +1,55 @@
+import { BUILTIN_TEXT_CHECKED } from '../types.mjs';
+import { Window } from '../Window.mjs';
+import { Size } from '../Size.mjs';
+import { getRegistry } from '../RegistryHolder.mjs';
+/** Width of the indicator prefix: `[✓] ` = 4 columns. */
+const INDICATOR_WIDTH = 4;
+/** A toggle control that renders `[✓] label` (checked) or `[ ] label` (unchecked).
+ *  Width is derived automatically from the label length when size is not provided.
+ *  Use setChecked() / setFocused() / setDisabled() to update state. */
+export class Checkbox extends Window {
+    checked;
+    onChange;
+    checkedStyleId;
+    /** Creates a Checkbox from window properties and optional control-specific properties.
+     *  When wp.size is omitted, width is computed from wp.label automatically.
+     *  Uses the global StyleRegistry set by the Screen constructor. */
+    constructor(wp, cp) {
+        const label = wp.label ?? '';
+        const size = wp.size ?? new Size(INDICATOR_WIDTH + label.length, 1);
+        super({ ...wp, size });
+        this.checked = cp?.checked ?? false;
+        this.onChange = cp?.onChange;
+        this.checkedStyleId = getRegistry().getNamed(BUILTIN_TEXT_CHECKED);
+    }
+    /** Toggles or sets the checked state. */
+    setChecked(checked) {
+        this.checked = checked;
+    }
+    /** Returns the current checked state. */
+    isChecked() {
+        return this.checked;
+    }
+    /** Processes a key press; Space toggles the checked state and fires onChange. */
+    handleKey(key) {
+        if (this.disabled)
+            return;
+        if (key === ' ' || key === 'space') {
+            this.checked = !this.checked;
+            this.onChange?.(this.checked);
+        }
+    }
+    /** Rebuilds the checkbox: draws indicator and label with appropriate styles. */
+    render() {
+        this.clear();
+        const indicator = this.checked ? '[✓]' : '[ ]';
+        // For indicator: use checkedStyleId when checked (and not disabled); auto-pick otherwise.
+        const indicatorStyle = (!this.disabled && this.checked) ? this.checkedStyleId : undefined;
+        // Write indicator (first 3 chars) and label separately to allow distinct colouring.
+        // Label uses auto-style (disabled/focused/normal via writeText).
+        this.writeText(indicator, { style: indicatorStyle });
+        this.writeText(` ${this.label}`, { x: INDICATOR_WIDTH - 1 });
+        super.render();
+    }
+}
+//# sourceMappingURL=Checkbox.mjs.map

package/dist/Screen/controls/Checkbox.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Checkbox.mjs","sourceRoot":"","sources":["../../../src/Screen/controls/Checkbox.mts"],"names":[],"mappings":"AACA,OAAO,EAAE,oBAAoB,EAAE,MAAM,cAAc,CAAC;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,OAAO,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AACnC,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpD,yDAAyD;AACzD,MAAM,eAAe,GAAG,CAAC,CAAC;AAE1B;;uEAEuE;AACvE,MAAM,OAAO,QAAS,SAAQ,MAAM;IAC3B,OAAO,CAAU;IACjB,QAAQ,CAA8B;IACtC,cAAc,CAAU;IAEhC;;uEAEmE;IACnE,YAAmB,EAAoB,EAAE,EAAuB;QAC/D,MAAM,KAAK,GAAG,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAI,EAAE,CAAC,IAAI,IAAI,IAAI,IAAI,CAAC,eAAe,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QACrE,KAAK,CAAC,EAAE,GAAG,EAAE,EAAE,IAAI,EAAE,CAAC,CAAC;QAEvB,IAAI,CAAC,OAAO,GAAI,EAAE,EAAE,OAAO,IAAK,KAAK,CAAC;QACtC,IAAI,CAAC,QAAQ,GAAG,EAAE,EAAE,QAAQ,CAAC;QAE7B,IAAI,CAAC,cAAc,GAAG,WAAW,EAAE,CAAC,QAAQ,CAAC,oBAAoB,CAAE,CAAC;IACrE,CAAC;IAED,yCAAyC;IAClC,UAAU,CAAC,OAAgB;QACjC,IAAI,CAAC,OAAO,GAAG,OAAO,CAAC;IACxB,CAAC;IAED,yCAAyC;IAClC,SAAS;QACf,OAAO,IAAI,CAAC,OAAO,CAAC;IACrB,CAAC;IAED,iFAAiF;IAC1E,SAAS,CAAC,GAAW;QAC3B,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO;QAC1B,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,OAAO,EAAE,CAAC;YACpC,IAAI,CAAC,OAAO,GAAG,CAAC,IAAI,CAAC,OAAO,CAAC;YAC7B,IAAI,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QAC/B,CAAC;IACF,CAAC;IAED,gFAAgF;IAChE,MAAM;QACrB,IAAI,CAAC,KAAK,EAAE,CAAC;QAEb,MAAM,SAAS,GAAQ,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC;QACpD,0FAA0F;QAC1F,MAAM,cAAc,GAAG,CAAC,CAAC,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,SAAS,CAAC;QAE1F,oFAAoF;QACpF,iEAAiE;QACjE,IAAI,CAAC,SAAS,CAAC,SAAS,EAAE,EAAE,KAAK,EAAE,cAAc,EAAE,CAAC,CAAC;QACrD,IAAI,CAAC,SAAS,CAAC,IAAI,IAAI,CAAC,KAAK,EAAE,EAAE,EAAE,CAAC,EAAE,eAAe,GAAG,CAAC,EAAE,CAAC,CAAC;QAE7D,KAAK,CAAC,MAAM,EAAE,CAAC;IAChB,CAAC;CACD"}

package/dist/Screen/controls/LineChart.d.mts

@@ -0,0 +1,29 @@
+import type { LineChartProperties, WindowProperties } from '../types.mjs';
+import { Window } from '../Window.mjs';
+/** A read-only line chart that renders a data series using box-drawing characters.
+ *  Includes a labelled Y-axis on the left and an X-axis at the bottom. */
+export declare class LineChart extends Window {
+    private data;
+    private minValue;
+    private maxValue;
+    private lineStyleId;
+    private axisStyleId;
+    private labelStyleId;
+    /** Creates a LineChart from window properties and optional control-specific properties.
+     *  Uses the global StyleRegistry set by the Screen constructor. */
+    constructor(wp: WindowProperties, cp?: LineChartProperties);
+    /** Sets the data series. Call render() afterwards. */
+    setData(data: number[]): void;
+    /** Returns the current data series. */
+    getData(): number[];
+    /** Sets the minimum Y value. Pass undefined to derive from data. Call render() afterwards. */
+    setMin(min: number | undefined): void;
+    /** Returns the configured minimum Y value, or undefined if derived from data. */
+    getMin(): number | undefined;
+    /** Sets the maximum Y value. Pass undefined to derive from data. Call render() afterwards. */
+    setMax(max: number | undefined): void;
+    /** Returns the configured maximum Y value, or undefined if derived from data. */
+    getMax(): number | undefined;
+    render(): void;
+}
+//# sourceMappingURL=LineChart.d.mts.map

package/dist/Screen/controls/LineChart.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LineChart.d.mts","sourceRoot":"","sources":["../../../src/Screen/controls/LineChart.mts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,gBAAgB,EAAW,MAAM,cAAc,CAAC;AACnF,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAUvC;0EAC0E;AAC1E,qBAAa,SAAU,SAAQ,MAAM;IACpC,OAAO,CAAC,IAAI,CAAe;IAC3B,OAAO,CAAC,QAAQ,CAAqB;IACrC,OAAO,CAAC,QAAQ,CAAqB;IAErC,OAAO,CAAC,WAAW,CAAW;IAC9B,OAAO,CAAC,WAAW,CAAW;IAC9B,OAAO,CAAC,YAAY,CAAU;IAE9B;uEACmE;gBAChD,EAAE,EAAE,gBAAgB,EAAE,EAAE,CAAC,EAAE,mBAAmB;IAajE,sDAAsD;IAC/C,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI;IAIpC,uCAAuC;IAChC,OAAO,IAAI,MAAM,EAAE;IAI1B,8FAA8F;IACvF,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAI5C,iFAAiF;IAC1E,MAAM,IAAI,MAAM,GAAG,SAAS;IAInC,8FAA8F;IACvF,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAI5C,iFAAiF;IAC1E,MAAM,IAAI,MAAM,GAAG,SAAS;IAInB,MAAM,IAAI,IAAI;CAsI9B"}

package/dist/Screen/controls/LineChart.mjs

@@ -0,0 +1,172 @@
+import { Window } from '../Window.mjs';
+import { getRegistry } from '../RegistryHolder.mjs';
+/** Formats a Y-axis label value as a compact string. */
+function formatYLabel(value) {
+    if (Number.isInteger(value))
+        return String(value);
+    const rounded = Math.round(value * 10) / 10;
+    return String(rounded);
+}
+/** A read-only line chart that renders a data series using box-drawing characters.
+ *  Includes a labelled Y-axis on the left and an X-axis at the bottom. */
+export class LineChart extends Window {
+    data;
+    minValue;
+    maxValue;
+    lineStyleId;
+    axisStyleId;
+    labelStyleId;
+    /** Creates a LineChart from window properties and optional control-specific properties.
+     *  Uses the global StyleRegistry set by the Screen constructor. */
+    constructor(wp, cp) {
+        super(wp);
+        this.data = cp?.data ?? [];
+        this.minValue = cp?.min;
+        this.maxValue = cp?.max;
+        const reg = getRegistry();
+        this.lineStyleId = reg.register({ foreground: cp?.color ?? 75 });
+        this.axisStyleId = reg.register({ foreground: 245 });
+        this.labelStyleId = reg.register({ foreground: 245 });
+    }
+    /** Sets the data series. Call render() afterwards. */
+    setData(data) {
+        this.data = data;
+    }
+    /** Returns the current data series. */
+    getData() {
+        return this.data;
+    }
+    /** Sets the minimum Y value. Pass undefined to derive from data. Call render() afterwards. */
+    setMin(min) {
+        this.minValue = min;
+    }
+    /** Returns the configured minimum Y value, or undefined if derived from data. */
+    getMin() {
+        return this.minValue;
+    }
+    /** Sets the maximum Y value. Pass undefined to derive from data. Call render() afterwards. */
+    setMax(max) {
+        this.maxValue = max;
+    }
+    /** Returns the configured maximum Y value, or undefined if derived from data. */
+    getMax() {
+        return this.maxValue;
+    }
+    render() {
+        this.clear();
+        const { width, height } = this.getInnerSize();
+        const { x: ox, y: oy } = this.getInnerOffset();
+        if (width < 4 || height < 3) {
+            super.render();
+            return;
+        }
+        // ── 1. Resolve data range ───────────────────────��───────────────────────
+        const dataMin = this.minValue ?? (this.data.length > 0 ? Math.min(...this.data) : 0);
+        const dataMax = this.maxValue ?? (this.data.length > 0 ? Math.max(...this.data) : 1);
+        const dataRange = dataMax - dataMin;
+        // ── 2. Compute Y-axis label width ────────────────────────────────────────
+        const numYLabels = Math.min(5, Math.max(2, height - 1));
+        const yLabelValues = Array.from({ length: numYLabels }, (_, k) => dataMin + (k / (numYLabels - 1)) * dataRange);
+        const yLabelStrs = yLabelValues.map(formatYLabel);
+        const maxLabelLen = Math.max(...yLabelStrs.map(s => s.length));
+        const yLabelWidth = maxLabelLen + 2; // space + label + '┤'
+        // ── 3. Plot dimensions ───────────────────────��───────────────────────────
+        const plotW = width - yLabelWidth;
+        const plotH = height - 1; // last row = X-axis
+        if (plotW < 1 || plotH < 1) {
+            super.render();
+            return;
+        }
+        /** Maps a value to a plot row (0 = top = dataMax). */
+        const valueToRow = (v) => {
+            if (dataRange === 0)
+                return Math.floor((plotH - 1) / 2);
+            const norm = Math.min(1, Math.max(0, (v - dataMin) / dataRange));
+            return (plotH - 1) - Math.round(norm * (plotH - 1));
+        };
+        // ── 4. Draw Y-axis ───────────────────��────────────────────────────────────
+        const yAxisAbsX = ox + yLabelWidth - 1; // column of '┤' / '│'
+        // Draw vertical line for all plot rows
+        for (let row = 0; row < plotH; row++) {
+            this.setCell(yAxisAbsX, oy + row, '│', this.axisStyleId);
+        }
+        // Overwrite with '┤' and labels at each label row
+        for (let k = 0; k < numYLabels; k++) {
+            // k=0 → bottom label (dataMin), k=numYLabels-1 → top label (dataMax)
+            const labelValue = yLabelValues[k];
+            const labelRow = valueToRow(labelValue);
+            const labelStr = yLabelStrs[k];
+            // Right-justify within maxLabelLen columns starting at ox
+            const padded = labelStr.padStart(maxLabelLen);
+            this.setCell(yAxisAbsX, oy + labelRow, '┤', this.axisStyleId);
+            for (let c = 0; c < padded.length; c++) {
+                this.setCell(ox + c, oy + labelRow, padded[c], this.labelStyleId);
+            }
+        }
+        // ── 5. Draw X-axis ─────────────────────────���─────────────────────────���────
+        const xAxisAbsY = oy + plotH;
+        for (let col = 0; col < plotW; col++) {
+            const absX = ox + yLabelWidth + col;
+            this.setCell(absX, xAxisAbsY, col === 0 ? '┼' : '─', this.axisStyleId);
+        }
+        // Y-axis bottom corner
+        this.setCell(yAxisAbsX, xAxisAbsY, '┼', this.axisStyleId);
+        // ── 6. Plot the line ──────────────────────────────────────────────────────
+        if (this.data.length === 0) {
+            super.render();
+            return;
+        }
+        // Build an interpolated row index for every plot column. With more
+        // columns than data points, this upsamples the series; with fewer,
+        // it averages between adjacent samples.
+        const dataRow = new Array(plotW);
+        if (this.data.length === 1) {
+            const r0 = valueToRow(this.data[0]);
+            for (let c = 0; c < plotW; c++)
+                dataRow[c] = r0;
+        }
+        else {
+            for (let c = 0; c < plotW; c++) {
+                const t = (c / (plotW - 1)) * (this.data.length - 1);
+                const i0 = Math.floor(t);
+                const i1 = Math.min(i0 + 1, this.data.length - 1);
+                const frac = t - i0;
+                const v = this.data[i0] * (1 - frac) + this.data[i1] * frac;
+                dataRow[c] = valueToRow(v);
+            }
+        }
+        /** Draws a single line cell in plot space. */
+        const plot = (col, row, ch) => {
+            this.setCell(ox + yLabelWidth + col, oy + row, ch, this.lineStyleId);
+        };
+        // Each column either holds a flat horizontal segment or a self-contained
+        // vertical step bridging the previous column's row to this column's row.
+        // The first column has no incoming step.
+        plot(0, dataRow[0], '─');
+        for (let c = 1; c < plotW; c++) {
+            const inRow = dataRow[c - 1];
+            const outRow = dataRow[c];
+            if (inRow === outRow) {
+                plot(c, outRow, '─');
+                continue;
+            }
+            const top = Math.min(inRow, outRow);
+            const bot = Math.max(inRow, outRow);
+            if (outRow < inRow) {
+                // Going up: line enters from left at the bottom, exits right at the top.
+                plot(c, bot, '╯'); // LEFT + TOP
+                plot(c, top, '╭'); // BOTTOM + RIGHT
+            }
+            else {
+                // Going down: line enters from left at the top, exits right at the bottom.
+                plot(c, top, '╮'); // LEFT + BOTTOM
+                plot(c, bot, '╰'); // TOP + RIGHT
+            }
+            for (let row = top + 1; row < bot; row++) {
+                plot(c, row, '│');
+            }
+        }
+        super.render();
+    }
+}
+//# sourceMappingURL=LineChart.mjs.map

package/dist/Screen/controls/LineChart.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"LineChart.mjs","sourceRoot":"","sources":["../../../src/Screen/controls/LineChart.mts"],"names":[],"mappings":"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"}

package/dist/Screen/controls/ListBox.d.mts

@@ -0,0 +1,34 @@
+import type { ListBoxProperties, WindowProperties } from '../types.mjs';
+import { Window } from '../Window.mjs';
+/** A scrollable list of single-line items. The selected item is highlighted and may
+ *  be moved with arrow keys, PgUp/PgDn, and Home/End. Emits onChange whenever the
+ *  selection index changes via keyboard. Appearance follows the same built-in style
+ *  naming scheme as the other focusable controls. */
+export declare class ListBox extends Window {
+    private items;
+    private selectedIndex;
+    private scrollTop;
+    private onChange?;
+    private selectedStyleId;
+    private focusedSelStyle;
+    /** Creates a ListBox from window properties and optional control-specific properties.
+     *  Uses the global StyleRegistry set by the Screen constructor. */
+    constructor(wp: WindowProperties, cp?: ListBoxProperties);
+    /** Replaces the list items. Resets selection to 0 (or -1 if empty) and scrolls to top. */
+    setItems(items: string[]): void;
+    /** Returns the current list items. */
+    getItems(): string[];
+    /** Sets the selected index. Clamped to valid range; -1 allowed only when items is empty. */
+    setSelectedIndex(index: number): void;
+    /** Returns the currently selected index, or -1 when the list is empty. */
+    getSelectedIndex(): number;
+    /** Returns the currently selected item string, or undefined when nothing is selected. */
+    getSelectedItem(): string | undefined;
+    /** Processes a key press: arrow keys, Home/End, PgUp/PgDn move the selection. */
+    handleKey(key: string): void;
+    /** Adjusts scrollTop so that the selected index remains within the visible window. */
+    private ensureVisible;
+    /** Rebuilds the list: renders visible rows with styles. */
+    render(): void;
+}
+//# sourceMappingURL=ListBox.d.mts.map

package/dist/Screen/controls/ListBox.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ListBox.d.mts","sourceRoot":"","sources":["../../../src/Screen/controls/ListBox.mts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAW,MAAM,cAAc,CAAC;AACjF,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAGvC;;;qDAGqD;AACrD,qBAAa,OAAQ,SAAQ,MAAM;IAClC,OAAO,CAAC,KAAK,CAAW;IACxB,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,CAAwC;IACzD,OAAO,CAAC,eAAe,CAAW;IAClC,OAAO,CAAC,eAAe,CAAW;IAElC;uEACmE;gBAChD,EAAE,EAAE,gBAAgB,EAAE,EAAE,CAAC,EAAE,iBAAiB;IAiB/D,0FAA0F;IACnF,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI;IAMtC,sCAAsC;IAC/B,QAAQ,IAAI,MAAM,EAAE;IAI3B,4FAA4F;IACrF,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAS5C,0EAA0E;IACnE,gBAAgB,IAAI,MAAM;IAIjC,yFAAyF;IAClF,eAAe,IAAI,MAAM,GAAG,SAAS;IAK5C,iFAAiF;IAC1E,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAqCnC,sFAAsF;IACtF,OAAO,CAAC,aAAa;IAYrB,2DAA2D;IAC3C,MAAM,IAAI,IAAI;CAiC9B"}

package/dist/Screen/controls/ListBox.mjs

@@ -0,0 +1,138 @@
+import { Window } from '../Window.mjs';
+import { getRegistry } from '../RegistryHolder.mjs';
+/** A scrollable list of single-line items. The selected item is highlighted and may
+ *  be moved with arrow keys, PgUp/PgDn, and Home/End. Emits onChange whenever the
+ *  selection index changes via keyboard. Appearance follows the same built-in style
+ *  naming scheme as the other focusable controls. */
+export class ListBox extends Window {
+    items;
+    selectedIndex;
+    scrollTop;
+    onChange;
+    selectedStyleId;
+    focusedSelStyle;
+    /** Creates a ListBox from window properties and optional control-specific properties.
+     *  Uses the global StyleRegistry set by the Screen constructor. */
+    constructor(wp, cp) {
+        super({
+            ...wp,
+            defaultBorder: { top: true, right: true, bottom: true, left: true, style: 'single' },
+        });
+        this.items = cp?.items ?? [];
+        this.onChange = cp?.onChange;
+        this.scrollTop = 0;
+        this.selectedIndex = cp?.selectedIndex ?? (this.items.length > 0 ? 0 : -1);
+        // Selected row: muted highlight when unfocused, bright inverse when focused.
+        const reg = getRegistry();
+        this.selectedStyleId = reg.register({ background: 238, foreground: 252 });
+        this.focusedSelStyle = reg.register({ background: 75, foreground: 231, bold: true });
+    }
+    /** Replaces the list items. Resets selection to 0 (or -1 if empty) and scrolls to top. */
+    setItems(items) {
+        this.items = items;
+        this.selectedIndex = items.length > 0 ? 0 : -1;
+        this.scrollTop = 0;
+    }
+    /** Returns the current list items. */
+    getItems() {
+        return this.items;
+    }
+    /** Sets the selected index. Clamped to valid range; -1 allowed only when items is empty. */
+    setSelectedIndex(index) {
+        if (this.items.length === 0) {
+            this.selectedIndex = -1;
+            return;
+        }
+        this.selectedIndex = Math.max(0, Math.min(this.items.length - 1, index));
+        this.ensureVisible();
+    }
+    /** Returns the currently selected index, or -1 when the list is empty. */
+    getSelectedIndex() {
+        return this.selectedIndex;
+    }
+    /** Returns the currently selected item string, or undefined when nothing is selected. */
+    getSelectedItem() {
+        if (this.selectedIndex < 0 || this.selectedIndex >= this.items.length)
+            return undefined;
+        return this.items[this.selectedIndex];
+    }
+    /** Processes a key press: arrow keys, Home/End, PgUp/PgDn move the selection. */
+    handleKey(key) {
+        if (this.disabled || this.items.length === 0)
+            return;
+        const prev = this.selectedIndex;
+        const pageSz = Math.max(1, this.getInnerSize().height);
+        switch (key) {
+            case '\x1b[A': // Up arrow
+                this.selectedIndex = Math.max(0, this.selectedIndex - 1);
+                break;
+            case '\x1b[B': // Down arrow
+                this.selectedIndex = Math.min(this.items.length - 1, this.selectedIndex + 1);
+                break;
+            case '\x1b[H': // Home
+            case '\x1b[1~':
+                this.selectedIndex = 0;
+                break;
+            case '\x1b[F': // End
+            case '\x1b[4~':
+                this.selectedIndex = this.items.length - 1;
+                break;
+            case '\x1b[5~': // PgUp
+                this.selectedIndex = Math.max(0, this.selectedIndex - pageSz);
+                break;
+            case '\x1b[6~': // PgDn
+                this.selectedIndex = Math.min(this.items.length - 1, this.selectedIndex + pageSz);
+                break;
+            default:
+                return;
+        }
+        this.ensureVisible();
+        if (this.selectedIndex !== prev) {
+            this.onChange?.(this.selectedIndex, this.items[this.selectedIndex]);
+        }
+    }
+    /** Adjusts scrollTop so that the selected index remains within the visible window. */
+    ensureVisible() {
+        const visibleRows = Math.max(1, this.getInnerSize().height);
+        if (this.selectedIndex < this.scrollTop) {
+            this.scrollTop = this.selectedIndex;
+        }
+        else if (this.selectedIndex >= this.scrollTop + visibleRows) {
+            this.scrollTop = this.selectedIndex - visibleRows + 1;
+        }
+        // Clamp scrollTop so we don't leave trailing empty rows unless necessary.
+        const maxScroll = Math.max(0, this.items.length - visibleRows);
+        this.scrollTop = Math.max(0, Math.min(maxScroll, this.scrollTop));
+    }
+    /** Rebuilds the list: renders visible rows with styles. */
+    render() {
+        this.clear();
+        const { width, height } = this.getInnerSize();
+        if (width < 1 || height < 1) {
+            super.render();
+            return;
+        }
+        this.ensureVisible();
+        const visibleCount = Math.min(height, this.items.length - this.scrollTop);
+        for (let row = 0; row < visibleCount; row++) {
+            const itemIndex = this.scrollTop + row;
+            const rawText = this.items[itemIndex];
+            // Truncate to fit width; pad with spaces so the highlight covers the whole row.
+            const text = rawText.length > width ? rawText.slice(0, width) : rawText;
+            const padded = text + ' '.repeat(width - text.length);
+            let style;
+            if (this.disabled) {
+                style = this.disabledStyleId;
+            }
+            else if (itemIndex === this.selectedIndex) {
+                style = this.focused ? this.focusedSelStyle : this.selectedStyleId;
+            }
+            else {
+                style = this.normalStyleId;
+            }
+            this.writeText(padded, { x: 0, y: row, style });
+        }
+        super.render();
+    }
+}
+//# sourceMappingURL=ListBox.mjs.map

package/dist/Screen/controls/ListBox.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ListBox.mjs","sourceRoot":"","sources":["../../../src/Screen/controls/ListBox.mts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AACvC,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AAEpD;;;qDAGqD;AACrD,MAAM,OAAO,OAAQ,SAAQ,MAAM;IAC1B,KAAK,CAAW;IAChB,aAAa,CAAS;IACtB,SAAS,CAAS;IAClB,QAAQ,CAAyC;IACjD,eAAe,CAAW;IAC1B,eAAe,CAAW;IAElC;uEACmE;IACnE,YAAmB,EAAoB,EAAE,EAAsB;QAC9D,KAAK,CAAC;YACL,GAAG,EAAE;YACL,aAAa,EAAE,EAAE,GAAG,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EAAE,KAAK,EAAE,QAAQ,EAAE;SACpF,CAAC,CAAC;QAEH,IAAI,CAAC,KAAK,GAAW,EAAE,EAAE,KAAK,IAAI,EAAE,CAAC;QACrC,IAAI,CAAC,QAAQ,GAAQ,EAAE,EAAE,QAAQ,CAAC;QAClC,IAAI,CAAC,SAAS,GAAO,CAAC,CAAC;QACvB,IAAI,CAAC,aAAa,GAAG,EAAE,EAAE,aAAa,IAAI,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAE3E,6EAA6E;QAC7E,MAAM,GAAG,GAAG,WAAW,EAAE,CAAC;QAC1B,IAAI,CAAC,eAAe,GAAG,GAAG,CAAC,QAAQ,CAAC,EAAE,UAAU,EAAE,GAAG,EAAE,UAAU,EAAE,GAAG,EAAE,CAAC,CAAC;QAC1E,IAAI,CAAC,eAAe,GAAG,GAAG,CAAC,QAAQ,CAAC,EAAE,UAAU,EAAE,EAAE,EAAE,UAAU,EAAE,GAAG,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;IACtF,CAAC;IAED,0FAA0F;IACnF,QAAQ,CAAC,KAAe;QAC9B,IAAI,CAAC,KAAK,GAAW,KAAK,CAAC;QAC3B,IAAI,CAAC,aAAa,GAAG,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC/C,IAAI,CAAC,SAAS,GAAO,CAAC,CAAC;IACxB,CAAC;IAED,sCAAsC;IAC/B,QAAQ;QACd,OAAO,IAAI,CAAC,KAAK,CAAC;IACnB,CAAC;IAED,4FAA4F;IACrF,gBAAgB,CAAC,KAAa;QACpC,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7B,IAAI,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC;YACxB,OAAO;QACR,CAAC;QACD,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC;QACzE,IAAI,CAAC,aAAa,EAAE,CAAC;IACtB,CAAC;IAED,0EAA0E;IACnE,gBAAgB;QACtB,OAAO,IAAI,CAAC,aAAa,CAAC;IAC3B,CAAC;IAED,yFAAyF;IAClF,eAAe;QACrB,IAAI,IAAI,CAAC,aAAa,GAAG,CAAC,IAAI,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM;YAAE,OAAO,SAAS,CAAC;QACxF,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IACvC,CAAC;IAED,iFAAiF;IAC1E,SAAS,CAAC,GAAW;QAC3B,IAAI,IAAI,CAAC,QAAQ,IAAI,IAAI,CAAC,KAAK,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAErD,MAAM,IAAI,GAAK,IAAI,CAAC,aAAa,CAAC;QAClC,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC,MAAM,CAAC,CAAC;QAEvD,QAAQ,GAAG,EAAE,CAAC;YACb,KAAK,QAAQ,EAAE,WAAW;gBACzB,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC;gBACzD,MAAM;YACP,KAAK,QAAQ,EAAE,aAAa;gBAC3B,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,IAAI,CAAC,aAAa,GAAG,CAAC,CAAC,CAAC;gBAC7E,MAAM;YACP,KAAK,QAAQ,CAAC,CAAC,OAAO;YACtB,KAAK,SAAS;gBACb,IAAI,CAAC,aAAa,GAAG,CAAC,CAAC;gBACvB,MAAM;YACP,KAAK,QAAQ,CAAC,CAAC,MAAM;YACrB,KAAK,SAAS;gBACb,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC;gBAC3C,MAAM;YACP,KAAK,SAAS,EAAE,OAAO;gBACtB,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC,CAAC;gBAC9D,MAAM;YACP,KAAK,SAAS,EAAE,OAAO;gBACtB,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,EAAE,IAAI,CAAC,aAAa,GAAG,MAAM,CAAC,CAAC;gBAClF,MAAM;YACP;gBACC,OAAO;QACT,CAAC;QAED,IAAI,CAAC,aAAa,EAAE,CAAC;QACrB,IAAI,IAAI,CAAC,aAAa,KAAK,IAAI,EAAE,CAAC;YACjC,IAAI,CAAC,QAAQ,EAAE,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC;QACrE,CAAC;IACF,CAAC;IAED,sFAAsF;IAC9E,aAAa;QACpB,MAAM,WAAW,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC,MAAM,CAAC,CAAC;QAC5D,IAAI,IAAI,CAAC,aAAa,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;YACzC,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,aAAa,CAAC;QACrC,CAAC;aAAM,IAAI,IAAI,CAAC,aAAa,IAAI,IAAI,CAAC,SAAS,GAAG,WAAW,EAAE,CAAC;YAC/D,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,aAAa,GAAG,WAAW,GAAG,CAAC,CAAC;QACvD,CAAC;QACD,0EAA0E;QAC1E,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,WAAW,CAAC,CAAC;QAC/D,IAAI,CAAC,SAAS,GAAI,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,SAAS,EAAE,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC;IACpE,CAAC;IAED,2DAA2D;IAC3C,MAAM;QACrB,IAAI,CAAC,KAAK,EAAE,CAAC;QAEb,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;QAC9C,IAAI,KAAK,GAAG,CAAC,IAAI,MAAM,GAAG,CAAC,EAAE,CAAC;YAC7B,KAAK,CAAC,MAAM,EAAE,CAAC;YACf,OAAO;QACR,CAAC;QAED,IAAI,CAAC,aAAa,EAAE,CAAC;QAErB,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,SAAS,CAAC,CAAC;QAC1E,KAAK,IAAI,GAAG,GAAG,CAAC,EAAE,GAAG,GAAG,YAAY,EAAE,GAAG,EAAE,EAAE,CAAC;YAC7C,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,GAAG,GAAG,CAAC;YACvC,MAAM,OAAO,GAAK,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;YACxC,gFAAgF;YAChF,MAAM,IAAI,GAAQ,OAAO,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC;YAC7E,MAAM,MAAM,GAAM,IAAI,GAAG,GAAG,CAAC,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC;YAEzD,IAAI,KAAc,CAAC;YACnB,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACnB,KAAK,GAAG,IAAI,CAAC,eAAe,CAAC;YAC9B,CAAC;iBAAM,IAAI,SAAS,KAAK,IAAI,CAAC,aAAa,EAAE,CAAC;gBAC7C,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC;YACpE,CAAC;iBAAM,CAAC;gBACP,KAAK,GAAG,IAAI,CAAC,aAAa,CAAC;YAC5B,CAAC;YAED,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC;QACjD,CAAC;QAED,KAAK,CAAC,MAAM,EAAE,CAAC;IAChB,CAAC;CACD"}

package/dist/Screen/controls/ProgressBar.d.mts

@@ -0,0 +1,26 @@
+import type { ProgressBarProperties, WindowProperties } from '../types.mjs';
+import { Window } from '../Window.mjs';
+/** A horizontal read-only progress bar that fills left-to-right using block characters.
+ *  Displays an optional centred percentage label over the bar. */
+export declare class ProgressBar extends Window {
+    private value;
+    private max;
+    private showLabel;
+    private fillStyleId;
+    private emptyStyleId;
+    private labelStyleId;
+    /** Creates a ProgressBar from window properties and optional control-specific properties.
+     *  Recommended height: 1 (no border) or 3 (with border).
+     *  Uses the global StyleRegistry set by the Screen constructor. */
+    constructor(wp: WindowProperties, cp?: ProgressBarProperties);
+    /** Sets the current value (clamped to 0–max). Call render() afterwards. */
+    setValue(value: number): void;
+    /** Returns the current value. */
+    getValue(): number;
+    /** Sets the maximum value (minimum 1). Call render() afterwards. */
+    setMax(max: number): void;
+    /** Returns the maximum value. */
+    getMax(): number;
+    render(): void;
+}
+//# sourceMappingURL=ProgressBar.d.mts.map

package/dist/Screen/controls/ProgressBar.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProgressBar.d.mts","sourceRoot":"","sources":["../../../src/Screen/controls/ProgressBar.mts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,qBAAqB,EAAE,gBAAgB,EAAW,MAAM,cAAc,CAAC;AACrF,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAQvC;kEACkE;AAClE,qBAAa,WAAY,SAAQ,MAAM;IACtC,OAAO,CAAC,KAAK,CAAa;IAC1B,OAAO,CAAC,GAAG,CAAe;IAC1B,OAAO,CAAC,SAAS,CAAU;IAE3B,OAAO,CAAC,WAAW,CAAW;IAC9B,OAAO,CAAC,YAAY,CAAU;IAC9B,OAAO,CAAC,YAAY,CAAU;IAE9B;;uEAEmE;gBAChD,EAAE,EAAE,gBAAgB,EAAE,EAAE,CAAC,EAAE,qBAAqB;IAanE,2EAA2E;IACpE,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIpC,iCAAiC;IAC1B,QAAQ,IAAI,MAAM;IAIzB,oEAAoE;IAC7D,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAKhC,iCAAiC;IAC1B,MAAM,IAAI,MAAM;IAIP,MAAM,IAAI,IAAI;CA8B9B"}

package/dist/Screen/controls/ProgressBar.mjs

@@ -0,0 +1,70 @@
+import { Window } from '../Window.mjs';
+import { getRegistry } from '../RegistryHolder.mjs';
+/** Character used for the filled portion of the bar. */
+const CHAR_FILL = '█';
+/** Character used for the empty portion of the bar. */
+const CHAR_EMPTY = '░';
+/** A horizontal read-only progress bar that fills left-to-right using block characters.
+ *  Displays an optional centred percentage label over the bar. */
+export class ProgressBar extends Window {
+    value;
+    max;
+    showLabel;
+    fillStyleId;
+    emptyStyleId;
+    labelStyleId;
+    /** Creates a ProgressBar from window properties and optional control-specific properties.
+     *  Recommended height: 1 (no border) or 3 (with border).
+     *  Uses the global StyleRegistry set by the Screen constructor. */
+    constructor(wp, cp) {
+        super(wp);
+        this.max = Math.max(1, cp?.max ?? 100);
+        this.value = Math.max(0, Math.min(cp?.value ?? 0, this.max));
+        this.showLabel = cp?.showLabel ?? true;
+        const reg = getRegistry();
+        this.fillStyleId = reg.register({ background: cp?.fillColor ?? 75 });
+        this.emptyStyleId = reg.register({ background: cp?.emptyColor ?? 237 });
+        this.labelStyleId = reg.register({ foreground: 255, bold: true });
+    }
+    /** Sets the current value (clamped to 0–max). Call render() afterwards. */
+    setValue(value) {
+        this.value = Math.max(0, Math.min(value, this.max));
+    }
+    /** Returns the current value. */
+    getValue() {
+        return this.value;
+    }
+    /** Sets the maximum value (minimum 1). Call render() afterwards. */
+    setMax(max) {
+        this.max = Math.max(1, max);
+        this.value = Math.min(this.value, this.max);
+    }
+    /** Returns the maximum value. */
+    getMax() {
+        return this.max;
+    }
+    render() {
+        this.clear();
+        const { width, height } = this.getInnerSize();
+        const { x: ox, y: oy } = this.getInnerOffset();
+        if (width < 1 || height < 1) {
+            super.render();
+            return;
+        }
+        const ratio = this.max > 0 ? Math.min(1, Math.max(0, this.value / this.max)) : 0;
+        const filledCols = Math.round(ratio * width);
+        const barRow = Math.floor(height / 2);
+        for (let x = 0; x < width; x++) {
+            const isFilled = x < filledCols;
+            this.setCell(ox + x, oy + barRow, isFilled ? CHAR_FILL : CHAR_EMPTY, isFilled ? this.fillStyleId : this.emptyStyleId);
+        }
+        if (this.showLabel) {
+            const pct = Math.round(ratio * 100);
+            const text = `${pct}%`;
+            const labelX = Math.max(0, Math.floor((width - text.length) / 2));
+            this.writeText(text, { x: labelX, y: barRow, style: this.labelStyleId });
+        }
+        super.render();
+    }
+}
+//# sourceMappingURL=ProgressBar.mjs.map

package/dist/Screen/controls/ProgressBar.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProgressBar.mjs","sourceRoot":"","sources":["../../../src/Screen/controls/ProgressBar.mts"],"names":[],"mappings":"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"}

package/dist/Screen/controls/ProgressBarV.d.mts

@@ -0,0 +1,22 @@
+import type { ProgressBarVProperties, WindowProperties } from '../types.mjs';
+import { Window } from '../Window.mjs';
+/** A vertical read-only progress bar that fills from the bottom upward using block characters. */
+export declare class ProgressBarV extends Window {
+    private value;
+    private max;
+    private fillStyleId;
+    private emptyStyleId;
+    /** Creates a ProgressBarV from window properties and optional control-specific properties.
+     *  Uses the global StyleRegistry set by the Screen constructor. */
+    constructor(wp: WindowProperties, cp?: ProgressBarVProperties);
+    /** Sets the current value (clamped to 0–max). Call render() afterwards. */
+    setValue(value: number): void;
+    /** Returns the current value. */
+    getValue(): number;
+    /** Sets the maximum value (minimum 1). Call render() afterwards. */
+    setMax(max: number): void;
+    /** Returns the maximum value. */
+    getMax(): number;
+    render(): void;
+}
+//# sourceMappingURL=ProgressBarV.d.mts.map

package/dist/Screen/controls/ProgressBarV.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ProgressBarV.d.mts","sourceRoot":"","sources":["../../../src/Screen/controls/ProgressBarV.mts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,sBAAsB,EAAE,gBAAgB,EAAW,MAAM,cAAc,CAAC;AACtF,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAQvC,kGAAkG;AAClG,qBAAa,YAAa,SAAQ,MAAM;IACvC,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,GAAG,CAAW;IAEtB,OAAO,CAAC,WAAW,CAAW;IAC9B,OAAO,CAAC,YAAY,CAAU;IAE9B;uEACmE;gBAChD,EAAE,EAAE,gBAAgB,EAAE,EAAE,CAAC,EAAE,sBAAsB;IAWpE,2EAA2E;IACpE,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,IAAI;IAIpC,iCAAiC;IAC1B,QAAQ,IAAI,MAAM;IAIzB,oEAAoE;IAC7D,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAKhC,iCAAiC;IAC1B,MAAM,IAAI,MAAM;IAIP,MAAM,IAAI,IAAI;CAyB9B"}