@forgeax/engine-render 0.1.19 → 0.1.20

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

package/dist/volume/inspection.d.ts

@@ -0,0 +1,38 @@
+import type { TextureFormat } from '@forgeax/engine-rhi';
+import type { VolumeRecoveryState, VolumeSelectedLightFacts } from './recovery';
+import type { VolumetricFogResourceFacts } from './resources';
+export type VolumetricFogInspectionStatus = 'off' | 'available' | 'unavailable' | 'degraded';
+export type VolumetricFogResourceStage = 'none' | 'candidate' | 'accepted' | 'lkg' | 'recovering';
+export interface VolumetricFogInspection {
+    readonly status: VolumetricFogInspectionStatus;
+    readonly resourceStage: VolumetricFogResourceStage;
+    readonly guid: string | undefined;
+    readonly generation: number | undefined;
+    readonly digest: string | undefined;
+    readonly candidateGeneration: number | undefined;
+    readonly candidateDigest: string | undefined;
+    readonly lkgGeneration: number | undefined;
+    readonly candidateFailure: VolumeRecoveryState['candidateFailure'];
+    readonly deviceEpoch: number;
+    readonly format: TextureFormat | undefined;
+    readonly passCount: number;
+    readonly sampleCount: number;
+    readonly memoryBytes: number;
+    readonly resourceFacts: VolumetricFogResourceFacts | undefined;
+    readonly selectedLight: VolumeSelectedLightFacts | undefined;
+    readonly candidateSelectedLight: VolumeSelectedLightFacts | undefined;
+}
+export interface VolumetricFogInspectionInput {
+    readonly authored: boolean;
+    readonly capability: 'available' | 'unavailable';
+    readonly degraded?: boolean;
+    readonly recovery?: VolumeRecoveryState;
+    readonly acceptedDigest?: string;
+    readonly format?: TextureFormat;
+    readonly passCount?: number;
+    readonly sampleCount?: number;
+    readonly memoryBytes?: number;
+    readonly resourceFacts?: VolumetricFogResourceFacts;
+}
+export declare function inspectVolumetricFog(input: VolumetricFogInspectionInput): VolumetricFogInspection;
+//# sourceMappingURL=inspection.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"inspection.d.ts","sourceRoot":"","sources":["../../src/volume/inspection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACzD,OAAO,KAAK,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,MAAM,YAAY,CAAC;AAChF,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,aAAa,CAAC;AAE9D,MAAM,MAAM,6BAA6B,GAAG,KAAK,GAAG,WAAW,GAAG,aAAa,GAAG,UAAU,CAAC;AAE7F,MAAM,MAAM,0BAA0B,GAAG,MAAM,GAAG,WAAW,GAAG,UAAU,GAAG,KAAK,GAAG,YAAY,CAAC;AAElG,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,MAAM,EAAE,6BAA6B,CAAC;IAC/C,QAAQ,CAAC,aAAa,EAAE,0BAA0B,CAAC;IACnD,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,SAAS,CAAC;IAClC,QAAQ,CAAC,UAAU,EAAE,MAAM,GAAG,SAAS,CAAC;IACxC,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC;IACpC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,GAAG,SAAS,CAAC;IACjD,QAAQ,CAAC,eAAe,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7C,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3C,QAAQ,CAAC,gBAAgB,EAAE,mBAAmB,CAAC,kBAAkB,CAAC,CAAC;IACnE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,aAAa,GAAG,SAAS,CAAC;IAC3C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,0BAA0B,GAAG,SAAS,CAAC;IAC/D,QAAQ,CAAC,aAAa,EAAE,wBAAwB,GAAG,SAAS,CAAC;IAC7D,QAAQ,CAAC,sBAAsB,EAAE,wBAAwB,GAAG,SAAS,CAAC;CACvE;AAED,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B,QAAQ,CAAC,UAAU,EAAE,WAAW,GAAG,aAAa,CAAC;IACjD,QAAQ,CAAC,QAAQ,CAAC,EAAE,OAAO,CAAC;IAC5B,QAAQ,CAAC,QAAQ,CAAC,EAAE,mBAAmB,CAAC;IACxC,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAC;IACjC,QAAQ,CAAC,MAAM,CAAC,EAAE,aAAa,CAAC;IAChC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,CAAC,EAAE,0BAA0B,CAAC;CACrD;AAUD,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,4BAA4B,GAAG,uBAAuB,CA4BjG"}

