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

package/dist/bench/model.js

@@ -0,0 +1,112 @@
+/**
+ * Experiment model: scrollable log + side panel + clock + optional CPU burn.
+ * Shared types for worker and main (view runs on main).
+ */
+const MAX_LINES = 5000;
+export function init(cols, rows) {
+    const lines = [];
+    for (let i = 0; i < 200; i++) {
+        lines.push(seedLine(i));
+    }
+    return {
+        cols,
+        rows,
+        lines,
+        scroll: 0,
+        now: Date.now(),
+        tick: 0,
+        burnMs: 0,
+        paused: false,
+    };
+}
+function seedLine(i) {
+    return `[${String(i).padStart(4, "0")}] event payload ${"·".repeat((i % 40) + 1)} id=${(i * 2_654_435_761) >>> 0}`;
+}
+function busy(ms) {
+    if (ms <= 0)
+        return;
+    const end = performance.now() + ms;
+    while (performance.now() < end) {
+        /* spin — intentional load on logic thread only */
+    }
+}
+export function update(msg, model) {
+    if (model.burnMs > 0 && msg.type !== "set_burn") {
+        busy(model.burnMs);
+    }
+    switch (msg.type) {
+        case "resize":
+            return { ...model, cols: msg.cols, rows: msg.rows };
+        case "tick": {
+            if (model.paused)
+                return { ...model, now: msg.now };
+            const nextTick = model.tick + 1;
+            const line = seedLine(model.lines.length);
+            const lines = model.lines.length >= MAX_LINES ? model.lines.slice(1).concat(line) : model.lines.concat(line);
+            // auto-follow if near bottom
+            const visible = Math.max(1, model.rows - 4);
+            const atBottom = model.scroll >= lines.length - visible - 1;
+            const scroll = atBottom ? Math.max(0, lines.length - visible) : model.scroll;
+            return {
+                ...model,
+                now: msg.now,
+                tick: nextTick,
+                lines,
+                scroll,
+            };
+        }
+        case "key":
+            return handleKey(msg.key, model);
+        case "append_burst": {
+            const extra = [];
+            for (let i = 0; i < msg.count; i++) {
+                extra.push(seedLine(model.lines.length + i));
+            }
+            let lines = model.lines.concat(extra);
+            if (lines.length > MAX_LINES)
+                lines = lines.slice(-MAX_LINES);
+            const visible = Math.max(1, model.rows - 4);
+            return {
+                ...model,
+                lines,
+                scroll: Math.max(0, lines.length - visible),
+            };
+        }
+        case "set_burn":
+            return { ...model, burnMs: Math.max(0, msg.ms) };
+        default:
+            return model;
+    }
+}
+function handleKey(key, model) {
+    const visible = Math.max(1, model.rows - 4);
+    const maxScroll = Math.max(0, model.lines.length - visible);
+    switch (key) {
+        case "q":
+        case "\u0003": // ctrl-c
+            // main handles exit; model unchanged
+            return model;
+        case " ":
+            return { ...model, paused: !model.paused };
+        case "j":
+        case "\u001B[B": // down
+            return { ...model, scroll: Math.min(maxScroll, model.scroll + 1) };
+        case "k":
+        case "\u001B[A": // up
+            return { ...model, scroll: Math.max(0, model.scroll - 1) };
+        case "g":
+            return { ...model, scroll: 0 };
+        case "G":
+            return { ...model, scroll: maxScroll };
+        case "b":
+            // toggle 5ms burn on logic thread
+            return { ...model, burnMs: model.burnMs > 0 ? 0 : 5 };
+        case "B":
+            return { ...model, burnMs: model.burnMs >= 20 ? 0 : 20 };
+        case "a":
+            return update({ type: "append_burst", count: 100 }, model);
+        default:
+            return model;
+    }
+}
+//# sourceMappingURL=model.js.map

package/dist/bench/model.js.map

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

