@mapvx/web-js 3.5.0-dev.2 → 3.5.0-dev.3

package/dist/es/utils/three.js.map

@@ -1 +1 @@
-{"version":3,"file":"three.js","sourceRoot":"","sources":["../../../src/utils/three.ts"],"names":[],"mappings":"AAmDA,IAAI,YAA8C,CAAA;AAClD,IAAI,WAA4C,CAAA;AAEhD;;;GAGG;AACH,MAAM,UAAU,SAAS;IACvB,YAAY,aAAZ,YAAY,cAAZ,YAAY,IAAZ,YAAY,GAAK,OAAO,CAAC,GAAG,CAAC;QAC3B,MAAM,CAAC,OAAO,CAAC;QACf,MAAM,CAAC,oCAAoC,CAAC;QAC5C,MAAM,CAAC,qCAAqC,CAAC;QAC7C,MAAM,CAAC,oCAAoC,CAAC;QAC5C,MAAM,CAAC,6CAA6C,CAAC;KACtD,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,EAAE,OAAO,CAAC,EAAE,EAAE,CAAC,CAAC;QAChD,KAAK,EAAE,KAAK;QACZ,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,cAAc,EAAE,OAAO,CAAC,cAAc;KACvC,CAAC,CAAC,EAAA;IACH,OAAO,YAAY,CAAA;AACrB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,QAAQ;IACtB,WAAW,aAAX,WAAW,cAAX,WAAW,IAAX,WAAW,GAAK,OAAO,CAAC,GAAG,CAAC;QAC1B,MAAM,CAAC,iBAAiB,CAAC;QACzB,MAAM,CAAC,qBAAqB,CAAC;QAC7B,MAAM,CAAC,iBAAiB,CAAC;KAC1B,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;QACxC,aAAa,EAAE,MAAM,CAAC,aAAa;QACnC,QAAQ,EAAE,SAAS,CAAC,QAAQ;QAC5B,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,SAAS,EAAE,MAAM,CAAC,SAAS;KAC5B,CAAC,CAAC,EAAA;IACH,OAAO,WAAW,CAAA;AACpB,CAAC"}
+{"version":3,"file":"three.js","sourceRoot":"","sources":["../../../src/utils/three.ts"],"names":[],"mappings":"AA6CA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,aAAa,CAAI,IAAsB;IACrD,IAAI,MAA8B,CAAA;IAClC,OAAO,GAAG,EAAE;QACV,MAAM,aAAN,MAAM,cAAN,MAAM,IAAN,MAAM,GAAK,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;YACzC,wFAAwF;YACxF,iFAAiF;YACjF,MAAM,GAAG,SAAS,CAAA;YAClB,MAAM,KAAK,CAAA;QACb,CAAC,CAAC,EAAA;QACF,OAAO,MAAM,CAAA;IACf,CAAC,CAAA;AACH,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,SAAS,GAA+B,aAAa,CAAC,GAAG,EAAE,CACtE,OAAO,CAAC,GAAG,CAAC;IACV,MAAM,CAAC,OAAO,CAAC;IACf,MAAM,CAAC,oCAAoC,CAAC;IAC5C,MAAM,CAAC,qCAAqC,CAAC;IAC7C,MAAM,CAAC,oCAAoC,CAAC;CAC7C,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;IACvC,KAAK,EAAE,KAAK;IACZ,UAAU,EAAE,IAAI,CAAC,UAAU;IAC3B,WAAW,EAAE,KAAK,CAAC,WAAW;IAC9B,UAAU,EAAE,IAAI,CAAC,UAAU;CAC5B,CAAC,CAAC,CACJ,CAAA;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,kBAAkB,GAAyC,aAAa,CAAC,GAAG,EAAE,CACzF,MAAM,CAAC,6CAA6C,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,cAAc,CAAC,CAChG,CAAA;AAED;;;GAGG;AACH,MAAM,CAAC,MAAM,QAAQ,GAA8B,aAAa,CAAC,GAAG,EAAE,CACpE,OAAO,CAAC,GAAG,CAAC;IACV,MAAM,CAAC,iBAAiB,CAAC;IACzB,MAAM,CAAC,qBAAqB,CAAC;IAC7B,MAAM,CAAC,iBAAiB,CAAC;CAC1B,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;IACxC,aAAa,EAAE,MAAM,CAAC,aAAa;IACnC,QAAQ,EAAE,SAAS,CAAC,QAAQ;IAC5B,SAAS,EAAE,MAAM,CAAC,SAAS;IAC3B,SAAS,EAAE,MAAM,CAAC,SAAS;IAC3B,SAAS,EAAE,MAAM,CAAC,SAAS;CAC5B,CAAC,CAAC,CACJ,CAAA"}

