@nika-js/onlymap 0.2.0 → 0.2.1

package/dist/basemap-registry.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Basemap preset registry (spec: "Basemap presets & switching") — the sixth
+ * plugin surface, alongside registerLayer/Widget/Action/Source/Format.
+ * Deliberately maplibre-free: validation, html-data generation, and om-map
+ * all consult it without pulling the ~326 KB gz maplibre chunk; only
+ * basemap.ts (already inside that chunk) consumes the resolved style.
+ *
+ * A MapTiler key is a PUBLISHABLE, origin-restricted client key — it ships
+ * in page source by design, so unlike data credentials (configureData) it
+ * may appear in markup (`basemap-key`) or be configured once
+ * (`OmMap.configureBasemap({ maptilerKey })`).
+ */
+/** A MapLibre style: a URL string (possibly with a `{key}` placeholder) or an inline style-spec object. */
+export type BasemapStyle = string | Record<string, unknown>;
+export interface BasemapPreset {
+    style: BasemapStyle;
+    /** Extra attribution line beyond what the style's tile sources declare (MapLibre renders source attributions automatically). */
+    attribution?: string;
+    /** Display name for the basemap-switcher widget (falls back to the preset name). */
+    label?: string;
+    /** Which key `{key}` substitutes — currently only "maptiler". */
+    requiresKey?: "maptiler";
+}
+/** MapLibre's own official, freely-hosted demo style — the zero-config `basemap="maplibre"` default (back-compat). */
+export declare const MAPLIBRE_DEMO_STYLE = "https://demotiles.maplibre.org/style.json";
+export declare function registerBasemap(name: string, preset: BasemapPreset): void;
+export declare function getBasemap(name: string): BasemapPreset | undefined;
+export declare function getAllBasemaps(): ReadonlyMap<string, BasemapPreset>;
+/** Provider keys for keyed presets — one call covers every layer of the app. */
+export declare function configureBasemap(config: {
+    maptilerKey?: string;
+}): void;
+/** Static-validation support: is a key available for this provider (from configureBasemap)? */
+export declare function hasConfiguredKey(provider: "maptiler"): boolean;
+export interface ResolvedBasemap {
+    style: BasemapStyle;
+    attribution?: string;
+    /** Resolution problem (unknown name / missing key) — the caller decides how loudly to fail; `style` is always usable (demo fallback). */
+    error?: string;
+}
+/**
+ * `basemap` attribute value → concrete style. Precedence: explicit URL /
+ * `.json` path passes through untouched (bring-your-own, keys inline);
+ * `maplibre` / `maplibre-*` → the demo style (back-compat); anything else
+ * is a registry lookup. Unknown names and keyless keyed presets resolve to
+ * the demo style WITH an `error` — the live path logs it, validation turns
+ * it into a structured entry, and the map still renders something.
+ */
+export declare function resolveBasemapStyle(raw: string, keyAttr?: string): ResolvedBasemap;

package/dist/basemap.d.ts

@@ -1,5 +1,6 @@
 import "maplibre-gl/dist/maplibre-gl.css";
 import type { DeckProps, Viewport } from "@deck.gl/core";
