@codexo/exojs 0.9.0 → 0.10.0

package/dist/esm/rendering/webgpu/WebGpuPassCoordinator.js

@@ -0,0 +1,270 @@
+import { Matrix } from '../../math/Matrix.js';
+import { WebGpuStencilClipper } from './WebGpuStencilClipper.js';
+export { stencilAttachmentFormat } from './WebGpuStencilClipper.js';
+
+/// <reference types="@webgpu/types" />
+/**
+ * WebGPU implementation of {@link RenderPassCoordinator}.
+ *
+ * Owns the GPU render-pass mechanics (acquire/end the active
+ * `GPURenderPassEncoder`), the clear-vs-load decision, and — from phase 12E —
+ * geometric stencil clipping: a per-target `depth24plus-stencil8` attachment
+ * shared across the multiple submits of a clip scope (via `stencilLoadOp:'load'`)
+ * plus a position-only stencil-write pipeline. Renderers select stencil-enabled
+ * content pipelines while {@link stencilActive} is true.
+ * @internal
+ */
+class WebGpuPassCoordinator {
+    _backend;
+    _stencil = new WebGpuStencilClipper();
+    _stencilDepths = new Map();
+    _stencilStacks = new Map();
+    _stencilConnected = false;
+    _stencilWriteInProgress = false;
+    _stencilLoadOp = 'load';
+    _stencilRef = 0;
+    _active = null;
+    constructor(backend) {
+        this._backend = backend;
+    }
+    get activeTarget() {
+        return this._backend.renderTarget;
+    }
+    get activeView() {
+        return this._backend.view;
+    }
+    get hasActivePass() {
+        return this._active !== null;
+    }
+    /** The open GPU pass, or `null` when none is open. @internal */
+    get activePass() {
+        return this._active;
+    }
+    /**
+     * Whether a geometric stencil clip is currently in effect on the active
+     * target. Renderers read this to select a stencil-enabled content pipeline
+     * (matching the depth/stencil attachment {@link acquirePass} adds).
+     * @internal
+     */
+    get stencilActive() {
+        return this._stencilWriteInProgress || this._activeTargetDepth() > 0;
+    }
+    /** Current stencil reference value content pipelines must test against. @internal */
+    get stencilReference() {
+        return this._stencilRef;
+    }
+    /**
+     * Open (or return the already-open) GPU render pass for the backend's current
+     * target/view. Resolves colour load/clear via {@link createColorAttachment},
+     * counts the pass, applies the active scissor, and — when a stencil clip is in
+     * effect — attaches the per-target depth/stencil buffer and sets the reference.
+     */
+    acquirePass() {
+        if (this._active !== null) {
+            return this._active;
+        }
+        const backend = this._backend;
+        const stencilEnabled = this.stencilActive;
+        const descriptor = {
+            colorAttachments: [backend.createColorAttachment()],
+        };
+        if (stencilEnabled) {
+            descriptor.depthStencilAttachment = this._createStencilAttachment(backend.renderTarget);
+        }
+        const encoder = backend.device.createCommandEncoder();
+        const pass = encoder.beginRenderPass(descriptor);
+        backend.stats.renderPasses++;
+        const scissor = backend.getScissorRect();
+        if (scissor !== null && scissor.width > 0 && scissor.height > 0) {
+            pass.setScissorRect(scissor.x, scissor.y, scissor.width, scissor.height);
+        }
+        if (stencilEnabled) {
+            pass.setStencilReference(this._stencilRef);
+        }
+        this._active = {
+            encoder,
+            pass,
+            targetFormat: backend.renderTargetFormat,
+            view: backend.view,
+            stencilEnabled,
+            stencilRef: this._stencilRef,
+        };
+        return this._active;
+    }
+    /** End and submit the active GPU pass, if any. Idempotent. */
+    endPass() {
+        const active = this._active;
+        if (active === null) {
+            return;
+        }
+        this._active = null;
+        active.pass.end();
+        this._backend.submit(active.encoder.finish());
+    }
+    beginPass(descriptor) {
+        this._backend.setRenderTarget(descriptor.target);
+        this._backend.setView(descriptor.view);
+        if (descriptor.load === 'clear') {
+            this._backend.clear(descriptor.clearColor ?? undefined);
+        }
+    }
+    withChildPass(descriptor, body) {
+        const previousTarget = this._backend.renderTarget;
+        const previousView = this._backend.view;
+        this.beginPass(descriptor);
+        try {
+            body();
+        }
+        finally {
+            // setRenderTarget flushes the active renderer on change, which self-closes
+            // its GPU pass, so the child's draws are committed into the child target
+            // before the bind switches back.
+            this._backend.setRenderTarget(previousTarget);
+            this._backend.setView(previousView);
+        }
+    }
+    pushScissorRect(bounds) {
+        this._backend.pushScissorRect(bounds);
+    }
+    popScissorRect() {
+        this._backend.popScissorRect();
+    }
+    /**
+     * Establish a geometric stencil clip on the active target. The shape silhouette
+     * is incremented into the stencil buffer where it covers the already-valid
+     * region (intersection on nesting); subsequent content draws are restricted to
+     * the new depth via the stencil-enabled content pipelines.
+     */
+    pushStencilClip(shape, transform) {
+        const target = this._backend.renderTarget;
+        const depth = this._stencilDepths.get(target) ?? 0;
+        if (depth >= 255) {
+            throw new Error('Stencil clip nesting exceeds the 255-level limit.');
+        }
+        this._connectStencil();
+        this.endPass();
+        // The write pass tests stencil == depth and increments to depth+1. At the
+        // outermost level the stencil aspect is cleared first so stale values from a
+        // previous frame cannot leak in; deeper levels load the existing buffer.
+        this._stencilWriteInProgress = true;
+        this._stencilRef = depth;
+        this._stencilLoadOp = depth === 0 ? 'clear' : 'load';
+        const active = this.acquirePass();
+        this._stencil.draw(active.pass, active.targetFormat, true, shape, transform, active.view);
+        this.endPass();
+        this._stencilWriteInProgress = false;
+        this._stencilDepths.set(target, depth + 1);
+        this._stencilRef = depth + 1;
+        this._getStencilStack(target).push({ shape, transform: new Matrix().copy(transform) });
+    }
+    /** Pop the most recent stencil clip on the active target, restoring the outer level. */
+    popStencilClip() {
+        const target = this._backend.renderTarget;
+        const stack = this._stencilStacks.get(target);
+        const entry = stack?.pop();
+        if (entry === undefined) {
+            return;
+        }
+        const depth = this._stencilDepths.get(target) ?? 0;
+        this.endPass();
+        // The decrement pass tests stencil == depth and decrements the region this
+        // clip incremented, restoring the outer level. The stencil aspect is loaded.
+        this._stencilWriteInProgress = true;
+        this._stencilRef = depth;
+        this._stencilLoadOp = 'load';
+        const active = this.acquirePass();
+        this._stencil.draw(active.pass, active.targetFormat, false, entry.shape, entry.transform, active.view);
+        this.endPass();
+        this._stencilWriteInProgress = false;
+        this._stencilDepths.set(target, depth - 1);
+        this._stencilRef = depth - 1;
+    }
+    resolveLoad(target, clearRequested) {
+        // Clear when explicitly requested or when the target holds no content to
+        // preserve; otherwise load, so a render texture keeps its prior contents
+        // across multiple passes in the same frame.
+        return clearRequested || !this._backend._targetHasContent(target) ? 'clear' : 'load';
+    }
+    /**
+     * Drop a target's cached stencil attachment and clip state. Called when the
+     * target is destroyed so a pooled render texture never reuses a stale buffer.
+     * @internal
+     */
+    releaseStencilTarget(target) {
+        if (this._stencilConnected) {
+            this._stencil.releaseAttachment(target);
+        }
+        this._stencilDepths.delete(target);
+        this._stencilStacks.delete(target);
+    }
+    /**
+     * Drop all stencil clip bookkeeping (depths, stacks, write/ref state). Invoked
+     * on the unbalanced-clip recovery path at the end of a draw plan (see
+     * `WebGpuBackend._endDrawPlan`) so a leaked clip cannot corrupt the next frame;
+     * backend destroy / device loss go through `destroyStencil` instead. @internal
+     */
+    resetStencil() {
+        this._stencilDepths.clear();
+        this._stencilStacks.clear();
+        this._stencilWriteInProgress = false;
+        this._stencilRef = 0;
+    }
+    /** Tear down all stencil GPU resources (device loss / backend destroy). @internal */
+    destroyStencil() {
+        if (this._stencilConnected) {
+            this._stencil.disconnect();
+            this._stencilConnected = false;
+        }
+        this._stencilDepths.clear();
+        this._stencilStacks.clear();
+        this._stencilWriteInProgress = false;
+        this._stencilRef = 0;
+    }
+    /** Number of unpopped stencil clips across all targets (balance assertion). @internal */
+    unbalancedStencilClips() {
+        let total = 0;
+        for (const stack of this._stencilStacks.values()) {
+            total += stack.length;
+        }
+        return total;
+    }
+    _activeTargetDepth() {
+        return this._stencilDepths.get(this._backend.renderTarget) ?? 0;
+    }
+    _connectStencil() {
+        if (!this._stencilConnected) {
+            this._stencil.connect(this._backend.device);
+            this._stencilConnected = true;
+        }
+    }
+    _getStencilStack(target) {
+        let stack = this._stencilStacks.get(target);
+        if (stack === undefined) {
+            stack = [];
+            this._stencilStacks.set(target, stack);
+        }
+        return stack;
+    }
+    _createStencilAttachment(target) {
+        // Size the stencil attachment to the colour attachment's physical pixels, not
+        // the target's logical size. The root canvas backing store is logical ×
+        // pixelRatio, so a logical-sized stencil buffer would mismatch the
+        // getCurrentTexture() colour attachment at pixelRatio > 1; RenderTexture
+        // targets report the same size for both, so they are unaffected.
+        const { width, height } = this._backend._getAttachmentPixelSize(target);
+        const view = this._stencil.getAttachmentView(target, width, height);
+        const stencilLoadOp = this._stencilLoadOp;
+        // Consumed once; subsequent passes within the clip scope load the buffer.
+        this._stencilLoadOp = 'load';
+        return {
+            view,
+            depthReadOnly: true,
+            stencilLoadOp,
+            stencilStoreOp: 'store',
+            stencilClearValue: 0,
+        };
+    }
+}
+
+export { WebGpuPassCoordinator };
+//# sourceMappingURL=WebGpuPassCoordinator.js.map

