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

package/dist/internals/bgfx/shader-frame-host.js

@@ -0,0 +1,165 @@
+/**
+ * Main-thread host for off-thread field frames (bg only, 1 sample / cell).
+ */
+import { existsSync } from "node:fs";
+import { createRequire } from "node:module";
+import { Worker } from "node:worker_threads";
+import invariant from "tiny-invariant";
+import { getBgFxNullField } from "./opacity.js";
+import { HDR_FRAME_MS, HDR_GEN, HDR_H, HDR_STATUS, HDR_W, STATUS_OK, copyFrontFrame, envSabBytes, openEnvViews, openPixelViews, pixelSabBytes, writeEnv, } from "./sab-layout.js";
+import { resolveGlModulePath } from "./shadertoy-gl.js";
+function allocPixelSab(w, h) {
+    return new SharedArrayBuffer(pixelSabBytes(w, h));
+}
+function allocEnvSab() {
+    return new SharedArrayBuffer(envSabBytes());
+}
+/**
+ * Worker entry is the package export (`dist/…`), not a sibling of this
+ * file. `import.meta.url` + `../bgfx-worker.js` follows the executing
+ * module — tsx/storybook load `src/` and miss the built worker.
+ */
+const BGFX_WORKER_ID = "@inhuman.tools/quickdraw/internals/bgfx-worker";
+export function resolveBgfxWorkerPath() {
+    try {
+        return createRequire(import.meta.url).resolve(BGFX_WORKER_ID);
+    }
+    catch {
+        invariant(false, `bgfx-worker missing (${BGFX_WORKER_ID}) — run @inhuman.tools/quickdraw build`);
+    }
+}
+export async function createShaderFrameHost(opts) {
+    let w = Math.max(1, opts.width ?? 80);
+    let h = Math.max(1, opts.height ?? 24);
+    let pixelSab = allocPixelSab(w, h);
+    const envSab = allocEnvSab();
+    let pixel = openPixelViews(pixelSab);
+    const envv = openEnvViews(envSab);
+    Atomics.store(pixel.hdr, HDR_W, w);
+    Atomics.store(pixel.hdr, HDR_H, h);
+    Atomics.store(pixel.hdr, HDR_STATUS, 0);
+    writeEnv(envv, { t: 0, w, h });
+    const workerPath = resolveBgfxWorkerPath();
+    invariant(existsSync(workerPath), `bgfx-worker missing at ${workerPath} — run @inhuman.tools/quickdraw build`);
+    const glPath = resolveGlModulePath();
+    invariant(glPath, "cannot resolve headless-gl module path for worker");
+    const worker = new Worker(workerPath);
+    const ready = new Promise((resolve, reject) => {
+        const onMsg = (msg) => {
+            if (msg.type === "ready") {
+                worker.off("message", onMsg);
+                resolve();
+            }
+            else if (msg.type === "error") {
+                worker.off("message", onMsg);
+                reject(new Error(msg.message ?? "shader worker error"));
+            }
+        };
+        worker.on("message", onMsg);
+        worker.on("error", (err) => {
+            worker.off("message", onMsg);
+            reject(err);
+        });
+    });
+    worker.postMessage({
+        type: "init",
+        source: opts.source,
+        pixelSab,
+        envSab,
+        glPath,
+    });
+    await ready;
+    const scratch = new Map();
+    function ensureSize(nw, nh) {
+        nw = Math.max(1, nw | 0);
+        nh = Math.max(1, nh | 0);
+        if (nw === w && nh === h)
+            return;
+        w = nw;
+        h = nh;
+        pixelSab = allocPixelSab(w, h);
+        pixel = openPixelViews(pixelSab);
+        Atomics.store(pixel.hdr, HDR_W, w);
+        Atomics.store(pixel.hdr, HDR_H, h);
+        worker.postMessage({ type: "rebind", pixelSab, envSab });
+    }
+    return {
+        pushEnv(nw, nh, e) {
+            ensureSize(nw, nh);
+            writeEnv(envv, {
+                t: e.t,
+                w: nw,
+                h: nh,
+                mouse: e.mouse,
+                polarity: e.polarity,
+            });
+        },
+        switchSource(source) {
+            return new Promise((resolve, reject) => {
+                const onMsg = (msg) => {
+                    if (msg.type === "sourceReady") {
+                        worker.off("message", onMsg);
+                        resolve();
+                    }
+                    else if (msg.type === "error") {
+                        worker.off("message", onMsg);
+                        reject(new Error(msg.message ?? "setSource failed"));
+                    }
+                };
+                worker.on("message", onMsg);
+                worker.on("error", (err) => {
+                    worker.off("message", onMsg);
+                    reject(err);
+                });
+                worker.postMessage({ type: "setSource", source });
+            });
+        },
+        readFrame(nw, nh) {
+            nw = Math.max(1, nw | 0);
+            nh = Math.max(1, nh | 0);
+            ensureSize(nw, nh);
+            const key = `${nw}x${nh}`;
+            let out = scratch.get(key);
+            const need = nw * nh * 4;
+            if (!out || out.length !== need) {
+                out = new Uint8Array(need);
+                scratch.set(key, out);
+            }
+            // M1: gate on STATUS — between SAB rebind (ensureSize) and the worker's
+            // first paint, copyFrontFrame can return true over uninitialized zero
+            // bytes. Treat !ready() the same as a failed copy: fill the sentinel so
+            // we never hand back a zero/black frame masquerading as valid shader output.
+            const statusOk = Atomics.load(pixel.hdr, HDR_STATUS) === STATUS_OK;
+            const ok = statusOk && copyFrontFrame(pixel, out, nw, nh);
+            if (!ok) {
+                const { r, g, b } = getBgFxNullField();
+                for (let i = 0; i < need; i += 4) {
+                    out[i] = r;
+                    out[i + 1] = g;
+                    out[i + 2] = b;
+                    out[i + 3] = 255;
+                }
+            }
+            return { width: nw, height: nh, rgba: out };
+        },
+        lastFrameMs() {
+            return Atomics.load(pixel.hdr, HDR_FRAME_MS);
+        },
+        gen() {
+            return Atomics.load(pixel.hdr, HDR_GEN);
+        },
+        ready() {
+            return Atomics.load(pixel.hdr, HDR_STATUS) === STATUS_OK;
+        },
+        [Symbol.dispose]() {
+            try {
+                worker.postMessage({ type: "stop" });
+            }
+            catch {
+                /* ignore */
+            }
+            void worker.terminate();
+        },
+    };
+}
+//# sourceMappingURL=shader-frame-host.js.map

