@mapvx/web-js 1.8.0 → 2.0.0-dev.2

package/dist/es/utils/3d.js.map

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

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

@@ -0,0 +1,51 @@
+import type { Feature } from "geojson";
+import type { SpriteIconData } from "../domain/models/scene3D";
+/**
+ * Pure data builders for the deck.gl indoor overlay sublayers.
+ *
+ * These functions contain the feature-filtering and coordinate/height mapping logic used inside the
+ * deck.gl `renderSubLayers` callbacks in {@link InternalMapVXMap}. They are kept free of any deck.gl
+ * / WebGL imports so the logic is unit-testable without a GL context.
+ *
+ * @group Utils
+ */
+/** Extracts polygon coordinate rings from a GeoJSON geometry (Polygon or MultiPolygon). */
+export declare function extractPolygonRings(geom: Feature["geometry"]): number[][][][];
+export interface ElevatedPathDatum {
+    path: number[][];
+}
+/**
+ * Builds elevated room-outline paths from indoor "room" features on the given floor.
+ * Each ring is lifted to `z` (feature `height` when present, otherwise `defaultHeight`).
+ */
+export declare function buildElevatedPaths(features: Feature[], floorKey: string, defaultHeight: number): ElevatedPathDatum[];
+export interface LabelDatum {
+    position: number[];
+    text: string;
+}
+/**
+ * Builds indoor label text data from `area_name` / `poi` point features on the given floor.
+ * A feature is skipped when a matching `logo-{name}` sprite exists (icon takes priority over text).
+ */
+export declare function buildLabelData(features: Feature[], floorKey: string, hasImage: (imageId: string) => boolean, defaultHeight: number): LabelDatum[];
+/** Resolves the POI icon id from a feature's `tags` and `subclass`. */
+export declare function resolvePoiIcon(tags: string, subclass: string): string;
+export interface PoiIconDatum {
+    position: number[];
+    icon: string;
+}
+/** Builds POI icon data (elevators / toilets) from point features on the given floor. */
+export declare function buildPoiIconData(features: Feature[], floorKey: string, defaultHeight: number): PoiIconDatum[];
+export interface StoreLogoDatum {
+    position: number[];
+    icon: string;
+    rotation: number;
+}
+/** Builds store-logo icon data from point features that have a matching `logo-{name}` sprite. */
+export declare function buildStoreLogoData(features: Feature[], floorKey: string, spriteMapping: Record<string, SpriteIconData>, defaultHeight: number): StoreLogoDatum[];
+/**
+ * Computes the display size for a store-logo icon from its sprite dimensions and an optional
+ * per-logo scale factor. Returns a fallback of `10` when the icon is missing from the sprite atlas.
+ */
+export declare function computeStoreLogoSize(mapping: Record<string, SpriteIconData>, icon: string, logoScale: Record<string, number>): number;
+//# sourceMappingURL=deckLayers.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"deckLayers.d.ts","sourceRoot":"","sources":["../../../src/utils/deckLayers.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAS,MAAM,SAAS,CAAA;AAC7C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAA;AAE9D;;;;;;;;GAQG;AAEH,2FAA2F;AAC3F,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,OAAO,CAAC,UAAU,CAAC,GAAG,MAAM,EAAE,EAAE,EAAE,EAAE,CAQ7E;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,MAAM,EAAE,EAAE,CAAA;CACjB;AAED;;;GAGG;AACH,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,OAAO,EAAE,EACnB,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,GACpB,iBAAiB,EAAE,CAiBrB;AAED,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,IAAI,EAAE,MAAM,CAAA;CACb;AAED;;;GAGG;AACH,wBAAgB,cAAc,CAC5B,QAAQ,EAAE,OAAO,EAAE,EACnB,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,OAAO,EACtC,aAAa,EAAE,MAAM,GACpB,UAAU,EAAE,CAkBd;AAED,uEAAuE;AACvE,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,MAAM,CAIrE;AAED,MAAM,WAAW,YAAY;IAC3B,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,IAAI,EAAE,MAAM,CAAA;CACb;AAED,yFAAyF;AACzF,wBAAgB,gBAAgB,CAC9B,QAAQ,EAAE,OAAO,EAAE,EACnB,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,GACpB,YAAY,EAAE,CAehB;AAED,MAAM,WAAW,cAAc;IAC7B,QAAQ,EAAE,MAAM,EAAE,CAAA;IAClB,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,iGAAiG;AACjG,wBAAgB,kBAAkB,CAChC,QAAQ,EAAE,OAAO,EAAE,EACnB,QAAQ,EAAE,MAAM,EAChB,aAAa,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,EAC7C,aAAa,EAAE,MAAM,GACpB,cAAc,EAAE,CAoBlB;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CAAC,EACvC,IAAI,EAAE,MAAM,EACZ,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAChC,MAAM,CAQR"}

