take4-console 0.15.0

package/dist/Screen/InterfaceBuilder.d.mts

@@ -0,0 +1,43 @@
+import { Window } from './Window.mjs';
+import { Screen } from './Screen.mjs';
+import { WindowManager } from './WindowManager.mjs';
+/** Builds a window hierarchy from a YAML description.
+ *
+ * Usage:
+ *   1. Create an InterfaceBuilder and call registerCallback() for any onPress/onChange IDs.
+ *   2. Call build(yamlText, screen) or buildFromFile(path, screen).
+ *   3. Optionally pass a WindowManager to automatically register all focusable controls.
+ *   4. The returned Map<string, Window> gives access to windows by their YAML id.
+ *
+ * YAML schema:
+ *   windows:
+ *     - id: myBtn
+ *       type: button          # window | button | textbox | textarea | checkbox | radio
+ *       pos: center           # {x, y} | center | topLeft | topRight | bottomLeft | bottomRight | {preset: top|left|right|bottom, offset?}
+ *       size: { width: 20, height: 3 }  # {width, height} | fill | {fillWidth: N} | {fillHeight: N}
+ *       label: "Click me"
+ *       onPress: my_callback
+ *       children:
+ *         - ...
+ */
+export declare class InterfaceBuilder {
+    private callbacks;
+    /** Creates an InterfaceBuilder with an empty callback registry. */
+    constructor();
+    /** Registers a named callback for use with onPress or onChange in YAML definitions. */
+    registerCallback(id: string, fn: (...args: unknown[]) => void): void;
+    /** Builds the UI from a YAML string, adds all top-level windows to Screen,
+     *  and registers focusable controls with WindowManager if provided.
+     *  Styles defined in the `styles:` section are registered before any windows are built.
+     *  Returns a map of all windows and controls keyed by their YAML id. */
+    build(yamlText: string, screen: Screen, wm?: WindowManager): Map<string, Window>;
+    /** Builds the UI from a YAML file. See build() for details. */
+    buildFromFile(filePath: string, screen: Screen, wm?: WindowManager): Promise<Map<string, Window>>;
+    /** Recursively creates a single widget and all of its children from a YamlWindowDef.
+     *  Static content strings are collected into contentWrites instead of being written
+     *  immediately, so they are applied after all sizes are resolved. */
+    private buildNode;
+    /** Returns a parsed Size from the definition or throws if size is missing. */
+    private requireSize;
+}
+//# sourceMappingURL=InterfaceBuilder.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"InterfaceBuilder.d.mts","sourceRoot":"","sources":["../../src/Screen/InterfaceBuilder.mts"],"names":[],"mappings":"AAYA,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,MAAM,EAAE,MAAM,cAAc,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAsFpD;;;;;;;;;;;;;;;;;;GAkBG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,SAAS,CAA4C;IAE7D,mEAAmE;;IAKnE,uFAAuF;IAChF,gBAAgB,CAAC,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,KAAK,IAAI,GAAG,IAAI;IAI3E;;;4EAGwE;IACjE,KAAK,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,aAAa,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC;IAmCvF,+DAA+D;IAClD,aAAa,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAO9G;;yEAEqE;IACrE,OAAO,CAAC,SAAS;IAoNjB,8EAA8E;IAC9E,OAAO,CAAC,WAAW;CAOpB"}

package/dist/Screen/InterfaceBuilder.mjs

