@aardworx/wombat.rendering 0.1.0 → 0.1.1

package/dist/core/framebuffer.d.ts

@@ -0,0 +1,32 @@
+import type { HashMap } from "@aardworx/wombat.adaptive";
+import type { FramebufferSignature } from "./framebufferSignature.js";
+export interface IFramebuffer {
+    readonly signature: FramebufferSignature;
+    /**
+     * name → color attachment view used inside the render pass.
+     * For `sampleCount > 1` these are views into the multisample
+     * textures; the resolve target views live in `resolveColors`.
+     */
+    readonly colors: HashMap<string, GPUTextureView>;
+    readonly depthStencil?: GPUTextureView;
+    /**
+     * Underlying GPU textures suitable for *sampling* downstream.
+     * - `sampleCount = 1`: same textures as `colors`.
+     * - `sampleCount > 1`: the resolve textures (single-sample);
+     *   the multisample textures are not sampleable.
+     * Populated by `allocateFramebuffer`; used by `renderTo` to
+     * expose results as `ITexture.fromGPU(...)`.
+     */
+    readonly colorTextures?: HashMap<string, GPUTexture>;
+    /**
+     * name → resolve target view, only present when
+     * `signature.sampleCount > 1`. Wired into the render pass
+     * descriptor as `resolveTarget` so the GPU resolves
+     * multisample → single-sample at end of pass.
+     */
+    readonly resolveColors?: HashMap<string, GPUTextureView>;
+    readonly depthStencilTexture?: GPUTexture;
+    readonly width: number;
+    readonly height: number;
+}
+//# sourceMappingURL=framebuffer.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"framebuffer.d.ts","sourceRoot":"","sources":["../../src/core/framebuffer.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AACzD,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2BAA2B,CAAC;AAEtE,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,SAAS,EAAE,oBAAoB,CAAC;IACzC;;;;OAIG;IACH,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACjD,QAAQ,CAAC,YAAY,CAAC,EAAE,cAAc,CAAC;IACvC;;;;;;;OAOG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IACrD;;;;;OAKG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC,MAAM,EAAE,cAAc,CAAC,CAAC;IACzD,QAAQ,CAAC,mBAAmB,CAAC,EAAE,UAAU,CAAC;IAC1C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB"}

package/dist/core/framebuffer.js

@@ -0,0 +1,6 @@
+// IFramebuffer — a concrete render target. The signature describes
+// the *shape*; the framebuffer pairs that shape with concrete
+// texture views. Both color and depth/stencil views are addressed
+// by the same names declared in the signature.
+export {};
+//# sourceMappingURL=framebuffer.js.map

package/dist/core/framebuffer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"framebuffer.js","sourceRoot":"","sources":["../../src/core/framebuffer.ts"],"names":[],"mappings":"AAAA,mEAAmE;AACnE,8DAA8D;AAC9D,kEAAkE;AAClE,+CAA+C"}

package/dist/core/framebufferSignature.d.ts

@@ -0,0 +1,12 @@
+import type { HashMap } from "@aardworx/wombat.adaptive";
+export interface DepthStencilAttachmentSignature {
+    readonly format: GPUTextureFormat;
+    readonly hasDepth: boolean;
+    readonly hasStencil: boolean;
+}
+export interface FramebufferSignature {
+    readonly colors: HashMap<string, GPUTextureFormat>;
+    readonly depthStencil?: DepthStencilAttachmentSignature;
+    readonly sampleCount: number;
+}
+//# sourceMappingURL=framebufferSignature.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"framebufferSignature.d.ts","sourceRoot":"","sources":["../../src/core/framebufferSignature.ts"],"names":[],"mappings":"AAMA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAEzD,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,MAAM,EAAE,gBAAgB,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,OAAO,CAAC;CAC9B;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IACnD,QAAQ,CAAC,YAAY,CAAC,EAAE,+BAA+B,CAAC;IACxD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B"}

package/dist/core/framebufferSignature.js

