@inhuman.tools/quickdraw 0.0.0-stage → 0.2.0

package/dist/capabilities/probe.js

@@ -0,0 +1,75 @@
+/**
+ * Interactive terminal probes — I/O only.
+ * Pure parse lives in parse.ts; env heuristics in env.ts.
+ */
+import { guessColorDepth } from "./env.js";
+import { extractOsc11FromBuffer, parseDecrqm2026, parseOsc11Payload, hasDa1Reply, stripProbeReplies } from "./parse.js";
+import { OSC11_QUERY, PROBE_BATCH } from "./sequences.js";
+/**
+ * Detect terminal capabilities: env depth + optional OSC11 + DECRQM 2026.
+ * Non-TTY → tty:false, env depth, no probes.
+ */
+export async function detectCapabilities(opts) {
+    const env = opts.env ?? process.env;
+    const depthGuess = guessColorDepth(env);
+    const tty = !!(opts.stdin.isTTY && opts.stdout.isTTY);
+    const base = {
+        tty,
+        colorDepth: depthGuess,
+    };
+    if (!tty) {
+        return { caps: base, leftover: "" };
+    }
+    const timeoutMs = opts.timeoutMs ?? 100;
+    const batch = opts.batch !== false;
+    return new Promise((resolve) => {
+        let buf = "";
+        let settled = false;
+        const finish = (caps) => {
+            if (settled)
+                return;
+            settled = true;
+            clearTimeout(timer);
+            opts.stdin.off("data", onData);
+            // Replies stripped; residual = keystrokes during the probe window.
+            resolve({ caps, leftover: stripProbeReplies(buf) });
+        };
+        const onData = (chunk) => {
+            buf += typeof chunk === "string" ? chunk : chunk.toString("utf8");
+            const payload = extractOsc11FromBuffer(buf);
+            const decrqm = parseDecrqm2026(buf);
+            const da1 = hasDa1Reply(buf);
+            // Batch ends with DA1 by design (PROBE_BATCH). Finish early only when
+            // ground + DA1 are both in — never on DECRQM alone. Early-exit on 2026
+            // left DA1 in the TTY queue; if it arrived after raw mode dropped at
+            // exit, the shell painted `CSI ? 64;…c` (and friends) on the prompt.
+            const haveGround = payload !== null;
+            if (haveGround && (!batch || da1)) {
+                const rgb = payload ? parseOsc11Payload(payload) : null;
+                finish({
+                    ...base,
+                    groundRgb: rgb ?? undefined,
+                    sync2026: decrqm ?? undefined,
+                });
+            }
+        };
+        const timer = setTimeout(() => {
+            const payload = extractOsc11FromBuffer(buf);
+            const rgb = payload ? parseOsc11Payload(payload) : null;
+            const decrqm = parseDecrqm2026(buf);
+            finish({
+                ...base,
+                groundRgb: rgb ?? undefined,
+                sync2026: decrqm ?? undefined,
+            });
+        }, timeoutMs);
+        opts.stdin.on("data", onData);
+        try {
+            opts.stdout.write(batch ? PROBE_BATCH : OSC11_QUERY);
+        }
+        catch {
+            finish(base);
+        }
+    });
+}
+//# sourceMappingURL=probe.js.map

package/dist/capabilities/probe.js.map

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

