openhorse 0.1.5

package/dist/ink/events/keyboard-event.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.KeyboardEvent = void 0;
+const terminal_event_js_1 = require("./terminal-event.js");
+/**
+ * Keyboard event dispatched through the DOM tree via capture/bubble.
+ *
+ * Follows browser KeyboardEvent semantics: `key` is the literal character
+ * for printable keys ('a', '3', ' ', '/') and a multi-char name for
+ * special keys ('down', 'return', 'escape', 'f1'). The idiomatic
+ * printable-char check is `e.key.length === 1`.
+ */
+class KeyboardEvent extends terminal_event_js_1.TerminalEvent {
+    constructor(parsedKey) {
+        super('keydown', { bubbles: true, cancelable: true });
+        this.key = keyFromParsed(parsedKey);
+        this.ctrl = parsedKey.ctrl;
+        this.shift = parsedKey.shift;
+        this.meta = parsedKey.meta || parsedKey.option;
+        this.superKey = parsedKey.super;
+        this.fn = parsedKey.fn;
+    }
+}
+exports.KeyboardEvent = KeyboardEvent;
+function keyFromParsed(parsed) {
+    const seq = parsed.sequence ?? '';
+    const name = parsed.name ?? '';
+    // Ctrl combos: sequence is a control byte (\x03 for ctrl+c), name is the
+    // letter. Browsers report e.key === 'c' with e.ctrlKey === true.
+    if (parsed.ctrl)
+        return name;
+    // Single printable char (space through ~, plus anything above ASCII):
+    // use the literal char. Browsers report e.key === '3', not 'Digit3'.
+    if (seq.length === 1) {
+        const code = seq.charCodeAt(0);
+        if (code >= 0x20 && code !== 0x7f)
+            return seq;
+    }
+    // Special keys (arrows, F-keys, return, tab, escape, etc.): sequence is
+    // either an escape sequence (\x1b[B) or a control byte (\r, \t), so use
+    // the parsed name. Browsers report e.key === 'ArrowDown'.
+    return name || seq;
+}
+//# sourceMappingURL=keyboard-event.js.map

package/dist/ink/events/keyboard-event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"keyboard-event.js","sourceRoot":"","sources":["../../../src/ink/events/keyboard-event.ts"],"names":[],"mappings":";;;AACA,2DAAmD;AAEnD;;;;;;;GAOG;AACH,MAAa,aAAc,SAAQ,iCAAa;IAQ9C,YAAY,SAAoB;QAC9B,KAAK,CAAC,SAAS,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAA;QAErD,IAAI,CAAC,GAAG,GAAG,aAAa,CAAC,SAAS,CAAC,CAAA;QACnC,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC,IAAI,CAAA;QAC1B,IAAI,CAAC,KAAK,GAAG,SAAS,CAAC,KAAK,CAAA;QAC5B,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC,IAAI,IAAI,SAAS,CAAC,MAAM,CAAA;QAC9C,IAAI,CAAC,QAAQ,GAAG,SAAS,CAAC,KAAK,CAAA;QAC/B,IAAI,CAAC,EAAE,GAAG,SAAS,CAAC,EAAE,CAAA;IACxB,CAAC;CACF;AAlBD,sCAkBC;AAED,SAAS,aAAa,CAAC,MAAiB;IACtC,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAA;IACjC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,IAAI,EAAE,CAAA;IAE9B,yEAAyE;IACzE,iEAAiE;IACjE,IAAI,MAAM,CAAC,IAAI;QAAE,OAAO,IAAI,CAAA;IAE5B,sEAAsE;IACtE,qEAAqE;IACrE,IAAI,GAAG,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACrB,MAAM,IAAI,GAAG,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAA;QAC9B,IAAI,IAAI,IAAI,IAAI,IAAI,IAAI,KAAK,IAAI;YAAE,OAAO,GAAG,CAAA;IAC/C,CAAC;IAED,wEAAwE;IACxE,wEAAwE;IACxE,0DAA0D;IAC1D,OAAO,IAAI,IAAI,GAAG,CAAA;AACpB,CAAC"}

package/dist/ink/events/terminal-event.d.ts

