mapspinner 0.1.52 → 0.1.54

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mapspinner",
-  "version": "0.1.52",
+  "version": "0.1.54",
   "description": "WebGL2 Earth-scale terrain rendering SDK for interactive globe applications",
   "main": "src/index.js",
   "exports": {

package/src/gl-render.js

@@ -1115,11 +1115,11 @@ export async function initMapspinnerRender(gl, opts = {}) {
       // shows. Cap every visible leaf at level WCAP and DEDUP to its ancestor tile: a coarse,
       // LOD-churn-free cover of the same footprint, typically ~10-50x fewer water vertices.
       // __waterSurface=0 disables live.
-      // UNDERWATER: skip the sea-level water surface entirely (user 2026-06-14 'underwater looks weird,
-      // we cant see anything / it must draw the sea bed'). The surface mesh drawn from below was an
-      // opaque sheet that occluded the seabed; with it gone, the underwater camera sees the seabed
-      // terrain directly (with the underwater fog). Above water it draws normally.
-      if ((typeof window === 'undefined' || window.__waterSurface !== false) && !_uw) {
+      // The water surface draws in BOTH cases now (user 2026-06-14 'no water surface visible from
+      // underneath'): it's geometrically ABOVE the camera, so underwater it is the up-view CEILING
+      // (Snell's window, shaded in the uUnderwater branch) and the seabed below stays visible (the
+      // down-view ray never hits the surface). With the fog 10x lighter it no longer washes the floor.
+      if (typeof window === 'undefined' || window.__waterSurface !== false) {
         // WCAP 7 -> 9 (coast witness caught it: a level-7 tile's 16-cell mesh chord sags
         // A_cell^2/(8R) ~ 0.8m below the true sphere mid-cell -- BELOW the metres-deep shelf
         // seabed, so the depth test culled the water across entire shorelines. Level-9 cells

package/src/shaders/terrain.glsl

@@ -1560,6 +1560,16 @@ void main() {
             vec3 deepBlue = vec3(0.005, 0.06, 0.18);
             vec3 waveBright = vec3(0.0, 0.02, 0.06) * length(slopeW);
             vec3 wcol = deepBlue + sunUnder * 0.4 + waveBright;
+            // SNELL'S WINDOW (user 2026-06-14 'no water surface visible from underneath'): looking UP, the
+            // surface is a bright window to the sky within the critical angle (near-vertical view) and a
+            // dark total-internal-reflection mirror at grazing angles. upness = how vertical the view->
+            // surface ray is; brighten toward the refracted sky + a sun disc inside the window.
+            float upness = abs(dot(viewW, wn));
+            float snell = smoothstep(0.50, 0.82, upness);
+            vec3 skyWindow = vec3(0.40, 0.60, 0.85) * (0.5 + 0.9 * ndl);
+            wcol = mix(wcol, skyWindow, snell * 0.85);
+            float sunw = pow(max(dot(viewW, sunDir), 0.0), 180.0);   // sun seen through the window
+            wcol += vec3(1.0, 0.92, 0.70) * sunw * (0.4 + 0.6 * snell);
             float macroMuW = dot(uz, sunDir);
             float dayShadeW = mix(uNightFloor, 1.0, smoothstep(-uTermWidth, uTermWidth, macroMuW));
             vec3 cW = wcol * dayShadeW * uExposure;
@@ -2179,10 +2189,22 @@ void main() {
         // under the ocean'): the old absorb (4,0.8,0.3)/km + a 50->500m hard fog fade closed the view to
         // opaque blue within ~500m. Lower the coefficients (still red-first absorption) and push the hard
         // fade to ~3-15km so the seabed landscape is explorable; red still fades fast (realistic blue cast).
-        vec3 absorb = vec3(1.0, 0.30, 0.15) * (1.0 + depth * 0.0002);
+        // MUCH CLEARER (user 2026-06-14 'we cant see the ocean floor properly'): the deep-ocean floor is
+        // km below, so even 'clear' (1.0/0.30/0.15) water + a 3-15km fade hid it. Drop the coefficients
+        // hard and push the fade to ~10-50km so the ocean FLOOR reads as terrain from a long way off
+        // (game-clarity over physical realism; red still absorbs first for a natural blue-green cast).
+        // FOG 10x LESS (user 2026-06-14 'make the fog 10x less / doesnt look right under the water'):
+        // extinction /10 and the hard fade pushed 10x out so the ocean floor reads clearly from a long
+        // way off with only a faint blue tint, not a wash of fog.
+        vec3 absorb = vec3(0.035, 0.010, 0.005) * (1.0 + depth * 0.0001);
         vec3 uwTrans = exp(-absorb * dKm);
-        vec3 uwFog = vec3(0.004, 0.10, 0.22) + vec3(0.0, 0.02, 0.04) * depth / 1000.0;
-        color = mix(color * uwTrans + uwFog * (1.0 - uwTrans), uwFog, smoothstep(3000.0, 15000.0, dKm * 1000.0));
+        vec3 uwFog = vec3(0.004, 0.09, 0.18) + vec3(0.0, 0.015, 0.03) * depth / 1000.0;
+        // SEABED LIGHTING (user 'floor too flat/dim'): the deep floor gets almost no direct sun, so it
+        // read dim+flat. Lift the brightness and add an up-facing fill (brighter where the surface faces
+        // up, darker on slopes -> 3D relief) + a touch of slope contrast keyed on the lit normal vNrm.
+        float upFill = mix(0.75, 1.35, clamp(dot(vNrm, normalize(vWorld)) * 0.5 + 0.5, 0.0, 1.0));
+        color *= upFill * 1.5;
+        color = mix(color * uwTrans + uwFog * (1.0 - uwTrans), uwFog, smoothstep(100000.0, 500000.0, dKm * 1000.0));
     }
     // RIVERS post-lighting (witnessed browser-2115/2118: the river-blue in ALBEDO is multiplied
     // by the warm sun irradiance (sunIrr.b is low) so land rivers lose their blue in the lit