@inhuman.tools/quickdraw 0.0.0-bootstrap.0 → 0.2.0

package/dist/buffer/index.js

@@ -0,0 +1,353 @@
+/**
+ * Dual-frame cell buffer + row damage + ANSI emit + content guard.
+ * No layout. No TEA. Pure grid → bytes.
+ *
+ * Wide glyphs: display width 2+ → glyph cell + trailing placeholder cells.
+ * Emit **skips** placeholders (TERMINAL P3) so terminals don't advance 3 cols.
+ */
+import { graphemeWidth, isTwoColumnSymbol, isUnitWidthRun } from "../measure/index.js";
+const GRAPHEME_SEGMENTER = new Intl.Segmenter(undefined, {
+    granularity: "grapheme",
+});
+/** Clamp a byte channel to [0,255]; non-finite → 0. Used by SGR emit. */
+function clampByte(n) {
+    if (!Number.isFinite(n))
+        return 0;
+    return Math.max(0, Math.min(255, Math.round(n)));
+}
+// ── Content guard ───────────────────────────────────────────────────────────
+// Model/user text must never emit CSI that mutates the terminal.
+const CSI_OR_ESC = /\u001B\[[0-9;?]*[ -/]*[@-~]|\u001B./g;
+// C2: OSC (ESC ] ... BEL/ST), DCS/SOS/PM/APC (ESC P/X/^/_ ... ST) carry payloads
+// (hyperlinks via OSC 8, titles via OSC 0, color queries) that must not leak as
+// visible text. Match terminated first, then strip any dangling intro byte.
+const OSC_OR_DCS = /\u001B\][^\u0007\u001B]*(?:\u0007|\u001B\\)|\u001B[PX^_][^\u001B]*\u001B\\/g;
+// Partial intros only: OSC = ESC ], DCS/SOS/PM/APC = ESC P / X / ^ / _.
+// (Was `/\x1b[][PX^_]/g` — empty class `[]` matched nothing, ever.)
+const OSC_OR_DCS_PARTIAL = /\u001B[\]PX^_]/g;
+/**
+ * Sanitize text that will be painted as content cells (not our emit path).
+ * Removes ESC/CSI/OSC/DCS entirely for v1 (safest).
+ */
+export function guardContent(text) {
+    if (!text.includes("\u001B") && !text.includes("\u009B"))
+        return text;
+    // OSC/DCS first — they contain their own ESC, so strip before CSI regex sees them.
+    let out = text.replaceAll(OSC_OR_DCS, "");
+    out = out.replaceAll(OSC_OR_DCS_PARTIAL, "");
+    out = out.replaceAll(CSI_OR_ESC, "");
+    out = out.replaceAll(/\u009B[0-9;?]*[ -/]*[@-~]/g, "");
+    out = out.replaceAll("\u001B", "");
+    return out;
+}
+const BLANK = { ch: " ", style: {} };
+/** Sentinel ch for placeholder mates — never emitted. */
+export const PLACEHOLDER_CH = "";
+// ── Grid ops ────────────────────────────────────────────────────────────────
+export function createBuffer(width, height) {
+    const n = width * height;
+    const cells = new Array(n);
+    for (let i = 0; i < n; i++)
+        cells[i] = { ...BLANK, style: {} };
+    return { width, height, cells };
+}
+export function clear(buf) {
+    for (let i = 0; i < buf.cells.length; i++) {
+        buf.cells[i] = { ch: " ", style: {} };
+    }
+}
+/**
+ * Transparent bg inherits the cell under paint (panel fill under border/text).
+ * Explicit `bg` / `bgRgb` / `bgFx` on the incoming style wins. Matches TERMINAL O1:
+ * undefined bg means transparent, not "clear to black."
+ * `cast: "transparent"` claims that absence — occupy the cell, do not fuse.
+ * Procedural `bgFx` (+ baked UV) also inherits so text/border over fx keeps the field.
+ */
+export function mergeStyle(under, over) {
+    const out = { ...over };
+    const overClaimsBg = over.bg !== undefined || over.bgRgb !== undefined || over.bgFx !== undefined;
+    if (overClaimsBg || over.cast === "transparent")
+        return out;
+    if (under.bgFx !== undefined) {
+        out.bgFx = under.bgFx;
+        if (under.bgFxU !== undefined)
+            out.bgFxU = under.bgFxU;
+        if (under.bgFxV !== undefined)
+            out.bgFxV = under.bgFxV;
+        if (under.bgFxOpacity !== undefined)
+            out.bgFxOpacity = under.bgFxOpacity;
+        if (under.bgRgb !== undefined)
+            out.bgRgb = under.bgRgb;
+    }
+    else if (under.bgRgb !== undefined) {
+        out.bgRgb = under.bgRgb;
+    }
+    else if (under.bg !== undefined) {
+        out.bg = under.bg;
+    }
+    return out;
+}
+function writeCell(buf, x, y, cell) {
+    if (x < 0 || x >= buf.width || y < 0 || y >= buf.height)
+        return;
+    const i = y * buf.width + x;
+    const prev = buf.cells[i];
+    // C1/C6: overwriting a wide glyph's primary cell (prev non-placeholder whose
+    // trailing mate(s) are placeholders) orphans those placeholders — whether the
+    // incoming cell is a narrow glyph (C1) or a new wide glyph's placeholder that
+    // lands on the old primary (C6: put("a漢") then put("漢")). Emit skips
+    // placeholders, so an orphan shifts subsequent columns. Clear consecutive
+    // trailing mates on this row before writing.
+    if (!prev.placeholder) {
+        const rowEnd = (y + 1) * buf.width;
+        for (let j = i + 1; j < rowEnd; j++) {
+            const mate = buf.cells[j];
+            if (!mate?.placeholder)
+                break;
+            buf.cells[j] = { ...BLANK };
+        }
+    }
+    buf.cells[i] = {
+        ...cell,
+        style: mergeStyle(prev.style, cell.style),
+    };
+}
+/**
+ * Put text at (x,y) walking **grapheme clusters** by display width.
+ * - **ContentGuard first** — strip ESC/CSI so measure (string-width strips ANSI)
+ *   and put agree. Bare ESC is width 0; leaving `[2J…` after skipping ESC desyncs
+ *   layout width and can still break a live terminal if re-emitted.
+ * - width 0 (combining/ZW alone): refused — do not advance
+ * - width 1: one cell
+ * - width ≥ 2: glyph + (w-1) mates; clips if no room for full wide span.
+ *   CJK/emoji mates are placeholders (emit skips). {@link isTwoColumnSymbol}
+ *   mates are a real space so a wcwidth-1 TTY still advances past the ink.
+ */
+export function put(buf, x, y, text, style = {}) {
+    if (y < 0 || y >= buf.height)
+        return;
+    // Chokepoint: all content paths (markdown, highlight, widgets) land here.
+    text = guardContent(text);
+    let cx = x;
+    if (isUnitWidthRun(text)) {
+        for (const element of text) {
+            if (cx >= buf.width)
+                break;
+            if (cx >= 0) {
+                writeCell(buf, cx, y, { ch: element, style, placeholder: false });
+            }
+            cx += 1;
+        }
+        return;
+    }
+    for (const { segment } of GRAPHEME_SEGMENTER.segment(text)) {
+        const w = Math.max(0, graphemeWidth(segment));
+        if (w === 0)
+            continue;
+        if (cx + w > buf.width) {
+            if (cx >= buf.width)
+                break;
+            if (w > 1)
+                break;
+        }
+        if (cx < 0) {
+            cx += w;
+            continue;
+        }
+        writeCell(buf, cx, y, { ch: segment, style, placeholder: false });
+        const pad = isTwoColumnSymbol(segment);
+        for (let k = 1; k < w; k++) {
+            writeCell(buf, cx + k, y, {
+                ch: pad ? " " : PLACEHOLDER_CH,
+                style,
+                placeholder: !pad,
+            });
+        }
+        cx += w;
+    }
+}
+// ── Damage ──────────────────────────────────────────────────────────────────
+function rgbEq(a, b) {
+    if (a === b)
+        return true;
+    if (!a || !b)
+        return false;
+    return a.r === b.r && a.g === b.g && a.b === b.b;
+}
+function cellEq(a, b) {
+    return (a.ch === b.ch &&
+        !!a.placeholder === !!b.placeholder &&
+        a.style.bold === b.style.bold &&
+        a.style.dim === b.style.dim &&
+        a.style.strike === b.style.strike &&
+        a.style.italic === b.style.italic &&
+        a.style.underline === b.style.underline &&
+        a.style.href === b.style.href &&
+        a.style.fg === b.style.fg &&
+        a.style.bg === b.style.bg &&
+        a.style.bgFx === b.style.bgFx &&
+        a.style.bgFxU === b.style.bgFxU &&
+        a.style.bgFxV === b.style.bgFxV &&
+        // C3: dual-dirty resolver fields — a role/prominence shift between frames
+        // must mark the row dirty, or emitAnsi skips it (silent stale frame).
+        a.style.role === b.style.role &&
+        a.style.prominence === b.style.prominence &&
+        a.style.bgRole === b.style.bgRole &&
+        a.style.bgProminence === b.style.bgProminence &&
+        a.style.surfaceRole === b.style.surfaceRole &&
+        a.style.surfaceProminence === b.style.surfaceProminence &&
+        a.style.fuseRole === b.style.fuseRole &&
+        a.style.fuseProminence === b.style.fuseProminence &&
+        a.style.tintRole === b.style.tintRole &&
+        a.style.tint === b.style.tint &&
+        a.style.regionProminence === b.style.regionProminence &&
+        a.style.bgFxOpacity === b.style.bgFxOpacity &&
+        a.style.cast === b.style.cast &&
+        rgbEq(a.style.fgRgb, b.style.fgRgb) &&
+        rgbEq(a.style.bgRgb, b.style.bgRgb) &&
+        // Selection toggle must dirty the row so the recolor re-resolves.
+        a.style.selected === b.style.selected);
+}
+function rowEq(prev, next, y) {
+    const w = next.width;
+    const base = y * w;
+    for (let x = 0; x < w; x++) {
+        if (!cellEq(prev.cells[base + x], next.cells[base + x]))
+            return false;
+    }
+    return true;
+}
+/** Rows that differ (or all rows if size changed / no prev). */
+export function dirtyRows(prev, next) {
+    if (!prev || prev.width !== next.width || prev.height !== next.height) {
+        return Array.from({ length: next.height }, (_, i) => i);
+    }
+    const out = [];
+    for (let y = 0; y < next.height; y++) {
+        if (!rowEq(prev, next, y))
+            out.push(y);
+    }
+    return out;
+}
+// ── ANSI emit ───────────────────────────────────────────────────────────────
+/** Clamp an ANSI 256 color index; non-finite/out-of-range → undefined (omit). */
+function clampIndex(n) {
+    if (!Number.isFinite(n))
+        return undefined;
+    return Math.max(0, Math.min(255, Math.round(n)));
+}
+function osc8Href(href) {
+    if (href === undefined || href === "")
+        return "";
+    if (!/^https?:\/\//i.test(href))
+        return "";
+    if (/[\u0000-\u001F\u007F]/.test(href))
+        return "";
+    return href;
+}
+function sgr(style) {
+    const parts = ["0"];
+    if (style.bold)
+        parts.push("1");
+    if (style.dim)
+        parts.push("2");
+    if (style.italic)
+        parts.push("3");
+    if (style.underline)
+        parts.push("4");
+    if (style.strike)
+        parts.push("9");
+    if (style.fgRgb) {
+        // H2: clamp each channel — NaN/Infinity/out-of-range must not corrupt SGR.
+        const { r, g, b } = style.fgRgb;
+        parts.push(`38;2;${clampByte(r)};${clampByte(g)};${clampByte(b)}`);
+    }
+    else if (style.fg !== undefined) {
+        const c = clampIndex(style.fg);
+        if (c !== undefined)
+            parts.push(`38;5;${c}`);
+    }
+    if (style.bgRgb) {
+        const { r, g, b } = style.bgRgb;
+        parts.push(`48;2;${clampByte(r)};${clampByte(g)};${clampByte(b)}`);
+    }
+    else if (style.bg !== undefined) {
+        const c = clampIndex(style.bg);
+        if (c !== undefined)
+            parts.push(`48;5;${c}`);
+    }
+    return `\u001B[${parts.join(";")}m`;
+}
+/**
+ * Emit ANSI for dirty rows with wire metrics.
+ * Absolute CUP, clear line, write row.
+ * **Skips placeholder cells** so wide glyphs advance 2 columns, not 3.
+ * Optional Mode 2026 wrap.
+ */
+export function emitAnsiDetailed(prev, next, opts = {}) {
+    const rows = opts.forceFull ? Array.from({ length: next.height }, (_, i) => i) : dirtyRows(prev, next);
+    if (rows.length === 0) {
+        return { ansi: "", dirtyRows: 0, bytes: 0 };
+    }
+    const chunks = [];
+    if (opts.sync2026)
+        chunks.push("\u001B[?2026h");
+    if (opts.forceFull || !prev)
+        chunks.push("\u001B[2J");
+    for (const y of rows) {
+        chunks.push(`\u001B[${y + 1};1H\u001B[0m\u001B[2K`);
+        let runStyle = "";
+        let runHref = "";
+        let run = "";
+        const flush = () => {
+            if (!run)
+                return;
+            if (runHref !== "")
+                chunks.push(`\u001B]8;;${runHref}\u001B\\`);
+            chunks.push(`${runStyle + run}\u001B[0m`);
+            if (runHref !== "")
+                chunks.push("\u001B]8;;\u001B\\");
+            run = "";
+        };
+        for (let x = 0; x < next.width; x++) {
+            const cell = next.cells[y * next.width + x];
+            if (cell.placeholder)
+                continue;
+            const st = sgr(cell.style);
+            const href = osc8Href(cell.style.href);
+            if (st !== runStyle || href !== runHref) {
+                flush();
+                runStyle = st;
+                runHref = href;
+            }
+            run += cell.ch;
+        }
+        flush();
+    }
+    if (opts.sync2026)
+        chunks.push("\u001B[?2026l");
+    const ansi = chunks.join("");
+    return { ansi, dirtyRows: rows.length, bytes: ansi.length };
+}
+/**
+ * Emit ANSI for dirty rows. Absolute CUP, clear line, write row.
+ * **Skips placeholder cells** so wide glyphs advance 2 columns, not 3.
+ * Optional Mode 2026 wrap.
+ */
+export function emitAnsi(prev, next, opts = {}) {
+    return emitAnsiDetailed(prev, next, opts).ansi;
+}
+/** Shallow copy of buffer cells (for storing previous frame). */
+export function cloneBuffer(buf) {
+    return {
+        width: buf.width,
+        height: buf.height,
+        cells: buf.cells.map((c) => ({
+            ch: c.ch,
+            style: { ...c.style },
+            placeholder: c.placeholder,
+        })),
+    };
+}
+export { fillBgFx } from "./bgfx-mark.js";
+//# sourceMappingURL=index.js.map

package/dist/buffer/index.js.map

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

package/dist/capabilities/env.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Env-based color depth heuristics when probes are unavailable.
+ * Conservative defaults — prefer under-claiming over broken truecolor.
+ */
+import type { ColorDepth } from "./types.js";
+export type EnvLike = {
+    COLORTERM?: string | undefined;
+    TERM?: string | undefined;
+    TERM_PROGRAM?: string | undefined;
+    WT_SESSION?: string | undefined;
+    /** https://no-color.org — presence (any value, including "") wins over everything else. */
+    NO_COLOR?: string | undefined;
+    [key: string]: string | undefined;
+};
+/**
+ * Guess ColorDepth from environment.
+ * - NO_COLOR set (any value) → mono, before any other signal (no-color.org)
+ * - COLORTERM=truecolor|24bit → truecolor
+ * - TERM=*256color* → ansi256
+ * - else ansi16
+ */
+export declare function guessColorDepth(env?: EnvLike): ColorDepth;
+//# sourceMappingURL=env.d.ts.map

package/dist/capabilities/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../src/capabilities/env.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAE7C,MAAM,MAAM,OAAO,GAAG;IACpB,SAAS,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC/B,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC1B,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,UAAU,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAChC,2FAA2F;IAC3F,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC9B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CACnC,CAAC;AAEF;;;;;;GAMG;AACH,wBAAgB,eAAe,CAAC,GAAG,GAAE,OAAqB,GAAG,UAAU,CAqBtE"}

package/dist/capabilities/env.js

@@ -0,0 +1,35 @@
+/**
+ * Env-based color depth heuristics when probes are unavailable.
+ * Conservative defaults — prefer under-claiming over broken truecolor.
+ */
+/**
+ * Guess ColorDepth from environment.
+ * - NO_COLOR set (any value) → mono, before any other signal (no-color.org)
+ * - COLORTERM=truecolor|24bit → truecolor
+ * - TERM=*256color* → ansi256
+ * - else ansi16
+ */
+export function guessColorDepth(env = process.env) {
+    if (env.NO_COLOR !== undefined)
+        return "mono";
+    const ct = (env.COLORTERM ?? "").toLowerCase();
+    if (ct === "truecolor" || ct === "24bit")
+        return "truecolor";
+    const term = env.TERM ?? "";
+    if (/256color|truecolor|direct/i.test(term)) {
+        // xterm-direct / *-truecolor often still set TERM with 256color or truecolor
+        if (/truecolor|direct/i.test(term))
+            return "truecolor";
+        return "ansi256";
+    }
+    // Well-known truecolor hosts even with dumb TERM.
+    // Terminal.app (`Apple_Terminal`) is not truecolor — do not add it here.
+    if (env.TERM_PROGRAM === "iTerm.app")
+        return "truecolor";
+    if (env.WT_SESSION)
+        return "truecolor";
+    if (/^xterm|^screen|^tmux|^rxvt|^vt100/i.test(term))
+        return "ansi16";
+    return "ansi16";
+}
+//# sourceMappingURL=env.js.map

package/dist/capabilities/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../src/capabilities/env.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAcH;;;;;;GAMG;AACH,MAAM,UAAU,eAAe,CAAC,MAAe,OAAO,CAAC,GAAG;IACxD,IAAI,GAAG,CAAC,QAAQ,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC;IAE9C,MAAM,EAAE,GAAG,CAAC,GAAG,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC;IAC/C,IAAI,EAAE,KAAK,WAAW,IAAI,EAAE,KAAK,OAAO;QAAE,OAAO,WAAW,CAAC;IAE7D,MAAM,IAAI,GAAG,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC;IAC5B,IAAI,4BAA4B,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;QAC5C,6EAA6E;QAC7E,IAAI,mBAAmB,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,OAAO,WAAW,CAAC;QACvD,OAAO,SAAS,CAAC;IACnB,CAAC;IAED,kDAAkD;IAClD,yEAAyE;IACzE,IAAI,GAAG,CAAC,YAAY,KAAK,WAAW;QAAE,OAAO,WAAW,CAAC;IACzD,IAAI,GAAG,CAAC,UAAU;QAAE,OAAO,WAAW,CAAC;IAEvC,IAAI,oCAAoC,CAAC,IAAI,CAAC,IAAI,CAAC;QAAE,OAAO,QAAQ,CAAC;IAErE,OAAO,QAAQ,CAAC;AAClB,CAAC"}

package/dist/capabilities/index.d.ts

@@ -0,0 +1,13 @@
+/**
+ * ./index.js — terminal feature detection.
+ *
+ * Pure parse + env heuristics + optional I/O probes.
+ * No theme math (ground OKLCH lives in ../theme/index.js).
+ * No TTY lifecycle (alt-screen lives in ../runtime/index.js).
+ */
+export * from "./types.js";
+export * from "./sequences.js";
+export * from "./parse.js";
+export * from "./env.js";
+export * from "./probe.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/capabilities/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/capabilities/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC"}

