@mapvx/web-js 1.4.0-dev.0 → 1.4.0-dev.2

package/dist/cjs/logger/logger.js

@@ -15,7 +15,7 @@ const rollbar_2 = require("./rollbar");
 // by scripts/inject-build-defines.js. The Countly key falls back to the
 // MapVX key when none is injected at build time.
 const IS_DEBUG = typeof DEBUG !== "undefined" ? DEBUG : false;
-const SDK_VERSION = typeof VERSION !== "undefined" ? VERSION : "1.4.0-dev.0";
+const SDK_VERSION = typeof VERSION !== "undefined" ? VERSION : "1.4.0-dev.2";
 const COUNTLY_API_KEY = typeof COUNTLY_KEY !== "undefined" && COUNTLY_KEY
     ? COUNTLY_KEY
     : "f0c8d3b96d336e857a8628f49dd1baf7d7add0e9";

package/dist/cjs/logger/logger.js.map

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

package/dist/cjs/logger/rollbar.js

@@ -1,13 +1,14 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.argsToDict = exports._rollbarConfig = void 0;
+exports._rollbarConfig = void 0;
+exports.argsToDict = argsToDict;
 // VERSION and ROLLBAR_ACCESS_TOKEN are webpack DefinePlugin constants,
 // substituted only in the UMD bundle. The tsc-built ES/CJS outputs keep them
 // as bare globals, so the typeof guards make the lookup safe everywhere; the
 // version placeholder is replaced with the package version by
 // scripts/inject-build-defines.js. The access token falls back to the MapVX
 // SDK-web Rollbar project token when none is injected at build time.
-const SDK_VERSION = typeof VERSION !== "undefined" ? VERSION : "1.4.0-dev.0";
+const SDK_VERSION = typeof VERSION !== "undefined" ? VERSION : "1.4.0-dev.2";
 const ACCESS_TOKEN = typeof ROLLBAR_ACCESS_TOKEN !== "undefined" && ROLLBAR_ACCESS_TOKEN
     ? ROLLBAR_ACCESS_TOKEN
     : "28279d52df43411ebd138c2bee0ab1df";
