mapspinner 0.1.41 → 0.1.43

package/bash.exe.stackdump

@@ -0,0 +1,28 @@
+Stack trace:
+Frame         Function      Args
+0007FFFFA9C0  00021005FEBA (000210285F48, 00021026AB6E, 000000000000, 0007FFFF98C0) msys-2.0.dll+0x1FEBA
+0007FFFFA9C0  0002100467F9 (000000000000, 000000000000, 000000000000, 0007FFFFAC98) msys-2.0.dll+0x67F9
+0007FFFFA9C0  000210046832 (000210285FF9, 0007FFFFA878, 000000000000, 000000000000) msys-2.0.dll+0x6832
+0007FFFFA9C0  000210068F86 (000000000000, 000000000000, 000000000000, 000000000000) msys-2.0.dll+0x28F86
+0007FFFFA9C0  0002100690B4 (0007FFFFA9D0, 000000000000, 000000000000, 000000000000) msys-2.0.dll+0x290B4
+0007FFFFACA0  00021006A49D (0007FFFFA9D0, 000000000000, 000000000000, 000000000000) msys-2.0.dll+0x2A49D
+End of stack trace
+Loaded modules:
+000100400000 bash.exe
+7FFFAD120000 ntdll.dll
+7FFFABF70000 KERNEL32.DLL
+7FFFAAA90000 KERNELBASE.dll
+7FFFAC040000 USER32.dll
+000210040000 msys-2.0.dll
+7FFFAA440000 win32u.dll
+7FFFAC210000 GDI32.dll
+7FFFAA6B0000 gdi32full.dll
+7FFFAA9E0000 msvcp_win.dll
+7FFFAA7E0000 ucrtbase.dll
+7FFFABA60000 advapi32.dll
+7FFFAAF30000 msvcrt.dll
+7FFFAB070000 sechost.dll
+7FFFAC240000 RPCRT4.dll
+7FFFA9990000 CRYPTBASE.DLL
+7FFFAA930000 bcryptPrimitives.dll
+7FFFAC710000 IMM32.DLL

package/package.json

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

package/src/gl-render.js