@@ -0,0 +1,55 @@
+import { Event } from './event.js';
+type EventPhase = 'none' | 'capturing' | 'at_target' | 'bubbling';
+type TerminalEventInit = {
+    bubbles?: boolean;
+    cancelable?: boolean;
+};
+/**
+ * Base class for all terminal events with DOM-style propagation.
+ *
+ * Extends Event so existing event types (ClickEvent, InputEvent,
+ * TerminalFocusEvent) share a common ancestor and can migrate later.
+ *
+ * Mirrors the browser's Event API: target, currentTarget, eventPhase,
+ * stopPropagation(), preventDefault(), timeStamp.
+ */
+export declare class TerminalEvent extends Event {
+    readonly type: string;
+    readonly timeStamp: number;
+    readonly bubbles: boolean;
+    readonly cancelable: boolean;
+    private _target;
+    private _currentTarget;
+    private _eventPhase;
+    private _propagationStopped;
+    private _defaultPrevented;
+    constructor(type: string, init?: TerminalEventInit);
+    get target(): EventTarget | null;
+    get currentTarget(): EventTarget | null;
+    get eventPhase(): EventPhase;
+    get defaultPrevented(): boolean;
+    stopPropagation(): void;
+    stopImmediatePropagation(): void;
+    preventDefault(): void;
+    /** @internal */
+    _setTarget(target: EventTarget): void;
+    /** @internal */
+    _setCurrentTarget(target: EventTarget | null): void;
+    /** @internal */
+    _setEventPhase(phase: EventPhase): void;
+    /** @internal */
+    _isPropagationStopped(): boolean;
+    /** @internal */
+    _isImmediatePropagationStopped(): boolean;
+    /**
+     * Hook for subclasses to do per-node setup before each handler fires.
+     * Default is a no-op.
+     */
+    _prepareForTarget(_target: EventTarget): void;
+}
+export type EventTarget = {
+    parentNode: EventTarget | undefined;
+    _eventHandlers?: Record<string, unknown>;
+};
+export {};
+//# sourceMappingURL=terminal-event.d.ts.map

package/dist/ink/events/terminal-event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-event.d.ts","sourceRoot":"","sources":["../../../src/ink/events/terminal-event.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAElC,KAAK,UAAU,GAAG,MAAM,GAAG,WAAW,GAAG,WAAW,GAAG,UAAU,CAAA;AAEjE,KAAK,iBAAiB,GAAG;IACvB,OAAO,CAAC,EAAE,OAAO,CAAA;IACjB,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB,CAAA;AAED;;;;;;;;GAQG;AACH,qBAAa,aAAc,SAAQ,KAAK;IACtC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAA;IACzB,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAA;IAE5B,OAAO,CAAC,OAAO,CAA2B;IAC1C,OAAO,CAAC,cAAc,CAA2B;IACjD,OAAO,CAAC,WAAW,CAAqB;IACxC,OAAO,CAAC,mBAAmB,CAAQ;IACnC,OAAO,CAAC,iBAAiB,CAAQ;gBAErB,IAAI,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,iBAAiB;IAQlD,IAAI,MAAM,IAAI,WAAW,GAAG,IAAI,CAE/B;IAED,IAAI,aAAa,IAAI,WAAW,GAAG,IAAI,CAEtC;IAED,IAAI,UAAU,IAAI,UAAU,CAE3B;IAED,IAAI,gBAAgB,IAAI,OAAO,CAE9B;IAED,eAAe,IAAI,IAAI;IAId,wBAAwB,IAAI,IAAI;IAKzC,cAAc,IAAI,IAAI;IAQtB,gBAAgB;IAChB,UAAU,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI;IAIrC,gBAAgB;IAChB,iBAAiB,CAAC,MAAM,EAAE,WAAW,GAAG,IAAI,GAAG,IAAI;IAInD,gBAAgB;IAChB,cAAc,CAAC,KAAK,EAAE,UAAU,GAAG,IAAI;IAIvC,gBAAgB;IAChB,qBAAqB,IAAI,OAAO;IAIhC,gBAAgB;IAChB,8BAA8B,IAAI,OAAO;IAIzC;;;OAGG;IACH,iBAAiB,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI;CAC9C;AAED,MAAM,MAAM,WAAW,GAAG;IACxB,UAAU,EAAE,WAAW,GAAG,SAAS,CAAA;IACnC,cAAc,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;CACzC,CAAA"}

package/dist/ink/events/terminal-event.js