package/dist/capabilities/sequences.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Terminal query sequences (feature detection).
+ * BEL-terminated OSC where common; ST also accepted by modern terms.
+ */
+/** OSC 11 — background color query */
+export declare const OSC11_QUERY = "\u001B]11;?\u0007";
+/** Mode 2031: subscribe to terminal color-scheme changes (CSI ? 997 ; Ps n). */
+export declare const THEME_REPORT_ENABLE = "\u001B[?2031h";
+export declare const THEME_REPORT_DISABLE = "\u001B[?2031l";
+/** OSC 10 — foreground color query */
+export declare const OSC10_QUERY = "\u001B]10;?\u0007";
+/**
+ * DECRQM — request Mode 2026 (synchronized output) state.
+ * Reply: CSI ? 2026 ; Ps $ y  (Ps 1/3 set, 2/4 reset)
+ */
+export declare const DECRQM_2026 = "\u001B[?2026$p";
+/** Primary Device Attributes — often ends a probe batch */
+export declare const DA1_QUERY = "\u001B[c";
+/** XTVERSION — terminal identity (many support) */
+export declare const XTVERSION_QUERY = "\u001B[>0q";
+/** Concatenated best-effort probe batch (OSC11 + DECRQM 2026 + DA1 last). */
+export declare const PROBE_BATCH: string;
+/**
+ * OSC 52 — clipboard write.
+ *
+ * Pure byte builder; caller writes to the TTY. Unsupported terminals ignore
+ * the sequence (graceful degradation).
+ *
+ * Pc: `c` = CLIPBOARD, `p` = PRIMARY, `cp` = both. That is the XTerm map;
+ * renaming the tokens to clipboard/primary breaks the sequence.
+ */
+export declare function osc52Set(text: string, pc?: "c" | "p" | "cp"): string;
+//# sourceMappingURL=sequences.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sequences.d.ts","sourceRoot":"","sources":["../../src/capabilities/sequences.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,sCAAsC;AACtC,eAAO,MAAM,WAAW,sBAAsB,CAAC;AAE/C,gFAAgF;AAChF,eAAO,MAAM,mBAAmB,kBAAkB,CAAC;AACnD,eAAO,MAAM,oBAAoB,kBAAkB,CAAC;AAEpD,sCAAsC;AACtC,eAAO,MAAM,WAAW,sBAAsB,CAAC;AAE/C;;;GAGG;AACH,eAAO,MAAM,WAAW,mBAAmB,CAAC;AAE5C,2DAA2D;AAC3D,eAAO,MAAM,SAAS,aAAa,CAAC;AAEpC,mDAAmD;AACnD,eAAO,MAAM,eAAe,eAAe,CAAC;AAE5C,6EAA6E;AAC7E,eAAO,MAAM,WAAW,QAAwC,CAAC;AAEjE;;;;;;;;GAQG;AACH,wBAAgB,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAE,GAAG,GAAG,GAAG,GAAG,IAAW,GAAG,MAAM,CAG1E"}

package/dist/capabilities/sequences.js

@@ -0,0 +1,36 @@
+/**
+ * Terminal query sequences (feature detection).
+ * BEL-terminated OSC where common; ST also accepted by modern terms.
+ */
+/** OSC 11 — background color query */
+export const OSC11_QUERY = "\u001B]11;?\u0007";
+/** Mode 2031: subscribe to terminal color-scheme changes (CSI ? 997 ; Ps n). */
+export const THEME_REPORT_ENABLE = "\u001B[?2031h";
+export const THEME_REPORT_DISABLE = "\u001B[?2031l";
+/** OSC 10 — foreground color query */
+export const OSC10_QUERY = "\u001B]10;?\u0007";
+/**
+ * DECRQM — request Mode 2026 (synchronized output) state.
+ * Reply: CSI ? 2026 ; Ps $ y  (Ps 1/3 set, 2/4 reset)
+ */
+export const DECRQM_2026 = "\u001B[?2026$p";
+/** Primary Device Attributes — often ends a probe batch */
+export const DA1_QUERY = "\u001B[c";
+/** XTVERSION — terminal identity (many support) */
+export const XTVERSION_QUERY = "\u001B[>0q";
+/** Concatenated best-effort probe batch (OSC11 + DECRQM 2026 + DA1 last). */
+export const PROBE_BATCH = OSC11_QUERY + DECRQM_2026 + DA1_QUERY;
+/**
+ * OSC 52 — clipboard write.
+ *
+ * Pure byte builder; caller writes to the TTY. Unsupported terminals ignore
+ * the sequence (graceful degradation).
+ *
+ * Pc: `c` = CLIPBOARD, `p` = PRIMARY, `cp` = both. That is the XTerm map;
+ * renaming the tokens to clipboard/primary breaks the sequence.
+ */
+export function osc52Set(text, pc = "cp") {
+    const b64 = Buffer.from(text, "utf8").toString("base64");
+    return `\u001B]52;${pc};${b64}\u0007`;
+}
+//# sourceMappingURL=sequences.js.map

