@forgeax/engine-render 0.1.19 → 0.1.21

package/dist/pipeline/standard-lighting/layout.d.ts

@@ -0,0 +1,28 @@
+export declare const DEFAULT_CLUSTER_GRID: {
+    readonly x: 16;
+    readonly y: 9;
+    readonly z: 24;
+};
+export declare const CLUSTER_GRID_STRIDE_U32: 2;
+export declare const LIGHT_INDEX_LIST_CAPACITY: 1048576;
+export declare const MAX_LIGHTS: 256;
+export interface StandardClusterLayout {
+    readonly grid: {
+        readonly x: number;
+        readonly y: number;
+        readonly z: number;
+    };
+    readonly clusterCount: number;
+    readonly clusterGridStrideU32: typeof CLUSTER_GRID_STRIDE_U32;
+    readonly clusterGridU32Length: number;
+    readonly lightIndexListCapacity: typeof LIGHT_INDEX_LIST_CAPACITY;
+    readonly lightDataSlotCount: typeof MAX_LIGHTS;
+    readonly lightBoundsInt32Length: number;
+}
+export declare function createStandardClusterLayout(grid?: {
+    readonly x: number;
+    readonly y: number;
+    readonly z: number;
+}): StandardClusterLayout;
+export declare const STANDARD_CLUSTER_LAYOUT: StandardClusterLayout;
+//# sourceMappingURL=layout.d.ts.map

package/dist/pipeline/standard-lighting/layout.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"layout.d.ts","sourceRoot":"","sources":["../../../src/pipeline/standard-lighting/layout.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB;;;;CAAkC,CAAC;AACpE,eAAO,MAAM,uBAAuB,EAAG,CAAU,CAAC;AAClD,eAAO,MAAM,yBAAyB,EAAG,OAAgB,CAAC;AAC1D,eAAO,MAAM,UAAU,EAAG,GAAY,CAAC;AAEvC,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,IAAI,EAAE;QAAE,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9E,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,oBAAoB,EAAE,OAAO,uBAAuB,CAAC;IAC9D,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,sBAAsB,EAAE,OAAO,yBAAyB,CAAC;IAClE,QAAQ,CAAC,kBAAkB,EAAE,OAAO,UAAU,CAAC;IAC/C,QAAQ,CAAC,sBAAsB,EAAE,MAAM,CAAC;CACzC;AAED,wBAAgB,2BAA2B,CACzC,IAAI,GAAE;IAAE,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;CAAyB,GAC1F,qBAAqB,CAWvB;AAED,eAAO,MAAM,uBAAuB,uBAAgC,CAAC"}

package/dist/pipeline/standard-lighting/light-frame.d.ts

@@ -0,0 +1,33 @@
+import type { Mat4, Vec3 } from '@forgeax/engine-math';
+import type { DirectionalLightSnapshot, PointLightSnapshot, SpotLightSnapshot } from '../../render-system-extract';
+import type { StandardLightCount } from '../standard-profile';
+export interface StandardLocalLightInput {
+    readonly kind: 'point' | 'spot';
+    readonly position: Vec3;
+    readonly range: number;
+    /** Whether the shadow producer admitted this local light to its atlas. */
+    readonly shadowed: boolean;
+    /**
+     * The immutable extract snapshot used by the record payload packer. Keeping
+     * it on the POD frame prevents Forward/Deferred from rebuilding a second
+     * light list while leaving hand-authored unit fixtures source-free.
+     */
+    readonly source?: PointLightSnapshot | SpotLightSnapshot;
+}
+export interface StandardLightFrame {
+    readonly directional: DirectionalLightSnapshot | undefined;
+    readonly local: readonly StandardLocalLightInput[];
+    readonly view: Mat4;
+    readonly projection: Mat4;
+    readonly near: number;
+    readonly far: number;
+    readonly grid: {
+        readonly x: number;
+        readonly y: number;
+        readonly z: number;
+    };
+    readonly lightCount: StandardLightCount;
+    /** Graph path carried into inspection from the active Standard profile. */
+    readonly renderPath: 'forward' | 'deferred';
+}
+//# sourceMappingURL=light-frame.d.ts.map

package/dist/pipeline/standard-lighting/light-frame.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"light-frame.d.ts","sourceRoot":"","sources":["../../../src/pipeline/standard-lighting/light-frame.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,KAAK,EACV,wBAAwB,EACxB,kBAAkB,EAClB,iBAAiB,EAClB,MAAM,6BAA6B,CAAC;AACrC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,qBAAqB,CAAC;AAE9D,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,IAAI,EAAE,OAAO,GAAG,MAAM,CAAC;IAChC,QAAQ,CAAC,QAAQ,EAAE,IAAI,CAAC;IACxB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,0EAA0E;IAC1E,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;IAC3B;;;;OAIG;IACH,QAAQ,CAAC,MAAM,CAAC,EAAE,kBAAkB,GAAG,iBAAiB,CAAC;CAC1D;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,WAAW,EAAE,wBAAwB,GAAG,SAAS,CAAC;IAC3D,QAAQ,CAAC,KAAK,EAAE,SAAS,uBAAuB,EAAE,CAAC;IACnD,QAAQ,CAAC,IAAI,EAAE,IAAI,CAAC;IACpB,QAAQ,CAAC,UAAU,EAAE,IAAI,CAAC;IAC1B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,IAAI,EAAE;QAAE,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAC9E,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;IACxC,2EAA2E;IAC3E,QAAQ,CAAC,UAAU,EAAE,SAAS,GAAG,UAAU,CAAC;CAC7C"}

package/dist/pipeline/standard-lighting/membership.d.ts

@@ -0,0 +1,14 @@
+import { type Result } from '@forgeax/engine-types';
+import { type ClusterBinScratch } from '../../cluster-binner';
+import type { RenderError } from '../../errors/render';
+import type { StandardClusterLayout } from './layout';
+import type { StandardLightFrame } from './light-frame';
+export interface StandardClusterMembership {
+    readonly clusterGrid: Uint32Array;
+    readonly lightIndexList: Uint32Array;
+    readonly lightBounds: Int32Array;
+    readonly membershipEntryCount: number;
+    readonly scratch: ClusterBinScratch;
+}
+export declare function deriveStandardMembership(frame: StandardLightFrame, layout: StandardClusterLayout, scratch?: ClusterBinScratch): Result<StandardClusterMembership, RenderError>;
+//# sourceMappingURL=membership.d.ts.map

package/dist/pipeline/standard-lighting/membership.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"membership.d.ts","sourceRoot":"","sources":["../../../src/pipeline/standard-lighting/membership.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAO,KAAK,iBAAiB,EAA2B,MAAM,sBAAsB,CAAC;AAC5F,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAEvD,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,UAAU,CAAC;AACtD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAExD,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,WAAW,EAAE,WAAW,CAAC;IAClC,QAAQ,CAAC,cAAc,EAAE,WAAW,CAAC;IACrC,QAAQ,CAAC,WAAW,EAAE,UAAU,CAAC;IACjC,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,OAAO,EAAE,iBAAiB,CAAC;CACrC;AAED,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,kBAAkB,EACzB,MAAM,EAAE,qBAAqB,EAC7B,OAAO,oBAA4B,GAClC,MAAM,CAAC,yBAAyB,EAAE,WAAW,CAAC,CAuBhD"}

package/dist/pipeline/standard-lighting/prepare.d.ts