package/dist/capabilities/index.js

@@ -0,0 +1,13 @@
+/**
+ * ./index.js — terminal feature detection.
+ *
+ * Pure parse + env heuristics + optional I/O probes.
+ * No theme math (ground OKLCH lives in ../theme/index.js).
+ * No TTY lifecycle (alt-screen lives in ../runtime/index.js).
+ */
+export * from "./types.js";
+export * from "./sequences.js";
+export * from "./parse.js";
+export * from "./env.js";
+export * from "./probe.js";
+//# sourceMappingURL=index.js.map

package/dist/capabilities/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/capabilities/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,gBAAgB,CAAC;AAC/B,cAAc,YAAY,CAAC;AAC3B,cAAc,UAAU,CAAC;AACzB,cAAc,YAAY,CAAC"}

package/dist/capabilities/parse.d.ts

@@ -0,0 +1,41 @@
+/**
+ * Pure parsers for terminal capability replies — no I/O.
+ */
+import type { Rgb } from "../lexicon/index.js";
+/**
+ * Parse OSC 11 (or OSC 10) color payload.
+ * Accepts `rgb:rrrr/gggg/bbbb` (XParseColor) and `#rrggbb` / `rrggbb`.
+ */
+export declare function parseOscColorPayload(payload: string): Rgb | null;
+/** Alias — OSC 11 is the common ground probe. */
+export declare const parseOsc11Payload: typeof parseOscColorPayload;
+/**
+ * Extract OSC 11 payload from a reply buffer (BEL or ST terminated).
+ * H3: requires a terminator — an unterminated partial chunk (e.g. the first
+ * stdin read delivering only `\x1b]11;rgb:1`) must return null so the probe
+ * keeps waiting for the rest, instead of finishing early with a truncated
+ * payload and `groundRgb: undefined`.
+ */
+export declare function extractOsc11FromBuffer(buf: string): string | null;
+/**
+ * Parse DECRQM reply for mode 2026.
+ * CSI ? 2026 ; Ps $ y — Ps 1 or 3 ⇒ set/supported; 2 or 4 ⇒ reset.
+ * Returns true if mode is reported as settable/set, false if reset, null if absent.
+ */
+export declare function parseDecrqm2026(buf: string): boolean | null;
+/** True if DA1 (primary DA) reply present — probe batch completed. */
+export declare function hasDa1Reply(buf: string): boolean;
+/**
+ * Remove known capability probe replies from a stdin accumulation buffer.
+ * Residual bytes are user keystrokes (or unrelated sequences) typed during
+ * the probe window — re-inject into the app's input path.
+ *
+ * Only complete, terminated replies are stripped:
+ * - OSC 11 ground (BEL or ST)
+ * - DECRQM mode 2026 (`CSI ? 2026 ; Ps $ y`)
+ * - DA1 (`CSI ? … c`)
+ *
+ * Partial fragments that never completed (timeout mid-reply) are left as-is.
+ */
+export declare function stripProbeReplies(buf: string): string;
+//# sourceMappingURL=parse.d.ts.map

