@forgeax/engine-render 0.1.19 → 0.1.21

package/dist/shadow-atlas.d.ts

@@ -5,17 +5,17 @@ import { type RhiDevice, type Sampler, type Texture, type TextureView } from '@f
 export interface ShadowAtlasOptions {
     /** Per-face square size in pixels. Default 512 (PointLightShadow.mapSize default). */
     readonly faceSize?: number;
-    /** Number of cube layers. Default 4 (= PointLightShadow cardinality cap). */
+    /** Number of cube layers. Default is the renderer atlas admission capacity. */
     readonly layers?: number;
 }
 /** Default per-face square size in pixels. Mirrors PointLightShadow.mapSize default. */
 export declare const SHADOW_ATLAS_DEFAULT_FACE_SIZE = 512;
-/** Default cube layer count. Mirrors PointLightShadow cardinality cap. */
+/** Default cube layer count. Renderer-owned point-shadow admission capacity. */
 export declare const SHADOW_ATLAS_DEFAULT_LAYERS = 4;
 /**
  * Cube-array depth atlas for point-light shadows.
  *
- * Shape: `texture_depth_cube_array` (depth32float) with `layers = 4` and per-
+ * Shape: `texture_depth_cube_array` (depth32float) with `layers` and per-
  * face size `faceSize x faceSize`. The cube_array sampling view feeds
  * `@group(0) @binding(5)` in URP shaders; the per-face 2D view feeds the
  * shadow-caster render pass attachment for one (layer, face) at a time

package/dist/shadow-atlas.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"shadow-atlas.d.ts","sourceRoot":"","sources":["../src/shadow-atlas.ts"],"names":[],"mappings":"AAiCA,OAAO,EAIL,KAAK,SAAS,EACd,KAAK,OAAO,EACZ,KAAK,OAAO,EACZ,KAAK,WAAW,EACjB,MAAM,qBAAqB,CAAC;AAQ7B;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,sFAAsF;IACtF,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,6EAA6E;IAC7E,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,wFAAwF;AACxF,eAAO,MAAM,8BAA8B,MAAM,CAAC;AAClD,0EAA0E;AAC1E,eAAO,MAAM,2BAA2B,IAAI,CAAC;AAE7C;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBAAa,WAAW;IACtB,yEAAyE;IACzE,OAAO,CAAC,OAAO,CAAwB;IACvC;;;OAGG;IACH,OAAO,CAAC,aAAa,CAA4B;IACjD,yDAAyD;IACzD,OAAO,CAAC,cAAc,CAAwB;IAC9C,iEAAiE;IACjE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkC;IAC5D,+DAA+D;IAC/D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAY;IACnC,sCAAsC;IACtC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,wBAAwB;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEZ,MAAM,EAAE,SAAS,EAAE,OAAO,GAAE,kBAAuB;IAM/D;;;;;;OAMG;IACH,WAAW,IAAI,OAAO;IAItB;;;;;;;;;OASG;IACH,MAAM,IAAI,IAAI;IAkCd;;;;OAIG;IACH,YAAY,IAAI,WAAW,GAAG,IAAI;IAIlC;;;OAGG;IACH,oBAAoB,IAAI,OAAO,GAAG,IAAI;IAItC;;OAEG;IACH,UAAU,IAAI,OAAO,GAAG,IAAI;IAI5B;;;;;;;;;;;;;;OAcG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,WAAW;IAoBlD;;;;OAIG;IACH,OAAO,IAAI,IAAI;CAShB"}
+{"version":3,"file":"shadow-atlas.d.ts","sourceRoot":"","sources":["../src/shadow-atlas.ts"],"names":[],"mappings":"AAiCA,OAAO,EAIL,KAAK,SAAS,EACd,KAAK,OAAO,EACZ,KAAK,OAAO,EACZ,KAAK,WAAW,EACjB,MAAM,qBAAqB,CAAC;AAQ7B;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,sFAAsF;IACtF,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,+EAA+E;IAC/E,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,wFAAwF;AACxF,eAAO,MAAM,8BAA8B,MAAM,CAAC;AAClD,gFAAgF;AAChF,eAAO,MAAM,2BAA2B,IAAI,CAAC;AAE7C;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,qBAAa,WAAW;IACtB,yEAAyE;IACzE,OAAO,CAAC,OAAO,CAAwB;IACvC;;;OAGG;IACH,OAAO,CAAC,aAAa,CAA4B;IACjD,yDAAyD;IACzD,OAAO,CAAC,cAAc,CAAwB;IAC9C,iEAAiE;IACjE,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAkC;IAC5D,+DAA+D;IAC/D,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAY;IACnC,sCAAsC;IACtC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,wBAAwB;IACxB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;gBAEZ,MAAM,EAAE,SAAS,EAAE,OAAO,GAAE,kBAAuB;IAM/D;;;;;;OAMG;IACH,WAAW,IAAI,OAAO;IAItB;;;;;;;;;OASG;IACH,MAAM,IAAI,IAAI;IAkCd;;;;OAIG;IACH,YAAY,IAAI,WAAW,GAAG,IAAI;IAIlC;;;OAGG;IACH,oBAAoB,IAAI,OAAO,GAAG,IAAI;IAItC;;OAEG;IACH,UAAU,IAAI,OAAO,GAAG,IAAI;IAI5B;;;;;;;;;;;;;;OAcG;IACH,QAAQ,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,WAAW;IAoBlD;;;;OAIG;IACH,OAAO,IAAI,IAAI;CAShB"}

package/dist/ssao-buffers.d.ts

@@ -6,6 +6,7 @@ export declare function generateSsaoNoise(seed?: number): Float32Array;
 export declare const SSAO_UNIFORM_INTENSITY_OFFSET = 192;
 export declare const SSAO_UNIFORM_BYTES = 256;
 interface SsaoFallbackResources {
+    readonly device: RenderSystemRuntime['device'];
     readonly texture: Texture;
     readonly view: TextureView;
     readonly sampler: Sampler;
@@ -26,6 +27,8 @@ export declare function getOrCreateSsaoFallbackTexture(runtime: RenderSystemRunt
  * Fields are readonly per charter P5: one resource, one owner.
  */
 export interface SsaoBuffers {
+    /** Device identity that owns every handle in this bundle. */
+    readonly device: RenderSystemRuntime['device'];
     /** 64 padded vec4 uniform buffer for hemisphere samples. */
     readonly kernelBuffer: Buffer;
     readonly kernelBytes: number;

package/dist/ssao-buffers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ssao-buffers.d.ts","sourceRoot":"","sources":["../src/ssao-buffers.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGjF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAInE,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAiB3C,wBAAgB,kBAAkB,CAAC,IAAI,GAAE,MAAU,GAAG,SAAS,YAAY,EAAE,CAuB5E;AAED,wBAAgB,iBAAiB,CAAC,IAAI,GAAE,MAAU,GAAG,YAAY,CAShE;AAiBD,eAAO,MAAM,6BAA6B,MAAiC,CAAC;AAC5E,eAAO,MAAM,kBAAkB,MAAgB,CAAC;AAYhD,UAAU,qBAAqB;IAC7B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAID;;;;;;;;GAQG;AACH,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,mBAAmB,GAC3B,qBAAqB,GAAG,IAAI,CAyE9B;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,4DAA4D;IAC5D,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,gEAAgE;IAChE,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,oFAAoF;IACpF,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAID;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,mBAAmB,GAAG,WAAW,GAAG,IAAI,CAwGvF"}
+{"version":3,"file":"ssao-buffers.d.ts","sourceRoot":"","sources":["../src/ssao-buffers.ts"],"names":[],"mappings":"AAmBA,OAAO,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAGjF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAInE,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAiB3C,wBAAgB,kBAAkB,CAAC,IAAI,GAAE,MAAU,GAAG,SAAS,YAAY,EAAE,CAuB5E;AAED,wBAAgB,iBAAiB,CAAC,IAAI,GAAE,MAAU,GAAG,YAAY,CAShE;AAiBD,eAAO,MAAM,6BAA6B,MAAiC,CAAC;AAC5E,eAAO,MAAM,kBAAkB,MAAgB,CAAC;AAYhD,UAAU,qBAAqB;IAC7B,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IAC/C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;CAC3B;AAID;;;;;;;;GAQG;AACH,wBAAgB,8BAA8B,CAC5C,OAAO,EAAE,mBAAmB,GAC3B,qBAAqB,GAAG,IAAI,CA2E9B;AAED;;;;GAIG;AACH,MAAM,WAAW,WAAW;IAC1B,6DAA6D;IAC7D,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC,QAAQ,CAAC,CAAC;IAC/C,4DAA4D;IAC5D,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,gEAAgE;IAChE,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAC;IAC/B,oFAAoF;IACpF,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAID;;;;;;;;;GASG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,mBAAmB,GAAG,WAAW,GAAG,IAAI,CA0GvF"}

package/dist/targets/contracts.d.ts

@@ -0,0 +1,66 @@
+import type { RenderError } from '../errors/render';
+import type { RenderResult } from '../render-contract';
+export type RenderTargetFormat = 'rgba16float' | 'rgba8unorm' | 'rgba8unorm-srgb';
+export type RenderTargetShape = '2d' | 'cube';
+export type RenderTargetMipLevels = 1 | 'full';
+export type RenderTargetSampleCount = 1 | 4;
+export type RenderTargetDepthFormat = 'depth24plus-stencil8' | 'depth32float';
+export interface RenderTargetDescriptor {
+    readonly shape: RenderTargetShape;
+    readonly width: number;
+    readonly height: number;
+    readonly format: RenderTargetFormat;
+    readonly mipLevels: RenderTargetMipLevels;
+    readonly sampleCount: RenderTargetSampleCount;
+    readonly depth?: RenderTargetDepthFormat;
+    readonly sampled: boolean;
+    readonly readback: boolean;
+}
+declare const RenderTargetBrand: unique symbol;
+declare const RenderTargetTextureSourceBrand: unique symbol;
+declare const RenderTargetReadbackTicketBrand: unique symbol;
+/** Opaque logical target lease owned by one Renderer. */
+export interface RenderTarget {
+    readonly [RenderTargetBrand]: 'RenderTarget';
+}
+export type RenderTargetTextureAspect = 'color';
+export interface RenderTargetTextureSourceOptions {
+    readonly aspect: RenderTargetTextureAspect;
+    readonly dimension: RenderTargetShape;
+    readonly mipLevel: number;
+}
+/** Renderer-local runtime material source; it is not an asset handle. */
+export interface RenderTargetTextureSource {
+    readonly [RenderTargetTextureSourceBrand]: 'RenderTargetTextureSource';
+}
+export interface RenderTargetReadbackRequest {
+    readonly mipLevel: number;
+    /** Cube array layer to copy; 2D targets accept only the omitted form. */
+    readonly face?: number;
+}
+/** One-shot readback request bound to a future matching FrameReceipt. */
+export interface RenderTargetReadbackTicket {
+    readonly [RenderTargetReadbackTicketBrand]: 'RenderTargetReadbackTicket';
+}
+/** Bytes released by observe after the ticket's matching frame completes. */
+export interface RenderTargetReadbackData {
+    readonly ticket: RenderTargetReadbackTicket;
+    readonly bytes: Uint8Array;
+    readonly frameId: number;
+    readonly deviceGeneration: number;
+    readonly mipLevel: number;
+    readonly face?: number;
+    readonly bytesPerRow: number;
+    readonly byteLength: number;
+}
+export interface RenderTargetAdmissionLimits {
+    readonly maxTextureDimension2D: number;
+    readonly maxBytesPerTarget: number;
+    readonly renderableFormats: readonly RenderTargetFormat[];
+    readonly sampleCounts: readonly RenderTargetSampleCount[];
+    readonly depthFormats: readonly RenderTargetDepthFormat[];
+}
+/** Validate descriptor facts before a renderer allocates a physical target. */
+export declare function admitRenderTargetDescriptor(descriptor: RenderTargetDescriptor, limits: RenderTargetAdmissionLimits): RenderResult<RenderTargetDescriptor, RenderError>;
+export {};
+//# sourceMappingURL=contracts.d.ts.map

package/dist/targets/contracts.d.ts.map

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

package/dist/targets/graph-projection.d.ts

@@ -0,0 +1,29 @@
+import type { GraphTexture, GraphTextureView, GraphTextureViewDescriptor, RenderGraphBuilder, RenderGraphFrame } from '@forgeax/engine-render-graph';
+import type { Texture, TextureView } from '@forgeax/engine-rhi';
+import type { RenderError } from '../errors/render';
+import type { RenderResult } from '../render-contract';
+import type { RenderTarget, RenderTargetDescriptor } from './contracts';
+export interface RenderTargetGraphInput {
+    readonly target: RenderTarget;
+    readonly generation: number;
+    readonly descriptor: RenderTargetDescriptor;
+    readonly texture: Texture;
+    readonly view: TextureView;
+    readonly resolveView?: TextureView | undefined;
+}
+export interface RenderTargetGraphSubresource {
+    readonly mipLevel?: number;
+    readonly face?: number;
+}
+export interface RenderTargetGraphProjection {
+    readonly ownership: 'imported';
+    readonly generation: number;
+    readonly texture: GraphTexture;
+    readonly view: GraphTextureView;
+    readonly sampleView: GraphTextureView;
+    readonly resolveView?: GraphTextureView | undefined;
+    readonly viewDescriptor: GraphTextureViewDescriptor;
+    readonly usage: readonly ('sampled-read' | 'copy-src')[];
+}
+export declare function projectRenderTargetGraph<FrameCtx extends RenderGraphFrame>(graph: RenderGraphBuilder<FrameCtx>, input: RenderTargetGraphInput, subresource?: RenderTargetGraphSubresource): RenderResult<RenderTargetGraphProjection, RenderError>;
+//# sourceMappingURL=graph-projection.d.ts.map

package/dist/targets/graph-projection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph-projection.d.ts","sourceRoot":"","sources":["../../src/targets/graph-projection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,YAAY,EACZ,gBAAgB,EAChB,0BAA0B,EAC1B,kBAAkB,EAClB,gBAAgB,EACjB,MAAM,8BAA8B,CAAC;AACtC,OAAO,KAAK,EAAE,OAAO,EAAiB,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAC/E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAExE,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,sBAAsB,CAAC;IAC5C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;CAChD;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,SAAS,EAAE,UAAU,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAAC;IAChC,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAC;IACtC,QAAQ,CAAC,WAAW,CAAC,EAAE,gBAAgB,GAAG,SAAS,CAAC;IACpD,QAAQ,CAAC,cAAc,EAAE,0BAA0B,CAAC;IACpD,QAAQ,CAAC,KAAK,EAAE,SAAS,CAAC,cAAc,GAAG,UAAU,CAAC,EAAE,CAAC;CAC1D;AAsED,wBAAgB,wBAAwB,CAAC,QAAQ,SAAS,gBAAgB,EACxE,KAAK,EAAE,kBAAkB,CAAC,QAAQ,CAAC,EACnC,KAAK,EAAE,sBAAsB,EAC7B,WAAW,GAAE,4BAAiC,GAC7C,YAAY,CAAC,2BAA2B,EAAE,WAAW,CAAC,CA0DxD"}

package/dist/targets/material-source.d.ts

@@ -0,0 +1,34 @@
+import type { TextureView } from '@forgeax/engine-rhi';
+import type { RenderError } from '../errors/render';
+import type { RenderResult } from '../render-contract';
+import type { RenderTarget, RenderTargetDescriptor, RenderTargetTextureSource, RenderTargetTextureSourceOptions } from './contracts';
+export interface RenderTargetMaterialSourceView {
+    readonly dimension: RenderTargetTextureSourceOptions['dimension'];
+    readonly mipLevel: number;
+    readonly resolveRequired: boolean;
+}
+export interface RenderTargetMaterialSourceBinding {
+    readonly source: RenderTargetTextureSource;
+    readonly target: RenderTarget;
+    readonly generation: number;
+    readonly shape: RenderTargetDescriptor['shape'];
+    readonly format: RenderTargetDescriptor['format'];
+    readonly view: RenderTargetMaterialSourceView;
+    /** Renderer-local physical view, present only for the active generation. */
+    readonly textureView?: TextureView;
+}
+export interface RenderTargetMaterialSourceExpectation {
+    readonly target: RenderTarget;
+    readonly generation: number;
+    readonly shape: RenderTargetDescriptor['shape'];
+    readonly format: RenderTargetDescriptor['format'];
+    readonly dimension: RenderTargetTextureSourceOptions['dimension'];
+    readonly mipLevel: number;
+}
+/** Resolve a source only inside the renderer-owned material projection. */
+export declare function resolveRenderTargetMaterialSource(source: RenderTargetTextureSource): RenderTargetMaterialSourceBinding | undefined;
+export declare function createRenderTargetMaterialSource(target: RenderTarget, descriptor: RenderTargetDescriptor, options: RenderTargetTextureSourceOptions & {
+    readonly generation: number;
+}): RenderResult<RenderTargetMaterialSourceBinding, RenderError>;
+export declare function validateRenderTargetMaterialSource(binding: RenderTargetMaterialSourceBinding, expected: RenderTargetMaterialSourceExpectation): RenderResult<void, RenderError>;
+//# sourceMappingURL=material-source.d.ts.map

package/dist/targets/material-source.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"material-source.d.ts","sourceRoot":"","sources":["../../src/targets/material-source.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAKpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EACV,YAAY,EACZ,sBAAsB,EACtB,yBAAyB,EACzB,gCAAgC,EACjC,MAAM,aAAa,CAAC;AAErB,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,SAAS,EAAE,gCAAgC,CAAC,WAAW,CAAC,CAAC;IAClE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,eAAe,EAAE,OAAO,CAAC;CACnC;AAED,MAAM,WAAW,iCAAiC;IAChD,QAAQ,CAAC,MAAM,EAAE,yBAAyB,CAAC;IAC3C,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAChD,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAC,QAAQ,CAAC,CAAC;IAClD,QAAQ,CAAC,IAAI,EAAE,8BAA8B,CAAC;IAC9C,4EAA4E;IAC5E,QAAQ,CAAC,WAAW,CAAC,EAAE,WAAW,CAAC;CACpC;AAED,MAAM,WAAW,qCAAqC;IACpD,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,sBAAsB,CAAC,OAAO,CAAC,CAAC;IAChD,QAAQ,CAAC,MAAM,EAAE,sBAAsB,CAAC,QAAQ,CAAC,CAAC;IAClD,QAAQ,CAAC,SAAS,EAAE,gCAAgC,CAAC,WAAW,CAAC,CAAC;IAClE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAQD,2EAA2E;AAC3E,wBAAgB,iCAAiC,CAC/C,MAAM,EAAE,yBAAyB,GAChC,iCAAiC,GAAG,SAAS,CAE/C;AAaD,wBAAgB,gCAAgC,CAC9C,MAAM,EAAE,YAAY,EACpB,UAAU,EAAE,sBAAsB,EAClC,OAAO,EAAE,gCAAgC,GAAG;IAAE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAAE,GAC1E,YAAY,CAAC,iCAAiC,EAAE,WAAW,CAAC,CAgC9D;AAED,wBAAgB,kCAAkC,CAChD,OAAO,EAAE,iCAAiC,EAC1C,QAAQ,EAAE,qCAAqC,GAC9C,YAAY,CAAC,IAAI,EAAE,WAAW,CAAC,CAqCjC"}

package/dist/targets/owner.d.ts

@@ -0,0 +1,32 @@
+import type { RenderError } from '../errors/render';
+import type { RenderResult } from '../render-contract';
+import type { RenderTarget, RenderTargetDescriptor } from './contracts';
+export type RenderTargetOwnerState = 'uninitialized' | 'candidate' | 'active' | 'rebuilding' | 'destroyed';
+export interface RenderTargetPhysicalCandidate {
+    readonly generation: number;
+    readonly descriptor: RenderTargetDescriptor;
+}
+export interface RenderTargetOwnerInspection {
+    readonly token: RenderTarget;
+    readonly state: RenderTargetOwnerState;
+    readonly generation: number;
+    readonly descriptor: RenderTargetDescriptor;
+    readonly candidate?: RenderTargetPhysicalCandidate;
+}
+export interface RenderTargetOwnerOptions {
+    readonly rendererId: symbol;
+    readonly initialGeneration: number;
+}
+export interface RenderTargetOwner {
+    create(descriptor: RenderTargetDescriptor): RenderResult<RenderTarget, RenderError>;
+    stage(target: RenderTarget, descriptor?: RenderTargetDescriptor): RenderResult<RenderTargetPhysicalCandidate, RenderError>;
+    promote(target: RenderTarget, generation: number): RenderResult<void, RenderError>;
+    rejectCandidate(target: RenderTarget, generation: number, stage: 'allocation' | 'compile' | 'write' | 'submit'): RenderResult<void, RenderError>;
+    beginRecovery(target: RenderTarget, generation: number): RenderResult<void, RenderError>;
+    finishRecovery(target: RenderTarget): RenderResult<void, RenderError>;
+    retire(target: RenderTarget, generation: number): RenderResult<void, RenderError>;
+    destroy(target: RenderTarget): RenderResult<void, RenderError>;
+    inspect(target: RenderTarget): RenderResult<RenderTargetOwnerInspection, RenderError>;
+}
+export declare function createRenderTargetOwner(options: RenderTargetOwnerOptions): RenderTargetOwner;
+//# sourceMappingURL=owner.d.ts.map

package/dist/targets/owner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"owner.d.ts","sourceRoot":"","sources":["../../src/targets/owner.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAExE,MAAM,MAAM,sBAAsB,GAC9B,eAAe,GACf,WAAW,GACX,QAAQ,GACR,YAAY,GACZ,WAAW,CAAC;AAEhB,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,sBAAsB,CAAC;CAC7C;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,sBAAsB,CAAC;IACvC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,sBAAsB,CAAC;IAC5C,QAAQ,CAAC,SAAS,CAAC,EAAE,6BAA6B,CAAC;CACpD;AAED,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;CACpC;AAED,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,UAAU,EAAE,sBAAsB,GAAG,YAAY,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC;IACpF,KAAK,CACH,MAAM,EAAE,YAAY,EACpB,UAAU,CAAC,EAAE,sBAAsB,GAClC,YAAY,CAAC,6BAA6B,EAAE,WAAW,CAAC,CAAC;IAC5D,OAAO,CAAC,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,GAAG,YAAY,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IACnF,eAAe,CACb,MAAM,EAAE,YAAY,EACpB,UAAU,EAAE,MAAM,EAClB,KAAK,EAAE,YAAY,GAAG,SAAS,GAAG,OAAO,GAAG,QAAQ,GACnD,YAAY,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IACnC,aAAa,CAAC,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,GAAG,YAAY,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IACzF,cAAc,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IACtE,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,GAAG,YAAY,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IAClF,OAAO,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IAC/D,OAAO,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,CAAC,2BAA2B,EAAE,WAAW,CAAC,CAAC;CACvF;AAgCD,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,wBAAwB,GAAG,iBAAiB,CAsI5F"}

package/dist/targets/physical.d.ts

@@ -0,0 +1,18 @@
+import type { Texture, TextureView } from '@forgeax/engine-rhi';
+import type { RenderTargetDescriptor } from './contracts';
+/** Renderer-private physical storage for one logical target generation. */
+export interface RenderTargetPhysical {
+    readonly generation: number;
+    readonly descriptor: RenderTargetDescriptor;
+    readonly texture: Texture;
+    readonly view: TextureView;
+    readonly mipViews: readonly TextureView[];
+    readonly colorTextures: readonly Texture[];
+    readonly faceViews: readonly TextureView[];
+    readonly depthTextures: readonly Texture[];
+    readonly depthViews: readonly TextureView[];
+    readonly resolveTexture?: Texture;
+    readonly resolveView: TextureView;
+    readonly resolveFaceViews: readonly TextureView[];
+}
+//# sourceMappingURL=physical.d.ts.map

package/dist/targets/physical.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"physical.d.ts","sourceRoot":"","sources":["../../src/targets/physical.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAChE,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAE1D,2EAA2E;AAC3E,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,UAAU,EAAE,sBAAsB,CAAC;IAC5C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,SAAS,WAAW,EAAE,CAAC;IAC1C,QAAQ,CAAC,aAAa,EAAE,SAAS,OAAO,EAAE,CAAC;IAC3C,QAAQ,CAAC,SAAS,EAAE,SAAS,WAAW,EAAE,CAAC;IAC3C,QAAQ,CAAC,aAAa,EAAE,SAAS,OAAO,EAAE,CAAC;IAC3C,QAAQ,CAAC,UAAU,EAAE,SAAS,WAAW,EAAE,CAAC;IAC5C,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAClC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,QAAQ,CAAC,gBAAgB,EAAE,SAAS,WAAW,EAAE,CAAC;CACnD"}

package/dist/targets/readback.d.ts

@@ -0,0 +1,39 @@
+import type { RenderError } from '../errors/render';
+import type { RenderResult } from '../render-contract';
+import type { RenderTarget } from './contracts';
+export interface RenderTargetReadbackReceipt {
+    readonly frameId: number;
+    readonly deviceGeneration: number;
+}
+export interface RenderTargetReadbackTicketInput {
+    readonly frameId?: number;
+    deviceGeneration: number;
+    readonly mipLevel: number;
+    readonly face?: number;
+    readonly width: number;
+    readonly height: number;
+    readonly bytesPerPixel: number;
+}
+export interface RenderTargetReadbackTicket {
+    readonly target: RenderTarget;
+    frameId: number | undefined;
+    deviceGeneration: number;
+    readonly mipLevel: number;
+    readonly face?: number;
+    readonly width: number;
+    readonly height: number;
+    readonly bytesPerRow: number;
+    readonly byteLength: number;
+    consumed: boolean;
+}
+export interface RenderTargetReadbackResult {
+    readonly bytes: Uint8Array;
+    readonly frameId: number;
+    readonly deviceGeneration: number;
+    readonly mipLevel: number;
+    readonly face?: number;
+}
+export declare function bindRenderTargetReadbackTicket(ticket: RenderTargetReadbackTicket, receipt: RenderTargetReadbackReceipt): RenderResult<void, RenderError>;
+export declare function createRenderTargetReadbackTicket(target: RenderTarget, input: RenderTargetReadbackTicketInput): RenderResult<RenderTargetReadbackTicket, RenderError>;
+export declare function completeRenderTargetReadback(ticket: RenderTargetReadbackTicket, receipt: RenderTargetReadbackReceipt, bytes: Uint8Array): RenderResult<RenderTargetReadbackResult, RenderError>;
+//# sourceMappingURL=readback.d.ts.map

package/dist/targets/readback.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"readback.d.ts","sourceRoot":"","sources":["../../src/targets/readback.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AAEpD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAEhD,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;CACnC;AAED,MAAM,WAAW,+BAA+B;IAC9C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,OAAO,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5B,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;CACxB;AAiBD,wBAAgB,8BAA8B,CAC5C,MAAM,EAAE,0BAA0B,EAClC,OAAO,EAAE,2BAA2B,GACnC,YAAY,CAAC,IAAI,EAAE,WAAW,CAAC,CAQjC;AAED,wBAAgB,gCAAgC,CAC9C,MAAM,EAAE,YAAY,EACpB,KAAK,EAAE,+BAA+B,GACrC,YAAY,CAAC,0BAA0B,EAAE,WAAW,CAAC,CA0CvD;AAED,wBAAgB,4BAA4B,CAC1C,MAAM,EAAE,0BAA0B,EAClC,OAAO,EAAE,2BAA2B,EACpC,KAAK,EAAE,UAAU,GAChB,YAAY,CAAC,0BAA0B,EAAE,WAAW,CAAC,CAgCvD"}

package/dist/temporal/frame.d.ts

@@ -0,0 +1,44 @@
+import { type Result } from '@forgeax/engine-types';
+import { TemporalFrameSubmitError } from '../errors/render';
+export type TemporalResetReason = 'none' | 'camera-cut' | 'resize' | 'signature-change' | 'depth-discontinuity' | 'out-of-screen' | 'queue-submit-failed' | 'device-recovery';
+export interface TemporalFrameInput {
+    readonly frameId: number;
+    readonly currentViewProjection: Float32Array;
+    readonly jitter: readonly [number, number];
+    readonly viewport: {
+        readonly width: number;
+        readonly height: number;
+    };
+    /** Current camera origin, retained only as accepted temporal history. */
+    readonly cameraPosition?: readonly [number, number, number];
+    readonly resetReason?: Exclude<TemporalResetReason, 'none' | 'queue-submit-failed'>;
+}
+export interface TemporalFrame {
+    readonly frameId: number;
+    readonly currentViewProjection: Float32Array;
+    readonly previousViewProjection: Float32Array | undefined;
+    readonly jitter: readonly [number, number];
+    readonly viewport: {
+        readonly width: number;
+        readonly height: number;
+    };
+    readonly currentCameraPosition: readonly [number, number, number];
+    readonly previousCameraPosition: readonly [number, number, number] | undefined;
+    readonly resetReason: TemporalResetReason;
+    readonly historyEpoch: number;
+    readonly deviceEpoch: number;
+}
+export interface TemporalSubmitResult {
+    readonly accepted: boolean;
+    readonly reason?: 'queue-submit-failed';
+    readonly resetReason?: Exclude<TemporalResetReason, 'none' | 'queue-submit-failed'>;
+}
+export interface TemporalFrameTransaction {
+    stage(input: TemporalFrameInput): void;
+    commit(submit: TemporalSubmitResult): Result<TemporalFrame, TemporalFrameSubmitError>;
+    snapshot(): TemporalFrame;
+}
+export declare function createTemporalFrameTransaction(options: {
+    readonly deviceEpoch: number;
+}): TemporalFrameTransaction;
+//# sourceMappingURL=frame.d.ts.map

package/dist/temporal/frame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frame.d.ts","sourceRoot":"","sources":["../../src/temporal/frame.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAE5D,MAAM,MAAM,mBAAmB,GAC3B,MAAM,GACN,YAAY,GACZ,QAAQ,GACR,kBAAkB,GAClB,qBAAqB,GACrB,eAAe,GACf,qBAAqB,GACrB,iBAAiB,CAAC;AAEtB,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,qBAAqB,EAAE,YAAY,CAAC;IAC7C,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3C,QAAQ,CAAC,QAAQ,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACvE,yEAAyE;IACzE,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAC5D,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC,mBAAmB,EAAE,MAAM,GAAG,qBAAqB,CAAC,CAAC;CACrF;AAED,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,qBAAqB,EAAE,YAAY,CAAC;IAC7C,QAAQ,CAAC,sBAAsB,EAAE,YAAY,GAAG,SAAS,CAAC;IAC1D,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3C,QAAQ,CAAC,QAAQ,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;IACvE,QAAQ,CAAC,qBAAqB,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAClE,QAAQ,CAAC,sBAAsB,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC;IAC/E,QAAQ,CAAC,WAAW,EAAE,mBAAmB,CAAC;IAC1C,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,qBAAqB,CAAC;IACxC,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAC,mBAAmB,EAAE,MAAM,GAAG,qBAAqB,CAAC,CAAC;CACrF;AAED,MAAM,WAAW,wBAAwB;IACvC,KAAK,CAAC,KAAK,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACvC,MAAM,CAAC,MAAM,EAAE,oBAAoB,GAAG,MAAM,CAAC,aAAa,EAAE,wBAAwB,CAAC,CAAC;IACtF,QAAQ,IAAI,aAAa,CAAC;CAC3B;AAgCD,wBAAgB,8BAA8B,CAAC,OAAO,EAAE;IACtD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B,GAAG,wBAAwB,CA+C3B"}

package/dist/temporal/index.mjs

@@ -1,8 +1,8 @@
-export { addStandardSceneDataPass, addTaaResolvePass, aggregateTemporalDemand, createStandardSceneDataTarget, describeTemporalDemand, standardTemporalLaneAdmission, standardTemporalPostOrder } from '../chunk-RJRUS55L.mjs';
+export { addStandardSceneDataPass, addTaaResolvePass, aggregateTemporalDemand, createStandardSceneDataTarget, describeTemporalDemand, standardTemporalLaneAdmission, standardTemporalPostOrder } from '../chunk-5YADUCA7.mjs';
 import '../chunk-RXZ3RGOU.mjs';
-export { SCENE_DATA_TEMPORAL_V1_DESCRIPTOR, SCENE_DATA_TEMPORAL_V1_SCHEMA, createSceneDataCatalog, isSceneDataTarget, registerSceneDataTarget, sceneDataError, sceneDataTargetAsAttachment, sceneDataTargetOwner, sceneDataTokenMismatch } from '../chunk-LOSO4CTV.mjs';
+export { SCENE_DATA_TEMPORAL_V1_DESCRIPTOR, SCENE_DATA_TEMPORAL_V1_SCHEMA, createSceneDataCatalog, isSceneDataTarget, registerSceneDataTarget, sceneDataError, sceneDataTargetAsAttachment, sceneDataTargetOwner, sceneDataTokenMismatch } from '../chunk-6OPXDQ2E.mjs';
 import '../chunk-VFPLTKCU.mjs';
 export { TEMPORAL_JITTER_SAMPLE_COUNT, TemporalFrameCoordinator, classifySceneDataCoverage, createTemporalCoverage, projectTemporalView, scanSceneDataCoverage, snapshotSubmittedTemporalView, temporalJitterSample, temporalViewId } from '../chunk-PCHBPYML.mjs';
-import '../chunk-IPXCABEP.mjs';
+import '../chunk-BXBQQKFQ.mjs';
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

package/dist/typed-render-graph-primitives.d.ts

@@ -60,6 +60,8 @@ export interface TypedFullscreenPassOptions {
         readonly key: string;
         readonly target: RenderPipelineTarget;
     }[];
+    /** Optional per-pass copy of the params UBO payload. */
+    readonly paramsTransform?: ((params: Uint8Array | undefined) => Uint8Array | undefined) | undefined;
 }
 export interface TypedTemporalResolveTargets {
     readonly scene: RenderPipelineTarget;
@@ -76,5 +78,8 @@ export declare function addTypedCompositePostEffects(graph: RenderGraphBuilder<R
     readonly width: number;
     readonly height: number;
 }): Result<void, RenderGraphError>;
