@effect-tui/core 0.1.0-alpha.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2024 Kit Langton
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,93 @@
+# @effect-tui/core
+
+Low-level terminal UI primitives built with [Effect](https://effect.website).
+
+## Installation
+
+```bash
+bun add @effect-tui/core effect
+```
+
+## Features
+
+- **CellBuffer** - Frame storage with glyph, style, and width-aware cells
+- **Palette** - Style deduplication for ANSI output
+- **Colors** - Color helpers (indexed, RGB, hex, grayscale)
+- **Keys** - Raw TTY key decoding
+- **Spring animations** - Analytical spring physics
+
+## Core Concepts
+
+### CellBuffer
+
+A 2D grid of cells, each storing a codepoint, style ID, and width. Handles wide characters (CJK, emoji) correctly.
+
+```typescript
+const buffer = new CellBuffer(80, 24)
+buffer.put(0, 0, "Hello", styleId)     // Put string
+buffer.drawCP(5, 0, 0x1F600, styleId)  // Draw codepoint (emoji)
+buffer.fillRect(0, 1, 10, 3, 32, styleId) // Fill rectangle
+```
+
+### Palette
+
+Maps style objects to numeric IDs and generates ANSI escape sequences:
+
+```typescript
+const palette = new Palette()
+const style = palette.id({ fg: Colors.green, bg: Colors.black })
+const ansi = palette.sgr(style)  // "\x1b[32;40m"
+```
+
+### Colors
+
+```typescript
+Colors.red           // Named color (indexed)
+Colors.rgb(255,0,0)  // RGB
+Colors.hex("#ff0000") // Hex
+Colors.gray(12)      // Grayscale (0-23)
+Colors.idx(196)      // 256-color index
+```
+
+## Basic Usage
+
+```typescript
+import { CellBuffer, Surface, Colors } from "@effect-tui/core"
+
+// Create a buffer
+const buffer = new CellBuffer(80, 24)
+buffer.put(0, 0, "Hello", { fg: Colors.green })
+
+// Render to terminal
+const surface = new Surface(process.stdout)
+surface.render(buffer)
+```
+
+## Spring Physics
+
+Analytical spring equations (matches framer-motion):
+
+```typescript
+import { Spring } from "@effect-tui/core"
+
+// Create spring with target
+const spring = Spring.init(0)
+const animated = Spring.to(spring, 100, { visualDuration: 0.35, bounce: 0.2 })
+
+// Tick each frame
+const next = Spring.tick(animated, 16)  // 16ms delta
+const value = Spring.value(next)        // Current position
+const done = Spring.settled(next)       // Animation complete?
+```
+
+**Parameters:**
+- `visualDuration` - Time to reach ~99% of target (seconds)
+- `bounce` - Overshoot amount (0 = no bounce, 0.5 = bouncy)
+
+## Related
+
+- [@effect-tui/react](https://github.com/kitlangton/effect-tui/tree/main/packages/effect-tui-react) - React renderer for terminal UIs
+
+## License
+
+MIT

package/dist/anim.d.ts

@@ -0,0 +1,4 @@
+export * from "./spring-physics.js";
+export * from "./spring.js";
+export * from "./motion-value.js";
+//# sourceMappingURL=anim.d.ts.map

package/dist/anim.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"anim.d.ts","sourceRoot":"","sources":["../src/anim.ts"],"names":[],"mappings":"AAEA,cAAc,qBAAqB,CAAA;AACnC,cAAc,aAAa,CAAA;AAC3B,cAAc,mBAAmB,CAAA"}

package/dist/anim.js

@@ -0,0 +1,5 @@
+// anim.ts - Re-export all animation primitives for backwards compatibility
+export * from "./spring-physics.js";
+export * from "./spring.js";
+export * from "./motion-value.js";
+//# sourceMappingURL=anim.js.map

package/dist/anim.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"anim.js","sourceRoot":"","sources":["../src/anim.ts"],"names":[],"mappings":"AAAA,2EAA2E;AAE3E,cAAc,qBAAqB,CAAA;AACnC,cAAc,aAAa,CAAA;AAC3B,cAAc,mBAAmB,CAAA"}

