feat: cursor-steered headlights light the hero name, plates and world

src/scene/world/environment.ts

@@ -32,6 +32,7 @@ import {
   type MutableChapterPalette,
 } from '@/scene/world/palette';
 import { createMaintenanceWindow } from '@/scene/world/maintenance-window';
+import { createHeadlights } from '@/scene/world/headlights';
 import { maintenanceProgress } from '@/journey/maintenance-progress';
 import { isTestFault, recordTestFaultEvent } from '@/testing/fault-hooks';
 
@@ -145,6 +146,13 @@ export async function createProceduralSceneGeneration(
     maximumTextureSize: renderer.capabilities.maxTextureSize,
   });
   const atmosphere = createAtmosphere(context.resources, quality);
+  // HIGH BEAM: the cursor steers the headlights (road cones on every tier).
+  const headlights = createHeadlights(
+    context.resources,
+    context.quality,
+    // A THREE.Group at runtime; CarGroup only types what car.ts uses.
+    car.group as unknown as Parameters<typeof createHeadlights>[2],
+  );
   // The 03:12 window. Phones, coarse pointers and the low tier keep only the
   // power-down, the re-light and the palette nudge: no rain, packets or lightning.
   const maintenance = createMaintenanceWindow(context.resources);
@@ -168,6 +176,7 @@ export async function createProceduralSceneGeneration(
     speedWake.group,
     sign.group,
     sign.truss,
+    ...headlights.lights,
   );
 
   const postProcessor = quality.postEffects
@@ -612,6 +621,8 @@ export async function createProceduralSceneGeneration(
         camera.fov = lensFov;
         camera.updateProjectionMatrix();
       }
+      const beam = headlights.update(snapshot.beam, snapshot, camera, 1 - engineOff, deltaSeconds);
+      road.setBeam(beam.yaw, beam.lift);
       const stage = signStage.update(width, height);
       sign.compose(camera, width, height, stage.dock, now, stage.tilt);
       const gantry = sign.dockState();