@forgeax/engine-render 0.1.31 → 0.1.32

package/README.md

@@ -101,6 +101,14 @@ plan. Register it at construction with
 `createRenderer(canvas, { features: [feature] })`. A feature never receives a
 device, queue, encoder, staging builder, or submit callback.
 
+After a frame reaches queue submission, the optional `onFrameSubmitted` callback
+receives a bounded `RenderFeatureSubmission` projection. Its `passes` contain
+only work admitted after prepared-resource resolution, so producer diagnostics
+can distinguish submitted compute dispatches and graphics draws from a plan
+that was still pending. This is a receipt of admitted commands, not a GPU
+readback or proof that an indirect draw produced non-zero instances; producers
+that need those facts must use their existing readback or tape evidence.
+
 ## RenderFeature: the producer seam (first-read index)
 
 The public route is one `RenderFeature<FrameData>` through the active RenderGraph
@@ -157,6 +165,13 @@ surface receiver position along its world-space normal before projection (defaul
 Normal offset and depth bias are independent: increasing the CSM depth span must
 not magnify the world-space normal offset. Both PCF and PCSS project the offset
 receiver; volumetric samples have no surface normal and use only depth bias.
+Surface receivers also get a per-cascade depth correction derived from the
+world size of a shadow texel, the filter footprint, and the receiver's depth
+slope along the light's two image axes. The existing normal offset counts
+toward this coverage; only the missing amount is added to `depthBias`, after
+conversion through that cascade's light-space depth span. PCSS derives its
+blocker-search and comparison coverage separately from their actual radii.
+This does not change either author field's units or add shadow texture taps.
 Cascade projections include their incoming blend band, and PCSS depth spans
 match the actual projection, including toward-light caster reach. The normal
 position offset follows the approach in
@@ -1093,6 +1108,8 @@ renderer.instances.update(collection.collectionId, {
 renderer.instances.replace(collection.collectionId, identityMatrices(instanceCount + 1));
 const current = renderer.instances.inspect(collection.collectionId).unwrap();
 const detached = renderer.instances.snapshot(collection.collectionId).unwrap();
+// A read-only observation does not advance the renderer upload cursor.
+const observed = renderer.instances.peek(collection.collectionId).unwrap();
 renderer.instances.release(collection.collectionId);
 ```
 
@@ -1101,7 +1118,9 @@ storage, `replace` publishes a complete new revision (and grows capacity when
 needed), `update` validates a bounded matrix interval and records its dirty
 range, `inspect` returns identity/count/capacity/revision, `snapshot` returns a
 detached matrix copy plus dirty ranges for extraction, and `release` makes the
-collection id terminal. A caller never provides a GPU buffer or maintains
+collection id terminal. `peek` returns the same detached matrices without
+advancing the renderer upload cursor, so read-only inspection cannot hide a
+later dirty range. A caller never provides a GPU buffer or maintains
 backend-specific chunks. `detached.transforms` is an observation, not mutable
 renderer state.
 
@@ -2303,3 +2322,51 @@ froxel depth, including the clipped final segment. It does not rotate density
 samples with frame number: static authored air must not create temporal noise.
 Shadow visibility uses matching froxel centers without per-frame XY jitter or
 stochastic byte dithering. Shared PCF shadow filtering remains in effect.
+
+## Camera Depth of Field
+
+`DepthOfField` is the built-in Standard camera effect for ordinary meshes. Add it
+only to the active perspective camera; component removal or
+`maxRadiusPixels: 0` declares the exact zero-work path. The side and quality
+fields use the closed numeric values exported by this package:
+
+```ts
+import {
+  DepthOfField,
+  DepthOfFieldQualityValue,
+  DepthOfFieldSideValue,
+} from '@forgeax/engine-render';
+
+world.addComponent(camera, {
+  component: DepthOfField,
+  data: {
+    focusDistance: 8,
+    fStop: 1.4,
+    sensorHeight: 0.024,
+    maxRadiusPixels: 16,
+    quality: DepthOfFieldQualityValue.medium,
+    blurSide: DepthOfFieldSideValue.both,
+  },
+});
+```
+
+The near, far and both presets share one signed thin-lens CoC. `quality` changes
+sampling density only, so it does not change the optical radius. The graph uses
+the Standard `RenderExtent`: full-resolution CoC/composite targets follow the
+current internal or output domain, and half-resolution targets use
+`max(1, ceil(axis / 2))`. Current temporal-v1 depth validity and the resolved
+multisampled depth binding remain the source of truth.
+
+After a real `draw()` submission, read `renderer.inspect().depthOfField` for the
+requested component values, effective submitted values, graph/device
+generations, extents, pass count and descriptor-derived bytes. `lastKnownGood`
+and `effective` stay bound to the accepted submission; a failed candidate keeps
+the prior accepted projection and reports its failure reason for recovery.
+When the active camera has no `DepthOfField` component, the inspection remains
+available with `status: 'off'` and zero DoF graph facts. Invalid fields and an
+orthographic camera stay on the normal camera snapshot path with structured
+`error.code`, `error.expected`, `error.hint`, and `error.detail`; they report
+`status: 'invalid'` or `status: 'unsupported'` without admitting a DoF graph.
+The Engine Preview/game capability lab uses this same component on its ordinary
+mesh camera, and its settings control toggles component presence through the
+normal World path.

package/dist/assembly/webgpu-ready.d.ts

@@ -1,6 +1,7 @@
 import type { RenderPipeline, Result, RhiDevice, ShaderModule } from '@forgeax/engine-rhi';
 import { RhiError } from '@forgeax/engine-rhi';
 import { type ShaderCatalog } from '@forgeax/engine-shader';
+import { prewarmDepthOfField } from '../features/depth-of-field/depth-of-field-assembly';
 export type { MaterialShaderManifestEntry } from '@forgeax/engine-shader';
 import type { GpuResidencyCache } from '../device/gpu-residency';
 import type { DeviceScope, RhiErrorListenerRegistry } from '../lifecycle';
@@ -49,7 +50,7 @@ requiredFullscreenPostProcesses: readonly {
 registerBuiltinFxaa: (source: string) => void, registerBuiltinTemporalPostProcesses: (entries: {
     readonly motionBlur?: string;
     readonly taaResolve?: string;
-}) => void, 
+}) => void, registerBuiltinDepthOfField: Parameters<typeof prewarmDepthOfField>[2], 
 /** Install manifest-owned volume utility sources only after all four modules compile. */
 setVolumetricFogShaderSources: (sources: VolumetricFogShaderSources) => void, 
 /** Install manifest-owned SSR utility sources only after all five modules compile. */

package/dist/assembly/webgpu-ready.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"webgpu-ready.d.ts","sourceRoot":"","sources":["../../src/assembly/webgpu-ready.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAKV,cAAc,EACd,MAAM,EACN,SAAS,EAET,YAAY,EACb,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAM,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAM9E,YAAY,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AAE1E,OAAO,KAAK,EAAE,iBAAiB,EAAkB,MAAM,yBAAyB,CAAC;AAwBjF,OAAO,KAAK,EAAE,WAAW,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAE1E,OAAO,EAGL,KAAK,sBAAsB,EAG5B,MAAM,iBAAiB,CAAC;AAmBzB,OAAO,EACL,KAAK,uBAAuB,EAC5B,KAAK,gBAAgB,EAErB,KAAK,0BAA0B,EAChC,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAEL,KAAK,aAAa,EAEnB,MAAM,kBAAkB,CAAC;AAQ1B,OAAO,EAIL,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAEnB,MAAM,kBAAkB,CAAC;AAmB1B;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,SAAS,EACpB,aAAa,EAAE,WAAW,EAC1B,SAAS,EAAE,MAAM,aAAa,EAC9B,QAAQ,EAAE,iBAAiB,EAC3B,uBAAuB,EACnB,CAAC,CACC,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,KAC/C,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC,CAAC,GAC7C,SAAS,EACb,aAAa,EAAE,wBAAwB;AACvC;;;;GAIG;AACH,uBAAuB,EAAE,SAAS,MAAM,EAAE,EAC1C,2BAA2B,EAAE,MAAM;AACnC,8EAA8E;AAC9E,+BAA+B,EAAE,SAAS;IACxC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,EAAE,EAUH,mBAAmB,EAAE,CACnB,IAAI,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,kBAAkB,EACjD,KAAK,EAAE,aAAa,KACjB,IAAI,EAQT,gBAAgB,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,KAAK,IAAI,EAQ/D,+BAA+B,EAAE,CAC/B,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,cAAc,EACnB,cAAc,EAAE,sBAAsB,KACnC,IAAI,EAST,sBAAsB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI;AAChD,sEAAsE;AACtE,mBAAmB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,EAC7C,oCAAoC,EAAE,CAAC,OAAO,EAAE;IAC9C,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B,KAAK,IAAI;AACV,yFAAyF;AACzF,6BAA6B,EAAE,CAAC,OAAO,EAAE,0BAA0B,KAAK,IAAI;AAC5E,sFAAsF;AACtF,mBAAmB,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI;AACxD,wFAAwF;AACxF,0BAA0B,EAAE,CAAC,OAAO,EAAE,uBAAuB,KAAK,IAAI,GACrE,OAAO,CAAC,aAAa,CAAC,CAyxHxB"}
+{"version":3,"file":"webgpu-ready.d.ts","sourceRoot":"","sources":["../../src/assembly/webgpu-ready.ts"],"names":[],"mappings":"AAeA,OAAO,KAAK,EAKV,cAAc,EACd,MAAM,EACN,SAAS,EAET,YAAY,EACb,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAM,QAAQ,EAAE,MAAM,qBAAqB,CAAC;AACnD,OAAO,EAAoB,KAAK,aAAa,EAAE,MAAM,wBAAwB,CAAC;AAG9E,OAAO,EAAE,mBAAmB,EAAE,MAAM,oDAAoD,CAAC;AAIzF,YAAY,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AAE1E,OAAO,KAAK,EAAE,iBAAiB,EAAkB,MAAM,yBAAyB,CAAC;AAwBjF,OAAO,KAAK,EAAE,WAAW,EAAE,wBAAwB,EAAE,MAAM,cAAc,CAAC;AAE1E,OAAO,EAGL,KAAK,sBAAsB,EAG5B,MAAM,iBAAiB,CAAC;AAmBzB,OAAO,EACL,KAAK,uBAAuB,EAC5B,KAAK,gBAAgB,EAErB,KAAK,0BAA0B,EAChC,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAEL,KAAK,aAAa,EAEnB,MAAM,kBAAkB,CAAC;AAQ1B,OAAO,EAIL,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAEnB,MAAM,kBAAkB,CAAC;AAmB1B;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAsB,gBAAgB,CACpC,SAAS,EAAE,SAAS,EACpB,aAAa,EAAE,WAAW,EAC1B,SAAS,EAAE,MAAM,aAAa,EAC9B,QAAQ,EAAE,iBAAiB,EAC3B,uBAAuB,EACnB,CAAC,CACC,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;CAAE,KAC/C,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC,CAAC,GAC7C,SAAS,EACb,aAAa,EAAE,wBAAwB;AACvC;;;;GAIG;AACH,uBAAuB,EAAE,SAAS,MAAM,EAAE,EAC1C,2BAA2B,EAAE,MAAM;AACnC,8EAA8E;AAC9E,+BAA+B,EAAE,SAAS;IACxC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACzB,EAAE,EAUH,mBAAmB,EAAE,CACnB,IAAI,EAAE,CAAC,WAAW,EAAE,MAAM,KAAK,kBAAkB,EACjD,KAAK,EAAE,aAAa,KACjB,IAAI,EAQT,gBAAgB,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,KAAK,IAAI,EAQ/D,+BAA+B,EAAE,CAC/B,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,cAAc,EACnB,cAAc,EAAE,sBAAsB,KACnC,IAAI,EAST,sBAAsB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI;AAChD,sEAAsE;AACtE,mBAAmB,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,EAC7C,oCAAoC,EAAE,CAAC,OAAO,EAAE;IAC9C,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;CAC9B,KAAK,IAAI,EACV,2BAA2B,EAAE,UAAU,CAAC,OAAO,mBAAmB,CAAC,CAAC,CAAC,CAAC;AACtE,yFAAyF;AACzF,6BAA6B,EAAE,CAAC,OAAO,EAAE,0BAA0B,KAAK,IAAI;AAC5E,sFAAsF;AACtF,mBAAmB,EAAE,CAAC,OAAO,EAAE,gBAAgB,KAAK,IAAI;AACxD,wFAAwF;AACxF,0BAA0B,EAAE,CAAC,OAAO,EAAE,uBAAuB,KAAK,IAAI,GACrE,OAAO,CAAC,aAAa,CAAC,CAuxHxB"}

package/dist/assembly/webgpu-renderer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"webgpu-renderer.d.ts","sourceRoot":"","sources":["../../src/assembly/webgpu-renderer.ts"],"names":[],"mappings":"AAyCA,YAAY,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AAqE1E,OAAO,KAAK,EAUV,eAAe,EAQhB,MAAM,oBAAoB,CAAC;AAgB5B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAkEzD,YAAY,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAUlF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAUhE,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AACjE,YAAY,EACV,UAAU,EACV,6BAA6B,EAC7B,iCAAiC,GAClC,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,2BAA2B,EAC3B,oCAAoC,EACpC,iCAAiC,EACjC,uCAAuC,EACvC,oCAAoC,EACpC,+BAA+B,EAC/B,+BAA+B,EAC/B,wCAAwC,EACxC,uBAAuB,EACvB,8BAA8B,EAC9B,wCAAwC,GACzC,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,4BAA4B,EAC5B,0BAA0B,EAC1B,4BAA4B,EAC5B,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,0BAA0B,EAC/B,KAAK,kBAAkB,EACvB,KAAK,yBAAyB,EAC9B,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,qBAAqB,GACtB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EACL,gCAAgC,EAChC,4BAA4B,EAC5B,0BAA0B,EAC1B,yBAAyB,EACzB,4CAA4C,GAC7C,MAAM,yBAAyB,CAAC;AACjC,YAAY,EAAE,aAAa,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AACzF,OAAO,EAAE,4BAA4B,EAAE,MAAM,+BAA+B,CAAC;AAI7E,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,iBAAiB,GAAG,eAAe,EAC3C,OAAO,EAAE,eAAe,GAAG,SAAS,EACpC,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE,cAAc,GAAG,SAAS,GAClC,OAAO,CAAC,aAAa,CAAC,CAExB"}
+{"version":3,"file":"webgpu-renderer.d.ts","sourceRoot":"","sources":["../../src/assembly/webgpu-renderer.ts"],"names":[],"mappings":"AAyCA,YAAY,EAAE,2BAA2B,EAAE,MAAM,wBAAwB,CAAC;AAyE1E,OAAO,KAAK,EAUV,eAAe,EAQhB,MAAM,oBAAoB,CAAC;AAgB5B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAkEzD,YAAY,EAAE,uBAAuB,EAAE,MAAM,oCAAoC,CAAC;AAUlF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAUhE,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AACzD,OAAO,EAAE,0BAA0B,EAAE,MAAM,qBAAqB,CAAC;AACjE,YAAY,EACV,UAAU,EACV,6BAA6B,EAC7B,iCAAiC,GAClC,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,2BAA2B,EAC3B,oCAAoC,EACpC,iCAAiC,EACjC,uCAAuC,EACvC,oCAAoC,EACpC,+BAA+B,EAC/B,+BAA+B,EAC/B,wCAAwC,EACxC,uBAAuB,EACvB,8BAA8B,EAC9B,wCAAwC,GACzC,MAAM,0BAA0B,CAAC;AAClC,OAAO,EACL,4BAA4B,EAC5B,0BAA0B,EAC1B,4BAA4B,EAC5B,KAAK,qBAAqB,EAC1B,KAAK,sBAAsB,EAC3B,KAAK,0BAA0B,EAC/B,KAAK,kBAAkB,EACvB,KAAK,yBAAyB,EAC9B,KAAK,kBAAkB,EACvB,KAAK,aAAa,EAClB,qBAAqB,GACtB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACnD,OAAO,EACL,gCAAgC,EAChC,4BAA4B,EAC5B,0BAA0B,EAC1B,yBAAyB,EACzB,4CAA4C,GAC7C,MAAM,yBAAyB,CAAC;AACjC,YAAY,EAAE,aAAa,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AACzF,OAAO,EAAE,4BAA4B,EAAE,MAAM,+BAA+B,CAAC;AAI7E,wBAAsB,uBAAuB,CAC3C,MAAM,EAAE,iBAAiB,GAAG,eAAe,EAC3C,OAAO,EAAE,eAAe,GAAG,SAAS,EACpC,IAAI,EAAE,cAAc,EACpB,OAAO,EAAE,cAAc,GAAG,SAAS,GAClC,OAAO,CAAC,aAAa,CAAC,CAExB"}

package/dist/{chunk-C3DDSXYK.mjs → chunk-4NNZQCL3.mjs}

@@ -1,8 +1,8 @@
 import { GlyphText } from './chunk-ILQ5MEZF.mjs';
-import { MeshRenderer, MeshFilter, DirectionalLight, validateDirectionalLightData, PointLight, computeInvRangeSquared, SpotLight, degToCos, RectAreaLight, validateRectAreaLightData, directionalShadowQualityFromF32, PointLightShadow, Skylight, LightProbe, validateLightProbeData, SkyboxBackground, Atmosphere, Instances, Layer, Points, Lines, SortKey, resolveMeshMaterialBindings, pointShapeFromU32, PostProcessParams, buildCubeCameraFaceViews, CubeCamera, cubeCameraUpdateIntentFromF32, ReflectionProbe, reflectionProbeUpdateIntentFromF32, tonemapToU32, resolveVisibility, Fog, VolumetricFog, resolveSelectedVolumetricLight, extractVolumetricFog, MotionBlur, DynamicResolution, ScreenSpaceReflection, Camera, CAMERA_EXPOSURE_MODE_MANUAL, cameraExposureFromColumns, antialiasFromF32, validateDynamicResolutionCamera, bloomEnabledFromF32, tonemapFromF32, cameraProjectionFromF32 } from './chunk-S5UE2T5P.mjs';
+import { MeshRenderer, MeshFilter, DirectionalLight, validateDirectionalLightData, PointLight, computeInvRangeSquared, SpotLight, degToCos, RectAreaLight, validateRectAreaLightData, directionalShadowQualityFromF32, PointLightShadow, Skylight, LightProbe, validateLightProbeData, SkyboxBackground, Atmosphere, Instances, Layer, Points, Lines, SortKey, resolveMeshMaterialBindings, pointShapeFromU32, PostProcessParams, buildCubeCameraFaceViews, CubeCamera, cubeCameraUpdateIntentFromF32, ReflectionProbe, reflectionProbeUpdateIntentFromF32, tonemapToU32, resolveVisibility, Fog, VolumetricFog, resolveSelectedVolumetricLight, extractVolumetricFog, MotionBlur, DynamicResolution, ScreenSpaceReflection, DepthOfField, Camera, cameraProjectionFromF32, resolveDepthOfFieldParams, depthOfFieldRequestFailure, CAMERA_EXPOSURE_MODE_MANUAL, cameraExposureFromColumns, antialiasFromF32, validateDynamicResolutionCamera, bloomEnabledFromF32, tonemapFromF32 } from './chunk-GWCEMDVR.mjs';
 import { SpriteRegionOverride, SpriteInstances, selectActiveCameraIndex, getActiveCamera } from './chunk-PA5DRJNI.mjs';
-import { PROBE_BLEND_RECORD_CAPACITY, GPU_BUFFER_USAGE_MAP_READ, GPU_BUFFER_USAGE_VERTEX, GPU_BUFFER_USAGE_COPY_DST, gpuDrivenShadowDrawKey, IES_SLICE_CAPACITY, COOKIE_SLICE_CAPACITY, isStandardPbrSkinMaterialShader, buildGpuDrivenDraws, worldEntityKey, gpuDrivenSourceDrawItemIndex, selectPasses, resolveRenderTargetMaterialSource, isCanonicalStandardPbrMaterialShader, PROBE_BLEND_RECORD_BYTE_SIZE, GPU_BUFFER_USAGE_UNIFORM, GPU_BUFFER_USAGE_QUERY_RESOLVE, GPU_BUFFER_USAGE_COPY_SRC, COOKIE_SLICE_SIZE, isStandardPbrMaterialShader } from './chunk-FUUO4UND.mjs';
-import { STANDARD_OUTPUT_TRANSFORM_FEATURE_ID, SHADOW_ATLAS_DEFAULT_LAYERS, SkinMaterialMismatchError, MaterialSkinAttrMissingError, InstanceCollectionError, ShadowInvalidConfigError, EnvironmentSourceConflictError, FogCardinalityError, GPU_TEXTURE_USAGE_COPY_SRC, GPU_TEXTURE_USAGE_COPY_DST, GPU_TEXTURE_USAGE_TEXTURE_BINDING, GPU_TEXTURE_USAGE_STORAGE_BINDING, GPU_TEXTURE_USAGE_RENDER_ATTACHMENT, AtmosphereInvalidParameterError } from './chunk-JRBDO2KB.mjs';
+import { PROBE_BLEND_RECORD_CAPACITY, GPU_BUFFER_USAGE_MAP_READ, GPU_BUFFER_USAGE_VERTEX, GPU_BUFFER_USAGE_COPY_DST, gpuDrivenShadowDrawKey, IES_SLICE_CAPACITY, COOKIE_SLICE_CAPACITY, isStandardPbrSkinMaterialShader, buildGpuDrivenDraws, worldEntityKey, gpuDrivenSourceDrawItemIndex, selectPasses, resolveRenderTargetMaterialSource, isCanonicalStandardPbrMaterialShader, PROBE_BLEND_RECORD_BYTE_SIZE, GPU_BUFFER_USAGE_UNIFORM, GPU_BUFFER_USAGE_QUERY_RESOLVE, GPU_BUFFER_USAGE_COPY_SRC, COOKIE_SLICE_SIZE, isStandardPbrMaterialShader } from './chunk-DRR7D3KX.mjs';
+import { STANDARD_OUTPUT_TRANSFORM_FEATURE_ID, SHADOW_ATLAS_DEFAULT_LAYERS, MaterialSkinAttrMissingError, SkinMaterialMismatchError, InstanceCollectionError, ShadowInvalidConfigError, EnvironmentSourceConflictError, FogCardinalityError, GPU_TEXTURE_USAGE_COPY_SRC, GPU_TEXTURE_USAGE_COPY_DST, GPU_TEXTURE_USAGE_TEXTURE_BINDING, GPU_TEXTURE_USAGE_STORAGE_BINDING, GPU_TEXTURE_USAGE_RENDER_ATTACHMENT, AtmosphereInvalidParameterError } from './chunk-6TFBXLRJ.mjs';
 import { R_MIN, ok, err, TextError, toShared, handleSlot, AssetError, ASSET_ERROR_HINTS, materialValuesToLinearRuntime, derive, unpackSlot, materialGuidText } from '@forgeax/engine-types';
 import { err as err$1, ok as ok$1, RhiError } from '@forgeax/engine-rhi';
 import { resolveAssetHandle, walkMaterialPassesOverSharedRefs, selectMaterialPassProgram, materialParametersToParamSchema as materialParametersToParamSchema$1 } from '@forgeax/engine-assets-runtime';
@@ -1984,6 +1984,14 @@ function buildShadowFrusta(lights) {
 function skinPaletteIdentity(world, entity) {
   return `skin:${world.identity}:${entity}`;
 }
+function materialProgramSelectionRequiresSkin(selection) {
+  if (selection.abi?.skinPaletteAddress !== void 0) return true;
+  const semantics = new Set((selection.abi?.vertexInputs ?? []).map((input) => input.semantic));
+  return semantics.has("skinIndex") && semantics.has("skinWeight");
+}
+function isMissingMaterialProgram(error) {
+  return error !== null && typeof error === "object" && error.code === "material-specialization-not-cooked";
+}
 function extractFrames(worlds, owner, assets, pipelineState, materialSnapshotCachesByWorld, options = {}) {
   const cameraOwner = typeof owner === "number" ? owner : owner.cameraOwner;
   const resourceOwner = typeof owner === "number" ? owner : owner.resourceOwner;
@@ -3198,6 +3206,7 @@ function extractFrame(world, context) {
       const handleRaw = materialHandles[0] ?? 0;
       const cachedMaterial = handleRaw !== 0 && !hasSpriteRegionOverride && !hasSkin ? materialSnapshotCache.get(handleRaw) : void 0;
       let materialSnap;
+      let materialProgramSelections;
       if (cachedMaterial !== void 0) {
         materialSnap = cachedMaterial.snapshot;
         if (isRenderable) {
@@ -3293,10 +3302,41 @@ function extractFrame(world, context) {
               ...context.materialContext,
               geometry: hasSkin ? "skinned" : context.materialContext.geometry
             };
-            const materialProgramKeys = materialProgramKeysForMaterial(
-              asset,
-              assets,
-              materialContext
+            try {
+              materialProgramSelections = materialProgramSelectionsForMaterial(
+                asset,
+                assets,
+                materialContext
+              );
+            } catch (error) {
+              if (isMissingMaterialProgram(error) && materialContext?.geometry === "mesh") {
+                try {
+                  const skinnedSelections = materialProgramSelectionsForMaterial(asset, assets, {
+                    ...materialContext,
+                    geometry: "skinned"
+                  });
+                  if (skinnedSelections?.some(materialProgramSelectionRequiresSkin) === true && gpuDrivenMesh !== void 0) {
+                    const hasSkinIndex = gpuDrivenMesh.attributes.skinIndex !== void 0;
+                    const hasSkinWeight = gpuDrivenMesh.attributes.skinWeight !== void 0;
+                    if (!hasSkinIndex || !hasSkinWeight) {
+                      const missing = !hasSkinIndex && !hasSkinWeight ? "both" : !hasSkinIndex ? "skinIndex" : "skinWeight";
+                      worldInternal._routeError(new MaterialSkinAttrMissingError(entity, missing), {
+                        severity: Severity.Error,
+                        systemName: "RenderSystem.extract (material-skin-attr-missing)"
+                      });
+                      continue;
+                    }
+                  }
+                } catch {
+                }
+              }
+              throw error;
+            }
+            const materialProgramKeys = materialProgramSelections === void 0 ? void 0 : Object.fromEntries(
+              materialProgramSelections.map(({ pass, specializationKey }) => [
+                pass,
+                specializationKey
+              ])
             );
             const materialSceneIndexProgramKeys = materialSceneIndexProgramKeysForMaterial(
               asset,
@@ -3341,7 +3381,7 @@ function extractFrame(world, context) {
             );
             {
               const hasSkinSkel = hasSkin && skinSkeletonView !== void 0 && skinSkeletonView !== void 0 && skinSkeletonView !== 0;
-              const isPbrSkinMaterial = isStandardPbrSkinMaterialShader(firstPassShader);
+              const isPbrSkinMaterial = materialProgramSelections?.some(materialProgramSelectionRequiresSkin) === true || isStandardPbrSkinMaterialShader(firstPassShader);
               if (hasSkinSkel && !isPbrSkinMaterial) {
                 worldInternal._routeError(new SkinMaterialMismatchError(entity, firstPassShader), {
                   severity: Severity.Error,
@@ -3707,7 +3747,7 @@ function extractFrame(world, context) {
         }
         if (skinSlice === void 0 && hasSkin) {
           releaseSkinIdentity();
-          if (materialSnap.materialShaderId === "forgeax::pbr-skin") {
+          if (materialSnap.materialShaderId === "forgeax::pbr-skin" || materialProgramSelections?.some(materialProgramSelectionRequiresSkin) === true) {
             pendingDispatch.length = 0;
             continue;
           }
@@ -4310,6 +4350,30 @@ function runtimeMaterialShaderId(module, passName) {
 function materialProgramKeysForMaterial(material, assets, context) {
   return materialProgramKeysForAddress(material, assets, context, "direct");
 }
+function materialProgramSelectionsForMaterial(material, assets, context, address = "direct") {
+  const projection = assets.getMaterialProjectionForPayload(material);
+  if (projection === void 0) return void 0;
+  if (context === void 0)
+    throw new Error("Published material selection requires renderer-owned compiler context");
+  return projection.passes.map((pass) => {
+    const mode = String(
+      pass.renderState?.tags?.LightMode ?? pass.name
+    );
+    const passKind = /shadow/i.test(mode) ? "shadow" : /depth/i.test(mode) ? "depth" : "forward";
+    const selectedContext = {
+      ...context,
+      pass: passKind,
+      pipeline: /deferred|gbuffer/i.test(mode) ? "deferred" : context.pipeline
+    };
+    const selected = selectMaterialPassProgram(projection, pass.name, selectedContext, address);
+    return {
+      pass: pass.name,
+      context: selectedContext,
+      specializationKey: selected.specializationKey,
+      ...selected.abi === void 0 ? {} : { abi: selected.abi }
+    };
+  });
+}
 function materialSceneIndexProgramKeysForMaterial(material, assets, context) {
   const projection = assets.getMaterialProjectionForPayload(material);
   if (projection === void 0) return void 0;
@@ -4335,35 +4399,19 @@ function materialSceneIndexProgramKeysForMaterial(material, assets, context) {
       );
       entries[pass.name] = { specializationKey: selected.specializationKey, pass: passKind };
     } catch (error) {
-      if (!isMissingMaterialProgram(error)) throw error;
+      if (!isMissingMaterialProgram2(error)) throw error;
     }
   }
   return Object.keys(entries).length === 0 ? void 0 : entries;
 }
-function isMissingMaterialProgram(error) {
+function isMissingMaterialProgram2(error) {
   return error !== null && typeof error === "object" && error.code === "material-specialization-not-cooked";
 }
 function materialProgramKeysForAddress(material, assets, context, address) {
-  const projection = assets.getMaterialProjectionForPayload(material);
-  if (projection === void 0) return void 0;
-  if (context === void 0)
-    throw new Error("Published material selection requires renderer-owned compiler context");
-  const entries = [];
-  for (const pass of projection.passes) {
-    const mode = String(
-      pass.renderState?.tags?.LightMode ?? pass.name
-    );
-    const selectedContext = {
-      ...context,
-      pass: /shadow/i.test(mode) ? "shadow" : /depth/i.test(mode) ? "depth" : "forward",
-      pipeline: /deferred|gbuffer/i.test(mode) ? "deferred" : context.pipeline
-    };
-    entries.push([
-      pass.name,
-      selectMaterialPassProgram(projection, pass.name, selectedContext, address).specializationKey
-    ]);
-  }
-  return entries.length === 0 ? void 0 : Object.fromEntries(entries);
+  const selections = materialProgramSelectionsForMaterial(material, assets, context, address);
+  return selections === void 0 ? void 0 : Object.fromEntries(
+    selections.map(({ pass, specializationKey }) => [pass, specializationKey])
+  );
 }
 function runtimeMaterialShaderIdForMaterial(passes, programs) {
   const pass = passes.find(
@@ -4965,6 +5013,22 @@ function computeDirectionalCsm(direction, config, cameraData) {
       if ((ls[2] ?? 0) < minZ) minZ = ls[2] ?? 0;
       if ((ls[2] ?? 0) > maxZ) maxZ = ls[2] ?? 0;
     }
+    const texelX = (maxX - minX) / config.mapSize;
+    const texelY = (maxY - minY) / config.mapSize;
+    if (Number.isFinite(texelX) && texelX > 0) {
+      const centerX = (minX + maxX) * 0.5;
+      const snappedCenterX = Math.round(centerX / texelX) * texelX;
+      const halfWidth = (maxX - minX) * 0.5 + texelX * 0.5;
+      minX = snappedCenterX - halfWidth;
+      maxX = snappedCenterX + halfWidth;
+    }
+    if (Number.isFinite(texelY) && texelY > 0) {
+      const centerY = (minY + maxY) * 0.5;
+      const snappedCenterY = Math.round(centerY / texelY) * texelY;
+      const halfHeight = (maxY - minY) * 0.5 + texelY * 0.5;
+      minY = snappedCenterY - halfHeight;
+      maxY = snappedCenterY + halfHeight;
+    }
     const nearZ = Math.max(maxZ, lightSpaceMaxZFull);
     const orthoProj = mat4.create();
     mat4.orthographic(orthoProj, minX, maxX, maxY, minY, -nearZ, -minZ);
@@ -5008,14 +5072,23 @@ function collectCameraSnapshots(world) {
   const cameras = [];
   const cameraQuery = world.query({
     read: [Camera],
-    optional: [MotionBlur, DynamicResolution, ScreenSpaceReflection],
+    optional: [MotionBlur, DynamicResolution, ScreenSpaceReflection, DepthOfField],
     with: [Transform, GlobalTransform]
   }).unwrap();
   for (const row of cameraQuery) {
     const cam = row.get(Camera);
     const motionBlur = row.get(MotionBlur);
+    const depthOfField = row.get(DepthOfField);
     const dynamicResolution = row.get(DynamicResolution);
     const screenSpaceReflection = row.get(ScreenSpaceReflection);
+    const projection = cameraProjectionFromF32(cam.projection);
+    const depthOfFieldResult = resolveDepthOfFieldParams(depthOfField, {
+      projection,
+      fov: cam.fov,
+      near: cam.near,
+      far: cam.far
+    });
+    const depthOfFieldError = depthOfFieldResult.ok ? void 0 : depthOfFieldRequestFailure(depthOfFieldResult.error);
     const entity = row.entity;
     const view = worldInternal._getArrayView(entity, GlobalTransform, "world");
     if (view === void 0) continue;
@@ -5042,7 +5115,7 @@ function collectCameraSnapshots(world) {
       aspect: cam.aspect,
       near: cam.near,
       far: cam.far,
-      projection: cameraProjectionFromF32(cam.projection),
+      projection,
       orthoLeft: cam.left,
       orthoRight: cam.right,
       orthoBottom: cam.bottom,
@@ -5063,6 +5136,8 @@ function collectCameraSnapshots(world) {
         cam.clearColor[2] ?? 0,
         cam.clearColor[3] ?? 1
       ],
+      ...depthOfFieldResult.ok && depthOfFieldResult.value !== void 0 ? { depthOfField: depthOfFieldResult.value } : {},
+      ...depthOfFieldError === void 0 ? {} : { depthOfFieldError },
       ...motionBlur === void 0 ? {} : {
         motionBlur: {
           shutterAngle: motionBlur.shutterAngle,
@@ -5904,5 +5979,5 @@ var ProbeBlendSceneProjection = class {
 };
 
 export { InstanceBoundsCache, OcclusionRenderRuntime, PROBE_MAX_CONTRIBUTORS, ProbeBlendSceneProjection, SKYLIGHT_RECOVERY_FALLBACK, SSR_HISTORY_FORMAT, SsrHistoryOwner, admitProbeContributors, blendLightProbes, buildRectAreaWorldFrame, buildShadowFrusta, createCookieProjectionMatrixData, createExtendedLightingState, createSsrHistoryOwner, createSsrSpatialResources, estimateSsrSpatialMemory, extractFrames, fingerprintNumericArray, glyphTextLayoutSystem, primitiveKey, primitiveKeyId, projectExtendedLightingInspection, promoteExtendedLightingCandidate, recordExtendedLightingFailure, rectAreaFacesPoint, scaledProbeWeight, setOcclusionRuntimeTestHooks, viewKey, viewKeyId };
-//# sourceMappingURL=chunk-C3DDSXYK.mjs.map
-//# sourceMappingURL=chunk-C3DDSXYK.mjs.map
+//# sourceMappingURL=chunk-4NNZQCL3.mjs.map
+//# sourceMappingURL=chunk-4NNZQCL3.mjs.map