@forgeax/engine-render 0.1.29 → 0.1.31

package/README.md

@@ -49,6 +49,12 @@ An AI consumer can start with the public sequence `state -> inspect -> recover
 `disposed` is terminal. `inspect()` is detached POD evidence for the current
 state, recovery attempt, and named output contract. After `recover()` succeeds, submit the current
 draw input and use the new `FrameReceipt` as the proof for that generation.
+An active device loss includes native `destroyed` notifications; only retired
+or unpublished candidate generations are isolated from active health. Pending
+dynamic geometry must be prepared again for the replacement generation before
+admission. Explicit preparation between recovery and draw may upload its new
+payload; the first-draw guard still rejects lazy cold uploads or pipeline builds
+inside rendering. Preparation does not make an old-generation receipt current.
 Recovery prepares the last successfully submitted workset; the next draw still
 consumes current World edits and admits new resources through normal residency.
 
@@ -144,9 +150,20 @@ The remaining CSM fields keep these public units and defaults: `cascadeCount`
 is an integer in `[1, 4]` (default `4`), `splitLambda` is `[0, 1]` (default
 `0.75`), `cascadeBlend` is `[0, 0.5]` (default `0.2`), `mapSize` is a positive
 map resolution (default `2048`), `depthBias` is a depth value (default
-`0.005`), `normalBias` is a world-space offset (default `0.05`), and
+`0.00001`, subtracted from normalized receiver depth), `normalBias` offsets the
+surface receiver position along its world-space normal before projection (default `0.05`), and
 `shadowDistance` is a positive world-unit distance in meters (default `200`).
 
+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.
+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
+[Three.js shadowmap_vertex](https://github.com/mrdoob/three.js/blob/e45cbf7ff66df079cfa39d9699ccb42729934be1/src/renderers/shaders/ShaderChunk/shadowmap_vertex.glsl.js).
+The real-render regression is
+[`shadow-contact.browser.test.ts`](../runtime/src/__tests__/shadow-contact.browser.test.ts).
+
 After `draw`, read the single `renderer.inspect().directionalShadow` projection.
 It is JSON-safe and bounded: `requested` is author intent, `effective` is the
 admitted profile, `status` is `accepted | fallback | rejected`, and
@@ -202,16 +219,24 @@ The Standard graph renders an Atmosphere source as a 128-by-128, six-face
 DirectionalLight supplies the sun direction, color, and illuminance; the sun
 angle is in radians, and zero radius disables the visible disc. Geometry covers
 the background through ordinary scene rendering, including transparent blending.
-The cube excludes the disc. Weak ambient lighting remains the explicit `Skylight`
-input; selecting an Atmosphere does not silently add a second ambient light.
-
-The cube has 786,432 texture payload bytes plus 280 bytes of graph-owned
-parameter and vertex payload, before backend allocation alignment. Its six faces update together when the selected environment
-signature changes, and become current only after successful frame submission.
-An unchanged source runs only the background pass. Resize, topology replacement,
-and recovery use normal graph retirement and reconstruction. GPU pass observations
+The cube excludes the disc. An explicit `Skylight` without an equirect asset
+uses diffuse irradiance and roughness-prefiltered radiance from this same cube.
+Its color and intensity remain the lighting controls; no Skylight means no
+global ambient contribution. An explicit equirect keeps its image source.
+Use a neutral Skylight tint when comparing local captures against the sky.
+
+The cube has 786,432 texture payload bytes. Its 16-square irradiance cube and
+64-square, five-mip prefilter add 274,176 bytes; parameters and vertices total
+1,560 bytes, before backend allocation alignment. DeviceScope owns one cached
+set, imported into each graph. Resize and probe topology changes reuse it;
+disabling Atmosphere retains it until device-scope retirement. Device recovery
+allocates a fresh set. Its six faces and lighting products update together only
+when the selected environment signature changes, and become current only after
+successful frame submission. An unchanged source runs only the background pass.
+GPU pass observations
 name `atmosphere-prepare`, `atmosphere-cube-0` through `atmosphere-cube-5`, and
-`atmosphere-background`; unavailable timestamps remain explicitly unavailable.
+`atmosphere-background`, `atmosphere-irradiance-*` and `atmosphere-prefilter-*`;
+unavailable timestamps remain explicitly unavailable.
 The source lifecycle inspection and graph resource accounting describe different
 owners: a source revision is not a claim that its GPU cube was submitted.
 
@@ -220,6 +245,10 @@ shows the public scene inputs and associated acceptance gates.
 
 ## GPU pass timing: opt in, draw, observe, branch on status
 
+When App owns the draw loop, `renderer.subscribe` delivers the exact `receipt`
+in each `frame-submitted` event. Pass that receipt to `observe`; do not construct
+one from the frame number. Start observation promptly because retention is bounded.
+
 GPU pass timing is disabled by default. Opt in once on `createRenderer`, keep the
 returned `FrameReceipt`, and request facts only for that receipt. The pass
 duration is a bounded GPU fact; it is not frame latency.
@@ -497,6 +526,50 @@ API; use the existing owner operation shown here, then submit and inspect again:
 SSR never invokes these operations or mutates producer/device state; this table
 maps the typed action to the existing public World and Renderer seams.
 
+## Screen-space ambient occlusion
+
+Enable AO through the same public Standard profile used at creation or by
+`renderer.setProfile()`. It requires `renderPath: 'deferred'` for current-frame
+depth and world normals; an incompatible profile returns a structured error.
+
+The GLES fallback does not support the required raw-depth shader reads. It boots normally with AO disabled; requesting AO reports `feature-not-enabled` and requires WebGPU.
+
+The default Vite shader producer includes SSAO, so `StandardProfile.ssao` needs no build-time opt-in. A deliberately stripped manifest reports `post-process-not-found` when AO is requested; it must not silently render white AO.
+
+```ts
+const configured = renderer.setProfile({
+  ...renderer.inspect().profile,
+  renderPath: 'deferred',
+  ssao: { quality: 'medium', radius: 0.5, bias: 0.025, intensity: 1 },
+});
+if (!configured.ok) throw configured.error;
+// Remove both AO passes and their per-frame upload work:
+const disabled = renderer.setProfile({ ...renderer.inspect().profile, ssao: false });
+if (!disabled.ok) throw disabled.error;
+```
+
+| Parameter | Contract |
+|:--|:--|
+| `quality` | `low` / `medium` / `high`: 16 / 32 / 64 hemisphere samples; default `high` |
+| `radius` | Positive finite view-space distance; default `0.5` |
+| `bias` | Non-negative finite view-space depth bias; default `0.025` |
+| `intensity` | Non-negative finite strength; default `1`; zero preserves the unoccluded image |
+| `ssao: true` | Enables the same default parameter set |
+
+AO runs at half resolution with a symmetric depth/normal-aware blur. Sampling
+uses the raster projection, including camera jitter. Static, skinned, and
+custom Standard surfaces multiply ambient illumination and the corresponding
+SSR fallback by the same AO factor; direct lights remain unchanged. Material
+occlusion is applied once. AO is reconstructed every frame and owns no temporal
+history, so moved geometry cannot leave a retained AO image.
+
+> [!NOTE]
+> AO is a local screen-space approximation. Offscreen occluders are absent,
+> and silhouettes can retain small half-resolution sampling artifacts. Use
+> the plane-plus-cube example at `apps/learn-render/5.advanced-lighting/9.ssao`
+> to compare contact, lift, quality, radius, and disabled behavior. GPU timings
+> are opt-in via `gpuPassTiming` and receipt-bound `observe(..., { include: ['timings'] })`.
+
 ## Target and probe lifecycle index
 
 The public target route is one Renderer owner: create a typed `RenderTarget`, create a
@@ -520,6 +593,90 @@ must match the committed row's frame and device generation before it is used as
 The exact public names and stable consumer IDs are machine-readable in
 `src/__tests__/render-target-public-schema.json`.
 
+### Dynamic reflection probes
+
+```ts
+const probe = world.spawn(
+  { component: Transform, data: { pos: [0, 1, 0] } },
+  { component: ReflectionProbe, data: {
+    halfExtents: [5, 3, 5], resolution: 128,
+    updateIntent: REFLECTION_PROBE_UPDATE_ON_CHANGE,
+  } },
+).unwrap();
+// Explicit invalidation also works for a once probe.
+const current = world.get(probe, ReflectionProbe).unwrap();
+world.set(probe, ReflectionProbe, {
+  invalidationVersion: current.invalidationVersion + 1,
+}).unwrap();
+```
+
+| Update intent | Trigger |
+|:--|:--|
+| `REFLECTION_PROBE_UPDATE_ONCE` | Initial capture, explicit invalidation, or probe movement |
+| `REFLECTION_PROBE_UPDATE_ON_CHANGE` | Above, plus retained scene/material/geometry or light/environment changes |
+| `REFLECTION_PROBE_UPDATE_CONTINUOUS` | Start another capture after the previous candidate completes |
+
+The renderer shares **one capture face or PMREM face/mip step per submitted
+frame across all probes**, round-robin. One probe needs six raw faces plus 30
+filter steps: 36 completed submissions after pipeline readiness. Multiple probes
+share that budget. This is amortized realtime updating, with visible latency;
+it does not provide a fresh six-face snapshot every display frame. Changes
+arriving during a cycle coalesce into the next cycle rather than starving
+publication. Video and time-driven shader changes require continuous mode or
+explicit invalidation when their producer does not update scene change evidence.
+
+A complete candidate swaps atomically after successful GPU completion. Failed
+submissions retry the same step, and stale device-generation completions cannot
+publish. A moving probe uses Skylight fallback until a capture at its new center
+is ready. Each face sees the retained authored scene, including objects outside
+the display camera; authored hidden objects stay excluded. Probe specular keeps
+the global Skylight diffuse color, intensity, and rotation. Shared materials
+still select probes independently for each object.
+
+Raw faces sample the selected Atmosphere sky cube, otherwise the authored
+`SkyboxBackground`, or the Skylight environment when no skybox is present,
+in the same HDR geometry pass. Atmosphere capture declares a sampled-read of
+the existing graph-owned cube; it does not evaluate another sky or allocate
+another sky texture. Its sun disc remains in the display background only,
+while directional lighting supplies the specular sun response. Changes to
+Atmosphere parameters invalidate `on-change` probes through the existing
+selected-environment signature. Camera-only changes do not invalidate them.
+Environment asset readiness precedes capture. Camera-cube orientation is normalized during PMREM
+production; runtime probe sampling does not apply the image-IBL Y conversion.
+Place capture centers in empty space, away from the interior of opaque objects.
+
+Fallback source receipts publish only after the actual graph output completes
+on the GPU. Normal rendering performs no fallback pixel readback or hashing.
+Set `captureReflectionFallbackReadback: true` on `createApp` / `createRenderer`
+only for diagnostics that need `reflectionFallbackReadback`: this copies,
+maps, validates and hashes the full HDR attachment each submitted frame.
+Source receipts contain selection facts; the optional readback receipt contains
+actual sampled pixel evidence. Submission failure preserves compatible LKG,
+and stale device or source completions cannot publish either kind of receipt.
+
+The selected probe is admitted per object, but its influence is evaluated per
+shaded pixel. Pixels outside `halfExtents` use the global Skylight specular map;
+the outer 10% of the box blends into that source. The global texture stays
+resident alongside the local cube, including GPU-driven and custom Surface
+materials. Changing either resource invalidates material binding reuse.
+
+`boxProjection` defaults to `false`, as a general captured cubemap has no known
+wall geometry. Set it to `true` only when `halfExtents` also describes a room's
+reflection proxy. A small influence box around an outdoor object is not a room
+proxy: forcing that correction can reflect the wrong surface even for an
+otherwise valid ray. The SSR demo exposes independent SSR/probe controls and a
+**Plane + cube** fixture; the Objects fixture keeps every object resting on its
+floor and contains the probe receiver within the influence box.
+
+Resolution is an actual power of two from 16 through 256. The 64 MiB admission
+budget counts the raw cube, two filtered cubes, and depth attachments, with at
+most 16 probes; at 256 pixels the byte budget admits five. Start at 64 or 128 for
+frequent updates. `inspect().reflectionProbes.updates` reports intent, requested
+and captured revision, active generation, pending work, and completion latency.
+The SSR fallback source identity includes the active probe generation, so a
+new environment invalidates stale SSR history. Probe capture, SSR ray tracing,
+and SSR composition remain separate observable work.
+
 ## Stable inspection and dark-gradient evidence
 
 Progressive disclosure is intentional: read Camera configuration first, then
@@ -1160,6 +1317,10 @@ the custom parameters on the returned root MaterialAsset. Compiler and loader
 project that published contract without adding fields based on a Pass module.
 Physical layer declarations remain sparse. A custom full-shader material does
 not acquire Standard semantics by adding a shadow Pass or a `surface` slot.
+When a producer also publishes `vs_main` and `vs_scene_index` for a controlled
+full-custom program, the same prepared material can use the GPU-driven indirect
+lane; ordinary custom WGSL without that ABI remains on its direct/specialized
+lane.
 
 The custom WGSL implements only `evaluate_surface`; it does not declare
 stages, bindings, lighting, or output code. The Engine composes the result
@@ -1181,7 +1342,7 @@ consumer never re-infers physical layers from `SurfaceData`.
 |:--|:--|:--|
 | base-only Standard | no second physical layer | Deferred plus Forward and ShadowCaster |
 | Standard with a physical layer | physical layer present | Forward plus ShadowCaster |
-| full-custom escape hatch | no Standard plan | authored custom pass contract |
+| full-custom escape hatch | no Standard plan | authored custom pass contract; GPU-driven only with a published direct/scene-index ABI |
 
 ## Points and Lines runtime contract
 
@@ -1337,16 +1498,31 @@ void materialHandle;
 | Candidate | Main GPU lane | Shadow GPU lane | Closed result |
 |:--|:--:|:--:|:--|
 | Standard opaque or Alpha Mask, finite resources | supported | supported | `gpu` |
-| Standard skin with producer-authored finite animated bounds | supported | supported | `gpu` |
+| Standard skin with imported or explicitly authored finite animated bounds | supported | supported | `gpu` |
 | Skin bounds missing or non-finite | refused | refused | `cpu-deformation` |
 | Capable resource/pipeline not ready | refused | refused | `blocked` (`resource-not-ready`) |
-| Blend, transmission, morph, custom, or unsupported topology | refused | refused | `cpu-semantic` |
-| Clustered local lights or enabled SSAO, including zero local lights | refused | refused | `cpu-semantic` (`unsupported`) |
+| Blend, transmission, morph, custom without a published ABI, or unsupported topology | refused | refused | `cpu-semantic` |
+| ABI-backed custom Surface/full-custom row within the producer page | supported | supported when a ShadowCaster ABI is published | `gpu` |
+
+The custom row is deliberately about the published producer contract, not a
+shader-name allowlist. A custom program is eligible only when its cooked receipt
+contains matching direct/scene-index entries, reflected resources, vertex inputs,
+and a schema-derived row no larger than the 512-byte GPU Scene page. Custom
+storage-buffer resources, renderer-local/video sources, and pass attachments that
+have no corresponding prepared owner remain on their specialized lane until that
+owner publishes the missing binding and recovery contract. The legacy
+[`custom-shader` demo](../../apps/hello/custom-shader) is direct-only by design;
+it does not publish `vs_scene_index`, so it is not evidence for the indirect lane.
+
+Clustered local lights and SSAO use the same group-2 lighting bindings in direct
+and scene-index programs, including custom Surface programs. These switches do
+not disable GPU-driven admission. SSAO requires `renderPath: 'deferred'` to
+produce depth and normals. SSR's fallback MRT selects the corresponding
+scene-index fragment variant; background probe capture preserves the display
+view's GPU submission. Each pass selects its own material slots and color
+attachments. Shared materials at different local probes retain separate binding
+classes so deduplication cannot substitute one object's reflection environment.
 
-The current scene-index shader does not consume the unified Cluster surface
-bindings. Admission checks active surface requirements each frame; disabling
-SSAO restores GPU eligibility when no other unsupported input remains. The
-existing complete CPU submission path still renders on the selected GPU.
 
 ### Static TextureAsset admission
 
@@ -1455,9 +1631,12 @@ view-local visibility and projection bindings. Ownership is per draw item and
 view pass, so one draw can be GPU-owned in the main/shadow channels while an
 unrelated semantic pass remains CPU-owned.
 
-Transparent/blend, transmission, morph, custom or unsupported prepared
-variants, and skin without a producer-authored conservative bound stay on an
-explicit CPU semantic or CPU deformation lane. WebGL2 selects capability
+Transparent/blend, transmission, morph, unsupported prepared variants, and
+skin without a producer-authored conservative bound stay on an explicit CPU
+semantic or CPU deformation lane. A producer-published custom Surface or
+full-custom ABI follows the same GPU lane when its selected Pass passes the
+prepared contract; an ordinary custom WGSL artifact without that ABI remains
+CPU/specialized. WebGL2 selects capability
 fallback from the same persistent projection; it does not emulate compute.
 Missing capable-path artifacts and failed resource publication are structured
 errors that block graph promotion rather than silently drawing the same item a
@@ -1973,6 +2152,28 @@ physics.admitDerivedShapeCandidate(physicsCandidate, () => {
 // After World.update succeeds, inspect Physics publication/failure and draw.
 ```
 
