take4-console 0.15.0

package/dist/Screen/Region.mjs

@@ -0,0 +1,73 @@
+export class Region {
+    chars;
+    styleIds;
+    size;
+    /** Allocates a cell buffer for the given dimensions. All cells start with style ID 0 (empty). */
+    constructor(width, height) {
+        this.size = { width, height };
+        const len = width * height;
+        this.chars = Array(len).fill(' ');
+        this.styleIds = new Array(len).fill(0);
+    }
+    /** Returns the region dimensions (columns × rows). */
+    getSize() {
+        return { ...this.size };
+    }
+    /** Returns the style ID stored at (x, y). Throws RangeError if out of bounds. */
+    getStyleId(x, y) {
+        this.assertBounds(x, y);
+        return this.styleIds[this.index(x, y)];
+    }
+    /** Sets only the character at (x, y) without modifying the style ID. Throws RangeError if out of bounds. */
+    setChar(x, y, char) {
+        this.assertBounds(x, y);
+        this.chars[this.index(x, y)] = char;
+    }
+    /** Sets the character and style ID at (x, y). Throws RangeError if out of bounds. */
+    setCell(x, y, char, styleId = 0) {
+        this.assertBounds(x, y);
+        const i = this.index(x, y);
+        this.chars[i] = char;
+        this.styleIds[i] = styleId;
+    }
+    /** Replaces only the style ID at (x, y) without changing the character. Throws RangeError if out of bounds. */
+    setStyleId(x, y, styleId) {
+        this.assertBounds(x, y);
+        this.styleIds[this.index(x, y)] = styleId;
+    }
+    /** Resets every cell to a blank space with style ID 0. */
+    clear() {
+        const len = this.chars.length;
+        for (let i = 0; i < len; i++) {
+            this.chars[i] = ' ';
+            this.styleIds[i] = 0;
+        }
+    }
+    /** Fills every cell with the given character and style ID. */
+    fill(char, styleId = 0) {
+        const len = this.chars.length;
+        for (let i = 0; i < len; i++) {
+            this.chars[i] = char;
+            this.styleIds[i] = styleId;
+        }
+    }
+    /** Returns a readonly view of the character buffer for rendering. */
+    getChars() {
+        return this.chars;
+    }
+    /** Returns a readonly view of the style-ID buffer for rendering. */
+    getStyleIds() {
+        return this.styleIds;
+    }
+    /** Returns the flat buffer index for the given (x, y) coordinates. */
+    index(x, y) {
+        return y * this.size.width + x;
+    }
+    /** Throws RangeError if the coordinates (x, y) are outside the region boundaries. */
+    assertBounds(x, y) {
+        if (x < 0 || x >= this.size.width || y < 0 || y >= this.size.height) {
+            throw new RangeError(`Cell (${x}, ${y}) is out of bounds for region ${this.size.width}×${this.size.height}`);
+        }
+    }
+}
+//# sourceMappingURL=Region.mjs.map

package/dist/Screen/Region.mjs.map

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

package/dist/Screen/RegistryHolder.d.mts

@@ -0,0 +1,6 @@
+import { StyleRegistry } from './StyleRegistry.mjs';
+/** Returns the currently active StyleRegistry. */
+export declare function getRegistry(): StyleRegistry;
+/** Sets the active StyleRegistry. Called by the Screen constructor. */
+export declare function setRegistry(registry: StyleRegistry): void;
+//# sourceMappingURL=RegistryHolder.d.mts.map

package/dist/Screen/RegistryHolder.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"RegistryHolder.d.mts","sourceRoot":"","sources":["../../src/Screen/RegistryHolder.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAOpD,kDAAkD;AAClD,wBAAgB,WAAW,IAAI,aAAa,CAE3C;AAED,uEAAuE;AACvE,wBAAgB,WAAW,CAAC,QAAQ,EAAE,aAAa,GAAG,IAAI,CAEzD"}

package/dist/Screen/RegistryHolder.mjs

