@aura3d/rendering 3.0.0 → 4.0.0

package/dist/Sampler.d.ts

@@ -1,3 +1,4 @@
+import type { AuraQualityTier } from "./contracts/quality.js";
 export type TextureMagFilter = "nearest" | "linear";
 export type TextureMinFilter = TextureMagFilter | "nearest-mipmap-nearest" | "linear-mipmap-nearest" | "nearest-mipmap-linear" | "linear-mipmap-linear";
 export type TextureFilter = TextureMinFilter;
@@ -8,6 +9,12 @@ export interface SamplerDescriptor {
     readonly addressU?: TextureAddressMode;
     readonly addressV?: TextureAddressMode;
     readonly maxAnisotropy?: number;
+    /** C-12 (PR 0a): depth-compare sampler mode (PRD 02 shadow compare samplers). */
+    readonly compare?: "less-equal" | "greater-equal";
+    /** C-12 (PR 0a): third axis address mode. */
+    readonly addressW?: TextureAddressMode;
+    /** C-12 (PR 0a): mirror-once address mode for U/V/W when the backend supports it. */
+    readonly mirror?: boolean;
 }
 export declare class Sampler {
     readonly minFilter: TextureMinFilter;
@@ -15,7 +22,26 @@ export declare class Sampler {
     readonly addressU: TextureAddressMode;
     readonly addressV: TextureAddressMode;
     readonly maxAnisotropy: number;
+    readonly compare: "less-equal" | "greater-equal" | undefined;
+    readonly addressW: TextureAddressMode | undefined;
+    readonly mirror: boolean;
     constructor(descriptor?: SamplerDescriptor);
+    /**
+     * PRD-04 P2-6: trilinear (mipmapped-linear) material sampler. `wrap` takes a single address
+     * mode or a `[u, v]` pair; the public `AuraTextureWrap` aliases map — `"clamp"` →
+     * `"clamp-to-edge"`, `"mirror"` → `"mirror-repeat"`.
+     */
+    static trilinear(options?: {
+        readonly wrap?: TextureAddressMode | "clamp" | "mirror" | readonly [TextureAddressMode | "clamp" | "mirror", TextureAddressMode | "clamp" | "mirror"];
+        readonly anisotropy?: number;
+    }): Sampler;
+    /** PRD-04 P2-6: a glTF sampler descriptor (`magFilter`/`minFilter`/`wrapS`/`wrapT` enums). */
+    static fromGLTF(info: {
+        readonly magFilter?: number;
+        readonly minFilter?: number;
+        readonly wrapS?: number;
+        readonly wrapT?: number;
+    } | undefined, anisotropy?: number): Sampler;
 }
 /** Device-quantized sampler anisotropy steps (muse3jsparity-PRD C3). */
 export declare const SAMPLER_ANISOTROPY_STEPS: readonly [1, 2, 4, 8, 16];
@@ -26,7 +52,10 @@ export declare const SAMPLER_ANISOTROPY_STEPS: readonly [1, 2, 4, 8, 16];
  */
 export declare const DEFAULT_SAMPLER_ANISOTROPY = 8;
 export interface SamplerAnisotropyRequest {
-    /** Desired anisotropy. Defaults to {@link DEFAULT_SAMPLER_ANISOTROPY}. */
+    /**
+     * Desired anisotropy. Defaults to {@link DEFAULT_SAMPLER_ANISOTROPY} — or to the `tier`
+     * default (C-12 R9: low 4 / medium 8 / high 16 / ultra 16) when `tier` is given (PRD-04 P2-6).
+     */
     readonly desired?: number;
     /**
      * Capability-probe result: maximum anisotropy the device supports.
@@ -34,6 +63,10 @@ export interface SamplerAnisotropyRequest {
      * renderer clamps to the device maximum at upload time.
      */
     readonly maxSupported?: number;
+    /** PRD-04 P2-6: quality tier supplying the default when `desired` is undefined (C-12 R9). */
+    readonly tier?: AuraQualityTier;
+    /** PRD-04 P2-6: C-12 contract alias of `maxSupported` — the device maximum. */
+    readonly deviceMax?: number;
 }
 export interface SamplerAnisotropyResolution {
     readonly applied: number;

package/dist/Sampler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Sampler.d.ts","sourceRoot":"","sources":["../../../../packages/rendering/src/Sampler.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,gBAAgB,GAAG,SAAS,GAAG,QAAQ,CAAC;AACpD,MAAM,MAAM,gBAAgB,GACxB,gBAAgB,GAChB,wBAAwB,GACxB,uBAAuB,GACvB,uBAAuB,GACvB,sBAAsB,CAAC;AAC3B,MAAM,MAAM,aAAa,GAAG,gBAAgB,CAAC;AAC7C,MAAM,MAAM,kBAAkB,GAAG,eAAe,GAAG,QAAQ,GAAG,eAAe,CAAC;AAE9E,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,SAAS,CAAC,EAAE,gBAAgB,CAAC;IACtC,QAAQ,CAAC,SAAS,CAAC,EAAE,gBAAgB,CAAC;IACtC,QAAQ,CAAC,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IACvC,QAAQ,CAAC,QAAQ,CAAC,EAAE,kBAAkB,CAAC;IACvC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;CACjC;AAED,qBAAa,OAAO;IAClB,SAAgB,SAAS,EAAE,gBAAgB,CAAC;IAC5C,SAAgB,SAAS,EAAE,gBAAgB,CAAC;IAC5C,SAAgB,QAAQ,EAAE,kBAAkB,CAAC;IAC7C,SAAgB,QAAQ,EAAE,kBAAkB,CAAC;IAC7C,SAAgB,aAAa,EAAE,MAAM,CAAC;gBAE1B,UAAU,GAAE,iBAAsB;CAW/C;AAED,wEAAwE;AACxE,eAAO,MAAM,wBAAwB,2BAA4B,CAAC;AAElE;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,IAAI,CAAC;AAE5C,MAAM,WAAW,wBAAwB;IACvC,0EAA0E;IAC1E,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B;;;;OAIG;IACH,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAC;IACzB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB;AAED;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,OAAO,GAAE,wBAA6B,GAAG,2BAA2B,CAyB5G"}
+{"version":3,"file":"Sampler.d.ts","sourceRoot":"","sources":["../../../../packages/rendering/src/Sampler.ts"],"names":[],"mappings":"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"}

package/dist/Sampler.js

@@ -1,21 +1,70 @@
+import { resolveSamplerAnisotropy as resolveTierSamplerAnisotropy } from "./contracts/sampling.js";
 export class Sampler {
     minFilter;
     magFilter;
     addressU;
     addressV;
     maxAnisotropy;
+    compare;
+    addressW;
+    mirror;
     constructor(descriptor = {}) {
         this.minFilter = descriptor.minFilter ?? "linear";
         this.magFilter = descriptor.magFilter ?? "linear";
         this.addressU = descriptor.addressU ?? "clamp-to-edge";
         this.addressV = descriptor.addressV ?? "clamp-to-edge";
+        this.compare = descriptor.compare;
+        this.addressW = descriptor.addressW;
+        this.mirror = descriptor.mirror ?? false;
         const maxAnisotropy = descriptor.maxAnisotropy ?? 1;
         if (!Number.isFinite(maxAnisotropy) || maxAnisotropy < 1) {
             throw new RangeError("Sampler maxAnisotropy must be finite and at least 1");
         }
         this.maxAnisotropy = maxAnisotropy;
     }
+    /**
+     * PRD-04 P2-6: trilinear (mipmapped-linear) material sampler. `wrap` takes a single address
+     * mode or a `[u, v]` pair; the public `AuraTextureWrap` aliases map — `"clamp"` →
+     * `"clamp-to-edge"`, `"mirror"` → `"mirror-repeat"`.
+     */
+    static trilinear(options = {}) {
+        const mapWrap = (mode) => mode === "mirror" ? "mirror-repeat" : mode === "clamp" ? "clamp-to-edge" : mode;
+        const [wrapU, wrapV] = Array.isArray(options.wrap) ? options.wrap : [options.wrap ?? "repeat", options.wrap ?? "repeat"];
+        return new Sampler({
+            minFilter: "linear-mipmap-linear",
+            magFilter: "linear",
+            addressU: mapWrap(wrapU),
+            addressV: mapWrap(wrapV),
+            maxAnisotropy: options.anisotropy ?? 1
+        });
+    }
+    /** PRD-04 P2-6: a glTF sampler descriptor (`magFilter`/`minFilter`/`wrapS`/`wrapT` enums). */
+    static fromGLTF(info, anisotropy = 1) {
+        const magFilter = info?.magFilter === 9728 ? "nearest" : "linear";
+        const minFilter = GLTF_MIN_FILTERS[info?.minFilter ?? 0] ?? "linear-mipmap-linear";
+        return new Sampler({
+            minFilter,
+            magFilter,
+            addressU: GLTF_WRAP_MODES[info?.wrapS ?? 0] ?? "repeat",
+            addressV: GLTF_WRAP_MODES[info?.wrapT ?? 0] ?? "repeat",
+            maxAnisotropy: anisotropy
+        });
+    }
 }
+// glTF sampler enums: CLAMP_TO_EDGE 33071, MIRRORED_REPEAT 33648, REPEAT 10497.
+const GLTF_WRAP_MODES = {
+    33071: "clamp-to-edge",
+    10497: "repeat",
+    33648: "mirror-repeat"
+};
+const GLTF_MIN_FILTERS = {
+    9728: "nearest",
+    9729: "linear",
+    9984: "nearest-mipmap-nearest",
+    9985: "linear-mipmap-nearest",
+    9986: "nearest-mipmap-linear",
+    9987: "linear-mipmap-linear"
+};
 /** Device-quantized sampler anisotropy steps (muse3jsparity-PRD C3). */
 export const SAMPLER_ANISOTROPY_STEPS = [1, 2, 4, 8, 16];
 /**
@@ -31,11 +80,15 @@ export const DEFAULT_SAMPLER_ANISOTROPY = 8;
  */
 export function resolveSamplerAnisotropy(request = {}) {
     const rawDesired = request.desired;
+    const deviceCap = request.deviceMax ?? request.maxSupported;
     const desired = typeof rawDesired === "number" && Number.isFinite(rawDesired) && rawDesired >= 1
         ? rawDesired
-        : DEFAULT_SAMPLER_ANISOTROPY;
+        : request.tier !== undefined
+            // P2-6: no explicit desire + tier -> C-12 R9 tier default (L4/M8/H16/U16), device-clamped.
+            ? resolveTierSamplerAnisotropy({ tier: request.tier, deviceMax: Math.max(1, deviceCap ?? 16) })
+            : DEFAULT_SAMPLER_ANISOTROPY;
     const snappedDesired = snapAnisotropyStep(desired);
-    const rawMax = request.maxSupported;
+    const rawMax = deviceCap;
     if (typeof rawMax !== "number" || !Number.isFinite(rawMax)) {
         return {
             applied: snappedDesired,

package/dist/Sampler.js.map

@@ -1 +1 @@
-{"version":3,"file":"Sampler.js","sourceRoot":"","sources":["../../../../packages/rendering/src/Sampler.ts"],"names":[],"mappings":"AAkBA,MAAM,OAAO,OAAO;IACF,SAAS,CAAmB;IAC5B,SAAS,CAAmB;IAC5B,QAAQ,CAAqB;IAC7B,QAAQ,CAAqB;IAC7B,aAAa,CAAS;IAEtC,YAAY,aAAgC,EAAE;QAC5C,IAAI,CAAC,SAAS,GAAG,UAAU,CAAC,SAAS,IAAI,QAAQ,CAAC;QAClD,IAAI,CAAC,SAAS,GAAG,UAAU,CAAC,SAAS,IAAI,QAAQ,CAAC;QAClD,IAAI,CAAC,QAAQ,GAAG,UAAU,CAAC,QAAQ,IAAI,eAAe,CAAC;QACvD,IAAI,CAAC,QAAQ,GAAG,UAAU,CAAC,QAAQ,IAAI,eAAe,CAAC;QACvD,MAAM,aAAa,GAAG,UAAU,CAAC,aAAa,IAAI,CAAC,CAAC;QACpD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,aAAa,CAAC,IAAI,aAAa,GAAG,CAAC,EAAE,CAAC;YACzD,MAAM,IAAI,UAAU,CAAC,qDAAqD,CAAC,CAAC;QAC9E,CAAC;QACD,IAAI,CAAC,aAAa,GAAG,aAAa,CAAC;IACrC,CAAC;CACF;AAED,wEAAwE;AACxE,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC,EAAE,EAAE,CAAU,CAAC;AAElE;;;;GAIG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAG,CAAC,CAAC;AAmB5C;;;;GAIG;AACH,MAAM,UAAU,wBAAwB,CAAC,UAAoC,EAAE;IAC7E,MAAM,UAAU,GAAG,OAAO,CAAC,OAAO,CAAC;IACnC,MAAM,OAAO,GAAG,OAAO,UAAU,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,UAAU,IAAI,CAAC;QAC9F,CAAC,CAAC,UAAU;QACZ,CAAC,CAAC,0BAA0B,CAAC;IAC/B,MAAM,cAAc,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;IACnD,MAAM,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IACpC,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3D,OAAO;YACL,OAAO,EAAE,cAAc;YACvB,MAAM,EAAE,KAAK;YACb,MAAM,EAAE,cAAc,cAAc,oGAAoG;SACzI,CAAC;IACJ,CAAC;IACD,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;IACzC,MAAM,OAAO,GAAG,IAAI,CAAC,GAAG,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;IAChD,MAAM,OAAO,GAAG,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAC5C,MAAM,MAAM,GAAG,OAAO,GAAG,OAAO,CAAC;IACjC,OAAO;QACL,OAAO;QACP,MAAM;QACN,MAAM,EAAE,MAAM;YACZ,CAAC,CAAC,cAAc,OAAO,mCAAmC,YAAY,eAAe,OAAO,IAAI;YAChG,CAAC,CAAC,cAAc,OAAO,wBAAwB,OAAO,aAAa,YAAY,KAAK;KACvF,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB,CAAC,KAAa;IACvC,IAAI,OAAO,GAAW,wBAAwB,CAAC,CAAC,CAAE,CAAC;IACnD,KAAK,MAAM,IAAI,IAAI,wBAAwB,EAAE,CAAC;QAC5C,IAAI,IAAI,IAAI,KAAK;YAAE,OAAO,GAAG,IAAI,CAAC;IACpC,CAAC;IACD,OAAO,OAAO,CAAC;AACjB,CAAC"}
+{"version":3,"file":"Sampler.js","sourceRoot":"","sources":["../../../../packages/rendering/src/Sampler.ts"],"names":[],"mappings":"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"}

package/dist/ScreenSpaceReflectionPass.d.ts

@@ -0,0 +1,43 @@
+import type { RenderDevice, RenderTarget } from "./RenderDevice.js";
+import { createSsrPassDescriptor, type SsrPassDescriptor } from "./PlanarReflection.js";
+export { invertSsrProjection } from "./ProjectionMath.js";
+export interface ReflectionSurfaceSsrInputs {
+    /** Color and nonlinear WebGL depth from the same completed scene frame. */
+    readonly scene: RenderTarget;
+    /** View-space normals encoded to RGB [0,1]; A is roughness, zero excludes the surface. */
+    readonly normalMask: RenderTarget;
+    readonly projection: Float32Array;
+    readonly frame: number;
+}
+export interface ReflectionSurfaceSsrResult {
+    readonly target: RenderTarget;
+    readonly frame: number;
+    readonly revision: number;
+    readonly nativeDraws: number;
+    readonly pixelBacked: true;
+}
+interface SsrNativeDevice extends RenderDevice {
+    executeReflectionSurfaceSsr?(source: RenderTarget, normalMask: RenderTarget, output: RenderTarget, options: {
+        projection: Float32Array;
+        inverseProjection: Float32Array;
+        maxSteps: number;
+        maxDistance: number;
+        thickness: number;
+        intensity: number;
+    }): void;
+}
+/** Owns only output; borrows current scene/G-buffer targets from the existing renderer. */
+export declare class ScreenSpaceReflectionPass {
+    private readonly device;
+    private output;
+    private disposed;
+    private revision;
+    private lastFrame;
+    private latest;
+    readonly descriptor: SsrPassDescriptor;
+    constructor(device: SsrNativeDevice, options: Parameters<typeof createSsrPassDescriptor>[0]);
+    execute(inputs: ReflectionSurfaceSsrInputs, intensity?: number): ReflectionSurfaceSsrResult;
+    get result(): ReflectionSurfaceSsrResult | undefined;
+    dispose(): void;
+}
+//# sourceMappingURL=ScreenSpaceReflectionPass.d.ts.map

package/dist/ScreenSpaceReflectionPass.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScreenSpaceReflectionPass.d.ts","sourceRoot":"","sources":["../../../../packages/rendering/src/ScreenSpaceReflectionPass.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACjE,OAAO,EAAE,uBAAuB,EAAE,KAAK,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAErF,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AAEvD,MAAM,WAAW,0BAA0B;IACzC,2EAA2E;IAC3E,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,0FAA0F;IAC1F,QAAQ,CAAC,UAAU,EAAE,YAAY,CAAC;IAClC,QAAQ,CAAC,UAAU,EAAE,YAAY,CAAC;IAClC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AACD,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,IAAI,CAAC;CAC5B;AACD,UAAU,eAAgB,SAAQ,YAAY;IAC5C,2BAA2B,CAAC,CAAC,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,EAAE,YAAY,EAC/F,OAAO,EAAE;QAAE,UAAU,EAAE,YAAY,CAAC;QAAC,iBAAiB,EAAE,YAAY,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,WAAW,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;CAC9J;AAED,2FAA2F;AAC3F,qBAAa,yBAAyB;IAQxB,OAAO,CAAC,QAAQ,CAAC,MAAM;IAPnC,OAAO,CAAC,MAAM,CAA2B;IACzC,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,SAAS,CAAM;IACvB,OAAO,CAAC,MAAM,CAAyC;IACvD,QAAQ,CAAC,UAAU,EAAE,iBAAiB,CAAC;gBAEV,MAAM,EAAE,eAAe,EAAE,OAAO,EAAE,UAAU,CAAC,OAAO,uBAAuB,CAAC,CAAC,CAAC,CAAC;IAI5G,OAAO,CAAC,MAAM,EAAE,0BAA0B,EAAE,SAAS,SAAM,GAAG,0BAA0B;IA4BxF,IAAI,MAAM,IAAI,0BAA0B,GAAG,SAAS,CAEnD;IAED,OAAO,IAAI,IAAI;CAMhB"}

package/dist/ScreenSpaceReflectionPass.js

@@ -0,0 +1,58 @@
+import { createSsrPassDescriptor } from "./PlanarReflection.js";
+import { invertSsrProjection } from "./ProjectionMath.js";
+export { invertSsrProjection } from "./ProjectionMath.js";
+/** Owns only output; borrows current scene/G-buffer targets from the existing renderer. */
+export class ScreenSpaceReflectionPass {
+    device;
+    output;
+    disposed = false;
+    revision = 0;
+    lastFrame = -1;
+    latest;
+    descriptor;
+    constructor(device, options) {
+        this.device = device;
+        this.descriptor = createSsrPassDescriptor(options);
+    }
+    execute(inputs, intensity = 0.8) {
+        this.latest = undefined;
+        if (this.disposed)
+            throw new Error("SSR pass is disposed.");
+        if (!this.device.executeReflectionSurfaceSsr)
+            throw new Error("SSR requires native renderer execution; CPU/mock fallback is unavailable.");
+        const { scene, normalMask, frame, projection } = inputs;
+        if (!scene || !normalMask || scene.disposed || normalMask.disposed || !scene.depthTexture || scene.depthTexture.disposed)
+            throw new Error("SSR requires live scene color, sampleable depth, and normal-mask targets.");
+        if (scene.width !== normalMask.width || scene.height !== normalMask.height)
+            throw new Error("SSR input dimensions must match.");
+        if (!Number.isSafeInteger(frame) || frame <= this.lastFrame)
+            throw new Error("SSR requires a new completed frame.");
+        if (!Number.isFinite(intensity) || intensity < 0 || intensity > 2)
+            throw new RangeError("SSR intensity must be in [0, 2].");
+        const inverseProjection = invertSsrProjection(projection);
+        const width = Math.max(1, Math.ceil(scene.width * this.descriptor.resolutionScale));
+        const height = Math.max(1, Math.ceil(scene.height * this.descriptor.resolutionScale));
+        if (!this.output || this.output.width !== width || this.output.height !== height) {
+            this.output?.dispose();
+            this.output = undefined;
+            this.output = this.device.createRenderTarget({ width, height, format: scene.colorTexture.format === "rgba16f" ? "rgba16f" : "rgba8", depth: false, label: "reflection-surface-ssr" });
+        }
+        this.device.executeReflectionSurfaceSsr(scene, normalMask, this.output, {
+            projection, inverseProjection, intensity, maxSteps: this.descriptor.maxSteps,
+            maxDistance: this.descriptor.maxDistance, thickness: this.descriptor.thickness,
+        });
+        this.lastFrame = frame;
+        this.latest = Object.freeze({ target: this.output, frame, revision: ++this.revision, nativeDraws: 1, pixelBacked: true });
+        return this.latest;
+    }
+    get result() {
+        return this.latest?.target.disposed ? undefined : this.latest;
+    }
+    dispose() {
+        this.disposed = true;
+        this.latest = undefined;
+        this.output?.dispose();
+        this.output = undefined;
+    }
+}
+//# sourceMappingURL=ScreenSpaceReflectionPass.js.map

package/dist/ScreenSpaceReflectionPass.js.map

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

package/dist/ShaderLibrary.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ShaderLibrary.d.ts","sourceRoot":"","sources":["../../../../packages/rendering/src/ShaderLibrary.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,aAAa,EA0Cd,MAAM,qBAAqB,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AAEpC,wBAAgB,0BAA0B,IAAI,aAAa,CA4uG1D"}
+{"version":3,"file":"ShaderLibrary.d.ts","sourceRoot":"","sources":["../../../../packages/rendering/src/ShaderLibrary.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,aAAa,EA6Cd,MAAM,qBAAqB,CAAC;AAC7B,cAAc,qBAAqB,CAAC;AAEpC,wBAAgB,0BAA0B,IAAI,aAAa,CAotG1D"}