@@ -33,5 +34,4 @@ exports._rollbarConfig = {
 function argsToDict(...args) {
     return Object.fromEntries(args.map((val, idx) => [idx, val]));
 }
-exports.argsToDict = argsToDict;
 //# sourceMappingURL=rollbar.js.map

package/dist/cjs/logger/rollbar.js.map

@@ -1 +1 @@
-{"version":3,"file":"rollbar.js","sourceRoot":"","sources":["../../../src/logger/rollbar.ts"],"names":[],"mappings":";;;AAKA,uEAAuE;AACvE,6EAA6E;AAC7E,6EAA6E;AAC7E,8DAA8D;AAC9D,4EAA4E;AAC5E,qEAAqE;AACrE,MAAM,WAAW,GAAW,OAAO,OAAO,KAAK,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,iBAAiB,CAAA;AACxF,MAAM,YAAY,GAChB,OAAO,oBAAoB,KAAK,WAAW,IAAI,oBAAoB;IACjE,CAAC,CAAC,oBAAoB;IACtB,CAAC,CAAC,kCAAkC,CAAA;AAE3B,QAAA,cAAc,GAAkB;IAC3C,WAAW,EAAE,YAAY;IACzB,yEAAyE;IACzE,uEAAuE;IACvE,uEAAuE;IACvE,6BAA6B;IAC7B,eAAe,EAAE,KAAK;IACtB,0BAA0B,EAAE,KAAK;IACjC,wDAAwD;IACxD,WAAW,EAAE,OAAO;IACpB,OAAO,EAAE;QACP,WAAW,EAAE,YAAY;QACzB,MAAM,EAAE;YACN,UAAU,EAAE;gBACV,YAAY,EAAE,WAAW;aAC1B;SACF;KACF;CACF,CAAA;AAED,SAAgB,UAAU,CAAC,GAAG,IAAmB;IAC/C,OAAO,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAA;AAC/D,CAAC;AAFD,gCAEC"}
+{"version":3,"file":"rollbar.js","sourceRoot":"","sources":["../../../src/logger/rollbar.ts"],"names":[],"mappings":";;;AAqCA,gCAEC;AAlCD,uEAAuE;AACvE,6EAA6E;AAC7E,6EAA6E;AAC7E,8DAA8D;AAC9D,4EAA4E;AAC5E,qEAAqE;AACrE,MAAM,WAAW,GAAW,OAAO,OAAO,KAAK,WAAW,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,iBAAiB,CAAA;AACxF,MAAM,YAAY,GAChB,OAAO,oBAAoB,KAAK,WAAW,IAAI,oBAAoB;IACjE,CAAC,CAAC,oBAAoB;IACtB,CAAC,CAAC,kCAAkC,CAAA;AAE3B,QAAA,cAAc,GAAkB;IAC3C,WAAW,EAAE,YAAY;IACzB,yEAAyE;IACzE,uEAAuE;IACvE,uEAAuE;IACvE,6BAA6B;IAC7B,eAAe,EAAE,KAAK;IACtB,0BAA0B,EAAE,KAAK;IACjC,wDAAwD;IACxD,WAAW,EAAE,OAAO;IACpB,OAAO,EAAE;QACP,WAAW,EAAE,YAAY;QACzB,MAAM,EAAE;YACN,UAAU,EAAE;gBACV,YAAY,EAAE,WAAW;aAC1B;SACF;KACF;CACF,CAAA;AAED,SAAgB,UAAU,CAAC,GAAG,IAAmB;IAC/C,OAAO,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,EAAE,CAAC,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,CAAC,CAAA;AAC/D,CAAC"}

package/dist/cjs/map/fitCamera.js

@@ -0,0 +1,124 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.computeOrientedCamera = computeOrientedCamera;
+exports.refineCameraForPitch = refineCameraForPitch;
+const maplibre_gl_1 = require("maplibre-gl");
+/** maplibre world size (px) at zoom 0: tileSize (512) * 2^0. */
+const TILE_SIZE = 512;
+const clamp = (value, min, max) => Math.min(Math.max(value, min), max);
+/**
+ * Compute the camera (center + zoom) that tightly fits `coordinates` into the
+ * padded viewport for a given bearing, using an ORIENTED bounding box.
+ *
+ * maplibre's `fitBounds` only fits a north-up `LngLatBounds`, which wastes
+ * viewport space for diagonal geometries under a bearing. Instead we rotate the
+ * mercator-projected points by the bearing, measure their axis-aligned extent in
+ * that rotated frame, and derive zoom + center analytically.
+ *
+ * This calculation is orthographic (assumes `pitch: 0`). For a tilted camera use
+ * {@link refineCameraForPitch} to correct for perspective.
+ *
+ * @param coordinates Points to fit (must contain at least one).
+ * @param params Bearing, padding and viewport constraints.
+ * @returns The fitting camera center and zoom.
+ */
+function computeOrientedCamera(coordinates, params) {
+    const { bearing, padding, containerWidth, containerHeight, maxZoom, minZoom } = params;
+    // Rotate the mercator plane by -bearing so the target bearing becomes axis-aligned.
+    const rad = (-bearing * Math.PI) / 180;
+    const cos = Math.cos(rad);
+    const sin = Math.sin(rad);
+    let minX = Infinity;
+    let minY = Infinity;
+    let maxX = -Infinity;
+    let maxY = -Infinity;
+    for (const coord of coordinates) {
+        const m = maplibre_gl_1.MercatorCoordinate.fromLngLat({ lat: coord.lat, lng: coord.lng });
+        const rx = m.x * cos - m.y * sin;
+        const ry = m.x * sin + m.y * cos;
+        minX = Math.min(minX, rx);
+        minY = Math.min(minY, ry);
+        maxX = Math.max(maxX, rx);
+        maxY = Math.max(maxY, ry);
+    }
+    const boxW = maxX - minX || Number.EPSILON;
+    const boxH = maxY - minY || Number.EPSILON;
+    const availW = Math.max(1, containerWidth - padding.left - padding.right);
+    const availH = Math.max(1, containerHeight - padding.top - padding.bottom);
+    // worldSize (px) = TILE_SIZE * 2^zoom
+    const worldSize = Math.min(availW / boxW, availH / boxH);
+    const zoom = clamp(Math.log2(worldSize / TILE_SIZE), minZoom, maxZoom);
+    // Center of the oriented box, rotated back to geographic space.
+    const cxr = (minX + maxX) / 2;
+    const cyr = (minY + maxY) / 2;
+    const center = new maplibre_gl_1.MercatorCoordinate(cxr * cos + cyr * sin, -cxr * sin + cyr * cos, 0).toLngLat();
+    return { center, zoom };
+}
+/**
+ * Refine a fit camera for a non-zero pitch.
+ *
+ * With `pitch > 0` the ground-to-screen mapping is non-linear (perspective), so
+ * the orthographic result from {@link computeOrientedCamera} either overshoots
+ * (geometry spills past the padding) or leaves extra space. This iteratively
+ * projects every point through maplibre's real perspective projection on a cloned
+ * transform (no visible camera movement) and adjusts zoom + center until the
+ * projected bounding box fits the padded viewport.
+ *
+ * If any point falls behind the horizon during refinement, it bails out and
+ * returns the best camera computed so far (never worse than the flat input).
+ *
+ * @param transform A `map.transform.clone()` used purely for projection.
+ * @param coordinates Points to fit.
+ * @param initial The orthographic camera to refine.
+ * @param params Bearing, pitch, padding and viewport constraints.
+ * @returns The refined camera center and zoom.
+ */
+function refineCameraForPitch(transform, coordinates, initial, params) {
+    const { bearing, pitch, padding, containerWidth, containerHeight, maxZoom, minZoom } = params;
+    transform.setBearing(bearing);
+    transform.setPitch(pitch);
+    transform.setPadding(padding);
+    transform.setCenter(initial.center);
+    transform.setZoom(initial.zoom);
+    const availW = Math.max(1, containerWidth - padding.left - padding.right);
+    const availH = Math.max(1, containerHeight - padding.top - padding.bottom);
+    const MAX_ITERATIONS = 4;
+    const CONVERGENCE_EPSILON = 0.01;
+    let best = { center: initial.center, zoom: initial.zoom };
+    for (let i = 0; i < MAX_ITERATIONS; i++) {
+        let minX = Infinity;
+        let minY = Infinity;
+        let maxX = -Infinity;
+        let maxY = -Infinity;
+        let allOnSurface = true;
+        for (const coord of coordinates) {
+            const screen = transform.locationToScreenPoint(new maplibre_gl_1.LngLat(coord.lng, coord.lat));
+            if (!transform.isPointOnMapSurface(screen)) {
+                allOnSurface = false;
+                break;
+            }
+            minX = Math.min(minX, screen.x);
+            minY = Math.min(minY, screen.y);
+            maxX = Math.max(maxX, screen.x);
+            maxY = Math.max(maxY, screen.y);
+        }
+        // A point behind the horizon makes the projected box meaningless; keep the
+        // last valid camera rather than risk an over-zoomed result.
+        if (!allOnSurface)
+            break;
+        // Recenter: move the projected box center onto the padded screen center.
+        const boxCenter = new maplibre_gl_1.Point((minX + maxX) / 2, (minY + maxY) / 2);
+        transform.setCenter(transform.screenPointToLocation(boxCenter));
+        // Rescale zoom so the projected box fills the padded viewport.
+        const boxW = Math.max(maxX - minX, 1e-6);
+        const boxH = Math.max(maxY - minY, 1e-6);
+        const scale = Math.min(availW / boxW, availH / boxH);
+        const zoomDelta = Math.log2(scale);
+        transform.setZoom(clamp(transform.zoom + zoomDelta, minZoom, maxZoom));
+        best = { center: transform.center, zoom: transform.zoom };
+        if (Math.abs(zoomDelta) < CONVERGENCE_EPSILON)
+            break;
+    }
+    return best;
+}
+//# sourceMappingURL=fitCamera.js.map

package/dist/cjs/map/fitCamera.js.map

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

package/dist/cjs/map/map.js

@@ -15,13 +15,23 @@ var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (
 }) : function(o, v) {
     o["default"] = v;
 });
