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

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/internals/bgfx/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,cAAc,CAAC"}

package/dist/internals/bgfx/index.js

@@ -0,0 +1,17 @@
+/**
+ * Procedural cell backgrounds = GLSL color-field shaders.
+ *
+ * Optional present-path canary (headroom under wash), not product chrome.
+ * TEA/layout writes style.bgFx = program id (+ baked UV).
+ * Present materialize* → bgRgb only.
+ *
+ * Catalog: registerShadertoyCatalog / loadShadertoyFile / activateShadertoy.
+ */
+export * from "./types.js";
+export * from "./registry.js";
+export * from "./materialize.js";
+export * from "./shadertoy-gl.js";
+export * from "./shadertoy-catalog.js";
+export * from "./shader-frame-host.js";
+export * from "./opacity.js";
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/internals/bgfx/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,cAAc,YAAY,CAAC;AAC3B,cAAc,eAAe,CAAC;AAC9B,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC;AAClC,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,cAAc,CAAC"}

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

@@ -0,0 +1,31 @@
+/**
+ * Present-time expansion of bgFx markers → bgRgb only.
+ *
+ * Cells store a shader id; present shades the field and writes truecolor
+ * backgrounds. No glyph / sub-cell packing — terminals that can't paint
+ * dense block+fg/bg at 30fps stay out of scope.
+ */
+import type { BgFxEnv, BgFxId } from "./types.js";
+import type { Rgb } from "../../lexicon/index.js";
+export type BgFxCell = {
+    ch: string;
+    style: {
+        bgFx?: BgFxId;
+        bgFxU?: number;
+        bgFxV?: number;
+        /** Multiplies global opacity (0–1). */
+        bgFxOpacity?: number;
+        bgRgb?: Rgb;
+        bg?: number;
+        [k: string]: unknown;
+    };
+    placeholder?: boolean;
+};
+export type BgFxBuffer = {
+    width: number;
+    height: number;
+    cells: BgFxCell[];
+};
+export declare function bufferHasBgFx(buf: BgFxBuffer): boolean;
+export declare function materializeBgFx(buf: BgFxBuffer, envOrT: number | BgFxEnv): number;
+//# sourceMappingURL=materialize.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"materialize.d.ts","sourceRoot":"","sources":["../../../src/internals/bgfx/materialize.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,YAAY,CAAC;AAClD,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,wBAAwB,CAAC;AAElD,MAAM,MAAM,QAAQ,GAAG;IACrB,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE;QACL,IAAI,CAAC,EAAE,MAAM,CAAC;QACd,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,KAAK,CAAC,EAAE,MAAM,CAAC;QACf,uCAAuC;QACvC,WAAW,CAAC,EAAE,MAAM,CAAC;QACrB,KAAK,CAAC,EAAE,GAAG,CAAC;QACZ,EAAE,CAAC,EAAE,MAAM,CAAC;QACZ,CAAC,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;KACtB,CAAC;IACF,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,CAAC;AAEF,MAAM,MAAM,UAAU,GAAG;IACvB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,QAAQ,EAAE,CAAC;CACnB,CAAC;AAEF,wBAAgB,aAAa,CAAC,GAAG,EAAE,UAAU,GAAG,OAAO,CAKtD;AAyGD,wBAAgB,eAAe,CAAC,GAAG,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,GAAG,MAAM,CAKjF"}

package/dist/internals/bgfx/materialize.js