+For a group of physical bodies, pair `physics.admitDerivedShapeCandidates`
+with `renderer.acceptDynamicGeometryCandidates`. The latter accepts one prepared
+candidate per distinct render entity, all in the same attached World and fixed
+step, using the existing candidate budget. It retains previous unpublished
+credentials and GPU leases until every MeshFilter swap succeeds. A later-member
+refusal restores earlier bindings; if restoration cannot be proven it throws so
+the paired physics owner requires reconstruction. Topology history is invalidated
+once after the whole successful group. Retain every returned accepted credential
+and inspect its normal FrameReceipt; callback success alone is not a draw receipt.
+
+```ts
+physics.admitDerivedShapeCandidates(physicsCandidates, () => {
+  const admitted = renderer.acceptDynamicGeometryCandidates(geometryCandidates, {
+    world,
+    fixedStep: world.getResource(FixedTime).tick,
+  });
+  if (!admitted.ok) return err(admitted.error);
+  acceptedGeometries = admitted.value;
+  return ok(undefined);
+}).unwrap();
+```
+
 The commit must return immediately after its complete binding change, without
 additional fallible work. On physical preparation/native failure it is not called;
 cancel the still-prepared geometry using its normal owner. On a refused commit,
@@ -2073,6 +2274,32 @@ loading therefore continues through the existing route; a producer that needs
 a custom voxel artifact owns that schema and loader outside the Engine, while
 its projected standard mesh enters this candidate path.
 
