@forgeax/engine-render 0.1.20 → 0.1.23

package/dist/instances-derived-bounds.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Inputs owned by the render extract/persistent-scene boundary. Bounds are
+ * deliberately derived here instead of being added to the author-facing
+ * `Instances` component or written back to a Pack asset.
+ */
+export interface DerivedInstancesUnionBoundsInput {
+    readonly meshAabb: ArrayLike<number> | undefined;
+    readonly entityWorld: ArrayLike<number>;
+    readonly transforms: ArrayLike<number> | undefined;
+}
+/**
+ * Renderer-owned cache key. Each generation is supplied by the owner that can
+ * observe that mutation: mesh/AABB publication, entity world transform, and
+ * the packed instance matrix array respectively.
+ */
+export interface InstanceBoundsCacheKey {
+    /** Optional scene/world scope for composite scenes; omitted for standalone tests. */
+    readonly worldId?: number;
+    readonly entityKey: number;
+    readonly meshGeneration: number;
+    readonly transformGeneration: number;
+    readonly matrixGeneration: number;
+}
+export type InstanceBoundsCacheInput = InstanceBoundsCacheKey & DerivedInstancesUnionBoundsInput;
+/**
+ * Stable bitwise fingerprint for detached numeric facts used by the cache.
+ * Float32 bits are hashed rather than decimal text so a real matrix/AABB
+ * change invalidates the projection without keeping another mutable ledger.
+ */
+export declare function fingerprintNumericArray(values: ArrayLike<number>): number;
+/**
+ * Derive the world-space AABB enclosing every instance of a mesh.
+ *
+ * `undefined` is a conservative signal: the caller must skip CPU culling
+ * when an input is missing, malformed, or empty. This prevents an empty
+ * `Instances` row from becoming a synthetic identity draw/bounds candidate.
+ */
+export declare function deriveInstancesUnionBounds(input: DerivedInstancesUnionBoundsInput): Float32Array | undefined;
+/**
+ * Small renderer-owned per-entity cache. A changed generation replaces the
+ * entry atomically; packed-id reuse is safe when its owner supplies a new
+ * generation (the normal RenderScene slot generation contract).
+ */
+export declare class InstanceBoundsCache {
+    private readonly entries;
+    private key;
+    get(input: InstanceBoundsCacheInput): Float32Array | undefined;
+    invalidate(entityKey?: number, worldId?: number): void;
+}
+//# sourceMappingURL=instances-derived-bounds.d.ts.map

package/dist/instances-derived-bounds.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"instances-derived-bounds.d.ts","sourceRoot":"","sources":["../src/instances-derived-bounds.ts"],"names":[],"mappings":"AAEA;;;;GAIG;AACH,MAAM,WAAW,gCAAgC;IAC/C,QAAQ,CAAC,QAAQ,EAAE,SAAS,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;IACjD,QAAQ,CAAC,WAAW,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC;IACxC,QAAQ,CAAC,UAAU,EAAE,SAAS,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;CACpD;AAED;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC,qFAAqF;IACrF,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;CACnC;AAED,MAAM,MAAM,wBAAwB,GAAG,sBAAsB,GAAG,gCAAgC,CAAC;AAEjG;;;;GAIG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,SAAS,CAAC,MAAM,CAAC,GAAG,MAAM,CASzE;AAyCD;;;;;;GAMG;AACH,wBAAgB,0BAA0B,CACxC,KAAK,EAAE,gCAAgC,GACtC,YAAY,GAAG,SAAS,CA8B1B;AAMD;;;;GAIG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA+C;IAEvE,OAAO,CAAC,GAAG;IAIX,GAAG,CAAC,KAAK,EAAE,wBAAwB,GAAG,YAAY,GAAG,SAAS;IAsB9D,UAAU,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI;CAOvD"}

package/dist/internal.d.ts

@@ -1,4 +1,13 @@
 export { type ResolvedTilesetRuntime, resolveTilesetRuntime, type TilesetAtlasLookup, type TilesetRuntimeError, type TilesetRuntimeErrorCode, } from '@forgeax/engine-assets-runtime';
+export { DeviceScope } from './device/device-scope';
+export { createLightResourceUnavailable } from './errors/render';
+export { deriveLtcResourcePlan, type LtcResourcePlan, } from './prepare/extended-lighting/ltc-resources';
+export { deriveExtendedLightingCapability, EXTENDED_LIGHTING_REQUIRED_SAMPLED_TEXTURES, type ExtendedLightingCapabilityResult, type ExtendedLightingResourceCandidate, extendedLightingSampledTextureCapacityAvailable, } from './prepare/extended-lighting/resources';
+export { createExtendedLightingState, type ExtendedLightingState, projectExtendedLightingInspection, promoteExtendedLightingCandidate, recordExtendedLightingFailure, } from './prepare/extended-lighting/state';
 export { type GraphTargetCaptureReadbackValidation, validateGraphTargetCaptureReadback, } from './record/frame-snapshot';
+export { buildRectAreaWorldFrame, rectAreaFacesPoint, } from './render-system-extract';
+export { admitProbeContributors, blendLightProbes, PROBE_MAX_CONTRIBUTORS, scaledProbeWeight, } from './scene/probe-blend';
+export { createVisibilityBudget, type VisibilityBudget, } from './scene/visibility/budget';
+export { type OcclusionRuntimeTestHooks, setOcclusionRuntimeTestHooks, } from './scene/visibility/occlusion-runtime';
 export { TemporalFrameCoordinator } from './temporal/frame-coordinator';
 //# sourceMappingURL=internal.d.ts.map

