@aardworx/wombat.rendering 0.1.0 → 0.1.1

package/dist/window/canvas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"canvas.d.ts","sourceRoot":"","sources":["../../src/window/canvas.ts"],"names":[],"mappings":"AAqBA,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,oBAAoB,EAC1B,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAIL,KAAK,IAAI,EAEV,MAAM,2BAA2B,CAAC;AAEnC,MAAM,WAAW,mBAAmB;IAClC,6EAA6E;IAC7E,QAAQ,CAAC,MAAM,CAAC,EAAE,gBAAgB,CAAC;IACnC,4FAA4F;IAC5F,QAAQ,CAAC,WAAW,CAAC,EAAE,gBAAgB,CAAC;IACxC,qEAAqE;IACrE,QAAQ,CAAC,SAAS,CAAC,EAAE,kBAAkB,CAAC;IACxC,4EAA4E;IAC5E,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,wFAAwF;IACxF,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IACtC;;;;;OAKG;IACH,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AAED,MAAM,WAAW,gBAAgB;IAC/B,8DAA8D;IAC9D,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC,YAAY,CAAC,CAAC;IACzC,6DAA6D;IAC7D,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACzE,qDAAqD;IACrD,QAAQ,CAAC,SAAS,EAAE,oBAAoB,CAAC;IACzC,+GAA+G;IAC/G,SAAS,IAAI,IAAI,CAAC;IAClB,6EAA6E;IAC7E,OAAO,IAAI,IAAI,CAAC;CACjB;AAED,wBAAgB,YAAY,CAC1B,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,iBAAiB,GAAG,eAAe,EAC3C,IAAI,GAAE,mBAAwB,GAC7B,gBAAgB,CAqGlB"}

package/dist/window/canvas.js