@@ -0,0 +1,7 @@
+// FramebufferSignature — the typed shape of a render target.
+// Attachments are addressed by name (never by index). The runtime
+// maps names → WebGPU attachment slots using a shader's
+// ProgramInterface, so users only ever talk about names like
+// "albedo" / "normal" / "objectId", not location indices.
+export {};
+//# sourceMappingURL=framebufferSignature.js.map

package/dist/core/framebufferSignature.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"framebufferSignature.js","sourceRoot":"","sources":["../../src/core/framebufferSignature.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,kEAAkE;AAClE,wDAAwD;AACxD,6DAA6D;AAC7D,0DAA0D"}

package/dist/core/index.d.ts

@@ -0,0 +1,20 @@
+export { IBuffer, } from "./buffer.js";
+export type { HostBufferSource, } from "./buffer.js";
+export type { BufferView, } from "./bufferView.js";
+export type { ClearColor, ClearValues, } from "./clear.js";
+export type { Command, CopySpec, BufferCopy, TextureCopy, BufferCopyRange, } from "./command.js";
+export type { DrawCall, IndexedDrawCall, NonIndexedDrawCall, } from "./drawCall.js";
+export type { IFramebuffer, } from "./framebuffer.js";
+export type { DepthStencilAttachmentSignature, FramebufferSignature, } from "./framebufferSignature.js";
+export type { BlendComponentState, BlendState, CullMode, DepthState, FrontFace, PipelineState, RasterizerState, StencilFaceState, StencilState, Topology, } from "./pipelineState.js";
+export type { RenderObject, } from "./renderObject.js";
+export { RenderTree, } from "./renderTree.js";
+export type { IRenderTask, } from "./renderTask.js";
+export { ISampler, } from "./sampler.js";
+export { ITexture, } from "./texture.js";
+export type { ExternalTextureSource, HostTextureSource, RawTextureSource, } from "./texture.js";
+export type { AttributeInfo, CompiledEffect, CompiledStage, ComputeShader, Effect, HoleGetter, HoleGetters, LooseUniformInfo, OutputInfo, ProgramInterface, SamplerInfo, Stage, StageInfo, StorageBufferInfo, Target, TextureInfo, UniformBlockInfo, UniformFieldInfo, } from "./shader.js";
+export { AdaptiveResource, } from "./adaptiveResource.js";
+export { tryAcquire, tryRelease, } from "./acquire.js";
+export { RenderContext, } from "./renderContext.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAMA,OAAO,EACL,OAAO,GACR,MAAM,aAAa,CAAC;AACrB,YAAY,EACV,gBAAgB,GACjB,MAAM,aAAa,CAAC;AAErB,YAAY,EACV,UAAU,GACX,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EACV,UAAU,EACV,WAAW,GACZ,MAAM,YAAY,CAAC;AAEpB,YAAY,EACV,OAAO,EACP,QAAQ,EACR,UAAU,EACV,WAAW,EACX,eAAe,GAChB,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,QAAQ,EACR,eAAe,EACf,kBAAkB,GACnB,MAAM,eAAe,CAAC;AAEvB,YAAY,EACV,YAAY,GACb,MAAM,kBAAkB,CAAC;AAE1B,YAAY,EACV,+BAA+B,EAC/B,oBAAoB,GACrB,MAAM,2BAA2B,CAAC;AAEnC,YAAY,EACV,mBAAmB,EACnB,UAAU,EACV,QAAQ,EACR,UAAU,EACV,SAAS,EACT,aAAa,EACb,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,QAAQ,GACT,MAAM,oBAAoB,CAAC;AAE5B,YAAY,EACV,YAAY,GACb,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,UAAU,GACX,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EACV,WAAW,GACZ,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,QAAQ,GACT,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,QAAQ,GACT,MAAM,cAAc,CAAC;AACtB,YAAY,EACV,qBAAqB,EACrB,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,cAAc,CAAC;AAEtB,YAAY,EACV,aAAa,EACb,cAAc,EACd,aAAa,EACb,aAAa,EACb,MAAM,EACN,UAAU,EACV,WAAW,EACX,gBAAgB,EAChB,UAAU,EACV,gBAAgB,EAChB,WAAW,EACX,KAAK,EACL,SAAS,EACT,iBAAiB,EACjB,MAAM,EACN,WAAW,EACX,gBAAgB,EAChB,gBAAgB,GACjB,MAAM,aAAa,CAAC;AAErB,OAAO,EACL,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,UAAU,EACV,UAAU,GACX,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,aAAa,GACd,MAAM,oBAAoB,CAAC"}

