@mapvx/web-js 3.3.1 → 3.3.2

package/dist/umd/index.js

@@ -11240,7 +11240,7 @@ const extractSafariExtensionDetails = (func, filename) => {
 // exists only for the type-checker, so in the ES/CJS builds the identifier is
 // genuinely absent and a direct comparison throws ReferenceError at module load.
 // `typeof` is the only safe way to probe a possibly-undeclared global.
-var sentry_SDK_VERSION =  false ? 0 : "3.3.1";
+var sentry_SDK_VERSION =  false ? 0 : "3.3.2";
 var DSN =  false ? 0 : "https://872f598f020e3cd73a0933b562d24c81@sentry.mapvx.app/5";
 
 /**
@@ -19121,7 +19121,7 @@ function getGltfLoader() {
  * Draco decode time, and totem hardware/networks in the field are often slower than that. The
  * timeout only needs to be long enough that no realistically-sized valid asset ever hits it; a
  * truly hung load (the actual failure this guards against) would still hang forever whether this
- * is 30 seconds or 5 minutes, so there is no tradeoff in keeping it generous.
+ * is 30 seconds or 500 seconds, so there is no tradeoff in keeping it generous.
  *
  * @group Configuration
  */
@@ -19327,6 +19327,89 @@ function addScene3DLights(three, scene, lights) {
   }
   return count;
 }
+
+/** Every material texture-slot property name across three.js's built-in material types. */
+var MATERIAL_TEXTURE_KEYS = ["map", "alphaMap", "aoMap", "bumpMap", "displacementMap", "emissiveMap", "envMap", "lightMap", "metalnessMap", "normalMap", "roughnessMap", "specularMap", "gradientMap", "clearcoatMap", "clearcoatNormalMap", "clearcoatRoughnessMap", "sheenColorMap", "sheenRoughnessMap", "transmissionMap", "thicknessMap", "iridescenceMap", "iridescenceThicknessMap", "anisotropyMap"];
+function disposeMaterial(three, material, disposeTextures) {
+  if (disposeTextures) {
+    var record = material;
+    var _iterator2 = threeScene_createForOfIteratorHelper(MATERIAL_TEXTURE_KEYS),
+      _step2;
+    try {
+      for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
+        var key = _step2.value;
+        var value = record[key];
+        if (value instanceof three.Texture) {
+          value.dispose();
+        }
+      }
+    } catch (err) {
+      _iterator2.e(err);
+    } finally {
+      _iterator2.f();
+    }
+  }
+  material.dispose();
+}
+
+/**
+ * Disposes every mesh's material(s) under `root`, releasing each one's GPU-side program reference,
+ * without touching geometries or textures. Use this for a group whose geometries/textures are
+ * shared with a still-live cache (e.g. a GLB template reused by future placements via `.clone(true)`)
+ * and only its per-placement material clones (made so each placement's opacity is independent) are
+ * exclusively owned by the group.
+ *
+ * @param three - The resolved Three.js module (from `loadThree()`).
+ */
+function disposeMaterialsOnly(three, root) {
+  root.traverse(function (obj) {
+    var mesh = obj;
+    if (!mesh.isMesh) return;
+    var materials = Array.isArray(mesh.material) ? mesh.material : [mesh.material];
+    var _iterator3 = threeScene_createForOfIteratorHelper(materials),
+      _step3;
+    try {
+      for (_iterator3.s(); !(_step3 = _iterator3.n()).done;) {
+        var material = _step3.value;
+        disposeMaterial(three, material, false);
+      }
+    } catch (err) {
+      _iterator3.e(err);
+    } finally {
+      _iterator3.f();
+    }
+  });
+}
+
+/**
+ * Fully disposes every mesh's geometry, material(s), and textures under `root`. Use this only for
+ * an object that exclusively owns its GPU resources — e.g. a loaded GLB template root being evicted
+ * from cache — never for a placement group whose geometries/textures came from a shared template
+ * (use {@link disposeMaterialsOnly} for that instead).
+ *
+ * @param three - The resolved Three.js module (from `loadThree()`).
+ */
+function disposeObject3D(three, root) {
+  root.traverse(function (obj) {
+    var _mesh$geometry;
+    var mesh = obj;
+    if (!mesh.isMesh) return;
+    (_mesh$geometry = mesh.geometry) === null || _mesh$geometry === void 0 || _mesh$geometry.dispose();
+    var materials = Array.isArray(mesh.material) ? mesh.material : [mesh.material];
+    var _iterator4 = threeScene_createForOfIteratorHelper(materials),
+      _step4;
+    try {
+      for (_iterator4.s(); !(_step4 = _iterator4.n()).done;) {
+        var material = _step4.value;
+        disposeMaterial(three, material, true);
+      }
+    } catch (err) {
+      _iterator4.e(err);
+    } finally {
+      _iterator4.f();
+    }
+  });
+}
 ;// ./src/map/scene3DController.ts
 function scene3DController_typeof(o) { "@babel/helpers - typeof"; return scene3DController_typeof = "function" == typeof Symbol && "symbol" == typeof Symbol.iterator ? function (o) { return typeof o; } : function (o) { return o && "function" == typeof Symbol && o.constructor === Symbol && o !== Symbol.prototype ? "symbol" : typeof o; }, scene3DController_typeof(o); }
 function scene3DController_ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
