@nika-js/onlymap 0.8.0 → 0.8.1

package/CHANGELOG.md

@@ -8,6 +8,15 @@ Note: npm collapsed a few closely-spaced releases — the GPX/FlatGeobuf (0.5.4)
 and GeoParquet (0.5.5) work shipped to npm together as **0.5.6**, so npm's
 version list jumps 0.5.3 → 0.5.6. Each logical version is listed here regardless.
 
+## 0.8.1 — 2026-09-18
+
+### Fixed
+- **A frame that used to show a captured image no longer shows it behind a live map.** Switching a cartograph frame back to live left its old capture drawing underneath, so the map appeared to have a ghost of itself behind it at low tilt. The capture is kept — switching back to static restores it — but it stays out of sight while the frame is live.
+- **A frame can no longer be tilted past the point where it stops working.** Tilt far enough and a frame's top edge reaches the horizon, which leaves it with no georeference — and without that, no scale bar, no north arrow, no graticule and no export. The tilt now stops at whatever that frame can still handle, which depends on its shape and zoom: a wide frame tilts further than a tall one, and zooming in lets both tilt further.
+
+### Added
+- **`max-pitch` on `<om-map>`** caps how far a map can be tilted, in degrees. Useful for a kiosk or an embedded map that should stay roughly upright. It is applied to the controls, so an over-tilt is simply refused rather than snapping back after the fact.
+
 ## 0.8.0 — 2026-09-11
 
 ### Added

package/dist/{LercDecode.es--DH6_OFE.js → LercDecode.es-DKhLh4TO.js}