@@ -0,0 +1,16 @@
+import { type Result } from '@forgeax/engine-types';
+import { type RenderError } from '../../errors/render';
+import { type StandardClusterLayout } from './layout';
+import type { StandardLightFrame } from './light-frame';
+import { type StandardClusterMembership } from './membership';
+export type { StandardLightFrame } from './light-frame';
+export interface PreparedStandardLighting extends StandardClusterMembership {
+    readonly directional: StandardLightFrame['directional'];
+    readonly local: StandardLightFrame['local'];
+    readonly layout: StandardClusterLayout;
+    readonly membershipLightCount: number;
+    readonly renderPath: NonNullable<StandardLightFrame['renderPath']>;
+    readonly maxLights: StandardLightFrame['lightCount'];
+}
+export declare function prepareStandardLighting(frame: StandardLightFrame): Result<PreparedStandardLighting, RenderError>;
+//# sourceMappingURL=prepare.d.ts.map

package/dist/pipeline/standard-lighting/prepare.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prepare.d.ts","sourceRoot":"","sources":["../../../src/pipeline/standard-lighting/prepare.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,KAAK,WAAW,EAAoC,MAAM,qBAAqB,CAAC;AAEzF,OAAO,EAA+B,KAAK,qBAAqB,EAAE,MAAM,UAAU,CAAC;AACnF,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AACxD,OAAO,EAA4B,KAAK,yBAAyB,EAAE,MAAM,cAAc,CAAC;AAExF,YAAY,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAExD,MAAM,WAAW,wBAAyB,SAAQ,yBAAyB;IACzE,QAAQ,CAAC,WAAW,EAAE,kBAAkB,CAAC,aAAa,CAAC,CAAC;IACxD,QAAQ,CAAC,KAAK,EAAE,kBAAkB,CAAC,OAAO,CAAC,CAAC;IAC5C,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC;IACvC,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,UAAU,EAAE,WAAW,CAAC,kBAAkB,CAAC,YAAY,CAAC,CAAC,CAAC;IACnE,QAAQ,CAAC,SAAS,EAAE,kBAAkB,CAAC,YAAY,CAAC,CAAC;CACtD;AAED,wBAAgB,uBAAuB,CACrC,KAAK,EAAE,kBAAkB,GACxB,MAAM,CAAC,wBAAwB,EAAE,WAAW,CAAC,CAgB/C"}

package/dist/pipeline/standard-lighting/topology.d.ts

@@ -0,0 +1,45 @@
+import { type Result } from '@forgeax/engine-types';
+import type { PreparedStandardLighting } from './prepare';
+import type { StandardClusterTransport } from './transport';
+/** A prepared frame with no local lights on a non-storage direct backend. */
+export interface StandardNoLocalTopologyInput {
+    readonly kind: 'no-local-lights';
+    readonly prepared: PreparedStandardLighting;
+}
+/** A prepared frame whose Standard surface uses one proven Cluster transport. */
+export interface StandardClusteredTopologyInput {
+    readonly kind: 'clustered';
+    readonly prepared: PreparedStandardLighting;
+    readonly transport: StandardClusterTransport;
+}
+/**
+ * The only lighting value accepted by a Standard topology adapter. It is a
+ * projection of one prepared frame, not a second light/config/capability
+ * input. Both Forward and Deferred keep the same object identity for a frame.
+ */
+export type StandardTopologyInput = StandardNoLocalTopologyInput | StandardClusteredTopologyInput;
+export type StandardTopologyInputValue = StandardTopologyInput;
+/**
+ * Stable identity for the graph-facing Standard lighting declaration.
+ *
+ * The prepared light payload itself is frame-local and must never be retained
+ * by a compiled graph. These are the only facts that affect the Cluster graph
+ * shape and persistent buffer contract, so the record owner can reject an old
+ * graph before uploading a payload derived from a different declaration.
+ */
+export declare function standardLightingTopologySignature(input: StandardTopologyInputValue | undefined): string;
+export interface StandardTopologyInputError {
+    readonly code: 'topology-input-invalid';
+    readonly expected: 'prepared Standard lighting topology input';
+    readonly hint: 'derive topology from prepared Standard lighting';
+    readonly detail: {
+        readonly field: 'kind' | 'prepared' | 'transport' | 'lights' | 'capabilities';
+    };
+}
+/**
+ * Validate that transport and prepared membership are the same derivation.
+ * The identity checks make it impossible for an adapter to silently combine
+ * one path's layout/counts with another path's prepared light corpus.
+ */
+export declare function deriveStandardTopologyInput(input: StandardTopologyInput): Result<StandardTopologyInputValue, StandardTopologyInputError>;
+//# sourceMappingURL=topology.d.ts.map

package/dist/pipeline/standard-lighting/topology.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"topology.d.ts","sourceRoot":"","sources":["../../../src/pipeline/standard-lighting/topology.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC;AAC1D,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAE5D,6EAA6E;AAC7E,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,wBAAwB,CAAC;CAC7C;AAED,iFAAiF;AACjF,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,wBAAwB,CAAC;IAC5C,QAAQ,CAAC,SAAS,EAAE,wBAAwB,CAAC;CAC9C;AAED;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAAG,4BAA4B,GAAG,8BAA8B,CAAC;AAElG,MAAM,MAAM,0BAA0B,GAAG,qBAAqB,CAAC;AAE/D;;;;;;;GAOG;AACH,wBAAgB,iCAAiC,CAC/C,KAAK,EAAE,0BAA0B,GAAG,SAAS,GAC5C,MAAM,CAaR;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,IAAI,EAAE,wBAAwB,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,2CAA2C,CAAC;IAC/D,QAAQ,CAAC,IAAI,EAAE,iDAAiD,CAAC;IACjE,QAAQ,CAAC,MAAM,EAAE;QACf,QAAQ,CAAC,KAAK,EAAE,MAAM,GAAG,UAAU,GAAG,WAAW,GAAG,QAAQ,GAAG,cAAc,CAAC;KAC/E,CAAC;CACH;AAaD;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,qBAAqB,GAC3B,MAAM,CAAC,0BAA0B,EAAE,0BAA0B,CAAC,CAyChE"}

package/dist/pipeline/standard-lighting/transport.d.ts

@@ -0,0 +1,36 @@
+import { type Result } from '@forgeax/engine-types';
+import { type RenderError } from '../../errors/render';
+import type { PreparedStandardLighting } from './prepare';
+export interface StandardClusterCapabilities {
+    readonly compute: boolean;
+    readonly storageBuffer: boolean;
+    /**
+     * The graph producer is ready to encode the selected compute lane. The
+     * renderer supplies this from the actual pipeline + bind-group layout; it is
+     * required so capability admission cannot forge a GPU producer from
+     * `compute` alone.
+     */
+    readonly membershipPipelineReady: boolean;
+}
+/** Only transports with storage-backed membership representation exist. */
+export type StandardClusterTransportKind = 'compute-storage' | 'cpu-storage';
+export type StandardClusterMembershipProducer = 'cpu' | 'gpu';
+export interface StandardClusterTransport {
+    readonly kind: StandardClusterTransportKind;
+    readonly producer: StandardClusterMembershipProducer;
+    readonly layout: PreparedStandardLighting['layout'];
+    readonly requestedLightCount: number;
+    readonly admittedLightCount: number;
+    readonly membershipEntryCount: number;
+    readonly occupiedClusterCount: number;
+    readonly clusterGridBytes: number;
+    readonly lightIndexListBytes: number;
+    readonly lightDataBytes: number;
+    readonly lightBoundsBytes: number;
+}
+/**
+ * Select a transport from one prepared frame. Capability facts choose only a
+ * producer/storage pair; all counts and byte sizes come from that frame.
+ */
+export declare function selectStandardClusterTransport(capabilities: StandardClusterCapabilities, prepared: PreparedStandardLighting): Result<StandardClusterTransport, RenderError>;
+//# sourceMappingURL=transport.d.ts.map