@@ -0,0 +1,79 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TerminalEvent = void 0;
+const event_js_1 = require("./event.js");
+/**
+ * Base class for all terminal events with DOM-style propagation.
+ *
+ * Extends Event so existing event types (ClickEvent, InputEvent,
+ * TerminalFocusEvent) share a common ancestor and can migrate later.
+ *
+ * Mirrors the browser's Event API: target, currentTarget, eventPhase,
+ * stopPropagation(), preventDefault(), timeStamp.
+ */
+class TerminalEvent extends event_js_1.Event {
+    constructor(type, init) {
+        super();
+        this._target = null;
+        this._currentTarget = null;
+        this._eventPhase = 'none';
+        this._propagationStopped = false;
+        this._defaultPrevented = false;
+        this.type = type;
+        this.timeStamp = performance.now();
+        this.bubbles = init?.bubbles ?? true;
+        this.cancelable = init?.cancelable ?? true;
+    }
+    get target() {
+        return this._target;
+    }
+    get currentTarget() {
+        return this._currentTarget;
+    }
+    get eventPhase() {
+        return this._eventPhase;
+    }
+    get defaultPrevented() {
+        return this._defaultPrevented;
+    }
+    stopPropagation() {
+        this._propagationStopped = true;
+    }
+    stopImmediatePropagation() {
+        super.stopImmediatePropagation();
+        this._propagationStopped = true;
+    }
+    preventDefault() {
+        if (this.cancelable) {
+            this._defaultPrevented = true;
+        }
+    }
+    // -- Internal setters used by the Dispatcher
+    /** @internal */
+    _setTarget(target) {
+        this._target = target;
+    }
+    /** @internal */
+    _setCurrentTarget(target) {
+        this._currentTarget = target;
+    }
+    /** @internal */
+    _setEventPhase(phase) {
+        this._eventPhase = phase;
+    }
+    /** @internal */
+    _isPropagationStopped() {
+        return this._propagationStopped;
+    }
+    /** @internal */
+    _isImmediatePropagationStopped() {
+        return this.didStopImmediatePropagation();
+    }
+    /**
+     * Hook for subclasses to do per-node setup before each handler fires.
+     * Default is a no-op.
+     */
+    _prepareForTarget(_target) { }
+}
+exports.TerminalEvent = TerminalEvent;
+//# sourceMappingURL=terminal-event.js.map

package/dist/ink/events/terminal-event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-event.js","sourceRoot":"","sources":["../../../src/ink/events/terminal-event.ts"],"names":[],"mappings":";;;AAAA,yCAAkC;AASlC;;;;;;;;GAQG;AACH,MAAa,aAAc,SAAQ,gBAAK;IAYtC,YAAY,IAAY,EAAE,IAAwB;QAChD,KAAK,EAAE,CAAA;QAPD,YAAO,GAAuB,IAAI,CAAA;QAClC,mBAAc,GAAuB,IAAI,CAAA;QACzC,gBAAW,GAAe,MAAM,CAAA;QAChC,wBAAmB,GAAG,KAAK,CAAA;QAC3B,sBAAiB,GAAG,KAAK,CAAA;QAI/B,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;QAChB,IAAI,CAAC,SAAS,GAAG,WAAW,CAAC,GAAG,EAAE,CAAA;QAClC,IAAI,CAAC,OAAO,GAAG,IAAI,EAAE,OAAO,IAAI,IAAI,CAAA;QACpC,IAAI,CAAC,UAAU,GAAG,IAAI,EAAE,UAAU,IAAI,IAAI,CAAA;IAC5C,CAAC;IAED,IAAI,MAAM;QACR,OAAO,IAAI,CAAC,OAAO,CAAA;IACrB,CAAC;IAED,IAAI,aAAa;QACf,OAAO,IAAI,CAAC,cAAc,CAAA;IAC5B,CAAC;IAED,IAAI,UAAU;QACZ,OAAO,IAAI,CAAC,WAAW,CAAA;IACzB,CAAC;IAED,IAAI,gBAAgB;QAClB,OAAO,IAAI,CAAC,iBAAiB,CAAA;IAC/B,CAAC;IAED,eAAe;QACb,IAAI,CAAC,mBAAmB,GAAG,IAAI,CAAA;IACjC,CAAC;IAEQ,wBAAwB;QAC/B,KAAK,CAAC,wBAAwB,EAAE,CAAA;QAChC,IAAI,CAAC,mBAAmB,GAAG,IAAI,CAAA;IACjC,CAAC;IAED,cAAc;QACZ,IAAI,IAAI,CAAC,UAAU,EAAE,CAAC;YACpB,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAA;QAC/B,CAAC;IACH,CAAC;IAED,6CAA6C;IAE7C,gBAAgB;IAChB,UAAU,CAAC,MAAmB;QAC5B,IAAI,CAAC,OAAO,GAAG,MAAM,CAAA;IACvB,CAAC;IAED,gBAAgB;IAChB,iBAAiB,CAAC,MAA0B;QAC1C,IAAI,CAAC,cAAc,GAAG,MAAM,CAAA;IAC9B,CAAC;IAED,gBAAgB;IAChB,cAAc,CAAC,KAAiB;QAC9B,IAAI,CAAC,WAAW,GAAG,KAAK,CAAA;IAC1B,CAAC;IAED,gBAAgB;IAChB,qBAAqB;QACnB,OAAO,IAAI,CAAC,mBAAmB,CAAA;IACjC,CAAC;IAED,gBAAgB;IAChB,8BAA8B;QAC5B,OAAO,IAAI,CAAC,2BAA2B,EAAE,CAAA;IAC3C,CAAC;IAED;;;OAGG;IACH,iBAAiB,CAAC,OAAoB,IAAS,CAAC;CACjD;AAnFD,sCAmFC"}