package/dist/core/index.js

@@ -0,0 +1,13 @@
+// Public API of @aardworx/wombat.rendering-core.
+//
+// Phase 0: types only. Implementations of `compileEffect`,
+// `prepareRenderObject`, `runRenderTask`, etc. live in higher
+// packages (`resources`, `commands`, `runtime`).
+export { IBuffer, } from "./buffer.js";
+export { RenderTree, } from "./renderTree.js";
+export { ISampler, } from "./sampler.js";
+export { ITexture, } from "./texture.js";
+export { AdaptiveResource, } from "./adaptiveResource.js";
+export { tryAcquire, tryRelease, } from "./acquire.js";
+export { RenderContext, } from "./renderContext.js";
+//# sourceMappingURL=index.js.map

package/dist/core/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/core/index.ts"],"names":[],"mappings":"AAAA,iDAAiD;AACjD,EAAE;AACF,2DAA2D;AAC3D,8DAA8D;AAC9D,iDAAiD;AAEjD,OAAO,EACL,OAAO,GACR,MAAM,aAAa,CAAC;AAsDrB,OAAO,EACL,UAAU,GACX,MAAM,iBAAiB,CAAC;AAMzB,OAAO,EACL,QAAQ,GACT,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,QAAQ,GACT,MAAM,cAAc,CAAC;AA4BtB,OAAO,EACL,gBAAgB,GACjB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACL,UAAU,EACV,UAAU,GACX,MAAM,cAAc,CAAC;AAEtB,OAAO,EACL,aAAa,GACd,MAAM,oBAAoB,CAAC"}

package/dist/core/pipelineState.d.ts

@@ -0,0 +1,56 @@
+import type { HashMap } from "@aardworx/wombat.adaptive";
+export type CullMode = "none" | "front" | "back";
+export type FrontFace = "ccw" | "cw";
+export type Topology = GPUPrimitiveTopology;
+export interface RasterizerState {
+    readonly topology: Topology;
+    readonly cullMode: CullMode;
+    readonly frontFace: FrontFace;
+    /** "none" disables polygon offset. */
+    readonly depthBias?: {
+        readonly constant: number;
+        readonly slopeScale: number;
+        readonly clamp: number;
+    };
+}
+export interface DepthState {
+    readonly write: boolean;
+    readonly compare: GPUCompareFunction;
+}
+export interface StencilFaceState {
+    readonly compare: GPUCompareFunction;
+    readonly failOp: GPUStencilOperation;
+    readonly depthFailOp: GPUStencilOperation;
+    readonly passOp: GPUStencilOperation;
+}
+export interface StencilState {
+    readonly readMask: number;
+    readonly writeMask: number;
+    readonly front: StencilFaceState;
+    readonly back: StencilFaceState;
+}
+export interface BlendComponentState {
+    readonly operation: GPUBlendOperation;
+    readonly srcFactor: GPUBlendFactor;
+    readonly dstFactor: GPUBlendFactor;
+}
+export interface BlendState {
+    readonly color: BlendComponentState;
+    readonly alpha: BlendComponentState;
+    /** RGBA channel write mask (bitmask: R=1, G=2, B=4, A=8). */
+    readonly writeMask: number;
+}
+export interface PipelineState {
+    readonly rasterizer: RasterizerState;
+    readonly depth?: DepthState;
+    readonly stencil?: StencilState;
+    /**
+     * Per-color-attachment blend state, keyed by the attachment name
+     * from the `FramebufferSignature`. Missing entries default to
+     * "no blending, write all channels".
+     */
+    readonly blends?: HashMap<string, BlendState>;
+    /** Multi-sample alpha-to-coverage. Default `false`. */
+    readonly alphaToCoverage?: boolean;
+}
+//# sourceMappingURL=pipelineState.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"pipelineState.d.ts","sourceRoot":"","sources":["../../src/core/pipelineState.ts"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,2BAA2B,CAAC;AAEzD,MAAM,MAAM,QAAQ,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,CAAC;AACjD,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,IAAI,CAAC;AACrC,MAAM,MAAM,QAAQ,GAAG,oBAAoB,CAAC;AAE5C,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,sCAAsC;IACtC,QAAQ,CAAC,SAAS,CAAC,EAAE;QAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;CACzG;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAC;IACxB,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC;CACtC;AAED,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC;IACrC,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;IACrC,QAAQ,CAAC,WAAW,EAAE,mBAAmB,CAAC;IAC1C,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;CACtC;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,gBAAgB,CAAC;IACjC,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;CACjC;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC;IACtC,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,cAAc,CAAC;CACpC;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAC;IACpC,QAAQ,CAAC,KAAK,EAAE,mBAAmB,CAAC;IACpC,6DAA6D;IAC7D,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC;IACrC,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,OAAO,CAAC,EAAE,YAAY,CAAC;IAChC;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC,MAAM,EAAE,UAAU,CAAC,CAAC;IAC9C,uDAAuD;IACvD,QAAQ,CAAC,eAAe,CAAC,EAAE,OAAO,CAAC;CACpC"}

