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

package/dist/es/map/scene3DController.js

@@ -0,0 +1,439 @@
+import { MercatorCoordinate } from "maplibre-gl";
+import { computeScenePosition, hexToRgb, isPlacementVisibleOnFloor, mergeGlbScale, mergeRotation3D, opacityForZoom, resolveModels3DLights, resolveZoomTransparency, } from "../utils/3d";
+import { buildElevatedPaths, buildLabelData, buildPoiIconData, buildStoreLogoData, computeStoreLogoSize, } from "../utils/deckLayers";
+import { loadGlbRoot } from "../utils/loadGlb";
+import { loadDeck, loadThree } from "../utils/three";
+import { addScene3DLights, computeGlbBottomAnchor } from "../utils/threeScene";
+/**
+ * Owns the experimental 3D scene for a MapLibre map: the deck.gl overlay layers (elevated room
+ * outlines, indoor labels, POI icons, store logos) and the declarative GLB custom layer rendered
+ * with Three.js.
+ *
+ * This is the WebGL / deck.gl "glue": creating the `WebGLRenderer`, instantiating deck layers and
+ * driving the per-frame render loop all require a real GPU context and a live map, so this module is
+ * excluded from unit-test coverage (see `sonar.coverage.exclusions`). The unit-testable logic it
+ * relies on lives in `utils/deckLayers.ts`, `utils/threeScene.ts` and `utils/3d.ts`.
+ *
+ * The map creates one instance only when {@link MapConfig.mode} is `"3D"` and
+ * {@link Scene3DConfig.enabled} is not `false`, and forwards its lifecycle to the `on*` methods.
+ *
+ * @group Map
+ */
+export class Scene3DController {
+    constructor(map, scene3DConfig, initialCenter) {
+        /** Latest known floor key; updated by the floor-change hooks and read when (re)building layers. */
+        this.currentFloor = "";
+        // Lazily-loaded Three.js / deck.gl runtime handles (see loadThree()/loadDeck()).
+        this.threeMod = undefined;
+        this.deckMod = undefined;
+        this.deckOverlay = undefined;
+        this.scene3DGlbScene = undefined;
+        /** Loaded GLB roots keyed by URL (deduplicated). */
+        this.scene3DGlbRootByUrl = new globalThis.Map();
+        /** Per-asset template root and bottom anchor for cloning. */
+        this.scene3DGlbTemplateById = new globalThis.Map();
+        /** Number of light objects in `scene3DGlbScene` (kept when clearing meshes). */
+        this.scene3DGlbLightCount = 0;
+        /** Container group holding all placed GLB pivots; rebuilt on each floor change. */
+        this.scene3DModelsGroup = undefined;
+        this.spriteIconMapping = {};
+        this.spriteAtlasImage = new Image();
+        this.map = map;
+        this.scene3DConfig = scene3DConfig;
+        this.initialCenter = initialCenter;
+    }
+    // Lifecycle entry points forwarded by the map ---------------------------------------------
+    /**
+     * Sets up the deck.gl overlay and GLB custom layer once the map style has loaded. Awaits the lazy
+     * library load first so the base 2D flow is never blocked by it.
+     */
+    async onMapLoad() {
+        var _a, _b;
+        try {
+            await this.ensure3DLibs();
+        }
+        catch (err) {
+            console.error("Failed to load 3D libraries (three/deck.gl)", err);
+            return;
+        }
+        if (!this.deckMod)
+            return;
+        // Load the sprite atlas (icons/logos) before building deck layers so the first
+        // updateDeckOverlay has the atlas available.
+        const spriteUrl = (_b = (_a = this.scene3DConfig.customLayers) === null || _a === void 0 ? void 0 : _a.iconLayers) === null || _b === void 0 ? void 0 : _b.spriteUrl;
+        if (spriteUrl) {
+            await this.loadSpriteAtlas(spriteUrl).catch((err) => console.error("Failed to load sprite atlas", err));
+        }
+        this.deckOverlay = new this.deckMod.MapboxOverlay({ layers: [] });
+        this.map.addControl(this.deckOverlay);
+        // Hide MapLibre icon layers — replaced by deck.gl IconLayer
+        this.hideLayers(this.scene3DConfig.hideLayers);
+        const models = this.scene3DConfig.models;
+        const glbModelsActive = models !== undefined && models.enabled !== false && models.assets.length > 0;
+        if (glbModelsActive) {
+            this.map.addLayer(this.createGlbCustomLayer());
+        }
+    }
+    /** Re-applies zoom-based model transparency; call on every map `zoom`. */
+    onZoom() {
+        this.applyModelZoomOpacity();
+    }
+    /** Rebuilds the deck overlay and GLB placements for the given floor. */
+    onFloorChange(currentFloor) {
+        this.currentFloor = currentFloor !== null && currentFloor !== void 0 ? currentFloor : "";
+        this.updateDeckOverlay();
+        this.placeScene3DModels();
+    }
+    /** Rebuilds only the deck overlay (no GLB replacement) for the given floor. */
+    refreshOverlay(currentFloor) {
+        this.currentFloor = currentFloor !== null && currentFloor !== void 0 ? currentFloor : "";
+        this.updateDeckOverlay();
+    }
+    // Internal implementation -----------------------------------------------------------------
+    /**
+     * Lazily loads the Three.js / deck.gl runtime handles (dynamic import) and caches them so the
+     * heavy libraries stay out of the base 2D bundle.
+     */
+    async ensure3DLibs() {
+        var _a, _b;
+        (_a = this.threeMod) !== null && _a !== void 0 ? _a : (this.threeMod = await loadThree());
+        (_b = this.deckMod) !== null && _b !== void 0 ? _b : (this.deckMod = await loadDeck());
+    }
+    createGlbCustomLayer() {
+        const three = this.threeMod.THREE;
+        const refMercator = MercatorCoordinate.fromLngLat(this.initialCenter, 0);
+        const meterScale = refMercator.meterInMercatorCoordinateUnits();
+        const modelTransform = new three.Matrix4()
+            .makeTranslation(refMercator.x, refMercator.y, refMercator.z)
+            .scale(new three.Vector3(meterScale, -meterScale, meterScale))
+            .multiply(new three.Matrix4().makeRotationX(Math.PI / 2));
+        this.scene3DGlbScene = new three.Scene();
+        const models = this.scene3DConfig.models;
+        if (models && models.enabled !== false && models.assets.length > 0) {
+            const lights = resolveModels3DLights(models);
+            this.scene3DGlbLightCount = addScene3DLights(three, this.scene3DGlbScene, lights);
+        }
+        else {
+            this.scene3DGlbLightCount = 0;
+        }
+        void this.loadScene3DGlbTemplates()
+            .then(() => this.placeScene3DModels())
+            .catch((err) => {
+            console.error("Failed to initialize declarative GLB models", err);
+        });
+        let renderer = undefined;
+        let camera = undefined;
+        const tmpMatrix = new three.Matrix4();
+        return {
+            id: "3d-glb-models",
+            type: "custom",
+            renderingMode: "3d",
+            onAdd: (_map, gl) => {
+                camera = new three.Camera();
+                renderer = new three.WebGLRenderer({
+                    canvas: _map.getCanvas(),
+                    context: gl,
+                    antialias: true,
+                });
+                renderer.autoClear = false;
+                // MapLibre owns canvas dimensions; only sync the GL viewport on resize.
+                renderer.setSize = function (width, height) {
+                    this.setViewport(0, 0, width, height);
+                };
+            },
+            render: (_gl, args) => {
+                var _a;
+                if (!camera ||
+                    !renderer ||
+                    !this.scene3DGlbScene ||
+                    !this.scene3DModelsGroup ||
+                    this.scene3DModelsGroup.children.length === 0) {
+                    return;
+                }
+                const canvas = this.map.getCanvas();
+                const width = canvas.width;
+                const height = canvas.height;
+                // Skip while the framebuffer has no drawable area (e.g. devtools opening).
+                if (width === 0 || height === 0) {
+                    return;
+                }
+                const mainMatrix = (_a = args.defaultProjectionData) === null || _a === void 0 ? void 0 : _a.mainMatrix;
+                if (!mainMatrix) {
+                    return;
+                }
+                renderer.setSize(width, height);
+                tmpMatrix.fromArray(mainMatrix).multiply(modelTransform);
+                camera.projectionMatrix.copy(tmpMatrix);
+                renderer.resetState();
+                renderer.render(this.scene3DGlbScene, camera);
+            },
+        };
+    }
+    async loadScene3DGlbTemplates() {
+        var _a;
+        const three = (_a = this.threeMod) === null || _a === void 0 ? void 0 : _a.THREE;
+        const models = this.scene3DConfig.models;
+        if (!three || !models || models.enabled === false || models.assets.length === 0) {
+            return;
+        }
+        this.scene3DGlbRootByUrl.clear();
+        this.scene3DGlbTemplateById.clear();
+        for (const asset of models.assets) {
+            try {
+                let root = this.scene3DGlbRootByUrl.get(asset.url);
+                if (!root) {
+                    root = await loadGlbRoot(asset.url);
+                    this.scene3DGlbRootByUrl.set(asset.url, root);
+                }
+                const center = computeGlbBottomAnchor(three, root);
+                this.scene3DGlbTemplateById.set(asset.id, { root, center });
+            }
+            catch (err) {
+                console.error(`Failed to load GLB asset "${asset.id}" from ${asset.url}`, err);
+            }
+        }
+    }
+    placeScene3DModels() {
+        var _a, _b, _c, _d, _e, _f, _g, _h;
+        const three = (_a = this.threeMod) === null || _a === void 0 ? void 0 : _a.THREE;
+        if (!three || !this.scene3DGlbScene) {
+            return;
+        }
+        const models = this.scene3DConfig.models;
+        if (!models || models.enabled === false) {
+            return;
+        }
+        if (this.scene3DModelsGroup) {
+            this.scene3DGlbScene.remove(this.scene3DModelsGroup);
+            this.scene3DModelsGroup = undefined;
+        }
+        if (this.scene3DGlbTemplateById.size === 0) {
+            return;
+        }
+        const refMercator = MercatorCoordinate.fromLngLat(this.initialCenter, 0);
+        const meterScale = refMercator.meterInMercatorCoordinateUnits();
+        const floorKey = this.currentFloor;
+        const modelsGroup = new three.Group();
+        modelsGroup.position.set((_c = (_b = models.globalOffset) === null || _b === void 0 ? void 0 : _b.x) !== null && _c !== void 0 ? _c : 0, (_e = (_d = models.globalOffset) === null || _d === void 0 ? void 0 : _d.y) !== null && _e !== void 0 ? _e : 0, (_g = (_f = models.globalOffset) === null || _f === void 0 ? void 0 : _f.z) !== null && _g !== void 0 ? _g : 0);
+        for (const placement of models.placements) {
+            if (!isPlacementVisibleOnFloor(placement, floorKey)) {
+                continue;
+            }
+            const template = this.scene3DGlbTemplateById.get(placement.assetId);
+            if (!template) {
+                continue;
+            }
+            const asset = models.assets.find((a) => a.id === placement.assetId);
+            if (!asset) {
+                continue;
+            }
+            const target = MercatorCoordinate.fromLngLat([placement.position.lng, placement.position.lat], (_h = placement.position.altitude) !== null && _h !== void 0 ? _h : 0);
+            const [posX, posY, posZ] = computeScenePosition(target, refMercator, meterScale, asset.defaultModelOffset, placement.offset);
+            const pivot = new three.Group();
+            pivot.position.set(posX, posY, posZ);
+            const mergedRot = mergeRotation3D(asset.defaultRotation, placement.rotation);
+            pivot.rotation.set(three.MathUtils.degToRad(mergedRot.pitch), three.MathUtils.degToRad(-mergedRot.yaw), three.MathUtils.degToRad(mergedRot.roll), "YXZ");
+            const [sx3, sy3, sz3] = mergeGlbScale(asset.defaultScale, placement.scale);
+            pivot.scale.set(sx3, sy3, sz3);
+            const model = template.root.clone(true);
+            // `clone(true)` shares materials between instances; clone them per placement so each
+            // placement's zoom-based opacity is independent and does not bleed into sibling models.
+            model.traverse((obj) => {
+                const mesh = obj;
+                if (!mesh.isMesh) {
+                    return;
+                }
+                mesh.material = Array.isArray(mesh.material)
+                    ? mesh.material.map((m) => m.clone())
+                    : mesh.material.clone();
+            });
+            model.position.set(-template.center.x, -template.center.y, -template.center.z);
+            // Stash the resolved zoom-transparency config so it can be re-applied on every zoom change.
+            pivot.userData.zoomTransparency = resolveZoomTransparency(models, asset, placement);
+            pivot.add(model);
+            modelsGroup.add(pivot);
+        }
+        this.scene3DModelsGroup = modelsGroup;
+        this.scene3DGlbScene.add(modelsGroup);
+        this.applyModelZoomOpacity();
+        this.map.triggerRepaint();
+    }
+    /**
+     * Applies zoom-based transparency to placed GLB models, using each placement's resolved
+     * {@link ZoomTransparencyConfig} stored in `pivot.userData.zoomTransparency`. Hard threshold:
+     * fully opaque below the configured zoom, configured opacity at/above it. Only triggers a
+     * repaint when at least one material actually changed.
+     */
+    applyModelZoomOpacity() {
+        if (!this.scene3DModelsGroup) {
+            return;
+        }
+        const zoom = this.map.getZoom();
+        let changed = false;
+        for (const pivot of this.scene3DModelsGroup.children) {
+            const cfg = pivot.userData.zoomTransparency;
+            const opacity = opacityForZoom(cfg, zoom);
+            pivot.traverse((obj) => {
+                const mesh = obj;
+                if (!mesh.isMesh) {
+                    return;
+                }
+                const materials = Array.isArray(mesh.material) ? mesh.material : [mesh.material];
+                for (const material of materials) {
+                    if (material.opacity !== opacity) {
+                        material.transparent = opacity < 1;
+                        material.opacity = opacity;
+                        // Disable depth writes while transparent to avoid draw-order artifacts.
+                        material.depthWrite = opacity >= 1;
+                        changed = true;
+                    }
+                }
+            });
+        }
+        if (changed) {
+            this.map.triggerRepaint();
+        }
+    }
+    async loadSpriteAtlas(spriteUrl) {
+        const [json, img] = await Promise.all([
+            fetch(`${spriteUrl}.json`).then((r) => r.json()),
+            new Promise((resolve, reject) => {
+                const image = new Image();
+                image.crossOrigin = "anonymous";
+                image.onload = () => resolve(image);
+                image.onerror = reject;
+                image.src = `${spriteUrl}.png`;
+            }),
+        ]);
+        this.spriteIconMapping = json;
+        this.spriteAtlasImage = img;
+    }
+    makeElevatedLinesLayer(floorKey, layerConfig) {
+        var _a;
+        const deck = this.deckMod;
+        if (!deck)
+            return null;
+        return new deck.MVTLayer({
+            id: "indoor-lines-elevated",
+            data: layerConfig.dataUrl,
+            binary: (_a = layerConfig.binaryData) !== null && _a !== void 0 ? _a : false,
+            renderSubLayers: (props) => {
+                var _a, _b, _c, _d;
+                const paths = buildElevatedPaths((props.data || []), floorKey, (_a = layerConfig.defaultHeight) !== null && _a !== void 0 ? _a : 5);
+                if (!paths.length)
+                    return null;
+                // Default color hardcoded to "#cbcbcb" (from the original style) to avoid a type mismatch.
+                return new deck.PathLayer(Object.assign(Object.assign({}, props), { id: `${props.id}-paths`, data: paths, getPath: (d) => d.path, getColor: hexToRgb((_b = layerConfig.lineColor) !== null && _b !== void 0 ? _b : "#cbcbcb"), getWidth: (_c = layerConfig.lineWidth) !== null && _c !== void 0 ? _c : 1.5, widthUnits: (_d = layerConfig.widthUnits) !== null && _d !== void 0 ? _d : "pixels", pickable: false }));
+            },
+            updateTriggers: {
+                renderSubLayers: [floorKey],
+            },
+        });
+    }
+    makeLabelLayer(floorKey, layerConfig, useSdf = true) {
+        var _a, _b, _c;
+        const deck = this.deckMod;
+        if (!deck)
+            return null;
+        return new deck.MVTLayer({
+            id: "indoor-labels",
+            data: layerConfig.dataUrl,
+            binary: (_a = layerConfig.binaryData) !== null && _a !== void 0 ? _a : false,
+            minZoom: (_b = layerConfig.minZoom) !== null && _b !== void 0 ? _b : 19.5,
+            maxZoom: (_c = layerConfig.maxZoom) !== null && _c !== void 0 ? _c : 24,
+            renderSubLayers: (props) => {
+                var _a, _b, _c, _d, _e, _f;
+                // Use area_name and poi Point features — unique per tile, no duplicates.
+                // If a logo-{name} image exists in the sprite, the icon takes priority over the text label.
+                const textData = buildLabelData((props.data || []), floorKey, (imageId) => this.map.hasImage(imageId), (_a = layerConfig.defaultHeight) !== null && _a !== void 0 ? _a : 5);
+                if (!textData.length)
+                    return null;
+                return new deck.TextLayer(Object.assign(Object.assign({}, props), { id: `${props.id}-labels`, data: textData, getPosition: (d) => d.position, getText: (d) => d.text, getSize: (_b = layerConfig.size) !== null && _b !== void 0 ? _b : 16, getColor: hexToRgb((_c = layerConfig.color) !== null && _c !== void 0 ? _c : "#91969b"), outlineColor: useSdf ? [255, 255, 255, 255] : [0, 0, 0, 0], outlineWidth: useSdf ? 4 : 0, fontSettings: { sdf: useSdf }, fontFamily: (_d = layerConfig.fontFamily) !== null && _d !== void 0 ? _d : "Open Sans, sans-serif", fontWeight: (_e = layerConfig.fontWeight) !== null && _e !== void 0 ? _e : 600, billboard: true, pickable: false, characterSet: "auto", wordBreak: "break-word", maxWidth: (_f = layerConfig.maxWidth) !== null && _f !== void 0 ? _f : 150 }));
+            },
+            updateTriggers: {
+                renderSubLayers: [floorKey],
+            },
+        });
+    }
+    makePoiIconLayer(floorKey, layerConfig) {
+        var _a, _b, _c;
+        const deck = this.deckMod;
+        if (!deck || !this.spriteIconMapping || !this.spriteAtlasImage)
+            return null;
+        return new deck.MVTLayer({
+            id: "indoor-poi-icons",
+            data: layerConfig.dataUrl,
+            binary: (_a = layerConfig.binaryData) !== null && _a !== void 0 ? _a : false,
+            minZoom: (_b = layerConfig.minZoom) !== null && _b !== void 0 ? _b : 17,
+            maxZoom: (_c = layerConfig.maxZoom) !== null && _c !== void 0 ? _c : 24,
+            renderSubLayers: (props) => {
+                var _a, _b, _c, _d, _e;
+                const iconData = buildPoiIconData((props.data || []), floorKey, (_a = layerConfig.defaultHeight) !== null && _a !== void 0 ? _a : 5);
+                if (!iconData.length)
+                    return null;
+                return new deck.IconLayer(Object.assign(Object.assign({}, props), { id: `${props.id}-poi-icons`, data: iconData, iconAtlas: this.spriteAtlasImage, iconMapping: this.spriteIconMapping, getIcon: (d) => d.icon, getPosition: (d) => d.position, getSize: (_b = layerConfig.size) !== null && _b !== void 0 ? _b : 2, sizeUnits: (_c = layerConfig.sizeUnits) !== null && _c !== void 0 ? _c : "meters", sizeScale: (_d = layerConfig.sizeScale) !== null && _d !== void 0 ? _d : 1, billboard: (_e = layerConfig.billboard) !== null && _e !== void 0 ? _e : true, pickable: false }));
+            },
+            updateTriggers: {
+                renderSubLayers: [floorKey],
+            },
+        });
+    }
+    makeStoreLogoLayer(floorKey, layerConfig) {
+        var _a, _b, _c;
+        const deck = this.deckMod;
+        if (!deck || !this.spriteIconMapping || !this.spriteAtlasImage)
+            return null;
+        return new deck.MVTLayer({
+            id: "indoor-store-logos",
+            data: layerConfig.dataUrl,
+            binary: (_a = layerConfig.binaryData) !== null && _a !== void 0 ? _a : false,
+            minZoom: (_b = layerConfig.minZoom) !== null && _b !== void 0 ? _b : 13,
+            maxZoom: (_c = layerConfig.maxZoom) !== null && _c !== void 0 ? _c : 24,
+            renderSubLayers: (props) => {
+                var _a, _b, _c, _d;
+                const logoData = buildStoreLogoData((props.data || []), floorKey, this.spriteIconMapping, (_a = layerConfig.defaultHeight) !== null && _a !== void 0 ? _a : 5);
+                if (!logoData.length)
+                    return null;
+                return new deck.IconLayer(Object.assign(Object.assign({}, props), { id: `${props.id}-store-logos`, data: logoData, iconAtlas: this.spriteAtlasImage, iconMapping: this.spriteIconMapping, getIcon: (d) => d.icon, getPosition: (d) => d.position, getAngle: (d) => -d.rotation, getSize: (d) => { var _a; return computeStoreLogoSize(this.spriteIconMapping, d.icon, (_a = layerConfig.logoScale) !== null && _a !== void 0 ? _a : {}); }, sizeUnits: (_b = layerConfig.sizeUnits) !== null && _b !== void 0 ? _b : "meters", sizeScale: (_c = layerConfig.sizeScale) !== null && _c !== void 0 ? _c : 1, billboard: (_d = layerConfig.billboard) !== null && _d !== void 0 ? _d : false, pickable: false }));
+            },
+            updateTriggers: {
+                renderSubLayers: [floorKey],
+            },
+        });
+    }
+    updateDeckOverlay() {
+        if (!this.deckOverlay || !this.currentFloor)
+            return;
+        if (!this.scene3DConfig.customLayers)
+            return;
+        const { customLayers } = this.scene3DConfig;
+        const layers = [];
+        if (customLayers.elevatedLinesLayer) {
+            layers.push(this.makeElevatedLinesLayer(this.currentFloor, customLayers.elevatedLinesLayer));
+        }
+        if (customLayers.labelsLayer) {
+            layers.push(this.makeLabelLayer(this.currentFloor, customLayers.labelsLayer, false));
+        }
+        if (customLayers.iconLayers) {
+            const { storeLogosLayer, poiIconsLayer } = customLayers.iconLayers;
+            if (storeLogosLayer) {
+                layers.push(this.makeStoreLogoLayer(this.currentFloor, storeLogosLayer));
+            }
+            if (poiIconsLayer) {
+                layers.push(this.makePoiIconLayer(this.currentFloor, poiIconsLayer));
+            }
+        }
+        this.deckOverlay.setProps({ layers });
+    }
+    hideLayers(layersIds) {
+        if (!layersIds)
+            return;
+        for (const layerId of layersIds) {
+            const layer = this.map.getLayer(layerId);
+            if (!layer)
+                continue;
+            this.map.setLayoutProperty(layer.id, "visibility", "none");
+        }
+    }
+}
+//# sourceMappingURL=scene3DController.js.map

