@nika-js/onlymap 0.6.0 → 0.6.2

package/dist/widget-registry.d.ts

@@ -36,6 +36,17 @@ export interface WidgetImpl {
      */
     neverHides?: boolean;
     render(ctx: RuntimeContext, host: WidgetHost): void | Promise<void>;
+    /**
+     * Optional teardown, called by <om-widget> when the element is REMOVED for
+     * real — an author delete, or an SPA unmounting the whole <om-map> — never
+     * on the transient disconnect of a slot/fold/cluster reparent (om-widget
+     * distinguishes the two; see its disconnectedCallback). For releasing
+     * resources the document would otherwise pin past the widget's life: blob
+     * URLs, external listeners, large cached tables held in `host.state`.
+     * May fire again after a re-connect if the widget is removed a second
+     * time, so implementations must tolerate repeat calls.
+     */
+    destroy?(host: WidgetHost): 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;

package/dist/widgets/ifc-clash.d.ts

@@ -0,0 +1,18 @@
+interface ClashItem {
+    id: number;
+    ifcClass: string;
+    name: string;
+    box: number[];
+}
+/** Rows to clash candidates, dropping ignored classes and anything with no real box. */
+export declare function clashCandidates(rows: Record<string, unknown>[]): ClashItem[];
+/**
+ * Axis-aligned overlap, with a tolerance that SHRINKS both boxes.
+ *
+ * The strict comparison matters: two slabs meeting exactly face to face share a
+ * plane, and reporting that would mean every floor clashes with every wall
+ * standing on it. `tolerance` then demands a real interpenetration of that
+ * depth before a pair counts, which is how modelling noise gets tuned out.
+ */
+export declare function boxesOverlap(a: number[], b: number[], tolerance: number): boolean;
+export {};

package/dist/widgets/ifc.d.ts

@@ -0,0 +1,41 @@
+export declare function ensureStyles(root: ShadowRoot): void;
+/** Every `<om-layer pick-features>` on a map — the BIM widgets' shared universe of pickable models. */
+export declare function pickFeatureLayers(map: Element | null | undefined): Element[];
+interface TreeNode {
+    /** Full prefix identifying this node — also its key in the visibility state. */
+    key: string;
+    label: string;
+    count: number;
+    /** Every concrete `spatialPath` value at or below this node. */
+    values: string[];
+    children: Map<string, TreeNode>;
+}
+/**
+ * Distinct spatial paths -> a nested tree, with counts aggregated upward.
+ *
+ * Depth is NOT uniform in real models: the bridge sample mixes 1-level and
+ * 5-level paths in one file, and a model can leave elements with no spatial
+ * container at all (700 of the clinic's 2,626). Both are represented rather
+ * than dropped — an element that vanishes from the tree is an element nobody
+ * can find again.
+ */
+export declare function buildSpatialTree(counts: Map<string, number>): TreeNode;
+/**
+ * Writes an attribute only when it would actually change.
+ *
+ * These widgets re-render on the `layers`/`features` tokens and their writes
+ * mutate layers, so an unconditional write schedules the MutationObserver →
+ * reconcile → full parseManifest pass that produced it — on EVERY render,
+ * even when nothing changed. `setAttribute` notifies observers even when the
+ * value is identical, so equality has to be checked here rather than relied
+ * on.
+ *
+ * It also matters for size: an isolate list or a serialized feature-styles
+ * table spans every element and runs to tens of kilobytes, and re-parsing
+ * that on a loop would be felt.
+ *
+ * Shared with ifc-clash (imported from here — the dependency already flows
+ * that way for ensureStyles/pickFeatureLayers).
+ */
+export declare function setIfChanged(element: Element | null, name: string, value: string | null): void;
+export {};

package/dist/{zarr-OewK7k2K.js → zarr-CUzEX8fB.js}

@@ -1,5 +1,5 @@
-import { A as ur, d as lr, R as zt, e as fr, m as dr, p as St, f as hr, g as pr, h as mr } from "./raster-pipeline-ZdCOGfqV.js";
-import { ap as gr } from "./index-Bz-rbmhj.js";
+import { A as ur, d as lr, R as zt, e as fr, m as dr, p as St, f as hr, g as pr, h as mr } from "./raster-pipeline-DLrnJK8y.js";
+import { ap as gr } from "./index-7B-6Cbzu.js";
 import $t from "./index-CW1n5LdO.js";
 var Et;
 function h(e, t, n) {
@@ -48,7 +48,7 @@ class zn extends Error {
 }
 (Et = globalThis).__zod_globalConfig ?? (Et.__zod_globalConfig = {});
 const et = globalThis.__zod_globalConfig;
-function L(e) {
+function M(e) {
   return et;
 }
 function Sn(e) {
@@ -396,7 +396,7 @@ const st = (e) => (t, n, r, o) => {
   if (i instanceof Promise)
     throw new ee();
   if (i.issues.length) {
-    const a = new (o?.Err ?? e)(i.issues.map((c) => D(c, s, L())));
+    const a = new (o?.Err ?? e)(i.issues.map((c) => D(c, s, M())));
     throw $n(a, o?.callee), a;
   }
   return i.value;
@@ -404,7 +404,7 @@ const st = (e) => (t, n, r, o) => {
   const s = r ? { ...r, async: !0 } : { async: !0 };
   let i = t._zod.run({ value: n, issues: [] }, s);
   if (i instanceof Promise && (i = await i), i.issues.length) {
-    const a = new (o?.Err ?? e)(i.issues.map((c) => D(c, s, L())));
+    const a = new (o?.Err ?? e)(i.issues.map((c) => D(c, s, M())));
     throw $n(a, o?.callee), a;
   }
   return i.value;
@@ -414,14 +414,14 @@ const st = (e) => (t, n, r, o) => {
     throw new ee();
   return s.issues.length ? {
     success: !1,
-    error: new (e ?? In)(s.issues.map((i) => D(i, o, L())))
+    error: new (e ?? In)(s.issues.map((i) => D(i, o, M())))
   } : { success: !0, data: s.value };
 }, Cr = /* @__PURE__ */ Pe(Zn), je = (e) => async (t, n, r) => {
   const o = r ? { ...r, async: !0 } : { async: !0 };
   let s = t._zod.run({ value: n, issues: [] }, o);
   return s instanceof Promise && (s = await s), s.issues.length ? {
     success: !1,
-    error: new e(s.issues.map((i) => D(i, o, L())))
+    error: new e(s.issues.map((i) => D(i, o, M())))
   } : { success: !0, data: s.value };
 }, Pr = /* @__PURE__ */ je(Zn), jr = (e) => (t, n, r) => {
   const o = r ? { ...r, direction: "backward" } : { direction: "backward" };
@@ -429,7 +429,7 @@ const st = (e) => (t, n, r, o) => {
 }, xr = (e) => (t, n, r) => st(e)(t, n, r), Rr = (e) => async (t, n, r) => {
   const o = r ? { ...r, direction: "backward" } : { direction: "backward" };
   return it(e)(t, n, o);
-}, Mr = (e) => async (t, n, r) => it(e)(t, n, r), Lr = (e) => (t, n, r) => {
+}, Lr = (e) => async (t, n, r) => it(e)(t, n, r), Mr = (e) => (t, n, r) => {
   const o = r ? { ...r, direction: "backward" } : { direction: "backward" };
   return Pe(e)(t, n, o);
 }, Dr = (e) => (t, n, r) => Pe(e)(t, n, r), Ur = (e) => async (t, n, r) => {
@@ -925,9 +925,9 @@ const Io = {
   t.pattern ?? (t.pattern = Jr), z.init(e, t);
 }), Ro = /* @__PURE__ */ h("$ZodULID", (e, t) => {
   t.pattern ?? (t.pattern = Vr), z.init(e, t);
-}), Mo = /* @__PURE__ */ h("$ZodXID", (e, t) => {
+}), Lo = /* @__PURE__ */ h("$ZodXID", (e, t) => {
   t.pattern ?? (t.pattern = Wr), z.init(e, t);
-}), Lo = /* @__PURE__ */ h("$ZodKSUID", (e, t) => {
+}), Mo = /* @__PURE__ */ h("$ZodKSUID", (e, t) => {
   t.pattern ?? (t.pattern = Gr), z.init(e, t);
 }), Do = /* @__PURE__ */ h("$ZodISODateTime", (e, t) => {
   t.pattern ?? (t.pattern = uo(t)), z.init(e, t);
@@ -1046,7 +1046,7 @@ const Qo = /* @__PURE__ */ h("$ZodJWT", (e, t) => {
       continue: !t.abort
     });
   };
-}), Mn = /* @__PURE__ */ h("$ZodNumber", (e, t) => {
+}), Ln = /* @__PURE__ */ h("$ZodNumber", (e, t) => {
   $.init(e, t), e._zod.pattern = e._zod.bag.pattern ?? Cn, e._zod.parse = (n, r) => {
     if (t.coerce)
       try {
@@ -1066,7 +1066,7 @@ const Qo = /* @__PURE__ */ h("$ZodJWT", (e, t) => {
     }), n;
   };
 }), es = /* @__PURE__ */ h("$ZodNumberFormat", (e, t) => {
-  go.init(e, t), Mn.init(e, t);
+  go.init(e, t), Ln.init(e, t);
 }), ts = /* @__PURE__ */ h("$ZodUnknown", (e, t) => {
   $.init(e, t), e._zod.parse = (n) => n;
 }), ns = /* @__PURE__ */ h("$ZodNever", (e, t) => {
@@ -1120,7 +1120,7 @@ function ve(e, t, n, r, o, s) {
   }
   e.value === void 0 ? i && (t.value[n] = void 0) : t.value[n] = e.value;
 }
-function Ln(e) {
+function Mn(e) {
   const t = Object.keys(e.shape);
   for (const r of t)
     if (!e.shape?.[r]?._zod?.traits?.has("$ZodType"))
@@ -1165,7 +1165,7 @@ const os = /* @__PURE__ */ h("$ZodObject", (e, t) => {
       }
     });
   }
-  const r = tt(() => Ln(t));
+  const r = tt(() => Mn(t));
   v(e._zod, "propValues", () => {
     const a = t.shape, c = {};
     for (const u in a) {
@@ -1200,7 +1200,7 @@ const os = /* @__PURE__ */ h("$ZodObject", (e, t) => {
   };
 }), ss = /* @__PURE__ */ h("$ZodObjectJIT", (e, t) => {
   os.init(e, t);
-  const n = e._zod.parse, r = tt(() => Ln(t)), o = (d) => {
+  const n = e._zod.parse, r = tt(() => Mn(t)), o = (d) => {
     const p = new To(["shape", "payload", "ctx"]), g = r.value, k = (O) => {
       const y = It(O);
       return `shape[${y}]._zod.run({ value: input[${y}], issues: [] }, ctx)`;
@@ -1301,7 +1301,7 @@ function At(e, t, n, r) {
     code: "invalid_union",
     input: t.value,
     inst: n,
-    errors: e.map((s) => s.issues.map((i) => D(i, r, L())))
+    errors: e.map((s) => s.issues.map((i) => D(i, r, M())))
   }), t);
 }
 const is = /* @__PURE__ */ h("$ZodUnion", (e, t) => {
@@ -1501,7 +1501,7 @@ const us = /* @__PURE__ */ h("$ZodRecord", (e, t) => {
             n.issues.push({
               code: "invalid_key",
               origin: "record",
-              issues: l.issues.map((p) => D(p, r, L())),
+              issues: l.issues.map((p) => D(p, r, M())),
               input: u,
               path: [u],
               inst: e
@@ -1540,7 +1540,7 @@ const us = /* @__PURE__ */ h("$ZodRecord", (e, t) => {
           t.mode === "loose" ? n.value[a] = o[a] : n.issues.push({
             code: "invalid_key",
             origin: "record",
-            issues: c.issues.map((f) => D(f, r, L())),
+            issues: c.issues.map((f) => D(f, r, M())),
             input: a,
             path: [a],
             inst: e
@@ -1621,10 +1621,10 @@ const ms = /* @__PURE__ */ h("$ZodPrefault", (e, t) => {
     return n ? new Set([...n].filter((r) => r !== void 0)) : void 0;
   }), e._zod.parse = (n, r) => {
     const o = t.innerType._zod.run(n, r);
-    return o instanceof Promise ? o.then((s) => Mt(s, e)) : Mt(o, e);
+    return o instanceof Promise ? o.then((s) => Lt(s, e)) : Lt(o, e);
   };
 });
-function Mt(e, t) {
+function Lt(e, t) {
   return !e.issues.length && e.value === void 0 && e.issues.push({
     code: "invalid_type",
     expected: "nonoptional",
@@ -1640,13 +1640,13 @@ const ys = /* @__PURE__ */ h("$ZodCatch", (e, t) => {
     return o instanceof Promise ? o.then((s) => (n.value = s.value, s.issues.length && (n.value = t.catchValue({
       ...n,
       error: {
-        issues: s.issues.map((i) => D(i, r, L()))
+        issues: s.issues.map((i) => D(i, r, M()))
       },
       input: n.value
     }), n.issues = [], n.fallback = !0), n)) : (n.value = o.value, o.issues.length && (n.value = t.catchValue({
       ...n,
       error: {
-        issues: o.issues.map((s) => D(s, r, L()))
+        issues: o.issues.map((s) => D(s, r, M()))
       },
       input: n.value
     }), n.issues = [], n.fallback = !0), n);
@@ -1669,10 +1669,10 @@ const ws = /* @__PURE__ */ h("$ZodReadonly", (e, t) => {
     if (r.direction === "backward")
       return t.innerType._zod.run(n, r);
     const o = t.innerType._zod.run(n, r);
-    return o instanceof Promise ? o.then(Lt) : Lt(o);
+    return o instanceof Promise ? o.then(Mt) : Mt(o);
   };
 });
-function Lt(e) {
+function Mt(e) {
   return e.value = Object.freeze(e.value), e;
 }
 const bs = /* @__PURE__ */ h("$ZodCustom", (e, t) => {
@@ -1894,7 +1894,7 @@ function Rs(e, t) {
   });
 }
 // @__NO_SIDE_EFFECTS__
-function Ms(e, t) {
+function Ls(e, t) {
   return new e({
     type: "string",
     format: "ipv6",
@@ -1904,7 +1904,7 @@ function Ms(e, t) {
   });
 }
 // @__NO_SIDE_EFFECTS__
-function Ls(e, t) {
+function Ms(e, t) {
   return new e({
     type: "string",
     format: "cidrv4",
@@ -2044,7 +2044,7 @@ function Bt(e, t) {
   });
 }
 // @__NO_SIDE_EFFECTS__
-function Me(e, t) {
+function Le(e, t) {
   return new jn({
     check: "less_than",
     ...m(t),
@@ -2062,7 +2062,7 @@ function Jt(e, t) {
   });
 }
 // @__NO_SIDE_EFFECTS__
-function Le(e, t) {
+function Me(e, t) {
   return new xn({
     check: "greater_than",
     ...m(t),
@@ -2625,11 +2625,11 @@ const pi = (e, t = {}) => (n) => {
 function Ri(e) {
   return /* @__PURE__ */ Vs(xi, e);
 }
-const Mi = /* @__PURE__ */ h("ZodISODate", (e, t) => {
+const Li = /* @__PURE__ */ h("ZodISODate", (e, t) => {
   Uo.init(e, t), E.init(e, t);
 });
-function Li(e) {
-  return /* @__PURE__ */ Ws(Mi, e);
+function Mi(e) {
+  return /* @__PURE__ */ Ws(Li, e);
 }
 const Di = /* @__PURE__ */ h("ZodISOTime", (e, t) => {
   Fo.init(e, t), E.init(e, t);
@@ -2674,7 +2674,7 @@ const Ji = (e, t) => {
   });
 }, x = /* @__PURE__ */ h("ZodError", Ji, {
   Parent: Error
-}), Vi = /* @__PURE__ */ st(x), Wi = /* @__PURE__ */ it(x), Gi = /* @__PURE__ */ Pe(x), Ki = /* @__PURE__ */ je(x), Yi = /* @__PURE__ */ jr(x), qi = /* @__PURE__ */ xr(x), Xi = /* @__PURE__ */ Rr(x), Hi = /* @__PURE__ */ Mr(x), Qi = /* @__PURE__ */ Lr(x), ea = /* @__PURE__ */ Dr(x), ta = /* @__PURE__ */ Ur(x), na = /* @__PURE__ */ Fr(x), Wt = /* @__PURE__ */ new WeakMap();
+}), Vi = /* @__PURE__ */ st(x), Wi = /* @__PURE__ */ it(x), Gi = /* @__PURE__ */ Pe(x), Ki = /* @__PURE__ */ je(x), Yi = /* @__PURE__ */ jr(x), qi = /* @__PURE__ */ xr(x), Xi = /* @__PURE__ */ Rr(x), Hi = /* @__PURE__ */ Lr(x), Qi = /* @__PURE__ */ Mr(x), ea = /* @__PURE__ */ Dr(x), ta = /* @__PURE__ */ Ur(x), na = /* @__PURE__ */ Fr(x), Wt = /* @__PURE__ */ new WeakMap();
 function fe(e, t, n) {
   const r = Object.getPrototypeOf(e);
   let o = Wt.get(r);
@@ -2770,7 +2770,7 @@ const I = /* @__PURE__ */ h("ZodType", (e, t) => ($.init(e, t), Object.assign(e[
     return Xt(this, Ca(n));
   },
   default(n) {
-    return Ma(this, n);
+    return La(this, n);
   },
   prefault(n) {
     return Da(this, n);
@@ -2859,9 +2859,9 @@ const I = /* @__PURE__ */ h("ZodType", (e, t) => ($.init(e, t), Object.assign(e[
     }
   });
 }), ra = /* @__PURE__ */ h("ZodString", (e, t) => {
-  at.init(e, t), Kn.init(e, t), e.email = (n) => e.check(/* @__PURE__ */ Ss(oa, n)), e.url = (n) => e.check(/* @__PURE__ */ Zs(sa, n)), e.jwt = (n) => e.check(/* @__PURE__ */ Js(ba, n)), e.emoji = (n) => e.check(/* @__PURE__ */ Os(ia, n)), e.guid = (n) => e.check(/* @__PURE__ */ Ft(Gt, n)), e.uuid = (n) => e.check(/* @__PURE__ */ $s(ye, n)), e.uuidv4 = (n) => e.check(/* @__PURE__ */ Es(ye, n)), e.uuidv6 = (n) => e.check(/* @__PURE__ */ Ts(ye, n)), e.uuidv7 = (n) => e.check(/* @__PURE__ */ Is(ye, n)), e.nanoid = (n) => e.check(/* @__PURE__ */ As(aa, n)), e.guid = (n) => e.check(/* @__PURE__ */ Ft(Gt, n)), e.cuid = (n) => e.check(/* @__PURE__ */ Ns(ca, n)), e.cuid2 = (n) => e.check(/* @__PURE__ */ Cs(ua, n)), e.ulid = (n) => e.check(/* @__PURE__ */ Ps(la, n)), e.base64 = (n) => e.check(/* @__PURE__ */ Us(ya, n)), e.base64url = (n) => e.check(/* @__PURE__ */ Fs(_a, n)), e.xid = (n) => e.check(/* @__PURE__ */ js(fa, n)), e.ksuid = (n) => e.check(/* @__PURE__ */ xs(da, n)), e.ipv4 = (n) => e.check(/* @__PURE__ */ Rs(ha, n)), e.ipv6 = (n) => e.check(/* @__PURE__ */ Ms(pa, n)), e.cidrv4 = (n) => e.check(/* @__PURE__ */ Ls(ma, n)), e.cidrv6 = (n) => e.check(/* @__PURE__ */ Ds(ga, n)), e.e164 = (n) => e.check(/* @__PURE__ */ Bs(wa, n)), e.datetime = (n) => e.check(Ri(n)), e.date = (n) => e.check(Li(n)), e.time = (n) => e.check(Ui(n)), e.duration = (n) => e.check(Bi(n));
+  at.init(e, t), Kn.init(e, t), e.email = (n) => e.check(/* @__PURE__ */ Ss(oa, n)), e.url = (n) => e.check(/* @__PURE__ */ Zs(sa, n)), e.jwt = (n) => e.check(/* @__PURE__ */ Js(ba, n)), e.emoji = (n) => e.check(/* @__PURE__ */ Os(ia, n)), e.guid = (n) => e.check(/* @__PURE__ */ Ft(Gt, n)), e.uuid = (n) => e.check(/* @__PURE__ */ $s(ye, n)), e.uuidv4 = (n) => e.check(/* @__PURE__ */ Es(ye, n)), e.uuidv6 = (n) => e.check(/* @__PURE__ */ Ts(ye, n)), e.uuidv7 = (n) => e.check(/* @__PURE__ */ Is(ye, n)), e.nanoid = (n) => e.check(/* @__PURE__ */ As(aa, n)), e.guid = (n) => e.check(/* @__PURE__ */ Ft(Gt, n)), e.cuid = (n) => e.check(/* @__PURE__ */ Ns(ca, n)), e.cuid2 = (n) => e.check(/* @__PURE__ */ Cs(ua, n)), e.ulid = (n) => e.check(/* @__PURE__ */ Ps(la, n)), e.base64 = (n) => e.check(/* @__PURE__ */ Us(ya, n)), e.base64url = (n) => e.check(/* @__PURE__ */ Fs(_a, n)), e.xid = (n) => e.check(/* @__PURE__ */ js(fa, n)), e.ksuid = (n) => e.check(/* @__PURE__ */ xs(da, n)), e.ipv4 = (n) => e.check(/* @__PURE__ */ Rs(ha, n)), e.ipv6 = (n) => e.check(/* @__PURE__ */ Ls(pa, n)), e.cidrv4 = (n) => e.check(/* @__PURE__ */ Ms(ma, n)), e.cidrv6 = (n) => e.check(/* @__PURE__ */ Ds(ga, n)), e.e164 = (n) => e.check(/* @__PURE__ */ Bs(wa, n)), e.datetime = (n) => e.check(Ri(n)), e.date = (n) => e.check(Mi(n)), e.time = (n) => e.check(Ui(n)), e.duration = (n) => e.check(Bi(n));
 });
-function M(e) {
+function L(e) {
   return /* @__PURE__ */ zs(ra, e);
 }
 const E = /* @__PURE__ */ h("ZodStringFormat", (e, t) => {
@@ -2885,9 +2885,9 @@ const E = /* @__PURE__ */ h("ZodStringFormat", (e, t) => {
 }), la = /* @__PURE__ */ h("ZodULID", (e, t) => {
   Ro.init(e, t), E.init(e, t);
 }), fa = /* @__PURE__ */ h("ZodXID", (e, t) => {
-  Mo.init(e, t), E.init(e, t);
-}), da = /* @__PURE__ */ h("ZodKSUID", (e, t) => {
   Lo.init(e, t), E.init(e, t);
+}), da = /* @__PURE__ */ h("ZodKSUID", (e, t) => {
+  Mo.init(e, t), E.init(e, t);
 }), ha = /* @__PURE__ */ h("ZodIPv4", (e, t) => {
   Jo.init(e, t), E.init(e, t);
 }), pa = /* @__PURE__ */ h("ZodIPv6", (e, t) => {
@@ -2905,24 +2905,24 @@ const E = /* @__PURE__ */ h("ZodStringFormat", (e, t) => {
 }), ba = /* @__PURE__ */ h("ZodJWT", (e, t) => {
   Qo.init(e, t), E.init(e, t);
 }), Yn = /* @__PURE__ */ h("ZodNumber", (e, t) => {
-  Mn.init(e, t), I.init(e, t), e._zod.processJSONSchema = (r, o, s) => yi(e, r, o), fe(e, "ZodNumber", {
+  Ln.init(e, t), I.init(e, t), e._zod.processJSONSchema = (r, o, s) => yi(e, r, o), fe(e, "ZodNumber", {
     gt(r, o) {
       return this.check(/* @__PURE__ */ Jt(r, o));
     },
     gte(r, o) {
-      return this.check(/* @__PURE__ */ Le(r, o));
+      return this.check(/* @__PURE__ */ Me(r, o));
     },
     min(r, o) {
-      return this.check(/* @__PURE__ */ Le(r, o));
+      return this.check(/* @__PURE__ */ Me(r, o));
     },
     lt(r, o) {
       return this.check(/* @__PURE__ */ Bt(r, o));
     },
     lte(r, o) {
-      return this.check(/* @__PURE__ */ Me(r, o));
+      return this.check(/* @__PURE__ */ Le(r, o));
     },
     max(r, o) {
-      return this.check(/* @__PURE__ */ Me(r, o));
+      return this.check(/* @__PURE__ */ Le(r, o));
     },
     int(r) {
       return this.check(Se(r));
@@ -2934,13 +2934,13 @@ const E = /* @__PURE__ */ h("ZodStringFormat", (e, t) => {
       return this.check(/* @__PURE__ */ Jt(0, r));
     },
     nonnegative(r) {
-      return this.check(/* @__PURE__ */ Le(0, r));
+      return this.check(/* @__PURE__ */ Me(0, r));
     },
     negative(r) {
       return this.check(/* @__PURE__ */ Bt(0, r));
     },
     nonpositive(r) {
-      return this.check(/* @__PURE__ */ Me(0, r));
+      return this.check(/* @__PURE__ */ Le(0, r));
     },
     multipleOf(r, o) {
       return this.check(/* @__PURE__ */ Vt(r, o));
@@ -3090,7 +3090,7 @@ const Kt = /* @__PURE__ */ h("ZodRecord", (e, t) => {
 function Aa(e, t, n) {
   return !t || !t._zod ? new Kt({
     type: "record",
-    keyType: M(),
+    keyType: L(),
     valueType: e,
     ...m(t)
   }) : new Kt({
@@ -3191,7 +3191,7 @@ function qt(e) {
 const Ra = /* @__PURE__ */ h("ZodDefault", (e, t) => {
   ps.init(e, t), I.init(e, t), e._zod.processJSONSchema = (n, r, o) => Ai(e, n, r, o), e.unwrap = () => e._zod.def.innerType, e.removeDefault = e.unwrap;
 });
-function Ma(e, t) {
+function La(e, t) {
   return new Ra({
     type: "default",
     innerType: e,
@@ -3200,11 +3200,11 @@ function Ma(e, t) {
     }
   });
 }
-const La = /* @__PURE__ */ h("ZodPrefault", (e, t) => {
+const Ma = /* @__PURE__ */ h("ZodPrefault", (e, t) => {
   ms.init(e, t), I.init(e, t), e._zod.processJSONSchema = (n, r, o) => Ni(e, n, r, o), e.unwrap = () => e._zod.def.innerType;
 });
 function Da(e, t) {
-  return new La({
+  return new Ma({
     type: "prefault",
     innerType: e,
     get defaultValue() {
@@ -3264,9 +3264,9 @@ function Ya(e, t) {
 const qa = {
   custom: "custom"
 }, Xa = ct([
-  J({ "proj:code": M().regex(/^[A-Z]+:[0-9]+$/) }),
-  J({ "proj:wkt2": M() }),
-  J({ "proj:projjson": Aa(M(), Ke()) })
+  J({ "proj:code": L().regex(/^[A-Z]+:[0-9]+$/) }),
+  J({ "proj:wkt2": L() }),
+  J({ "proj:projjson": Aa(L(), Ke()) })
 ]), Qn = $e([
   A(),
   A(),
@@ -3275,23 +3275,23 @@ const qa = {
   A(),
   A()
 ]), er = $e([Se().min(1), Se().min(1)]), Ha = J({
-  asset: M(),
-  derived_from: M().optional(),
+  asset: L(),
+  derived_from: L().optional(),
   transform: J({
     scale: le(A()).optional(),
     translation: le(A()).optional()
   }).optional(),
-  resampling_method: M().optional(),
+  resampling_method: L().optional(),
   // spatial: overrides per level — required here when not at group level
   "spatial:transform": Qn.optional(),
   "spatial:shape": er.optional()
 }).passthrough(), Qa = J({
   multiscales: J({
     layout: le(Ha).min(1),
-    resampling_method: M().optional()
+    resampling_method: L().optional()
   })
 }), ec = J({
-  "spatial:dimensions": le(M()).min(2).max(3),
+  "spatial:dimensions": le(L()).min(2).max(3),
   "spatial:transform": Qn.optional(),
   "spatial:shape": er.optional(),
   "spatial:bbox": ct([
@@ -3305,7 +3305,7 @@ const qa = {
       A()
     ])
   ]).optional(),
-  "spatial:transform_type": M().optional(),
+  "spatial:transform_type": L().optional(),
   "spatial:registration": qn(["node", "pixel"]).optional(),
   multiscales: Qa.shape.multiscales.optional()
 }), tc = ec.superRefine((e, t) => {
@@ -4778,15 +4778,15 @@ function Rc(e, t) {
     n instanceof Promise ? n = n.then((o) => r(o)) : n = r(n);
   return n;
 }
-function Mc(e, ...t) {
+function Lc(e, ...t) {
   return Rc(e, t);
 }
 async function ar(e) {
   let t = e.store.arrayExtensions;
-  return t?.length ? await Mc(e, ...t) : e;
+  return t?.length ? await Lc(e, ...t) : e;
 }
-let pe = Lc();
-function Lc() {
+let pe = Mc();
+function Mc() {
   let e = /* @__PURE__ */ new WeakMap();
   function t(n) {
     let r = e.get(n) ?? { v2: 0, v3: 0 };
@@ -5428,8 +5428,20 @@ const ku = async (e, t) => {
 function _e(e) {
   return JSON.stringify([e.src ?? "", e.variable ?? "", e.select ?? "", e.bounds ?? null, e.crs ?? "", e.spatialDims ?? ""]);
 }
+class zu extends _u {
+  static layerName = "OmZarrTileLayer";
+  renderLayers() {
+    const t = super.renderLayers();
+    if (!t) return t;
+    const r = {
+      updateTriggers: { ...t.props.updateTriggers, getTileData: this.props.selectTrigger },
+      onViewportLoad: () => requestAnimationFrame(() => this.setNeedsRedraw())
+    };
+    return t.clone(r);
+  }
+}
 const kn = /* @__PURE__ */ new Map();
-async function zu(e) {
+async function Su(e) {
   const t = new URL(e.src ?? "", typeof document < "u" ? document.baseURI : void 0).href, n = new oc(t);
   let r = n;
   try {
@@ -5446,7 +5458,7 @@ async function zu(e) {
   }
   return { node: o, variable: e.variable };
 }
-class Iu extends gr {
+class Zu extends gr {
   static layerName = "OmZarrLayer";
   static defaultProps = {
     src: "",
@@ -5470,7 +5482,7 @@ class Iu extends gr {
       if (!t.src) throw new Error('ZarrLayer requires a src (the ".zarr" store URL).');
       const r = bu(t.select), o = JSON.stringify([t.src, t.variable ?? "", t.bounds ?? null, t.crs ?? "", t.spatialDims ?? ""]);
       let s = kn.get(o);
-      if (s || (s = await zu(t), kn.set(o, s)), n !== _e(this.props)) return;
+      if (s || (s = await Su(t), kn.set(o, s)), n !== _e(this.props)) return;
       this.setState({ status: "ready", node: s.node, variable: s.variable, metadata: s.metadata, selection: r, loadKey: n });
     } catch (r) {
       console.error(`[onlymapjs] ZarrLayer src="${t.src}" failed to load:`, r), n === _e(this.props) && this.setState({ status: "error", loadKey: n });
@@ -5485,13 +5497,14 @@ class Iu extends gr {
       colormap: this.props.colormap,
       nodataOverride: this.props.nodataOverride
     };
-    return new _u(
+    return new zu(
       this.getSubLayerProps({
         id: "zarr",
         node: n,
         ...r !== void 0 ? { variable: r } : {},
         ...o !== void 0 ? { metadata: o } : {},
         selection: s,
+        selectTrigger: this.props.select,
         getTileData: ku,
         renderTile: (a) => pr(a, i),
         opacity: this.props.opacity
@@ -5500,7 +5513,7 @@ class Iu extends gr {
   }
 }
 export {
-  Iu as OmZarrLayer,
+  Zu as OmZarrLayer,
   vu as buildManualGeoZarrAttrs,
   bu as parseZarrSelection
 };

package/docs/3d-assets.md

@@ -69,6 +69,54 @@ For LOD experiments, common loaders.gl tileset options have first-class attribut
 
 Upstream converters exist for IFC/CityGML → 3D Tiles (e.g. Cesium ion, `py3dtiles`, FME). Same rule: convert upstream, ingest the standard.
 
+## Working inside a 3D scene: cutting, exporting, picking
+
+Three tools operate on whatever 3D content is already loaded — `Tile3DLayer` tilesets, `BIMLayer` models, extruded vector geometry alike. They compose: cut a box open, outline what's inside, export it.
+
+### Clip box — cut the scene open
+
+```html
+<om-map terrain="mapterhorn"
+        clip-box-min="[6.145, 46.201, 380]"
+        clip-box-max="[6.149, 46.204, 440]">
+  <om-widget type="clip-box"></om-widget>
+</om-map>
+```
+
+Geometry outside the box is discarded. Every layer is clipped **by default** — `clip="off"` on an `<om-layer>` opts one out (a basemap, usually). Two modifiers change what "outside" means rather than how much is cut:
+
+- `clip-box-invert` — show what's *outside* the box instead of inside.
+- `clip-box-highlight` — dim clipped-out geometry instead of discarding it, so nothing disappears (a non-destructive preview).
+
+The `clip-box` widget renders the box as a draggable cuboid; its "Show face gizmos" toggle adds a double-headed arrow on each of the 6 faces so you can resize by dragging, and keeps those handles off ordinary map panning when you're not using them. The box is attribute-backed like `terrain`/`lighting`, so changes are undoable and story-steppable, and the `set-clip-box` action (`{min, max, invert?, highlight?}`, or `{clear: true}`) drives it programmatically.
+
+v1 is **axis-aligned only** — rotated/oriented boxes are a documented follow-up.
+
+### Region export — download the 3D content inside a footprint
+
+```html
+<om-widget type="draw" export-3d></om-widget>          <!-- GLB (default) -->
+<om-widget type="draw" export-3d="b3dm"></om-widget>   <!-- b3dm, for Cesium/3D-Tiles pipelines -->
+```
+
+Outline a footprint with the draw widget, then hit **Export 3D**: every triangle of every loaded, *visible* 3D Tiles/BIM layer inside that ring is clipped exactly and downloaded. Positions are re-framed to a local coordinate frame at the footprint's own centroid, so the file opens correctly in Blender/three.js without ECEF-scale support. Each triangle carries its own source color as per-vertex `COLOR_0`; there are no textures (BIM/IFC materials are flat colors). `b3dm` adds a `_BATCHID` attribute and a feature table, namespaced per source tileset.
+
+A layer hidden via `visible="false"` (or the `toggle-layer` action) is skipped, with distinct console warnings for "nothing loaded yet" vs. "everything loaded but hidden."
+
+The clip and pack run **synchronously on the main thread** — fine at single-model/BIM scale, but a city-scale tileset under a large footprint will visibly block the tab. Keep footprints to the region you actually want.
+
+### `pickable="3d"` — a real elevation on hover and click
+
+An ordinary `pickable` layer resolves a click against the z=0 ground plane, so clicking a building face reports the point on the ground *behind* it. `pickable="3d"` opts the layer into deck's depth-pick pass instead:
+
+```html
+<om-layer id="city" type="Tile3DLayer" tileset="…/tileset.json" pickable="3d"></om-layer>
+```
+
+The resolved coordinate then carries a real third (elevation) component, which flows through `ctx.selection.coordinate` and `{{z}}` in `<om-overlay>` / `show-tooltip` templates. `terrain` sets this on itself automatically. `{{z}}` is **absent, not `0`**, when no layer in the scene ran the depth pass for that pick — so a missing elevation is distinguishable from sea level.
+
+Snapping (`<om-map snap="vertex edge midpoint">`, see the README) also reads a `BIMLayer`'s edge/crease overlay, converting real wall corners back to `[lng, lat]` — so a drawn footprint can land on an actual building corner rather than near it. `snap="off"` opts a layer out.
+
 ## Semantic city models: CityJSON
 
 3D Tiles is the right target for *visual* city models. It is the wrong one for **CityJSON**, because converting flattens the per-building semantics — and semantics are the whole reason municipal programmes publish it: the Netherlands' [3DBAG](https://3dbag.nl) (~10M buildings), Japan's [PLATEAU](https://www.mlit.go.jp/plateau/) (250+ cities), swisstopo, several German states. Rooftop-solar, shadow, zoning and noise studies all read those attributes.

package/docs/live-data.md

@@ -76,7 +76,15 @@ This applies to **every** Data Layer request: initial loads, polling refreshes,
 
 Every flush/poll takes the same path a resolved fetch takes: a **new data reference** enters the layer IR → the reconciler hands it to deck.gl, which re-uploads geometry without recompiling any accessor → `data:<layerId>` watch tokens fire, so widgets (stats panels, charts) re-render once per update. `om-map-ready` resolves after the *first* load for polling; for streams it resolves immediately (a stream never "finishes" — don't wait for a first message to consider the map ready).
 
-Known limitation: sockets and poll loops are keyed by URL and live for the page — removing the layer stops the data being *read*, not the connection.
+Live transports follow the active descriptor document. Removing a layer,
+changing its URL or stream options, destroying its `MapController`, or
+disconnecting its `<om-map>` releases that owner's handle. Identical
+URL/options across maps share one transport, and the final release aborts the
+fetch/poller or closes the socket. `MapController.suspend()` releases its live
+handles while preserving descriptors and rendered state;
+`MapController.resume()` reacquires them from the current descriptor document.
+This is the intended app-background/app-foreground integration for native
+hosts.
 
 ## Testing live layers