@@ -0,0 +1,117 @@
+/**
+ * Present-time expansion of bgFx markers → bgRgb only.
+ *
+ * Cells store a shader id; present shades the field and writes truecolor
+ * backgrounds. No glyph / sub-cell packing — terminals that can't paint
+ * dense block+fg/bg at 30fps stay out of scope.
+ */
+import { blendBgFx, getBgFxNullField } from "./opacity.js";
+import { getBgFxShader } from "./registry.js";
+export function bufferHasBgFx(buf) {
+    for (let i = 0; i < buf.cells.length; i++) {
+        if (buf.cells[i].style.bgFx)
+            return true;
+    }
+    return false;
+}
+function normalizeEnv(buf, envOrT) {
+    if (typeof envOrT === "number") {
+        return {
+            t: envOrT,
+            resolution: { x: buf.width, y: buf.height },
+        };
+    }
+    return {
+        t: envOrT.t,
+        resolution: envOrT.resolution ?? { x: buf.width, y: buf.height },
+        mouse: envOrT.mouse,
+        polarity: envOrT.polarity,
+    };
+}
+function collectCells(buf) {
+    const { width: w, height: h, cells } = buf;
+    const out = [];
+    for (let y = 0; y < h; y++) {
+        const row = y * w;
+        for (let x = 0; x < w; x++) {
+            const i = row + x;
+            const id = cells[i].style.bgFx;
+            if (!id)
+                continue;
+            out.push({ i, x, y, id });
+        }
+    }
+    return out;
+}
+function applyRgb(buf, i, field) {
+    const cell = buf.cells[i];
+    const per = typeof cell.style.bgFxOpacity === "number" ? cell.style.bgFxOpacity : undefined;
+    // Toward terminal ground (setBgFxGround / OSC 11), not pure black
+    cell.style.bgRgb = blendBgFx(field, { opacity: per });
+    if (cell.style.bg !== undefined)
+        delete cell.style.bg;
+}
+function materializeCollected(buf, cells, env) {
+    if (cells.length === 0)
+        return 0;
+    const byId = new Map();
+    for (const c of cells) {
+        let list = byId.get(c.id);
+        if (!list) {
+            list = [];
+            byId.set(c.id, list);
+        }
+        list.push(c);
+    }
+    let n = 0;
+    const nullField = getBgFxNullField();
+    for (const [id, refs] of byId) {
+        const prog = getBgFxShader(id);
+        if (!prog?.renderFrame) {
+            for (const r of refs) {
+                applyRgb(buf, r.i, nullField);
+                n += 1;
+            }
+            continue;
+        }
+        let minX = Infinity, minY = Infinity, maxX = -Infinity, maxY = -Infinity;
+        for (const r of refs) {
+            if (r.x < minX)
+                minX = r.x;
+            if (r.y < minY)
+                minY = r.y;
+            if (r.x > maxX)
+                maxX = r.x;
+            if (r.y > maxY)
+                maxY = r.y;
+        }
+        const cellsW = maxX - minX + 1;
+        const cellsH = maxY - minY + 1;
+        const frameEnv = {
+            ...env,
+            resolution: { x: cellsW, y: cellsH },
+        };
+        const frame = prog.renderFrame(cellsW, cellsH, frameEnv);
+        for (const r of refs) {
+            const px = Math.min(frame.width - 1, Math.max(0, r.x - minX));
+            const py = Math.min(frame.height - 1, Math.max(0, r.y - minY));
+            const o = (py * frame.width + px) * 4;
+            applyRgb(buf, r.i, {
+                r: frame.rgba[o],
+                g: frame.rgba[o + 1],
+                b: frame.rgba[o + 2],
+            });
+            n += 1;
+        }
+    }
+    return n;
+}
+export function materializeBgFx(buf, envOrT) {
+    if (buf.width <= 0 || buf.height <= 0)
+        return 0;
+    const cells = collectCells(buf);
+    if (cells.length === 0)
+        return 0;
+    return materializeCollected(buf, cells, normalizeEnv(buf, envOrT));
+}
+//# sourceMappingURL=materialize.js.map

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

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

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

