@mapvx/web-js 3.6.0-dev.1 → 4.0.0

package/dist/cjs/utils/loadGlb.js

@@ -1,190 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.DEFAULT_GLB_LOAD_TIMEOUT_MS = void 0;
-exports.createLazyMeshoptDecoder = createLazyMeshoptDecoder;
-exports.loadGlbRoot = loadGlbRoot;
-const draco_1 = require("../config/draco");
-const three_1 = require("./three");
-/**
- * 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(load = three_1.loadMeshoptDecoder) {
-    return {
-        // Same condition the real decoder uses, evaluated without loading it.
-        supported: typeof WebAssembly === "object",
-        decodeGltfBufferAsync: async (count, size, source, mode, filter) => {
-            const decoder = await load();
-            await decoder.ready;
-            return decoder.decodeGltfBufferAsync(count, size, source, mode, filter);
-        },
-    };
-}
-/**
- * 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.
- *
- * 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.
- */
-const getGltfLoader = (0, three_1.memoizeImport)(() => (0, three_1.loadThree)().then((mod) => {
-    const dracoLoader = new mod.DRACOLoader();
-    dracoLoader.setDecoderPath(draco_1.DEFAULT_DRACO_DECODER_PATH);
-    const gltfLoader = new mod.GLTFLoader();
-    gltfLoader.setDRACOLoader(dracoLoader);
-    const ktx2Loader = new mod.KTX2Loader();
-    ktx2Loader.setTranscoderPath(draco_1.DEFAULT_KTX2_TRANSCODER_PATH);
-    gltfLoader.setKTX2Loader(ktx2Loader);
-    ktx2Loader.detectSupport(new mod.THREE.WebGLRenderer({ antialias: true }));
-    // 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;
-}));
-/**
- * Default per-asset timeout for {@link loadGlbRoot}.
- *
- * Guards against loaders that hang instead of throwing — a GLB whose binary chunk is truncated
- * (see {@link loadGlbRoot}'s completeness check) or otherwise malformed can put Three.js's
- * `DRACOLoader` into an undefined state: sometimes a decode error, sometimes no callback at all.
- * Without a timeout, one such asset never settles and blocks every other load queued behind it.
- *
- * Declarative GLB scenes can legitimately include very large assets — a client's ground-mesh
- * "Suelo" model measured at ~400 MB took ~26s to download alone on a solid connection, before any
- * 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 500 seconds, so there is no tradeoff in keeping it generous.
- *
- * @group Configuration
- */
-exports.DEFAULT_GLB_LOAD_TIMEOUT_MS = 500000;
-/**
- * Magic number ("glTF" read little-endian) at byte offset 0 of every binary glTF (`.glb`)
- * container. Used only to tell a binary GLB apart from a plain JSON `.gltf` payload — the latter
- * has no such header and skips the completeness check in {@link assertGlbBufferComplete}.
- */
-const GLB_MAGIC = 0x46546c67;
-/**
- * Rejects a GLB download that was cut short before it reaches Three.js's `GLTFLoader`/`DRACOLoader`,
- * whose behavior on truncated input ranges from a cryptic decode error (e.g. "Unexpected geometry
- * type") to an outright hang, rather than a clear message pointing at the actual problem.
- *
- * The binary glTF container format requires the 12-byte header's declared total length to equal
- * the file's real byte length (see the {@link https://registry.khronos.org/glTF/specs/2.0/glTF-2.0.html#binary-header | spec}).
- * A mismatch means the response body was truncated — a dropped connection, or the object stored at
- * `url` is itself incomplete — so every buffer-view offset past that point reads garbage. This is
- * exactly what was found in the field for one "Suelo" asset that both threw a decode error and (in
- * a larger sibling file) hung: the file's own header declared a ~383 MB binary chunk while only
- * ~8.7 MB had actually been received.
- */
-function assertGlbBufferComplete(buffer, url) {
-    if (buffer.byteLength < 12)
-        return; // too short to have a GLB header; let parse() report it
-    const header = new DataView(buffer, 0, 12);
-    if (header.getUint32(0, true) !== GLB_MAGIC)
-        return; // plain JSON .gltf, not a binary .glb
-    const declaredLength = header.getUint32(8, true);
-    if (declaredLength !== buffer.byteLength) {
-        throw new Error(`GLB download is truncated or corrupt: header declares ${declaredLength} bytes, received ${buffer.byteLength}: ${url}`);
-    }
-}
-/**
- * Loads a GLB/GLTF from URL and returns the root scene group.
- * Central entry point so the loader implementation can be swapped later (e.g. Draco, KTX2, custom fetch).
- *
- * Fetches the raw bytes itself (rather than deferring to `GLTFLoader.load`) so a truncated download
- * can be caught and rejected clearly — see {@link assertGlbBufferComplete} — before it ever reaches
- * the Draco/KTX2 decoders.
- *
- * @param url - GLB URL
- * @returns Root `THREE.Group` from the loaded glTF scene
- * @group Utils
- */
-async function loadGlbRoot(url, options = {}) {
-    const { timeoutMs = exports.DEFAULT_GLB_LOAD_TIMEOUT_MS, onProgress } = options;
-    const [gltfLoader, { THREE: three }] = await Promise.all([getGltfLoader(), (0, three_1.loadThree)()]);
-    // Set once the caller has stopped waiting (success, failure, or timeout) so any callback three
-    // fires afterwards — e.g. a timed-out fetch/decode that keeps running in the background — is a
-    // no-op instead of resolving/rejecting an already-settled promise or emitting a stray progress
-    // event after the batch this asset belongs to already reported `done: true`.
-    let settled = false;
-    const fileLoader = new three.FileLoader();
-    fileLoader.setResponseType("arraybuffer");
-    const load = new Promise((resolve, reject) => {
-        const onError = (error) => {
-            if (settled)
-                return;
-            reject(error instanceof Error ? error : new Error(String(error)));
-        };
-        fileLoader.load(url, (data) => {
-            if (settled)
-                return;
-            const buffer = data;
-            try {
-                assertGlbBufferComplete(buffer, url);
-            }
-            catch (err) {
-                onError(err);
-                return;
-            }
-            gltfLoader.parse(buffer, three.LoaderUtils.extractUrlBase(url), (gltf) => {
-                if (settled)
-                    return;
-                resolve(gltf.scene);
-            }, onError);
-        }, (event) => {
-            if (!settled)
-                onProgress === null || onProgress === void 0 ? void 0 : onProgress(event);
-        }, onError);
-    });
-    if (!Number.isFinite(timeoutMs) || timeoutMs <= 0) {
-        try {
-            return await load;
-        }
-        finally {
-            settled = true;
-        }
-    }
-    let timer;
-    const timeout = new Promise((_resolve, reject) => {
-        timer = setTimeout(() => reject(new Error(`Timed out loading GLB after ${timeoutMs}ms: ${url}`)), timeoutMs);
-    });
-    try {
-        return await Promise.race([load, timeout]);
-    }
-    finally {
-        settled = true;
-        clearTimeout(timer);
-        // Cancels the underlying fetch (and, by never delivering its buffer, the Draco/KTX2 decode)
-        // so a timed-out asset actually frees its network/CPU usage instead of running to completion
-        // 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();
-    }
-}
-//# sourceMappingURL=loadGlb.js.map

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

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