-var __importStar = (this && this.__importStar) || function (mod) {
-    if (mod && mod.__esModule) return mod;
-    var result = {};
-    if (mod != null) for (var k in mod) if (k !== "default" && Object.prototype.hasOwnProperty.call(mod, k)) __createBinding(result, mod, k);
-    __setModuleDefault(result, mod);
-    return result;
-};
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.InternalMapVXMap = void 0;
 const geo_layers_1 = require("@deck.gl/geo-layers");
@@ -161,9 +171,9 @@ const icons_1 = require("../assets/icons");
 const routeController_1 = require("../controllers/routeController");
 const _rtl_1 = require("../domain/models/_rtl");
 const animation_1 = require("../domain/models/animation");
+const circle_1 = require("../domain/models/circle");
 const loggeable_1 = require("../domain/models/loggeable");
 const mapConfig_1 = require("../domain/models/mapConfig");
-const circle_1 = require("../domain/models/circle");
 const marker_1 = require("../domain/models/marker");
 const route_1 = require("../domain/models/route");
 const routeConfiguration_1 = require("../domain/models/routeConfiguration");
@@ -172,6 +182,7 @@ const _3d_1 = require("../utils/3d");
 const loadGlb_1 = require("../utils/loadGlb");
 const route_utils_1 = require("../utils/route-utils");
 const utils_1 = require("../utils/utils");
