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

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

@@ -1 +1 @@
-{"version":3,"file":"loadGlb.js","sourceRoot":"","sources":["../../../src/utils/loadGlb.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"loadGlb.js","sourceRoot":"","sources":["../../../src/utils/loadGlb.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,0BAA0B,EAAE,4BAA4B,EAAE,MAAM,iBAAiB,CAAA;AAC1F,OAAO,EAAE,kBAAkB,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AAwBtE;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,wBAAwB,CACtC,OAA6C,kBAAkB;IAE/D,OAAO;QACL,sEAAsE;QACtE,SAAS,EAAE,OAAO,WAAW,KAAK,QAAQ;QAC1C,qBAAqB,EAAE,KAAK,EAC1B,KAAa,EACb,IAAY,EACZ,MAAkB,EAClB,IAAY,EACZ,MAAe,EACf,EAAE;YACF,MAAM,OAAO,GAAG,MAAM,IAAI,EAAE,CAAA;YAC5B,MAAM,OAAO,CAAC,KAAK,CAAA;YACnB,OAAO,OAAO,CAAC,qBAAqB,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,CAAA;QACzE,CAAC;KACF,CAAA;AACH,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,aAAa,GAAG,aAAa,CAAC,GAAG,EAAE,CACvC,SAAS,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE;IACvB,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,WAAW,EAAE,CAAA;IACzC,WAAW,CAAC,cAAc,CAAC,0BAA0B,CAAC,CAAA;IAEtD,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,UAAU,EAAE,CAAA;IACvC,UAAU,CAAC,cAAc,CAAC,WAAW,CAAC,CAAA;IAEtC,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,UAAU,EAAE,CAAA;IACvC,UAAU,CAAC,iBAAiB,CAAC,4BAA4B,CAAC,CAAA;IAC1D,UAAU,CAAC,aAAa,CAAC,UAAU,CAAC,CAAA;IACpC,UAAU,CAAC,aAAa,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,aAAa,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;IAE1E,2FAA2F;IAC3F,8FAA8F;IAC9F,+FAA+F;IAC/F,6FAA6F;IAC7F,yEAAyE;IACzE,UAAU,CAAC,iBAAiB,CAAC,wBAAwB,EAAsC,CAAC,CAAA;IAE5F,OAAO,UAAU,CAAA;AACnB,CAAC,CAAC,CACH,CAAA;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,CAAC,MAAM,2BAA2B,GAAG,MAAO,CAAA;AAElD;;;;GAIG;AACH,MAAM,SAAS,GAAG,UAAU,CAAA;AAE5B;;;;;;;;;;;;GAYG;AACH,SAAS,uBAAuB,CAAC,MAAmB,EAAE,GAAW;IAC/D,IAAI,MAAM,CAAC,UAAU,GAAG,EAAE;QAAE,OAAM,CAAC,wDAAwD;IAC3F,MAAM,MAAM,GAAG,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC,CAAA;IAC1C,IAAI,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,SAAS;QAAE,OAAM,CAAC,sCAAsC;IAC1F,MAAM,cAAc,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,EAAE,IAAI,CAAC,CAAA;IAChD,IAAI,cAAc,KAAK,MAAM,CAAC,UAAU,EAAE,CAAC;QACzC,MAAM,IAAI,KAAK,CACb,yDAAyD,cAAc,oBAAoB,MAAM,CAAC,UAAU,KAAK,GAAG,EAAE,CACvH,CAAA;IACH,CAAC;AACH,CAAC;AAoBD;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,GAAW,EACX,UAA8B,EAAE;IAEhC,MAAM,EAAE,SAAS,GAAG,2BAA2B,EAAE,UAAU,EAAE,GAAG,OAAO,CAAA;IACvE,MAAM,CAAC,UAAU,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,CAAC,aAAa,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,CAAA;IAExF,+FAA+F;IAC/F,+FAA+F;IAC/F,+FAA+F;IAC/F,6EAA6E;IAC7E,IAAI,OAAO,GAAG,KAAK,CAAA;IACnB,MAAM,UAAU,GAAG,IAAI,KAAK,CAAC,UAAU,EAAE,CAAA;IACzC,UAAU,CAAC,eAAe,CAAC,aAAa,CAAC,CAAA;IAEzC,MAAM,IAAI,GAAG,IAAI,OAAO,CAAc,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACxD,MAAM,OAAO,GAAG,CAAC,KAAc,EAAE,EAAE;YACjC,IAAI,OAAO;gBAAE,OAAM;YACnB,MAAM,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;QACnE,CAAC,CAAA;QAED,UAAU,CAAC,IAAI,CACb,GAAG,EACH,CAAC,IAA0B,EAAE,EAAE;YAC7B,IAAI,OAAO;gBAAE,OAAM;YACnB,MAAM,MAAM,GAAG,IAAmB,CAAA;YAClC,IAAI,CAAC;gBACH,uBAAuB,CAAC,MAAM,EAAE,GAAG,CAAC,CAAA;YACtC,CAAC;YAAC,OAAO,GAAG,EAAE,CAAC;gBACb,OAAO,CAAC,GAAG,CAAC,CAAA;gBACZ,OAAM;YACR,CAAC;YACD,UAAU,CAAC,KAAK,CACd,MAAM,EACN,KAAK,CAAC,WAAW,CAAC,cAAc,CAAC,GAAG,CAAC,EACrC,CAAC,IAAU,EAAE,EAAE;gBACb,IAAI,OAAO;oBAAE,OAAM;gBACnB,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;YACrB,CAAC,EACD,OAAO,CACR,CAAA;QACH,CAAC,EACD,CAAC,KAAoB,EAAE,EAAE;YACvB,IAAI,CAAC,OAAO;gBAAE,UAAU,aAAV,UAAU,uBAAV,UAAU,CAAG,KAAK,CAAC,CAAA;QACnC,CAAC,EACD,OAAO,CACR,CAAA;IACH,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;QAClD,IAAI,CAAC;YACH,OAAO,MAAM,IAAI,CAAA;QACnB,CAAC;gBAAS,CAAC;YACT,OAAO,GAAG,IAAI,CAAA;QAChB,CAAC;IACH,CAAC;IAED,IAAI,KAAgD,CAAA;IACpD,MAAM,OAAO,GAAG,IAAI,OAAO,CAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE;QACtD,KAAK,GAAG,UAAU,CAChB,GAAG,EAAE,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,+BAA+B,SAAS,OAAO,GAAG,EAAE,CAAC,CAAC,EAC7E,SAAS,CACV,CAAA;IACH,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC;QACH,OAAO,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC,CAAA;IAC5C,CAAC;YAAS,CAAC;QACT,OAAO,GAAG,IAAI,CAAA;QACd,YAAY,CAAC,KAAK,CAAC,CAAA;QACnB,4FAA4F;QAC5F,6FAA6F;QAC7F,4FAA4F;QAC5F,4EAA4E;QAC5E,UAAU,CAAC,KAAK,EAAE,CAAA;IACpB,CAAC;AACH,CAAC"}

package/dist/es/utils/three.d.ts

@@ -31,12 +31,6 @@ export interface ThreeModule {
     GLTFLoader: typeof GLTFLoader;
     DRACOLoader: typeof DRACOLoader;
     KTX2Loader: typeof KTX2Loader;
-    /**
-     * The singleton meshopt decoder. Wired into the GLB loader so assets compressed with
-     * `EXT_meshopt_compression` (a much stronger geometry/vertex compressor than Draco for many
-     * meshes) decode instead of failing. See {@link getGltfLoader} in `loadGlb.ts`.
-     */
-    MeshoptDecoder: typeof MeshoptDecoder;
 }
 /** Runtime handle to the deck.gl classes used by the 3D scene. */
 export interface DeckModule {
@@ -46,13 +40,48 @@ export interface DeckModule {
     PathLayer: typeof import("@deck.gl/layers").PathLayer;
     TextLayer: typeof import("@deck.gl/layers").TextLayer;
 }
+/**
+ * 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
+ */
+export declare function memoizeImport<T>(load: () => Promise<T>): () => Promise<T>;
 /**
  * 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}.
+ */
+export declare const loadThree: () => Promise<ThreeModule>;
+/**
+ * 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.
  */
-export declare function loadThree(): Promise<ThreeModule>;
+export declare const loadMeshoptDecoder: () => Promise<typeof MeshoptDecoder>;
 /**
  * Dynamically imports the deck.gl overlay and layer classes once and caches the result.
+ * A failed import is not cached — see {@link memoizeImport}.
  */
-export declare function loadDeck(): Promise<DeckModule>;
+export declare const loadDeck: () => Promise<DeckModule>;
 //# sourceMappingURL=three.d.ts.map

package/dist/es/utils/three.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"three.d.ts","sourceRoot":"","sources":["../../../src/utils/three.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qCAAqC,CAAA;AACtE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAA;AACpE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAA;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6CAA6C,CAAA;AAEjF,+DAA+D;AAC/D,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,cAAc,OAAO,CAAC,CAAA;IAC7B,UAAU,EAAE,OAAO,UAAU,CAAA;IAC7B,WAAW,EAAE,OAAO,WAAW,CAAA;IAC/B,UAAU,EAAE,OAAO,UAAU,CAAA;IAC7B;;;;OAIG;IACH,cAAc,EAAE,OAAO,cAAc,CAAA;CACtC;AAED,kEAAkE;AAClE,MAAM,WAAW,UAAU;IACzB,aAAa,EAAE,cAAc,iBAAiB,EAAE,aAAa,CAAA;IAC7D,QAAQ,EAAE,cAAc,qBAAqB,EAAE,QAAQ,CAAA;IACvD,SAAS,EAAE,cAAc,iBAAiB,EAAE,SAAS,CAAA;IACrD,SAAS,EAAE,cAAc,iBAAiB,EAAE,SAAS,CAAA;IACrD,SAAS,EAAE,cAAc,iBAAiB,EAAE,SAAS,CAAA;CACtD;AAKD;;;GAGG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAAC,WAAW,CAAC,CAehD;AAED;;GAEG;AACH,wBAAgB,QAAQ,IAAI,OAAO,CAAC,UAAU,CAAC,CAa9C"}
+{"version":3,"file":"three.d.ts","sourceRoot":"","sources":["../../../src/utils/three.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qCAAqC,CAAA;AACtE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAA;AACpE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAA;AACpE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,6CAA6C,CAAA;AAEjF,+DAA+D;AAC/D,MAAM,WAAW,WAAW;IAC1B,KAAK,EAAE,cAAc,OAAO,CAAC,CAAA;IAC7B,UAAU,EAAE,OAAO,UAAU,CAAA;IAC7B,WAAW,EAAE,OAAO,WAAW,CAAA;IAC/B,UAAU,EAAE,OAAO,UAAU,CAAA;CAC9B;AAED,kEAAkE;AAClE,MAAM,WAAW,UAAU;IACzB,aAAa,EAAE,cAAc,iBAAiB,EAAE,aAAa,CAAA;IAC7D,QAAQ,EAAE,cAAc,qBAAqB,EAAE,QAAQ,CAAA;IACvD,SAAS,EAAE,cAAc,iBAAiB,EAAE,SAAS,CAAA;IACrD,SAAS,EAAE,cAAc,iBAAiB,EAAE,SAAS,CAAA;IACrD,SAAS,EAAE,cAAc,iBAAiB,EAAE,SAAS,CAAA;CACtD;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,aAAa,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,MAAM,OAAO,CAAC,CAAC,CAAC,CAWzE;AAED;;;;GAIG;AACH,eAAO,MAAM,SAAS,EAAE,MAAM,OAAO,CAAC,WAAW,CAYhD,CAAA;AAED;;;;;;;;;;GAUG;AACH,eAAO,MAAM,kBAAkB,EAAE,MAAM,OAAO,CAAC,OAAO,cAAc,CAEnE,CAAA;AAED;;;GAGG;AACH,eAAO,MAAM,QAAQ,EAAE,MAAM,OAAO,CAAC,UAAU,CAY9C,CAAA"}

package/dist/es/utils/three.js

@@ -1,40 +1,76 @@
-let threePromise;
-let 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
+ */
+export function memoizeImport(load) {
+    let cached;
+    return () => {
+        cached !== null && cached !== void 0 ? cached : (cached = load().catch((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}.
  */
-export function loadThree() {
-    threePromise !== null && threePromise !== void 0 ? threePromise : (threePromise = Promise.all([
-        import("three"),
-        import("three/addons/loaders/GLTFLoader.js"),
-        import("three/addons/loaders/DRACOLoader.js"),
-        import("three/addons/loaders/KTX2Loader.js"),
-        import("three/addons/libs/meshopt_decoder.module.js"),
-    ]).then(([three, gltf, draco, ktx2, meshopt]) => ({
-        THREE: three,
-        GLTFLoader: gltf.GLTFLoader,
-        DRACOLoader: draco.DRACOLoader,
-        KTX2Loader: ktx2.KTX2Loader,
-        MeshoptDecoder: meshopt.MeshoptDecoder,
-    })));
-    return threePromise;
-}
+export const loadThree = memoizeImport(() => Promise.all([
+    import("three"),
+    import("three/addons/loaders/GLTFLoader.js"),
+    import("three/addons/loaders/DRACOLoader.js"),
+    import("three/addons/loaders/KTX2Loader.js"),
+]).then(([three, gltf, draco, ktx2]) => ({
+    THREE: three,
+    GLTFLoader: gltf.GLTFLoader,
+    DRACOLoader: draco.DRACOLoader,
+    KTX2Loader: ktx2.KTX2Loader,
+})));
+/**
+ * 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.
+ */
+export const loadMeshoptDecoder = memoizeImport(() => import("three/addons/libs/meshopt_decoder.module.js").then((meshopt) => 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}.
  */
-export function loadDeck() {
-    deckPromise !== null && deckPromise !== void 0 ? deckPromise : (deckPromise = Promise.all([
-        import("@deck.gl/mapbox"),
-        import("@deck.gl/geo-layers"),
-        import("@deck.gl/layers"),
-    ]).then(([mapbox, geoLayers, layers]) => ({
-        MapboxOverlay: mapbox.MapboxOverlay,
-        MVTLayer: geoLayers.MVTLayer,
-        IconLayer: layers.IconLayer,
-        PathLayer: layers.PathLayer,
-        TextLayer: layers.TextLayer,
-    })));
-    return deckPromise;
-}
+export const loadDeck = memoizeImport(() => Promise.all([
+    import("@deck.gl/mapbox"),
+    import("@deck.gl/geo-layers"),
+    import("@deck.gl/layers"),
+]).then(([mapbox, geoLayers, layers]) => ({
+    MapboxOverlay: mapbox.MapboxOverlay,
+    MVTLayer: geoLayers.MVTLayer,
+    IconLayer: layers.IconLayer,
+    PathLayer: layers.PathLayer,
+    TextLayer: layers.TextLayer,
+})));
 //# sourceMappingURL=three.js.map

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"}