package/dist/cjs/utils/mapvxHostname.js

@@ -1,21 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.isMapVxRequestHostname = isMapVxRequestHostname;
-/**
- * Returns whether a URL hostname is part of the MapVX API domain tree.
- * Matches `mapvx.com` and `mapvx.dev` plus any subdomain (`api.mapvx.com`,
- * `public-api.mapvx.com`, `api.mapvx.dev`, `portal.mapvx.dev`, etc.).
- * Does not match lookalike domains (e.g. `notmapvx.com`).
- *
- * @param hostname - Value from `URL.hostname` (no port)
- * @returns True if context headers should be attached for this host
- * @group Utils
- */
-function isMapVxRequestHostname(hostname) {
-    const h = hostname.trim().toLowerCase();
-    if (!h) {
-        return false;
-    }
-    return /^(?:[a-z0-9-]+\.)*mapvx\.(?:com|dev)$/.test(h);
-}
-//# sourceMappingURL=mapvxHostname.js.map

package/dist/cjs/utils/mapvxHostname.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"mapvxHostname.js","sourceRoot":"","sources":["../../../src/utils/mapvxHostname.ts"],"names":[],"mappings":";;AAUA,wDAMC;AAhBD;;;;;;;;;GASG;AACH,SAAgB,sBAAsB,CAAC,QAAgB;IACrD,MAAM,CAAC,GAAG,QAAQ,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAA;IACvC,IAAI,CAAC,CAAC,EAAE,CAAC;QACP,OAAO,KAAK,CAAA;IACd,CAAC;IACD,OAAO,uCAAuC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;AACxD,CAAC"}

package/dist/cjs/utils/nav-functions.js

