@profullstack/hqtui 0.1.0

package/dist/graphics/plot.js

@@ -0,0 +1,291 @@
+import { gradient as makeGradient, mix } from "../color.js";
+import { BrailleCanvas } from "./braille.js";
+import { verticalGlyph, horizontalGlyph } from "./blocks.js";
+import { seriesColor } from "../theme.js";
+function extent(seriesList, options) {
+    let min = options.min;
+    let max = options.max;
+    if (min === undefined || max === undefined) {
+        let lo = Infinity;
+        let hi = -Infinity;
+        for (const s of seriesList) {
+            for (const v of s.values) {
+                if (!Number.isFinite(v))
+                    continue;
+                if (v < lo)
+                    lo = v;
+                if (v > hi)
+                    hi = v;
+            }
+        }
+        if (!Number.isFinite(lo)) {
+            lo = 0;
+            hi = 1;
+        }
+        min = min ?? Math.min(0, lo);
+        max = max ?? hi;
+    }
+    if (max <= min)
+        max = min + 1;
+    return [min, max];
+}
+function drawGrid(surface, color, bg) {
+    const { width: w, height: h } = surface;
+    for (let y = 0; y < h; y += Math.max(2, Math.floor(h / 4))) {
+        for (let x = 0; x < w; x += 2)
+            surface.char(x, y, "·", { fg: color, bg });
+    }
+}
+/**
+ * Draw one or more series across the whole surface.
+ * With `mode: "braille"` each cell carries a 2x4 pixel matrix, so a 40x10 panel
+ * plots at 80x40 resolution.
+ */
+export function plot(surface, series, options = {}) {
+    if (surface.empty || series.length === 0)
+        return;
+    const theme = surface.theme;
+    const mode = options.mode ?? "braille";
+    const bg = options.background;
+    const w = surface.width;
+    const h = surface.height;
+    // Only the samples that will actually be drawn should set the scale, or an
+    // old spike still sitting in the history buffer flattens the live line.
+    const columns = mode === "braille" ? w * 2 : w;
+    const visible = series.map((s) => ({ ...s, values: s.values.slice(-Math.max(1, columns)) }));
+    const [min, max] = extent(visible, options);
+    const span = max - min;
+    series = visible;
+    if (options.grid)
+        drawGrid(surface, options.gridColor ?? mix(theme.border, theme.background, 0.4), bg);
+    if (mode === "block" || mode === "ascii" || mode === "half") {
+        // One column per cell, newest value on the right.
+        series.forEach((s, si) => {
+            const color = s.color ?? options.color ?? seriesColor(theme, si);
+            const ramp = options.colors ? makeGradient(options.colors) : undefined;
+            for (let x = 0; x < w; x++) {
+                const idx = s.values.length - w + x;
+                const v = idx >= 0 ? s.values[idx] : undefined;
+                if (v === undefined || !Number.isFinite(v))
+                    continue;
+                const ratio = (v - min) / span;
+                const filled = ratio * h;
+                const full = Math.floor(filled);
+                const cellColor = ramp ? ramp(ratio) : color;
+                for (let k = 0; k < full && k < h; k++) {
+                    surface.char(x, h - 1 - k, "█", { fg: cellColor, bg });
+                }
+                if (full < h) {
+                    const glyph = verticalGlyph(filled - full, mode);
+                    if (glyph !== " ")
+                        surface.char(x, h - 1 - full, glyph, { fg: cellColor, bg });
+                }
+            }
+        });
+        return;
+    }
+    // Braille: build one canvas per series so colors stay separable.
+    const canvas = new BrailleCanvas(w, h);
+    const px = canvas.width;
+    const py = canvas.height;
+    series.forEach((s, si) => {
+        canvas.clear();
+        const color = s.color ?? options.color ?? seriesColor(theme, si);
+        const values = s.values;
+        if (values.length === 0)
+            return;
+        const count = Math.min(values.length, px);
+        const start = values.length - count;
+        const points = [];
+        for (let i = 0; i < count; i++) {
+            const v = values[start + i];
+            if (!Number.isFinite(v))
+                continue;
+            const ratio = (v - min) / span;
+            const x = count === 1 ? px - 1 : Math.round((i / (count - 1)) * (px - 1));
+            const y = Math.round((1 - Math.max(0, Math.min(1, ratio))) * (py - 1));
+            points.push([x, y]);
+        }
+        if (points.length === 0)
+            return;
+        if (points.length === 1)
+            canvas.pixel(points[0][0], points[0][1]);
+        else
+            canvas.polyline(points);
+        const wantFill = s.fill ?? options.fill ?? false;
+        const fillAlpha = options.fillAlpha ?? 0.35;
+        if (wantFill) {
+            const area = new BrailleCanvas(w, h);
+            area.polyline(points);
+            area.fillUnder(points, py - 1);
+            // Fade the shading downwards so the line stays the brightest thing on screen.
+            const base = bg ?? theme.background;
+            blit(surface, area, (_col, row) => {
+                const depth = h <= 1 ? 0 : row / (h - 1);
+                return mix(base, color, fillAlpha * (1 - depth * 0.6));
+            }, bg);
+        }
+        const ramp = options.colors ? makeGradient(options.colors) : undefined;
+        blit(surface, canvas, (col, row) => {
+            if (!ramp)
+                return color;
+            return ramp(1 - row / Math.max(1, h - 1));
+        }, bg);
+    });
+}
+/** Copy a Braille canvas onto a surface, one glyph per cell. */
+export function blit(surface, canvas, colorAt, bg) {
+    for (let row = 0; row < canvas.rows; row++) {
+        for (let col = 0; col < canvas.cols; col++) {
+            const value = canvas.cell(col, row);
+            if (value === 0)
+                continue;
+            surface.char(col, row, value, { fg: colorAt(col, row), bg });
+        }
+    }
+}
+/** A single-row trend line. Cheap enough to put in a table cell. */
+export function sparkline(surface, values, options = {}) {
+    if (surface.empty)
+        return;
+    const theme = surface.theme;
+    const w = surface.width;
+    const windowed = values.slice(-Math.max(1, w));
+    const [min, max] = extent([{ values: windowed }], options);
+    const span = max - min;
+    const ramp = options.colors ? makeGradient(options.colors) : undefined;
+    const color = options.color ?? theme.accent;
+    const count = Math.min(values.length, w);
+    const start = values.length - count;
+    const offset = w - count;
+    for (let i = 0; i < count; i++) {
+        const v = values[start + i];
+        if (!Number.isFinite(v))
+            continue;
+        const ratio = Math.max(0, Math.min(1, (v - min) / span));
+        surface.char(offset + i, 0, verticalGlyph(ratio, options.mode ?? "block"), {
+            fg: ramp ? ramp(ratio) : color,
+            bg: options.background,
+        });
+    }
+}
+/** A horizontal bar filling the surface's first row. */
+export function bar(surface, options) {
+    if (surface.empty)
+        return;
+    const theme = surface.theme;
+    const w = surface.width;
+    const ratio = Math.max(0, Math.min(1, options.value));
+    const style = options.style ?? "smooth";
+    const trackColor = options.track ?? mix(theme.background, theme.border, 0.8);
+    const heat = options.heat ? makeGradient(theme.heat) : undefined;
+    const color = options.color ?? theme.primary;
+    const trackChar = options.trackChar ?? (style === "ascii" ? "-" : style === "segmented" ? "░" : "─");
+    const filled = ratio * w;
+    const full = Math.floor(filled);
+    for (let x = 0; x < w; x++) {
+        if (x < full) {
+            surface.char(x, 0, style === "ascii" ? "#" : "█", {
+                fg: heat ? heat(w <= 1 ? ratio : x / (w - 1)) : color,
+                bg: options.background,
+            });
+        }
+        else if (x === full && style !== "segmented") {
+            const glyph = horizontalGlyph(filled - full, style === "ascii" ? "ascii" : "block");
+            surface.char(x, 0, glyph === " " ? trackChar : glyph, {
+                fg: glyph === " " ? trackColor : heat ? heat(ratio) : color,
+                bg: options.background,
+            });
+        }
+        else {
+            surface.char(x, 0, trackChar, { fg: trackColor, bg: options.background });
+        }
+    }
+}
+/**
+ * A semicircular dial drawn with Braille. Needs about 9x5 cells to look right.
+ */
+export function gauge(surface, options) {
+    if (surface.empty || surface.height < 3) {
+        bar(surface, { value: options.value, color: options.color, heat: options.heat });
+        return;
+    }
+    const theme = surface.theme;
+    const ratio = Math.max(0, Math.min(1, options.value));
+    const canvas = new BrailleCanvas(surface.width, surface.height);
+    const cx = canvas.width / 2;
+    const cy = canvas.height - 2;
+    const radius = Math.min(canvas.width / 2 - 1, canvas.height - 3);
+    const heat = makeGradient(theme.heat);
+    const arcColors = [];
+    const steps = Math.max(24, Math.round(radius * 4));
+    for (let i = 0; i <= steps; i++) {
+        const t = i / steps;
+        const angle = Math.PI * (1 - t);
+        const x = cx + Math.cos(angle) * radius;
+        const y = cy - Math.sin(angle) * radius * 0.85;
+        if (t <= ratio) {
+            canvas.pixel(x, y);
+            canvas.pixel(x, y - 1);
+            arcColors.push(t);
+        }
+    }
+    const color = options.color ?? (options.heat === false ? theme.primary : heat(ratio));
+    blit(surface, canvas, () => color, options.background);
+    // Unfilled remainder of the dial, dimmed.
+    const rest = new BrailleCanvas(surface.width, surface.height);
+    for (let i = 0; i <= steps; i++) {
+        const t = i / steps;
+        if (t <= ratio)
+            continue;
+        const angle = Math.PI * (1 - t);
+        rest.pixel(cx + Math.cos(angle) * radius, cy - Math.sin(angle) * radius * 0.85);
+    }
+    blit(surface, rest, () => mix(theme.background, theme.border, 0.9), options.background);
+    if (options.label) {
+        const y = surface.height - 1;
+        surface.textAligned(y, options.label, "center", { fg: color, attrs: 1 });
+    }
+}
+/** A ring chart. Reads well from about 12x6 cells. */
+export function donut(surface, options) {
+    if (surface.empty)
+        return;
+    const theme = surface.theme;
+    const total = options.segments.reduce((a, s) => a + Math.max(0, s.value), 0) || 1;
+    const canvas = new BrailleCanvas(surface.width, surface.height);
+    const cx = canvas.width / 2;
+    const cy = canvas.height / 2;
+    const outer = Math.min(canvas.width / 2, canvas.height / 2) - 1;
+    const inner = outer * 0.55;
+    const colorFor = new Map();
+    let angle = -Math.PI / 2;
+    options.segments.forEach((seg, i) => {
+        const sweep = (Math.max(0, seg.value) / total) * Math.PI * 2;
+        const color = seg.color ?? seriesColor(theme, i);
+        const steps = Math.max(8, Math.round(sweep * outer * 3));
+        for (let s = 0; s <= steps; s++) {
+            const a = angle + (sweep * s) / steps;
+            for (let r = inner; r <= outer; r += 0.4) {
+                const x = Math.round(cx + Math.cos(a) * r);
+                const y = Math.round(cy + Math.sin(a) * r * 0.9);
+                canvas.pixel(x, y);
+                colorFor.set(`${x >> 1},${y >> 2}`, color);
+            }
+        }
+        angle += sweep;
+    });
+    blit(surface, canvas, (col, row) => colorFor.get(`${col},${row}`) ?? theme.muted, options.background);
+}
+/** Vertical column chart, one column per value, newest on the right. */
+export function histogram(surface, options) {
+    plot(surface, [{ values: options.values }], {
+        mode: "block",
+        color: options.color,
+        colors: options.colors,
+        background: options.background,
+        max: options.max,
+        min: 0,
+    });
+}
+//# sourceMappingURL=plot.js.map