+const fitCamera_1 = require("./fitCamera");
 const mapInteractionOptions_1 = require("./mapInteractionOptions");
 /**
  * Class to interact with the map.
@@ -214,6 +225,13 @@ class InternalMapVXMap extends loggeable_1.Loggeable {
         this.scene3DGlbLightCount = 0;
         /** Container group holding all placed GLB pivots; rebuilt on each floor change. */
         this.scene3DModelsGroup = undefined;
+        /**
+         * Route points currently used for GLB route-transparency collision, tagged with the floor on
+         * which each point's route segment is visible. Stored as coordinates (not pivot references) so
+         * they survive `placeScene3DModels` rebuilds on floor change. Only points matching the current
+         * floor participate, so a model only fades when a route is visibly crossing it on that floor.
+         */
+        this.scene3DRouteCollisionPoints = [];
         this.spriteIconMapping = {};
         this.spriteAtlasImage = new Image();
         if (_rtl_1.rtlLanguages.includes((_a = mapConfig.lang) !== null && _a !== void 0 ? _a : "")) {
@@ -371,7 +389,7 @@ class InternalMapVXMap extends loggeable_1.Loggeable {
                 // Hide MapLibre icon layers — replaced by deck.gl IconLayer
                 this.hideLayers((_a = this.scene3DConfig) === null || _a === void 0 ? void 0 : _a.hideLayers);
                 const models = (_b = this.scene3DConfig) === null || _b === void 0 ? void 0 : _b.models;
-                const glbModelsActive = models !== undefined && models.enabled !== false && models.assets.length > 0;
+                const glbModelsActive = models !== undefined && models.assets.length > 0;
                 if (glbModelsActive) {
                     this.map.addLayer(this.createGlbCustomLayer());
                 }
@@ -391,7 +409,7 @@ class InternalMapVXMap extends loggeable_1.Loggeable {
         });
         this.map.on("zoom", () => {
             if (this.is3DSceneActive()) {
-                this.applyModelZoomOpacity();
+                this.applyModelOpacity();
             }
         });
         this.map.on("zoomend", () => {
@@ -551,7 +569,7 @@ class InternalMapVXMap extends loggeable_1.Loggeable {
             .multiply(new three_1.THREE.Matrix4().makeRotationX(Math.PI / 2));
         this.scene3DGlbScene = new three_1.THREE.Scene();
         const models = (_a = this.scene3DConfig) === null || _a === void 0 ? void 0 : _a.models;
-        if (models && models.enabled !== false && models.assets.length > 0) {
+        if (models && models.assets.length > 0) {
             const lights = (0, _3d_1.resolveModels3DLights)(models);
             this.scene3DGlbLightCount = (0, loadGlb_1.addScene3DLights)(this.scene3DGlbScene, lights);
         }
@@ -614,7 +632,7 @@ class InternalMapVXMap extends loggeable_1.Loggeable {
     async loadScene3DGlbTemplates() {
         var _a;
         const models = (_a = this.scene3DConfig) === null || _a === void 0 ? void 0 : _a.models;
-        if (!models || models.enabled === false || models.assets.length === 0) {
+        if (!models || models.assets.length === 0) {
             return;
         }
         this.scene3DGlbRootByUrl.clear();
@@ -635,12 +653,12 @@ class InternalMapVXMap extends loggeable_1.Loggeable {
         }
     }
     placeScene3DModels() {
-        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w;
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v;
         if (!this.scene3DGlbScene) {
             return;
         }
         const models = (_a = this.scene3DConfig) === null || _a === void 0 ? void 0 : _a.models;
-        if (!models || models.enabled === false) {
+        if (!models) {
             return;
         }
         if (this.scene3DModelsGroup) {
@@ -682,15 +700,18 @@ class InternalMapVXMap extends loggeable_1.Loggeable {
                 this.logWarning(new Error(`Invalid scene3D placement position (assetId=${placement.assetId}, floorKey=${floorKey})`));
                 continue;
             }
-            const target = maplibre_gl_1.default.MercatorCoordinate.fromLngLat([placement.position.lng, placement.position.lat], (_j = placement.position.altitude) !== null && _j !== void 0 ? _j : 0);
+            const target = maplibre_gl_1.default.MercatorCoordinate.fromLngLat([
+                placement.position.lng,
+                placement.position.lat,
+            ]);
             const sx = (target.x - refMercator.x) / meterScale;
             const sz = (target.y - refMercator.y) / meterScale;
-            const ax = (_l = (_k = asset.defaultModelOffset) === null || _k === void 0 ? void 0 : _k.x) !== null && _l !== void 0 ? _l : 0;
-            const ay = (_o = (_m = asset.defaultModelOffset) === null || _m === void 0 ? void 0 : _m.y) !== null && _o !== void 0 ? _o : 0;
-            const az = (_q = (_p = asset.defaultModelOffset) === null || _p === void 0 ? void 0 : _p.z) !== null && _q !== void 0 ? _q : 0;
-            const px = (_s = (_r = placement.offset) === null || _r === void 0 ? void 0 : _r.x) !== null && _s !== void 0 ? _s : 0;
-            const py = (_u = (_t = placement.offset) === null || _t === void 0 ? void 0 : _t.y) !== null && _u !== void 0 ? _u : 0;
-            const pz = (_w = (_v = placement.offset) === null || _v === void 0 ? void 0 : _v.z) !== null && _w !== void 0 ? _w : 0;
+            const ax = (_k = (_j = asset.defaultModelOffset) === null || _j === void 0 ? void 0 : _j.x) !== null && _k !== void 0 ? _k : 0;
+            const ay = (_m = (_l = asset.defaultModelOffset) === null || _l === void 0 ? void 0 : _l.y) !== null && _m !== void 0 ? _m : 0;
+            const az = (_p = (_o = asset.defaultModelOffset) === null || _o === void 0 ? void 0 : _o.z) !== null && _p !== void 0 ? _p : 0;
+            const px = (_r = (_q = placement.offset) === null || _q === void 0 ? void 0 : _q.x) !== null && _r !== void 0 ? _r : 0;
+            const py = (_t = (_s = placement.offset) === null || _s === void 0 ? void 0 : _s.y) !== null && _t !== void 0 ? _t : 0;
+            const pz = (_v = (_u = placement.offset) === null || _u === void 0 ? void 0 : _u.z) !== null && _v !== void 0 ? _v : 0;
             const pivot = new three_1.THREE.Group();
             pivot.position.set(sx + ax + px, ay + py, sz + az + pz);
             const mergedRot = (0, _3d_1.mergeRotation3D)(asset.defaultRotation, placement.rotation);
@@ -712,29 +733,109 @@ class InternalMapVXMap extends loggeable_1.Loggeable {
             model.position.set(-template.center.x, -template.center.y, -template.center.z);
             // Stash the resolved zoom-transparency config so it can be re-applied on every zoom change.
             pivot.userData.zoomTransparency = (0, _3d_1.resolveZoomTransparency)(models, asset, placement);
+            // Stash route-transparency config (may be undefined => feature off for this model) so a
+            // route crossing this model can fade it independently of zoom.
+            pivot.userData.routeTransparency = (0, _3d_1.resolveRouteTransparency)(models, asset, placement);
+            // Precompute the model footprint in the pivot's local x/z frame while `model` has no parent
+            // (its world matrix equals its local matrix), for cheap point-in-building collision tests.
+            // After `pivot.add(model)` the world matrix would fold in the pivot transform, giving a loose
+            // world-axis box instead; `pivot.worldToLocal` at test time undoes the pivot transform.
+            const localBox = new three_1.THREE.Box3().setFromObject(model);
+            pivot.userData.footprint = {
+                minX: localBox.min.x,
+                maxX: localBox.max.x,
+                minZ: localBox.min.z,
+                maxZ: localBox.max.z,
+            };
             pivot.add(model);
             modelsGroup.add(pivot);
         }
         this.scene3DModelsGroup = modelsGroup;
         this.scene3DGlbScene.add(modelsGroup);
-        this.applyModelZoomOpacity();
+        // Recompute route collision against the freshly rebuilt pivots (footprints/floor changed),
+        // then apply the combined opacity.
+        this.recomputeRouteAffectedModels();
+        this.applyModelOpacity();
         this.map.triggerRepaint();
     }
     /**
-     * Applies zoom-based transparency to placed GLB models, using each placement's resolved
-     * {@link ZoomTransparencyConfig} stored in `pivot.userData.zoomTransparency`. Hard threshold:
-     * fully opaque below the configured zoom, configured opacity at/above it. Only triggers a
-     * repaint when at least one material actually changed.
+     * Sets the route path used for GLB route-transparency collision and re-evaluates which models a
+     * route currently crosses. Points are tagged with the floor on which their route segment is
+     * visible; only points on the current floor participate, so a model never fades unless a route is
+     * visibly crossing it on the displayed floor. Pass an empty array to clear.
+     *
+     * No-op unless the 3D scene is active.
+     */
+    setRouteCollisionPath(points) {
+        if (!this.is3DSceneActive()) {
+            return;
+        }
+        this.scene3DRouteCollisionPoints = points;
+        this.recomputeRouteAffectedModels();
+        this.applyModelOpacity();
+    }
+    /**
+     * Recomputes `pivot.userData.routeAffected` for every placed model by testing the current-floor
+     * route collision points against each model's precomputed footprint. Cheap point-in-box tests in
+     * the pivot's local x/z frame; runs only when the route path or the placed models change, never
+     * per zoom frame.
+     */
+    recomputeRouteAffectedModels() {
+        var _a;
+        if (!this.scene3DModelsGroup) {
+            return;
+        }
+        const floorKey = (_a = this.currentFloor) !== null && _a !== void 0 ? _a : "";
+        const points = this.scene3DRouteCollisionPoints.filter((p) => p.floorKey === floorKey);
+        // Convert each route point into the models group's local frame (metres relative to
+        // initialCenter), exactly as placements are positioned in `placeScene3DModels`. The group's
+        // own transform (globalOffset) is applied via `localToWorld` at test time, so route points and
+        // model pivots share one frame regardless of the collective offset.
+        const refMercator = maplibre_gl_1.MercatorCoordinate.fromLngLat(this.initialCenter, 0);
+        const meterScale = refMercator.meterInMercatorCoordinateUnits();
+        const groupLocalPoints = points.map((p) => {
+            const target = maplibre_gl_1.MercatorCoordinate.fromLngLat([p.lng, p.lat], 0);
+            const x = (target.x - refMercator.x) / meterScale;
+            const z = (target.y - refMercator.y) / meterScale;
+            return new three_1.THREE.Vector3(x, 0, z);
+        });
+        this.scene3DModelsGroup.updateMatrixWorld(true);
+        const local = new three_1.THREE.Vector3();
+        for (const pivot of this.scene3DModelsGroup.children) {
+            const routeCfg = pivot.userData.routeTransparency;
+            const footprint = pivot.userData.footprint;
+            // Only models with a route-transparency config participate (feature activation gate).
+            if (!routeCfg || !footprint || groupLocalPoints.length === 0) {
+                pivot.userData.routeAffected = false;
+                continue;
+            }
+            pivot.userData.routeAffected = groupLocalPoints.some((gp) => {
+                // group-local -> world (applies globalOffset) -> pivot-local (undoes position/rotation/
+                // scale), then test its x/z against the footprint. y is ignored (floor-level footprint).
+                local.copy(gp);
+                this.scene3DModelsGroup.localToWorld(local);
+                pivot.worldToLocal(local);
+                return (0, _3d_1.pointInFootprint)(footprint, local.x, local.z);
+            });
+        }
+    }
+    /**
+     * Applies transparency to placed GLB models, combining zoom-based transparency
+     * ({@link ZoomTransparencyConfig}) with route-based transparency ({@link RouteTransparencyConfig})
+     * for models a route currently crosses (`pivot.userData.routeAffected`). The more transparent of
+     * the two wins. Only triggers a repaint when at least one material actually changed.
      */
-    applyModelZoomOpacity() {
+    applyModelOpacity() {
         if (!this.scene3DModelsGroup) {
             return;
         }
         const zoom = this.getZoomLevel();
         let changed = false;
         for (const pivot of this.scene3DModelsGroup.children) {
-            const cfg = pivot.userData.zoomTransparency;
-            const opacity = (0, _3d_1.opacityForZoom)(cfg, zoom);
+            const zoomCfg = pivot.userData.zoomTransparency;
+            const routeCfg = pivot.userData.routeTransparency;
+            const routeAffected = pivot.userData.routeAffected === true;
+            const opacity = (0, _3d_1.effectiveModelOpacity)(zoomCfg, routeCfg, zoom, routeAffected);
             pivot.traverse((obj) => {
                 const mesh = obj;
                 if (!mesh.isMesh) {
@@ -1771,6 +1872,52 @@ class InternalMapVXMap extends loggeable_1.Loggeable {
             this.map.fitBounds(bounds, fitOptions);
         }
     }
+    easeToCoordinates(coordinates, options) {
+        var _a;
+        if (coordinates.length === 0) {
+            return;
+        }
+        const onComplete = options === null || options === void 0 ? void 0 : options.onComplete;
+        // Get container dimensions for percentage-based padding calculations
+        const container = this.map.getContainer();
+        const containerWidth = container.clientWidth;
+        const containerHeight = container.clientHeight;
+        // Convert padding values with units to pixels
+        const padding = convertPaddingToPixels(options === null || options === void 0 ? void 0 : options.padding, containerWidth, containerHeight);
+        if (coordinates.length === 1) {
+            const [coord] = coordinates;
+            if (onComplete) {
+                void this.map.once("moveend", onComplete);
+            }
+            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 cameraParams = {
+            bearing,
+            padding,
+            containerWidth,
+            containerHeight,
+            maxZoom: (_a = options === null || options === void 0 ? void 0 : options.maxZoom) !== null && _a !== void 0 ? _a : this.map.getMaxZoom(),
+            minZoom: this.map.getMinZoom(),
+        };
+        // Orthographic oriented fit (exact for pitch 0). maplibre's fitBounds only
+        // fits a north-up LngLatBounds, which wastes viewport space for diagonal
+        // geometries under a bearing.
+        let camera = (0, fitCamera_1.computeOrientedCamera)(coordinates, cameraParams);
+        // With a tilted camera the orthographic zoom is off due to perspective, so
+        // refine it against maplibre's real projection on a cloned transform.
+        if (pitch > 0) {
+            camera = (0, fitCamera_1.refineCameraForPitch)(this.map.transform.clone(), coordinates, camera, Object.assign(Object.assign({}, cameraParams), { pitch }));
+        }
+        if (onComplete) {
+            void this.map.once("moveend", onComplete);
+        }
+        this.map.easeTo(Object.assign(Object.assign({}, options), { center: camera.center, zoom: camera.zoom, bearing,
+            pitch,
+            padding }));
+    }
     fitRouteByPlace(route, placeId, options) {
         // Filter steps that belong to the specified place
         const stepsInPlace = route.steps.filter((step) => step.startInsidePlace === placeId || step.endInsidePlace === placeId);
@@ -1824,7 +1971,7 @@ class InternalMapVXMap extends loggeable_1.Loggeable {
             throw new Error("Error: Failed to add route");
         }
     }
-    updateRouteProgress(routeId, position, behindStyle = { type: "Solid", color: "#757575" }) {
+    updateRouteProgress(routeId, position, behindStyle = { type: "Solid", color: "#276EF1" }) {
         try {
             const behindConfig = new routeConfiguration_1.InternalDrawRouteConfiguration({
                 routeStyle: behindStyle,
@@ -1880,7 +2027,6 @@ class InternalMapVXMap extends loggeable_1.Loggeable {
         }
         return "";
     }
-    // eslint-disable-next-line @typescript-eslint/no-unused-vars
     removePopOver(id) {
         throw Error("Not implemented");
     }