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

package/LICENSE.md

@@ -0,0 +1,7 @@
+Copyright 2026 Merkle Bonsai
+
+Permission is hereby granted, free of charge, to any person obtaining a copy of this software and associated documentation files (the “Software”), to deal in the Software without restriction, including without limitation the rights to use, copy, modify, merge, publish, distribute, sublicense, and/or sell copies of the Software, and to permit persons to whom the Software is furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED “AS IS”, WITHOUT WARRANTY OF ANY KIND, EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.

package/README.md

@@ -1 +1,102 @@
-Placeholder for @inhuman.tools/quickdraw; see https://github.com/here-build/inhuman-harness
+# quickdraw
+
+**Terminal rendering substrate** for the harness — internal framework (cells,
+CSI, layout, theme, caps, input, present).
+
+In climbing, a **quickdraw** clips the *harness* into the bolt. Same wordplay:
+the product is the harness (`../harness/`); this tree is how it meets the
+terminal’s brutal reality.
+
+One package: `@inhuman.tools/quickdraw`. Grain stages (`src/{measure,lexicon,…}`) are folders, not
+npm names.
+
+| | |
+|---|---|
+| **Product** | The harness (`../harness/`). Not this renderer. |
+| **This tree** | Measure, layout, theme, caps, input, damage buffer, host present, paint widgets. |
+| **License** | [MIT](./LICENSE.md) |
+
+## Product home
+
+Quickdraw lives **inside the harness product root** (`../` — process packages in
+`../harness/`). Dual-mode is at the product root:
+
+```bash
+cd ..   # harness product root
+pnpm build
+pnpm test
+pnpm typecheck
+pnpm test:umbrella          # pnpm --filter @inhuman.tools/quickdraw test
+pnpm check:color-parity
+```
+
+From this package:
+
+```bash
+pnpm --filter @inhuman.tools/quickdraw storybook   # interactive catalog
+pnpm --filter @inhuman.tools/quickdraw visual      # mac terminal goldens (not CI)
+```
+
+## Tiers
+
+**Load-bearing core**
+
+- Cell buffer + dirty rows + ANSI emit + content guard
+- Layout tree → `Frame` → paint / hit / selection
+- Role & prominence theme (ground-aware, depth ladder)
+- TTY capability probe
+- One pure input decoder
+- Optional host present (mailboxes, TTY enter/exit order)
+
+**Paint widgets**
+
+- Streaming markdown, syntax highlight, structured diff
+- Thinking stream / composer chrome
+
+**Optional canary — not product chrome**
+
+- `src/internals/bgfx` + storybook `fx`: procedural cell wash to prove present-path
+  headroom under load. Cool if it runs; interactive paint still owns the loop.
+  Don’t build features on shaders.
+
+```bash
+pnpm --filter @inhuman.tools/quickdraw fx
+```
+
+## Package (`@inhuman.tools/quickdraw`)
+
+One package. Grain stages live in `src/` folders. Out-of-package code imports
+named subpaths below — never `src/` or `dist/` filesystem paths.
+
+| Export | Role |
+|--------|------|
+| `.` | `startRender` (UI thread; handle: `silenceInput` / `drainInput` / `stop` / `restore`) |
+| `./input` | Draft and key decode |
+| `./measure` | Display-column width |
+| `./runtime` | Worker paint seam, mailbox, raster, thought birth and collapsed |
+| `./widgets` | Light constructors (`Markdown`, `Diff`, `ComposerFrame`, …) |
+| `./widgets/*` | Granular constructors |
+| `./buffer` | Cell grid, dirty rows, ANSI emit |
+| `./lexicon` | Roles, prominence, quarantine brands |
+| `./layout` | Flex/grid tree → Frame, paint / hit / selection |
+| `./theme` | Ground-aware color solve |
+| `./capabilities` | TTY probe result |
+| `./internals/bgfx` | Present-path canary (not product chrome) |
+| `./internals/bgfx-worker` | Worker entry only |
+
+The catalog (`src/storybook`) and the present-path bench (`src/bench`) live in this package. Terminal screenshot driving lives in [`../harness-tui/src/e2e`](../harness-tui/src/e2e).
+
+```bash
+pnpm --filter @inhuman.tools/quickdraw storybook
+pnpm --filter @inhuman.tools/quickdraw fx
+pnpm --filter @inhuman.tools/quickdraw visual
+pnpm --filter @inhuman.tools/quickdraw bench
+pnpm --filter @inhuman.tools/quickdraw test
+```
+
+**Boundary:** substrate + paint widgets stay here. The agent product is
+`../harness/` (`@inhuman.tools/harness-*`).
+
+## License
+
+[MIT](./LICENSE.md).

