@inhuman.tools/quickdraw 0.0.0-stage → 0.2.0

package/dist/internals/bgfx/shadertoy-gl.js

@@ -0,0 +1,283 @@
+/**
+ * Shadertoy GLSL host via headless-gl (optional native dep `gl`).
+ *
+ * Renders full frames (not per-cell samples) — correct for heavy raytracers
+ * like Doom E1M1. Call `renderFrame(w,h,env)` once per present, scatter RGBA.
+ */
+import { createRequire } from "node:module";
+import { dirname, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import invariant from "tiny-invariant";
+function asCreateGL(mod) {
+    if (typeof mod === "function")
+        return mod;
+    if (mod && typeof mod === "object" && "default" in mod) {
+        const d = mod.default;
+        if (typeof d === "function")
+            return d;
+    }
+    return null;
+}
+/** Optional absolute path injected via workerData (main resolves `gl` reliably). */
+let glModulePathOverride = null;
+let lastGlLoadError = null;
+export function setGlModulePath(absPath) {
+    glModulePathOverride = absPath;
+    lastGlLoadError = null;
+}
+/**
+ * Resolve path to `gl` **without loading** the native addon.
+ * Loading `webgl.node` on main + worker causes "Module did not self-register"
+ * under vitest's thread pool — worker path must be the sole loader when used.
+ */
+export function resolveGlModulePath() {
+    const here = dirname(fileURLToPath(import.meta.url));
+    const packageRoot = resolve(here, "..");
+    const attempts = [
+        { requireFrom: import.meta.url, id: "gl" },
+        { requireFrom: resolve(packageRoot, "package.json"), id: "gl" },
+    ];
+    for (const { requireFrom, id } of attempts) {
+        try {
+            const require = createRequire(requireFrom);
+            return require.resolve(id);
+        }
+        catch {
+            /* next */
+        }
+    }
+    return null;
+}
+function loadCreateGL() {
+    const here = dirname(fileURLToPath(import.meta.url));
+    const packageRoot = resolve(here, "..");
+    // Prefer absolute path from main (vitest nested-worker resolve is flaky).
+    if (glModulePathOverride) {
+        try {
+            const require = createRequire(glModulePathOverride);
+            const fn = asCreateGL(require(glModulePathOverride));
+            if (fn)
+                return fn;
+        }
+        catch (error) {
+            lastGlLoadError = error instanceof Error ? error.message : String(error);
+        }
+    }
+    const ids = ["gl", resolve(packageRoot, "node_modules/gl/index.js")];
+    const requireFroms = [import.meta.url, resolve(packageRoot, "package.json")];
+    for (const requireFrom of requireFroms) {
+        for (const id of ids) {
+            try {
+                const require = createRequire(requireFrom);
+                const fn = asCreateGL(require(id));
+                if (fn)
+                    return fn;
+            }
+            catch {
+                /* next */
+            }
+        }
+    }
+    return null;
+}
+export function shadertoyGlAvailable() {
+    // Resolve-only — do not load native addon (worker exclusivity).
+    return resolveGlModulePath() !== null;
+}
+const VS = `
+attribute vec2 a_pos;
+void main() {
+  gl_Position = vec4(a_pos, 0.0, 1.0);
+}
+`;
+/** WebGL1-friendly preprocessing for Shadertoy sources. */
+export function preprocessShadertoySource(source) {
+    let body = source.replace(/^\s*#version[^\n]*\n/, "");
+    // GLSL ES 1.00 / WebGL1 aliases
+    body = body.replaceAll(/\bmat2x2\b/g, "mat2");
+    body = body.replaceAll(/\btexture\s*\(/g, "texture2D(");
+    // Terminal budget: drop AA multi-sample if present
+    body = body.replaceAll(/#define\s+AA\s+\d+/g, "#define AA 1");
+    // uvec* hash (WebGL2) → float hash (WebGL1). Matches nimitz-style nmzHash33.
+    body = body.replace(/vec3\s+nmzHash33\s*\(\s*vec3\s+q\s*\)\s*\{[\s\S]*?return\s+vec3\s*\([^;]+;\s*\}/, `vec3 nmzHash33(vec3 q){
+    vec3 p = floor(q);
+    p = fract(p * vec3(0.1031, 0.1030, 0.0973));
+    p += dot(p, p.yxz + 33.33);
+    return fract((p.xxy + p.yxx) * p.zyx);
+}`);
+    return body;
+}
+/** 1×1 white — iChannel stubs. One allocation for the process, not per frame. */
+const WHITE_1X1 = new Uint8Array([255, 255, 255, 255]);
+function wrapShadertoy(source) {
+    const body = preprocessShadertoySource(source);
+    return `
+precision highp float;
+
+uniform vec3 iResolution;
+uniform float iTime;
+uniform float iTimeDelta;
+uniform float iFrame;
+uniform float iFrameRate;
+uniform vec4 iMouse;
+uniform vec4 iDate;
+uniform float iSampleRate;
+uniform float iPolarity;
+uniform sampler2D iChannel0;
+uniform sampler2D iChannel1;
+uniform sampler2D iChannel2;
+uniform sampler2D iChannel3;
+
+${body}
+
+void main() {
+  vec4 col;
+  mainImage(col, gl_FragCoord.xy);
+  gl_FragColor = col;
+}
+`;
+}
+/**
+ * Create a reusable Shadertoy host for one GLSL source (mainImage entry).
+ * Context is recreated when size changes.
+ */
+export function createShadertoyProgram(glslSource) {
+    const createGL = loadCreateGL();
+    invariant(createGL, `headless-gl (\`gl\` package) not available — cannot run Shadertoy GLSL` +
+        ` (glPathOverride=${glModulePathOverride ?? "null"}; err=${lastGlLoadError ?? "n/a"})`);
+    let gl = null;
+    let prog = null;
+    let channelTex = null;
+    let ctxW = 0;
+    let ctxH = 0;
+    let frameCount = 0;
+    let fragSrc = wrapShadertoy(glslSource);
+    const makeGL = createGL;
+    /** Readback + Y-flip. Reallocated only when `ensureSize` changes w×h. */
+    let raw = new Uint8Array(0);
+    let rgba = new Uint8Array(0);
+    function compileShader(g, type, src) {
+        const s = g.createShader(type);
+        g.shaderSource(s, src);
+        g.compileShader(s);
+        invariant(g.getShaderParameter(s, g.COMPILE_STATUS), () => `GLSL compile: ${g.getShaderInfoLog(s)}`);
+        return s;
+    }
+    function bindDummyChannels(g, p) {
+        // 1×1 white — stubs iChannel0..3 for shaders that sample them
+        if (!channelTex) {
+            channelTex = g.createTexture();
+            g.bindTexture(g.TEXTURE_2D, channelTex);
+            g.texParameteri(g.TEXTURE_2D, g.TEXTURE_MIN_FILTER, g.NEAREST);
+            g.texParameteri(g.TEXTURE_2D, g.TEXTURE_MAG_FILTER, g.NEAREST);
+            g.texParameteri(g.TEXTURE_2D, g.TEXTURE_WRAP_S, g.CLAMP_TO_EDGE);
+            g.texParameteri(g.TEXTURE_2D, g.TEXTURE_WRAP_T, g.CLAMP_TO_EDGE);
+            g.texImage2D(g.TEXTURE_2D, 0, g.RGBA, 1, 1, 0, g.RGBA, g.UNSIGNED_BYTE, WHITE_1X1);
+        }
+        for (let i = 0; i < 4; i++) {
+            g.activeTexture(g.TEXTURE0 + i);
+            g.bindTexture(g.TEXTURE_2D, channelTex);
+            const loc = g.getUniformLocation(p, `iChannel${i}`);
+            if (loc != null)
+                g.uniform1i(loc, i);
+        }
+        g.activeTexture(g.TEXTURE0);
+    }
+    function linkProgram(g) {
+        const p = g.createProgram();
+        g.attachShader(p, compileShader(g, g.VERTEX_SHADER, VS));
+        g.attachShader(p, compileShader(g, g.FRAGMENT_SHADER, fragSrc));
+        g.linkProgram(p);
+        invariant(g.getProgramParameter(p, g.LINK_STATUS), () => `GLSL link: ${g.getProgramInfoLog(p)}`);
+        prog = p;
+        g.useProgram(p);
+        const vbo = g.createBuffer();
+        g.bindBuffer(g.ARRAY_BUFFER, vbo);
+        g.bufferData(g.ARRAY_BUFFER, new Float32Array([-1, -1, 1, -1, -1, 1, 1, 1]), g.STATIC_DRAW);
+        const loc = g.getAttribLocation(p, "a_pos");
+        g.enableVertexAttribArray(loc);
+        g.vertexAttribPointer(loc, 2, g.FLOAT, false, 0, 0);
+        bindDummyChannels(g, p);
+    }
+    function ensureSize(w, h) {
+        if (gl && ctxW === w && ctxH === h && prog)
+            return;
+        if (gl) {
+            gl.getExtension("STACKGL_destroy_context")?.destroy();
+            gl = null;
+            prog = null;
+            channelTex = null;
+        }
+        const g = makeGL(w, h, { preserveDrawingBuffer: true });
+        invariant(g, "createGL failed");
+        gl = g;
+        ctxW = w;
+        ctxH = h;
+        const need = w * h * 4;
+        if (raw.length !== need) {
+            raw = new Uint8Array(need);
+            rgba = new Uint8Array(need);
+        }
+        linkProgram(g);
+    }
+    return {
+        ensureCompiled() {
+            ensureSize(4, 4);
+        },
+        /** Hot-swap GLSL (recompile); keeps context size. */
+        setSource(source) {
+            fragSrc = wrapShadertoy(source);
+            if (gl) {
+                linkProgram(gl);
+            }
+            else {
+                ensureSize(4, 4);
+            }
+            frameCount = 0;
+        },
+        renderFrame(w, h, env) {
+            const width = Math.max(1, w | 0);
+            const height = Math.max(1, h | 0);
+            ensureSize(width, height);
+            const g = gl;
+            g.useProgram(prog);
+            bindDummyChannels(g, prog);
+            g.viewport(0, 0, width, height);
+            g.uniform3f(g.getUniformLocation(prog, "iResolution"), width, height, 1);
+            g.uniform1f(g.getUniformLocation(prog, "iTime"), env.t);
+            g.uniform1f(g.getUniformLocation(prog, "iPolarity"), env.polarity === "light" ? -1 : 1);
+            g.uniform1f(g.getUniformLocation(prog, "iTimeDelta"), 1 / 30);
+            g.uniform1f(g.getUniformLocation(prog, "iFrame"), frameCount++);
+            g.uniform1f(g.getUniformLocation(prog, "iFrameRate"), 30);
+            const m = env.mouse ?? { x: 0, y: 0, z: 0, w: 0 };
+            // Shadertoy iMouse in pixels; accept 0..1 normalized or pixel-ish
+            const mx = m.x <= 1 && m.y <= 1 ? m.x * width : m.x;
+            const my = m.x <= 1 && m.y <= 1 ? m.y * height : m.y;
+            const mz = m.z <= 1 && m.z > 0 ? m.z * width : m.z;
+            const mw = m.w <= 1 && m.w > 0 ? m.w * height : m.w;
+            g.uniform4f(g.getUniformLocation(prog, "iMouse"), mx, my, mz, mw);
+            const now = new Date();
+            g.uniform4f(g.getUniformLocation(prog, "iDate"), now.getFullYear(), now.getMonth(), now.getDate(), now.getHours() * 3600 + now.getMinutes() * 60 + now.getSeconds() + now.getMilliseconds() / 1000);
+            g.clearColor(0, 0, 0, 1);
+            g.clear(g.COLOR_BUFFER_BIT);
+            g.drawArrays(g.TRIANGLE_STRIP, 0, 4);
+            g.readPixels(0, 0, width, height, g.RGBA, g.UNSIGNED_BYTE, raw);
+            // Flip Y → top-left origin for cell mapping. `rgba` is reused;
+            // valid until the next renderFrame / resize.
+            const row = width * 4;
+            for (let y = 0; y < height; y++) {
+                const src = (height - 1 - y) * row;
+                rgba.set(raw.subarray(src, src + row), y * row);
+            }
+            return { width, height, rgba };
+        },
+        [Symbol.dispose]() {
+            if (gl) {
+                gl.getExtension("STACKGL_destroy_context")?.destroy();
+                gl = null;
+            }
+            prog = null;
+        },
+    };
+}
+//# sourceMappingURL=shadertoy-gl.js.map

package/dist/internals/bgfx/shadertoy-gl.js.map

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

package/dist/internals/bgfx/types.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Procedural cell backgrounds = GLSL color-field shaders.
+ *
+ * Product path: headless-gl (`renderFrame`) via shadertoy catalog / worker.
+ */
+/** Shader program id. Open string — not a closed enum. */
+export type BgFxId = string;
+/** Re-export — single source of truth is ../../capabilities/index.js. */
+/**
+ * Frame uniforms — Shadertoy-shaped so ports map 1:1 in spirit:
+ *   iTime ← t, iResolution ← resolution, iMouse ← mouse
+ */
+export type BgFxEnv = {
+    /** Seconds (iTime). */
+    t: number;
+    /** Field size in cells or pixels of the region (iResolution.xy). */
+    resolution: {
+        x: number;
+        y: number;
+    };
+    /**
+     * Optional pointer (iMouse): xy = current, zw = click anchor / press.
+     * Absent → program uses zeros.
+     */
+    mouse?: {
+        x: number;
+        y: number;
+        z: number;
+        w: number;
+    };
+    /**
+     * Canvas polarity. Shadertoy `iPolarity` is +1 on dark ground, −1 on light
+     * so mixes/steering invert with the theme instead of staying "lighter = up".
+     */
+    polarity?: "dark" | "light";
+};
+/** Full-frame RGBA (top-left origin) from a frame shader. */
+export type BgFxFrame = {
+    width: number;
+    height: number;
+    /** length = width * height * 4 */
+    rgba: Uint8Array;
+};
+/** One registered color field — `renderFrame` is required. */
+export type BgFxProgram = {
+    id: BgFxId;
+    renderFrame: (w: number, h: number, env: BgFxEnv) => BgFxFrame;
+};
+export declare function clampByte(n: number): number;
+export declare function mix(a: number, b: number, t: number): number;
+//# sourceMappingURL=types.d.ts.map

package/dist/internals/bgfx/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/internals/bgfx/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,0DAA0D;AAC1D,MAAM,MAAM,MAAM,GAAG,MAAM,CAAC;AAE5B,yEAAyE;AAEzE;;;GAGG;AACH,MAAM,MAAM,OAAO,GAAG;IACpB,uBAAuB;IACvB,CAAC,EAAE,MAAM,CAAC;IACV,oEAAoE;IACpE,UAAU,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACrC;;;OAGG;IACH,KAAK,CAAC,EAAE;QAAE,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAC;QAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IACvD;;;OAGG;IACH,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CAC7B,CAAC;AAEF,6DAA6D;AAC7D,MAAM,MAAM,SAAS,GAAG;IACtB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,kCAAkC;IAClC,IAAI,EAAE,UAAU,CAAC;CAClB,CAAC;AAEF,8DAA8D;AAC9D,MAAM,MAAM,WAAW,GAAG;IACxB,EAAE,EAAE,MAAM,CAAC;IACX,WAAW,EAAE,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,KAAK,SAAS,CAAC;CAChE,CAAC;AAEF,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,GAAG,MAAM,CAG3C;AAED,wBAAgB,GAAG,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAE3D"}

package/dist/internals/bgfx/types.js

@@ -0,0 +1,14 @@
+/**
+ * Procedural cell backgrounds = GLSL color-field shaders.
+ *
+ * Product path: headless-gl (`renderFrame`) via shadertoy catalog / worker.
+ */
+export function clampByte(n) {
+    if (!Number.isFinite(n))
+        return 0;
+    return Math.max(0, Math.min(255, Math.round(n)));
+}
+export function mix(a, b, t) {
+    return a + (b - a) * t;
+}
+//# sourceMappingURL=types.js.map

package/dist/internals/bgfx/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/internals/bgfx/types.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AA0CH,MAAM,UAAU,SAAS,CAAC,CAAS;IACjC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;QAAE,OAAO,CAAC,CAAC;IAClC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;AACnD,CAAC;AAED,MAAM,UAAU,GAAG,CAAC,CAAS,EAAE,CAAS,EAAE,CAAS;IACjD,OAAO,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;AACzB,CAAC"}

package/dist/internals/bgfx-worker.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Worker: field GLSL → cell-resolution RGBA → SharedArrayBuffer.
+ * One sample per terminal cell (background only).
+ */
+export {};
+//# sourceMappingURL=bgfx-worker.d.ts.map

package/dist/internals/bgfx-worker.d.ts.map

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

package/dist/internals/bgfx-worker.js

@@ -0,0 +1,131 @@
+/**
+ * Worker: field GLSL → cell-resolution RGBA → SharedArrayBuffer.
+ * One sample per terminal cell (background only).
+ */
+import { parentPort } from "node:worker_threads";
+import invariant from "tiny-invariant";
+import { ENV_H, ENV_MW, ENV_MX, ENV_MY, ENV_MZ, ENV_POLARITY, ENV_T, ENV_W, HDR_FRONT, HDR_H, HDR_STATUS, HDR_W, STATUS_BOOT, STATUS_ERR, STATUS_OK, beginSlotWrite, endSlotWrite, openEnvViews, openPixelViews, slotOffset, } from "./bgfx/sab-layout.js";
+import { createShadertoyProgram, setGlModulePath } from "./bgfx/shadertoy-gl.js";
+invariant(parentPort, "shader-frame-worker must run as a worker_thread");
+const port = parentPort;
+let running = false;
+let pixel = null;
+let env = null;
+let program = null;
+let back = 1;
+let loopTimer = null;
+function fail(msg) {
+    if (pixel)
+        Atomics.store(pixel.hdr, HDR_STATUS, STATUS_ERR);
+    port.postMessage({ type: "error", message: msg });
+}
+function tick() {
+    if (!running || !pixel || !env || !program)
+        return;
+    const w = Atomics.load(env.i32, ENV_W);
+    const h = Atomics.load(env.i32, ENV_H);
+    if (w <= 0 || h <= 0) {
+        schedule();
+        return;
+    }
+    const sabW = Atomics.load(pixel.hdr, HDR_W);
+    const sabH = Atomics.load(pixel.hdr, HDR_H);
+    if (sabW !== w || sabH !== h) {
+        schedule();
+        return;
+    }
+    const t = env.f32[ENV_T];
+    const mouse = {
+        x: env.f32[ENV_MX],
+        y: env.f32[ENV_MY],
+        z: env.f32[ENV_MZ],
+        w: env.f32[ENV_MW],
+    };
+    const polarity = env.f32[ENV_POLARITY] < 0 ? "light" : "dark";
+    try {
+        const t0 = performance.now();
+        const frame = program.renderFrame(w, h, {
+            t,
+            resolution: { x: w, y: h },
+            mouse,
+            polarity,
+        });
+        const ms = performance.now() - t0;
+        const slot = back;
+        beginSlotWrite(pixel.hdr, slot);
+        const off = slotOffset(w, h, slot);
+        pixel.bytes.set(frame.rgba.subarray(0, w * h * 4), off);
+        endSlotWrite(pixel.hdr, slot, ms);
+        back = slot === 0 ? 1 : 0;
+    }
+    catch (error) {
+        fail(error instanceof Error ? error.message : String(error));
+        running = false;
+        return;
+    }
+    schedule();
+}
+function schedule() {
+    if (!running)
+        return;
+    loopTimer = setTimeout(tick, 0);
+}
+function bindSabs(pixelSab, envSab) {
+    pixel = openPixelViews(pixelSab);
+    env = openEnvViews(envSab);
+    Atomics.store(pixel.hdr, HDR_STATUS, STATUS_BOOT);
+    Atomics.store(pixel.hdr, HDR_FRONT, 0);
+    back = 1;
+}
+port.on("message", (msg) => {
+    if (msg.type === "stop") {
+        running = false;
+        if (loopTimer)
+            clearTimeout(loopTimer);
+        program?.[Symbol.dispose]();
+        program = null;
+        port.postMessage({ type: "stopped" });
+        return;
+    }
+    if (msg.type === "rebind") {
+        bindSabs(msg.pixelSab, msg.envSab);
+        const w = Atomics.load(env.i32, ENV_W);
+        const h = Atomics.load(env.i32, ENV_H);
+        if (w > 0 && h > 0) {
+            Atomics.store(pixel.hdr, HDR_W, w);
+            Atomics.store(pixel.hdr, HDR_H, h);
+        }
+        Atomics.store(pixel.hdr, HDR_STATUS, STATUS_OK);
+        port.postMessage({ type: "rebound" });
+        return;
+    }
+    if (msg.type === "setSource") {
+        try {
+            invariant(program, "setSource before init");
+            program.setSource(msg.source);
+            port.postMessage({ type: "sourceReady" });
+        }
+        catch (error) {
+            fail(error instanceof Error ? error.message : String(error));
+        }
+        return;
+    }
+    if (msg.type === "init") {
+        try {
+            if (msg.glPath)
+                setGlModulePath(msg.glPath);
+            bindSabs(msg.pixelSab, msg.envSab);
+            program?.[Symbol.dispose]();
+            program = createShadertoyProgram(msg.source);
+            program.ensureCompiled();
+            running = true;
+            Atomics.store(pixel.hdr, HDR_STATUS, STATUS_OK);
+            port.postMessage({ type: "ready" });
+            schedule();
+        }
+        catch (error) {
+            fail(error instanceof Error ? error.message : String(error));
+        }
+    }
+});
+//# sourceMappingURL=bgfx-worker.js.map

package/dist/internals/bgfx-worker.js.map

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

package/dist/layout/birth.d.ts

@@ -0,0 +1,77 @@
+/**
+ * Opacity wavefront — present-clock motion, same plane as spinner.
+ *
+ *   W  = left edge of “solid” (wavefront)
+ *   T  = newest-line ink mass (older peek lanes are age-dim only)
+ *
+ * Prominence is distance-from-W, never band-normalized:
+ *
+ *   p(x) = target · falloff^max(0, x − W)   (floored at birthFloor; 0 = ground)
+ *
+ * While T grows, chase A = T − tipWindow and record that catch-up speed as
+ * impulse. When T is frozen (or sealed), A = T and W coasts at the carried
+ * impulse — no gap ease-out, no settle ramp.
+ *
+ * Host steps W; paint samples it. Widget constructors do not bake per-char
+ * prominence or rebuild on the present tick.
+ */
+/** Per-column opacity multiplier past W (`target · falloff^distance`). */
+export declare const WAVEFRONT_FALLOFF = 0.8;
+export type BirthFrontierDefaults = {
+    /** Rest lag behind tip while ink is hot (cols). */
+    tipWindow: number;
+    /** Softest prominence far past the wavefront. 0 dissolves into terminal ground. */
+    birthFloor: number;
+    /**
+     * Per-column opacity multiplier past W (`target · falloff^distance`).
+     * Default 0.8 — gentler than φ⁻¹ without a progress-bar √ shape.
+     */
+    falloff: number;
+    /** AA width at the wavefront (cols). */
+    edgeWidth: number;
+    /** Base catch-up speed (cols/s) when gap≈0. */
+    baseColsPerSec: number;
+    /** Extra cols/s per column of gap (T−W). Hot path only. */
+    gapGain: number;
+    /** Cap speed (cols/s). */
+    maxColsPerSec: number;
+};
+export declare const BIRTH_FRONTIER_DEFAULTS: BirthFrontierDefaults;
+export type BirthFrontierState = {
+    /** Wavefront position W (stream columns). */
+    W: number;
+    /** Ink tip mass T. */
+    T: number;
+    lastStepMs: number | null;
+    sealed: boolean;
+    /** Last time T grew (ms). */
+    lastAdvanceMs: number | null;
+    /** Carried catch-up speed (cols/s). Endgame coasts at this. */
+    v: number;
+};
+export type BirthFrontierInput = {
+    T: number;
+    nowMs: number;
+    sealed?: boolean;
+};
+export type BirthFrontierOpts = Partial<BirthFrontierDefaults>;
+export declare function createBirthFrontier(init?: Partial<BirthFrontierState>): BirthFrontierState;
+export declare function birthFrontierLive(state: BirthFrontierState): boolean;
+/**
+ * Hot-path catch-up speed (cols/s): grows with gap behind tip.
+ * Endgame does not call this — it coasts at the carried impulse.
+ */
+export declare function wavefrontSpeed(gap: number, opts?: BirthFrontierOpts): number;
+/**
+ * Prominence at continuous stream position `pos`.
+ *
+ * Absolute distance from wavefront — **not** normalized by (T−W).
+ *
+ *   p = target · falloff^max(0, pos − W) , floored at birthFloor
+ *
+ * `T` only gates “fully solid when wavefront has sealed past ink”.
+ */
+export declare function wavefrontProminence(pos: number, W: number, T: number, targetP: number, opts?: BirthFrontierOpts): number;
+/** Step wavefront. Pure. */
+export declare function stepBirthFrontier(state: BirthFrontierState, input: BirthFrontierInput, opts?: BirthFrontierOpts): BirthFrontierState;
+//# sourceMappingURL=birth.d.ts.map

package/dist/layout/birth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"birth.d.ts","sourceRoot":"","sources":["../../src/layout/birth.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,0EAA0E;AAC1E,eAAO,MAAM,iBAAiB,MAAM,CAAC;AAErC,MAAM,MAAM,qBAAqB,GAAG;IAClC,mDAAmD;IACnD,SAAS,EAAE,MAAM,CAAC;IAClB,mFAAmF;IACnF,UAAU,EAAE,MAAM,CAAC;IACnB;;;OAGG;IACH,OAAO,EAAE,MAAM,CAAC;IAChB,wCAAwC;IACxC,SAAS,EAAE,MAAM,CAAC;IAClB,+CAA+C;IAC/C,cAAc,EAAE,MAAM,CAAC;IACvB,2DAA2D;IAC3D,OAAO,EAAE,MAAM,CAAC;IAChB,0BAA0B;IAC1B,aAAa,EAAE,MAAM,CAAC;CACvB,CAAC;AAEF,eAAO,MAAM,uBAAuB,EAAE,qBAQrC,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,6CAA6C;IAC7C,CAAC,EAAE,MAAM,CAAC;IACV,sBAAsB;IACtB,CAAC,EAAE,MAAM,CAAC;IACV,UAAU,EAAE,MAAM,GAAG,IAAI,CAAC;IAC1B,MAAM,EAAE,OAAO,CAAC;IAChB,6BAA6B;IAC7B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,+DAA+D;IAC/D,CAAC,EAAE,MAAM,CAAC;CACX,CAAC;AAEF,MAAM,MAAM,kBAAkB,GAAG;IAC/B,CAAC,EAAE,MAAM,CAAC;IACV,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,CAAC;AAEF,MAAM,MAAM,iBAAiB,GAAG,OAAO,CAAC,qBAAqB,CAAC,CAAC;AAE/D,wBAAgB,mBAAmB,CAAC,IAAI,CAAC,EAAE,OAAO,CAAC,kBAAkB,CAAC,GAAG,kBAAkB,CAY1F;AAED,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAGpE;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,iBAAsB,GAAG,MAAM,CAIhF;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,GAAG,EAAE,MAAM,EACX,CAAC,EAAE,MAAM,EACT,CAAC,EAAE,MAAM,EACT,OAAO,EAAE,MAAM,EACf,IAAI,GAAE,iBAAsB,GAC3B,MAAM,CAqBR;AAED,4BAA4B;AAC5B,wBAAgB,iBAAiB,CAC/B,KAAK,EAAE,kBAAkB,EACzB,KAAK,EAAE,kBAAkB,EACzB,IAAI,GAAE,iBAAsB,GAC3B,kBAAkB,CA8CpB"}