ixmaps-gl 0.2.0 → 0.2.1

package/README.md

@@ -181,7 +181,9 @@ script. For brokers that query by view, like flat's bbox data providers, ixmaps-
 `ixmaps.getBoundingBox()`, `ixmaps.refreshTheme(id)` (loads the theme's data again, in place),
 `ixmaps.setTitle(html)`/`setTitleBox(text, color)`, `ixmaps.getThemeObj(id).fVisible` (false for a
 FEATURE theme out of scale) and calls a page's `ixmaps.htmlgui_onZoomAndPan(zoom)` after each zoom
-or pan. Scripts that reach further into flat's internals (`ixmaps.parentApi`, other `htmlgui_*`
+or pan — and also during a zoom, at the pace of the layer refresh (about every 150 ms, zoom changes only),
+so zoom-dependent page state (e.g. a basemap opacity ramp) changes in step with the scale gates
+(`featurelower`, `chartupper`, …) instead of after the gesture has ended. Scripts that reach further into flat's internals (`ixmaps.parentApi`, other `htmlgui_*`
 hooks) aren't supported. `test/project-report.mjs` shows which themes
 of your own project files gl can render.
 
@@ -190,7 +192,7 @@ of your own project files gl can render.
 Load the engine from jsDelivr, pinned to a release tag (or `@main` for the latest commit):
 
 ```html
-<script src="https://cdn.jsdelivr.net/gh/gjrichter/ixmaps-gl@v0.2.0/ixmaps-gl.js"></script>
+<script src="https://cdn.jsdelivr.net/gh/gjrichter/ixmaps-gl@v0.2.1/ixmaps-gl.js"></script>
 ```
 
 or from unpkg, the npm package [`ixmaps-gl`](https://www.npmjs.com/package/ixmaps-gl)
@@ -198,13 +200,13 @@ or from unpkg, the npm package [`ixmaps-gl`](https://www.npmjs.com/package/ixmap
 browser script, which defines the global `ixmaps`):
 
 ```html
-<script src="https://unpkg.com/ixmaps-gl@0.2.0/ixmaps-gl.js"></script>
+<script src="https://unpkg.com/ixmaps-gl@0.2.1/ixmaps-gl.js"></script>
 ```
 
 or use a local copy (`<script src="ixmaps-gl.js"></script>`). A minimal page:
 
 ```html
-<script src="https://cdn.jsdelivr.net/gh/gjrichter/ixmaps-gl@v0.2.0/ixmaps-gl.js"></script>
+<script src="https://cdn.jsdelivr.net/gh/gjrichter/ixmaps-gl@v0.2.1/ixmaps-gl.js"></script>
 <div id="map_div" style="position:absolute;inset:0;"></div>
 
 <script>

package/ixmaps-gl.js

@@ -80,7 +80,7 @@
   // ---------------------------------------------------------------
   // this engine's release (= package.json "version", checked by
   // test/unit/version.test.mjs); ixmaps.glVersion, and logged once at start
-  const IXMAPS_GL_VERSION = '0.2.0';
+  const IXMAPS_GL_VERSION = '0.2.1';
 
   const LIB_URLS = {
     // Bumped 3.6.2 -> 5.x (2026-09-21, globe-projection compat fix): native
@@ -2728,6 +2728,16 @@
       // broker re-queries its data from it. Read at call time: pages wrap
       // it after loading. flat passes its SVG zoom scale; this passes the
       // flat zoom level, the one value gl has.
+      //
+      // gl also calls it DURING a zoom (notifyZoomAndPanMidGesture, wired
+      // into the throttled refresh below), zoom changes only: the scale
+      // gates (featurelower/chartupper ...) switch on the live zoom while
+      // the gesture runs, so a page that ties something zoom-dependent to
+      // this hook (e.g. a basemap opacity ramp) must be told in the same
+      // tick — from 'moveend' alone it arrived after the gate had already
+      // flipped (FEATURE gone, basemap still at the old, faint opacity: a
+      // blank background until the zoom ended).
+      let notifyZoomAndPanMidGesture = () => {};
       {
         let last = null;
         map.on('moveend', () => {
@@ -2739,6 +2749,14 @@
           if (z === prev.z && Math.abs(p.x - q.x) <= 10 && Math.abs(p.y - q.y) <= 10) return;
           try { hook.call(global.ixmaps, mapLibreToFlatZoom(z)); } catch (e) { console.error('[ixmaps-gl] htmlgui_onZoomAndPan:', e); }
         });
+        notifyZoomAndPanMidGesture = () => {
+          const hook = pageIxmaps() && pageIxmaps().htmlgui_onZoomAndPan;
+          if (typeof hook !== 'function' || !last) return;
+          const z = map.getZoom();
+          if (z === last.z) return; // a pan alone waits for 'moveend' (and its 10 px rule)
+          last = { z, c: map.getCenter() };
+          try { hook.call(global.ixmaps, mapLibreToFlatZoom(z)); } catch (e) { console.error('[ixmaps-gl] htmlgui_onZoomAndPan:', e); }
+        };
         // flat calls it on the first draw too (its old zoom is unset then)
         map.once('load', () => {
           last = { z: map.getZoom(), c: map.getCenter() };
@@ -3878,10 +3896,11 @@
         const elapsed = now - lastRefreshAt;
         if (elapsed >= REFRESH_INTERVAL_MS) {
           lastRefreshAt = now;
+          notifyZoomAndPanMidGesture();
           refreshLayers();
         } else {
           clearTimeout(refreshTimer);
-          refreshTimer = setTimeout(() => { lastRefreshAt = Date.now(); refreshLayers(); }, REFRESH_INTERVAL_MS - elapsed);
+          refreshTimer = setTimeout(() => { lastRefreshAt = Date.now(); notifyZoomAndPanMidGesture(); refreshLayers(); }, REFRESH_INTERVAL_MS - elapsed);
         }
         scheduleNotifyRedraw();
       }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "ixmaps-gl",
-  "version": "0.2.0",
+  "version": "0.2.1",
   "description": "MapLibre GL + deck.gl reimplementation of the ixmaps-flat declarative mapping engine",
   "main": "ixmaps-gl.js",
   "browser": "ixmaps-gl.js",