+import type { ResolvedBasemap } from "./basemap-registry";
 export interface ViewportLike {
     project(xyz: number[]): number[];
     getBounds(): [number, number, number, number];
@@ -18,6 +19,10 @@ export interface BasemapViewState {
 export declare class MapLibreBasemapAdapter {
     private map;
     private overlay;
+    /** Our own compact attribution control (spec: "attribution becomes correct, not optional") — undefined when the author opted out. */
+    private attribution?;
+    private attributionText?;
+    private showAttribution;
     /**
      * One-time "has the map initialized at least once" flag, set by the first
      * `load` event. Deliberately NOT `this.map.loaded()` — that method means
@@ -34,18 +39,33 @@ export declare class MapLibreBasemapAdapter {
      */
     private initialized;
     private loadCallbacks;
-    constructor(container: HTMLElement, basemapAttr: string, initialView: {
+    constructor(container: HTMLElement, resolved: ResolvedBasemap, initialView: {
         longitude: number;
         latitude: number;
         zoom: number;
         pitch?: number;
         bearing?: number;
-    }, deckProps: DeckProps);
+    }, deckProps: DeckProps, showAttribution?: boolean);
     private markInitialized;
     onLoad(cb: () => void): void;
     /** Fires continuously during pan/zoom/rotate — MapLibre's own camera-change event, standing in for deck's onViewStateChange (which doesn't apply — deck isn't driving the camera). */
     onMove(cb: () => void): void;
     setLayers(layers: DeckProps["layers"]): void;
+    /**
+     * Live basemap switch (spec: "Basemap presets & switching"). Deck layers
+     * survive BY CONSTRUCTION: the MapboxOverlay is a map control, not style
+     * layers, and controls persist across `setStyle` — as does the camera.
+     * MapLibre diffs same-source styles and falls back to a full style reload
+     * internally when the diff fails (the cross-provider case).
+     */
+    setStyle(resolved: ResolvedBasemap): void;
+    /**
+     * (Re)mounts the compact attribution control. Source-declared attributions
+     * (what OpenFreeMap/CARTO/OSM styles carry) are read live by the control on
+     * every style change; only the PRESET-level `attribution` override needs a
+     * remount, since `customAttribution` is fixed at construction.
+     */
+    private mountAttribution;
     /** Toggle map interactions (spec: "Manual Drawing", D4) — used to suspend double-click-zoom while a draw tool is active. */
     setInteractive(opts: {
         doubleClickZoom?: boolean;

package/dist/html-data.d.ts

@@ -15,9 +15,9 @@ interface TagData {
     }[];
 }
 /** Hand-authored action list — validated against hasAction() in html-data.test.ts. */
-export declare const BUILTIN_ACTIONS: readonly ["toggle-layer", "zoom-in", "zoom-out", "filter-layer", "highlight-feature", "fade", "pulse", "populate", "trace", "story-play", "story-pause", "story-seek", "fly-to", "zoom-to-feature", "show-overlay", "hide-overlay", "show-tooltip", "hide-tooltip", "draw-mode", "draw-commit", "draw-cancel", "draw-delete", "draw-clear", "draw-config", "draw-save"];
+export declare const BUILTIN_ACTIONS: readonly ["toggle-layer", "zoom-in", "zoom-out", "filter-layer", "highlight-feature", "fade", "pulse", "populate", "trace", "story-play", "story-pause", "story-seek", "fly-to", "zoom-to-feature", "show-overlay", "hide-overlay", "show-tooltip", "hide-tooltip", "draw-mode", "draw-commit", "draw-cancel", "draw-delete", "draw-clear", "draw-config", "draw-save", "set-basemap"];
 /** Hand-authored widget types — validated against the widget registry in html-data.test.ts. */
-export declare const BUILTIN_WIDGETS: readonly ["legend", "layer-switcher", "zoom-controls", "scale-bar", "attribution", "filter", "vega-lite", "player", "draw"];
+export declare const BUILTIN_WIDGETS: readonly ["legend", "layer-switcher", "zoom-controls", "scale-bar", "attribution", "filter", "vega-lite", "player", "draw", "basemap-switcher"];
 export declare function buildHtmlCustomData(): {
     version: number;
     tags: TagData[];

package/dist/{index-CZf9WlZe.js → index-COu-3-gN.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-DnvxPnDF.js";
+import { g as ve, a as ce, b as he, i as Fe, t as je, l as xe } from "./index-CvfuISOc.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-DeEur5Xk.js → index-CgyAD98B.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-DnvxPnDF.js";
+import { t as zt, $ as ca, a0 as ua, a1 as wi } from "./index-CvfuISOc.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 {