@@ -0,0 +1,194 @@
+// attachCanvas — bind a `GPUDevice` to an `HTMLCanvasElement` /
+// `OffscreenCanvas` and expose the swap-chain as an
+// `aval<IFramebuffer>` so render tasks just plug it into a
+// `Render` command's `output`.
+//
+// Each call to `framebuffer.getValue(token)` returns a fresh
+// `IFramebuffer` whose color view is the current swap-chain
+// texture (`context.getCurrentTexture().createView()`). Inside
+// the render loop we mark the framebuffer aval outdated once per
+// rAF tick so the runtime samples the new texture.
+//
+// The size aval is fed by a `ResizeObserver`; on size change we
+// re-`configure()` the canvas context and bump a cval that the
+// framebuffer aval depends on.
+//
+// MSAA: when `sampleCount > 1`, we allocate a hidden multisample
+// color (and depth) texture sized to the canvas; the swap-chain
+// texture becomes the resolve target. The render-pass descriptor
+// builder in `@aardworx/wombat.rendering-commands` already wires
+// `resolveTarget` based on the framebuffer's `resolveColors`.
+import {} from "../core/index.js";
+import { HashMap, cval, transact, } from "@aardworx/wombat.adaptive";
+export function attachCanvas(device, canvas, opts = {}) {
+    const ctx = canvas.getContext("webgpu");
+    if (ctx === null)
+        throw new Error("attachCanvas: getContext('webgpu') returned null");
+    const colorName = opts.colorAttachmentName ?? "color";
+    const format = opts.format ?? navigator.gpu.getPreferredCanvasFormat();
+    const alphaMode = opts.alphaMode ?? "premultiplied";
+    const sampleCount = opts.sampleCount ?? 1;
+    const dpr = opts.devicePixelRatio ?? (typeof window !== "undefined" ? window.devicePixelRatio : 1);
+    // initial size from the canvas's CSS size (or its native dimensions for OffscreenCanvas).
+    const initial = currentSize(canvas, dpr);
+    const sizeC = cval({ width: initial.width, height: initial.height });
+    const frameC = cval(0);
+    // Apply the initial configure. We re-configure on every size change.
+    configure(ctx, device, format, alphaMode);
+    applySize(canvas, initial.width, initial.height);
+    // Hidden multisample color texture, present only when sampleCount > 1.
+    let msaaColor;
+    const ensureMsaaColor = (w, h) => {
+        if (sampleCount <= 1)
+            return undefined;
+        if (msaaColor !== undefined)
+            msaaColor.destroy();
+        msaaColor = device.createTexture({
+            size: { width: w, height: h, depthOrArrayLayers: 1 },
+            format,
+            sampleCount,
+            usage: GPUTextureUsage.RENDER_ATTACHMENT,
+            label: "canvas.color.msaa",
+        });
+        return msaaColor;
+    };
+    ensureMsaaColor(initial.width, initial.height);
+    // Optional shared depth texture re-allocated on size change.
+    let depthTexture;
+    const ensureDepth = (w, h) => {
+        if (opts.depthFormat === undefined)
+            return undefined;
+        if (depthTexture !== undefined)
+            depthTexture.destroy();
+        depthTexture = device.createTexture({
+            size: { width: w, height: h, depthOrArrayLayers: 1 },
+            format: opts.depthFormat,
+            sampleCount,
+            usage: GPUTextureUsage.RENDER_ATTACHMENT,
+            label: "canvas.depth",
+        });
+        return depthTexture;
+    };
+    ensureDepth(initial.width, initial.height);
+    // ResizeObserver — only meaningful for HTMLCanvasElement.
+    let observer;
+    if (typeof ResizeObserver !== "undefined" && canvas instanceof globalThis.HTMLCanvasElement) {
+        observer = new ResizeObserver((entries) => {
+            for (const e of entries) {
+                const cssWidth = e.contentBoxSize?.[0]?.inlineSize ?? canvas.clientWidth;
+                const cssHeight = e.contentBoxSize?.[0]?.blockSize ?? canvas.clientHeight;
+                const w = Math.max(1, Math.floor(cssWidth * dpr));
+                const h = Math.max(1, Math.floor(cssHeight * dpr));
+                if (w !== sizeC.value.width || h !== sizeC.value.height) {
+                    applySize(canvas, w, h);
+                    ensureMsaaColor(w, h);
+                    ensureDepth(w, h);
+                    transact(() => {
+                        sizeC.value = { width: w, height: h };
+                    });
+                }
+            }
+        });
+        observer.observe(canvas);
+    }
+    const signature = {
+        colors: HashMap.empty().add(colorName, format),
+        sampleCount,
+        ...(opts.depthFormat !== undefined
+            ? { depthStencil: depthAttachmentSig(opts.depthFormat) }
+            : {}),
+    };
+    // The framebuffer aval depends on (size, frame). Reading it pulls
+    // a fresh swap-chain texture; the frameC bump after each markFrame()
+    // is what re-fires the chain on the same size.
+    const framebuffer = sizeC.bind((sz) => frameC.map(() => makeFramebuffer(ctx, signature, sz, msaaColor, depthTexture, colorName)));
+    return {
+        framebuffer,
+        size: sizeC,
+        signature,
+        markFrame() {
+            transact(() => { frameC.value = frameC.value + 1; });
+        },
+        dispose() {
+            if (observer !== undefined)
+                observer.disconnect();
+            if (msaaColor !== undefined) {
+                msaaColor.destroy();
+                msaaColor = undefined;
+            }
+            if (depthTexture !== undefined) {
+                depthTexture.destroy();
+                depthTexture = undefined;
+            }
+            try {
+                ctx.unconfigure();
+            }
+            catch { /* already gone */ }
+        },
+    };
+}
+function configure(ctx, device, format, alphaMode) {
+    ctx.configure({
+        device, format, alphaMode,
+        usage: GPUTextureUsage.RENDER_ATTACHMENT | GPUTextureUsage.TEXTURE_BINDING | GPUTextureUsage.COPY_SRC,
+    });
+}
+function currentSize(canvas, dpr) {
+    if (canvas.clientWidth !== undefined) {
+        const c = canvas;
+        return {
+            width: Math.max(1, Math.floor((c.clientWidth || c.width) * dpr)),
+            height: Math.max(1, Math.floor((c.clientHeight || c.height) * dpr)),
+        };
+    }
+    const c = canvas;
+    return { width: c.width, height: c.height };
+}
+function applySize(canvas, w, h) {
+    if (canvas.clientWidth !== undefined) {
+        const c = canvas;
+        c.width = w;
+        c.height = h;
+    }
+    else {
+        const c = canvas;
+        c.width = w;
+        c.height = h;
+    }
+}
+function makeFramebuffer(ctx, signature, size, msaaColor, depthTexture, colorName) {
+    const swap = ctx.getCurrentTexture();
+    const swapView = swap.createView();
+    const msaa = signature.sampleCount > 1;
+    // Pass attachment view: the multisample texture when MSAA is on,
+    // otherwise the swap-chain texture directly.
+    const passView = msaa
+        ? (msaaColor ?? swap).createView()
+        : swapView;
+    const colors = HashMap.empty().add(colorName, passView);
+    const resolveColors = msaa
+        ? HashMap.empty().add(colorName, swapView)
+        : undefined;
+    // `colorTextures` exposes the *sampleable* texture (always the
+    // swap-chain — multisample textures are not sampleable in the
+    // normal sense).
+    const colorTextures = HashMap.empty().add(colorName, swap);
+    const fb = {
+        signature,
+        colors,
+        colorTextures,
+        ...(resolveColors !== undefined ? { resolveColors } : {}),
+        width: size.width,
+        height: size.height,
+        ...(depthTexture !== undefined
+            ? { depthStencil: depthTexture.createView(), depthStencilTexture: depthTexture }
+            : {}),
+    };
+    return fb;
+}
+function depthAttachmentSig(format) {
+    const hasDepth = /^depth/.test(format) || format === "depth24plus-stencil8" || format === "depth32float-stencil8";
+    const hasStencil = /stencil/.test(format);
+    return { format, hasDepth, hasStencil };
+}
+//# sourceMappingURL=canvas.js.map

