@aardworx/wombat.rendering 0.1.0 → 0.1.1

package/dist/resources/adaptiveBuffer.js

@@ -0,0 +1,99 @@
+// prepareAdaptiveBuffer — lift `aval<IBuffer>` to
+// `AdaptiveResource<GPUBuffer>`.
+//
+// Behaviour:
+//   - On `acquire` (refCount 0→1): subscribes, allocates nothing yet.
+//   - On `compute(token)`:
+//     - reads the source `aval<IBuffer>`;
+//     - if it's `gpu`: returns the user's handle directly. We
+//       don't own it; `destroy()` will not free it.
+//     - if it's `host`: ensures we own a `GPUBuffer` of sufficient
+//       size + correct usage flags, encodes a `writeBuffer` (via
+//       device.queue) to upload the bytes, returns the owned
+//       buffer. Reuses the existing buffer when capacity allows;
+//       reallocates on growth.
+//   - On `destroy`: frees the owned buffer (if any).
+//
+// `writeBuffer` does not require a GPUCommandEncoder — it goes via
+// `GPUQueue.writeBuffer`, scheduled at the next submit. That keeps
+// the upload path simple and avoids needing `RenderContext.encoder`
+// for plain CPU→GPU buffer flow. (Compute-produced buffers will
+// need the encoder; that's a different code path.)
+import { AdaptiveResource, tryAcquire, tryRelease, } from "../core/index.js";
+import {} from "@aardworx/wombat.adaptive";
+import { BufferUsage } from "./webgpuFlags.js";
+class AdaptiveBuffer extends AdaptiveResource {
+    device;
+    source;
+    opts;
+    _owned = undefined;
+    _ownedCapacity = 0;
+    constructor(device, source, opts) {
+        super();
+        this.device = device;
+        this.source = source;
+        this.opts = opts;
+    }
+    create() {
+        tryAcquire(this.source);
+    }
+    destroy() {
+        if (this._owned !== undefined) {
+            this._owned.destroy();
+            this._owned = undefined;
+            this._ownedCapacity = 0;
+        }
+        tryRelease(this.source);
+    }
+    compute(token) {
+        const src = this.source.getValue(token);
+        if (src.kind === "gpu") {
+            // Caller-owned buffer; drop any owned allocation we still hold.
+            if (this._owned !== undefined) {
+                this._owned.destroy();
+                this._owned = undefined;
+                this._ownedCapacity = 0;
+            }
+            return src.buffer;
+        }
+        // host — upload via queue.writeBuffer.
+        const usage = this.opts.usage | BufferUsage.COPY_DST;
+        const reuseOnFit = this.opts.reuseOnFit ?? true;
+        const requiredSize = roundUp4(src.sizeBytes);
+        if (this._owned === undefined
+            || !reuseOnFit
+            || requiredSize > this._ownedCapacity) {
+            if (this._owned !== undefined)
+                this._owned.destroy();
+            const desc = {
+                size: requiredSize,
+                usage,
+                ...(this.opts.label !== undefined ? { label: this.opts.label } : {}),
+            };
+            this._owned = this.device.createBuffer(desc);
+            this._ownedCapacity = requiredSize;
+        }
+        // writeBuffer accepts ArrayBuffer or any ArrayBufferView.
+        const data = src.data;
+        if (data instanceof ArrayBuffer) {
+            this.device.queue.writeBuffer(this._owned, 0, data, 0, src.sizeBytes);
+        }
+        else {
+            this.device.queue.writeBuffer(this._owned, 0, data.buffer, data.byteOffset, src.sizeBytes);
+        }
+        return this._owned;
+    }
+}
+function roundUp4(n) {
+    return (n + 3) & ~3;
+}
+/**
+ * Wrap an `aval<IBuffer>` as a ref-counted, adaptively-uploaded
+ * `AdaptiveResource<GPUBuffer>`. The resource is itself an
+ * `aval<GPUBuffer>` — downstream consumers can `getValue(token)`
+ * inside their own adaptive evaluation.
+ */
+export function prepareAdaptiveBuffer(device, source, opts) {
+    return new AdaptiveBuffer(device, source, opts);
+}
+//# sourceMappingURL=adaptiveBuffer.js.map

package/dist/resources/adaptiveBuffer.js.map

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

package/dist/resources/adaptiveSampler.d.ts

@@ -0,0 +1,4 @@
+import { AdaptiveResource, type ISampler } from "../core/index.js";
+import { type aval } from "@aardworx/wombat.adaptive";
+export declare function prepareAdaptiveSampler(device: GPUDevice, source: aval<ISampler>): AdaptiveResource<GPUSampler>;
+//# sourceMappingURL=adaptiveSampler.d.ts.map

package/dist/resources/adaptiveSampler.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adaptiveSampler.d.ts","sourceRoot":"","sources":["../../src/resources/adaptiveSampler.ts"],"names":[],"mappings":"AAQA,OAAO,EACL,gBAAgB,EAGhB,KAAK,QAAQ,EACd,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAEL,KAAK,IAAI,EACV,MAAM,2BAA2B,CAAC;AA2DnC,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,GACrB,gBAAgB,CAAC,UAAU,CAAC,CAE9B"}

package/dist/resources/adaptiveSampler.js