@@ -1,150 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.NavFunctions = void 0;
-exports.toRadians = toRadians;
-exports.toDegrees = toDegrees;
-exports.compareLatLng = compareLatLng;
-const { asin, atan2, cos, sin, pow, sqrt, PI } = Math;
-/**
- * Return the haversine of a number.
- * Haversine formula is a formula that calculates the distance
- * between two points on a sphere given their longitudes and latitudes.
- * @group Utils
- * @see [Haversine Formula](https://en.wikipedia.org/wiki/Haversine_formula)
- * @param angle A numeric expression that contains an angle measured in radians.
- * @returns
- */
-function hav(angle) {
-    return sin(angle / 2) * sin(angle / 2);
-}
-/**
- * Converts an angle from degrees to radians.
- * @group Utils
- * @param degrees - The angle in degrees.
- * @returns The angle converted to radians.
- */
-function toRadians(degrees) {
-    return degrees * (PI / 180);
-}
-/**
- * Converts an angle from radians to degrees.
- * @group Utils
- * @param radians - The angle in radians.
- * @returns The angle converted to degrees.
- */
-function toDegrees(radians) {
-    return radians * (180 / PI);
-}
-/**
- * Compare two geographic points.
- * @group Utils
- * @param location - The first point.
- * @param otherLocation - The second point.
- * @returns True if the points are the same, false otherwise.
- */
-function compareLatLng(location, otherLocation) {
-    return location.lat === otherLocation.lat && location.lng === otherLocation.lng;
-}
-/**
- * NavFunctions is a class that contains static methods to calculate distances and angles between geographic points.
- * @group Utils
- */
-class NavFunctions {
-    /**
-     * Calculate the distance between two geographic points using the haversine formula.
-     *
-     * @see [Haversine Formula](https://en.wikipedia.org/wiki/Haversine_formula)
-     *
-     * @param pointA A geographic point.
-     * @param pointB Another geographic point.
-     * @returns The distance between the two points.
-     */
-    static distance(pointA, pointB) {
-        const radLatA = toRadians(pointA.lat);
-        const radLatB = toRadians(pointB.lat);
-        const radLongA = toRadians(pointA.lng);
-        const radLongB = toRadians(pointB.lng);
-        const deltaLat = radLatB - radLatA;
-        const deltaLng = radLongB - radLongA;
-        const haversine = hav(deltaLat) + cos(radLatA) * cos(radLatB) * hav(deltaLng);
-        return 2 * NavFunctions.EARTH_RADIUS * asin(sqrt(haversine));
-    }
-    /**
-     *
-     * @param pointA
-     * @param pointB
-     * @param fraction A number between 0 to 1, 0 and 1 inclusive.
-     * @returns
-     */
-    static intermediatePointBetween(pointA, pointB, fraction) {
-        const radLatA = toRadians(pointA.lat);
-        const radLatB = toRadians(pointB.lat);
-        const radLongA = toRadians(pointA.lng);
-        const radLongB = toRadians(pointB.lng);
-        const angDistance = NavFunctions.distance(pointA, pointB) / NavFunctions.EARTH_RADIUS;
-        const a = sin((1 - fraction) * angDistance) / sin(angDistance);
-        const b = sin(fraction * angDistance) / sin(angDistance);
-        const x = a * cos(radLatA) * cos(radLongA) + b * cos(radLatB) * cos(radLongB);
-        const y = a * cos(radLatA) * sin(radLongA) + b * cos(radLatB) * sin(radLongB);
-        const z = a * sin(radLatA) + b * sin(radLatB);
-        const radLat = atan2(z, sqrt(pow(x, 2) + pow(y, 2)));
-        const radLong = atan2(y, x);
-        const lat = toDegrees(radLat);
-        const lng = toDegrees(radLong);
-        return {
-            lat: lat,
-            lng: lng,
-        };
-    }
-    /**
-     * Calculate the angle of a line between two points.
-     * Relative to NORTH in positive degrees: 0 N, 90 E, 180 S, 270 O
-     * @param source The initial point
-     * @param destination The final
-     * @returns
-     */
-    static bearingInDegBetween(source, destination) {
-        const inRad = NavFunctions.bearingInRadBetween(source, destination);
-        return toDegrees(inRad);
-    }
-    /**
-     * Calculate the bearing between two points in radians.
-     * @param source The initial point.
-     * @param destination The final point.
-     * @returns The bearing in radians.
-     */
-    static bearingInRadBetween(source, destination) {
-        const x = destination.lng - source.lng;
-        const y = destination.lat - source.lat;
-        return (PI / 2 - atan2(y, x) + 2 * PI) % (2 * PI);
-    }
-    /**
-     * Calculate an intermediate angle between two given angles based on a specific fraction.
-     * The function returns an angle that is a certain fraction of the shortest arc between the initial and final angles.
-     *
-     * @remarks
-     *
-     * If the fraction is 0, the function returns the initial angle.
-     *
-     * If the fraction is 1, it returns the final angle.
-     *
-     * For fractions in between, it returns an angle that is a proportional distance between the two angles along the shortest arc.
-     *
-     * @param initialAngle The starting angle specified in degrees.
-     * @param finalAngle The ending angle specified in degrees.
-     * @param fraction A decimal value ranging from 0 to 1 indicating the fraction of the distance between the initial and final angles.
-     * @returns The calculated intermediate angle in degrees, within the range `[0, 360[`.
-     */
-    static intermediateAngleBetween(initialAngle, finalAngle, fraction) {
-        let delta = ((finalAngle - initialAngle + 180) % 360) - 180;
-        if (delta < -180)
-            delta += 360;
-        return (initialAngle + 360 + delta * fraction) % 360;
-    }
-}
-exports.NavFunctions = NavFunctions;
-/**
- * The radius of the Earth in meters.
- */
-NavFunctions.EARTH_RADIUS = 6378000;
-//# sourceMappingURL=nav-functions.js.map

package/dist/cjs/utils/nav-functions.js.map

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