@nika-js/onlymap 0.2.3 → 0.3.1

package/dist/{recordbatch-HRu0SMKp.js → recordbatch-Bpc0uxFn.js}

@@ -180,7 +180,7 @@ function q(e, t) {
         yield L(yield* ye(Wt(ve((function* (a) {
           let c = null;
           do
-            c = a.next(yield c == null ? void 0 : c.value);
+            c = a.next(yield c?.value);
           while (!c.done);
         })(o[Symbol.iterator]())))));
       });
@@ -454,87 +454,87 @@ var Mn, Nn, Un, Cn, Fn, Ln, En, Vn, xn, kn, jn, zn, $n, Pn, Rn, Yn, Wn, Hn, Kn,
 class A {
   /** @nocollapse */
   static isNull(t) {
-    return (t == null ? void 0 : t.typeId) === l.Null;
+    return t?.typeId === l.Null;
   }
   /** @nocollapse */
   static isInt(t) {
-    return (t == null ? void 0 : t.typeId) === l.Int;
+    return t?.typeId === l.Int;
   }
   /** @nocollapse */
   static isFloat(t) {
-    return (t == null ? void 0 : t.typeId) === l.Float;
+    return t?.typeId === l.Float;
   }
   /** @nocollapse */
   static isBinary(t) {
-    return (t == null ? void 0 : t.typeId) === l.Binary;
+    return t?.typeId === l.Binary;
   }
   /** @nocollapse */
   static isLargeBinary(t) {
-    return (t == null ? void 0 : t.typeId) === l.LargeBinary;
+    return t?.typeId === l.LargeBinary;
   }
   /** @nocollapse */
   static isUtf8(t) {
-    return (t == null ? void 0 : t.typeId) === l.Utf8;
+    return t?.typeId === l.Utf8;
   }
   /** @nocollapse */
   static isLargeUtf8(t) {
-    return (t == null ? void 0 : t.typeId) === l.LargeUtf8;
+    return t?.typeId === l.LargeUtf8;
   }
   /** @nocollapse */
   static isBool(t) {
-    return (t == null ? void 0 : t.typeId) === l.Bool;
+    return t?.typeId === l.Bool;
   }
   /** @nocollapse */
   static isDecimal(t) {
-    return (t == null ? void 0 : t.typeId) === l.Decimal;
+    return t?.typeId === l.Decimal;
   }
   /** @nocollapse */
   static isDate(t) {
-    return (t == null ? void 0 : t.typeId) === l.Date;
+    return t?.typeId === l.Date;
   }
   /** @nocollapse */
   static isTime(t) {
-    return (t == null ? void 0 : t.typeId) === l.Time;
+    return t?.typeId === l.Time;
   }
   /** @nocollapse */
   static isTimestamp(t) {
-    return (t == null ? void 0 : t.typeId) === l.Timestamp;
+    return t?.typeId === l.Timestamp;
   }
   /** @nocollapse */
   static isInterval(t) {
-    return (t == null ? void 0 : t.typeId) === l.Interval;
+    return t?.typeId === l.Interval;
   }
   /** @nocollapse */
   static isDuration(t) {
-    return (t == null ? void 0 : t.typeId) === l.Duration;
+    return t?.typeId === l.Duration;
   }
   /** @nocollapse */
   static isList(t) {
-    return (t == null ? void 0 : t.typeId) === l.List;
+    return t?.typeId === l.List;
   }
   /** @nocollapse */
   static isStruct(t) {
-    return (t == null ? void 0 : t.typeId) === l.Struct;
+    return t?.typeId === l.Struct;
   }
   /** @nocollapse */
   static isUnion(t) {
-    return (t == null ? void 0 : t.typeId) === l.Union;
+    return t?.typeId === l.Union;
   }
   /** @nocollapse */
   static isFixedSizeBinary(t) {
-    return (t == null ? void 0 : t.typeId) === l.FixedSizeBinary;
+    return t?.typeId === l.FixedSizeBinary;
   }
   /** @nocollapse */
   static isFixedSizeList(t) {
-    return (t == null ? void 0 : t.typeId) === l.FixedSizeList;
+    return t?.typeId === l.FixedSizeList;
   }
   /** @nocollapse */
   static isMap(t) {
-    return (t == null ? void 0 : t.typeId) === l.Map;
+    return t?.typeId === l.Map;
   }
   /** @nocollapse */
   static isDictionary(t) {
-    return (t == null ? void 0 : t.typeId) === l.Dictionary;
+    return t?.typeId === l.Dictionary;
   }
   /** @nocollapse */
   static isDenseUnion(t) {
@@ -982,10 +982,10 @@ we[Gn] = ((e) => (e.children = null, e.listSize = null, e[Symbol.toStringTag] =
 class Ae extends A {
   constructor(t, n = !1) {
     var i, r, s;
-    if (super(l.Map), this.children = [t], this.keysSorted = n, t && (t.name = "entries", !((i = t == null ? void 0 : t.type) === null || i === void 0) && i.children)) {
-      const o = (r = t == null ? void 0 : t.type) === null || r === void 0 ? void 0 : r.children[0];
+    if (super(l.Map), this.children = [t], this.keysSorted = n, t && (t.name = "entries", !((i = t?.type) === null || i === void 0) && i.children)) {
+      const o = (r = t?.type) === null || r === void 0 ? void 0 : r.children[0];
       o && (o.name = "key");
-      const a = (s = t == null ? void 0 : t.type) === null || s === void 0 ? void 0 : s.children[1];
+      const a = (s = t?.type) === null || s === void 0 ? void 0 : s.children[1];
       a && (a.name = "value");
     }
   }
@@ -1119,7 +1119,7 @@ class _ {
   }
 }
 function bs(e, t, n = !0) {
-  return typeof t == "number" ? ft(e, t, n) : typeof t == "string" && t in l ? ft(e, l[t], n) : t && t instanceof A ? ft(e, gn(t), n) : t != null && t.type && t.type instanceof A ? ft(e, gn(t.type), n) : ft(e, l.NONE, n);
+  return typeof t == "number" ? ft(e, t, n) : typeof t == "string" && t in l ? ft(e, l[t], n) : t && t instanceof A ? ft(e, gn(t), n) : t?.type && t.type instanceof A ? ft(e, gn(t.type), n) : ft(e, l.NONE, n);
 }
 function ft(e, t, n = !0) {
   let i = null;
@@ -3139,7 +3139,7 @@ class P {
   flush() {
     let t, n, i, r;
     const { type: s, length: o, nullCount: a, _typeIds: c, _offsets: u, _values: d, _nulls: h } = this;
-    (n = c == null ? void 0 : c.flush(o)) ? r = u == null ? void 0 : u.flush(o) : (r = u == null ? void 0 : u.flush(o)) ? t = d == null ? void 0 : d.flush(u.last()) : t = d == null ? void 0 : d.flush(o), a > 0 && (i = h == null ? void 0 : h.flush(o));
+    (n = c?.flush(o)) ? r = u?.flush(o) : (r = u?.flush(o)) ? t = d?.flush(u.last()) : t = d?.flush(o), a > 0 && (i = h?.flush(o));
     const U = this.children.map((B) => B.flush());
     return this.clear(), M({
       type: s,
@@ -3621,7 +3621,7 @@ class on extends P {
   setValue(t, n, i) {
     this._typeIds.set(t, i);
     const r = this.type.typeIdToChildIndex[i], s = this.children[r];
-    s == null || s.set(t, n), this.length = Math.max(t + 1, this.length);
+    s?.set(t, n), this.length = Math.max(t + 1, this.length);
   }
   addChild(t, n = `${this.children.length}`) {
     const i = this.children.push(t), { type: { children: r, mode: s, typeIds: o } } = this, a = [...r, new k(n, t.type)];
@@ -3642,7 +3642,7 @@ class jo extends on {
   /** @ignore */
   setValue(t, n, i) {
     const r = this._typeIds.set(t, i).buffer[t], s = this.getChildAt(this.type.typeIdToChildIndex[r]), o = this._offsets.set(t, s.length).buffer[t];
-    s == null || s.set(o, n), this.length = Math.max(t + 1, this.length);
+    s?.set(o, n), this.length = Math.max(t + 1, this.length);
   }
 }
 class wr extends _t {
@@ -4088,12 +4088,12 @@ function Xo(e, t, n, i, r) {
   var s;
   const o = (t + 63 & -64) >> 3;
   for (let a = -1, c = i.length; ++a < c; ) {
-    const u = n[a], d = u == null ? void 0 : u.length;
+    const u = n[a], d = u?.length;
     if (d >= t)
       d === t ? n[a] = u : (n[a] = u.slice(0, t), r.numBatches = Math.max(r.numBatches, i[a].unshift(u.slice(t, d - t))));
     else {
       const h = e[a];
-      e[a] = h.clone({ nullable: !0 }), n[a] = (s = u == null ? void 0 : u._changeLengthAndBackfillNullBitmap(t)) !== null && s !== void 0 ? s : M({
+      e[a] = h.clone({ nullable: !0 }), n[a] = (s = u?._changeLengthAndBackfillNullBitmap(t)) !== null && s !== void 0 ? s : M({
         type: h.type,
         length: t,
         nullCount: t,
@@ -4530,7 +4530,7 @@ function wn(e, t, n = t.reduce((i, r) => Math.max(i, r.length), 0)) {
   const r = [...e.fields], s = [...t], o = (n + 63 & -64) >> 3;
   for (const [a, c] of e.fields.entries()) {
     const u = t[a];
-    (!u || u.length !== n) && (r[a] = c.clone({ nullable: !0 }), s[a] = (i = u == null ? void 0 : u._changeLengthAndBackfillNullBitmap(n)) !== null && i !== void 0 ? i : M({
+    (!u || u.length !== n) && (r[a] = c.clone({ nullable: !0 }), s[a] = (i = u?._changeLengthAndBackfillNullBitmap(n)) !== null && i !== void 0 ? i : M({
       type: c.type,
       length: n,
       nullCount: n,
@@ -4544,15 +4544,15 @@ function wn(e, t, n = t.reduce((i, r) => Math.max(i, r.length), 0)) {
 }
 function Tr(e, t, n = /* @__PURE__ */ new Map()) {
   var i, r;
-  if (((i = e == null ? void 0 : e.length) !== null && i !== void 0 ? i : 0) > 0 && (e == null ? void 0 : e.length) === (t == null ? void 0 : t.length))
+  if (((i = e?.length) !== null && i !== void 0 ? i : 0) > 0 && e?.length === t?.length)
     for (let s = -1, o = e.length; ++s < o; ) {
       const { type: a } = e[s], c = t[s];
-      for (const u of [c, ...((r = c == null ? void 0 : c.dictionary) === null || r === void 0 ? void 0 : r.data) || []])
-        Tr(a.children, u == null ? void 0 : u.children, n);
+      for (const u of [c, ...((r = c?.dictionary) === null || r === void 0 ? void 0 : r.data) || []])
+        Tr(a.children, u?.children, n);
       if (A.isDictionary(a)) {
         const { id: u } = a;
         if (!n.has(u))
-          c != null && c.dictionary && n.set(u, c.dictionary);
+          c?.dictionary && n.set(u, c.dictionary);
         else if (n.get(u) !== c.dictionary)
           throw new Error("Cannot create Schema containing two different dictionaries with the same Id");
       }
@@ -4566,177 +4566,177 @@ class Va extends V {
   }
 }
 export {
-  ea as $,
-  A,
+  W as $,
+  R as A,
   Se as B,
-  Nr as C,
-  Z as D,
-  oa as E,
+  M as C,
+  pn as D,
+  sn as E,
   k as F,
-  Vr as G,
-  ia as H,
-  j as I,
-  Dn as J,
-  Fr as K,
+  L as G,
+  N as H,
+  Ia as I,
+  jr as J,
+  os as K,
   qt as L,
-  be as M,
+  Ae as M,
   Ft as N,
-  Lr as O,
-  x as P,
-  Wt as Q,
-  Pi as R,
+  Qr as O,
+  ta as P,
+  Z as Q,
+  V as R,
   C as S,
-  y as T,
-  K as U,
-  _ as V,
-  O as W,
-  ne as X,
-  M as Y,
-  na as Z,
+  va as T,
+  Ie as U,
+  y as V,
+  x as W,
+  j as X,
+  K as Y,
+  be as Z,
   Nt as _,
-  L as a,
-  Qn as a$,
-  Er as a0,
-  Va as a1,
-  V as a2,
-  D as a3,
-  ye as a4,
-  _e as a5,
-  hs as a6,
-  it as a7,
-  le as a8,
-  $i as a9,
-  sr as aA,
-  Ba as aB,
-  jo as aC,
-  So as aD,
-  Bt as aE,
-  Da as aF,
-  hr as aG,
-  Aa as aH,
-  dr as aI,
-  _a as aJ,
-  yr as aK,
-  wa as aL,
-  ur as aM,
-  or as aN,
-  wo as aO,
-  gs as aP,
-  Ao as aQ,
-  ii as aR,
-  Do as aS,
-  Ue as aT,
-  _o as aU,
-  ue as aV,
-  Xn as aW,
-  To as aX,
-  Oo as aY,
-  Ne as aZ,
-  Mo as a_,
-  tn as aa,
-  re as ab,
-  ra as ac,
-  sa as ad,
-  Go as ae,
-  R as af,
-  H as ag,
-  Zo as ah,
-  xt as ai,
-  ca as aj,
-  Na as ak,
-  Oa as al,
-  aa as am,
-  Ma as an,
-  la as ao,
-  Jo as ap,
-  Ua as aq,
-  P as ar,
-  er as as,
-  Io as at,
-  T as au,
-  ce as av,
-  ua as aw,
-  ir as ax,
-  da as ay,
-  rr as az,
-  os as b,
-  Bo as b0,
-  ot as b1,
-  zt as b2,
-  ba as b3,
-  ar as b4,
-  Sa as b5,
-  cr as b6,
-  Ia as b7,
-  lr as b8,
-  nr as b9,
-  pr as bA,
-  l as bB,
-  ti as bC,
-  Uo as bD,
-  ei as bE,
-  Co as bF,
-  ni as bG,
-  Fo as bH,
-  Zn as bI,
-  No as bJ,
-  on as bK,
-  wr as bL,
-  Fa as bM,
-  qo as bN,
-  La as bO,
-  sn as bP,
+  Y as a,
+  hr as a$,
+  _ as a0,
+  Qt as a1,
+  yn as a2,
+  hn as a3,
+  fn as a4,
+  Vt as a5,
+  Dt as a6,
+  Et as a7,
+  At as a8,
+  wt as a9,
+  tn as aA,
+  re as aB,
+  ra as aC,
+  sa as aD,
+  Go as aE,
+  H as aF,
+  Zo as aG,
+  ca as aH,
+  Na as aI,
+  Oa as aJ,
+  aa as aK,
+  Ma as aL,
+  la as aM,
+  Jo as aN,
+  Ua as aO,
+  P as aP,
+  er as aQ,
+  Io as aR,
+  ce as aS,
+  ir as aT,
+  rr as aU,
+  sr as aV,
+  Ba as aW,
+  jo as aX,
+  So as aY,
+  Bt as aZ,
+  Da as a_,
+  Jt as aa,
+  Lt as ab,
+  tt as ac,
+  A as ad,
+  Nr as ae,
+  oa as af,
+  Vr as ag,
+  ia as ah,
+  Dn as ai,
+  Fr as aj,
+  Lr as ak,
+  Wt as al,
+  Pi as am,
+  O as an,
+  ne as ao,
+  na as ap,
+  ea as aq,
+  Er as ar,
+  Va as as,
+  D as at,
+  ye as au,
+  _e as av,
+  hs as aw,
+  it as ax,
+  le as ay,
+  $i as az,
+  we as b,
+  Aa as b0,
+  dr as b1,
+  _a as b2,
+  yr as b3,
+  wa as b4,
+  ur as b5,
+  or as b6,
+  wo as b7,
+  Ao as b8,
+  Do as b9,
+  vr as bA,
+  Tt as bB,
+  gr as bC,
+  fr as bD,
+  mr as bE,
+  pr as bF,
+  l as bG,
+  Uo as bH,
+  Co as bI,
+  Fo as bJ,
+  No as bK,
+  on as bL,
+  wr as bM,
+  Fa as bN,
+  qo as bO,
+  La as bP,
   Ea as bQ,
   Ca as bR,
   Dr as bS,
-  Ar as ba,
-  Lo as bb,
-  Eo as bc,
-  se as bd,
-  Vo as be,
-  Ta as bf,
-  ko as bg,
-  xo as bh,
-  Xe as bi,
-  Ot as bj,
-  pa as bk,
-  Ir as bl,
-  ya as bm,
-  br as bn,
-  fa as bo,
-  Sr as bp,
-  ha as bq,
-  vr as br,
-  Tt as bs,
-  ma as bt,
-  gr as bu,
-  ms as bv,
-  fr as bw,
-  va as bx,
-  mr as by,
-  ga as bz,
-  Qr as c,
-  ta as d,
-  W as e,
-  Me as f,
-  Qt as g,
-  Y as h,
-  yn as i,
-  jr as j,
-  Ie as k,
-  hn as l,
-  dn as m,
-  Ae as n,
-  we as o,
-  fn as p,
-  Vt as q,
-  Dt as r,
-  Et as s,
-  N as t,
-  At as u,
-  wt as v,
-  Jt as w,
-  pn as x,
-  Lt as y,
-  tt as z
+  _o as ba,
+  ue as bb,
+  To as bc,
+  Oo as bd,
+  Mo as be,
+  Bo as bf,
+  ot as bg,
+  zt as bh,
+  ar as bi,
+  Sa as bj,
+  cr as bk,
+  lr as bl,
+  nr as bm,
+  Ar as bn,
+  Lo as bo,
+  Eo as bp,
+  se as bq,
+  Vo as br,
+  Ta as bs,
+  ko as bt,
+  xo as bu,
+  Xe as bv,
+  Ot as bw,
+  Ir as bx,
+  br as by,
+  Sr as bz,
+  ba as c,
+  ma as d,
+  ms as e,
+  ga as f,
+  fa as g,
+  pa as h,
+  ya as i,
+  ha as j,
+  da as k,
+  ua as l,
+  Ue as m,
+  ii as n,
+  gs as o,
+  ni as p,
+  ei as q,
+  ti as r,
+  Zn as s,
+  Ne as t,
+  Me as u,
+  Xn as v,
+  Qn as w,
+  dn as x,
+  xt as y,
+  T as z
 };

package/dist/runtime-core.d.ts

@@ -1,8 +1,10 @@
+import { type LightingIR } from "./scene-lighting";
+import { type TerrainIR } from "./terrain";
 import type { LayerIR } from "./ir";
 import { type Selection } from "./selection";
 import type { ValidationEntry } from "./validation";
 import type { MapViewport } from "./basemap";
-/** `basemap="mapbox-*"` isn't implemented — kept maplibre-free so validation/runtime can check without loading the chunk. */
+/** Mapbox presets/protocol URLs aren't implemented — kept maplibre-free so validation/runtime can check without loading the chunk. */
 export declare function isMapboxBasemap(raw: string): boolean;
 export interface InitialView {
     longitude: number;
@@ -92,6 +94,42 @@ export declare class RuntimeCore {
     private rendererGeneration;
     /** Pre-gate descriptors — what a license settle re-reconciles from (lastIRs holds the GATED set the renderer sees). */
     private pregateIRs;
+    /**
+     * Scene lighting (spec: "Scene Lighting") — the retained IR, rebuilt into
+     * a LightingEffect on apply. Survives renderer remounts (initRenderer
+     * reads it, the lastIRs contract) and the lazy basemap-chunk window (the
+     * adapter constructor reads it on arrival). null = deck default lights.
+     */
+    private lighting;
+    /**
+     * Terrain (spec: "Terrain") — the retained surface IR. Non-null appends
+     * the internal terrain layer and patches drape/offset layers in
+     * buildLayers. `terrainGeneration` bumps on every terrain state change:
+     * extension sets must be BIRTH-stable, so patched layers get
+     * `#t<generation>`-based deck ids (fresh instances per flip — see
+     * applyTerrain); an explicit renderer-id map restores authored pick ids.
+     */
+    private terrain;
+    private terrainGeneration;
+    /** Rendered deck layer id → authored manifest/controller id (terrain uses fresh renderer ids). */
+    private renderedLayerIds;
+    /**
+     * The basemap attribute suppressed while terrain is active — a flat
+     * MapLibre canvas at sea level visibly desyncs from a raised surface
+     * (true coexistence is the interleaved-compositing TODO), so terrain
+     * forces standalone rendering and restores the basemap when it turns off.
+     */
+    private suppressedBasemapAttr?;
+    /**
+     * Snapshot capture queue (spec: "Snapshot API") — the WebGL context has
+     * no preserveDrawingBuffer, so pixels are only readable synchronously
+     * inside a post-render callback. snapshot() enqueues a capture and forces
+     * a redraw; the permanent onAfterRender (standalone Deck constructor)
+     * drains the queue while the drawing buffer is valid. `cancel` settles the
+     * promise when the renderer goes away before that frame renders (teardown/
+     * destroy) — a queued capture must never leave its caller hanging.
+     */
+    private snapshotCaptures;
     /** (layer, reason) pairs already reported — gate errors fire once per violation, not per reconcile. */
     private readonly gateWarned;
     private badge?;
@@ -105,6 +143,40 @@ export declare class RuntimeCore {
      * (none ↔ maplibre). Reads/seeds the camera from `this.viewState`.
      */
     private initRenderer;
+    /** The current lighting as a deck `effects` array — [] restores deck's default lights. */
+    private buildEffects;
+    /**
+     * Scene lighting (spec: "Scene Lighting") — swap the LightingEffect on
+     * the live renderer. null restores deck's default lights. Headless stores
+     * the IR (inspectable via the map's internal getter) with no renderer to
+     * drive; a change during the lazy basemap-chunk window is picked up by
+     * the adapter constructor (which reads `this.lighting` on arrival). A
+     * sunDate-driven sun resolves az/el HERE, against the current map center
+     * — deterministic per apply, not tracked per frame.
+     */
+    setLighting(ir: LightingIR | null): void;
+    getLightingInternal(): LightingIR | null;
+    /**
+     * Terrain on/off/source change (spec: "Terrain"). Bumps the generation
+     * (fresh deck ids for extension-carrying layers — birth-stable extension
+     * sets), swaps the renderer mode when needed (terrain suppresses an
+     * active basemap; turning it off restores the suppressed one), and
+     * re-applies layers. Headless stores the IR for inspection.
+     */
+    setTerrain(ir: TerrainIR | null): void;
+    getTerrainInternal(): TerrainIR | null;
+    private drainSnapshotCaptures;
+    /** Settle queued snapshot promises when the renderer they were waiting on goes away (mode flip / destroy) — never leave a caller hanging. */
+    private cancelSnapshotCaptures;
+    /**
+     * Canvas-only scene snapshot (spec: "Snapshot API") — the composite of
+     * basemap + deck canvases at device pixels, captured right after a forced
+     * repaint (no preserveDrawingBuffer in either context). DOM widgets,
+     * overlays, the badge, and the attribution control are NOT captured —
+     * consumers rendering exports must add provider credits themselves.
+     * Headless rejects (no renderer); pre-ready rejects (await map.ready).
+     */
+    snapshot(): Promise<HTMLCanvasElement>;
     /**
      * Live basemap change (spec: "Basemap presets & switching"), both paths:
      * - maplibre → maplibre: `map.setStyle()` — deck layers survive (the