package/dist/pipeline/standard-lighting/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../../src/pipeline/standard-lighting/transport.ts"],"names":[],"mappings":"AAAA,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAAE,KAAK,WAAW,EAA4C,MAAM,qBAAqB,CAAC;AACjG,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,WAAW,CAAC;AAE1D,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAC;IAChC;;;;;OAKG;IACH,QAAQ,CAAC,uBAAuB,EAAE,OAAO,CAAC;CAC3C;AAED,2EAA2E;AAC3E,MAAM,MAAM,4BAA4B,GAAG,iBAAiB,GAAG,aAAa,CAAC;AAC7E,MAAM,MAAM,iCAAiC,GAAG,KAAK,GAAG,KAAK,CAAC;AAE9D,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,IAAI,EAAE,4BAA4B,CAAC;IAC5C,QAAQ,CAAC,QAAQ,EAAE,iCAAiC,CAAC;IACrD,QAAQ,CAAC,MAAM,EAAE,wBAAwB,CAAC,QAAQ,CAAC,CAAC;IACpD,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;CACnC;AAUD;;;GAGG;AACH,wBAAgB,8BAA8B,CAC5C,YAAY,EAAE,2BAA2B,EACzC,QAAQ,EAAE,wBAAwB,GACjC,MAAM,CAAC,wBAAwB,EAAE,WAAW,CAAC,CA2B/C"}

package/dist/pipeline/standard-pipeline.d.ts

@@ -1,20 +1,10 @@
 import { type Result } from '@forgeax/engine-types';
+import { StandardProfileInvalidError } from '../errors/render';
 import type { FramePlan } from '../extract/environment';
 import type { RenderPipeline } from '../render-pipeline';
-import { STANDARD_PIPELINE_ID } from './standard-profile';
+import { STANDARD_PIPELINE_ID, type StandardProfile } from './standard-profile';
 /** WGSL owner for the Standard clustered membership producer. */
 export declare const STANDARD_CLUSTER_MEMBERSHIP_WGSL = "\nstruct ClusterUniform {\n  grid : vec4<u32>,\n  near_far_log : vec4<f32>,\n};\n\n@group(0) @binding(0) var<storage, read> cluster_grid : array<u32>;\n@group(0) @binding(1) var<storage, read_write> light_index_list : array<u32>;\n@group(0) @binding(2) var<uniform> cluster_uniform : ClusterUniform;\n@group(0) @binding(3) var<storage, read> light_bounds : array<i32>;\n\n@compute @workgroup_size(64)\nfn cs_cluster_membership(@builtin(global_invocation_id) global_id : vec3<u32>) {\n  let cluster_index = global_id.x;\n  let grid_x = cluster_uniform.grid.x;\n  let grid_y = cluster_uniform.grid.y;\n  let grid_z = cluster_uniform.grid.z;\n  let cluster_count = grid_x * grid_y * grid_z;\n  if (cluster_index >= cluster_count) {\n    return;\n  }\n\n  let cluster_x = cluster_index % grid_x;\n  let cluster_yz = cluster_index / grid_x;\n  let cluster_y = cluster_yz % grid_y;\n  let cluster_z = cluster_yz / grid_y;\n  let grid_offset = cluster_index * 2u;\n  let output_offset = cluster_grid[grid_offset];\n  let output_count = cluster_grid[grid_offset + 1u];\n  let cluster_x_i = i32(cluster_x);\n  let cluster_y_i = i32(cluster_y);\n  let cluster_z_i = i32(cluster_z);\n  var output_index = output_offset;\n\n  var light_index = 0u;\n  loop {\n    if (light_index >= cluster_uniform.grid.w || light_index >= 256u) {\n      break;\n    }\n    let bounds_offset = light_index * 6u;\n    let min_x = light_bounds[bounds_offset];\n    if (min_x >= 0) {\n      let min_y = light_bounds[bounds_offset + 1u];\n      let min_z = light_bounds[bounds_offset + 2u];\n      let max_x = light_bounds[bounds_offset + 3u];\n      let max_y = light_bounds[bounds_offset + 4u];\n      let max_z = light_bounds[bounds_offset + 5u];\n      if (\n        cluster_x_i >= min_x && cluster_x_i <= max_x &&\n        cluster_y_i >= min_y && cluster_y_i <= max_y &&\n        cluster_z_i >= min_z && cluster_z_i <= max_z\n      ) {\n        if (output_index < output_offset + output_count) {\n          light_index_list[output_index] = light_index;\n          output_index += 1u;\n        }\n      }\n    }\n    light_index += 1u;\n  }\n}\n";