package/dist/umd/index.js

@@ -11249,7 +11249,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.5.0-dev.2";
+var sentry_SDK_VERSION =  false ? 0 : "3.5.0-dev.3";
 var DSN =  false ? 0 : "https://872f598f020e3cd73a0933b562d24c81@sentry.mapvx.app/5";
 
 /**
@@ -19709,37 +19709,83 @@ function three_arrayWithHoles(r) { if (Array.isArray(r)) return r; }
 
 /** Runtime handle to the deck.gl classes used by the 3D scene. */
 
-var threePromise;
-var deckPromise;
+/**
+ * Memoizes a dynamic-import chain, caching only a FULFILLED result.
+ *
+ * A plain `cached ??= import(...)` also memoizes a *rejection*, so one transient chunk-fetch
+ * failure (a dropped connection, a cache-busted deploy mid-session) permanently disables the
+ * feature for the rest of the page's life: every retry receives the same rejected promise and
+ * fails identically. The 3D scene retries on its own — `reloadScene3DModelsForLod` reloads GLB
+ * templates on every zoom-in past the LOD threshold — so a sticky rejection turns a blip into
+ * models that never come back until the user reloads.
+ *
+ * Concurrent callers still share one in-flight import (that is the point of the cache); only the
+ * rejected promise is evicted, and the error is re-thrown so every current caller still sees it.
+ *
+ * Exported only so the eviction behaviour can be tested directly — the loaders below wrap real
+ * dynamic `import()` calls, which a unit test cannot fail on demand.
+ *
+ * @param load Builds the import promise. Called again on the first retry after a failure.
+ * @returns An accessor that imports at most once per successful load.
+ * @internal
+ */
+function memoizeImport(load) {
+  var cached;
+  return function () {
+    cached !== null && cached !== void 0 ? cached : cached = load()["catch"](function (error) {
+      // Evict BEFORE re-throwing so the next call starts a fresh import. Safe to assign here:
+      // a promise never settles synchronously, so `cached` is already assigned by now.
+      cached = undefined;
+      throw error;
+    });
+    return cached;
+  };
+}
 
 /**
  * Dynamically imports Three.js and the GLTF/DRACO/KTX2 loaders once and caches the result.
  * Subsequent calls return the same promise, so a single Three.js instance is shared.
+ * A failed import is not cached — see {@link memoizeImport}.
  */