package/dist/volume/passes.d.ts

@@ -0,0 +1,38 @@
+import type { GraphBuffer, GraphTextureView, RenderGraphBuilder, RenderGraphError } from '@forgeax/engine-render-graph';
+import { type Result } from '@forgeax/engine-types';
+import type { RenderPipelineFrame, RenderPipelineTarget, RenderPipelineTopology } from '../render-pipeline';
+import type { VolumetricFogResources } from './resources';
+import type { VolumeProjectorTuple } from './temporal';
+export declare const VOLUMETRIC_FOG_PASS_ORDER: readonly ["volume-inject", "volume-integrate", "volume-temporal", "volume-composite"];
+export interface VolumetricFogTopology {
+    readonly passes: readonly string[];
+    readonly resources: readonly string[];
+    readonly colorInput: 'linear-hdr';
+    readonly depthInput: 'scene-depth';
+    readonly lightKind?: 'directional' | 'point' | 'spot';
+    readonly lightEntity?: number;
+    readonly lightRevision?: number;
+    readonly projector?: Pick<VolumeProjectorTuple, 'guid' | 'generation' | 'revision'>;
+}
+export declare function volumetricFogTopology(enabled: boolean, selectedLight?: {
+    readonly lightKind: 'directional' | 'point' | 'spot';
+    readonly lightEntity: number;
+    readonly lightRevision: number;
+}): VolumetricFogTopology;
+export interface VolumetricFogPassInputs {
+    readonly resources: VolumetricFogResources;
+    readonly linearHdr: RenderPipelineTarget;
+    readonly sceneDepth: GraphTextureView;
+    readonly density: GraphTextureView;
+    readonly params: GraphBuffer;
+    readonly view: GraphBuffer;
+    readonly directionalShadow: GraphTextureView;
+    readonly spotShadow: GraphTextureView;
+    readonly pointLights: GraphBuffer;
+    readonly spotLights: GraphBuffer;
+    readonly selectedLightKind: 'directional' | 'point' | 'spot';
+    readonly projector?: GraphTextureView;
+}
+export declare function addAuthoredVolumetricFogPasses(graph: RenderGraphBuilder<RenderPipelineFrame>, topology: RenderPipelineTopology, linearHdr: RenderPipelineTarget, sceneDepth: GraphTextureView, directionalShadow: GraphTextureView, spotShadow: GraphTextureView): Result<void, RenderGraphError>;
+export declare function addVolumetricFogPasses(graph: RenderGraphBuilder<RenderPipelineFrame>, inputs: VolumetricFogPassInputs): Result<void, RenderGraphError>;
+//# sourceMappingURL=passes.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"passes.d.ts","sourceRoot":"","sources":["../../src/volume/passes.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,WAAW,EACX,gBAAgB,EAChB,kBAAkB,EAClB,gBAAgB,EACjB,MAAM,8BAA8B,CAAC;AAWtC,OAAO,EAAM,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAcxD,OAAO,KAAK,EACV,mBAAmB,EACnB,oBAAoB,EACpB,sBAAsB,EACvB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,aAAa,CAAC;AAQ1D,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD,eAAO,MAAM,yBAAyB,uFAK5B,CAAC;AACX,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,SAAS,EAAE,SAAS,MAAM,EAAE,CAAC;IACtC,QAAQ,CAAC,UAAU,EAAE,YAAY,CAAC;IAClC,QAAQ,CAAC,UAAU,EAAE,aAAa,CAAC;IACnC,QAAQ,CAAC,SAAS,CAAC,EAAE,aAAa,GAAG,OAAO,GAAG,MAAM,CAAC;IACtD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC,oBAAoB,EAAE,MAAM,GAAG,YAAY,GAAG,UAAU,CAAC,CAAC;CACrF;AACD,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,OAAO,EAChB,aAAa,CAAC,EAAE;IACd,QAAQ,CAAC,SAAS,EAAE,aAAa,GAAG,OAAO,GAAG,MAAM,CAAC;IACrD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC,GACA,qBAAqB,CAevB;AACD,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,SAAS,EAAE,sBAAsB,CAAC;IAC3C,QAAQ,CAAC,SAAS,EAAE,oBAAoB,CAAC;IACzC,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,gBAAgB,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,iBAAiB,EAAE,gBAAgB,CAAC;IAC7C,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAC;IACtC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC;IACjC,QAAQ,CAAC,iBAAiB,EAAE,aAAa,GAAG,OAAO,GAAG,MAAM,CAAC;IAC7D,QAAQ,CAAC,SAAS,CAAC,EAAE,gBAAgB,CAAC;CACvC;AAqLD,wBAAgB,8BAA8B,CAC5C,KAAK,EAAE,kBAAkB,CAAC,mBAAmB,CAAC,EAC9C,QAAQ,EAAE,sBAAsB,EAChC,SAAS,EAAE,oBAAoB,EAC/B,UAAU,EAAE,gBAAgB,EAC5B,iBAAiB,EAAE,gBAAgB,EACnC,UAAU,EAAE,gBAAgB,GAC3B,MAAM,CAAC,IAAI,EAAE,gBAAgB,CAAC,CA2BhC;AACD,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,kBAAkB,CAAC,mBAAmB,CAAC,EAC9C,MAAM,EAAE,uBAAuB,GAC9B,MAAM,CAAC,IAAI,EAAE,gBAAgB,CAAC,CA2WhC"}