@@ -0,0 +1,37 @@
+/**
+ * Global opacity for procedural backgrounds (quiet wash).
+ *
+ * Transparency means mix toward the **terminal ground color** (OSC 11),
+ * not toward pure black — so light terminals and tinted themes stay coherent.
+ *
+ *   out = mix(ground, field, opacity)
+ *   0 → ground · 1 → full field
+ */
+import { type Rgb } from "../../lexicon/index.js";
+/**
+ * Fallback only when OSC 11 was never set — not "the" ground.
+ * Hosts should call `setBgFxGround` from probeOsc11 / theme.
+ */
+export declare const BGFX_DEFAULT_GROUND: Rgb;
+export declare function setBgFxOpacity(o: number): void;
+export declare function getBgFxOpacity(): number;
+/** Terminal background (0–255 sRGB), typically from OSC 11. */
+export declare function setBgFxGround(rgb: Rgb): void;
+/**
+ * The `BGFX_NULL_FIELD` sentinel (color-hygiene plan, enabler 10) — the
+ * single "nothing here" color for all bgFx no-field paths, replacing five
+ * independent near-black literals. Ground-derived + `NULL_FIELD_DELTA`, so it
+ * is a function (not a frozen constant): it must track `setBgFxGround` calls
+ * rather than assume a dark terminal.
+ */
+export declare function getBgFxNullField(): Rgb;
+/**
+ * Blend field sample toward terminal ground.
+ * Per-cell `opacity` multiplies global opacity.
+ * Explicit `ground` overrides the OSC11-attuned default for this call only.
+ */
+export declare function blendBgFx(field: Rgb, opts?: {
+    opacity?: number;
+    ground?: Rgb;
+}): Rgb;
+//# sourceMappingURL=opacity.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"opacity.d.ts","sourceRoot":"","sources":["../../../src/internals/bgfx/opacity.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAGH,OAAO,EAAE,KAAK,GAAG,EAAO,MAAM,wBAAwB,CAAC;AAEvD;;;GAGG;AACH,eAAO,MAAM,mBAAmB,EAAE,GAA6B,CAAC;AAehE,wBAAgB,cAAc,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI,CAG9C;AAED,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,+DAA+D;AAC/D,wBAAgB,aAAa,CAAC,GAAG,EAAE,GAAG,GAAG,IAAI,CAM5C;AAED;;;;;;GAMG;AACH,wBAAgB,gBAAgB,IAAI,GAAG,CAMtC;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CACvB,KAAK,EAAE,GAAG,EACV,IAAI,CAAC,EAAE;IACL,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,GAAG,CAAC;CACd,GACA,GAAG,CAUL"}

package/dist/internals/bgfx/opacity.js