package/dist/core/pipelineState.js

@@ -0,0 +1,6 @@
+// PipelineState — the fixed-function bits the user picks per
+// RenderObject. Vertex layout, blending, depth/stencil, raster.
+// Combined with a CompiledEffect + FramebufferSignature this is
+// enough to bake a GPURenderPipeline.
+export {};
+//# sourceMappingURL=pipelineState.js.map

package/dist/core/pipelineState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipelineState.js","sourceRoot":"","sources":["../../src/core/pipelineState.ts"],"names":[],"mappings":"AAAA,6DAA6D;AAC7D,gEAAgE;AAChE,gEAAgE;AAChE,sCAAsC"}

package/dist/core/renderContext.d.ts

@@ -0,0 +1,8 @@
+interface RenderContextSlot {
+    encoder: GPUCommandEncoder | null;
+    withEncoder<R>(encoder: GPUCommandEncoder, fn: () => R): R;
+    requireEncoder(): GPUCommandEncoder;
+}
+export declare const RenderContext: RenderContextSlot;
+export {};
+//# sourceMappingURL=renderContext.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"renderContext.d.ts","sourceRoot":"","sources":["../../src/core/renderContext.ts"],"names":[],"mappings":"AAUA,UAAU,iBAAiB;IACzB,OAAO,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAClC,WAAW,CAAC,CAAC,EAAE,OAAO,EAAE,iBAAiB,EAAE,EAAE,EAAE,MAAM,CAAC,GAAG,CAAC,CAAC;IAC3D,cAAc,IAAI,iBAAiB,CAAC;CACrC;AAED,eAAO,MAAM,aAAa,EAAE,iBA+B3B,CAAC"}

package/dist/core/renderContext.js

@@ -0,0 +1,39 @@
+// RenderContext — ambient state available to AdaptiveResources
+// during evaluation. The runtime sets `encoder` before walking a
+// task's resources so that `compute(token)` calls inside an
+// AdaptiveResource can encode commands (uploads, compute passes,
+// render-to-texture) onto the current frame's encoder.
+//
+// Outside a frame (`encoder === null`) AdaptiveResources should
+// either return their cached handle or throw — they cannot do
+// GPU work without an encoder.
+export const RenderContext = {
+    encoder: null,
+    /**
+     * Run `fn` with `encoder` exposed as the current frame encoder.
+     * Restores the previous value on exit. Nestable.
+     */
+    withEncoder(encoder, fn) {
+        const prev = RenderContext.encoder;
+        RenderContext.encoder = encoder;
+        try {
+            return fn();
+        }
+        finally {
+            RenderContext.encoder = prev;
+        }
+    },
+    /**
+     * Convenience: throws if no encoder is active. Use inside
+     * `compute(token)` of an AdaptiveResource that genuinely needs
+     * to encode work.
+     */
+    requireEncoder() {
+        if (RenderContext.encoder === null) {
+            throw new Error("RenderContext: no active encoder. AdaptiveResource.compute() " +
+                "was called outside RenderContext.withEncoder(...).");
+        }
+        return RenderContext.encoder;
+    },
+};
+//# sourceMappingURL=renderContext.js.map