package/dist/ink/events/terminal-focus-event.d.ts

@@ -0,0 +1,14 @@
+import { Event } from './event.js';
+export type TerminalFocusEventType = 'terminalfocus' | 'terminalblur';
+/**
+ * Event fired when the terminal window gains or loses focus.
+ *
+ * Uses DECSET 1004 focus reporting - the terminal sends:
+ * - CSI I (\x1b[I) when the terminal gains focus
+ * - CSI O (\x1b[O) when the terminal loses focus
+ */
+export declare class TerminalFocusEvent extends Event {
+    readonly type: TerminalFocusEventType;
+    constructor(type: TerminalFocusEventType);
+}
+//# sourceMappingURL=terminal-focus-event.d.ts.map

package/dist/ink/events/terminal-focus-event.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-focus-event.d.ts","sourceRoot":"","sources":["../../../src/ink/events/terminal-focus-event.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,EAAE,MAAM,YAAY,CAAA;AAElC,MAAM,MAAM,sBAAsB,GAAG,eAAe,GAAG,cAAc,CAAA;AAErE;;;;;;GAMG;AACH,qBAAa,kBAAmB,SAAQ,KAAK;IAC3C,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAA;gBAEzB,IAAI,EAAE,sBAAsB;CAIzC"}

package/dist/ink/events/terminal-focus-event.js

@@ -0,0 +1,19 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.TerminalFocusEvent = void 0;
+const event_js_1 = require("./event.js");
+/**
+ * Event fired when the terminal window gains or loses focus.
+ *
+ * Uses DECSET 1004 focus reporting - the terminal sends:
+ * - CSI I (\x1b[I) when the terminal gains focus
+ * - CSI O (\x1b[O) when the terminal loses focus
+ */
+class TerminalFocusEvent extends event_js_1.Event {
+    constructor(type) {
+        super();
+        this.type = type;
+    }
+}
+exports.TerminalFocusEvent = TerminalFocusEvent;
+//# sourceMappingURL=terminal-focus-event.js.map

package/dist/ink/events/terminal-focus-event.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"terminal-focus-event.js","sourceRoot":"","sources":["../../../src/ink/events/terminal-focus-event.ts"],"names":[],"mappings":";;;AAAA,yCAAkC;AAIlC;;;;;;GAMG;AACH,MAAa,kBAAmB,SAAQ,gBAAK;IAG3C,YAAY,IAA4B;QACtC,KAAK,EAAE,CAAA;QACP,IAAI,CAAC,IAAI,GAAG,IAAI,CAAA;IAClB,CAAC;CACF;AAPD,gDAOC"}

package/dist/ink/focus.d.ts

@@ -0,0 +1,44 @@
+import type { DOMElement } from './dom.js';
+import { FocusEvent } from './events/focus-event.js';
+/**
+ * DOM-like focus manager for the Ink terminal UI.
+ *
+ * Pure state — tracks activeElement and a focus stack. Has no reference
+ * to the tree; callers pass the root when tree walks are needed.
+ *
+ * Stored on the root DOMElement so any node can reach it by walking
+ * parentNode (like browser's `node.ownerDocument`).
+ */
+export declare class FocusManager {
+    activeElement: DOMElement | null;
+    private dispatchFocusEvent;
+    private enabled;
+    private focusStack;
+    constructor(dispatchFocusEvent: (target: DOMElement, event: FocusEvent) => boolean);
+    focus(node: DOMElement): void;
+    blur(): void;
+    /**
+     * Called by the reconciler when a node is removed from the tree.
+     * Handles both the exact node and any focused descendant within
+     * the removed subtree. Dispatches blur and restores focus from stack.
+     */
+    handleNodeRemoved(node: DOMElement, root: DOMElement): void;
+    handleAutoFocus(node: DOMElement): void;
+    handleClickFocus(node: DOMElement): void;
+    enable(): void;
+    disable(): void;
+    focusNext(root: DOMElement): void;
+    focusPrevious(root: DOMElement): void;
+    private moveFocus;
+}
+/**
+ * Walk up to root and return it. The root is the node that holds
+ * the FocusManager — like browser's `node.getRootNode()`.
+ */
+export declare function getRootNode(node: DOMElement): DOMElement;
+/**
+ * Walk up to root and return its FocusManager.
+ * Like browser's `node.ownerDocument` — focus belongs to the root.
+ */
+export declare function getFocusManager(node: DOMElement): FocusManager;
+//# sourceMappingURL=focus.d.ts.map

