@nika-js/onlymap 0.6.1 → 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 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 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,
@@ -15,10 +15,10 @@ export {
   g as FOLD_SIDES,
   c 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,
@@ -29,8 +29,8 @@ export {
   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,
@@ -69,10 +69,10 @@ export {
   ga as normalizeData,
   ca 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,
@@ -83,8 +83,8 @@ export {
   Na as resolveImageOverlay,
   Ra as resolveLighting,
   Pa as resolveSlot,
-  Fa as ringAreaMeters2,
-  ha as ringEnclosesPole,
+  ha as ringAreaMeters2,
+  Fa as ringEnclosesPole,
   Ba as ringPerimeterMeters,
   Ca as rowAt,
   Ga as sandboxHtml,
@@ -94,8 +94,9 @@ export {
   xa as shouldFoldAtWidth,
   wa as slotContainerStyle,
   Ya as slotLayout,
-  Ha as snapshotIR,
-  Xa as solarAzElDegrees,
-  ka as validateManifest,
-  Ja as validateManifestString
+  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";
@@ -127,6 +130,11 @@ export interface MapControllerOptions {
 }
 /** 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, 
 /** Pointer event behind the latest pick — carries the type of an EMPTY pick (`selection` null), which the selection itself can't. */
@@ -158,6 +166,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 +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-0b0nSHUh.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-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-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-CbTjQ7uI.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-D8siq7-4.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-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-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;