+### Residency resource retirement
+
+Scope-owned `GpuBuffer` and `GpuTexture` registrations end when their explicit
+`destroy()` succeeds. Failed destruction keeps scope ownership for cleanup;
+scope termination still cleans remaining resources in reverse adoption order.
+Mesh retirement waits for outstanding submission and candidate leases before
+releasing that registration, so repeated mesh replacement does not retain all
+destroyed handles in the renderer generation. Caller-held handles retain their
+existing observable state; resource disposal is distinct from JavaScript GC.
+
 ### Targeted spatial inspection
 
 `renderer.bounds(world, entity)` returns a detached world-space AABB from the last extracted composition, including the existing instance-bound projection. It returns `undefined` for an absent World/entity or unknown/invalid producer bounds. This is renderer geometry evidence, not collision geometry or a synchronous update of authored World changes. A subsequent draw refreshes the projection; callers must not substitute an origin for an unavailable mesh bound. The query reuses culling ownership and retains no additional bounds cache.
+
+### Volumetric density coordinates
+
+`VolumetricFog.density` is a linear scalar field over `boundsMin` to `boundsMax`.
+World positions map to `(position - boundsMin) / (boundsMax - boundsMin)` and
+sample with clamp-to-edge addressing. The renderer clamps negative density at
+the optical-depth boundary, but adds no bias, octave synthesis, repetition or
+animation. White density means one; zero density contributes no extinction or
+scattering. Noise synthesis belongs to the asset producer. The existing volume
+passes integrate this field against scene depth before output tonemapping.
+
+Density integration uses fixed segment midpoints and the profile's logical
+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.

package/dist/assembly/atmosphere-shader-prewarm.d.ts

@@ -1,6 +1,6 @@
 import { type ShaderModule } from '@forgeax/engine-rhi';
 import type { ManifestEntry } from '@forgeax/engine-types';
 import type { AtmosphereShaderSources } from '../render-contract';
-/** Admit and compile the complete analytic-atmosphere shader pair atomically. */
+/** Admit and compile the complete analytic-atmosphere shader programs atomically. */
 export declare function prewarmAtmosphereShaders(entries: readonly ManifestEntry[], compile: (label: string, source: string) => Promise<ShaderModule>, seed: (label: string, module: ShaderModule) => void): Promise<AtmosphereShaderSources | undefined>;
 //# sourceMappingURL=atmosphere-shader-prewarm.d.ts.map