@@ -0,0 +1,73 @@
+// prepareAdaptiveSampler — lift `aval<ISampler>` to
+// `AdaptiveResource<GPUSampler>`.
+//
+// Samplers are cheap and structurally-identifiable — the device
+// dedupes them via a descriptor cache. Per AdaptiveResource we
+// just track the most recent handle; on descriptor change we
+// fetch a fresh one from the cache.
+import { AdaptiveResource, tryAcquire, tryRelease, } from "../core/index.js";
+import {} from "@aardworx/wombat.adaptive";
+class SamplerCache {
+    device;
+    map = new Map();
+    constructor(device) {
+        this.device = device;
+    }
+    get(desc) {
+        const k = key(desc);
+        let s = this.map.get(k);
+        if (s === undefined) {
+            s = this.device.createSampler(desc);
+            this.map.set(k, s);
+        }
+        return s;
+    }
+}
+function key(d) {
+    return [
+        d.addressModeU ?? "clamp-to-edge",
+        d.addressModeV ?? "clamp-to-edge",
+        d.addressModeW ?? "clamp-to-edge",
+        d.magFilter ?? "nearest",
+        d.minFilter ?? "nearest",
+        d.mipmapFilter ?? "nearest",
+        d.lodMinClamp ?? 0,
+        d.lodMaxClamp ?? 32,
+        d.compare ?? "",
+        d.maxAnisotropy ?? 1,
+    ].join("|");
+}
+const caches = new WeakMap();
+function cacheFor(device) {
+    let c = caches.get(device);
+    if (c === undefined) {
+        c = new SamplerCache(device);
+        caches.set(device, c);
+    }
+    return c;
+}
+class AdaptiveSampler extends AdaptiveResource {
+    device;
+    source;
+    constructor(device, source) {
+        super();
+        this.device = device;
+        this.source = source;
+    }
+    create() { tryAcquire(this.source); }
+    destroy() {
+        // We never own the GPUSampler — the cache does. Just propagate
+        // release to the source aval (in case it's an AdaptiveResource).
+        tryRelease(this.source);
+    }
+    compute(token) {
+        const s = this.source.getValue(token);
+        if (s.kind === "gpu")
+            return s.sampler;
+        return cacheFor(this.device).get(s.descriptor);
+    }
+}
+export function prepareAdaptiveSampler(device, source) {
+    return new AdaptiveSampler(device, source);
+}
+//# sourceMappingURL=adaptiveSampler.js.map

package/dist/resources/adaptiveSampler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adaptiveSampler.js","sourceRoot":"","sources":["../../src/resources/adaptiveSampler.ts"],"names":[],"mappings":"AAAA,oDAAoD;AACpD,kCAAkC;AAClC,EAAE;AACF,gEAAgE;AAChE,+DAA+D;AAC/D,6DAA6D;AAC7D,oCAAoC;AAEpC,OAAO,EACL,gBAAgB,EAChB,UAAU,EACV,UAAU,GAEX,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAGN,MAAM,2BAA2B,CAAC;AAEnC,MAAM,YAAY;IAEa;IADZ,GAAG,GAAG,IAAI,GAAG,EAAsB,CAAC;IACrD,YAA6B,MAAiB;QAAjB,WAAM,GAAN,MAAM,CAAW;IAAG,CAAC;IAClD,GAAG,CAAC,IAA0B;QAC5B,MAAM,CAAC,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC;QACpB,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;QACxB,IAAI,CAAC,KAAK,SAAS,EAAE,CAAC;YACpB,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;YACpC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;QACrB,CAAC;QACD,OAAO,CAAC,CAAC;IACX,CAAC;CACF;AAED,SAAS,GAAG,CAAC,CAAuB;IAClC,OAAO;QACL,CAAC,CAAC,YAAY,IAAI,eAAe;QACjC,CAAC,CAAC,YAAY,IAAI,eAAe;QACjC,CAAC,CAAC,YAAY,IAAI,eAAe;QACjC,CAAC,CAAC,SAAS,IAAI,SAAS;QACxB,CAAC,CAAC,SAAS,IAAI,SAAS;QACxB,CAAC,CAAC,YAAY,IAAI,SAAS;QAC3B,CAAC,CAAC,WAAW,IAAI,CAAC;QAClB,CAAC,CAAC,WAAW,IAAI,EAAE;QACnB,CAAC,CAAC,OAAO,IAAI,EAAE;QACf,CAAC,CAAC,aAAa,IAAI,CAAC;KACrB,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACd,CAAC;AAED,MAAM,MAAM,GAAG,IAAI,OAAO,EAA2B,CAAC;AACtD,SAAS,QAAQ,CAAC,MAAiB;IACjC,IAAI,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IAC3B,IAAI,CAAC,KAAK,SAAS,EAAE,CAAC;QACpB,CAAC,GAAG,IAAI,YAAY,CAAC,MAAM,CAAC,CAAC;QAC7B,MAAM,CAAC,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IACxB,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,eAAgB,SAAQ,gBAA4B;IAErC;IACA;IAFnB,YACmB,MAAiB,EACjB,MAAsB;QACrC,KAAK,EAAE,CAAC;QAFO,WAAM,GAAN,MAAM,CAAW;QACjB,WAAM,GAAN,MAAM,CAAgB;IAC5B,CAAC;IACJ,MAAM,KAAW,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAC3C,OAAO;QACf,+DAA+D;QAC/D,iEAAiE;QACjE,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1B,CAAC;IACQ,OAAO,CAAC,KAAoB;QACnC,MAAM,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACtC,IAAI,CAAC,CAAC,IAAI,KAAK,KAAK;YAAE,OAAO,CAAC,CAAC,OAAO,CAAC;QACvC,OAAO,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC;IACjD,CAAC;CACF;AAED,MAAM,UAAU,sBAAsB,CACpC,MAAiB,EACjB,MAAsB;IAEtB,OAAO,IAAI,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAC7C,CAAC"}

package/dist/resources/adaptiveTexture.d.ts

@@ -0,0 +1,14 @@
+import { AdaptiveResource, type ITexture } from "../core/index.js";
+import { type aval } from "@aardworx/wombat.adaptive";
+export interface PrepareAdaptiveTextureOptions {
+    /** Extra usage flags. `COPY_DST` and `TEXTURE_BINDING` are added automatically. */
+    readonly usage?: GPUTextureUsageFlags;
+    /** Optional debug label. */
+    readonly label?: string;
+}
+/**
+ * Wrap an `aval<ITexture>` as a ref-counted, adaptively-uploaded
+ * `AdaptiveResource<GPUTexture>`.
+ */
+export declare function prepareAdaptiveTexture(device: GPUDevice, source: aval<ITexture>, opts?: PrepareAdaptiveTextureOptions): AdaptiveResource<GPUTexture>;
+//# sourceMappingURL=adaptiveTexture.d.ts.map

