@mapvx/web-js 2.0.2 → 3.0.0-dev.1

package/dist/es/map/map.js

@@ -15,6 +15,18 @@ const CIRCLE_LAYER_SUFFIXES = {
     belowLabels: "-below-labels",
     top: "-top",
 };
+/**
+ * How many times a failed vector tile is reloaded before it is dropped from the retry
+ * queue. Bounded so a permanently unavailable tile stops being requested, while a tile
+ * that failed on a transient network error still gets several chances.
+ */
+const MAX_TILE_RETRIES = 5;
+/**
+ * Base delay for the retry backoff. Attempt N waits `BASE * 2^(N-1)` before it is
+ * eligible again — 1s, 2s, 4s, 8s — so a tile that keeps failing is retried ever less
+ * often instead of once per timer tick.
+ */
+const TILE_RETRY_BASE_DELAY_MS = 1000;
 /** Fill/line layer ids for one circle render-order bucket. */
 function circleLayerIdsFor(order) {
     const suffix = CIRCLE_LAYER_SUFFIXES[order];
@@ -94,7 +106,7 @@ function parsePaddingValue(value, dimension) {
     if (!match) {
         return 0;
     }
-    const numericValue = parseFloat(match[1]);
+    const numericValue = Number.parseFloat(match[1]);
     const unit = match[2] || "px";
     switch (unit) {
         case "px":
@@ -177,6 +189,12 @@ export class InternalMapVXMap extends Loggeable {
         this.enableHover = false;
         this.hoveredId = "unselected";
         this.failedTiles = new Set();
+        /**
+         * Retry bookkeeping per failed tile. A WeakMap so it can never outlive the tiles
+         * themselves — entries disappear with the tile objects, which is why none of the
+         * `failedTiles.clear()` paths have to reset it.
+         */
+        this.tileRetryState = new WeakMap();
         this.geoLocation = navigator.geolocation;
         /** Owns the deck.gl overlay + GLB scene; created on style load only when 3D is active. */
         this.scene3D = undefined;
@@ -295,7 +313,7 @@ export class InternalMapVXMap extends Loggeable {
             .catch(console.error);
     }
     onMapStyleLoaded(mapConfig, container, style) {
-        var _a, _b, _c, _d, _e;
+        var _a, _b, _c, _d, _e, _f, _g;
         // Determine if service worker caching should be enabled
         const useServiceWorkerCaching = this.tileCacheConfig.enabled && this.tileCacheConfig.persistToServiceWorker;
         if (useServiceWorkerCaching) {
@@ -326,9 +344,9 @@ export class InternalMapVXMap extends Loggeable {
             (_d = (_c = this.map.touchZoomRotate) === null || _c === void 0 ? void 0 : _c.disableRotation) === null || _d === void 0 ? void 0 : _d.call(_c);
         }
         this.map.addControl(new NavigationControl({
-            showCompass: mapConfig.showCompass !== undefined ? mapConfig.showCompass : true,
-            showZoom: mapConfig.showZoom !== undefined ? mapConfig.showZoom : true,
-        }), (_e = mapConfig.navigationPosition) !== null && _e !== void 0 ? _e : "top-right");
+            showCompass: (_e = mapConfig.showCompass) !== null && _e !== void 0 ? _e : true,
+            showZoom: (_f = mapConfig.showZoom) !== null && _f !== void 0 ? _f : true,
+        }), (_g = mapConfig.navigationPosition) !== null && _g !== void 0 ? _g : "top-right");
         this.map.on("load", () => {
             var _a, _b;
             // 3D libraries load asynchronously; the rest of the load flow does not wait on them.
@@ -429,7 +447,7 @@ export class InternalMapVXMap extends Loggeable {
                 ]);
             }
             catch (error) {
-                // Layer language update may fail if layer doesn't exist
+                this.debugLog("Layer language update failed (layer may not exist)", error);
             }
         });
         // indoor layers
@@ -453,7 +471,7 @@ export class InternalMapVXMap extends Loggeable {
                 ]);
             }
             catch (error) {
-                // Layer language update may fail if layer doesn't exist
+                this.debugLog("Layer language update failed (layer may not exist)", error);
             }
         });
     }
