@aardworx/wombat.rendering 0.1.0 → 0.2.0

package/dist/core/texture.d.ts

@@ -0,0 +1,34 @@
+export interface RawTextureSource {
+    readonly kind: "raw";
+    readonly data: ArrayBuffer | ArrayBufferView;
+    readonly width: number;
+    readonly height: number;
+    readonly depthOrArrayLayers?: number;
+    readonly format: GPUTextureFormat;
+    readonly mipLevelCount?: number;
+}
+export interface ExternalTextureSource {
+    readonly kind: "external";
+    readonly source: ImageBitmap | HTMLImageElement | HTMLVideoElement | HTMLCanvasElement | OffscreenCanvas | ImageData;
+    /** Override the format the runtime should allocate (default: "rgba8unorm"). */
+    readonly format?: GPUTextureFormat;
+    /** Generate a mip chain on upload. Default `false`. */
+    readonly generateMips?: boolean;
+}
+export type HostTextureSource = RawTextureSource | ExternalTextureSource;
+export type ITexture = {
+    readonly kind: "gpu";
+    readonly texture: GPUTexture;
+} | {
+    readonly kind: "host";
+    readonly source: HostTextureSource;
+};
+export declare const ITexture: {
+    readonly fromGPU: (texture: GPUTexture) => ITexture;
+    readonly fromExternal: (source: ExternalTextureSource["source"], opts?: {
+        format?: GPUTextureFormat;
+        generateMips?: boolean;
+    }) => ITexture;
+    readonly fromRaw: (raw: Omit<RawTextureSource, "kind">) => ITexture;
+};
+//# sourceMappingURL=texture.d.ts.map

package/dist/core/texture.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"texture.d.ts","sourceRoot":"","sources":["../../src/core/texture.ts"],"names":[],"mappings":"AAYA,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE,WAAW,GAAG,eAAe,CAAC;IAC7C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAC1B,QAAQ,CAAC,MAAM,EACX,WAAW,GACX,gBAAgB,GAChB,gBAAgB,GAChB,iBAAiB,GACjB,eAAe,GACf,SAAS,CAAC;IACd,+EAA+E;IAC/E,QAAQ,CAAC,MAAM,CAAC,EAAE,gBAAgB,CAAC;IACnC,uDAAuD;IACvD,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,CAAC;CACjC;AAED,MAAM,MAAM,iBAAiB,GAAG,gBAAgB,GAAG,qBAAqB,CAAC;AAEzE,MAAM,MAAM,QAAQ,GAChB;IAAE,QAAQ,CAAC,IAAI,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAA;CAAE,GACtD;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAA;CAAE,CAAC;AAElE,eAAO,MAAM,QAAQ;gCACF,UAAU,KAAG,QAAQ;oCAI5B,qBAAqB,CAAC,QAAQ,CAAC,SACjC;QAAE,MAAM,CAAC,EAAE,gBAAgB,CAAC;QAAC,YAAY,CAAC,EAAE,OAAO,CAAA;KAAE,KAC1D,QAAQ;4BASE,IAAI,CAAC,gBAAgB,EAAE,MAAM,CAAC,KAAG,QAAQ;CAG9C,CAAC"}

package/dist/core/texture.js

@@ -0,0 +1,29 @@
+// ITexture — texture source that can be either a real GPU texture
+// or a host-side image. Mirrors the IBuffer pattern.
+//
+// Host sources cover everything WebGPU's `copyExternalImageToTexture`
+// or `writeTexture` can accept:
+//   - `ImageBitmap`, `HTMLImageElement`, `HTMLVideoElement`,
+//     `HTMLCanvasElement`, `OffscreenCanvas`, `ImageData` —
+//     uploaded via `copyExternalImageToTexture`.
+//   - Raw `{ data, width, height, format }` — uploaded via
+//     `queue.writeTexture` (one mip; runtime can synthesise the
+//     rest if requested).
+export const ITexture = {
+    fromGPU(texture) {
+        return { kind: "gpu", texture };
+    },
+    fromExternal(source, opts = {}) {
+        const ext = {
+            kind: "external",
+            source,
+            ...(opts.format !== undefined ? { format: opts.format } : {}),
+            ...(opts.generateMips !== undefined ? { generateMips: opts.generateMips } : {}),
+        };
+        return { kind: "host", source: ext };
+    },
+    fromRaw(raw) {
+        return { kind: "host", source: { kind: "raw", ...raw } };
+    },
+};
+//# sourceMappingURL=texture.js.map