package/dist/resources/adaptiveTexture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adaptiveTexture.d.ts","sourceRoot":"","sources":["../../src/resources/adaptiveTexture.ts"],"names":[],"mappings":"AAiBA,OAAO,EACL,gBAAgB,EAGhB,KAAK,QAAQ,EAGd,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAEL,KAAK,IAAI,EACV,MAAM,2BAA2B,CAAC;AAGnC,MAAM,WAAW,6BAA6B;IAC5C,mFAAmF;IACnF,QAAQ,CAAC,KAAK,CAAC,EAAE,oBAAoB,CAAC;IACtC,4BAA4B;IAC5B,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB;AA8ND;;;GAGG;AACH,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,EACtB,IAAI,GAAE,6BAAkC,GACvC,gBAAgB,CAAC,UAAU,CAAC,CAE9B"}

package/dist/resources/adaptiveTexture.js

@@ -0,0 +1,265 @@
+// prepareAdaptiveTexture — lift `aval<ITexture>` to
+// `AdaptiveResource<GPUTexture>`.
+//
+// Behaviour matches `prepareAdaptiveBuffer`: on `compute`, if the
+// source is `gpu` return the user's handle; if `host`, ensure we
+// own a GPUTexture of the right size/format and upload via the
+// queue (writeTexture for raw, copyExternalImageToTexture for
+// external sources).
+//
+// Reuse: a host source with the same dimensions + format reuses
+// the existing texture; mismatch triggers a fresh allocation.
+//
+// Mip-map generation is not implemented in this first cut —
+// `generateMips: true` on an external source allocates the mip
+// levels but only mip 0 is uploaded. (Mip generation requires a
+// compute pass; that lands in a follow-up.)
+import { AdaptiveResource, tryAcquire, tryRelease, } from "../core/index.js";
+import {} from "@aardworx/wombat.adaptive";
+import { TextureUsage } from "./webgpuFlags.js";
+function descsEqual(a, b) {
+    return (a.width === b.width
+        && a.height === b.height
+        && a.depthOrArrayLayers === b.depthOrArrayLayers
+        && a.format === b.format
+        && a.mipLevelCount === b.mipLevelCount);
+}
+function descFor(src) {
+    if (src.kind === "raw") {
+        return {
+            width: src.width,
+            height: src.height,
+            depthOrArrayLayers: src.depthOrArrayLayers ?? 1,
+            format: src.format,
+            mipLevelCount: src.mipLevelCount ?? 1,
+        };
+    }
+    // external
+    const s = src.source;
+    let width = 0;
+    let height = 0;
+    if (s instanceof ImageData) {
+        width = s.width;
+        height = s.height;
+    }
+    else if ("naturalWidth" in s && typeof s.naturalWidth === "number") {
+        // HTMLImageElement
+        width = s.naturalWidth || s.width;
+        height = s.naturalHeight || s.height;
+    }
+    else if ("videoWidth" in s && typeof s.videoWidth === "number") {
+        // HTMLVideoElement
+        width = s.videoWidth;
+        height = s.videoHeight;
+    }
+    else {
+        // ImageBitmap, HTMLCanvasElement, OffscreenCanvas — all have width/height
+        width = s.width;
+        height = s.height;
+    }
+    const generateMips = src.generateMips === true;
+    return {
+        width, height, depthOrArrayLayers: 1,
+        format: src.format ?? "rgba8unorm",
+        mipLevelCount: generateMips ? mipCount(width, height) : 1,
+    };
+}
+function mipCount(w, h) {
+    return Math.floor(Math.log2(Math.max(w, h))) + 1;
+}
+class AdaptiveTexture extends AdaptiveResource {
+    device;
+    source;
+    opts;
+    _owned = undefined;
+    _ownedDesc = undefined;
+    constructor(device, source, opts) {
+        super();
+        this.device = device;
+        this.source = source;
+        this.opts = opts;
+    }
+    create() { tryAcquire(this.source); }
+    destroy() {
+        if (this._owned !== undefined) {
+            this._owned.destroy();
+            this._owned = undefined;
+            this._ownedDesc = undefined;
+        }
+        tryRelease(this.source);
+    }
+    compute(token) {
+        const src = this.source.getValue(token);
+        if (src.kind === "gpu") {
+            if (this._owned !== undefined) {
+                this._owned.destroy();
+                this._owned = undefined;
+                this._ownedDesc = undefined;
+            }
+            return src.texture;
+        }
+        const desc = descFor(src.source);
+        const usage = (this.opts.usage ?? 0)
+            | TextureUsage.COPY_DST
+            | TextureUsage.TEXTURE_BINDING
+            | (src.source.kind === "external" ? TextureUsage.RENDER_ATTACHMENT : 0);
+        if (this._owned === undefined || this._ownedDesc === undefined || !descsEqual(this._ownedDesc, desc)) {
+            if (this._owned !== undefined)
+                this._owned.destroy();
+            const tdesc = {
+                size: { width: desc.width, height: desc.height, depthOrArrayLayers: desc.depthOrArrayLayers },
+                format: desc.format,
+                mipLevelCount: desc.mipLevelCount,
+                usage,
+                ...(this.opts.label !== undefined ? { label: this.opts.label } : {}),
+            };
+            this._owned = this.device.createTexture(tdesc);
+            this._ownedDesc = desc;
+        }
+        if (src.source.kind === "raw") {
+            uploadRaw(this.device, this._owned, src.source);
+        }
+        else {
+            uploadExternal(this.device, this._owned, src.source);
+        }
+        return this._owned;
+    }
+}
+function uploadRaw(device, tex, src) {
+    const bytes = src.data instanceof ArrayBuffer ? new Uint8Array(src.data) : new Uint8Array(src.data.buffer, src.data.byteOffset, src.data.byteLength);
+    const block = blockInfoFor(src.format);
+    const blocksPerRow = Math.ceil(src.width / block.width);
+    const rowsOfBlocks = Math.ceil(src.height / block.height);
+    device.queue.writeTexture({ texture: tex }, bytes, { bytesPerRow: blocksPerRow * block.bytesPerBlock, rowsPerImage: rowsOfBlocks }, { width: src.width, height: src.height, depthOrArrayLayers: src.depthOrArrayLayers ?? 1 });
+}
+function uploadExternal(device, tex, src) {
+    device.queue.copyExternalImageToTexture({ source: src.source }, { texture: tex }, { width: src.source.width, height: src.source.height, depthOrArrayLayers: 1 });
+}
+/**
+ * Block dimensions + size for a WebGPU texture format. Linear
+ * (uncompressed) formats report 1×1 blocks. Block-compressed
+ * formats (BC*, ETC*, ASTC*, EAC) use their native block size so
+ * `writeTexture`'s bytesPerRow / rowsPerImage land on the right
+ * block grid.
+ */
+function blockInfoFor(format) {
+    switch (format) {
+        // 8-bit
+        case "r8unorm":
+        case "r8snorm":
+        case "r8uint":
+        case "r8sint":
+            return { width: 1, height: 1, bytesPerBlock: 1 };
+        // 16-bit
+        case "rg8unorm":
+        case "rg8snorm":
+        case "rg8uint":
+        case "rg8sint":
+        case "r16uint":
+        case "r16sint":
+        case "r16float":
+            return { width: 1, height: 1, bytesPerBlock: 2 };
+        // 32-bit
+        case "rgba8unorm":
+        case "rgba8unorm-srgb":
+        case "rgba8snorm":
+        case "rgba8uint":
+        case "rgba8sint":
+        case "bgra8unorm":
+        case "bgra8unorm-srgb":
+        case "rgb10a2unorm":
+        case "rgb10a2uint":
+        case "rg11b10ufloat":
+        case "rgb9e5ufloat":
+        case "rg16uint":
+        case "rg16sint":
+        case "rg16float":
+        case "r32uint":
+        case "r32sint":
+        case "r32float":
+            return { width: 1, height: 1, bytesPerBlock: 4 };
+        // 64-bit
+        case "rgba16uint":
+        case "rgba16sint":
+        case "rgba16float":
+        case "rg32uint":
+        case "rg32sint":
+        case "rg32float":
+            return { width: 1, height: 1, bytesPerBlock: 8 };
+        // 128-bit
+        case "rgba32uint":
+        case "rgba32sint":
+        case "rgba32float":
+            return { width: 1, height: 1, bytesPerBlock: 16 };
+        // ---- Block-compressed formats ----
+        // BC1/2/3/4/5 (DXT/RGTC) — 4×4 blocks
+        case "bc1-rgba-unorm":
+        case "bc1-rgba-unorm-srgb":
+        case "bc4-r-unorm":
+        case "bc4-r-snorm":
+            return { width: 4, height: 4, bytesPerBlock: 8 };
+        case "bc2-rgba-unorm":
+        case "bc2-rgba-unorm-srgb":
+        case "bc3-rgba-unorm":
+        case "bc3-rgba-unorm-srgb":
+        case "bc5-rg-unorm":
+        case "bc5-rg-snorm":
+        case "bc6h-rgb-ufloat":
+        case "bc6h-rgb-float":
+        case "bc7-rgba-unorm":
+        case "bc7-rgba-unorm-srgb":
+            return { width: 4, height: 4, bytesPerBlock: 16 };
+        // ETC2 — 4×4 blocks
+        case "etc2-rgb8unorm":
+        case "etc2-rgb8unorm-srgb":
+        case "etc2-rgb8a1unorm":
+        case "etc2-rgb8a1unorm-srgb":
+        case "eac-r11unorm":
+        case "eac-r11snorm":
+            return { width: 4, height: 4, bytesPerBlock: 8 };
+        case "etc2-rgba8unorm":
+        case "etc2-rgba8unorm-srgb":
+        case "eac-rg11unorm":
+        case "eac-rg11snorm":
+            return { width: 4, height: 4, bytesPerBlock: 16 };
+        // ASTC — variable block size, all 16 bytes/block.
+        case "astc-4x4-unorm":
+        case "astc-4x4-unorm-srgb": return { width: 4, height: 4, bytesPerBlock: 16 };
+        case "astc-5x4-unorm":
+        case "astc-5x4-unorm-srgb": return { width: 5, height: 4, bytesPerBlock: 16 };
+        case "astc-5x5-unorm":
+        case "astc-5x5-unorm-srgb": return { width: 5, height: 5, bytesPerBlock: 16 };
+        case "astc-6x5-unorm":
+        case "astc-6x5-unorm-srgb": return { width: 6, height: 5, bytesPerBlock: 16 };
+        case "astc-6x6-unorm":
+        case "astc-6x6-unorm-srgb": return { width: 6, height: 6, bytesPerBlock: 16 };
+        case "astc-8x5-unorm":
+        case "astc-8x5-unorm-srgb": return { width: 8, height: 5, bytesPerBlock: 16 };
+        case "astc-8x6-unorm":
+        case "astc-8x6-unorm-srgb": return { width: 8, height: 6, bytesPerBlock: 16 };
+        case "astc-8x8-unorm":
+        case "astc-8x8-unorm-srgb": return { width: 8, height: 8, bytesPerBlock: 16 };
+        case "astc-10x5-unorm":
+        case "astc-10x5-unorm-srgb": return { width: 10, height: 5, bytesPerBlock: 16 };
+        case "astc-10x6-unorm":
+        case "astc-10x6-unorm-srgb": return { width: 10, height: 6, bytesPerBlock: 16 };
+        case "astc-10x8-unorm":
+        case "astc-10x8-unorm-srgb": return { width: 10, height: 8, bytesPerBlock: 16 };
+        case "astc-10x10-unorm":
+        case "astc-10x10-unorm-srgb": return { width: 10, height: 10, bytesPerBlock: 16 };
+        case "astc-12x10-unorm":
+        case "astc-12x10-unorm-srgb": return { width: 12, height: 10, bytesPerBlock: 16 };
+        case "astc-12x12-unorm":
+        case "astc-12x12-unorm-srgb": return { width: 12, height: 12, bytesPerBlock: 16 };
+        default:
+            throw new Error(`blockInfoFor: unsupported format ${format}`);
+    }
+}
+/**
+ * Wrap an `aval<ITexture>` as a ref-counted, adaptively-uploaded
+ * `AdaptiveResource<GPUTexture>`.
+ */
+export function prepareAdaptiveTexture(device, source, opts = {}) {
+    return new AdaptiveTexture(device, source, opts);
+}
+//# sourceMappingURL=adaptiveTexture.js.map