@@ -19335,12 +19418,12 @@ function scene3DController_slicedToArray(r, e) { return scene3DController_arrayW
 function scene3DController_nonIterableRest() { throw new TypeError("Invalid attempt to destructure non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
 function scene3DController_iterableToArrayLimit(r, l) { var t = null == r ? null : "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (null != t) { var e, n, i, u, a = [], f = !0, o = !1; try { if (i = (t = t.call(r)).next, 0 === l) { if (Object(t) !== t) return; f = !1; } else for (; !(f = (e = i.call(t)).done) && (a.push(e.value), a.length !== l); f = !0); } catch (r) { o = !0, n = r; } finally { try { if (!f && null != t["return"] && (u = t["return"](), Object(u) !== u)) return; } finally { if (o) throw n; } } return a; } }
 function scene3DController_arrayWithHoles(r) { if (Array.isArray(r)) return r; }
-function scene3DController_createForOfIteratorHelper(r, e) { var t = "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (!t) { if (Array.isArray(r) || (t = scene3DController_unsupportedIterableToArray(r)) || e && r && "number" == typeof r.length) { t && (r = t); var _n = 0, F = function F() {}; return { s: F, n: function n() { return _n >= r.length ? { done: !0 } : { done: !1, value: r[_n++] }; }, e: function e(r) { throw r; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var o, a = !0, u = !1; return { s: function s() { t = t.call(r); }, n: function n() { var r = t.next(); return a = r.done, r; }, e: function e(r) { u = !0, o = r; }, f: function f() { try { a || null == t["return"] || t["return"](); } finally { if (u) throw o; } } }; }
 function scene3DController_toConsumableArray(r) { return scene3DController_arrayWithoutHoles(r) || scene3DController_iterableToArray(r) || scene3DController_unsupportedIterableToArray(r) || scene3DController_nonIterableSpread(); }
 function scene3DController_nonIterableSpread() { throw new TypeError("Invalid attempt to spread non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); }
-function scene3DController_unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return scene3DController_arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? scene3DController_arrayLikeToArray(r, a) : void 0; } }
 function scene3DController_iterableToArray(r) { if ("undefined" != typeof Symbol && null != r[Symbol.iterator] || null != r["@@iterator"]) return Array.from(r); }
 function scene3DController_arrayWithoutHoles(r) { if (Array.isArray(r)) return scene3DController_arrayLikeToArray(r); }
+function scene3DController_createForOfIteratorHelper(r, e) { var t = "undefined" != typeof Symbol && r[Symbol.iterator] || r["@@iterator"]; if (!t) { if (Array.isArray(r) || (t = scene3DController_unsupportedIterableToArray(r)) || e && r && "number" == typeof r.length) { t && (r = t); var _n = 0, F = function F() {}; return { s: F, n: function n() { return _n >= r.length ? { done: !0 } : { done: !1, value: r[_n++] }; }, e: function e(r) { throw r; }, f: F }; } throw new TypeError("Invalid attempt to iterate non-iterable instance.\nIn order to be iterable, non-array objects must have a [Symbol.iterator]() method."); } var o, a = !0, u = !1; return { s: function s() { t = t.call(r); }, n: function n() { var r = t.next(); return a = r.done, r; }, e: function e(r) { u = !0, o = r; }, f: function f() { try { a || null == t["return"] || t["return"](); } finally { if (u) throw o; } } }; }
+function scene3DController_unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return scene3DController_arrayLikeToArray(r, a); var t = {}.toString.call(r).slice(8, -1); return "Object" === t && r.constructor && (t = r.constructor.name), "Map" === t || "Set" === t ? Array.from(r) : "Arguments" === t || /^(?:Ui|I)nt(?:8|16|32)(?:Clamped)?Array$/.test(t) ? scene3DController_arrayLikeToArray(r, a) : void 0; } }
 function scene3DController_arrayLikeToArray(r, a) { (null == a || a > r.length) && (a = r.length); for (var e = 0, n = Array(a); e < a; e++) n[e] = r[e]; return n; }
 function scene3DController_regenerator() { /*! regenerator-runtime -- Copyright (c) 2014-present, Facebook, Inc. -- license (MIT): https://github.com/babel/babel/blob/main/packages/babel-helpers/LICENSE */ var e, t, r = "function" == typeof Symbol ? Symbol : {}, n = r.iterator || "@@iterator", o = r.toStringTag || "@@toStringTag"; function i(r, n, o, i) { var c = n && n.prototype instanceof Generator ? n : Generator, u = Object.create(c.prototype); return scene3DController_regeneratorDefine2(u, "_invoke", function (r, n, o) { var i, c, u, f = 0, p = o || [], y = !1, G = { p: 0, n: 0, v: e, a: d, f: d.bind(e, 4), d: function d(t, r) { return i = t, c = 0, u = e, G.n = r, a; } }; function d(r, n) { for (c = r, u = n, t = 0; !y && f && !o && t < p.length; t++) { var o, i = p[t], d = G.p, l = i[2]; r > 3 ? (o = l === n) && (u = i[(c = i[4]) ? 5 : (c = 3, 3)], i[4] = i[5] = e) : i[0] <= d && ((o = r < 2 && d < i[1]) ? (c = 0, G.v = n, G.n = i[1]) : d < l && (o = r < 3 || i[0] > n || n > l) && (i[4] = r, i[5] = n, G.n = l, c = 0)); } if (o || r > 1) return a; throw y = !0, n; } return function (o, p, l) { if (f > 1) throw TypeError("Generator is already running"); for (y && 1 === p && d(p, l), c = p, u = l; (t = c < 2 ? e : u) || !y;) { i || (c ? c < 3 ? (c > 1 && (G.n = -1), d(c, u)) : G.n = u : G.v = u); try { if (f = 2, i) { if (c || (o = "next"), t = i[o]) { if (!(t = t.call(i, u))) throw TypeError("iterator result is not an object"); if (!t.done) return t; u = t.value, c < 2 && (c = 0); } else 1 === c && (t = i["return"]) && t.call(i), c < 2 && (u = TypeError("The iterator does not provide a '" + o + "' method"), c = 1); i = e; } else if ((t = (y = G.n < 0) ? u : r.call(n, G)) !== a) break; } catch (t) { i = e, c = 1, u = t; } finally { f = 1; } } return { value: t, done: y }; }; }(r, o, i), !0), u; } var a = {}; function Generator() {} function GeneratorFunction() {} function GeneratorFunctionPrototype() {} t = Object.getPrototypeOf; var c = [][n] ? t(t([][n]())) : (scene3DController_regeneratorDefine2(t = {}, n, function () { return this; }), t), u = GeneratorFunctionPrototype.prototype = Generator.prototype = Object.create(c); function f(e) { return Object.setPrototypeOf ? Object.setPrototypeOf(e, GeneratorFunctionPrototype) : (e.__proto__ = GeneratorFunctionPrototype, scene3DController_regeneratorDefine2(e, o, "GeneratorFunction")), e.prototype = Object.create(u), e; } return GeneratorFunction.prototype = GeneratorFunctionPrototype, scene3DController_regeneratorDefine2(u, "constructor", GeneratorFunctionPrototype), scene3DController_regeneratorDefine2(GeneratorFunctionPrototype, "constructor", GeneratorFunction), GeneratorFunction.displayName = "GeneratorFunction", scene3DController_regeneratorDefine2(GeneratorFunctionPrototype, o, "GeneratorFunction"), scene3DController_regeneratorDefine2(u), scene3DController_regeneratorDefine2(u, o, "Generator"), scene3DController_regeneratorDefine2(u, n, function () { return this; }), scene3DController_regeneratorDefine2(u, "toString", function () { return "[object Generator]"; }), (scene3DController_regenerator = function _regenerator() { return { w: i, m: f }; })(); }
 function scene3DController_regeneratorDefine2(e, r, n, t) { var i = Object.defineProperty; try { i({}, "", {}); } catch (e) { i = 0; } scene3DController_regeneratorDefine2 = function _regeneratorDefine(e, r, n, t) { function o(r, n) { scene3DController_regeneratorDefine2(e, r, function (e) { return this._invoke(r, n, e); }); } r ? i ? i(e, r, { value: n, enumerable: !t, configurable: !t, writable: !t }) : e[r] = n : (o("next", 0), o("throw", 1), o("return", 2)); }, scene3DController_regeneratorDefine2(e, r, n, t); }
@@ -19393,6 +19476,8 @@ var Scene3DController = /*#__PURE__*/function () {
     scene3DController_defineProperty(this, "scene3DGlbLightCount", 0);
     /** Container group holding all placed GLB pivots; rebuilt on each floor change. */
     scene3DController_defineProperty(this, "scene3DModelsGroup", undefined);
+    /** The GLB custom layer's renderer, stored so {@link dispose} can release it; see `createGlbCustomLayer`. */
+    scene3DController_defineProperty(this, "glbRenderer", 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
@@ -19500,11 +19585,20 @@ var Scene3DController = /*#__PURE__*/function () {
       this.applyModelOpacity();
     }
 
-    /** Rebuilds the deck overlay and GLB placements for the given floor. */
+    /**
+     * Rebuilds the deck overlay and GLB placements for the given floor. Host apps call this on every
+     * floor/place-changing navigation, including many that leave the floor unchanged (e.g. re-entering
+     * a screen, tapping the already-active floor selector); a no-op floor is skipped so those don't
+     * trigger a full, wasteful GLB rebuild.
+     */
   }, {
     key: "onFloorChange",
     value: function onFloorChange(currentFloor) {
-      this.currentFloor = currentFloor !== null && currentFloor !== void 0 ? currentFloor : "";
+      var nextFloor = currentFloor !== null && currentFloor !== void 0 ? currentFloor : "";
+      if (nextFloor === this.currentFloor) {
+        return;
+      }
+      this.currentFloor = nextFloor;
       this.updateDeckOverlay();
       this.placeScene3DModels();
     }
@@ -19517,6 +19611,48 @@ var Scene3DController = /*#__PURE__*/function () {
       this.updateDeckOverlay();
     }
 
+    /**
+     * Releases every GPU resource this controller owns: the placed models group's material clones,
+     * the cached GLB templates' geometries/materials/textures, and the `WebGLRenderer` created for the
+     * declarative GLB layer. Idempotent — safe to call more than once (e.g. once via the custom
+     * layer's own `onRemove` and again explicitly).
+     *
+     * Callers must invoke this themselves before tearing down the map: MapLibre's `map.remove()` does
+     * not call a custom layer's `onRemove`, so without an explicit call here nothing ever frees these
+     * resources, and every context-loss recovery cycle (destroy + recreate the map) leaks a full scene.
+     */
+  }, {
+    key: "dispose",
+    value: function dispose() {
+      var _this$threeMod, _this$glbRenderer;
+      var three = (_this$threeMod = this.threeMod) === null || _this$threeMod === void 0 ? void 0 : _this$threeMod.THREE;
+      if (three) {
+        if (this.scene3DModelsGroup) {
+          disposeMaterialsOnly(three, this.scene3DModelsGroup);
+          this.scene3DModelsGroup = undefined;
+        }
+        // Iterate the deduplicated-by-URL roots (not `scene3DGlbTemplateById`, which may map several
+        // asset ids to the same root) so a shared root is never disposed more than once.
+        var _iterator = scene3DController_createForOfIteratorHelper(this.scene3DGlbRootByUrl.values()),
+          _step;
+        try {
+          for (_iterator.s(); !(_step = _iterator.n()).done;) {
+            var root = _step.value;
+            disposeObject3D(three, root);
+          }
+        } catch (err) {
+          _iterator.e(err);
+        } finally {
+          _iterator.f();
+        }
+      }
+      this.scene3DGlbRootByUrl.clear();
+      this.scene3DGlbTemplateById.clear();
+      this.scene3DGlbScene = undefined;
+      (_this$glbRenderer = this.glbRenderer) === null || _this$glbRenderer === void 0 || _this$glbRenderer.dispose();
+      this.glbRenderer = undefined;
+    }
+
     // Internal implementation -----------------------------------------------------------------
 
     /**
@@ -19527,15 +19663,15 @@ var Scene3DController = /*#__PURE__*/function () {
     key: "ensure3DLibs",
     value: function () {
       var _ensure3DLibs = scene3DController_asyncToGenerator(/*#__PURE__*/scene3DController_regenerator().m(function _callee2() {
-        var _this$threeMod, _this$deckMod;
+        var _this$threeMod2, _this$deckMod;
         return scene3DController_regenerator().w(function (_context2) {
           while (1) switch (_context2.n) {
             case 0:
-              if (!((_this$threeMod = this.threeMod) !== null && _this$threeMod !== void 0)) {
+              if (!((_this$threeMod2 = this.threeMod) !== null && _this$threeMod2 !== void 0)) {
                 _context2.n = 1;
                 break;
               }
-              _this$threeMod;
+              _this$threeMod2;
               _context2.n = 3;
               break;
             case 1:
@@ -19606,6 +19742,13 @@ var Scene3DController = /*#__PURE__*/function () {
           renderer.setSize = function (width, height) {
             this.setViewport(0, 0, width, height);
           };
+          // Stored on the controller (not just this closure) so `dispose()` can release it — MapLibre
+          // does not call a custom layer's `onRemove` when the whole map/style is torn down via
+          // `map.remove()`, so callers must dispose this controller explicitly before that happens.
+          _this.glbRenderer = renderer;
+        },
+        onRemove: function onRemove() {
+          _this.dispose();
         },
         render: function render(_gl, args) {
           var _args$defaultProjecti;
@@ -19635,13 +19778,13 @@ var Scene3DController = /*#__PURE__*/function () {
     key: "loadScene3DGlbTemplates",
     value: function () {
       var _loadScene3DGlbTemplates = scene3DController_asyncToGenerator(/*#__PURE__*/scene3DController_regenerator().m(function _callee4() {
-        var _this$threeMod2,
+        var _this$threeMod3,
           _this2 = this;
-        var three, models, uniqueUrls, errorByUrl, semaphore, loadedBytesByUrl, totalBytesByUrl, settledAssets, totalAssets, reportProgress, _iterator2, _step2, asset, root, center, _t5;
+        var three, models, uniqueUrls, errorByUrl, semaphore, loadedBytesByUrl, totalBytesByUrl, settledAssets, totalAssets, reportProgress, _iterator3, _step3, asset, root, center, _t5;
         return scene3DController_regenerator().w(function (_context4) {
           while (1) switch (_context4.p = _context4.n) {
             case 0:
-              three = (_this$threeMod2 = this.threeMod) === null || _this$threeMod2 === void 0 ? void 0 : _this$threeMod2.THREE;
+              three = (_this$threeMod3 = this.threeMod) === null || _this$threeMod3 === void 0 ? void 0 : _this$threeMod3.THREE;
               models = this.scene3DConfig.models;
               if (!(!three || !models || models.enabled === false || models.assets.length === 0)) {
                 _context4.n = 1;
@@ -19671,20 +19814,20 @@ var Scene3DController = /*#__PURE__*/function () {
                 if (!_this2.onModelsProgress) return;
                 var loadedBytes = 0;
                 var totalBytes = 0;
-                var _iterator = scene3DController_createForOfIteratorHelper(uniqueUrls),
-                  _step;
+                var _iterator2 = scene3DController_createForOfIteratorHelper(uniqueUrls),
+                  _step2;
                 try {
-                  for (_iterator.s(); !(_step = _iterator.n()).done;) {
+                  for (_iterator2.s(); !(_step2 = _iterator2.n()).done;) {
                     var _loadedBytesByUrl$get;
-                    var url = _step.value;
+                    var url = _step2.value;
                     loadedBytes += (_loadedBytesByUrl$get = loadedBytesByUrl.get(url)) !== null && _loadedBytesByUrl$get !== void 0 ? _loadedBytesByUrl$get : 0;
                     var total = totalBytesByUrl.get(url);
                     totalBytes = total == null || totalBytes === null ? null : totalBytes + total;
                   }
                 } catch (err) {
-                  _iterator.e(err);
+                  _iterator2.e(err);
                 } finally {
-                  _iterator.f();
+                  _iterator2.f();
                 }
                 try {
                   _this2.onModelsProgress({
@@ -19752,15 +19895,15 @@ var Scene3DController = /*#__PURE__*/function () {
               }()));
             case 2:
               reportProgress(true);
-              _iterator2 = scene3DController_createForOfIteratorHelper(models.assets);
+              _iterator3 = scene3DController_createForOfIteratorHelper(models.assets);
               _context4.p = 3;
-              _iterator2.s();
+              _iterator3.s();
             case 4:
-              if ((_step2 = _iterator2.n()).done) {
+              if ((_step3 = _iterator3.n()).done) {
                 _context4.n = 7;
                 break;
               }
-              asset = _step2.value;
+              asset = _step3.value;
               root = this.scene3DGlbRootByUrl.get(asset.url);
               if (root) {
                 _context4.n = 5;
@@ -19783,10 +19926,10 @@ var Scene3DController = /*#__PURE__*/function () {
             case 8:
               _context4.p = 8;
               _t5 = _context4.v;
-              _iterator2.e(_t5);
+              _iterator3.e(_t5);
             case 9:
               _context4.p = 9;
-              _iterator2.f();
+              _iterator3.f();
               return _context4.f(9);
             case 10:
               return _context4.a(2);
@@ -19801,7 +19944,7 @@ var Scene3DController = /*#__PURE__*/function () {
   }, {
     key: "placeScene3DModels",
     value: function placeScene3DModels() {
-      var _this$threeMod3,
+      var _this$threeMod4,
         _models$globalOffset$,
         _models$globalOffset,
         _models$globalOffset$2,
@@ -19809,7 +19952,7 @@ var Scene3DController = /*#__PURE__*/function () {
         _models$globalOffset$3,
         _models$globalOffset3,
         _this3 = this;
-      var three = (_this$threeMod3 = this.threeMod) === null || _this$threeMod3 === void 0 ? void 0 : _this$threeMod3.THREE;
+      var three = (_this$threeMod4 = this.threeMod) === null || _this$threeMod4 === void 0 ? void 0 : _this$threeMod4.THREE;
       if (!three || !this.scene3DGlbScene) {
         return;
       }
@@ -19818,6 +19961,10 @@ var Scene3DController = /*#__PURE__*/function () {
         return;
       }
       if (this.scene3DModelsGroup) {
+        // Only the per-placement material clones (made below so each placement's zoom-based opacity
+        // is independent) are exclusively owned by this group — geometries/textures come from the
+        // cached templates and stay alive for the next rebuild, so they must not be disposed here.
+        disposeMaterialsOnly(three, this.scene3DModelsGroup);
         this.scene3DGlbScene.remove(this.scene3DModelsGroup);
         this.scene3DModelsGroup = undefined;
       }
@@ -19829,12 +19976,12 @@ var Scene3DController = /*#__PURE__*/function () {
       var floorKey = this.currentFloor;
       var modelsGroup = new three.Group();
       modelsGroup.position.set((_models$globalOffset$ = (_models$globalOffset = models.globalOffset) === null || _models$globalOffset === void 0 ? void 0 : _models$globalOffset.x) !== null && _models$globalOffset$ !== void 0 ? _models$globalOffset$ : 0, (_models$globalOffset$2 = (_models$globalOffset2 = models.globalOffset) === null || _models$globalOffset2 === void 0 ? void 0 : _models$globalOffset2.y) !== null && _models$globalOffset$2 !== void 0 ? _models$globalOffset$2 : 0, (_models$globalOffset$3 = (_models$globalOffset3 = models.globalOffset) === null || _models$globalOffset3 === void 0 ? void 0 : _models$globalOffset3.z) !== null && _models$globalOffset$3 !== void 0 ? _models$globalOffset$3 : 0);
-      var _iterator3 = scene3DController_createForOfIteratorHelper(models.placements),
-        _step3;
+      var _iterator4 = scene3DController_createForOfIteratorHelper(models.placements),
+        _step4;
       try {
         var _loop = function _loop() {
             var _placement$position$a;
-            var placement = _step3.value;
+            var placement = _step4.value;
             if (!isPlacementVisibleOnFloor(placement, floorKey)) {
               return 0; // continue
             }
@@ -19900,14 +20047,14 @@ var Scene3DController = /*#__PURE__*/function () {
             modelsGroup.add(pivot);
           },
           _ret;
-        for (_iterator3.s(); !(_step3 = _iterator3.n()).done;) {
+        for (_iterator4.s(); !(_step4 = _iterator4.n()).done;) {
           _ret = _loop();
           if (_ret === 0) continue;
         }
       } catch (err) {
-        _iterator3.e(err);
+        _iterator4.e(err);
       } finally {
-        _iterator3.f();
+        _iterator4.f();
       }
       this.scene3DModelsGroup = modelsGroup;
       this.scene3DGlbScene.add(modelsGroup);
@@ -19927,9 +20074,9 @@ var Scene3DController = /*#__PURE__*/function () {
   }, {
     key: "recomputeRouteAffectedModels",
     value: function recomputeRouteAffectedModels() {
-      var _this$threeMod4,
+      var _this$threeMod5,
         _this4 = this;
-      var three = (_this$threeMod4 = this.threeMod) === null || _this$threeMod4 === void 0 ? void 0 : _this$threeMod4.THREE;
+      var three = (_this$threeMod5 = this.threeMod) === null || _this$threeMod5 === void 0 ? void 0 : _this$threeMod5.THREE;
       var modelsGroup = this.scene3DModelsGroup;
       if (!three || !modelsGroup) {
         return;
@@ -19952,11 +20099,11 @@ var Scene3DController = /*#__PURE__*/function () {
       });
       modelsGroup.updateMatrixWorld(true);
       var local = new three.Vector3();
-      var _iterator4 = scene3DController_createForOfIteratorHelper(modelsGroup.children),
-        _step4;
+      var _iterator5 = scene3DController_createForOfIteratorHelper(modelsGroup.children),
+        _step5;
       try {
         var _loop2 = function _loop2() {
-          var pivot = _step4.value;
+          var pivot = _step5.value;
           var routeCfg = pivot.userData.routeTransparency;
           var footprint = pivot.userData.footprint;
           // Only models with a route-transparency config participate (feature activation gate).
@@ -19973,13 +20120,13 @@ var Scene3DController = /*#__PURE__*/function () {
             return pointInFootprint(footprint, local.x, local.z);
           });
         };
-        for (_iterator4.s(); !(_step4 = _iterator4.n()).done;) {
+        for (_iterator5.s(); !(_step5 = _iterator5.n()).done;) {
           if (_loop2()) continue;
         }
       } catch (err) {
-        _iterator4.e(err);
+        _iterator5.e(err);
       } finally {
-        _iterator4.f();
+        _iterator5.f();
       }
     }
 
@@ -19999,11 +20146,11 @@ var Scene3DController = /*#__PURE__*/function () {
       }
       var zoom = this.map.getZoom();
       var changed = false;
-      var _iterator5 = scene3DController_createForOfIteratorHelper(this.scene3DModelsGroup.children),
-        _step5;
+      var _iterator6 = scene3DController_createForOfIteratorHelper(this.scene3DModelsGroup.children),
+        _step6;
       try {
         var _loop3 = function _loop3() {
-          var pivot = _step5.value;
+          var pivot = _step6.value;
           var zoomCfg = pivot.userData.zoomTransparency;
           var routeCfg = pivot.userData.routeTransparency;
           var routeAffected = pivot.userData.routeAffected === true;
@@ -20014,11 +20161,11 @@ var Scene3DController = /*#__PURE__*/function () {
               return;
             }
             var materials = Array.isArray(mesh.material) ? mesh.material : [mesh.material];
-            var _iterator6 = scene3DController_createForOfIteratorHelper(materials),
-              _step6;
+            var _iterator7 = scene3DController_createForOfIteratorHelper(materials),
+              _step7;
             try {
-              for (_iterator6.s(); !(_step6 = _iterator6.n()).done;) {
-                var material = _step6.value;
+              for (_iterator7.s(); !(_step7 = _iterator7.n()).done;) {
+                var material = _step7.value;
                 if (material.opacity !== opacity) {
                   material.transparent = opacity < 1;
                   material.opacity = opacity;
@@ -20028,19 +20175,19 @@ var Scene3DController = /*#__PURE__*/function () {
                 }
               }
             } catch (err) {
-              _iterator6.e(err);
+              _iterator7.e(err);
             } finally {
-              _iterator6.f();
+              _iterator7.f();
             }
           });
         };
-        for (_iterator5.s(); !(_step5 = _iterator5.n()).done;) {
+        for (_iterator6.s(); !(_step6 = _iterator6.n()).done;) {
           _loop3();
         }
       } catch (err) {
-        _iterator5.e(err);
+        _iterator6.e(err);
       } finally {
-        _iterator5.f();
+        _iterator6.f();
       }
       if (changed) {
         this.map.triggerRepaint();
@@ -20292,19 +20439,19 @@ var Scene3DController = /*#__PURE__*/function () {
     key: "hideLayers",
     value: function hideLayers(layersIds) {
       if (!layersIds) return;
-      var _iterator7 = scene3DController_createForOfIteratorHelper(layersIds),
-        _step7;
+      var _iterator8 = scene3DController_createForOfIteratorHelper(layersIds),
+        _step8;
       try {
-        for (_iterator7.s(); !(_step7 = _iterator7.n()).done;) {
-          var layerId = _step7.value;
+        for (_iterator8.s(); !(_step8 = _iterator8.n()).done;) {
+          var layerId = _step8.value;
           var layer = this.map.getLayer(layerId);
           if (!layer) continue;
           this.map.setLayoutProperty(layer.id, "visibility", "none");
         }
       } catch (err) {
-        _iterator7.e(err);
+        _iterator8.e(err);
       } finally {
-        _iterator7.f();
+        _iterator8.f();
       }
     }
   }]);
@@ -21129,8 +21276,12 @@ var InternalMapVXMap = /*#__PURE__*/function (_Loggeable) {
   }, {
     key: "destroyMap",
     value: function destroyMap() {
+      var _this$scene3D;
       this.circles = [];
       this.markerLayoutController.destroy();
+      // Dispose the 3D scene's GPU resources before the map (and its shared WebGL context) go away —
+      // MapLibre's own teardown never calls the custom GLB layer's `onRemove`.
+      (_this$scene3D = this.scene3D) === null || _this$scene3D === void 0 || _this$scene3D.dispose();
       this.map.remove();
       this.unsubscribeFromFailedTiles();
     }
@@ -21183,11 +21334,11 @@ var InternalMapVXMap = /*#__PURE__*/function (_Loggeable) {
   }, {
     key: "setRouteCollisionPath",
     value: function setRouteCollisionPath(points) {
-      var _this$scene3D;
+      var _this$scene3D2;
       if (!this.is3DSceneActive()) {
         return;
       }
-      (_this$scene3D = this.scene3D) === null || _this$scene3D === void 0 || _this$scene3D.setRouteCollisionPath(points);
+      (_this$scene3D2 = this.scene3D) === null || _this$scene3D2 === void 0 || _this$scene3D2.setRouteCollisionPath(points);
     }
 
     /**
@@ -21204,7 +21355,7 @@ var InternalMapVXMap = /*#__PURE__*/function (_Loggeable) {
         _this$innerFloors$fin,
         _this$innerFloors$fin2,
         _this$innerFloors$,
-        _this$scene3D2,
+        _this$scene3D3,
         _this9 = this;
       var updateStyle = arguments.length > 1 && arguments[1] !== undefined ? arguments[1] : false;
       var onStyleReady = arguments.length > 2 ? arguments[2] : undefined;
@@ -21219,7 +21370,7 @@ var InternalMapVXMap = /*#__PURE__*/function (_Loggeable) {
       if (place) {
         this.subPlacesLoad(place.mapvxId);
       }
-      (_this$scene3D2 = this.scene3D) === null || _this$scene3D2 === void 0 || _this$scene3D2.onFloorChange(this.currentFloor);
+      (_this$scene3D3 = this.scene3D) === null || _this$scene3D3 === void 0 || _this$scene3D3.onFloorChange(this.currentFloor);
       if (updateStyle) {
         this.repository.fetchAndParseMapStyle(place === null || place === void 0 ? void 0 : place.mapvxId).then(function (style) {
           var useServiceWorkerCaching = _this9.tileCacheConfig.enabled && _this9.tileCacheConfig.persistToServiceWorker;
@@ -21241,7 +21392,7 @@ var InternalMapVXMap = /*#__PURE__*/function (_Loggeable) {
   }, {
     key: "updatePlaceAndFloor",
     value: function updatePlaceAndFloor(parentPlaceId, floorId) {
-      var _place$innerFloors$so2, _ref2, _ref3, _this$innerFloors$fin3, _this$innerFloors$2, _this$scene3D3;
+      var _place$innerFloors$so2, _ref2, _ref3, _this$innerFloors$fin3, _this$innerFloors$2, _this$scene3D4;
       var place = this.potentialParentPlaces.find(function (place) {
         return place.mapvxId === parentPlaceId;
       });
@@ -21253,7 +21404,7 @@ var InternalMapVXMap = /*#__PURE__*/function (_Loggeable) {
       this.currentFloor = (_ref2 = (_ref3 = floorId !== null && floorId !== void 0 ? floorId : (_this$innerFloors$fin3 = this.innerFloors.find(function (floor) {
         return floor.defaultFloor;
       })) === null || _this$innerFloors$fin3 === void 0 ? void 0 : _this$innerFloors$fin3.key) !== null && _ref3 !== void 0 ? _ref3 : (_this$innerFloors$2 = this.innerFloors[0]) === null || _this$innerFloors$2 === void 0 ? void 0 : _this$innerFloors$2.key) !== null && _ref2 !== void 0 ? _ref2 : "";
-      (_this$scene3D3 = this.scene3D) === null || _this$scene3D3 === void 0 || _this$scene3D3.onFloorChange(this.currentFloor);
+      (_this$scene3D4 = this.scene3D) === null || _this$scene3D4 === void 0 || _this$scene3D4.onFloorChange(this.currentFloor);
     }
   }, {
     key: "updateParentPlaceAndFloor",
@@ -21313,14 +21464,14 @@ var InternalMapVXMap = /*#__PURE__*/function (_Loggeable) {
   }, {
     key: "whenStyleUpdates",
     value: function whenStyleUpdates(newStyle) {
-      var _this$scene3D4;
+      var _this$scene3D5;
       if (newStyle) {
         this.setBaseFilters(newStyle);
       }
       this.routeController.addSourcesAndLayers();
       this.refreshCircles();
       this.filterByFloorKey(this.currentFloor);
-      (_this$scene3D4 = this.scene3D) === null || _this$scene3D4 === void 0 || _this$scene3D4.refreshOverlay(this.currentFloor);
+      (_this$scene3D5 = this.scene3D) === null || _this$scene3D5 === void 0 || _this$scene3D5.refreshOverlay(this.currentFloor);
     }
 
     /**
@@ -22234,9 +22385,9 @@ var InternalMapVXMap = /*#__PURE__*/function (_Loggeable) {
     key: "updateFloor",
     value: function updateFloor(floorId, options) {
       try {
-        var _this$scene3D5, _this$onFloorChange2, _options$onComplete6;
+        var _this$scene3D6, _this$onFloorChange2, _options$onComplete6;
         this.filterByFloorKey(floorId);
-        (_this$scene3D5 = this.scene3D) === null || _this$scene3D5 === void 0 || _this$scene3D5.onFloorChange(this.currentFloor);
+        (_this$scene3D6 = this.scene3D) === null || _this$scene3D6 === void 0 || _this$scene3D6.onFloorChange(this.currentFloor);
         (_this$onFloorChange2 = this.onFloorChange) === null || _this$onFloorChange2 === void 0 || _this$onFloorChange2.call(this, floorId);
         this.logEvent("updateFloor", {
           floorId: floorId