package/dist/graphics/plot.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,34 @@
+/**
+ * HQTUI — High Quality Terminal UI for TypeScript.
+ *
+ *   import { createApp } from "@profullstack/hqtui";
+ *
+ *   const app = await createApp();
+ *   app.render(({ ui }) => {
+ *     ui.panel({ title: "Hello" }, panel => panel.text("Hello, terminal."));
+ *   });
+ *   await app.start();
+ *
+ * Dark theme, mouse, truecolor, resize handling and terminal restoration are
+ * all on by default. https://hqtui.com
+ */
+export { App, createApp, type AppOptions, type RenderArgs, type RenderFn, type FrameStats } from "./app.ts";
+export { Container, GridContainer } from "./ui.ts";
+export type { RenderContext, ContainerOptions, PanelOptions, GridOptions, CellOptions, HitRegion, } from "./ui.ts";
+export { Terminal, createTerminal, emergencyRestore, type TerminalOptions, type TerminalSize } from "./terminal.ts";
+export { detectCapabilities, type Capabilities, type ColorDepth, type CapabilityOverrides } from "./capabilities.ts";
+export { FrameBuffer, Attr, type Style, type Attributes } from "./buffer.ts";
+export { Encoder, encodeFull, type EncodeResult } from "./diff.ts";
+export { Surface, createSurface, BORDERS, type BorderStyle, type BoxOptions, type Align } from "./surface.ts";
+export { ansi, stripAnsi, moveTo, setTitle } from "./ansi.ts";
+export { rgb, hex, ansi256, gradient, gradientSteps, mix, alpha, lighten, darken, grayscale, luminance, contrast, to256, to16, from256, DEFAULT_COLOR, type Color, } from "./color.ts";
+export { themes, themeList, defineTheme, resolveTheme, elevate, heatColor, seriesColor, type Theme, type ThemeName, } from "./theme.ts";
+export { solve, stack, inset, intersect, contains, isEmpty, fixed, percent, flex, auto, fill, remaining, minmax, normalizePadding, type Rect, type Size, type Constraint, type Padding, } from "./layout.ts";
+export { InputParser, matchKey, type InputEvent, type KeyEvent, type MouseEvent, type PasteEvent, type FocusEvent } from "./input.ts";
+export { stringWidth, truncate, fit, wrap, graphemes, charWidth } from "./unicode.ts";
+export { BrailleCanvas } from "./graphics/braille.ts";
+export { plot, blit, sparkline, bar, gauge, donut, histogram, verticalGlyph, horizontalGlyph, shadeGlyph, bestMode, type Series, type PlotOptions, type FillMode, } from "./graphics/index.ts";
+export * as widgets from "./widgets/index.ts";
+export { renderToScreen, renderToText, renderToAnsi, renderToHtml, renderFrames } from "./testing.ts";
+export type { RenderedScreen, RenderOptions, CellSnapshot } from "./testing.ts";
+//# 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":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,GAAG,EAAE,SAAS,EAAE,KAAK,UAAU,EAAE,KAAK,UAAU,EAAE,KAAK,QAAQ,EAAE,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AAC5G,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACnD,YAAY,EACV,aAAa,EAAE,gBAAgB,EAAE,YAAY,EAAE,WAAW,EAAE,WAAW,EAAE,SAAS,GACnF,MAAM,SAAS,CAAC;AAGjB,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,gBAAgB,EAAE,KAAK,eAAe,EAAE,KAAK,YAAY,EAAE,MAAM,eAAe,CAAC;AACpH,OAAO,EAAE,kBAAkB,EAAE,KAAK,YAAY,EAAE,KAAK,UAAU,EAAE,KAAK,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAGrH,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,KAAK,KAAK,EAAE,KAAK,UAAU,EAAE,MAAM,aAAa,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,UAAU,EAAE,KAAK,YAAY,EAAE,MAAM,WAAW,CAAC;AACnE,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,OAAO,EAAE,KAAK,WAAW,EAAE,KAAK,UAAU,EAAE,KAAK,KAAK,EAAE,MAAM,cAAc,CAAC;AAC9G,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAG9D,OAAO,EACL,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAClF,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,aAAa,EAAE,KAAK,KAAK,GACrE,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,OAAO,EAAE,SAAS,EAAE,WAAW,EAC7E,KAAK,KAAK,EAAE,KAAK,SAAS,GAC3B,MAAM,YAAY,CAAC;AAGpB,OAAO,EACL,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EACnF,SAAS,EAAE,MAAM,EAAE,gBAAgB,EAAE,KAAK,IAAI,EAAE,KAAK,IAAI,EAAE,KAAK,UAAU,EAAE,KAAK,OAAO,GACzF,MAAM,aAAa,CAAC;AAGrB,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,KAAK,UAAU,EAAE,KAAK,QAAQ,EAAE,KAAK,UAAU,EAAE,KAAK,UAAU,EAAE,KAAK,UAAU,EAAE,MAAM,YAAY,CAAC;AAGtI,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAGtF,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EACL,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EACnD,aAAa,EAAE,eAAe,EAAE,UAAU,EAAE,QAAQ,EACpD,KAAK,MAAM,EAAE,KAAK,WAAW,EAAE,KAAK,QAAQ,GAC7C,MAAM,qBAAqB,CAAC;AAG7B,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC;AAG9C,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AACtG,YAAY,EAAE,cAAc,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC"}