package/dist/resources/adaptiveTexture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"adaptiveTexture.js","sourceRoot":"","sources":["../../src/resources/adaptiveTexture.ts"],"names":[],"mappings":"AAAA,oDAAoD;AACpD,kCAAkC;AAClC,EAAE;AACF,kEAAkE;AAClE,iEAAiE;AACjE,+DAA+D;AAC/D,8DAA8D;AAC9D,qBAAqB;AACrB,EAAE;AACF,gEAAgE;AAChE,8DAA8D;AAC9D,EAAE;AACF,4DAA4D;AAC5D,+DAA+D;AAC/D,gEAAgE;AAChE,4CAA4C;AAE5C,OAAO,EACL,gBAAgB,EAChB,UAAU,EACV,UAAU,GAIX,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAGN,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AAiBhD,SAAS,UAAU,CAAC,CAAY,EAAE,CAAY;IAC5C,OAAO,CACL,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,KAAK;WAChB,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM;WACrB,CAAC,CAAC,kBAAkB,KAAK,CAAC,CAAC,kBAAkB;WAC7C,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC,MAAM;WACrB,CAAC,CAAC,aAAa,KAAK,CAAC,CAAC,aAAa,CACvC,CAAC;AACJ,CAAC;AAED,SAAS,OAAO,CAAC,GAA6C;IAC5D,IAAI,GAAG,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;QACvB,OAAO;YACL,KAAK,EAAE,GAAG,CAAC,KAAK;YAChB,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,kBAAkB,EAAE,GAAG,CAAC,kBAAkB,IAAI,CAAC;YAC/C,MAAM,EAAE,GAAG,CAAC,MAAM;YAClB,aAAa,EAAE,GAAG,CAAC,aAAa,IAAI,CAAC;SACtC,CAAC;IACJ,CAAC;IACD,WAAW;IACX,MAAM,CAAC,GAAG,GAAG,CAAC,MAAM,CAAC;IACrB,IAAI,KAAK,GAAG,CAAC,CAAC;IACd,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,IAAI,CAAC,YAAY,SAAS,EAAE,CAAC;QAC3B,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC;QAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;IACrC,CAAC;SAAM,IAAI,cAAc,IAAI,CAAC,IAAI,OAAO,CAAC,CAAC,YAAY,KAAK,QAAQ,EAAE,CAAC;QACrE,mBAAmB;QACnB,KAAK,GAAG,CAAC,CAAC,YAAY,IAAI,CAAC,CAAC,KAAK,CAAC;QAClC,MAAM,GAAG,CAAC,CAAC,aAAa,IAAI,CAAC,CAAC,MAAM,CAAC;IACvC,CAAC;SAAM,IAAI,YAAY,IAAI,CAAC,IAAI,OAAO,CAAC,CAAC,UAAU,KAAK,QAAQ,EAAE,CAAC;QACjE,mBAAmB;QACnB,KAAK,GAAG,CAAC,CAAC,UAAU,CAAC;QAAC,MAAM,GAAG,CAAC,CAAC,WAAW,CAAC;IAC/C,CAAC;SAAM,CAAC;QACN,0EAA0E;QAC1E,KAAK,GAAI,CAAuB,CAAC,KAAK,CAAC;QACvC,MAAM,GAAI,CAAwB,CAAC,MAAM,CAAC;IAC5C,CAAC;IACD,MAAM,YAAY,GAAG,GAAG,CAAC,YAAY,KAAK,IAAI,CAAC;IAC/C,OAAO;QACL,KAAK,EAAE,MAAM,EAAE,kBAAkB,EAAE,CAAC;QACpC,MAAM,EAAE,GAAG,CAAC,MAAM,IAAI,YAAY;QAClC,aAAa,EAAE,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;KAC1D,CAAC;AACJ,CAAC;AAED,SAAS,QAAQ,CAAC,CAAS,EAAE,CAAS;IACpC,OAAO,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC;AACnD,CAAC;AAED,MAAM,eAAgB,SAAQ,gBAA4B;IAKrC;IACA;IACA;IANX,MAAM,GAA2B,SAAS,CAAC;IAC3C,UAAU,GAA0B,SAAS,CAAC;IAEtD,YACmB,MAAiB,EACjB,MAAsB,EACtB,IAAmC;QAEpD,KAAK,EAAE,CAAC;QAJS,WAAM,GAAN,MAAM,CAAW;QACjB,WAAM,GAAN,MAAM,CAAgB;QACtB,SAAI,GAAJ,IAAI,CAA+B;IAGtD,CAAC;IAES,MAAM,KAAW,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAE3C,OAAO;QACf,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;YAC9B,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACtB,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;YACxB,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;QAC9B,CAAC;QACD,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC1B,CAAC;IAEQ,OAAO,CAAC,KAAoB;QACnC,MAAM,GAAG,GAAG,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QACxC,IAAI,GAAG,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;YACvB,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;gBAC9B,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;gBACtB,IAAI,CAAC,MAAM,GAAG,SAAS,CAAC;gBACxB,IAAI,CAAC,UAAU,GAAG,SAAS,CAAC;YAC9B,CAAC;YACD,OAAO,GAAG,CAAC,OAAO,CAAC;QACrB,CAAC;QACD,MAAM,IAAI,GAAG,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;QACjC,MAAM,KAAK,GACT,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,CAAC;cACpB,YAAY,CAAC,QAAQ;cACrB,YAAY,CAAC,eAAe;cAC5B,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,YAAY,CAAC,iBAAiB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC1E,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS,IAAI,IAAI,CAAC,UAAU,KAAK,SAAS,IAAI,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,EAAE,IAAI,CAAC,EAAE,CAAC;YACrG,IAAI,IAAI,CAAC,MAAM,KAAK,SAAS;gBAAE,IAAI,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;YACrD,MAAM,KAAK,GAAyB;gBAClC,IAAI,EAAE,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,kBAAkB,EAAE,IAAI,CAAC,kBAAkB,EAAE;gBAC7F,MAAM,EAAE,IAAI,CAAC,MAAM;gBACnB,aAAa,EAAE,IAAI,CAAC,aAAa;gBACjC,KAAK;gBACL,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACrE,CAAC;YACF,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,KAAK,CAAC,CAAC;YAC/C,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC;QACzB,CAAC;QACD,IAAI,GAAG,CAAC,MAAM,CAAC,IAAI,KAAK,KAAK,EAAE,CAAC;YAC9B,SAAS,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;QAClD,CAAC;aAAM,CAAC;YACN,cAAc,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,MAAM,CAAC,CAAC;QACvD,CAAC;QACD,OAAO,IAAI,CAAC,MAAM,CAAC;IACrB,CAAC;CACF;AAED,SAAS,SAAS,CAAC,MAAiB,EAAE,GAAe,EAAE,GAAqB;IAC1E,MAAM,KAAK,GAAG,GAAG,CAAC,IAAI,YAAY,WAAW,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,IAAI,CAAC,UAAU,EAAE,GAAG,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;IACrJ,MAAM,KAAK,GAAG,YAAY,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC;IACvC,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;IACxD,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,MAAM,GAAG,KAAK,CAAC,MAAM,CAAC,CAAC;IAC1D,MAAM,CAAC,KAAK,CAAC,YAAY,CACvB,EAAE,OAAO,EAAE,GAAG,EAAE,EAChB,KAA8C,EAC9C,EAAE,WAAW,EAAE,YAAY,GAAG,KAAK,CAAC,aAAa,EAAE,YAAY,EAAE,YAAY,EAAE,EAC/E,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,kBAAkB,EAAE,GAAG,CAAC,kBAAkB,IAAI,CAAC,EAAE,CAC1F,CAAC;AACJ,CAAC;AAED,SAAS,cAAc,CAAC,MAAiB,EAAE,GAAe,EAAE,GAA0B;IACpF,MAAM,CAAC,KAAK,CAAC,0BAA0B,CACrC,EAAE,MAAM,EAAE,GAAG,CAAC,MAAyC,EAAE,EACzD,EAAE,OAAO,EAAE,GAAG,EAAE,EAChB,EAAE,KAAK,EAAG,GAAG,CAAC,MAA4B,CAAC,KAAK,EAAE,MAAM,EAAG,GAAG,CAAC,MAA6B,CAAC,MAAM,EAAE,kBAAkB,EAAE,CAAC,EAAE,CAC7H,CAAC;AACJ,CAAC;AAQD;;;;;;GAMG;AACH,SAAS,YAAY,CAAC,MAAwB;IAC5C,QAAQ,MAAM,EAAE,CAAC;QACf,QAAQ;QACR,KAAK,SAAS,CAAC;QAAC,KAAK,SAAS,CAAC;QAAC,KAAK,QAAQ,CAAC;QAAC,KAAK,QAAQ;YAC1D,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,CAAC;QACnD,SAAS;QACT,KAAK,UAAU,CAAC;QAAC,KAAK,UAAU,CAAC;QAAC,KAAK,SAAS,CAAC;QAAC,KAAK,SAAS,CAAC;QACjE,KAAK,SAAS,CAAC;QAAC,KAAK,SAAS,CAAC;QAAC,KAAK,UAAU;YAC7C,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,CAAC;QACnD,SAAS;QACT,KAAK,YAAY,CAAC;QAAC,KAAK,iBAAiB,CAAC;QAAC,KAAK,YAAY,CAAC;QAC7D,KAAK,WAAW,CAAC;QAAC,KAAK,WAAW,CAAC;QACnC,KAAK,YAAY,CAAC;QAAC,KAAK,iBAAiB,CAAC;QAC1C,KAAK,cAAc,CAAC;QAAC,KAAK,aAAa,CAAC;QACxC,KAAK,eAAe,CAAC;QAAC,KAAK,cAAc,CAAC;QAC1C,KAAK,UAAU,CAAC;QAAC,KAAK,UAAU,CAAC;QAAC,KAAK,WAAW,CAAC;QACnD,KAAK,SAAS,CAAC;QAAC,KAAK,SAAS,CAAC;QAAC,KAAK,UAAU;YAC7C,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,CAAC;QACnD,SAAS;QACT,KAAK,YAAY,CAAC;QAAC,KAAK,YAAY,CAAC;QAAC,KAAK,aAAa,CAAC;QACzD,KAAK,UAAU,CAAC;QAAC,KAAK,UAAU,CAAC;QAAC,KAAK,WAAW;YAChD,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,CAAC;QACnD,UAAU;QACV,KAAK,YAAY,CAAC;QAAC,KAAK,YAAY,CAAC;QAAC,KAAK,aAAa;YACtD,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,aAAa,EAAE,EAAE,EAAE,CAAC;QAEpD,qCAAqC;QACrC,sCAAsC;QACtC,KAAK,gBAAgB,CAAC;QAAC,KAAK,qBAAqB,CAAC;QAClD,KAAK,aAAa,CAAC;QAAG,KAAK,aAAa;YACtC,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,CAAC;QACnD,KAAK,gBAAgB,CAAC;QAAC,KAAK,qBAAqB,CAAC;QAClD,KAAK,gBAAgB,CAAC;QAAC,KAAK,qBAAqB,CAAC;QAClD,KAAK,cAAc,CAAC;QAAG,KAAK,cAAc,CAAC;QAC3C,KAAK,iBAAiB,CAAC;QAAC,KAAK,gBAAgB,CAAC;QAC9C,KAAK,gBAAgB,CAAC;QAAE,KAAK,qBAAqB;YAChD,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,aAAa,EAAE,EAAE,EAAE,CAAC;QAEpD,oBAAoB;QACpB,KAAK,gBAAgB,CAAC;QAAC,KAAK,qBAAqB,CAAC;QAClD,KAAK,kBAAkB,CAAC;QAAC,KAAK,uBAAuB,CAAC;QACtD,KAAK,cAAc,CAAC;QAAE,KAAK,cAAc;YACvC,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,aAAa,EAAE,CAAC,EAAE,CAAC;QACnD,KAAK,iBAAiB,CAAC;QAAC,KAAK,sBAAsB,CAAC;QACpD,KAAK,eAAe,CAAC;QAAE,KAAK,eAAe;YACzC,OAAO,EAAE,KAAK,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,aAAa,EAAE,EAAE,EAAE,CAAC;QAEpD,kDAAkD;QAClD,KAAK,gBAAgB,CAAC;QAAG,KAAK,qBAAqB,CAAC,CAAG,OAAO,EAAE,KAAK,EAAE,CAAC,EAAG,MAAM,EAAE,CAAC,EAAG,aAAa,EAAE,EAAE,EAAE,CAAC;QAC3G,KAAK,gBAAgB,CAAC;QAAG,KAAK,qBAAqB,CAAC,CAAG,OAAO,EAAE,KAAK,EAAE,CAAC,EAAG,MAAM,EAAE,CAAC,EAAG,aAAa,EAAE,EAAE,EAAE,CAAC;QAC3G,KAAK,gBAAgB,CAAC;QAAG,KAAK,qBAAqB,CAAC,CAAG,OAAO,EAAE,KAAK,EAAE,CAAC,EAAG,MAAM,EAAE,CAAC,EAAG,aAAa,EAAE,EAAE,EAAE,CAAC;QAC3G,KAAK,gBAAgB,CAAC;QAAG,KAAK,qBAAqB,CAAC,CAAG,OAAO,EAAE,KAAK,EAAE,CAAC,EAAG,MAAM,EAAE,CAAC,EAAG,aAAa,EAAE,EAAE,EAAE,CAAC;QAC3G,KAAK,gBAAgB,CAAC;QAAG,KAAK,qBAAqB,CAAC,CAAG,OAAO,EAAE,KAAK,EAAE,CAAC,EAAG,MAAM,EAAE,CAAC,EAAG,aAAa,EAAE,EAAE,EAAE,CAAC;QAC3G,KAAK,gBAAgB,CAAC;QAAG,KAAK,qBAAqB,CAAC,CAAG,OAAO,EAAE,KAAK,EAAE,CAAC,EAAG,MAAM,EAAE,CAAC,EAAG,aAAa,EAAE,EAAE,EAAE,CAAC;QAC3G,KAAK,gBAAgB,CAAC;QAAG,KAAK,qBAAqB,CAAC,CAAG,OAAO,EAAE,KAAK,EAAE,CAAC,EAAG,MAAM,EAAE,CAAC,EAAG,aAAa,EAAE,EAAE,EAAE,CAAC;QAC3G,KAAK,gBAAgB,CAAC;QAAG,KAAK,qBAAqB,CAAC,CAAG,OAAO,EAAE,KAAK,EAAE,CAAC,EAAG,MAAM,EAAE,CAAC,EAAG,aAAa,EAAE,EAAE,EAAE,CAAC;QAC3G,KAAK,iBAAiB,CAAC;QAAE,KAAK,sBAAsB,CAAC,CAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,EAAG,aAAa,EAAE,EAAE,EAAE,CAAC;QAC3G,KAAK,iBAAiB,CAAC;QAAE,KAAK,sBAAsB,CAAC,CAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,EAAG,aAAa,EAAE,EAAE,EAAE,CAAC;QAC3G,KAAK,iBAAiB,CAAC;QAAE,KAAK,sBAAsB,CAAC,CAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,EAAG,aAAa,EAAE,EAAE,EAAE,CAAC;QAC3G,KAAK,kBAAkB,CAAC;QAAC,KAAK,uBAAuB,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,aAAa,EAAE,EAAE,EAAE,CAAC;QAC3G,KAAK,kBAAkB,CAAC;QAAC,KAAK,uBAAuB,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,aAAa,EAAE,EAAE,EAAE,CAAC;QAC3G,KAAK,kBAAkB,CAAC;QAAC,KAAK,uBAAuB,CAAC,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,EAAE,EAAE,aAAa,EAAE,EAAE,EAAE,CAAC;QAE3G;YACE,MAAM,IAAI,KAAK,CAAC,oCAAoC,MAAM,EAAE,CAAC,CAAC;IAClE,CAAC;AACH,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CACpC,MAAiB,EACjB,MAAsB,EACtB,OAAsC,EAAE;IAExC,OAAO,IAAI,eAAe,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,CAAC,CAAC;AACnD,CAAC"}