package/dist/core/texture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"texture.js","sourceRoot":"","sources":["../../src/core/texture.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,qDAAqD;AACrD,EAAE;AACF,sEAAsE;AACtE,gCAAgC;AAChC,6DAA6D;AAC7D,4DAA4D;AAC5D,iDAAiD;AACjD,2DAA2D;AAC3D,gEAAgE;AAChE,0BAA0B;AAiC1B,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,OAAO,CAAC,OAAmB;QACzB,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;IAClC,CAAC;IACD,YAAY,CACV,MAAuC,EACvC,OAA8D,EAAE;QAEhE,MAAM,GAAG,GAA0B;YACjC,IAAI,EAAE,UAAU;YAChB,MAAM;YACN,GAAG,CAAC,IAAI,CAAC,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YAC7D,GAAG,CAAC,IAAI,CAAC,YAAY,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SAChF,CAAC;QACF,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,CAAC;IACvC,CAAC;IACD,OAAO,CAAC,GAAmC;QACzC,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,GAAG,EAAE,EAAE,CAAC;IAC3D,CAAC;CACO,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./core/index.js";
+export * from "./resources/index.js";
+export * from "./commands/index.js";
+export * from "./runtime/index.js";
+export * from "./window/index.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAaA,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,18 @@
+// Public API of `@aardworx/wombat.rendering`.
+//
+// Default entry re-exports everything: types, resource preparers,
+// command-stream functions, runtime, and the window/canvas glue.
+// Subpath exports give granular access for advanced consumers.
+//
+//   import { ... } from "@aardworx/wombat.rendering";        // everything
+//   import { ... } from "@aardworx/wombat.rendering/core";   // types only
+//   import { ... } from "@aardworx/wombat.rendering/resources";
+//   import { ... } from "@aardworx/wombat.rendering/commands";
+//   import { ... } from "@aardworx/wombat.rendering/runtime";
+//   import { ... } from "@aardworx/wombat.rendering/window";
+export * from "./core/index.js";
+export * from "./resources/index.js";
+export * from "./commands/index.js";
+export * from "./runtime/index.js";
+export * from "./window/index.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,8CAA8C;AAC9C,EAAE;AACF,kEAAkE;AAClE,iEAAiE;AACjE,+DAA+D;AAC/D,EAAE;AACF,2EAA2E;AAC3E,2EAA2E;AAC3E,gEAAgE;AAChE,+DAA+D;AAC/D,8DAA8D;AAC9D,6DAA6D;AAE7D,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,qBAAqB,CAAC;AACpC,cAAc,oBAAoB,CAAC;AACnC,cAAc,mBAAmB,CAAC"}

package/dist/resources/adaptiveBuffer.d.ts

@@ -0,0 +1,22 @@
+import { AdaptiveResource, type IBuffer } from "../core/index.js";
+import { type aval } from "@aardworx/wombat.adaptive";
+export interface PrepareAdaptiveBufferOptions {
+    /** Bitwise OR of GPUBufferUsage flags. `COPY_DST` is added automatically when needed. */
+    readonly usage: GPUBufferUsageFlags;
+    /** Optional debug label forwarded to created GPUBuffers. */
+    readonly label?: string;
+    /**
+     * Reuse the existing GPUBuffer when the new host data fits in
+     * the current allocation. Default `true`. Set `false` to force
+     * a fresh buffer on every host-side change (rarely useful).
+     */
+    readonly reuseOnFit?: boolean;
+}
+/**
+ * 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 declare function prepareAdaptiveBuffer(device: GPUDevice, source: aval<IBuffer>, opts: PrepareAdaptiveBufferOptions): AdaptiveResource<GPUBuffer>;
+//# sourceMappingURL=adaptiveBuffer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"adaptiveBuffer.d.ts","sourceRoot":"","sources":["../../src/resources/adaptiveBuffer.ts"],"names":[],"mappings":"AAsBA,OAAO,EACL,gBAAgB,EAGhB,KAAK,OAAO,EACb,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAEL,KAAK,IAAI,EACV,MAAM,2BAA2B,CAAC;AAGnC,MAAM,WAAW,4BAA4B;IAC3C,yFAAyF;IACzF,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAC;IACpC,4DAA4D;IAC5D,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACxB;;;;OAIG;IACH,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;CAC/B;AA6ED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,SAAS,EACjB,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,EACrB,IAAI,EAAE,4BAA4B,GACjC,gBAAgB,CAAC,SAAS,CAAC,CAE7B"}

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":"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"}

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