package/dist/index.js

@@ -0,0 +1,42 @@
+/**
+ * HQTUI — High Quality Terminal UI for TypeScript.
+ *
+ *   import { createApp } from "@profullstack/hqtui";
+ *
+ *   const app = await createApp();
+ *   app.render(({ ui }) => {
+ *     ui.panel({ title: "Hello" }, panel => panel.text("Hello, terminal."));
+ *   });
+ *   await app.start();
+ *
+ * Dark theme, mouse, truecolor, resize handling and terminal restoration are
+ * all on by default. https://hqtui.com
+ */
+export { App, createApp } from "./app.js";
+export { Container, GridContainer } from "./ui.js";
+// Terminal + capabilities
+export { Terminal, createTerminal, emergencyRestore } from "./terminal.js";
+export { detectCapabilities } from "./capabilities.js";
+// Rendering core
+export { FrameBuffer, Attr } from "./buffer.js";
+export { Encoder, encodeFull } from "./diff.js";
+export { Surface, createSurface, BORDERS } from "./surface.js";
+export { ansi, stripAnsi, moveTo, setTitle } from "./ansi.js";
+// Color
+export { rgb, hex, ansi256, gradient, gradientSteps, mix, alpha, lighten, darken, grayscale, luminance, contrast, to256, to16, from256, DEFAULT_COLOR, } from "./color.js";
+// Theme
+export { themes, themeList, defineTheme, resolveTheme, elevate, heatColor, seriesColor, } from "./theme.js";
+// Layout
+export { solve, stack, inset, intersect, contains, isEmpty, fixed, percent, flex, auto, fill, remaining, minmax, normalizePadding, } from "./layout.js";
+// Input
+export { InputParser, matchKey } from "./input.js";
+// Text
+export { stringWidth, truncate, fit, wrap, graphemes, charWidth } from "./unicode.js";
+// Graphics
+export { BrailleCanvas } from "./graphics/braille.js";
+export { plot, blit, sparkline, bar, gauge, donut, histogram, verticalGlyph, horizontalGlyph, shadeGlyph, bestMode, } from "./graphics/index.js";
+// Widgets (for drawing straight onto a Surface)
+export * as widgets from "./widgets/index.js";
+// Headless rendering + testing
+export { renderToScreen, renderToText, renderToAnsi, renderToHtml, renderFrames } from "./testing.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;;;;;;;;;;;;;GAaG;AAEH,OAAO,EAAE,GAAG,EAAE,SAAS,EAAoE,MAAM,UAAU,CAAC;AAC5G,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AAKnD,0BAA0B;AAC1B,OAAO,EAAE,QAAQ,EAAE,cAAc,EAAE,gBAAgB,EAA2C,MAAM,eAAe,CAAC;AACpH,OAAO,EAAE,kBAAkB,EAAgE,MAAM,mBAAmB,CAAC;AAErH,iBAAiB;AACjB,OAAO,EAAE,WAAW,EAAE,IAAI,EAA+B,MAAM,aAAa,CAAC;AAC7E,OAAO,EAAE,OAAO,EAAE,UAAU,EAAqB,MAAM,WAAW,CAAC;AACnE,OAAO,EAAE,OAAO,EAAE,aAAa,EAAE,OAAO,EAAiD,MAAM,cAAc,CAAC;AAC9G,OAAO,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAE9D,QAAQ;AACR,OAAO,EACL,GAAG,EAAE,GAAG,EAAE,OAAO,EAAE,QAAQ,EAAE,aAAa,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,SAAS,EAClF,SAAS,EAAE,QAAQ,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,EAAE,aAAa,GACzD,MAAM,YAAY,CAAC;AAEpB,QAAQ;AACR,OAAO,EACL,MAAM,EAAE,SAAS,EAAE,WAAW,EAAE,YAAY,EAAE,OAAO,EAAE,SAAS,EAAE,WAAW,GAE9E,MAAM,YAAY,CAAC;AAEpB,SAAS;AACT,OAAO,EACL,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,OAAO,EAAE,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,IAAI,EACnF,SAAS,EAAE,MAAM,EAAE,gBAAgB,GACpC,MAAM,aAAa,CAAC;AAErB,QAAQ;AACR,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAqF,MAAM,YAAY,CAAC;AAEtI,OAAO;AACP,OAAO,EAAE,WAAW,EAAE,QAAQ,EAAE,GAAG,EAAE,IAAI,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AAEtF,WAAW;AACX,OAAO,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AACtD,OAAO,EACL,IAAI,EAAE,IAAI,EAAE,SAAS,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,EAAE,SAAS,EACnD,aAAa,EAAE,eAAe,EAAE,UAAU,EAAE,QAAQ,GAErD,MAAM,qBAAqB,CAAC;AAE7B,gDAAgD;AAChD,OAAO,KAAK,OAAO,MAAM,oBAAoB,CAAC;AAE9C,+BAA+B;AAC/B,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC"}