package/dist/es/map/scene3DController.js.map

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

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

@@ -0,0 +1,54 @@
+import type { GLBAssetConfig, GLBModelOffset, GLBPlacementConfig, Models3DConfig, Rotation3D, Scene3DLightConfig, ZoomTransparencyConfig } from "../domain/models/scene3D";
+/**
+ * Default lights matching the legacy escalator scene when {@link Models3DConfig.lights} is unset.
+ * @internal
+ */
+export declare const DEFAULT_SCENE3D_LIGHTS: readonly Scene3DLightConfig[];
+export declare const hexToRgb: (hex: string) => [number, number, number];
+export declare const hexToRgba: (hex: string) => [number, number, number, number];
+/**
+ * Resolves lights for the declarative GLB scene: {@link Models3DConfig.lights} when set, otherwise SDK defaults.
+ */
+export declare function resolveModels3DLights(models: Models3DConfig): Scene3DLightConfig[];
+/**
+ * Merges two partial rotations by adding each axis in degrees.
+ */
+export declare function mergeRotation3D(a?: Rotation3D, b?: Rotation3D): Required<Rotation3D>;
+/**
+ * Normalizes a uniform or per-axis scale; undefined uses `fallback` on all axes.
+ */
+export declare function normalizeScale(scale: number | readonly [number, number, number] | undefined, fallback: number): [number, number, number];
+/**
+ * Placement scale overrides asset default when provided; otherwise asset (or 1) applies.
+ */
+export declare function mergeGlbScale(assetDefault?: number | readonly [number, number, number], placementOverride?: number | readonly [number, number, number]): [number, number, number];
+/**
+ * Resolves the effective zoom-based transparency for a placement, applying precedence:
+ * placement > asset > global. Returns `undefined` when none is configured.
+ */
+export declare function resolveZoomTransparency(models: Models3DConfig, asset: GLBAssetConfig | undefined, placement: GLBPlacementConfig): ZoomTransparencyConfig | undefined;
+/**
+ * Opacity for a given zoom under a hard-threshold {@link ZoomTransparencyConfig}.
+ * Returns `cfg.opacity` when `zoom >= cfg.zoom`, otherwise `1` (fully opaque).
+ * With no config, returns `1`.
+ */
+export declare function opacityForZoom(cfg: ZoomTransparencyConfig | undefined, zoom: number): number;
+/**
+ * Whether a GLB placement should be visible for the given floor key.
+ */
+export declare function isPlacementVisibleOnFloor(placement: GLBPlacementConfig, floorKey: string): boolean;
+/**
+ * Computes a GLB pivot's scene-space position (in metres) from a placement's Mercator target and a
+ * Mercator reference origin, plus the asset-level and placement-level offsets.
+ *
+ * X/Z come from the Mercator delta divided by the metre scale; Y comes only from the offsets (the
+ * model is bottom-aligned separately). All offsets are in map-space metres.
+ */
+export declare function computeScenePosition(target: {
+    x: number;
+    y: number;
+}, ref: {
+    x: number;
+    y: number;
+}, meterScale: number, assetOffset?: GLBModelOffset, placementOffset?: GLBModelOffset): [number, number, number];
+//# sourceMappingURL=3d.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"3d.d.ts","sourceRoot":"","sources":["../../../src/utils/3d.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,cAAc,EACd,kBAAkB,EAClB,cAAc,EACd,UAAU,EACV,kBAAkB,EAClB,sBAAsB,EACvB,MAAM,0BAA0B,CAAA;AAEjC;;;GAGG;AACH,eAAO,MAAM,sBAAsB,EAAE,SAAS,kBAAkB,EAItD,CAAA;AAEV,eAAO,MAAM,QAAQ,GAAI,KAAK,MAAM,KAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAW7D,CAAA;AAED,eAAO,MAAM,SAAS,GAAI,KAAK,MAAM,KAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAYtE,CAAA;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE,cAAc,GAAG,kBAAkB,EAAE,CAKlF;AAED;;GAEG;AACH,wBAAgB,eAAe,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,EAAE,UAAU,GAAG,QAAQ,CAAC,UAAU,CAAC,CAMpF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,MAAM,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,EAC7D,QAAQ,EAAE,MAAM,GACf,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAQ1B;AAED;;GAEG;AACH,wBAAgB,aAAa,CAC3B,YAAY,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EACzD,iBAAiB,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,GAC7D,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAM1B;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,cAAc,GAAG,SAAS,EACjC,SAAS,EAAE,kBAAkB,GAC5B,sBAAsB,GAAG,SAAS,CAEpC;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,GAAG,EAAE,sBAAsB,GAAG,SAAS,EAAE,IAAI,EAAE,MAAM,GAAG,MAAM,CAK5F;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CACvC,SAAS,EAAE,kBAAkB,EAC7B,QAAQ,EAAE,MAAM,GACf,OAAO,CAKT;AAED;;;;;;GAMG;AACH,wBAAgB,oBAAoB,CAClC,MAAM,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,EAChC,GAAG,EAAE;IAAE,CAAC,EAAE,MAAM,CAAC;IAAC,CAAC,EAAE,MAAM,CAAA;CAAE,EAC7B,UAAU,EAAE,MAAM,EAClB,WAAW,CAAC,EAAE,cAAc,EAC5B,eAAe,CAAC,EAAE,cAAc,GAC/B,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAU1B"}

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