package/dist/internals/bgfx/shader-frame-host.js.map

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

package/dist/internals/bgfx/shadertoy-catalog.d.ts

@@ -0,0 +1,41 @@
+/**
+ * GLSL (Shadertoy-shaped) bgFx catalog.
+ * Shared worker host by default; re-register to switch source.
+ * Product backgrounds are **shaders only** — no CPU stock dual-world.
+ */
+export type ShadertoyEntry = {
+    id: string;
+    file: string;
+};
+/** Product pool — all GLSL under quickdraw root. */
+export declare const DEFAULT_SHADERTOY_CATALOG: readonly ShadertoyEntry[];
+/**
+ * Resolve the quickdraw workspace root (where `*.vert` assets live).
+ *
+ * Walks up from this module looking for known shader files or the workspace
+ * package.json — does not hard-code nesting depth (B6: dist/ vs src/ hops).
+ */
+export declare function quickdrawRoot(): string;
+/** Prefer worker unless `worker: false` or `QD_BGFX_SYNC=1`. */
+export declare function preferShaderWorker(env?: NodeJS.ProcessEnv): boolean;
+/**
+ * Register GLSL files as bgFx programs (renderFrame only).
+ * Shared worker by default.
+ */
+export declare function registerShadertoyCatalog(opts?: {
+    root?: string;
+    entries?: ShadertoyEntry[];
+    worker?: boolean;
+    width?: number;
+    height?: number;
+}): Promise<{
+    ids: string[];
+    mode: "worker" | "sync";
+}>;
+export declare function unregisterShadertoyCatalog(): void;
+/**
+ * Worker hosts one GLSL source. Point it at `id` (no-op if already there).
+ * Resolves true when the source actually changed — caller may requestPaint.
+ */
+export declare function activateShadertoy(id: string): Promise<boolean>;
+//# sourceMappingURL=shadertoy-catalog.d.ts.map