@@ -0,0 +1,76 @@
+/**
+ * Global opacity for procedural backgrounds (quiet wash).
+ *
+ * Transparency means mix toward the **terminal ground color** (OSC 11),
+ * not toward pure black — so light terminals and tinted themes stay coherent.
+ *
+ *   out = mix(ground, field, opacity)
+ *   0 → ground · 1 → full field
+ */
+import { clampByte, mix } from "./types.js";
+import { BgP } from "../../lexicon/index.js";
+/**
+ * Fallback only when OSC 11 was never set — not "the" ground.
+ * Hosts should call `setBgFxGround` from probeOsc11 / theme.
+ */
+export const BGFX_DEFAULT_GROUND = { r: 10, g: 10, b: 14 };
+/**
+ * Fixed per-channel nudge from ground for the "no field sample here"
+ * sentinel (registry unknown-id, shadertoy null frame, shader-frame-host
+ * bad-copy fill). Keeps the sentinel one truth with the live ground instead
+ * of a hardcoded near-black that clashes with light terminals, while staying
+ * non-zero so a zero-filled buffer is never mistaken for valid shader output
+ * (see M1 note in shader-frame-host.ts).
+ */
+const NULL_FIELD_DELTA = { r: 4, g: 4, b: 6 };
+let opacity = BgP.mist;
+let ground = { ...BGFX_DEFAULT_GROUND };
+export function setBgFxOpacity(o) {
+    if (!Number.isFinite(o))
+        return;
+    opacity = Math.min(1, Math.max(0, o));
+}
+export function getBgFxOpacity() {
+    return opacity;
+}
+/** Terminal background (0–255 sRGB), typically from OSC 11. */
+export function setBgFxGround(rgb) {
+    ground = {
+        r: clampByte(rgb.r),
+        g: clampByte(rgb.g),
+        b: clampByte(rgb.b),
+    };
+}
+/**
+ * The `BGFX_NULL_FIELD` sentinel (color-hygiene plan, enabler 10) — the
+ * single "nothing here" color for all bgFx no-field paths, replacing five
+ * independent near-black literals. Ground-derived + `NULL_FIELD_DELTA`, so it
+ * is a function (not a frozen constant): it must track `setBgFxGround` calls
+ * rather than assume a dark terminal.
+ */
+export function getBgFxNullField() {
+    return {
+        r: clampByte(ground.r + NULL_FIELD_DELTA.r),
+        g: clampByte(ground.g + NULL_FIELD_DELTA.g),
+        b: clampByte(ground.b + NULL_FIELD_DELTA.b),
+    };
+}
+/**
+ * Blend field sample toward terminal ground.
+ * Per-cell `opacity` multiplies global opacity.
+ * Explicit `ground` overrides the OSC11-attuned default for this call only.
+ */
+export function blendBgFx(field, opts) {
+    const o = Math.min(1, Math.max(0, (opts?.opacity ?? 1) * opacity));
+    const g = opts?.ground ?? ground;
+    if (o >= 0.999)
+        return field;
+    if (o <= 0.001)
+        return { ...g };
+    return {
+        r: clampByte(mix(g.r, field.r, o)),
+        g: clampByte(mix(g.g, field.g, o)),
+        b: clampByte(mix(g.b, field.b, o)),
+    };
+}
+//# sourceMappingURL=opacity.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"opacity.js","sourceRoot":"","sources":["../../../src/internals/bgfx/opacity.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,SAAS,EAAE,GAAG,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAY,GAAG,EAAE,MAAM,wBAAwB,CAAC;AAEvD;;;GAGG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAQ,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC,EAAE,EAAE,EAAE,CAAC;AAEhE;;;;;;;GAOG;AACH,MAAM,gBAAgB,GAAQ,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;AAEnD,IAAI,OAAO,GAAW,GAAG,CAAC,IAAI,CAAC;AAC/B,IAAI,MAAM,GAAQ,EAAE,GAAG,mBAAmB,EAAE,CAAC;AAE7C,MAAM,UAAU,cAAc,CAAC,CAAS;IACtC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;QAAE,OAAO;IAChC,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AACxC,CAAC;AAED,MAAM,UAAU,cAAc;IAC5B,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,+DAA+D;AAC/D,MAAM,UAAU,aAAa,CAAC,GAAQ;IACpC,MAAM,GAAG;QACP,CAAC,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;QACnB,CAAC,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;QACnB,CAAC,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;KACpB,CAAC;AACJ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB;IAC9B,OAAO;QACL,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC;QAC3C,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC;QAC3C,CAAC,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC,GAAG,gBAAgB,CAAC,CAAC,CAAC;KAC5C,CAAC;AACJ,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,SAAS,CACvB,KAAU,EACV,IAGC;IAED,MAAM,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,IAAI,EAAE,OAAO,IAAI,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IACnE,MAAM,CAAC,GAAG,IAAI,EAAE,MAAM,IAAI,MAAM,CAAC;IACjC,IAAI,CAAC,IAAI,KAAK;QAAE,OAAO,KAAK,CAAC;IAC7B,IAAI,CAAC,IAAI,KAAK;QAAE,OAAO,EAAE,GAAG,CAAC,EAAE,CAAC;IAChC,OAAO;QACL,CAAC,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAClC,CAAC,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QAClC,CAAC,EAAE,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;KACnC,CAAC;AACJ,CAAC"}

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