@@ -0,0 +1,14 @@
+import { StyleRegistry } from './StyleRegistry.mjs';
+/** Module-level singleton holding the active StyleRegistry.
+ *  Initialized with an empty registry so Window and controls work
+ *  in isolation (e.g. in tests) before any Screen is constructed. */
+let activeRegistry = new StyleRegistry();
+/** Returns the currently active StyleRegistry. */
+export function getRegistry() {
+    return activeRegistry;
+}
+/** Sets the active StyleRegistry. Called by the Screen constructor. */
+export function setRegistry(registry) {
+    activeRegistry = registry;
+}
+//# sourceMappingURL=RegistryHolder.mjs.map

package/dist/Screen/RegistryHolder.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"RegistryHolder.mjs","sourceRoot":"","sources":["../../src/Screen/RegistryHolder.mts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD;;qEAEqE;AACrE,IAAI,cAAc,GAAkB,IAAI,aAAa,EAAE,CAAC;AAExD,kDAAkD;AAClD,MAAM,UAAU,WAAW;IAC1B,OAAO,cAAc,CAAC;AACvB,CAAC;AAED,uEAAuE;AACvE,MAAM,UAAU,WAAW,CAAC,QAAuB;IAClD,cAAc,GAAG,QAAQ,CAAC;AAC3B,CAAC"}

package/dist/Screen/Screen.d.mts

@@ -0,0 +1,25 @@
+import type { CellAttributes, StyleId } from './types.mjs';
+import { StyleRegistry } from './StyleRegistry.mjs';
+import { Window } from './Window.mjs';
+export declare class Screen extends Window {
+    /** Initializes the root window sized to the current terminal dimensions.
+     *  Creates a fresh StyleRegistry (with built-in styles pre-registered)
+     *  and installs it as the global singleton. */
+    constructor();
+    /** Registers a CellAttributes object in the global style registry and returns its stable ID. */
+    registerStyle(attrs: CellAttributes): StyleId;
+    /** Returns the global StyleRegistry. */
+    getStyleRegistry(): StyleRegistry;
+    /** Overrides a built-in named style (or registers any named style) and returns its new ID.
+     *  Controls will use the updated style on their next render() call. */
+    setBuiltinStyle(name: string, attrs: CellAttributes): StyleId;
+    /**
+     * Composites the full window tree, then writes the result to stdout as a single ANSI string.
+     */
+    render(): void;
+    /** Converts cell attributes into an ANSI escape sequence (always resets first). */
+    private buildAnsiSequence;
+    /** Parses a hex color string (#rrggbb or #rgb) into [r, g, b] components. */
+    private hexToRgb;
+}
+//# sourceMappingURL=Screen.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Screen.d.mts","sourceRoot":"","sources":["../../src/Screen/Screen.mts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AAItC,qBAAa,MAAO,SAAQ,MAAM;IACjC;;mDAE+C;;IAS/C,gGAAgG;IACzF,aAAa,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO;IAIpD,wCAAwC;IACjC,gBAAgB,IAAI,aAAa;IAIxC;2EACuE;IAChE,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,OAAO;IAIpE;;OAEG;IACa,MAAM,IAAI,IAAI;IAe9B,mFAAmF;IACnF,OAAO,CAAC,iBAAiB;IAgCzB,6EAA6E;IAC7E,OAAO,CAAC,QAAQ;CAehB"}

package/dist/Screen/Screen.mjs