package/dist/window/canvas.js.map

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

package/dist/window/index.d.ts

@@ -0,0 +1,3 @@
+export { attachCanvas, type AttachCanvasOptions, type CanvasAttachment, } from "./canvas.js";
+export { runFrame, type FrameCallback, type FrameInfo, type RunFrameOptions, } from "./loop.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/window/index.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,YAAY,EACZ,KAAK,mBAAmB,EACxB,KAAK,gBAAgB,GACtB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,QAAQ,EACR,KAAK,aAAa,EAClB,KAAK,SAAS,EACd,KAAK,eAAe,GACrB,MAAM,WAAW,CAAC"}

package/dist/window/index.js

@@ -0,0 +1,4 @@
+// Public API of @aardworx/wombat.rendering-window.
+export { attachCanvas, } from "./canvas.js";
+export { runFrame, } from "./loop.js";
+//# sourceMappingURL=index.js.map

package/dist/window/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/window/index.ts"],"names":[],"mappings":"AAAA,mDAAmD;AAEnD,OAAO,EACL,YAAY,GAGb,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,QAAQ,GAIT,MAAM,WAAW,CAAC"}

package/dist/window/loop.d.ts

@@ -0,0 +1,16 @@
+import type { AdaptiveToken } from "@aardworx/wombat.adaptive";
+import type { CanvasAttachment } from "./canvas.js";
+export interface RunFrameOptions {
+    /** Stop after N frames. Useful for tests + finite animations. */
+    readonly maxFrames?: number;
+}
+export type FrameCallback = (token: AdaptiveToken, info: FrameInfo) => void;
+export interface FrameInfo {
+    readonly frame: number;
+    readonly timestampMs: number;
+    readonly deltaMs: number;
+}
+export declare function runFrame(attachment: CanvasAttachment, frame: FrameCallback, opts?: RunFrameOptions): {
+    stop(): void;
+};
+//# sourceMappingURL=loop.d.ts.map

package/dist/window/loop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop.d.ts","sourceRoot":"","sources":["../../src/window/loop.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE/D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEpD,MAAM,WAAW,eAAe;IAC9B,iEAAiE;IACjE,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED,MAAM,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,aAAa,EAAE,IAAI,EAAE,SAAS,KAAK,IAAI,CAAC;AAE5E,MAAM,WAAW,SAAS;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,QAAQ,CACtB,UAAU,EAAE,gBAAgB,EAC5B,KAAK,EAAE,aAAa,EACpB,IAAI,GAAE,eAAoB,GACzB;IAAE,IAAI,IAAI,IAAI,CAAA;CAAE,CA8BlB"}