package/dist/volume/recovery.d.ts

@@ -0,0 +1,38 @@
+import type { VolumeProjectorTuple } from './temporal';
+export interface VolumeSelectedLightFacts {
+    readonly entity: number;
+    readonly kind: 'directional' | 'point' | 'spot';
+    readonly revision: number;
+    readonly shadowTile: number;
+    readonly pointLightEntity?: number;
+    readonly spotLightEntity?: number;
+    readonly projector?: VolumeProjectorTuple;
+}
+export interface VolumeRecoveryState {
+    readonly guid: string;
+    readonly generation: number;
+    readonly deviceEpoch: number;
+    readonly status: 'accepted' | 'candidate' | 'degraded' | 'recovering';
+    readonly candidateGeneration?: number;
+    readonly candidateDigest?: string;
+    readonly lkgGeneration?: number;
+    readonly candidateFailure?: 'submit-failed' | 'stale-generation' | 'missing-selected-light' | 'missing-shadow';
+    readonly selectedLight?: VolumeSelectedLightFacts;
+    readonly candidateSelectedLight?: VolumeSelectedLightFacts;
+}
+export type VolumeRecoveryEvent = {
+    readonly kind: 'submit-failed';
+} | {
+    readonly kind: 'device-lost';
+    readonly deviceEpoch: number;
+} | {
+    readonly kind: 'accepted';
+    readonly generation: number;
+};
+export declare function stageVolumetricFog(state: VolumeRecoveryState, candidate: {
+    readonly generation: number;
+    readonly digest: string;
+    readonly selectedLight?: VolumeSelectedLightFacts;
+}): VolumeRecoveryState;
+export declare function recoverVolumetricFog(state: VolumeRecoveryState, event: VolumeRecoveryEvent): VolumeRecoveryState;
+//# sourceMappingURL=recovery.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"recovery.d.ts","sourceRoot":"","sources":["../../src/volume/recovery.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,YAAY,CAAC;AAEvD,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,GAAG,MAAM,CAAC;IAChD,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,SAAS,CAAC,EAAE,oBAAoB,CAAC;CAC3C;AAED,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,WAAW,GAAG,UAAU,GAAG,YAAY,CAAC;IACtE,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,gBAAgB,CAAC,EACtB,eAAe,GACf,kBAAkB,GAClB,wBAAwB,GACxB,gBAAgB,CAAC;IACrB,QAAQ,CAAC,aAAa,CAAC,EAAE,wBAAwB,CAAC;IAClD,QAAQ,CAAC,sBAAsB,CAAC,EAAE,wBAAwB,CAAC;CAC5D;AAED,MAAM,MAAM,mBAAmB,GAC3B;IAAE,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAA;CAAE,GAClC;IAAE,QAAQ,CAAC,IAAI,EAAE,aAAa,CAAC;IAAC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAA;CAAE,GAC9D;IAAE,QAAQ,CAAC,IAAI,EAAE,UAAU,CAAC;IAAC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/D,wBAAgB,kBAAkB,CAChC,KAAK,EAAE,mBAAmB,EAC1B,SAAS,EAAE;IACT,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,aAAa,CAAC,EAAE,wBAAwB,CAAC;CACnD,GACA,mBAAmB,CAUrB;AAED,wBAAgB,oBAAoB,CAClC,KAAK,EAAE,mBAAmB,EAC1B,KAAK,EAAE,mBAAmB,GACzB,mBAAmB,CA6BrB"}

