npm - mapspinner - Versions diffs - 0.1.3 → 0.1.5 - Mend

mapspinner 0.1.3 → 0.1.5

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (10) hide show

package/AGENTS.md +3 -3
package/CHANGELOG.md +1 -1
package/package.json +1 -1
package/planet.html +15 -20
package/src/anchor-field.js +5 -6
package/src/gl-render.js +1 -1
package/src/planet-orchestrator.js +2 -2
package/src/quadtree.js +1 -4
package/src/shaders/atmosphere.glsl +1 -1
package/src/shaders/terrain.glsl +9 -13

package/AGENTS.md CHANGED Viewed

@@ -33,7 +33,7 @@ camera you can't aim. Use the DATA diagnostics — `__diag.pxPerPoly()` (on-scre
 ## The terrain pipeline in one page (read this before touching terrain)
 Earth-scale terrain SDK, WebGL2, served at `http://localhost:8080/` (entry `planet.html`, `server.js`).
-GPU one-fractal: no Proland tile producer, no cascade. A finer
+GPU one-fractal: no tile producer. A finer
 LOD is a denser sample of the SAME field. The procedural broadShapeM fractal is the LIVE render
 path (hasAtlas==0, the default). The baked atlas is opt-in (planet-orchestrator.js opts.atlas===true;
 live `window.__toggleAtlas(on)` / `__forceAtlas`); its bake is CLI-validated faithful (atlas-bake.mjs
@@ -58,7 +58,7 @@ probes, and `window.__diag.reloadShaders()` hot-reload through `/cmd` — no pag
 Data flow, each stage names its one file:
 1. QUADTREE picks which cube-sphere patches to draw per camera altitude — `src/quadtree.js`
-   (cube-sphere quadtree in JS, ported from the deleted Proland C++), driven per frame by
+   (cube-sphere quadtree in JS), driven per frame by
    `src/planet-orchestrator.js`.
 2. MESH per patch is a GRID+2 grid (`src/gl-render.js`) whose outer ring is a SKIRT (terrain.glsl
    drops `vertex.z>0.5` verts radially below the surface) hiding LOD T-junction cracks. The outer
@@ -70,7 +70,7 @@ Data flow, each stage names its one file:
    `inciseRidgeField`. Collision = a GPU `_PROBE_` variant of the SAME shader (1px readback,
    `gl-render.sampleGroundM`), no CPU mirror. — full design: recall "TV8 GPU-TERRAIN ARCHITECTURE
    DECISION" in rs-learn.
-4. DEFORM: direct per-vertex sphere projection — `vWorld = dir0 * (R + h)` (replaced the Proland
+4. DEFORM: direct per-vertex sphere projection — `vWorld = dir0 * (R + h)`
    corner-blend deform; round at any tessellation, no flat patches at high GRID).
 5. FS shades from height+slope+climate (`terrainAlbedoClimate`) + per-vertex seamless normal +
    ocean/lake/river. No FS detail TEXTURE (a tiled image would moire + UV-scroll); closeup MACRO

package/CHANGELOG.md CHANGED Viewed

@@ -24,7 +24,7 @@
 ## 2026-05-23
-- `terrain-phase2.js` (commit `d87c51b`): Add `allocateTileSlot`, `computePipelines`, `computeBindGroups` to `ProlandProducer` — stopped TypeError crash every render frame when `terrain-phase3-integration.js` called these missing methods.
+- `terrain-phase2.js` (commit `d87c51b`): Add `allocateTileSlot`, `computePipelines`, `computeBindGroups` — stopped TypeError crash every render frame when `terrain-phase3-integration.js` called these missing methods.
 - `shader-loader.js` (commit `1e61b7b` session): Fix `#if` numeric literal handling — `#if 1` was treated as a flag lookup (always false), stripping always-true blocks and causing GPU validation errors and black canvas.
 - `terrain-phase1.js`: Change `normTexArray` format from `rg32float` to `rgba8unorm` to match `normal_producer.wgsl` storageTexture output.
 - `terrain-phase2.js`: Remove unused bind group entries for upsample (b5), normal producer (b0), ortho producer (b0,b1,b2,b6) — WebGPU `layout:'auto'` strips unreachable bindings, causing validation errors when they were supplied.

package/package.json CHANGED Viewed

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

package/planet.html CHANGED Viewed

@@ -1,5 +1,5 @@
 <!doctype html>
-<html><head><meta charset="utf-8"><title>TerrainView8 -- authentic Proland planet (WebGL2)</title>
+<html><head><meta charset="utf-8"><title>mapspinner — WebGL2 Terrain SDK</title>
 <style>
   html,body{margin:0;height:100%;background:#000;color:#9f9;font:12px monospace;overflow:hidden}
   canvas{display:block;width:100vw;height:100vh}
@@ -14,9 +14,9 @@
   #panel .grp{border-top:1px solid #3f3;padding-top:4px;margin-top:6px;color:#cfc}
 </style></head>
 <body>
-<!-- The authentic Proland WebGL2 path (proland-planet-orchestrator) renders here. -->
+<!-- The mapspinner WebGL2 renderer renders here. -->
 <canvas id="cwebgl" style="position:fixed;inset:0;width:100vw;height:100vh"></canvas>
-<div id="hud"><b>TerrainView8 (authentic Proland, WebGL2)</b><br>
+<div id="hud"><b>mapspinner — WebGL2 Terrain SDK</b><br>
 Controls: <b>WASD</b>/drag orbit . <b>Q/E</b>/wheel zoom . <b>R</b> reset<br>
 <span id="stats">init...</span></div>
 <div id="panel">
@@ -33,18 +33,16 @@ Controls: <b>WASD</b>/drag orbit . <b>Q/E</b>/wheel zoom . <b>R</b> reset<br>
 <div id="genPanel" style="position:fixed;left:8px;top:34px;z-index:30;display:none;max-height:88vh;overflow:auto;background:rgba(12,16,20,0.92);color:#cfe;font:10px/1.5 monospace;padding:6px 8px;border:1px solid #2a3a44;width:250px"></div>
 <div id="err"></div>
 <script type="module">
-// [P2-6 follow-up] The authentic Proland terrain + atmosphere + ocean run entirely
-// on the WebGL2 path (proland-planet-orchestrator, loaded lazily in frameLoop). The
-// legacy WebGPU device/pipelines/ocean/atmosphere + the JS quadtree + our CPU
-// proland_terrain.wasm (which only drove that dead path) have been DELETED.
+// The mapspinner terrain + atmosphere + ocean run entirely
+// on the WebGL2 path, loaded lazily in frameLoop. The
+// legacy WebGPU device/pipelines/ocean/atmosphere have been DELETED.
 const errEl=document.getElementById('err');
 const showErr=m=>{errEl.style.display='block';errEl.textContent=String(m);window.__pageErr=String(m);console.error(m)};
 window.addEventListener('error',e=>showErr(e.message||e));
 window.addEventListener('unhandledrejection',e=>showErr(e.reason?.message||e.reason||e));
-// [P2-6 follow-up] The legacy WebGPU render path has been DELETED. The authentic
-// Proland terrain + atmosphere + ocean all run on the WebGL2 path
-// (proland-planet-orchestrator) drawing to #cwebgl. `canvas` is the WebGL2 canvas;
+// The legacy WebGPU render path has been DELETED. All terrain + atmosphere + ocean
+// run on the WebGL2 path drawing to #cwebgl. `canvas` is the WebGL2 canvas;
 // camera event handlers + sizing read it.
 const canvas=document.getElementById('cwebgl');
@@ -124,8 +122,7 @@ const normalize=v=>{const r=Math.hypot(...v)||1;return [v[0]/r,v[1]/r,v[2]/r]};
 // where the camera starts (cam.pos below), not by this scalar -- RADIUS just
 // sets the units everything else is denominated in.
 const RADIUS=6371.0;
-// WebGL2 Proland overlay works in METERS (its producer generates meter-scale
-// elevation). Surface radius 6.36e6 m; the km-unit world maps to it 1 unit = this many m.
+// WebGL2 terrain works in METERS. Surface radius 6.36e6 m; the km-unit world maps to it 1 unit = this many m.
 const WEBGL2_TERRAIN_R_M = 6360000.0;
 const WEBGL2_M_PER_UNIT = WEBGL2_TERRAIN_R_M / RADIUS;
 // EXPOSE the world-scale constants as globals so a scripted browser-witness (page.evaluate runs
@@ -298,8 +295,7 @@ async function pollCmd() {
   } catch (_) {} finally { __cmdBusy = false; }
 }
 setInterval(pollCmd, 500);
-// P2-6: the authentic Proland WebGL2 terrain (proland-planet-orchestrator) is the
-// renderer. Set window.__useWebGL2Terrain=false to disable (no fallback now).
+// The mapspinner WebGL2 terrain is the renderer.
 if (window.__useWebGL2Terrain === undefined) window.__useWebGL2Terrain = true;
 const stats=document.getElementById('stats');
 // SINGLE-FLIGHT FRAME SCHEDULER (2026-06-12): every frameLoop continuation routes through here so
@@ -314,8 +310,7 @@ function frameLoop(){
   const frameMs = now - lastT;          // true inter-frame interval (for FPS)
   const dt=Math.min(0.05,(now-lastT)/1000); lastT=now;
-  // ---- Authentic-Proland WebGL2 terrain path. Lazily inits the compiled Proland
-  // wasm + thin WebGL2 renderer (proland-planet-orchestrator) on the #cwebgl canvas.
+  // ---- mapspinner WebGL2 terrain path. Lazily inits the renderer on the #cwebgl canvas.
   // The actual render + rAF happens AFTER the camera-update section below (so WASD/
   // drag/zoom + autopilot move the camera before the frame is drawn).
   if (window.__useWebGL2Terrain) {
@@ -378,7 +373,7 @@ function frameLoop(){
       // We drive it in meter-space and scale the km-unit camera into meters via
       // WEBGL2_M_PER_UNIT below.
       import('./src/planet-orchestrator.js')
-        .then(m => m.initProlandPlanet(glw, { radius: WEBGL2_TERRAIN_R_M, frustumCull: false }))
+        .then(m => m.initMapspinnerPlanet(glw, { radius: WEBGL2_TERRAIN_R_M, frustumCull: false }))
         .then(orch => { window.__planetOrch = orch; window.__planetOrchGL = glw; window.__planetOrchStatus='ready';
           import('./src/terrain-gen-controls.js').then(()=>{ try{ window.__gen && window.__gen.apply(); }catch(_){} }).catch(e=>console.warn('gen-controls',e)); })
         .catch(e => { window.__planetOrchStatus='error:'+(e.message||e); console.error('orch init',e); });
@@ -546,7 +541,7 @@ function frameLoop(){
   window.__altM = heightAboveGroundM;
   // The camera (autopilot + free-fly + clamp) has now been fully updated this frame,
-  // so render the authentic Proland WebGL2 planet with the CURRENT camera. This is
+  // so render the planet with the CURRENT camera. This is
   // the sole render path; it advances the sun, draws via the orchestrator, updates
   // the HUD/title/diag, schedules the next frame, and returns.
   if (window.__useWebGL2Terrain && window.__planetOrch) {
@@ -705,8 +700,8 @@ cam.oceanAmplitude  = 1.0 * (0.4 + 5 / 12.0);    // == old default (windSpeed 5)
 cam.oceanChoppiness = 1.6 * (0.5 + 0.5);         // == old default (seaState 0.5)
 cam.oceanFoam       = 0.5;
 cam.oceanTimeScale  = 1.0;
-// Display-mode toggle (tv-display-modes-toggle). Skirts removed: LOD cracks are now hidden
-// by the one-cell overlap ring in the mesh (proland-gl-render), not a dropped skirt curtain.
+// Display-mode toggle. Skirts removed: LOD cracks are now hidden
+// by the one-cell overlap ring in the mesh, not a dropped skirt curtain.
 // User picking from the dropdown is an explicit action that must WIN over any stale diagnostic
 // override (window.__displayMode left set by __dbg.setDisplayMode/census/aimDir). Clear the override
 // so the menu value takes effect immediately -- otherwise the precedence pick in the render loop

package/src/anchor-field.js CHANGED Viewed

@@ -12,10 +12,9 @@
 // only that cell's neighbourhood -- never the whole planet.
 //
 // INTEGRATION: this is a pure-JS field (editable, serialisable). The orchestrator samples
-// it per Proland tile and pushes the result into the wasm via the existing setters + a
-// per-tile additive bias, so Proland's upsample-coherence and seamlessness are preserved
-// (the field is C0-continuous across tile edges because every tile samples the SAME global
-// quadtree partition at its own scale band). No wasm rebuild is needed to edit params.
+// it per tile and pushes the result into the terrain VS via a uniform or texture.
+// The field is C0-continuous across tile edges because every tile samples the SAME global
+// quadtree partition at its own scale band.
 //
 // PERFORMANCE (all the most-performant choices):
 //   - Param storage is a flat Float32Array per band (cache-friendly, zero object churn),
@@ -26,7 +25,7 @@
 //   - Sampling is O(bands) -- a handful of band lookups + one bilinear per band -- with no
 //     allocation on the hot path (results written into a reused scratch object).
-// ---- cube-face frame (mirrors proland-planet-orchestrator FACE_FRAME / render localToWorld3).
+// ---- cube-face frame (mirrors planet-orchestrator FACE_FRAME / render localToWorld3).
 // A face-local point (u,v in [-1,1], outward axis) maps to a world direction. We only need
 // the inverse (world dir -> face + uv) for sampleDir, and the forward (face,uv -> dir) for
 // the per-node procedural hash seed coordinate.
@@ -415,7 +414,7 @@ export function createAnchorField(opts = {}) {
     return _scratch;
   }
-  // PER-TILE sample for the orchestrator: a Proland tile (face, level, tx, ty) covers a uv
+  // PER-TILE sample for the orchestrator: a tile (face, level, tx, ty) covers a uv
   // square on its face; sample the field at the tile CENTRE (the bias is per-tile, and the
   // field is C0 across tiles because every tile samples the same global band quadtrees).
   function sampleTile(face, level, tx, ty) {

package/src/gl-render.js CHANGED Viewed

@@ -561,7 +561,7 @@ export async function initMapspinnerRender(gl, opts = {}) {
   const instBuf=gl.createBuffer();   // per-instance [ox,oy,l,level,face] (filled per frame in render())
   // per-face local->world (cube face -> sphere local frame). Column-major mat3 packed
-  // into a Float32Array(9). Matches prolandProducers.buildLocalToWorld convention:
+  // into a Float32Array(9). Matches localToWorld3 convention:
   // col0 = U/rs, col1 = faceCenter, col2 = V/rs. rootQuadSize=2 -> face spans [-1,1].
   function localToWorld3(face) {
     // face axes (cube): for face 3 (+Z) U=+X, V=+Y, center=+Z. Generic table:

package/src/planet-orchestrator.js CHANGED Viewed

@@ -202,7 +202,7 @@ export async function initMapspinnerPlanet(gl, opts = {}) {
   // ---- HIERARCHICAL PARAMETER FIELD (HPF) ----------------------------------------
   // The anchor field drives generation as a CONTINUOUS function of world direction. To keep
-  // Proland upsample-coherence + seamlessness we feed it to the terrain VS as a TEXTURE (a
+  // For seamlessness we feed it to the terrain VS as a TEXTURE (a
   // continuous C0 field via LINEAR filtering) rather than a per-tile constant (a per-tile
   // step would reintroduce seams -- see the CLOD mean-drift / edge-equality lessons). We bake
   // the field's continental band into a per-face HPF_RES^2 RGBA32F 2D-array (seaBias, elevAmp,
@@ -414,7 +414,7 @@ export async function initMapspinnerPlanet(gl, opts = {}) {
                fallbackCount: c.fallbackCount, maxFallbackLevel: c.maxFallbackLevel, frontFallback: c.frontFallback, cached: true };
     }
-    // configure the authentic Proland quadtree once (meter units; root l=2R).
+    // configure the quadtree once (meter units; root l=2R).
     // splitFactor is LIVE-TUNABLE via window.__splitFactor so the px/poly target
     // (4-50 px per triangle edge) can be calibrated in-browser with one dispatch
     // (no wasm rebuild / reload) -- the efficiency analog of __diag.setGen. A SMALLER

package/src/quadtree.js CHANGED Viewed

@@ -1,7 +1,4 @@
-// quadtree.js -- the cube-face terrain quadtree LOD selection, ported from the deleted
-// proland_terrain.cpp (TerrainNode/TerrainQuad subdivision + SphericalDeformation + the
-// pixel-calibrated split distance). This is the ONE piece of the old C++/wasm the render
-// needed; everything else (the elevation/normal/ortho atlas producer + cascade) is gone --
+// quadtree.js -- the cube-face terrain quadtree LOD selection.
 // terrain shape is the single GPU fractal (broadShapeM in terrain.glsl), evaluated per-vertex.
 //
 // Pure JS, no wasm, no allocation per frame beyond the leaf array. One Quadtree instance per

package/src/shaders/atmosphere.glsl CHANGED Viewed

@@ -1,6 +1,6 @@
 // src/shaders/atmosphere.glsl  (#version 300 es is prepended by the JS loader)
 // -----------------------------------------------------------------------------
-// WebGL2 analytic Rayleigh/Mie single-scatter atmosphere for the Proland planet.
+// WebGL2 analytic Rayleigh/Mie single-scatter atmosphere for the planet.
 //
 // PORT NOTE — what this is vs. the WebGPU path:
 //   planet.html runs the AUTHORITATIVE Bruneton model: it BAKES the transmittance/

package/src/shaders/terrain.glsl CHANGED Viewed

@@ -1,14 +1,9 @@
-// Proland authentic terrain render shader, ported to WebGL2 (#version 300 es) from
-// vendor/proland-build/proland-git/terrain/examples/terrain2/terrainShader.glsl.
-// VS: spherical deformation + CLOD blend (zf<->zc) of the wasm-driven elevation tiles.
-// FS: sample normal + (placeholder) albedo, simple sun-lit Lambert with an ambient floor.
-// Driven by the thin WebGL2 render layer (per-quad deformation uniforms + textureTile
-// coords from the Proland wasm). No geometry/tess -> WebGL2-clean. The JS prepends
-// #version + precision and compiles _VERTEX_ / _FRAGMENT_ separately.
+// mapspinner WebGL2 terrain render shader.
+// VS: spherical deformation + direct per-vertex sphere projection.
+// FS: sample normal + albedo, sun-lit Lambert with ambient floor.
+// The JS prepends #version + precision and compiles _VERTEX_ / _FRAGMENT_ separately.
-// (Proland SamplerTile/textureTile atlas plumbing DELETED 2026-06-11 dead-code sweep: never set, never called.)
-// --- DIRECT per-vertex sphere-projection uniforms (replaces the Proland corner-blend CLOD) ------
+// --- DIRECT per-vertex sphere-projection uniforms ------
 // SINGLE INSTANCED DRAW: defOffset (ox,oy,l,level) + the face frame are PER-INSTANCE now (one
 // gl.drawElementsInstanced over the whole visible leaf set, no per-quad uniform churn). In the VS
 // they come from instance attributes (iOffset + iFace); defRadius/defViewProjRel stay uniforms
@@ -712,7 +707,7 @@ mat3 faceFrame(float f){
 // function of world dir -> replaces the old hardcoded sin/cos lobe with the editable field.
 highp float continentalBias(vec3 dir) { return hpfSample(dir).r; }   // W7: R = seaBias (meters) -> highp
-// ---- CONTINUOUS BROAD+MID SHAPE (LOD-uniformity fix, user-directive 2026-05-30). The Proland
+// ---- CONTINUOUS BROAD+MID SHAPE (LOD-uniformity fix). The
 // per-level g_noiseAmp cascade adds a DIFFERENT noise draw at each LOD, so consecutive levels
 // look different (1500km vs 1200km "way different"). The fix: source the broad+regional SHAPE
 // from ONE continuous fBm of WORLD DIRECTION, sampled the same at every LOD -> a finer level is
@@ -966,7 +961,8 @@ void main() {
     float dHdvN = float(hFD2 - h) / nStep;
     vNrm = normalize(uxN * (-dHduN) + uyN * (-dHdvN) + uzN);   // n = normalize([-dz/du,-dz/dv,1]) in the (ux,uy,uz) frame
     }
-    // DIRECT per-vertex sphere projection (replaces the Proland deformedCorners*alphaPrime blend,
+    // DIRECT per-vertex sphere projection (replaces the
+    deformedCorners*alphaPrime blend,
     // which bilinearly interpolated 4 deformed corners -> FLAT quad interior -> faceted at high GRID).
     // dir0 is THIS vertex's world direction (faceWarp'd, defLocalToWorld-mapped); place it on the
     // sphere at radius R+h and project. Every vertex curves -> round at any tessellation.
@@ -2076,7 +2072,7 @@ void main() {
 // ---- HEIGHT PROBE (collision): compute the EXACT rendered terrain height for one world dir,
 // reusing the same hpfSample + broadShapeM the mesh VS uses, so the free-fly collision floor
 // can never diverge from the rendered surface (user-chosen: read px from the GPU, not a CPU
-// mirror). Paired with a 1-point VS in proland-gl-render.js; writes height (metres) to R32F.
+// mirror). Paired with a 1-point VS in gl-render.js; writes height (metres) to R32F.
 #ifdef _PROBE_
 uniform vec3 probeDir;     // world direction under the camera (normalized)
 out vec4 probeOut;