package/dist/internals/bgfx/shadertoy-catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shadertoy-catalog.d.ts","sourceRoot":"","sources":["../../../src/internals/bgfx/shadertoy-catalog.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAaH,MAAM,MAAM,cAAc,GAAG;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;CACd,CAAC;AAEF,oDAAoD;AACpD,eAAO,MAAM,yBAAyB,EAAE,SAAS,cAAc,EAIrD,CAAC;AAEX;;;;;GAKG;AACH,wBAAgB,aAAa,IAAI,MAAM,CAqBtC;AA2ED,gEAAgE;AAChE,wBAAgB,kBAAkB,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAEhF;AAED;;;GAGG;AACH,wBAAsB,wBAAwB,CAAC,IAAI,CAAC,EAAE;IACpD,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,cAAc,EAAE,CAAC;IAC3B,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC;IAAE,GAAG,EAAE,MAAM,EAAE,CAAC;IAAC,IAAI,EAAE,QAAQ,GAAG,MAAM,CAAA;CAAE,CAAC,CA2DtD;AAED,wBAAgB,0BAA0B,IAAI,IAAI,CAEjD;AAED;;;GAGG;AACH,wBAAsB,iBAAiB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CASpE"}

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

@@ -0,0 +1,200 @@
+/**
+ * GLSL (Shadertoy-shaped) bgFx catalog.
+ * Shared worker host by default; re-register to switch source.
+ * Product backgrounds are **shaders only** — no CPU stock dual-world.
+ */
+import { existsSync, readFileSync } from "node:fs";
+import { dirname, join, resolve } from "node:path";
+import { fileURLToPath } from "node:url";
+import invariant from "tiny-invariant";
+import { getBgFxNullField } from "./opacity.js";
+import { registerBgFxShader, unregisterBgFxShader } from "./registry.js";
+import { createShaderFrameHost } from "./shader-frame-host.js";
+import { createShadertoyProgram, shadertoyGlAvailable } from "./shadertoy-gl.js";
+/** Product pool — all GLSL under quickdraw root. */
+export const DEFAULT_SHADERTOY_CATALOG = [
+    { id: "gradient", file: "gradient.vert" },
+    { id: "aurora", file: "aurora.vert" },
+    { id: "doom", file: "doom.vert" },
+];
+/**
+ * Resolve the quickdraw workspace root (where `*.vert` assets live).
+ *
+ * Walks up from this module looking for known shader files or the workspace
+ * package.json — does not hard-code nesting depth (B6: dist/ vs src/ hops).
+ */
+export function quickdrawRoot() {
+    let dir = dirname(fileURLToPath(import.meta.url));
+    for (let i = 0; i < 10; i++) {
+        if (existsSync(join(dir, "gradient.vert")) || existsSync(join(dir, "aurora.vert"))) {
+            return dir;
+        }
+        const pj = join(dir, "package.json");
+        if (existsSync(pj)) {
+            try {
+                const name = JSON.parse(readFileSync(pj, "utf8")).name;
+                if (name === "@inhuman.tools/quickdraw")
+                    return dir;
+            }
+            catch {
+                /* keep walking */
+            }
+        }
+        const parent = dirname(dir);
+        if (parent === dir)
+            break;
+        dir = parent;
+    }
+    // Last resort: historical packages/bgfx/{src,dist} → quickdraw/
+    return resolve(dirname(fileURLToPath(import.meta.url)), "../../..");
+}
+let entries = new Map();
+let activeId = null;
+let workerHost = null;
+const syncHosts = new Map();
+let mode = null;
+function loadFile(root, file) {
+    const p = resolve(root, file);
+    invariant(existsSync(p), `shader not found: ${p}`);
+    return readFileSync(p, "utf8");
+}
+function disposeAll() {
+    workerHost?.[Symbol.dispose]();
+    workerHost = null;
+    for (const h of syncHosts.values())
+        h[Symbol.dispose]();
+    syncHosts.clear();
+    for (const id of entries.keys())
+        unregisterBgFxShader(id);
+    entries = new Map();
+    activeId = null;
+    mode = null;
+}
+/** BGFX_NULL_FIELD fill — inactive/unregistered id, not literal black. */
+let nullCached = null;
+function nullFrame(w, h) {
+    const ww = Math.max(1, w);
+    const hh = Math.max(1, h);
+    const { r, g, b } = getBgFxNullField();
+    if (nullCached &&
+        nullCached.w === ww &&
+        nullCached.h === hh &&
+        nullCached.r === r &&
+        nullCached.g === g &&
+        nullCached.b === b) {
+        return { width: ww, height: hh, rgba: nullCached.rgba };
+    }
+    const rgba = new Uint8Array(ww * hh * 4);
+    for (let i = 0; i < rgba.length; i += 4) {
+        rgba[i] = r;
+        rgba[i + 1] = g;
+        rgba[i + 2] = b;
+        rgba[i + 3] = 255;
+    }
+    nullCached = { w: ww, h: hh, r, g, b, rgba };
+    return { width: ww, height: hh, rgba };
+}
+function registerOne(e) {
+    registerBgFxShader({
+        id: e.id,
+        renderFrame: (w, h, env) => {
+            if (mode === "worker" && workerHost) {
+                if (activeId !== e.id)
+                    return nullFrame(w, h);
+                workerHost.pushEnv(w, h, env);
+                return workerHost.readFrame(w, h);
+            }
+            const host = syncHosts.get(e.id);
+            if (!host)
+                return nullFrame(w, h);
+            return host.renderFrame(w, h, env);
+        },
+    });
+}
+/** Prefer worker unless `worker: false` or `QD_BGFX_SYNC=1`. */
+export function preferShaderWorker(env = process.env) {
+    return env.QD_BGFX_SYNC !== "1";
+}
+/**
+ * Register GLSL files as bgFx programs (renderFrame only).
+ * Shared worker by default.
+ */
+export async function registerShadertoyCatalog(opts) {
+    if (!shadertoyGlAvailable()) {
+        return { ids: [], mode: "sync" };
+    }
+    const root = opts?.root ?? quickdrawRoot();
+    const list = opts?.entries ?? [...DEFAULT_SHADERTOY_CATALOG];
+    const wantWorker = opts?.worker !== false && preferShaderWorker();
+    disposeAll();
+    for (const e of list) {
+        try {
+            const source = loadFile(root, e.file);
+            entries.set(e.id, {
+                id: e.id,
+                file: e.file,
+                source,
+            });
+        }
+        catch (error) {
+            console.error(`[bgfx] skip ${e.id}:`, error instanceof Error ? error.message : error);
+        }
+    }
+    if (entries.size === 0)
+        return { ids: [], mode: "sync" };
+    const first = [...entries.values()][0];
+    if (wantWorker) {
+        try {
+            workerHost = await createShaderFrameHost({
+                source: first.source,
+                width: opts?.width ?? 80,
+                height: opts?.height ?? 24,
+            });
+            mode = "worker";
+            activeId = first.id;
+            for (const e of entries.values())
+                registerOne(e);
+            return { ids: [...entries.keys()], mode: "worker" };
+        }
+        catch (error) {
+            console.error("[bgfx] catalog worker failed, sync per-shader:", error instanceof Error ? error.message : error);
+            workerHost = null;
+        }
+    }
+    mode = "sync";
+    try {
+        for (const e of entries.values()) {
+            const host = createShadertoyProgram(e.source);
+            host.ensureCompiled();
+            syncHosts.set(e.id, host);
+            registerOne(e);
+        }
+    }
+    catch (error) {
+        console.error("[bgfx] catalog sync compile failed:", error instanceof Error ? error.message : error);
+        disposeAll();
+        return { ids: [], mode: "sync" };
+    }
+    activeId = first.id;
+    return { ids: [...entries.keys()], mode: "sync" };
+}
+export function unregisterShadertoyCatalog() {
+    disposeAll();
+}
+/**
+ * Worker hosts one GLSL source. Point it at `id` (no-op if already there).
+ * Resolves true when the source actually changed — caller may requestPaint.
+ */
+export async function activateShadertoy(id) {
+    const entry = entries.get(id);
+    if (!entry)
+        return false;
+    if (activeId === id)
+        return false;
+    activeId = id;
+    if (mode === "worker" && workerHost) {
+        await workerHost.switchSource(entry.source);
+    }
+    return true;
+}
+//# sourceMappingURL=shadertoy-catalog.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"shadertoy-catalog.js","sourceRoot":"","sources":["../../../src/internals/bgfx/shadertoy-catalog.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AACnD,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC,OAAO,SAAS,MAAM,gBAAgB,CAAC;AAEvC,OAAO,EAAE,gBAAgB,EAAE,MAAM,cAAc,CAAC;AAChD,OAAO,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,MAAM,eAAe,CAAC;AACzE,OAAO,EAAE,qBAAqB,EAAwB,MAAM,wBAAwB,CAAC;AACrF,OAAO,EAAE,sBAAsB,EAAE,oBAAoB,EAAyB,MAAM,mBAAmB,CAAC;AAOxG,oDAAoD;AACpD,MAAM,CAAC,MAAM,yBAAyB,GAA8B;IAClE,EAAE,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,eAAe,EAAE;IACzC,EAAE,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,aAAa,EAAE;IACrC,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,EAAE;CACzB,CAAC;AAEX;;;;;GAKG;AACH,MAAM,UAAU,aAAa;IAC3B,IAAI,GAAG,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC;IAClD,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,EAAE,EAAE,CAAC;QAC5B,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,EAAE,aAAa,CAAC,CAAC,EAAE,CAAC;YACnF,OAAO,GAAG,CAAC;QACb,CAAC;QACD,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,CAAC;QACrC,IAAI,UAAU,CAAC,EAAE,CAAC,EAAE,CAAC;YACnB,IAAI,CAAC;gBACH,MAAM,IAAI,GAAI,IAAI,CAAC,KAAK,CAAC,YAAY,CAAC,EAAE,EAAE,MAAM,CAAC,CAAuB,CAAC,IAAI,CAAC;gBAC9E,IAAI,IAAI,KAAK,0BAA0B;oBAAE,OAAO,GAAG,CAAC;YACtD,CAAC;YAAC,MAAM,CAAC;gBACP,kBAAkB;YACpB,CAAC;QACH,CAAC;QACD,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC;QAC5B,IAAI,MAAM,KAAK,GAAG;YAAE,MAAM;QAC1B,GAAG,GAAG,MAAM,CAAC;IACf,CAAC;IACD,gEAAgE;IAChE,OAAO,OAAO,CAAC,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC;AACtE,CAAC;AAQD,IAAI,OAAO,GAAG,IAAI,GAAG,EAAsB,CAAC;AAC5C,IAAI,QAAQ,GAAkB,IAAI,CAAC;AACnC,IAAI,UAAU,GAA2B,IAAI,CAAC;AAC9C,MAAM,SAAS,GAAG,IAAI,GAAG,EAA4B,CAAC;AACtD,IAAI,IAAI,GAA6B,IAAI,CAAC;AAE1C,SAAS,QAAQ,CAAC,IAAY,EAAE,IAAY;IAC1C,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;IAC9B,SAAS,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,qBAAqB,CAAC,EAAE,CAAC,CAAC;IACnD,OAAO,YAAY,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;AACjC,CAAC;AAED,SAAS,UAAU;IACjB,UAAU,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;IAC/B,UAAU,GAAG,IAAI,CAAC;IAClB,KAAK,MAAM,CAAC,IAAI,SAAS,CAAC,MAAM,EAAE;QAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,EAAE,CAAC;IACxD,SAAS,CAAC,KAAK,EAAE,CAAC;IAClB,KAAK,MAAM,EAAE,IAAI,OAAO,CAAC,IAAI,EAAE;QAAE,oBAAoB,CAAC,EAAE,CAAC,CAAC;IAC1D,OAAO,GAAG,IAAI,GAAG,EAAE,CAAC;IACpB,QAAQ,GAAG,IAAI,CAAC;IAChB,IAAI,GAAG,IAAI,CAAC;AACd,CAAC;AAED,0EAA0E;AAC1E,IAAI,UAAU,GAAuF,IAAI,CAAC;AAE1G,SAAS,SAAS,CAAC,CAAS,EAAE,CAAS;IACrC,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC1B,MAAM,EAAE,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC1B,MAAM,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,GAAG,gBAAgB,EAAE,CAAC;IACvC,IACE,UAAU;QACV,UAAU,CAAC,CAAC,KAAK,EAAE;QACnB,UAAU,CAAC,CAAC,KAAK,EAAE;QACnB,UAAU,CAAC,CAAC,KAAK,CAAC;QAClB,UAAU,CAAC,CAAC,KAAK,CAAC;QAClB,UAAU,CAAC,CAAC,KAAK,CAAC,EAClB,CAAC;QACD,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,UAAU,CAAC,IAAI,EAAE,CAAC;IAC1D,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,UAAU,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC;IACzC,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC;QACxC,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;QACZ,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;QAChB,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC;QAChB,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC;IACpB,CAAC;IACD,UAAU,GAAG,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,IAAI,EAAE,CAAC;IAC7C,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;AACzC,CAAC;AAED,SAAS,WAAW,CAAC,CAAa;IAChC,kBAAkB,CAAC;QACjB,EAAE,EAAE,CAAC,CAAC,EAAE;QACR,WAAW,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,EAAE,EAAE;YACzB,IAAI,IAAI,KAAK,QAAQ,IAAI,UAAU,EAAE,CAAC;gBACpC,IAAI,QAAQ,KAAK,CAAC,CAAC,EAAE;oBAAE,OAAO,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;gBAC9C,UAAU,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;gBAC9B,OAAO,UAAU,CAAC,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YACpC,CAAC;YACD,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;YACjC,IAAI,CAAC,IAAI;gBAAE,OAAO,SAAS,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;YAClC,OAAO,IAAI,CAAC,WAAW,CAAC,CAAC,EAAE,CAAC,EAAE,GAAG,CAAC,CAAC;QACrC,CAAC;KACF,CAAC,CAAC;AACL,CAAC;AAED,gEAAgE;AAChE,MAAM,UAAU,kBAAkB,CAAC,MAAyB,OAAO,CAAC,GAAG;IACrE,OAAO,GAAG,CAAC,YAAY,KAAK,GAAG,CAAC;AAClC,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,wBAAwB,CAAC,IAM9C;IACC,IAAI,CAAC,oBAAoB,EAAE,EAAE,CAAC;QAC5B,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IACnC,CAAC;IAED,MAAM,IAAI,GAAG,IAAI,EAAE,IAAI,IAAI,aAAa,EAAE,CAAC;IAC3C,MAAM,IAAI,GAAG,IAAI,EAAE,OAAO,IAAI,CAAC,GAAG,yBAAyB,CAAC,CAAC;IAC7D,MAAM,UAAU,GAAG,IAAI,EAAE,MAAM,KAAK,KAAK,IAAI,kBAAkB,EAAE,CAAC;IAElE,UAAU,EAAE,CAAC;IAEb,KAAK,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC;QACrB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC;YACtC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE;gBAChB,EAAE,EAAE,CAAC,CAAC,EAAE;gBACR,IAAI,EAAE,CAAC,CAAC,IAAI;gBACZ,MAAM;aACP,CAAC,CAAC;QACL,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QACxF,CAAC;IACH,CAAC;IAED,IAAI,OAAO,CAAC,IAAI,KAAK,CAAC;QAAE,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IACzD,MAAM,KAAK,GAAG,CAAC,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,CAAE,CAAC;IAExC,IAAI,UAAU,EAAE,CAAC;QACf,IAAI,CAAC;YACH,UAAU,GAAG,MAAM,qBAAqB,CAAC;gBACvC,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,KAAK,EAAE,IAAI,EAAE,KAAK,IAAI,EAAE;gBACxB,MAAM,EAAE,IAAI,EAAE,MAAM,IAAI,EAAE;aAC3B,CAAC,CAAC;YACH,IAAI,GAAG,QAAQ,CAAC;YAChB,QAAQ,GAAG,KAAK,CAAC,EAAE,CAAC;YACpB,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,MAAM,EAAE;gBAAE,WAAW,CAAC,CAAC,CAAC,CAAC;YACjD,OAAO,EAAE,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC;QACtD,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,gDAAgD,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;YAChH,UAAU,GAAG,IAAI,CAAC;QACpB,CAAC;IACH,CAAC;IAED,IAAI,GAAG,MAAM,CAAC;IACd,IAAI,CAAC;QACH,KAAK,MAAM,CAAC,IAAI,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC;YACjC,MAAM,IAAI,GAAG,sBAAsB,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;YAC9C,IAAI,CAAC,cAAc,EAAE,CAAC;YACtB,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;YAC1B,WAAW,CAAC,CAAC,CAAC,CAAC;QACjB,CAAC;IACH,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,qCAAqC,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;QACrG,UAAU,EAAE,CAAC;QACb,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;IACnC,CAAC;IACD,QAAQ,GAAG,KAAK,CAAC,EAAE,CAAC;IACpB,OAAO,EAAE,GAAG,EAAE,CAAC,GAAG,OAAO,CAAC,IAAI,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;AACpD,CAAC;AAED,MAAM,UAAU,0BAA0B;IACxC,UAAU,EAAE,CAAC;AACf,CAAC;AAED;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,EAAU;IAChD,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC9B,IAAI,CAAC,KAAK;QAAE,OAAO,KAAK,CAAC;IACzB,IAAI,QAAQ,KAAK,EAAE;QAAE,OAAO,KAAK,CAAC;IAClC,QAAQ,GAAG,EAAE,CAAC;IACd,IAAI,IAAI,KAAK,QAAQ,IAAI,UAAU,EAAE,CAAC;QACpC,MAAM,UAAU,CAAC,YAAY,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC9C,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/internals/bgfx/shadertoy-gl.d.ts