@@ -0,0 +1,13 @@
+/**
+ * Open shader registry. Programs register with renderFrame (node GL / worker).
+ *
+ *   registerBgFxShader({ id: "mine", renderFrame: ... })
+ *   fillBgFx(buf, rect, "mine")
+ */
+import type { BgFxId, BgFxProgram } from "./types.js";
+/** Register or replace a color-field program. */
+export declare function registerBgFxShader(program: BgFxProgram): void;
+export declare function unregisterBgFxShader(id: BgFxId): boolean;
+export declare function getBgFxShader(id: BgFxId): BgFxProgram | undefined;
+export declare function hasBgFxShader(id: BgFxId): boolean;
+//# sourceMappingURL=registry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../../src/internals/bgfx/registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAItD,iDAAiD;AACjD,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CAI7D;AAED,wBAAgB,oBAAoB,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAExD;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,CAEjE;AAED,wBAAgB,aAAa,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAEjD"}

package/dist/internals/bgfx/registry.js

@@ -0,0 +1,24 @@
+/**
+ * Open shader registry. Programs register with renderFrame (node GL / worker).
+ *
+ *   registerBgFxShader({ id: "mine", renderFrame: ... })
+ *   fillBgFx(buf, rect, "mine")
+ */
+import invariant from "tiny-invariant";
+const registry = new Map();
+/** Register or replace a color-field program. */
+export function registerBgFxShader(program) {
+    invariant(program.id, "bgFx program requires non-empty id");
+    invariant(program.renderFrame, `bgFx program "${program.id}" needs renderFrame`);
+    registry.set(program.id, program);
+}
+export function unregisterBgFxShader(id) {
+    return registry.delete(id);
+}
+export function getBgFxShader(id) {
+    return registry.get(id);
+}
+export function hasBgFxShader(id) {
+    return registry.has(id);
+}
+//# sourceMappingURL=registry.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../../../src/internals/bgfx/registry.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,SAAS,MAAM,gBAAgB,CAAC;AAIvC,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAuB,CAAC;AAEhD,iDAAiD;AACjD,MAAM,UAAU,kBAAkB,CAAC,OAAoB;IACrD,SAAS,CAAC,OAAO,CAAC,EAAE,EAAE,oCAAoC,CAAC,CAAC;IAC5D,SAAS,CAAC,OAAO,CAAC,WAAW,EAAE,iBAAiB,OAAO,CAAC,EAAE,qBAAqB,CAAC,CAAC;IACjF,QAAQ,CAAC,GAAG,CAAC,OAAO,CAAC,EAAE,EAAE,OAAO,CAAC,CAAC;AACpC,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,EAAU;IAC7C,OAAO,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;AAC7B,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,EAAU;IACtC,OAAO,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAC1B,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,EAAU;IACtC,OAAO,QAAQ,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;AAC1B,CAAC"}

package/dist/internals/bgfx/sab-layout.d.ts