-export declare function addTypedOutputTransformPass(graph: RenderGraphBuilder<RenderPipelineFrame>, input: RenderPipelineTarget, output: RenderPipelineTarget, outputOnly?: boolean): Result<void, RenderGraphError>;
+export declare function addTypedOutputTransformPass(graph: RenderGraphBuilder<RenderPipelineFrame>, input: RenderPipelineTarget, output: RenderPipelineTarget, options?: {
+    readonly outputOnly?: boolean;
+    readonly dither?: boolean;
+}): Result<void, RenderGraphError>;
 //# sourceMappingURL=typed-render-graph-primitives.d.ts.map

package/dist/typed-render-graph-primitives.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"typed-render-graph-primitives.d.ts","sourceRoot":"","sources":["../src/typed-render-graph-primitives.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"typed-render-graph-primitives.d.ts","sourceRoot":"","sources":["../src/typed-render-graph-primitives.ts"],"names":[],"mappings":"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"}

package/dist/typed-shadow-atlas.d.ts

@@ -0,0 +1,10 @@
+export interface DirectionalShadowAtlasGrid {
+    readonly columns: 1 | 2;
+    readonly rows: 1 | 2;
+}
+/**
+ * The directional CSM atlas layout is one compact contract for raster writes
+ * and shader reads: 1 -> 1x1, 2 -> 2x1, and 3/4 -> 2x2.
+ */
+export declare function resolveDirectionalShadowAtlasGrid(cascadeCount: number): DirectionalShadowAtlasGrid;
+//# sourceMappingURL=typed-shadow-atlas.d.ts.map

package/dist/typed-shadow-atlas.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typed-shadow-atlas.d.ts","sourceRoot":"","sources":["../src/typed-shadow-atlas.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,CAAC,GAAG,CAAC,CAAC;CACtB;AAED;;;GAGG;AACH,wBAAgB,iCAAiC,CAC/C,YAAY,EAAE,MAAM,GACnB,0BAA0B,CAK5B"}

package/dist/typed-shadow-passes.d.ts

@@ -3,7 +3,7 @@ import { type Result } from '@forgeax/engine-types';
 import type { RenderPipelineFrame, RenderPipelineTopology } from './render-pipeline';
 import { type RenderPipelineTarget } from './render-pipeline';
 export interface TypedShadowTargets {
-    readonly directional: RenderPipelineTarget;
+    readonly directional?: RenderPipelineTarget | undefined;
     readonly spot: RenderPipelineTarget;
     readonly point?: RenderPipelineTarget | undefined;
 }

package/dist/typed-shadow-passes.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"typed-shadow-passes.d.ts","sourceRoot":"","sources":["../src/typed-shadow-passes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AACzF,OAAO,EAAM,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AASxD,OAAO,KAAK,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AACrF,OAAO,EAA8B,KAAK,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAE1F,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,WAAW,EAAE,oBAAoB,CAAC;IAC3C,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IACpC,QAAQ,CAAC,KAAK,CAAC,EAAE,oBAAoB,GAAG,SAAS,CAAC;CACnD;AAwBD,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,kBAAkB,CAAC,mBAAmB,CAAC,EAC9C,QAAQ,EAAE,sBAAsB,GAC/B,MAAM,CAAC,kBAAkB,EAAE,gBAAgB,CAAC,CAwH9C"}
+{"version":3,"file":"typed-shadow-passes.d.ts","sourceRoot":"","sources":["../src/typed-shadow-passes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AACzF,OAAO,EAAM,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AASxD,OAAO,KAAK,EAAE,mBAAmB,EAAE,sBAAsB,EAAE,MAAM,mBAAmB,CAAC;AACrF,OAAO,EAA8B,KAAK,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAG1F,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,WAAW,CAAC,EAAE,oBAAoB,GAAG,SAAS,CAAC;IACxD,QAAQ,CAAC,IAAI,EAAE,oBAAoB,CAAC;IACpC,QAAQ,CAAC,KAAK,CAAC,EAAE,oBAAoB,GAAG,SAAS,CAAC;CACnD;AAwBD,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,kBAAkB,CAAC,mBAAmB,CAAC,EAC9C,QAAQ,EAAE,sBAAsB,GAC/B,MAAM,CAAC,kBAAkB,EAAE,gBAAgB,CAAC,CA8H9C"}

package/dist/volume/capability.d.ts

@@ -0,0 +1,57 @@
+import { type EntityHandle, type World } from '@forgeax/engine-ecs';
+import type { RhiCaps } from '@forgeax/engine-rhi';
+/**
+ * The single capability predicate for the authored volumetric-fog producer.
+ * Shader sources are part of the device-bound bundle: compute/storage alone
+ * is not enough to claim that the three fused graph passes can execute.
+ */
+export declare function hasVolumetricFogCapability(caps: Pick<RhiCaps, 'compute' | 'storageTexture'>, shaders: unknown): boolean;
+export type VolumetricFogLightKind = 'directional' | 'point' | 'spot';
+export type VolumetricFogLightResolution = {
+    readonly status: 'available';
+    readonly entity: EntityHandle;
+    readonly kind: VolumetricFogLightKind;
+} | {
+    readonly status: 'unresolved';
+    readonly reason: 'missing-entity' | 'wrong-component' | 'ambiguous';
+    readonly entity: EntityHandle;
+    readonly expected: 'DirectionalLight | PointLight | SpotLight';
+    readonly actual: string;
+    readonly hint: string;
+};
+export type VolumetricFogLightPairResolution = {
+    readonly status: 'available';
+    readonly mode: 'point-spot';
+    readonly point: EntityHandle;
+    readonly spot: EntityHandle;
+} | {
+    readonly status: 'unresolved';
+    readonly reason: 'missing-entity' | 'same-entity' | 'wrong-component';
+    readonly point: EntityHandle;
+    readonly spot: EntityHandle;
+    readonly expected: 'PointLight + SpotLight in the same World';
+    readonly actual: string;
+    readonly hint: string;
+};
+/** Resolve the narrow official Point+Spot pair without creating a light owner. */
+export declare function resolveVolumetricFogLightPair(world: World, point: EntityHandle, spot: EntityHandle): VolumetricFogLightPairResolution;
+/**
+ * Resolve the required VolumetricFog.light reference in its owning World.
+ * PointLight is a valid primary selection for the exact Point+Spot pair.
+ * EntityHandle has no portable world tag, so a handle absent from this World
+ * (the same World contract) is reported as missing-entity;
+ * is reported as missing-entity; callers must not manufacture a light.
+ */
+export declare function resolveSelectedVolumetricLight(world: World, entity: EntityHandle): VolumetricFogLightResolution;
+export interface IntegratedVolumeResource {
+    /** Logical resolved-volume identity; this is not a physical graph resource. */
+    readonly identity: 'volume-integrated';
+    readonly format: 'rgba16float';
+    readonly stage: 'resolved';
+}
+export type VolumeConsumer = 'opaque' | 'transparent' | 'sprite' | 'vfx' | 'custom';
+export declare function resolveIntegratedVolumeConsumer(resource: IntegratedVolumeResource, consumer: VolumeConsumer): {
+    readonly consumer: VolumeConsumer;
+    readonly resource: IntegratedVolumeResource;
+};
+//# sourceMappingURL=capability.d.ts.map

package/dist/volume/capability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capability.d.ts","sourceRoot":"","sources":["../../src/volume/capability.ts"],"names":[],"mappings":"AAAA,OAAO,EAAU,KAAK,YAAY,EAAE,KAAK,KAAK,EAAE,MAAM,qBAAqB,CAAC;AAC5E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,qBAAqB,CAAC;AAMnD;;;;GAIG;AACH,wBAAgB,0BAA0B,CACxC,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,SAAS,GAAG,gBAAgB,CAAC,EACjD,OAAO,EAAE,OAAO,GACf,OAAO,CAET;AAED,MAAM,MAAM,sBAAsB,GAAG,aAAa,GAAG,OAAO,GAAG,MAAM,CAAC;AAGtE,MAAM,MAAM,4BAA4B,GACpC;IACE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,IAAI,EAAE,sBAAsB,CAAC;CACvC,GACD;IACE,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,gBAAgB,GAAG,iBAAiB,GAAG,WAAW,CAAC;IACpE,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,QAAQ,EAAE,2CAA2C,CAAC;IAC/D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB,CAAC;AAEN,MAAM,MAAM,gCAAgC,GACxC;IACE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;CAC7B,GACD;IACE,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,MAAM,EAAE,gBAAgB,GAAG,aAAa,GAAG,iBAAiB,CAAC;IACtE,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,YAAY,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,0CAA0C,CAAC;IAC9D,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;CACvB,CAAC;AAEN,kFAAkF;AAClF,wBAAgB,6BAA6B,CAC3C,KAAK,EAAE,KAAK,EACZ,KAAK,EAAE,YAAY,EACnB,IAAI,EAAE,YAAY,GACjB,gCAAgC,CAsClC;AAED;;;;;;GAMG;AACH,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,KAAK,EACZ,MAAM,EAAE,YAAY,GACnB,4BAA4B,CA4C9B;AAED,MAAM,WAAW,wBAAwB;IACvC,+EAA+E;IAC/E,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;CAC5B;AAED,MAAM,MAAM,cAAc,GAAG,QAAQ,GAAG,aAAa,GAAG,QAAQ,GAAG,KAAK,GAAG,QAAQ,CAAC;AAEpF,wBAAgB,+BAA+B,CAC7C,QAAQ,EAAE,wBAAwB,EAClC,QAAQ,EAAE,cAAc,GACvB;IAAE,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,wBAAwB,CAAA;CAAE,CAKpF"}

package/dist/volume/component.d.ts

@@ -0,0 +1,61 @@
+import { type EntityHandle } from '@forgeax/engine-ecs';
+import { type Result } from '@forgeax/engine-types';
+import { type VolumeError } from '../errors/render';
+export interface VolumeDensityBinding {
+    readonly guid: string;
+    readonly generation: number;
+    readonly shape: {
+        readonly viewDimension: '2d' | '2d-array' | '3d';
+        readonly extent: {
+            readonly width: number;
+            readonly height: number;
+            readonly depth?: number;
+            readonly layers?: number;
+        };
+    };
+    readonly format: string;
+    readonly colorSpace?: 'linear' | 'srgb';
+}
+export interface VolumeBounds {
+    readonly min: readonly [number, number, number];
+    readonly max: readonly [number, number, number];
+}
+export interface VolumetricFogAuthoring {
+    /** Invalid authoring reports closed code, expected, hint, and detail fields. */
+    /** The selected DirectionalLight or PointLight in this World. */
+    readonly light: EntityHandle;
+    /** The optional same-World SpotLight paired with a PointLight. */
+    readonly spotLight?: EntityHandle;
+    readonly density: VolumeDensityBinding;
+    readonly bounds: VolumeBounds;
+    readonly extinction: readonly [number, number, number];
+    readonly albedo: readonly [number, number, number];
+    readonly emission: readonly [number, number, number];
+    readonly anisotropy: number;
+    readonly maxDistance: number;
+    readonly ownerCount?: number;
+}
+export type VolumetricFogLightSelection = {
+    readonly light: EntityHandle;
+    readonly spotLight?: undefined;
+} | {
+    readonly light: EntityHandle;
+    readonly spotLight: EntityHandle;
+};
+export interface ValidatedVolumetricFog extends VolumetricFogAuthoring {
+    readonly ownerCount: 1;
+}
+export declare const VolumetricFog: import("@forgeax/engine-ecs").Component<"VolumetricFog", {
+    readonly light: "entity";
+    readonly spotLight: "entity";
+    readonly density: "shared<TextureAsset>";
+    readonly boundsMin: "array<f32, 3>";
+    readonly boundsMax: "array<f32, 3>";
+    readonly extinction: "array<f32, 3>";
+    readonly albedo: "array<f32, 3>";
+    readonly emission: "array<f32, 3>";
+    readonly anisotropy: "f32";
+    readonly maxDistance: "f32";
+}>;
+export declare function validateVolumetricFog(input: VolumetricFogAuthoring): Result<ValidatedVolumetricFog, VolumeError>;
+//# sourceMappingURL=component.d.ts.map

package/dist/volume/component.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"component.d.ts","sourceRoot":"","sources":["../../src/volume/component.ts"],"names":[],"mappings":"AAAA,OAAO,EAAmB,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACzE,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAEL,KAAK,WAAW,EAIjB,MAAM,kBAAkB,CAAC;AAE1B,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,KAAK,EAAE;QACd,QAAQ,CAAC,aAAa,EAAE,IAAI,GAAG,UAAU,GAAG,IAAI,CAAC;QACjD,QAAQ,CAAC,MAAM,EAAE;YACf,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;YACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;YACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;YACxB,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;SAC1B,CAAC;KACH,CAAC;IACF,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,UAAU,CAAC,EAAE,QAAQ,GAAG,MAAM,CAAC;CACzC;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IAChD,QAAQ,CAAC,GAAG,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;CACjD;AAED,MAAM,WAAW,sBAAsB;IACrC,gFAAgF;IAChF,iEAAiE;IACjE,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAC7B,kEAAkE;IAClE,QAAQ,CAAC,SAAS,CAAC,EAAE,YAAY,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,oBAAoB,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACvD,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACnD,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACrD,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,MAAM,2BAA2B,GACnC;IAAE,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,SAAS,CAAA;CAAE,GAChE;IAAE,QAAQ,CAAC,KAAK,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,SAAS,EAAE,YAAY,CAAA;CAAE,CAAC;AAEvE,MAAM,WAAW,sBAAuB,SAAQ,sBAAsB;IACpE,QAAQ,CAAC,UAAU,EAAE,CAAC,CAAC;CACxB;AAED,eAAO,MAAM,aAAa;;;;;;;;;;;EAWxB,CAAC;AAmBH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,sBAAsB,GAC5B,MAAM,CAAC,sBAAsB,EAAE,WAAW,CAAC,CAsB7C"}

package/dist/volume/extract.d.ts

@@ -0,0 +1,11 @@
+import { type Result } from '@forgeax/engine-types';
+import { type VolumeError } from '../errors/render';
+import { type ValidatedVolumetricFog, type VolumetricFogAuthoring } from './component';
+export type VolumetricFogExtract = {
+    readonly status: 'off';
+} | {
+    readonly status: 'available';
+    readonly fog: ValidatedVolumetricFog;
+};
+export declare function extractVolumetricFog(inputs: readonly VolumetricFogAuthoring[]): Result<VolumetricFogExtract, VolumeError>;
+//# sourceMappingURL=extract.d.ts.map

package/dist/volume/extract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extract.d.ts","sourceRoot":"","sources":["../../src/volume/extract.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,KAAK,WAAW,EAA4B,MAAM,kBAAkB,CAAC;AAC9E,OAAO,EACL,KAAK,sBAAsB,EAC3B,KAAK,sBAAsB,EAE5B,MAAM,aAAa,CAAC;AAErB,MAAM,MAAM,oBAAoB,GAC5B;IAAE,QAAQ,CAAC,MAAM,EAAE,KAAK,CAAA;CAAE,GAC1B;IAAE,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAAC,QAAQ,CAAC,GAAG,EAAE,sBAAsB,CAAA;CAAE,CAAC;AAE3E,wBAAgB,oBAAoB,CAClC,MAAM,EAAE,SAAS,sBAAsB,EAAE,GACxC,MAAM,CAAC,oBAAoB,EAAE,WAAW,CAAC,CAM3C"}