package/dist/esm/rendering/webgpu/WebGpuPassCoordinator.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"WebGpuPassCoordinator.js","sources":["../../../../../src/rendering/webgpu/WebGpuPassCoordinator.ts"],"sourcesContent":[null],"names":[],"mappings":";;;;AAAA;AAoEA;;;;;;;;;;AAUG;MACU,qBAAqB,CAAA;AACf,IAAA,QAAQ;AACR,IAAA,QAAQ,GAAG,IAAI,oBAAoB,EAAE;AACrC,IAAA,cAAc,GAAG,IAAI,GAAG,EAAwB;AAChD,IAAA,cAAc,GAAG,IAAI,GAAG,EAAoC;IACrE,iBAAiB,GAAG,KAAK;IACzB,uBAAuB,GAAG,KAAK;IAC/B,cAAc,GAAc,MAAM;IAClC,WAAW,GAAG,CAAC;IACf,OAAO,GAAkC,IAAI;AAErD,IAAA,WAAA,CAAmB,OAA0B,EAAA;AAC3C,QAAA,IAAI,CAAC,QAAQ,GAAG,OAAO;IACzB;AAEA,IAAA,IAAW,YAAY,GAAA;AACrB,QAAA,OAAO,IAAI,CAAC,QAAQ,CAAC,YAAY;IACnC;AAEA,IAAA,IAAW,UAAU,GAAA;AACnB,QAAA,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI;IAC3B;AAEA,IAAA,IAAW,aAAa,GAAA;AACtB,QAAA,OAAO,IAAI,CAAC,OAAO,KAAK,IAAI;IAC9B;;AAGA,IAAA,IAAW,UAAU,GAAA;QACnB,OAAO,IAAI,CAAC,OAAO;IACrB;AAEA;;;;;AAKG;AACH,IAAA,IAAW,aAAa,GAAA;QACtB,OAAO,IAAI,CAAC,uBAAuB,IAAI,IAAI,CAAC,kBAAkB,EAAE,GAAG,CAAC;IACtE;;AAGA,IAAA,IAAW,gBAAgB,GAAA;QACzB,OAAO,IAAI,CAAC,WAAW;IACzB;AAEA;;;;;AAKG;IACI,WAAW,GAAA;AAChB,QAAA,IAAI,IAAI,CAAC,OAAO,KAAK,IAAI,EAAE;YACzB,OAAO,IAAI,CAAC,OAAO;QACrB;AAEA,QAAA,MAAM,OAAO,GAAG,IAAI,CAAC,QAAQ;AAC7B,QAAA,MAAM,cAAc,GAAG,IAAI,CAAC,aAAa;AACzC,QAAA,MAAM,UAAU,GAA4B;AAC1C,YAAA,gBAAgB,EAAE,CAAC,OAAO,CAAC,qBAAqB,EAAE,CAAC;SACpD;QAED,IAAI,cAAc,EAAE;YAClB,UAAU,CAAC,sBAAsB,GAAG,IAAI,CAAC,wBAAwB,CAAC,OAAO,CAAC,YAAY,CAAC;QACzF;QAEA,MAAM,OAAO,GAAG,OAAO,CAAC,MAAM,CAAC,oBAAoB,EAAE;QACrD,MAAM,IAAI,GAAG,OAAO,CAAC,eAAe,CAAC,UAAU,CAAC;AAEhD,QAAA,OAAO,CAAC,KAAK,CAAC,YAAY,EAAE;AAE5B,QAAA,MAAM,OAAO,GAAG,OAAO,CAAC,cAAc,EAAE;AAExC,QAAA,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,CAAC,KAAK,GAAG,CAAC,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE;AAC/D,YAAA,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,EAAE,OAAO,CAAC,KAAK,EAAE,OAAO,CAAC,MAAM,CAAC;QAC1E;QAEA,IAAI,cAAc,EAAE;AAClB,YAAA,IAAI,CAAC,mBAAmB,CAAC,IAAI,CAAC,WAAW,CAAC;QAC5C;QAEA,IAAI,CAAC,OAAO,GAAG;YACb,OAAO;YACP,IAAI;YACJ,YAAY,EAAE,OAAO,CAAC,kBAAkB;YACxC,IAAI,EAAE,OAAO,CAAC,IAAI;YAClB,cAAc;YACd,UAAU,EAAE,IAAI,CAAC,WAAW;SAC7B;QAED,OAAO,IAAI,CAAC,OAAO;IACrB;;IAGO,OAAO,GAAA;AACZ,QAAA,MAAM,MAAM,GAAG,IAAI,CAAC,OAAO;AAE3B,QAAA,IAAI,MAAM,KAAK,IAAI,EAAE;YACnB;QACF;AAEA,QAAA,IAAI,CAAC,OAAO,GAAG,IAAI;AACnB,QAAA,MAAM,CAAC,IAAI,CAAC,GAAG,EAAE;AACjB,QAAA,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;IAC/C;AAEO,IAAA,SAAS,CAAC,UAAgC,EAAA;QAC/C,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,UAAU,CAAC,MAAM,CAAC;QAChD,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC;AAEtC,QAAA,IAAI,UAAU,CAAC,IAAI,KAAK,OAAO,EAAE;YAC/B,IAAI,CAAC,QAAQ,CAAC,KAAK,CAAC,UAAU,CAAC,UAAU,IAAI,SAAS,CAAC;QACzD;IACF;IAEO,aAAa,CAAC,UAAgC,EAAE,IAAgB,EAAA;AACrE,QAAA,MAAM,cAAc,GAAG,IAAI,CAAC,QAAQ,CAAC,YAAY;AACjD,QAAA,MAAM,YAAY,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI;AAEvC,QAAA,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC;AAE1B,QAAA,IAAI;AACF,YAAA,IAAI,EAAE;QACR;gBAAU;;;;AAIR,YAAA,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,cAAc,CAAC;AAC7C,YAAA,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,YAAY,CAAC;QACrC;IACF;AAEO,IAAA,eAAe,CAAC,MAAiB,EAAA;AACtC,QAAA,IAAI,CAAC,QAAQ,CAAC,eAAe,CAAC,MAAM,CAAC;IACvC;IAEO,cAAc,GAAA;AACnB,QAAA,IAAI,CAAC,QAAQ,CAAC,cAAc,EAAE;IAChC;AAEA;;;;;AAKG;IACI,eAAe,CAAC,KAAe,EAAE,SAAiB,EAAA;AACvD,QAAA,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,YAAY;AACzC,QAAA,MAAM,KAAK,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;AAElD,QAAA,IAAI,KAAK,IAAI,GAAG,EAAE;AAChB,YAAA,MAAM,IAAI,KAAK,CAAC,mDAAmD,CAAC;QACtE;QAEA,IAAI,CAAC,eAAe,EAAE;QACtB,IAAI,CAAC,OAAO,EAAE;;;;AAKd,QAAA,IAAI,CAAC,uBAAuB,GAAG,IAAI;AACnC,QAAA,IAAI,CAAC,WAAW,GAAG,KAAK;AACxB,QAAA,IAAI,CAAC,cAAc,GAAG,KAAK,KAAK,CAAC,GAAG,OAAO,GAAG,MAAM;AAEpD,QAAA,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,EAAE;QACjC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,YAAY,EAAE,IAAI,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC;QACzF,IAAI,CAAC,OAAO,EAAE;AAEd,QAAA,IAAI,CAAC,uBAAuB,GAAG,KAAK;QACpC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,GAAG,CAAC,CAAC;AAC1C,QAAA,IAAI,CAAC,WAAW,GAAG,KAAK,GAAG,CAAC;QAC5B,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,MAAM,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;IACxF;;IAGO,cAAc,GAAA;AACnB,QAAA,MAAM,MAAM,GAAG,IAAI,CAAC,QAAQ,CAAC,YAAY;QACzC,MAAM,KAAK,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC;AAC7C,QAAA,MAAM,KAAK,GAAG,KAAK,EAAE,GAAG,EAAE;AAE1B,QAAA,IAAI,KAAK,KAAK,SAAS,EAAE;YACvB;QACF;AAEA,QAAA,MAAM,KAAK,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC;QAElD,IAAI,CAAC,OAAO,EAAE;;;AAId,QAAA,IAAI,CAAC,uBAAuB,GAAG,IAAI;AACnC,QAAA,IAAI,CAAC,WAAW,GAAG,KAAK;AACxB,QAAA,IAAI,CAAC,cAAc,GAAG,MAAM;AAE5B,QAAA,MAAM,MAAM,GAAG,IAAI,CAAC,WAAW,EAAE;QACjC,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,MAAM,CAAC,YAAY,EAAE,KAAK,EAAE,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,SAAS,EAAE,MAAM,CAAC,IAAI,CAAC;QACtG,IAAI,CAAC,OAAO,EAAE;AAEd,QAAA,IAAI,CAAC,uBAAuB,GAAG,KAAK;QACpC,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,GAAG,CAAC,CAAC;AAC1C,QAAA,IAAI,CAAC,WAAW,GAAG,KAAK,GAAG,CAAC;IAC9B;IAEO,WAAW,CAAC,MAAoB,EAAE,cAAuB,EAAA;;;;AAI9D,QAAA,OAAO,cAAc,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,iBAAiB,CAAC,MAAM,CAAC,GAAG,OAAO,GAAG,MAAM;IACtF;AAEA;;;;AAIG;AACI,IAAA,oBAAoB,CAAC,MAAoB,EAAA;AAC9C,QAAA,IAAI,IAAI,CAAC,iBAAiB,EAAE;AAC1B,YAAA,IAAI,CAAC,QAAQ,CAAC,iBAAiB,CAAC,MAAM,CAAC;QACzC;AAEA,QAAA,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,MAAM,CAAC;AAClC,QAAA,IAAI,CAAC,cAAc,CAAC,MAAM,CAAC,MAAM,CAAC;IACpC;AAEA;;;;;AAKG;IACI,YAAY,GAAA;AACjB,QAAA,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE;AAC3B,QAAA,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE;AAC3B,QAAA,IAAI,CAAC,uBAAuB,GAAG,KAAK;AACpC,QAAA,IAAI,CAAC,WAAW,GAAG,CAAC;IACtB;;IAGO,cAAc,GAAA;AACnB,QAAA,IAAI,IAAI,CAAC,iBAAiB,EAAE;AAC1B,YAAA,IAAI,CAAC,QAAQ,CAAC,UAAU,EAAE;AAC1B,YAAA,IAAI,CAAC,iBAAiB,GAAG,KAAK;QAChC;AAEA,QAAA,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE;AAC3B,QAAA,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE;AAC3B,QAAA,IAAI,CAAC,uBAAuB,GAAG,KAAK;AACpC,QAAA,IAAI,CAAC,WAAW,GAAG,CAAC;IACtB;;IAGO,sBAAsB,GAAA;QAC3B,IAAI,KAAK,GAAG,CAAC;QAEb,KAAK,MAAM,KAAK,IAAI,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,EAAE;AAChD,YAAA,KAAK,IAAI,KAAK,CAAC,MAAM;QACvB;AAEA,QAAA,OAAO,KAAK;IACd;IAEQ,kBAAkB,GAAA;AACxB,QAAA,OAAO,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,IAAI,CAAC;IACjE;IAEQ,eAAe,GAAA;AACrB,QAAA,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE;YAC3B,IAAI,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC;AAC3C,YAAA,IAAI,CAAC,iBAAiB,GAAG,IAAI;QAC/B;IACF;AAEQ,IAAA,gBAAgB,CAAC,MAAoB,EAAA;QAC3C,IAAI,KAAK,GAAG,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,CAAC;AAE3C,QAAA,IAAI,KAAK,KAAK,SAAS,EAAE;YACvB,KAAK,GAAG,EAAE;YACV,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,MAAM,EAAE,KAAK,CAAC;QACxC;AAEA,QAAA,OAAO,KAAK;IACd;AAEQ,IAAA,wBAAwB,CAAC,MAAoB,EAAA;;;;;;AAMnD,QAAA,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,CAAC,QAAQ,CAAC,uBAAuB,CAAC,MAAM,CAAC;AACvE,QAAA,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,iBAAiB,CAAC,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC;AACnE,QAAA,MAAM,aAAa,GAAG,IAAI,CAAC,cAAc;;AAGzC,QAAA,IAAI,CAAC,cAAc,GAAG,MAAM;QAE5B,OAAO;YACL,IAAI;AACJ,YAAA,aAAa,EAAE,IAAI;YACnB,aAAa;AACb,YAAA,cAAc,EAAE,OAAO;AACvB,YAAA,iBAAiB,EAAE,CAAC;SACrB;IACH;AACD;;;;"}