package/dist/capabilities/sequences.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sequences.js","sourceRoot":"","sources":["../../src/capabilities/sequences.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,sCAAsC;AACtC,MAAM,CAAC,MAAM,WAAW,GAAG,mBAAmB,CAAC;AAE/C,gFAAgF;AAChF,MAAM,CAAC,MAAM,mBAAmB,GAAG,eAAe,CAAC;AACnD,MAAM,CAAC,MAAM,oBAAoB,GAAG,eAAe,CAAC;AAEpD,sCAAsC;AACtC,MAAM,CAAC,MAAM,WAAW,GAAG,mBAAmB,CAAC;AAE/C;;;GAGG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,gBAAgB,CAAC;AAE5C,2DAA2D;AAC3D,MAAM,CAAC,MAAM,SAAS,GAAG,UAAU,CAAC;AAEpC,mDAAmD;AACnD,MAAM,CAAC,MAAM,eAAe,GAAG,YAAY,CAAC;AAE5C,6EAA6E;AAC7E,MAAM,CAAC,MAAM,WAAW,GAAG,WAAW,GAAG,WAAW,GAAG,SAAS,CAAC;AAEjE;;;;;;;;GAQG;AACH,MAAM,UAAU,QAAQ,CAAC,IAAY,EAAE,KAAuB,IAAI;IAChE,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC;IACzD,OAAO,aAAa,EAAE,IAAI,GAAG,QAAQ,CAAC;AACxC,CAAC"}

package/dist/capabilities/types.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Terminal feature snapshot — request/detect, never assume.
+ */
+/**
+ * Color emission depth the paint path should use.
+ * `mono` (NO_COLOR) strips color SGR entirely at the resolver — role solving
+ * still runs (tier/prominence math, bold H-K compensation) but no fg/bg color
+ * escape is emitted; bold/italic/strike/underline attributes still emit.
+ */
+import type { Rgb } from "../lexicon/index.js";
+export type ColorDepth = "truecolor" | "ansi256" | "ansi16" | "mono";
+/**
+ * Detected (or guessed) terminal capabilities.
+ * Unknown fields stay undefined — callers fall back honestly.
+ */
+export type TerminalCaps = {
+    /** stdin+stdout are TTYs */
+    tty: boolean;
+    colorDepth: ColorDepth;
+    /** OSC 11 background RGB if probed */
+    groundRgb?: Rgb;
+    /** Mode 2026 supported (DECRQM) when probed */
+    sync2026?: boolean;
+};
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/capabilities/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;GAKG;AACH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,qBAAqB,CAAC;AAE/C,MAAM,MAAM,UAAU,GAAG,WAAW,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;AAErE;;;GAGG;AACH,MAAM,MAAM,YAAY,GAAG;IACzB,4BAA4B;IAC5B,GAAG,EAAE,OAAO,CAAC;IACb,UAAU,EAAE,UAAU,CAAC;IACvB,sCAAsC;IACtC,SAAS,CAAC,EAAE,GAAG,CAAC;IAChB,+CAA+C;IAC/C,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB,CAAC"}

package/dist/capabilities/types.js

@@ -0,0 +1,5 @@
+/**
+ * Terminal feature snapshot — request/detect, never assume.
+ */
+export {};
+//# sourceMappingURL=types.js.map

package/dist/capabilities/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../src/capabilities/types.ts"],"names":[],"mappings":"AAAA;;GAEG"}

package/dist/index.d.ts

