@nika-js/onlymap 0.2.1 → 0.2.2

package/.vscode/onlymap.code-snippets

@@ -36,6 +36,11 @@
       "    <!-- Built-in legend — reads label/color from each <om-layer> -->",
       "    <om-widget type=\"legend\" title=\"Layers\" position=\"top-right\"></om-widget>",
       "",
+      "    <!-- Shown only where scripts never run (chat-app/email file previews) — hidden once the map boots -->",
+      "    <om-fallback>",
+      "      <p>This interactive map requires JavaScript.<br />Open this file in a web browser such as Chrome, Safari, or Firefox.</p>",
+      "    </om-fallback>",
+      "",
       "  </om-map>",
       "",
       "</body>",
@@ -78,6 +83,11 @@
       "",
       "  $0",
       "",
+      "  <!-- Shown only where scripts never run (chat-app/email file previews) -->",
+      "  <om-fallback>",
+      "    <p>This interactive map requires JavaScript — open this file in a web browser.</p>",
+      "  </om-fallback>",
+      "",
       "</om-map>"
     ]
   },
@@ -157,6 +167,19 @@
     ]
   },
 
+  "!fallback": {
+    "scope": "html",
+    "prefix": "!fallback",
+    "description": "<om-fallback> — no-JS fallback for shared/previewed files (hidden once the map boots)",
+    "body": [
+      "<!-- Shown only where scripts never run (chat-app/email file previews, iOS QuickLook) -->",
+      "<om-fallback>",
+      "  <p>${1:This interactive map requires JavaScript.}<br />",
+      "     ${2:Open this file in a web browser such as Chrome, Safari, or Firefox.}</p>",
+      "</om-fallback>$0"
+    ]
+  },
+
   "!inline-data": {
     "scope": "html",
     "prefix": "!inline-data",

package/README.md

@@ -44,13 +44,13 @@ Or with no build step at all, straight from a CDN:
 <script type="module" src="https://esm.sh/@nika-js/onlymap"></script>
 ```
 
-Then `npx @nika-js/onlymap init` wires up VS Code IntelliSense and `!`-prefixed manifest snippets for your project. The library ships with 254 unit/behavioral tests and 12 Playwright GPU tests.
+Then `npx @nika-js/onlymap init` wires up VS Code IntelliSense and `!`-prefixed manifest snippets for your project. The library ships with 297 unit/behavioral tests and 19 Playwright GPU tests.
 
 The [examples](https://github.com/NikaGeospatial/onlymapjs/tree/main/examples) are the best tour: widgets, behaviors & overlays, basemaps, columnar/Arrow data, manual drawing, 3D models, a live WebSocket ship feed, and a polled driver fleet.
 
 ## The manifest
 
-Five elements, one rule: **attributes are kebab-case versions of deck.gl props** (`radius-units` → `radiusUnits`), and `get-*` attributes are data-driven accessors.
+A handful of elements, one rule: **attributes are kebab-case versions of deck.gl props** (`radius-units` → `radiusUnits`), and `get-*` attributes are data-driven accessors.
 
 | Element | Role |
 |---|---|
@@ -60,6 +60,7 @@ Five elements, one rule: **attributes are kebab-case versions of deck.gl props**
 | `<om-overlay>` | Rich HTML anchored to a map location — a static `anchor="[lng, lat]"`, the current selection, or a feature's own geometry via `anchor-layer`/`anchor-feature-id`. `{{field}}` interpolates the picked feature, HTML-escaped by default. |
 | `<om-behavior>` | Declarative interactions: `on="click|hover|drag|load|data-loaded"` → a named action. |
 | `<om-story>` | A storyboard: `<om-step>` children fire actions on a timeline. Controlled by the `player` widget, behaviors, or `storyEl.play()/pause()/seek()`. |
+| `<om-fallback>` | What shows where scripts never run — chat-app/email file previews (iOS QuickLook renders HTML attachments with JS off), file managers, sandboxed webviews. A direct child of `<om-map>`, hidden automatically the moment the map boots; pages without one get a text-only default banner from the stylesheet. Good practice on any page that may travel as a file. The gate is pure CSS (`om-map:not(:defined)`), so `onlymapjs.css` must load without JS — a real `<link>`, a bundler-emitted sheet, or an inlined `<style>`. |
 
 ### Accessors without JavaScript
 

package/dist/{basemap-COurZNDH.js → basemap-Bn4TmZtQ.js}

@@ -1,7 +1,7 @@
 var sy = Object.defineProperty;
 var oy = (ve, J, me) => J in ve ? sy(ve, J, { enumerable: !0, configurable: !0, writable: !0, value: me }) : ve[J] = me;
 var _s = (ve, J, me) => oy(ve, typeof J != "symbol" ? J + "" : J, me);
-import { a4 as ay, a5 as ly, a6 as cy, a7 as uy, a8 as Ra, a9 as ac, aa as Pd, ab as om, ac as hy, ad as dy, ae as py, af as fy, ag as ju, ah as Cd, ai as my, aj as gy, ak as _y, al as em, am as yy } from "./index-CvfuISOc.js";
+import { a4 as ay, a5 as ly, a6 as cy, a7 as uy, a8 as Ra, a9 as ac, aa as Pd, ab as om, ac as hy, ad as dy, ae as py, af as fy, ag as ju, ah as Cd, ai as my, aj as gy, ak as _y, al as em, am as yy } from "./index-oE1Kouy1.js";
 const Ad = Math.PI / 180, vy = 180 / Math.PI;
 function tm(ve, J = 0) {
   const me = Math.min(180, ve) * Ad;

package/dist/elements/om-fallback.d.ts

@@ -0,0 +1,22 @@
+/**
+ * <om-fallback> — static content shown only when the library never boots:
+ * scripting-disabled contexts like chat-app/email file previews (iOS
+ * QuickLook renders HTML attachments with JS off), file managers, and
+ * sandboxed webviews (spec: "Deployment & Distribution / No-JS fallback").
+ *
+ * Deliberately logic-free: the show/hide gate lives in the shipped
+ * stylesheet (src/fallback.css) as `om-map:not(:defined)` rules, because
+ * only the CSS engine — not script — still runs where this element earns
+ * its keep. The class exists for two reasons: registering it keeps the
+ * element out of "unknown tag" territory for tooling, and its
+ * connectedCallback hides the element inline as a belt-and-braces for
+ * pages that loaded the JS bundle but not onlymapjs.css (if this code
+ * runs at all, the map is booting and the fallback must not show).
+ *
+ * Pages without an <om-fallback> still get a text-only default banner,
+ * generated by the stylesheet on `om-map:not(:defined)::before`.
+ */
+import { HTMLElementBase } from "../env";
+export declare class OmFallbackElement extends HTMLElementBase {
+    connectedCallback(): void;
+}

package/dist/{index-COu-3-gN.js → index-3UyMg0Md.js}

@@ -1,7 +1,7 @@
 var Oe = Object.defineProperty;
 var ke = (r, e, t) => e in r ? Oe(r, e, { enumerable: !0, configurable: !0, writable: !0, value: t }) : r[e] = t;
 var l = (r, e, t) => ke(r, typeof e != "symbol" ? e + "" : e, t);
-import { g as ve, a as ce, b as he, i as Fe, t as je, l as xe } from "./index-CvfuISOc.js";
+import { g as ve, a as ce, b as he, i as Fe, t as je, l as xe } from "./index-oE1Kouy1.js";
 import { ai as Ie, h as ue, au as X, a2 as W, af as fe, Y as Ne, F as Le, aR as Ue, S as Me, bP as qe } from "./recordbatch-HRu0SMKp.js";
 import { g as $, a as de, b as Ve, c as $e, d as Pe, e as He, m as ze } from "./table-accessors-DBjWgN0C.js";
 import { c as Qe } from "./convert-arrow-schema-CvZ3cT5m.js";

package/dist/{index-DuvXK95V.js → index-BZs_x9Dx.js}

@@ -1,8 +1,8 @@
 var R = Object.defineProperty;
 var N = (t, e, r) => e in t ? R(t, e, { enumerable: !0, configurable: !0, writable: !0, value: r }) : t[e] = r;
 var u = (t, e, r) => N(t, typeof e != "symbol" ? e + "" : e, r);
-import { c as W, W as x, d as O, e as _, f as m, h as g, j as P, s as z, n as I, k as B, m as k, o as $, p as C, q as F, r as M, u as U, v as D, w as L, x as j, y as v, z as T, A as J } from "./index-CvfuISOc.js";
-import { F as Ue, R as De, _ as je, B as ve, C as Je, D as qe, E as Ve, G as Ge, H as He, I as Ke, J as Qe, K as Xe, L as Ye, M as Ze, N as er, O as rr, P as tr, Q as nr, S as ar, T as sr, U as cr, V as or, X as ir, Y as ur, Z as fr } from "./index-CvfuISOc.js";
+import { c as W, W as x, d as O, e as _, f as m, h as g, j as P, s as z, n as I, k as B, m as k, o as $, p as C, q as F, r as M, u as U, v as D, w as L, x as j, y as v, z as T, A as J } from "./index-oE1Kouy1.js";
+import { F as Ue, R as De, _ as je, B as ve, C as Je, D as qe, E as Ve, G as Ge, H as He, I as Ke, J as Qe, K as Xe, L as Ye, M as Ze, N as er, O as rr, P as tr, Q as nr, S as ar, T as sr, U as cr, V as or, X as ir, Y as ur, Z as fr } from "./index-oE1Kouy1.js";
 import { g as q, i as V } from "./table-accessors-DBjWgN0C.js";
 async function G(t, e, r = {}, n = {}) {
   const a = W(t), s = x.getWorkerFarm(r), { source: c } = r, o = { name: a, source: c };

package/dist/{index-D-X8KPA1.js → index-D2zVsZ79.js}

@@ -1,4 +1,4 @@
-import { a2 as _t, a3 as Ct } from "./index-CvfuISOc.js";
+import { a2 as _t, a3 as Ct } from "./index-oE1Kouy1.js";
 function Yt(e, r, t = 2, i, o = "xy") {
   const s = r && r.length, l = s ? r[0] * t : e.length;
   let c = Ut(e, 0, l, t, !0, i && i[0], o);

package/dist/{index-CgyAD98B.js → index-DSjndBOf.js}

@@ -1,7 +1,7 @@
 var Ri = Object.defineProperty;
 var Ii = (t, a, i) => a in t ? Ri(t, a, { enumerable: !0, configurable: !0, writable: !0, value: i }) : t[a] = i;
 var N = (t, a, i) => Ii(t, typeof a != "symbol" ? a + "" : a, i);
-import { t as zt, $ as ca, a0 as ua, a1 as wi } from "./index-CvfuISOc.js";
+import { t as zt, $ as ca, a0 as ua, a1 as wi } from "./index-oE1Kouy1.js";
 import { c as Si } from "./convert-arrow-schema-CvZ3cT5m.js";
 import { ai as Ni, af as Nt, h as Ci, au as Pi, a2 as Oi } from "./recordbatch-HRu0SMKp.js";
 class Ti {