package/dist/es/utils/deckLayers.js

@@ -0,0 +1,144 @@
+/**
+ * Pure data builders for the deck.gl indoor overlay sublayers.
+ *
+ * These functions contain the feature-filtering and coordinate/height mapping logic used inside the
+ * deck.gl `renderSubLayers` callbacks in {@link InternalMapVXMap}. They are kept free of any deck.gl
+ * / WebGL imports so the logic is unit-testable without a GL context.
+ *
+ * @group Utils
+ */
+/** Extracts polygon coordinate rings from a GeoJSON geometry (Polygon or MultiPolygon). */
+export function extractPolygonRings(geom) {
+    if (geom.type === "Polygon") {
+        return [geom.coordinates];
+    }
+    if (geom.type === "MultiPolygon") {
+        return geom.coordinates;
+    }
+    return [];
+}
+/**
+ * Builds elevated room-outline paths from indoor "room" features on the given floor.
+ * Each ring is lifted to `z` (feature `height` when present, otherwise `defaultHeight`).
+ */
+export function buildElevatedPaths(features, floorKey, defaultHeight) {
+    var _a;
+    const rooms = features.filter((f) => {
+        var _a, _b, _c;
+        return ((_a = f.properties) === null || _a === void 0 ? void 0 : _a.class) === "room" &&
+            ((_b = f.properties) === null || _b === void 0 ? void 0 : _b.subclass) !== "empty" &&
+            ((_c = f.properties) === null || _c === void 0 ? void 0 : _c.floor_key) === floorKey;
+    });
+    const paths = [];
+    for (const f of rooms) {
+        const z = ((_a = f.properties) === null || _a === void 0 ? void 0 : _a.height) ? Number(f.properties.height) : defaultHeight;
+        for (const rings of extractPolygonRings(f.geometry)) {
+            for (const ring of rings) {
+                paths.push({ path: ring.map(([lon, lat]) => [lon, lat, z]) });
+            }
+        }
+    }
+    return paths;
+}
+/**
+ * Builds indoor label text data from `area_name` / `poi` point features on the given floor.
+ * A feature is skipped when a matching `logo-{name}` sprite exists (icon takes priority over text).
+ */
+export function buildLabelData(features, floorKey, hasImage, defaultHeight) {
+    const labelFeatures = features.filter((f) => {
+        var _a, _b, _c, _d, _e, _f;
+        if (((_a = f.properties) === null || _a === void 0 ? void 0 : _a.layerName) !== "area_name" && ((_b = f.properties) === null || _b === void 0 ? void 0 : _b.layerName) !== "poi")
+            return false;
+        if (((_c = f.geometry) === null || _c === void 0 ? void 0 : _c.type) !== "Point")
+            return false;
+        const name = ((_d = f.properties) === null || _d === void 0 ? void 0 : _d["name:latin"]) || ((_e = f.properties) === null || _e === void 0 ? void 0 : _e.name);
+        if (!name)
+            return false;
+        if (((_f = f.properties) === null || _f === void 0 ? void 0 : _f.floor_key) && f.properties.floor_key !== floorKey)
+            return false;
+        if (hasImage("logo-" + name))
+            return false; // icon has priority
+        return true;
+    });
+    return labelFeatures.map((f) => {
+        var _a, _b, _c;
+        return ({
+            position: [
+                ...f.geometry.coordinates.slice(0, 2),
+                ((_a = f.properties) === null || _a === void 0 ? void 0 : _a.height) ? Number(f.properties.height) : defaultHeight,
+            ],
+            text: ((_b = f.properties) === null || _b === void 0 ? void 0 : _b["name:latin"]) || ((_c = f.properties) === null || _c === void 0 ? void 0 : _c.name) || "",
+        });
+    });
+}
+/** Resolves the POI icon id from a feature's `tags` and `subclass`. */
+export function resolvePoiIcon(tags, subclass) {
+    if (tags.includes("wheelchair"))
+        return "accessible_toilets";
+    if (tags.includes("changing_table"))
+        return "changing_table";
+    return subclass;
+}
+/** Builds POI icon data (elevators / toilets) from point features on the given floor. */
+export function buildPoiIconData(features, floorKey, defaultHeight) {
+    const poi = features.filter((f) => {
+        var _a, _b, _c;
+        if (((_a = f.geometry) === null || _a === void 0 ? void 0 : _a.type) !== "Point")
+            return false;
+        if (((_b = f.properties) === null || _b === void 0 ? void 0 : _b.floor_key) && f.properties.floor_key !== floorKey)
+            return false;
+        const sub = (_c = f.properties) === null || _c === void 0 ? void 0 : _c.subclass;
+        return sub === "elevator" || sub === "toilets";
+    });
+    return poi.map((f) => {
+        var _a, _b, _c;
+        return ({
+            position: [
+                ...f.geometry.coordinates.slice(0, 2),
+                ((_a = f.properties) === null || _a === void 0 ? void 0 : _a.height) ? Number(f.properties.height) : defaultHeight,
+            ],
+            icon: resolvePoiIcon(((_b = f.properties) === null || _b === void 0 ? void 0 : _b.tags) || "", ((_c = f.properties) === null || _c === void 0 ? void 0 : _c.subclass) || ""),
+        });
+    });
+}
+/** Builds store-logo icon data from point features that have a matching `logo-{name}` sprite. */
+export function buildStoreLogoData(features, floorKey, spriteMapping, defaultHeight) {
+    const logos = features.filter((f) => {
+        var _a, _b, _c;
+        if (((_a = f.geometry) === null || _a === void 0 ? void 0 : _a.type) !== "Point")
+            return false;
+        if (((_b = f.properties) === null || _b === void 0 ? void 0 : _b.floor_key) && f.properties.floor_key !== floorKey)
+            return false;
+        const name = (_c = f.properties) === null || _c === void 0 ? void 0 : _c.name;
+        if (!name)
+            return false;
+        return !!spriteMapping["logo-" + name];
+    });
+    return logos.map((f) => {
+        var _a, _b, _c;
+        const name = (_a = f.properties) === null || _a === void 0 ? void 0 : _a.name;
+        return {
+            position: [
+                ...f.geometry.coordinates.slice(0, 2),
+                ((_b = f.properties) === null || _b === void 0 ? void 0 : _b.height) ? Number(f.properties.height) : defaultHeight,
+            ],
+            icon: "logo-" + name,
+            rotation: ((_c = f.properties) === null || _c === void 0 ? void 0 : _c.rotation_icon) ? Number(f.properties.rotation_icon) : 0,
+        };
+    });
+}
+/**
+ * Computes the display size for a store-logo icon from its sprite dimensions and an optional
+ * per-logo scale factor. Returns a fallback of `10` when the icon is missing from the sprite atlas.
+ */
+export function computeStoreLogoSize(mapping, icon, logoScale) {
+    const m = mapping[icon];
+    if (!m)
+        return 10;
+    const pr = m.pixelRatio;
+    const w = m.width / pr;
+    const h = m.height / pr;
+    const base = 10 * (h / Math.max(w, h));
+    return base * (logoScale[icon] || 1);
+}
+//# sourceMappingURL=deckLayers.js.map

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

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

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