package/dist/ink/focus.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"focus.d.ts","sourceRoot":"","sources":["../../src/ink/focus.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAA;AAC1C,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAA;AAIpD;;;;;;;;GAQG;AACH,qBAAa,YAAY;IACvB,aAAa,EAAE,UAAU,GAAG,IAAI,CAAO;IACvC,OAAO,CAAC,kBAAkB,CAAoD;IAC9E,OAAO,CAAC,OAAO,CAAO;IACtB,OAAO,CAAC,UAAU,CAAmB;gBAGnC,kBAAkB,EAAE,CAAC,MAAM,EAAE,UAAU,EAAE,KAAK,EAAE,UAAU,KAAK,OAAO;IAKxE,KAAK,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;IAiB7B,IAAI,IAAI,IAAI;IAQZ;;;;OAIG;IACH,iBAAiB,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,UAAU,GAAG,IAAI;IA2B3D,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;IAIvC,gBAAgB,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;IAMxC,MAAM,IAAI,IAAI;IAId,OAAO,IAAI,IAAI;IAIf,SAAS,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;IAIjC,aAAa,CAAC,IAAI,EAAE,UAAU,GAAG,IAAI;IAIrC,OAAO,CAAC,SAAS;CAsBlB;AA8BD;;;GAGG;AACH,wBAAgB,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,UAAU,CAOxD;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,IAAI,EAAE,UAAU,GAAG,YAAY,CAE9D"}

package/dist/ink/focus.js

@@ -0,0 +1,164 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FocusManager = void 0;
+exports.getRootNode = getRootNode;
+exports.getFocusManager = getFocusManager;
+const focus_event_js_1 = require("./events/focus-event.js");
+const MAX_FOCUS_STACK = 32;
+/**
+ * DOM-like focus manager for the Ink terminal UI.
+ *
+ * Pure state — tracks activeElement and a focus stack. Has no reference
+ * to the tree; callers pass the root when tree walks are needed.
+ *
+ * Stored on the root DOMElement so any node can reach it by walking
+ * parentNode (like browser's `node.ownerDocument`).
+ */
+class FocusManager {
+    constructor(dispatchFocusEvent) {
+        this.activeElement = null;
+        this.enabled = true;
+        this.focusStack = [];
+        this.dispatchFocusEvent = dispatchFocusEvent;
+    }
+    focus(node) {
+        if (node === this.activeElement)
+            return;
+        if (!this.enabled)
+            return;
+        const previous = this.activeElement;
+        if (previous) {
+            // Deduplicate before pushing to prevent unbounded growth from Tab cycling
+            const idx = this.focusStack.indexOf(previous);
+            if (idx !== -1)
+                this.focusStack.splice(idx, 1);
+            this.focusStack.push(previous);
+            if (this.focusStack.length > MAX_FOCUS_STACK)
+                this.focusStack.shift();
+            this.dispatchFocusEvent(previous, new focus_event_js_1.FocusEvent('blur', node));
+        }
+        this.activeElement = node;
+        this.dispatchFocusEvent(node, new focus_event_js_1.FocusEvent('focus', previous));
+    }
+    blur() {
+        if (!this.activeElement)
+            return;
+        const previous = this.activeElement;
+        this.activeElement = null;
+        this.dispatchFocusEvent(previous, new focus_event_js_1.FocusEvent('blur', null));
+    }
+    /**
+     * Called by the reconciler when a node is removed from the tree.
+     * Handles both the exact node and any focused descendant within
+     * the removed subtree. Dispatches blur and restores focus from stack.
+     */
+    handleNodeRemoved(node, root) {
+        // Remove the node and any descendants from the stack
+        this.focusStack = this.focusStack.filter(n => n !== node && isInTree(n, root));
+        // Check if activeElement is the removed node OR a descendant
+        if (!this.activeElement)
+            return;
+        if (this.activeElement !== node && isInTree(this.activeElement, root)) {
+            return;
+        }
+        const removed = this.activeElement;
+        this.activeElement = null;
+        this.dispatchFocusEvent(removed, new focus_event_js_1.FocusEvent('blur', null));
+        // Restore focus to the most recent still-mounted element
+        while (this.focusStack.length > 0) {
+            const candidate = this.focusStack.pop();
+            if (isInTree(candidate, root)) {
+                this.activeElement = candidate;
+                this.dispatchFocusEvent(candidate, new focus_event_js_1.FocusEvent('focus', removed));
+                return;
+            }
+        }
+    }
+    handleAutoFocus(node) {
+        this.focus(node);
+    }
+    handleClickFocus(node) {
+        const tabIndex = node.attributes['tabIndex'];
+        if (typeof tabIndex !== 'number')
+            return;
+        this.focus(node);
+    }
+    enable() {
+        this.enabled = true;
+    }
+    disable() {
+        this.enabled = false;
+    }
+    focusNext(root) {
+        this.moveFocus(1, root);
+    }
+    focusPrevious(root) {
+        this.moveFocus(-1, root);
+    }
+    moveFocus(direction, root) {
+        if (!this.enabled)
+            return;
+        const tabbable = collectTabbable(root);
+        if (tabbable.length === 0)
+            return;
+        const currentIndex = this.activeElement
+            ? tabbable.indexOf(this.activeElement)
+            : -1;
+        const nextIndex = currentIndex === -1
+            ? direction === 1
+                ? 0
+                : tabbable.length - 1
+            : (currentIndex + direction + tabbable.length) % tabbable.length;
+        const next = tabbable[nextIndex];
+        if (next) {
+            this.focus(next);
+        }
+    }
+}
+exports.FocusManager = FocusManager;
+function collectTabbable(root) {
+    const result = [];
+    walkTree(root, result);
+    return result;
+}
+function walkTree(node, result) {
+    const tabIndex = node.attributes['tabIndex'];
+    if (typeof tabIndex === 'number' && tabIndex >= 0) {
+        result.push(node);
+    }
+    for (const child of node.childNodes) {
+        if (child.nodeName !== '#text') {
+            walkTree(child, result);
+        }
+    }
+}
+function isInTree(node, root) {
+    let current = node;
+    while (current) {
+        if (current === root)
+            return true;
+        current = current.parentNode;
+    }
+    return false;
+}
+/**
+ * Walk up to root and return it. The root is the node that holds
+ * the FocusManager — like browser's `node.getRootNode()`.
+ */
+function getRootNode(node) {
+    let current = node;
+    while (current) {
+        if (current.focusManager)
+            return current;
+        current = current.parentNode;
+    }
+    throw new Error('Node is not in a tree with a FocusManager');
+}
+/**
+ * Walk up to root and return its FocusManager.
+ * Like browser's `node.ownerDocument` — focus belongs to the root.
+ */
+function getFocusManager(node) {
+    return getRootNode(node).focusManager;
+}
+//# sourceMappingURL=focus.js.map