package/dist/input.d.ts

@@ -0,0 +1,62 @@
+/**
+ * Decodes raw terminal bytes into normalized events. Applications should never
+ * see an escape sequence — only `"ctrl+c"`, `"up"`, or a printable character.
+ */
+export interface KeyEvent {
+    type: "key";
+    /** Normalized name: "a", "up", "enter", "f5", "escape", "space", … */
+    name: string;
+    ctrl: boolean;
+    alt: boolean;
+    shift: boolean;
+    /** The printable character, when there is one. */
+    char?: string;
+    /** Full form including modifiers, e.g. "ctrl+c" — what you usually match on. */
+    key: string;
+    raw: string;
+}
+export interface MouseEvent {
+    type: "mouse";
+    action: "press" | "release" | "move" | "drag" | "scroll";
+    button: "left" | "middle" | "right" | "none";
+    /** Zero-based cell coordinates. */
+    x: number;
+    y: number;
+    /** -1 up, 1 down; 0 when this is not a scroll. */
+    scroll: number;
+    ctrl: boolean;
+    alt: boolean;
+    shift: boolean;
+}
+export interface PasteEvent {
+    type: "paste";
+    text: string;
+}
+export interface FocusEvent {
+    type: "focus";
+    focused: boolean;
+}
+export type InputEvent = KeyEvent | MouseEvent | PasteEvent | FocusEvent;
+/**
+ * Feed it chunks, get events. Stateful so a sequence split across two reads
+ * (common over SSH) still decodes correctly.
+ */
+export declare class InputParser {
+    private pending;
+    private pasteBuffer;
+    /** True when bytes are buffered awaiting the rest of a sequence. */
+    get hasPending(): boolean;
+    /**
+     * Resolve buffered bytes that turned out to be complete after all. A lone ESC
+     * is ambiguous — it only becomes the Escape key once no more bytes follow —
+     * so the terminal calls this on a short timeout.
+     */
+    flush(): InputEvent[];
+    parse(chunk: string): InputEvent[];
+    private parsePlain;
+    private parseEscape;
+    private decodeMouse;
+}
+/** Does this event match a binding like `"ctrl+c"`, `"q"`, or `"f10"`? */
+export declare function matchKey(event: KeyEvent, binding: string): boolean;
+//# sourceMappingURL=input.d.ts.map