@@ -0,0 +1,38 @@
+/**
+ * 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 type { BgFxEnv } from "./types.js";
+export type ShadertoyFrame = {
+    width: number;
+    height: number;
+    /** RGBA row-major, top-left origin (y flipped from GL). */
+    rgba: Uint8Array;
+};
+export declare function setGlModulePath(absPath: string | null): void;
+/**
+ * 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 declare function resolveGlModulePath(): string | null;
+export declare function shadertoyGlAvailable(): boolean;
+/** WebGL1-friendly preprocessing for Shadertoy sources. */
+export declare function preprocessShadertoySource(source: string): string;
+export type ShadertoyProgram = {
+    /** Compile GLSL (throws on compile/link error). */
+    ensureCompiled(): void;
+    /** Hot-swap fragment source (recompile). */
+    setSource(source: string): void;
+    /** Render one frame; returns top-left origin RGBA. */
+    renderFrame(w: number, h: number, env: BgFxEnv): ShadertoyFrame;
+    [Symbol.dispose](): void;
+};
+/**
+ * Create a reusable Shadertoy host for one GLSL source (mainImage entry).
+ * Context is recreated when size changes.
+ */
+export declare function createShadertoyProgram(glslSource: string): ShadertoyProgram;
+//# sourceMappingURL=shadertoy-gl.d.ts.map

package/dist/internals/bgfx/shadertoy-gl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shadertoy-gl.d.ts","sourceRoot":"","sources":["../../../src/internals/bgfx/shadertoy-gl.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAQH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,YAAY,CAAC;AAE1C,MAAM,MAAM,cAAc,GAAG;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,2DAA2D;IAC3D,IAAI,EAAE,UAAU,CAAC;CAClB,CAAC;AAkFF,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,GAAG,IAAI,CAG5D;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,IAAI,MAAM,GAAG,IAAI,CAgBnD;AAiCD,wBAAgB,oBAAoB,IAAI,OAAO,CAG9C;AASD,2DAA2D;AAC3D,wBAAgB,yBAAyB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAkBhE;AAkCD,MAAM,MAAM,gBAAgB,GAAG;IAC7B,mDAAmD;IACnD,cAAc,IAAI,IAAI,CAAC;IACvB,4CAA4C;IAC5C,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,sDAAsD;IACtD,WAAW,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,cAAc,CAAC;IAChE,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC;CAC1B,CAAC;AAEF;;;GAGG;AACH,wBAAgB,sBAAsB,CAAC,UAAU,EAAE,MAAM,GAAG,gBAAgB,CAyJ3E"}