package/dist/ink/focus.js.map

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

package/dist/ink/frame.d.ts

@@ -0,0 +1,95 @@
+import type { Cursor } from './cursor.js';
+import type { Size } from './layout/geometry.js';
+import type { ScrollHint } from './render-node-to-output.js';
+import { type CharPool, type HyperlinkPool, type Screen, type StylePool } from './screen.js';
+export type Frame = {
+    readonly screen: Screen;
+    readonly viewport: Size;
+    readonly cursor: Cursor;
+    /** DECSTBM scroll optimization hint (alt-screen only, null otherwise). */
+    readonly scrollHint?: ScrollHint | null;
+    /** A ScrollBox has remaining pendingScrollDelta — schedule another frame. */
+    readonly scrollDrainPending?: boolean;
+};
+export declare function emptyFrame(rows: number, columns: number, stylePool: StylePool, charPool: CharPool, hyperlinkPool: HyperlinkPool): Frame;
+export type FlickerReason = 'resize' | 'offscreen' | 'clear';
+export type FrameEvent = {
+    durationMs: number;
+    /** Phase breakdown in ms + patch count. Populated when the ink instance
+     *  has frame-timing instrumentation enabled (via onFrame wiring). */
+    phases?: {
+        /** createRenderer output: DOM → yoga layout → screen buffer */
+        renderer: number;
+        /** LogUpdate.render(): screen diff → Patch[] (the hot path this PR optimizes) */
+        diff: number;
+        /** optimize(): patch merge/dedupe */
+        optimize: number;
+        /** writeDiffToTerminal(): serialize patches → ANSI → stdout */
+        write: number;
+        /** Pre-optimize patch count (proxy for how much changed this frame) */
+        patches: number;
+        /** yoga calculateLayout() time (runs in resetAfterCommit, before onRender) */
+        yoga: number;
+        /** React reconcile time: scrollMutated → resetAfterCommit. 0 if no commit. */
+        commit: number;
+        /** layoutNode() calls this frame (recursive, includes cache-hit returns) */
+        yogaVisited: number;
+        /** measureFunc (text wrap/width) calls — the expensive part */
+        yogaMeasured: number;
+        /** early returns via _hasL single-slot cache */
+        yogaCacheHits: number;
+        /** total yoga Node instances alive (create - free). Growth = leak. */
+        yogaLive: number;
+    };
+    flickers: Array<{
+        desiredHeight: number;
+        availableHeight: number;
+        reason: FlickerReason;
+    }>;
+};
+export type Patch = {
+    type: 'stdout';
+    content: string;
+} | {
+    type: 'clear';
+    count: number;
+} | {
+    type: 'clearTerminal';
+    reason: FlickerReason;
+    debug?: {
+        triggerY: number;
+        prevLine: string;
+        nextLine: string;
+    };
+} | {
+    type: 'cursorHide';
+} | {
+    type: 'cursorShow';
+} | {
+    type: 'cursorMove';
+    x: number;
+    y: number;
+} | {
+    type: 'cursorTo';
+    col: number;
+} | {
+    type: 'carriageReturn';
+} | {
+    type: 'hyperlink';
+    uri: string;
+} | {
+    type: 'styleStr';
+    str: string;
+};
+export type Diff = Patch[];
+/**
+ * Determines whether the screen should be cleared based on the current and previous frame.
+ * Returns the reason for clearing, or undefined if no clear is needed.
+ *
+ * Screen clearing is triggered when:
+ * 1. Terminal has been resized (viewport dimensions changed) → 'resize'
+ * 2. Current frame screen height exceeds available terminal rows → 'offscreen'
+ * 3. Previous frame screen height exceeded available terminal rows → 'offscreen'
+ */
+export declare function shouldClearScreen(prevFrame: Frame, frame: Frame): FlickerReason | undefined;
+//# sourceMappingURL=frame.d.ts.map