package/aurora.vert

@@ -0,0 +1,168 @@
+// Auroras by nimitz 2017 (twitter: @stormoid)
+// License Creative Commons Attribution-NonCommercial-ShareAlike 3.0 Unported License
+// Contact the author for other licensing options
+
+/*
+
+	There are two main hurdles I encountered rendering this effect.
+	First, the nature of the texture that needs to be generated to get a believable effect
+	needs to be very specific, with large scale band-like structures, small scale non-smooth variations
+	to create the trail-like effect, a method for animating said texture smoothly and finally doing all
+	of this cheaply enough to be able to evaluate it several times per fragment/pixel.
+
+	The second obstacle is the need to render a large volume while keeping the computational cost low.
+	Since the effect requires the trails to extend way up in the atmosphere to look good, this means
+	that the evaluated volume cannot be as constrained as with cloud effects. My solution was to make
+	the sample stride increase polynomially, which works very well as long as the trails are lower opcaity than
+	the rest of the effect. Which is always the case for auroras.
+
+	After that, there were some issues with getting the correct emission curves and removing banding at lowered
+	sample densities, this was fixed by a combination of sample number influenced dithering and slight sample blending.
+
+	N.B. the base setup is from an old shader and ideally the effect would take an arbitrary ray origin and
+	direction. But this was not required for this demo and would be trivial to fix.
+*/
+
+#define time iTime
+
+mat2 mm2(in float a){float c = cos(a), s = sin(a);return mat2(c,s,-s,c);}
+mat2 m2 = mat2(0.95534, 0.29552, -0.29552, 0.95534);
+float tri(in float x){return clamp(abs(fract(x)-.5),0.01,0.49);}
+vec2 tri2(in vec2 p){return vec2(tri(p.x)+tri(p.y),tri(p.y+tri(p.x)));}
+
+float triNoise2d(in vec2 p, float spd)
+{
+    float z=1.8;
+    float z2=2.5;
+	float rz = 0.;
+    p *= mm2(p.x*0.06);
+    vec2 bp = p;
+	for (float i=0.; i<5.; i++ )
+	{
+        vec2 dg = tri2(bp*1.85)*.75;
+        dg *= mm2(time*spd);
+        p -= dg/z2;
+
+        bp *= 1.3;
+        z2 *= .45;
+        z *= .42;
+		p *= 1.21 + (rz-1.0)*.02;
+
+        rz += tri(p.x+tri(p.y))*z;
+        p*= -m2;
+	}
+    return clamp(1./pow(rz*29., 1.3),0.,.55);
+}
+
+float hash21(in vec2 n){ return fract(sin(dot(n, vec2(12.9898, 4.1414))) * 43758.5453); }
+vec4 aurora(vec3 ro, vec3 rd)
+{
+    vec4 col = vec4(0);
+    vec4 avgCol = vec4(0);
+
+    for(float i=0.;i<50.;i++)
+    {
+        float of = 0.006*hash21(gl_FragCoord.xy)*smoothstep(0.,15., i);
+        float pt = ((.8+pow(i,1.4)*.002)-ro.y)/(rd.y*2.+0.4);
+        pt -= of;
+    	vec3 bpos = ro + pt*rd;
+        vec2 p = bpos.zx;
+        float rzt = triNoise2d(p, 0.06);
+        vec4 col2 = vec4(0,0,0, rzt);
+        col2.rgb = (sin(1.-vec3(2.15,-.5, 1.2)+i*0.043)*0.5+0.5)*rzt;
+        avgCol =  mix(avgCol, col2, .5);
+        col += avgCol*exp2(-i*0.065 - 2.5)*smoothstep(0.,5., i);
+
+    }
+
+    col *= (clamp(rd.y*15.+.4,0.,1.));
+
+
+    //return clamp(pow(col,vec4(1.3))*1.5,0.,1.);
+    //return clamp(pow(col,vec4(1.7))*2.,0.,1.);
+    //return clamp(pow(col,vec4(1.5))*2.5,0.,1.);
+    //return clamp(pow(col,vec4(1.8))*1.5,0.,1.);
+
+    //return smoothstep(0.,1.1,pow(col,vec4(1.))*1.5);
+    return col*1.8;
+    //return pow(col,vec4(1.))*2.
+}
+
+
+//-------------------Background and Stars--------------------
+
+vec3 nmzHash33(vec3 q)
+{
+    uvec3 p = uvec3(ivec3(q));
+    p = p*uvec3(374761393U, 1103515245U, 668265263U) + p.zxy + p.yzx;
+    p = p.yzx*(p.zxy^(p >> 3U));
+    return vec3(p^(p >> 16U))*(1.0/vec3(0xffffffffU));
+}
+
+vec3 stars(in vec3 p)
+{
+    vec3 c = vec3(0.);
+    float res = iResolution.x*1.;
+
+	for (float i=0.;i<4.;i++)
+    {
+        vec3 q = fract(p*(.15*res))-0.5;
+        vec3 id = floor(p*(.15*res));
+        vec2 rn = nmzHash33(id).xy;
+        float c2 = 1.-smoothstep(0.,.6,length(q));
+        c2 *= step(rn.x,.0005+i*i*0.001);
+        c += c2*(mix(vec3(1.0,0.49,0.1),vec3(0.75,0.9,1.),rn.y)*0.1+0.9);
+        p *= 1.3;
+    }
+    return c*c*.8;
+}
+
+vec3 bg(in vec3 rd)
+{
+    float sd = dot(normalize(vec3(-0.5, -0.6, 0.9)), rd)*0.5+0.5;
+    sd = pow(sd, 5.);
+    vec3 col = mix(vec3(0.05,0.1,0.2), vec3(0.1,0.05,0.2), sd);
+    return col*.63;
+}
+//-----------------------------------------------------------
+
+
+void mainImage( out vec4 fragColor, in vec2 fragCoord )
+{
+	vec2 q = fragCoord.xy / iResolution.xy;
+    vec2 p = q - 0.5;
+	p.x*=iResolution.x/iResolution.y;
+
+    vec3 ro = vec3(0,0,-6.7);
+    vec3 rd = normalize(vec3(p,1.3));
+    vec2 mo = iMouse.xy / iResolution.xy-.5;
+    mo = (mo==vec2(-.5))?mo=vec2(-0.1,0.1):mo;
+	mo.x *= iResolution.x/iResolution.y;
+    rd.yz *= mm2(mo.y);
+    rd.xz *= mm2(mo.x + sin(time*0.05)*0.2);
+
+    vec3 col = vec3(0.);
+    vec3 brd = rd;
+    float fade = smoothstep(0.,0.01,abs(brd.y))*0.1+0.9;
+
+    col = bg(rd)*fade;
+
+    if (rd.y > 0.){
+        vec4 aur = smoothstep(0.,1.5,aurora(ro,rd))*fade;
+        col += stars(rd);
+        col = col*(1.-aur.a) + aur.rgb;
+    }
+    else //Reflections
+    {
+        rd.y = abs(rd.y);
+        col = bg(rd)*fade*0.6;
+        vec4 aur = smoothstep(0.0,2.5,aurora(ro,rd));
+        col += stars(rd)*0.1;
+        col = col*(1.-aur.a) + aur.rgb;
+        vec3 pos = ro + ((0.5-ro.y)/rd.y)*rd;
+        float nz2 = triNoise2d(pos.xz*vec2(.5,.7), 0.);
+        col += mix(vec3(0.2,0.25,0.5)*0.08,vec3(0.3,0.3,0.5)*0.7, nz2*0.4);
+    }
+
+	fragColor = vec4(col, 1.);
+}