package/dist/assembly/atmosphere-shader-prewarm.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"atmosphere-shader-prewarm.d.ts","sourceRoot":"","sources":["../../src/assembly/atmosphere-shader-prewarm.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAElE,iFAAiF;AACjF,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,SAAS,aAAa,EAAE,EACjC,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,CAAC,EACjE,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,KAAK,IAAI,GAClD,OAAO,CAAC,uBAAuB,GAAG,SAAS,CAAC,CA4B9C"}
+{"version":3,"file":"atmosphere-shader-prewarm.d.ts","sourceRoot":"","sources":["../../src/assembly/atmosphere-shader-prewarm.ts"],"names":[],"mappings":"AAAA,OAAO,EAAY,KAAK,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAClE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,oBAAoB,CAAC;AAElE,qFAAqF;AACrF,wBAAsB,wBAAwB,CAC5C,OAAO,EAAE,SAAS,aAAa,EAAE,EACjC,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,KAAK,OAAO,CAAC,YAAY,CAAC,EACjE,IAAI,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,YAAY,KAAK,IAAI,GAClD,OAAO,CAAC,uBAAuB,GAAG,SAAS,CAAC,CA6B9C"}

package/dist/assembly/device-feature-admission.d.ts

@@ -1,5 +1,7 @@
 import type { RhiAdapter, RhiDevice } from '@forgeax/engine-rhi';
-export declare const STANDARD_PBR_REQUIRED_SAMPLED_TEXTURES = 17;
+import { STANDARD_PBR_REQUIRED_SAMPLED_TEXTURES } from './shader-prewarm-policy';
+export { STANDARD_PBR_REQUIRED_SAMPLED_TEXTURES };
+export declare function transmissionBackdropAvailable(limit: number | undefined): boolean;
 /**
  * The complete Standard physical root can declare all optional texture slots.
  * Its material group therefore needs one more sampled-texture entry than the
@@ -7,7 +9,7 @@ export declare const STANDARD_PBR_REQUIRED_SAMPLED_TEXTURES = 17;
  * provide it; lower-capability devices remain fail-closed at material
  * pipeline admission instead of receiving an invalid WebGPU layout.
  */