package/dist/volume/resources.d.ts

@@ -0,0 +1,57 @@
+import type { CompiledRenderGraphInfo, GraphTexture, GraphTextureView, RenderGraphBuilder, RenderGraphError } from '@forgeax/engine-render-graph';
+import { type Result } from '@forgeax/engine-types';
+import type { RenderPipelineFrame } from '../render-pipeline';
+export declare const VOLUME_FROXEL_FORMAT: "rgba8unorm";
+export declare const VOLUME_HISTORY_FORMAT: "rgba16float";
+export declare const VOLUME_RESOLVED_FORMAT: "rgba16float";
+export declare const VOLUME_DEPTH_FORMAT: "r32float";
+export declare const VOLUME_PACKING_Z = 4;
+/** Renderer-owned parameter allocation shared by staging and inspection. */
+export declare const VOLUMETRIC_FOG_PARAMS_BYTES: number;
+export interface VolumetricFogExtent {
+    readonly width: number;
+    readonly height: number;
+    readonly depth: number;
+}
+/** Derive the renderer's high profile grid from the actual surface descriptor. */
+export declare function deriveVolumetricFogExtent(surface: {
+    readonly width: number;
+    readonly height: number;
+}, depth?: number, tileSize?: number): VolumetricFogExtent;
+/** Derive the 2D resolve extent from the same profile tile without a second profile. */
+export declare function deriveVolumetricFogResolvedExtent(surface: {
+    readonly width: number;
+    readonly height: number;
+}, froxelTileSize?: number): VolumetricFogExtent;
+export interface VolumetricFogResources {
+    readonly extent: VolumetricFogExtent;
+    readonly resolvedExtent: VolumetricFogExtent;
+    readonly froxel: GraphTexture;
+    readonly froxelView: GraphTextureView;
+    readonly resolved: GraphTexture;
+    readonly resolvedView: GraphTextureView;
+    readonly history: GraphTexture;
+    readonly historyView: GraphTextureView;
+    readonly temporal: GraphTexture;
+    readonly temporalView: GraphTextureView;
+}
+export interface VolumetricFogResourceFacts {
+    readonly generation: number;
+    readonly liveResourceCount: number;
+    readonly currentBytes: number;
+    readonly historyBytes: number;
+    readonly scratchBytes: number;
+    readonly bufferBytes: number;
+    readonly totalBytes: number;
+    readonly physicalResourceCount: number;
+    readonly sampleCount: number;
+    readonly resolvedPixelCount: number;
+}
+/** Project graph descriptors into the volume inspection without a second ledger. */
+export interface VolumetricFogResourceInspectionOptions {
+    /** Number of non-null parameter buffers retained by the frame owner. */
+    readonly parameterBufferCount?: number;
+}
+export declare function inspectVolumetricFogResources(graph: CompiledRenderGraphInfo, options?: VolumetricFogResourceInspectionOptions): VolumetricFogResourceFacts;
+export declare function createVolumetricFogResources(graph: RenderGraphBuilder<RenderPipelineFrame>, extent?: VolumetricFogExtent, resolvedExtent?: VolumetricFogExtent): Result<VolumetricFogResources, RenderGraphError>;
+//# sourceMappingURL=resources.d.ts.map

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

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

package/dist/volume/temporal.d.ts