@@ -484,7 +502,7 @@ export class InternalMapVXMap extends Loggeable {
             this.logEvent("clearTileCache");
         }
         catch (error) {
-            // Tile cache clear may fail if cache doesn't exist
+            this.debugLog("Tile cache clear failed (cache may not exist)", error);
         }
     }
     /**
@@ -501,6 +519,21 @@ export class InternalMapVXMap extends Loggeable {
         var _a;
         return (_a = this.currentFloor) !== null && _a !== void 0 ? _a : "";
     }
+    /**
+     * Sets the route path used for GLB route-transparency collision, so 3D models a route passes
+     * through fade and reveal the floor plan underneath. Called by {@link RouteController} whenever
+     * the set of drawn routes changes. Points are tagged with the floor their segment is drawn on;
+     * only points on the displayed floor participate. Pass an empty array to clear.
+     *
+     * No-op unless the 3D scene is active.
+     */
+    setRouteCollisionPath(points) {
+        var _a;
+        if (!this.is3DSceneActive()) {
+            return;
+        }
+        (_a = this.scene3D) === null || _a === void 0 ? void 0 : _a.setRouteCollisionPath(points);
+    }
     /**
      * Performs changes when parent place is updated
      * @param place new parent place
@@ -558,7 +591,7 @@ export class InternalMapVXMap extends Loggeable {
             (_d = options === null || options === void 0 ? void 0 : options.onComplete) === null || _d === void 0 ? void 0 : _d.call(options);
         }
         catch (error) {
-            // Parent place/floor update may fail
+            this.debugLog("Parent place/floor update failed", error);
         }
     }
     setLang(lang) {
@@ -626,7 +659,7 @@ export class InternalMapVXMap extends Loggeable {
             return markerCreated.id;
         }
         catch (error) {
-            throw new Error("Failed to add marker");
+            throw new Error("Failed to add marker", { cause: error });
         }
     }
     updateMarker(markerConfig) {
@@ -640,7 +673,7 @@ export class InternalMapVXMap extends Loggeable {
             return (_a = marker === null || marker === void 0 ? void 0 : marker.id) !== null && _a !== void 0 ? _a : "";
         }
         catch (error) {
-            throw new Error("Failed to update marker");
+            throw new Error("Failed to update marker", { cause: error });
         }
     }
     updateMarkerPosition(markerId, newPosition) {
@@ -652,7 +685,7 @@ export class InternalMapVXMap extends Loggeable {
             this.logEvent("updateMarkerPosition");
         }
         catch (error) {
-            throw new Error("Failed to update marker position");
+            throw new Error("Failed to update marker position", { cause: error });
         }
     }
     showMarker(markerId) {
@@ -664,7 +697,7 @@ export class InternalMapVXMap extends Loggeable {
             this.logEvent("showMarker");
         }
         catch (error) {
-            // Show marker may fail if marker doesn't exist
+            this.debugLog("Show marker failed (marker may not exist)", error);
         }
     }
     hideMarker(markerId) {
@@ -676,7 +709,7 @@ export class InternalMapVXMap extends Loggeable {
             this.logEvent("hideMarker");
         }
         catch (error) {
-            // Hide marker may fail if marker doesn't exist
+            this.debugLog("Hide marker failed (marker may not exist)", error);
         }
     }
     removeMarker(markerId) {
@@ -689,7 +722,7 @@ export class InternalMapVXMap extends Loggeable {
             this.logEvent("removeMarker");
         }
         catch (error) {
-            throw new Error("Failed to remove marker");
+            throw new Error("Failed to remove marker", { cause: error });
         }
     }
     removeAllMarkers() {
@@ -701,7 +734,7 @@ export class InternalMapVXMap extends Loggeable {
             this.logEvent("removeAllMarkers");
         }
         catch (error) {
-            throw new Error("Failed to remove all markers");
+            throw new Error("Failed to remove all markers", { cause: error });
         }
     }
     addCircle(circle) {
@@ -810,7 +843,7 @@ export class InternalMapVXMap extends Loggeable {
             this.logEvent("removeCircle");
         }
         catch (error) {
-            throw new Error("Failed to remove circle");
+            throw new Error("Failed to remove circle", { cause: error });
         }
     }
     removeAllCircles() {
@@ -820,7 +853,7 @@ export class InternalMapVXMap extends Loggeable {
             this.logEvent("removeAllCircles");
         }
         catch (error) {
-            throw new Error("Failed to remove all circles");
+            throw new Error("Failed to remove all circles", { cause: error });
         }
     }
     showCircle(circleId) {
@@ -835,6 +868,7 @@ export class InternalMapVXMap extends Loggeable {
             return true;
         }
         catch (error) {
+            this.debugLog("Show circle failed", error);
             return false;
         }
     }
@@ -850,6 +884,7 @@ export class InternalMapVXMap extends Loggeable {
             return true;
         }
         catch (error) {
+            this.debugLog("Hide circle failed", error);
             return false;
         }
     }
@@ -996,7 +1031,7 @@ export class InternalMapVXMap extends Loggeable {
             }
         }
         catch (error) {
-            // Style may not be loaded yet; the styledata listener re-adds the layers
+            this.debugLog("Layers not added: style not loaded yet, the styledata listener will re-add them", error);
         }
     }
     /**
@@ -1015,7 +1050,7 @@ export class InternalMapVXMap extends Loggeable {
             source === null || source === void 0 ? void 0 : source.setData(this.circleFeatureCollection());
         }
         catch (error) {
-            // Source may not exist while a new style is loading
+            this.debugLog("Source not found (a new style may still be loading)", error);
         }
     }
     /**
@@ -1045,7 +1080,7 @@ export class InternalMapVXMap extends Loggeable {
             }
         }
         catch (error) {
-            // Resize may fail if the map/container is not ready
+            this.debugLog("Resize failed (map/container may not be ready)", error);
         }
     }
     updateMarkersTo(floorId) {
@@ -1206,6 +1241,7 @@ export class InternalMapVXMap extends Loggeable {
         (_a = options === null || options === void 0 ? void 0 : options.onComplete) === null || _a === void 0 ? void 0 : _a.call(options);
     }
     fitCoordinates(coordinates, options) {
+        var _a, _b;
         if (coordinates.length === 0) {
             return;
         }
@@ -1247,8 +1283,8 @@ export class InternalMapVXMap extends Loggeable {
             const fitOptions = Object.assign(Object.assign({}, options), { padding });
             const bearing = this.map.getBearing();
             const pitch = this.map.getPitch();
-            fitOptions.bearing = fitOptions.bearing !== undefined ? fitOptions.bearing : bearing;
-            fitOptions.pitch = fitOptions.pitch !== undefined ? fitOptions.pitch : pitch;
+            (_a = fitOptions.bearing) !== null && _a !== void 0 ? _a : (fitOptions.bearing = bearing);
+            (_b = fitOptions.pitch) !== null && _b !== void 0 ? _b : (fitOptions.pitch = pitch);
             if (onComplete) {
                 void this.map.once("moveend", onComplete);
             }
@@ -1256,7 +1292,7 @@ export class InternalMapVXMap extends Loggeable {
         }
     }
     easeToCoordinates(coordinates, options) {
-        var _a;
+        var _a, _b, _c;
         if (coordinates.length === 0) {
             return;
         }
@@ -1275,14 +1311,14 @@ export class InternalMapVXMap extends Loggeable {
             this.map.easeTo(Object.assign(Object.assign({}, options), { center: { lat: coord.lat, lng: coord.lng }, padding }));
             return;
         }
-        const bearing = (options === null || options === void 0 ? void 0 : options.bearing) !== undefined ? options.bearing : this.map.getBearing();
-        const pitch = (options === null || options === void 0 ? void 0 : options.pitch) !== undefined ? options.pitch : this.map.getPitch();
+        const bearing = (_a = options === null || options === void 0 ? void 0 : options.bearing) !== null && _a !== void 0 ? _a : this.map.getBearing();
+        const pitch = (_b = options === null || options === void 0 ? void 0 : options.pitch) !== null && _b !== void 0 ? _b : this.map.getPitch();
         const cameraParams = {
             bearing,
             padding,
             containerWidth,
             containerHeight,
-            maxZoom: (_a = options === null || options === void 0 ? void 0 : options.maxZoom) !== null && _a !== void 0 ? _a : this.map.getMaxZoom(),
+            maxZoom: (_c = options === null || options === void 0 ? void 0 : options.maxZoom) !== null && _c !== void 0 ? _c : this.map.getMaxZoom(),
             minZoom: this.map.getMinZoom(),
         };
         // Orthographic oriented fit (exact for pitch 0). maplibre's fitBounds only
@@ -1326,7 +1362,7 @@ export class InternalMapVXMap extends Loggeable {
             (_c = options === null || options === void 0 ? void 0 : options.onComplete) === null || _c === void 0 ? void 0 : _c.call(options);
         }
         catch (error) {
-            // Floor update may fail
+            this.debugLog("Floor update failed", error);
         }
     }
     updatePlaceAndFloorForRouting(placeId, floorId) {
@@ -1339,7 +1375,7 @@ export class InternalMapVXMap extends Loggeable {
             this.logEvent("updatePlaceAndFloorForRouting", { floorId });
         }
         catch (error) {
-            // Place/floor update for routing may fail
+            this.debugLog("Place/floor update for routing failed", error);
         }
     }
     async addRoute(config, drawConfig = {}) {
@@ -1352,7 +1388,7 @@ export class InternalMapVXMap extends Loggeable {
             return route;
         }
         catch (error) {
-            throw new Error("Error: Failed to add route");
+            throw new Error("Error: Failed to add route", { cause: error });
         }
     }
     async addLiveRoute(config, drawConfig = {}) {
@@ -1389,8 +1425,8 @@ export class InternalMapVXMap extends Loggeable {
             return route;
         }
         catch (error) {
-            const cause = error instanceof Error ? error.message : String(error);
-            throw new Error(`Error: Failed to add route: ${cause}`);
+            const reason = error instanceof Error ? error.message : String(error);
+            throw new Error(`Error: Failed to add route: ${reason}`, { cause: error });
         }
     }
     updateRouteProgress(routeId, position, behindStyle = { type: "Solid", color: "#276EF1" }) {
@@ -1401,7 +1437,7 @@ export class InternalMapVXMap extends Loggeable {
             this.routeController.updateRouteProgress(routeId, position, behindConfig);
         }
         catch (error) {
-            // Update may fail if route doesn't exist
+            this.debugLog("Route update failed (route may not exist)", error);
         }
     }
     removeRoute(routeId) {
@@ -1410,7 +1446,7 @@ export class InternalMapVXMap extends Loggeable {
             this.routeController.removeRoute(routeId);
         }
         catch (error) {
-            // Remove route may fail if no route exists
+            this.debugLog("Remove route failed (no route may exist)", error);
         }
         this.syncLiveRouteId();
     }
@@ -1420,7 +1456,7 @@ export class InternalMapVXMap extends Loggeable {
             this.routeController.removeRoute(routeId);
         }
         catch (error) {
-            // Remove route may fail if route doesn't exist
+            this.debugLog("Remove route failed (route may not exist)", error);
         }
         this.syncLiveRouteId();
     }
@@ -1430,7 +1466,7 @@ export class InternalMapVXMap extends Loggeable {
             this.routeController.removeAllRoutes();
         }
         catch (error) {
-            // Remove all routes may fail
+            this.debugLog("Remove all routes failed", error);
         }
         this.syncLiveRouteId();
     }
@@ -1570,7 +1606,7 @@ export class InternalMapVXMap extends Loggeable {
             }
         }
         catch (error) {
-            // Place selection may fail if layer doesn't exist
+            this.debugLog("Place selection failed (layer may not exist)", error);
         }
     }
     is3DStyle() {
@@ -1659,7 +1695,7 @@ export class InternalMapVXMap extends Loggeable {
             return route;
         }
         catch (error) {
-            throw new Error("Error: Failed to start animating route");
+            throw new Error("Error: Failed to start animating route", { cause: error });
         }
     }
     async startAnimateRouteV2(routeConfig, drawConfig = {}, animationConfig = {}) {
@@ -1678,7 +1714,7 @@ export class InternalMapVXMap extends Loggeable {
             return route;
         }
         catch (error) {
-            throw new Error("Error: Failed to start animating route");
+            throw new Error("Error: Failed to start animating route", { cause: error });
         }
     }
     pauseAnimateRoute(routeId) {
@@ -1687,7 +1723,7 @@ export class InternalMapVXMap extends Loggeable {
             this.logEvent("pauseAnimateRoute");
         }
         catch (error) {
-            // Pause animation may fail if no animation is running
+            this.debugLog("Pause animation failed (no animation may be running)", error);
         }
     }
     resumeAnimateRoute(routeId) {
@@ -1696,7 +1732,7 @@ export class InternalMapVXMap extends Loggeable {
             this.logEvent("resumeAnimateRoute");
         }
         catch (error) {
-            // Resume animation may fail if no animation is paused
+            this.debugLog("Resume animation failed (no animation may be paused)", error);
         }
     }
     restartAnimateRoute(routeId) {
@@ -1705,7 +1741,7 @@ export class InternalMapVXMap extends Loggeable {
             this.logEvent("restartAnimateRoute");
         }
         catch (error) {
-            // Restart animation may fail if no animation exists
+            this.debugLog("Restart animation failed (no animation may exist)", error);
         }
     }
     stopAnimateRoute() {
@@ -1730,7 +1766,7 @@ export class InternalMapVXMap extends Loggeable {
             return route;
         }
         catch (error) {
-            throw new Error("Error: Failed to add step animation");
+            throw new Error("Error: Failed to add step animation", { cause: error });
         }
     }
     async addStepAnimationV2(routeConfig, drawConfig = {}, animationConfig = {}) {
@@ -1750,7 +1786,7 @@ export class InternalMapVXMap extends Loggeable {
             return route;
         }
         catch (error) {
-            throw new Error("Error: Failed to add step animation");
+            throw new Error("Error: Failed to add step animation", { cause: error });
         }
     }
     nextStepAnimation(routeId) {
@@ -1759,7 +1795,7 @@ export class InternalMapVXMap extends Loggeable {
             this.logEvent("nextStepAnimation");
         }
         catch (error) {
-            throw new Error("Error: Failed to animate step");
+            throw new Error("Error: Failed to animate step", { cause: error });
         }
     }
     previousStepAnimation(routeId) {
@@ -1848,7 +1884,7 @@ export class InternalMapVXMap extends Loggeable {
             }
         }
         catch (error) {
-            throw new Error("Failed to add border to places");
+            throw new Error("Failed to add border to places", { cause: error });
         }
     }
     createBorderedPlacesLayer() {
@@ -1951,16 +1987,54 @@ export class InternalMapVXMap extends Loggeable {
             // Remove invalid tiles from the set
             tilesToRemove.forEach((tile) => this.failedTiles.delete(tile));
             // Attempt to reload valid failed tiles
+            const now = Date.now();
             tilesToRetry.forEach((tile) => {
+                var _a;
+                const retry = (_a = this.tileRetryState.get(tile)) !== null && _a !== void 0 ? _a : {
+                    attempts: 0,
+                    nextAttemptAt: 0,
+                    pending: false,
+                };
+                // Skip tiles with a reload still in flight or still inside their backoff window.
+                if (retry.pending || now < retry.nextAttemptAt)
+                    return;
+                const onFailure = (error) => {
+                    const attempts = retry.attempts + 1;
+                    if (attempts >= MAX_TILE_RETRIES) {
+                        this.debugLog(`Tile reload failed ${attempts} times, dropping it from the retry queue`, error);
+                        this.failedTiles.delete(tile);
+                        this.tileRetryState.delete(tile);
+                        return;
+                    }
+                    // Stay in the queue and try again once the backoff has elapsed.
+                    const backoffMs = TILE_RETRY_BASE_DELAY_MS * 2 ** (attempts - 1);
+                    this.debugLog(`Tile reload failed (attempt ${attempts}/${MAX_TILE_RETRIES}), retrying in ${backoffMs}ms`, error);
+                    this.tileRetryState.set(tile, {
+                        attempts,
+                        nextAttemptAt: Date.now() + backoffMs,
+                        pending: false,
+                    });
+                };
                 try {
                     // Verify tile still exists and is in a retryable state
                     if (tile && (tile.state === "errored" || tile.state === "expired")) {
-                        source.loadTile(tile);
+                        this.tileRetryState.set(tile, Object.assign(Object.assign({}, retry), { pending: true }));
+                        // loadTile is async, so a rejection escapes this try/catch and has to be handled
+                        // on the promise itself - otherwise it surfaces as an unhandled rejection and the
+                        // tile is retried on every tick regardless of how often it has already failed.
+                        source
+                            .loadTile(tile)
+                            .then(() => {
+                            // Loaded: forget the attempt history so a later failure starts from zero. The
+                            // tile leaves the queue through the tilesToRemove branch on the next tick,
+                            // once its state is no longer errored/expired.
+                            this.tileRetryState.delete(tile);
+                        })
+                            .catch(onFailure);
                     }
                 }
                 catch (error) {
-                    // If reload fails, remove tile from retry queue - this is expected
-                    this.failedTiles.delete(tile);
+                    onFailure(error);
                 }
             });
         }, 1000);