package/dist/bench/host.d.ts

@@ -0,0 +1,62 @@
+/**
+ * TEA host pieces for the fps experiment — the retired first-generation host,
+ * kept bench-local. The product protocol is box-bus (`quickdraw-runtime`);
+ * this whole-model snapshot channel exists only to drive the load box.
+ */
+import type { Generation, Snapshot } from "./tea.js";
+/** Main → Worker */
+export type HostToWorker = {
+    type: "init";
+    cols: number;
+    rows: number;
+} | {
+    type: "resize";
+    cols: number;
+    rows: number;
+} | {
+    type: "key";
+    key: string;
+} | {
+    type: "tick";
+    now: number;
+};
+/** Worker → Main */
+export type WorkerToHost<Model> = {
+    type: "snapshot";
+    snap: Snapshot<Model>;
+};
+/**
+ * Latest-wins box: render always takes the freshest snapshot.
+ * Intermediate models are dropped (backpressure).
+ *
+ * **Thread-safety invariant:** single host event loop only. Safe when the
+ * worker `message` handler and the present `onFrame` callback both run on the
+ * same Node/main event loop (never concurrent). No Atomics — do not share one
+ * mailbox across workers/OS threads or move paint off that loop without a
+ * redesign.
+ */
+export declare class LatestMailbox<Model> {
+    private snap;
+    private dropped;
+    /** One call may carry a burst. The newest gen wins; older gens in the burst count as dropped. */
+    push(...snaps: Snapshot<Model>[]): void;
+    /** Read without clearing (render may re-read same gen if no update). */
+    peek(): Snapshot<Model> | null;
+    takeDropped(): number;
+}
+export type FpsStats = {
+    fps: number;
+    frameMs: number;
+    presents: number;
+    skippedEmpty: number;
+    snapshotsDropped: number;
+    lastGen: Generation;
+};
+export declare function createFpsTracker(): {
+    recordPresent: (frameMs: number) => void;
+    recordSkip: () => void;
+    addDropped: (n: number) => void;
+    setGen: (g: Generation) => void;
+    sample: () => FpsStats;
+};
+//# sourceMappingURL=host.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"host.d.ts","sourceRoot":"","sources":["../../src/bench/host.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAErD,oBAAoB;AACpB,MAAM,MAAM,YAAY,GACpB;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC5C;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9C;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAC5B;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,CAAC;AAElC,oBAAoB;AACpB,MAAM,MAAM,YAAY,CAAC,KAAK,IAAI;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,IAAI,EAAE,QAAQ,CAAC,KAAK,CAAC,CAAA;CAAE,CAAC;AAE9E;;;;;;;;;GASG;AACH,qBAAa,aAAa,CAAC,KAAK;IAC9B,OAAO,CAAC,IAAI,CAAgC;IAC5C,OAAO,CAAC,OAAO,CAAK;IAEpB,iGAAiG;IACjG,IAAI,CAAC,GAAG,KAAK,EAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,GAAG,IAAI;IAQvC,wEAAwE;IACxE,IAAI,IAAI,QAAQ,CAAC,KAAK,CAAC,GAAG,IAAI;IAI9B,WAAW,IAAI,MAAM;CAKtB;AAED,MAAM,MAAM,QAAQ,GAAG;IACrB,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,YAAY,EAAE,MAAM,CAAC;IACrB,gBAAgB,EAAE,MAAM,CAAC;IACzB,OAAO,EAAE,UAAU,CAAC;CACrB,CAAC;AAEF,wBAAgB,gBAAgB,IAAI;IAClC,aAAa,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;IACzC,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,UAAU,EAAE,CAAC,CAAC,EAAE,MAAM,KAAK,IAAI,CAAC;IAChC,MAAM,EAAE,CAAC,CAAC,EAAE,UAAU,KAAK,IAAI,CAAC;IAChC,MAAM,EAAE,MAAM,QAAQ,CAAC;CACxB,CA2CA"}

