@profullstack/hqtui 0.1.0

package/dist/capabilities.js

@@ -0,0 +1,93 @@
+/**
+ * What the terminal can actually do. Detection is deliberately conservative:
+ * we degrade colors and glyphs rather than print mojibake on someone's console.
+ */
+function detectProgram(env) {
+    if (env.KITTY_WINDOW_ID || env.TERM === "xterm-kitty")
+        return "kitty";
+    if (env.WEZTERM_EXECUTABLE || env.TERM_PROGRAM === "WezTerm")
+        return "wezterm";
+    if (env.GHOSTTY_RESOURCES_DIR || env.TERM === "xterm-ghostty")
+        return "ghostty";
+    if (env.TERM_PROGRAM === "iTerm.app")
+        return "iterm";
+    if (env.ALACRITTY_WINDOW_ID || env.TERM === "alacritty")
+        return "alacritty";
+    if (env.TERM_PROGRAM === "vscode")
+        return "vscode";
+    if (env.WT_SESSION)
+        return "windows-terminal";
+    if (env.TERM_PROGRAM === "Apple_Terminal")
+        return "apple-terminal";
+    if (env.KONSOLE_VERSION)
+        return "konsole";
+    if ((env.TERM ?? "").startsWith("xterm"))
+        return "xterm";
+    return "unknown";
+}
+function detectColors(env, tty) {
+    if (env.NO_COLOR !== undefined && env.NO_COLOR !== "")
+        return "none";
+    if (env.FORCE_COLOR === "0")
+        return "none";
+    if (env.FORCE_COLOR === "1")
+        return "ansi16";
+    if (env.FORCE_COLOR === "2")
+        return "ansi256";
+    if (env.FORCE_COLOR === "3")
+        return "truecolor";
+    if (!tty)
+        return "none";
+    const term = env.TERM ?? "";
+    if (term === "dumb")
+        return "none";
+    const colorterm = (env.COLORTERM ?? "").toLowerCase();
+    if (colorterm === "truecolor" || colorterm === "24bit")
+        return "truecolor";
+    const program = detectProgram(env);
+    if (["kitty", "wezterm", "ghostty", "iterm", "vscode", "windows-terminal", "konsole"].includes(program)) {
+        return "truecolor";
+    }
+    if (term.includes("256"))
+        return "ansi256";
+    if (term === "")
+        return "ansi16";
+    return "ansi16";
+}
+function detectUnicode(env) {
+    const locale = env.LC_ALL || env.LC_CTYPE || env.LANG || "";
+    if (/UTF-?8/i.test(locale))
+        return true;
+    // Windows Terminal and modern emulators are UTF-8 regardless of locale vars.
+    if (env.WT_SESSION || env.TERM_PROGRAM || env.KITTY_WINDOW_ID)
+        return true;
+    return process.platform === "win32" ? Boolean(env.WT_SESSION) : locale === "";
+}
+export function detectCapabilities(overrides = {}, env = process.env, stream = process.stdout) {
+    const tty = overrides.tty ?? Boolean(stream.isTTY);
+    const term = env.TERM ?? "";
+    const program = detectProgram(env);
+    const tmux = Boolean(env.TMUX) || term.startsWith("tmux") || term.startsWith("screen");
+    const screen = term.startsWith("screen") && !env.TMUX;
+    const ssh = Boolean(env.SSH_CLIENT || env.SSH_TTY || env.SSH_CONNECTION);
+    const colors = overrides.colors ?? detectColors(env, tty);
+    const unicode = overrides.unicode ?? detectUnicode(env);
+    const syncCapable = ["kitty", "wezterm", "ghostty", "iterm", "windows-terminal", "konsole", "alacritty"].includes(program) || tmux;
+    return {
+        tty,
+        colors,
+        trueColor: colors === "truecolor",
+        unicode,
+        braille: overrides.braille ?? (unicode && program !== "apple-terminal"),
+        mouse: overrides.mouse ?? (tty && term !== "dumb" && term !== "linux"),
+        synchronizedOutput: overrides.synchronizedOutput ?? (tty && syncCapable),
+        bracketedPaste: tty && term !== "dumb",
+        focusEvents: tty && term !== "dumb" && !screen,
+        tmux,
+        screen,
+        ssh,
+        windows: process.platform === "win32",
+        program,
+    };
+}
+//# sourceMappingURL=capabilities.js.map