package/dist/core/renderContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderContext.js","sourceRoot":"","sources":["../../src/core/renderContext.ts"],"names":[],"mappings":"AAAA,+DAA+D;AAC/D,iEAAiE;AACjE,4DAA4D;AAC5D,iEAAiE;AACjE,uDAAuD;AACvD,EAAE;AACF,gEAAgE;AAChE,8DAA8D;AAC9D,+BAA+B;AAQ/B,MAAM,CAAC,MAAM,aAAa,GAAsB;IAC9C,OAAO,EAAE,IAAI;IAEb;;;OAGG;IACH,WAAW,CAAI,OAA0B,EAAE,EAAW;QACpD,MAAM,IAAI,GAAG,aAAa,CAAC,OAAO,CAAC;QACnC,aAAa,CAAC,OAAO,GAAG,OAAO,CAAC;QAChC,IAAI,CAAC;YACH,OAAO,EAAE,EAAE,CAAC;QACd,CAAC;gBAAS,CAAC;YACT,aAAa,CAAC,OAAO,GAAG,IAAI,CAAC;QAC/B,CAAC;IACH,CAAC;IAED;;;;OAIG;IACH,cAAc;QACZ,IAAI,aAAa,CAAC,OAAO,KAAK,IAAI,EAAE,CAAC;YACnC,MAAM,IAAI,KAAK,CACb,+DAA+D;gBAC/D,oDAAoD,CACrD,CAAC;QACJ,CAAC;QACD,OAAO,aAAa,CAAC,OAAO,CAAC;IAC/B,CAAC;CACF,CAAC"}

package/dist/core/renderObject.d.ts

@@ -0,0 +1,45 @@
+import type { HashMap, aval } from "@aardworx/wombat.adaptive";
+import type { IBuffer } from "./buffer.js";
+import type { BufferView } from "./bufferView.js";
+import type { DrawCall } from "./drawCall.js";
+import type { ISampler } from "./sampler.js";
+import type { ITexture } from "./texture.js";
+import type { PipelineState } from "./pipelineState.js";
+import type { Effect } from "./shader.js";
+export interface RenderObject {
+    /**
+     * A wombat.shader `Effect` — produced by the `vertex(...) /
+     * fragment(...) / effect(...)` markers (transformed at build
+     * time by `@aardworx/wombat.shader-vite`) or hand-built via
+     * `stage(module, ...)`. The runtime calls
+     * `effect.compile({ target: "wgsl" })` (Effect's own
+     * hole-value-keyed cache makes this free per frame).
+     *
+     * `Effect.id` (stable build-time hash) feeds the pipeline cache
+     * key, which means renaming a captured value invalidates only
+     * its specialization; everything else stays cached.
+     *
+     * For users with a precompiled `CompiledEffect` (e.g. from
+     * `compileShaderSource(...)`), wrap it with the test helper
+     * `fakeEffectFromCompiled` or call `stage(module)` to produce
+     * a real Effect.
+     */
+    readonly effect: Effect;
+    readonly pipelineState: PipelineState;
+    /** name → vertex buffer view; e.g. "position", "normal", "uv". */
+    readonly vertexAttributes: HashMap<string, aval<BufferView>>;
+    /** name → instance buffer view; e.g. "modelMatrix", "instanceColor". */
+    readonly instanceAttributes?: HashMap<string, aval<BufferView>>;
+    /** name → uniform value; runtime packs into UBO based on shader layout. */
+    readonly uniforms: HashMap<string, aval<unknown>>;
+    /** name → texture source (CPU image or pre-built GPUTexture). */
+    readonly textures: HashMap<string, aval<ITexture>>;
+    /** name → sampler source (descriptor or pre-built GPUSampler). */
+    readonly samplers: HashMap<string, aval<ISampler>>;
+    /** name → storage buffer source. */
+    readonly storageBuffers?: HashMap<string, aval<IBuffer>>;
+    /** Index buffer for indexed draws. */
+    readonly indices?: aval<BufferView>;
+    readonly drawCall: aval<DrawCall>;
+}
+//# sourceMappingURL=renderObject.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"renderObject.d.ts","sourceRoot":"","sources":["../../src/core/renderObject.ts"],"names":[],"mappings":"AAUA,OAAO,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,aAAa,CAAC;AAC3C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,iBAAiB,CAAC;AAClD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,cAAc,CAAC;AAC7C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,WAAW,YAAY;IAC3B;;;;;;;;;;;;;;;;OAgBG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IAEtC,kEAAkE;IAClE,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;IAC7D,wEAAwE;IACxE,QAAQ,CAAC,kBAAkB,CAAC,EAAE,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;IAChE,2EAA2E;IAC3E,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAClD,iEAAiE;IACjE,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IACnD,kEAAkE;IAClE,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC;IACnD,oCAAoC;IACpC,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC,CAAC;IAEzD,sCAAsC;IACtC,QAAQ,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,UAAU,CAAC,CAAC;IACpC,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;CACnC"}