package/dist/bench/tea.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Minimal TEA (The Elm Architecture) types for @quickdraw.
+ * Pure functions only — no I/O, no workers.
+ */
+export type Update<Model, Msg> = (msg: Msg, model: Model) => Model;
+/** Monotonic generation counter for snapshots (render drops stale gens). */
+export type Generation = number;
+export interface Snapshot<Model> {
+    gen: Generation;
+    model: Model;
+    /** wall-clock ms when snapshot was produced (worker) */
+    at: number;
+}
+//# sourceMappingURL=tea.d.ts.map

package/dist/bench/tea.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tea.d.ts","sourceRoot":"","sources":["../../src/bench/tea.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,MAAM,CAAC,KAAK,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,KAAK,KAAK,CAAC;AAEnE,4EAA4E;AAC5E,MAAM,MAAM,UAAU,GAAG,MAAM,CAAC;AAEhC,MAAM,WAAW,QAAQ,CAAC,KAAK;IAC7B,GAAG,EAAE,UAAU,CAAC;IAChB,KAAK,EAAE,KAAK,CAAC;IACb,wDAAwD;IACxD,EAAE,EAAE,MAAM,CAAC;CACZ"}

package/dist/bench/tea.js

@@ -0,0 +1,6 @@
+/**
+ * Minimal TEA (The Elm Architecture) types for @quickdraw.
+ * Pure functions only — no I/O, no workers.
+ */
+export {};
+//# sourceMappingURL=tea.js.map

package/dist/bench/tea.js.map

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

package/dist/bench/view.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Pure view: Model → buffer paint.
+ * Runs on the **render (main)** thread only.
+ */
+import type { FpsStats } from "./host.js";
+import type { Model } from "./model.js";
+import { type Buffer } from "../buffer/index.js";
+export declare function paint(model: Model, stats: FpsStats, into?: Buffer): Buffer;
+//# sourceMappingURL=view.d.ts.map

package/dist/bench/view.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"view.d.ts","sourceRoot":"","sources":["../../src/bench/view.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,YAAY,CAAC;AACxC,OAAO,EAAE,KAAK,MAAM,EAAwC,MAAM,oBAAoB,CAAC;AAGvF,wBAAgB,KAAK,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CA4F1E"}

package/dist/bench/view.js