@@ -0,0 +1,11 @@
+export * from "./render.js";
+export { Renderer as Renderer, type BoxCadencePort as BoxCadencePort, type CadenceDownItem as CadenceDownItem, } from "./runtime/renderer.js";
+export { assemblePaintFrame as assemblePaintFrame, createPaintLocal as createPaintLocal, type PaintLocal as PaintLocal, type RetainedPaintSource as RetainedPaintSource, } from "./runtime/paint_source.js";
+export * from "./runtime/present_loop.js";
+export { renderFrame as renderFrame } from "./runtime/frame.js";
+export { createTtySession as createTtySession, type TtyOptions as TtyOptions, type TtySession as TtySession, } from "./runtime/tty.js";
+export { emptyEcho as emptyEcho } from "./runtime/echo.js";
+export { createSelectionHost as createSelectionHost } from "./runtime/selection_host.js";
+export { detectCapabilities as detectCapabilities } from "./capabilities/index.js";
+export { resolvePresentConfig as resolvePresentConfig, type PresentConfig as PresentConfig, } from "./runtime/present_profile.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":"AAAA,cAAc,aAAa,CAAC;AAC5B,OAAO,EACL,QAAQ,IAAI,QAAQ,EACpB,KAAK,cAAc,IAAI,cAAc,EACrC,KAAK,eAAe,IAAI,eAAe,GACxC,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,kBAAkB,IAAI,kBAAkB,EACxC,gBAAgB,IAAI,gBAAgB,EACpC,KAAK,UAAU,IAAI,UAAU,EAC7B,KAAK,mBAAmB,IAAI,mBAAmB,GAChD,MAAM,2BAA2B,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,OAAO,EAAE,WAAW,IAAI,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EACL,gBAAgB,IAAI,gBAAgB,EACpC,KAAK,UAAU,IAAI,UAAU,EAC7B,KAAK,UAAU,IAAI,UAAU,GAC9B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,SAAS,IAAI,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,IAAI,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AACzF,OAAO,EAAE,kBAAkB,IAAI,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AACnF,OAAO,EACL,oBAAoB,IAAI,oBAAoB,EAC5C,KAAK,aAAa,IAAI,aAAa,GACpC,MAAM,8BAA8B,CAAC"}

package/dist/index.js

@@ -0,0 +1,11 @@
+export * from "./render.js";
+export { Renderer as Renderer, } from "./runtime/renderer.js";
+export { assemblePaintFrame as assemblePaintFrame, createPaintLocal as createPaintLocal, } from "./runtime/paint_source.js";
+export * from "./runtime/present_loop.js";
+export { renderFrame as renderFrame } from "./runtime/frame.js";
+export { createTtySession as createTtySession, } from "./runtime/tty.js";
+export { emptyEcho as emptyEcho } from "./runtime/echo.js";
+export { createSelectionHost as createSelectionHost } from "./runtime/selection_host.js";
+export { detectCapabilities as detectCapabilities } from "./capabilities/index.js";
+export { resolvePresentConfig as resolvePresentConfig, } from "./runtime/present_profile.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,cAAc,aAAa,CAAC;AAC5B,OAAO,EACL,QAAQ,IAAI,QAAQ,GAGrB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACL,kBAAkB,IAAI,kBAAkB,EACxC,gBAAgB,IAAI,gBAAgB,GAGrC,MAAM,2BAA2B,CAAC;AACnC,cAAc,2BAA2B,CAAC;AAC1C,OAAO,EAAE,WAAW,IAAI,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAChE,OAAO,EACL,gBAAgB,IAAI,gBAAgB,GAGrC,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,SAAS,IAAI,SAAS,EAAE,MAAM,mBAAmB,CAAC;AAC3D,OAAO,EAAE,mBAAmB,IAAI,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AACzF,OAAO,EAAE,kBAAkB,IAAI,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AACnF,OAAO,EACL,oBAAoB,IAAI,oBAAoB,GAE7C,MAAM,8BAA8B,CAAC"}

package/dist/input/decode.d.ts