@@ -0,0 +1,11 @@
+import type * as THREE from "three";
+/**
+ * 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).
+ *
+ * @param url - GLB URL
+ * @returns Root `THREE.Group` from the loaded glTF scene
+ * @group Utils
+ */
+export declare function loadGlbRoot(url: string): Promise<THREE.Group>;
+//# sourceMappingURL=loadGlb.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"loadGlb.d.ts","sourceRoot":"","sources":["../../../src/utils/loadGlb.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAA;AAiCnC;;;;;;;GAOG;AACH,wBAAsB,WAAW,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAcnE"}

package/dist/es/utils/loadGlb.js

@@ -0,0 +1,42 @@
+import { DEFAULT_DRACO_DECODER_PATH, DEFAULT_KTX2_TRANSCODER_PATH } from "../config/draco";
+import { loadThree } from "./three";
+/**
+ * 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.
+ */
+let gltfLoaderPromise;
+function getGltfLoader() {
+    gltfLoaderPromise !== null && gltfLoaderPromise !== void 0 ? gltfLoaderPromise : (gltfLoaderPromise = loadThree().then((mod) => {
+        const dracoLoader = new mod.DRACOLoader();
+        dracoLoader.setDecoderPath(DEFAULT_DRACO_DECODER_PATH);
+        const gltfLoader = new mod.GLTFLoader();
+        gltfLoader.setDRACOLoader(dracoLoader);
+        const ktx2Loader = new mod.KTX2Loader();
+        ktx2Loader.setTranscoderPath(DEFAULT_KTX2_TRANSCODER_PATH);
+        gltfLoader.setKTX2Loader(ktx2Loader);
+        ktx2Loader.detectSupport(new mod.THREE.WebGLRenderer({ antialias: true }));
+        return gltfLoader;
+    }));
+    return gltfLoaderPromise;
+}
+/**
+ * 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).
+ *
+ * @param url - GLB URL
+ * @returns Root `THREE.Group` from the loaded glTF scene
+ * @group Utils
+ */
+export async function loadGlbRoot(url) {
+    const gltfLoader = await getGltfLoader();
+    return new Promise((resolve, reject) => {
+        gltfLoader.load(url, (gltf) => {
+            resolve(gltf.scene);
+        }, undefined, (error) => {
+            reject(error instanceof Error ? error : new Error(String(error)));
+        });
+    });
+}
+//# sourceMappingURL=loadGlb.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"loadGlb.js","sourceRoot":"","sources":["../../../src/utils/loadGlb.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,0BAA0B,EAAE,4BAA4B,EAAE,MAAM,iBAAiB,CAAA;AAC1F,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AAEnC;;;;;GAKG;AACH,IAAI,iBAES,CAAA;AAEb,SAAS,aAAa;IACpB,iBAAiB,aAAjB,iBAAiB,cAAjB,iBAAiB,IAAjB,iBAAiB,GAAK,SAAS,EAAE,CAAC,IAAI,CAAC,CAAC,GAAG,EAAE,EAAE;QAC7C,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC,WAAW,EAAE,CAAA;QACzC,WAAW,CAAC,cAAc,CAAC,0BAA0B,CAAC,CAAA;QAEtD,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,UAAU,EAAE,CAAA;QACvC,UAAU,CAAC,cAAc,CAAC,WAAW,CAAC,CAAA;QAEtC,MAAM,UAAU,GAAG,IAAI,GAAG,CAAC,UAAU,EAAE,CAAA;QACvC,UAAU,CAAC,iBAAiB,CAAC,4BAA4B,CAAC,CAAA;QAC1D,UAAU,CAAC,aAAa,CAAC,UAAU,CAAC,CAAA;QACpC,UAAU,CAAC,aAAa,CAAC,IAAI,GAAG,CAAC,KAAK,CAAC,aAAa,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;QAE1E,OAAO,UAAU,CAAA;IACnB,CAAC,CAAC,EAAA;IACF,OAAO,iBAAiB,CAAA;AAC1B,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,GAAW;IAC3C,MAAM,UAAU,GAAG,MAAM,aAAa,EAAE,CAAA;IACxC,OAAO,IAAI,OAAO,CAAc,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QAClD,UAAU,CAAC,IAAI,CACb,GAAG,EACH,CAAC,IAAU,EAAE,EAAE;YACb,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAA;QACrB,CAAC,EACD,SAAS,EACT,CAAC,KAAc,EAAE,EAAE;YACjB,MAAM,CAAC,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAA;QACnE,CAAC,CACF,CAAA;IACH,CAAC,CAAC,CAAA;AACJ,CAAC"}

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