@@ -0,0 +1,61 @@
+/**
+ * SharedArrayBuffer layout for off-thread field frames (bg only).
+ *
+ * Double-buffered RGBA + seqlocks. Dimensions are cell grid (1 sample / cell).
+ */
+export declare const HDR_W = 0;
+export declare const HDR_H = 1;
+export declare const HDR_FRONT = 2;
+export declare const HDR_SEQ0 = 3;
+export declare const HDR_SEQ1 = 4;
+export declare const HDR_FRAME_MS = 5;
+export declare const HDR_STATUS = 6;
+export declare const HDR_GEN = 7;
+export declare const HDR_SLOTS = 16;
+export declare const STATUS_BOOT = 0;
+export declare const STATUS_OK = 1;
+export declare const STATUS_ERR = 2;
+export declare const ENV_T = 0;
+export declare const ENV_MX = 1;
+export declare const ENV_MY = 2;
+export declare const ENV_MZ = 3;
+export declare const ENV_MW = 4;
+/** +1 dark canvas, −1 light — Shadertoy iPolarity. */
+export declare const ENV_POLARITY = 5;
+export declare const ENV_FLOATS = 8;
+export declare const ENV_W = 0;
+export declare const ENV_H = 1;
+export declare const ENV_INTS = 4;
+export declare function headerBytes(): number;
+export declare function slotBytes(w: number, h: number): number;
+export declare function pixelSabBytes(w: number, h: number): number;
+export declare function envSabBytes(): number;
+export declare function slotOffset(w: number, h: number, slot: 0 | 1): number;
+export type PixelViews = {
+    sab: SharedArrayBuffer;
+    hdr: Int32Array;
+    bytes: Uint8Array;
+};
+export declare function openPixelViews(sab: SharedArrayBuffer): PixelViews;
+export type EnvViews = {
+    sab: SharedArrayBuffer;
+    f32: Float32Array;
+    i32: Int32Array;
+};
+export declare function openEnvViews(sab: SharedArrayBuffer): EnvViews;
+export declare function writeEnv(env: EnvViews, opts: {
+    t: number;
+    w: number;
+    h: number;
+    mouse?: {
+        x: number;
+        y: number;
+        z: number;
+        w: number;
+    };
+    polarity?: "dark" | "light";
+}): void;
+export declare function beginSlotWrite(hdr: Int32Array, slot: 0 | 1): void;
+export declare function endSlotWrite(hdr: Int32Array, slot: 0 | 1, frameMs: number): void;
+export declare function copyFrontFrame(views: PixelViews, out: Uint8Array, expectW: number, expectH: number): boolean;
+//# sourceMappingURL=sab-layout.d.ts.map

package/dist/internals/bgfx/sab-layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sab-layout.d.ts","sourceRoot":"","sources":["../../../src/internals/bgfx/sab-layout.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,eAAO,MAAM,KAAK,IAAI,CAAC;AACvB,eAAO,MAAM,KAAK,IAAI,CAAC;AACvB,eAAO,MAAM,SAAS,IAAI,CAAC;AAC3B,eAAO,MAAM,QAAQ,IAAI,CAAC;AAC1B,eAAO,MAAM,QAAQ,IAAI,CAAC;AAC1B,eAAO,MAAM,YAAY,IAAI,CAAC;AAC9B,eAAO,MAAM,UAAU,IAAI,CAAC;AAC5B,eAAO,MAAM,OAAO,IAAI,CAAC;AACzB,eAAO,MAAM,SAAS,KAAK,CAAC;AAE5B,eAAO,MAAM,WAAW,IAAI,CAAC;AAC7B,eAAO,MAAM,SAAS,IAAI,CAAC;AAC3B,eAAO,MAAM,UAAU,IAAI,CAAC;AAE5B,eAAO,MAAM,KAAK,IAAI,CAAC;AACvB,eAAO,MAAM,MAAM,IAAI,CAAC;AACxB,eAAO,MAAM,MAAM,IAAI,CAAC;AACxB,eAAO,MAAM,MAAM,IAAI,CAAC;AACxB,eAAO,MAAM,MAAM,IAAI,CAAC;AACxB,sDAAsD;AACtD,eAAO,MAAM,YAAY,IAAI,CAAC;AAC9B,eAAO,MAAM,UAAU,IAAI,CAAC;AAE5B,eAAO,MAAM,KAAK,IAAI,CAAC;AACvB,eAAO,MAAM,KAAK,IAAI,CAAC;AACvB,eAAO,MAAM,QAAQ,IAAI,CAAC;AAE1B,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAED,wBAAgB,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAEtD;AAED,wBAAgB,aAAa,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAE1D;AAED,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAED,wBAAgB,UAAU,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,GAAG,MAAM,CAEpE;AAED,MAAM,MAAM,UAAU,GAAG;IACvB,GAAG,EAAE,iBAAiB,CAAC;IACvB,GAAG,EAAE,UAAU,CAAC;IAChB,KAAK,EAAE,UAAU,CAAC;CACnB,CAAC;AAEF,wBAAgB,cAAc,CAAC,GAAG,EAAE,iBAAiB,GAAG,UAAU,CAMjE;AAED,MAAM,MAAM,QAAQ,GAAG;IACrB,GAAG,EAAE,iBAAiB,CAAC;IACvB,GAAG,EAAE,YAAY,CAAC;IAClB,GAAG,EAAE,UAAU,CAAC;CACjB,CAAC;AAEF,wBAAgB,YAAY,CAAC,GAAG,EAAE,iBAAiB,GAAG,QAAQ,CAI7D;AAED,wBAAgB,QAAQ,CACtB,GAAG,EAAE,QAAQ,EACb,IAAI,EAAE;IACJ,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,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,QAAQ,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;CAC7B,GACA,IAAI,CAWN;AAED,wBAAgB,cAAc,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,GAAG,IAAI,CAIjE;AAED,wBAAgB,YAAY,CAAC,GAAG,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,IAAI,CAQhF;AAED,wBAAgB,cAAc,CAAC,KAAK,EAAE,UAAU,EAAE,GAAG,EAAE,UAAU,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAqB5G"}

