@nika-js/onlymap 0.6.25 → 0.6.26

package/CHANGELOG.md

@@ -8,6 +8,15 @@ Note: npm collapsed a few closely-spaced releases — the GPX/FlatGeobuf (0.5.4)
 and GeoParquet (0.5.5) work shipped to npm together as **0.5.6**, so npm's
 version list jumps 0.5.3 → 0.5.6. Each logical version is listed here regardless.
 
+## 0.6.26 — 2026-09-02
+
+### Added
+- **Hovering an interactive feature now shows a pointer cursor.** The cheapest "this map is clickable" signal there is — recipients of a shared map no longer have to click at random to discover popups. `pick-cursor` on `<om-map>` customizes the cursor; `pick-cursor="none"` turns it off. (#33)
+- **A runtime popup switch per layer.** The new `set-pickable` action (`{layer, pickable: true|false|"3d"}`) turns a layer's picking — and with it popups, tooltips, and hover behaviors — on or off from a button, behavior, or story step. It's undoable and rewinds on story scrub like every scene action. (#31)
+
+### Changed
+- **Hover no longer stalls the map on modest hardware.** Hovering over layers used to run a GPU hit-test on every mouse move — measured at over a second of freeze per move on integrated graphics with real data. Hover now tests once when the pointer comes to rest instead of continuously while it sweeps, which makes hover popups usable on the machines shared maps are actually opened on. Hover-follow UIs that want the old per-move behavior can opt back in with `hover-pick="continuous"` (or a throttle interval like `hover-pick="120"`); clicking is unaffected. (#31)
+
 ## 0.6.25 — 2026-09-02
 
 ### Fixed

package/README.md

@@ -139,7 +139,9 @@ Private endpoints: `OmMap.configureData({ headers, credentials, fetch })` — ap
 
 ### Interaction
 
-Built-in actions wire to picks, widget buttons (`data-emit`), or script (`ctx.emit`) with one shared payload contract: `show-overlay`, `hide-overlay`, `show-tooltip`, `hide-tooltip`, `toggle-layer`, `highlight-feature`, `zoom-to-feature`, `filter-layer`, `set-basemap`, `zoom-in`, `zoom-out`, `undo`, `redo` — plus `OmMap.registerAction` for your own.
+Built-in actions wire to picks, widget buttons (`data-emit`), or script (`ctx.emit`) with one shared payload contract: `show-overlay`, `hide-overlay`, `show-tooltip`, `hide-tooltip`, `toggle-layer`, `set-pickable` (a runtime popups-on/off switch per layer), `highlight-feature`, `zoom-to-feature`, `filter-layer`, `set-basemap`, `zoom-in`, `zoom-out`, `undo`, `redo` — plus `OmMap.registerAction` for your own.
+
+Hovering a pickable feature shows a pointer cursor automatically, so recipients can tell a map is interactive without clicking at random (`pick-cursor` on `<om-map>` customizes or disables it). Hover GPU picking is rest-debounced by default — one pick when the pointer stops instead of one per mouse move — which keeps hover popups smooth even on integrated graphics; `hover-pick="continuous|off|<ms>"` tunes it.
 
 **Undo/redo:** user-facing manifest changes — layer toggles, filter changes, basemap switches, element edits, drawn sketches — are undoable out of the box; the manifest *is* the state, so history is recorded from the DOM itself. Add `<om-widget type="undo-redo">` for buttons, or just press Cmd/Ctrl-Z (Shift-Cmd/Ctrl-Z or Ctrl-Y to redo). Camera moves, hover effects, and story playback are deliberately not undo steps.
 

package/dist/{LercDecode.es-DNwkPiJw.js → LercDecode.es-B4KknLMs.js}

@@ -19,7 +19,7 @@ async function v(N = {}) {
   if (n) {
     const { createRequire: I } = await import(
       /*webpackIgnore:true*/
-      "./lerc-CkqppWZk.js"
+      "./lerc-BNW5A6zN.js"
     ).then((g) => g._);
     var O = I(import.meta.url);
   }

package/dist/{basemap-Da9yotkI.js → basemap-C4bmWq6M.js}

@@ -1,4 +1,4 @@
-import { C as ny, L as sy, M as oy, m as ay, c as ka, a as Sd, z as oc, G as sm, V as ly, W as cy, b as uy, g as hy, d as Vu, f as Ed, e as dy, l as py, u as fy, D as Qf, h as my } from "./index-CPf0evzb.js";
+import { C as ny, L as sy, M as oy, m as ay, c as ka, a as Sd, z as oc, G as sm, V as ly, W as cy, b as uy, g as hy, d as Vu, f as Ed, e as dy, l as py, u as fy, D as Qf, h as my } from "./index-COuIQk2Z.js";
 const Cd = Math.PI / 180, gy = 180 / Math.PI;
 function em(Pe, J = 0) {
   const me = Math.min(180, Pe) * Cd;
@@ -25169,6 +25169,14 @@ class Ry {
   markBusy() {
     this.idleLatch = !1;
   }
+  /** The overlay's internal Deck instance — the hover-pick gate wraps its pointermove handler (issue #31); same exact-pin `_deck` seam as getDeckLayers below. */
+  getOverlayDeckInternal() {
+    return this.overlay._deck;
+  }
+  /** The MapLibre canvas — the pick-cursor affordance writes its cursor style (issue #33). */
+  getCanvasElement() {
+    return this.map.getCanvas();
+  }
   /** The overlay deck's live layers — whenSettled's readiness gate (issue #37). */
   getDeckLayers() {
     return this.overlay._deck?.getLayers?.();

package/dist/basemap.d.ts

@@ -67,6 +67,10 @@ export declare class MapLibreBasemapAdapter {
     isIdle(): boolean;
     /** Camera writes from OUR side must clear the latch immediately — the map's own movestart fires a tick later, and a settle read in that gap would see stale idle. */
     private markBusy;
+    /** The overlay's internal Deck instance — the hover-pick gate wraps its pointermove handler (issue #31); same exact-pin `_deck` seam as getDeckLayers below. */
+    getOverlayDeckInternal(): unknown;
+    /** The MapLibre canvas — the pick-cursor affordance writes its cursor style (issue #33). */
+    getCanvasElement(): HTMLElement;
     /** The overlay deck's live layers — whenSettled's readiness gate (issue #37). */
     getDeckLayers(): {
         isLoaded: boolean;

package/dist/{geoparquet-D8-txekS.js → geoparquet-BPMda753.js}

@@ -1,4 +1,4 @@
-import { r as p, n as d } from "./index-CPf0evzb.js";
+import { r as p, n as d } from "./index-COuIQk2Z.js";
 function g(t) {
   if (t == null) return !0;
   const e = t, n = e.id?.code;

package/dist/hover-pick.d.ts

@@ -0,0 +1,53 @@
+/**
+ * Hover-pick gating (public issue #31). deck.gl picks the scene on EVERY
+ * animation frame that saw a pointer move — a full render to the picking
+ * framebuffer plus a GPU→CPU ReadPixels round-trip. On integrated graphics
+ * with real layers that measured ~1,145ms of main-thread stall per mouse
+ * move (850× the pickable="false" baseline), making any map with popups
+ * unusable on exactly the hardware map RECIPIENTS have.
+ *
+ * deck exposes no cadence knob, but `deck._onPointerMove` is an assignable
+ * instance property and the deck dependency is an EXACT pin (the
+ * `overlay._deck` / `_cacheBytes` seam precedent) — so the gate wraps it:
+ *
+ * - `rest` (the default): pointer moves are held until the pointer RESTS
+ *   (restMs without further movement), then the LAST move is forwarded —
+ *   one pick per rest instead of one per frame. Fast sweeps across the map
+ *   cost zero picks; stopping on a feature picks once. Hover popups appear
+ *   on rest, which is when a human is asking "what is this?" anyway.
+ * - a NUMBER (ms): leading + trailing throttle — an immediate pick, then at
+ *   most one per interval while moving, plus the rest pick. For authors who
+ *   want livelier hover-follow at a bounded cost.
+ * - `continuous`: deck's native behavior, unwrapped cadence.
+ * - `off`: hover picking disabled entirely (click picking is a separate
+ *   deck path and is unaffected).
+ *
+ * Always forwarded regardless of policy: `pointerleave` (clears hover
+ * state) and button-down moves (deck's own drag handling early-returns on
+ * those, and gizmo drags depend on the stream).
+ *
+ * Pure and dependency-injected (timers/clock) so the policy is unit-testable
+ * without deck or a DOM.
+ */
+export type HoverPickMode = "rest" | "continuous" | "off" | number;
+export interface HoverGateTimers {
+    set(fn: () => void, ms: number): unknown;
+    clear(handle: unknown): void;
+    now(): number;
+}
+/** How long the pointer must sit still before the rest pick fires. One-ish frame of stillness reads as "stopped" without feeling laggy. */
+export declare const HOVER_REST_MS = 32;
+interface PointerMoveLike {
+    type?: string;
+    leftButton?: boolean;
+    rightButton?: boolean;
+}
+/**
+ * Wraps a deck-shaped `_onPointerMove` with the gating policy. `policy` is a
+ * GETTER so an attribute edit applies to the very next move with no
+ * re-wrapping; `forward` is deck's original handler.
+ */
+export declare function createHoverGate<E extends PointerMoveLike>(forward: (event: E) => void, policy: () => HoverPickMode, timers?: HoverGateTimers): (event: E) => void;
+/** Parses the `hover-pick` attribute (null/absent → the rest default; unknown values warn and fall back). */
+export declare function parseHoverPickMode(raw: string | null, warnLabel: string): HoverPickMode;
+export {};

package/dist/html-data.d.ts

@@ -15,7 +15,7 @@ interface TagData {
     }[];
 }
 /** Hand-authored action list — validated against hasAction() in html-data.test.ts. */
-export declare const BUILTIN_ACTIONS: readonly ["toggle-layer", "zoom-in", "zoom-out", "filter-layer", "highlight-feature", "fade", "pulse", "populate", "trace", "story-play", "story-pause", "story-seek", "fly-to", "zoom-to-feature", "show-overlay", "hide-overlay", "show-tooltip", "hide-tooltip", "draw-mode", "draw-commit", "draw-cancel", "draw-delete", "draw-clear", "draw-config", "draw-save", "export-region-3d", "measure-mode", "measure-clear", "measure-units", "set-basemap", "set-lighting", "set-terrain", "set-clip-box", "clip-box-edit", "set-widgets-visible", "undo", "redo", "warm-tiles"];
+export declare const BUILTIN_ACTIONS: readonly ["toggle-layer", "set-pickable", "zoom-in", "zoom-out", "filter-layer", "highlight-feature", "fade", "pulse", "populate", "trace", "story-play", "story-pause", "story-seek", "fly-to", "zoom-to-feature", "show-overlay", "hide-overlay", "show-tooltip", "hide-tooltip", "draw-mode", "draw-commit", "draw-cancel", "draw-delete", "draw-clear", "draw-config", "draw-save", "export-region-3d", "measure-mode", "measure-clear", "measure-units", "set-basemap", "set-lighting", "set-terrain", "set-clip-box", "clip-box-edit", "set-widgets-visible", "undo", "redo", "warm-tiles"];
 /** Hand-authored widget types — validated against the widget registry in html-data.test.ts. */
 export declare const BUILTIN_WIDGETS: readonly ["legend", "layer-switcher", "zoom-controls", "scale-bar", "attribution", "filter", "vega-lite", "dynamic-chart", "player", "draw", "measure", "basemap-switcher", "lighting", "clip-box", "undo-redo", "widgets-toggle", "time-slider", "ifc-browser", "ifc-legend", "feature-inspector", "ifc-inspector", "ifc-loader", "ifc-clash"];
 export declare function buildHtmlCustomData(): {

package/dist/{index-Z6ZPKbXa.js → index-B5hsHnPl.js}

@@ -1,4 +1,4 @@
-import { ag as Be, ah as le, ai as ce, aj as De, ak as Oe, al as ke } from "./index-CPf0evzb.js";
+import { ag as Be, ah as le, ai as ce, aj as De, ak as Oe, al as ke } from "./index-COuIQk2Z.js";
 import { y as ve, a as he, z as G, R as J, A as ue, C as Fe, F as je, n as xe, S as Ie, E as Ne } from "./recordbatch-Bpc0uxFn.js";
 import { g as V, a as fe, b as Le, c as Ue, d as Me, e as qe, m as Ve } from "./table-accessors-CYWTzpQI.js";
 import { c as $e } from "./convert-arrow-schema-DrAihRf9.js";