-function loadThree() {
-  threePromise !== null && threePromise !== void 0 ? threePromise : threePromise = Promise.all([Promise.resolve(/* import() */).then(__webpack_require__.t.bind(__webpack_require__, 912, 23)), Promise.resolve(/* import() */).then(__webpack_require__.t.bind(__webpack_require__, 833, 23)), Promise.resolve(/* import() */).then(__webpack_require__.t.bind(__webpack_require__, 303, 23)), Promise.resolve(/* import() */).then(__webpack_require__.t.bind(__webpack_require__, 373, 23)), Promise.resolve(/* import() */).then(__webpack_require__.t.bind(__webpack_require__, 502, 23))]).then(function (_ref) {
-    var _ref2 = three_slicedToArray(_ref, 5),
+var loadThree = memoizeImport(function () {
+  return Promise.all([Promise.resolve(/* import() */).then(__webpack_require__.t.bind(__webpack_require__, 912, 23)), Promise.resolve(/* import() */).then(__webpack_require__.t.bind(__webpack_require__, 833, 23)), Promise.resolve(/* import() */).then(__webpack_require__.t.bind(__webpack_require__, 303, 23)), Promise.resolve(/* import() */).then(__webpack_require__.t.bind(__webpack_require__, 373, 23))]).then(function (_ref) {
+    var _ref2 = three_slicedToArray(_ref, 4),
       three = _ref2[0],
       gltf = _ref2[1],
       draco = _ref2[2],
-      ktx2 = _ref2[3],
-      meshopt = _ref2[4];
+      ktx2 = _ref2[3];
     return {
       THREE: three,
       GLTFLoader: gltf.GLTFLoader,
       DRACOLoader: draco.DRACOLoader,
-      KTX2Loader: ktx2.KTX2Loader,
-      MeshoptDecoder: meshopt.MeshoptDecoder
+      KTX2Loader: ktx2.KTX2Loader
     };
   });
-  return threePromise;
-}
+});
+
+/**
+ * Dynamically imports the singleton meshopt decoder once and caches the result.
+ *
+ * Deliberately NOT part of {@link loadThree}'s import chain: only GLBs compressed with
+ * `EXT_meshopt_compression` need it, so keeping it out of the eager `Promise.all` keeps the
+ * decoder module (and its WASM instantiation) off the critical path of the first 3D frame.
+ * It is fetched on the first meshopt buffer decode instead — see the lazy wrapper in
+ * `loadGlb.ts`. That moves the fetch inside `parse()`, competing with hundreds of MB of GLB
+ * downloads, so not caching a failed import (see {@link memoizeImport}) matters more here than
+ * for the eager loaders.
+ */
+var loadMeshoptDecoder = memoizeImport(function () {
+  return Promise.resolve(/* import() */).then(__webpack_require__.t.bind(__webpack_require__, 502, 23)).then(function (meshopt) {
+    return meshopt.MeshoptDecoder;
+  });
+});
 
 /**
  * Dynamically imports the deck.gl overlay and layer classes once and caches the result.
+ * A failed import is not cached — see {@link memoizeImport}.
  */
-function loadDeck() {
-  deckPromise !== null && deckPromise !== void 0 ? deckPromise : deckPromise = Promise.all([Promise.resolve(/* import() */).then(__webpack_require__.t.bind(__webpack_require__, 452, 23)), Promise.resolve(/* import() */).then(__webpack_require__.t.bind(__webpack_require__, 741, 23)), Promise.resolve(/* import() */).then(__webpack_require__.t.bind(__webpack_require__, 589, 23))]).then(function (_ref3) {
+var loadDeck = memoizeImport(function () {
+  return Promise.all([Promise.resolve(/* import() */).then(__webpack_require__.t.bind(__webpack_require__, 452, 23)), Promise.resolve(/* import() */).then(__webpack_require__.t.bind(__webpack_require__, 741, 23)), Promise.resolve(/* import() */).then(__webpack_require__.t.bind(__webpack_require__, 589, 23))]).then(function (_ref3) {
     var _ref4 = three_slicedToArray(_ref3, 3),
       mapbox = _ref4[0],
       geoLayers = _ref4[1],
@@ -19752,31 +19798,104 @@ function loadDeck() {
       TextLayer: layers.TextLayer
     };
   });
-  return deckPromise;
-}
+});
 ;// ./src/utils/loadGlb.ts
-function loadGlb_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 loadGlb_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]())) : (loadGlb_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, loadGlb_regeneratorDefine2(e, o, "GeneratorFunction")), e.prototype = Object.create(u), e; } return GeneratorFunction.prototype = GeneratorFunctionPrototype, loadGlb_regeneratorDefine2(u, "constructor", GeneratorFunctionPrototype), loadGlb_regeneratorDefine2(GeneratorFunctionPrototype, "constructor", GeneratorFunction), GeneratorFunction.displayName = "GeneratorFunction", loadGlb_regeneratorDefine2(GeneratorFunctionPrototype, o, "GeneratorFunction"), loadGlb_regeneratorDefine2(u), loadGlb_regeneratorDefine2(u, o, "Generator"), loadGlb_regeneratorDefine2(u, n, function () { return this; }), loadGlb_regeneratorDefine2(u, "toString", function () { return "[object Generator]"; }), (loadGlb_regenerator = function _regenerator() { return { w: i, m: f }; })(); }
-function loadGlb_regeneratorDefine2(e, r, n, t) { var i = Object.defineProperty; try { i({}, "", {}); } catch (e) { i = 0; } loadGlb_regeneratorDefine2 = function _regeneratorDefine(e, r, n, t) { function o(r, n) { loadGlb_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)); }, loadGlb_regeneratorDefine2(e, r, n, t); }
 function loadGlb_slicedToArray(r, e) { return loadGlb_arrayWithHoles(r) || loadGlb_iterableToArrayLimit(r, e) || loadGlb_unsupportedIterableToArray(r, e) || loadGlb_nonIterableRest(); }
 function loadGlb_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 loadGlb_unsupportedIterableToArray(r, a) { if (r) { if ("string" == typeof r) return loadGlb_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) ? loadGlb_arrayLikeToArray(r, a) : void 0; } }
 function loadGlb_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 loadGlb_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 loadGlb_arrayWithHoles(r) { if (Array.isArray(r)) return r; }
