@mapvx/web-js 3.6.0-dev.1 → 4.0.0

package/dist/cjs/map/liveMapFitTransform.js

@@ -1,180 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.LiveMapFitTransform = void 0;
-/**
- * Screen-space tolerance, in pixels, for the horizon round-trip test.
- *
- * `project` and `unproject` are not exact inverses — they run through a 4x4 matrix and its
- * inverse, so a well-behaved point still drifts by a fraction of a pixel. Half a pixel is far
- * below that drift's ceiling and far above the millions-of-pixels divergence a point behind the
- * horizon produces, so the threshold is not sensitive to its exact value.
- */
-const SURFACE_ROUND_TRIP_EPSILON_PX = 0.5;
-/**
- * A {@link FitTransform} backed by a live MapLibre map and its public API.
- *
- * ## Why this exists
- *
- * {@link refineCameraForPitch} needs to project points through MapLibre's real perspective
- * projection for camera states the map is not actually in — it tries a candidate camera, measures
- * where the geometry lands, adjusts, and repeats. Until MapLibre v6 that was done on
- * `map.transform.clone()`, a detached copy of the internal transform.
- *
- * v6 removed `map.transform` and exposes no replacement: there is no exported `Camera`,
- * `Transform` or `MercatorTransform`, and the migration guide says only "use `Map`'s public API
- * instead". So the simulation moves onto the map itself.
- *
- * ## How it stays invisible
- *
- * The map is genuinely moved, but never painted mid-simulation: MapLibre renders on
- * `requestAnimationFrame`, and every mutation here happens inside one synchronous block that ends
- * with {@link restore}. No intermediate frame exists to be seen.
- *
- * Camera writes are also batched. Setters only record intent; the map is moved at most once per
- * refinement iteration, lazily, the first time a projection actually needs the new camera.
- *
- * ## What it costs
- *
- * `jumpTo` fires camera events, so listeners observe movement that no user caused. At the only
- * call site this is bounded — the refinement is immediately followed by a real `easeTo`, so the
- * map was going to move regardless, and the `moveend` handler that reports completion is attached
- * *after* refinement and so cannot see the simulation's events.
- *
- * @example
- * ```typescript
- * const transform = new LiveMapFitTransform(map)
- * try {
- *   camera = refineCameraForPitch(transform, coordinates, camera, params)
- * } finally {
- *   transform.restore()
- * }
- * ```
- *
- * @group Map
- */
-class LiveMapFitTransform {
-    /**
-     * Capture the map's current camera so it can be restored, and seed the simulation with it.
-     *
-     * @param map The live map to simulate on.
-     */
-    constructor(map) {
-        var _a, _b, _c, _d;
-        /** Whether {@link pending} has diverged from what the map is currently showing. */
-        this.dirty = false;
-        /**
-         * Whether the map was ever actually moved.
-         *
-         * Tracked separately from {@link dirty}, which {@link sync} clears the moment it flushes: keying
-         * {@link restore} off `dirty` alone would make it a no-op right after a flush and strand the map
-         * on a candidate camera.
-         */
-        this.moved = false;
-        this.setCenter = (center) => {
-            this.pending.center = center;
-            this.dirty = true;
-        };
-        this.setZoom = (zoom) => {
-            this.pending.zoom = zoom;
-            this.dirty = true;
-        };
-        this.setBearing = (bearing) => {
-            this.pending.bearing = bearing;
-            this.dirty = true;
-        };
-        this.setPitch = (pitch) => {
-            this.pending.pitch = pitch;
-            this.dirty = true;
-        };
-        this.setPadding = (padding) => {
-            this.pending.padding = padding;
-            this.dirty = true;
-        };
-        this.locationToScreenPoint = (lnglat) => {
-            this.sync();
-            return this.map.project(lnglat);
-        };
-        this.screenPointToLocation = (p) => {
-            this.sync();
-            return this.map.unproject(p);
-        };
-        /**
-         * Whether a projected point lies on the visible map surface rather than beyond the horizon.
-         *
-         * MapLibre exposes no public horizon test, so this uses a round-trip: unprojecting a screen
-         * point casts a ray onto the map plane, and re-projecting that location lands back where it
-         * started only if the ray actually met the plane in front of the camera. Past the horizon the
-         * ray diverges and the round-trip misses by an enormous margin.
-         *
-         * @param p Screen point, as returned by {@link locationToScreenPoint}.
-         * @returns `true` when the point is on the map surface.
-         */
-        this.isPointOnMapSurface = (p) => {
-            this.sync();
-            const roundTripped = this.map.project(this.map.unproject(p));
-            return (Number.isFinite(roundTripped.x) &&
-                Number.isFinite(roundTripped.y) &&
-                Math.abs(roundTripped.x - p.x) < SURFACE_ROUND_TRIP_EPSILON_PX &&
-                Math.abs(roundTripped.y - p.y) < SURFACE_ROUND_TRIP_EPSILON_PX);
-        };
-        /**
-         * Put the camera back exactly as it was when this instance was constructed.
-         *
-         * Safe to call more than once, and safe to call when nothing was ever changed. Always call it
-         * from a `finally` block so a throw mid-refinement cannot strand the map on a candidate camera.
-         */
-        this.restore = () => {
-            if (!this.moved) {
-                return;
-            }
-            this.map.jumpTo({
-                center: this.snapshot.center,
-                zoom: this.snapshot.zoom,
-                bearing: this.snapshot.bearing,
-                pitch: this.snapshot.pitch,
-                padding: this.snapshot.padding,
-            });
-            this.pending = Object.assign({}, this.snapshot);
-            this.dirty = false;
-            this.moved = false;
-        };
-        this.map = map;
-        const padding = map.getPadding();
-        this.snapshot = {
-            center: map.getCenter(),
-            zoom: map.getZoom(),
-            bearing: map.getBearing(),
-            pitch: map.getPitch(),
-            padding: {
-                top: (_a = padding.top) !== null && _a !== void 0 ? _a : 0,
-                bottom: (_b = padding.bottom) !== null && _b !== void 0 ? _b : 0,
-                left: (_c = padding.left) !== null && _c !== void 0 ? _c : 0,
-                right: (_d = padding.right) !== null && _d !== void 0 ? _d : 0,
-            },
-        };
-        this.pending = Object.assign({}, this.snapshot);
-    }
-    get center() {
-        return this.pending.center;
-    }
-    get zoom() {
-        return this.pending.zoom;
-    }
-    /** Flush {@link pending} onto the map, but only when a projection actually needs it. */
-    sync() {
-        if (!this.dirty) {
-            return;
-        }
-        this.map.jumpTo({
-            center: this.pending.center,
-            zoom: this.pending.zoom,
-            bearing: this.pending.bearing,
-            pitch: this.pending.pitch,
-            padding: this.pending.padding,
-        });
-        this.dirty = false;
-        this.moved = true;
-    }
-}
-exports.LiveMapFitTransform = LiveMapFitTransform;
-//# sourceMappingURL=liveMapFitTransform.js.map

package/dist/cjs/map/liveMapFitTransform.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"liveMapFitTransform.js","sourceRoot":"","sources":["../../../src/map/liveMapFitTransform.ts"],"names":[],"mappings":"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"}