-export declare class HdrpInstallError extends Error {
-    readonly code: "hdrp-grid-invalid";
-    readonly expected = "clusterGrid.{x,y,z} each integer in [1, 64]";
-    readonly hint: string;
-    readonly detail: {
-        readonly x: number;
-        readonly y: number;
-        readonly z: number;
-    };
-    constructor(x: number, y: number, z: number);
-}
 export declare function validateClusterGrid(grid: {
     x: number;
     y: number;
@@ -23,10 +13,11 @@ export declare function validateClusterGrid(grid: {
     x: number;
     y: number;
     z: number;
-}, HdrpInstallError>;
+}, StandardProfileInvalidError>;
 export interface StandardPipeline extends RenderPipeline {
     readonly identity: typeof STANDARD_PIPELINE_ID;
 }
+export declare function standardProfileSupportsReflectionProbes(_profile: StandardProfile): boolean;
 /** Standard graph inputs are derived once from the immutable frame plan. */
 export type StandardFramePlan = FramePlan;
 export declare const standardPipeline: StandardPipeline;

package/dist/pipeline/standard-pipeline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"standard-pipeline.d.ts","sourceRoot":"","sources":["../../src/pipeline/standard-pipeline.ts"],"names":[],"mappings":"AAOA,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAE7D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AASxD,OAAO,KAAK,EACV,cAAc,EAIf,MAAM,oBAAoB,CAAC;AA6B5B,OAAO,EAOL,oBAAoB,EAErB,MAAM,oBAAoB,CAAC;AAE5B,iEAAiE;AACjE,eAAO,MAAM,gCAAgC,ykEA6D5C,CAAC;AACF,qBAAa,gBAAiB,SAAQ,KAAK;IACzC,QAAQ,CAAC,IAAI,EAAG,mBAAmB,CAAU;IAC7C,QAAQ,CAAC,QAAQ,iDAAiD;IAClE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;gBAEpE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM;CAO5C;AAED,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACxC,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX,GAAG,MAAM,CAAC;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,gBAAgB,CAAC,CAahE;AAwYD,MAAM,WAAW,gBAAiB,SAAQ,cAAc;IACtD,QAAQ,CAAC,QAAQ,EAAE,OAAO,oBAAoB,CAAC;CAChD;AAED,4EAA4E;AAC5E,MAAM,MAAM,iBAAiB,GAAG,SAAS,CAAC;AA6C1C,eAAO,MAAM,gBAAgB,EAAE,gBAG7B,CAAC;AAEH,OAAO,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"standard-pipeline.d.ts","sourceRoot":"","sources":["../../src/pipeline/standard-pipeline.ts"],"names":[],"mappings":"AAMA,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,EAA6B,2BAA2B,EAAE,MAAM,kBAAkB,CAAC;AAC1F,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAC;AAExD,OAAO,KAAK,EACV,cAAc,EAIf,MAAM,oBAAoB,CAAC;AAsC5B,OAAO,EAGL,oBAAoB,EACpB,KAAK,eAAe,EACrB,MAAM,oBAAoB,CAAC;AAE5B,iEAAiE;AACjE,eAAO,MAAM,gCAAgC,ykEA6D5C,CAAC;AACF,wBAAgB,mBAAmB,CAAC,IAAI,EAAE;IACxC,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;IACV,CAAC,EAAE,MAAM,CAAC;CACX,GAAG,MAAM,CAAC;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,EAAE,2BAA2B,CAAC,CAkB3E;AA0SD,MAAM,WAAW,gBAAiB,SAAQ,cAAc;IACtD,QAAQ,CAAC,QAAQ,EAAE,OAAO,oBAAoB,CAAC;CAChD;AAED,wBAAgB,uCAAuC,CAAC,QAAQ,EAAE,eAAe,GAAG,OAAO,CAE1F;AAED,4EAA4E;AAC5E,MAAM,MAAM,iBAAiB,GAAG,SAAS,CAAC;AAiG1C,eAAO,MAAM,gBAAgB,EAAE,gBAG7B,CAAC;AAEH,OAAO,EAAE,wBAAwB,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/pipeline/standard-post.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"standard-post.d.ts","sourceRoot":"","sources":["../../src/pipeline/standard-post.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAA0B,MAAM,8BAA8B,CAAC;AAEpG,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAK7D,OAAO,KAAK,EACV,0BAA0B,EAC1B,wBAAwB,EACxB,mBAAmB,EACnB,sBAAsB,EACvB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAA8B,KAAK,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAW3F,UAAU,mBAAmB;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,oBAAoB,CAAC;IACxC,QAAQ,CAAC,OAAO,EAAE,oBAAoB,CAAC;CACxC;AAED,oFAAoF;AACpF,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;CAQtC,CAAC;AAEF,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS,CAAC;IAC/C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAyCD,8EAA8E;AAC9E,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,uBAAuB,GAAG,SAAS,GACzC,4BAA4B,CA8B9B;AAyBD;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,0BAA0B,CAAC,mBAAmB,CAAC,EACxD,QAAQ,EAAE,sBAAsB,EAChC,KAAK,EAAE,oBAAoB,EAC3B,KAAK,EAAE,oBAAoB,EAC3B,OAAO,EAAE,mBAAmB,EAC5B,aAAa,CAAC,EAAE,oBAAoB,GACnC,MAAM,CAAC,IAAI,EAAE,wBAAwB,CAAC,CAuNxC"}
+{"version":3,"file":"standard-post.d.ts","sourceRoot":"","sources":["../../src/pipeline/standard-post.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAA0B,MAAM,8BAA8B,CAAC;AAEpG,OAAO,EAAW,KAAK,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAK7D,OAAO,KAAK,EACV,0BAA0B,EAC1B,wBAAwB,EACxB,mBAAmB,EACnB,sBAAsB,EACvB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAEL,KAAK,oBAAoB,EAE1B,MAAM,oBAAoB,CAAC;AAW5B,UAAU,mBAAmB;IAC3B,QAAQ,CAAC,OAAO,CAAC,EAAE,oBAAoB,CAAC;IACxC,QAAQ,CAAC,OAAO,EAAE,oBAAoB,CAAC;CACxC;AAED,oFAAoF;AACpF,eAAO,MAAM,0BAA0B;;;;;;;;;;;;;;;;;;;;;CAQtC,CAAC;AAEF,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,OAAO,GAAG,SAAS,CAAC;IAC/C,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;CAC5B;AAyCD,8EAA8E;AAC9E,wBAAgB,yBAAyB,CACvC,KAAK,EAAE,uBAAuB,GAAG,SAAS,GACzC,4BAA4B,CA8B9B;AAyBD;;;;;GAKG;AACH,wBAAgB,eAAe,CAC7B,OAAO,EAAE,0BAA0B,CAAC,mBAAmB,CAAC,EACxD,QAAQ,EAAE,sBAAsB,EAChC,KAAK,EAAE,oBAAoB,EAC3B,KAAK,EAAE,oBAAoB,EAC3B,OAAO,EAAE,mBAAmB,EAC5B,aAAa,CAAC,EAAE,oBAAoB,GACnC,MAAM,CAAC,IAAI,EAAE,wBAAwB,CAAC,CAsOxC"}

package/dist/pipeline/standard-profile.d.ts

@@ -1,37 +1,29 @@
 export declare const STANDARD_PIPELINE_ID: "forgeax::standard";
 export declare const STANDARD_LIGHT_COUNTS: readonly [1, 32, 256];
-/** Shared clustered-lighting facts consumed by pipeline, record, and buffers. */
-export declare const DEFAULT_CLUSTER_GRID: {
-    readonly x: 16;
-    readonly y: 9;
-    readonly z: 24;
-};
-export declare const CLUSTER_GRID_STRIDE_U32 = 2;
-export declare const LIGHT_INDEX_LIST_CAPACITY = 1048576;
-export declare const MAX_LIGHTS = 256;
+export { CLUSTER_GRID_STRIDE_U32, DEFAULT_CLUSTER_GRID, LIGHT_INDEX_LIST_CAPACITY, MAX_LIGHTS, } from './standard-lighting/layout';
 export type StandardLightCount = (typeof STANDARD_LIGHT_COUNTS)[number];
-export type StandardLightingLane = 'direct' | 'clustered';
-export type StandardFallbackLane = 'native' | 'cpu-webgl2';
 export type StandardShadowMode = 'off' | 'hard' | 'filtered';
-export type StandardTone = 'none' | 'aces-filmic' | 'agx' | 'cineon' | 'linear' | 'neutral' | 'reinhard' | 'reinhard-extended';
-export type StandardAntialias = 'none' | 'fxaa' | 'msaa';
+export type StandardVolumetricFogQuality = 'low' | 'high';
+export interface StandardVolumetricFogProfile {
+    readonly quality: StandardVolumetricFogQuality;
+    readonly depth: 48 | 64;
+    readonly tileSize: 4 | 16;
+}
 export declare const STANDARD_POST_STAGE_NAMES: readonly ["transparent-blend", "bloom", "output-transform", "fxaa", "post-effect", "present"];
 export type StandardPostStage = (typeof STANDARD_POST_STAGE_NAMES)[number];
 export interface StandardProfile {
     readonly pipelineId: typeof STANDARD_PIPELINE_ID;
     readonly lightCount: StandardLightCount;
-    readonly lighting: StandardLightingLane;
+    /** Graph topology selector; all local lights use the shared Cluster path. */
+    readonly renderPath: 'forward' | 'deferred';
     readonly shadows: StandardShadowMode;
     readonly pbr: boolean;
     readonly ibl: boolean;
     readonly ssao: boolean;
-    readonly fallback: StandardFallbackLane;
+    /** Renderer-owned 1080p volume profile; tile width/height remain surface-derived. */
+    readonly volumetricFog?: StandardVolumetricFogProfile | undefined;
     readonly postStages: typeof STANDARD_POST_STAGE_NAMES;
 }
 export declare const DEFAULT_STANDARD_PROFILE: StandardProfile;
-export type StandardLane = StandardLightingLane | 'cpu-webgl2';
-export declare function resolveStandardLane(profile: Pick<StandardProfile, 'lighting'>, capabilities: {
-    readonly compute: boolean;
-    readonly storageBuffer: boolean;
-}): StandardLane;
+export declare function resolveVolumetricFogProfile(profile: Pick<StandardProfile, 'volumetricFog'>): StandardVolumetricFogProfile;
 //# sourceMappingURL=standard-profile.d.ts.map

package/dist/pipeline/standard-profile.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"standard-profile.d.ts","sourceRoot":"","sources":["../../src/pipeline/standard-profile.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,EAAG,mBAA4B,CAAC;AACjE,eAAO,MAAM,qBAAqB,uBAAwB,CAAC;AAC3D,iFAAiF;AACjF,eAAO,MAAM,oBAAoB;;;;CAAkC,CAAC;AACpE,eAAO,MAAM,uBAAuB,IAAI,CAAC;AACzC,eAAO,MAAM,yBAAyB,UAAU,CAAC;AACjD,eAAO,MAAM,UAAU,MAAM,CAAC;AAE9B,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AACxE,MAAM,MAAM,oBAAoB,GAAG,QAAQ,GAAG,WAAW,CAAC;AAC1D,MAAM,MAAM,oBAAoB,GAAG,QAAQ,GAAG,YAAY,CAAC;AAC3D,MAAM,MAAM,kBAAkB,GAAG,KAAK,GAAG,MAAM,GAAG,UAAU,CAAC;AAC7D,MAAM,MAAM,YAAY,GACpB,MAAM,GACN,aAAa,GACb,KAAK,GACL,QAAQ,GACR,QAAQ,GACR,SAAS,GACT,UAAU,GACV,mBAAmB,CAAC;AACxB,MAAM,MAAM,iBAAiB,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AACzD,eAAO,MAAM,yBAAyB,+FAO5B,CAAC;AACX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,yBAAyB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3E,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,UAAU,EAAE,OAAO,oBAAoB,CAAC;IACjD,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;IACxC,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAC;IACxC,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC;IACrC,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,QAAQ,CAAC,QAAQ,EAAE,oBAAoB,CAAC;IACxC,QAAQ,CAAC,UAAU,EAAE,OAAO,yBAAyB,CAAC;CACvD;AAED,eAAO,MAAM,wBAAwB,EAAE,eAUrC,CAAC;AAEH,MAAM,MAAM,YAAY,GAAG,oBAAoB,GAAG,YAAY,CAAC;AAE/D,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,IAAI,CAAC,eAAe,EAAE,UAAU,CAAC,EAC1C,YAAY,EAAE;IAAE,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAA;CAAE,GAC3E,YAAY,CAGd"}
+{"version":3,"file":"standard-profile.d.ts","sourceRoot":"","sources":["../../src/pipeline/standard-profile.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,oBAAoB,EAAG,mBAA4B,CAAC;AACjE,eAAO,MAAM,qBAAqB,uBAAwB,CAAC;AAC3D,OAAO,EACL,uBAAuB,EACvB,oBAAoB,EACpB,yBAAyB,EACzB,UAAU,GACX,MAAM,4BAA4B,CAAC;AAEpC,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AACxE,MAAM,MAAM,kBAAkB,GAAG,KAAK,GAAG,MAAM,GAAG,UAAU,CAAC;AAC7D,MAAM,MAAM,4BAA4B,GAAG,KAAK,GAAG,MAAM,CAAC;AAE1D,MAAM,WAAW,4BAA4B;IAC3C,QAAQ,CAAC,OAAO,EAAE,4BAA4B,CAAC;IAC/C,QAAQ,CAAC,KAAK,EAAE,EAAE,GAAG,EAAE,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,CAAC;CAC3B;AAED,eAAO,MAAM,yBAAyB,+FAO5B,CAAC;AACX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,yBAAyB,CAAC,CAAC,MAAM,CAAC,CAAC;AAC3E,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,UAAU,EAAE,OAAO,oBAAoB,CAAC;IACjD,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;IACxC,6EAA6E;IAC7E,QAAQ,CAAC,UAAU,EAAE,SAAS,GAAG,UAAU,CAAC;IAC5C,QAAQ,CAAC,OAAO,EAAE,kBAAkB,CAAC;IACrC,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,OAAO,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IACvB,qFAAqF;IACrF,QAAQ,CAAC,aAAa,CAAC,EAAE,4BAA4B,GAAG,SAAS,CAAC;IAClE,QAAQ,CAAC,UAAU,EAAE,OAAO,yBAAyB,CAAC;CACvD;AAED,eAAO,MAAM,wBAAwB,EAAE,eASrC,CAAC;AAEH,wBAAgB,2BAA2B,CACzC,OAAO,EAAE,IAAI,CAAC,eAAe,EAAE,eAAe,CAAC,GAC9C,4BAA4B,CAE9B"}

package/dist/pipeline-spec.d.ts

@@ -99,6 +99,39 @@ export declare function cacheKeyOf(spec: PipelineSpec): string;
  * by a material variant.
  */
 export declare function variantSetFromVertexLayoutProjection(projection: VertexLayoutProjection, authoredVariantSet: string | undefined): Result<string, VertexColorVariantConflictError>;
+/**
+ * Derive the capability axes shared by every Standard PBR draw owner.
+ *
+ * The all-true key is the canonical empty key used by the shader manifest;
+ * every other capability pair stays explicit so a no-local-light frame on a
+ * device without storage buffers cannot accidentally select a storage-backed
+ * PSO. Vertex-color is supplied here because the empty-key rule is only valid
+ * when that geometry-owned axis is also true.
+ */
+export declare function standardCapabilityVariantSet(clustered: boolean, storageBuffer: boolean, vertexColorAvailable: boolean): string;
+/**
+ * Project the frame-owned Standard topology onto its material variant axes.
+ *
+ * `StandardTopologyInputValue.kind` is the only runtime authority for the
+ * cluster axis: a frame with local lights must request the clustered artifact,
+ * while the no-local-light topology requests the direct artifact.  Keeping
+ * this projection beside the canonical key builder prevents PBR, skin, and
+ * sprite-lit record owners from independently inferring the active lane from
+ * whichever bind group happened to be constructed first.
+ */
+export declare function standardTopologyVariantSet(topology: {
+    readonly kind: 'no-local-lights' | 'clustered';
+} | undefined, storageBuffer: boolean, vertexColorAvailable: boolean): string;
+/**
+ * Keep a clustered frame fail-closed when its unified group(2) resource is
+ * unavailable. A missing group is not evidence that the frame is direct; it
+ * is an invalid prepared resource state.
+ */
+export declare function standardTopologyBindGroupReady(topology: {
+    readonly kind: 'no-local-lights' | 'clustered';
+} | undefined, clusterBindGroup: unknown): boolean;
+/** Derive the storage axis for Standard-compatible unlit material draws. */
+export declare function standardStorageVariantSet(storageBuffer: boolean, vertexColorAvailable: boolean): string;
 /**
  * Build a `GPURenderPipelineDescriptor` from a PipelineSpec + shader modules.
  *
@@ -312,22 +345,22 @@ export declare function getOrBuildPipeline(spec: PipelineSpec, deviceProvider: P
  *
  * Matrix:
  *   - 8 base material variants — {unlit, standard-pbr} x {LDR, HDR} x {S1, S4}
- *   - 4 URP-variant standard-pbr — standard-pbr (variantSet=URP_PBR_VARIANT_SET)
- *     x {LDR, HDR} x {S1, S4}; URP record path requests these specs by
+ *   - 4 non-clustered standard-pbr — standard-pbr (variantSet=STANDARD_BOOT_VARIANT_SET)
+ *     x {LDR, HDR} x {S1, S4}; the default record path requests these specs by
  *     `getMaterialShaderPipeline` keying off `cacheKeyOf` so the boot-time
  *     prewarm seeds `materialShaderPipelineCache` and avoids a 1-frame
- *     async-compile skip-draw (M6 fix-up; see render-system-record.ts §URP)
+ *     async-compile skip-draw (M6 fix-up; see render-system-record.ts)
  *   - 3 fullscreen-post — tonemap (LDR S1) + skybox (HDR S1, HDR S4)
  *
- * Total: 15. The URP variant is PBR-only because:
- *   - unlit URP record path passes `variantSet=undefined` (the no-variant
+ * Total: 15. The non-clustered variant is PBR-only because:
+ *   - unlit record path passes `variantSet=undefined` (the no-variant
  *     boot-default entries already cover it; createRenderer.ts §unlitRsp)
  *   - sprite goes through `getMaterialShaderPipeline('forgeax::sprite', ...)`
  *     lazily at first transparent-LDR-split draw — no boot-time pre-warm.
- *   - HDRP variant (`variantSet=''` or compound `=true` form) is registered
+ *   - clustered variant (`variantSet=''` or compound `=true` form) is registered
  *     lazily when the clustered Standard profile activates, not at boot — adding clustered
  *     prewarm here would build PSOs against the URP layout (the boot-time
- *     `pbrModule` is the URP variant when `isHdrpActive=false`)
+ *     `pbrModule` is the non-clustered variant before a frame admits local lights)
  *
  * `ldrViewFormat` parameterises the LDR color attachment format. Callers
  * pass the runtime-resolved swap-chain view format (Channel 2 typically

package/dist/pipeline-spec.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"pipeline-spec.d.ts","sourceRoot":"","sources":["../src/pipeline-spec.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"pipeline-spec.d.ts","sourceRoot":"","sources":["../src/pipeline-spec.ts"],"names":[],"mappings":"AAmBA,OAAO,EAGL,KAAK,sBAAsB,EAC5B,MAAM,0BAA0B,CAAC;AAClC,OAAO,EAEL,gBAAgB,EAChB,KAAK,mBAAmB,EAGxB,KAAK,MAAM,EAEZ,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,+BAA+B,EAAE,MAAM,iBAAiB,CAAC;AAElE,OAAO,EACL,KAAK,OAAO,EACZ,KAAK,+BAA+B,EACpC,8BAA8B,EAC9B,mCAAmC,GACpC,MAAM,gBAAgB,CAAC;AAGxB,OAAO,EAAE,gBAAgB,EAAE,CAAC;AAE5B;;;GAGG;AACH,eAAO,MAAM,sBAAsB,EAAE,SAAS,gBAAgB,EAI7D,CAAC;AAEF,kEAAkE;AAClE,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,MAAM,EAChB,kBAAkB,EAAE,gBAAgB,GACnC,SAAS,gBAAgB,EAAE,CAI7B;AAMD;;;;;;;;;;;;;;;GAeG;AACH,YAAY,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAE1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,uBAAuB,CAAC;AAK1D;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,qBAAqB,GAC7B,mBAAmB,GACnB,mBAAmB,GACnB,gCAAgC,GAChC,gCAAgC,GAChC,2BAA2B,GAC3B,uBAAuB,GACvB,uBAAuB,CAAC;AAE5B;;;;;;;GAOG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;IAC1C,QAAQ,CAAC,IAAI,EAAE,qBAAqB,CAAC;IACrC;;;;;;;;;;OAUG;IACH,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;gBAE7B,IAAI,EAAE;QAChB,IAAI,EAAE,qBAAqB,CAAC;QAC5B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;QAChC,IAAI,CAAC,EAAE,MAAM,CAAC;KACf;CAUF;AAeD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,WAAW,EAAE,mBAAmB,GAAG,SAAS,GAAG,MAAM,CAiBpF;AAMD;;;;;;;;;;;GAWG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,YAAY,GAAG,MAAM,CAyCrD;AAED;;;;GAIG;AACH,wBAAgB,oCAAoC,CAClD,UAAU,EAAE,sBAAsB,EAClC,kBAAkB,EAAE,MAAM,GAAG,SAAS,GACrC,MAAM,CAAC,MAAM,EAAE,+BAA+B,CAAC,CA0BjD;AAED;;;;;;;;GAQG;AACH,wBAAgB,4BAA4B,CAC1C,SAAS,EAAE,OAAO,EAClB,aAAa,EAAE,OAAO,EACtB,oBAAoB,EAAE,OAAO,GAC5B,MAAM,CAGR;AAED;;;;;;;;;GASG;AACH,wBAAgB,0BAA0B,CACxC,QAAQ,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,iBAAiB,GAAG,WAAW,CAAA;CAAE,GAAG,SAAS,EACxE,aAAa,EAAE,OAAO,EACtB,oBAAoB,EAAE,OAAO,GAC5B,MAAM,CAMR;AAED;;;;GAIG;AACH,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE;IAAE,QAAQ,CAAC,IAAI,EAAE,iBAAiB,GAAG,WAAW,CAAA;CAAE,GAAG,SAAS,EACxE,gBAAgB,EAAE,OAAO,GACxB,OAAO,CAIT;AAED,4EAA4E;AAC5E,wBAAgB,yBAAyB,CACvC,aAAa,EAAE,OAAO,EACtB,oBAAoB,EAAE,OAAO,GAC5B,MAAM,CAGR;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,uBAAuB,CACrC,IAAI,EAAE,YAAY,EAClB,OAAO,EAAE;IACP,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,GACA,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA6GzB;AAMD;;;;;GAKG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,UAAU,EAAE,QAAQ,GAAG,SAAS,CAAC;CAC3C;AAED;;;;;;;;GAQG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,OAAO,GAAG,SAAS,CAAC;IACtC,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,wBAAwB;IACvC,QAAQ,CAAC,KAAK,EAAE,YAAY,GAAG,YAAY,GAAG,iBAAiB,CAAC;IAChE,QAAQ,CAAC,eAAe,EAAE,kBAAkB,GAAG,SAAS,CAAC;IACzD,QAAQ,CAAC,eAAe,EAAE,kBAAkB,GAAG,SAAS,CAAC;CAC1D;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,eAAO,MAAM,mBAAmB,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,wBAAwB,CAAC,CAqGlF,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,wBAAgB,8BAA8B,CAC5C,eAAe,EAAE,YAAY,CAAC,aAAa,CAAC,EAC5C,YAAY,EAAE;IACZ,QAAQ,CAAC,UAAU,EAAE,SAAS,OAAO,EAAE,CAAC;IACxC,QAAQ,CAAC,cAAc,CAAC,EAAE,SAAS,CAAC,OAAO,GAAG,SAAS,CAAC,EAAE,CAAC;IAC3D,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;CAC9B,EACD,QAAQ,EAAE,MAAM,EAChB,OAAO,CAAC,EAAE;IACR,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IACxC,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5C,QAAQ,CAAC,UAAU,CAAC,EAAE,QAAQ,CAAC;IAC/B,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IACxC,QAAQ,CAAC,YAAY,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;IAC5C,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;CACzB,GACA,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CA8EzB;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,YAAY,CAC1B,IAAI,EAAE,YAAY,GAEhB;IAAE,EAAE,EAAE,IAAI,CAAA;CAAE,GACZ;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,IAAI,EAAE,qBAAqB,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAuC7F;AAMD;;;;;;;;;GASG;AACH,MAAM,MAAM,aAAa,GAAG,GAAG,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;AAMjD;;;;;;GAMG;AACH,MAAM,WAAW,sBAAsB;IACrC,oBAAoB,CAClB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAClC;QAAE,EAAE,EAAE,IAAI,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,GAAG;QAAE,EAAE,EAAE,KAAK,CAAC;QAAC,KAAK,EAAE,OAAO,CAAA;KAAE,CAAC;CACjE;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH,wBAAgB,kBAAkB,CAChC,IAAI,EAAE,YAAY,EAClB,cAAc,EAAE,sBAAsB,EACtC,KAAK,EAAE,aAAa,EACpB,OAAO,CAAC,EAAE;IACR,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,OAAO,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB,GACA,OAAO,CAiCT;AA0DD;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyCG;AACH,wBAAgB,mBAAmB,CACjC,aAAa,EAAE,gBAAgB,GAC9B,SAAS,QAAQ,CAAC,YAAY,CAAC,EAAE,CA8NnC;AAED;;;;;;;;GAQG;AACH,wBAAgB,+BAA+B,CAC7C,aAAa,EAAE,gBAAgB,GAC9B,SAAS,QAAQ,CAAC,YAAY,CAAC,EAAE,CAanC;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,gBAAgB,EAAE,SAAS,QAAQ,CAAC,YAAY,CAAC,EACrB,CAAC"}

package/dist/point-shadow-inspection.d.ts

@@ -0,0 +1,21 @@
+import type { PointShadowSnapshot } from './render-system-extract';
+/**
+ * Detached point-shadow budget facts from one completed extract/record frame.
+ *
+ * `requested` is the number of PointLight + PointLightShadow pairs. The
+ * renderer owns the bounded cube-array atlas, so `admitted`, `shadowed`, and
+ * `shadowAtlasOccupancy` are all derived from the layer sentinel emitted by
+ * the same extract owner. No consumer needs to maintain a second budget
+ * ledger.
+ */
+export interface PointShadowInspection {
+    readonly status: 'inactive' | 'ready' | 'over-budget';
+    readonly requested: number;
+    readonly admitted: number;
+    readonly shadowed: number;
+    readonly shadowAtlasOccupancy: number;
+    readonly shadowAtlasCapacity: number;
+}
+/** Project point-shadow snapshots to the public, JSON-safe inspection shape. */
+export declare function inspectPointShadow(snapshots: readonly PointShadowSnapshot[], shadowAtlasCapacity: number): PointShadowInspection;
+//# sourceMappingURL=point-shadow-inspection.d.ts.map

package/dist/point-shadow-inspection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"point-shadow-inspection.d.ts","sourceRoot":"","sources":["../src/point-shadow-inspection.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAEnE;;;;;;;;GAQG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,GAAG,aAAa,CAAC;IACtD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;CACtC;AAED,gFAAgF;AAChF,wBAAgB,kBAAkB,CAChC,SAAS,EAAE,SAAS,mBAAmB,EAAE,EACzC,mBAAmB,EAAE,MAAM,GAC1B,qBAAqB,CA8BvB"}

package/dist/record/frame-lighting.d.ts

@@ -1,8 +1,25 @@
-import { type BindGroup, type BindGroupLayout, type TextureView } from '@forgeax/engine-rhi';
+import { type BindGroup, type BindGroupLayout, type RhiDevice, type TextureView } from '@forgeax/engine-rhi';
+import { type Result } from '@forgeax/engine-types';
+import { type RenderError } from '../errors/render';
+import { type PreparedStandardLighting } from '../pipeline/standard-lighting/prepare';
+import type { StandardTopologyInputValue } from '../pipeline/standard-lighting/topology';
+import { type StandardClusterTransport } from '../pipeline/standard-lighting/transport';
+import type { ReflectionProbeTable } from '../reflection/gpu-table';
+import type { ReflectionProbeSelectionResult } from '../reflection/projection';
 import type { CameraSnapshot } from '../render-contract';
 import type { DirectionalLightSnapshot, ExtractedLights, RenderableSnapshot, SkyboxSnapshot, SkylightSnapshot } from '../render-system-extract';
 import type { BindGroupCounts, RenderFrameState } from './frame-snapshot';
 import type { PipelineState, RecordProfileRunner, RenderSystemInternals } from './render-context';
+export interface StandardReflectionProbeBinding {
+    readonly probeIndex: number | undefined;
+    readonly useSkylight: boolean;
+}
+export declare function resolveReflectionProbeBinding(selection: ReflectionProbeSelectionResult, table?: ReflectionProbeTable): StandardReflectionProbeBinding;
+export declare function projectDeviceOwnedBindGroup<T>(state: {
+    readonly device: RhiDevice;
+    readonly layout: BindGroupLayout;
+    readonly bindGroup: T;
+} | null | undefined, device: RhiDevice, layout: BindGroupLayout | null): T | null;
 /**
  * feat-20260704 M3/w18: per-frame bind-group cache resolution, extracted
  * verbatim from `recordFrame`. Walks the handle-identity WeakMap caches
@@ -17,7 +34,9 @@ import type { PipelineState, RecordProfileRunner, RenderSystemInternals } from '
 export declare function buildPerFrameBindGroups(internals: RenderSystemInternals, frameState: RenderFrameState, pipelineState: PipelineState, hasValidated: boolean, bindGroupCounts: BindGroupCounts, graphTargets?: {
     readonly directionalShadow?: TextureView | undefined;
     readonly spotShadow?: TextureView | undefined;
-}, includeView?: boolean): {
+    readonly projector?: TextureView | undefined;
+    readonly projectorSampler?: import('@forgeax/engine-rhi').Sampler | undefined;
+}, includeView?: boolean, standardLighting?: StandardTopologyInputValue): {
     viewBindGroup: BindGroup | null;
     meshBindGroup: BindGroup | null;
     hdrpClusterBindGroup: BindGroup | null;
@@ -25,8 +44,7 @@ export declare function buildPerFrameBindGroups(internals: RenderSystemInternals
 };
 /**
  * feat-20260704 M3/w18: per-frame lighting preparation, extracted verbatim from
- * `recordFrame`. (1) URP-only multi-light warn-once (directional / point / spot
- * over `LIGHT_ARRAY_MAX_SLOTS`; HDRP gated off — 256 SSBO lights). (2) pin the
+ * `recordFrame`. (1) pin the
  * point + spot shadow snapshot lists onto frameState for the URP shadow caster
  * pass closures + lazy-allocate the point-shadow cube_array atlas on first
  * non-empty frame (AC-09 zero-shadow zero-alloc). (3) destructure ExtractedLights
@@ -35,26 +53,13 @@ export declare function buildPerFrameBindGroups(internals: RenderSystemInternals
  *
  * @internal
  */
-export declare function prepareFrameLighting(internals: RenderSystemInternals, frameState: RenderFrameState, lights: ExtractedLights): {
+export declare function prepareFrameLighting(internals: RenderSystemInternals, frameState: RenderFrameState, lights: ExtractedLights, camera: CameraSnapshot, pipelineState?: Pick<PipelineState, 'hdrpClusterMembershipPipeline' | 'hdrpClusterMembershipBindGroupLayout'>): Result<{
     light: DirectionalLightSnapshot;
     pointLights: ExtractedLights['point'];
     spotLights: ExtractedLights['spot'];
     totalLightCount: number;
-};
-/**
- * feat-20260704 M3/w18: per-frame full rewrite of the PointLight + SpotLight
- * std430 storage buffers, extracted verbatim from `recordFrame`.
- *
- * feat-20260519-light-casters-point-spot-pbr M3 / w20 (D-S1 + D-S2 + D-S6):
- * header (16 B count u32 + 12 B pad) at offset 0 + first-slice cap N=4 slots
- * packed sequentially. The N>4 fail-fast upstream ensures the counts are <= 4
- * when the listener registry consumed the structured error; the slice keeps
- * the buffer write bounded even if downstream listeners ignore the RhiError
- * (charter P9 graceful degradation: surplus entities dropped, frame records).
- *
- * @internal
- */
-export declare function writePointSpotLightBuffers(internals: RenderSystemInternals, pipelineState: PipelineState, lights: ExtractedLights): void;
+    standard: StandardTopologyInputValue;
+}, RenderError>;
 /**
  * feat-20260704 M3/w18: write the point-shadow params UBO (bound at viewBg
  * binding 6), extracted verbatim from `recordFrame`.
@@ -83,21 +88,13 @@ export declare function writeShadowParamsBuffer(internals: RenderSystemInternals
  */
 export declare function warnZeroLightStandard(frameState: RenderFrameState, renderables: readonly RenderableSnapshot[], skylight: SkylightSnapshot | undefined, totalLightCount: number): void;
 /**
- * feat-20260704 M3/w18: HDRP per-frame CPU cluster binning + light-data /
- * cluster-grid / light-index-list / cluster-uniform / SSAO uniform buffer
- * uploads. Extracted verbatim from `recordFrame`. Runs only when the HDRP
- * pipeline is active. A zero-punctual frame explicitly clears the persistent
- * cluster buffers so stale membership cannot leak across frames; direct and
- * non-clustered paths remain untouched.
- *
- * feat-20260608-cluster-lighting M5 / w21 + M6 / w23 + r2 fix-up: fail-soft
- * semantics preserved verbatim — index-list-overflow and light-budget-exceeded
- * fire once per frame (via `frameState.hdrpOncePerFrameFired`) and continue
- * rendering.
+ * Write the one prepared Standard Cluster payload into the persistent buffers.
+ * Membership has already been derived by `prepareFrameLighting`; this function
+ * only packs/uploads that immutable result and never re-runs the binner.
  *
  * @internal
  */
-export declare function writeHdrpClusterAndSsaoBuffers(internals: RenderSystemInternals, frameState: RenderFrameState, camera: CameraSnapshot, pointLights: ExtractedLights['point'], spotLights: ExtractedLights['spot'], profilePhase?: RecordProfileRunner, useGpuMembership?: boolean, membershipBindGroupLayout?: BindGroupLayout | null): void;
+export declare function writeHdrpClusterAndSsaoBuffers(internals: RenderSystemInternals, frameState: RenderFrameState, camera: CameraSnapshot, prepared: PreparedStandardLighting, transport: StandardClusterTransport, profilePhase?: RecordProfileRunner, gpuMembershipPipelineReady?: boolean, membershipBindGroupLayout?: BindGroupLayout | null, projectorLightSlotIndex?: number): Result<void, RenderError>;
 /**
  * feat-20260704 M3/w18: resolve `tonemapActive` + `skyboxActive` for this
  * frame, extracted verbatim from `recordFrame`.

package/dist/record/frame-lighting.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"frame-lighting.d.ts","sourceRoot":"","sources":["../../src/record/frame-lighting.ts"],"names":[],"mappings":"AAKA,OAAO,EACL,KAAK,SAAS,EACd,KAAK,eAAe,EAEpB,KAAK,WAAW,EACjB,MAAM,qBAAqB,CAAC;AA2B7B,OAAO,KAAK,EAAE,cAAc,EAA0B,MAAM,oBAAoB,CAAC;AACjF,OAAO,KAAK,EACV,wBAAwB,EACxB,eAAe,EACf,kBAAkB,EAClB,cAAc,EACd,gBAAgB,EACjB,MAAM,0BAA0B,CAAC;AAIlC,OAAO,KAAK,EAAE,eAAe,EAAE,gBAAgB,EAAE,MAAM,kBAAkB,CAAC;AAU1E,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAWlG;;;;;;;;;;GAUG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,qBAAqB,EAChC,UAAU,EAAE,gBAAgB,EAC5B,aAAa,EAAE,aAAa,EAC5B,YAAY,EAAE,OAAO,EACrB,eAAe,EAAE,eAAe,EAChC,YAAY,CAAC,EAAE;IACb,QAAQ,CAAC,iBAAiB,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;IACrD,QAAQ,CAAC,UAAU,CAAC,EAAE,WAAW,GAAG,SAAS,CAAC;CAC/C,EACD,WAAW,UAAO,GACjB;IACD,aAAa,EAAE,SAAS,GAAG,IAAI,CAAC;IAChC,aAAa,EAAE,SAAS,GAAG,IAAI,CAAC;IAChC,oBAAoB,EAAE,SAAS,GAAG,IAAI,CAAC;IACvC,8BAA8B,EAAE,SAAS,GAAG,IAAI,CAAC;CAClD,CA0QA;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,qBAAqB,EAChC,UAAU,EAAE,gBAAgB,EAC5B,MAAM,EAAE,eAAe,GACtB;IACD,KAAK,EAAE,wBAAwB,CAAC;IAChC,WAAW,EAAE,eAAe,CAAC,OAAO,CAAC,CAAC;IACtC,UAAU,EAAE,eAAe,CAAC,MAAM,CAAC,CAAC;IACpC,eAAe,EAAE,MAAM,CAAC;CACzB,CAyFA;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,0BAA0B,CACxC,SAAS,EAAE,qBAAqB,EAChC,aAAa,EAAE,aAAa,EAC5B,MAAM,EAAE,eAAe,GACtB,IAAI,CA+CN;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,uBAAuB,CACrC,SAAS,EAAE,qBAAqB,EAChC,UAAU,EAAE,gBAAgB,EAC5B,aAAa,EAAE,aAAa,GAC3B,IAAI,CA4BN;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,qBAAqB,CACnC,UAAU,EAAE,gBAAgB,EAC5B,WAAW,EAAE,SAAS,kBAAkB,EAAE,EAC1C,QAAQ,EAAE,gBAAgB,GAAG,SAAS,EACtC,eAAe,EAAE,MAAM,GACtB,IAAI,CAgBN;AAED;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,8BAA8B,CAC5C,SAAS,EAAE,qBAAqB,EAChC,UAAU,EAAE,gBAAgB,EAC5B,MAAM,EAAE,cAAc,EACtB,WAAW,EAAE,eAAe,CAAC,OAAO,CAAC,EACrC,UAAU,EAAE,eAAe,CAAC,MAAM,CAAC,EACnC,YAAY,CAAC,EAAE,mBAAmB,EAClC,gBAAgB,UAAQ,EACxB,yBAAyB,GAAE,eAAe,GAAG,IAAW,GACvD,IAAI,CA6WN;AAED;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,qBAAqB,EAChC,UAAU,EAAE,gBAAgB,EAC5B,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,cAAc,GAAG,SAAS,GACjC;IAAE,aAAa,EAAE,OAAO,CAAC;IAAC,YAAY,EAAE,OAAO,CAAA;CAAE,CAqCnD"}
+{"version":3,"file":"frame-lighting.d.ts","sourceRoot":"","sources":["../../src/record/frame-lighting.ts"],"names":[],"mappings":"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"}