@@ -0,0 +1,51 @@
+/**
+ * Lazy, single-instance access to Three.js / deck.gl and the glTF loaders.
+ *
+ * Why: Three.js and deck.gl are heavy and only needed when the map runs in 3D mode. They are
+ * declared as `optionalDependencies` and pulled in on demand via dynamic `import()` so the base
+ * 2D bundle never includes them. Routing every import through this module also guarantees a single
+ * shared Three.js instance, avoiding the runtime warning:
+ *   "THREE.WARNING: Multiple instances of Three.js being imported."
+ *
+ * Consumers use the exported `type`-only `THREE` namespace for annotations (erased at compile time)
+ * and `loadThree()` / `loadDeck()` for the runtime instances.
+ *
+ * @example
+ * ```typescript
+ * import type * as THREE from "three"
+ * import { loadThree } from "../utils/three"
+ *
+ * const { THREE: three } = await loadThree()
+ * const geometry: THREE.BufferGeometry = new three.BoxGeometry(1, 1, 1)
+ * ```
+ *
+ * @group Utils
+ */
+import type { DRACOLoader } from "three/addons/loaders/DRACOLoader.js";
+import type { GLTFLoader } from "three/addons/loaders/GLTFLoader.js";
+import type { KTX2Loader } from "three/addons/loaders/KTX2Loader.js";
+/** Runtime handle to Three.js plus its glTF loader classes. */
+export interface ThreeModule {
+    THREE: typeof import("three");
+    GLTFLoader: typeof GLTFLoader;
+    DRACOLoader: typeof DRACOLoader;
+    KTX2Loader: typeof KTX2Loader;
+}
+/** Runtime handle to the deck.gl classes used by the 3D scene. */
+export interface DeckModule {
+    MapboxOverlay: typeof import("@deck.gl/mapbox").MapboxOverlay;
+    MVTLayer: typeof import("@deck.gl/geo-layers").MVTLayer;
+    IconLayer: typeof import("@deck.gl/layers").IconLayer;
+    PathLayer: typeof import("@deck.gl/layers").PathLayer;
+    TextLayer: typeof import("@deck.gl/layers").TextLayer;
+}
+/**
+ * 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.
+ */
+export declare function loadThree(): Promise<ThreeModule>;
+/**
+ * Dynamically imports the deck.gl overlay and layer classes once and caches the result.
+ */
+export declare function loadDeck(): Promise<DeckModule>;
+//# sourceMappingURL=three.d.ts.map

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