@@ -0,0 +1,355 @@
+import { parse } from 'yaml';
+import { readFile } from 'node:fs/promises';
+import { Window } from './Window.mjs';
+import { Pos, pct } from './Pos.mjs';
+import { Size } from './Size.mjs';
+import { getRegistry } from './RegistryHolder.mjs';
+import { Button } from './controls/Button.mjs';
+import { TextBox } from './controls/TextBox.mjs';
+import { TextArea } from './controls/TextArea.mjs';
+import { Checkbox } from './controls/Checkbox.mjs';
+import { Radio } from './controls/Radio.mjs';
+import { StatusLED } from './controls/StatusLED.mjs';
+import { ProgressBar } from './controls/ProgressBar.mjs';
+import { ProgressBarV } from './controls/ProgressBarV.mjs';
+import { LineChart } from './controls/LineChart.mjs';
+import { BarChart } from './controls/BarChart.mjs';
+import { ListBox } from './controls/ListBox.mjs';
+import { Tabs } from './controls/Tabs.mjs';
+import { Sparkline } from './controls/Sparkline.mjs';
+import { Spinner } from './controls/Spinner.mjs';
+/** Converts a YamlAxisValue ("N%", or a number) to a number or Pct instance. */
+function parseAxisValue(v) {
+    if (typeof v === 'string') {
+        const m = v.match(/^(-?\d+(?:\.\d+)?)%$/);
+        if (!m)
+            throw new Error(`Invalid axis value: "${v}". Expected a number or "N%" string.`);
+        return pct(parseFloat(m[1]));
+    }
+    return v;
+}
+/** Converts a YamlPosSpec to a Pos instance. */
+function parsePos(spec) {
+    if (!spec)
+        return new Pos(0, 0);
+    if (spec === 'center')
+        return Pos.center();
+    if (spec === 'topLeft')
+        return Pos.topLeft();
+    if (spec === 'topRight')
+        return Pos.topRight();
+    if (spec === 'bottomLeft')
+        return Pos.bottomLeft();
+    if (spec === 'bottomRight')
+        return Pos.bottomRight();
+    if (typeof spec === 'object') {
+        if ('preset' in spec) {
+            const off = spec.offset !== undefined ? parseAxisValue(spec.offset) : 0;
+            switch (spec.preset) {
+                case 'top': return Pos.top(off);
+                case 'left': return Pos.left(off);
+                case 'right': return Pos.right(off);
+                case 'bottom': return Pos.bottom(off);
+            }
+        }
+        if ('x' in spec && 'y' in spec) {
+            return new Pos(parseAxisValue(spec.x), parseAxisValue(spec.y));
+        }
+    }
+    throw new Error(`Invalid pos spec: ${JSON.stringify(spec)}`);
+}
+/** Converts a YamlSizeSpec to a Size instance. */
+function parseSize(spec) {
+    if (spec === 'fill')
+        return Size.fill();
+    if (typeof spec === 'object') {
+        if ('fillWidth' in spec)
+            return Size.fillWidth(parseAxisValue(spec.fillWidth));
+        if ('fillHeight' in spec)
+            return Size.fillHeight(parseAxisValue(spec.fillHeight));
+        if ('width' in spec && 'height' in spec) {
+            return new Size(parseAxisValue(spec.width), parseAxisValue(spec.height));
+        }
+    }
+    throw new Error(`Invalid size spec: ${JSON.stringify(spec)}`);
+}
+/** Resolves a YAML background value (style name or numeric StyleId) to a StyleId.
+ *  String values are looked up by name in the global registry (returns 0 if not found).
+ *  Numeric values are passed through as-is. Undefined becomes undefined (transparent). */
+function resolveBackground(bg) {
+    if (bg === undefined)
+        return undefined;
+    if (typeof bg === 'string')
+        return getRegistry().getNamed(bg) ?? 0;
+    return bg;
+}
+// ── InterfaceBuilder ──────────────────────────────────────────────────────────
+/** Builds a window hierarchy from a YAML description.
+ *
+ * Usage:
+ *   1. Create an InterfaceBuilder and call registerCallback() for any onPress/onChange IDs.
+ *   2. Call build(yamlText, screen) or buildFromFile(path, screen).
+ *   3. Optionally pass a WindowManager to automatically register all focusable controls.
+ *   4. The returned Map<string, Window> gives access to windows by their YAML id.
+ *
+ * YAML schema:
+ *   windows:
+ *     - id: myBtn
+ *       type: button          # window | button | textbox | textarea | checkbox | radio
+ *       pos: center           # {x, y} | center | topLeft | topRight | bottomLeft | bottomRight | {preset: top|left|right|bottom, offset?}
+ *       size: { width: 20, height: 3 }  # {width, height} | fill | {fillWidth: N} | {fillHeight: N}
+ *       label: "Click me"
+ *       onPress: my_callback
+ *       children:
+ *         - ...
+ */
+export class InterfaceBuilder {
+    callbacks;
+    /** Creates an InterfaceBuilder with an empty callback registry. */
+    constructor() {
+        this.callbacks = new Map();
+    }
+    /** Registers a named callback for use with onPress or onChange in YAML definitions. */
+    registerCallback(id, fn) {
+        this.callbacks.set(id, fn);
+    }
+    /** Builds the UI from a YAML string, adds all top-level windows to Screen,
+     *  and registers focusable controls with WindowManager if provided.
+     *  Styles defined in the `styles:` section are registered before any windows are built.
+     *  Returns a map of all windows and controls keyed by their YAML id. */
+    build(yamlText, screen, wm) {
+        const layout = parse(yamlText);
+        const result = new Map();
+        const pending = [];
+        const contentWrites = [];
+        // Register YAML-defined named styles before building the window tree.
+        if (layout.styles) {
+            const registry = getRegistry();
+            for (const styleDef of layout.styles) {
+                const { name, ...attrs } = styleDef;
+                registry.registerNamed(name, attrs);
+            }
+        }
+        for (const def of layout.windows) {
+            const win = this.buildNode(def, result, pending, contentWrites, []);
+            // Adding to screen resolves percentage-based sizes for the entire subtree.
+            screen.addChild(win);
+        }
+        // Write static content after sizing so text lands in correctly-sized regions.
+        for (const { win, text } of contentWrites) {
+            win.writeText(text);
+        }
+        if (wm) {
+            for (const { control, parents } of pending) {
+                wm.register(control, ...parents);
+            }
+        }
+        return result;
+    }
+    /** Builds the UI from a YAML file. See build() for details. */
+    async buildFromFile(filePath, screen, wm) {
+        const text = await readFile(filePath, 'utf8');
+        return this.build(text, screen, wm);
+    }
+    // ── Private helpers ───────────────────────────────────────────────────────────
+    /** Recursively creates a single widget and all of its children from a YamlWindowDef.
+     *  Static content strings are collected into contentWrites instead of being written
+     *  immediately, so they are applied after all sizes are resolved. */
+    buildNode(def, result, pending, contentWrites, parentChain) {
+        const pos = parsePos(def.pos);
+        const bgId = resolveBackground(def.background);
+        /** Common window properties shared by all control types. */
+        const wp = {
+            pos,
+            size: def.size ? parseSize(def.size) : undefined,
+            background: bgId,
+            border: def.border,
+            active: def.active,
+            focused: def.focused,
+            disabled: def.disabled,
+            label: def.label,
+        };
+        let win;
+        switch (def.type ?? 'window') {
+            case 'button': {
+                const pressCb = def.onPress ? this.callbacks.get(def.onPress) : undefined;
+                wp.size = wp.size ?? this.requireSize(def);
+                const btn = new Button(wp, {
+                    onPress: pressCb ? () => pressCb() : undefined,
+                });
+                pending.push({ control: btn, parents: [...parentChain] });
+                win = btn;
+                break;
+            }
+            case 'textbox': {
+                wp.size = wp.size ?? this.requireSize(def);
+                const tb = new TextBox(wp, {
+                    value: def.value,
+                    placeholder: def.placeholder,
+                });
+                pending.push({ control: tb, parents: [...parentChain] });
+                win = tb;
+                break;
+            }
+            case 'textarea': {
+                wp.size = wp.size ?? this.requireSize(def);
+                const ta = new TextArea(wp, {
+                    value: def.value,
+                    placeholder: def.placeholder,
+                });
+                pending.push({ control: ta, parents: [...parentChain] });
+                win = ta;
+                break;
+            }
+            case 'checkbox': {
+                const changeCb = def.onChange ? this.callbacks.get(def.onChange) : undefined;
+                const cb = new Checkbox(wp, {
+                    checked: def.checked,
+                    onChange: changeCb ? (checked) => changeCb(checked) : undefined,
+                });
+                pending.push({ control: cb, parents: [...parentChain] });
+                win = cb;
+                break;
+            }
+            case 'radio': {
+                const changeCb = def.onChange ? this.callbacks.get(def.onChange) : undefined;
+                const r = new Radio(wp, {
+                    checked: def.checked,
+                    onChange: changeCb ? (checked) => changeCb(checked) : undefined,
+                });
+                pending.push({ control: r, parents: [...parentChain] });
+                win = r;
+                break;
+            }
+            case 'statusled': {
+                const led = new StatusLED(wp, {
+                    state: def.state,
+                });
+                win = led;
+                break;
+            }
+            case 'progressbar': {
+                wp.size = wp.size ?? this.requireSize(def);
+                const pb = new ProgressBar(wp, {
+                    value: def.barValue,
+                    max: def.max,
+                    showLabel: def.showLabel,
+                    fillColor: def.fillColor,
+                    emptyColor: def.emptyColor,
+                });
+                win = pb;
+                break;
+            }
+            case 'progressbarv': {
+                wp.size = wp.size ?? this.requireSize(def);
+                const pbv = new ProgressBarV(wp, {
+                    value: def.barValue,
+                    max: def.max,
+                    fillColor: def.fillColor,
+                    emptyColor: def.emptyColor,
+                });
+                win = pbv;
+                break;
+            }
+            case 'linechart': {
+                wp.size = wp.size ?? this.requireSize(def);
+                const lc = new LineChart(wp, {
+                    data: def.data,
+                    min: def.min,
+                    max: def.max,
+                    color: def.chartColor,
+                });
+                win = lc;
+                break;
+            }
+            case 'barchart': {
+                wp.size = wp.size ?? this.requireSize(def);
+                const bc = new BarChart(wp, {
+                    data: def.data,
+                    labels: def.barLabels,
+                    max: def.max,
+                    barColor: def.chartColor,
+                    barWidth: def.barWidth,
+                });
+                win = bc;
+                break;
+            }
+            case 'listbox': {
+                const changeCb = def.onChange ? this.callbacks.get(def.onChange) : undefined;
+                wp.size = wp.size ?? this.requireSize(def);
+                const lb = new ListBox(wp, {
+                    items: def.items,
+                    selectedIndex: def.selectedIndex,
+                    onChange: changeCb ? (idx, item) => changeCb(idx, item) : undefined,
+                });
+                pending.push({ control: lb, parents: [...parentChain] });
+                win = lb;
+                break;
+            }
+            case 'tabs': {
+                const changeCb = def.onChange ? this.callbacks.get(def.onChange) : undefined;
+                wp.size = wp.size ?? this.requireSize(def);
+                const tabs = new Tabs(wp, {
+                    titles: def.titles,
+                    activeIndex: def.activeIndex,
+                    onChange: changeCb ? (idx, title) => changeCb(idx, title) : undefined,
+                });
+                pending.push({ control: tabs, parents: [...parentChain] });
+                win = tabs;
+                break;
+            }
+            case 'sparkline': {
+                wp.size = wp.size ?? this.requireSize(def);
+                const sp = new Sparkline(wp, {
+                    data: def.data,
+                    min: def.min,
+                    max: def.max,
+                    color: def.chartColor,
+                });
+                win = sp;
+                break;
+            }
+            case 'spinner': {
+                const sp = new Spinner(wp, {
+                    style: def.spinnerStyle,
+                    frame: def.frame,
+                    running: def.running,
+                    color: def.chartColor,
+                });
+                win = sp;
+                break;
+            }
+            default: {
+                wp.size = wp.size ?? this.requireSize(def);
+                win = new Window(wp);
+                break;
+            }
+        }
+        if (def.id)
+            result.set(def.id, win);
+        // Defer content write – the window may not have its final size yet.
+        if (def.content)
+            contentWrites.push({ win, text: def.content });
+        if (def.children) {
+            for (const childDef of def.children) {
+                const child = this.buildNode(childDef, result, pending, contentWrites, [win, ...parentChain]);
+                if (win instanceof Tabs && childDef.tab !== undefined) {
+                    win.addChildToTab(childDef.tab, child);
+                }
+                else {
+                    win.addChild(child);
+                }
+            }
+        }
+        return win;
+    }
+    /** Returns a parsed Size from the definition or throws if size is missing. */
+    requireSize(def) {
+        if (!def.size) {
+            const label = def.id ? `"${def.id}"` : (def.type ?? 'window');
+            throw new Error(`Missing required "size" for ${label}.`);
+        }
+        return parseSize(def.size);
+    }
+}
+//# sourceMappingURL=InterfaceBuilder.mjs.map