@@ -655,8 +655,12 @@ export async function initMapspinnerRender(gl, opts = {}) {
       // The analytic single-scatter radiance is HDR with small magnitudes; lift then
       // ACES tonemap (matches the WebGPU sky pass family). EXPOSURE tuned so the limb
       // glow + daylit sky read as an atmosphere without blowing out.
-      vec3 c = radiance * 120.0;
+      vec3 c = radiance * 105.0;   // 120->105: trim exposure so the bright daytime sky stops clipping to white
       vec3 mapped = clamp((c*(2.51*c+0.03))/(c*(2.43*c+0.59)+0.14), 0.0, 1.0); // ACES
+      // DAY SKY TOO WHITE (user 2026-06-14): ACES desaturates the bright daylit sky toward white. Push
+      // saturation back up so the day sky reads BLUE (sun disc stays white -- it is already near-neutral).
+      float skyLum = dot(mapped, vec3(0.2126, 0.7152, 0.0722));
+      mapped = clamp(mix(vec3(skyLum), mapped, 1.35), 0.0, 1.0);
       fragColor = vec4(pow(mapped, vec3(1.0/2.2)) * uSkyFade, 1.0);
     }`;
   function rawShader(type, source){ const s=gl.createShader(type); gl.shaderSource(s, source); gl.compileShader(s);
@@ -776,7 +780,14 @@ export async function initMapspinnerRender(gl, opts = {}) {
     const camDist = Math.hypot(cam.eye[0], cam.eye[1], cam.eye[2]);
     const alt = Math.max(0.0, camDist - R);
     const altAboveTerrain = Math.max(0.001, alt - R * (cam.surfElev || 0));
-    const horizon = Math.sqrt(Math.max(0.0, camDist*camDist - R*R));
+    // FAR-PLANE HORIZON RADIUS = R - 500m (user 2026-06-14: 'nearby mountains disappear at water level;
+    // adjust that level to 500m under water'). The far plane tracks the sea-level horizon = sqrt(camDist^2
+    // - R^2), which at the deck (camDist~=R) collapses to a few hundred metres -> coastal mountains a km
+    // out fall beyond the far plane and vanish. Dropping the horizon reference radius 500m below sea level
+    // extends the horizon to tens of km at low altitude so near-shore relief stays in view (negligible
+    // depth-precision cost: 500m vs R~6.37e6). Both the cull and the draw use this (single source).
+    const RHORIZON = R - 500.0;
+    const horizon = Math.sqrt(Math.max(0.0, camDist*camDist - RHORIZON*RHORIZON));
     // MATCH render()'s near exactly (2026-06-14 jank fix): the cull frustum must use the SAME near
     // as the draw frustum, else behind-limb/screen-AABB culling diverges from what is actually drawn
     // at the deck (cull near was max(*0.1,0.1) while render used the <2m 0.05 branch).
@@ -812,7 +823,14 @@ export async function initMapspinnerRender(gl, opts = {}) {
     const camDist = Math.hypot(cam.eye[0], cam.eye[1], cam.eye[2]);
     const alt = Math.max(0.0, camDist - R);
     const altAboveTerrain = Math.max(0.001, alt - R * (cam.surfElev || 0));
-    const horizon = Math.sqrt(Math.max(0.0, camDist*camDist - R*R));
+    // FAR-PLANE HORIZON RADIUS = R - 500m (user 2026-06-14: 'nearby mountains disappear at water level;
+    // adjust that level to 500m under water'). The far plane tracks the sea-level horizon = sqrt(camDist^2
+    // - R^2), which at the deck (camDist~=R) collapses to a few hundred metres -> coastal mountains a km
+    // out fall beyond the far plane and vanish. Dropping the horizon reference radius 500m below sea level
+    // extends the horizon to tens of km at low altitude so near-shore relief stays in view (negligible
+    // depth-precision cost: 500m vs R~6.37e6). Both the cull and the draw use this (single source).
+    const RHORIZON = R - 500.0;
+    const horizon = Math.sqrt(Math.max(0.0, camDist*camDist - RHORIZON*RHORIZON));
     const near = altAboveTerrain < 2.0 ? 0.05 : Math.max(altAboveTerrain * 0.1, 0.05);
     const _fBlend = Math.min(1.0, Math.max(0.0, (alt - 500000.0) / 4500000.0));
     const farGround = Math.max(horizon, alt * 8.0);
@@ -993,7 +1011,7 @@ export async function initMapspinnerRender(gl, opts = {}) {
     gl.uniform1f(U('uLookSat'),        _g('lookSat', 1.15));
     gl.uniform1f(U('uLookContrast'),   _g('lookContrast', 1.08));
     { const o3=(n,d)=>{ const w=(typeof window!=='undefined'&&window['__'+n])||null; const v=(Array.isArray(w)&&w.length===3)?w:d; gl.uniform3f(U(n), v[0],v[1],v[2]); };
-      o3('uOceanDeep',[0.008,0.025,0.06]); o3('uOceanShallow',[0.07,0.22,0.26]); o3('uOceanK',[0.030,0.012,0.0045]); }
+      o3('uOceanDeep',[0.008,0.025,0.06]); o3('uOceanShallow',[0.07,0.22,0.26]); o3('uOceanK',[0.016,0.007,0.0028]); }   // K halved (user 2026-06-14 'see the land under the water properly') = clearer water, bed visible through shallow/medium depth; deep basins still opaque
     // (the continuous broad-shape field is now always on - the single terrain shape source -
     // so its old on/off lever uniform was removed from terrain.glsl; nothing to set here.)
     // LIVE biome ramp (window.__gen.state.biome, else tuned defaults) -- full-adjustability.

package/src/shaders/terrain.glsl

@@ -634,7 +634,11 @@ highp float composeHeight(vec3 dir0, highp vec2 faceLocal, float tileM){   // W7
       // the field -> seam-safe + the collision probe shares it. GUARD: a stale/unset uniform (0) would
       // disable the shelf -> default 600 so it always applies. window.__beachShelf dials S live.
       highp float bShelf = uBeachShelfM > 1.0 ? uBeachShelfM : 600.0;
-      if (h < bShelf) h = h * h / bShelf;
+      // C1-CONTINUOUS shelf (user 2026-06-14 'hard shading line where landscape meets beach'): the old
+      // h*h/S met the identity at h=S with SLOPE 2 (vs 1) -> a derivative kink -> the slope-keyed shading
+      // (rock/AO/material) SNAPPED into a hard line at the shelf top. f = (h*h/S)*(2 - h/S) keeps f(0)=0,
+      // f'(0)=0 (flat at the waterline = wide beach) AND f(S)=S, f'(S)=1 (smooth join to natural land).
+      if (h < bShelf) h = (h * h / bShelf) * (2.0 - h / bShelf);
   }
   // displacement now continues UNDERWATER (the old land-only gate served the flat-clamped ocean,
   // gone since 026d530): the seabed carries the same micro-relief as land = realistic continuation.
@@ -853,7 +857,8 @@ void main() {
         vH = max(vH, -11000.0);   // cap depth at Mariana Trench (~11km)
     } else {
         highp float bShelf = uBeachShelfM > 1.0 ? uBeachShelfM : 600.0;   // LAND COASTAL SHELF -- mirror composeHeight exactly (wide beach, user 2026-06-14); guard stale/unset uniform
-        if (vH < bShelf) vH = vH * vH / bShelf;
+        if (vH < bShelf) vH = (vH * vH / bShelf) * (2.0 - vH / bShelf);   // C1-continuous (mirror composeHeight) -- removes the beach-top slope kink / hard shading line
+
     }
     vH += vDisp;
     vH += detailFbm(dir0) * uDetailOverlay * 30.0 * step(0.0, vH);
@@ -1582,8 +1587,12 @@ void main() {
         // ~0 and nadir fresnel ~0 made the whole shoreline INVISIBLE (coverage 0 at a bisected
         // waterline pose). Real shallow water still shows its surface (sky reflection + ripple):
         // floor the opacity once genuinely submerged so shorelines read as water.
-        alphaW = max(alphaW, 0.30 * smoothstep(0.3, 4.0, depthM));
-        alphaW *= smoothstep(0.0, 1.5, depthM);
+        // SHALLOW TRANSPARENCY (user 2026-06-14: 'water fully transparent where it meets land, see the
+        // bed through it'): floor cut 0.30->0.12 and pushed deeper (start 1.5m) so the bed shows through
+        // the shoreline + shallows; deeper water still goes opaque via Beer-Lambert (1-Tavg). The contact
+        // fade is widened (0->3m) so the exact waterline is clear, not a hard opaque rim.
+        alphaW = max(alphaW, 0.12 * smoothstep(1.5, 8.0, depthM));
+        alphaW *= smoothstep(0.0, 3.0, depthM);
         fragColor = vec4(pow(mappedW, vec3(1.0 / 2.2)), alphaW);
         return;
     }
@@ -1746,7 +1755,7 @@ void main() {
         // WIDENED TRANSITION (2026-06-13): srLo+0.2 -> srLo+0.4 so rock/grass and rock/sand/snow
         // boundaries have a wider blend band — the slope gradient between materials is no longer
         // a ~0.2-unit hard step but a ~0.4-unit gradual fade.
-        float srLo = max(slopeRock.x, 0.05), srHi = max(slopeRock.y, srLo + 0.35);   // 0.18->0.10->0.05: rock slope gate MORE SENSITIVE so even gentle slopes (~18deg+) pick up as rock (user 2026-06-14, repeated). Stays above truly-flat (rockSlope~0).
+        float srLo = max(slopeRock.x, 0.05), srHi = max(slopeRock.y, srLo + 0.25);   // 0.18->0.10->0.05 lo; band +0.35->+0.25 (user 2026-06-14 repeated 'rock face angle more sensitive'): rock fully engages by a GENTLER slope. Stays above truly-flat (rockSlope~0).
         float wRockSlope = smoothstep(mix(srLo, 0.50, sandRegion), mix(srHi, 0.70, sandRegion), rockSlope);
         // WARPED BIOME BAND EDGES (user 2026-06-14: the snow/rock lines were STRAIGHT horizontal contours
         // viewed side-on; the vTexWarp domain warp was too low-freq (>1.8km waves = ~constant over one

package/src/terrain-gen-controls.js

@@ -37,7 +37,7 @@ const DEFAULTS = {
     bcLowland: [0.20,0.34,0.15], bcGrass: [0.26,0.40,0.17], bcRock: [0.52,0.43,0.34],   // bcRock -> a clearly WARMER TAN-GREY (R>G>B) so it reads as ROCK when lit, not olive-green (the [0.46,0.42,0.37] near-grey read green next to the biome). state.biome OVERRIDES gl-render defaults via window.__gen.
     bcSnow: [0.92,0.94,0.97],
     bandEdgesLo: [150.0,1200.0], bandEdgesHi: [3500.0,6500.0], snowEdges: [6000.0,8500.0],   // 8000/10500->6000/8500 (user 2026-06-11 'snowy mountains disappeared' -- see gl-render snowEdges note)   // snowEdges 5200/7000->8000/10500 (user 2026-06-10 'entire terrain white': the rock-by-height fix unmasked snow gates tuned pre-4x; full snow from 5.2km whitened the 11.6km massifs; coldSnow onset = snowEdges.x*0.5 follows)   // bandEdgesHi 1600/3200->3500/6500 (user 2026-06-10 'rockface everywhere'): tuned on the pre-4x terrain; with 11.6km peaks everything above 3200m read rock BY HEIGHT alone -- rescale the treeline to the new elevation range
-    seaDepthM: 3000.0, slopeRock: [0.0,0.3],   // [0.0,0.3] USER-SET 2026-06-13
+    seaDepthM: 3000.0, slopeRock: [0.0,0.22],   // hi 0.3->0.22 (user 2026-06-14 'rock face angle more sensitive, gentler slopes turn to rock'): rock fully engages by ~0.22 slope; lo stays 0.0 so truly-flat (rockSlope~0) keeps grass
   },
   // REAL-WORLD LOOK overhaul (terraformable lighting/shading levers; applyShaderGlobals sets window
   // globals; gl-render reads them via _g()). Beer-Lambert ocean, biome sat, mottle, sky-fill relief,
@@ -46,7 +46,7 @@ const DEFAULTS = {
     exposure: 1.0, skyFill: 0.45, biomeSat: 0.72, variationAmt: 0.04, colorVar: 0.5, vertexAO: 1.0,     reliefShade: 2.5,   // variationAmt 0.08->0.04 (user 2026-06-10 'blotchy': the ~50km value mottle painted light/dark patches across the massifs)
     nightFloor: 0.16, termWidth: 0.25, terminatorGlow: 0.30, lookSat: 1.15, lookContrast: 1.08,   // nightFloor 0.05->0.16: no black night terrain (2026-06-09)
     detailOverlay: 6.0, hazeMul: 0.65,   // 2026-06-10 'pale hazy + featureless': perlin-everywhere albedo+elevation fbm (user-tuned 6) + aerial-perspective strength cut
-    ocean: { deep: [0.008,0.025,0.06], shallow: [0.07,0.22,0.26], k: [0.030,0.012,0.0045] },
+    ocean: { deep: [0.008,0.025,0.06], shallow: [0.07,0.22,0.26], k: [0.016,0.007,0.0028] },   // k halved (user 2026-06-14 'see the land under the water'): clearer water, bed visible through shallow/medium depth. OVERRIDES the gl-render uOceanK default via window.__uOceanK.
   },
   // HPF band scales (multipliers on the anchor-field band base values; anchor-field.setBandScales).
   hpf: {