package/dist/esm/rendering/webgpu/WebGpuSpriteRenderer.d.ts

@@ -22,9 +22,17 @@ export declare class WebGpuSpriteRenderer extends AbstractWebGpuRenderer<Sprite>
     private _slotCount;
     private _instanceCount;
     private _currentBlendMode;
+    private readonly _customMaterials;
+    private _customBaseTextureLayout;
+    private _currentMaterial;
+    private _currentBaseTexture;
     protected onConnect(backend: WebGpuBackend): void;
     protected onDisconnect(): void;
     render(sprite: Sprite): void;
+    /** Default multi-texture path: rotate the base texture through 8 slots. */
+    private _renderDefault;
+    /** Custom-material path: single base texture on group(1), instanced. */
+    private _renderCustom;
     flush(): void;
     destroy(): void;
     /**
@@ -45,4 +53,12 @@ export declare class WebGpuSpriteRenderer extends AbstractWebGpuRenderer<Sprite>
     private _createTextureBindGroup;
     private _getPipeline;
     private _buildPipelineDescriptor;
+    private _drawCustomBatch;
+    private _getOrCreateCustomResources;
+    private _getOrCreateCustomPipeline;
+    private _getCustomBaseTextureBindGroup;
+    private _buildUserBindGroupLayout;
+    private _uploadUserUniforms;
+    private _buildUserBindGroup;
+    private _releaseCustomResources;
 }