package/dist/capabilities/parse.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.d.ts","sourceRoot":"","sources":["../../src/capabilities/parse.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAC;AAE/C;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,OAAO,EAAE,MAAM,GAAG,GAAG,GAAG,IAAI,CA4BhE;AAED,iDAAiD;AACjD,eAAO,MAAM,iBAAiB,6BAAuB,CAAC;AAEtD;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAGjE;AAED;;;;GAIG;AACH,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAQ3D;AAED,sEAAsE;AACtE,wBAAgB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAEhD;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAKrD"}

package/dist/capabilities/parse.js

@@ -0,0 +1,86 @@
+/**
+ * Pure parsers for terminal capability replies — no I/O.
+ */
+/**
+ * Parse OSC 11 (or OSC 10) color payload.
+ * Accepts `rgb:rrrr/gggg/bbbb` (XParseColor) and `#rrggbb` / `rrggbb`.
+ */
+export function parseOscColorPayload(payload) {
+    const s = payload.trim();
+    const xparse = /^rgb:([0-9a-fA-F]{1,4})\/([0-9a-fA-F]{1,4})\/([0-9a-fA-F]{1,4})$/.exec(s);
+    if (xparse) {
+        const scale = (hex) => {
+            const n = Number.parseInt(hex, 16);
+            const max = (1 << (hex.length * 4)) - 1;
+            return Math.round((n / max) * 255);
+        };
+        return {
+            r: scale(xparse[1]),
+            g: scale(xparse[2]),
+            b: scale(xparse[3]),
+        };
+    }
+    const hex = /^#?([0-9a-f]{6})$/i.exec(s);
+    if (hex) {
+        const h = hex[1];
+        return {
+            r: Number.parseInt(h.slice(0, 2), 16),
+            g: Number.parseInt(h.slice(2, 4), 16),
+            b: Number.parseInt(h.slice(4, 6), 16),
+        };
+    }
+    return null;
+}
+/** Alias — OSC 11 is the common ground probe. */
+export const parseOsc11Payload = parseOscColorPayload;
+/**
+ * Extract OSC 11 payload from a reply buffer (BEL or ST terminated).
+ * H3: requires a terminator — an unterminated partial chunk (e.g. the first
+ * stdin read delivering only `\x1b]11;rgb:1`) must return null so the probe
+ * keeps waiting for the rest, instead of finishing early with a truncated
+ * payload and `groundRgb: undefined`.
+ */
+export function extractOsc11FromBuffer(buf) {
+    const m = /\u001B\]11;([^\u0007\u001B]+)(?:\u0007|\u001B\\)/.exec(buf);
+    return m?.[1] ?? null;
+}
+/**
+ * Parse DECRQM reply for mode 2026.
+ * CSI ? 2026 ; Ps $ y — Ps 1 or 3 ⇒ set/supported; 2 or 4 ⇒ reset.
+ * Returns true if mode is reported as settable/set, false if reset, null if absent.
+ */
+export function parseDecrqm2026(buf) {
+    const m = /\u001B\[\?2026;(\d+)\$y/.exec(buf);
+    if (!m)
+        return null;
+    const ps = Number.parseInt(m[1], 10);
+    // 0 unknown, 1 set, 2 reset, 3 permanently set, 4 permanently reset
+    if (ps === 1 || ps === 3)
+        return true;
+    if (ps === 2 || ps === 4)
+        return false;
+    return null;
+}
+/** True if DA1 (primary DA) reply present — probe batch completed. */
+export function hasDa1Reply(buf) {
+    return /\u001B\[\?[\d;]*c/.test(buf);
+}
+/**
+ * Remove known capability probe replies from a stdin accumulation buffer.
+ * Residual bytes are user keystrokes (or unrelated sequences) typed during
+ * the probe window — re-inject into the app's input path.
+ *
+ * Only complete, terminated replies are stripped:
+ * - OSC 11 ground (BEL or ST)
+ * - DECRQM mode 2026 (`CSI ? 2026 ; Ps $ y`)
+ * - DA1 (`CSI ? … c`)
+ *
+ * Partial fragments that never completed (timeout mid-reply) are left as-is.
+ */
+export function stripProbeReplies(buf) {
+    return buf
+        .replaceAll(/\u001B\]11;[^\u0007\u001B]+(?:\u0007|\u001B\\)/g, "")
+        .replaceAll(/\u001B\[\?2026;\d+\$y/g, "")
+        .replaceAll(/\u001B\[\?[\d;]*c/g, "");
+}
+//# sourceMappingURL=parse.js.map

package/dist/capabilities/parse.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse.js","sourceRoot":"","sources":["../../src/capabilities/parse.ts"],"names":[],"mappings":"AAAA;;GAEG;AAIH;;;GAGG;AACH,MAAM,UAAU,oBAAoB,CAAC,OAAe;IAClD,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC;IAEzB,MAAM,MAAM,GAAG,kEAAkE,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAC1F,IAAI,MAAM,EAAE,CAAC;QACX,MAAM,KAAK,GAAG,CAAC,GAAW,EAAE,EAAE;YAC5B,MAAM,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC;YACnC,MAAM,GAAG,GAAG,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;YACxC,OAAO,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,GAAG,CAAC,CAAC;QACrC,CAAC,CAAC;QACF,OAAO;YACL,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC;YACpB,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC;YACpB,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC,CAAE,CAAC;SACrB,CAAC;IACJ,CAAC;IAED,MAAM,GAAG,GAAG,oBAAoB,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACzC,IAAI,GAAG,EAAE,CAAC;QACR,MAAM,CAAC,GAAG,GAAG,CAAC,CAAC,CAAE,CAAC;QAClB,OAAO;YACL,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC;YACrC,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC;YACrC,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC;SACtC,CAAC;IACJ,CAAC;IAED,OAAO,IAAI,CAAC;AACd,CAAC;AAED,iDAAiD;AACjD,MAAM,CAAC,MAAM,iBAAiB,GAAG,oBAAoB,CAAC;AAEtD;;;;;;GAMG;AACH,MAAM,UAAU,sBAAsB,CAAC,GAAW;IAChD,MAAM,CAAC,GAAG,kDAAkD,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACvE,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC;AACxB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,MAAM,CAAC,GAAG,yBAAyB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC9C,IAAI,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IACpB,MAAM,EAAE,GAAG,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAE,EAAE,EAAE,CAAC,CAAC;IACtC,oEAAoE;IACpE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACtC,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACvC,OAAO,IAAI,CAAC;AACd,CAAC;AAED,sEAAsE;AACtE,MAAM,UAAU,WAAW,CAAC,GAAW;IACrC,OAAO,mBAAmB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACvC,CAAC;AAED;;;;;;;;;;;GAWG;AACH,MAAM,UAAU,iBAAiB,CAAC,GAAW;IAC3C,OAAO,GAAG;SACP,UAAU,CAAC,iDAAiD,EAAE,EAAE,CAAC;SACjE,UAAU,CAAC,wBAAwB,EAAE,EAAE,CAAC;SACxC,UAAU,CAAC,oBAAoB,EAAE,EAAE,CAAC,CAAC;AAC1C,CAAC"}

package/dist/capabilities/probe.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Interactive terminal probes — I/O only.
+ * Pure parse lives in parse.ts; env heuristics in env.ts.
+ */
+import type { Readable, Writable } from "node:stream";
+import type { TerminalCaps } from "./types.js";
+export type ProbeOpts = {
+    stdin: Readable & {
+        isTTY?: boolean;
+    };
+    stdout: Writable & {
+        isTTY?: boolean;
+    };
+    timeoutMs?: number;
+    /** Env for depth heuristics (default process.env) */
+    env?: NodeJS.ProcessEnv;
+    /**
+     * When true (default), also send DECRQM 2026 + DA1 after OSC11.
+     * Disable for minimal ground-only probe.
+     */
+    batch?: boolean;
+};
+export type DetectResult = {
+    caps: TerminalCaps;
+    /**
+     * Stdin bytes accumulated during the probe that were not capability replies
+     * (keystrokes / unrelated sequences). Re-inject into the app input path.
+     * Empty when non-TTY or when the window only contained probe replies.
+     */
+    leftover: string;
+};
+/**
+ * Detect terminal capabilities: env depth + optional OSC11 + DECRQM 2026.
+ * Non-TTY → tty:false, env depth, no probes.
+ */
+export declare function detectCapabilities(opts: ProbeOpts): Promise<DetectResult>;
+//# sourceMappingURL=probe.d.ts.map

package/dist/capabilities/probe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"probe.d.ts","sourceRoot":"","sources":["../../src/capabilities/probe.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAKtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE/C,MAAM,MAAM,SAAS,GAAG;IACtB,KAAK,EAAE,QAAQ,GAAG;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IACtC,MAAM,EAAE,QAAQ,GAAG;QAAE,KAAK,CAAC,EAAE,OAAO,CAAA;KAAE,CAAC;IACvC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,qDAAqD;IACrD,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAC;IACxB;;;OAGG;IACH,KAAK,CAAC,EAAE,OAAO,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACzB,IAAI,EAAE,YAAY,CAAC;IACnB;;;;OAIG;IACH,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAC;AAEF;;;GAGG;AACH,wBAAsB,kBAAkB,CAAC,IAAI,EAAE,SAAS,GAAG,OAAO,CAAC,YAAY,CAAC,CAqE/E"}