@@ -0,0 +1,35 @@
+export interface VolumeTemporalSignature {
+    readonly cameraRevision: number;
+    readonly fogRevision: number;
+    readonly lightRevision: number;
+    readonly densityGeneration: number;
+    readonly width: number;
+    readonly height: number;
+    readonly lightKind?: 'directional' | 'point' | 'spot';
+    readonly lightEntity?: number;
+    readonly pointLightEntity?: number;
+    readonly spotLightEntity?: number;
+    readonly projector?: VolumeProjectorTuple;
+    readonly lightShadowRevision?: number;
+}
+/** Accepted projector facts shared by surface and volume consumers. */
+export interface VolumeProjectorTuple {
+    readonly guid: string;
+    readonly generation: number;
+    readonly view: string;
+    readonly sampler: string;
+    readonly projection: string;
+    readonly revision: number;
+}
+export type VolumeTemporalResetReason = 'camera-cut' | 'fog-revision' | 'light-revision' | 'density-generation' | 'resize' | 'reprojection-out-of-screen' | 'reprojection-depth-discontinuity';
+export type VolumeTemporalReset = {
+    readonly reset: false;
+} | {
+    readonly reset: true;
+    readonly reason: VolumeTemporalResetReason;
+};
+export declare function resolveVolumeTemporalReset(previous: VolumeTemporalSignature, next: VolumeTemporalSignature, options?: {
+    readonly taaEnabled?: boolean;
+    readonly reprojection?: 'out-of-screen' | 'depth-discontinuity';
+}): VolumeTemporalReset;
+//# sourceMappingURL=temporal.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"temporal.d.ts","sourceRoot":"","sources":["../../src/volume/temporal.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,SAAS,CAAC,EAAE,aAAa,GAAG,OAAO,GAAG,MAAM,CAAC;IACtD,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,SAAS,CAAC,EAAE,oBAAoB,CAAC;IAC1C,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;CACvC;AAED,uEAAuE;AACvE,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,MAAM,yBAAyB,GACjC,YAAY,GACZ,cAAc,GACd,gBAAgB,GAChB,oBAAoB,GACpB,QAAQ,GACR,4BAA4B,GAC5B,kCAAkC,CAAC;AAEvC,MAAM,MAAM,mBAAmB,GAC3B;IAAE,QAAQ,CAAC,KAAK,EAAE,KAAK,CAAA;CAAE,GACzB;IAAE,QAAQ,CAAC,KAAK,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,yBAAyB,CAAA;CAAE,CAAC;AAEzE,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE,uBAAuB,EACjC,IAAI,EAAE,uBAAuB,EAC7B,OAAO,GAAE;IACP,QAAQ,CAAC,UAAU,CAAC,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,YAAY,CAAC,EAAE,eAAe,GAAG,qBAAqB,CAAC;CAC5D,GACL,mBAAmB,CA2CrB"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@forgeax/engine-render",
-  "version": "0.1.19",
+  "version": "0.1.20",
   "description": "Canonical ECS render schemas and renderer boundary.",
   "private": false,
   "type": "module",
@@ -37,27 +37,27 @@
     "LICENSE"
   ],
   "dependencies": {
-    "@forgeax/engine-assets-runtime": "0.1.19",
-    "@forgeax/engine-audio-webaudio": "0.1.19",
-    "@forgeax/engine-codec": "0.1.19",
-    "@forgeax/engine-ecs": "0.1.19",
-    "@forgeax/engine-geometry": "0.1.19",
-    "@forgeax/engine-graphics-extras": "0.1.19",
-    "@forgeax/engine-math": "0.1.19",
-    "@forgeax/engine-pack": "0.1.19",
-    "@forgeax/engine-plugin": "0.1.19",
-    "@forgeax/engine-profiler": "0.1.19",
-    "@forgeax/engine-render-graph": "0.1.19",
-    "@forgeax/engine-rhi": "0.1.19",
-    "@forgeax/engine-scene": "0.1.19",
-    "@forgeax/engine-shader": "0.1.19",
-    "@forgeax/engine-skinning": "0.1.19",
-    "@forgeax/engine-types": "0.1.19"
+    "@forgeax/engine-assets-runtime": "0.1.20",
+    "@forgeax/engine-audio-webaudio": "0.1.20",
+    "@forgeax/engine-codec": "0.1.20",
+    "@forgeax/engine-ecs": "0.1.20",
+    "@forgeax/engine-geometry": "0.1.20",
+    "@forgeax/engine-graphics-extras": "0.1.20",
+    "@forgeax/engine-math": "0.1.20",
+    "@forgeax/engine-pack": "0.1.20",
+    "@forgeax/engine-plugin": "0.1.20",
+    "@forgeax/engine-profiler": "0.1.20",
+    "@forgeax/engine-render-graph": "0.1.20",
+    "@forgeax/engine-rhi": "0.1.20",
+    "@forgeax/engine-scene": "0.1.20",
+    "@forgeax/engine-shader": "0.1.20",
+    "@forgeax/engine-skinning": "0.1.20",
+    "@forgeax/engine-types": "0.1.20"
   },
   "devDependencies": {
-    "@forgeax/engine-rhi-null": "0.1.19",
-    "@forgeax/engine-rhi-webgpu": "0.1.19",
-    "@forgeax/engine-vite-plugin-shader": "0.1.19"
+    "@forgeax/engine-rhi-null": "0.1.20",
+    "@forgeax/engine-rhi-webgpu": "0.1.20",
+    "@forgeax/engine-vite-plugin-shader": "0.1.20"
   },
   "forgeax": {
     "metrics": {

package/src/__tests__/ktx2-basis-gpu-consumer.dawn.test.ts

@@ -343,12 +343,11 @@ async function textureFor(
       selected,
       texture: {
         kind: 'texture',
-        width: mip.width,
-        height: mip.height,
+        shape: { viewDimension: '2d', extent: { width: mip.width, height: mip.height } },
         format: selected,
         data: mip.data,
         colorSpace: input.colorSpace,
-        mipmap: false,
+        mips: { kind: 'none' },
       },
     };
   }
@@ -377,12 +376,11 @@ async function textureFor(
     selected,
     texture: {
       kind: 'texture',
-      width: mip.width,
-      height: mip.height,
+      shape: { viewDimension: '2d', extent: { width: mip.width, height: mip.height } },
       format: selected,
       data: mip.data,
       colorSpace: input.colorSpace,
-      mipmap: false,
+      mips: { kind: 'none' },
     },
   };
 }
