@aardworx/wombat.rendering 0.1.0 → 0.2.0

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,21 @@
+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, DepthBiasState, DepthState, FrontFace, PlainBlendComponentState, PlainBlendState, PlainDepthState, PlainPipelineState, PlainRasterizerState, PlainStencilFaceState, PlainStencilState, RasterizerState, StencilFaceState, StencilState, Topology, } from "./pipelineState.js";
+export { PipelineState } 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,cAAc,EACd,UAAU,EACV,SAAS,EACT,wBAAwB,EACxB,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,oBAAoB,EACpB,qBAAqB,EACrB,iBAAiB,EACjB,eAAe,EACf,gBAAgB,EAChB,YAAY,EACZ,QAAQ,GACT,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,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,14 @@
+// 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 { PipelineState } from "./pipelineState.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;AAyDrB,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAMnD,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,126 @@
+import { HashMap, type aval } from "@aardworx/wombat.adaptive";
+export type CullMode = "none" | "front" | "back";
+export type FrontFace = "ccw" | "cw";
+export type Topology = GPUPrimitiveTopology;
+export interface DepthBiasState {
+    readonly constant: number;
+    readonly slopeScale: number;
+    readonly clamp: number;
+}
+export interface RasterizerState {
+    readonly topology: aval<Topology>;
+    readonly cullMode: aval<CullMode>;
+    readonly frontFace: aval<FrontFace>;
+    /** `undefined` value disables polygon offset. */
+    readonly depthBias?: aval<DepthBiasState | undefined>;
+}
+export interface DepthState {
+    readonly write: aval<boolean>;
+    readonly compare: aval<GPUCompareFunction>;
+    /** unclippedDepth — requires the WebGPU adapter feature. */
+    readonly clamp?: aval<boolean>;
+}
+export interface StencilFaceState {
+    readonly compare: aval<GPUCompareFunction>;
+    readonly failOp: aval<GPUStencilOperation>;
+    readonly depthFailOp: aval<GPUStencilOperation>;
+    readonly passOp: aval<GPUStencilOperation>;
+}
+export interface StencilState {
+    readonly enabled: aval<boolean>;
+    /** Per-frame, NOT pipeline rebuild. */
+    readonly reference: aval<number>;
+    readonly readMask: aval<number>;
+    readonly writeMask: aval<number>;
+    readonly front: StencilFaceState;
+    readonly back: StencilFaceState;
+}
+export interface BlendComponentState {
+    readonly operation: aval<GPUBlendOperation>;
+    readonly srcFactor: aval<GPUBlendFactor>;
+    readonly dstFactor: aval<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: aval<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?: aval<HashMap<string, BlendState>>;
+    /** Multi-sample alpha-to-coverage. Default `false`. */
+    readonly alphaToCoverage?: aval<boolean>;
+    /** Per-frame, not pipeline-rebuild. */
+    readonly blendConstant?: aval<{
+        r: number;
+        g: number;
+        b: number;
+        a: number;
+    }>;
+}
+export interface PlainRasterizerState {
+    readonly topology: Topology;
+    readonly cullMode: CullMode;
+    readonly frontFace: FrontFace;
+    readonly depthBias?: DepthBiasState;
+}
+export interface PlainDepthState {
+    readonly write: boolean;
+    readonly compare: GPUCompareFunction;
+    readonly clamp?: boolean;
+}
+export interface PlainStencilFaceState {
+    readonly compare: GPUCompareFunction;
+    readonly failOp: GPUStencilOperation;
+    readonly depthFailOp: GPUStencilOperation;
+    readonly passOp: GPUStencilOperation;
+}
+export interface PlainStencilState {
+    readonly enabled: boolean;
+    readonly reference: number;
+    readonly readMask: number;
+    readonly writeMask: number;
+    readonly front: PlainStencilFaceState;
+    readonly back: PlainStencilFaceState;
+}
+export interface PlainBlendComponentState {
+    readonly operation: GPUBlendOperation;
+    readonly srcFactor: GPUBlendFactor;
+    readonly dstFactor: GPUBlendFactor;
+}
+export interface PlainBlendState {
+    readonly color: PlainBlendComponentState;
+    readonly alpha: PlainBlendComponentState;
+    readonly writeMask: number;
+}
+export interface PlainPipelineState {
+    readonly rasterizer: PlainRasterizerState;
+    readonly depth?: PlainDepthState;
+    readonly stencil?: PlainStencilState;
+    readonly blends?: HashMap<string, PlainBlendState>;
+    readonly alphaToCoverage?: boolean;
+    readonly blendConstant?: {
+        r: number;
+        g: number;
+        b: number;
+        a: number;
+    };
+}
+/**
+ * Wrap a plain `PlainPipelineState` into the aval-shaped
+ * `PipelineState` by lifting every leaf with `AVal.constant`. Useful
+ * for tests and for callers that don't carry avals yet — wombat.dom's
+ * `derivePipelineState` constructs the aval-shape directly.
+ */
+export declare const PipelineState: {
+    constant(plain: PlainPipelineState): PipelineState;
+};
+//# 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":"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"}

