@nika-js/onlymap 0.6.4 → 0.6.11

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 c, aM as g, aN as A, aO as p, aP as m, aQ as _, aR as d, aS as I, aT as y, aU as D, aV as M, aW as u, 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 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 Ea, bw as Ta, bx as La, by as ca, bz as ga, bA as Aa, bB as pa, bC as ma, bD as _a, bE as da, bF as Ia, bG as ya, bH as Da, bI as Ma, bJ as ua, 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 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 } from "./index-Cxo9mCw_.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-BUp4hR6r.js";
 export {
   e as ALL_POSITION_VALUES,
   r as AUDIT_EXEMPTIONS,
@@ -9,34 +9,34 @@ 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,
-  c as FOLD_SIDES,
-  g 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,
-  D as OmMap,
-  M as ScatterplotLayer,
-  u as ScenegraphLayer,
+  u as MapController,
+  M as OmMap,
+  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,
+  v as auditLayout,
+  G as compileExpression,
+  U as compileFullJsAccessorBlockInSandbox,
+  W as computeTimeline,
   w as configureBasemap,
   x as configureData,
   Y as configureIfc,
@@ -57,47 +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,
-  ca as normalizeData,
-  ga 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,
   Da as registerLayer,
-  Ma as registerSource,
-  ua as registerTerrain,
-  Oa as registerWidget,
-  fa as releaseDataOwner,
-  Na as resolveFoldBreakpointPx,
-  Ra as resolveImageOverlay,
-  Pa as resolveLighting,
-  ha as resolveSlot,
-  Fa as ringAreaMeters2,
-  Ba as ringEnclosesPole,
-  Ca as ringPerimeterMeters,
-  Ga as rowAt,
-  Ua as sandboxHtml,
-  Wa as scaleBarStep,
-  va as setMeasureRadiusMeters,
-  wa as settleLayout,
-  xa as shouldFoldAtWidth,
-  Ya as slotContainerStyle,
-  Ha as slotLayout,
-  Xa as snapshotDescriptorIR,
-  ka as snapshotIR,
-  Ja as solarAzElDegrees,
-  Ka as validateManifest,
-  Va as validateManifestString
+  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,7 @@ 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";
@@ -50,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`. */
@@ -118,6 +123,20 @@ export interface MapControllerOptions {
     onMapPoint?: (coordinate: [number, number] | null, kind: "click" | "hover") => void;
     /** A Tile3DLayer finished loading its root tileset — the `om-tileset-load` DOM event's twin; `tileset` is the live deck `Tileset3D`. */
     onTilesetLoad?: (layerId: string, tileset: unknown) => void;
+    /** A Route layer finished resolving — the `om-route-resolved` DOM event's twin; `route` carries the normalized geometry/distanceMeters/durationSec/legs/bounds. */
+    onRouteResolved?: (layerId: string, route: {
+        geometry?: {
+            type: "LineString";
+            coordinates: [number, number][];
+        };
+        distanceMeters?: number;
+        durationSec?: number;
+        legs?: {
+            distanceMeters: number;
+            durationSec: number;
+        }[];
+        bounds?: [[number, number], [number, number]];
+    }) => void;
     /** A `pick-features` layer decoded its property table — the DOM front-end's internal `featureTables` bookkeeping, surfaced here since `ctx.features()` depends on it (see `RuntimeCoreCallbacks.onFeatureTable`). */
     onFeatureTable?: (layerId: string, rows: Record<string, unknown>[]) => void;
     /** A `carriesGeoreference` layer (BIMLayer) finished loading and read its own file's georeferencing (see `RuntimeCoreCallbacks.onGeoreference`). No front end auto-applies terrain (what-you-write-is-what-you-see) — call `controller.setTerrain(...)` from here if you want a reaction. `approximatePlacement` mirrors the DOM lane's data-quality warning. */

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-Cl5m3KsC.js → raster-BVzTnbhW.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-hJGxIwYx.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-FAPzre9S.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-gKDDtc69.js").then((e) => e.l).then((e) => e.decode));
+A.set(m.Lerc, () => import("./lerc-Cryu98-R.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-hJGxIwYx.js → raster-pipeline-FAPzre9S.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-Cxo9mCw_.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-BUp4hR6r.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/runtime-core.d.ts

@@ -8,6 +8,20 @@ import type { LayerIR } from "./ir";
 import { type Selection } from "./selection";
 import type { ValidationEntry } from "./validation";
 import type { MapViewport } from "./basemap";
+/** RouteLayer's own `onRouteResolved` report (spec: "Routing & Tracking") — a normalized Route plus its bounds. `bounds` drives `follow="fit-route"` here; the WHOLE object forwards to `RuntimeCoreCallbacks.onRouteResolved` (the `om-route-resolved` consumer event), so a page can read a provider-resolved route's geometry/distance/duration without re-fetching it. */
+interface RouteResolvedInfo {
+    geometry?: {
+        type: "LineString";
+        coordinates: [number, number][];
+    };
+    distanceMeters?: number;
+    durationSec?: number;
+    legs?: {
+        distanceMeters: number;
+        durationSec: number;
+    }[];
+    bounds?: [[number, number], [number, number]];
+}
 /**
  * The tile-level EXT_structural_metadata property-table index, resolved
  * independently of `FeatureMeshLayer`'s own copy of this same computation.
@@ -153,6 +167,13 @@ export interface RuntimeCoreCallbacks {
      * @loaders.gl/tiles type dependency in the core).
      */
     onTilesetLoad?: (layerId: string, tileset: unknown) => void;
+    /**
+     * A `carriesRoute` layer (Route) finished resolving its route — direct
+     * `geometry` or a `RoutingProvider` round-trip alike. The `om-route-resolved`
+     * consumer event's source; `route` carries the normalized geometry/
+     * distanceMeters/durationSec/legs plus the fitted bounds.
+     */
+    onRouteResolved?: (layerId: string, route: RouteResolvedInfo) => void;
     /**
      * A `carriesGeoreference` layer (BIMLayer) finished loading its source file
      * and read whatever georeferencing it declares — `hasFullMapConversion`

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

package/dist/{zarr-hRDavRGV.js → zarr-DCWSzKoG.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-hJGxIwYx.js";
-import { ap as gr } from "./index-Cxo9mCw_.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-FAPzre9S.js";
+import { ap as gr } from "./index-BUp4hR6r.js";
 import $t from "./index-CW1n5LdO.js";
 var Et;
 function h(e, t, n) {