package/dist/capabilities.js.map

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

package/dist/color.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Colors are packed into a single 32-bit integer so a cell never needs an object.
+ *
+ *   0                       -> "terminal default"
+ *   0x1000000 | 0xRRGGBB    -> truecolor
+ *   0x2000000 | index       -> explicit 256-colour palette index
+ */
+export type Color = number;
+export declare const DEFAULT_COLOR: Color;
+/** Truecolor from 0-255 components. */
+export declare function rgb(r: number, g: number, b: number): Color;
+/** `hex("#00d7ff")`, `hex("#0df")` or `hex(0x00d7ff)`. */
+export declare function hex(value: string | number): Color;
+/** An explicit xterm-256 palette entry (rarely needed; truecolor is quantized for you). */
+export declare function ansi256(index: number): Color;
+export declare function isDefault(c: Color): boolean;
+export declare function red(c: Color): number;
+export declare function green(c: Color): number;
+export declare function blue(c: Color): number;
+/** Mix two colors. `t` of 0 returns `a`, 1 returns `b`. Software alpha — terminals have none. */
+export declare function mix(a: Color, b: Color, t: number): Color;
+/** Blend a color over a background at `alpha` (0-1). Used for subtle fills and shadows. */
+export declare function alpha(fg: Color, bg: Color, a: number): Color;
+export declare function lighten(c: Color, amount?: number): Color;
+export declare function darken(c: Color, amount?: number): Color;
+/** Relative luminance, 0-1. */
+export declare function luminance(c: Color): number;
+/** WCAG contrast ratio between two colors (1-21). */
+export declare function contrast(a: Color, b: Color): number;
+/**
+ * A multi-stop gradient. Returns a sampler: `g(0)` is the first stop, `g(1)` the last.
+ *
+ *   const heat = gradient(["#00d7ff", "#5fff87", "#ffd75f", "#ff5f5f"]);
+ *   heat(0.75);
+ */
+export declare function gradient(stops: (Color | string)[]): (t: number) => Color;
+/** Sample `n` evenly spaced colors from a gradient. */
+export declare function gradientSteps(stops: (Color | string)[], n: number): Color[];
+/** Quantize truecolor to the xterm-256 palette (used when COLORTERM is absent). */
+export declare function to256(c: Color): number;
+/** Quantize truecolor to the 16-color palette (last-resort terminals). */
+export declare function to16(c: Color): number;
+/** Convert a 256-palette index back to truecolor. */
+export declare function from256(index: number): Color;
+/** Desaturate towards grey — powers `monochrome` mode. */
+export declare function grayscale(c: Color): Color;
+//# sourceMappingURL=color.d.ts.map

