@nika-js/onlymap 0.4.1 → 0.4.2

package/dist/onlymapjs.js

@@ -1,4 +1,4 @@
-import { ay as e, az as r, aA as o, aB as t, aC as i, aq as n, aD as b, aE as l, aF as S, aG as L, aH as p, aI as c, aJ as g, aK as m, aL as T, aM as y, aN as E, ap as A, aO as I, ax as u, aP as d, W as M, aQ as _, aR as C, aS as D, aT as O, aU as f, aV as x, aW as N, aX as h, aY as B, aZ as G, a_ as R, a$ as W, b0 as v, b1 as w, b2 as Y, b3 as F, b4 as P, b5 as k, b6 as z, b7 as H, b8 as J, b9 as V, ba as q, bb as K, bc as U, bd as j, be as Q, bf as X, bg as Z, bh as $, bi as aa, bj as sa, bk as ea, bl as ra, bm as oa, bn as ta, bo as ia, bp as na, bq as ba, br as la, bs as Sa, bt as La } from "./index-BKiyX-jQ.js";
+import { ay as e, az as r, aA as o, aB as t, aC as i, aq as n, aD as b, aE as l, aF as S, aG as L, aH as p, aI as c, aJ as g, aK as m, aL as T, aM as y, aN as E, ap as A, aO as I, ax as u, aP as d, W as M, aQ as _, aR as C, aS as D, aT as O, aU as f, aV as x, aW as N, aX as h, aY as B, aZ as G, a_ as R, a$ as W, b0 as v, b1 as w, b2 as Y, b3 as F, b4 as P, b5 as k, b6 as z, b7 as H, b8 as J, b9 as V, ba as q, bb as K, bc as U, bd as j, be as Q, bf as X, bg as Z, bh as $, bi as aa, bj as sa, bk as ea, bl as ra, bm as oa, bn as ta, bo as ia, bp as na, bq as ba, br as la, bs as Sa, bt as La } from "./index-ULsb51al.js";
 export {
   e as ALL_POSITION_VALUES,
   r as AccessorCache,

package/dist/{raster-xUPg8Z-C.js → raster-CXnE4ZJp.js}

@@ -1,5 +1,5 @@
 import { w as kt, t as Ni, f as Oi, m as Ri } from "./mgrs-BY9bIvp4.js";
-import { an as Fi, ao as zi, ap as Ks, aq as Ws, ar as Di, b as Bi, as as Ui, l as es, at as ki, d as qi, au as Ki, av as Wi, aw as Xi, ax as Xs } from "./index-BKiyX-jQ.js";
+import { an as Fi, ao as zi, ap as Ks, aq as Ws, ar as Di, b as Bi, as as Ui, l as es, at as ki, d as qi, au as Ki, av as Wi, aw as Xi, ax as Xs } from "./index-ULsb51al.js";
 function Hi(t, e, s) {
   const { projectedCorners: i } = e, { topLeft: a, topRight: r, bottomRight: o, bottomLeft: n } = i, h = s(a[0], a[1]), l = s(r[0], r[1]), c = s(o[0], o[1]), u = s(n[0], n[1]), d = [
     h,
@@ -2377,7 +2377,7 @@ it.set(G.Zstd, () => import("./zstd-jXobGRcq.js").then((t) => t.decode));
 it.set(G.Jpeg, () => Promise.resolve(ke));
 it.set(G.Jpeg6, () => Promise.resolve(ke));
 it.set(G.Webp, () => Promise.resolve(ke));
-it.set(G.Lerc, () => import("./lerc-filCwJiM.js").then((t) => t.l).then((t) => t.decode));
+it.set(G.Lerc, () => import("./lerc-DsrKzmOh.js").then((t) => t.l).then((t) => t.decode));
 async function qe(t, e, s) {
   const i = it.get(e);
   if (!i)

package/dist/react/om-map.d.ts

@@ -20,6 +20,8 @@ export interface OmMapProps {
     };
     /** Layout-token sugar, the `widget-style` attribute's twin: `"gap:10 opacity:0.9"` → `--om-widget-*` custom properties on the widget layer. */
     widgetStyle?: string;
+    /** Hide-all, the `widgets-hidden` attribute's twin: hides every slot container (visibility, not removal — widget state survives). MapLibre's attribution control is outside the layer and never hides. */
+    widgetsHidden?: boolean;
     className?: string;
     style?: CSSProperties;
     children?: ReactNode;

package/dist/react.js

@@ -1,143 +1,144 @@
-var X = Object.defineProperty;
-var Z = (t, e, n) => e in t ? X(t, e, { enumerable: !0, configurable: !0, writable: !0, value: n }) : t[e] = n;
-var B = (t, e, n) => Z(t, typeof e != "symbol" ? e + "" : e, n);
-import { jsxs as ee, jsx as O } from "react/jsx-runtime";
-import { createContext as te, useContext as re, forwardRef as ne, useRef as g, useState as N, useCallback as se, useMemo as x, useLayoutEffect as oe, useEffect as w, useImperativeHandle as ie, useSyncExternalStore as H } from "react";
-import { MANAGED_SLOTS as ae, slotContainerStyle as ce, MapController as le, parseWidgetStyle as ue, resolveSlot as fe, isStoreToken as de } from "@nika-js/onlymap";
-import { createPortal as J } from "react-dom";
-const Y = te(null);
-function $(t) {
-  const e = re(Y);
+var Z = Object.defineProperty;
+var ee = (t, e, n) => e in t ? Z(t, e, { enumerable: !0, configurable: !0, writable: !0, value: n }) : t[e] = n;
+var B = (t, e, n) => ee(t, typeof e != "symbol" ? e + "" : e, n);
+import { jsxs as te, jsx as w } from "react/jsx-runtime";
+import { createContext as re, useContext as ne, forwardRef as se, useRef as m, useState as V, useCallback as oe, useMemo as x, useLayoutEffect as ie, useEffect as E, useImperativeHandle as ae, useSyncExternalStore as J } from "react";
+import { MANAGED_SLOTS as ce, slotContainerStyle as le, MapController as ue, parseWidgetStyle as de, resolveSlot as fe, isStoreToken as ye } from "@nika-js/onlymap";
+import { createPortal as Y } from "react-dom";
+const Q = re(null);
+function z(t) {
+  const e = ne(Q);
   if (!e) throw new Error(`[onlymapjs] ${t} must be rendered inside <OmMap>.`);
   return e;
 }
-function V(t, e) {
+function W(t, e) {
   if (t === e) return !0;
   const n = Object.keys(t ?? {}), r = Object.keys(e ?? {});
   return n.length !== r.length ? !1 : n.every((l) => t[l] === e[l]);
 }
-function ye(t, e) {
-  const { props: n, updateTriggers: r, ...l } = t, { props: f, updateTriggers: c, ...s } = e;
-  return V(l, s) && V(n, f) && V(r, c);
+function me(t, e) {
+  const { props: n, updateTriggers: r, ...l } = t, { props: d, updateTriggers: c, ...o } = e;
+  return W(l, o) && W(n, d) && W(r, c);
 }
-class me {
+class ge {
   constructor(e) {
     B(this, "descriptors", /* @__PURE__ */ new Map());
     this.controller = e;
   }
   upsert(e) {
     const n = this.descriptors.get(e.id);
-    n && ye(n, e) || (this.descriptors.set(e.id, e), this.controller.setLayers([...this.descriptors.values()]));
+    n && me(n, e) || (this.descriptors.set(e.id, e), this.controller.setLayers([...this.descriptors.values()]));
   }
   remove(e) {
     this.descriptors.delete(e) && this.controller.setLayers([...this.descriptors.values()]);
   }
 }
-const I = ae, ge = Object.fromEntries(I.map((t) => [t, ce(t)]));
-function he(t, e) {
+const $ = ce, he = Object.fromEntries($.map((t) => [t, le(t)]));
+function be(t, e) {
   return Object.entries(e).some(([n, r]) => r !== void 0 && t[n] !== r);
 }
-const Re = ne(function(e, n) {
-  const { center: r, zoom: l, pitch: f, bearing: c, basemap: s, basemapKey: a, attribution: d, headless: u, widgetStyle: p, className: z, style: h, children: b } = e, y = g(null), [o, v] = N(null), [S, T] = N(null), [E, R] = N(
-    () => Object.fromEntries(I.map((i) => [i, null]))
-  ), k = se((i) => {
-    T((m) => m === i ? m : i);
-  }, []), j = x(
+const Ce = se(function(e, n) {
+  const { center: r, zoom: l, pitch: d, bearing: c, basemap: o, basemapKey: a, attribution: f, headless: u, widgetStyle: v, widgetsHidden: L, className: h, style: b, children: g } = e, p = m(null), [s, R] = V(null), [S, T] = V(null), [O, k] = V(
+    () => Object.fromEntries($.map((i) => [i, null]))
+  ), j = oe((i) => {
+    T((y) => y === i ? y : i);
+  }, []), P = x(
     () => Object.fromEntries(
-      I.map((i) => [
+      $.map((i) => [
         i,
-        (m) => {
-          R((M) => M[i] === m ? M : { ...M, [i]: m });
+        (y) => {
+          k((M) => M[i] === y ? M : { ...M, [i]: y });
         }
       ])
     ),
     []
-  ), L = g({ center: r, zoom: l, pitch: f, bearing: c });
-  L.current = { center: r, zoom: l, pitch: f, bearing: c };
-  const P = g(e.onReady);
-  P.current = e.onReady;
-  const C = g(e.onViewStateChange);
+  ), _ = m({ center: r, zoom: l, pitch: d, bearing: c });
+  _.current = { center: r, zoom: l, pitch: d, bearing: c };
+  const F = m(e.onReady);
+  F.current = e.onReady;
+  const C = m(e.onViewStateChange);
   C.current = e.onViewStateChange;
-  const F = g(e.onRuntimeError);
-  F.current = e.onRuntimeError;
-  const _ = g(s);
-  _.current = s;
-  const A = g(void 0), Q = u ? JSON.stringify(u) : "";
-  oe(() => {
-    if (!y.current) return;
-    const i = L.current;
-    A.current = _.current;
-    const m = new le(y.current, {
+  const K = m(e.onRuntimeError);
+  K.current = e.onRuntimeError;
+  const A = m(o);
+  A.current = o;
+  const D = m(void 0), U = u ? JSON.stringify(u) : "";
+  ie(() => {
+    if (!p.current) return;
+    const i = _.current;
+    D.current = A.current;
+    const y = new ue(p.current, {
       center: i.center,
       zoom: i.zoom,
       pitch: i.pitch,
       bearing: i.bearing,
-      basemap: _.current,
+      basemap: A.current,
       basemapKey: a,
-      attribution: d,
+      attribution: f,
       headless: u ? u === !0 ? {} : u : void 0,
-      onRuntimeError: (K) => {
+      onRuntimeError: (I) => {
         var q;
-        return (q = F.current) == null ? void 0 : q.call(F, K);
+        return (q = K.current) == null ? void 0 : q.call(K, I);
       }
     });
-    v(m);
+    R(y);
     let M = !0;
-    return m.ready.then(() => {
-      var K;
-      M && ((K = P.current) == null || K.call(P));
+    return y.ready.then(() => {
+      var I;
+      M && ((I = F.current) == null || I.call(F));
     }), () => {
-      M = !1, v(null), m.destroy();
+      M = !1, R(null), y.destroy();
     };
-  }, [Q]), w(() => {
-    !o || A.current === s || (A.current = s, o.setBasemap(s ?? null));
-  }, [o, s]), ie(n, () => o, [o]), w(() => {
-    if (!o) return;
-    const i = { longitude: r == null ? void 0 : r[0], latitude: r == null ? void 0 : r[1], zoom: l, pitch: f, bearing: c };
-    he(o.getViewState(), i) && o.setView(i);
-  }, [o, r == null ? void 0 : r[0], r == null ? void 0 : r[1], l, f, c]), w(() => {
+  }, [U]), E(() => {
+    !s || D.current === o || (D.current = o, s.setBasemap(o ?? null));
+  }, [s, o]), ae(n, () => s, [s]), E(() => {
+    if (!s) return;
+    const i = { longitude: r == null ? void 0 : r[0], latitude: r == null ? void 0 : r[1], zoom: l, pitch: d, bearing: c };
+    be(s.getViewState(), i) && s.setView(i);
+  }, [s, r == null ? void 0 : r[0], r == null ? void 0 : r[1], l, d, c]), E(() => {
     var i;
-    if (o)
-      return (i = C.current) == null || i.call(C, o.getViewState()), o.getStore("viewport").subscribe(() => {
-        var m;
-        return (m = C.current) == null ? void 0 : m.call(C, o.getViewState());
+    if (s)
+      return (i = C.current) == null || i.call(C, s.getViewState()), s.getStore("viewport").subscribe(() => {
+        var y;
+        return (y = C.current) == null ? void 0 : y.call(C, s.getViewState());
       });
-  }, [o]);
-  const U = x(
+  }, [s]);
+  const X = x(
     () => ({
       position: "absolute",
       inset: 0,
       zIndex: 20,
       pointerEvents: "none",
       opacity: "var(--om-widget-opacity, 1)",
-      ...p ? ue(p).properties : void 0
+      ...L ? { visibility: "hidden" } : void 0,
+      ...v ? de(v).properties : void 0
     }),
-    [p]
-  ), D = x(() => o ? new me(o) : null, [o]), W = x(
-    () => o && D && S ? { controller: o, layers: D, overlayPane: S, corners: E } : null,
-    [o, D, S, E]
+    [v, L]
+  ), N = x(() => s ? new ge(s) : null, [s]), H = x(
+    () => s && N && S ? { controller: s, layers: N, overlayPane: S, corners: O } : null,
+    [s, N, S, O]
   );
-  return /* @__PURE__ */ ee("div", { className: z, style: { position: "relative", overflow: "hidden", ...h }, children: [
-    /* @__PURE__ */ O("div", { ref: y, style: { position: "absolute", inset: 0 } }),
-    /* @__PURE__ */ O(
+  return /* @__PURE__ */ te("div", { className: h, style: { position: "relative", overflow: "hidden", ...b }, children: [
+    /* @__PURE__ */ w("div", { ref: p, style: { position: "absolute", inset: 0 } }),
+    /* @__PURE__ */ w(
       "div",
       {
-        ref: k,
+        ref: j,
         style: { position: "absolute", top: 0, left: 0, zIndex: 10, pointerEvents: "none" }
       }
     ),
-    /* @__PURE__ */ O("div", { "data-om-widget-layer": "", style: U, children: I.map((i) => /* @__PURE__ */ O(
+    /* @__PURE__ */ w("div", { "data-om-widget-layer": "", style: X, children: $.map((i) => /* @__PURE__ */ w(
       "div",
       {
         "data-om-widget-slot": i,
-        ref: j[i],
-        style: ge[i]
+        ref: P[i],
+        style: he[i]
       },
       i
     )) }),
-    W && /* @__PURE__ */ O(Y.Provider, { value: W, children: b })
+    H && /* @__PURE__ */ w(Q.Provider, { value: H, children: g })
   ] });
-}), be = /* @__PURE__ */ new Set([
+}), ve = /* @__PURE__ */ new Set([
   "id",
   "type",
   "data",
@@ -157,11 +158,11 @@ const Re = ne(function(e, n) {
   "onClick",
   "onHover"
 ]);
-function Ce(t) {
-  const { controller: e, layers: n } = $("OmLayer"), { id: r } = t, l = {};
-  for (const [a, d] of Object.entries(t))
-    !be.has(a) && d !== void 0 && (l[a] = d);
-  const f = {
+function xe(t) {
+  const { controller: e, layers: n } = z("OmLayer"), { id: r } = t, l = {};
+  for (const [a, f] of Object.entries(t))
+    !ve.has(a) && f !== void 0 && (l[a] = f);
+  const d = {
     id: r,
     type: t.type,
     data: t.data,
@@ -180,38 +181,38 @@ function Ce(t) {
     updateTriggers: t.updateTriggers,
     props: l
   };
-  w(() => {
-    n.upsert(f);
-  }), w(() => () => n.remove(r), [n, r]);
-  const c = g(t.onClick);
+  E(() => {
+    n.upsert(d);
+  }), E(() => () => n.remove(r), [n, r]);
+  const c = m(t.onClick);
   c.current = t.onClick;
-  const s = g(t.onHover);
-  return s.current = t.onHover, w(
+  const o = m(t.onHover);
+  return o.current = t.onHover, E(
     () => e.watchPicks((a) => {
-      var d, u, p;
+      var f, u, v;
       if (a === null) {
-        (d = s.current) == null || d.call(s, null);
+        (f = o.current) == null || f.call(o, null);
         return;
       }
-      a.layerId === r && (a.type === "click" ? (u = c.current) == null || u.call(c, a) : (p = s.current) == null || p.call(s, a));
+      a.layerId === r && (a.type === "click" ? (u = c.current) == null || u.call(c, a) : (v = o.current) == null || v.call(o, a));
     }),
     [e, r]
   ), null;
 }
-function xe({ position: t = "top-start", order: e, className: n, style: r, children: l }) {
-  const { corners: f } = $("OmWidget"), c = fe(t) ?? "top-start";
+function Te({ position: t = "top-start", order: e, className: n, style: r, children: l }) {
+  const { corners: d } = z("OmWidget"), c = fe(t) ?? "top-start";
   if (c === "manual")
-    return /* @__PURE__ */ O("div", { className: n, style: { pointerEvents: "auto", ...r }, children: l });
-  const s = f[c];
-  return s ? J(
-    /* @__PURE__ */ O("div", { className: n, style: { pointerEvents: "auto", ...e !== void 0 ? { order: e } : void 0, ...r }, children: l }),
-    s
+    return /* @__PURE__ */ w("div", { className: n, style: { pointerEvents: "auto", ...r }, children: l });
+  const o = d[c];
+  return o ? Y(
+    /* @__PURE__ */ w("div", { className: n, style: { pointerEvents: "auto", ...e !== void 0 ? { order: e } : void 0, ...r }, children: l }),
+    o
   ) : null;
 }
 function G(t, e) {
   return !e || (t == null ? void 0 : t.layerId) === e;
 }
-const ve = {
+const pe = {
   "top-left": "translate(0, 0)",
   "top-center": "translate(-50%, 0)",
   "top-right": "translate(-100%, 0)",
@@ -222,52 +223,52 @@ const ve = {
   "bottom-center": "translate(-50%, -100%)",
   "bottom-right": "translate(-100%, -100%)"
 };
-function Te(t) {
-  const { controller: e, overlayPane: n } = $("OmOverlay"), r = g(null), l = g(void 0), f = g(t);
-  f.current = t;
+function Me(t) {
+  const { controller: e, overlayPane: n } = z("OmOverlay"), r = m(null), l = m(void 0), d = m(t);
+  d.current = t;
   const c = x(() => {
     const h = e.getStore("selection");
-    let b, y, o = null;
+    let b, g, p = null;
     return {
       subscribe: h.subscribe,
       getSnapshot: () => {
-        const v = h.getSnapshot(), { anchorFrom: S, layer: T } = f.current, E = `${S ?? ""}|${T ?? ""}`;
-        return (v !== b || E !== y) && (b = v, y = E, S === "selection" && G(v, T) && (o = v)), o;
+        const s = h.getSnapshot(), { anchorFrom: R, layer: S } = d.current, T = `${R ?? ""}|${S ?? ""}`;
+        return (s !== b || T !== g) && (b = s, g = T, R === "selection" && G(s, S) && (p = s)), p;
       }
     };
-  }, [e]), s = H(
+  }, [e]), o = J(
     c.subscribe,
     c.getSnapshot,
     c.getSnapshot
   );
-  w(
+  E(
     () => e.registerOverlay((h, b) => {
-      const y = r.current;
-      if (!y) return;
-      const { anchor: o, anchorFrom: v, layer: S, visible: T = !0, anchorOffset: E } = f.current;
-      let R;
-      if (v === "selection" ? (G(b, S) && (l.current = (b == null ? void 0 : b.coordinate) ?? void 0), R = l.current) : R = o, !T || !R || !h) {
-        y.style.visibility = "hidden";
+      const g = r.current;
+      if (!g) return;
+      const { anchor: p, anchorFrom: s, layer: R, visible: S = !0, anchorOffset: T } = d.current;
+      let O;
+      if (s === "selection" ? (G(b, R) && (l.current = (b == null ? void 0 : b.coordinate) ?? void 0), O = l.current) : O = p, !S || !O || !h) {
+        g.style.visibility = "hidden";
         return;
       }
-      const [k, j, L] = h.project([R[0], R[1], 0]);
-      if (!(k >= 0 && k <= h.width && j >= 0 && j <= h.height) || L !== void 0 && L < 0) {
-        y.style.visibility = "hidden";
+      const [k, j, P] = h.project([O[0], O[1], 0]);
+      if (!(k >= 0 && k <= h.width && j >= 0 && j <= h.height) || P !== void 0 && P < 0) {
+        g.style.visibility = "hidden";
         return;
       }
-      y.style.visibility = "visible", y.style.transform = `translate(${k}px, ${j}px) ${ve[E ?? "bottom-center"]}`;
+      g.style.visibility = "visible", g.style.transform = `translate(${k}px, ${j}px) ${pe[T ?? "bottom-center"]}`;
     }),
     [e]
-  ), w(() => {
+  ), E(() => {
     e.refreshOverlays();
   });
-  const { children: a, className: d, style: u, interactive: p = !0 } = t, z = typeof a == "function" ? a(s) : a;
-  return J(
-    /* @__PURE__ */ O(
+  const { children: a, className: f, style: u, interactive: v = !0 } = t, L = typeof a == "function" ? a(o) : a;
+  return Y(
+    /* @__PURE__ */ w(
       "div",
       {
         ref: r,
-        className: d,
+        className: f,
         style: {
           position: "absolute",
           top: 0,
@@ -275,38 +276,38 @@ function Te(t) {
           visibility: "hidden",
           // hidden until the first flush positions it — never flashes at the origin
           willChange: "transform",
-          pointerEvents: p ? "auto" : "none",
+          pointerEvents: v ? "auto" : "none",
           ...u
         },
-        children: z
+        children: L
       }
     ),
     n
   );
 }
-function Me(t = []) {
-  const { controller: e } = $("useOmMap"), n = t.join(" "), r = x(() => {
-    const c = (n ? n.split(" ") : []).flatMap((a) => de(a) ? [e.getStore(a)] : (console.warn(`[onlymapjs] useOmMap: "${a}" is not a watch token on the React front-end — expected viewport, selection, layers, or data:<layerId>.`), []));
-    let s;
+function ke(t = []) {
+  const { controller: e } = z("useOmMap"), n = t.join(" "), r = x(() => {
+    const c = (n ? n.split(" ") : []).flatMap((a) => ye(a) ? [e.getStore(a)] : (console.warn(`[onlymapjs] useOmMap: "${a}" is not a watch token on the React front-end — expected viewport, selection, layers, or data:<layerId>.`), []));
+    let o;
     return {
       subscribe: (a) => {
-        const d = c.map((u) => u.subscribe(a));
+        const f = c.map((u) => u.subscribe(a));
         return () => {
-          for (const u of d) u();
+          for (const u of f) u();
         };
       },
       getSnapshot: () => {
-        const a = c.map((d) => d.getSnapshot());
-        return (!s || a.some((d, u) => d !== s[u])) && (s = a), s;
+        const a = c.map((f) => f.getSnapshot());
+        return (!o || a.some((f, u) => f !== o[u])) && (o = a), o;
       }
     };
-  }, [e, n]), l = H(r.subscribe, r.getSnapshot, r.getSnapshot);
+  }, [e, n]), l = J(r.subscribe, r.getSnapshot, r.getSnapshot);
   return x(() => e.buildCtx(), [e, l]);
 }
 export {
-  Ce as OmLayer,
-  Re as OmMap,
-  Te as OmOverlay,
-  xe as OmWidget,
-  Me as useOmMap
+  xe as OmLayer,
+  Ce as OmMap,
+  Me as OmOverlay,
+  Te as OmWidget,
+  ke as useOmMap
 };

package/dist/version.d.ts

@@ -5,4 +5,4 @@
  * the build rootDir, and a `define` would need repeating across vite/vitest/
  * vite-node configs.
  */
-export declare const LIBRARY_VERSION = "0.4.1";
+export declare const LIBRARY_VERSION = "0.4.2";

package/dist/widget-registry.d.ts

@@ -19,7 +19,27 @@ export interface WidgetHost {
 export interface WidgetImpl {
     /** Default watch tokens when the element has no `watch` attribute. */
     watch?: string[];
+    /**
+     * Compact button widget (spec: "Widget Layout Manager / Button
+     * clustering") — adjacent compact widgets in one slot auto-merge into a
+     * single visual control group (shared rounded container, dividers, one
+     * shadow). Per-widget opt-out: `cluster="false"`. Non-compact widgets
+     * (panels: legend, filter, search) never cluster.
+     */
+    compact?: boolean;
+    /**
+     * Never affected by hide-all (spec: "Widget Layout Manager / Hide-all") —
+     * `widgets-hidden` leaves this widget visible. Attribution declares it
+     * (license compliance) and so does the widgets-toggle button (it must
+     * stay clickable to un-hide). Third-party always-visible chrome sets it
+     * here rather than the core hardcoding a type list.
+     */
+    neverHides?: boolean;
     render(ctx: RuntimeContext, host: WidgetHost): void | Promise<void>;
 }
+/** Clusterable (spec: "Widget Layout Manager") — the type is compact AND the author didn't opt out. One predicate for the cluster pass AND the validation lint. */
+export declare function isClusterableWidget(el: Element): boolean;
+/** Exempt from hide-all — the type declares `neverHides` (attribution, widgets-toggle). */
+export declare function widgetNeverHides(type: string | null): boolean;
 export declare function registerWidget(name: string, impl: WidgetImpl): void;
 export declare function getWidget(name: string): WidgetImpl | undefined;

package/llms.txt

@@ -24,9 +24,9 @@ OnlyMapJS is NOT raw deck.gl and NOT generic HTML/JSX. The rules below are the d
 
 ## Element vocabulary
 
-- `<om-map center="[lng, lat]" zoom="11" pitch="55" bearing="20" basemap="positron">` — the root. `basemap` accepts a free preset (`liberty`, `bright`, `positron`, `dark-matter`, `voyager`, `osm` — no keys; or `maptiler-streets`/`maptiler-dataviz`/`maptiler-satellite` with `basemap-key="…"` or `OmMap.configureBasemap({ maptilerKey })`), `maplibre` (bare demo style), a style URL (e.g. a MapTiler-customized style; any scheme fetch supports, including desktop asset protocols like Tauri's, query strings fine), or `none` (standalone canvas). The attribute is LIVE — writing it switches the basemap in place (camera + layers survive); the `set-basemap {basemap}` action and `<om-widget type="basemap-switcher" options="positron dark-matter osm">` do the same. Register more via `OmMap.registerBasemap(name, { style })`. Required provider attribution renders automatically (`attribution="false"` opts out). `pitch`/`bearing` tilt the initial camera (use for 3D content). Terrain: `terrain="terrarium"` (keyless AWS DEM; also `maptiler-terrain` with a key, a raw `{z}/{x}/{y}` DEM URL + `terrain-decoder="terrarium|mapbox-rgb|<JSON>"`, or `off`) raises a 3D surface — geographic layers DRAPE onto it automatically (per-layer `terrain="drape|offset|off"` overrides; 3D-model layers sit ON it), `terrain-exaggeration` scales relief, `terrain-texture` drapes imagery; terrain REPLACES an active basemap while on (restored when off); `set-terrain` action, `terrain` watch token, `OmMap.registerTerrain(name, {...})` for more sources. Scene lighting for 3D content: `lighting="daylight|studio|flat|custom"` (absent = deck defaults) with `lighting-ambient`/`lighting-sun`/`lighting-sun-azimuth`/`lighting-sun-elevation`/`lighting-camera` overrides and `lighting-sun-date` (ISO/epoch — solar-position sun computed at the map center, wins over azimuth/elevation); attribute-backed (undoable, live-editable), story-steppable via the `set-lighting {lighting, sunAzimuth, ...}` action (`lighting="default"` removes the attribute set; a bare preset is a clean reset — stale overrides clear), native UI via `<om-widget type="lighting">` (preset radios + tuning sliders), widget watch token `lighting`. GeoJsonLayer extrudes polygons declaratively: `extruded get-elevation="$height"` (+ `wireframe`). `validate` attribute enables live validation + on-page error panel. Include a `map-id="<random UUID>"` on complete pages (identifies the map artifact for usage telemetry — not a visitor id; the page author deletes it to opt out); `telemetry="off"` disables usage telemetry + library-error reporting for the map (global: `OmMap.configureTelemetry({ disabled: true })`; schema: docs/telemetry.md). Free plan limits: 5 layers, 25k rows per layer — layers past a limit don't render and validation says why; a `license-key="om_live_…"` attribute (publishable, origin-restricted) or `OmMap.configureLicense(key)` lifts limits and removes the corner badge. When a user's map exceeds free limits, say so and point at the validation message rather than silently restructuring their data. Events on the element: `om-map-ready` (boot complete; `await mapEl.ready` is the promise twin), `om-validation-error`, `om-view-changed` (camera settled after a move, debounced; `detail = {longitude, latitude, zoom, pitch, bearing, origin}` where `origin` is `"user"` for gesture bursts vs `"programmatic"` for API/story moves — the camera-persistence hook, and the echo-suppression signal when syncing camera state to an app store). `await mapEl.snapshot()` returns a canvas-only PNG dataURL of the scene (basemap + layers at device pixels; `{as:"blob"}` for files) — DOM widgets/overlays/attribution are NOT captured, so exports must render provider credits themselves.
+- `<om-map center="[lng, lat]" zoom="11" pitch="55" bearing="20" basemap="positron">` — the root. `basemap` accepts a free preset (`liberty`, `bright`, `positron`, `dark-matter`, `voyager`, `osm` — no keys; or `maptiler-streets`/`maptiler-dataviz`/`maptiler-satellite` with `basemap-key="…"` or `OmMap.configureBasemap({ maptilerKey })`), `maplibre` (bare demo style), a style URL (e.g. a MapTiler-customized style; any scheme fetch supports, including desktop asset protocols like Tauri's, query strings fine), or `none` (standalone canvas). The attribute is LIVE — writing it switches the basemap in place (camera + layers survive); the `set-basemap {basemap}` action and `<om-widget type="basemap-switcher" options="positron dark-matter osm">` do the same. Register more via `OmMap.registerBasemap(name, { style })`. Required provider attribution renders automatically (`attribution="false"` opts out). `pitch`/`bearing` tilt the initial camera (use for 3D content). Terrain: `terrain="terrarium"` (keyless AWS DEM; also `maptiler-terrain` with a key, a raw `{z}/{x}/{y}` DEM URL + `terrain-decoder="terrarium|mapbox-rgb|<JSON>"`, or `off`) raises a 3D surface — geographic layers DRAPE onto it automatically (per-layer `terrain="drape|offset|off"` overrides; 3D-model layers sit ON it), `terrain-exaggeration` scales relief, `terrain-texture` drapes imagery; terrain REPLACES an active basemap while on (restored when off); `set-terrain` action, `terrain` watch token, `OmMap.registerTerrain(name, {...})` for more sources. Scene lighting for 3D content: `lighting="daylight|studio|flat|custom"` (absent = deck defaults) with `lighting-ambient`/`lighting-sun`/`lighting-sun-azimuth`/`lighting-sun-elevation`/`lighting-camera` overrides and `lighting-sun-date` (ISO/epoch — solar-position sun computed at the map center, wins over azimuth/elevation); attribute-backed (undoable, live-editable), story-steppable via the `set-lighting {lighting, sunAzimuth, ...}` action (`lighting="default"` removes the attribute set; a bare preset is a clean reset — stale overrides clear), native UI via `<om-widget type="lighting">` (preset radios + tuning sliders), widget watch token `lighting`. GeoJsonLayer extrudes polygons declaratively: `extruded get-elevation="$height"` (+ `wireframe`). `widgets-hidden` attribute (or the `set-widgets-visible {visible}` action / `<om-widget type="widgets-toggle">` button) hides every widget WITHOUT destroying state — attribution never hides (license); transient (not an undo step) but story-steppable, so a step can clear chrome for a cinematic take. `validate` attribute enables live validation + on-page error panel. Include a `map-id="<random UUID>"` on complete pages (identifies the map artifact for usage telemetry — not a visitor id; the page author deletes it to opt out); `telemetry="off"` disables usage telemetry + library-error reporting for the map (global: `OmMap.configureTelemetry({ disabled: true })`; schema: docs/telemetry.md). Free plan limits: 5 layers, 25k rows per layer — layers past a limit don't render and validation says why; a `license-key="om_live_…"` attribute (publishable, origin-restricted) or `OmMap.configureLicense(key)` lifts limits and removes the corner badge. When a user's map exceeds free limits, say so and point at the validation message rather than silently restructuring their data. Events on the element: `om-map-ready` (boot complete; `await mapEl.ready` is the promise twin), `om-validation-error`, `om-view-changed` (camera settled after a move, debounced; `detail = {longitude, latitude, zoom, pitch, bearing, origin}` where `origin` is `"user"` for gesture bursts vs `"programmatic"` for API/story moves — the camera-persistence hook, and the echo-suppression signal when syncing camera state to an app store). `await mapEl.snapshot()` returns a canvas-only PNG dataURL of the scene (basemap + layers at device pixels; `{as:"blob"}` for files) — DOM widgets/overlays/attribution are NOT captured, so exports must render provider credits themselves.
 - `<om-layer id="..." type="ScatterplotLayer" data="./points.json">` — any deck.gl layer class by `type` (all 33 bundled, plus the native `COGLayer` raster type), plus `PopupLayer` (WebGL badges/labels at scale: `layout="badge|pin-label|card"`, `min-zoom`/`max-zoom`). Every type's full attribute list ships in the package's `onlymapjs.html-data.json` — consult it instead of guessing attribute names or reading the minified dist. TextLayer's default font atlas covers ASCII only: set `character-set` when label text carries other glyphs (`—`, `·`, accents) or deck warns and renders them blank. External layer classes register via `OmMap.registerLayer({type, deckClass, props})` — build them on `@nika-js/onlymap/deck` (the bundled `CompositeLayer`/`TileLayer`/… re-exports), never a separately-installed deck.gl (different class hierarchy, breaks in the renderer); function-valued props ride the subclass's `static defaultProps`; register at module top level BEFORE the manifest mounts (see docs/custom-layers.md). Data: `data` URL (JSON, GeoJSON, CSV/TSV `.csv` — parsed to typed columns — Shapefile `.shp` (+`.dbf` attributes) and KML `.kml` as GeoJSON features, or Arrow IPC `.arrow`/`.feather` — large point datasets stay columnar, GeoArrow line/polygon geometry becomes GeoJSON features, zstd-compressed IPC is handled; other formats plug in via `OmMap.registerFormat({match, parse})`; data URLs accept any scheme the runtime's fetch supports — desktop webviews (Tauri, Electron) pass asset-protocol URLs straight in), inline `<script type="application/json">` (row arrays or column-oriented `{"columns": {"lon": [...], "lat": [...]}}`; must be a DIRECT child of the `<om-layer>`, and when present it wins — omit the `data` attribute), or `wss://` streaming (`key="mmsi"` upserts entities in place, `flush="250ms"` coalesces bursts, `source="name"` selects a `OmMap.registerSource` decoder plugin), or a polled REST snapshot (`refresh="5s"` re-fetches and replaces — for live endpoints that return the full current state). Authenticated endpoints: call `OmMap.configureData({ headers: {...} })` in a script — never put tokens in attributes. `$field` accessors work identically on all of them — never write column-index code yourself. One columnar restriction: the `js` full-JS opt-in is not allowed on Arrow/columnar layers (validation will tell you; use `$field` accessors instead). For 3D models use `type="ScenegraphLayer"` with `scenegraph="./model.glb"` (required) and `get-orientation="[0, $heading, 90]"` — the roll of 90 stands Y-up glTF models upright; see docs/3d-assets.md. GeoTIFF/COG rasters use `type="COGLayer"` with `src="./dem.tif"` (NOT `data` — rasters stream tiles by Range request, they are not parsed rows): `min`/`max` set the rescale window (default 0–255; ALWAYS set them for float/16-bit data like DEMs), `colormap` picks a bundled ramp for single-band sources (gray, viridis, plasma, inferno, magma, cividis, rdylgn, rdbu, spectral, terrain, jet, turbo), `nodata` overrides the source sentinel (renders transparent); plain 8-bit RGB COGs need no styling attributes; restretch/recolor are GPU uniforms (no refetch) and the legend ramp derives from colormap+min/max automatically. Sources must be Cloud-Optimized (`gdal_translate -of COG` otherwise).
-- `<om-widget type="legend|layer-switcher|basemap-switcher|lighting|zoom-controls|undo-redo|scale-bar|attribution|filter|vega-lite" position="bottom-end">` — static UI panels. `position` takes one of 8 managed slots (logical, RTL-aware: `top-start|top-center|top-end|center-start|center-end|bottom-start|bottom-center|bottom-end`; legacy corners `top-left` etc. alias) — same-slot widgets stack with flush edges and a shared gap (never overlap); `order="1"` orders within a slot; `position="manual"` renders a plain block you place with your own CSS (even outside the map). Layout tokens on `<om-map>`: `widget-style="gap:10 opacity:0.9 inset:16"` (keys inset/gap/inset-x/-y/gap-x/-y/opacity/radius/size, px except opacity) or the `--om-widget-inset-x/-y/-gap-x/-y/-opacity/-radius` custom properties. Built-ins are themeable from page CSS via custom properties (they inherit through the shadow root): `om-map { --om-widget-bg: #111827; --om-widget-fg: #f9fafb; }` — full set: `--om-widget-bg/-fg/-muted/-border/-hover-bg/-accent`; scope to a single widget with an `om-widget[type=legend]` selector instead. No `type` + HTML + `<script type="om/widget">` = custom widget with `ctx` (`ctx.layers`, `ctx.data(id)`, `ctx.dataInViewport(id)`, `ctx.stats(id, field)`, `ctx.viewport`, `ctx.selection`, `ctx.emit(action, payload)`), `this.watch = ['data:<layerId>', 'viewport', 'selection', 'layers', 'history', 'basemap']` (`layers` also fires on visibility/filter changes; `basemap` on basemap switches; `history` on undo/redo availability), `this.$(sel)`, `vegaEmbed`/`d3` as globals.
+- `<om-widget type="legend|layer-switcher|basemap-switcher|lighting|zoom-controls|undo-redo|scale-bar|attribution|filter|vega-lite" position="bottom-end">` — static UI panels. `position` takes one of 8 managed slots (logical, RTL-aware: `top-start|top-center|top-end|center-start|center-end|bottom-start|bottom-center|bottom-end`; legacy corners `top-left` etc. alias) — same-slot widgets stack with flush edges and a shared gap (never overlap); `order="1"` orders within a slot; adjacent compact button widgets (zoom-controls, undo-redo, widgets-toggle) auto-merge into ONE control group with dividers (`cluster="false"` opts a widget out); `position="manual"` renders a plain block you place with your own CSS (even outside the map). Layout tokens on `<om-map>`: `widget-style="gap:10 opacity:0.9 inset:16"` (keys inset/gap/inset-x/-y/gap-x/-y/opacity/radius/size, px except opacity) or the `--om-widget-inset-x/-y/-gap-x/-y/-opacity/-radius` custom properties. Built-ins are themeable from page CSS via custom properties (they inherit through the shadow root): `om-map { --om-widget-bg: #111827; --om-widget-fg: #f9fafb; }` — full set: `--om-widget-bg/-fg/-muted/-border/-hover-bg/-accent`; scope to a single widget with an `om-widget[type=legend]` selector instead. No `type` + HTML + `<script type="om/widget">` = custom widget with `ctx` (`ctx.layers`, `ctx.data(id)`, `ctx.dataInViewport(id)`, `ctx.stats(id, field)`, `ctx.viewport`, `ctx.selection`, `ctx.emit(action, payload)`), `this.watch = ['data:<layerId>', 'viewport', 'selection', 'layers', 'history', 'basemap']` (`layers` also fires on visibility/filter changes; `basemap` on basemap switches; `history` on undo/redo availability), `this.$(sel)`, `vegaEmbed`/`d3` as globals.
 - `<om-overlay id="..." anchor-from="selection">` — rich geo-anchored HTML (≤ ~20 per map). Anchors: `anchor="[lng, lat]"` (static), `anchor-from="selection"` (follows picks), or `anchor-layer="regions" anchor-feature-id="mission"` (anchored to a feature's own geometry — bbox center — no coordinates in markup; `{{field}}` interpolates that feature's attributes). `{{field}}` interpolates the picked feature HTML-escaped; `{{{field}}}` is raw (avoid). For labels on many features use `PopupLayer`, not overlays.
 - `<om-behavior on="click|hover|drag|load|data-loaded" layer="..." action="...">` — declarative interaction. Built-in actions: `show-overlay`, `hide-overlay`, `show-tooltip`, `hide-tooltip`, `toggle-layer`, `filter-layer`, `highlight-feature`, `zoom-to-feature`, `set-basemap`, `undo`, `redo`. One payload contract everywhere: `{ layer, target, feature, featureId, coordinate }`.
 - Undo/redo is built in: user-facing manifest changes (layer toggles, filter changes, basemap switches, element add/remove, drawn sketches) are recorded automatically — the manifest is the state. `<om-widget type="undo-redo">` renders the buttons; Cmd/Ctrl-Z, Shift-Cmd/Ctrl-Z, and Ctrl-Y work on any map (text inputs keep their native undo). Camera moves, hover effects, and story playback are deliberately NOT undo steps. Widget scripts: `ctx.history.canUndo/canRedo` with watch token `history`; `ctx.emit("undo")`/`ctx.emit("redo")`.

package/onlymapjs.html-data.json

@@ -158,6 +158,10 @@
           "name": "widget-style",
           "description": "Layout-token sugar: space-separated key:number pairs → --om-widget-* custom properties (e.g. \"gap:10 opacity:0.9\"). Keys: inset, gap (shorthands), inset-x/-y, gap-x/-y, opacity, radius, size. Numbers are px except opacity."
         },
+        {
+          "name": "widgets-hidden",
+          "description": "Hide-all: every widget goes visibility:hidden (state survives — no removal) except attribution and widgets-toggle, which never hide. Toggle via the set-widgets-visible action or <om-widget type=\"widgets-toggle\">; transient UI, not an undo step; story-scrub-capturable."
+        },
         {
           "name": "validate",
           "description": "Run manifest validation and show the on-page error panel."
@@ -1582,6 +1586,9 @@
             {
               "name": "set-terrain"
             },
+            {
+              "name": "set-widgets-visible"
+            },
             {
               "name": "undo"
             },
@@ -1643,6 +1650,9 @@
             },
             {
               "name": "undo-redo"
+            },
+            {
+              "name": "widgets-toggle"
             }
           ]
         },
@@ -1695,9 +1705,18 @@
           "name": "order",
           "description": "Deterministic in-slot ordering (flex order; lower renders first). Default: DOM order."
         },
+        {
+          "name": "cluster",
+          "description": "Set \"false\" to keep a compact button widget (zoom-controls, undo-redo, widgets-toggle) out of the automatic control-group merge with adjacent compact widgets.",
+          "values": [
+            {
+              "name": "false"
+            }
+          ]
+        },
         {
           "name": "watch",
-          "description": "Space-separated watch tokens: viewport, selection, layers, history, basemap, lighting, terrain, data:<layerId>."
+          "description": "Space-separated watch tokens: viewport, selection, layers, history, basemap, lighting, terrain, widgets, data:<layerId>."
         },
         {
           "name": "layer",
@@ -1896,6 +1915,9 @@
             {
               "name": "set-terrain"
             },
+            {
+              "name": "set-widgets-visible"
+            },
             {
               "name": "undo"
             },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nika-js/onlymap",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "description": "Declarative deck.gl maps for HTML and React — interactive WebGL mapping with GeoJSON/CSV/Arrow data, MapLibre basemaps, widgets, popups, and live streams from a custom-element manifest or typed React components. TypeScript, no build step.",
   "license": "SEE LICENSE IN LICENSE.md",
   "publishConfig": {