take4-console 0.15.0

package/dist/Screen/WindowManager.mjs

@@ -0,0 +1,399 @@
+// ── Key parsing ───────────────────────────────────────────────────────────────
+/**
+ * Parses a raw stdin Buffer into an array of key strings.
+ * Regular characters are emitted as-is; escape sequences (CSI, SS3) are
+ * captured as multi-character strings (e.g. '\x1b[A' for the up arrow).
+ */
+function parseKeys(data) {
+    const keys = [];
+    let i = 0;
+    while (i < data.length) {
+        const byte = data[i];
+        if (byte !== 0x1b) {
+            // UTF-8 multi-byte character start (0xC2–0xF4).
+            if (byte >= 0xc2 && byte <= 0xf4) {
+                const len = byte >= 0xf0 ? 4 : byte >= 0xe0 ? 3 : 2;
+                const end = Math.min(i + len, data.length);
+                keys.push(data.subarray(i, end).toString('utf8'));
+                i = end;
+            }
+            else {
+                keys.push(String.fromCharCode(byte));
+                i++;
+            }
+            continue;
+        }
+        // Escape byte (0x1B).
+        if (i + 1 >= data.length) {
+            keys.push('\x1b');
+            i++;
+            continue;
+        }
+        const next = data[i + 1];
+        if (next === 0x5b) {
+            // CSI sequence: ESC [ <params> <final>
+            // Final byte is in range 0x40–0x7E.
+            let j = i + 2;
+            while (j < data.length && (data[j] < 0x40 || data[j] > 0x7e))
+                j++;
+            if (j < data.length) {
+                keys.push(data.subarray(i, j + 1).toString('utf8'));
+                i = j + 1;
+            }
+            else {
+                keys.push('\x1b');
+                i++;
+            }
+        }
+        else if (next === 0x4f) {
+            // SS3 sequence: ESC O <char> (F1–F4).
+            if (i + 2 < data.length) {
+                keys.push(data.subarray(i, i + 3).toString('utf8'));
+                i += 3;
+            }
+            else {
+                keys.push('\x1b');
+                i++;
+            }
+        }
+        else {
+            // Lone ESC (or unrecognised Alt combo — emit just ESC).
+            keys.push('\x1b');
+            i++;
+        }
+    }
+    return keys;
+}
+/**
+ * Attempts to parse an SGR mouse escape sequence.
+ * SGR format: \x1b[<btn;x;yM (press) or \x1b[<btn;x;ym (release / move).
+ * Returns null if the key string is not a mouse sequence.
+ */
+function parseMouseEvent(key) {
+    const m = key.match(/^\x1b\[<(\d+);(\d+);(\d+)([Mm])$/);
+    if (!m)
+        return null;
+    const raw = parseInt(m[1], 10);
+    const x = parseInt(m[2], 10) - 1; // terminal uses 1-based coords
+    const y = parseInt(m[3], 10) - 1;
+    const press = m[4] === 'M';
+    const isMove = (raw & 32) !== 0;
+    return {
+        type: isMove ? 'move' : press ? 'press' : 'release',
+        button: raw & 3,
+        x,
+        y,
+        shift: (raw & 4) !== 0,
+        alt: (raw & 8) !== 0,
+        ctrl: (raw & 16) !== 0,
+    };
+}
+// ── WindowManager ─────────────────────────────────────────────────────────────
+/** Manages the application input loop, focus, and modal dialogs.
+ *
+ * Usage:
+ *   1. Create a Screen and add windows/controls to it.
+ *   2. Instantiate WindowManager and call register() for each focusable control.
+ *   3. Call run() to start the event loop.
+ *
+ * Focus is cycled with Tab / Shift-Tab. Keys are dispatched to the focused
+ * control's handleKey() method. Ctrl+C (or a configured exitKey) stops the loop.
+ */
+export class WindowManager {
+    screen;
+    exitKeys;
+    onExit;
+    onKey;
+    onMouse;
+    mouseEnabled;
+    mainEntries;
+    mainFocusIndex;
+    dialogStack;
+    running;
+    /** Bound reference kept so we can remove the listener in stop(). */
+    boundHandleInput;
+    /** Bound SIGTERM handler for clean shutdown. */
+    boundSigterm;
+    /** Creates a WindowManager for the given Screen.
+     *  Does not start the input loop; call run() to begin. */
+    constructor(screen, options) {
+        this.screen = screen;
+        this.exitKeys = options?.exitKeys ?? ['\x03']; // Ctrl+C
+        this.onExit = options?.onExit;
+        this.onKey = options?.onKey;
+        this.onMouse = options?.onMouse;
+        this.mouseEnabled = options?.mouse ?? false;
+        this.mainEntries = [];
+        this.mainFocusIndex = -1;
+        this.dialogStack = [];
+        this.running = false;
+        this.boundHandleInput = this.handleInput.bind(this);
+        this.boundSigterm = () => this.stop();
+    }
+    // ── Registration ───────────────────────────────────────────────────────────
+    /** Registers a focusable control for Tab-cycling in the main (non-dialog) context.
+     *  Pass the chain of parent Windows so the absolute screen position can be computed
+     *  for mouse hit-testing (innermost parent first, outermost last is NOT required —
+     *  just pass them in nesting order from the control outward). */
+    register(control, ...parents) {
+        const absX = parents.reduce((acc, p) => acc + p.x, 0) + control.x;
+        const absY = parents.reduce((acc, p) => acc + p.y, 0) + control.y;
+        this.mainEntries.push({ control, absX, absY });
+    }
+    /** Removes a previously registered control from the main focus list. */
+    unregister(control) {
+        const idx = this.mainEntries.findIndex(e => e.control === control);
+        if (idx !== -1)
+            this.mainEntries.splice(idx, 1);
+        if (this.mainFocusIndex >= this.mainEntries.length) {
+            this.mainFocusIndex = this.mainEntries.length - 1;
+        }
+    }
+    // ── Focus ──────────────────────────────────────────────────────────────────
+    /** Returns the currently focused control, or null if no control has focus. */
+    getFocused() {
+        const entries = this.activeEntries();
+        const idx = this.getActiveFocusIndex();
+        return idx >= 0 ? entries[idx].control : null;
+    }
+    /** Moves focus to the given control if it belongs to the active context and is enabled. */
+    setFocus(control) {
+        const entries = this.activeEntries();
+        const idx = entries.findIndex(e => e.control === control);
+        if (idx === -1 || entries[idx].control.isDisabled())
+            return;
+        this.blurCurrent();
+        this.setActiveFocusIndex(idx);
+        control.setFocused(true);
+    }
+    // ── Dialog ─────────────────────────────────────────────────────────────────
+    /** Opens a modal dialog: blurs the current context, adds the dialog Window to
+     *  the Screen, and activates a new focus context for the provided controls.
+     *
+     *  @param dialog   - The Window to display (will be added to Screen via addChild).
+     *  @param controls - Array of { control, parents? } entries within the dialog.
+     *                    parents are Windows between the dialog and the control, used
+     *                    to compute absolute screen positions for mouse hit-testing. */
+    openDialog(dialog, controls) {
+        this.blurCurrent();
+        this.screen.addChild(dialog);
+        const entries = controls.map(({ control, parents = [] }) => ({
+            control,
+            absX: dialog.x + parents.reduce((acc, p) => acc + p.x, 0) + control.x,
+            absY: dialog.y + parents.reduce((acc, p) => acc + p.y, 0) + control.y,
+        }));
+        this.dialogStack.push({ dialog, entries, focusIndex: -1 });
+        this.initializeFocus();
+        this.renderFrame();
+    }
+    /** Closes the topmost modal dialog, removes it from the Screen, and restores
+     *  the previous focus context. */
+    closeDialog() {
+        const level = this.dialogStack.pop();
+        if (!level)
+            return;
+        // Blur whichever control had focus inside the dialog.
+        const idx = level.focusIndex;
+        if (idx >= 0 && idx < level.entries.length) {
+            level.entries[idx].control.setFocused(false);
+        }
+        this.screen.removeChild(level.dialog);
+        // Re-focus whatever was focused in the restored context.
+        const entries = this.activeEntries();
+        const fi = this.getActiveFocusIndex();
+        if (fi >= 0 && fi < entries.length) {
+            entries[fi].control.setFocused(true);
+        }
+        this.renderFrame();
+    }
+    // ── Lifecycle ──────────────────────────────────────────────────────────────
+    /** Starts the input loop: enables raw mode, optional mouse tracking, and renders
+     *  the initial frame. The method returns immediately; events are handled
+     *  asynchronously via stdin. */
+    run() {
+        if (this.running)
+            return;
+        this.running = true;
+        if (process.stdin.isTTY) {
+            process.stdin.setRawMode(true);
+        }
+        process.stdin.resume();
+        process.stdin.on('data', this.boundHandleInput);
+        process.once('SIGTERM', this.boundSigterm);
+        process.stdout.write('\x1b[?1049h'); // switch to alternate screen buffer
+        if (this.mouseEnabled) {
+            // Enable button-press tracking + SGR extended coordinates.
+            process.stdout.write('\x1b[?1000h\x1b[?1006h');
+        }
+        process.stdout.write('\x1b[?25l'); // hide cursor
+        this.initializeFocus();
+        this.renderFrame();
+    }
+    /** Stops the input loop, restores terminal state, and fires the onExit callback.
+     *  Safe to call even when the loop was not started (skips terminal teardown). */
+    stop() {
+        const wasRunning = this.running;
+        this.running = false;
+        if (wasRunning) {
+            process.stdin.off('data', this.boundHandleInput);
+            if (process.stdin.isTTY) {
+                process.stdin.setRawMode(false);
+            }
+            process.stdin.pause();
+            process.off('SIGTERM', this.boundSigterm);
+            if (this.mouseEnabled) {
+                process.stdout.write('\x1b[?1006l\x1b[?1000l');
+            }
+            process.stdout.write('\x1b[?25h'); // show cursor
+            process.stdout.write('\x1b[?1049l'); // restore normal screen buffer
+        }
+        this.onExit?.();
+    }
+    // ── Input handling ─────────────────────────────────────────────────────────
+    /** Processes a raw stdin Buffer. Exposed as public so tests can drive it directly
+     *  without needing a real TTY. Tab / Shift-Tab navigation works even before run()
+     *  because moveFocus() handles the "no current focus" case. Dispatching to a
+     *  control triggers lazy focus initialization so the key reaches the right target. */
+    handleInput(data) {
+        for (const key of parseKeys(data)) {
+            // Check for mouse event first (SGR sequence starting with \x1b[<).
+            if (this.mouseEnabled) {
+                const mouse = parseMouseEvent(key);
+                if (mouse) {
+                    this.onMouse?.(mouse);
+                    this.handleMouseEvent(mouse);
+                    continue;
+                }
+            }
+            this.onKey?.(key);
+            // Exit keys.
+            if (this.exitKeys.includes(key)) {
+                this.stop();
+                return;
+            }
+            // Focus navigation – moveFocus handles index -1 correctly.
+            if (key === '\t') {
+                this.moveFocus(1);
+                this.renderFrame();
+                continue;
+            }
+            if (key === '\x1b[Z') { // Shift-Tab
+                this.moveFocus(-1);
+                this.renderFrame();
+                continue;
+            }
+            // Dispatch to focused control.
+            // Lazy init here so Tab tests can rely on -1 start without double-move.
+            if (this.getActiveFocusIndex() < 0) {
+                this.initializeFocus();
+            }
+            const entries = this.activeEntries();
+            const fi = this.getActiveFocusIndex();
+            const entry = entries[fi];
+            if (entry?.control.handleKey) {
+                entry.control.handleKey(key);
+                this.renderFrame();
+            }
+        }
+    }
+    // ── Private helpers ────────────────────────────────────────────────────────
+    /** Returns the FocusEntry array for the active context (topmost dialog or main). */
+    activeEntries() {
+        if (this.dialogStack.length > 0) {
+            return this.dialogStack[this.dialogStack.length - 1].entries;
+        }
+        return this.mainEntries;
+    }
+    /** Returns the focus index for the active context. */
+    getActiveFocusIndex() {
+        if (this.dialogStack.length > 0) {
+            return this.dialogStack[this.dialogStack.length - 1].focusIndex;
+        }
+        return this.mainFocusIndex;
+    }
+    /** Sets the focus index for the active context. */
+    setActiveFocusIndex(index) {
+        if (this.dialogStack.length > 0) {
+            this.dialogStack[this.dialogStack.length - 1].focusIndex = index;
+        }
+        else {
+            this.mainFocusIndex = index;
+        }
+    }
+    /** Removes focus from the currently focused control without moving it elsewhere. */
+    blurCurrent() {
+        const entries = this.activeEntries();
+        const fi = this.getActiveFocusIndex();
+        if (fi >= 0 && fi < entries.length) {
+            entries[fi].control.setFocused(false);
+        }
+    }
+    /** Finds the first already-focused (or first non-disabled) control and focuses it. */
+    initializeFocus() {
+        const entries = this.activeEntries();
+        if (entries.length === 0)
+            return;
+        // Prefer a control that is already marked as focused.
+        for (let i = 0; i < entries.length; i++) {
+            if (entries[i].control.isFocused() && !entries[i].control.isDisabled()) {
+                this.setActiveFocusIndex(i);
+                return;
+            }
+        }
+        // Otherwise focus the first enabled control.
+        for (let i = 0; i < entries.length; i++) {
+            if (!entries[i].control.isDisabled()) {
+                this.setActiveFocusIndex(i);
+                entries[i].control.setFocused(true);
+                return;
+            }
+        }
+    }
+    /** Moves focus by delta (+1 for Tab, -1 for Shift-Tab), skipping disabled controls. */
+    moveFocus(delta) {
+        const entries = this.activeEntries();
+        if (entries.length === 0)
+            return;
+        const current = this.getActiveFocusIndex();
+        // Blur current control.
+        if (current >= 0 && current < entries.length) {
+            entries[current].control.setFocused(false);
+        }
+        const count = entries.length;
+        let next = current < 0 ? (delta > 0 ? -1 : count) : current;
+        let attempts = 0;
+        do {
+            next = ((next + delta) % count + count) % count;
+            attempts++;
+        } while (entries[next].control.isDisabled() && attempts <= count);
+        if (!entries[next].control.isDisabled()) {
+            this.setActiveFocusIndex(next);
+            entries[next].control.setFocused(true);
+        }
+    }
+    /** Handles a parsed mouse event: left click moves focus to the clicked control. */
+    handleMouseEvent(event) {
+        if (event.type !== 'press' || event.button !== 0)
+            return;
+        const entries = this.activeEntries();
+        for (let i = 0; i < entries.length; i++) {
+            const { control, absX, absY } = entries[i];
+            if (control.isDisabled())
+                continue;
+            const { width, height } = control.getSize();
+            if (event.x >= absX && event.x < absX + width &&
+                event.y >= absY && event.y < absY + height) {
+                this.blurCurrent();
+                this.setActiveFocusIndex(i);
+                control.setFocused(true);
+                this.renderFrame();
+                return;
+            }
+        }
+    }
+    /** Renders a frame to the screen. */
+    renderFrame() {
+        this.screen.render();
+    }
+}
+//# sourceMappingURL=WindowManager.mjs.map

package/dist/Screen/WindowManager.mjs.map

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

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

@@ -0,0 +1,29 @@
+import type { BarChartProperties, WindowProperties } from '../types.mjs';
+import { Window } from '../Window.mjs';
+/** A read-only vertical bar chart. Each bar fills from the bottom upward using block characters.
+ *  The last row of the inner area is reserved for single-character bar labels. */
+export declare class BarChart extends Window {
+    private data;
+    private labels;
+    private max;
+    private barWidth;
+    private barStyleId;
+    private labelStyleId;
+    /** Creates a BarChart from window properties and optional control-specific properties.
+     *  Uses the global StyleRegistry set by the Screen constructor. */
+    constructor(wp: WindowProperties, cp?: BarChartProperties);
+    /** Sets the data values. Call render() afterwards. */
+    setData(data: number[]): void;
+    /** Returns the current data values. */
+    getData(): number[];
+    /** Sets the bar labels. Call render() afterwards. */
+    setLabels(labels: string[]): void;
+    /** Returns the current bar labels. */
+    getLabels(): string[];
+    /** 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=BarChart.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"BarChart.d.mts","sourceRoot":"","sources":["../../../src/Screen/controls/BarChart.mts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,gBAAgB,EAAW,MAAM,cAAc,CAAC;AAClF,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAMvC;kFACkF;AAClF,qBAAa,QAAS,SAAQ,MAAM;IACnC,OAAO,CAAC,IAAI,CAAe;IAC3B,OAAO,CAAC,MAAM,CAAa;IAC3B,OAAO,CAAC,GAAG,CAA0B;IACrC,OAAO,CAAC,QAAQ,CAAS;IAEzB,OAAO,CAAC,UAAU,CAAY;IAC9B,OAAO,CAAC,YAAY,CAAU;IAE9B;uEACmE;gBAChD,EAAE,EAAE,gBAAgB,EAAE,EAAE,CAAC,EAAE,kBAAkB;IAahE,sDAAsD;IAC/C,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,IAAI;IAIpC,uCAAuC;IAChC,OAAO,IAAI,MAAM,EAAE;IAI1B,qDAAqD;IAC9C,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI;IAIxC,sCAAsC;IAC/B,SAAS,IAAI,MAAM,EAAE;IAI5B,8FAA8F;IACvF,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAI5C,iFAAiF;IAC1E,MAAM,IAAI,MAAM,GAAG,SAAS;IAInB,MAAM,IAAI,IAAI;CA6C9B"}

package/dist/Screen/controls/BarChart.mjs

@@ -0,0 +1,90 @@
+import { Window } from '../Window.mjs';
+import { getRegistry } from '../RegistryHolder.mjs';
+/** Character used for bar cells. */
+const CHAR_BAR = '█';
+/** A read-only vertical bar chart. Each bar fills from the bottom upward using block characters.
+ *  The last row of the inner area is reserved for single-character bar labels. */
+export class BarChart extends Window {
+    data;
+    labels;
+    max;
+    barWidth;
+    barStyleId;
+    labelStyleId;
+    /** Creates a BarChart 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.labels = cp?.labels ?? [];
+        this.max = cp?.max;
+        this.barWidth = Math.max(1, cp?.barWidth ?? 1);
+        const reg = getRegistry();
+        this.barStyleId = reg.register({ foreground: cp?.barColor ?? 75 });
+        this.labelStyleId = reg.register({ foreground: 245 });
+    }
+    /** Sets the data values. Call render() afterwards. */
+    setData(data) {
+        this.data = data;
+    }
+    /** Returns the current data values. */
+    getData() {
+        return this.data;
+    }
+    /** Sets the bar labels. Call render() afterwards. */
+    setLabels(labels) {
+        this.labels = labels;
+    }
+    /** Returns the current bar labels. */
+    getLabels() {
+        return this.labels;
+    }
+    /** Sets the maximum Y value. Pass undefined to derive from data. Call render() afterwards. */
+    setMax(max) {
+        this.max = max;
+    }
+    /** Returns the configured maximum Y value, or undefined if derived from data. */
+    getMax() {
+        return this.max;
+    }
+    render() {
+        this.clear();
+        const { width, height } = this.getInnerSize();
+        const { x: ox, y: oy } = this.getInnerOffset();
+        if (this.data.length === 0 || width < 1 || height < 2) {
+            super.render();
+            return;
+        }
+        const dataMax = this.max ?? Math.max(...this.data, 0);
+        const plotH = height - 1; // last row is label row
+        const barStep = this.barWidth + 1;
+        for (let i = 0; i < this.data.length; i++) {
+            const startCol = i * barStep;
+            if (startCol + this.barWidth > width)
+                break;
+            const norm = dataMax > 0 ? Math.min(1, Math.max(0, this.data[i] / dataMax)) : 0;
+            const filledRows = Math.round(norm * plotH);
+            // Draw bar cells
+            for (let row = 0; row < plotH; row++) {
+                const isFilled = row >= (plotH - filledRows);
+                for (let col = 0; col < this.barWidth; col++) {
+                    const absX = ox + startCol + col;
+                    if (absX - ox >= width)
+                        break;
+                    this.setCell(absX, oy + row, isFilled ? CHAR_BAR : ' ', isFilled ? this.barStyleId : 0);
+                }
+            }
+            // Draw label in the bottom row (truncated to barWidth)
+            const rawLabel = this.labels[i] ?? '';
+            for (let col = 0; col < this.barWidth; col++) {
+                const absX = ox + startCol + col;
+                if (absX - ox >= width)
+                    break;
+                const ch = col < rawLabel.length ? rawLabel[col] : ' ';
+                this.setCell(absX, oy + plotH, ch, this.labelStyleId);
+            }
+        }
+        super.render();
+    }
+}
+//# sourceMappingURL=BarChart.mjs.map

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

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

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

@@ -0,0 +1,16 @@
+import type { ButtonProperties, WindowProperties } from '../types.mjs';
+import { Window } from '../Window.mjs';
+/** A clickable button that renders a centred label inside a rounded border.
+ *  Visual state (normal / focused / disabled) is controlled via setters.
+ *  Appearance can be customised by overriding the built-in named styles via Screen.setBuiltinStyle(). */
+export declare class Button extends Window {
+    private onPress?;
+    /** Creates a Button from window properties and optional control-specific properties.
+     *  Uses the global StyleRegistry set by the Screen constructor. */
+    constructor(wp: WindowProperties, cp?: ButtonProperties);
+    /** Processes a key press; Enter or Space triggers the onPress callback. */
+    handleKey(key: string): void;
+    /** Rebuilds the button: writes centred label with appropriate style, then composites. */
+    render(): void;
+}
+//# sourceMappingURL=Button.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Button.d.mts","sourceRoot":"","sources":["../../../src/Screen/controls/Button.mts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AACvE,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAEvC;;yGAEyG;AACzG,qBAAa,MAAO,SAAQ,MAAM;IACjC,OAAO,CAAC,OAAO,CAAC,CAAa;IAE7B;uEACmE;gBAChD,EAAE,EAAE,gBAAgB,EAAE,EAAE,CAAC,EAAE,gBAAgB;IAS9D,2EAA2E;IACpE,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAOnC,yFAAyF;IACzE,MAAM,IAAI,IAAI;CAU9B"}

package/dist/Screen/controls/Button.mjs

@@ -0,0 +1,34 @@
+import { Window } from '../Window.mjs';
+/** A clickable button that renders a centred label inside a rounded border.
+ *  Visual state (normal / focused / disabled) is controlled via setters.
+ *  Appearance can be customised by overriding the built-in named styles via Screen.setBuiltinStyle(). */
+export class Button extends Window {
+    onPress;
+    /** Creates a Button 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: 'rounded' },
+        });
+        this.onPress = cp?.onPress;
+    }
+    /** Processes a key press; Enter or Space triggers the onPress callback. */
+    handleKey(key) {
+        if (this.disabled)
+            return;
+        if (key === '\r' || key === '\n' || key === ' ' || key === 'enter' || key === 'space') {
+            this.onPress?.();
+        }
+    }
+    /** Rebuilds the button: writes centred label with appropriate style, then composites. */
+    render() {
+        this.clear();
+        const { width, height } = this.getInnerSize();
+        const labelX = Math.max(0, Math.floor((width - this.label.length) / 2));
+        const labelY = Math.floor(height / 2);
+        this.writeText(this.label, { x: labelX, y: labelY });
+        super.render();
+    }
+}
+//# sourceMappingURL=Button.mjs.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Button.mjs","sourceRoot":"","sources":["../../../src/Screen/controls/Button.mts"],"names":[],"mappings":"AACA,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAEvC;;yGAEyG;AACzG,MAAM,OAAO,MAAO,SAAQ,MAAM;IACzB,OAAO,CAAc;IAE7B;uEACmE;IACnE,YAAmB,EAAoB,EAAE,EAAqB;QAC7D,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,SAAS,EAAE;SACrF,CAAC,CAAC;QAEH,IAAI,CAAC,OAAO,GAAG,EAAE,EAAE,OAAO,CAAC;IAC5B,CAAC;IAED,2EAA2E;IACpE,SAAS,CAAC,GAAW;QAC3B,IAAI,IAAI,CAAC,QAAQ;YAAE,OAAO;QAC1B,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,GAAG,IAAI,GAAG,KAAK,OAAO,IAAI,GAAG,KAAK,OAAO,EAAE,CAAC;YACvF,IAAI,CAAC,OAAO,EAAE,EAAE,CAAC;QAClB,CAAC;IACF,CAAC;IAED,yFAAyF;IACzE,MAAM;QACrB,IAAI,CAAC,KAAK,EAAE,CAAC;QAEb,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;QAC9C,MAAM,MAAM,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACxE,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACtC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,EAAE,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,CAAC;QAErD,KAAK,CAAC,MAAM,EAAE,CAAC;IAChB,CAAC;CACD"}

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

@@ -0,0 +1,23 @@
+import type { CheckboxProperties, WindowProperties } from '../types.mjs';
+import { Window } from '../Window.mjs';
+/** 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 declare class Checkbox extends Window {
+    private checked;
+    private onChange?;
+    private 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: WindowProperties, cp?: CheckboxProperties);
+    /** Toggles or sets the checked state. */
+    setChecked(checked: boolean): void;
+    /** Returns the current checked state. */
+    isChecked(): boolean;
+    /** Processes a key press; Space toggles the checked state and fires onChange. */
+    handleKey(key: string): void;
+    /** Rebuilds the checkbox: draws indicator and label with appropriate styles. */
+    render(): void;
+}
+//# sourceMappingURL=Checkbox.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Checkbox.d.mts","sourceRoot":"","sources":["../../../src/Screen/controls/Checkbox.mts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,gBAAgB,EAAW,MAAM,cAAc,CAAC;AAElF,OAAO,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAOvC;;uEAEuE;AACvE,qBAAa,QAAS,SAAQ,MAAM;IACnC,OAAO,CAAC,OAAO,CAAU;IACzB,OAAO,CAAC,QAAQ,CAAC,CAA6B;IAC9C,OAAO,CAAC,cAAc,CAAU;IAEhC;;uEAEmE;gBAChD,EAAE,EAAE,gBAAgB,EAAE,EAAE,CAAC,EAAE,kBAAkB;IAWhE,yCAAyC;IAClC,UAAU,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI;IAIzC,yCAAyC;IAClC,SAAS,IAAI,OAAO;IAI3B,iFAAiF;IAC1E,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI;IAQnC,gFAAgF;IAChE,MAAM,IAAI,IAAI;CAc9B"}