package/dist/bench/host.js

@@ -0,0 +1,77 @@
+/**
+ * Latest-wins box: render always takes the freshest snapshot.
+ * Intermediate models are dropped (backpressure).
+ *
+ * **Thread-safety invariant:** single host event loop only. Safe when the
+ * worker `message` handler and the present `onFrame` callback both run on the
+ * same Node/main event loop (never concurrent). No Atomics — do not share one
+ * mailbox across workers/OS threads or move paint off that loop without a
+ * redesign.
+ */
+export class LatestMailbox {
+    snap = null;
+    dropped = 0;
+    /** One call may carry a burst. The newest gen wins; older gens in the burst count as dropped. */
+    push(...snaps) {
+        for (const snap of snaps) {
+            if (this.snap !== null && snap.gen < this.snap.gen)
+                continue;
+            if (this.snap !== null)
+                this.dropped += 1;
+            this.snap = snap;
+        }
+    }
+    /** Read without clearing (render may re-read same gen if no update). */
+    peek() {
+        return this.snap;
+    }
+    takeDropped() {
+        const d = this.dropped;
+        this.dropped = 0;
+        return d;
+    }
+}
+export function createFpsTracker() {
+    let windowStart = performance.now();
+    let presents = 0;
+    let skipped = 0;
+    let dropped = 0;
+    let lastFrameMs = 0;
+    let lastGen = 0;
+    let fps = 0;
+    /** Count in the current 1s window for live fps. */
+    let windowPresents = 0;
+    return {
+        recordPresent(frameMs) {
+            presents += 1;
+            windowPresents += 1;
+            lastFrameMs = frameMs;
+            const now = performance.now();
+            if (now - windowStart >= 1000) {
+                fps = windowPresents / ((now - windowStart) / 1000);
+                windowPresents = 0;
+                windowStart = now;
+            }
+        },
+        recordSkip() {
+            skipped += 1;
+        },
+        addDropped(n) {
+            dropped += n;
+        },
+        setGen(g) {
+            lastGen = g;
+        },
+        sample() {
+            return {
+                fps,
+                frameMs: lastFrameMs,
+                presents,
+                skippedEmpty: skipped,
+                snapshotsDropped: dropped,
+                lastGen,
+            };
+        },
+    };
+}
+//# sourceMappingURL=host.js.map