package/dist/ansi.d.ts

@@ -0,0 +1,69 @@
+/** Basic ANSI codes and helpers */
+export declare const ANSI: {
+    /** Reset all attributes */
+    readonly reset: "\u001B[0m";
+    /** Cursor control */
+    readonly cursor: {
+        /** Hide cursor */
+        readonly hide: "\u001B[?25l";
+        /** Show cursor */
+        readonly show: "\u001B[?25h";
+        /** Move cursor to home position (1,1) */
+        readonly home: "\u001B[H";
+        /** Move cursor to 1-based row/column */
+        readonly to: (row1: number, col1: number) => string;
+        /** Move cursor to 1-based column on current row */
+        readonly toCol: (col1: number) => string;
+    };
+    /** Screen control */
+    readonly screen: {
+        /** Enter alternate screen buffer */
+        readonly altEnter: "\u001B[?1049h";
+        /** Exit alternate screen buffer */
+        readonly altExit: "\u001B[?1049l";
+        /** Clear entire display */
+        readonly clear: "\u001B[2J";
+        /** Clear scrollback buffer */
+        readonly clearScrollback: "\u001B[3J";
+    };
+    /** Scrolling */
+    readonly scroll: {
+        /** Scroll up by n lines */
+        readonly up: (n: number) => string;
+    };
+    /** Device Status Reports / queries */
+    readonly report: {
+        /** Report Cursor Position (response: ESC [ row ; col R) */
+        readonly cursorPosition: "\u001B[6n";
+    };
+    /** Bracketed paste mode */
+    readonly paste: {
+        readonly bracketed: {
+            readonly on: "\u001B[?2004h";
+            readonly off: "\u001B[?2004l";
+        };
+    };
+    /** Mouse reporting toggles */
+    readonly mouse: {
+        /** Enable button tracking and SGR coordinates */
+        readonly on: "\u001B[?1002h\u001B[?1006h";
+        /** Disable SGR coords and button tracking */
+        readonly off: "\u001B[?1006l\u001B[?1002l";
+    };
+};
+/** Terminal session control utilities (compositions of ANSI primitives) */
+export declare const Terminal: {
+    /** Enter full-screen mode: alternate screen + hide cursor */
+    readonly enterFullscreen: string;
+    /** Exit full-screen mode: reset + show cursor + exit alternate screen */
+    readonly exitFullscreen: string;
+    /** Clear screen and move cursor to home */
+    readonly clearAndHome: string;
+    /** Convenience shorthands for common toggles */
+    readonly bracketedPasteOn: "\u001B[?2004h";
+    readonly bracketedPasteOff: "\u001B[?2004l";
+    readonly mouseOn: "\u001B[?1002h\u001B[?1006h";
+    readonly mouseOff: "\u001B[?1006l\u001B[?1002l";
+    readonly reportCursorPosition: "\u001B[6n";
+};
+//# sourceMappingURL=ansi.d.ts.map

package/dist/ansi.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ansi.d.ts","sourceRoot":"","sources":["../src/ansi.ts"],"names":[],"mappings":"AAKA,mCAAmC;AACnC,eAAO,MAAM,IAAI;IACf,2BAA2B;;IAG3B,qBAAqB;;QAEnB,kBAAkB;;QAElB,kBAAkB;;QAElB,yCAAyC;;QAEzC,wCAAwC;4BAC7B,MAAM,QAAQ,MAAM;QAC/B,mDAAmD;+BACrC,MAAM;;IAGtB,qBAAqB;;QAEnB,oCAAoC;;QAEpC,mCAAmC;;QAEnC,2BAA2B;;QAE3B,8BAA8B;;;IAIhC,gBAAgB;;QAEd,2BAA2B;yBACnB,MAAM;;IAGhB,sCAAsC;;QAEpC,2DAA2D;;;IAI7D,2BAA2B;;;;;;;IAQ3B,8BAA8B;;QAE5B,iDAAiD;;QAEjD,6CAA6C;;;CAGvC,CAAA;AAEV,2EAA2E;AAC3E,eAAO,MAAM,QAAQ;IACnB,6DAA6D;;IAG7D,yEAAyE;;IAGzE,2CAA2C;;IAG3C,gDAAgD;;;;;;CAMxC,CAAA"}