package/dist/Screen/InterfaceBuilder.mjs.map

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

package/dist/Screen/Pos.d.mts

@@ -0,0 +1,52 @@
+/** Wraps a percentage value (0–100) for use in Pos and Size constructors. */
+export declare class Pct {
+    readonly value: number;
+    constructor(value: number);
+}
+/** Creates a Pct instance representing the given percentage. */
+export declare function pct(value: number): Pct;
+/** Encodes a window position. Supports absolute coordinates, edge-relative (negative),
+ *  percentage-based, center alignment, and named edge presets. */
+export declare class Pos {
+    private xSpec;
+    private ySpec;
+    /** Creates a position.
+     *  - Positive number: absolute distance from left/top.
+     *  - Negative number: own right/bottom edge at that distance from parent's right/bottom.
+     *  - Pct instance: percentage of parent dimension from left/top. */
+    constructor(x: number | Pct, y: number | Pct);
+    /** Builds a Pos directly from raw AxisSpec values (used by static factories). */
+    private static fromSpecs;
+    /** Aligns the top-left corner with the parent's top-left corner (0, 0). */
+    static topLeft(): Pos;
+    /** Aligns the top-right corner with the parent's top-right corner. */
+    static topRight(): Pos;
+    /** Aligns the bottom-left corner with the parent's bottom-left corner. */
+    static bottomLeft(): Pos;
+    /** Aligns the bottom-right corner with the parent's bottom-right corner. */
+    static bottomRight(): Pos;
+    /** Centers the window within the parent on both axes. */
+    static center(): Pos;
+    /** Aligns the top edge with the parent's top edge; x sets horizontal position. */
+    static top(x?: number | Pct): Pos;
+    /** Aligns the left edge with the parent's left edge; y sets vertical position. */
+    static left(y?: number | Pct): Pos;
+    /** Aligns the right edge with the parent's right edge; y sets vertical position. */
+    static right(y?: number | Pct): Pos;
+    /** Aligns the bottom edge with the parent's bottom edge; x sets horizontal position. */
+    static bottom(x?: number | Pct): Pos;
+    /** Returns true when both axes are absolute-from-start values (no parent/own-size needed). */
+    isAbsolute(): boolean;
+    /** Resolves absolute position without needing parent or own dimensions.
+     *  Only call when isAbsolute() returns true. */
+    resolveAbsolute(): {
+        x: number;
+        y: number;
+    };
+    /** Resolves this position to pixel coordinates given parent and own dimensions. */
+    resolve(parentW: number, parentH: number, ownW: number, ownH: number): {
+        x: number;
+        y: number;
+    };
+}
+//# sourceMappingURL=Pos.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Pos.d.mts","sourceRoot":"","sources":["../../src/Screen/Pos.mts"],"names":[],"mappings":"AAEA,6EAA6E;AAC7E,qBAAa,GAAG;aACoB,KAAK,EAAE,MAAM;gBAAb,KAAK,EAAE,MAAM;CAChD;AAED,gEAAgE;AAChE,wBAAgB,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,GAAG,CAEtC;AAmBD;kEACkE;AAClE,qBAAa,GAAG;IACf,OAAO,CAAC,KAAK,CAAW;IACxB,OAAO,CAAC,KAAK,CAAW;IAExB;;;wEAGoE;gBACjD,CAAC,EAAE,MAAM,GAAG,GAAG,EAAE,CAAC,EAAE,MAAM,GAAG,GAAG;IAKnD,iFAAiF;IACjF,OAAO,CAAC,MAAM,CAAC,SAAS;IAOxB,2EAA2E;WAC7D,OAAO,IAAI,GAAG;IAI5B,sEAAsE;WACxD,QAAQ,IAAI,GAAG;IAI7B,0EAA0E;WAC5D,UAAU,IAAI,GAAG;IAI/B,4EAA4E;WAC9D,WAAW,IAAI,GAAG;IAIhC,yDAAyD;WAC3C,MAAM,IAAI,GAAG;IAI3B,kFAAkF;WACpE,GAAG,CAAC,CAAC,GAAE,MAAM,GAAG,GAAO,GAAG,GAAG;IAI3C,kFAAkF;WACpE,IAAI,CAAC,CAAC,GAAE,MAAM,GAAG,GAAO,GAAG,GAAG;IAI5C,oFAAoF;WACtE,KAAK,CAAC,CAAC,GAAE,MAAM,GAAG,GAAO,GAAG,GAAG;IAI7C,wFAAwF;WAC1E,MAAM,CAAC,CAAC,GAAE,MAAM,GAAG,GAAO,GAAG,GAAG;IAI9C,8FAA8F;IACvF,UAAU,IAAI,OAAO;IAI5B;oDACgD;IACzC,eAAe,IAAI;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE;IAOlD,mFAAmF;IAC5E,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE;CAMtG"}