@@ -19,7 +19,7 @@ async function v(N = {}) {
   if (n) {
     const { createRequire: I } = await import(
       /*webpackIgnore:true*/
-      "./lerc-D7TfTy6l.js"
+      "./lerc-BdHcL8pi.js"
     ).then((g) => g._);
     var O = I(import.meta.url);
   }

package/dist/{basemap-2ZZ_9gFn.js → basemap-BjXMRr_M.js}

@@ -1,4 +1,4 @@
-import { C as ny, L as sy, M as oy, m as ay, c as ka, a as Sd, z as oc, G as sm, V as ly, W as cy, b as uy, g as hy, d as Vu, f as Ed, e as dy, l as py, u as fy, D as Qf, h as my } from "./index-BGOblzWN.js";
+import { C as ny, L as sy, M as oy, m as ay, c as ka, a as Sd, z as oc, G as sm, V as ly, W as cy, b as uy, g as hy, d as Vu, f as Ed, e as dy, l as py, u as fy, D as Qf, h as my } from "./index-D6R4z3Zs.js";
 const Cd = Math.PI / 180, gy = 180 / Math.PI;
 function em(Pe, K = 0) {
   const pe = Math.min(180, Pe) * Cd;
@@ -25321,6 +25321,16 @@ class Ry {
   setInteractive(K) {
     K.doubleClickZoom === !1 ? this.map.doubleClickZoom.disable() : K.doubleClickZoom === !0 && this.map.doubleClickZoom.enable(), K.dragPan === !1 ? this.map.dragPan.disable() : K.dragPan === !0 && this.map.dragPan.enable();
   }
+  /**
+   * Cap how far the user can tilt. Null restores MapLibre's own maximum.
+   *
+   * A cap belongs on the CONTROLLER, not on the camera: clamping a pitch after
+   * the gesture has produced it means the view visibly overshoots and springs
+   * back, while a controller maximum simply refuses to go further.
+   */
+  setMaxPitch(K) {
+    this.map.setMaxPitch(K ?? 85);
+  }
   isLoaded() {
     return this.initialized;
   }

package/dist/basemap.d.ts

@@ -154,6 +154,14 @@ export declare class MapLibreBasemapAdapter {
         doubleClickZoom?: boolean;
         dragPan?: boolean;
     }): void;
+    /**
+     * Cap how far the user can tilt. Null restores MapLibre's own maximum.
+     *
+     * A cap belongs on the CONTROLLER, not on the camera: clamping a pitch after
+     * the gesture has produced it means the view visibly overshoots and springs
+     * back, while a controller maximum simply refuses to go further.
+     */
+    setMaxPitch(maxPitch: number | null): void;
     isLoaded(): boolean;
     getViewport(): ViewportLike;
     getViewState(): BasemapViewState;

package/dist/cartograph/api.d.ts

@@ -29,7 +29,7 @@ export { deriveLegendRows, readOverrides, readLiteralRows, swatchShapeFor, rowCo
 export { buildGraticule, niceInterval, formatDms, GEOGRAPHIC_PLANE, type Graticule, type GridPlane } from "./graticule";
 export { lintLegendColours, simulate, deltaE00, parseColor, ensureCvdFilters, applyCvdToCanvas, resolveCvdType, CVD_TYPES, CVD_VALUES, CVD_MATRICES, COLLAPSE_THRESHOLD, type CvdType, type LegendColourLint, type ColourCollapse, } from "./cvd";
 export { loadCore, setCoreLoader, peekCore, isCoreLoaded, type CoreModule } from "./core-loader";
-export { cornersFromCamera, readCamera, sanitizeAdoptedMap, type FrameCamera, type Corners } from "./live-frame";
+export { cornersFromCamera, maxGeoreferenceablePitch, readCamera, sanitizeAdoptedMap, type FrameCamera, type Corners } from "./live-frame";
 export { renderCartograph, renderCartographAtlas, MAX_CANVAS_AREA, MAX_CANVAS_DIMENSION, type RenderCartographOptions, type RenderCartographResult, type RenderAtlasOptions, type RenderAtlasResult, } from "./render";
 export { buildPages, featureBounds, padBounds, boundsArea, atlasFields, fieldOf, parseSort, sanitizeFilename, resolveFilenames, rejectionFor, type AtlasFeature, type AtlasRejection, } from "./atlas";
 export { createZip, type ZipFile } from "./zip";

package/dist/cartograph/elements/om-frame.d.ts

@@ -65,6 +65,16 @@ export declare class OmFrameElement extends CartographElementBase implements Car
     private updateLiveCorners;
     private mountLive;
     private sizeLiveMap;
+    /**
+     * Stop the adopted map tilting past what this frame can georeference.
+     *
+     * A frame without a georeference has no scale bar, no north arrow, no
+     * graticule and no export — so letting a host drive the camera past the
+     * limit produces a frame that renders an error instead of a map. The ceiling
+     * is the frame's own, recomputed whenever its box changes, because it
+     * depends on the box's aspect and the current zoom.
+     */
+    private capMapPitch;
     /**
      * Draw another frame's footprint on this one. The outline is DENSIFIED —
      * sampled along each edge and projected point by point — because a

package/dist/cartograph/live-frame.d.ts

@@ -45,6 +45,20 @@ export declare function readCamera(el: Element): FrameCamera | null;
  * a huge number that looks like a coordinate — is what lets the frame mark
  * itself degenerate and the furniture refuse to draw.
  */
+/**
+ * The steepest pitch this frame can still georeference, in whole degrees.
+ *
+ * There is no constant to use here. The corners are unprojected through the
+ * frame's OWN box, so the ceiling moves with its aspect and the zoom: a wide
+ * frame tilts further than a tall one, and zooming in raises the limit again.
+ * A fixed 45° or 60° would be wrong in both directions — too strict on the
+ * frames that could tilt, too lax on the ones that cannot.
+ *
+ * Coarse then fine: the answer only needs to be whole degrees, and each probe
+ * is four unprojections, so this is a handful of microseconds rather than
+ * something worth caching.
+ */
+export declare function maxGeoreferenceablePitch(core: CoreModule, camera: FrameCamera, widthPx: number, heightPx: number, ceiling?: number): number;
 export declare function cornersFromCamera(core: CoreModule, camera: FrameCamera, widthPx: number, heightPx: number): Corners | null;
 /** Load the core and build an `<om-map>` for a frame, from `src=` or an inline child. */
 export declare function buildLiveMap(frame: Element): Promise<{