-export declare const STANDARD_PHYSICAL_REQUIRED_SAMPLED_TEXTURES = 21;
+export declare const STANDARD_PHYSICAL_REQUIRED_SAMPLED_TEXTURES = 22;
 export interface DeviceFeatureAdmissionOptions {
     readonly gpuPassTiming?: object | undefined;
     readonly captureGpuTimings?: boolean | undefined;
@@ -22,5 +24,4 @@ type AdapterFeatureProbe = Pick<RhiAdapter, 'features'> & Partial<Pick<RhiAdapte
 export declare function deriveDeviceFeatureAdmission(adapter: AdapterFeatureProbe, options?: DeviceFeatureAdmissionOptions): DeviceFeatureAdmission;
 export declare function deviceOptionsForAdapter(adapter: AdapterFeatureProbe, options?: DeviceFeatureAdmissionOptions): DeviceFeatureAdmission | undefined;
 export declare function isTimestampQueryAdmitted(caps: Pick<RhiDevice['caps'], 'timestampQuery' | 'timestampPeriodNanoseconds'>): boolean;
-export {};
 //# sourceMappingURL=device-feature-admission.d.ts.map

package/dist/assembly/device-feature-admission.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"device-feature-admission.d.ts","sourceRoot":"","sources":["../../src/assembly/device-feature-admission.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAejE,eAAO,MAAM,sCAAsC,KAAK,CAAC;AACzD;;;;;;GAMG;AACH,eAAO,MAAM,2CAA2C,KAAK,CAAC;AAE9D,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5C,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAClD;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,gBAAgB,EAAE,cAAc,EAAE,CAAC;IAC5C,QAAQ,CAAC,cAAc,CAAC,EAAE;QACxB,QAAQ,CAAC,gCAAgC,EAAE,MAAM,CAAC;KACnD,CAAC;CACH;AAED,KAAK,mBAAmB,GAAG,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC;AAE9F,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,mBAAmB,EAC5B,OAAO,CAAC,EAAE,6BAA6B,GACtC,sBAAsB,CA0BxB;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,mBAAmB,EAC5B,OAAO,CAAC,EAAE,6BAA6B,GACtC,sBAAsB,GAAG,SAAS,CAKpC;AAED,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,4BAA4B,CAAC,GAC7E,OAAO,CAOT"}
+{"version":3,"file":"device-feature-admission.d.ts","sourceRoot":"","sources":["../../src/assembly/device-feature-admission.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAEjE,OAAO,EAAE,sCAAsC,EAAE,MAAM,yBAAyB,CAAC;AAcjF,OAAO,EAAE,sCAAsC,EAAE,CAAC;AAElD,wBAAgB,6BAA6B,CAAC,KAAK,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAEhF;AACD;;;;;;GAMG;AACH,eAAO,MAAM,2CAA2C,KAAK,CAAC;AAE9D,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,aAAa,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC5C,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,GAAG,SAAS,CAAC;CAClD;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,gBAAgB,EAAE,cAAc,EAAE,CAAC;IAC5C,QAAQ,CAAC,cAAc,CAAC,EAAE;QACxB,QAAQ,CAAC,gCAAgC,EAAE,MAAM,CAAC;KACnD,CAAC;CACH;AAED,KAAK,mBAAmB,GAAG,IAAI,CAAC,UAAU,EAAE,UAAU,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,CAAC,CAAC,CAAC;AAE9F,wBAAgB,4BAA4B,CAC1C,OAAO,EAAE,mBAAmB,EAC5B,OAAO,CAAC,EAAE,6BAA6B,GACtC,sBAAsB,CA0BxB;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,mBAAmB,EAC5B,OAAO,CAAC,EAAE,6BAA6B,GACtC,sBAAsB,GAAG,SAAS,CAKpC;AAED,wBAAgB,wBAAwB,CACtC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,EAAE,gBAAgB,GAAG,4BAA4B,CAAC,GAC7E,OAAO,CAOT"}

package/dist/assembly/dynamic-geometry-host.d.ts

@@ -5,6 +5,12 @@ import { type DynamicGeometryCandidate, DynamicGeometryError, type DynamicGeomet
 export interface DynamicGeometryHostImplementation {
     prepareDynamicGeometry(input: DynamicGeometryPrepareInput): Result<DynamicGeometryCandidate, DynamicGeometryError>;
     acceptDynamicGeometry(candidate: DynamicGeometryCandidate, ordering: DynamicGeometryOrdering): Result<DynamicGeometryCandidate, DynamicGeometryError>;
+    /**
+     * Atomically swap distinct entities in one attached World. Returned failures
+     * retain old bindings; an uncertain rollback throws to require paired rebuild.
+     * Invoke inside PhysicsWorld.admitDerivedShapeCandidates commitGeometry.
+     */
+    acceptDynamicGeometryCandidates(candidates: readonly DynamicGeometryCandidate[], ordering: DynamicGeometryOrdering): Result<readonly DynamicGeometryCandidate[], DynamicGeometryError>;
     dynamicGeometryReceipt(candidate: DynamicGeometryCandidate): DynamicGeometryReceipt | undefined;
     cancelDynamicGeometry(candidate: DynamicGeometryCandidate): Result<void, DynamicGeometryError>;
     retireDynamicGeometry(candidate: DynamicGeometryCandidate): Result<void, DynamicGeometryError>;

package/dist/assembly/dynamic-geometry-host.d.ts.map

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

package/dist/assembly/host-contract.d.ts

@@ -39,6 +39,12 @@ export interface RendererHostImplementation {
     attach(world: World): RenderResult<RenderWorldLease, RenderError>;
     prepareDynamicGeometry(input: DynamicGeometryPrepareInput): Result<DynamicGeometryCandidate, DynamicGeometryError>;
     acceptDynamicGeometry(candidate: DynamicGeometryCandidate, ordering: DynamicGeometryOrdering): Result<DynamicGeometryCandidate, DynamicGeometryError>;
+    /**
+     * Atomically swap distinct entities in one attached World. Returned failures
+     * retain old bindings; an uncertain rollback throws to require paired rebuild.
+     * Invoke inside PhysicsWorld.admitDerivedShapeCandidates commitGeometry.
+     */
+    acceptDynamicGeometryCandidates(candidates: readonly DynamicGeometryCandidate[], ordering: DynamicGeometryOrdering): Result<readonly DynamicGeometryCandidate[], DynamicGeometryError>;
     dynamicGeometryReceipt(candidate: DynamicGeometryCandidate): DynamicGeometryReceipt | undefined;
     cancelDynamicGeometry(candidate: DynamicGeometryCandidate): Result<void, DynamicGeometryError>;
     retireDynamicGeometry(candidate: DynamicGeometryCandidate): Result<void, DynamicGeometryError>;

package/dist/assembly/host-contract.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"host-contract.d.ts","sourceRoot":"","sources":["../../src/assembly/host-contract.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,gCAAgC,CAAC;AACpE,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,qBAAqB,CAAC;AACjD,OAAO,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AACrF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAAK,EACV,wBAAwB,EACxB,oBAAoB,EACpB,uBAAuB,EACvB,2BAA2B,EAC3B,sBAAsB,EACvB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,KAAK,EAAE,2BAA2B,EAAE,WAAW,EAAE,MAAM,kBAAkB,CAAC;AACjF,OAAO,KAAK,EAAE,aAAa,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AACjF,OAAO,KAAK,EAAE,6BAA6B,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AACjG,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,cAAc,CAAC;AAC5D,OAAO,KAAK,EAAE,8BAA8B,EAAE,MAAM,2BAA2B,CAAC;AAChF,OAAO,KAAK,EAAE,gBAAgB,EAAE,uBAAuB,EAAE,MAAM,iBAAiB,CAAC;AACjF,OAAO,KAAK,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,MAAM,0BAA0B,CAAC;AAC9F,OAAO,KAAK,EACV,gBAAgB,EAChB,uBAAuB,EACvB,YAAY,EACZ,uBAAuB,EACvB,cAAc,EACd,kBAAkB,EAClB,aAAa,EACb,qBAAqB,EACrB,oBAAoB,EACpB,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,EACb,YAAY,EACZ,gBAAgB,EACjB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,kBAAkB,CAAC;AAC9D,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,6BAA6B,CAAC;AACrE,OAAO,KAAK,EACV,YAAY,EACZ,sBAAsB,EACtB,2BAA2B,EAC3B,0BAA0B,EAC1B,yBAAyB,EACzB,gCAAgC,EACjC,MAAM,sBAAsB,CAAC;AAE9B,KAAK,yBAAyB,GAAG,CAC/B,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE;IAAE,QAAQ,CAAC,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;CAAE,KACjE,OAAO,CAAC,MAAM,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC,CAAC;AAE7C,oFAAoF;AACpF,MAAM,MAAM,iBAAiB,GACzB;IAAE,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,aAAa,CAAA;CAAE,GACzD;IAAE,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAA;CAAE,CAAC;AAEjE,MAAM,MAAM,yBAAyB,GAAG,CAAC,KAAK,EAAE,iBAAiB,KAAK,IAAI,CAAC;AAE3E;;;;GAIG;AACH,MAAM,WAAW,0BAA0B;IACzC,+EAA+E;IAC/E,QAAQ,CAAC,SAAS,EAAE,uBAAuB,CAAC;IAC5C,MAAM,CAAC,KAAK,EAAE,KAAK,GAAG,YAAY,CAAC,gBAAgB,EAAE,WAAW,CAAC,CAAC;IAClE,sBAAsB,CACpB,KAAK,EAAE,2BAA2B,GACjC,MAAM,CAAC,wBAAwB,EAAE,oBAAoB,CAAC,CAAC;IAC1D,qBAAqB,CACnB,SAAS,EAAE,wBAAwB,EACnC,QAAQ,EAAE,uBAAuB,GAChC,MAAM,CAAC,wBAAwB,EAAE,oBAAoB,CAAC,CAAC;IAC1D,sBAAsB,CAAC,SAAS,EAAE,wBAAwB,GAAG,sBAAsB,GAAG,SAAS,CAAC;IAChG,qBAAqB,CAAC,SAAS,EAAE,wBAAwB,GAAG,MAAM,CAAC,IAAI,EAAE,oBAAoB,CAAC,CAAC;IAC/F,qBAAqB,CAAC,SAAS,EAAE,wBAAwB,GAAG,MAAM,CAAC,IAAI,EAAE,oBAAoB,CAAC,CAAC;IAC/F,sBAAsB,CACpB,KAAK,EAAE;QACL,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QACzB,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;QAClC,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC,OAAO,CAAC,CAAC;KACvC,EACD,MAAM,CAAC,EAAE,SAAS,MAAM,EAAE,EAC1B,SAAS,CAAC,EAAE,MAAM,GACjB,SAAS,sBAAsB,EAAE,CAAC;IACrC,kBAAkB,CAAC,UAAU,EAAE,sBAAsB,GAAG,YAAY,CAAC,YAAY,EAAE,WAAW,CAAC,CAAC;IAChG,kBAAkB,CAChB,MAAM,EAAE,YAAY,EACpB,UAAU,EAAE,sBAAsB,GACjC,YAAY,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IACnC,+BAA+B,CAC7B,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,gCAAgC,GACxC,YAAY,CAAC,yBAAyB,EAAE,WAAW,CAAC,CAAC;IACxD,qBAAqB,CACnB,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,2BAA2B,GACnC,YAAY,CAAC,0BAA0B,EAAE,WAAW,CAAC,CAAC;IACzD,mBAAmB,CAAC,MAAM,EAAE,YAAY,GAAG,YAAY,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IAC3E,UAAU,CAAC,OAAO,EAAE,aAAa,GAAG,YAAY,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IACpE,kGAAkG;IAClG,MAAM,CAAC,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS,CAAC;IACpE,OAAO,IAAI,gBAAgB,CAAC;IAC5B;;;;OAIG;IACH,mBAAmB,IAAI;QACrB,QAAQ,CAAC,YAAY,EAAE,sBAAsB,GAAG,SAAS,CAAC;QAC1D,QAAQ,CAAC,SAAS,EAAE,6BAA6B,CAAC;KACnD,CAAC;IACF,SAAS,CAAC,OAAO,EAAE,gBAAgB,GAAG,YAAY,CAAC,YAAY,EAAE,QAAQ,GAAG,WAAW,CAAC,CAAC;IACzF,mEAAmE;IACnE,kBAAkB,CAAC,EAAE,CACnB,OAAO,EAAE,SAAS,OAAO,oBAAoB,EAAE,sBAAsB,EAAE,KACpE,YAAY,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IACrC,OAAO,CACL,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,YAAY,CAAC,uBAAuB,EAAE,WAAW,CAAC,CAAC,CAAC;IAC/D,cAAc,IAAI,YAAY,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC/C,cAAc,IAAI,YAAY,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IAC/C,OAAO,IAAI,OAAO,CAAC,MAAM,CAAC,IAAI,EAAE,cAAc,CAAC,CAAC,CAAC;IACjD,OAAO,IAAI,YAAY,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IAC3C,iFAAiF;IACjF,mBAAmB,CAAC,QAAQ,EAAE,yBAAyB,GAAG,MAAM,IAAI,CAAC;IAErE,QAAQ,CAAC,MAAM,EAAE,SAAS,CAAC;IAC3B,gBAAgB;IAChB,QAAQ,CAAC,4BAA4B,EAAE,yBAAyB,CAAC;IACjE,gBAAgB;IAChB,QAAQ,CAAC,0BAA0B,EAAE,CAAC,OAAO,EAAE,kBAAkB,GAAG,SAAS,KAAK,IAAI,CAAC;IACvF,QAAQ,CAAC,aAAa,EAAE,aAAa,CAAC;IACtC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;CAChE;AAED;;;;GAIG;AACH,MAAM,WAAW,yBAAyB;IACxC,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,YAAY,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;IACxD,WAAW,CAAC,KAAK,EAAE,KAAK,GAAG,IAAI,CAAC;IAChC,IAAI,CACF,eAAe,EAAE,SAAS,KAAK,EAAE,GAAG,gBAAgB,EACpD,OAAO,CAAC,EAAE,gBAAgB,GACzB,YAAY,CAAC,IAAI,GAAG,YAAY,EAAE,QAAQ,GAAG,WAAW,CAAC,CAAC;IAC7D,mBAAmB,CACjB,OAAO,EAAE,uBAAuB,GAC/B,OAAO,CAAC,YAAY,CAAC,gBAAgB,EAAE,2BAA2B,CAAC,CAAC,CAAC;IACxE,oEAAoE;IACpE,qBAAqB,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS,CAAC;IACpE,yBAAyB,CAAC,OAAO,EAAE,yBAAyB,GAAG,IAAI,CAAC;IACpE,MAAM,CAAC,QAAQ,EAAE,oBAAoB,GAAG,MAAM,IAAI,CAAC;IACnD,OAAO,CAAC,QAAQ,EAAE,qBAAqB,GAAG,MAAM,IAAI,CAAC;IACrD,MAAM,IAAI,cAAc,CAAC;IACzB,QAAQ,CAAC,YAAY,EAAE;QAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC;IAC3E,QAAQ,CAAC,eAAe,EAAE;QAAE,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAA;KAAE,CAAC;IAChE,QAAQ,CAAC,WAAW,EAAE,qBAAqB,CAAC;IAC5C,QAAQ,CAAC,oBAAoB,EAAE,SAAS,8BAA8B,EAAE,CAAC;IACzE,QAAQ,CAAC,iBAAiB,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9C,wBAAwB,IAAI,SAAS,wBAAwB,EAAE,CAAC;IAChE,8EAA8E;IAC9E,iBAAiB,CAAC,MAAM,EAAE,mBAAmB,CAAC,QAAQ,CAAC,GAAG,IAAI,CAAC;IAC/D,oBAAoB,CAAC,OAAO,EAAE,aAAa,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC;IAChG,sBAAsB,CAAC,OAAO,EAAE,aAAa,CAAC,OAAO,CAAC,GAAG,OAAO,CAAC,YAAY,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC,CAAC;IAClG,QAAQ,CAAC,eAAe,EAAE;QAAE,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAA;KAAE,CAAC;CAClG;AAED,iFAAiF;AACjF,MAAM,WAAW,8BACf,SAAQ,0BAA0B,EAChC,yBAAyB;CAAG"}
+{"version":3,"file":"host-contract.d.ts","sourceRoot":"","sources":["../../src/assembly/host-contract.ts"],"names":[],"mappings":"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"}

package/dist/assembly/material/assembly.d.ts

@@ -1,16 +1,39 @@
 import { type MaterialRenderProjection as AssetMaterialRenderProjection } from '@forgeax/engine-assets-runtime';
 import { type CookedMaterialRecord } from '@forgeax/engine-pack/material-cook';
-import { type MaterialShaderArtifact } from '@forgeax/engine-shader';
-import type { StandardLayerPlan } from '@forgeax/engine-types';
+import { type MaterialShaderArtifact, type MaterialShaderEntry, type ShaderRegistry } from '@forgeax/engine-shader';
+import type { MaterialProgramAddress, StandardLayerPlan } from '@forgeax/engine-types';
 export type { MaterialRenderPassProjection } from '@forgeax/engine-assets-runtime';
 export interface MaterialRenderProjection extends AssetMaterialRenderProjection {
     readonly layerPlan: StandardLayerPlan;
 }
 export declare function assembleMaterialProjection(record: CookedMaterialRecord): MaterialRenderProjection;
 /**
- * Assemble the one built-in Standard PBR artifact from the selected producer WGSL.
+ * Assemble the one built-in Standard PBR artifact from the registry-owned entry.
  * Both rigid and skinned identifiers use this producer; unsupported identifiers
  * stay outside the GPU-driven Standard PBR lane.
  */
 export declare function assembleStandardPbrArtifact(materialShaderId: string, wgsl: string, vertexColorAvailable?: boolean): MaterialShaderArtifact | undefined;
+export declare function assembleStandardPbrArtifact(materialShaderId: string, shaderEntry: MaterialShaderEntry, options?: MaterialShaderArtifactRequest): MaterialShaderArtifact | undefined;
+export interface MaterialShaderArtifactRequest {
+    /** Geometry-owned COLOR_0 fact used to select the matching published variant. */
+    readonly vertexColorAvailable?: boolean;
+    /** Deformation lane used to select a skin-compatible shadow variant. */
+    readonly deformation?: 'rigid' | 'skin';
+    readonly clustered?: boolean;
+    readonly reflectionFallback?: boolean;
+    readonly variantSet?: string;
+    /** Submission address requested by the consumer; GPU-driven uses scene-index. */
+    readonly address?: MaterialProgramAddress;
+    /** Concrete Pass whose entry metadata is being assembled. */
+    readonly pass?: 'forward' | 'shadow' | 'depth';
+}
+/** Resolve the registry-owned Standard PBR artifact, including the historical skin alias. */
+export declare function resolveStandardPbrArtifact(materialShaderId: string, shader: Pick<ShaderRegistry, 'findMaterialArtifact'> & Partial<Pick<ShaderRegistry, 'materialShaderManifestEntries'>>, options?: MaterialShaderArtifactRequest): MaterialShaderArtifact | undefined;
+/**
+ * Resolve any producer-published material artifact through the same manifest
+ * variant relation as Standard. Unlike the Standard compatibility helper this
+ * never fabricates a receipt: a custom shader without producer ABI remains
+ * outside the GPU-driven lane with a structured preparation error.
+ */
+export declare function resolveMaterialShaderArtifact(materialShaderId: string, shader: Pick<ShaderRegistry, 'findMaterialArtifact'> & Partial<Pick<ShaderRegistry, 'materialShaderManifestEntries'>>, options?: MaterialShaderArtifactRequest): MaterialShaderArtifact | undefined;
 //# sourceMappingURL=assembly.d.ts.map

package/dist/assembly/material/assembly.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"assembly.d.ts","sourceRoot":"","sources":["../../../src/assembly/material/assembly.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,wBAAwB,IAAI,6BAA6B,EAE/D,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,KAAK,oBAAoB,EAE1B,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAEL,KAAK,sBAAsB,EAC5B,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAG/D,YAAY,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC;AACnF,MAAM,WAAW,wBAAyB,SAAQ,6BAA6B;IAC7E,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC;CACvC;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,oBAAoB,GAAG,wBAAwB,CAejG;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,gBAAgB,EAAE,MAAM,EACxB,IAAI,EAAE,MAAM,EACZ,oBAAoB,UAAQ,GAC3B,sBAAsB,GAAG,SAAS,CAuBpC"}
+{"version":3,"file":"assembly.d.ts","sourceRoot":"","sources":["../../../src/assembly/material/assembly.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,wBAAwB,IAAI,6BAA6B,EAE/D,MAAM,gCAAgC,CAAC;AACxC,OAAO,EACL,KAAK,oBAAoB,EAE1B,MAAM,oCAAoC,CAAC;AAC5C,OAAO,EAEL,KAAK,sBAAsB,EAE3B,KAAK,mBAAmB,EAExB,KAAK,cAAc,EACpB,MAAM,wBAAwB,CAAC;AAChC,OAAO,KAAK,EAAE,sBAAsB,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAIvF,YAAY,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC;AACnF,MAAM,WAAW,wBAAyB,SAAQ,6BAA6B;IAC7E,QAAQ,CAAC,SAAS,EAAE,iBAAiB,CAAC;CACvC;AAED,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,oBAAoB,GAAG,wBAAwB,CAejG;AAED;;;;GAIG;AACH,wBAAgB,2BAA2B,CACzC,gBAAgB,EAAE,MAAM,EACxB,IAAI,EAAE,MAAM,EACZ,oBAAoB,CAAC,EAAE,OAAO,GAC7B,sBAAsB,GAAG,SAAS,CAAC;AACtC,wBAAgB,2BAA2B,CACzC,gBAAgB,EAAE,MAAM,EACxB,WAAW,EAAE,mBAAmB,EAChC,OAAO,CAAC,EAAE,6BAA6B,GACtC,sBAAsB,GAAG,SAAS,CAAC;AA8DtC,MAAM,WAAW,6BAA6B;IAC5C,iFAAiF;IACjF,QAAQ,CAAC,oBAAoB,CAAC,EAAE,OAAO,CAAC;IACxC,wEAAwE;IACxE,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,GAAG,MAAM,CAAC;IACxC,QAAQ,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;IAC7B,QAAQ,CAAC,kBAAkB,CAAC,EAAE,OAAO,CAAC;IACtC,QAAQ,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC;IAC7B,iFAAiF;IACjF,QAAQ,CAAC,OAAO,CAAC,EAAE,sBAAsB,CAAC;IAC1C,6DAA6D;IAC7D,QAAQ,CAAC,IAAI,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,OAAO,CAAC;CAChD;AA6JD,6FAA6F;AAC7F,wBAAgB,0BAA0B,CACxC,gBAAgB,EAAE,MAAM,EACxB,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,sBAAsB,CAAC,GAClD,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,+BAA+B,CAAC,CAAC,EAChE,OAAO,GAAE,6BAAkC,GAC1C,sBAAsB,GAAG,SAAS,CAkCpC;AAYD;;;;;GAKG;AACH,wBAAgB,6BAA6B,CAC3C,gBAAgB,EAAE,MAAM,EACxB,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,sBAAsB,CAAC,GAClD,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,+BAA+B,CAAC,CAAC,EAChE,OAAO,GAAE,6BAAkC,GAC1C,sBAAsB,GAAG,SAAS,CA+DpC"}

package/dist/assembly/material/pipeline-helpers.d.ts

@@ -0,0 +1,24 @@
+import type { BindGroupLayout } from '@forgeax/engine-rhi';
+import type { MaterialShaderArtifact, ShaderRegistry } from '@forgeax/engine-shader';
+import { type GpuDrivenPbrProgram } from '../../gpu-driven/pbr-program';
+import type { LayoutKind } from '../material-shader-policy';
+import { type MaterialShaderArtifactRequest } from './assembly';
+type MaterialArtifactRegistry = Pick<ShaderRegistry, 'findMaterialArtifact'> & Partial<Pick<ShaderRegistry, 'materialShaderManifestEntries'>>;
+export declare function resolveRendererMaterialShaderArtifact(materialShaderId: string, shader: MaterialArtifactRegistry, programs: ReadonlyMap<string, GpuDrivenPbrProgram> | undefined, options?: MaterialShaderArtifactRequest | boolean): MaterialShaderArtifact | undefined;
+export declare function resolveMaterialPipelineShaderId(materialShaderId: string, passKind: string): string;
+export declare function resolveMaterialPipelineVertexEntry(layoutKind: LayoutKind | undefined, vertexEntryPoint: string | undefined, authoredVertexEntry: string | undefined): string | undefined;
+export interface MaterialPipelineBindGroupState {
+    readonly meshBindGroupLayout: BindGroupLayout;
+    readonly pbrSkinMeshBindGroupLayout: BindGroupLayout | null;
+    readonly hdrpSkinMeshBindGroupLayout: BindGroupLayout | null;
+    readonly hdrpMeshBindGroupLayout?: BindGroupLayout | null;
+    readonly instancesBindGroupLayout: BindGroupLayout;
+    readonly gpuDrivenInstancesBindGroupLayout?: BindGroupLayout | null;
+}
+export declare function resolveMaterialPipelineBindGroups(layoutKind: LayoutKind, state: MaterialPipelineBindGroupState, clustered?: boolean): {
+    readonly meshLayout: BindGroupLayout;
+    readonly instancesLayout: BindGroupLayout;
+} | null;
+export declare function isEngineOwnedMaterialShader(materialShaderId: string): boolean;
+export {};
+//# sourceMappingURL=pipeline-helpers.d.ts.map

package/dist/assembly/material/pipeline-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"pipeline-helpers.d.ts","sourceRoot":"","sources":["../../../src/assembly/material/pipeline-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,KAAK,EAAE,sBAAsB,EAAE,cAAc,EAAE,MAAM,wBAAwB,CAAC;AACrF,OAAO,EAAE,KAAK,mBAAmB,EAA6B,MAAM,8BAA8B,CAAC;AACnG,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAC5D,OAAO,EAAE,KAAK,6BAA6B,EAAiC,MAAM,YAAY,CAAC;AAE/F,KAAK,wBAAwB,GAAG,IAAI,CAAC,cAAc,EAAE,sBAAsB,CAAC,GAC1E,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,+BAA+B,CAAC,CAAC,CAAC;AAEjE,wBAAgB,qCAAqC,CACnD,gBAAgB,EAAE,MAAM,EACxB,MAAM,EAAE,wBAAwB,EAChC,QAAQ,EAAE,WAAW,CAAC,MAAM,EAAE,mBAAmB,CAAC,GAAG,SAAS,EAC9D,OAAO,GAAE,6BAA6B,GAAG,OAAY,GACpD,sBAAsB,GAAG,SAAS,CAWpC;AAED,wBAAgB,+BAA+B,CAC7C,gBAAgB,EAAE,MAAM,EACxB,QAAQ,EAAE,MAAM,GACf,MAAM,CAOR;AAED,wBAAgB,kCAAkC,CAChD,UAAU,EAAE,UAAU,GAAG,SAAS,EAClC,gBAAgB,EAAE,MAAM,GAAG,SAAS,EACpC,mBAAmB,EAAE,MAAM,GAAG,SAAS,GACtC,MAAM,GAAG,SAAS,CAQpB;AAED,MAAM,WAAW,8BAA8B;IAC7C,QAAQ,CAAC,mBAAmB,EAAE,eAAe,CAAC;IAC9C,QAAQ,CAAC,0BAA0B,EAAE,eAAe,GAAG,IAAI,CAAC;IAC5D,QAAQ,CAAC,2BAA2B,EAAE,eAAe,GAAG,IAAI,CAAC;IAC7D,QAAQ,CAAC,uBAAuB,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;IAC1D,QAAQ,CAAC,wBAAwB,EAAE,eAAe,CAAC;IACnD,QAAQ,CAAC,iCAAiC,CAAC,EAAE,eAAe,GAAG,IAAI,CAAC;CACrE;AAED,wBAAgB,iCAAiC,CAC/C,UAAU,EAAE,UAAU,EACtB,KAAK,EAAE,8BAA8B,EACrC,SAAS,UAAQ,GAChB;IAAE,QAAQ,CAAC,UAAU,EAAE,eAAe,CAAC;IAAC,QAAQ,CAAC,eAAe,EAAE,eAAe,CAAA;CAAE,GAAG,IAAI,CAmB5F;AAED,wBAAgB,2BAA2B,CAAC,gBAAgB,EAAE,MAAM,GAAG,OAAO,CAY7E"}

package/dist/assembly/material-shader-policy.d.ts.map

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

package/dist/assembly/recovery/device-loss-fanout.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"device-loss-fanout.d.ts","sourceRoot":"","sources":["../../../src/assembly/recovery/device-loss-fanout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,KAAK,EACV,sBAAsB,EACtB,oBAAoB,EACpB,wBAAwB,EACzB,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,qFAAqF;AACrF,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,cAAc,EACpB,UAAU,EAAE;IACV,YAAY,EAAE,oBAAoB,CAAC;IACnC,aAAa,EAAE,wBAAwB,CAAC;IACxC,cAAc,EAAE,sBAAsB,CAAC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,MAAM,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;IACzB,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC,GACA,IAAI,CAkEN"}
+{"version":3,"file":"device-loss-fanout.d.ts","sourceRoot":"","sources":["../../../src/assembly/recovery/device-loss-fanout.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAErD,OAAO,KAAK,EACV,sBAAsB,EACtB,oBAAoB,EACpB,wBAAwB,EACzB,MAAM,iBAAiB,CAAC;AACzB,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAC;AAE1D,qFAAqF;AACrF,wBAAgB,sBAAsB,CACpC,MAAM,EAAE,SAAS,EACjB,IAAI,EAAE,cAAc,EACpB,UAAU,EAAE;IACV,YAAY,EAAE,oBAAoB,CAAC;IACnC,aAAa,EAAE,wBAAwB,CAAC;IACxC,cAAc,EAAE,sBAAsB,CAAC;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,MAAM,CAAC;IAChC,WAAW,CAAC,EAAE,MAAM,IAAI,CAAC;IACzB,YAAY,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;CACzC,GACA,IAAI,CAuEN"}

package/dist/assembly/recovery/recovery-attempt.d.ts

@@ -2,7 +2,7 @@ import { type RhiAdapter, type RhiCanvasContext, type RhiDevice, RhiError, type
 import { type Result } from '@forgeax/engine-types';
 import type { RhiBackendPack } from '../backend-contract';
 import { type RecoveryContinuation, type RecoveryDeadline, type RecoveryPhase } from '../renderer-lifecycle';
-export declare const STANDARD_PBR_REQUIRED_SAMPLED_TEXTURES = 17;
+export { deviceOptionsForAdapter } from '../device-feature-admission';
 type ProbeFormat = 'rgba16float' | 'rgba8unorm';
 /**
  * Prove that a freshly acquired candidate device can execute and expose one
@@ -28,10 +28,6 @@ export declare function probeCandidateGraphExecution(device: RhiDevice, target:
     readonly view: TextureView;
     readonly format: ProbeFormat;
 }): Promise<import('@forgeax/engine-types').Result<void, RhiError>>;
-export declare function deviceOptionsForAdapter(adapter: Pick<RhiAdapter, 'features' | 'limits'>): {
-    requiredFeatures?: GPUFeatureName[];
-    requiredLimits?: GPUDeviceDescriptor['requiredLimits'];
-} | undefined;
 export interface AcquiredDeviceGeneration {
     readonly adapter: RhiAdapter;
     readonly device: RhiDevice;
@@ -59,5 +55,4 @@ export type RecoveryStepOutcome<T, E> = {
 export declare function runRecoveryStep<T, E>(operation: (continuation?: RecoveryContinuation) => Promise<Result<T, E>>, phase: RecoveryPhase, deadline: RecoveryDeadline | undefined, now?: () => number, continuation?: RecoveryContinuation): Promise<RecoveryStepOutcome<T, E>>;
 /** Acquire the same backend generation inputs for boot and recovery. */
 export declare function acquireDeviceGeneration(pack: RhiBackendPack, canvas: HTMLCanvasElement | OffscreenCanvas, deadline?: RecoveryDeadline, continuation?: RecoveryContinuation, onPhase?: (phase: RecoveryPhase) => void): Promise<Result<AcquiredDeviceGeneration, DeviceGenerationAcquisitionFailure>>;
-export {};
 //# sourceMappingURL=recovery-attempt.d.ts.map