@@ -0,0 +1,100 @@
+import { StyleRegistry } from './StyleRegistry.mjs';
+import { getRegistry, setRegistry } from './RegistryHolder.mjs';
+import { Window } from './Window.mjs';
+import { Pos } from './Pos.mjs';
+import { Size } from './Size.mjs';
+export class Screen extends Window {
+    /** Initializes the root window sized to the current terminal dimensions.
+     *  Creates a fresh StyleRegistry (with built-in styles pre-registered)
+     *  and installs it as the global singleton. */
+    constructor() {
+        const width = process.stdout.columns ?? 80;
+        const height = process.stdout.rows ?? 24;
+        const registry = new StyleRegistry();
+        setRegistry(registry);
+        super({ pos: Pos.topLeft(), size: new Size(width, height), background: 0 });
+    }
+    /** Registers a CellAttributes object in the global style registry and returns its stable ID. */
+    registerStyle(attrs) {
+        return getRegistry().register(attrs);
+    }
+    /** Returns the global StyleRegistry. */
+    getStyleRegistry() {
+        return getRegistry();
+    }
+    /** Overrides a built-in named style (or registers any named style) and returns its new ID.
+     *  Controls will use the updated style on their next render() call. */
+    setBuiltinStyle(name, attrs) {
+        return getRegistry().registerNamed(name, attrs);
+    }
+    /**
+     * Composites the full window tree, then writes the result to stdout as a single ANSI string.
+     */
+    render() {
+        super.render();
+        const reg = getRegistry();
+        const chars = this.region.getChars();
+        const styleIds = this.region.getStyleIds();
+        let output = '\x1b[H';
+        for (let i = 0; i < chars.length; i++) {
+            output += this.buildAnsiSequence(reg.get(styleIds[i]));
+            output += chars[i];
+        }
+        output += '\x1b[0m';
+        process.stdout.write(output);
+    }
+    /** Converts cell attributes into an ANSI escape sequence (always resets first). */
+    buildAnsiSequence(attrs) {
+        const codes = [0];
+        if (attrs.bold)
+            codes.push(1);
+        if (attrs.dim)
+            codes.push(2);
+        if (attrs.italic)
+            codes.push(3);
+        if (attrs.underline)
+            codes.push(4);
+        if (attrs.blink)
+            codes.push(5);
+        if (attrs.inverse)
+            codes.push(7);
+        if (attrs.strikethrough)
+            codes.push(9);
+        if (attrs.foreground !== undefined) {
+            if (typeof attrs.foreground === 'number') {
+                codes.push(38, 5, attrs.foreground);
+            }
+            else {
+                const [r, g, b] = this.hexToRgb(attrs.foreground);
+                codes.push(38, 2, r, g, b);
+            }
+        }
+        if (attrs.background !== undefined) {
+            if (typeof attrs.background === 'number') {
+                codes.push(48, 5, attrs.background);
+            }
+            else {
+                const [r, g, b] = this.hexToRgb(attrs.background);
+                codes.push(48, 2, r, g, b);
+            }
+        }
+        return `\x1b[${codes.join(';')}m`;
+    }
+    /** Parses a hex color string (#rrggbb or #rgb) into [r, g, b] components. */
+    hexToRgb(hex) {
+        const clean = hex.replace('#', '');
+        if (clean.length === 3) {
+            return [
+                parseInt(clean[0] + clean[0], 16),
+                parseInt(clean[1] + clean[1], 16),
+                parseInt(clean[2] + clean[2], 16),
+            ];
+        }
+        return [
+            parseInt(clean.slice(0, 2), 16),
+            parseInt(clean.slice(2, 4), 16),
+            parseInt(clean.slice(4, 6), 16),
+        ];
+    }
+}
+//# sourceMappingURL=Screen.mjs.map

package/dist/Screen/Screen.mjs.map

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

package/dist/Screen/Size.d.mts

@@ -0,0 +1,23 @@
+import { Pct } from './Pos.mjs';
+/** Encodes window dimensions. Supports absolute pixel values and percentage of parent size. */
+export declare class Size {
+    private wSpec;
+    private hSpec;
+    /** Creates a size from width and height values.
+     *  Pass a plain number for absolute pixels, or a Pct instance for a percentage of the parent. */
+    constructor(w: number | Pct, h: number | Pct);
+    /** Creates a size that fills 100% of the parent in both dimensions. */
+    static fill(): Size;
+    /** Creates a size that fills 100% of the parent's width; height is absolute or percentage. */
+    static fillWidth(h: number | Pct): Size;
+    /** Creates a size that fills 100% of the parent's height; width is absolute or percentage. */
+    static fillHeight(w: number | Pct): Size;
+    /** Returns true when both dimensions are absolute pixel values (no parent size needed). */
+    isAbsolute(): boolean;
+    /** Resolves this size to pixel dimensions given the parent's dimensions. */
+    resolve(parentW: number, parentH: number): {
+        w: number;
+        h: number;
+    };
+}
+//# sourceMappingURL=Size.d.mts.map