package/dist/bench/host.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"host.js","sourceRoot":"","sources":["../../src/bench/host.ts"],"names":[],"mappings":"AAiBA;;;;;;;;;GASG;AACH,MAAM,OAAO,aAAa;IAChB,IAAI,GAA2B,IAAI,CAAC;IACpC,OAAO,GAAG,CAAC,CAAC;IAEpB,iGAAiG;IACjG,IAAI,CAAC,GAAG,KAAwB;QAC9B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI,IAAI,IAAI,CAAC,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG;gBAAE,SAAS;YAC7D,IAAI,IAAI,CAAC,IAAI,KAAK,IAAI;gBAAE,IAAI,CAAC,OAAO,IAAI,CAAC,CAAC;YAC1C,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC;QACnB,CAAC;IACH,CAAC;IAED,wEAAwE;IACxE,IAAI;QACF,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED,WAAW;QACT,MAAM,CAAC,GAAG,IAAI,CAAC,OAAO,CAAC;QACvB,IAAI,CAAC,OAAO,GAAG,CAAC,CAAC;QACjB,OAAO,CAAC,CAAC;IACX,CAAC;CACF;AAWD,MAAM,UAAU,gBAAgB;IAO9B,IAAI,WAAW,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;IACpC,IAAI,QAAQ,GAAG,CAAC,CAAC;IACjB,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,IAAI,OAAO,GAAe,CAAC,CAAC;IAC5B,IAAI,GAAG,GAAG,CAAC,CAAC;IACZ,mDAAmD;IACnD,IAAI,cAAc,GAAG,CAAC,CAAC;IAEvB,OAAO;QACL,aAAa,CAAC,OAAO;YACnB,QAAQ,IAAI,CAAC,CAAC;YACd,cAAc,IAAI,CAAC,CAAC;YACpB,WAAW,GAAG,OAAO,CAAC;YACtB,MAAM,GAAG,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;YAC9B,IAAI,GAAG,GAAG,WAAW,IAAI,IAAI,EAAE,CAAC;gBAC9B,GAAG,GAAG,cAAc,GAAG,CAAC,CAAC,GAAG,GAAG,WAAW,CAAC,GAAG,IAAI,CAAC,CAAC;gBACpD,cAAc,GAAG,CAAC,CAAC;gBACnB,WAAW,GAAG,GAAG,CAAC;YACpB,CAAC;QACH,CAAC;QACD,UAAU;YACR,OAAO,IAAI,CAAC,CAAC;QACf,CAAC;QACD,UAAU,CAAC,CAAC;YACV,OAAO,IAAI,CAAC,CAAC;QACf,CAAC;QACD,MAAM,CAAC,CAAC;YACN,OAAO,GAAG,CAAC,CAAC;QACd,CAAC;QACD,MAAM;YACJ,OAAO;gBACL,GAAG;gBACH,OAAO,EAAE,WAAW;gBACpB,QAAQ;gBACR,YAAY,EAAE,OAAO;gBACrB,gBAAgB,EAAE,OAAO;gBACzB,OAAO;aACR,CAAC;QACJ,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/bench/main.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Render thread (main).
+ * Spawns logic worker, presents @ targetFps, writes ANSI to stdout.
+ */
+export {};
+//# sourceMappingURL=main.d.ts.map

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

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