package/dist/ink/frame.d.ts.map

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

package/dist/ink/frame.js

@@ -0,0 +1,35 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.emptyFrame = emptyFrame;
+exports.shouldClearScreen = shouldClearScreen;
+const screen_js_1 = require("./screen.js");
+function emptyFrame(rows, columns, stylePool, charPool, hyperlinkPool) {
+    return {
+        screen: (0, screen_js_1.createScreen)(0, 0, stylePool, charPool, hyperlinkPool),
+        viewport: { width: columns, height: rows },
+        cursor: { x: 0, y: 0, visible: true },
+    };
+}
+/**
+ * Determines whether the screen should be cleared based on the current and previous frame.
+ * Returns the reason for clearing, or undefined if no clear is needed.
+ *
+ * Screen clearing is triggered when:
+ * 1. Terminal has been resized (viewport dimensions changed) → 'resize'
+ * 2. Current frame screen height exceeds available terminal rows → 'offscreen'
+ * 3. Previous frame screen height exceeded available terminal rows → 'offscreen'
+ */
+function shouldClearScreen(prevFrame, frame) {
+    const didResize = frame.viewport.height !== prevFrame.viewport.height ||
+        frame.viewport.width !== prevFrame.viewport.width;
+    if (didResize) {
+        return 'resize';
+    }
+    const currentFrameOverflows = frame.screen.height >= frame.viewport.height;
+    const previousFrameOverflowed = prevFrame.screen.height >= prevFrame.viewport.height;
+    if (currentFrameOverflows || previousFrameOverflowed) {
+        return 'offscreen';
+    }
+    return undefined;
+}
+//# sourceMappingURL=frame.js.map

package/dist/ink/frame.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame.js","sourceRoot":"","sources":["../../src/ink/frame.ts"],"names":[],"mappings":";;AAqBA,gCAYC;AAuED,8CAmBC;AAxHD,2CAMoB;AAYpB,SAAgB,UAAU,CACxB,IAAY,EACZ,OAAe,EACf,SAAoB,EACpB,QAAkB,EAClB,aAA4B;IAE5B,OAAO;QACL,MAAM,EAAE,IAAA,wBAAY,EAAC,CAAC,EAAE,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,aAAa,CAAC;QAC9D,QAAQ,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE;QAC1C,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE;KACtC,CAAA;AACH,CAAC;AA8DD;;;;;;;;GAQG;AACH,SAAgB,iBAAiB,CAC/B,SAAgB,EAChB,KAAY;IAEZ,MAAM,SAAS,GACb,KAAK,CAAC,QAAQ,CAAC,MAAM,KAAK,SAAS,CAAC,QAAQ,CAAC,MAAM;QACnD,KAAK,CAAC,QAAQ,CAAC,KAAK,KAAK,SAAS,CAAC,QAAQ,CAAC,KAAK,CAAA;IACnD,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,QAAQ,CAAA;IACjB,CAAC;IAED,MAAM,qBAAqB,GAAG,KAAK,CAAC,MAAM,CAAC,MAAM,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAA;IAC1E,MAAM,uBAAuB,GAC3B,SAAS,CAAC,MAAM,CAAC,MAAM,IAAI,SAAS,CAAC,QAAQ,CAAC,MAAM,CAAA;IACtD,IAAI,qBAAqB,IAAI,uBAAuB,EAAE,CAAC;QACrD,OAAO,WAAW,CAAA;IACpB,CAAC;IAED,OAAO,SAAS,CAAA;AAClB,CAAC"}