@@ -0,0 +1,88 @@
+/**
+ * Pure view: Model → buffer paint.
+ * Runs on the **render (main)** thread only.
+ */
+import { clear, createBuffer, put } from "../buffer/index.js";
+import { FgP } from "../lexicon/index.js";
+export function paint(model, stats, into) {
+    const w = Math.max(40, model.cols);
+    const h = Math.max(10, model.rows);
+    const buf = into && into.width === w && into.height === h ? into : createBuffer(w, h);
+    clear(buf);
+    // header
+    const header = ` quickdraw bench │ tick=${model.tick} │ burn=${model.burnMs}ms │ ${model.paused ? "PAUSED" : "live"} `;
+    put(buf, 0, 0, pad(header, w), { role: "accent", prominence: FgP.primary, bold: true });
+    // stats line
+    const statsLine = ` fps=${stats.fps.toFixed(1)} frame=${stats.frameMs.toFixed(1)}ms gen=${stats.lastGen} drop≈${stats.snapshotsDropped} │ keys: j/k scroll  space pause  b/B burn  a burst  q quit `;
+    put(buf, 0, 1, pad(statsLine, w), { role: "foreground", prominence: FgP.secondary });
+    // split: log (left) + panel (right)
+    const panelW = Math.min(28, Math.floor(w * 0.3));
+    const logW = w - panelW - 1;
+    const bodyTop = 2;
+    const bodyH = h - 3;
+    const visible = bodyH;
+    // log region
+    for (let row = 0; row < visible; row++) {
+        const li = model.scroll + row;
+        const y = bodyTop + row;
+        if (li < 0 || li >= model.lines.length) {
+            put(buf, 0, y, pad("", logW), {});
+            continue;
+        }
+        const style = li % 17 === 0 ? { role: "warning", prominence: FgP.primary } : { role: "foreground", prominence: FgP.primary };
+        put(buf, 0, y, pad(model.lines[li].slice(0, logW), logW), style);
+    }
+    // divider
+    for (let row = 0; row < visible; row++) {
+        put(buf, logW, bodyTop + row, "│", { role: "border", prominence: FgP.ghost });
+    }
+    // side panel
+    const px = logW + 1;
+    put(buf, px, bodyTop, pad(" PANEL", panelW), {
+        role: "accent",
+        prominence: FgP.primary,
+        bold: true,
+    });
+    put(buf, px, bodyTop + 1, pad(` lines ${model.lines.length}`, panelW), {
+        role: "foreground",
+        prominence: FgP.primary,
+    });
+    put(buf, px, bodyTop + 2, pad(` scroll ${model.scroll}`, panelW), {
+        role: "foreground",
+        prominence: FgP.primary,
+    });
+    put(buf, px, bodyTop + 3, pad(` size ${w}x${h}`, panelW), {
+        role: "foreground",
+        prominence: FgP.primary,
+    });
+    const t = new Date(model.now).toISOString().slice(11, 23);
+    put(buf, px, bodyTop + 5, pad(` time ${t}`, panelW), {
+        role: "muted",
+        prominence: FgP.ghost,
+    });
+    // fake sparkline from tick
+    let spark = " ";
+    for (let i = 0; i < Math.max(0, panelW - 2); i++) {
+        const v = (Math.sin((model.tick + i) * 0.15) + 1) * 0.5;
+        spark += " ▁▂▃▄▅▆▇█"[Math.min(8, Math.floor(v * 9))];
+    }
+    // `accent` for now — no dedicated `data` role until a second data surface
+    // exists to justify one (plan: explicit non-commitment).
+    put(buf, px, bodyTop + 7, pad(spark.slice(0, panelW), panelW), {
+        role: "accent",
+        prominence: FgP.primary,
+    });
+    const configLabel = { role: "muted", prominence: FgP.ghost };
+    put(buf, px, bodyTop + 9, pad(" logic=worker", panelW), configLabel);
+    put(buf, px, bodyTop + 10, pad(" paint=main", panelW), configLabel);
+    put(buf, px, bodyTop + 11, pad(" target=30fps", panelW), configLabel);
+    // footer
+    put(buf, 0, h - 1, pad(` ${model.scroll + 1}-${Math.min(model.lines.length, model.scroll + visible)}/${model.lines.length} `, w), { role: "foreground", prominence: FgP.secondary });
+    return buf;
+}
+function pad(s, w) {
+    if (s.length >= w)
+        return s.slice(0, w);
+    return s + " ".repeat(w - s.length);
+}
+//# sourceMappingURL=view.js.map

package/dist/bench/view.js.map

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

package/dist/bench/worker.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Logic thread (worker_threads).
+ * Owns TEA model. Never touches stdout.
+ */
+export {};
+//# sourceMappingURL=worker.d.ts.map

package/dist/bench/worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../src/bench/worker.ts"],"names":[],"mappings":"AAAA;;;GAGG"}

package/dist/bench/worker.js

@@ -0,0 +1,46 @@
+/**
+ * Logic thread (worker_threads).
+ * Owns TEA model. Never touches stdout.
+ */
+import { parentPort } from "node:worker_threads";
+import { init, update } from "./model.js";
+if (!parentPort) {
+    throw new Error("worker must run as worker_thread");
+}
+const port = parentPort;
+let model = init(80, 24);
+let gen = 0;
+function publish() {
+    gen += 1;
+    const snap = {
+        gen,
+        model,
+        at: performance.now(),
+    };
+    const msg = { type: "snapshot", snap };
+    port.postMessage(msg);
+}
+function apply(msg) {
+    model = update(msg, model);
+    publish();
+}
+port.on("message", (raw) => {
+    switch (raw.type) {
+        case "init":
+            model = init(raw.cols, raw.rows);
+            gen = 0;
+            publish();
+            break;
+        case "resize":
+            apply({ type: "resize", cols: raw.cols, rows: raw.rows });
+            break;
+        case "key":
+            apply({ type: "key", key: raw.key });
+            break;
+        case "tick":
+            // coalesce: only one tick worth of work per message
+            apply({ type: "tick", now: raw.now });
+            break;
+    }
+});
+//# sourceMappingURL=worker.js.map