package/dist/core/renderObject.js

@@ -0,0 +1,11 @@
+// RenderObject — the user-facing primitive: an effect + a bag of
+// named inputs + a draw call. Names are matched against the
+// shader's ProgramInterface during preparation; extras are
+// silently ignored, missing required bindings are an error.
+//
+// Every input is `aval<T>` over a *source* type (IBuffer, ITexture,
+// ISampler, …). The runtime (resources package) wraps these into
+// internal AdaptiveResources for upload + ref-counting; the user
+// never instantiates an AdaptiveResource directly.
+export {};
+//# sourceMappingURL=renderObject.js.map

package/dist/core/renderObject.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderObject.js","sourceRoot":"","sources":["../../src/core/renderObject.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,4DAA4D;AAC5D,2DAA2D;AAC3D,4DAA4D;AAC5D,EAAE;AACF,oEAAoE;AACpE,iEAAiE;AACjE,iEAAiE;AACjE,mDAAmD"}

package/dist/core/renderTask.d.ts

@@ -0,0 +1,12 @@
+import type { AdaptiveToken } from "@aardworx/wombat.adaptive";
+export interface IRenderTask {
+    /**
+     * Encode all commands into the GPU queue using the current
+     * adaptive state read via `token`. Returns once submission has
+     * been queued (does not wait for GPU completion).
+     */
+    run(token: AdaptiveToken): void;
+    /** Tear down resources owned by the task. Idempotent. */
+    dispose(): void;
+}
+//# sourceMappingURL=renderTask.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"renderTask.d.ts","sourceRoot":"","sources":["../../src/core/renderTask.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,2BAA2B,CAAC;AAE/D,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,GAAG,CAAC,KAAK,EAAE,aAAa,GAAG,IAAI,CAAC;IAEhC,yDAAyD;IACzD,OAAO,IAAI,IAAI,CAAC;CACjB"}

package/dist/core/renderTask.js

@@ -0,0 +1,5 @@
+// RenderTask — the compiled, runnable form of an alist<Command>.
+// The runtime returns one of these from `compile`; the user calls
+// `run(token)` to encode + submit a frame.
+export {};
+//# sourceMappingURL=renderTask.js.map

package/dist/core/renderTask.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderTask.js","sourceRoot":"","sources":["../../src/core/renderTask.ts"],"names":[],"mappings":"AAAA,iEAAiE;AACjE,kEAAkE;AAClE,2CAA2C"}

package/dist/core/renderTree.d.ts