package/dist/internals/bgfx/sab-layout.js

@@ -0,0 +1,107 @@
+/**
+ * SharedArrayBuffer layout for off-thread field frames (bg only).
+ *
+ * Double-buffered RGBA + seqlocks. Dimensions are cell grid (1 sample / cell).
+ */
+export const HDR_W = 0;
+export const HDR_H = 1;
+export const HDR_FRONT = 2;
+export const HDR_SEQ0 = 3;
+export const HDR_SEQ1 = 4;
+export const HDR_FRAME_MS = 5;
+export const HDR_STATUS = 6;
+export const HDR_GEN = 7;
+export const HDR_SLOTS = 16;
+export const STATUS_BOOT = 0;
+export const STATUS_OK = 1;
+export const STATUS_ERR = 2;
+export const ENV_T = 0;
+export const ENV_MX = 1;
+export const ENV_MY = 2;
+export const ENV_MZ = 3;
+export const ENV_MW = 4;
+/** +1 dark canvas, −1 light — Shadertoy iPolarity. */
+export const ENV_POLARITY = 5;
+export const ENV_FLOATS = 8;
+export const ENV_W = 0;
+export const ENV_H = 1;
+export const ENV_INTS = 4;
+export function headerBytes() {
+    return HDR_SLOTS * 4;
+}
+export function slotBytes(w, h) {
+    return Math.max(1, w) * Math.max(1, h) * 4;
+}
+export function pixelSabBytes(w, h) {
+    return headerBytes() + 2 * slotBytes(w, h);
+}
+export function envSabBytes() {
+    return ENV_FLOATS * 4 + ENV_INTS * 4;
+}
+export function slotOffset(w, h, slot) {
+    return headerBytes() + slot * slotBytes(w, h);
+}
+export function openPixelViews(sab) {
+    return {
+        sab,
+        hdr: new Int32Array(sab, 0, HDR_SLOTS),
+        bytes: new Uint8Array(sab),
+    };
+}
+export function openEnvViews(sab) {
+    const f32 = new Float32Array(sab, 0, ENV_FLOATS);
+    const i32 = new Int32Array(sab, ENV_FLOATS * 4, ENV_INTS);
+    return { sab, f32, i32 };
+}
+export function writeEnv(env, opts) {
+    const m = opts.mouse ?? { x: 0, y: 0, z: 0, w: 0 };
+    env.f32[ENV_T] = opts.t;
+    env.f32[ENV_MX] = m.x;
+    env.f32[ENV_MY] = m.y;
+    env.f32[ENV_MZ] = m.z;
+    env.f32[ENV_MW] = m.w;
+    env.f32[ENV_POLARITY] = opts.polarity === "light" ? -1 : 1;
+    Atomics.store(env.i32, ENV_W, opts.w);
+    Atomics.store(env.i32, ENV_H, opts.h);
+    // ENV_RESERVED left untouched — no reader; avoid false "change" noise.
+}
+export function beginSlotWrite(hdr, slot) {
+    const seqIdx = slot === 0 ? HDR_SEQ0 : HDR_SEQ1;
+    const seq = Atomics.load(hdr, seqIdx);
+    Atomics.store(hdr, seqIdx, seq | 1);
+}
+export function endSlotWrite(hdr, slot, frameMs) {
+    const seqIdx = slot === 0 ? HDR_SEQ0 : HDR_SEQ1;
+    const seq = Atomics.load(hdr, seqIdx);
+    Atomics.store(hdr, seqIdx, (seq | 1) + 1);
+    Atomics.store(hdr, HDR_FRONT, slot);
+    Atomics.store(hdr, HDR_FRAME_MS, Math.round(frameMs));
+    Atomics.add(hdr, HDR_GEN, 1);
+    Atomics.store(hdr, HDR_STATUS, STATUS_OK);
+}
+export function copyFrontFrame(views, out, expectW, expectH) {
+    const { hdr, bytes } = views;
+    const w = Atomics.load(hdr, HDR_W);
+    const h = Atomics.load(hdr, HDR_H);
+    if (w !== expectW || h !== expectH || w <= 0 || h <= 0)
+        return false;
+    const need = w * h * 4;
+    if (out.length < need)
+        return false;
+    for (let attempt = 0; attempt < 8; attempt++) {
+        const front = Atomics.load(hdr, HDR_FRONT);
+        if (front !== 0 && front !== 1)
+            return false;
+        const seqIdx = front === 0 ? HDR_SEQ0 : HDR_SEQ1;
+        const s1 = Atomics.load(hdr, seqIdx);
+        if (s1 & 1)
+            continue;
+        const off = slotOffset(w, h, front);
+        out.set(bytes.subarray(off, off + need));
+        const s2 = Atomics.load(hdr, seqIdx);
+        if (s1 === s2 && (s2 & 1) === 0)
+            return true;
+    }
+    return false;
+}
+//# sourceMappingURL=sab-layout.js.map