@@ -0,0 +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;AAEpE,+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;AAKD;;;GAGG;AACH,wBAAgB,SAAS,IAAI,OAAO,CAAC,WAAW,CAAC,CAahD;AAED;;GAEG;AACH,wBAAgB,QAAQ,IAAI,OAAO,CAAC,UAAU,CAAC,CAa9C"}

package/dist/es/utils/three.js

@@ -0,0 +1,38 @@
+let threePromise;
+let deckPromise;
+/**
+ * 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.
+ */
+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"),
+    ]).then(([three, gltf, draco, ktx2]) => ({
+        THREE: three,
+        GLTFLoader: gltf.GLTFLoader,
+        DRACOLoader: draco.DRACOLoader,
+        KTX2Loader: ktx2.KTX2Loader,
+    })));
+    return threePromise;
+}
+/**
+ * Dynamically imports the deck.gl overlay and layer classes once and caches the result.
+ */
+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;
+}
+//# sourceMappingURL=three.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"three.js","sourceRoot":"","sources":["../../../src/utils/three.ts"],"names":[],"mappings":"AA4CA,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;KAC7C,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,EAAE,IAAI,EAAE,KAAK,EAAE,IAAI,CAAC,EAAE,EAAE,CAAC,CAAC;QACvC,KAAK,EAAE,KAAK;QACZ,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,UAAU,EAAE,IAAI,CAAC,UAAU;KAC5B,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"}

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

@@ -0,0 +1,24 @@
+import type * as THREE from "three";
+import type { Scene3DLightConfig } from "../domain/models/scene3D";
+/**
+ * Pure Three.js scene helpers. They receive the resolved Three.js module (from {@link loadThree})
+ * as their first argument instead of importing it, so they add nothing to the base bundle and can be
+ * unit-tested by passing a real Three.js instance (Three.js core math/scene classes need no WebGL).
+ *
+ * @group Utils
+ */
+/**
+ * Computes the anchor point used for bottom-aligned GLB placement: XZ from the bounding-box center,
+ * Y from the bounding-box minimum.
+ *
+ * @param three - The resolved Three.js module (from `loadThree()`).
+ */
+export declare function computeGlbBottomAnchor(three: typeof import("three"), root: THREE.Object3D): THREE.Vector3;
+/**
+ * Instantiates Three.js lights from declarative config and adds them to the scene.
+ *
+ * @param three - The resolved Three.js module (from `loadThree()`).
+ * @returns Number of light objects added (used to keep lights when clearing meshes).
+ */
+export declare function addScene3DLights(three: typeof import("three"), scene: THREE.Scene, lights: readonly Scene3DLightConfig[]): number;
+//# sourceMappingURL=threeScene.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"threeScene.d.ts","sourceRoot":"","sources":["../../../src/utils/threeScene.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,KAAK,KAAK,MAAM,OAAO,CAAA;AACnC,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,0BAA0B,CAAA;AAElE;;;;;;GAMG;AAEH;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,cAAc,OAAO,CAAC,EAC7B,IAAI,EAAE,KAAK,CAAC,QAAQ,GACnB,KAAK,CAAC,OAAO,CAKf;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,cAAc,OAAO,CAAC,EAC7B,KAAK,EAAE,KAAK,CAAC,KAAK,EAClB,MAAM,EAAE,SAAS,kBAAkB,EAAE,GACpC,MAAM,CAcR"}