package/dist/internal.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,sBAAsB,EAC3B,qBAAqB,EACrB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,GAC7B,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,KAAK,oCAAoC,EACzC,kCAAkC,GACnC,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC"}
+{"version":3,"file":"internal.d.ts","sourceRoot":"","sources":["../src/internal.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,sBAAsB,EAC3B,qBAAqB,EACrB,KAAK,kBAAkB,EACvB,KAAK,mBAAmB,EACxB,KAAK,uBAAuB,GAC7B,MAAM,gCAAgC,CAAC;AACxC,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,8BAA8B,EAAE,MAAM,iBAAiB,CAAC;AACjE,OAAO,EACL,qBAAqB,EACrB,KAAK,eAAe,GACrB,MAAM,2CAA2C,CAAC;AACnD,OAAO,EACL,gCAAgC,EAChC,2CAA2C,EAC3C,KAAK,gCAAgC,EACrC,KAAK,iCAAiC,EACtC,+CAA+C,GAChD,MAAM,uCAAuC,CAAC;AAC/C,OAAO,EACL,2BAA2B,EAC3B,KAAK,qBAAqB,EAC1B,iCAAiC,EACjC,gCAAgC,EAChC,6BAA6B,GAC9B,MAAM,mCAAmC,CAAC;AAC3C,OAAO,EACL,KAAK,oCAAoC,EACzC,kCAAkC,GACnC,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,uBAAuB,EACvB,kBAAkB,GACnB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EACL,sBAAsB,EACtB,gBAAgB,EAChB,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACL,sBAAsB,EACtB,KAAK,gBAAgB,GACtB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EACL,KAAK,yBAAyB,EAC9B,4BAA4B,GAC7B,MAAM,sCAAsC,CAAC;AAC9C,OAAO,EAAE,wBAAwB,EAAE,MAAM,8BAA8B,CAAC"}

package/dist/internal.mjs

@@ -1,5 +1,26 @@
-export { TemporalFrameCoordinator } from './chunk-PCHBPYML.mjs';
-export { validateGraphTargetCaptureReadback } from './chunk-M2MP4ZOU.mjs';
+export { PROBE_MAX_CONTRIBUTORS, admitProbeContributors, blendLightProbes, buildRectAreaWorldFrame, createExtendedLightingState, projectExtendedLightingInspection, promoteExtendedLightingCandidate, recordExtendedLightingFailure, rectAreaFacesPoint, scaledProbeWeight, setOcclusionRuntimeTestHooks } from './chunk-DIYW3M5D.mjs';
+import './chunk-FJ6P52EE.mjs';
+export { createVisibilityBudget } from './chunk-FF7K3FSO.mjs';
+import './chunk-JDWARUOI.mjs';
+export { TemporalFrameCoordinator } from './chunk-4L3P6DT5.mjs';
+import { EXTENDED_LIGHTING_TOPOLOGY } from './chunk-HZUPSYW7.mjs';
+export { DeviceScope, EXTENDED_LIGHTING_REQUIRED_SAMPLED_TEXTURES, deriveExtendedLightingCapability, extendedLightingSampledTextureCapacityAvailable, validateGraphTargetCaptureReadback } from './chunk-HZUPSYW7.mjs';
+export { createLightResourceUnavailable } from './chunk-QODA5UKU.mjs';
 export { resolveTilesetRuntime } from '@forgeax/engine-assets-runtime';
+import '@forgeax/engine-shader';
+import '@forgeax/engine-types';
+
+function deriveLtcResourcePlan(input) {
+  const admitted = input.ltcAvailable;
+  return {
+    topology: EXTENDED_LIGHTING_TOPOLOGY,
+    generation: input.scope.generation,
+    rectAdmission: admitted ? "admitted" : "omitted",
+    tableCount: admitted ? 2 : 0,
+    uploadCount: admitted && input.residentGeneration !== input.scope.generation ? 2 : 0
+  };
+}
+
+export { deriveLtcResourcePlan };
 //# sourceMappingURL=internal.mjs.map
 //# sourceMappingURL=internal.mjs.map

package/dist/internal.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":[],"names":[],"mappings":"","file":"internal.mjs","sourcesContent":[]}
+{"version":3,"sources":["../src/prepare/extended-lighting/ltc-resources.ts"],"names":[],"mappings":";;;;;;;;;;;;AAoCO,SAAS,sBAAsB,KAAA,EAA8C;AAClF,EAAA,MAAM,WAAW,KAAA,CAAM,YAAA;AACvB,EAAA,OAAO;AAAA,IACL,QAAA,EAAU,0BAAA;AAAA,IACV,UAAA,EAAY,MAAM,KAAA,CAAM,UAAA;AAAA,IACxB,aAAA,EAAe,WAAW,UAAA,GAAa,SAAA;AAAA,IACvC,UAAA,EAAY,WAAW,CAAA,GAAI,CAAA;AAAA,IAC3B,aAAa,QAAA,IAAY,KAAA,CAAM,uBAAuB,KAAA,CAAM,KAAA,CAAM,aAAa,CAAA,GAAI;AAAA,GACrF;AACF","file":"internal.mjs","sourcesContent":["// @forgeax/engine-render - DeviceScope-owned RectArea LTC resources.\n\nimport type { Result, RhiDevice, RhiError, Texture } from '@forgeax/engine-rhi';\nimport { LTC_TABLE_HEIGHT, LTC_TABLE_WIDTH, LTC_TABLES } from '@forgeax/engine-shader';\nimport { err, ok } from '@forgeax/engine-types';\nimport { type DeviceScope, LifecycleTransaction } from '../../device/device-scope';\nimport {\n  GPU_TEXTURE_USAGE_COPY_DST,\n  GPU_TEXTURE_USAGE_TEXTURE_BINDING,\n} from '../../gpu-texture-usage';\nimport { deriveExtendedLightingCapability, EXTENDED_LIGHTING_TOPOLOGY } from './resources';\n\nexport interface LtcResourcePlanInput {\n  readonly scope: DeviceScope;\n  readonly ltcAvailable: boolean;\n  readonly residentGeneration?: number;\n}\n\nexport interface LtcResourcePlan {\n  readonly topology: typeof EXTENDED_LIGHTING_TOPOLOGY;\n  readonly generation: number;\n  readonly rectAdmission: 'admitted' | 'omitted';\n  readonly tableCount: number;\n  readonly uploadCount: number;\n}\n\nexport interface LtcResourceCandidate {\n  readonly topology: typeof EXTENDED_LIGHTING_TOPOLOGY;\n  readonly generation: number;\n  readonly scope: DeviceScope;\n  readonly lambertTexture: Texture;\n  readonly ggxTexture: Texture;\n  readonly tableCount: 2;\n  readonly uploadCount: 2;\n}\n\nexport function deriveLtcResourcePlan(input: LtcResourcePlanInput): LtcResourcePlan {\n  const admitted = input.ltcAvailable;\n  return {\n    topology: EXTENDED_LIGHTING_TOPOLOGY,\n    generation: input.scope.generation,\n    rectAdmission: admitted ? 'admitted' : 'omitted',\n    tableCount: admitted ? 2 : 0,\n    uploadCount: admitted && input.residentGeneration !== input.scope.generation ? 2 : 0,\n  };\n}\n\nfunction failure(expected: string, actual: string): Result<never, RhiError> {\n  return err({\n    code: 'webgpu-runtime-error',\n    expected,\n    hint: 'inspect device capabilities and retry the extendedLighting candidate',\n    detail: { error: { code: 'ltc-resource', message: actual } },\n  } as RhiError);\n}\n\nfunction textureBytes(table: Uint16Array): Uint8Array {\n  return new Uint8Array(table.buffer, table.byteOffset, table.byteLength);\n}\n\n/** Create both tracked tables atomically; unavailable LTC only omits Rect. */\nexport async function createLtcResourceCandidate(input: {\n  readonly device: RhiDevice | undefined;\n  readonly scope: DeviceScope;\n}): Promise<Result<LtcResourceCandidate | undefined, RhiError>> {\n  if (input.device === undefined) return ok(undefined);\n  if (!deriveExtendedLightingCapability(input.device).admitted) return ok(undefined);\n  const device = input.device;\n\n  const transaction = new LifecycleTransaction(input.scope);\n  let lambertTexture: Texture | undefined;\n  let ggxTexture: Texture | undefined;\n  const createTable = (label: string, table: Uint16Array): Texture => {\n    const texture = device.createTexture({\n      label,\n      size: { width: LTC_TABLE_WIDTH, height: LTC_TABLE_HEIGHT, depthOrArrayLayers: 1 },\n      mipLevelCount: 1,\n      sampleCount: 1,\n      dimension: '2d',\n      format: 'rgba16float',\n      usage: GPU_TEXTURE_USAGE_COPY_DST | GPU_TEXTURE_USAGE_TEXTURE_BINDING,\n      viewFormats: [],\n      textureBindingViewDimension: undefined,\n    });\n    if (texture === undefined || !texture.ok) {\n      throw texture?.error ?? new Error('LTC texture creation returned no result');\n    }\n    const write = device.queue.writeTexture(\n      { texture: texture.value, mipLevel: 0, origin: { x: 0, y: 0, z: 0 } },\n      textureBytes(table),\n      { offset: 0, bytesPerRow: LTC_TABLE_WIDTH * 8, rowsPerImage: LTC_TABLE_HEIGHT },\n      { width: LTC_TABLE_WIDTH, height: LTC_TABLE_HEIGHT, depthOrArrayLayers: 1 },\n    );\n    if (!write.ok) throw write.error;\n    return texture.value;\n  };\n\n  transaction.add({\n    kind: 'texture',\n    create: () => {\n      lambertTexture = createTable('extended-lighting-ltc-lambert', LTC_TABLES.lambert);\n      return lambertTexture;\n    },\n    cleanup: (value) => {\n      const destroyed = input.device?.destroyTexture(value);\n      if (destroyed !== undefined && !destroyed.ok) throw destroyed.error;\n    },\n  });\n  transaction.add({\n    kind: 'texture',\n    create: () => {\n      ggxTexture = createTable('extended-lighting-ltc-ggx', LTC_TABLES.ggx);\n      return ggxTexture;\n    },\n    cleanup: (value) => {\n      const destroyed = input.device?.destroyTexture(value);\n      if (destroyed !== undefined && !destroyed.ok) throw destroyed.error;\n    },\n  });\n\n  const committed = await transaction.commit();\n  if (!committed.ok)\n    return failure(committed.error.primary.expected, committed.error.primary.message);\n  if (lambertTexture === undefined || ggxTexture === undefined) {\n    return failure('two LTC textures', 'the transaction committed without both tables');\n  }\n  return ok({\n    topology: EXTENDED_LIGHTING_TOPOLOGY,\n    generation: input.scope.generation,\n    scope: input.scope,\n    lambertTexture,\n    ggxTexture,\n    tableCount: 2,\n    uploadCount: 2,\n  });\n}\n"]}

package/dist/light-buffer-layout.d.ts

@@ -1,117 +1,20 @@
 import { type Result, RhiError } from '@forgeax/engine-rhi';
-import type { PointLightSnapshot, SpotLightSnapshot } from './render-system-extract';
-/** Byte size of one HDRP LightSlot in std430 (16 x f32). AC-11 absolute-value lock. */
-export declare const BYTES_PER_LIGHT_SLOT = 64;
-/**
- * LightSlot kind discriminant — closed enum matching WGSL `KIND_POINT` / `KIND_SPOT`.
- * Values are u32 bit-tags (not sequential); AC-12 exhaustive switch.
- */
-export declare const LightSlotKind: {
-    readonly POINT: 0;
-    readonly SPOT: 1;
-};
-export type LightSlotKind = (typeof LightSlotKind)[keyof typeof LightSlotKind];
-/**
- * Byte-offset layout of one LightSlot in std430 (16 f32 = 64 B).
- *
- * Mirrors the WGSL `LightSlot` struct field order byte-for-byte.
- * All offsets verified by w14 lightslot-layout.test.ts.
- *
- * feat-20260612-point-light-shadows-urp-hdrp M4 / T-M4-4 (plan-strategy §D-8):
- * the prior u32x3 pad lanes at byte 52..64 carry shadow-side data on the HDRP
- * path. `kind_and_pad.x = kind` (u32), `.y = shadow identity` (i32, sentinel
- * -1 = no shadow). For point lights `.z/.w` carry near/far (f32 via bitcast);
- * for spot lights `.z` carries shadowIntensity and `.w` carries the PCF
- * kernel width (f32 via bitcast). The shader reads these lanes through
- * `bitcast<f32>(...)` to
- * keep the WGSL struct as `vec4<u32>` (alignment + naga_oil unchanged).
- */
-export declare const LIGHTSLOT_LAYOUT: {
-    readonly byteSize: 64;
-    readonly positionOffset: 0;
-    readonly invRangeSquaredOffset: 12;
-    readonly colorOffset: 16;
-    readonly cosInnerOffset: 28;
-    readonly directionOffset: 32;
-    readonly cosOuterOffset: 44;
-    readonly kindOffset: 48;
-    readonly shadowPayloadOffset: 52;
-    readonly shadowAtlasLayerOffset: 52;
-    readonly shadowAtlasTileOffset: 52;
-    readonly shadowNearOffset: 56;
-    readonly shadowFarOffset: 60;
-    readonly spotPcfKernelSizeOffset: 60;
-    readonly floatCount: 16;
-    readonly vec4Count: 4;
-};
+import type { PointLightSnapshot, RectAreaDirectLightSnapshot, SpotLightSnapshot } from './render-system-extract';
 /**
  * Minimum storage-buffer count needed by the M3 record stage.
  *
  *   1. Mesh SSBO (entity_world + normalMatrix; per-renderable dynamic
  *      offset, 256 B stride).
- *   2. PointLight std430 array (this feat).
- *   3. SpotLight std430 array (this feat).
+ *   2. Cluster light_data SSBO.
+ *   3. Cluster membership grid SSBO.
+ *   4. Cluster light-index-list SSBO.
  *
- * Plan R-4 + plan-strategy section 4 risk table: assert >= 4 to keep the
- * head-room margin for todo-125 (cluster expansion lifts to 4-5 entries).
+ * Cluster needs four storage-backed resources in the Standard bind group.
+ * This is the complete local-light transport.
  */
 export declare const STORAGE_BUFFER_MIN_REQUIRED = 4;
-/** Byte size of one PointLight std430 slot (vec4 * 2). */
-export declare const POINT_LIGHT_STD430_BYTES = 32;
-/**
- * Byte size of one SpotLight std430 slot (five 16-byte columns).
- *
- * feat-20260625-spot-light-shadow-mapping M2 / w8 (D-4) grew 48 -> 64 for
- * `shadowAtlasTile`; the visual-parity contract then adds a fifth column for
- * `shadowIntensity` rather than overloading the tile/PCF lanes.
- */
-export declare const SPOT_LIGHT_STD430_BYTES = 80;
-/** Sentinel value for SpotLight slot[15] meaning "no shadow / clipped". */
-export declare const SPOT_LIGHT_SHADOW_TILE_SENTINEL = -1;
-/** Sentinel for a projector-only SpotLight with no shadow atlas tile. */
-export declare const SPOT_LIGHT_PROJECTOR_ONLY_SENTINEL = -2;
-/** Byte size of the array header (count u32 + 12 B pad to 16 B stride). */
-export declare const LIGHT_ARRAY_HEADER_BYTES = 16;
-/** Maximum number of slots packed in the first-slice cap layout (D-S3). */
-export declare const LIGHT_ARRAY_MAX_SLOTS = 4;
-/** Sentinel value for PointLight slot[7] / LightSlot pad meaning "no shadow". */
-export declare const POINT_LIGHT_SHADOW_LAYER_SENTINEL = -1;
-/**
- * Pack one PointLightSnapshot into 8 floats / 32 B byte-for-byte std430.
- *
- * Returns a fresh `Float32Array` per call; `Float32Array.byteLength === 32`
- * by construction (Float32Array(8).buffer.byteLength === 32). Slot 7
- * (byte 28..32) carries `shadowAtlasLayer: i32` (sentinel -1 = no shadow,
- * 0..3 = cube_array atlas layer index for shadow casters). The lane is
- * written through an Int32Array view of the same backing ArrayBuffer so the
- * shader's `i32` read at byte 28..32 of `struct PointLight` (common.wgsl)
- * sees the correct two's-complement bits (-1 = 0xFFFFFFFF).
- */
-export declare function packPointLight(snap: PointLightSnapshot): Float32Array;
-/**
- * Pack one SpotLightSnapshot into 20 floats (80 B byte-for-byte std430).
- *
- * cosInner / cosOuter ride the otherwise-padding `.w` lanes of the
- * `color` and `direction` vec4 columns (AC-04 c + plan D-S2 16 B alignment
- * via packing rather than padding rows). Slot 15 carries `shadowAtlasTile: i32`
- * (sentinel -1 = unassigned/clipped, 0..3 = atlas tile) written through an
- * Int32Array view so the shader's `i32` read at byte 60..64 of struct SpotLight
- * (common.wgsl) sees the correct two's-complement bits (-1 = 0xFFFFFFFF).
- * Slots 12..14 carry the shared receiver controls; slot 15 remains the i32
- * shadow tile sentinel; slot 16 carries shadowIntensity and slots 17..19 are
- * alignment tail padding. Surface and volume consumers therefore share one
- * extracted shadow configuration.
- */
-export declare function packSpotLight(snap: SpotLightSnapshot): Float32Array;
-/**
- * Pack the 16-byte std430 array header (count u32 + 12 B pad) for the
- * point/spot light storage buffers.
- *
- * Returns a fresh `ArrayBuffer` so callers can either re-view it as
- * `Uint8Array` for `queue.writeBuffer` or as `Uint32Array` for in-place
- * inspection.
- */
-export declare function packLightArrayHeader(count: number): ArrayBuffer;
+/** Byte size of one Point/Spot/Rect DirectLightSlot. */
+export declare const BYTES_PER_DIRECT_LIGHT_SLOT = 80;
 /**
  * Cap gate at createRenderer time: check whether the device has enough
  * storage-buffer slots for the PBR pipeline (M3 requires
@@ -127,46 +30,61 @@ export declare function packLightArrayHeader(count: number): ArrayBuffer;
  *
  * Uniform-fallback path decision (plan D-5): `cap === 0` is the wgpu
  * WebGL2 backend signal (`downlevel_webgl2_defaults().limits.
- * maxStorageBuffersPerShaderStage = 0`). Uniform fallback covers pointLight
- * + spotLight + meshes + instances + skin palette — every storage-buffer
- * entry in the PBR pipeline switches to `uniform`.
+ * maxStorageBuffersPerShaderStage = 0`). It remains a mesh/instance fallback;
+ * local-light frames require the single Cluster storage transport.
  */
+/** Closed direct-light kind carried by the unified five-row slot. */
+export declare const DirectLightSlotKind: {
+    readonly POINT: 0;
+    readonly SPOT: 1;
+    readonly RECT_AREA: 2;
+};
+export type DirectLightSlotKind = 'point' | 'spot' | 'rect-area';
+/** Metadata identity used for absent shadow, IES, and Cookie resources. */
+export declare const DIRECT_LIGHT_SLOT_METADATA_SENTINEL = 4294967295;
 /**
- * Optional shadow info attached to a HDRP LightSlot for point lights with a
- * companion `PointLightShadow` component. Sentinel `layer = -1` (the default
- * when the snapshot has no shadow) makes the shader skip cube_array sampling
- * and stay on the unshadowed `evalPoint` path.
- *
- * `near` / `far` ride the otherwise-pad lanes (`kind_and_pad.zw` in the WGSL
- * struct, byte 56..64) and feed the depth-ref reconstruction in
- * `evalPointShadowed`. Spot lights (and shadow-less point lights) leave these
- * lanes zero per std430 init.
+ * SpotLight projector marker carried in the shared shadow identity word. The
+ * lower 30 bits retain the selected shadow tile; projector-only spots use tile
+ * zero because their matrix is deliberately published in View lane zero.
  */
-export interface PointShadowSlotInfo {
-    readonly shadowAtlasLayer: number;
-    readonly near: number;
-    readonly far: number;
-}
+export declare const DIRECT_LIGHT_SLOT_PROJECTOR_FLAG = 1073741824;
+export declare const DIRECT_LIGHT_SLOT_TILE_MASK: number;
+/** Byte size of the five-row Point/Spot/Rect transport slot. */
+export declare const DIRECT_LIGHT_SLOT_FLOAT_COUNT: number;
+/** Five vec4 rows shared by host packing and the WGSL direct-light consumer. */
+export declare const DIRECT_LIGHT_SLOT_LAYOUT: {
+    readonly byteSize: 80;
+    readonly rowByteOffsets: readonly [0, 16, 32, 48, 64];
+    readonly positionOffset: 0;
+    readonly rangeOffset: 12;
+    readonly colorOffset: 16;
+    readonly firstAngleOffset: 28;
+    readonly primaryAxisOffset: 32;
+    readonly secondAngleOffset: 44;
+    readonly auxiliaryAxisOffset: 48;
+    readonly metadataByteOffset: 64;
+    readonly kindByteOffset: 64;
+    readonly shadowByteOffset: 68;
+    readonly iesProfileByteOffset: 72;
+    readonly cookieByteOffset: 76;
+    /** Spot-only roll angle stored in the fourth row's w lane. */
+    readonly rollDegByteOffset: 60;
+    readonly floatCount: number;
+    readonly vec4Count: 5;
+};
+type DirectLightModifierMetadata = {
+    readonly iesProfileSlice?: number;
+    readonly cookieSlice?: number;
+};
+export type DirectLightSnapshot = (PointLightSnapshot & DirectLightModifierMetadata) | (SpotLightSnapshot & DirectLightModifierMetadata) | (RectAreaDirectLightSnapshot & DirectLightModifierMetadata);
 /**
- * Pack one PointLightSnapshot or SpotLightSnapshot into a 64-byte LightSlot
- * (16 floats, std430). Point lights fill `cosInner=1.0`, `direction=vec3(0)`,
- * `cosOuter=0.0`, `kind=POINT(0)`. Spot lights fill all fields verbatim;
- * `direction` is already normalized by extract and this owner never repeats
- * that operation.
- *
- * feat-20260612-point-light-shadows-urp-hdrp M4 / T-M4-4 (plan-strategy §D-8):
- * the optional point `shadow` info threads through to bytes 52..64 as
- * `(shadowAtlasLayer i32, near f32, far f32)`. Spot snapshots write their
- * `shadowAtlasTile` directly into the same identity lane, put shadowIntensity
- * in the `.z` lane, and the PCF kernel width in `.w`. The shader reads `near`/`far`
- * through `bitcast<f32>(kind_and_pad.zw)` so the WGSL struct stays
- * `kind_and_pad: vec4<u32>` (alignment + naga_oil compose unchanged). When
- * `shadow` is undefined (no PointLightShadow) the lanes default to
- * `(layer = -1, 0, 0)` -- shader gates on `layer >= 0` so unshadowed lights
- * stay on the `evaluate_point_light` path. Spot lights write their tile or -1.
+ * Pack one Point, Spot, or Rect snapshot into the unified five-row slot.
  *
- * Returns a fresh `Float32Array(16)` per call.
+ * Row 0 is position plus inverse range. Row 1 is color plus the first
+ * angular/size fact. Row 2 is the primary axis plus the second angular/size
+ * fact. Row 3 is the auxiliary Rect axis. Row 4 is four u32 identities.
  */
-export declare function packLightSlot(snap: PointLightSnapshot | SpotLightSnapshot, shadow?: PointShadowSlotInfo): Float32Array;
+export declare function packDirectLightSlot(snapshot: DirectLightSnapshot, projectorSelected?: boolean): Float32Array;
 export declare function assertStorageBufferCap(cap: number): Result<boolean, RhiError>;
+export {};
 //# sourceMappingURL=light-buffer-layout.d.ts.map

package/dist/light-buffer-layout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"light-buffer-layout.d.ts","sourceRoot":"","sources":["../src/light-buffer-layout.ts"],"names":[],"mappings":"AAsDA,OAAO,EAAW,KAAK,MAAM,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACrE,OAAO,KAAK,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AA4BrF,uFAAuF;AACvF,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAEvC;;;GAGG;AACH,eAAO,MAAM,aAAa;;;CAGhB,CAAC;AACX,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,OAAO,aAAa,CAAC,CAAC;AAE/E;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;CAiBnB,CAAC;AAEX;;;;;;;;;;GAUG;AACH,eAAO,MAAM,2BAA2B,IAAI,CAAC;AAE7C,0DAA0D;AAC1D,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAC3C;;;;;;GAMG;AACH,eAAO,MAAM,uBAAuB,KAAK,CAAC;AAE1C,2EAA2E;AAC3E,eAAO,MAAM,+BAA+B,KAAK,CAAC;AAClD,yEAAyE;AACzE,eAAO,MAAM,kCAAkC,KAAK,CAAC;AACrD,2EAA2E;AAC3E,eAAO,MAAM,wBAAwB,KAAK,CAAC;AAC3C,2EAA2E;AAC3E,eAAO,MAAM,qBAAqB,IAAI,CAAC;AAEvC,iFAAiF;AACjF,eAAO,MAAM,iCAAiC,KAAK,CAAC;AAEpD;;;;;;;;;;GAUG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,kBAAkB,GAAG,YAAY,CAarE;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,iBAAiB,GAAG,YAAY,CA6BnE;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,WAAW,CAM/D;AAED;;;;;;;;;;;;;;;;;;GAkBG;AACH;;;;;;;;;;GAUG;AACH,MAAM,WAAW,mBAAmB;IAClC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;CACtB;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,aAAa,CAC3B,IAAI,EAAE,kBAAkB,GAAG,iBAAiB,EAC5C,MAAM,CAAC,EAAE,mBAAmB,GAC3B,YAAY,CA8Cd;AAED,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,CAkB7E"}
+{"version":3,"file":"light-buffer-layout.d.ts","sourceRoot":"","sources":["../src/light-buffer-layout.ts"],"names":[],"mappings":"AAMA,OAAO,EAAW,KAAK,MAAM,EAAE,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACrE,OAAO,KAAK,EACV,kBAAkB,EAClB,2BAA2B,EAC3B,iBAAiB,EAClB,MAAM,yBAAyB,CAAC;AAqBjC;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,2BAA2B,IAAI,CAAC;AAE7C,wDAAwD;AACxD,eAAO,MAAM,2BAA2B,KAAK,CAAC;AAE9C;;;;;;;;;;;;;;;;;GAiBG;AACH,qEAAqE;AACrE,eAAO,MAAM,mBAAmB;;;;CAItB,CAAC;AACX,MAAM,MAAM,mBAAmB,GAAG,OAAO,GAAG,MAAM,GAAG,WAAW,CAAC;AAEjE,2EAA2E;AAC3E,eAAO,MAAM,mCAAmC,aAAa,CAAC;AAC9D;;;;GAIG;AACH,eAAO,MAAM,gCAAgC,aAAa,CAAC;AAC3D,eAAO,MAAM,2BAA2B,QAAuC,CAAC;AAChF,gEAAgE;AAChE,eAAO,MAAM,6BAA6B,QACoB,CAAC;AAE/D,gFAAgF;AAChF,eAAO,MAAM,wBAAwB;;;;;;;;;;;;;;;IAenC,8DAA8D;;;;CAItD,CAAC;AAEX,KAAK,2BAA2B,GAAG;IACjC,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;CAC/B,CAAC;AAEF,MAAM,MAAM,mBAAmB,GAC3B,CAAC,kBAAkB,GAAG,2BAA2B,CAAC,GAClD,CAAC,iBAAiB,GAAG,2BAA2B,CAAC,GACjD,CAAC,2BAA2B,GAAG,2BAA2B,CAAC,CAAC;AAMhE;;;;;;GAMG;AACH,wBAAgB,mBAAmB,CACjC,QAAQ,EAAE,mBAAmB,EAC7B,iBAAiB,CAAC,EAAE,OAAO,GAC1B,YAAY,CAqEd;AAED,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC,OAAO,EAAE,QAAQ,CAAC,CAkB7E"}