package/dist/ansi.js

@@ -0,0 +1,72 @@
+// ANSI escape sequences and terminal control utilities
+/** CSI prefix (ESC [) */
+const CSI = "\x1b[";
+/** Basic ANSI codes and helpers */
+export const ANSI = {
+    /** Reset all attributes */
+    reset: `${CSI}0m`,
+    /** Cursor control */
+    cursor: {
+        /** Hide cursor */
+        hide: `${CSI}?25l`,
+        /** Show cursor */
+        show: `${CSI}?25h`,
+        /** Move cursor to home position (1,1) */
+        home: `${CSI}H`,
+        /** Move cursor to 1-based row/column */
+        to: (row1, col1) => `${CSI}${row1};${col1}H`,
+        /** Move cursor to 1-based column on current row */
+        toCol: (col1) => `${CSI}${col1}G`,
+    },
+    /** Screen control */
+    screen: {
+        /** Enter alternate screen buffer */
+        altEnter: `${CSI}?1049h`,
+        /** Exit alternate screen buffer */
+        altExit: `${CSI}?1049l`,
+        /** Clear entire display */
+        clear: `${CSI}2J`,
+        /** Clear scrollback buffer */
+        clearScrollback: `${CSI}3J`,
+    },
+    /** Scrolling */
+    scroll: {
+        /** Scroll up by n lines */
+        up: (n) => `${CSI}${n}S`,
+    },
+    /** Device Status Reports / queries */
+    report: {
+        /** Report Cursor Position (response: ESC [ row ; col R) */
+        cursorPosition: `${CSI}6n`,
+    },
+    /** Bracketed paste mode */
+    paste: {
+        bracketed: {
+            on: `${CSI}?2004h`,
+            off: `${CSI}?2004l`,
+        },
+    },
+    /** Mouse reporting toggles */
+    mouse: {
+        /** Enable button tracking and SGR coordinates */
+        on: `${CSI}?1002h${CSI}?1006h`,
+        /** Disable SGR coords and button tracking */
+        off: `${CSI}?1006l${CSI}?1002l`,
+    },
+};
+/** Terminal session control utilities (compositions of ANSI primitives) */
+export const Terminal = {
+    /** Enter full-screen mode: alternate screen + hide cursor */
+    enterFullscreen: ANSI.screen.altEnter + ANSI.cursor.hide,
+    /** Exit full-screen mode: reset + show cursor + exit alternate screen */
+    exitFullscreen: ANSI.reset + ANSI.cursor.show + ANSI.screen.altExit,
+    /** Clear screen and move cursor to home */
+    clearAndHome: ANSI.screen.clear + ANSI.cursor.home,
+    /** Convenience shorthands for common toggles */
+    bracketedPasteOn: ANSI.paste.bracketed.on,
+    bracketedPasteOff: ANSI.paste.bracketed.off,
+    mouseOn: ANSI.mouse.on,
+    mouseOff: ANSI.mouse.off,
+    reportCursorPosition: ANSI.report.cursorPosition,
+};
+//# sourceMappingURL=ansi.js.map