package/dist/window/loop.js

@@ -0,0 +1,43 @@
+// runFrame — requestAnimationFrame-driven loop integrated with
+// wombat.adaptive transactions. Each tick:
+//   1. Bumps the canvas attachment's frame counter so its
+//      framebuffer aval invalidates and the next read returns the
+//      current swap-chain texture.
+//   2. Calls the user's `frame(token)` callback. The user runs
+//      their `IRenderTask` here.
+//
+// Returns a `stop()` to cancel the loop.
+import { AdaptiveToken as Tok } from "@aardworx/wombat.adaptive";
+export function runFrame(attachment, frame, opts = {}) {
+    let stopped = false;
+    let frameNo = 0;
+    let lastTime = performance.now();
+    let rafId = 0;
+    const tick = (now) => {
+        if (stopped)
+            return;
+        const delta = now - lastTime;
+        lastTime = now;
+        attachment.markFrame();
+        try {
+            frame(Tok.top, { frame: frameNo, timestampMs: now, deltaMs: delta });
+        }
+        catch (e) {
+            stopped = true;
+            console.error("runFrame: error in frame callback", e);
+            throw e;
+        }
+        frameNo++;
+        if (opts.maxFrames !== undefined && frameNo >= opts.maxFrames)
+            return;
+        rafId = requestAnimationFrame(tick);
+    };
+    rafId = requestAnimationFrame(tick);
+    return {
+        stop() {
+            stopped = true;
+            cancelAnimationFrame(rafId);
+        },
+    };
+}
+//# sourceMappingURL=loop.js.map

package/dist/window/loop.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"loop.js","sourceRoot":"","sources":["../../src/window/loop.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,2CAA2C;AAC3C,0DAA0D;AAC1D,kEAAkE;AAClE,mCAAmC;AACnC,+DAA+D;AAC/D,iCAAiC;AACjC,EAAE;AACF,yCAAyC;AAGzC,OAAO,EAAE,aAAa,IAAI,GAAG,EAAE,MAAM,2BAA2B,CAAC;AAgBjE,MAAM,UAAU,QAAQ,CACtB,UAA4B,EAC5B,KAAoB,EACpB,OAAwB,EAAE;IAE1B,IAAI,OAAO,GAAG,KAAK,CAAC;IACpB,IAAI,OAAO,GAAG,CAAC,CAAC;IAChB,IAAI,QAAQ,GAAG,WAAW,CAAC,GAAG,EAAE,CAAC;IACjC,IAAI,KAAK,GAAG,CAAC,CAAC;IAEd,MAAM,IAAI,GAAG,CAAC,GAAW,EAAE,EAAE;QAC3B,IAAI,OAAO;YAAE,OAAO;QACpB,MAAM,KAAK,GAAG,GAAG,GAAG,QAAQ,CAAC;QAC7B,QAAQ,GAAG,GAAG,CAAC;QACf,UAAU,CAAC,SAAS,EAAE,CAAC;QACvB,IAAI,CAAC;YACH,KAAK,CAAC,GAAG,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,GAAG,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;QACvE,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,OAAO,GAAG,IAAI,CAAC;YACf,OAAO,CAAC,KAAK,CAAC,mCAAmC,EAAE,CAAC,CAAC,CAAC;YACtD,MAAM,CAAC,CAAC;QACV,CAAC;QACD,OAAO,EAAE,CAAC;QACV,IAAI,IAAI,CAAC,SAAS,KAAK,SAAS,IAAI,OAAO,IAAI,IAAI,CAAC,SAAS;YAAE,OAAO;QACtE,KAAK,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;IACtC,CAAC,CAAC;IAEF,KAAK,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;IACpC,OAAO;QACL,IAAI;YACF,OAAO,GAAG,IAAI,CAAC;YACf,oBAAoB,CAAC,KAAK,CAAC,CAAC;QAC9B,CAAC;KACF,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aardworx/wombat.rendering",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "WebGPU rendering layer for the Wombat TypeScript stack — RenderObject/RenderTask/runtime + window glue, port of Aardvark.Rendering's lower layers on top of WebGPU and wombat.shader.",
   "license": "MIT",
   "author": "krauthaufen",