package/dist/es/utils/threeScene.js

@@ -0,0 +1,41 @@
+/**
+ * Pure Three.js scene helpers. They receive the resolved Three.js module (from {@link loadThree})
+ * as their first argument instead of importing it, so they add nothing to the base bundle and can be
+ * unit-tested by passing a real Three.js instance (Three.js core math/scene classes need no WebGL).
+ *
+ * @group Utils
+ */
+/**
+ * Computes the anchor point used for bottom-aligned GLB placement: XZ from the bounding-box center,
+ * Y from the bounding-box minimum.
+ *
+ * @param three - The resolved Three.js module (from `loadThree()`).
+ */
+export function computeGlbBottomAnchor(three, root) {
+    const box = new three.Box3().setFromObject(root);
+    const center = box.getCenter(new three.Vector3());
+    center.y = box.min.y;
+    return center;
+}
+/**
+ * Instantiates Three.js lights from declarative config and adds them to the scene.
+ *
+ * @param three - The resolved Three.js module (from `loadThree()`).
+ * @returns Number of light objects added (used to keep lights when clearing meshes).
+ */
+export function addScene3DLights(three, scene, lights) {
+    let count = 0;
+    for (const light of lights) {
+        if (light.type === "ambient") {
+            scene.add(new three.AmbientLight(light.color, light.intensity));
+            count++;
+            continue;
+        }
+        const directional = new three.DirectionalLight(light.color, light.intensity);
+        directional.position.set(light.position.x, light.position.y, light.position.z);
+        scene.add(directional);
+        count++;
+    }
+    return count;
+}
+//# sourceMappingURL=threeScene.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"threeScene.js","sourceRoot":"","sources":["../../../src/utils/threeScene.ts"],"names":[],"mappings":"AAGA;;;;;;GAMG;AAEH;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CACpC,KAA6B,EAC7B,IAAoB;IAEpB,MAAM,GAAG,GAAG,IAAI,KAAK,CAAC,IAAI,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,CAAA;IAChD,MAAM,MAAM,GAAG,GAAG,CAAC,SAAS,CAAC,IAAI,KAAK,CAAC,OAAO,EAAE,CAAC,CAAA;IACjD,MAAM,CAAC,CAAC,GAAG,GAAG,CAAC,GAAG,CAAC,CAAC,CAAA;IACpB,OAAO,MAAM,CAAA;AACf,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAC9B,KAA6B,EAC7B,KAAkB,EAClB,MAAqC;IAErC,IAAI,KAAK,GAAG,CAAC,CAAA;IACb,KAAK,MAAM,KAAK,IAAI,MAAM,EAAE,CAAC;QAC3B,IAAI,KAAK,CAAC,IAAI,KAAK,SAAS,EAAE,CAAC;YAC7B,KAAK,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,YAAY,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC,CAAC,CAAA;YAC/D,KAAK,EAAE,CAAA;YACP,SAAQ;QACV,CAAC;QACD,MAAM,WAAW,GAAG,IAAI,KAAK,CAAC,gBAAgB,CAAC,KAAK,CAAC,KAAK,EAAE,KAAK,CAAC,SAAS,CAAC,CAAA;QAC5E,WAAW,CAAC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAA;QAC9E,KAAK,CAAC,GAAG,CAAC,WAAW,CAAC,CAAA;QACtB,KAAK,EAAE,CAAA;IACT,CAAC;IACD,OAAO,KAAK,CAAA;AACd,CAAC"}