@nika-js/onlymap 0.3.5 → 0.4.1

package/dist/onlymapjs.js

@@ -1,58 +1,67 @@
-import { ay as e, az as r, aA as o, aB as t, aq as i, aC as n, aD as b, aE as l, aF as c, aG as g, aH as m, aI as p, aJ as L, aK as y, ap as T, aL as S, ax as u, W as d, aM as E, aN as M, aO as A, aP as I, aQ as f, aR as x, aS as C, aT as h, aU as B, aV as D, aW as R, aX as w, aY as v, aZ as F, a_ as G, a$ as N, b0 as O, b1 as W, b2 as _, b3 as z, b4 as H, b5 as J, b6 as k, b7 as P, b8 as V, b9 as Y, ba as j, bb as q, bc as K, bd as Q, be as U, bf as X, bg as Z, bh as $, bi as aa, bj as sa, bk as ea } from "./index-i_KAvtQZ.js";
+import { ay as e, az as r, aA as o, aB as t, aC as i, aq as n, aD as b, aE as l, aF as S, aG as L, aH as p, aI as c, aJ as g, aK as m, aL as T, aM as y, aN as E, ap as A, aO as I, ax as u, aP as d, W as M, aQ as _, aR as C, aS as D, aT as O, aU as f, aV as x, aW as N, aX as h, aY as B, aZ as G, a_ as R, a$ as W, b0 as v, b1 as w, b2 as Y, b3 as F, b4 as P, b5 as k, b6 as z, b7 as H, b8 as J, b9 as V, ba as q, bb as K, bc as U, bd as j, be as Q, bf as X, bg as Z, bh as $, bi as aa, bj as sa, bk as ea, bl as ra, bm as oa, bn as ta, bo as ia, bp as na, bq as ba, br as la, bs as Sa, bt as La } from "./index-BKiyX-jQ.js";
 export {
-  e as AccessorCache,
-  r as BitmapLayer,
-  o as COORDINATE_SYSTEM,
-  t as CompileError,
-  i as CompositeLayer,
-  n as GeoJsonLayer,
-  b as IconLayer,
-  l as LIGHTING_PRESET_NAMES,
-  c as Layer,
-  g as LayerExtension,
+  e as ALL_POSITION_VALUES,
+  r as AccessorCache,
+  o as BitmapLayer,
+  t as COORDINATE_SYSTEM,
+  i as CompileError,
+  n as CompositeLayer,
+  b as GeoJsonLayer,
+  l as IconLayer,
+  S as LEGACY_POSITION_ALIASES,
+  L as LIGHTING_PRESET_NAMES,
+  p as Layer,
+  c as LayerExtension,
+  g as MANAGED_SLOTS,
   m as MapController,
-  p as OmMap,
-  L as ScatterplotLayer,
-  y as ScenegraphLayer,
-  T as SimpleMeshLayer,
-  S as Tile3DLayer,
+  T as OmMap,
+  y as ScatterplotLayer,
+  E as ScenegraphLayer,
+  A as SimpleMeshLayer,
+  I as Tile3DLayer,
   u as TileLayer,
-  d as WebMercatorViewport,
-  E as arrowTableToColumnar,
-  M as asRows,
-  A as compileExpression,
-  I as compileFullJsAccessorBlockInSandbox,
+  d as WIDGET_STYLE_KEY_NAMES,
+  M as WebMercatorViewport,
+  _ as arrowTableToColumnar,
+  C as asRows,
+  D as compileExpression,
+  O as compileFullJsAccessorBlockInSandbox,
   f as computeTimeline,
   x as configureBasemap,
-  C as configureData,
+  N as configureData,
   h as configureLicense,
   B as configureTelemetry,
-  D as descriptorToIR,
+  G as descriptorToIR,
   R as destroySandbox,
-  w as evaluateInSandbox,
+  W as evaluateInSandbox,
   v as getBasemap,
-  F as getEntitlements,
-  G as getLayerSchema,
-  N as getTerrain,
-  O as isBrowser,
-  W as isColumnar,
-  _ as loadRasterModule,
-  z as mountForTest,
-  H as normalizeData,
-  J as parseDurationMs,
-  k as parseTerrainAttrs,
-  P as registerAction,
-  V as registerBasemap,
-  Y as registerFormat,
-  j as registerLayer,
-  q as registerSource,
-  K as registerTerrain,
-  Q as registerWidget,
-  U as resolveLighting,
-  X as rowAt,
-  Z as sandboxHtml,
-  $ as snapshotIR,
-  aa as solarAzElDegrees,
-  sa as validateManifest,
-  ea as validateManifestString
+  w as getEntitlements,
+  Y as getLayerSchema,
+  F as getTerrain,
+  P as isBrowser,
+  k as isColumnar,
+  z as isStoreToken,
+  H as loadRasterModule,
+  J as mountForTest,
+  V as normalizeData,
+  q as parseDurationMs,
+  K as parseTerrainAttrs,
+  U as parseWidgetStyle,
+  j as registerAction,
+  Q as registerBasemap,
+  X as registerFormat,
+  Z as registerLayer,
+  $ as registerSource,
+  aa as registerTerrain,
+  sa as registerWidget,
+  ea as resolveLighting,
+  ra as resolveSlot,
+  oa as rowAt,
+  ta as sandboxHtml,
+  ia as slotContainerStyle,
+  na as slotLayout,
+  ba as snapshotIR,
+  la as solarAzElDegrees,
+  Sa as validateManifest,
+  La as validateManifestString
 };