package/dist/ink/get-max-width.d.ts

@@ -0,0 +1,18 @@
+import { type LayoutNode } from './layout/node.js';
+/**
+ * Returns the yoga node's content width (computed width minus padding and
+ * border).
+ *
+ * Warning: can return a value WIDER than the parent container. In a
+ * column-direction flex parent, width is the cross axis — align-items:
+ * stretch never shrinks children below their intrinsic size, so the text
+ * node overflows (standard CSS behavior). Yoga measures leaf nodes in two
+ * passes: the AtMost pass determines width, the Exactly pass determines
+ * height. getComputedWidth() reflects the wider AtMost result while
+ * getComputedHeight() reflects the narrower Exactly result. Callers that
+ * use this for wrapping should clamp to actual available screen space so
+ * the rendered line count stays consistent with the layout height.
+ */
+declare const getMaxWidth: (yogaNode: LayoutNode) => number;
+export default getMaxWidth;
+//# sourceMappingURL=get-max-width.d.ts.map

package/dist/ink/get-max-width.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-max-width.d.ts","sourceRoot":"","sources":["../../src/ink/get-max-width.ts"],"names":[],"mappings":"AAAA,OAAO,EAAc,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAA;AAE9D;;;;;;;;;;;;;GAaG;AACH,QAAA,MAAM,WAAW,GAAI,UAAU,UAAU,KAAG,MAQ3C,CAAA;AAED,eAAe,WAAW,CAAA"}

package/dist/ink/get-max-width.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const node_js_1 = require("./layout/node.js");
+/**
+ * Returns the yoga node's content width (computed width minus padding and
+ * border).
+ *
+ * Warning: can return a value WIDER than the parent container. In a
+ * column-direction flex parent, width is the cross axis — align-items:
+ * stretch never shrinks children below their intrinsic size, so the text
+ * node overflows (standard CSS behavior). Yoga measures leaf nodes in two
+ * passes: the AtMost pass determines width, the Exactly pass determines
+ * height. getComputedWidth() reflects the wider AtMost result while
+ * getComputedHeight() reflects the narrower Exactly result. Callers that
+ * use this for wrapping should clamp to actual available screen space so
+ * the rendered line count stays consistent with the layout height.
+ */
+const getMaxWidth = (yogaNode) => {
+    return (yogaNode.getComputedWidth() -
+        yogaNode.getComputedPadding(node_js_1.LayoutEdge.Left) -
+        yogaNode.getComputedPadding(node_js_1.LayoutEdge.Right) -
+        yogaNode.getComputedBorder(node_js_1.LayoutEdge.Left) -
+        yogaNode.getComputedBorder(node_js_1.LayoutEdge.Right));
+};
+exports.default = getMaxWidth;
+//# sourceMappingURL=get-max-width.js.map

package/dist/ink/get-max-width.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-max-width.js","sourceRoot":"","sources":["../../src/ink/get-max-width.ts"],"names":[],"mappings":";;AAAA,8CAA8D;AAE9D;;;;;;;;;;;;;GAaG;AACH,MAAM,WAAW,GAAG,CAAC,QAAoB,EAAU,EAAE;IACnD,OAAO,CACL,QAAQ,CAAC,gBAAgB,EAAE;QAC3B,QAAQ,CAAC,kBAAkB,CAAC,oBAAU,CAAC,IAAI,CAAC;QAC5C,QAAQ,CAAC,kBAAkB,CAAC,oBAAU,CAAC,KAAK,CAAC;QAC7C,QAAQ,CAAC,iBAAiB,CAAC,oBAAU,CAAC,IAAI,CAAC;QAC3C,QAAQ,CAAC,iBAAiB,CAAC,oBAAU,CAAC,KAAK,CAAC,CAC7C,CAAA;AACH,CAAC,CAAA;AAED,kBAAe,WAAW,CAAA"}