package/dist/bench/main.js

@@ -0,0 +1,118 @@
+/**
+ * Render thread (main).
+ * Spawns logic worker, presents @ targetFps, writes ANSI to stdout.
+ */
+import path from "node:path";
+import process from "node:process";
+import { fileURLToPath } from "node:url";
+import { Worker } from "node:worker_threads";
+import { createFpsTracker, LatestMailbox } from "./host.js";
+import { cloneBuffer, emitAnsi } from "../buffer/index.js";
+import { startPresentLoop } from "../index.js";
+import { paint } from "./view.js";
+const TARGET_FPS = Number(process.env.QD_FPS ?? 30);
+const TICK_MS = Number(process.env.QD_TICK_MS ?? 50); // logic clock / log growth
+const SYNC_2026 = process.env.QD_SYNC !== "0";
+const __dirname = path.dirname(fileURLToPath(import.meta.url));
+function termSize() {
+    return {
+        cols: process.stdout.columns || 80,
+        rows: process.stdout.rows || 24,
+    };
+}
+const mailbox = new LatestMailbox();
+const fps = createFpsTracker();
+let prev = null;
+let canvas;
+let lastPaintedGen = -1;
+let worker;
+function send(msg) {
+    worker.postMessage(msg);
+}
+function setupTerminal() {
+    process.stdout.write("\u001B[?1049h"); // alt screen
+    process.stdout.write("\u001B[?25l"); // hide cursor
+    process.stdout.write("\u001B[?7l"); // no wrap
+    if (process.stdin.isTTY) {
+        process.stdin.setRawMode(true);
+        process.stdin.resume();
+        process.stdin.setEncoding("utf8");
+    }
+}
+/** Restore TTY and exit. `code` defaults to 0 (clean quit); errors pass 1. */
+function teardown(code = 0) {
+    present.stop();
+    clearInterval(tickTimer);
+    void worker.terminate();
+    if (process.stdin.isTTY)
+        process.stdin.setRawMode(false);
+    process.stdout.write("\u001B[?25h\u001B[?7h\u001B[?1049l");
+    process.stdout.write("\n");
+    const s = fps.sample();
+    console.error(`[quickdraw] last fps=${s.fps.toFixed(1)} frameMs=${s.frameMs.toFixed(1)} gen=${s.lastGen}`);
+    process.exit(code);
+}
+function onFrame(_dt) {
+    fps.addDropped(mailbox.takeDropped());
+    const snap = mailbox.peek();
+    if (!snap) {
+        fps.recordSkip();
+        return;
+    }
+    // Still present when gen unchanged (clock panel updates only if tick advanced;
+    // for steady fps measurement we always paint when we have a snapshot).
+    const t0 = performance.now();
+    const stats = fps.sample();
+    fps.setGen(snap.gen);
+    canvas = paint(snap.model, stats, canvas);
+    const ansi = emitAnsi(prev, canvas, {
+        sync2026: SYNC_2026,
+        forceFull: prev === null || lastPaintedGen < 0,
+    });
+    if (ansi)
+        process.stdout.write(ansi);
+    prev = cloneBuffer(canvas);
+    lastPaintedGen = snap.gen;
+    fps.recordPresent(performance.now() - t0);
+}
+// --- boot ---
+setupTerminal();
+const { cols, rows } = termSize();
+// Load the compiled worker beside this file. `tsc` emits `dist/bench/worker.js`;
+// worker_threads + tsx is brittle for a `.js` specifier that should be `.ts`.
+const workerPath = path.resolve(__dirname, "worker.js");
+worker = new Worker(workerPath);
+worker.on("message", (msg) => {
+    if (msg.type === "snapshot") {
+        mailbox.push(msg.snap);
+    }
+});
+worker.on("error", (err) => {
+    // Teardown ends in process.exit — log first, then exit non-zero (C9).
+    console.error(err);
+    teardown(1);
+});
+send({ type: "init", cols, rows });
+const present = startPresentLoop({
+    targetFps: TARGET_FPS,
+    onFrame,
+});
+const tickTimer = setInterval(() => {
+    send({ type: "tick", now: Date.now() });
+}, TICK_MS);
+process.stdout.on("resize", () => {
+    const s = termSize();
+    send({ type: "resize", cols: s.cols, rows: s.rows });
+    prev = null; // keyframe after resize
+});
+process.stdin.on("data", (chunk) => {
+    const key = typeof chunk === "string" ? chunk : chunk.toString("utf8");
+    if (key === "q" || key === "\u0003") {
+        teardown();
+        return;
+    }
+    send({ type: "key", key });
+});
+process.on("SIGINT", teardown);
+process.on("SIGTERM", teardown);
+//# sourceMappingURL=main.js.map

