@forgeax/engine-render 0.1.24 → 0.1.26

package/dist/scene/render-scene.d.ts

@@ -6,11 +6,13 @@ import type { DeviceScope, LifecycleResourceSpec } from '../device/device-scope'
 import { type SubmissionPlan } from '../gpu-driven/batch-topology';
 import { GpuScene } from '../gpu-scene';
 import type { PersistentRenderSceneInspection } from '../inspection-types';
+import type { InstanceProjectionStore } from '../instances';
 import type { PointsLinesInspection } from '../points-lines/inspection';
 import type { PointsLinesRetainedSnapshot } from '../points-lines/snapshot';
 import { type ReflectionProbeFact, ReflectionProbeProjection, type ReflectionProbeSelectionResult } from '../reflection/projection';
 import type { CameraSnapshot } from '../render-contract';
 import type { DispatchEntry, ExtractedFrame, MaterialSnapshotCachesByWorld, RenderableSnapshot, RenderableTemporalSnapshot } from '../render-system-extract';
+import type { SkinPaletteAllocator } from '../systems/skin-palette-allocator';
 import { type TransmissionDemand } from '../transmission/projection';
 import type { RenderSceneApplyResult, RenderSceneBounds, RenderSceneInspection, RenderSceneOperation, RenderSceneSlot } from './render-scene-types';
 import { type VisibilityBudget } from './visibility/budget';
@@ -22,6 +24,12 @@ interface WorldTransformSpan {
     readonly entities: Readonly<Uint32Array>;
     readonly worlds: Readonly<Float32Array>;
 }