package/dist/Screen/Pos.mjs

@@ -0,0 +1,105 @@
+/** Wraps a percentage value (0–100) for use in Pos and Size constructors. */
+export class Pct {
+    value;
+    constructor(value) {
+        this.value = value;
+    }
+}
+/** Creates a Pct instance representing the given percentage. */
+export function pct(value) {
+    return new Pct(value);
+}
+/** Converts a user-supplied coordinate to an internal AxisSpec. */
+function toAxisSpec(v) {
+    if (v instanceof Pct)
+        return { mode: 'pct', value: v.value };
+    if (v < 0)
+        return { mode: 'end', value: -v };
+    return { mode: 'start', value: v };
+}
+/** Resolves a single axis spec to a pixel offset. */
+function resolveAxis(spec, parentSize, ownSize) {
+    switch (spec.mode) {
+        case 'start': return spec.value;
+        case 'end': return parentSize - ownSize - spec.value;
+        case 'pct': return Math.floor(parentSize * spec.value / 100);
+        case 'center': return Math.floor((parentSize - ownSize) / 2);
+    }
+}
+/** Encodes a window position. Supports absolute coordinates, edge-relative (negative),
+ *  percentage-based, center alignment, and named edge presets. */
+export class Pos {
+    xSpec;
+    ySpec;
+    /** Creates a position.
+     *  - Positive number: absolute distance from left/top.
+     *  - Negative number: own right/bottom edge at that distance from parent's right/bottom.
+     *  - Pct instance: percentage of parent dimension from left/top. */
+    constructor(x, y) {
+        this.xSpec = toAxisSpec(x);
+        this.ySpec = toAxisSpec(y);
+    }
+    /** Builds a Pos directly from raw AxisSpec values (used by static factories). */
+    static fromSpecs(x, y) {
+        const p = Object.create(Pos.prototype);
+        p.xSpec = x;
+        p.ySpec = y;
+        return p;
+    }
+    /** Aligns the top-left corner with the parent's top-left corner (0, 0). */
+    static topLeft() {
+        return Pos.fromSpecs({ mode: 'start', value: 0 }, { mode: 'start', value: 0 });
+    }
+    /** Aligns the top-right corner with the parent's top-right corner. */
+    static topRight() {
+        return Pos.fromSpecs({ mode: 'end', value: 0 }, { mode: 'start', value: 0 });
+    }
+    /** Aligns the bottom-left corner with the parent's bottom-left corner. */
+    static bottomLeft() {
+        return Pos.fromSpecs({ mode: 'start', value: 0 }, { mode: 'end', value: 0 });
+    }
+    /** Aligns the bottom-right corner with the parent's bottom-right corner. */
+    static bottomRight() {
+        return Pos.fromSpecs({ mode: 'end', value: 0 }, { mode: 'end', value: 0 });
+    }
+    /** Centers the window within the parent on both axes. */
+    static center() {
+        return Pos.fromSpecs({ mode: 'center' }, { mode: 'center' });
+    }
+    /** Aligns the top edge with the parent's top edge; x sets horizontal position. */
+    static top(x = 0) {
+        return Pos.fromSpecs(toAxisSpec(x), { mode: 'start', value: 0 });
+    }
+    /** Aligns the left edge with the parent's left edge; y sets vertical position. */
+    static left(y = 0) {
+        return Pos.fromSpecs({ mode: 'start', value: 0 }, toAxisSpec(y));
+    }
+    /** Aligns the right edge with the parent's right edge; y sets vertical position. */
+    static right(y = 0) {
+        return Pos.fromSpecs({ mode: 'end', value: 0 }, toAxisSpec(y));
+    }
+    /** Aligns the bottom edge with the parent's bottom edge; x sets horizontal position. */
+    static bottom(x = 0) {
+        return Pos.fromSpecs(toAxisSpec(x), { mode: 'end', value: 0 });
+    }
+    /** Returns true when both axes are absolute-from-start values (no parent/own-size needed). */
+    isAbsolute() {
+        return this.xSpec.mode === 'start' && this.ySpec.mode === 'start';
+    }
+    /** Resolves absolute position without needing parent or own dimensions.
+     *  Only call when isAbsolute() returns true. */
+    resolveAbsolute() {
+        return {
+            x: this.xSpec.value,
+            y: this.ySpec.value,
+        };
+    }
+    /** Resolves this position to pixel coordinates given parent and own dimensions. */
+    resolve(parentW, parentH, ownW, ownH) {
+        return {
+            x: resolveAxis(this.xSpec, parentW, ownW),
+            y: resolveAxis(this.ySpec, parentH, ownH),
+        };
+    }
+}
+//# sourceMappingURL=Pos.mjs.map

