mapspinner 0.1.64 → 0.1.66

package/package.json

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

package/src/gl-render.js

@@ -787,7 +787,7 @@ export async function initMapspinnerRender(gl, opts = {}) {
     // 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 - 250.0;   // far brought in 500->250 (user 2026-06-14 'bring far plane in a bit'): deck horizon ~80km->~56km = more z-precision; still clears coastal mountains
+    const RHORIZON = R - 150.0;   // far brought in 500->250 (user 2026-06-14 'bring far plane in a bit'): deck horizon ~80km->~56km = more z-precision; still clears coastal mountains
     // UNDERWATER FAR-PLANE FIX (user 2026-06-14 'at -214m visible, at -500m it disappears'): when the
     // camera is more than 500m below sea level, camDist < RHORIZON so the sea-level horizon is imaginary
     // (-> 0) and alt is negative; the old max(horizon, alt*8) then collapsed the far plane to ~0 and the
@@ -797,7 +797,7 @@ export async function initMapspinnerRender(gl, opts = {}) {
     // 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).
-    const near = altAboveTerrain < 2.0 ? 0.25 : Math.max(altAboveTerrain * 0.1, 0.25);   // near nudged out 0.05->0.25 (user 2026-06-14 'improve on-ground'): more z-precision on the deck
+    const near = altAboveTerrain < 2.0 ? 0.5 : Math.max(altAboveTerrain * 0.1, 0.5);   // near nudged out 0.05->0.25 (user 2026-06-14 'improve on-ground'): more z-precision on the deck
     // FAR PLANE: horizon distance tracks the visible ground edge; blends toward camDist
     // above 500km for orbital views so the full planet is visible.
     const _fBlend = Math.min(1.0, Math.max(0.0, (alt - 500000.0) / 4500000.0));
@@ -835,14 +835,14 @@ export async function initMapspinnerRender(gl, opts = {}) {
     // 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 - 250.0;   // far brought in 500->250 (user 2026-06-14 'bring far plane in a bit'): deck horizon ~80km->~56km = more z-precision; still clears coastal mountains
+    const RHORIZON = R - 150.0;   // far brought in 500->250 (user 2026-06-14 'bring far plane in a bit'): deck horizon ~80km->~56km = more z-precision; still clears coastal mountains
     // UNDERWATER FAR-PLANE FIX (user 2026-06-14 'at -214m visible, at -500m it disappears'): when the
     // camera is more than 500m below sea level, camDist < RHORIZON so the sea-level horizon is imaginary
     // (-> 0) and alt is negative; the old max(horizon, alt*8) then collapsed the far plane to ~0 and the
     // whole scene vanished past -500m deep (= the 'ocean looks shallow/empty' when exploring). Floor the
     // far reach to 60km when submerged so the seabed + the underwater view stay visible.
     const horizon = (camDist > RHORIZON) ? Math.sqrt(camDist*camDist - RHORIZON*RHORIZON) : 60000.0;
-    const near = altAboveTerrain < 2.0 ? 0.25 : Math.max(altAboveTerrain * 0.1, 0.25);   // near nudged out 0.05->0.25 (user 2026-06-14 'improve on-ground'): more z-precision on the deck
+    const near = altAboveTerrain < 2.0 ? 0.5 : Math.max(altAboveTerrain * 0.1, 0.5);   // near nudged out 0.05->0.25 (user 2026-06-14 'improve on-ground'): more z-precision on the deck
     const _fBlend = Math.min(1.0, Math.max(0.0, (alt - 500000.0) / 4500000.0));
     const farGround = Math.max(horizon, alt * 8.0);
     const far = farGround * (1.0 - _fBlend) + camDist * _fBlend;

package/src/shaders/terrain.glsl

@@ -1807,9 +1807,13 @@ void main() {
         // NOT a fractal (user 2026-06-14: 'looking like a fractal, use the materials displacement'). Widen
         // the gate transition band so sand+grass overlap over a broad elevation span -> bSharp picks the
         // local winner by texture relief -> fingered shoreline that follows the actual texture bumps.
+        // MUCH MORE GRADUAL grass<->sand margin (user 2026-06-14): the WEIGHT crosses over slowly across
+        // a wide elevation span (0 -> ~2.5x beachTop); the per-pixel transition is then made HARD by the
+        // displacement height-blend (small bw below) so sand vs grass is a sharp choice distributed by
+        // texture relief = interlocking fingers that thin out with height, never a blendy fade.
         float beachW = warpN * uBeachTopM * 0.30;   // warp amplitude scales with the beach band height
-        float beach = (1.0 - smoothstep(uBeachTopM * 0.10 + beachW, uBeachTopM * 1.15 + beachW, vH))
-                    * (1.0 - smoothstep(0.15, 0.42, slope));
+        float beach = (1.0 - smoothstep(beachW, uBeachTopM * 2.5 + beachW, vH))
+                    * (1.0 - smoothstep(0.18, 0.55, slope));
         // SAND BLEED (2026-06-13): patchy sand spills above the main beach line, modulated by VS
         // warp noise so the edge reads as wind-blown pockets, not a strict elevation cut. At peak it
         // adds ~0.3 sand weight far above the beach, creating a natural dappled transition.
@@ -1912,7 +1916,7 @@ void main() {
             // offset by the ramp'): height = displacement + a weight-ramp offset (gate positions the
             // boundary); higher wins over a soft width so the loser's high bumps poke through = fingers,
             // no hard line. ONE blend for ALL pairs. Mips smooth dispA/dispB at distance -> soft far edge.
-            float bw = 0.25;
+            float bw = 0.06;   // NEAR-HARD crossover (user 2026-06-14 'make the transition hard, let the displacement make the distribution interesting -> far less blendy'): the displacement picks a sharp per-pixel winner; the gate weight only shifts the proportion across the ramp
             float hA = dispA + (bAB - 0.5) * 1.1;
             float hB = dispB + (0.5 - bAB) * 1.1;
             float mh = max(hA, hB) - bw;