package/dist/Screen/Size.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Size.d.mts","sourceRoot":"","sources":["../../src/Screen/Size.mts"],"names":[],"mappings":"AACA,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAchC,+FAA+F;AAC/F,qBAAa,IAAI;IAChB,OAAO,CAAC,KAAK,CAAU;IACvB,OAAO,CAAC,KAAK,CAAU;IAEvB;qGACiG;gBAC9E,CAAC,EAAE,MAAM,GAAG,GAAG,EAAE,CAAC,EAAE,MAAM,GAAG,GAAG;IAKnD,uEAAuE;WACzD,IAAI,IAAI,IAAI;IAI1B,8FAA8F;WAChF,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,GAAG,GAAG,IAAI;IAI9C,8FAA8F;WAChF,UAAU,CAAC,CAAC,EAAE,MAAM,GAAG,GAAG,GAAG,IAAI;IAI/C,2FAA2F;IACpF,UAAU,IAAI,OAAO;IAI5B,4EAA4E;IACrE,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE;CAM1E"}

package/dist/Screen/Size.mjs

@@ -0,0 +1,48 @@
+import { Pct } from './Pos.mjs';
+/** Converts a user-supplied dimension value to an internal DimSpec. */
+function toDimSpec(v) {
+    if (v instanceof Pct)
+        return { mode: 'pct', value: v.value };
+    return { mode: 'abs', value: v };
+}
+/** Resolves a single dimension spec to a pixel value. */
+function resolveDim(spec, parentSize) {
+    if (spec.mode === 'pct')
+        return Math.floor(parentSize * spec.value / 100);
+    return spec.value;
+}
+/** Encodes window dimensions. Supports absolute pixel values and percentage of parent size. */
+export class Size {
+    wSpec;
+    hSpec;
+    /** Creates a size from width and height values.
+     *  Pass a plain number for absolute pixels, or a Pct instance for a percentage of the parent. */
+    constructor(w, h) {
+        this.wSpec = toDimSpec(w);
+        this.hSpec = toDimSpec(h);
+    }
+    /** Creates a size that fills 100% of the parent in both dimensions. */
+    static fill() {
+        return new Size(new Pct(100), new Pct(100));
+    }
+    /** Creates a size that fills 100% of the parent's width; height is absolute or percentage. */
+    static fillWidth(h) {
+        return new Size(new Pct(100), h);
+    }
+    /** Creates a size that fills 100% of the parent's height; width is absolute or percentage. */
+    static fillHeight(w) {
+        return new Size(w, new Pct(100));
+    }
+    /** Returns true when both dimensions are absolute pixel values (no parent size needed). */
+    isAbsolute() {
+        return this.wSpec.mode === 'abs' && this.hSpec.mode === 'abs';
+    }
+    /** Resolves this size to pixel dimensions given the parent's dimensions. */
+    resolve(parentW, parentH) {
+        return {
+            w: resolveDim(this.wSpec, parentW),
+            h: resolveDim(this.hSpec, parentH),
+        };
+    }
+}
+//# sourceMappingURL=Size.mjs.map