package/dist/materials.d.ts.map

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

package/dist/mesh-material-bindings.d.ts

@@ -11,13 +11,67 @@ export interface ResolvedMeshMaterialBinding {
     readonly handle: number;
     readonly source: MeshMaterialBindingSource;
 }
+/** Lifecycle values projected from an already prepared resident binding. */
+export type MeshMaterialBindingReadiness = 'ready' | 'pending' | 'failed' | 'last-known-good';
+/** Structured producer failure retained by the renderer's bounded projection. */
+export interface MeshMaterialBindingPreparationFailure {
+    readonly code: string;
+    readonly expected: string;
+    readonly hint: string;
+    readonly detail?: Readonly<Record<string, unknown>>;
+}
+export interface MeshMaterialBindingSamplerObservation {
+    readonly handle: number;
+    readonly resident: boolean;
+}
+export interface MeshMaterialBindingTextureObservation {
+    readonly handle: number;
+    readonly mipLevelCount: number;
+}
+/**
+ * One material-slot's bounded resident projection. The renderer reports only
+ * resources it actually resolved for the slot; Pack/AssetRegistry lifecycle
+ * records stay owned by the producer and are never copied here.
+ */
+export interface MeshMaterialBindingResidency {
+    readonly readiness: MeshMaterialBindingReadiness;
+    readonly samplers: readonly MeshMaterialBindingSamplerObservation[];
+    readonly textures: readonly MeshMaterialBindingTextureObservation[];
+    readonly preparationFailure?: MeshMaterialBindingPreparationFailure;
+}
 /** Public read-only observation of the bindings used by the last frame. */
 export interface MeshMaterialBindingObservation {
     readonly worldId: number;
     readonly entityKey: number;
     readonly bindings: readonly ResolvedMeshMaterialBinding[];
     readonly diagnostics: readonly MeshMaterialBindingDiagnostic[];
+    /** One resident projection per resolved material slot. */
+    readonly residency: readonly MeshMaterialBindingResidency[];
 }
