PROCITY/web/js/world/lighting.js

// PROCITY Lane B — lighting.js
// Sky dome (seeded sky-*.jpg on a BackSide sphere) + a 6-segment day/night cycle ported from
// 90sDJsim's applyLighting: one hemisphere ambient + one directional sun (single shadow map that
// follows the player) + a night flag that drives window/lamp emissives (via a callback into the
// ChunkManager). Linear fog tuned to the streaming radius doubles as the pop-in mask.
//
// Global, not chunked. The sky dome and sun re-centre on the player each frame so the world
// never runs out from under you.

import * as THREE from 'three';

// [name, sunI, sunColor, hemiSky, hemiGround, hemiI, skyTint, fogColor, exposure, night, sunOffset]
const SEG = [
  ['DAWN',    0.75, 0xffd9b0, 0xbcd0e8, 0x8a7a60, 0.75, 0xdcdce8, 0xcfc6ba, 1.05, false, [80, 26, 14]],
  ['MORNING', 1.20, 0xffe8c8, 0xcfe0f2, 0x9a8a6c, 0.95, 0xffffff, 0xd6d6cc, 1.00, false, [50, 46, 22]],
  ['MIDDAY',  1.55, 0xffffff, 0xd8e8ff, 0xa89878, 1.10, 0xffffff, 0xe0e2da, 0.98, false, [12, 72, 12]],
  ['ARVO',    1.15, 0xffdca0, 0xc8d4e8, 0xa08858, 1.00, 0xf2e8d8, 0xe0cdb0, 1.02, false, [-42, 46, 20]],
  ['DUSK',    0.55, 0xff9860, 0x9a86b0, 0x6a4a3a, 0.72, 0xb89a8a, 0xa07860, 1.10, false, [-74, 16, 10]],
  ['NIGHT',   0.10, 0x8faaff, 0x2a3050, 0x14100c, 0.38, 0x1b2038, 0x0a0c18, 1.18, true,  [-40, 66, 22]],
];
const HOUR = ['06:30', '09:00', '12:30', '15:30', '18:30', '22:00'];

export function createLighting(scene, plan, skins, { radius = 3, shadows = true } = {}) {
  const group = new THREE.Group();
  group.name = 'lighting';
  scene.add(group);

  // sky dome — seeded photo skin, darkened at night via material colour
  const skyName = plan.sky || 'golden-arvo';
  const skyMat = new THREE.MeshBasicMaterial({ color: 0xffffff, side: THREE.BackSide, depthWrite: false, fog: false });
  skins.skyTex(skyName, (t) => { skyMat.map = t; skyMat.needsUpdate = true; });
  const dome = new THREE.Mesh(new THREE.SphereGeometry(650, 24, 14), skyMat);
  group.add(dome);

  const hemi = new THREE.HemisphereLight(0xd8e8ff, 0xa89878, 1.0);
  group.add(hemi);
  const sun = new THREE.DirectionalLight(0xffffff, 1.4);
  sun.castShadow = shadows;   // dense cities skip the shadow pass (≈halves draw calls; doc allows "none")
  sun.shadow.mapSize.set(2048, 2048);
  sun.shadow.bias = -0.0004;
  const SH = 60; // half-extent of the shadow frustum around the player
  Object.assign(sun.shadow.camera, { left: -SH, right: SH, top: SH, bottom: -SH, near: 1, far: 260 });
  sun.shadow.camera.updateProjectionMatrix();
  group.add(sun, sun.target);

  // fog fades distant chunks out just before the streaming radius, hiding pop-in
  const fog = new THREE.Fog(0xd6d6cc, 40, (radius + 0.4) * 64);
  scene.fog = fog;

  const _skyTint = new THREE.Color();
  const _fogTint = new THREE.Color();
  let seg = 2, night = false;
  let clock = seg + 0.001, paused = false;
  const DAY_SECONDS = 240; // one full cycle
  let onNightChange = null;
  let renderer = null;

  function apply(i) {
    const [, sunI, sunC, hSky, hGnd, hI, skyTint, fogC, exposure, isNight] = SEG[i];
    sun.intensity = sunI; sun.color.set(sunC);
    hemi.intensity = hI; hemi.color.set(hSky); hemi.groundColor.set(hGnd);
    _skyTint.set(skyTint); skyMat.color.copy(_skyTint);
    _fogTint.set(fogC); fog.color.copy(_fogTint);
    scene.background = _fogTint.clone(); // horizon colour behind the (finite) dome
    if (renderer) renderer.toneMappingExposure = exposure;
    const was = night; night = isNight; seg = i;
    if (isNight !== was && onNightChange) onNightChange(isNight);
  }

  function setSegment(i) { clock = ((i % SEG.length) + SEG.length) % SEG.length + 0.001; apply(i); }
  function stepSegment(d) { setSegment((seg + d + SEG.length) % SEG.length); }

  const _sunOff = new THREE.Vector3();
  function update(dt, playerPos) {
    if (!paused) {
      clock = (clock + (dt / DAY_SECONDS) * SEG.length) % SEG.length;
      const i = Math.floor(clock);
      if (i !== seg) apply(i);
    }
    // re-centre dome + sun on the player
    dome.position.copy(playerPos);
    const off = SEG[seg][10];
    _sunOff.set(off[0], off[1], off[2]).multiplyScalar(0.8);
    sun.position.copy(playerPos).add(_sunOff);
    sun.target.position.copy(playerPos);
    sun.target.updateMatrixWorld();
  }

  function getClock() {
    const frac = clock - Math.floor(clock);
    return { seg, label: SEG[seg][0], hour: HOUR[seg], night, frac };
  }

  function attachRenderer(r) { renderer = r; r.toneMappingExposure = SEG[seg][8]; }

  function dispose() {
    scene.fog = null;
    dome.geometry.dispose(); skyMat.dispose();
    scene.remove(group);
  }

  apply(seg);
  return {
    group, sun, hemi,
    update, setSegment, stepSegment, getClock, attachRenderer, dispose,
    setPaused: (p) => { paused = p; },
    togglePaused: () => (paused = !paused),
    isNight: () => night,
    get segCount() { return SEG.length; },
    set onNightChange(fn) { onNightChange = fn; },
    get onNightChange() { return onNightChange; },
  };
}