package/dist/color.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"color.d.ts","sourceRoot":"","sources":["../src/color.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,KAAK,GAAG,MAAM,CAAC;AAE3B,eAAO,MAAM,aAAa,EAAE,KAAS,CAAC;AAItC,uCAAuC;AACvC,wBAAgB,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,KAAK,CAE1D;AAED,0DAA0D;AAC1D,wBAAgB,GAAG,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,KAAK,CAKjD;AAED,2FAA2F;AAC3F,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,CAE5C;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,GAAG,OAAO,CAE3C;AAED,wBAAgB,GAAG,CAAC,CAAC,EAAE,KAAK,GAAG,MAAM,CAEpC;AACD,wBAAgB,KAAK,CAAC,CAAC,EAAE,KAAK,GAAG,MAAM,CAEtC;AACD,wBAAgB,IAAI,CAAC,CAAC,EAAE,KAAK,GAAG,MAAM,CAErC;AAED,iGAAiG;AACjG,wBAAgB,GAAG,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,GAAG,KAAK,CAQxD;AAED,2FAA2F;AAC3F,wBAAgB,KAAK,CAAC,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,GAAG,KAAK,CAE5D;AAED,wBAAgB,OAAO,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,SAAM,GAAG,KAAK,CAErD;AAED,wBAAgB,MAAM,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,SAAM,GAAG,KAAK,CAEpD;AAED,+BAA+B;AAC/B,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,GAAG,MAAM,CAM1C;AAED,qDAAqD;AACrD,wBAAgB,QAAQ,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,KAAK,GAAG,MAAM,CAInD;AAED;;;;;GAKG;AACH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,CAAC,KAAK,GAAG,MAAM,CAAC,EAAE,GAAG,CAAC,CAAC,EAAE,MAAM,KAAK,KAAK,CAUxE;AAED,uDAAuD;AACvD,wBAAgB,aAAa,CAAC,KAAK,EAAE,CAAC,KAAK,GAAG,MAAM,CAAC,EAAE,EAAE,CAAC,EAAE,MAAM,GAAG,KAAK,EAAE,CAK3E;AAiBD,mFAAmF;AACnF,wBAAgB,KAAK,CAAC,CAAC,EAAE,KAAK,GAAG,MAAM,CAYtC;AASD,0EAA0E;AAC1E,wBAAgB,IAAI,CAAC,CAAC,EAAE,KAAK,GAAG,MAAM,CAmBrC;AAED,qDAAqD;AACrD,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,GAAG,KAAK,CAY5C;AAED,0DAA0D;AAC1D,wBAAgB,SAAS,CAAC,CAAC,EAAE,KAAK,GAAG,KAAK,CAIzC"}

package/dist/color.js