package/dist/programmatic.d.ts

@@ -18,8 +18,10 @@ import { type CameraOptions } from "./runtime-core";
 import { type LightingIR, type LightingOptions } from "./scene-lighting";
 import type { TerrainIR } from "./terrain";
 import { type SnapshotOptions } from "./snapshot";
+import { type TokenStore, type ViewOrigin, type ViewportSnapshot, type DataVersionSnapshot } from "./external-store";
 import type { LayerIR } from "./ir";
 import { type RuntimeContext } from "./ctx";
+import type { LayerMetaSnapshot } from "./ctx";
 import type { Selection } from "./selection";
 import type { ValidationEntry } from "./validation";
 import type { MapViewport } from "./basemap";
@@ -96,9 +98,12 @@ export interface MapControllerOptions {
     /**
      * Camera settled (trailing-debounced, the `om-view-changed` twin) — for
      * camera persistence. Per-frame viewport churn goes to `watch(["viewport"])`;
-     * this fires once with the destination.
+     * this fires once with the destination. `origin` is "user" when ANY change
+     * in the settled burst came from a canvas gesture (a drag's inertia tail
+     * alone must not relabel the gesture), "programmatic" for pure API/story
+     * moves — the echo-suppression signal for store bridges.
      */
-    onViewChange?: (view: CameraState) => void;
+    onViewChange?: (view: CameraState, origin: ViewOrigin) => void;
     /** Scene lighting (spec: "Scene Lighting") — the lighting* attributes' programmatic twin; omit for deck's default lights. */
     lighting?: LightingOptions;
 }