@@ -392,6 +390,8 @@ async function readbackTexture(
   texture: TextureAsset,
   gpuTexture: { readonly handle: Texture },
 ): Promise<Uint8Array> {
+  const width = texture.shape.extent.width;
+  const height = texture.shape.extent.height;
   const hdr = texture.format === 'rgba16float' || texture.format.startsWith('bc6h');
   const outputFormat: GPUTextureFormat = hdr ? 'rgba16float' : 'rgba8unorm-srgb';
   const outputBytesPerPixel = hdr ? 8 : 4;
@@ -447,7 +447,7 @@ async function readbackTexture(
   });
   if (!bindings.ok) throw new Error(`${bindings.error.code}:${bindings.error.hint}`);
   const normalizedTexture = device.createTexture({
-    size: { width: texture.width, height: texture.height, depthOrArrayLayers: 1 },
+    size: { width, height, depthOrArrayLayers: 1 },
     format: outputFormat,
     usage: 0x10 | 0x01,
   } as never);
@@ -457,7 +457,7 @@ async function readbackTexture(
   if (!normalizedView.ok)
     throw new Error(`${normalizedView.error.code}:${normalizedView.error.hint}`);
   const readback = device.createBuffer({
-    size: 256 * texture.height,
+    size: 256 * height,
     usage: GPU_BUFFER_USAGE_COPY_DST | GPU_BUFFER_USAGE_MAP_READ,
   });
   if (!readback.ok) throw new Error(`${readback.error.code}:${readback.error.hint}`);
@@ -483,9 +483,9 @@ async function readbackTexture(
       buffer: readback.value as unknown as GPUBuffer,
       offset: 0,
       bytesPerRow: 256,
-      rowsPerImage: texture.height,
+      rowsPerImage: height,
     },
-    { width: texture.width, height: texture.height, depthOrArrayLayers: 1 },
+    { width, height, depthOrArrayLayers: 1 },
   );
   const command = encoder.value.finish();
   if (!command.ok) throw new Error(`${command.error.code}:${command.error.hint}`);