@@ -0,0 +1,176 @@
+/**
+ * Colors are packed into a single 32-bit integer so a cell never needs an object.
+ *
+ *   0                       -> "terminal default"
+ *   0x1000000 | 0xRRGGBB    -> truecolor
+ *   0x2000000 | index       -> explicit 256-colour palette index
+ */
+export const DEFAULT_COLOR = 0;
+const RGB_FLAG = 0x1000000;
+const IDX_FLAG = 0x2000000;
+/** Truecolor from 0-255 components. */
+export function rgb(r, g, b) {
+    return RGB_FLAG | ((r & 255) << 16) | ((g & 255) << 8) | (b & 255);
+}
+/** `hex("#00d7ff")`, `hex("#0df")` or `hex(0x00d7ff)`. */
+export function hex(value) {
+    if (typeof value === "number")
+        return RGB_FLAG | (value & 0xffffff);
+    let s = value.trim().replace(/^#/, "");
+    if (s.length === 3)
+        s = s[0] + s[0] + s[1] + s[1] + s[2] + s[2];
+    return RGB_FLAG | (Number.parseInt(s, 16) & 0xffffff);
+}
+/** An explicit xterm-256 palette entry (rarely needed; truecolor is quantized for you). */
+export function ansi256(index) {
+    return IDX_FLAG | (index & 255);
+}
+export function isDefault(c) {
+    return c === DEFAULT_COLOR;
+}
+export function red(c) {
+    return (c >> 16) & 255;
+}
+export function green(c) {
+    return (c >> 8) & 255;
+}
+export function blue(c) {
+    return c & 255;
+}
+/** Mix two colors. `t` of 0 returns `a`, 1 returns `b`. Software alpha — terminals have none. */
+export function mix(a, b, t) {
+    if (isDefault(a) || isDefault(b))
+        return t < 0.5 ? a : b;
+    const k = t < 0 ? 0 : t > 1 ? 1 : t;
+    return rgb(Math.round(red(a) + (red(b) - red(a)) * k), Math.round(green(a) + (green(b) - green(a)) * k), Math.round(blue(a) + (blue(b) - blue(a)) * k));
+}
+/** Blend a color over a background at `alpha` (0-1). Used for subtle fills and shadows. */
+export function alpha(fg, bg, a) {
+    return mix(bg, fg, a);
+}
+export function lighten(c, amount = 0.2) {
+    return mix(c, rgb(255, 255, 255), amount);
+}
+export function darken(c, amount = 0.2) {
+    return mix(c, rgb(0, 0, 0), amount);
+}
+/** Relative luminance, 0-1. */
+export function luminance(c) {
+    const f = (v) => {
+        const x = v / 255;
+        return x <= 0.03928 ? x / 12.92 : ((x + 0.055) / 1.055) ** 2.4;
+    };
+    return 0.2126 * f(red(c)) + 0.7152 * f(green(c)) + 0.0722 * f(blue(c));
+}
+/** WCAG contrast ratio between two colors (1-21). */
+export function contrast(a, b) {
+    const la = luminance(a);
+    const lb = luminance(b);
+    return (Math.max(la, lb) + 0.05) / (Math.min(la, lb) + 0.05);
+}
+/**
+ * A multi-stop gradient. Returns a sampler: `g(0)` is the first stop, `g(1)` the last.
+ *
+ *   const heat = gradient(["#00d7ff", "#5fff87", "#ffd75f", "#ff5f5f"]);
+ *   heat(0.75);
+ */
+export function gradient(stops) {
+    const cols = stops.map((s) => (typeof s === "string" ? hex(s) : s));
+    if (cols.length === 0)
+        return () => DEFAULT_COLOR;
+    if (cols.length === 1)
+        return () => cols[0];
+    return (t) => {
+        const k = t < 0 ? 0 : t > 1 ? 1 : t;
+        const pos = k * (cols.length - 1);
+        const i = Math.min(Math.floor(pos), cols.length - 2);
+        return mix(cols[i], cols[i + 1], pos - i);
+    };
+}
+/** Sample `n` evenly spaced colors from a gradient. */
+export function gradientSteps(stops, n) {
+    const g = gradient(stops);
+    const out = [];
+    for (let i = 0; i < n; i++)
+        out.push(g(n === 1 ? 0 : i / (n - 1)));
+    return out;
+}
+const CUBE = [0, 95, 135, 175, 215, 255];
+function nearestCubeIndex(v) {
+    let best = 0;
+    let bestD = Infinity;
+    for (let i = 0; i < 6; i++) {
+        const d = Math.abs(CUBE[i] - v);
+        if (d < bestD) {
+            bestD = d;
+            best = i;
+        }
+    }
+    return best;
+}
+/** Quantize truecolor to the xterm-256 palette (used when COLORTERM is absent). */
+export function to256(c) {
+    if ((c & IDX_FLAG) !== 0)
+        return c & 255;
+    const r = red(c);
+    const g = green(c);
+    const b = blue(c);
+    // Grey ramp often beats the cube for desaturated colors.
+    if (Math.abs(r - g) < 8 && Math.abs(g - b) < 8) {
+        if (r < 8)
+            return 16;
+        if (r > 248)
+            return 231;
+        return 232 + Math.round(((r - 8) / 247) * 24);
+    }
+    return 16 + 36 * nearestCubeIndex(r) + 6 * nearestCubeIndex(g) + nearestCubeIndex(b);
+}
+const BASE16 = [
+    [0, 0, 0], [205, 49, 49], [13, 188, 121], [229, 229, 16],
+    [36, 114, 200], [188, 63, 188], [17, 168, 205], [229, 229, 229],
+    [102, 102, 102], [241, 76, 76], [35, 209, 139], [245, 245, 67],
+    [59, 142, 234], [214, 112, 214], [41, 184, 219], [255, 255, 255],
+];
+/** Quantize truecolor to the 16-color palette (last-resort terminals). */
+export function to16(c) {
+    if ((c & IDX_FLAG) !== 0) {
+        const i = c & 255;
+        return i < 16 ? i : to16(from256(i));
+    }
+    const r = red(c);
+    const g = green(c);
+    const b = blue(c);
+    let best = 7;
+    let bestD = Infinity;
+    for (let i = 0; i < 16; i++) {
+        const [br, bg, bb] = BASE16[i];
+        const d = (r - br) ** 2 + (g - bg) ** 2 + (b - bb) ** 2;
+        if (d < bestD) {
+            bestD = d;
+            best = i;
+        }
+    }
+    return best;
+}
+/** Convert a 256-palette index back to truecolor. */
+export function from256(index) {
+    const i = index & 255;
+    if (i < 16) {
+        const [r, g, b] = BASE16[i];
+        return rgb(r, g, b);
+    }
+    if (i >= 232) {
+        const v = 8 + (i - 232) * 10;
+        return rgb(v, v, v);
+    }
+    const n = i - 16;
+    return rgb(CUBE[Math.floor(n / 36) % 6], CUBE[Math.floor(n / 6) % 6], CUBE[n % 6]);
+}
+/** Desaturate towards grey — powers `monochrome` mode. */
+export function grayscale(c) {
+    if (isDefault(c))
+        return c;
+    const v = Math.round(0.299 * red(c) + 0.587 * green(c) + 0.114 * blue(c));
+    return rgb(v, v, v);
+}
+//# sourceMappingURL=color.js.map

package/dist/color.js.map

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

package/dist/diff.d.ts

@@ -0,0 +1,39 @@
+import type { FrameBuffer } from "./buffer.ts";
+import type { Capabilities } from "./capabilities.ts";
+export interface EncodeResult {
+    /** The bytes to hand to stdout. */
+    output: string;
+    changedCells: number;
+    /** Rows that contained at least one change. */
+    dirtyRows: number;
+}
+export interface EncoderOptions {
+    colors?: Capabilities["colors"];
+    /** Drain all color, keeping attributes. */
+    monochrome?: boolean;
+}
+/**
+ * Turns two framebuffers into the smallest practical stream of escape sequences.
+ * It keeps a model of the terminal's current pen so no redundant SGR is emitted.
+ */
+export declare class Encoder {
+    private state;
+    private parts;
+    colors: Capabilities["colors"];
+    monochrome: boolean;
+    constructor(options?: EncoderOptions);
+    /** Forget what we believe about the terminal; the next write re-states everything. */
+    invalidateState(): void;
+    private fgSeq;
+    private bgSeq;
+    private applyStyle;
+    private moveCursor;
+    /**
+     * Encode the difference between `prev` and `next`.
+     * Pass `full` to repaint every cell (first frame, resize, or after a redraw request).
+     */
+    encode(prev: FrameBuffer, next: FrameBuffer, full?: boolean): EncodeResult;
+}
+/** One-shot encode of a whole buffer, e.g. for `renderToAnsi` in tests. */
+export declare function encodeFull(buffer: FrameBuffer, options?: EncoderOptions): string;
+//# sourceMappingURL=diff.d.ts.map

package/dist/diff.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"diff.d.ts","sourceRoot":"","sources":["../src/diff.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAuBtD,MAAM,WAAW,YAAY;IAC3B,mCAAmC;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,+CAA+C;IAC/C,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,cAAc;IAC7B,MAAM,CAAC,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC;IAChC,2CAA2C;IAC3C,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAED;;;GAGG;AACH,qBAAa,OAAO;IAClB,OAAO,CAAC,KAAK,CAAiG;IAC9G,OAAO,CAAC,KAAK,CAAgB;IAC7B,MAAM,EAAE,YAAY,CAAC,QAAQ,CAAC,CAAC;IAC/B,UAAU,EAAE,OAAO,CAAC;gBAER,OAAO,GAAE,cAAmB;IAKxC,sFAAsF;IACtF,eAAe,IAAI,IAAI;IAKvB,OAAO,CAAC,KAAK;IASb,OAAO,CAAC,KAAK;IASb,OAAO,CAAC,UAAU;IAqClB,OAAO,CAAC,UAAU;IAoBlB;;;OAGG;IACH,MAAM,CAAC,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,UAAQ,GAAG,YAAY;CA4EzE;AAED,2EAA2E;AAC3E,wBAAgB,UAAU,CAAC,MAAM,EAAE,WAAW,EAAE,OAAO,GAAE,cAAmB,GAAG,MAAM,CAIpF"}

package/dist/diff.js

@@ -0,0 +1,203 @@
+import { Attr } from "./buffer.js";
+import { DEFAULT_COLOR, blue, green, grayscale, red, to16, to256 } from "./color.js";
+import { CSI, bg16, bg256, bgDefault, bgTrue, fg16, fg256, fgDefault, fgTrue, moveTo, moveToColumn, moveRight, } from "./ansi.js";
+import { CONTINUATION, cellText, cellWidth } from "./unicode.js";
+/**
+ * Rewriting up to this many unchanged cells is cheaper than the escape sequence
+ * needed to jump over them, so neighbouring dirty spans get merged.
+ */
+const GAP_MERGE = 5;
+/**
+ * Turns two framebuffers into the smallest practical stream of escape sequences.
+ * It keeps a model of the terminal's current pen so no redundant SGR is emitted.
+ */
+export class Encoder {
+    state = { x: -1, y: -1, known: false, fg: DEFAULT_COLOR, bg: DEFAULT_COLOR, attrs: 0 };
+    parts = [];
+    colors;
+    monochrome;
+    constructor(options = {}) {
+        this.colors = options.colors ?? "truecolor";
+        this.monochrome = options.monochrome ?? false;
+    }
+    /** Forget what we believe about the terminal; the next write re-states everything. */
+    invalidateState() {
+        this.state = { x: -1, y: -1, known: false, fg: DEFAULT_COLOR, bg: DEFAULT_COLOR, attrs: 0 };
+        this.parts.push(`${CSI}0m`);
+    }
+    fgSeq(c) {
+        if (this.colors === "none")
+            return "";
+        if (c === DEFAULT_COLOR)
+            return fgDefault;
+        const col = this.monochrome ? grayscale(c) : c;
+        if (this.colors === "truecolor")
+            return fgTrue(red(col), green(col), blue(col));
+        if (this.colors === "ansi256")
+            return fg256(to256(col));
+        return fg16(to16(col));
+    }
+    bgSeq(c) {
+        if (this.colors === "none")
+            return "";
+        if (c === DEFAULT_COLOR)
+            return bgDefault;
+        const col = this.monochrome ? grayscale(c) : c;
+        if (this.colors === "truecolor")
+            return bgTrue(red(col), green(col), blue(col));
+        if (this.colors === "ansi256")
+            return bg256(to256(col));
+        return bg16(to16(col));
+    }
+    applyStyle(fg, bg, attrs) {
+        const s = this.state;
+        if (s.fg === fg && s.bg === bg && s.attrs === attrs)
+            return;
+        // Attributes can only be added cheaply; removing one means a full reset.
+        const removed = s.attrs & ~attrs;
+        if (removed !== 0) {
+            this.parts.push(`${CSI}0m`);
+            s.attrs = 0;
+            s.fg = DEFAULT_COLOR;
+            s.bg = DEFAULT_COLOR;
+        }
+        const added = attrs & ~s.attrs;
+        if (added !== 0) {
+            const codes = [];
+            if (added & Attr.Bold)
+                codes.push(1);
+            if (added & Attr.Dim)
+                codes.push(2);
+            if (added & Attr.Italic)
+                codes.push(3);
+            if (added & Attr.Underline)
+                codes.push(4);
+            if (added & Attr.Blink)
+                codes.push(5);
+            if (added & Attr.Reverse)
+                codes.push(7);
+            if (added & Attr.Strike)
+                codes.push(9);
+            if (codes.length)
+                this.parts.push(`${CSI}${codes.join(";")}m`);
+            s.attrs = attrs;
+        }
+        if (s.fg !== fg) {
+            this.parts.push(this.fgSeq(fg));
+            s.fg = fg;
+        }
+        if (s.bg !== bg) {
+            this.parts.push(this.bgSeq(bg));
+            s.bg = bg;
+        }
+    }
+    moveCursor(x, y) {
+        const s = this.state;
+        if (s.known && s.y === y) {
+            if (s.x === x)
+                return;
+            if (x > s.x && x - s.x <= 3) {
+                // Short hop: cheaper than a full CUP, and never repaints cells.
+                this.parts.push(moveRight(x - s.x));
+            }
+            else if (x === 0) {
+                this.parts.push("\r");
+            }
+            else {
+                this.parts.push(moveToColumn(x));
+            }
+        }
+        else {
+            this.parts.push(moveTo(x, y));
+        }
+        s.x = x;
+        s.y = y;
+        s.known = true;
+    }
+    /**
+     * Encode the difference between `prev` and `next`.
+     * Pass `full` to repaint every cell (first frame, resize, or after a redraw request).
+     */
+    encode(prev, next, full = false) {
+        this.parts.length = 0;
+        let changed = 0;
+        let dirtyRows = 0;
+        const w = next.width;
+        const h = next.height;
+        const sameSize = prev.width === w && prev.height === h;
+        const repaint = full || !sameSize;
+        if (repaint)
+            this.invalidateState();
+        const nc = next.chars;
+        const nf = next.fg;
+        const nb = next.bg;
+        const na = next.attrs;
+        const pc = prev.chars;
+        const pf = prev.fg;
+        const pb = prev.bg;
+        const pa = prev.attrs;
+        for (let y = 0; y < h; y++) {
+            const rowStart = y * w;
+            let x = 0;
+            let rowDirty = false;
+            while (x < w) {
+                const i = rowStart + x;
+                const dirty = repaint || nc[i] !== pc[i] || nf[i] !== pf[i] || nb[i] !== pb[i] || na[i] !== pa[i];
+                if (!dirty) {
+                    x++;
+                    continue;
+                }
+                // Walk left onto the lead cell if we landed on a wide char's tail.
+                let start = x;
+                while (start > 0 && nc[rowStart + start] === CONTINUATION)
+                    start--;
+                // Extend the run while cells are dirty, tolerating short clean gaps.
+                let end = start;
+                let clean = 0;
+                let probe = start;
+                while (probe < w) {
+                    const j = rowStart + probe;
+                    const d = repaint || nc[j] !== pc[j] || nf[j] !== pf[j] || nb[j] !== pb[j] || na[j] !== pa[j];
+                    if (d) {
+                        end = probe;
+                        clean = 0;
+                    }
+                    else {
+                        clean++;
+                        if (clean > GAP_MERGE)
+                            break;
+                    }
+                    probe++;
+                }
+                this.moveCursor(start, y);
+                for (let cx = start; cx <= end; cx++) {
+                    const j = rowStart + cx;
+                    const value = nc[j];
+                    if (value === CONTINUATION)
+                        continue; // emitted with its lead cell
+                    this.applyStyle(nf[j], nb[j], na[j]);
+                    this.parts.push(value === 0 ? " " : cellText(value));
+                    const cw = Math.max(1, cellWidth(value));
+                    this.state.x += cw;
+                    if (nc[j] !== pc[j] || nf[j] !== pf[j] || nb[j] !== pb[j] || na[j] !== pa[j])
+                        changed++;
+                }
+                // Writing the final column may have triggered autowrap; stop trusting x.
+                if (this.state.x >= w)
+                    this.state.known = false;
+                rowDirty = true;
+                x = end + 1;
+            }
+            if (rowDirty)
+                dirtyRows++;
+        }
+        return { output: this.parts.join(""), changedCells: changed, dirtyRows };
+    }
+}
+/** One-shot encode of a whole buffer, e.g. for `renderToAnsi` in tests. */
+export function encodeFull(buffer, options = {}) {
+    const encoder = new Encoder(options);
+    const empty = { ...buffer, width: -1, height: -1 };
+    return encoder.encode(empty, buffer, true).output;
+}
+//# sourceMappingURL=diff.js.map

package/dist/diff.js.map

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

package/dist/graphics/blocks.d.ts

@@ -0,0 +1,26 @@
+/** Sub-cell glyph ramps. Every one degrades to ASCII when Unicode is off. */
+/** Left-to-right eighths: ▏▎▍▌▋▊▉█ — horizontal bars and meters. */
+export declare const HORIZONTAL_EIGHTHS: string[];
+/** Bottom-up eighths: ▁▂▃▄▅▆▇█ — sparklines and column charts. */
+export declare const VERTICAL_EIGHTHS: string[];
+/** Two vertical halves, for double-density line plots. */
+export declare const HALF_BLOCKS: {
+    readonly upper: "▀";
+    readonly lower: "▄";
+    readonly full: "█";
+    readonly empty: " ";
+};
+/** Quadrants indexed by a 4-bit mask: 1=TL, 2=TR, 4=BL, 8=BR. */
+export declare const QUADRANTS: string[];
+export declare const SHADES: string[];
+export declare const ASCII_RAMP: string[];
+export type FillMode = "braille" | "block" | "half" | "quadrant" | "ascii";
+/** Pick the glyph for a 0-1 fill of one cell, bottom-up. */
+export declare function verticalGlyph(ratio: number, mode?: FillMode): string;
+/** Pick the glyph for a 0-1 fill of one cell, left to right. */
+export declare function horizontalGlyph(ratio: number, mode?: FillMode): string;
+/** Map a 0-1 value onto a shade block, for heatmaps and dim fills. */
+export declare function shadeGlyph(ratio: number, unicode?: boolean): string;
+/** Braille when the terminal supports it, blocks when it does not. */
+export declare function bestMode(unicode: boolean, braille: boolean): FillMode;
+//# sourceMappingURL=blocks.d.ts.map

package/dist/graphics/blocks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"blocks.d.ts","sourceRoot":"","sources":["../../src/graphics/blocks.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAE7E,oEAAoE;AACpE,eAAO,MAAM,kBAAkB,UAA+C,CAAC;AAC/E,kEAAkE;AAClE,eAAO,MAAM,gBAAgB,UAA+C,CAAC;AAC7E,0DAA0D;AAC1D,eAAO,MAAM,WAAW;;;;;CAA6D,CAAC;AACtF,iEAAiE;AACjE,eAAO,MAAM,SAAS,UAErB,CAAC;AACF,eAAO,MAAM,MAAM,UAAuB,CAAC;AAC3C,eAAO,MAAM,UAAU,UAAqD,CAAC;AAE7E,MAAM,MAAM,QAAQ,GAAG,SAAS,GAAG,OAAO,GAAG,MAAM,GAAG,UAAU,GAAG,OAAO,CAAC;AAE3E,4DAA4D;AAC5D,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,QAAkB,GAAG,MAAM,CAM7E;AAED,gEAAgE;AAChE,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,GAAE,QAAkB,GAAG,MAAM,CAK/E;AAED,sEAAsE;AACtE,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,UAAO,GAAG,MAAM,CAKhE;AAED,sEAAsE;AACtE,wBAAgB,QAAQ,CAAC,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,GAAG,QAAQ,CAIrE"}