@@ -131,7 +136,18 @@ export declare class MapController {
     private commitPending;
     private destroyed;
     private firstCommitDone;
-    private viewChangeTimer;
+    private readonly stores;
+    /** Origin of the most recent viewport change FRAME — latched through the settle tracker for snapshot reads. */
+    private lastViewOrigin;
+    /**
+     * Shared settle/burst tracker (the `om-view-changed` twin) — ALWAYS armed,
+     * onViewChange or not: the burst latch also feeds the viewport snapshot's
+     * `origin`, so it must reset on settle even for store-only consumers.
+     */
+    private readonly viewSettle;
+    private onViewChange?;
+    /** Per-layer data version counters (`data:<id>` snapshots) — bumped on every data change, monotonic for the controller's lifetime. */
+    private readonly dataVersions;
     private readyFired;
     private resolveReady;
     readonly ready: Promise<void>;
@@ -153,6 +169,29 @@ export declare class MapController {
      */
     watch(tokens: readonly string[], notify: (ctx: RuntimeContext) => void): () => void;
     private notifyWatchers;
+    /**
+     * Per-token `{subscribe, getSnapshot}` store — the framework-free surface
+     * for `useSyncExternalStore`, MobX autoruns, Redux listeners, Zustand
+     * mirrors (recipes: docs/external-stores.md). Snapshots are cached
+     * immutable PLAIN DATA: `getSnapshot()` returns the SAME reference until
+     * this token's next change event, and never contains closures — rich
+     * reads (`project`, `data()`, `stats()`) stay on `ctx`. Tokens:
+     *   - "viewport"      → ViewportSnapshot (camera + bounds + origin)
+     *   - "selection"     → Selection | null
+     *   - "layers"        → LayerMetaSnapshot[] (what ctx.layers builds)
+     *   - "data:<layerId>" → {version, rows} — a VERSION STAMP, not the rows
+     *     (mirroring row arrays into a store per tick is the anti-pattern the
+     *     Redux performance guidance warns about; fetch rows via ctx.data()).
+     * `history` is deliberately NOT a store here — the app owns state on the
+     * programmatic front-end. Calling twice for one token returns the
+     * identical store object.
+     */
+    getStore(token: "viewport"): TokenStore<ViewportSnapshot>;
+    getStore(token: "selection"): TokenStore<Selection | null>;
+    getStore(token: "layers"): TokenStore<LayerMetaSnapshot[]>;
+    getStore(token: `data:${string}`): TokenStore<DataVersionSnapshot>;
+    getStore(token: string): TokenStore<unknown>;
+    private buildViewportSnapshot;
     /** The RuntimeContext contract (HU5) — identical to what HTML widget scripts receive as `ctx`. */
     buildCtx(): RuntimeContext;
     /** Picked object, normalized to flat — same path as OmMapElement (GeoJSON properties lifted; columnar rows materialized). */
@@ -216,6 +255,4 @@ export declare class MapController {
     /** Projects a lng/lat through the current viewport — undefined before the viewport resolves. */
     project(lngLat: [number, number]): [number, number] | undefined;
     destroy(): void;
-    /** Trailing-debounced onViewChange — see MapControllerOptions.onViewChange. */
-    private scheduleViewChange;
 }

package/dist/{raster-Da1auFQH.js → raster-xUPg8Z-C.js}

@@ -1,5 +1,5 @@
 import { w as kt, t as Ni, f as Oi, m as Ri } from "./mgrs-BY9bIvp4.js";
-import { an as Fi, ao as zi, ap as Ks, aq as Ws, ar as Di, b as Bi, as as Ui, l as es, at as ki, d as qi, au as Ki, av as Wi, aw as Xi, ax as Xs } from "./index-i_KAvtQZ.js";
+import { an as Fi, ao as zi, ap as Ks, aq as Ws, ar as Di, b as Bi, as as Ui, l as es, at as ki, d as qi, au as Ki, av as Wi, aw as Xi, ax as Xs } from "./index-BKiyX-jQ.js";
 function Hi(t, e, s) {
   const { projectedCorners: i } = e, { topLeft: a, topRight: r, bottomRight: o, bottomLeft: n } = i, h = s(a[0], a[1]), l = s(r[0], r[1]), c = s(o[0], o[1]), u = s(n[0], n[1]), d = [
     h,
@@ -2377,7 +2377,7 @@ it.set(G.Zstd, () => import("./zstd-jXobGRcq.js").then((t) => t.decode));
 it.set(G.Jpeg, () => Promise.resolve(ke));
 it.set(G.Jpeg6, () => Promise.resolve(ke));
 it.set(G.Webp, () => Promise.resolve(ke));
-it.set(G.Lerc, () => import("./lerc-DWGhMWvo.js").then((t) => t.l).then((t) => t.decode));
+it.set(G.Lerc, () => import("./lerc-filCwJiM.js").then((t) => t.l).then((t) => t.decode));
 async function qe(t, e, s) {
   const i = it.get(e);
   if (!i)

package/dist/react/context.d.ts

@@ -1,12 +1,14 @@
 import type { MapController, LayerDescriptor } from "@nika-js/onlymap";
-export type WidgetPosition = "top-left" | "top-right" | "bottom-left" | "bottom-right";
+import type { ManagedSlot } from "@nika-js/onlymap";
+/** A managed slot (spec: "Widget Layout Manager"), a legacy corner alias, or the author-styled `manual` tier. */
+export type WidgetPosition = ManagedSlot | "manual" | "top-left" | "top-right" | "bottom-left" | "bottom-right";
 export interface OmMapContextValue {
     controller: MapController;
     layers: LayerRegistry;
     /** The pane <OmOverlay> portals into — absolutely positioned above the canvas, pointer-events: none. */
     overlayPane: HTMLDivElement;
-    /** Corner containers <OmWidget> portals into (filled as OmMap's own DOM mounts). */
-    corners: Readonly<Record<WidgetPosition, HTMLDivElement | null>>;
+    /** Slot containers <OmWidget> portals into (filled as OmMap's own DOM mounts). */
+    corners: Readonly<Record<ManagedSlot, HTMLDivElement | null>>;
 }
 export declare const OmMapContext: import("react").Context<OmMapContextValue | null>;
 export declare function useOmMapContext(caller: string): OmMapContextValue;

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

@@ -18,6 +18,8 @@ export interface OmMapProps {
         width?: number;
         height?: number;
     };
+    /** Layout-token sugar, the `widget-style` attribute's twin: `"gap:10 opacity:0.9"` → `--om-widget-*` custom properties on the widget layer. */
+    widgetStyle?: string;
     className?: string;
     style?: CSSProperties;
     children?: ReactNode;

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

@@ -1,9 +1,12 @@
 import type { CSSProperties, ReactNode } from "react";
 import { type WidgetPosition } from "./context";
 export interface OmWidgetProps {
+    /** A managed slot (`top-start` … `bottom-end`), a legacy corner alias, or `manual`. Default `top-start`. */
     position?: WidgetPosition;
+    /** Deterministic in-slot ordering (flex `order`); default is mount order. */
+    order?: number;
     className?: string;
     style?: CSSProperties;
     children?: ReactNode;
 }
-export declare function OmWidget({ position, className, style, children }: OmWidgetProps): ReactNode;
+export declare function OmWidget({ position, order, className, style, children }: OmWidgetProps): ReactNode;