package/dist/ansi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ansi.js","sourceRoot":"","sources":["../src/ansi.ts"],"names":[],"mappings":"AAAA,uDAAuD;AAEvD,yBAAyB;AACzB,MAAM,GAAG,GAAG,OAAO,CAAA;AAEnB,mCAAmC;AACnC,MAAM,CAAC,MAAM,IAAI,GAAG;IAClB,2BAA2B;IAC3B,KAAK,EAAE,GAAG,GAAG,IAAI;IAEjB,qBAAqB;IACrB,MAAM,EAAE;QACN,kBAAkB;QAClB,IAAI,EAAE,GAAG,GAAG,MAAM;QAClB,kBAAkB;QAClB,IAAI,EAAE,GAAG,GAAG,MAAM;QAClB,yCAAyC;QACzC,IAAI,EAAE,GAAG,GAAG,GAAG;QACf,wCAAwC;QACxC,EAAE,EAAE,CAAC,IAAY,EAAE,IAAY,EAAE,EAAE,CAAC,GAAG,GAAG,GAAG,IAAI,IAAI,IAAI,GAAG;QAC5D,mDAAmD;QACnD,KAAK,EAAE,CAAC,IAAY,EAAE,EAAE,CAAC,GAAG,GAAG,GAAG,IAAI,GAAG;KAC1C;IAED,qBAAqB;IACrB,MAAM,EAAE;QACN,oCAAoC;QACpC,QAAQ,EAAE,GAAG,GAAG,QAAQ;QACxB,mCAAmC;QACnC,OAAO,EAAE,GAAG,GAAG,QAAQ;QACvB,2BAA2B;QAC3B,KAAK,EAAE,GAAG,GAAG,IAAI;QACjB,8BAA8B;QAC9B,eAAe,EAAE,GAAG,GAAG,IAAI;KAC5B;IAED,gBAAgB;IAChB,MAAM,EAAE;QACN,2BAA2B;QAC3B,EAAE,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,GAAG,GAAG,GAAG,CAAC,GAAG;KACjC;IAED,sCAAsC;IACtC,MAAM,EAAE;QACN,2DAA2D;QAC3D,cAAc,EAAE,GAAG,GAAG,IAAI;KAC3B;IAED,2BAA2B;IAC3B,KAAK,EAAE;QACL,SAAS,EAAE;YACT,EAAE,EAAE,GAAG,GAAG,QAAQ;YAClB,GAAG,EAAE,GAAG,GAAG,QAAQ;SACpB;KACF;IAED,8BAA8B;IAC9B,KAAK,EAAE;QACL,iDAAiD;QACjD,EAAE,EAAE,GAAG,GAAG,SAAS,GAAG,QAAQ;QAC9B,6CAA6C;QAC7C,GAAG,EAAE,GAAG,GAAG,SAAS,GAAG,QAAQ;KAChC;CACO,CAAA;AAEV,2EAA2E;AAC3E,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,6DAA6D;IAC7D,eAAe,EAAE,IAAI,CAAC,MAAM,CAAC,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI;IAExD,yEAAyE;IACzE,cAAc,EAAE,IAAI,CAAC,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO;IAEnE,2CAA2C;IAC3C,YAAY,EAAE,IAAI,CAAC,MAAM,CAAC,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,IAAI;IAElD,gDAAgD;IAChD,gBAAgB,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE;IACzC,iBAAiB,EAAE,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG;IAC3C,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,EAAE;IACtB,QAAQ,EAAE,IAAI,CAAC,KAAK,CAAC,GAAG;IACxB,oBAAoB,EAAE,IAAI,CAAC,MAAM,CAAC,cAAc;CACxC,CAAA"}

package/dist/index.d.ts

@@ -0,0 +1,16 @@
+export * from "./render/surface.js";
+export * from "./render/buffer.js";
+export * from "./render/measure.js";
+export * from "./anim.js";
+export * from "./keys.js";
+export { View } from "./ui/index.js";
+export { ShinyText } from "./ui/index.js";
+export { TextInput, TextInputState, editTextInput } from "./ui/index.js";
+export { Markdown } from "./ui/index.js";
+export type { TextInputStateLike, TextInputStatePlain, TextInputGeom, TextInputOptions } from "./ui/index.js";
+export type { MarkdownOptions } from "./ui/index.js";
+export { geometryStore } from "./ui/core/geometry-store.js";
+export type { ViewId, Rect as GeometryRect, InputGeom } from "./ui/core/geometry-store.js";
+export * from "./present/display.js";
+export type { TerminalBackend } from "./runtime/backend_node.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,cAAc,qBAAqB,CAAA;AACnC,cAAc,oBAAoB,CAAA;AAClC,cAAc,qBAAqB,CAAA;AACnC,cAAc,WAAW,CAAA;AACzB,cAAc,WAAW,CAAA;AAGzB,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAA;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AACzC,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AACxE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AACxC,YAAY,EAAE,kBAAkB,EAAE,mBAAmB,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,eAAe,CAAA;AAC7G,YAAY,EAAE,eAAe,EAAE,MAAM,eAAe,CAAA;AAEpD,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAA;AAC3D,YAAY,EAAE,MAAM,EAAE,IAAI,IAAI,YAAY,EAAE,SAAS,EAAE,MAAM,6BAA6B,CAAA;AAG1F,cAAc,sBAAsB,CAAA;AACpC,YAAY,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAA"}