+function loadGlb_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 loadGlb_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]())) : (loadGlb_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, loadGlb_regeneratorDefine2(e, o, "GeneratorFunction")), e.prototype = Object.create(u), e; } return GeneratorFunction.prototype = GeneratorFunctionPrototype, loadGlb_regeneratorDefine2(u, "constructor", GeneratorFunctionPrototype), loadGlb_regeneratorDefine2(GeneratorFunctionPrototype, "constructor", GeneratorFunction), GeneratorFunction.displayName = "GeneratorFunction", loadGlb_regeneratorDefine2(GeneratorFunctionPrototype, o, "GeneratorFunction"), loadGlb_regeneratorDefine2(u), loadGlb_regeneratorDefine2(u, o, "Generator"), loadGlb_regeneratorDefine2(u, n, function () { return this; }), loadGlb_regeneratorDefine2(u, "toString", function () { return "[object Generator]"; }), (loadGlb_regenerator = function _regenerator() { return { w: i, m: f }; })(); }
+function loadGlb_regeneratorDefine2(e, r, n, t) { var i = Object.defineProperty; try { i({}, "", {}); } catch (e) { i = 0; } loadGlb_regeneratorDefine2 = function _regeneratorDefine(e, r, n, t) { function o(r, n) { loadGlb_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)); }, loadGlb_regeneratorDefine2(e, r, n, t); }
 function loadGlb_asyncGeneratorStep(n, t, e, r, o, a, c) { try { var i = n[a](c), u = i.value; } catch (n) { return void e(n); } i.done ? t(u) : Promise.resolve(u).then(r, o); }
 function loadGlb_asyncToGenerator(n) { return function () { var t = this, e = arguments; return new Promise(function (r, o) { var a = n.apply(t, e); function _next(n) { loadGlb_asyncGeneratorStep(a, r, o, _next, _throw, "next", n); } function _throw(n) { loadGlb_asyncGeneratorStep(a, r, o, _next, _throw, "throw", n); } _next(void 0); }); }; }
+function loadGlb_typeof(o) { "@babel/helpers - typeof"; return loadGlb_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; }, loadGlb_typeof(o); }
 
 
 
