@nika-js/onlymap 0.6.0 → 0.6.2

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 A, aN as m, aO as _, aP as p, aQ as d, aR as c, aS as y, aT as I, aU as M, aV as u, aW as D, ao as O, aX as N, aw as R, aY as f, aZ as P, a_ as F, W as h, 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 Aa, bA as ma, bB as _a, bC as pa, bD as da, bE as ca, bF as ya, bG as Ia, bH as Ma, bI as ua, bJ as Da, bK as Oa, bL as Na, bM as Ra, bN as fa, bO as Pa, bP as Fa, bQ as ha, 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 } from "./index-Bz-rbmhj.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 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";
 export {
   e as ALL_POSITION_VALUES,
   r as AUDIT_EXEMPTIONS,
@@ -13,24 +13,24 @@ export {
   T as EDGE_TOLERANCE_PX,
   L as FOLD_HYSTERESIS_PX,
   g as FOLD_SIDES,
-  A as GeoJsonLayer,
-  m as IconLayer,
-  _ as LEGACY_POSITION_ALIASES,
-  p as LIGHTING_PRESET_NAMES,
-  d as Layer,
-  c as LayerExtension,
-  y as MANAGED_SLOTS,
-  I as MapController,
+  c as GeoJsonLayer,
+  A as IconLayer,
+  p as LEGACY_POSITION_ALIASES,
+  m as LIGHTING_PRESET_NAMES,
+  _ as Layer,
+  d as LayerExtension,
+  I as MANAGED_SLOTS,
+  y as MapController,
   M as OmMap,
   u as ScatterplotLayer,
   D as ScenegraphLayer,
   O as SimpleMeshLayer,
-  N as Tile3DLayer,
-  R as TileLayer,
-  f as UNIT_SYSTEMS,
+  f as Tile3DLayer,
+  N as TileLayer,
+  R as UNIT_SYSTEMS,
   P as WGS84_MEAN_RADIUS_M,
-  F as WIDGET_STYLE_KEY_NAMES,
-  h as WebMercatorViewport,
+  h as WIDGET_STYLE_KEY_NAMES,
+  F as WebMercatorViewport,
   B as arrowTableToColumnar,
   C as asRows,
   G as auditLayout,
@@ -39,61 +39,64 @@ export {
   v as computeTimeline,
   x as configureBasemap,
   w as configureData,
-  Y as configureLicense,
-  H as configureTelemetry,
-  X as descriptorToIR,
-  k as destroySandbox,
-  J as distanceMeters,
-  K as evaluateInSandbox,
-  V as foldDrawerStyle,
-  z as foldPanelStyle,
-  Q as foldSideForSlot,
-  Z as foldToggleSlot,
-  $ as foldToggleStyle,
-  j as formatArea,
-  q as formatLength,
-  aa as getBasemap,
-  sa as getEntitlements,
-  ea as getLayerSchema,
-  ra as getMeasureRadiusMeters,
-  ta as getTerrain,
-  oa as isBrowser,
-  ba as isColumnar,
-  ia as isStoreToken,
-  la as loadRasterModule,
-  na as midpoint,
-  Sa as mountForTest,
-  Ea as niceNumber,
-  Ta as normalizeData,
-  La as parseDurationMs,
-  ga as parseTerrainAttrs,
-  Aa as parseUnitSystem,
+  Y as configureIfc,
+  H as configureLicense,
+  X as configureTelemetry,
+  k as descriptorToIR,
+  J as destroySandbox,
+  K as distanceMeters,
+  V as evaluateInSandbox,
+  z as foldDrawerStyle,
+  Q as foldPanelStyle,
+  Z as foldSideForSlot,
+  $ as foldToggleSlot,
+  j as foldToggleStyle,
+  q as formatArea,
+  aa as formatLength,
+  sa as getBasemap,
+  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,
+  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,
-  pa as registerAction,
-  da as registerBasemap,
-  ca as registerFormat,
-  ya as registerLayer,
-  Ia as registerSource,
-  Ma as registerTerrain,
-  ua as registerWidget,
-  Da as resolveFoldBreakpointPx,
-  Oa as resolveImageOverlay,
-  Na as resolveLighting,
-  Ra as resolveSlot,
-  fa as ringAreaMeters2,
-  Pa as ringEnclosesPole,
-  Fa as ringPerimeterMeters,
-  ha as rowAt,
-  Ba as sandboxHtml,
-  Ca as scaleBarStep,
-  Ga as setMeasureRadiusMeters,
-  Ua as settleLayout,
-  Wa as shouldFoldAtWidth,
-  va as slotContainerStyle,
-  xa as slotLayout,
-  wa as snapshotIR,
-  Ya as solarAzElDegrees,
-  Ha as validateManifest,
-  Xa as validateManifestString
+  da as registerAction,
+  Ia 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
 };

package/dist/parse-manifest.d.ts

@@ -6,6 +6,7 @@
  * runtime-core.ts never does.
  */
 import type { LayerIR } from "./ir";
+import { type DataTransportOwner } from "./data-layer";
 export interface ParseManifestOptions {
     /**
      * IR-snapshot mode (see ir-snapshot.ts): resolve the manifest without side
@@ -15,5 +16,7 @@ export interface ParseManifestOptions {
      * would evict a concurrently-running live map's compiled accessors).
      */
     snapshot?: boolean;
+    /** Controller/element identity for descriptor-owned transport lifetime. */
+    dataOwner?: DataTransportOwner;
 }
 export declare function parseManifest(mapEl: Element, onDataLoaded: () => void, opts?: ParseManifestOptions): LayerIR[];

package/dist/programmatic.d.ts

@@ -25,10 +25,13 @@ import type { LayerMetaSnapshot } from "./ctx";
 import type { Selection } from "./selection";
 import type { ValidationEntry } from "./validation";
 import type { MapViewport } from "./basemap";
+import { type LayerIRSnapshot } from "./ir-snapshot";
 /**
  * A layer, declared as a typed value — the programmatic mirror of one
- * <om-layer> element. Accessors are plain JS functions (no expression
- * language, no trust step — first-party code is trusted by definition).
+ * <om-layer> element. First-party callers normally use plain JS accessor
+ * functions. A schema-declared accessor may alternatively be a restricted
+ * OnlyMap expression string; that JSON-safe form is intended for native and
+ * cross-process bridges and uses the same compiler as `get-*` attributes.
  */
 export interface LayerDescriptor {
     /** Stable identity — same contract as the `id` attribute. Required. */
@@ -68,7 +71,7 @@ export interface LayerDescriptor {
      * when an accessor's output changes (the deck-idiomatic contract).
      */
     updateTriggers?: Record<string, unknown>;
-    /** deck.gl props (camelCase), accessors as plain functions — passed through. */
+    /** deck.gl props (camelCase); accessors may be functions or restricted expression strings. */
     props?: Record<string, unknown>;
     /** Per-layer terrain mode (spec: "Terrain") — the `terrain` attribute's twin; absent = the type default. */
     terrain?: "drape" | "offset" | "off";
@@ -114,13 +117,28 @@ 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 `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. */
+    onGeoreference?: (layerId: string, info: {
+        orthogonalHeight?: number;
+        hasFullMapConversion: boolean;
+        approximatePlacement: boolean;
+    }) => void;
     /** @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;
+/**
+ * Resolve JSON-safe/programmatic descriptors to deterministic snapshots.
+ * URL data is represented as an empty pending layer and is never fetched.
+ */
+export declare function snapshotDescriptorIR(descriptors: readonly LayerDescriptor[]): LayerIRSnapshot[];
 /** rAF-batched overlay positioning hook — same flush contract as the DOM front-end's OverlayHost. */
-export type OverlayPositioner = (viewport: MapViewport | undefined, selection: Selection | null) => void;
+export type OverlayPositioner = (viewport: MapViewport | undefined, selection: Selection | null, 
+/** Pointer event behind the latest pick — carries the type of an EMPTY pick (`selection` null), which the selection itself can't. */
+pickType?: "hover" | "click") => void;
 /**
  * Pick stream for framework event handlers. `null` means the pointer left
  * whatever it was hovering (deck reports an empty pick) — the "hover out"
@@ -137,14 +155,19 @@ export declare class MapController {
     private core;
     private mount;
     private layerIRs;
+    /** Decoded property tables per pick-features layer — see RuntimeCoreCallbacks.onFeatureTable and the `<om-map>` twin's own field. */
+    private featureTables;
     private descriptors;
     private selection;
+    private lastPickType;
     private watchers;
     private pickListeners;
     private overlayFns;
     private overlayFlushPending;
     private commitPending;
     private destroyed;
+    private suspended;
+    private readonly dataOwner;
     private firstCommitDone;
     private readonly stores;
     /** Origin of the most recent viewport change FRAME — latched through the settle tracker for snapshot reads. */
@@ -207,6 +230,13 @@ export declare class MapController {
     /** Picked object, normalized to flat — same path as OmMapElement (GeoJSON properties lifted; columnar rows materialized). */
     private resolvePickedObject;
     private handleSelectionChange;
+    /**
+     * The pointer event behind the most recent pick — tracked separately from
+     * the selection because an EMPTY pick stores null, losing its type. What
+     * lets a `selectionType`-scoped overlay treat a click on empty space as a
+     * dismissal while ignoring hovers over empty space.
+     */
+    getLastPickType(): "hover" | "click" | undefined;
     getSelection(): Selection | null;
     /** Every hover/click pick (null = hover left) — the stream framework adapters route to per-layer onClick/onHover handlers. */
     watchPicks(listener: PickListener): () => void;
@@ -216,7 +246,7 @@ export declare class MapController {
      * flattening, watcher notification, and overlay flush are same-path by
      * construction.
      */
-    injectPick(selection: Selection | null): void;
+    injectPick(selection: Selection | null, pickType?: "hover" | "click"): void;
     /**
      * Registers an rAF-batched positioner: called with the fresh viewport +
      * selection whenever either may have moved (spec: "Overlay Renderer" —
@@ -262,6 +292,10 @@ 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. */
+    suspend(): void;
+    /** Reacquire current descriptor transports and reconcile after foregrounding. */
+    resume(): void;
     /** Projects a lng/lat through the current viewport — undefined before the viewport resolves. */
     project(lngLat: [number, number]): [number, number] | undefined;
     destroy(): void;

package/dist/{raster-dysYIQ_k.js → raster-Cuzhibe2.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-ZdCOGfqV.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-DLrnJK8y.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-CuifOkoA.js").then((e) => e.l).then((e) => e.decode));
+A.set(m.Lerc, () => import("./lerc-C6k7EzSN.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-ZdCOGfqV.js → raster-pipeline-DLrnJK8y.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-Bz-rbmhj.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";
 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 { Selection } from "@nika-js/onlymap";
+import type { LayerDescriptor, Selection } from "@nika-js/onlymap";
 export interface OmLayerProps {
     /** Stable identity — same contract as the `id` attribute. */
     id: string;
@@ -20,6 +20,9 @@ export interface OmLayerProps {
     filterSoftRange?: [number, number];
     filterCategoryField?: string;
     filterCategories?: unknown[];
+    /** Dashed path styling, mirroring `dash` / `dash-justified`. */
+    dash?: [number, number];
+    dashJustified?: boolean;
     /** Stream options for ws(s):// data URLs. `streamKey` is the upsert identity field (the `key` attribute — `key` itself is reserved by React). */
     source?: string;
     streamKey?: string;
@@ -37,4 +40,6 @@ export interface OmLayerProps {
     /** Everything else passes through as deck.gl props (camelCase): getPosition, radiusMinPixels, visible, opacity, pickable, … */
     [deckProp: string]: unknown;
 }
+/** @internal Pure React-props → programmatic descriptor adapter used by parity tests. */
+export declare function reactLayerPropsToDescriptor(props: OmLayerProps): LayerDescriptor;
 export declare function OmLayer(props: OmLayerProps): null;

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

@@ -8,6 +8,15 @@ export interface OmOverlayProps {
     anchorFrom?: "selection";
     /** Scope a selection-anchored overlay to one layer's picks — non-matching selections don't move or re-render it. */
     layer?: string;
+    /**
+     * Scope a selection-anchored overlay to one PICK TYPE. A click-opened popup
+     * wants `"click"`: without it, merely hovering any pickable feature drags
+     * the popup there and re-renders it against the hovered object. With it,
+     * hover picks are inert and a click on empty space still dismisses.
+     * `"hover"` is the mirror for hover-driven overlays. Absent: every pick
+     * applies.
+     */
+    selectionType?: "click" | "hover";
     visible?: boolean;
     /** Attachment point relative to the anchor (default bottom-center: content sits above the point). */
     anchorOffset?: AnchorOffset;