@@ -0,0 +1,35 @@
+import type { aval, alist, aset } from "@aardworx/wombat.adaptive";
+import type { RenderObject } from "./renderObject.js";
+export type RenderTree = {
+    readonly kind: "Empty";
+} | {
+    readonly kind: "Leaf";
+    readonly object: RenderObject;
+} | {
+    readonly kind: "Ordered";
+    readonly children: readonly RenderTree[];
+} | {
+    readonly kind: "Unordered";
+    readonly children: readonly RenderTree[];
+} | {
+    readonly kind: "Adaptive";
+    readonly tree: aval<RenderTree>;
+} | {
+    readonly kind: "OrderedFromList";
+    readonly children: alist<RenderTree>;
+} | {
+    readonly kind: "UnorderedFromSet";
+    readonly children: aset<RenderTree>;
+};
+export declare const RenderTree: {
+    readonly empty: {
+        readonly kind: "Empty";
+    };
+    readonly leaf: (object: RenderObject) => RenderTree;
+    readonly ordered: (...children: RenderTree[]) => RenderTree;
+    readonly unordered: (...children: RenderTree[]) => RenderTree;
+    readonly adaptive: (tree: aval<RenderTree>) => RenderTree;
+    readonly orderedFromList: (children: alist<RenderTree>) => RenderTree;
+    readonly unorderedFromSet: (children: aset<RenderTree>) => RenderTree;
+};
+//# sourceMappingURL=renderTree.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"renderTree.d.ts","sourceRoot":"","sources":["../../src/core/renderTree.ts"],"names":[],"mappings":"AAQA,OAAO,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AAEtD,MAAM,MAAM,UAAU,GAClB;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;CAAE,GAC1B;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAA;CAAE,GACxD;IAAE,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,SAAS,UAAU,EAAE,CAAA;CAAE,GACtE;IAAE,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,SAAS,UAAU,EAAE,CAAA;CAAE,GACxE;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC,UAAU,CAAC,CAAA;CAAE,GAC9D;IAAE,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,KAAK,CAAC,UAAU,CAAC,CAAA;CAAE,GAC1E;IAAE,QAAQ,CAAC,IAAI,EAAE,kBAAkB,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC,UAAU,CAAC,CAAA;CAAE,CAAC;AAE/E,eAAO,MAAM,UAAU;;;;4BAEN,YAAY,KAAG,UAAU;oCACjB,UAAU,EAAE,KAAG,UAAU;sCACvB,UAAU,EAAE,KAAG,UAAU;8BACjC,IAAI,CAAC,UAAU,CAAC,KAAG,UAAU;yCAClB,KAAK,CAAC,UAAU,CAAC,KAAG,UAAU;0CAC7B,IAAI,CAAC,UAAU,CAAC,KAAG,UAAU;CAClD,CAAC"}

package/dist/core/renderTree.js

@@ -0,0 +1,17 @@
+// RenderTree — intra-pass ordering structure for RenderObjects.
+//
+// `Ordered` children execute left-to-right; `Unordered` children
+// can be reordered by the backend to minimise pipeline / bind-
+// group / vertex-buffer state changes. The Adaptive variants
+// fold reactive containers (alist, aset, aval) directly into the
+// tree.
+export const RenderTree = {
+    empty: { kind: "Empty" },
+    leaf: (object) => ({ kind: "Leaf", object }),
+    ordered: (...children) => ({ kind: "Ordered", children }),
+    unordered: (...children) => ({ kind: "Unordered", children }),
+    adaptive: (tree) => ({ kind: "Adaptive", tree }),
+    orderedFromList: (children) => ({ kind: "OrderedFromList", children }),
+    unorderedFromSet: (children) => ({ kind: "UnorderedFromSet", children }),
+};
+//# sourceMappingURL=renderTree.js.map

package/dist/core/renderTree.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"renderTree.js","sourceRoot":"","sources":["../../src/core/renderTree.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,EAAE;AACF,iEAAiE;AACjE,+DAA+D;AAC/D,6DAA6D;AAC7D,iEAAiE;AACjE,QAAQ;AAcR,MAAM,CAAC,MAAM,UAAU,GAAG;IACxB,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAgC;IACtD,IAAI,EAAE,CAAC,MAAoB,EAAc,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;IACtE,OAAO,EAAE,CAAC,GAAG,QAAsB,EAAc,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,CAAC;IACnF,SAAS,EAAE,CAAC,GAAG,QAAsB,EAAc,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,EAAE,CAAC;IACvF,QAAQ,EAAE,CAAC,IAAsB,EAAc,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;IAC9E,eAAe,EAAE,CAAC,QAA2B,EAAc,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,iBAAiB,EAAE,QAAQ,EAAE,CAAC;IACrG,gBAAgB,EAAE,CAAC,QAA0B,EAAc,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,kBAAkB,EAAE,QAAQ,EAAE,CAAC;CAC9F,CAAC"}