@@ -0,0 +1,167 @@
+import type { Rgb } from "../lexicon/color.js";
+export type InputEvent = {
+    type: "char";
+    ch: string;
+} | {
+    type: "enter";
+    shift?: boolean;
+    alt?: boolean;
+    ctrl?: boolean;
+    meta?: boolean;
+} | {
+    type: "shift_enter";
+} | {
+    type: "esc";
+    shift?: boolean;
+    alt?: boolean;
+    ctrl?: boolean;
+    meta?: boolean;
+}
+/** Bare Tab — autocomplete / cycle (host maps to key "Tab"). Not a draft glyph. */
+ | {
+    type: "tab";
+}
+/** Shift+Tab — host hotkey (policy cycle). Not a draft glyph. */
+ | {
+    type: "shift_tab";
+} | {
+    type: "backspace";
+} | {
+    type: "delete";
+}
+/**
+ * Caret motion. `select: true` when Shift is held — extend draft selection
+ * (browser textarea law). Plain motion collapses the selection.
+ */
+ | {
+    type: "up";
+    select?: boolean;
+} | {
+    type: "down";
+    select?: boolean;
+} | {
+    type: "left";
+    select?: boolean;
+} | {
+    type: "right";
+    select?: boolean;
+} | {
+    type: "home";
+    select?: boolean;
+} | {
+    type: "end";
+    select?: boolean;
+} | {
+    type: "page_up";
+} | {
+    type: "page_down";
+} | {
+    type: "word_left";
+    select?: boolean;
+} | {
+    type: "word_right";
+    select?: boolean;
+} | {
+    type: "word_backspace";
+} | {
+    type: "kill_to_start";
+} | {
+    type: "kill_to_end";
+} | {
+    type: "ctrl_c";
+}
+/** Ctrl+X — product hotkey (e.g. connect/drop). Not a draft kill. */
+ | {
+    type: "ctrl_x";
+}
+/** Ctrl+O / Cmd+O — live tape density (tool rows). Not a frozen overlay. */
+ | {
+    type: "ctrl_o";
+}
+/** Ctrl+V — paste. Host fills the clipboard body and lowers to `paste`. */
+ | {
+    type: "ctrl_v";
+}
+/** Ctrl+Z / Cmd+Z — draft undo (host lowers to named key). */
+ | {
+    type: "undo";
+}
+/** Ctrl+Y / Ctrl+Shift+Z — draft redo. */
+ | {
+    type: "redo";
+}
+/** Cmd+A — select the whole draft. Ctrl+A stays readline Home. */
+ | {
+    type: "select_all";
+}
+/** Bracketed paste body (already unwrapped from CSI 200~/201~). */
+ | {
+    type: "paste";
+    text: string;
+}
+/** Terminal gained focus (`CSI I` with ?1004h). */
+ | {
+    type: "focus_in";
+}
+/** Terminal lost focus (`CSI O` with ?1004h). */
+ | {
+    type: "focus_out";
+}
+/**
+ * OSC 11 ground (boot leftover or a live theme change). Host attunes;
+ * never a draft glyph.
+ */
+ | {
+    type: "osc_ground";
+    rgb: Rgb;
+}
+/** Mode 2031 notification. Re-query actual ground; the mode is not a color. */
+ | {
+    type: "theme_changed";
+}
+/**
+ * SGR mouse (`?1000h`+`?1006h`). col/row are **1-based** terminal cells.
+ * Prefer acting on `release` (press-drag is selection, not click).
+ */
+ | {
+    type: "mouse";
+    button: number;
+    col: number;
+    row: number;
+    release: boolean;
+} | {
+    type: "unknown";
+    raw: string;
+}
+/** Kitty report-all-keys: Control / Super press or release. Not a draft glyph. */
+ | {
+    type: "mod";
+    persist: true;
+    down: boolean;
+};
+export type ConsumeKeysResult = {
+    events: InputEvent[];
+    /** Incomplete ESC/CSI tail held for the next stdin chunk. */
+    pending: string;
+};
+export declare function normalizePaste(text: string): string;
+/**
+ * Max OSC body length (bytes after `ESC ]`) before an unterminated sequence is
+ * abandoned. Capability replies (OSC 10/11 rgb, …) are tens of bytes; without
+ * this bound a lone malformed `ESC ]…` with no BEL/ST holds every subsequent
+ * keystroke in `pending` forever (unlike lone-ESC, which the host can flush).
+ * Fail-safe: drop the runaway OSC prefix and resume decoding at the bound.
+ */
+export declare const MAX_OSC_BODY = 512;
+export declare function consumeKeys(raw: string, pending?: string): ConsumeKeysResult;
+/**
+ * Resolve a held ESC after the host's short quiet-window timeout elapses
+ * with no further bytes. consumeKeys never does this itself — it cannot
+ * distinguish "no more bytes are coming" from "more are about to arrive" —
+ * so the timer belongs to the host (main.ts / storybook's main.ts both use
+ * ~30ms). Only a bare "\x1b" tail resolves; any other pending shape
+ * (incomplete CSI, empty) is returned untouched — it still needs more bytes,
+ * or there was nothing pending to begin with.
+ */
+export declare function flushPendingEsc(pending: string): ConsumeKeysResult;
+//# sourceMappingURL=decode.d.ts.map

package/dist/input/decode.d.ts.map

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