package/dist/bench/worker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.js","sourceRoot":"","sources":["../../src/bench/worker.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AAGjD,OAAO,EAAE,IAAI,EAAE,MAAM,EAAwB,MAAM,YAAY,CAAC;AAGhE,IAAI,CAAC,UAAU,EAAE,CAAC;IAChB,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,IAAI,GAAG,UAAU,CAAC;AACxB,IAAI,KAAK,GAAU,IAAI,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC;AAChC,IAAI,GAAG,GAAG,CAAC,CAAC;AAEZ,SAAS,OAAO;IACd,GAAG,IAAI,CAAC,CAAC;IACT,MAAM,IAAI,GAAoB;QAC5B,GAAG;QACH,KAAK;QACL,EAAE,EAAE,WAAW,CAAC,GAAG,EAAE;KACtB,CAAC;IACF,MAAM,GAAG,GAAwB,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;IAC5D,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC;AACxB,CAAC;AAED,SAAS,KAAK,CAAC,GAAQ;IACrB,KAAK,GAAG,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAC3B,OAAO,EAAE,CAAC;AACZ,CAAC;AAED,IAAI,CAAC,EAAE,CAAC,SAAS,EAAE,CAAC,GAAiB,EAAE,EAAE;IACvC,QAAQ,GAAG,CAAC,IAAI,EAAE,CAAC;QACjB,KAAK,MAAM;YACT,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;YACjC,GAAG,GAAG,CAAC,CAAC;YACR,OAAO,EAAE,CAAC;YACV,MAAM;QACR,KAAK,QAAQ;YACX,KAAK,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC;YAC1D,MAAM;QACR,KAAK,KAAK;YACR,KAAK,CAAC,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC;YACrC,MAAM;QACR,KAAK,MAAM;YACT,oDAAoD;YACpD,KAAK,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,GAAG,CAAC,GAAG,EAAE,CAAC,CAAC;YACtC,MAAM;IACV,CAAC;AACH,CAAC,CAAC,CAAC"}

package/dist/buffer/bgfx-mark.d.ts

@@ -0,0 +1,32 @@
+/**
+ * UV-stamp a bgFx shader id onto a cell rect. Paint-time only — no GL.
+ * Lives next to the cell fields so layout never imports internals/bgfx.
+ */
+export type BgFxMarkBuffer = {
+    width: number;
+    height: number;
+    cells: Array<{
+        ch: string;
+        placeholder?: boolean;
+        style: {
+            bgFx?: string;
+            bgFxU?: number;
+            bgFxV?: number;
+            bg?: number;
+            bgRgb?: unknown;
+            [key: string]: unknown;
+        };
+    }>;
+};
+export declare function fillBgFx(buf: BgFxMarkBuffer, rect: {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}, id: string, scissor?: {
+    x: number;
+    y: number;
+    w: number;
+    h: number;
+}): void;
+//# sourceMappingURL=bgfx-mark.d.ts.map