package/dist/Screen/Size.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"Size.mjs","sourceRoot":"","sources":["../../src/Screen/Size.mts"],"names":[],"mappings":"AACA,OAAO,EAAE,GAAG,EAAE,MAAM,WAAW,CAAC;AAEhC,uEAAuE;AACvE,SAAS,SAAS,CAAC,CAAe;IACjC,IAAI,CAAC,YAAY,GAAG;QAAE,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,KAAK,EAAE,CAAC;IAC7D,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC;AAClC,CAAC;AAED,yDAAyD;AACzD,SAAS,UAAU,CAAC,IAAa,EAAE,UAAkB;IACpD,IAAI,IAAI,CAAC,IAAI,KAAK,KAAK;QAAE,OAAO,IAAI,CAAC,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC,KAAK,GAAG,GAAG,CAAC,CAAC;IAC1E,OAAO,IAAI,CAAC,KAAK,CAAC;AACnB,CAAC;AAED,+FAA+F;AAC/F,MAAM,OAAO,IAAI;IACR,KAAK,CAAU;IACf,KAAK,CAAU;IAEvB;qGACiG;IACjG,YAAmB,CAAe,EAAE,CAAe;QAClD,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;QAC1B,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC,CAAC,CAAC,CAAC;IAC3B,CAAC;IAED,uEAAuE;IAChE,MAAM,CAAC,IAAI;QACjB,OAAO,IAAI,IAAI,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,EAAE,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IAC7C,CAAC;IAED,8FAA8F;IACvF,MAAM,CAAC,SAAS,CAAC,CAAe;QACtC,OAAO,IAAI,IAAI,CAAC,IAAI,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;IAClC,CAAC;IAED,8FAA8F;IACvF,MAAM,CAAC,UAAU,CAAC,CAAe;QACvC,OAAO,IAAI,IAAI,CAAC,CAAC,EAAE,IAAI,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC;IAClC,CAAC;IAED,2FAA2F;IACpF,UAAU;QAChB,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC;IAC/D,CAAC;IAED,4EAA4E;IACrE,OAAO,CAAC,OAAe,EAAE,OAAe;QAC9C,OAAO;YACN,CAAC,EAAE,UAAU,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC;YAClC,CAAC,EAAE,UAAU,CAAC,IAAI,CAAC,KAAK,EAAE,OAAO,CAAC;SAClC,CAAC;IACH,CAAC;CACD"}

package/dist/Screen/StyleRegistry.d.mts

@@ -0,0 +1,32 @@
+import type { CellAttributes, StyleId, Color } from './types.mjs';
+/** Central registry that maps integer style IDs to CellAttributes objects.
+ *  Identical attribute sets always map to the same ID (deduplication). */
+export declare class StyleRegistry {
+    /** Styles indexed by ID. Index 0 is always the empty style {}. */
+    private styles;
+    /** Serialized key → ID, for deduplication. */
+    private index;
+    /** Name → ID map for built-in and user-defined named styles. */
+    private named;
+    /** Creates a new StyleRegistry with built-in named styles pre-registered. */
+    constructor();
+    /** Registers a CellAttributes object and returns its stable ID.
+     *  If an identical style was registered before, returns the existing ID. */
+    register(attrs: CellAttributes): StyleId;
+    /** Registers a CellAttributes object under a given name and returns its stable ID.
+     *  Calling with the same name again replaces the previous association. */
+    registerNamed(name: string, attrs: CellAttributes): StyleId;
+    /** Returns the StyleId associated with the given name, or undefined if not registered. */
+    getNamed(name: string): StyleId | undefined;
+    /** Returns the foreground Color of a named style, or the fallback value if the name is
+     *  not registered or the style has no foreground attribute. */
+    getNamedForeground(name: string, fallback: Color): Color;
+    /** Returns the CellAttributes for the given style ID. Returns {} for unknown IDs. */
+    get(id: StyleId): CellAttributes;
+    /** Merges two styles and returns the ID of the result.
+     *  The `over` style takes precedence over `base` for conflicting keys. */
+    merge(baseId: StyleId, overId: StyleId): StyleId;
+    /** Produces a deterministic JSON key for deduplication. */
+    private makeKey;
+}
+//# sourceMappingURL=StyleRegistry.d.mts.map