package/dist/resources/framebuffer.d.ts

@@ -0,0 +1,14 @@
+import { AdaptiveResource, type IFramebuffer } from "../core/index.js";
+import { type aval } from "@aardworx/wombat.adaptive";
+export interface FramebufferSize {
+    readonly width: number;
+    readonly height: number;
+}
+export interface AllocateFramebufferOptions {
+    /** Extra usage flags ORed into every attachment. `RENDER_ATTACHMENT` is added automatically. */
+    readonly extraUsage?: GPUTextureUsageFlags;
+    /** Optional debug-label prefix; attachment name is appended. */
+    readonly labelPrefix?: string;
+}
+export declare function allocateFramebuffer(device: GPUDevice, signature: import("../core/index.js").FramebufferSignature, size: aval<FramebufferSize>, opts?: AllocateFramebufferOptions): AdaptiveResource<IFramebuffer>;
+//# sourceMappingURL=framebuffer.d.ts.map

package/dist/resources/framebuffer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"framebuffer.d.ts","sourceRoot":"","sources":["../../src/resources/framebuffer.ts"],"names":[],"mappings":"AAeA,OAAO,EAAE,gBAAgB,EAAE,KAAK,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,EAA+B,KAAK,IAAI,EAAE,MAAM,2BAA2B,CAAC;AAGnF,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,WAAW,0BAA0B;IACzC,gGAAgG;IAChG,QAAQ,CAAC,UAAU,CAAC,EAAE,oBAAoB,CAAC;IAC3C,gEAAgE;IAChE,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B;AA8HD,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,SAAS,EACjB,SAAS,EAAE,OAAO,kBAAkB,EAAE,oBAAoB,EAC1D,IAAI,EAAE,IAAI,CAAC,eAAe,CAAC,EAC3B,IAAI,GAAE,0BAA+B,GACpC,gBAAgB,CAAC,YAAY,CAAC,CAEhC"}