+/**
+ * The subset of the meshopt decoder contract `GLTFLoader` actually exercises when
+ * `decodeGltfBufferAsync` is present: it checks `supported`, then calls `decodeGltfBufferAsync`
+ * for each `EXT_meshopt_compression` buffer view (never touching `ready`/`decodeGltfBuffer`).
+ *
+ * The signature is derived from the module type again, now that
+ * `src/types/three-addons.d.ts` declares the decoder's shape directly instead of forwarding to
+ * `@types/three`'s unresolvable `export * from "meshoptimizer/decoder"` — which `skipLibCheck`
+ * swallowed, collapsing the lookup to `any`. Deriving keeps this interface and the delegation
+ * call in `createLazyMeshoptDecoder` checked against a single definition; hand-writing it here
+ * left the delegation itself unchecked, because the value it delegates to was still `any`.
+ *
+ * That definition is transcribed from three's JS, so it is an assertion about that file rather
+ * than a derivation from it: a three.js change needs the `.d.ts` updated by hand. What is
+ * compiler-enforced is that this shim and its consumers agree with it.
+ * @internal
+ */
+
+/**
+ * Builds a stand-in meshopt decoder that defers importing the real module (and instantiating its
+ * WASM) until the first `EXT_meshopt_compression` buffer actually needs decoding. GLBs without the
+ * extension never trigger the import, so the decoder stays off the critical path of the first 3D
+ * frame — it used to be part of the eager three.js import chain, delaying every scene load.
+ *
+ * `supported` mirrors the real module's own gate — it returns a bare `{ supported: false }` when
+ * `typeof WebAssembly !== "object"` — so the answer is reproduced synchronously here without
+ * importing anything. Reporting a flat `true` instead would break the platforms it claims to
+ * support: `GLTFLoader` reads `supported` before deciding to decode, and on `false` with meshopt
+ * merely OPTIONAL it returns `null` and falls back to the GLB's uncompressed buffer
+ * (`GLTFLoader.js` `GLTFMeshoptCompression.loadBufferView`). Claiming support on a WASM-less
+ * platform discards that fallback and fails the whole asset with a `TypeError` from this shim,
+ * since `decodeGltfBufferAsync` does not exist on the real module there.
+ *
+ * @param load Injectable module loader, for tests. Defaults to the cached {@link loadMeshoptDecoder}.
+ * @internal
+ */
+function createLazyMeshoptDecoder() {
+  var load = arguments.length > 0 && arguments[0] !== undefined ? arguments[0] : loadMeshoptDecoder;
+  return {
+    // Same condition the real decoder uses, evaluated without loading it.
+    supported: (typeof WebAssembly === "undefined" ? "undefined" : loadGlb_typeof(WebAssembly)) === "object",
+    decodeGltfBufferAsync: function () {
+      var _decodeGltfBufferAsync = loadGlb_asyncToGenerator(/*#__PURE__*/loadGlb_regenerator().m(function _callee(count, size, source, mode, filter) {
+        var decoder;
+        return loadGlb_regenerator().w(function (_context) {
+          while (1) switch (_context.n) {
+            case 0:
+              _context.n = 1;
+              return load();
+            case 1:
+              decoder = _context.v;
+              _context.n = 2;
+              return decoder.ready;
+            case 2:
+              return _context.a(2, decoder.decodeGltfBufferAsync(count, size, source, mode, filter));
+          }
+        }, _callee);
+      }));
+      function decodeGltfBufferAsync(_x, _x2, _x3, _x4, _x5) {
+        return _decodeGltfBufferAsync.apply(this, arguments);
+      }
+      return decodeGltfBufferAsync;
+    }()
+  };
+}
+
 /**
  * Lazily-initialized, cached GLTF loader configured with Draco + KTX2 support.
  *
  * The loaders (and their WebGLRenderer for KTX2 support detection) are heavy and pull in Three.js,
  * so they are created on first use inside the dynamic-import boundary rather than at module load.
- */
-var gltfLoaderPromise;
-function getGltfLoader() {
-  gltfLoaderPromise !== null && gltfLoaderPromise !== void 0 ? gltfLoaderPromise : gltfLoaderPromise = loadThree().then(function (mod) {
+ *
+ * Memoized through {@link memoizeImport} for the same reason the loaders in `three.ts` are: a plain
+ * `cached ??=` also caches a rejection. Fixing the three loaders was not enough, because this is a
+ * SECOND cache wrapped around `loadThree()` — so a transient failure was evicted there and then
+ * replayed from here forever, and `loadGlbRoot` awaits both, meaning every GLB kept failing with
+ * the stale error long after `loadThree()` had recovered. Not only network: the `.then` below
+ * constructs a `WebGLRenderer` for KTX2 support detection, and a failed context creation was
+ * cached just the same.
+ */
+var getGltfLoader = memoizeImport(function () {
+  return loadThree().then(function (mod) {
     var dracoLoader = new mod.DRACOLoader();
     dracoLoader.setDecoderPath(DEFAULT_DRACO_DECODER_PATH);
     var gltfLoader = new mod.GLTFLoader();
@@ -19788,15 +19907,15 @@ function getGltfLoader() {
       antialias: true
     }));
 
-    // Enable EXT_meshopt_compression so meshopt-compressed GLBs decode. The decoder is a WASM
-    // singleton; GLTFLoader awaits its `.ready` promise internally before parsing. Assets that
-    // don't use the extension are unaffected. This lets the offline pipeline pick meshopt (often
-    // smaller than Draco for the scene's meshes) without a runtime change.
-    gltfLoader.setMeshoptDecoder(mod.MeshoptDecoder);
+    // Enable EXT_meshopt_compression so meshopt-compressed GLBs decode, without paying for the
+    // decoder module up front: the lazy stand-in imports it (and instantiates its WASM) only when
+    // the first meshopt-compressed buffer is actually decoded. Assets that don't use the extension
+    // never load it. The cast is safe — with `decodeGltfBufferAsync` present, GLTFLoader touches
+    // only `supported` and `decodeGltfBufferAsync` (see LazyMeshoptDecoder).
+    gltfLoader.setMeshoptDecoder(createLazyMeshoptDecoder());
     return gltfLoader;
   });
-  return gltfLoaderPromise;
-}
+});
 
 /**
  * Default per-asset timeout for {@link loadGlbRoot}.
@@ -19861,11 +19980,11 @@ function assertGlbBufferComplete(buffer, url) {
  * @returns Root `THREE.Group` from the loaded glTF scene
  * @group Utils
  */