package/dist/core/sampler.d.ts

@@ -0,0 +1,12 @@
+export type ISampler = {
+    readonly kind: "gpu";
+    readonly sampler: GPUSampler;
+} | {
+    readonly kind: "desc";
+    readonly descriptor: GPUSamplerDescriptor;
+};
+export declare const ISampler: {
+    readonly fromGPU: (sampler: GPUSampler) => ISampler;
+    readonly fromDescriptor: (descriptor: GPUSamplerDescriptor) => ISampler;
+};
+//# sourceMappingURL=sampler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"sampler.d.ts","sourceRoot":"","sources":["../../src/core/sampler.ts"],"names":[],"mappings":"AAIA,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,UAAU,EAAE,oBAAoB,CAAA;CAAE,CAAC;AAEzE,eAAO,MAAM,QAAQ;gCACF,UAAU,KAAG,QAAQ;0CACX,oBAAoB,KAAG,QAAQ;CAClD,CAAC"}

package/dist/core/sampler.js

@@ -0,0 +1,8 @@
+// ISampler — sampler source. Either a pre-built `GPUSampler` or a
+// descriptor for the runtime to materialise (samplers are cheap
+// and dedupable, so descriptors are the common path).
+export const ISampler = {
+    fromGPU(sampler) { return { kind: "gpu", sampler }; },
+    fromDescriptor(descriptor) { return { kind: "desc", descriptor }; },
+};
+//# sourceMappingURL=sampler.js.map

package/dist/core/sampler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sampler.js","sourceRoot":"","sources":["../../src/core/sampler.ts"],"names":[],"mappings":"AAAA,kEAAkE;AAClE,gEAAgE;AAChE,sDAAsD;AAMtD,MAAM,CAAC,MAAM,QAAQ,GAAG;IACtB,OAAO,CAAC,OAAmB,IAAc,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC;IAC3E,cAAc,CAAC,UAAgC,IAAc,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC;CAC3F,CAAC"}

package/dist/core/shader.d.ts

@@ -0,0 +1,3 @@
+export type { Effect, ComputeShader, Stage, HoleGetter, HoleGetters, CompiledEffect, CompiledStage, Target, } from "@aardworx/wombat.shader";
+export type { ProgramInterface, StageInfo, AttributeInfo, OutputInfo, LooseUniformInfo, UniformBlockInfo, UniformFieldInfo, SamplerInfo, TextureInfo, StorageBufferInfo, } from "@aardworx/wombat.shader";
+//# sourceMappingURL=shader.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"shader.d.ts","sourceRoot":"","sources":["../../src/core/shader.ts"],"names":[],"mappings":"AAKA,YAAY,EACV,MAAM,EACN,aAAa,EACb,KAAK,EACL,UAAU,EACV,WAAW,EACX,cAAc,EACd,aAAa,EACb,MAAM,GACP,MAAM,yBAAyB,CAAC;AAEjC,YAAY,EACV,gBAAgB,EAChB,SAAS,EACT,aAAa,EACb,UAAU,EACV,gBAAgB,EAChB,gBAAgB,EAChB,gBAAgB,EAChB,WAAW,EACX,WAAW,EACX,iBAAiB,GAClB,MAAM,yBAAyB,CAAC"}

package/dist/core/shader.js

@@ -0,0 +1,6 @@
+// Re-exports of the wombat.shader runtime types consumed by the
+// rendering layer. We do NOT duplicate or re-shape these — the
+// rendering layer is just a consumer of wombat.shader's
+// `Effect` / `CompiledEffect` / `ProgramInterface`.
+export {};
+//# sourceMappingURL=shader.js.map

package/dist/core/shader.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"shader.js","sourceRoot":"","sources":["../../src/core/shader.ts"],"names":[],"mappings":"AAAA,gEAAgE;AAChE,+DAA+D;AAC/D,wDAAwD;AACxD,oDAAoD"}

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