@@ -0,0 +1,120 @@
+/**
+ * Default lights matching the legacy escalator scene when {@link Models3DConfig.lights} is unset.
+ * @internal
+ */
+export const DEFAULT_SCENE3D_LIGHTS = [
+    { type: "directional", color: 0xffffff, intensity: 2, position: { x: 50, y: 100, z: 80 } },
+    { type: "directional", color: 0xffffff, intensity: 1.5, position: { x: -50, y: 80, z: -60 } },
+    { type: "ambient", color: 0xffffff, intensity: 1.5 },
+];
+export const hexToRgb = (hex) => {
+    const matches = hex.match(/\w\w/g);
+    if (!matches || matches.length < 3) {
+        throw new Error(`Invalid hex color: ${hex}`);
+    }
+    const r = Number.parseInt(matches[0], 16);
+    const g = Number.parseInt(matches[1], 16);
+    const b = Number.parseInt(matches[2], 16);
+    return [r, g, b];
+};
+export const hexToRgba = (hex) => {
+    const matches = hex.match(/\w\w/g);
+    if (!matches || matches.length < 3) {
+        throw new Error(`Invalid hex color: ${hex}`);
+    }
+    const r = Number.parseInt(matches[0], 16);
+    const g = Number.parseInt(matches[1], 16);
+    const b = Number.parseInt(matches[2], 16);
+    const a = matches.length >= 4 ? Number.parseInt(matches[3], 16) : 255;
+    return [r, g, b, a];
+};
+/**
+ * Resolves lights for the declarative GLB scene: {@link Models3DConfig.lights} when set, otherwise SDK defaults.
+ */
+export function resolveModels3DLights(models) {
+    if (models.lights && models.lights.length > 0) {
+        return [...models.lights];
+    }
+    return [...DEFAULT_SCENE3D_LIGHTS];
+}
+/**
+ * Merges two partial rotations by adding each axis in degrees.
+ */
+export function mergeRotation3D(a, b) {
+    var _a, _b, _c, _d, _e, _f;
+    return {
+        yaw: ((_a = a === null || a === void 0 ? void 0 : a.yaw) !== null && _a !== void 0 ? _a : 0) + ((_b = b === null || b === void 0 ? void 0 : b.yaw) !== null && _b !== void 0 ? _b : 0),
+        pitch: ((_c = a === null || a === void 0 ? void 0 : a.pitch) !== null && _c !== void 0 ? _c : 0) + ((_d = b === null || b === void 0 ? void 0 : b.pitch) !== null && _d !== void 0 ? _d : 0),
+        roll: ((_e = a === null || a === void 0 ? void 0 : a.roll) !== null && _e !== void 0 ? _e : 0) + ((_f = b === null || b === void 0 ? void 0 : b.roll) !== null && _f !== void 0 ? _f : 0),
+    };
+}
+/**
+ * Normalizes a uniform or per-axis scale; undefined uses `fallback` on all axes.
+ */
+export function normalizeScale(scale, fallback) {
+    if (scale === undefined) {
+        return [fallback, fallback, fallback];
+    }
+    if (typeof scale === "number") {
+        return [scale, scale, scale];
+    }
+    return [scale[0], scale[1], scale[2]];
+}
+/**
+ * Placement scale overrides asset default when provided; otherwise asset (or 1) applies.
+ */
+export function mergeGlbScale(assetDefault, placementOverride) {
+    const base = normalizeScale(assetDefault, 1);
+    if (placementOverride === undefined) {
+        return base;
+    }
+    return normalizeScale(placementOverride, 1);
+}
+/**
+ * Resolves the effective zoom-based transparency for a placement, applying precedence:
+ * placement > asset > global. Returns `undefined` when none is configured.
+ */
+export function resolveZoomTransparency(models, asset, placement) {
+    var _a, _b;
+    return (_b = (_a = placement.zoomTransparency) !== null && _a !== void 0 ? _a : asset === null || asset === void 0 ? void 0 : asset.zoomTransparency) !== null && _b !== void 0 ? _b : models.zoomTransparency;
+}
+/**
+ * Opacity for a given zoom under a hard-threshold {@link ZoomTransparencyConfig}.
+ * Returns `cfg.opacity` when `zoom >= cfg.zoom`, otherwise `1` (fully opaque).
+ * With no config, returns `1`.
+ */
+export function opacityForZoom(cfg, zoom) {
+    if (!cfg) {
+        return 1;
+    }
+    return zoom >= cfg.zoom ? cfg.opacity : 1;
+}
+/**
+ * Whether a GLB placement should be visible for the given floor key.
+ */
+export function isPlacementVisibleOnFloor(placement, floorKey) {
+    if (placement.visibility.mode === "allFloors") {
+        return true;
+    }
+    return placement.visibility.floorKey === floorKey;
+}
+/**
+ * Computes a GLB pivot's scene-space position (in metres) from a placement's Mercator target and a
+ * Mercator reference origin, plus the asset-level and placement-level offsets.
+ *
+ * X/Z come from the Mercator delta divided by the metre scale; Y comes only from the offsets (the
+ * model is bottom-aligned separately). All offsets are in map-space metres.
+ */
+export function computeScenePosition(target, ref, meterScale, assetOffset, placementOffset) {
+    var _a, _b, _c, _d, _e, _f;
+    const sx = (target.x - ref.x) / meterScale;
+    const sz = (target.y - ref.y) / meterScale;
+    const ax = (_a = assetOffset === null || assetOffset === void 0 ? void 0 : assetOffset.x) !== null && _a !== void 0 ? _a : 0;
+    const ay = (_b = assetOffset === null || assetOffset === void 0 ? void 0 : assetOffset.y) !== null && _b !== void 0 ? _b : 0;
+    const az = (_c = assetOffset === null || assetOffset === void 0 ? void 0 : assetOffset.z) !== null && _c !== void 0 ? _c : 0;
+    const px = (_d = placementOffset === null || placementOffset === void 0 ? void 0 : placementOffset.x) !== null && _d !== void 0 ? _d : 0;
+    const py = (_e = placementOffset === null || placementOffset === void 0 ? void 0 : placementOffset.y) !== null && _e !== void 0 ? _e : 0;
+    const pz = (_f = placementOffset === null || placementOffset === void 0 ? void 0 : placementOffset.z) !== null && _f !== void 0 ? _f : 0;
+    return [sx + ax + px, ay + py, sz + az + pz];
+}
+//# sourceMappingURL=3d.js.map