package/dist/internals/bgfx/sab-layout.js.map

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

package/dist/internals/bgfx/shader-frame-host.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Main-thread host for off-thread field frames (bg only, 1 sample / cell).
+ */
+import type { BgFxEnv, BgFxFrame } from "./types.js";
+export type ShaderFrameHostOpts = {
+    source: string;
+    width?: number;
+    height?: number;
+};
+export type ShaderFrameHost = {
+    pushEnv(w: number, h: number, env: BgFxEnv): void;
+    readFrame(w: number, h: number): BgFxFrame;
+    /** Recompile worker GLSL (await before using new shader). */
+    switchSource(source: string): Promise<void>;
+    lastFrameMs(): number;
+    gen(): number;
+    ready(): boolean;
+    [Symbol.dispose](): void;
+};
+export declare function resolveBgfxWorkerPath(): string;
+export declare function createShaderFrameHost(opts: ShaderFrameHostOpts): Promise<ShaderFrameHost>;
+//# sourceMappingURL=shader-frame-host.d.ts.map

package/dist/internals/bgfx/shader-frame-host.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shader-frame-host.d.ts","sourceRoot":"","sources":["../../../src/internals/bgfx/shader-frame-host.ts"],"names":[],"mappings":"AAAA;;GAEG;AA0BH,OAAO,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAErD,MAAM,MAAM,mBAAmB,GAAG;IAChC,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,eAAe,GAAG;IAC5B,OAAO,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,GAAG,EAAE,OAAO,GAAG,IAAI,CAAC;IAClD,SAAS,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3C,6DAA6D;IAC7D,YAAY,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,WAAW,IAAI,MAAM,CAAC;IACtB,GAAG,IAAI,MAAM,CAAC;IACd,KAAK,IAAI,OAAO,CAAC;IACjB,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC;CAC1B,CAAC;AAiBF,wBAAgB,qBAAqB,IAAI,MAAM,CAM9C;AAED,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,eAAe,CAAC,CA0I/F"}