package/dist/resources/framebuffer.js

@@ -0,0 +1,144 @@
+// allocateFramebuffer — `aval<{width,height}>` → `AdaptiveResource<IFramebuffer>`.
+//
+// The signature defines names + formats; the size aval drives
+// allocation. Each color attachment gets its own GPUTexture sized
+// to the current `width × height`; depth/stencil similarly. On
+// size change, all textures are torn down and reallocated.
+//
+// This is the building block for `runtime.renderTo(scene, size)`:
+//   - The render task acquires the framebuffer's resource;
+//   - Each frame, evaluates the FBO via its own AdaptiveResource
+//     pipeline, getting current views;
+//   - Encodes a render pass into those views;
+//   - Exposes the chosen color attachment as an
+//     `aval<ITexture>` so downstream samplers see live data.
+import { AdaptiveResource } from "../core/index.js";
+import { HashMap } from "@aardworx/wombat.adaptive";
+import { TextureUsage } from "./webgpuFlags.js";
+class AdaptiveFramebuffer extends AdaptiveResource {
+    device;
+    signature;
+    size;
+    opts;
+    _ownedColors = new Map();
+    _ownedResolves = new Map();
+    _ownedDepth;
+    _lastSize;
+    constructor(device, signature, size, opts) {
+        super();
+        this.device = device;
+        this.signature = signature;
+        this.size = size;
+        this.opts = opts;
+    }
+    create() { }
+    destroy() {
+        for (const t of this._ownedColors.values())
+            t.destroy();
+        this._ownedColors.clear();
+        for (const t of this._ownedResolves.values())
+            t.destroy();
+        this._ownedResolves.clear();
+        if (this._ownedDepth !== undefined) {
+            this._ownedDepth.destroy();
+            this._ownedDepth = undefined;
+        }
+        this._lastSize = undefined;
+    }
+    compute(token) {
+        const size = this.size.getValue(token);
+        if (this._lastSize === undefined
+            || this._lastSize.width !== size.width
+            || this._lastSize.height !== size.height) {
+            this.reallocate(size);
+            this._lastSize = size;
+        }
+        const msaa = this.signature.sampleCount > 1;
+        let colorViews = HashMap.empty();
+        let colorTextures = HashMap.empty();
+        let resolveViews = HashMap.empty();
+        for (const [name, tex] of this._ownedColors.entries()) {
+            colorViews = colorViews.add(name, tex.createView());
+            if (msaa) {
+                const resolve = this._ownedResolves.get(name);
+                if (resolve === undefined) {
+                    throw new Error(`framebuffer: missing resolve target for "${name}"`);
+                }
+                resolveViews = resolveViews.add(name, resolve.createView());
+                colorTextures = colorTextures.add(name, resolve);
+            }
+            else {
+                colorTextures = colorTextures.add(name, tex);
+            }
+        }
+        return {
+            signature: this.signature,
+            colors: colorViews,
+            colorTextures,
+            ...(msaa ? { resolveColors: resolveViews } : {}),
+            ...(this._ownedDepth ? { depthStencil: this._ownedDepth.createView(), depthStencilTexture: this._ownedDepth } : {}),
+            width: size.width,
+            height: size.height,
+        };
+    }
+    reallocate(size) {
+        // Destroy old.
+        for (const t of this._ownedColors.values())
+            t.destroy();
+        this._ownedColors.clear();
+        for (const t of this._ownedResolves.values())
+            t.destroy();
+        this._ownedResolves.clear();
+        if (this._ownedDepth !== undefined) {
+            this._ownedDepth.destroy();
+            this._ownedDepth = undefined;
+        }
+        const sampleCount = this.signature.sampleCount;
+        const msaa = sampleCount > 1;
+        // Multisample textures are not directly sampleable; they only
+        // serve as render attachments, with a separate single-sample
+        // resolve target carrying TEXTURE_BINDING.
+        const colorUsage = msaa
+            ? TextureUsage.RENDER_ATTACHMENT
+            : TextureUsage.RENDER_ATTACHMENT
+                | TextureUsage.TEXTURE_BINDING
+                | (this.opts.extraUsage ?? 0);
+        const resolveUsage = TextureUsage.RENDER_ATTACHMENT
+            | TextureUsage.TEXTURE_BINDING
+            | (this.opts.extraUsage ?? 0);
+        const labelPrefix = this.opts.labelPrefix ?? "fbo";
+        for (const [name, format] of this.signature.colors) {
+            const tex = this.device.createTexture({
+                size: { width: size.width, height: size.height, depthOrArrayLayers: 1 },
+                format,
+                usage: colorUsage,
+                sampleCount,
+                label: msaa ? `${labelPrefix}.${name}.msaa` : `${labelPrefix}.${name}`,
+            });
+            this._ownedColors.set(name, tex);
+            if (msaa) {
+                const resolve = this.device.createTexture({
+                    size: { width: size.width, height: size.height, depthOrArrayLayers: 1 },
+                    format,
+                    usage: resolveUsage,
+                    sampleCount: 1,
+                    label: `${labelPrefix}.${name}.resolve`,
+                });
+                this._ownedResolves.set(name, resolve);
+            }
+        }
+        if (this.signature.depthStencil !== undefined) {
+            this._ownedDepth = this.device.createTexture({
+                size: { width: size.width, height: size.height, depthOrArrayLayers: 1 },
+                format: this.signature.depthStencil.format,
+                usage: TextureUsage.RENDER_ATTACHMENT,
+                sampleCount,
+                label: `${labelPrefix}.depthStencil`,
+            });
+        }
+    }
+}
+export function allocateFramebuffer(device, signature, size, opts = {}) {
+    return new AdaptiveFramebuffer(device, signature, size, opts);
+}
+//# sourceMappingURL=framebuffer.js.map