package/dist/Screen/StyleRegistry.d.mts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StyleRegistry.d.mts","sourceRoot":"","sources":["../../src/Screen/StyleRegistry.mts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAclE;0EAC0E;AAC1E,qBAAa,aAAa;IACzB,kEAAkE;IAClE,OAAO,CAAC,MAAM,CAA0B;IACxC,8CAA8C;IAC9C,OAAO,CAAC,KAAK,CAA8C;IAC3D,gEAAgE;IAChE,OAAO,CAAC,KAAK,CAAmC;IAEhD,6EAA6E;;IAc7E;gFAC4E;IACrE,QAAQ,CAAC,KAAK,EAAE,cAAc,GAAG,OAAO;IAU/C;8EAC0E;IACnE,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,cAAc,GAAG,OAAO;IAMlE,0FAA0F;IACnF,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,SAAS;IAIlD;mEAC+D;IACxD,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,KAAK,GAAG,KAAK;IAM/D,qFAAqF;IAC9E,GAAG,CAAC,EAAE,EAAE,OAAO,GAAG,cAAc;IAIvC;8EAC0E;IACnE,KAAK,CAAC,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,GAAG,OAAO;IAMvD,2DAA2D;IAC3D,OAAO,CAAC,OAAO;CASf"}

package/dist/Screen/StyleRegistry.mjs

@@ -0,0 +1,80 @@
+import { BUILTIN_WINDOW_BG, BUILTIN_BORDER, BUILTIN_BORDER_FOCUSED, BUILTIN_BORDER_DISABLED, BUILTIN_TEXT, BUILTIN_TEXT_FOCUSED, BUILTIN_TEXT_DISABLED, BUILTIN_TEXT_PLACEHOLDER, BUILTIN_TEXT_CHECKED, BUILTIN_CURSOR, } from './types.mjs';
+/** Central registry that maps integer style IDs to CellAttributes objects.
+ *  Identical attribute sets always map to the same ID (deduplication). */
+export class StyleRegistry {
+    /** Styles indexed by ID. Index 0 is always the empty style {}. */
+    styles = [{}];
+    /** Serialized key → ID, for deduplication. */
+    index = new Map([['{}', 0]]);
+    /** Name → ID map for built-in and user-defined named styles. */
+    named = new Map();
+    /** Creates a new StyleRegistry with built-in named styles pre-registered. */
+    constructor() {
+        this.registerNamed(BUILTIN_WINDOW_BG, { background: 237 });
+        this.registerNamed(BUILTIN_BORDER, { foreground: 240 });
+        this.registerNamed(BUILTIN_BORDER_FOCUSED, { foreground: 75 });
+        this.registerNamed(BUILTIN_BORDER_DISABLED, { foreground: 238 });
+        this.registerNamed(BUILTIN_TEXT, { foreground: 252 });
+        this.registerNamed(BUILTIN_TEXT_FOCUSED, { foreground: 255, bold: true });
+        this.registerNamed(BUILTIN_TEXT_DISABLED, { foreground: 245, dim: true });
+        this.registerNamed(BUILTIN_TEXT_PLACEHOLDER, { foreground: 242, italic: true });
+        this.registerNamed(BUILTIN_TEXT_CHECKED, { foreground: 76, bold: true });
+        this.registerNamed(BUILTIN_CURSOR, { inverse: true });
+    }
+    /** Registers a CellAttributes object and returns its stable ID.
+     *  If an identical style was registered before, returns the existing ID. */
+    register(attrs) {
+        const key = this.makeKey(attrs);
+        const existing = this.index.get(key);
+        if (existing !== undefined)
+            return existing;
+        const id = this.styles.length;
+        this.styles.push({ ...attrs });
+        this.index.set(key, id);
+        return id;
+    }
+    /** Registers a CellAttributes object under a given name and returns its stable ID.
+     *  Calling with the same name again replaces the previous association. */
+    registerNamed(name, attrs) {
+        const id = this.register(attrs);
+        this.named.set(name, id);
+        return id;
+    }
+    /** Returns the StyleId associated with the given name, or undefined if not registered. */
+    getNamed(name) {
+        return this.named.get(name);
+    }
+    /** Returns the foreground Color of a named style, or the fallback value if the name is
+     *  not registered or the style has no foreground attribute. */
+    getNamedForeground(name, fallback) {
+        const id = this.named.get(name);
+        if (id === undefined)
+            return fallback;
+        return this.styles[id]?.foreground ?? fallback;
+    }
+    /** Returns the CellAttributes for the given style ID. Returns {} for unknown IDs. */
+    get(id) {
+        return this.styles[id] ?? {};
+    }
+    /** Merges two styles and returns the ID of the result.
+     *  The `over` style takes precedence over `base` for conflicting keys. */
+    merge(baseId, overId) {
+        if (overId === 0)
+            return baseId;
+        if (baseId === 0)
+            return overId;
+        return this.register({ ...this.get(baseId), ...this.get(overId) });
+    }
+    /** Produces a deterministic JSON key for deduplication. */
+    makeKey(attrs) {
+        const keys = Object.keys(attrs).sort();
+        if (keys.length === 0)
+            return '{}';
+        const sorted = {};
+        for (const k of keys) {
+            sorted[k] = attrs[k];
+        }
+        return JSON.stringify(sorted);
+    }
+}
+//# sourceMappingURL=StyleRegistry.mjs.map