+/** The normal extract request used by the persistent scene owner. */
+export type PersistentRenderCandidateRequest = 'full' | 'none' | {
+    readonly kind: 'partial';
+    /** Entity keys are local to the corresponding World entry. */
+    readonly entitiesByWorld: readonly (ReadonlySet<number> | undefined)[];
+};
 export interface RenderSceneSubmissionCapture {
     readonly revision: number;
     readonly slots: readonly {
@@ -113,6 +121,9 @@ export interface PersistentRenderSceneOptions {
     readonly onGpuError?: ((error: RhiError) => void) | undefined;
     readonly onSharedRefMutation?: ((worldId: number, handle: number) => void) | undefined;
     readonly configuredQueryBudget?: number | undefined;
+    /** Rebuildable projection of World-owned instance matrices. */
+    readonly instanceCollections?: InstanceProjectionStore | undefined;
+    readonly getSkinPaletteAllocator?: (() => SkinPaletteAllocator | null) | undefined;
 }
 export interface PersistentGpuDrivenState {
     readonly scene: GpuScene;
@@ -238,7 +249,7 @@ export declare class PersistentRenderScene {
     extractComposition(worlds: readonly World[], owner: {
         readonly cameraOwner: number;
         readonly resourceOwner: number;
-    }, catalogEpoch: number, buildCandidateFrame: (renderables: 'full' | 'none') => ExtractedFrame, leases?: readonly RenderReadLease[]): ExtractedFrame;
+    }, catalogEpoch: number, buildCandidateFrame: (request: PersistentRenderCandidateRequest) => ExtractedFrame, leases?: readonly RenderReadLease[]): ExtractedFrame;
     invalidate(): void;
     setCompositionGpuSceneDemand(sceneRowsRequired: boolean): void;
     detach(world: World): void;

package/dist/scene/render-scene.d.ts.map

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

package/dist/systems/skin-palette-allocator.d.ts

@@ -28,6 +28,12 @@ export interface SkinPaletteAllocator {
      *         `device.limits.maxStorageBufferBindingSize`
      */
     allocateSlice(jointCount: number): SkinPaletteSlice;
+    /** Allocate one stable slice for a retained render source. */
+    allocateSliceFor(key: string, jointCount: number): SkinPaletteSlice;
+    /** Release a stable slice when its render source leaves the scene. */
+    releaseSliceFor(key: string): void;
+    /** Reconcile stable slices after a full render-source extraction. */
+    retainSliceKeys(keys: ReadonlySet<string>): void;
     /**
      * Write joint matrices into the slice's buffer at the slice's offset.
      * Computes M_i = jointWorldTransforms[i] * ibm[i] per joint.

package/dist/systems/skin-palette-allocator.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"skin-palette-allocator.d.ts","sourceRoot":"","sources":["../../src/systems/skin-palette-allocator.ts"],"names":[],"mappings":"AA6CA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAEjD,OAAO,KAAK,EAAU,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAO7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAmB7D,MAAM,WAAW,oBAAoB;IACnC;;;;OAIG;IACH,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC;;;;;;OAMG;IACH,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC;;;;;;;;;;OAUG;IACH,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,gBAAgB,CAAC;IACpD;;;;;;;;OAQG;IACH,iBAAiB,CACf,KAAK,EAAE,gBAAgB,EACvB,IAAI,EAAE,SAAS,YAAY,EAAE,EAC7B,WAAW,EAAE,SAAS,IAAI,EAAE,GAC3B,IAAI,CAAC;IACR;;;;OAIG;IACH,aAAa,IAAI,IAAI,CAAC;CACvB;AAED,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,SAAS,EACjB,cAAc,EAAE,MAAM,EACtB,gBAAgB,UAAO,GACtB,oBAAoB,CA4HtB"}
+{"version":3,"file":"skin-palette-allocator.d.ts","sourceRoot":"","sources":["../../src/systems/skin-palette-allocator.ts"],"names":[],"mappings":"AA6CA,OAAO,KAAK,EAAE,IAAI,EAAE,MAAM,sBAAsB,CAAC;AAEjD,OAAO,KAAK,EAAU,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAO7D,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AAmB7D,MAAM,WAAW,oBAAoB;IACnC;;;;OAIG;IACH,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC;;;;;;OAMG;IACH,QAAQ,CAAC,gBAAgB,EAAE,OAAO,CAAC;IACnC;;;;;;;;;;OAUG;IACH,aAAa,CAAC,UAAU,EAAE,MAAM,GAAG,gBAAgB,CAAC;IACpD,8DAA8D;IAC9D,gBAAgB,CAAC,GAAG,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,gBAAgB,CAAC;IACpE,sEAAsE;IACtE,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,qEAAqE;IACrE,eAAe,CAAC,IAAI,EAAE,WAAW,CAAC,MAAM,CAAC,GAAG,IAAI,CAAC;IACjD;;;;;;;;OAQG;IACH,iBAAiB,CACf,KAAK,EAAE,gBAAgB,EACvB,IAAI,EAAE,SAAS,YAAY,EAAE,EAC7B,WAAW,EAAE,SAAS,IAAI,EAAE,GAC3B,IAAI,CAAC;IACR;;;;OAIG;IACH,aAAa,IAAI,IAAI,CAAC;CACvB;AAED,wBAAgB,0BAA0B,CACxC,MAAM,EAAE,SAAS,EACjB,cAAc,EAAE,MAAM,EACtB,gBAAgB,UAAO,GACtB,oBAAoB,CAgPtB"}

package/dist/temporal/index.mjs

@@ -1,9 +1,9 @@
-export { addStandardSceneDataPass, addTaaResolvePass, aggregateTemporalDemand, createStandardSceneDataTarget, describeTemporalDemand, standardTemporalLaneAdmission, standardTemporalPostOrder } from '../chunk-YRUYGA4A.mjs';
+export { addStandardSceneDataPass, addTaaResolvePass, aggregateTemporalDemand, createStandardSceneDataTarget, describeTemporalDemand, standardTemporalLaneAdmission, standardTemporalPostOrder } from '../chunk-TMIASV2N.mjs';
 import '../chunk-RXZ3RGOU.mjs';
-export { SCENE_DATA_TEMPORAL_V1_DESCRIPTOR, SCENE_DATA_TEMPORAL_V1_SCHEMA, createSceneDataCatalog, isSceneDataTarget, registerSceneDataTarget, sceneDataError, sceneDataTargetAsAttachment, sceneDataTargetOwner, sceneDataTokenMismatch } from '../chunk-TFH5I7JJ.mjs';
-import '../chunk-YKB5DQV7.mjs';
+export { SCENE_DATA_TEMPORAL_V1_DESCRIPTOR, SCENE_DATA_TEMPORAL_V1_SCHEMA, createSceneDataCatalog, isSceneDataTarget, registerSceneDataTarget, sceneDataError, sceneDataTargetAsAttachment, sceneDataTargetOwner, sceneDataTokenMismatch } from '../chunk-E34VL5VI.mjs';
+import '../chunk-GF523LHF.mjs';
 export { TEMPORAL_JITTER_SAMPLE_COUNT, TemporalFrameCoordinator, classifySceneDataCoverage, createTemporalCoverage, projectTemporalView, scanSceneDataCoverage, snapshotSubmittedTemporalView, temporalJitterSample, temporalViewId } from '../chunk-GE3SDD72.mjs';
-import '../chunk-KZFTK6DO.mjs';
-import '../chunk-RR5L4SRS.mjs';
+import '../chunk-HKXTW355.mjs';
+import '../chunk-ZZ4YQ474.mjs';
 //# sourceMappingURL=index.mjs.map
 //# sourceMappingURL=index.mjs.map

package/package.json

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

package/src/__tests__/fixtures/ai-weapon-spirit/README.md

@@ -0,0 +1,20 @@
+# ai-weapon-spirit material regression fixture
+
+Frozen on 2026-09-09 from the consumer working tree, including its uncommitted
+0.1.25 migration. The WGSL files are verbatim copies, not approximations.
+Tests use this local closure and never read the consumer checkout.
+
+| Source file in ai-weapon-spirit | SHA-256 |
+|:--|:--|
+| `src/shaders/low-poly-toon.wgsl` | `ebdd63714683f2178a973d9392911bd0d5e607ad1df198a0c3b70f277c34b371` |
+| `src/shaders/includes/painterly-surface.wgsl` | `48573786f86c3b6be1d5231797ed77b2206c54563f83d8edc6f597575805f1bb` |
+
+The root parameter layout is the game's 11-field Toon contract (80 bytes).
+The fixture exercises its migrated same-module Forward + ShadowCaster path,
+and the intended Toon Forward + Engine ShadowCaster composition. Child values
+include emissionStrength=0, pigmentStrength=0, surfaceMetallic=0 and sideShade=0.84.
+A successful cook is only the compiler checkpoint: the runtime regression must
+also submit real WebGPU draws, inspect validation errors and prove shadow pixels.
+
+Source feedback: Engine Harness `2026-09-09-engine-025-material-contract-composition`,
+especially cases D (child scalar decoding) and E (shadow material bind group).

package/src/__tests__/fixtures/ai-weapon-spirit/low-poly-toon.wgsl

@@ -0,0 +1,178 @@
+#define_import_path ai_weapon_spirit::low_poly_toon
+
+#import forgeax_view::common::{view, meshes, instances, shadowCasterCascade}
+#import forgeax_pbr::lighting_directional::{evalDirectionalShadowFactor}
+#import ai_weapon_spirit::painterly_surface::{applyPigment, paintedSpecular, paintedRim}
+
+struct Material {
+  baseColor : vec4<f32>,
+  shadowColor : vec4<f32>,
+  rimColor : vec4<f32>,
+  rimStrength : f32,
+  specularStrength : f32,
+  emissionStrength : f32,
+  sideShade : f32,
+  surfaceRoughness : f32,
+  surfaceMetallic : f32,
+  pigmentStrength : f32,
+  pigmentScale : f32,
+};
+
+@group(1) @binding(0) var<uniform> material : Material;
+
+struct VsIn {
+  @location(0) pos : vec3<f32>,
+  @location(1) normal : vec3<f32>,
+};
+
+struct VsOut {
+  @builtin(position) clip : vec4<f32>,
+  @location(0) worldPos : vec3<f32>,
+  @location(1) worldNormal : vec3<f32>,
+  @location(2) viewZ : f32,
+  @location(3) paintPos : vec3<f32>,
+};
+
+@vertex
+fn vs_main(input : VsIn, @builtin(instance_index) idx : u32) -> VsOut {
+  // One path covers regular meshes (the renderer binds one identity instance)
+  // and explicit GPU Instances batches used by projectiles.
+  let model = meshes[0].worldFromLocal * instances[idx].localFromInstance;
+  let world = model * vec4<f32>(input.pos, 1.0);
+  var output : VsOut;
+  output.clip = view.worldViewProj * world;
+  output.worldPos = world.xyz;
+  output.paintPos = input.pos * vec3<f32>(length(model[0].xyz), length(model[1].xyz), length(model[2].xyz));
+  output.worldNormal = normalize((model * vec4<f32>(input.normal, 0.0)).xyz);
+  output.viewZ = -output.clip.w;
+  return output;
+}
+
+@fragment
+fn fs_main(input : VsOut, @builtin(front_facing) frontFacing : bool) -> @location(0) vec4<f32> {
+  // PCG crowd meshes share the eight geometric cube corners instead of
+  // duplicating four vertices per face. Reconstructing the face normal from
+  // world-space derivatives preserves exact hard Low Poly planes while
+  // reducing full-stage stress vertex traffic by roughly three times.
+  // WebGPU framebuffer Y grows downward, so dy × dx produces the outward
+  // normal for the front-facing triangle winding used by ForgeAX meshes.
+  var normal = normalize(cross(dpdy(input.worldPos), dpdx(input.worldPos)));
+  if (!frontFacing) {
+    normal = -normal;
+  }
+  let toLight = normalize(vec3<f32>(0.46, 1.0, 0.32));
+  let toCamera = normalize(view.cameraPos - input.worldPos);
+  let nDotL = dot(normal, toLight);
+  let upFacing = dot(normal, vec3<f32>(0.0, 1.0, 0.0));
+  let paintNormal = normalize(cross(dpdy(input.paintPos), dpdx(input.paintPos)));
+  let surfaceColor = applyPigment(material.baseColor.rgb, input.paintPos, paintNormal, material.pigmentScale, material.pigmentStrength);
+
+  // Three broad light bands keep the blocks graphic instead of plastic.
+  var lightBand = 0.16;
+  if (nDotL > 0.08) {
+    lightBand = 0.58;
+  }
+  if (nDotL > 0.68) {
+    lightBand = 1.0;
+  }
+  var color = mix(material.shadowColor.rgb, surfaceColor, lightBand);
+
+  // Preserve native PCF and cascade blending. Thresholding BRDF radiance
+  // makes shadow edges depend on view direction and amplifies small changes.
+  // Toon bands stay authored here, with a readable cool ambient floor.
+  let shadowVisibility = evalDirectionalShadowFactor(normal, input.worldPos, input.viewZ);
+  if (nDotL > 0.08) {
+    color *= mix(0.46, 1.0, shadowVisibility);
+  }
+
+  // Top planes carry the clean local color; sides become the darker cut face.
+  var planeShade = material.sideShade;
+  if (upFacing > 0.72) {
+    planeShade = 1.0;
+  }
+  if (upFacing < -0.72) {
+    planeShade = material.sideShade * 0.72;
+  }
+  color *= planeShade;
+
+  color += paintedSpecular(surfaceColor, normal, toLight, toCamera, material.surfaceRoughness,
+    material.surfaceMetallic, material.specularStrength, shadowVisibility);
+  let rim = paintedRim(normal, toCamera, material.surfaceRoughness, material.rimStrength, shadowVisibility);
+  color += material.rimColor.rgb * rim;
+  color += material.rimColor.rgb * material.emissionStrength;
+
+  return vec4<f32>(color, material.baseColor.a);
+}
+
+// Isolated candidate entry for the readability preview. Production
+// materials continue to use fs_main; this variant only tests a coloured
+// ambient floor and a restrained Fresnel lift before the values are approved.
+@fragment
+fn fs_readability_candidate(input : VsOut, @builtin(front_facing) frontFacing : bool) -> @location(0) vec4<f32> {
+  var normal = normalize(cross(dpdy(input.worldPos), dpdx(input.worldPos)));
+  if (!frontFacing) {
+    normal = -normal;
+  }
+
+  let toLight = normalize(vec3<f32>(0.46, 1.0, 0.32));
+  let toCamera = normalize(view.cameraPos - input.worldPos);
+  let nDotL = dot(normal, toLight);
+  let upFacing = dot(normal, vec3<f32>(0.0, 1.0, 0.0));
+  let paintNormal = normalize(cross(dpdy(input.paintPos), dpdx(input.paintPos)));
+  let surfaceColor = applyPigment(material.baseColor.rgb, input.paintPos, paintNormal, material.pigmentScale, material.pigmentStrength);
+
+  var lightBand = 0.24;
+  if (nDotL > -0.22) {
+    lightBand = 0.43;
+  }
+  if (nDotL > 0.08) {
+    lightBand = 0.70;
+  }
+  if (nDotL > 0.68) {
+    lightBand = 1.0;
+  }
+  var color = mix(material.shadowColor.rgb, surfaceColor, lightBand);
+
+  let shadowVisibility = evalDirectionalShadowFactor(normal, input.worldPos, input.viewZ);
+  if (nDotL > 0.08) {
+    // Move occluded faces toward their authored hue without multiplying the
+    // already-dark result toward black a second time.
+    let retainedLight = mix(0.48, 1.0, shadowVisibility);
+    color = mix(material.shadowColor.rgb, color, retainedLight);
+  }
+
+  var planeShade = material.sideShade;
+  if (upFacing > 0.72) {
+    planeShade = 1.0;
+  }
+  if (upFacing < -0.72) {
+    planeShade = material.sideShade * 0.86;
+  }
+  color *= planeShade;
+
+  color += paintedSpecular(surfaceColor, normal, toLight, toCamera, material.surfaceRoughness,
+    material.surfaceMetallic, material.specularStrength, shadowVisibility);
+  let rim = paintedRim(normal, toCamera, material.surfaceRoughness, material.rimStrength, shadowVisibility);
+  color += material.rimColor.rgb * rim;
+  color += material.rimColor.rgb * material.emissionStrength;
+
+  return vec4<f32>(color, material.baseColor.a);
+}
+
+// Opaque Toon depth entry shares this material's composed module and layout.
+@vertex
+fn vs_shadow(@location(0) position : vec3<f32>, @builtin(instance_index) idx : u32) -> @builtin(position) vec4<f32> {
+  let world = meshes[0].worldFromLocal * instances[idx].localFromInstance * vec4<f32>(position, 1.0);
+  if (shadowCasterCascade.isSpot == 1u) {
+    return shadowCasterCascade.spotLightViewProj * world;
+  }
+  switch (shadowCasterCascade.index) {
+    case 0u: { return view.lightViewProj_A * world; }
+    case 1u: { return view.lightViewProj_B * world; }
+    case 2u: { return view.lightViewProj_C * world; }
+    default: { return view.lightViewProj_D * world; }
+  }
+}
+
+@fragment
+fn fs_shadow() {}

package/src/__tests__/fixtures/ai-weapon-spirit/material.json

@@ -0,0 +1,97 @@
+{
+  "kind": "material",
+  "colorSpace": "srgb",
+  "parameters": [
+    {
+      "name": "baseColor",
+      "type": "color",
+      "default": [1, 1, 1, 1]
+    },
+    {
+      "name": "shadowColor",
+      "type": "color",
+      "default": [0.34, 0.43, 0.56, 1]
+    },
+    {
+      "name": "rimColor",
+      "type": "color",
+      "default": [0.72, 0.88, 0.84, 1]
+    },
+    {
+      "name": "rimStrength",
+      "type": "f32",
+      "default": 0.018
+    },
+    {
+      "name": "specularStrength",
+      "type": "f32",
+      "default": 0.008
+    },
+    {
+      "name": "emissionStrength",
+      "type": "f32",
+      "default": 0
+    },
+    {
+      "name": "sideShade",
+      "type": "f32",
+      "default": 0.84
+    },
+    {
+      "name": "surfaceRoughness",
+      "type": "f32",
+      "default": 0.86
+    },
+    {
+      "name": "surfaceMetallic",
+      "type": "f32",
+      "default": 0
+    },
+    {
+      "name": "pigmentStrength",
+      "type": "f32",
+      "default": 0.08
+    },
+    {
+      "name": "pigmentScale",
+      "type": "f32",
+      "default": 3.2
+    }
+  ],
+  "passes": [
+    {
+      "name": "Forward",
+      "program": {
+        "module": "ai_weapon_spirit::low_poly_toon",
+        "vertexEntry": "vs_main",
+        "fragmentEntry": "fs_main"
+      },
+      "renderState": {
+        "tags": {
+          "LightMode": "Forward"
+        },
+        "queue": 2000
+      }
+    },
+    {
+      "name": "ShadowCaster",
+      "program": {
+        "module": "ai_weapon_spirit::low_poly_toon",
+        "vertexEntry": "vs_shadow",
+        "fragmentEntry": "fs_shadow"
+      },
+      "renderState": {
+        "tags": {
+          "LightMode": "ShadowCaster"
+        }
+      }
+    }
+  ],
+  "values": {
+    "baseColor": [0.4, 0.65, 0.55, 1],
+    "emissionStrength": 0,
+    "pigmentStrength": 0,
+    "surfaceMetallic": 0,
+    "sideShade": 0.84
+  }
+}

package/src/__tests__/fixtures/ai-weapon-spirit/painterly-surface.wgsl

@@ -0,0 +1,55 @@
+#define_import_path ai_weapon_spirit::painterly_surface
+
+fn pigmentHash(point : vec2<f32>) -> f32 {
+  var p = fract(vec3<f32>(point.x, point.y, point.x) * .1031);
+  p += vec3<f32>(dot(p, p.yzx + vec3<f32>(33.33)));
+  return fract((p.x + p.y) * p.z);
+}
+
+fn pigmentNoise(point : vec2<f32>) -> f32 {
+  let cell = floor(point);
+  let f = fract(point);
+  let u = f * f * (vec2<f32>(3.0) - 2.0 * f);
+  return mix(mix(pigmentHash(cell), pigmentHash(cell + vec2<f32>(1.0, 0.0)), u.x),
+    mix(pigmentHash(cell + vec2<f32>(0.0, 1.0)), pigmentHash(cell + vec2<f32>(1.0, 1.0)), u.x), u.y);
+}
+
+fn pigmentPlane(position : vec3<f32>, normal : vec3<f32>) -> vec2<f32> {
+  let axis = abs(normal);
+  if (axis.y >= max(axis.x, axis.z)) { return position.xz; }
+  if (axis.x > axis.z) { return position.zy; }
+  return position.xy;
+}
+
+// Soft pigment pools, with no repeated stroke or bristle shapes. Rotate and
+// gently warp the field so its broad transitions do not reveal the noise grid.
+// Units are metres: moving actors use local coordinates, fixed terrain world coordinates.
+fn applyPigment(base : vec3<f32>, position : vec3<f32>, normal : vec3<f32>, scale : f32, strength : f32) -> vec3<f32> {
+  let plane = pigmentPlane(position, normal) * scale;
+  let point = vec2<f32>(plane.x * .8 + plane.y * .6, plane.y * .8 - plane.x * .6);
+  let drift = vec2<f32>(
+    pigmentNoise(point * .11 + vec2<f32>(5.2, 11.7)),
+    pigmentNoise(point * .11 + vec2<f32>(19.3, -4.6)),
+  ) - vec2<f32>(.5);
+  let field = point * .18 + drift * .65;
+  let wash = pigmentNoise(field + vec2<f32>(3.2, 8.1)) - .5;
+  let bloom = pigmentNoise(field * .47 + vec2<f32>(-7.4, 2.9)) - .5;
+  let pigment = (wash * .72 + bloom * .28) * strength;
+  // Pigment changes local reflectance; it never emits light or changes normals.
+  return max(vec3<f32>(0.0), base * (1.0 + pigment) + vec3<f32>(.08, .02, -.055) * pigment);
+}
+
+fn paintedSpecular(base : vec3<f32>, normal : vec3<f32>, light : vec3<f32>, camera : vec3<f32>,
+  roughness : f32, metallic : f32, strength : f32, visibility : f32) -> vec3<f32> {
+  let halfVector = normalize(light + camera);
+  let smoothness = 1.0 - clamp(roughness, .04, 1.0);
+  let lobe = pow(max(dot(normal, halfVector), 0.0), mix(12.0, 112.0, smoothness));
+  let reflection = strength * smoothness * smoothness * lobe
+    * max(dot(normal, light), 0.0) * visibility;
+  return mix(vec3<f32>(.88, .86, .81), base, metallic) * reflection;
+}
+
+fn paintedRim(normal : vec3<f32>, camera : vec3<f32>, roughness : f32, strength : f32, visibility : f32) -> f32 {
+  let fresnel = pow(1.0 - clamp(dot(normal, camera), 0.0, 1.0), 4.0);
+  return fresnel * strength * mix(1.0, .18, roughness) * mix(.35, 1.0, visibility);
+}

package/src/__tests__/gpu-driven-view-gpu-evidence.ts

@@ -61,7 +61,9 @@ export interface GpuDrivenViewLifecycleEvidence {
   readonly candidateCapacity: number;
 }
 
-export async function runGpuDrivenViewLifecycleEvidence(): Promise<GpuDrivenViewLifecycleEvidence> {
+export async function runGpuDrivenViewLifecycleEvidence(
+  frames = 300,
+): Promise<GpuDrivenViewLifecycleEvidence> {
   const adapter = (await rhi.requestAdapter()).unwrap();
   const device = (await adapter.requestDevice()).unwrap();
   const rawDevice = _internal_getRawDevice(device);
@@ -85,8 +87,6 @@ export async function runGpuDrivenViewLifecycleEvidence(): Promise<GpuDrivenView
   const retirements: Array<Promise<unknown>> = [];
   let activeCount = 0;
   let previous: CompiledRenderGraph<{ readonly encoder: RhiCommandEncoder }> | undefined;
-  const frames = 300;
-
   for (let frame = 0; frame < frames; frame += 1) {
     const targetCount = frame < 4 ? 2 ** frame : frame % 2 === 0 ? 1 : 8;
     const operations: Array<

package/src/__tests__/gpu-driven-view.browser.test.ts

@@ -5,6 +5,14 @@ import {
 } from './gpu-driven-view-gpu-evidence';
 
 const browserReady = typeof navigator !== 'undefined' && navigator.gpu !== undefined;
+const lifecycleFrames =
+  (
+    import.meta as ImportMeta & {
+      readonly env?: { readonly FORGEAX_BROWSER_CI_LIGHTWEIGHT?: string };
+    }
+  ).env?.FORGEAX_BROWSER_CI_LIGHTWEIGHT === '1'
+    ? 60
+    : 300;
 
 describe.skipIf(!browserReady)('GPU-driven View Browser WebGPU', () => {
   it('produces compact visible IDs and portable indirect args on the real browser device', async () => {
@@ -20,9 +28,9 @@ describe.skipIf(!browserReady)('GPU-driven View Browser WebGPU', () => {
     });
   });
 
-  it('survives 300 frames of spawn/despawn capacity crossings without stale buffers', async () => {
-    await expect(runGpuDrivenViewLifecycleEvidence()).resolves.toEqual({
-      frames: 300,
+  it(`survives ${lifecycleFrames} frames of spawn/despawn capacity crossings without stale buffers`, async () => {
+    await expect(runGpuDrivenViewLifecycleEvidence(lifecycleFrames)).resolves.toEqual({
+      frames: lifecycleFrames,
       bufferRebuilds: 4,
       candidateCapacity: 8,
     });

package/src/__tests__/gpu-scene.unit.test.ts

@@ -120,9 +120,17 @@ describe('GpuScene', () => {
     expect(created.scene.inspect().uploadBytes).toBe(bytesBefore);
 
     created.scene.commitTemporalFrame(true).unwrap();
-    expect(queue.writes).toHaveLength(writesBefore + 1);
+    expect(queue.writes).toHaveLength(writesBefore);
+    expect(created.scene.inspect().uploadBytes).toBe(bytesBefore);
+
+    const dirty = projection.apply([
+      { kind: 'update-transform', worldId: 0, entityKey: 0, world: snapshot(0, 3).transform.world },
+    ]);
+    created.scene.sync(dirty).unwrap();
+    created.scene.commitTemporalFrame(true).unwrap();
+    expect(queue.writes).toHaveLength(writesBefore + 2);
     expect(created.scene.inspect().uploadBytes).toBe(
-      bytesBefore + created.scene.inspect().tables.transform.bytes,
+      bytesBefore + 2 * GPU_SCENE_LAYOUTS.transform.stride,
     );
   });
 
@@ -200,4 +208,32 @@ describe('GpuScene', () => {
       gpuSceneFieldOffset(GPU_SCENE_LAYOUTS.transform, 'previousWorld') + 12 * 4;
     expect(new DataView(transformWrite.bytes.buffer).getFloat32(previousTranslation, true)).toBe(9);
   });
+
+  it('keeps a recycled slot allocated for the replacement identity', () => {
+    const queue = new RecordingQueue();
+    const created = GpuScene.create(createDevice(queue), 1).unwrap();
+    if (created.status !== 'available') return;
+    const projection = new RenderScene();
+    created.scene.sync(projection.apply([{ kind: 'create', snapshot: snapshot(1, 2) }])).unwrap();
+
+    const recycled = projection.apply([
+      { kind: 'remove', worldId: 0, entityKey: 1 },
+      { kind: 'create', snapshot: snapshot(2, 7) },
+    ]);
+    expect(recycled.removedSlots[0]?.slot).toBe(recycled.createdSlots[0]?.slot);
+    created.scene.sync(recycled).unwrap();
+
+    expect(() =>
+      created.scene.sync(
+        projection.apply([
+          {
+            kind: 'update-transform',
+            worldId: 0,
+            entityKey: 2,
+            world: snapshot(2, 11).transform.world,
+          },
+        ]),
+      ),
+    ).not.toThrow();
+  });
 });