package/dist/buffer/bgfx-mark.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bgfx-mark.d.ts","sourceRoot":"","sources":["../../src/buffer/bgfx-mark.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,cAAc,GAAG;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,KAAK,CAAC;QACX,EAAE,EAAE,MAAM,CAAC;QACX,WAAW,CAAC,EAAE,OAAO,CAAC;QACtB,KAAK,EAAE;YACL,IAAI,CAAC,EAAE,MAAM,CAAC;YACd,KAAK,CAAC,EAAE,MAAM,CAAC;YACf,KAAK,CAAC,EAAE,MAAM,CAAC;YACf,EAAE,CAAC,EAAE,MAAM,CAAC;YACZ,KAAK,CAAC,EAAE,OAAO,CAAC;YAChB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;SACxB,CAAC;KACH,CAAC,CAAC;CACJ,CAAC;AAEF,wBAAgB,QAAQ,CACtB,GAAG,EAAE,cAAc,EACnB,IAAI,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,EACpD,EAAE,EAAE,MAAM,EACV,OAAO,CAAC,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,GACvD,IAAI,CAmCN"}

package/dist/buffer/bgfx-mark.js

@@ -0,0 +1,43 @@
+/**
+ * UV-stamp a bgFx shader id onto a cell rect. Paint-time only — no GL.
+ * Lives next to the cell fields so layout never imports internals/bgfx.
+ */
+export function fillBgFx(buf, rect, id, scissor) {
+    const { x: rx, y: ry, w: rw, h: rh } = rect;
+    if (rw <= 0 || rh <= 0)
+        return;
+    const { width: bw, height: bh, cells } = buf;
+    for (let dy = 0; dy < rh; dy++) {
+        const y = ry + dy;
+        if (y < 0 || y >= bh)
+            continue;
+        if (scissor && (y < scissor.y || y >= scissor.y + scissor.h)) {
+            continue;
+        }
+        const v = (dy + 0.5) / rh;
+        for (let dx = 0; dx < rw; dx++) {
+            const x = rx + dx;
+            if (x < 0 || x >= bw)
+                continue;
+            if (scissor && (x < scissor.x || x >= scissor.x + scissor.w)) {
+                continue;
+            }
+            const u = (dx + 0.5) / rw;
+            const i = y * bw + x;
+            const prev = cells[i];
+            cells[i] = {
+                ch: prev.ch && prev.ch !== " " ? prev.ch : " ",
+                placeholder: prev.placeholder,
+                style: {
+                    ...prev.style,
+                    bgFx: id,
+                    bgFxU: u,
+                    bgFxV: v,
+                    bg: undefined,
+                    bgRgb: undefined,
+                },
+            };
+        }
+    }
+}
+//# sourceMappingURL=bgfx-mark.js.map

package/dist/buffer/bgfx-mark.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"bgfx-mark.js","sourceRoot":"","sources":["../../src/buffer/bgfx-mark.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAmBH,MAAM,UAAU,QAAQ,CACtB,GAAmB,EACnB,IAAoD,EACpD,EAAU,EACV,OAAwD;IAExD,MAAM,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,GAAG,IAAI,CAAC;IAC5C,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,IAAI,CAAC;QAAE,OAAO;IAC/B,MAAM,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,GAAG,GAAG,CAAC;IAE7C,KAAK,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC;QAC/B,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC;QAClB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE;YAAE,SAAS;QAC/B,IAAI,OAAO,IAAI,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7D,SAAS;QACX,CAAC;QACD,MAAM,CAAC,GAAG,CAAC,EAAE,GAAG,GAAG,CAAC,GAAG,EAAE,CAAC;QAC1B,KAAK,IAAI,EAAE,GAAG,CAAC,EAAE,EAAE,GAAG,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC;YAC/B,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC;YAClB,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,EAAE;gBAAE,SAAS;YAC/B,IAAI,OAAO,IAAI,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC;gBAC7D,SAAS;YACX,CAAC;YACD,MAAM,CAAC,GAAG,CAAC,EAAE,GAAG,GAAG,CAAC,GAAG,EAAE,CAAC;YAC1B,MAAM,CAAC,GAAG,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;YACrB,MAAM,IAAI,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;YACvB,KAAK,CAAC,CAAC,CAAC,GAAG;gBACT,EAAE,EAAE,IAAI,CAAC,EAAE,IAAI,IAAI,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG;gBAC9C,WAAW,EAAE,IAAI,CAAC,WAAW;gBAC7B,KAAK,EAAE;oBACL,GAAG,IAAI,CAAC,KAAK;oBACb,IAAI,EAAE,EAAE;oBACR,KAAK,EAAE,CAAC;oBACR,KAAK,EAAE,CAAC;oBACR,EAAE,EAAE,SAAS;oBACb,KAAK,EAAE,SAAS;iBACjB;aACF,CAAC;QACJ,CAAC;IACH,CAAC;AACH,CAAC"}