package/dist/index.js

@@ -0,0 +1,16 @@
+// Re-export core modules
+export * from "./render/surface.js";
+export * from "./render/buffer.js";
+export * from "./render/measure.js";
+export * from "./anim.js";
+export * from "./keys.js";
+// UI (canonical View and curated exports)
+export { View } from "./ui/index.js";
+export { ShinyText } from "./ui/index.js";
+export { TextInput, TextInputState, editTextInput } from "./ui/index.js";
+export { Markdown } from "./ui/index.js";
+// Geometry store (last-known layout)
+export { geometryStore } from "./ui/core/geometry-store.js";
+// Renderers (optional public API)
+export * from "./present/display.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,yBAAyB;AACzB,cAAc,qBAAqB,CAAA;AACnC,cAAc,oBAAoB,CAAA;AAClC,cAAc,qBAAqB,CAAA;AACnC,cAAc,WAAW,CAAA;AACzB,cAAc,WAAW,CAAA;AAEzB,0CAA0C;AAC1C,OAAO,EAAE,IAAI,EAAE,MAAM,eAAe,CAAA;AACpC,OAAO,EAAE,SAAS,EAAE,MAAM,eAAe,CAAA;AACzC,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,eAAe,CAAA;AACxE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAA;AAGxC,qCAAqC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAA;AAG3D,kCAAkC;AAClC,cAAc,sBAAsB,CAAA"}

package/dist/keys.d.ts

@@ -0,0 +1,18 @@
+export type KeyName = "up" | "down" | "left" | "right" | "enter" | "escape" | "tab" | "shift-tab" | "backspace" | "delete" | "home" | "end" | "pageup" | "pagedown" | "insert" | "return" | "space" | "char";
+export type KeyMsg = {
+    type: "key";
+    name: KeyName;
+    text?: string;
+    ctrl?: boolean;
+    meta?: boolean;
+    shift?: boolean;
+    /** Optional phase; currently always "press" but left extensible. */
+    phase?: "press" | "repeat" | "release";
+    /** Set by renderer to allow handlers to stop further propagation. */
+    defaultPrevented?: boolean;
+    preventDefault?: () => void;
+    /** Source protocol (raw|csiu|modifyOther|kitty). */
+    source?: "raw" | "csiu" | "modify-other" | "kitty";
+};
+export declare function decodeKeys(buf: Buffer): Iterable<KeyMsg>;
+//# sourceMappingURL=keys.d.ts.map

package/dist/keys.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"keys.d.ts","sourceRoot":"","sources":["../src/keys.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,OAAO,GACf,IAAI,GACJ,MAAM,GACN,MAAM,GACN,OAAO,GACP,OAAO,GACP,QAAQ,GACR,KAAK,GACL,WAAW,GACX,WAAW,GACX,QAAQ,GACR,MAAM,GACN,KAAK,GACL,QAAQ,GACR,UAAU,GACV,QAAQ,GACR,QAAQ,GACR,OAAO,GACP,MAAM,CAAA;AAEV,MAAM,MAAM,MAAM,GAAG;IACnB,IAAI,EAAE,KAAK,CAAA;IACX,IAAI,EAAE,OAAO,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,IAAI,CAAC,EAAE,OAAO,CAAA;IACd,KAAK,CAAC,EAAE,OAAO,CAAA;IACf,oEAAoE;IACpE,KAAK,CAAC,EAAE,OAAO,GAAG,QAAQ,GAAG,SAAS,CAAA;IACtC,qEAAqE;IACrE,gBAAgB,CAAC,EAAE,OAAO,CAAA;IAC1B,cAAc,CAAC,EAAE,MAAM,IAAI,CAAA;IAC3B,oDAAoD;IACpD,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,cAAc,GAAG,OAAO,CAAA;CACnD,CAAA;AAID,wBAAiB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,QAAQ,CAAC,MAAM,CAAC,CA+NzD"}

