@nika-js/onlymap 0.6.2 → 0.6.7

package/dist/onlymapjs.js

@@ -1,4 +1,4 @@
-import { aA as e, aB as r, aC as t, aD as o, aE as b, aF as i, ap as l, aG as n, aH as S, aI as E, aJ as T, aK as L, aL as g, aM as c, aN as A, aO as p, aP as m, aQ as _, aR as d, aS as I, aT as y, aU as M, aV as u, aW as D, ao as O, aX as f, aw as N, aY as R, aZ as P, a_ as h, W as F, a$ as B, b0 as C, b1 as G, b2 as U, b3 as W, b4 as v, b5 as x, b6 as w, b7 as Y, b8 as H, b9 as X, ba as k, bb as J, bc as K, bd as V, be as z, bf as Q, bg as Z, bh as $, bi as j, bj as q, bk as aa, bl as sa, bm as ea, bn as ra, bo as ta, bp as oa, bq as ba, br as ia, bs as la, bt as na, bu as Sa, bv as Ea, bw as Ta, bx as La, by as ga, bz as ca, bA as Aa, bB as pa, bC as ma, bD as _a, bE as da, bF as Ia, bG as ya, bH as Ma, bI as ua, bJ as Da, bK as Oa, bL as fa, bM as Na, bN as Ra, bO as Pa, bP as ha, bQ as Fa, bR as Ba, bS as Ca, bT as Ga, bU as Ua, bV as Wa, bW as va, bX as xa, bY as wa, bZ as Ya, b_ as Ha, b$ as Xa, c0 as ka, c1 as Ja, c2 as Ka } from "./index-7B-6Cbzu.js";
+import { aA as e, aB as r, aC as t, aD as o, aE as b, aF as i, ap as l, aG as n, aH as S, aI as g, aJ as c, aK as E, aL as L, aM as T, aN as A, aO as d, aP as p, aQ as m, aR as _, aS as I, aT as u, aU as M, aV as y, aW as D, ao as O, aX as R, aw as f, aY as N, aZ as P, a_ as h, W as F, a$ as B, b0 as C, b1 as v, b2 as G, b3 as U, b4 as W, b5 as w, b6 as x, b7 as Y, b8 as H, b9 as X, ba as k, bb as J, bc as K, bd as V, be as z, bf as Q, bg as Z, bh as $, bi as j, bj as q, bk as aa, bl as sa, bm as ea, bn as ra, bo as ta, bp as oa, bq as ba, br as ia, bs as la, bt as na, bu as Sa, bv as ga, bw as ca, bx as Ea, by as La, bz as Ta, bA as Aa, bB as da, bC as pa, bD as ma, bE as _a, bF as Ia, bG as ua, bH as Ma, bI as ya, bJ as Da, bK as Oa, bL as Ra, bM as fa, bN as Na, bO as Pa, bP as ha, bQ as Fa, bR as Ba, bS as Ca, bT as va, bU as Ga, bV as Ua, bW as Wa, bX as wa, bY as xa, bZ as Ya, b_ as Ha, b$ as Xa, c0 as ka, c1 as Ja, c2 as Ka, c3 as Va, c4 as za, c5 as Qa, c6 as Za } from "./index-CAuq7wRs.js";
 export {
   e as ALL_POSITION_VALUES,
   r as AUDIT_EXEMPTIONS,
@@ -9,36 +9,36 @@ export {
   l as CompositeLayer,
   n as DEFAULT_AUDIT_WIDTHS,
   S as DEFAULT_FOLD_BREAKPOINT_PX,
-  E as DRONE_SENSOR_DATABASE,
-  T as EDGE_TOLERANCE_PX,
-  L as FOLD_HYSTERESIS_PX,
-  g as FOLD_SIDES,
-  c as GeoJsonLayer,
+  g as DRONE_SENSOR_DATABASE,
+  c as EDGE_TOLERANCE_PX,
+  E as FOLD_HYSTERESIS_PX,
+  L as FOLD_SIDES,
+  T as GeoJsonLayer,
   A as IconLayer,
-  p as LEGACY_POSITION_ALIASES,
-  m as LIGHTING_PRESET_NAMES,
-  _ as Layer,
-  d as LayerExtension,
+  d as LEGACY_POSITION_ALIASES,
+  p as LIGHTING_PRESET_NAMES,
+  m as Layer,
+  _ as LayerExtension,
   I as MANAGED_SLOTS,
-  y as MapController,
+  u as MapController,
   M as OmMap,
-  u as ScatterplotLayer,
+  y as ScatterplotLayer,
   D as ScenegraphLayer,
   O as SimpleMeshLayer,
-  f as Tile3DLayer,
-  N as TileLayer,
-  R as UNIT_SYSTEMS,
+  R as Tile3DLayer,
+  f as TileLayer,
+  N as UNIT_SYSTEMS,
   P as WGS84_MEAN_RADIUS_M,
   h as WIDGET_STYLE_KEY_NAMES,
   F as WebMercatorViewport,
   B as arrowTableToColumnar,
   C as asRows,
-  G as auditLayout,
-  U as compileExpression,
-  W as compileFullJsAccessorBlockInSandbox,
-  v as computeTimeline,
-  x as configureBasemap,
-  w as configureData,
+  v as auditLayout,
+  G as compileExpression,
+  U as compileFullJsAccessorBlockInSandbox,
+  W as computeTimeline,
+  w as configureBasemap,
+  x as configureData,
   Y as configureIfc,
   H as configureLicense,
   X as configureTelemetry,
@@ -57,46 +57,50 @@ export {
   ea as getEntitlements,
   ra as getLayerSchema,
   ta as getMeasureRadiusMeters,
-  oa as getTerrain,
-  ba as isBrowser,
-  ia as isColumnar,
-  la as isStoreToken,
-  na as loadIfc,
-  Sa as loadRasterModule,
+  oa as getRoutingProvider,
+  ba as getTerrain,
+  ia as isBrowser,
+  la as isColumnar,
+  na as isStoreToken,
+  Sa as lineStringLengthMeters,
+  ga as loadIfc,
+  ca as loadRasterModule,
   Ea as midpoint,
-  Ta as mountForTest,
-  La as niceNumber,
-  ga as normalizeData,
-  ca as parseDurationMs,
-  Aa as parseTerrainAttrs,
-  pa as parseUnitSystem,
-  ma as parseWidgetStyle,
-  _a as pathLengthMeters,
-  da as registerAction,
-  Ia as registerBasemap,
+  La as mountForTest,
+  Ta as niceNumber,
+  Aa as normalizeData,
+  da as parseDurationMs,
+  pa as parseTerrainAttrs,
+  ma as parseUnitSystem,
+  _a as parseWidgetStyle,
+  Ia as pathLengthMeters,
+  ua as registerAction,
+  Ma as registerBasemap,
   ya as registerFormat,
-  Ma as registerLayer,
-  ua as registerSource,
-  Da as registerTerrain,
-  Oa as registerWidget,
-  fa as resolveFoldBreakpointPx,
-  Na as resolveImageOverlay,
-  Ra as resolveLighting,
-  Pa as resolveSlot,
-  ha as ringAreaMeters2,
-  Fa as ringEnclosesPole,
-  Ba as ringPerimeterMeters,
-  Ca as rowAt,
-  Ga as sandboxHtml,
-  Ua as scaleBarStep,
-  Wa as setMeasureRadiusMeters,
-  va as settleLayout,
-  xa as shouldFoldAtWidth,
-  wa as slotContainerStyle,
-  Ya as slotLayout,
-  Ha as snapshotDescriptorIR,
-  Xa as snapshotIR,
-  ka as solarAzElDegrees,
-  Ja as validateManifest,
-  Ka as validateManifestString
+  Da as registerLayer,
+  Oa as registerRoutingProvider,
+  Ra as registerSource,
+  fa as registerTerrain,
+  Na as registerWidget,
+  Pa as releaseDataOwner,
+  ha as resolveFoldBreakpointPx,
+  Fa as resolveImageOverlay,
+  Ba as resolveLighting,
+  Ca as resolveSlot,
+  va as ringAreaMeters2,
+  Ga as ringEnclosesPole,
+  Ua as ringPerimeterMeters,
+  Wa as rowAt,
+  wa as sandboxHtml,
+  xa as scaleBarStep,
+  Ya as setMeasureRadiusMeters,
+  Ha as settleLayout,
+  Xa as shouldFoldAtWidth,
+  ka as slotContainerStyle,
+  Ja as slotLayout,
+  Ka as snapshotDescriptorIR,
+  Va as snapshotIR,
+  za as solarAzElDegrees,
+  Qa as validateManifest,
+  Za as validateManifestString
 };

package/dist/programmatic.d.ts

@@ -22,6 +22,8 @@ import { type TokenStore, type ViewOrigin, type ViewportSnapshot, type DataVersi
 import type { LayerIR } from "./ir";
 import { type RuntimeContext } from "./ctx";
 import type { LayerMetaSnapshot } from "./ctx";
+import { type LayerFilterFieldSpec, type LayerCategoryFilterFieldSpec } from "./attribute-resolution";
+import { type DataTransportOwner } from "./data-layer";
 import type { Selection } from "./selection";
 import type { ValidationEntry } from "./validation";
 import type { MapViewport } from "./basemap";
@@ -49,12 +51,16 @@ export interface LayerDescriptor {
     /** Legend metadata (ctx.layers), same as the label/color attributes. */
     label?: string;
     color?: string;
-    /** GPU filter (spec: "Filtering") — mirrors filter-field/filter-range/… */
+    /** GPU filter (spec: "Filtering") — mirrors filter-field/filter-range/… (single dimension). */
     filterField?: string;
     filterRange?: [number, number];
     filterSoftRange?: [number, number];
+    /** Multi-dimension GPU filter (up to 4) — mirrors `filter-fields`. Wins over `filterField`/`filterRange` if both are set. */
+    filterFields?: LayerFilterFieldSpec[];
     filterCategoryField?: string;
     filterCategories?: unknown[];
+    /** Multi-dimension categorical GPU filter (up to 4) — mirrors `filter-category-fields`. Wins over `filterCategoryField`/`filterCategories` if both are set. */
+    filterCategoryFields?: LayerCategoryFilterFieldSpec[];
     /** Dashed lines on a path layer (spec: "PathStyleExtension") — `[dashLength, gapLength]` in line-width units; mirrors the `dash` attribute. */
     dash?: [number, number];
     /** Stretch each segment's dashes to start and end on a dash (deck `dashJustified`); mirrors `dash-justified`. */
@@ -128,8 +134,18 @@ export interface MapControllerOptions {
     /** @internal Stable React-owned hosts that place required chrome in managed slots. */
     chromeHosts?: MandatedChromeHosts;
 }
-/** Descriptor → layer IR: the programmatic counterpart of one parse-manifest.ts loop iteration. */
-export declare function descriptorToIR(desc: LayerDescriptor, onDataLoaded: () => void): LayerIR | null;
+/**
+ * Descriptor → layer IR: the programmatic counterpart of one parse-manifest.ts
+ * loop iteration.
+ *
+ * Pass `owner` (any stable object identity — a host controller, an element) to
+ * put a URL-backed descriptor's fetch/poll/socket under descriptor-owned
+ * lifetime; `releaseDataOwner(owner)` then stops everything that owner holds.
+ * Without one the transport is un-owned: it is still shared by identity and
+ * still notifies, but it holds no reference count, so a real owner's release
+ * can stop it. `MapController` owns its own transports and does not need this.
+ */
+export declare function descriptorToIR(desc: LayerDescriptor, onDataLoaded: () => void, owner?: DataTransportOwner): LayerIR | null;
 /**
  * Resolve JSON-safe/programmatic descriptors to deterministic snapshots.
  * URL data is represented as an empty pending layer and is never fetched.
@@ -292,7 +308,11 @@ export declare class MapController {
     flyToBounds(bounds: [[number, number], [number, number]], padding?: number, opts?: CameraOptions): void;
     setView(partial: Partial<CameraState>, opts?: CameraOptions): void;
     getViewState(): CameraState;
-    /** Pause descriptor-owned live transports while retaining canonical map state. */
+    /**
+     * Pause descriptor-owned live transports while retaining canonical map state.
+     * `retain` because this pause is meant to be reversed: `resume()` repaints the
+     * last rows immediately rather than showing an empty map while it reconnects.
+     */
     suspend(): void;
     /** Reacquire current descriptor transports and reconcile after foregrounding. */
     resume(): void;

package/dist/providers.d.ts

@@ -0,0 +1,48 @@
+/**
+ * Routing provider registry (spec: "Routing & Tracking", v0.6.7). A
+ * `RoutingProvider` computes a route from an origin/destination/waypoints
+ * request — kept swappable in code (a plugin registry, the
+ * `registerBasemap`/`registerTerrain` precedent) even though v1 ships
+ * exactly one concrete adapter (NIKA, below), so a second provider is a
+ * registry addition later, not a rewrite.
+ *
+ * Tracking deliberately has NO separate provider abstraction here: per the
+ * design doc, live position updates ride the EXISTING data/source streaming
+ * machinery (`OmMap.registerSource`) — a tracking feed is just a
+ * `<om-layer type="Tracking">` whose `data` points at a `wss://` URL with a
+ * registered `SourcePlugin` decoder, nothing new to build for that half.
+ */
+export interface RouteWaypoint {
+    lng: number;
+    lat: number;
+    stop?: boolean;
+}
+export interface RouteRequest {
+    waypoints: RouteWaypoint[];
+    profile?: "driving" | "walking" | "cycling";
+}
+export interface RouteLeg {
+    distanceMeters: number;
+    durationSec: number;
+}
+/** Normalized route shape every provider returns — GeoJSON end-to-end (v1 ships GeoJSON only; encoded-polyline decoding is a deferred dependency, see the architecture doc). */
+export interface Route {
+    geometry: {
+        type: "LineString";
+        coordinates: [number, number][];
+    };
+    distanceMeters: number;
+    /** `NaN` when no speed model exists to derive it (the direct-`geometry` authoring path) — a provider-computed route always supplies a real value. */
+    durationSec: number;
+    legs?: RouteLeg[];
+}
+export interface RoutingProvider {
+    computeRoute(request: RouteRequest, opts?: {
+        signal?: AbortSignal;
+    }): Promise<Route>;
+}
+export declare function registerRoutingProvider(name: string, provider: RoutingProvider): void;
+export declare function getRoutingProvider(name: string): RoutingProvider | undefined;
+/** Great-circle length of a LineString, in meters — used both by the direct-`geometry` authoring path (no provider round-trip needed for an already-computed route) and available to any provider adapter that needs it. */
+export declare function lineStringLengthMeters(coordinates: readonly (readonly [number, number])[]): number;
+export declare const nikaRoutingProvider: RoutingProvider;

package/dist/{raster-Cuzhibe2.js → raster-DtyMY54Z.js}

@@ -1,4 +1,4 @@
-import { c as re, t as Ae, i as nt, a as Re, s as rt, C as ot, b as it, F as at, A as st, d as lt, R as he, e as ct, p as ut, m as dt, f as ht, g as pt, h as gt } from "./raster-pipeline-DLrnJK8y.js";
+import { c as re, t as Ae, i as nt, a as Re, s as rt, C as ot, b as it, F as at, A as st, d as lt, R as he, e as ct, p as ut, m as dt, f as ht, g as pt, h as gt } from "./raster-pipeline-BmHRCUEb.js";
 import pe from "./index-CW1n5LdO.js";
 function mt(e, t) {
   const n = e.length / 3, r = new Uint8ClampedArray(n * 4), o = 0, i = n, a = n * 2;
@@ -1069,7 +1069,7 @@ A.set(m.Zstd, () => import("./zstd-jXobGRcq.js").then((e) => e.decode));
 A.set(m.Jpeg, () => Promise.resolve(oe));
 A.set(m.Jpeg6, () => Promise.resolve(oe));
 A.set(m.Webp, () => Promise.resolve(oe));
-A.set(m.Lerc, () => import("./lerc-C6k7EzSN.js").then((e) => e.l).then((e) => e.decode));
+A.set(m.Lerc, () => import("./lerc-BgzbFAc7.js").then((e) => e.l).then((e) => e.decode));
 async function ie(e, t, n) {
   const r = A.get(t);
   if (!r)

package/dist/{raster-pipeline-DLrnJK8y.js → raster-pipeline-BmHRCUEb.js}

@@ -1,5 +1,5 @@
 import { w as ae } from "./mgrs-BY9bIvp4.js";
-import { am as ce, an as le, ao as ee, ap as te, aq as ue, b as he, ar as de, l as Z, as as fe, d as pe, at as me, au as ge, av as ve, aw as ne } from "./index-7B-6Cbzu.js";
+import { am as ce, an as le, ao as ee, ap as te, aq as ue, b as he, ar as de, l as Z, as as fe, d as pe, at as me, au as ge, av as ve, aw as ne } from "./index-CAuq7wRs.js";
 function Pe(o, e, t) {
   const { projectedCorners: n } = e, { topLeft: s, topRight: r, bottomRight: a, bottomLeft: i } = n, c = t(s[0], s[1]), u = t(r[0], r[1]), l = t(a[0], a[1]), d = t(i[0], i[1]), f = [
     c,

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

@@ -1,4 +1,4 @@
-import type { LayerDescriptor, Selection } from "@nika-js/onlymap";
+import type { LayerDescriptor, LayerFilterFieldSpec, LayerCategoryFilterFieldSpec, Selection } from "@nika-js/onlymap";
 export interface OmLayerProps {
     /** Stable identity — same contract as the `id` attribute. */
     id: string;
@@ -14,12 +14,16 @@ export interface OmLayerProps {
     /** Legend metadata (ctx.layers). */
     label?: string;
     color?: string;
-    /** GPU filter (DataFilterExtension) — mirrors filter-field/filter-range. */
+    /** GPU filter (DataFilterExtension) — mirrors filter-field/filter-range (single dimension). */
     filterField?: string;
     filterRange?: [number, number];
     filterSoftRange?: [number, number];
+    /** Multi-dimension GPU filter (up to 4) — mirrors `filter-fields`. Wins over `filterField`/`filterRange` if both are set. */
+    filterFields?: LayerFilterFieldSpec[];
     filterCategoryField?: string;
     filterCategories?: unknown[];
+    /** Multi-dimension categorical GPU filter (up to 4) — mirrors `filter-category-fields`. Wins over `filterCategoryField`/`filterCategories` if both are set. */
+    filterCategoryFields?: LayerCategoryFilterFieldSpec[];
     /** Dashed path styling, mirroring `dash` / `dash-justified`. */
     dash?: [number, number];
     dashJustified?: boolean;

package/dist/react.js

@@ -1,13 +1,13 @@
 var Ee = Object.defineProperty;
-var Re = (e, t, s) => t in e ? Ee(e, t, { enumerable: !0, configurable: !0, writable: !0, value: s }) : e[t] = s;
-var oe = (e, t, s) => Re(e, typeof t != "symbol" ? t + "" : t, s);
+var Fe = (e, t, s) => t in e ? Ee(e, t, { enumerable: !0, configurable: !0, writable: !0, value: s }) : e[t] = s;
+var oe = (e, t, s) => Fe(e, typeof t != "symbol" ? t + "" : t, s);
 import { jsxs as X, jsx as O } from "react/jsx-runtime";
-import { createContext as xe, useContext as Fe, forwardRef as Te, useRef as h, useState as j, useId as ce, useCallback as se, useMemo as L, useLayoutEffect as ie, useEffect as x, useImperativeHandle as Pe, useSyncExternalStore as de } from "react";
-import { MANAGED_SLOTS as Ce, slotContainerStyle as ke, FOLD_SIDES as A, MapController as Le, parseWidgetStyle as Me, foldToggleSlot as $e, foldToggleStyle as je, foldPanelStyle as De, foldDrawerStyle as _e, resolveFoldBreakpointPx as Ae, shouldFoldAtWidth as Ie, DEFAULT_FOLD_BREAKPOINT_PX as ze, resolveSlot as Ke, foldSideForSlot as He, isStoreToken as Ne } from "@nika-js/onlymap";
+import { createContext as Re, useContext as xe, forwardRef as Ce, useRef as h, useState as j, useId as ce, useCallback as se, useMemo as L, useLayoutEffect as ie, useEffect as R, useImperativeHandle as Te, useSyncExternalStore as de } from "react";
+import { MANAGED_SLOTS as Pe, slotContainerStyle as ke, FOLD_SIDES as A, MapController as Le, parseWidgetStyle as Me, foldToggleSlot as $e, foldToggleStyle as je, foldPanelStyle as De, foldDrawerStyle as _e, resolveFoldBreakpointPx as Ae, shouldFoldAtWidth as Ie, DEFAULT_FOLD_BREAKPOINT_PX as ze, resolveSlot as Ke, foldSideForSlot as He, isStoreToken as Ne } from "@nika-js/onlymap";
 import { createPortal as ue } from "react-dom";
-const fe = xe(null);
+const fe = Re(null);
 function W(e) {
-  const t = Fe(fe);
+  const t = xe(fe);
   if (!t) throw new Error(`[onlymapjs] ${e} must be rendered inside <OmMap>.`);
   return t;
 }
@@ -33,7 +33,7 @@ class qe {
     this.descriptors.delete(t) && this.controller.setLayers([...this.descriptors.values()]);
   }
 }
-const N = Ce, Ve = Object.fromEntries(N.map((e) => [e, ke(e)])), ae = { display: "flex", pointerEvents: "none", order: 2147483647 }, Be = Object.fromEntries(A.map((e) => [e, null]));
+const N = Pe, Ve = Object.fromEntries(N.map((e) => [e, ke(e)])), ae = { display: "flex", pointerEvents: "none", order: 2147483647 }, Be = Object.fromEntries(A.map((e) => [e, null]));
 function Je(e) {
   const t = e.querySelector(
     'button:not([disabled]),a[href],input:not([disabled]),select:not([disabled]),textarea:not([disabled]),[tabindex]:not([tabindex="-1"])'
@@ -43,10 +43,10 @@ function Je(e) {
 function Ye(e, t) {
   return Object.entries(t).some(([s, o]) => o !== void 0 && e[s] !== o);
 }
-const nt = Te(function(t, s) {
-  const { center: o, zoom: i, pitch: m, bearing: c, basemap: l, basemapKey: g, attribution: p, headless: d, widgetStyle: F, widgetsHidden: v, widgetsFold: b = !0, className: y, style: T, children: w } = t, E = h(null), C = h(null), [a, M] = j(null), [k, q] = j(null), [P, D] = j(
+const nt = Ce(function(t, s) {
+  const { center: o, zoom: i, pitch: m, bearing: c, basemap: l, basemapKey: g, attribution: p, headless: d, widgetStyle: x, widgetsHidden: v, widgetsFold: b = !0, className: y, style: C, children: w } = t, E = h(null), P = h(null), [a, M] = j(null), [k, q] = j(null), [T, D] = j(
     () => Object.fromEntries(N.map((r) => [r, null]))
-  ), [R, I] = j(!1), [V, me] = j(Be), [ge, ye] = j(
+  ), [F, I] = j(!1), [V, me] = j(Be), [ge, ye] = j(
     () => Object.fromEntries(A.map((r) => [r, 0]))
   ), [be, B] = j(null), Z = `om-react-fold-${ce().replaceAll(":", "")}`, he = h(new Map(A.map((r) => [r, /* @__PURE__ */ new Set()]))), ee = d ? JSON.stringify(d) : "", z = h({
     badge: null,
@@ -88,9 +88,9 @@ const nt = Te(function(t, s) {
     if (f(r.getBoundingClientRect().width || (d ? d === !0 ? 800 : d.width ?? 800 : 0)), typeof ResizeObserver > "u") return;
     const S = new ResizeObserver(([_]) => f(_.contentRect.width));
     return S.observe(r), () => S.disconnect();
-  }, [b, ee]), x(() => {
-    (!R || v) && B(null);
-  }, [R, v]);
+  }, [b, ee]), R(() => {
+    (!F || v) && B(null);
+  }, [F, v]);
   const re = h({ center: o, zoom: i, pitch: m, bearing: c });
   re.current = { center: o, zoom: i, pitch: m, bearing: c };
   const K = h(t.onReady);
@@ -103,10 +103,10 @@ const nt = Te(function(t, s) {
   J.current = l;
   const Y = h(void 0);
   ie(() => {
-    if (!C.current) return;
+    if (!P.current) return;
     const r = re.current;
     Y.current = J.current;
-    const n = new Le(C.current, {
+    const n = new Le(P.current, {
       center: r.center,
       zoom: r.zoom,
       pitch: r.pitch,
@@ -132,13 +132,13 @@ const nt = Te(function(t, s) {
     }), () => {
       u = !1, M(null), n.destroy();
     };
-  }, [ee]), x(() => {
+  }, [ee]), R(() => {
     !a || Y.current === l || (Y.current = l, a.setBasemap(l ?? null));
-  }, [a, l]), Pe(s, () => a, [a]), x(() => {
+  }, [a, l]), Te(s, () => a, [a]), R(() => {
     if (!a) return;
     const r = { longitude: o == null ? void 0 : o[0], latitude: o == null ? void 0 : o[1], zoom: i, pitch: m, bearing: c };
     Ye(a.getViewState(), r) && a.setView(r);
-  }, [a, o == null ? void 0 : o[0], o == null ? void 0 : o[1], i, m, c]), x(() => {
+  }, [a, o == null ? void 0 : o[0], o == null ? void 0 : o[1], i, m, c]), R(() => {
     var r;
     if (a)
       return (r = $.current) == null || r.call($, a.getViewState()), a.getStore("viewport").subscribe(() => {
@@ -153,15 +153,15 @@ const nt = Te(function(t, s) {
       zIndex: 20,
       pointerEvents: "none",
       opacity: "var(--om-widget-opacity, 1)",
-      ...F ? Me(F).properties : void 0
+      ...x ? Me(x).properties : void 0
     }),
-    [F]
+    [x]
   ), G = L(() => a ? new qe(a) : null, [a]), ne = L(
-    () => a && G && k ? { controller: a, layers: G, overlayPane: k, corners: P, widgetsHidden: !!v, widgetsFolded: R, foldPanels: V, registerFoldedWidget: te } : null,
-    [a, G, k, P, v, R, V, te]
+    () => a && G && k ? { controller: a, layers: G, overlayPane: k, corners: T, widgetsHidden: !!v, widgetsFolded: F, foldPanels: V, registerFoldedWidget: te } : null,
+    [a, G, k, T, v, F, V, te]
   );
-  return /* @__PURE__ */ X("div", { ref: E, className: y, style: { position: "relative", overflow: "hidden", ...T }, children: [
-    /* @__PURE__ */ O("div", { ref: C, style: { position: "absolute", inset: 0 } }),
+  return /* @__PURE__ */ X("div", { ref: E, className: y, style: { position: "relative", overflow: "hidden", ...C }, children: [
+    /* @__PURE__ */ O("div", { ref: P, style: { position: "absolute", inset: 0 } }),
     /* @__PURE__ */ O(
       "div",
       {
@@ -176,10 +176,10 @@ const nt = Te(function(t, s) {
         ref: ve[r],
         style: {
           ...Ve[r],
-          ...R && r === "bottom-end" ? { bottom: "calc(var(--om-widget-inset-y, 12px) + 28px)" } : void 0
+          ...F && r === "bottom-end" ? { bottom: "calc(var(--om-widget-inset-y, 12px) + 28px)" } : void 0
         },
         children: [
-          R && A.filter((n) => $e(n) === r && ge[n] > 0).map((n) => {
+          F && A.filter((n) => $e(n) === r && ge[n] > 0).map((n) => {
             const u = be === n;
             return /* @__PURE__ */ X(
               "div",
@@ -262,8 +262,10 @@ const nt = Te(function(t, s) {
   "filterField",
   "filterRange",
   "filterSoftRange",
+  "filterFields",
   "filterCategoryField",
   "filterCategories",
+  "filterCategoryFields",
   "dash",
   "dashJustified",
   "source",
@@ -288,8 +290,10 @@ function Ue(e) {
     filterField: e.filterField,
     filterRange: e.filterRange,
     filterSoftRange: e.filterSoftRange,
+    filterFields: e.filterFields,
     filterCategoryField: e.filterCategoryField,
     filterCategories: e.filterCategories,
+    filterCategoryFields: e.filterCategoryFields,
     dash: e.dash,
     dashJustified: e.dashJustified,
     source: e.source,
@@ -303,13 +307,13 @@ function Ue(e) {
 }
 function ot(e) {
   const { controller: t, layers: s } = W("OmLayer"), { id: o } = e, i = Ue(e);
-  x(() => {
+  R(() => {
     s.upsert(i);
-  }), x(() => () => s.remove(o), [s, o]);
+  }), R(() => () => s.remove(o), [s, o]);
   const m = h(e.onClick);
   m.current = e.onClick;
   const c = h(e.onHover);
-  return c.current = e.onHover, x(
+  return c.current = e.onHover, R(
     () => t.watchPicks((l) => {
       var g, p, d;
       if (l === null) {
@@ -322,14 +326,14 @@ function ot(e) {
   ), null;
 }
 function st({ position: e = "top-start", order: t, fold: s, className: o, style: i, children: m }) {
-  const { corners: c, widgetsHidden: l, widgetsFolded: g, foldPanels: p, registerFoldedWidget: d } = W("OmWidget"), F = ce(), v = Ke(e) ?? "top-start", b = g && v !== "manual" && s !== "never", y = v === "manual" ? null : He(v);
-  if (x(() => {
+  const { corners: c, widgetsHidden: l, widgetsFolded: g, foldPanels: p, registerFoldedWidget: d } = W("OmWidget"), x = ce(), v = Ke(e) ?? "top-start", b = g && v !== "manual" && s !== "never", y = v === "manual" ? null : He(v);
+  if (R(() => {
     if (y)
-      return d(y, F, b), () => d(y, F, !1);
-  }, [y, F, b, d]), v === "manual")
+      return d(y, x, b), () => d(y, x, !1);
+  }, [y, x, b, d]), v === "manual")
     return /* @__PURE__ */ O("div", { className: o, style: { pointerEvents: "auto", ...i }, children: m });
-  const T = b && y ? p[y] : c[v];
-  return T ? ue(
+  const C = b && y ? p[y] : c[v];
+  return C ? ue(
     /* @__PURE__ */ O(
       "div",
       {
@@ -345,7 +349,7 @@ function st({ position: e = "top-start", order: t, fold: s, className: o, style:
         children: m
       }
     ),
-    T
+    C
   ) : null;
 }
 function le(e, t, s, o) {
@@ -367,12 +371,12 @@ function it(e) {
   m.current = e;
   const c = L(() => {
     const b = t.getStore("selection");
-    let y, T, w = null;
+    let y, C, w = null;
     return {
       subscribe: b.subscribe,
       getSnapshot: () => {
-        const E = b.getSnapshot(), { anchorFrom: C, layer: a, selectionType: M } = m.current, k = `${C ?? ""}|${a ?? ""}|${M ?? ""}`;
-        return (E !== y || k !== T) && (y = E, T = k, C === "selection" && le(E, a, M, t.getLastPickType()) && (w = E)), w;
+        const E = b.getSnapshot(), { anchorFrom: P, layer: a, selectionType: M } = m.current, k = `${P ?? ""}|${a ?? ""}|${M ?? ""}`;
+        return (E !== y || k !== C) && (y = E, C = k, P === "selection" && le(E, a, M, t.getLastPickType()) && (w = E)), w;
       }
     };
   }, [t]), l = de(
@@ -380,28 +384,28 @@ function it(e) {
     c.getSnapshot,
     c.getSnapshot
   );
-  x(
-    () => t.registerOverlay((b, y, T) => {
+  R(
+    () => t.registerOverlay((b, y, C) => {
       const w = o.current;
       if (!w) return;
-      const { anchor: E, anchorFrom: C, layer: a, selectionType: M, visible: k = !0, anchorOffset: q } = m.current;
-      let P;
-      if (C === "selection" ? (le(y, a, M, T) && (i.current = (y == null ? void 0 : y.coordinate) ?? void 0), P = i.current) : P = E, !k || !P || !b) {
+      const { anchor: E, anchorFrom: P, layer: a, selectionType: M, visible: k = !0, anchorOffset: q } = m.current;
+      let T;
+      if (P === "selection" ? (le(y, a, M, C) && (i.current = (y == null ? void 0 : y.coordinate) ?? void 0), T = i.current) : T = E, !k || !T || !b) {
         w.style.visibility = "hidden";
         return;
       }
-      const [D, R, I] = b.project([P[0], P[1], P[2] ?? 0]);
-      if (!(D >= 0 && D <= b.width && R >= 0 && R <= b.height) || I !== void 0 && I < 0) {
+      const [D, F, I] = b.project([T[0], T[1], T[2] ?? 0]);
+      if (!(D >= 0 && D <= b.width && F >= 0 && F <= b.height) || I !== void 0 && I < 0) {
         w.style.visibility = "hidden";
         return;
       }
-      w.style.visibility = "visible", w.style.transform = `translate(${D}px, ${R}px) ${Xe[q ?? "bottom-center"]}`;
+      w.style.visibility = "visible", w.style.transform = `translate(${D}px, ${F}px) ${Xe[q ?? "bottom-center"]}`;
     }),
     [t]
-  ), x(() => {
+  ), R(() => {
     t.refreshOverlays();
   });
-  const { children: g, className: p, style: d, interactive: F = !0 } = e, v = typeof g == "function" ? g(l) : g;
+  const { children: g, className: p, style: d, interactive: x = !0 } = e, v = typeof g == "function" ? g(l) : g;
   return ue(
     /* @__PURE__ */ O(
       "div",
@@ -415,7 +419,7 @@ function it(e) {
           visibility: "hidden",
           // hidden until the first flush positions it — never flashes at the origin
           willChange: "transform",
-          pointerEvents: F ? "auto" : "none",
+          pointerEvents: x ? "auto" : "none",
           ...d
         },
         children: v

package/dist/tracking-interpolation.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Drives interpolation + follow-camera for `type="Tracking"` layers (spec:
+ * "Routing & Tracking"). Deliberately isolated from `RuntimeCore.reconcile`'s
+ * own internals — called as one line from that method, reusing the SAME
+ * per-frame channel `trace`/`pulse` already ride (`runLayerEffect`/
+ * `patchAnimatedProps`, src/effects.ts), not a parallel animation system.
+ *
+ * Position/bearing come from the layer's OWN already-resolved IR props (the
+ * compiled `getPosition` accessor, the `bearingField` name) — no new
+ * field-resolution kernel invented for this.
+ */
+import type { RuntimeCore } from "./runtime-core";
+import type { LayerIR } from "./ir";
+/** Shortest-path angle interpolation — a plain lerp on raw degrees would swing the long way around at the 0/360 wrap (350° → 10° should pass through 0°, not backward through 180°). Exported for direct unit testing (the `traceProgress`/`pulseOpacity` precedent in effects.ts — "pure math, unit-testable without a clock"). */
+export declare function lerpAngle(a: number, b: number, t: number): number;
+/**
+ * Called once per `reconcile()`, after `RuntimeCore.lastIRs` is updated —
+ * needs the PREVIOUS set (passed in explicitly) to detect a genuine new fix
+ * vs. an unrelated reconcile (a sibling layer's edit, a story step) that
+ * left this layer's `data` reference untouched.
+ */
+export declare function updateTrackingLayers(core: RuntimeCore, previousIRs: readonly LayerIR[], irs: readonly LayerIR[]): void;

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.6.2";
+export declare const LIBRARY_VERSION = "0.6.7";

package/dist/{zarr-CUzEX8fB.js → zarr-CTpFZo_m.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-DLrnJK8y.js";
-import { ap as gr } from "./index-7B-6Cbzu.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-BmHRCUEb.js";
+import { ap as gr } from "./index-CAuq7wRs.js";
 import $t from "./index-CW1n5LdO.js";
 var Et;
 function h(e, t, n) {

package/docs/3d-assets.md

@@ -181,7 +181,7 @@ Face counts are long-tailed, so the building count you can fit is not predictabl
 
 ### Visible edges in surfaces mode
 
-Surfaces mode is flat-shaded, so adjacent faces at similar heights (e.g. a LoD2.2 hip roof's planes) can be hard to tell apart by color alone. Each row carries an `outline` field — the same face's outer ring, flattened and closed — for exactly this: give a `PathLayer` `get-path="$outline"` and it traces real per-face edges. Always pair one with a surfaces-mode `SolidPolygonLayer`; deck's `wireframe` prop on `SolidPolygonLayer` only builds wireframe geometry when `extruded: true`, so it does nothing in this unextruded mode. Point the `PathLayer` at the same `data` URL (the cache is keyed by URL, so this doesn't cost a second fetch) and mirror the fill layer's `filter-field`/`filter-range` so filtered-out buildings' outlines disappear too.
+Surfaces mode is flat-shaded, so adjacent faces at similar heights (e.g. a LoD2.2 hip roof's planes) can be hard to tell apart by color alone. Each row carries an `outline` field — the same face's outer ring, flattened and closed — for exactly this: give a `PathLayer` `get-path="$outline"` and it traces real per-face edges. Always pair one with a surfaces-mode `SolidPolygonLayer`; deck's `wireframe` prop on `SolidPolygonLayer` only builds wireframe geometry when `extruded: true`, so it does nothing in this unextruded mode. Point the `PathLayer` at the same `data` URL (the cache is keyed by URL plus live-source options, so two plain layers on one URL share a single fetch — give one of them a `refresh`/stream attribute the other lacks and they become separate requests) and mirror the fill layer's `filter-field`/`filter-range` so filtered-out buildings' outlines disappear too.
 
 The semantics still do work in both modes: they decide which surfaces count as roof, so these are real roof measurements rather than bounding-box numbers. Derived names win over a same-named source attribute, so manifests can rely on them.
 

package/docs/live-data.md

@@ -86,6 +86,23 @@ handles while preserving descriptors and rendered state;
 This is the intended app-background/app-foreground integration for native
 hosts.
 
+A transport released by an owner that means to come back leaves its **last rows
+behind as a cold snapshot**, keyed by the same transport identity. Re-acquiring
+it — `resume()`, or re-adding a layer you removed — repaints those rows
+immediately instead of flashing an empty layer while the first fetch or stream
+message arrives; on a 30-second feed that gap would otherwise be 30 seconds of
+blank map after every foreground. A keyed stream also restores its upsert set,
+so the next message merges rather than replacing.
+
+Only reversible releases retain. `suspend()` and layer removal/re-pointing keep
+their rows; `MapController.destroy()` and an `<om-map>` leaving the document
+keep nothing, since neither can re-acquire. (Re-parenting a live `<om-map>`
+isn't a teardown at all — the release is deferred a microtask, so the transport
+never stops.) The snapshot is cold, not live: the first real response supersedes
+it, and polling readiness (`om-map-ready`) still waits for that response.
+Nothing is retained for a transport still held by another owner — it was never
+stopped.
+
 ## Testing live layers
 
 In the [headless harness](testing.md), mock the transport: `vi.stubGlobal("fetch", ...)` for polling (readiness waits for your mock), or `vi.stubGlobal("WebSocket", ...)` for streams. The library's own test suites are the reference patterns — including asserting *movement* (fixed entity count, changing coordinates) rather than just presence.