config+docs: sun/moon/camera/day blocks, moon map attribution and cache manifest

config.js

@@ -155,6 +155,32 @@ window.CONFIG = {
         // density: { sunny: 0.05, cloudy: 0.9, stormy: 1.0, night: 0.2 }
     },
 
+    // ------------------------------------------------------------------
+    // Moon
+    // ------------------------------------------------------------------
+    // The disc is drawn artistically larger than the real one (0.0046 rad
+    // = 0.26 deg, about 9 px at 1080p) so that the surface texture and the
+    // phase are actually readable. The terminator itself stays geometric:
+    // lit side = surface normal dot sun direction.
+    // The map is sampled in a selenographic frame built from the north
+    // celestial pole, so the disc shows north up and east to the right -
+    // like a printed lunar map - and rotates as the moon crosses the sky.
+    moon: {
+        angularRadius: 0.0552,     // 12x the physical 0.0046 rad
+        texture: 'vendor/moon.jpg', // equirectangular near-side map
+        // Scene moonlight (terrain, aircraft, contrails, airlight) is
+        // scaled with the disc, but only half of the excess over the
+        // physical size counts: 1 + 0.5 * (angularRadius/0.0046 - 1) = 6.5.
+        // Set 1.0 for the strictly physical night brightness.
+        lightGain: 6.5,
+        earthshine: 0.10,          // faint light on the dark side
+        limbDarkening: 0.30,       // surface dims towards the limb
+        brightness: 2.20,          // per-pixel luminance of the disc
+        halo: 1.0,                 // glow around the disc, scales with phase
+        flipU: false,              // mirror the map if orientation is wrong
+        flipV: false
+    },
+
     // ------------------------------------------------------------------
     // Civil aviation
     // ------------------------------------------------------------------
@@ -308,18 +334,44 @@ window.CONFIG = {
     },
 
     // ------------------------------------------------------------------
-    // Day cycle
+    // Sun
     // ------------------------------------------------------------------
-    // simulation: true runs a full 24 h cycle in cycleSeconds (sun rises
-    // east, culminates south, sets west) and the clock plus the sun/moon
-    // tables follow the simulated date. false uses the real SunCalc positions.
+    // The real sun is 0.00465 rad (0.27 deg). Like the moon, the disc is
+    // drawn larger so it reads as a disc; the surface brightness and the
+    // scene lighting are NOT scaled with it.
+    sun: {
+        angularRadius: 0.0558     // 12x the physical 0.00465 rad
+    },
+
+    // ------------------------------------------------------------------
+    // Camera
+    // ------------------------------------------------------------------
+    // The camera always flies the configured path (figure eight or straight
+    // drift); 'aim' changes only where it LOOKS. 'moon' turns the view to
+    // the moon - heading to its azimuth, pitch to its altitude - while the
+    // flight path, the fetch corridor and the traffic stay as they are.
+    // Below the horizon the view holds the moon's azimuth at the horizon.
+    camera: {
+        aim: 'off',               // 'off' | 'moon'
+        aimEase: 0.94,            // 0 = instant turn, 0.99 = very slow
+        aimBob: 0.25              // share of the altitude bob kept while aiming
+        // camera: { aim: 'moon' }                         // look at the moon
+    },
+
+    // ------------------------------------------------------------------
+    // Clock
+    // ------------------------------------------------------------------
+    // Sun and moon are always the real ones (SunCalc ephemeris) - this block
+    // only moves the clock that the astronomy is evaluated at. startAt picks
+    // the moment the scene begins at, speed advances it from there: 1 = real
+    // time, 1440 = one simulated day per minute. Clock hands, digital readout,
+    // weather and sky all use the same clock. Hash overrides: #at=... #speed=...
     day: {
-        simulation: false,        // false = the real sun and moon (default)
-        cycleSeconds: 60,         // only used when simulation is true:
-                                  // 60 s = one simulated day per minute
-        fixedTime: null           // 'HH:MM' or 0-24 freezes the sim clock
-                                  // (clouds, traffic and flights keep moving)
-        // day: { simulation: true, cycleSeconds: 60 }   // accelerated day
+        startAt: null,            // null = strictly real time
+        speed: 1                  // virtual seconds per real second
+        // day: { startAt: '2026-10-29T20:56', speed: 1 }    // start at a chosen
+        //                                                   // moment, real pace
+        // day: { startAt: '2026-10-29T20:56', speed: 1440 } // accelerated
     },
 
     // ------------------------------------------------------------------