package/dist/Screen/StyleRegistry.mjs.map

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

package/dist/Screen/Window.d.mts

@@ -0,0 +1,121 @@
+import type { Cell, StyleId, WindowBorder, WindowProperties, WriteTextOptions, TerminalSize } from './types.mjs';
+import { Region } from './Region.mjs';
+import { StyleRegistry } from './StyleRegistry.mjs';
+export declare class Window {
+    x: number;
+    y: number;
+    /** Composited display buffer – rebuilt by render(); read by blitChild and Screen. */
+    protected region: Region;
+    /** Global style registry shared by all windows and controls. */
+    protected registry: StyleRegistry;
+    protected children: Window[];
+    /** Whether this window currently has keyboard focus. */
+    protected focused: boolean;
+    /** Whether this window is disabled (inactive and visually dimmed). */
+    protected disabled: boolean;
+    /** Optional text label displayed by the control. */
+    protected label: string;
+    /** Style ID used for normal (default) text rendering. Initialized from BUILTIN_TEXT. */
+    protected normalStyleId: StyleId;
+    /** Style ID used when the control is focused. Initialized from BUILTIN_TEXT_FOCUSED. */
+    protected focusedStyleId: StyleId;
+    /** Style ID used when the control is disabled. Initialized from BUILTIN_TEXT_DISABLED. */
+    protected disabledStyleId: StyleId;
+    /** User-written content – survives render() cycles. */
+    private content;
+    private background;
+    private border;
+    /** True when the original border config included an explicit color; prevents auto-sync. */
+    private borderColorExplicit;
+    private active;
+    private posSpec;
+    private sizeSpec;
+    /** Creates a window from the given properties.
+     *  For percentage-based sizes, call addChild() before writing content to the window.
+     *  Uses the global StyleRegistry set by the Screen constructor. */
+    constructor(wp: WindowProperties);
+    /** Returns the window dimensions (columns × rows). */
+    getSize(): TerminalSize;
+    /** Returns the number of cells consumed by decorations on each edge. */
+    private borderInset;
+    /** Returns the top-left offset of the content area, accounting for decorations such as borders. */
+    getInnerOffset(): {
+        x: number;
+        y: number;
+    };
+    /** Returns the dimensions of the content area, accounting for decorations such as borders. */
+    getInnerSize(): TerminalSize;
+    /** Sets the active state. Affects border and background appearance on next render(). */
+    setActive(active: boolean): void;
+    /** Sets the focused state. Controls use this to change visual appearance on focus. */
+    setFocused(focused: boolean): void;
+    /** Returns whether this window currently has keyboard focus. */
+    isFocused(): boolean;
+    /** Sets the disabled state and deactivates the window when disabled. */
+    setDisabled(disabled: boolean): void;
+    /** Returns whether this window is currently disabled. */
+    isDisabled(): boolean;
+    /** Sets the label text displayed by the control. */
+    setLabel(label: string): void;
+    /** Returns the current label text. */
+    getLabel(): string;
+    /** Updates the border configuration. Effective on the next render() call.
+     *  Intended for use by subclasses that need dynamic decoration (e.g. focus-state colour). */
+    protected updateBorder(border: WindowBorder | boolean | undefined): void;
+    /** Recomputes the border color from the current focused/disabled state.
+     *  Called automatically at the start of render() so subclasses never need to do it manually.
+     *  Only updates the color when no explicit color was provided in the original border config. */
+    private syncBorderColor;
+    /** Adds a child window. If the child uses percentage-based sizes they are resolved immediately
+     *  against this window's inner dimensions (excluding decorations such as borders).
+     *  Position is resolved relative to the inner area and stored on child.x/y. */
+    addChild(child: Window): void;
+    /** Returns a resolved Cell (char + CellAttributes) at (x, y) from the display buffer.
+     *  Throws RangeError if out of bounds. */
+    getCell(x: number, y: number): Cell;
+    /** Sets only the character at (x, y) without modifying the style ID. Throws RangeError if out of bounds. */
+    setChar(x: number, y: number, char: string): void;
+    /** Sets the character and style ID at (x, y). Throws RangeError if out of bounds. */
+    setCell(x: number, y: number, char: string, styleId?: StyleId): void;
+    /** Merges the given style ID onto the existing style at (x, y) without changing the character.
+     *  Throws RangeError if out of bounds. */
+    mergeStyle(x: number, y: number, styleId: StyleId): void;
+    /** Resets every cell to a blank space with style ID 0. */
+    clear(): void;
+    /** Fills every cell with the given character and style ID. */
+    fill(char: string, styleId?: StyleId): void;
+    /** Writes text into the window's content area starting at (x, y) (default 0, 0).
+     *  Coordinates are relative to the inner content area (i.e. decorations such as borders are excluded).
+     *  Newline characters move to the next row, resetting x to startX.
+     *  Characters outside the inner bounds are silently clipped.
+     *  When no style is provided, automatically picks disabledStyleId, focusedStyleId, or normalStyleId
+     *  based on the current disabled/focused state. */
+    writeText(text: string, options?: WriteTextOptions): void;
+    /**
+     * Builds the display buffer: background → user content → border → children.
+     * The result is stored in region and used by blitChild / Screen.render().
+     */
+    render(): void;
+    /** Fills the display buffer with the background style. When inactive, adds dim to every cell.
+     *  No-op when background is 0 (transparent). */
+    private paintBackground;
+    /** Overlays user-written content onto the display buffer, merging with any background already set. */
+    private blitContent;
+    /** Draws border characters on the display buffer edges. When inactive, adds dim to border cells. */
+    private paintBorder;
+    /** Copies a child's display buffer onto this window's display buffer, clipping to this window's bounds.
+     *  Styles are transferred from the child's registry into this window's registry.
+     *  Position is re-resolved from the child's Pos spec relative to the inner content area on every render. */
+    private blitChild;
+    /** Removes a previously added child window. No-op if the child is not found. */
+    removeChild(child: Window): void;
+    /** Replaces both internal regions with new ones of the given dimensions,
+     *  then re-resolves sizes and positions of all direct children against the updated inner area. */
+    private resizeRegions;
+    /** Re-resolves sizes and absolute positions for every direct child against the current inner area.
+     *  Called after this window is resized so that percentage-based children get correct dimensions. */
+    private reflowChildren;
+    /** Returns the flat index for (x, y) in the region buffer (used by getCell). */
+    private flatIndex;
+}
+//# sourceMappingURL=Window.d.mts.map

package/dist/Screen/Window.d.mts.map

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