package/dist/keys.js

@@ -0,0 +1,247 @@
+// Minimal key decoder for Node raw input → semantic key messages.
+const ESC = "\x1b";
+export function* decodeKeys(buf) {
+    // Handle control characters (0x00-0x1F)
+    // These are generated by Ctrl+letter combinations
+    if (buf.length === 1 && buf[0] !== undefined && buf[0] < 0x20) {
+        const byte = buf[0];
+        // Special control characters with specific meanings
+        switch (byte) {
+            case 0x03: // Ctrl-C (ETX - End of Text)
+                yield { type: "key", name: "char", text: "c", ctrl: true };
+                return;
+            case 0x04: // Ctrl-D (EOT - End of Transmission)
+                yield { type: "key", name: "char", text: "d", ctrl: true };
+                return;
+            case 0x17: // Ctrl-W (ETB - End of Transmission Block)
+                yield { type: "key", name: "char", text: "w", ctrl: true };
+                return;
+            case 0x1a: // Ctrl-Z (SUB - Substitute)
+                yield { type: "key", name: "char", text: "z", ctrl: true };
+                return;
+            case 0x0c: // Ctrl-L (FF - Form Feed)
+                yield { type: "key", name: "char", text: "l", ctrl: true };
+                return;
+            case 0x09: // Tab (HT - Horizontal Tab)
+                yield { type: "key", name: "tab" };
+                return;
+            case 0x0d: // Enter (CR - Carriage Return)
+                yield { type: "key", name: "enter" };
+                return;
+            case 0x0a: // Line Feed (LF)
+                yield { type: "key", name: "enter" };
+                return;
+            case 0x08: // Backspace (BS)
+                yield { type: "key", name: "backspace" };
+                return;
+            case 0x1b: // Escape (ESC)
+                yield { type: "key", name: "escape" };
+                return;
+            default:
+                // Other control characters: convert back to letter
+                // Ctrl-A = 0x01, Ctrl-B = 0x02, etc.
+                if (byte >= 0x01 && byte <= 0x1a) {
+                    const letter = String.fromCharCode(byte + 96); // 0x01 + 96 = 'a'
+                    yield { type: "key", name: "char", text: letter, ctrl: true };
+                }
+                else {
+                    // Unknown control character, emit raw
+                    yield { type: "key", name: "char", text: String.fromCharCode(byte), ctrl: true };
+                }
+                return;
+        }
+    }
+    // Handle 0x7F (DEL) separately as it's outside the control character range
+    if (buf.length === 1 && buf[0] === 0x7f) {
+        yield { type: "key", name: "backspace" };
+        return;
+    }
+    let s = buf.toString("utf8");
+    // Handle one or more SGR mouse reports possibly coalesced in a single chunk.
+    // Format: ESC [ < Cb ; Cx ; Cy (M|m) — terminals vary on the trailing letter; accept any A-Z.
+    const sgrRe = /\x1b\x5b<(?<cb>\d+);(?<cx>\d+);(?<cy>\d+)(?<updown>[A-Za-z])/g;
+    let matchedAny = false;
+    for (const m of s.matchAll(sgrRe)) {
+        matchedAny = true;
+        const code = parseInt(m.groups?.cb ?? "0", 10);
+        if (code === 64) {
+            yield { type: "key", name: "pageup", meta: true };
+            continue;
+        }
+        if (code === 65) {
+            yield { type: "key", name: "pagedown", meta: true };
+        }
+        // ignore other mouse events
+    }
+    if (matchedAny) {
+        // Strip SGR mouse sequences so they never leak into the input as text
+        // Create a fresh regex since the global one was consumed by matchAll()
+        s = s.replace(/\x1b\x5b<(?<cb>\d+);(?<cx>\d+);(?<cy>\d+)(?<updown>[A-Za-z])/g, "");
+        if (s.length === 0)
+            return;
+    }
+    // Legacy single SGR report path (when only one arrives)
+    const sgr = /^\x1b\[<(?<cb>\d+);(?<cx>\d+);(?<cy>\d+)(?<updown>[A-Za-z])$/.exec(s);
+    if (sgr?.groups) {
+        const code = parseInt(sgr.groups.cb ?? "0", 10);
+        if (code === 64) {
+            yield { type: "key", name: "pageup", meta: true };
+            return;
+        }
+        if (code === 65) {
+            yield { type: "key", name: "pagedown", meta: true };
+            return;
+        }
+        return;
+    }
+    // Meta+Backspace (Option+Backspace on macOS terminals) — often ESC + DEL / BS
+    if (s === `${ESC}\x7f` || s === `${ESC}\b` || s === `${ESC}\x08`) {
+        yield { type: "key", name: "backspace", meta: true };
+        return;
+    }
+    // Alt/Meta + Enter (many terminals send ESC + CR/LF)
+    if (s === `${ESC}\r` || s === `${ESC}\n`) {
+        yield { type: "key", name: "enter", meta: true };
+        return;
+    }
+    // modifyOtherKeys (xterm / some terminals): CSI 27;modifier;code~
+    const moo = /^\x1b\[27;(?<mod>\d+);(?<code>\d+)~$/.exec(s);
+    if (moo?.groups) {
+        const mod = parseInt(moo.groups.mod ?? "1", 10) - 1;
+        const code = parseInt(moo.groups.code ?? "0", 10);
+        const shift = !!(mod & 1);
+        const alt = !!(mod & 2);
+        const ctrl = !!(mod & 4);
+        const meta = !!(mod & 8) || alt;
+        const key = fromCharCode(code, { shift, ctrl, meta, source: "modify-other" });
+        if (key) {
+            yield key;
+            return;
+        }
+    }
+    // CSI-u (modern modifyOtherKeys): CSI <code> ; <modifier> u
+    const csiu = /^\x1b\[(?<code>\d+);(?<mod>\d+)u$/.exec(s);
+    if (csiu?.groups) {
+        const mod = parseInt(csiu.groups.mod ?? "1", 10) - 1;
+        const code = parseInt(csiu.groups.code ?? "0", 10);
+        const shift = !!(mod & 1);
+        const alt = !!(mod & 2);
+        const ctrl = !!(mod & 4);
+        const meta = !!(mod & 8) || alt;
+        const key = fromCharCode(code, { shift, ctrl, meta, source: "csiu" });
+        if (key) {
+            yield key;
+            return;
+        }
+    }
+    // Escape (lone ESC) - handle after meta combinations
+    if (s === ESC) {
+        yield { type: "key", name: "escape" };
+        return;
+    }
+    // Single printable
+    if (s.length === 1 && s !== ESC && s !== "\x7f") {
+        if (s === " ") {
+            yield { type: "key", name: "space", text: " " };
+            return;
+        }
+        if (s >= " ") {
+            yield { type: "key", name: "char", text: s };
+            return;
+        }
+    }
+    // Common escapes
+    switch (s) {
+        case `${ESC}[A`:
+            yield { type: "key", name: "up" };
+            return;
+        case `${ESC}[B`:
+            yield { type: "key", name: "down" };
+            return;
+        case `${ESC}[C`:
+            yield { type: "key", name: "right" };
+            return;
+        case `${ESC}[D`:
+            yield { type: "key", name: "left" };
+            return;
+        case `${ESC}[1;3C`:
+            yield { type: "key", name: "right", meta: true };
+            return;
+        case `${ESC}[1;3D`:
+            yield { type: "key", name: "left", meta: true };
+            return;
+        case `${ESC}OP`: // F1 (ignored)
+            return;
+        case `${ESC}[H`:
+            yield { type: "key", name: "home" };
+            return;
+        case `${ESC}[F`:
+            yield { type: "key", name: "end" };
+            return;
+        case `${ESC}[5~`:
+            yield { type: "key", name: "pageup" };
+            return;
+        case `${ESC}[6~`:
+            yield { type: "key", name: "pagedown" };
+            return;
+        case `${ESC}[2~`:
+            yield { type: "key", name: "insert" };
+            return;
+        case `${ESC}[3~`:
+            yield { type: "key", name: "delete" };
+            return;
+        case `${ESC}[3;3~`: // Meta+Delete (best-effort for some terminals)
+            yield { type: "key", name: "delete", meta: true };
+            return;
+        case `${ESC}[Z`:
+            yield { type: "key", name: "shift-tab", shift: true };
+            return;
+    }
+    // Alt/Meta + char (ESC <char>)
+    if (s.length === 2 && s[0] === ESC && s[1] && s[1] >= " ") {
+        const ch = s[1];
+        if (ch === " ") {
+            yield { type: "key", name: "space", text: " ", meta: true };
+            return;
+        }
+        yield { type: "key", name: "char", text: ch, meta: true };
+        return;
+    }
+    // Fallback: emit printable chars individually
+    for (const ch of s) {
+        if (ch >= " ")
+            yield { type: "key", name: "char", text: ch };
+    }
+}
+function fromCharCode(code, mods) {
+    const { shift, ctrl, meta, source } = mods;
+    const common = {
+        type: "key",
+        ctrl,
+        meta,
+        shift,
+        phase: "press",
+        source,
+    };
+    switch (code) {
+        case 13:
+            return { ...common, name: "enter" };
+        case 27:
+            return { ...common, name: "escape" };
+        case 9:
+            return { ...common, name: "tab" };
+        case 32:
+            return { ...common, name: "space", text: " " };
+        case 127:
+        case 8:
+            return { ...common, name: "backspace" };
+    }
+    if (code >= 0 && code < 32) {
+        // Control character -> map to letter when possible
+        const letter = String.fromCharCode(code + 96);
+        return { ...common, name: "char", text: letter, ctrl: true };
+    }
+    const ch = String.fromCharCode(code);
+    return { ...common, name: "char", text: ch };
+}
+//# sourceMappingURL=keys.js.map

package/dist/keys.js.map

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

package/dist/layout/linearStack.d.ts

@@ -0,0 +1,17 @@
+export type Axis = "horizontal" | "vertical";
+export type Size = {
+    w: number;
+    h: number;
+};
+export type Rect = {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+};
+export type HAlign = "leading" | "center" | "trailing";
+export type VAlign = "top" | "center" | "bottom";
+/** flexBase[i] = null for fixed, or the child's base main-size for flexible. */
+export declare function measureLinear(axis: Axis, maxW: number, maxH: number, spacing: number, sizes: Size[], flexBase: (number | null)[]): Size;
+export declare function layoutLinear(axis: Axis, rect: Rect, spacing: number, crossAlign: HAlign | VAlign, sizes: Size[], flexBase: (number | null)[]): Rect[];
+//# sourceMappingURL=linearStack.d.ts.map

package/dist/layout/linearStack.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"linearStack.d.ts","sourceRoot":"","sources":["../../src/layout/linearStack.ts"],"names":[],"mappings":"AAEA,MAAM,MAAM,IAAI,GAAG,YAAY,GAAG,UAAU,CAAA;AAC5C,MAAM,MAAM,IAAI,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAC3C,MAAM,MAAM,IAAI,GAAG;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AACjE,MAAM,MAAM,MAAM,GAAG,SAAS,GAAG,QAAQ,GAAG,UAAU,CAAA;AACtD,MAAM,MAAM,MAAM,GAAG,KAAK,GAAG,QAAQ,GAAG,QAAQ,CAAA;AAEhD,gFAAgF;AAChF,wBAAgB,aAAa,CAC3B,IAAI,EAAE,IAAI,EACV,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EACZ,OAAO,EAAE,MAAM,EACf,KAAK,EAAE,IAAI,EAAE,EACb,QAAQ,EAAE,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,GAC1B,IAAI,CAwBN;AAED,wBAAgB,YAAY,CAC1B,IAAI,EAAE,IAAI,EACV,IAAI,EAAE,IAAI,EACV,OAAO,EAAE,MAAM,EACf,UAAU,EAAE,MAAM,GAAG,MAAM,EAC3B,KAAK,EAAE,IAAI,EAAE,EACb,QAAQ,EAAE,CAAC,MAAM,GAAG,IAAI,CAAC,EAAE,GAC1B,IAAI,EAAE,CAiER"}