@nika-js/onlymap 0.6.1 → 0.6.4

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 m, aP as _, aQ as d, aR as p, 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 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 ca, bA as Aa, bB as ma, bC as _a, bD as da, bE as pa, 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 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, c0 as ka, c1 as Ja } from "./index-1UgNlfGR.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 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";
 export {
   e as ALL_POSITION_VALUES,
   r as AUDIT_EXEMPTIONS,
@@ -12,33 +12,33 @@ export {
   E as DRONE_SENSOR_DATABASE,
   T as EDGE_TOLERANCE_PX,
   L as FOLD_HYSTERESIS_PX,
-  g as FOLD_SIDES,
-  c as GeoJsonLayer,
+  c as FOLD_SIDES,
+  g as GeoJsonLayer,
   A as IconLayer,
-  m as LEGACY_POSITION_ALIASES,
-  _ as LIGHTING_PRESET_NAMES,
-  d as Layer,
-  p as LayerExtension,
+  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,
+  D as OmMap,
+  M as ScatterplotLayer,
+  u as ScenegraphLayer,
   O as SimpleMeshLayer,
   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,
   U as compileExpression,
   W as compileFullJsAccessorBlockInSandbox,
   v as computeTimeline,
-  x as configureBasemap,
-  w as configureData,
+  w as configureBasemap,
+  x as configureData,
   Y as configureIfc,
   H as configureLicense,
   X as configureTelemetry,
@@ -66,36 +66,38 @@ export {
   Ea as midpoint,
   Ta as mountForTest,
   La as niceNumber,
-  ga as normalizeData,
-  ca as parseDurationMs,
+  ca as normalizeData,
+  ga as parseDurationMs,
   Aa as parseTerrainAttrs,
-  ma as parseUnitSystem,
-  _a as parseWidgetStyle,
-  da as pathLengthMeters,
-  pa as registerAction,
+  pa as parseUnitSystem,
+  ma as parseWidgetStyle,
+  _a as pathLengthMeters,
+  da as registerAction,
   Ia as registerBasemap,
   ya as registerFormat,
-  Ma as registerLayer,
-  ua as registerSource,
-  Da as registerTerrain,
+  Da as registerLayer,
+  Ma as registerSource,
+  ua as registerTerrain,
   Oa as registerWidget,
-  fa as resolveFoldBreakpointPx,
-  Na as resolveImageOverlay,
-  Ra as resolveLighting,
-  Pa as resolveSlot,
+  fa as releaseDataOwner,
+  Na as resolveFoldBreakpointPx,
+  Ra as resolveImageOverlay,
+  Pa as resolveLighting,
+  ha as resolveSlot,
   Fa as ringAreaMeters2,
-  ha as ringEnclosesPole,
-  Ba as ringPerimeterMeters,
-  Ca as rowAt,
-  Ga as sandboxHtml,
-  Ua as scaleBarStep,
-  Wa as setMeasureRadiusMeters,
-  va as settleLayout,
+  Ba as ringEnclosesPole,
+  Ca as ringPerimeterMeters,
+  Ga as rowAt,
+  Ua as sandboxHtml,
+  Wa as scaleBarStep,
+  va as setMeasureRadiusMeters,
+  wa as settleLayout,
   xa as shouldFoldAtWidth,
-  wa as slotContainerStyle,
-  Ya as slotLayout,
-  Ha as snapshotIR,
-  Xa as solarAzElDegrees,
-  ka as validateManifest,
-  Ja as validateManifestString
+  Ya as slotContainerStyle,
+  Ha as slotLayout,
+  Xa as snapshotDescriptorIR,
+  ka as snapshotIR,
+  Ja as solarAzElDegrees,
+  Ka as validateManifest,
+  Va 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

@@ -22,13 +22,17 @@ 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 DataTransportOwner } from "./data-layer";
 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 +72,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";
@@ -125,8 +129,23 @@ 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.
+ */
+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, 
 /** Pointer event behind the latest pick — carries the type of an EMPTY pick (`selection` null), which the selection itself can't. */
@@ -158,6 +177,8 @@ export declare class MapController {
     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. */
@@ -282,6 +303,14 @@ 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.
+     * `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;
     /** 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-0b0nSHUh.js → raster-Cl5m3KsC.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-D8siq7-4.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-hJGxIwYx.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-CbTjQ7uI.js").then((e) => e.l).then((e) => e.decode));
+A.set(m.Lerc, () => import("./lerc-gKDDtc69.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-D8siq7-4.js → raster-pipeline-hJGxIwYx.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-1UgNlfGR.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";
 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;