package/dist/core/pipelineState.js

@@ -0,0 +1,88 @@
+// 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.
+//
+// All fields are `aval<T>` so wombat.dom's render-state scopes can
+// flow through without forcing. The shader (`Effect`) stays a plain
+// non-aval value; only uniforms and pipeline state are reactive.
+import { AVal, HashMap } from "@aardworx/wombat.adaptive";
+// ---------------------------------------------------------------------------
+// Helpers
+// ---------------------------------------------------------------------------
+function blendStateFromPlain(b) {
+    return {
+        color: {
+            operation: AVal.constant(b.color.operation),
+            srcFactor: AVal.constant(b.color.srcFactor),
+            dstFactor: AVal.constant(b.color.dstFactor),
+        },
+        alpha: {
+            operation: AVal.constant(b.alpha.operation),
+            srcFactor: AVal.constant(b.alpha.srcFactor),
+            dstFactor: AVal.constant(b.alpha.dstFactor),
+        },
+        writeMask: AVal.constant(b.writeMask),
+    };
+}
+function stencilFaceFromPlain(f) {
+    return {
+        compare: AVal.constant(f.compare),
+        failOp: AVal.constant(f.failOp),
+        depthFailOp: AVal.constant(f.depthFailOp),
+        passOp: AVal.constant(f.passOp),
+    };
+}
+/**
+ * Wrap a plain `PlainPipelineState` into the aval-shaped
+ * `PipelineState` by lifting every leaf with `AVal.constant`. Useful
+ * for tests and for callers that don't carry avals yet — wombat.dom's
+ * `derivePipelineState` constructs the aval-shape directly.
+ */
+export const PipelineState = {
+    constant(plain) {
+        const rast = {
+            topology: AVal.constant(plain.rasterizer.topology),
+            cullMode: AVal.constant(plain.rasterizer.cullMode),
+            frontFace: AVal.constant(plain.rasterizer.frontFace),
+            ...(plain.rasterizer.depthBias !== undefined
+                ? { depthBias: AVal.constant(plain.rasterizer.depthBias) }
+                : {}),
+        };
+        let blends;
+        if (plain.blends !== undefined) {
+            let m = HashMap.empty();
+            for (const [k, v] of plain.blends)
+                m = m.add(k, blendStateFromPlain(v));
+            blends = AVal.constant(m);
+        }
+        return {
+            rasterizer: rast,
+            ...(plain.depth !== undefined
+                ? {
+                    depth: {
+                        write: AVal.constant(plain.depth.write),
+                        compare: AVal.constant(plain.depth.compare),
+                        ...(plain.depth.clamp !== undefined ? { clamp: AVal.constant(plain.depth.clamp) } : {}),
+                    },
+                }
+                : {}),
+            ...(plain.stencil !== undefined
+                ? {
+                    stencil: {
+                        enabled: AVal.constant(plain.stencil.enabled),
+                        reference: AVal.constant(plain.stencil.reference),
+                        readMask: AVal.constant(plain.stencil.readMask),
+                        writeMask: AVal.constant(plain.stencil.writeMask),
+                        front: stencilFaceFromPlain(plain.stencil.front),
+                        back: stencilFaceFromPlain(plain.stencil.back),
+                    },
+                }
+                : {}),
+            ...(blends !== undefined ? { blends } : {}),
+            ...(plain.alphaToCoverage !== undefined ? { alphaToCoverage: AVal.constant(plain.alphaToCoverage) } : {}),
+            ...(plain.blendConstant !== undefined ? { blendConstant: AVal.constant(plain.blendConstant) } : {}),
+        };
+    },
+};
+//# 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":"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"}

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