package/dist/bench/main.js.map

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

package/dist/bench/model.d.ts

@@ -0,0 +1,36 @@
+/**
+ * Experiment model: scrollable log + side panel + clock + optional CPU burn.
+ * Shared types for worker and main (view runs on main).
+ */
+export type Msg = {
+    type: "tick";
+    now: number;
+} | {
+    type: "key";
+    key: string;
+} | {
+    type: "resize";
+    cols: number;
+    rows: number;
+} | {
+    type: "append_burst";
+    count: number;
+} | {
+    type: "set_burn";
+    ms: number;
+};
+export type Model = {
+    cols: number;
+    rows: number;
+    /** monologue log lines */
+    lines: string[];
+    scroll: number;
+    now: number;
+    tick: number;
+    /** artificial load in update (ms busy-loop) to prove render isolation */
+    burnMs: number;
+    paused: boolean;
+};
+export declare function init(cols: number, rows: number): Model;
+export declare function update(msg: Msg, model: Model): Model;
+//# sourceMappingURL=model.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"model.d.ts","sourceRoot":"","sources":["../../src/bench/model.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,MAAM,MAAM,GAAG,GACX;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAC7B;IAAE,IAAI,EAAE,KAAK,CAAC;IAAC,GAAG,EAAE,MAAM,CAAA;CAAE,GAC5B;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC9C;IAAE,IAAI,EAAE,cAAc,CAAC;IAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACvC;IAAE,IAAI,EAAE,UAAU,CAAC;IAAC,EAAE,EAAE,MAAM,CAAA;CAAE,CAAC;AAErC,MAAM,MAAM,KAAK,GAAG;IAClB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,0BAA0B;IAC1B,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,yEAAyE;IACzE,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,OAAO,CAAC;CACjB,CAAC;AAIF,wBAAgB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,KAAK,CAetD;AAcD,wBAAgB,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,KAAK,EAAE,KAAK,GAAG,KAAK,CA8CpD"}