-function loadGlbRoot(_x) {
+function loadGlbRoot(_x6) {
   return _loadGlbRoot.apply(this, arguments);
 }
 function _loadGlbRoot() {
-  _loadGlbRoot = loadGlb_asyncToGenerator(/*#__PURE__*/loadGlb_regenerator().m(function _callee(url) {
+  _loadGlbRoot = loadGlb_asyncToGenerator(/*#__PURE__*/loadGlb_regenerator().m(function _callee2(url) {
     var options,
       _options$timeoutMs,
       timeoutMs,
@@ -19879,16 +19998,16 @@ function _loadGlbRoot() {
       load,
       timer,
       timeout,
-      _args = arguments;
-    return loadGlb_regenerator().w(function (_context) {
-      while (1) switch (_context.p = _context.n) {
+      _args2 = arguments;
+    return loadGlb_regenerator().w(function (_context2) {
+      while (1) switch (_context2.p = _context2.n) {
         case 0:
-          options = _args.length > 1 && _args[1] !== undefined ? _args[1] : {};
+          options = _args2.length > 1 && _args2[1] !== undefined ? _args2[1] : {};
           _options$timeoutMs = options.timeoutMs, timeoutMs = _options$timeoutMs === void 0 ? DEFAULT_GLB_LOAD_TIMEOUT_MS : _options$timeoutMs, onProgress = options.onProgress;
-          _context.n = 1;
+          _context2.n = 1;
           return Promise.all([getGltfLoader(), loadThree()]);
         case 1:
-          _yield$Promise$all = _context.v;
+          _yield$Promise$all = _context2.v;
           _yield$Promise$all2 = loadGlb_slicedToArray(_yield$Promise$all, 2);
           gltfLoader = _yield$Promise$all2[0];
           three = _yield$Promise$all2[1].THREE;
@@ -19922,31 +20041,31 @@ function _loadGlbRoot() {
             }, onError);
           });
           if (!(!Number.isFinite(timeoutMs) || timeoutMs <= 0)) {
-            _context.n = 5;
+            _context2.n = 5;
             break;
           }
-          _context.p = 2;
-          _context.n = 3;
+          _context2.p = 2;
+          _context2.n = 3;
           return load;
         case 3:
-          return _context.a(2, _context.v);
+          return _context2.a(2, _context2.v);
         case 4:
-          _context.p = 4;
+          _context2.p = 4;
           settled = true;
-          return _context.f(4);
+          return _context2.f(4);
         case 5:
           timeout = new Promise(function (_resolve, reject) {
             timer = setTimeout(function () {
               return reject(new Error("Timed out loading GLB after ".concat(timeoutMs, "ms: ").concat(url)));
             }, timeoutMs);
           });
-          _context.p = 6;
-          _context.n = 7;
+          _context2.p = 6;
+          _context2.n = 7;
           return Promise.race([load, timeout]);
         case 7:
-          return _context.a(2, _context.v);
+          return _context2.a(2, _context2.v);
         case 8:
-          _context.p = 8;
+          _context2.p = 8;
           settled = true;
           clearTimeout(timer);
           // Cancels the underlying fetch (and, by never delivering its buffer, the Draco/KTX2 decode)
@@ -19954,11 +20073,11 @@ function _loadGlbRoot() {
           // unattended — otherwise GLB_LOAD_CONCURRENCY only bounds how many loads the caller awaits,
           // not how many are truly in flight. A no-op if `load` already won the race.
           fileLoader.abort();
-          return _context.f(8);
+          return _context2.f(8);
         case 9:
-          return _context.a(2);
+          return _context2.a(2);
       }
-    }, _callee, null, [[6,, 8, 9], [2,, 4, 5]]);
+    }, _callee2, null, [[6,, 8, 9], [2,, 4, 5]]);
   }));
   return _loadGlbRoot.apply(this, arguments);
 }