package/dist/Screen/Pos.mjs.map

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

package/dist/Screen/Region.d.mts

@@ -0,0 +1,31 @@
+import type { StyleId, TerminalSize } from './types.mjs';
+export declare class Region {
+    private chars;
+    private styleIds;
+    private size;
+    /** Allocates a cell buffer for the given dimensions. All cells start with style ID 0 (empty). */
+    constructor(width: number, height: number);
+    /** Returns the region dimensions (columns × rows). */
+    getSize(): TerminalSize;
+    /** Returns the style ID stored at (x, y). Throws RangeError if out of bounds. */
+    getStyleId(x: number, y: number): StyleId;
+    /** 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;
+    /** Replaces only the style ID at (x, y) without changing the character. Throws RangeError if out of bounds. */
+    setStyleId(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;
+    /** Returns a readonly view of the character buffer for rendering. */
+    getChars(): readonly string[];
+    /** Returns a readonly view of the style-ID buffer for rendering. */
+    getStyleIds(): readonly number[];
+    /** Returns the flat buffer index for the given (x, y) coordinates. */
+    private index;
+    /** Throws RangeError if the coordinates (x, y) are outside the region boundaries. */
+    private assertBounds;
+}
+//# sourceMappingURL=Region.d.mts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Region.d.mts","sourceRoot":"","sources":["../../src/Screen/Region.mts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEzD,qBAAa,MAAM;IAClB,OAAO,CAAC,KAAK,CAAW;IACxB,OAAO,CAAC,QAAQ,CAAW;IAC3B,OAAO,CAAC,IAAI,CAAe;IAE3B,iGAAiG;gBAC9E,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM;IAOhD,sDAAsD;IAC/C,OAAO,IAAI,YAAY;IAI9B,iFAAiF;IAC1E,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,OAAO;IAKhD,4GAA4G;IACrG,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI;IAKxD,qFAAqF;IAC9E,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,OAAW,GAAG,IAAI;IAO9E,+GAA+G;IACxG,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI;IAK/D,0DAA0D;IACnD,KAAK,IAAI,IAAI;IAQpB,8DAA8D;IACvD,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,OAAW,GAAG,IAAI;IAQrD,qEAAqE;IAC9D,QAAQ,IAAI,SAAS,MAAM,EAAE;IAIpC,oEAAoE;IAC7D,WAAW,IAAI,SAAS,MAAM,EAAE;IAIvC,sEAAsE;IACtE,OAAO,CAAC,KAAK;IAIb,qFAAqF;IACrF,OAAO,CAAC,YAAY;CAOpB"}