+export interface MeshMaterialBindingSummary {
+    readonly total: number;
+    readonly ready: number;
+    readonly pending: number;
+    readonly failed: number;
+    readonly lastKnownGood: number;
+    readonly textureCount: number;
+    readonly samplerCount: number;
+}
+/**
+ * Build the sole renderer observation projection from the resident seam.
+ * Missing facts remain `pending`; they are never guessed from a URL, asset
+ * name, or authoring field. Slot cardinality is normalized so aggregation is
+ * deterministic even while a preparation candidate is incomplete.
+ */
+export declare function projectMeshMaterialBindingObservation(input: {
+    readonly worldId: number;
+    readonly entityKey: number;
+    readonly bindings: readonly ResolvedMeshMaterialBinding[];
+    readonly diagnostics: readonly MeshMaterialBindingDiagnostic[];
+    readonly residency?: readonly MeshMaterialBindingResidency[];
+}): MeshMaterialBindingObservation;
+/** Recompute bounded readiness/resource counts from retained observations. */
+export declare function summarizeMeshMaterialBindings(observations: readonly MeshMaterialBindingObservation[]): MeshMaterialBindingSummary;
 export type ResolveMeshMaterialBindingsResult = {
     readonly ok: true;
     readonly bindings: readonly ResolvedMeshMaterialBinding[];

package/dist/mesh-material-bindings.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"mesh-material-bindings.d.ts","sourceRoot":"","sources":["../src/mesh-material-bindings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,uBAAuB,CAAC;AAEpF,MAAM,MAAM,yBAAyB,GAAG,mBAAmB,GAAG,cAAc,GAAG,gBAAgB,CAAC;AAEhG,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,IAAI,EACT,yCAAyC,GACzC,0CAA0C,CAAC;IAC/C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IACzB,yEAAyE;IACzE,QAAQ,CAAC,MAAM,CAAC,EAAE,QAAQ,CAAC,gBAAgB,CAAC,CAAC;CAC9C;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,MAAM,EAAE,yBAAyB,CAAC;CAC5C;AAED,2EAA2E;AAC3E,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,SAAS,2BAA2B,EAAE,CAAC;IAC1D,QAAQ,CAAC,WAAW,EAAE,SAAS,6BAA6B,EAAE,CAAC;CAChE;AAED,MAAM,MAAM,iCAAiC,GACzC;IACE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAClB,QAAQ,CAAC,QAAQ,EAAE,SAAS,2BAA2B,EAAE,CAAC;IAC1D,QAAQ,CAAC,WAAW,EAAE,SAAS,6BAA6B,EAAE,CAAC;CAChE,GACD;IACE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IACnB,QAAQ,CAAC,IAAI,EAAE,6BAA6B,CAAC;CAC9C,GACD;IACE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IACnB,QAAQ,CAAC,IAAI,EAAE,iCAAiC,CAAC;IACjD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,eAAe,EAAE,SAAS,CAAC;CACrC,CAAC;AAEN;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,SAAS,EACf,iBAAiB,EAAE,SAAS,CAAC,MAAM,CAAC,EACpC,IAAI,EAAE;IACJ,QAAQ,CAAC,eAAe,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC;IACtD,QAAQ,CAAC,kBAAkB,EAAE,CAAC,IAAI,EAAE,SAAS,KAAK,MAAM,GAAG,SAAS,CAAC;CACtE,GACA,iCAAiC,CA8CnC"}
+{"version":3,"file":"mesh-material-bindings.d.ts","sourceRoot":"","sources":["../src/mesh-material-bindings.ts"],"names":[],"mappings":"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"}

package/dist/pbr-pipeline.d.ts

@@ -1,4 +1,4 @@
-import type { BindGroup, BindGroupEntry, BindGroupLayout, BindGroupLayoutDescriptor, Buffer, PipelineLayout, RhiDevice, Sampler, TextureView } from '@forgeax/engine-rhi';
+import type { BindGroup, BindGroupEntry, BindGroupLayout, Buffer, PipelineLayout, RhiDevice, Sampler, TextureFormat, TextureView } from '@forgeax/engine-rhi';
 import { type ShaderCatalog } from '@forgeax/engine-shader';
 import { type ParamSchemaEntry } from '@forgeax/engine-types';
 import type { PipelineSpec } from './pipeline-spec-types';
@@ -18,6 +18,10 @@ export interface PbrPipelineLayoutBundle {
     readonly meshArrayBgl: BindGroupLayout;
     /** Per-instance storage BindGroupLayout (slot 3). */
     readonly instancesBgl: BindGroupLayout;
+    /** Probe-enabled slot-3 BGL; aliases `instancesBgl` when probes are unavailable. */
+    readonly probeInstancesBgl: BindGroupLayout;
+    /** Same pipeline layout with the probe-enabled slot-3 BGL, when supported. */
+    readonly probePipelineLayout: PipelineLayout | null;
     /**
      * Same 4 layouts in slot order. Useful for assertion sites that check the
      * pipeline-layout `bindGroupLayouts` array shape (t57 (a) + (d)).
@@ -29,6 +33,8 @@ export interface PbrPipelineLayoutBundle {
         BindGroupLayout
     ];
 }
+/** Derives the Standard PBR attachment list without allocating a closed path. */
+export declare function standardPbrColorFormats(baseFormat: TextureFormat, fallbackDemand: boolean): readonly TextureFormat[];
 /**
  * The built-in standard-PBR material paramSchema's texture/user-region shape,
  * used as the fallback when the material BGL is built without a registry
@@ -94,13 +100,20 @@ export declare const INJECTION_KIND_LENGTHS: {
  */
 export interface PbrCaps {
     readonly storageBuffer: boolean;
+    /**
+     * Whether the selected material variant declares the optional extended
+     * lighting view resources.  The default keeps the historical helper shape
+     * for callers that build the canonical full PBR layout; the renderer passes
+     * the device/variant decision explicitly.
+     */
+    readonly extendedLighting?: boolean;
+    /** Selects the optional binding(1) ProbeBlendRecord lane. */
+    readonly probeBlend?: boolean;
     /** Whether the device can carry the optional SpotLight projector texture. */
     readonly projectorAvailable?: boolean;
 }
 /**
  * The view BGL entry list. binding 0 = view UBO (vertex + fragment);
- * binding 1 = pointLights (storage or uniform, per caps);
- * binding 2 = spotLights (storage or uniform, per caps);
  * binding 3 = directional shadowMap atlas (texture_depth_2d, vertex+fragment).
  *   feat-20260613-csm-cascaded-shadow-maps: this is the CSM atlas — N
  *   cascades tiled into one 2D depth texture, sampled via per-cascade UV
@@ -140,9 +153,9 @@ export interface PbrCaps {
  *   layout and consumed only by the dedicated points-lines shader).
  * Isolated here so M4 round-4 tests can recreate the layout.
  *
- * feat-20260526-pbr-uniform-fallback-no-storage-buffer M3 / w9:
- * caps.storageBuffer===false switches bindings 1+2 from
- * 'read-only-storage' to 'uniform'.
+ * Local lights are not part of the view group. Standard material variants
+ * consume the one Cluster payload in group(2), while this group retains only
+ * camera and shadow resources.
  */
 export declare function buildPbrViewBglEntries(caps: PbrCaps): GPUBindGroupLayoutEntry[];
 /**
@@ -150,8 +163,8 @@ export declare function buildPbrViewBglEntries(caps: PbrCaps): GPUBindGroupLayou
  * material, mesh-array, instances]`; the material BGL is derived from the
  * standard material schema and engine injection chain.
  *
- * `caps.storageBuffer===false` switches every storage-buffer BGL entry
- * (view bindings 1+2, mesh-array, instances) to `uniform`.
+ * `caps.storageBuffer===false` switches the mesh-array and instances entries
+ * to `uniform`; local-light resources are never part of this view group.
  *
  * Throws on each `createBindGroupLayout` / `createPipelineLayout` Result
  * failure -- the engine bootstrap path (createRenderer) wraps the call in
@@ -171,19 +184,27 @@ export declare const SKIN_MATERIAL_SHADER_ID: "forgeax::pbr-skin";
 export declare const SHADOW_CASTER_SHADER_ID: "forgeax::default-shadow-caster";
 export declare function shadowCasterVariantSet(storageBuffer: boolean, skinned: boolean): string;
 export declare function isSkinnedShadowCasterVariant(materialShaderId: string | undefined, variantSet: string | undefined): boolean;
+export type PipelineGroup2Contract = 'mesh' | 'skin' | 'cluster' | 'skin-cluster';
+/** Resolve group(2) from the composed WGSL artifact used to build the PSO. */
+export declare function resolvePipelineGroup2Contract(source: string): PipelineGroup2Contract;
 /** Returns true for the engine-shipped standard-PBR material shader family. */
 export declare function isStandardPbrMaterialShader(shaderId: string | undefined): boolean;
 /**
  * Build the PBR skin pipeline layout (4 slots `[view, material,
- * mesh-array(2-entry), instances]`). View / material / instances BGLs are
+ * mesh-array(3-entry), instances]`). View / material / instances BGLs are
  * shared with the standard-PBR layout (passed in via `pbr` bundle); the only
- * new BGL is the 2-entry mesh-array slot for `meshes` + `palette`.
+ * new BGL is the 3-entry mesh-array slot for `meshes` + current/previous
+ * `palette` buffers.
  *
  * Throws on each `createBindGroupLayout` / `createPipelineLayout` Result
  * failure -- the engine bootstrap path wraps the call in `runShimSyncStep`
  * to fold the throw into the structured error pipe.
  */
 export declare function buildPbrSkinLayouts(device: PbrPipelineDevice, caps: PbrCaps, pbr: PbrPipelineLayoutBundle): PbrPipelineLayoutBundle;
+/** Project the canonical group(2) resources for a PBR skin draw. */
+export declare function createPbrSkinMeshBindGroupEntries(meshBuffer: Buffer, meshSize: number, paletteBuffer: Buffer, paletteWindowBytes: number): BindGroupEntry[];
+/** Project all dynamic offsets for the canonical PBR skin group(2) shape. */
+export declare function pbrSkinMeshDynamicOffsets(meshOffset: number, paletteOffset: number): readonly [number, number, number];
 /**
  * Build a stand-alone 7-entry unlit material BGL. Round-4 D-5 keeps unlit
  * material BG isolated from Skylight binding 7..13 -- unlit demos do not
@@ -253,13 +274,14 @@ export declare const SPRITE_PASS_PER_INSTANCE_REGION_VARIANT_SET = "";
  *    - `'unlit-material'` — 7 entries: base PBR material only (no inject)
  *    - `'hdrp-7-slot'` — 7 entries (binding 0 + 3..8): HDRP cluster + SSAO group(2) BGL
  * 2. Caps-driven literal shapes (no shader):
- *    - `'pbr-view'` — 12 entries: view UBO + lights + shadow bindings,
- *      projector texture/sampler (11/12), and the Points/Lines UBO (10)
+ *    - `'pbr-view'` — camera/shadow bindings, optional projector
+ *      texture/sampler (11/12), and the Points/Lines UBO (10). Local lights
+ *      are carried exclusively by the Standard Cluster group(2).
  *      (directional 3/4, point 5/6, cascade 7, spot atlas 8; the former
  *      spot lightViewProj matrices moved into the View UBO)
  *    - `'pbr-mesh-array'` — 1 entry: per-entity mesh SSBO (dynamic-offset)
  *    - `'pbr-instances'` — 1 entry: per-instance SSBO (no dynamic-offset)
- *    - `'pbr-skin-mesh-array'` — 2 entries: meshes + skin palette
+ *    - `'pbr-skin-mesh-array'` — 3 entries: meshes + current/previous palette
  * 3. Attachment-driven (fullscreen post-process):
  *    - `'fullscreen-post'` — 2 entries: input texture + sampler. The texture
  *      `sampleType` is derived from `spec.attachments` (plan §R3 fix):
@@ -289,7 +311,9 @@ export interface BindGroupLayoutDescriptorOutput {
     readonly entries: GPUBindGroupLayoutEntry[];
 }
 /** Build the canonical HDRP group(2) bind-group layout. */
-export declare function createHdrpBindGroupLayoutDescriptor(storageBuffer?: boolean): BindGroupLayoutDescriptor;
+export declare function createHdrpBindGroupLayoutDescriptor(): BindGroupLayoutDescriptorOutput;
+/** Build the HDRP group(2) layout for the clustered skin variant. */
+export declare function createHdrpSkinBindGroupLayoutDescriptor(): BindGroupLayoutDescriptorOutput;
 export declare function buildBindGroupLayoutDescriptor(spec: PipelineSpec, options: {
     kind: BglKind;
     registry?: ShaderCatalog;

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

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

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

@@ -1,5 +1,6 @@
 import type { RenderPipeline, RenderPipelineBuildContext, RenderPipelineFrame, RenderPipelineTopology } from '../render-pipeline';
-declare function buildUrp(context: RenderPipelineBuildContext<RenderPipelineFrame>, topology: RenderPipelineTopology): ReturnType<RenderPipeline['build']>;
+import type { StandardTopologyInputValue } from './standard-lighting/topology';
+declare function buildUrp(context: RenderPipelineBuildContext<RenderPipelineFrame>, topology: RenderPipelineTopology, lighting: StandardTopologyInputValue): ReturnType<RenderPipeline['build']>;
 export declare const buildStandardForwardLane: typeof buildUrp;
 export {};
 //# sourceMappingURL=standard-forward-lane.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"standard-forward-lane.d.ts","sourceRoot":"","sources":["../../src/pipeline/standard-forward-lane.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EACV,cAAc,EACd,0BAA0B,EAC1B,mBAAmB,EACnB,sBAAsB,EACvB,MAAM,oBAAoB,CAAC;AAmC5B,iBAAS,QAAQ,CACf,OAAO,EAAE,0BAA0B,CAAC,mBAAmB,CAAC,EACxD,QAAQ,EAAE,sBAAsB,GAC/B,UAAU,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CA6PrC;AAED,eAAO,MAAM,wBAAwB,iBAAW,CAAC"}
+{"version":3,"file":"standard-forward-lane.d.ts","sourceRoot":"","sources":["../../src/pipeline/standard-forward-lane.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EACV,cAAc,EACd,0BAA0B,EAC1B,mBAAmB,EACnB,sBAAsB,EACvB,MAAM,oBAAoB,CAAC;AA+B5B,OAAO,KAAK,EAAE,0BAA0B,EAAE,MAAM,8BAA8B,CAAC;AAW/E,iBAAS,QAAQ,CACf,OAAO,EAAE,0BAA0B,CAAC,mBAAmB,CAAC,EACxD,QAAQ,EAAE,sBAAsB,EAChC,QAAQ,EAAE,0BAA0B,GACnC,UAAU,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC,CA6TrC;AAED,eAAO,MAAM,wBAAwB,iBAAW,CAAC"}