package/dist/input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input.d.ts","sourceRoot":"","sources":["../src/input.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,KAAK,CAAC;IACZ,sEAAsE;IACtE,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,OAAO,CAAC;IACd,GAAG,EAAE,OAAO,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;IACf,kDAAkD;IAClD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,gFAAgF;IAChF,GAAG,EAAE,MAAM,CAAC;IACZ,GAAG,EAAE,MAAM,CAAC;CACb;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,QAAQ,CAAC;IACzD,MAAM,EAAE,MAAM,GAAG,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;IAC7C,mCAAmC;IACnC,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,kDAAkD;IAClD,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,CAAC;IACd,GAAG,EAAE,OAAO,CAAC;IACb,KAAK,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,OAAO,CAAC;IACd,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,MAAM,MAAM,UAAU,GAAG,QAAQ,GAAG,UAAU,GAAG,UAAU,GAAG,UAAU,CAAC;AAsCzE;;;GAGG;AACH,qBAAa,WAAW;IACtB,OAAO,CAAC,OAAO,CAAM;IACrB,OAAO,CAAC,WAAW,CAAuB;IAE1C,oEAAoE;IACpE,IAAI,UAAU,IAAI,OAAO,CAExB;IAED;;;;OAIG;IACH,KAAK,IAAI,UAAU,EAAE;IAYrB,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,EAAE;IA4ClC,OAAO,CAAC,UAAU;IA+BlB,OAAO,CAAC,WAAW;IAuEnB,OAAO,CAAC,WAAW;CAmCpB;AAID,0EAA0E;AAC1E,wBAAgB,QAAQ,CAAC,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAKlE"}