@nika-js/onlymap 0.7.2 → 0.7.3

package/dist/onlymapjs.js

@@ -1,4 +1,4 @@
-import { aC as e, aD as r, aE as t, aF as o, aG as b, aH as i, ap as l, aI as n, aJ as S, aK as c, aL as g, aM as E, aN as L, aO as T, aP as A, aQ as _, aR as d, aS as m, aT as p, aU as I, aV as M, aW as u, aX as D, aY as y, aZ as O, ao as R, a_ as f, aw as N, a$ as P, b0 as h, b1 as C, W as F, b2 as B, b3 as v, b4 as x, b5 as G, b6 as U, b7 as W, b8 as w, b9 as Y, ba as X, bb as H, bc as k, bd as J, be as K, bf as V, bg as z, bh as Q, bi as Z, bj as $, bk as j, bl as q, bm as aa, bn as sa, bo as ea, bp as ra, bq as ta, br as oa, bs as ba, bt as ia, bu as la, bv as na, bw as Sa, bx as ca, by as ga, bz as Ea, bA as La, bB as Ta, bC as Aa, bD as _a, bE as da, bF as ma, bG as pa, bH as Ia, bI as Ma, bJ as ua, bK as Da, bL as ya, bM as Oa, bN as Ra, bO as fa, bP as Na, bQ as Pa, bR as ha, bS as Ca, bT as Fa, bU as Ba, bV as va, bW as xa, bX as Ga, bY as Ua, bZ as Wa, b_ as wa, b$ as Ya, c0 as Xa, c1 as Ha, c2 as ka, c3 as Ja, c4 as Ka, c5 as Va, c6 as za, c7 as Qa, c8 as Za, c9 as $a, ca as ja } from "./index-C40QUjew.js";
+import { aC as e, aD as r, aE as t, aF as o, aG as b, aH as i, ap as l, aI as n, aJ as S, aK as c, aL as g, aM as E, aN as L, aO as T, aP as A, aQ as _, aR as d, aS as m, aT as p, aU as I, aV as M, aW as u, aX as D, aY as y, aZ as O, ao as R, a_ as f, aw as N, a$ as P, b0 as h, b1 as C, W as F, b2 as B, b3 as v, b4 as x, b5 as G, b6 as U, b7 as W, b8 as w, b9 as Y, ba as X, bb as H, bc as k, bd as J, be as K, bf as V, bg as z, bh as Q, bi as Z, bj as $, bk as j, bl as q, bm as aa, bn as sa, bo as ea, bp as ra, bq as ta, br as oa, bs as ba, bt as ia, bu as la, bv as na, bw as Sa, bx as ca, by as ga, bz as Ea, bA as La, bB as Ta, bC as Aa, bD as _a, bE as da, bF as ma, bG as pa, bH as Ia, bI as Ma, bJ as ua, bK as Da, bL as ya, bM as Oa, bN as Ra, bO as fa, bP as Na, bQ as Pa, bR as ha, bS as Ca, bT as Fa, bU as Ba, bV as va, bW as xa, bX as Ga, bY as Ua, bZ as Wa, b_ as wa, b$ as Ya, c0 as Xa, c1 as Ha, c2 as ka, c3 as Ja, c4 as Ka, c5 as Va, c6 as za, c7 as Qa, c8 as Za, c9 as $a, ca as ja } from "./index-BRdaiH3a.js";
 export {
   e as ALL_POSITION_VALUES,
   r as AUDIT_EXEMPTIONS,

package/dist/{raster-DVcoh7tO.js → raster-lkF1eUo1.js}

@@ -1,5 +1,5 @@
-import { c as se, t as ze, i as wt, a as Be, s as St, C as Pt, b as bt, F as Ct, A as Lt, d as It, R as fe, e as Gt, p as vt, m as Et, f as Ft, g as At, r as _e, h as jt, j as Rt, k as Ut, l as Mt, n as Ot } from "./raster-pipeline-BUuur0I8.js";
-import { ax as Kt, ay as xt } from "./index-C40QUjew.js";
+import { c as se, t as ze, i as wt, a as Be, s as St, C as Pt, b as bt, F as Ct, A as Lt, d as It, R as fe, e as Gt, p as vt, m as Et, f as Ft, g as At, r as _e, h as jt, j as Rt, k as Ut, l as Mt, n as Ot } from "./raster-pipeline-B4N48UQX.js";
+import { ax as Kt, ay as xt } from "./index-BRdaiH3a.js";
 import ye from "./index-CW1n5LdO.js";
 function Dt(e, t) {
   const n = e.length / 3, r = new Uint8ClampedArray(n * 4), o = 0, i = n, a = n * 2;
@@ -1070,7 +1070,7 @@ j.set(f.Zstd, () => import("./zstd-jXobGRcq.js").then((e) => e.decode));
 j.set(f.Jpeg, () => Promise.resolve(le));
 j.set(f.Jpeg6, () => Promise.resolve(le));
 j.set(f.Webp, () => Promise.resolve(le));
-j.set(f.Lerc, () => import("./lerc-Dpc86Tzf.js").then((e) => e.l).then((e) => e.decode));
+j.set(f.Lerc, () => import("./lerc-BPTGJlrt.js").then((e) => e.l).then((e) => e.decode));
 async function ce(e, t, n) {
   const r = j.get(t);
   if (!r)

package/dist/{raster-pipeline-BUuur0I8.js → raster-pipeline-B4N48UQX.js}

@@ -1,5 +1,5 @@
 import { w as de } from "./mgrs-BY9bIvp4.js";
-import { am as he, an as fe, ao as se, ap as oe, aq as me, b as pe, ar as ge, l as Z, as as ve, d as be, at as xe, au as Pe, av as ye, aw as ie } from "./index-C40QUjew.js";
+import { am as he, an as fe, ao as se, ap as oe, aq as me, b as pe, ar as ge, l as Z, as as ve, d as be, at as xe, au as Pe, av as ye, aw as ie } from "./index-BRdaiH3a.js";
 function Te(r, e, t) {
   const { projectedCorners: n } = e, { topLeft: s, topRight: o, bottomRight: i, bottomLeft: a } = n, c = t(s[0], s[1]), u = t(o[0], o[1]), l = t(i[0], i[1]), h = t(a[0], a[1]), f = [
     c,

package/dist/version.d.ts

@@ -5,4 +5,4 @@
  * the build rootDir, and a `define` would need repeating across vite/vitest/
  * vite-node configs.
  */
-export declare const LIBRARY_VERSION = "0.7.2";
+export declare const LIBRARY_VERSION = "0.7.3";

package/dist/{zarr-BDGjP2SU.js → zarr-B-l3yHWb.js}

@@ -1,5 +1,5 @@
-import { A as ur, d as lr, R as zt, e as fr, m as dr, p as St, f as hr, j as pr, k as mr } from "./raster-pipeline-BUuur0I8.js";
-import { ap as gr } from "./index-C40QUjew.js";
+import { A as ur, d as lr, R as zt, e as fr, m as dr, p as St, f as hr, j as pr, k as mr } from "./raster-pipeline-B4N48UQX.js";
+import { ap as gr } from "./index-BRdaiH3a.js";
 import $t from "./index-CW1n5LdO.js";
 var Et;
 function h(e, t, n) {

package/llms.txt

@@ -20,7 +20,7 @@ Programmatic/native bridge rule: `MapController.setLayers()` accepts normal func
 - ScatterplotLayer points need an explicit size: `radius="6" radius-units="pixels"` (constant), `get-radius="..."` (data-driven), or `radius-min-pixels="..."` (floor). Deck's default is getRadius 1 METER — sub-pixel at city zooms, the layer renders nothing visible — and validation warns when no radius source is present.
 - A literal color inside a `get-*` accessor is a string IN the expression — quote it: `get-line-color="'#ffffff'"` or an RGBA array `get-line-color="[255,255,255,200]"`. Bare `get-line-color="#ffffff"` is an expression parse error (plain attributes like `color="#dc2626"` take bare hex, accessors do not).
 - Inline event handlers (`onclick="..."`) are rejected. Use `data-emit` attributes (`<span data-emit="hide-overlay" data-target="popup1">`) or `addEventListener` inside a `<script type="om/widget">` block where `ctx` is in scope.
-- `scale()` requires an explicit `domain=`: `get-fill-color="scale($depth, sequential, ['#ffffcc','#800026'], domain=[0,700])"`. A missing domain is a validation error.
+- `scale()` requires an explicit `domain=`: `get-fill-color="scale($depth, sequential, ['#ffffcc','#800026'], domain=[0,700])"`. A missing domain is a validation error. The KIND must match the range: `sequential`/`diverging` interpolate COLORS (range = 2+ color stops); `linear`/`sqrt`/`log`/`pow` interpolate NUMBERS (sizes, radii, widths, opacities — e.g. `get-point-radius="scale($mag, linear, [4, 18], domain=[4.5, 7.8])"`); `threshold` maps either. `pow` REQUIRES `exponent=` as the last argument (`scale($v, pow, [0,30], domain=[0,100], exponent=2)`) — without a real exponent it is just a straight line, and `linear` is the honest spelling for that. A mismatched pairing (e.g. `sequential` with `[4,18]`) is a compile/validation ERROR — it used to silently paint black/zero.
 - Readable date/time labels use the safe built-in `formatDate($time, 'datetime', 'UTC')`. Input may be epoch milliseconds (NEVER seconds; multiply seconds by 1000 first) or an ISO string. Styles: `date|datetime|time|iso`; default style `datetime`, default zone `UTC`; zone may be `local` or an IANA name such as `Asia/Singapore`. Do NOT use `new Date()`, `Intl`, or instance methods in restricted expressions.
 - `scale()`/`clamp()`/`lerp()`/`$field` expressions go ONLY in `get-*` accessors — NEVER in a scalar attribute (`radius-min-pixels`, `point-radius-min-pixels`, `opacity`, `line-width-min-pixels`, `color`, …). A data-driven expression in a scalar doesn't coerce, so the layer silently renders defaults (invisible / black points); validation errors on it. Data-driven size/width/opacity/color → the matching `get-*` accessor (`get-radius`, `get-fill-color`, …); scalars take a constant floor/value.
 - `id` is required on every `<om-layer>`. `label` and `color` feed the legend; an explicit `get-fill-color` overrides `color` for rendering (both together is valid and common). The legend widget also reads `get-fill-color` itself: a `sequential`/`diverging` scale renders as a gradient ramp with domain labels, a `threshold` scale as discrete class ranges, and an equality ternary chain (`$f == 'a' ? '#c1' : '#c2'`) as a category palette — write those canonical shapes and the legend describes the symbology automatically.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@nika-js/onlymap",
-  "version": "0.7.2",
+  "version": "0.7.3",
   "description": "Declarative deck.gl maps for HTML and React — interactive WebGL mapping with GeoJSON/CSV/Arrow data, MapLibre basemaps, widgets, popups, and live streams from a custom-element manifest or typed React components. TypeScript, no build step.",
   "license": "SEE LICENSE IN LICENSE.md",
   "publishConfig": {

package/skills/onlymapjs/SKILL.md

@@ -23,7 +23,7 @@ Use OnlyMapJS as a declarative HTML map library. Write custom elements such as `
 </script>
 ```
 
-For no-build CDN pages, use the single-file standalone bundle from a raw-file CDN — `https://unpkg.com/@nika-js/onlymap@0.7.2` (the bare package URL serves `dist/onlymap.standalone.js`) — plus `<link rel="stylesheet" href="https://unpkg.com/@nika-js/onlymap@0.7.2/dist/onlymapjs.css">`. Never a rebundling CDN (esm.sh, skypack): re-bundling duplicates the deck.gl/luma.gl runtime and every layer fails shader compilation.
+For no-build CDN pages, use the single-file standalone bundle from a raw-file CDN — `https://unpkg.com/@nika-js/onlymap@0.7.3` (the bare package URL serves `dist/onlymap.standalone.js`) — plus `<link rel="stylesheet" href="https://unpkg.com/@nika-js/onlymap@0.7.3/dist/onlymapjs.css">`. Never a rebundling CDN (esm.sh, skypack): re-bundling duplicates the deck.gl/luma.gl runtime and every layer fails shader compilation.
 
 ## React Projects
 
@@ -55,7 +55,7 @@ Load the smallest reference needed for the task:
 - Every `<om-layer>` needs a stable `id`.
 - Attribute names are kebab-case: `get-fill-color`, `radius-units`, `line-width-min-pixels`.
 - Accessor values are expressions: `get-position="[$lon, $lat]"`.
-- `scale()` always needs an explicit `domain=`.
+- `scale()` always needs an explicit `domain=`. Match the kind to the range: `sequential`/`diverging` take COLOR stops, `linear`/`sqrt`/`log`/`pow` take NUMBERS (a mismatch is a compile error). `pow` also requires a trailing `exponent=` (e.g. `exponent=2`) — for a straight line use `linear`.
 - Format epoch-millisecond or ISO fields with the safe `formatDate()` built-in, e.g. `get-text="formatDate($time, 'datetime', 'UTC')"`. Do not use `new Date()`, `Intl`, or method calls in restricted expressions.
 - For a built-in filter over epoch milliseconds, add `format="date"` with optional `date-style="date|datetime|time|iso"` and `time-zone="UTC|local|<IANA zone>"`; do not hand-roll a time slider only to format its labels. For temporal PLAYBACK (play/pause/scrub over a time field, cumulative or a sliding `window`), use `<om-widget type="time-slider" layer="…" field="…" duration="20s" loop>` — never hand-roll the playback loop.
 - ScatterplotLayer points need an explicit size — `radius="6" radius-units="pixels"`, `get-radius="..."`, or `radius-min-pixels="..."`: deck's default is 1 METER, sub-pixel at city zooms, and validation warns on layers with no radius source.

package/skills/onlymapjs/references/syntax.md

@@ -16,8 +16,8 @@ Vite/npm project:
 Static CDN page (raw-file CDNs only — unpkg/jsDelivr; never esm.sh or another rebundling CDN, which duplicates the WebGL runtime and breaks layer shaders):
 
 ```html
-<link rel="stylesheet" href="https://unpkg.com/@nika-js/onlymap@0.7.2/dist/onlymapjs.css">
-<script type="module" src="https://unpkg.com/@nika-js/onlymap@0.7.2"></script>
+<link rel="stylesheet" href="https://unpkg.com/@nika-js/onlymap@0.7.3/dist/onlymapjs.css">
+<script type="module" src="https://unpkg.com/@nika-js/onlymap@0.7.3"></script>
 ```
 
 Always include `onlymapjs.css` — it carries the MapLibre basemap styles and the no-JS fallback rules (`<om-fallback>` / default banner). For the fallback to work in script-disabled previews it must load without JavaScript: a real `<link rel="stylesheet">` or inlined `<style>` on no-build pages (a bundler-emitted stylesheet is fine in npm projects).
@@ -88,6 +88,8 @@ get-text="formatDate($time, 'datetime', 'UTC')"
 
 `$field` works on flat rows, GeoJSON properties, columnar JSON, CSV/TSV columns, and Arrow point columns.
 
+`scale()` kinds: `sequential`/`diverging` interpolate COLOR stops; `linear`/`sqrt`/`log`/`pow` interpolate NUMBERS (sizes, radii, widths); `threshold` maps either. A kind/range mismatch (e.g. `sequential` with `[4,18]`) is a compile error. `pow` requires a trailing `exponent=` (`scale($v, pow, [0,30], domain=[0,100], exponent=2)`); for a straight line use `linear`.
+
 Date formatting is a safe built-in rather than an opt-in to arbitrary JavaScript:
 
 ```html