package/dist/buffer/index.d.ts

@@ -0,0 +1,191 @@
+/**
+ * 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 type { Rgb } from "../lexicon/index.js";
+/**
+ * Sanitize text that will be painted as content cells (not our emit path).
+ * Removes ESC/CSI/OSC/DCS entirely for v1 (safest).
+ */
+export declare function guardContent(text: string): string;
+export type Style = {
+    bold?: boolean;
+    /**
+     * ANSI SGR 2 faint. **Not authorable** — widgets state `prominence`, not
+     * `dim`. Prominence is the authoring concept; the resolver may *emit*
+     * `dim` as the ansi16 degradation of `ghost`/`whisper`, where truecolor
+     * fades don't exist. This field stays for that emit path only.
+     */
+    dim?: boolean;
+    /** ANSI SGR 9 crossed-out. Markdown ~~strike~~ etc. */
+    strike?: boolean;
+    /** ANSI SGR 3 italic. Voice inflection — never expressed via `dim`. */
+    italic?: boolean;
+    /** ANSI SGR 4 underline. Link affordance: a link is accent + underline. */
+    underline?: boolean;
+    /** OSC 8 hyperlink target. Painted with accent + underline. */
+    href?: string;
+    /** 0–255 ANSI / xterm-256 index. Prefer fgRgb when truecolor available. */
+    fg?: number;
+    /**
+     * Truecolor foreground (0–255 per channel). Wins over `fg` when set.
+     * From ../theme/index.js role resolve — not hand-picked hex in widgets.
+     */
+    fgRgb?: Rgb;
+    /**
+     * Background. **Undefined means transparent** (inherit terminal ground).
+     * Never paint default black for unpainted cells (TERMINAL O1).
+     */
+    bg?: number;
+    /** Truecolor background; wins over `bg` when set. Still omit when transparent. */
+    bgRgb?: Rgb;
+    /**
+     * Occupy the background without painting a color (TERMINAL O1).
+     * Omitted bg fuses with the cell underneath (panel fill under text).
+     * `cast: "transparent"` claims absence so lower layers cannot show through.
+     */
+    cast?: "transparent";
+    /**
+     * Procedural background **shader id** (open string).
+     * Product: GLSL catalog ids (`gradient`, `aurora`, `doom`, or load path).
+     * Present expands to truecolor `bgRgb` only (no sub-cell glyphs).
+     * Typed as `string` here to keep buffer decoupled from `../internals/bgfx/index.js`;
+     * the branded `BgFxId` lives in that package.
+     */
+    bgFx?: string;
+    /** Region-local U ∈ [0,1] baked by `fillBgFx` (optional; else buffer coords). */
+    bgFxU?: number;
+    /** Region-local V ∈ [0,1] baked by `fillBgFx`. */
+    bgFxV?: number;
+    /**
+     * Multiplies global bgFx opacity (0–1). Quiet wash over ground.
+     * @see setBgFxOpacity
+     */
+    bgFxOpacity?: number;
+    /**
+     * Semantic role intent (ColorResolver dual-dirty). Not emitted to SGR;
+     * paint-time resolve re-solves against current theme/depth.
+     */
+    role?: string;
+    /** Own prominence request 0–1 (composed with regionProminence). */
+    prominence?: number;
+    /**
+     * Background role intent (ColorResolver dual-dirty), mirroring `role` for
+     * the BG ladder (panels, washes, surface). Not emitted to SGR directly —
+     * paint-time resolve turns it into `bg`/`bgRgb` against theme/depth.
+     */
+    bgRole?: string;
+    /** Own background prominence request 0–1, mirroring `prominence`. */
+    bgProminence?: number;
+    /**
+     * Local surface for FG opacity (prominence dissolve target). When text
+     * sits on painted furniture that is not this cell's bg, pass the parent
+     * surface role so low prominence fades into *that* color, not theme ground.
+     */
+    surfaceRole?: string;
+    /** Already-painted background, used as a fallback FG dissolve target. */
+    surfaceRgb?: Rgb;
+    /** Solidity of surfaceRole (BgP); default solid when surfaceRole set. */
+    surfaceProminence?: number;
+    /**
+     * FG dissolve target (another text role, not a BG surface). Low
+     * prominence fades toward that role's ink so a chromatic run can fuse
+     * into a contour. Distinct from {@link surfaceRole} (panel furniture).
+     */
+    fuseRole?: string;
+    /** Prominence of {@link fuseRole} (default ghost — box contour). */
+    fuseProminence?: number;
+    /**
+     * Mix this role's ink into {@link role} by {@link tint}. 0 = role only,
+     * 1 = full tint. Applied before prominence fade so a remaining-fill can
+     * warm toward warning while still dissolving into the contour.
+     */
+    tintRole?: string;
+    /** 0..1 mix of {@link tintRole} into {@link role}. */
+    tint?: number;
+    /** Region de-emphasis 0–1 (modal/backdrop). Resolver composition only. */
+    regionProminence?: number;
+    /**
+     * Cell is part of an active text selection. The ColorResolver applies the
+     * HK-aware perception-preserving recolor (see quickdraw-theme/selection.ts)
+     * to fg AND bg — shifting apparent lightness without touching hue. This
+     * solves the Zed #17313 blend problem by construction (no alpha-blend, no
+     * reverse-video). Dual-dirty: must participate in cellEq or toggling
+     * selection won't dirty the row (silent stale frame).
+     */
+    selected?: boolean;
+};
+export type Cell = {
+    /**
+     * Grapheme for this column. Empty when `placeholder` (wide-glyph mate).
+     * Emit skips placeholders so wide chars consume 2 columns, not 3.
+     */
+    ch: string;
+    style: Style;
+    /**
+     * Trailing mate of a wide (or multi-column) glyph to the left.
+     * Not written to the terminal; occupies a grid column only.
+     */
+    placeholder?: boolean;
+};
+export type Buffer = {
+    width: number;
+    height: number;
+    /** row-major, length = width * height */
+    cells: Cell[];
+};
+/** Sentinel ch for placeholder mates — never emitted. */
+export declare const PLACEHOLDER_CH = "";
+export declare function createBuffer(width: number, height: number): Buffer;
+export declare function clear(buf: Buffer): void;
+/**
+ * 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 declare function mergeStyle(under: Style, over: Style): 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 declare function put(buf: Buffer, x: number, y: number, text: string, style?: Style): void;
+/** Rows that differ (or all rows if size changed / no prev). */
+export declare function dirtyRows(prev: Buffer | null, next: Buffer): number[];
+export type EmitAnsiOpts = {
+    sync2026?: boolean;
+    forceFull?: boolean;
+};
+export type EmitAnsiStats = {
+    ansi: string;
+    dirtyRows: number;
+    bytes: number;
+};
+/**
+ * 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 declare function emitAnsiDetailed(prev: Buffer | null, next: Buffer, opts?: EmitAnsiOpts): EmitAnsiStats;
+/**
+ * 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 declare function emitAnsi(prev: Buffer | null, next: Buffer, opts?: EmitAnsiOpts): string;
+/** Shallow copy of buffer cells (for storing previous frame). */
+export declare function cloneBuffer(buf: Buffer): Buffer;
+export { fillBgFx } from "./bgfx-mark.js";
+//# sourceMappingURL=index.d.ts.map

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

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