@@ -497,11 +497,11 @@ async function readbackTexture(
   const range = mapped.value.getMappedRange();
   if (!range.ok) throw new Error(`${range.error.code}:${range.error.hint}`);
   const mappedBytes = new Uint8Array(range.value);
-  const bytes = new Uint8Array(texture.width * texture.height * outputBytesPerPixel);
-  for (let row = 0; row < texture.height; row += 1) {
+  const bytes = new Uint8Array(width * height * outputBytesPerPixel);
+  for (let row = 0; row < height; row += 1) {
     bytes.set(
-      mappedBytes.subarray(row * 256, row * 256 + texture.width * outputBytesPerPixel),
-      row * texture.width * outputBytesPerPixel,
+      mappedBytes.subarray(row * 256, row * 256 + width * outputBytesPerPixel),
+      row * width * outputBytesPerPixel,
     );
   }
   mapped.value.unmap();

package/src/__tests__/mesh-buffer-usage-surface.unit.test.ts

@@ -71,7 +71,7 @@ describe('render buffer usage owner', () => {
     expect(GPU_BUFFER_USAGE_UNIFORM).toBe(0x40);
     expect(GPU_BUFFER_USAGE_STORAGE).toBe(0x80);
     expect(GPU_BUFFER_USAGE_MAP_READ).toBe(0x01);
-    expect(ownerSource.match(/export const GPU_BUFFER_USAGE_/g)).toHaveLength(8);
+    expect(ownerSource.match(/export const GPU_BUFFER_USAGE_/g)).toHaveLength(9);
   });
 
   it('routes mesh descriptor, update, and bootstrap consumers through the owner', () => {

package/src/__tests__/render-error-code-owner.test-d.ts

@@ -64,6 +64,11 @@ const expectedCodes = [
   'points-lines-material-unsupported',
   'points-lines-budget-exceeded',
   'points-lines-prepare-failed',
+  'volume-owner-conflict',
+  'volume-density-shape-mismatch',
+  'volume-invalid-bounds',
+  'volume-invalid-parameters',
+  'projector-binding-failed',
 ] as const satisfies readonly RenderErrorCode[];
 type ExpectedCodeUnion = (typeof expectedCodes)[number];
 

package/src/__tests__/renderer-factory-material-contract.unit.test.ts

@@ -187,6 +187,34 @@ describe('material shader variant identity', () => {
     ).toBe('STORAGE_BUFFER_AVAILABLE=true+VERTEX_COLOR_AVAILABLE=false');
   });
 
+  it('selects the projector-disabled PBR variant when the device exposes only 16 sampled textures', () => {
+    const variants = [
+      {
+        defines: {
+          CLUSTER_FORWARD_AVAILABLE: false,
+          PROJECTOR_AVAILABLE: false,
+          STORAGE_BUFFER_AVAILABLE: true,
+          VERTEX_COLOR_AVAILABLE: false,
+        },
+      },
+      {
+        defines: {
+          CLUSTER_FORWARD_AVAILABLE: false,
+          PROJECTOR_AVAILABLE: true,
+          STORAGE_BUFFER_AVAILABLE: true,
+          VERTEX_COLOR_AVAILABLE: false,
+        },
+      },
+    ];
+
+    expect(resolveMaterialShaderVariantSet(undefined, variants, 'webgpu', true, false)).toBe(
+      'CLUSTER_FORWARD_AVAILABLE=false+PROJECTOR_AVAILABLE=false+STORAGE_BUFFER_AVAILABLE=true+VERTEX_COLOR_AVAILABLE=false',
+    );
+    expect(resolveMaterialShaderVariantSet(undefined, variants, 'webgpu', true, true)).toBe(
+      'CLUSTER_FORWARD_AVAILABLE=false+PROJECTOR_AVAILABLE=true+STORAGE_BUFFER_AVAILABLE=true+VERTEX_COLOR_AVAILABLE=false',
+    );
+  });
+
   it('keeps single-source manifests on the canonical module key', () => {
     const singleSourceManifest = {
       identifier: 'forgeax::points-lines',

package/src/__tests__/renderer-frame-transaction.integration.test.ts

@@ -83,7 +83,7 @@ function temporalResolveFrame(
     msaaActive: false,
     geometryColorResolveView: null,
     ldrSpriteColorView: null,
-  } as RenderPipelineFrame;
+  } as unknown as RenderPipelineFrame;
 }
 
 async function buildTemporalResolveGraph(device: RhiDevice) {

package/src/__tests__/skinned-shadow-caster.test.ts

@@ -99,4 +99,25 @@ describe('skinned shadow caster', () => {
     expect(recordSource).toContain('shadowPass.setBindGroup(2, skinMeshBindGroup, [');
     expect(recordSource).toContain('entry.source.skin.byteOffset');
   });
+
+  it('keeps low-limit shadow view bindings paired with the optional projector layout', () => {
+    const recordSource = readFileSync(
+      fileURLToPath(new URL('../record/shadow-pass.ts', import.meta.url)),
+      'utf8',
+    );
+
+    // A 16-sampled-texture device removes bindings 11/12 from pbr-view-bgl.
+    // The shadow-view helper must use the same capability bit as the main
+    // view helper or it recreates the browser-only bind-group mismatch.
+    expect(recordSource).toContain(
+      'const projectorAvailable = pipelineState.projectorAvailable !== false;',
+    );
+    expect(recordSource).toContain(
+      '...(projectorAvailable\n          ? [pipelineState.defaultWhiteTextureView, pipelineState.defaultSampler]',
+    );
+    expect(recordSource).toContain(
+      '...(projectorAvailable\n              ? [\n                  {\n                    binding: 11,',
+    );
+    expect(recordSource).toContain('binding: 12');
+  });
 });