storysplat-viewer 0.2.1 → 0.2.2

package/dist/esm/index.js

@@ -76232,805 +76232,228 @@ WebGPUEngine._GlslangDefaultOptions = {
 WebGPUEngine._InstanceId = 0;
 
 /**
- * Basic check if the current environment appears to be a mobile device based on user agent.
- * Note: User agent sniffing is generally unreliable; consider feature detection instead if possible.
- * This function might return false positives or negatives.
- * @returns True if the user agent string matches common mobile patterns, false otherwise.
- */
-const isMobileDevice = () => {
-    if (typeof navigator === 'undefined' || !navigator.userAgent) {
-        return false; // Cannot determine without navigator.userAgent
-    }
-    return /android|webos|iphone|ipad|ipod|blackberry|iemobile|opera mini/i.test(navigator.userAgent.toLowerCase());
-};
-/**
- * Converts a simple {r, g, b, a} object to a BabylonJS Color4 object.
- * Handles potential undefined input. Alpha defaults to 1 if not provided.
- * @param colorObj - The color object { r, g, b, a? } (values 0-1).
- * @param defaultColor - The default Color4 to return if input is invalid.
- * @returns A BabylonJS Color4 object.
- */
-const toColor4 = (colorObj, defaultColor = new Color4(1, 1, 1, 1) // Default to opaque white
-) => {
-    if (colorObj && typeof colorObj.r === 'number' && typeof colorObj.g === 'number' && typeof colorObj.b === 'number') {
-        const alpha = typeof colorObj.a === 'number' ? colorObj.a : 1.0;
-        return new Color4(colorObj.r, colorObj.g, colorObj.b, alpha);
-    }
-    return defaultColor;
-};
-/**
- * Converts a simple {x, y, z} object to a BabylonJS Vector3 object.
- * Handles potential undefined input.
- * @param vecObj - The vector object { x, y, z }.
- * @param defaultVector - The default Vector3 to return if input is invalid.
- * @returns A BabylonJS Vector3 object.
- */
-const toVector3 = (vecObj, defaultVector = new Vector3(0, 0, 0) // Default to origin
-) => {
-    if (vecObj && typeof vecObj.x === 'number' && typeof vecObj.y === 'number' && typeof vecObj.z === 'number') {
-        return new Vector3(vecObj.x, vecObj.y, vecObj.z);
-    }
-    return defaultVector;
-};
-/**
- * Converts a simple {_x, _y, _z, _w} object to a BabylonJS Quaternion object.
- * Handles potential undefined input.
- * @param quatObj - The quaternion object { _x, _y, _z, _w }.
- * @param defaultQuaternion - The default Quaternion to return if input is invalid.
- * @returns A BabylonJS Quaternion object.
+ * Class used to store geometry data (vertex buffers + index buffer)
  */
-const toQuaternion = (quatObj, defaultQuaternion = Quaternion.Identity() // Default to identity
-) => {
-    if (quatObj && typeof quatObj._x === 'number' && typeof quatObj._y === 'number' && typeof quatObj._z === 'number' && typeof quatObj._w === 'number') {
-        return new Quaternion(quatObj._x, quatObj._y, quatObj._z, quatObj._w);
+class Geometry {
+    /**
+     *  Gets or sets the Bias Vector to apply on the bounding elements (box/sphere), the max extend is computed as v += v * bias.x + bias.y, the min is computed as v -= v * bias.x + bias.y
+     */
+    get boundingBias() {
+        return this._boundingBias;
     }
-    return defaultQuaternion;
-};
-/**
- * Converts a hex color string (e.g., "#RRGGBB") to a BabylonJS Color3 object.
- * Handles potential undefined or invalid input.
- * @param hex - The hex color string.
- * @param defaultColor - The default Color3 to return if input is invalid.
- * @returns A BabylonJS Color3 object.
- */
-const hexToColor3 = (hex, defaultColor = new Color3(1, 1, 1) // Default to white
-) => {
-    if (!hex) {
-        return defaultColor;
+    /**
+     *  Gets or sets the Bias Vector to apply on the bounding elements (box/sphere), the max extend is computed as v += v * bias.x + bias.y, the min is computed as v -= v * bias.x + bias.y
+     */
+    set boundingBias(value) {
+        if (this._boundingBias) {
+            this._boundingBias.copyFrom(value);
+        }
+        else {
+            this._boundingBias = value.clone();
+        }
+        this._updateBoundingInfo(true, null);
     }
-    try {
-        return Color3.FromHexString(hex);
+    /**
+     * Static function used to attach a new empty geometry to a mesh
+     * @param mesh defines the mesh to attach the geometry to
+     * @returns the new Geometry
+     */
+    static CreateGeometryForMesh(mesh) {
+        const geometry = new Geometry(Geometry.RandomId(), mesh.getScene());
+        geometry.applyToMesh(mesh);
+        return geometry;
     }
-    catch (error) {
-        console.warn(`Invalid hex color format for hexToColor3: ${hex}. Using default.`, error);
-        return defaultColor;
+    /** Get the list of meshes using this geometry */
+    get meshes() {
+        return this._meshes;
     }
-};
-/**
- * Applies opacity to a mesh and its children's materials.
- * Handles StandardMaterial and potentially PBRMaterial alpha/transparencyMode.
- * @param mesh - The root mesh to apply opacity to.
- * @param opacity - The opacity value (0-1).
- */
-function applyOpacityToMeshAndChildren(mesh, opacity) {
-    if (!mesh)
-        return;
-    const applyToMaterial = (material) => {
-        if (material) {
-            const clampedOpacity = Math.max(0, Math.min(1, opacity)); // Ensure opacity is 0-1
-            // StandardMaterial
-            if ('alpha' in material) {
-                material.alpha = clampedOpacity;
-            }
-            // PBRMaterial - requires transparencyMode adjustment
-            if ('transparencyMode' in material) {
-                const pbrMaterial = material;
-                if (clampedOpacity < 1) {
-                    // Use ALPHABLEND (numeric value 2) if transparent
-                    pbrMaterial.transparencyMode = 2; // BABYLON.Constants.PBRMATERIAL_ALPHABLEND;
-                    pbrMaterial.alpha = clampedOpacity;
-                }
-                else {
-                    // Reset to opaque if opacity is 1
-                    pbrMaterial.transparencyMode = null; // Or 0 for OPAQUE
-                    pbrMaterial.alpha = 1;
-                }
-            }
+    /**
+     * Creates a new geometry
+     * @param id defines the unique ID
+     * @param scene defines the hosting scene
+     * @param vertexData defines the VertexData used to get geometry data
+     * @param updatable defines if geometry must be updatable (false by default)
+     * @param mesh defines the mesh that will be associated with the geometry
+     */
+    constructor(id, scene, vertexData, updatable = false, mesh = null) {
+        /**
+         * Gets the delay loading state of the geometry (none by default which means not delayed)
+         */
+        this.delayLoadState = 0;
+        this._totalVertices = 0;
+        this._isDisposed = false;
+        this._extend = {
+            minimum: new Vector3(-Number.MAX_VALUE, -Number.MAX_VALUE, -Number.MAX_VALUE),
+            maximum: new Vector3(Number.MAX_VALUE, Number.MAX_VALUE, Number.MAX_VALUE),
+        };
+        this._indexBufferIsUpdatable = false;
+        this._positionsCache = [];
+        /** @internal */
+        this._parentContainer = null;
+        /**
+         * If set to true (false by default), the bounding info applied to the meshes sharing this geometry will be the bounding info defined at the class level
+         * and won't be computed based on the vertex positions (which is what we get when useBoundingInfoFromGeometry = false)
+         */
+        this.useBoundingInfoFromGeometry = false;
+        this._scene = scene || EngineStore.LastCreatedScene;
+        if (!this._scene) {
+            return;
         }
-    };
-    // Apply to the mesh's own material
-    applyToMaterial(mesh.material);
-    // Apply to materials of direct child meshes recursively (optional, depending on need)
-    // If you only want direct children, use getChildMeshes(true)
-    // If you want all descendants, use getChildMeshes(false) - potentially expensive
-    const children = mesh.getChildMeshes ? mesh.getChildMeshes(true) : []; // Direct children only
-    children.forEach(childMesh => {
-        applyOpacityToMeshAndChildren(childMesh, opacity); // Recursive call
-    });
-}
-
-/**
- * Initializes the BabylonJS Engine and Scene.
- * Attempts to use WebGPU first, falling back to WebGL2.
- * @param canvas - The HTML canvas element to render to.
- * @param data - The StorySplat data containing scene properties.
- * @param options - Viewer configuration options.
- * @returns A promise resolving with the initialized engine and scene, or rejecting on failure.
- */
-async function initializeSceneAndEngine(canvas, data, options // Allow passing disableWebGPU internally
-) {
-    var _a;
-    // Ensure canvas fills its container
-    canvas.style.width = '100%';
-    canvas.style.height = '100%';
-    canvas.style.display = 'block';
-    canvas.style.verticalAlign = 'bottom'; // Prevent extra space below canvas
-    let engine;
-    const disableWebGPU = (_a = options === null || options === void 0 ? void 0 : options.disableWebGPU) !== null && _a !== void 0 ? _a : false;
-    if (disableWebGPU) {
-        // Force WebGL2
-        try {
-            engine = new Engine(canvas, true);
-            console.log("StorySplat Viewer: WebGPU disabled by option, using WebGL2.");
+        this.id = id;
+        this.uniqueId = this._scene.getUniqueId();
+        this._engine = this._scene.getEngine();
+        this._meshes = [];
+        //Init vertex buffer cache
+        this._vertexBuffers = {};
+        this._indices = [];
+        this._updatable = updatable;
+        // vertexData
+        if (vertexData) {
+            this.setAllVerticesData(vertexData, updatable);
         }
-        catch (err) {
-            console.error("StorySplat Viewer: Failed to initialize WebGL2 engine:", err);
-            throw new Error("Failed to initialize WebGL2 engine.");
+        else {
+            this._totalVertices = 0;
         }
-    }
-    else {
-        // Try WebGPU first, then fallback
-        try {
-            // Check if running in a secure context, required for WebGPU
-            if (!window.isSecureContext) {
-                throw new Error("WebGPU requires a secure context (HTTPS or localhost).");
-            }
-            if (WebGPUEngine && WebGPUEngine.IsSupportedAsync) {
-                const supported = await WebGPUEngine.IsSupportedAsync;
-                if (supported) {
-                    const webgpuEngine = new WebGPUEngine(canvas, {
-                        // Explicitly request high-performance adapter
-                        powerPreference: "high-performance",
-                        // Enable validation in development environments if needed
-                        // enableAllFeatures: true // Use cautiously, might impact performance
-                    });
-                    await webgpuEngine.initAsync();
-                    engine = webgpuEngine; // Use double assertion
-                    console.log("StorySplat Viewer: WebGPU engine initialized.");
-                }
-                else {
-                    throw new Error("WebGPU is not supported on this browser/device.");
-                }
-            }
-            else {
-                throw new Error("WebGPUEngine not available or IsSupportedAsync missing.");
-            }
+        if (this._engine.getCaps().vertexArrayObject) {
+            this._vertexArrayObjects = {};
         }
-        catch (err) {
-            // Fallback to WebGL2 if WebGPU fails or is unavailable
-            console.warn("StorySplat Viewer: WebGPU unavailable or initialization failed, falling back to WebGL2:", err);
-            try {
-                engine = new Engine(canvas, true, {
-                // Options for WebGL engine if needed
-                // preserveDrawingBuffer: true, // Example option
-                // stencil: true
-                });
-                console.log("StorySplat Viewer: Initialized WebGL2 engine as fallback.");
-            }
-            catch (webglErr) {
-                console.error("StorySplat Viewer: Failed to initialize WebGL2 engine as fallback:", webglErr);
-                throw new Error("Failed to initialize WebGL2 engine as fallback.");
-            }
+        // applyToMesh
+        if (mesh) {
+            this.applyToMesh(mesh);
+            mesh.computeWorldMatrix(true);
         }
     }
-    if (!engine) {
-        throw new Error("Failed to initialize any Babylon engine.");
+    /**
+     * Gets the current extend of the geometry
+     */
+    get extend() {
+        return this._extend;
     }
-    const scene = new Scene(engine);
-    // Set background color from data or options, default to dark background to match HTML exports
-    const defaultBgColor = new Color4(0.12, 0.12, 0.12, 1.0); // Dark gray background to match HTML exports
-    const bgColorOption = options === null || options === void 0 ? void 0 : options.backgroundColor; // Options still use {r,g,b,a} format
-    if (bgColorOption) {
-        scene.clearColor = toColor4(bgColorOption, defaultBgColor);
+    /**
+     * Gets the hosting scene
+     * @returns the hosting Scene
+     */
+    getScene() {
+        return this._scene;
     }
-    else if (data.backgroundColor) {
-        // Convert hex from data to Color3, then to Color4
-        const defaultColor3 = new Color3(defaultBgColor.r, defaultBgColor.g, defaultBgColor.b); // Create default Color3
-        scene.clearColor = hexToColor3(data.backgroundColor, defaultColor3).toColor4(1.0);
+    /**
+     * Gets the hosting engine
+     * @returns the hosting Engine
+     */
+    getEngine() {
+        return this._engine;
     }
-    else {
-        scene.clearColor = defaultBgColor;
+    /**
+     * Defines if the geometry is ready to use
+     * @returns true if the geometry is ready to be used
+     */
+    isReady() {
+        return this.delayLoadState === 1 || this.delayLoadState === 0;
     }
-    // Ambient color is typically handled by lights (e.g., HemisphericLight groundColor)
-    // Removing direct ambientColor setting from sceneProperties
-    // Set a default ambient if needed, but lightingManager should handle specifics
-    scene.ambientColor = new Color3(0.2, 0.2, 0.2); // Default dim ambient
-    // Add resize listener
-    const resizeHandler = () => {
-        engine.resize();
-    };
-    window.addEventListener("resize", resizeHandler);
-    // Add a cleanup function to the scene context
-    scene.onDisposeObservable.addOnce(() => {
-        console.log("StorySplat Viewer: Disposing scene, removing resize listener.");
-        window.removeEventListener("resize", resizeHandler);
-        // Engine disposal is handled separately in the destroy function
-    });
-    return { engine, scene };
-}
-
-// Removed import for shared wheelHandler
-const DEFAULT_CAMERA_POSITION = new Vector3(0, 1.6, -5);
-const DEFAULT_CAMERA_TARGET = Vector3.Zero();
-const DEFAULT_FOV = 0.8;
-const DEFAULT_MIN_Z = 0.1;
-const DEFAULT_MAX_Z = 1000;
-const DEFAULT_SPEED = 0.1;
-const DEFAULT_INERTIA = 0.9;
-const DEFAULT_ANGULAR_SENSIBILITY = 2000;
-// Removed DEFAULT_WHEEL_DELTA_PERCENTAGE and DEFAULT_WHEEL_STEP as they are handled by shared handler or options
-// Walk Mode Defaults
-const DEFAULT_APPLY_GRAVITY = true;
-const DEFAULT_ELLIPSOID = new Vector3(0.5, 0.9, 0.5);
-const DEFAULT_GRAVITY = -9.81;
-class CameraManager {
-    constructor(canvas, scene, data, options, // Correct options parameter
-    analyticsManager // Correct analyticsManager parameter
-    ) {
-        var _a, _b, _c;
-        this._camera = null;
-        this._currentMode = 'explore';
-        this._uiManager = null; // Add UIManager reference
-        this._analyticsManager = null; // Add AnalyticsManager reference
-        this._canvas = canvas;
-        this._scene = scene;
-        this._data = data; // Store data object
-        this._viewerOptions = options;
-        this._analyticsManager = analyticsManager || null; // Store analytics manager
-        // this._uiManager = uiManager || null; // Don't store here initially
-        this._isMobile = isMobileDevice();
-        this._initializeCamera();
-        // Prioritize initial mode from data, then options, then default to 'explore'
-        const initialMode = (_c = (_a = this._data.initialCameraMode) !== null && _a !== void 0 ? _a : (_b = this._viewerOptions) === null || _b === void 0 ? void 0 : _b.defaultCameraMode) !== null && _c !== void 0 ? _c : 'explore';
-        this.setCameraMode(initialMode, true); // Assert type as CameraMode
-        this._setupSceneDispose();
-        // Removed _setupCustomWheelInput call
+    /**
+     * Gets a value indicating that the geometry should not be serialized
+     */
+    get doNotSerialize() {
+        for (let index = 0; index < this._meshes.length; index++) {
+            if (!this._meshes[index].doNotSerialize) {
+                return false;
+            }
+        }
+        return true;
     }
-    get camera() {
-        return this._camera;
+    /** @internal */
+    _rebuild() {
+        if (this._vertexArrayObjects) {
+            this._vertexArrayObjects = {};
+        }
+        // Index buffer
+        if (this._meshes.length !== 0 && this._indices) {
+            this._indexBuffer = this._engine.createIndexBuffer(this._indices, this._updatable, "Geometry_" + this.id + "_IndexBuffer");
+        }
+        // Vertex buffers
+        const buffers = new Set();
+        for (const key in this._vertexBuffers) {
+            buffers.add(this._vertexBuffers[key].getWrapperBuffer());
+        }
+        buffers.forEach((buffer) => {
+            buffer._rebuild();
+        });
     }
-    get currentMode() {
-        return this._currentMode;
+    /**
+     * Affects all geometry data in one call
+     * @param vertexData defines the geometry data
+     * @param updatable defines if the geometry must be flagged as updatable (false as default)
+     */
+    setAllVerticesData(vertexData, updatable) {
+        vertexData.applyToGeometry(this, updatable);
+        this._notifyUpdate();
     }
-    _initializeCamera() {
-        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _0, _1, _2, _3, _4, _5, _6;
-        let initialPosition = DEFAULT_CAMERA_POSITION;
-        let initialRotation = undefined; // Use rotation instead of target
-        // Try to get initial pose from the first waypoint
-        const firstWaypoint = (_a = this._data.waypoints) === null || _a === void 0 ? void 0 : _a[0];
-        if (firstWaypoint) {
-            initialPosition = new Vector3(firstWaypoint.x, firstWaypoint.y, firstWaypoint.z);
-            initialRotation = toQuaternion(firstWaypoint.rotation); // Use helper
+    /**
+     * Set specific vertex data
+     * @param kind defines the data kind (Position, normal, etc...)
+     * @param data defines the vertex data to use
+     * @param updatable defines if the vertex must be flagged as updatable (false as default)
+     * @param stride defines the stride to use (0 by default). This value is deduced from the kind value if not specified
+     */
+    setVerticesData(kind, data, updatable = false, stride) {
+        if (updatable && Array.isArray(data)) {
+            // to avoid converting to Float32Array at each draw call in engine.updateDynamicVertexBuffer, we make the conversion a single time here
+            data = new Float32Array(data);
         }
-        this._camera = new UniversalCamera("viewerCamera", initialPosition, this._scene);
-        // Set initial rotation if derived from waypoint, otherwise set default target
-        if (initialRotation) {
-            this._camera.rotationQuaternion = initialRotation;
+        const buffer = new VertexBuffer(this._engine, data, kind, {
+            updatable,
+            postponeInternalCreation: this._meshes.length === 0,
+            stride,
+            label: "Geometry_" + this.id + "_" + kind,
+        });
+        this.setVerticesBuffer(buffer);
+    }
+    /**
+     * Removes a specific vertex data
+     * @param kind defines the data kind (Position, normal, etc...)
+     */
+    removeVerticesData(kind) {
+        if (this._vertexBuffers[kind]) {
+            this._vertexBuffers[kind].dispose();
+            delete this._vertexBuffers[kind];
         }
-        else {
-            this._camera.setTarget(DEFAULT_CAMERA_TARGET);
+        if (this._vertexArrayObjects) {
+            this._disposeVertexArrayObjects();
         }
-        // --- Add Standard Inputs ---
-        this._camera.inputs.addKeyboard();
-        this._camera.inputs.addMouse();
-        if (this._isMobile) {
-            this._camera.inputs.addTouch();
+    }
+    /**
+     * Affect a vertex buffer to the geometry. the vertexBuffer.getKind() function is used to determine where to store the data
+     * @param buffer defines the vertex buffer to use
+     * @param totalVertices defines the total number of vertices for position kind (could be null)
+     * @param disposeExistingBuffer disposes the existing buffer, if any (default: true)
+     */
+    setVerticesBuffer(buffer, totalVertices = null, disposeExistingBuffer = true) {
+        const kind = buffer.getKind();
+        if (this._vertexBuffers[kind] && disposeExistingBuffer) {
+            this._vertexBuffers[kind].dispose();
         }
-        // Keyboard bindings need to be set *after* inputs are added
-        this._setKeyboardInputs();
-        // --- Apply Common Settings ---
-        // Get settings from data (StorySplatData) or options (ViewerOptions)
-        this._camera.fov = (_b = this._data.fov) !== null && _b !== void 0 ? _b : DEFAULT_FOV; // FOV comes from data only
-        this._camera.minZ = (_e = (_d = (_c = this._viewerOptions) === null || _c === void 0 ? void 0 : _c.cameraMinZ) !== null && _d !== void 0 ? _d : this._data.minClipPlane) !== null && _e !== void 0 ? _e : DEFAULT_MIN_Z; // Use minClipPlane from data
-        this._camera.maxZ = (_h = (_g = (_f = this._viewerOptions) === null || _f === void 0 ? void 0 : _f.cameraMaxZ) !== null && _g !== void 0 ? _g : this._data.maxClipPlane) !== null && _h !== void 0 ? _h : DEFAULT_MAX_Z; // Use maxClipPlane from data
-        this._camera.speed = (_l = (_k = (_j = this._viewerOptions) === null || _j === void 0 ? void 0 : _j.cameraSpeed) !== null && _k !== void 0 ? _k : this._data.cameraMovementSpeed) !== null && _l !== void 0 ? _l : DEFAULT_SPEED; // Use cameraMovementSpeed from data
-        this._camera.inertia = (_o = (_m = this._viewerOptions) === null || _m === void 0 ? void 0 : _m.cameraInertia) !== null && _o !== void 0 ? _o : DEFAULT_INERTIA; // Inertia likely only in options
-        // Map cameraRotationSensitivity from data to angularSensibility if options don't provide it
-        const angularSensibility = (_q = (_p = this._viewerOptions) === null || _p === void 0 ? void 0 : _p.cameraAngularSensibility) !== null && _q !== void 0 ? _q : (this._data.cameraRotationSensitivity ? (DEFAULT_ANGULAR_SENSIBILITY / (this._data.cameraRotationSensitivity / 4000)) : DEFAULT_ANGULAR_SENSIBILITY); // Simple scaling based on default
-        this._camera.angularSensibility = angularSensibility;
-        this._camera.touchAngularSensibility = (_s = (_r = this._viewerOptions) === null || _r === void 0 ? void 0 : _r.cameraTouchAngularSensibility) !== null && _s !== void 0 ? _s : angularSensibility; // Use same sensitivity for touch by default
-        // Apply Y-axis inversion by negating sensitivity if needed
-        const shouldInvert = (_v = (_u = (_t = this._viewerOptions) === null || _t === void 0 ? void 0 : _t.invertCameraRotation) !== null && _u !== void 0 ? _u : this._data.invertCameraRotation) !== null && _v !== void 0 ? _v : false;
-        if (shouldInvert) {
-            this._camera.angularSensibility *= -1;
-            this._camera.touchAngularSensibility *= -1;
-            console.log("StorySplat Viewer: Inverting camera Y-axis rotation.");
+        if (buffer._buffer && buffer._ownsBuffer) {
+            buffer._buffer._increaseReferences();
         }
-        // --- Wheel Input ---
-        // Default wheel input is now used unless options customize it elsewhere.
-        // No need to remove default or handle custom wheel here.
-        // Initial collision/gravity state
-        this._camera.checkCollisions = false;
-        this._camera.applyGravity = false;
-        // Ellipsoid primarily from options
-        this._camera.ellipsoid = ((_w = this._viewerOptions) === null || _w === void 0 ? void 0 : _w.cameraEllipsoid) ? toVector3(this._viewerOptions.cameraEllipsoid) : DEFAULT_ELLIPSOID.clone();
-        // Gravity primarily from options
-        const sceneGravityY = (_y = (_x = this._scene.gravity) === null || _x === void 0 ? void 0 : _x.y) !== null && _y !== void 0 ? _y : ((_0 = (_z = this._viewerOptions) === null || _z === void 0 ? void 0 : _z.gravity) !== null && _0 !== void 0 ? _0 : DEFAULT_GRAVITY);
-        this._scene.gravity = new Vector3(0, sceneGravityY, 0);
-        // Enable scene collisions if needed - removed checks for _initialSettings
-        if (((_2 = (_1 = this._viewerOptions) === null || _1 === void 0 ? void 0 : _1.allowedCameraModes) === null || _2 === void 0 ? void 0 : _2.includes('walk')) ||
-            ((_3 = this._viewerOptions) === null || _3 === void 0 ? void 0 : _3.defaultCameraMode) === 'walk' ||
-            ((_4 = this._viewerOptions) === null || _4 === void 0 ? void 0 : _4.exploreCollisions) ||
-            ((_5 = this._viewerOptions) === null || _5 === void 0 ? void 0 : _5.walkCollisions) ||
-            ((_6 = this._viewerOptions) === null || _6 === void 0 ? void 0 : _6.cameraEllipsoid) || // Check if ellipsoid is defined in options
-            this._scene.collisionsEnabled) {
-            this._scene.collisionsEnabled = true;
-            console.log("StorySplat Viewer: Scene collisions enabled for camera.");
+        this._vertexBuffers[kind] = buffer;
+        const meshes = this._meshes;
+        const numOfMeshes = meshes.length;
+        if (kind === VertexBuffer.PositionKind) {
+            this._totalVertices = totalVertices ?? buffer._maxVerticesCount;
+            this._updateExtend(buffer.getFloatData(this._totalVertices));
+            this._resetPointsArrayCache();
+            // this._extend can be empty if buffer.getFloatData(this._totalVertices) returned null
+            const minimum = (this._extend && this._extend.minimum) || new Vector3(-Number.MAX_VALUE, -Number.MAX_VALUE, -Number.MAX_VALUE);
+            const maximum = (this._extend && this._extend.maximum) || new Vector3(Number.MAX_VALUE, Number.MAX_VALUE, Number.MAX_VALUE);
+            for (let index = 0; index < numOfMeshes; index++) {
+                const mesh = meshes[index];
+                mesh.buildBoundingInfo(minimum, maximum);
+                mesh._createGlobalSubMesh(mesh.isUnIndexed);
+                mesh.computeWorldMatrix(true);
+                mesh.synchronizeInstances();
+            }
         }
-    }
-    setCameraMode(mode, immediate = false) {
-        var _a, _b, _c, _d, _e, _f, _g;
-        if (!this._camera)
-            return;
-        const allowedModes = (_b = (_a = this._viewerOptions) === null || _a === void 0 ? void 0 : _a.allowedCameraModes) !== null && _b !== void 0 ? _b : ['explore', 'walk', 'tour', 'hybrid'];
-        if (!allowedModes.includes(mode)) {
-            console.warn(`StorySplat Viewer: Camera mode "${mode}" is not allowed by options. Allowed: [${allowedModes.join(', ')}]`);
-            return;
-        }
-        const oldMode = this._currentMode;
-        if (oldMode === mode && !immediate)
-            return;
-        console.log(`StorySplat Viewer: Setting camera mode to ${mode}`);
-        this._currentMode = mode;
-        // Detach controls before reconfiguring
-        this._camera.detachControl();
-        // Reset mode-specific properties
-        this._camera.checkCollisions = false;
-        this._camera.applyGravity = false;
-        // Inputs are now added during initialization and persist.
-        // No need to remove/re-add input types here.
-        // detachControl/attachControl handles focus.
-        switch (mode) {
-            case 'explore':
-                this._configureExploreMode();
-                break;
-            case 'walk':
-                this._configureWalkMode();
-                break;
-            case 'tour':
-            case 'hybrid':
-                this._configureTourMode();
-                break;
-            default:
-                console.warn(`StorySplat Viewer: Unknown camera mode "${mode}". Defaulting to explore.`);
-                this._configureExploreMode();
-                this._currentMode = 'explore';
-        }
-        // Re-attach controls if globally enabled
-        if (((_c = this._viewerOptions) === null || _c === void 0 ? void 0 : _c.cameraControls) !== false) {
-            this._camera.attachControl(this._canvas, true);
-            // Removed DEBUG log
-            // Inputs are added during initialization, attachControl manages focus.
-        }
-        else {
-            console.log("StorySplat Viewer: Camera controls globally disabled by options.");
-            // No activation needed if controls are disabled
-        }
-        // Trigger callback and update UI
-        if (oldMode !== mode) {
-            (_e = (_d = this._viewerOptions) === null || _d === void 0 ? void 0 : _d.onCameraModeChanged) === null || _e === void 0 ? void 0 : _e.call(_d, mode);
-            (_f = this.onCameraModeChange) === null || _f === void 0 ? void 0 : _f.call(this, mode); // Call the new callback
-            (_g = this._analyticsManager) === null || _g === void 0 ? void 0 : _g.trackCameraModeChange(oldMode, mode); // Track event
-            this._updateUIManager(); // Notify UI Manager of the change
-        }
-    }
-    _configureExploreMode() {
-        var _a, _b;
-        if (!this._camera)
-            return;
-        this._camera.checkCollisions = (_b = (_a = this._viewerOptions) === null || _a === void 0 ? void 0 : _a.exploreCollisions) !== null && _b !== void 0 ? _b : false;
-        this._camera.applyGravity = false;
-        // Inputs are now managed globally during initialization.
-        // This method only sets mode-specific camera properties.
-        console.log("Explore mode configured: Collisions=" + this._camera.checkCollisions);
-    }
-    _configureWalkMode() {
-        var _a, _b, _c, _d, _e, _f, _g;
-        if (!this._camera)
-            return;
-        this._camera.checkCollisions = (_b = (_a = this._viewerOptions) === null || _a === void 0 ? void 0 : _a.walkCollisions) !== null && _b !== void 0 ? _b : true;
-        this._camera.applyGravity = (_d = (_c = this._viewerOptions) === null || _c === void 0 ? void 0 : _c.walkApplyGravity) !== null && _d !== void 0 ? _d : DEFAULT_APPLY_GRAVITY;
-        // Gravity primarily from options
-        const sceneGravityY = (_f = (_e = this._viewerOptions) === null || _e === void 0 ? void 0 : _e.gravity) !== null && _f !== void 0 ? _f : DEFAULT_GRAVITY; // Already checks options
-        this._scene.gravity = new Vector3(0, sceneGravityY, 0);
-        // Ellipsoid primarily from options
-        this._camera.ellipsoid = ((_g = this._viewerOptions) === null || _g === void 0 ? void 0 : _g.cameraEllipsoid) ? toVector3(this._viewerOptions.cameraEllipsoid) : DEFAULT_ELLIPSOID.clone(); // Already checks options
-        // Inputs are now managed globally during initialization.
-        // This method only sets mode-specific camera properties.
-        console.log(`Walk mode configured: Gravity=${this._camera.applyGravity}, Collisions=${this._camera.checkCollisions}`);
-    }
-    _configureTourMode() {
-        if (!this._camera)
-            return;
-        this._camera.checkCollisions = false;
-        this._camera.applyGravity = false;
-        // Inputs are now managed globally during initialization.
-        // Mouse/Touch rotation is handled by the default inputs added earlier.
-        // This method only sets mode-specific camera properties.
-        console.log("Tour/Hybrid mode configured: No gravity, no collisions.");
-    }
-    // Helper to set standard keyboard bindings
-    _setKeyboardInputs() {
-        if (!this._camera)
-            return;
-        const input = this._camera.inputs.attached.keyboard; // Use specific type
-        if (input) {
-            // Clear existing potentially conflicting bindings (optional but safer)
-            input.keysUp = [];
-            input.keysDown = [];
-            input.keysLeft = [];
-            input.keysRight = [];
-            input.keysUpward = [];
-            input.keysDownward = [];
-            // Standard WASD / Arrow Keys
-            input.keysUp.push(87, 38); // W, Up Arrow
-            input.keysDown.push(83, 40); // S, Down Arrow
-            input.keysLeft.push(65, 37); // A, Left Arrow
-            input.keysRight.push(68, 39); // D, Right Arrow
-            // Add Q/E for vertical movement
-            input.keysUpward = [69]; // E key for up
-            input.keysDownward = [81]; // Q key for down
-        }
-    }
-    // --- Custom Mouse Wheel Input Handling Removed ---
-    // The default FreeCameraMouseWheelInput is now used.
-    _setupSceneDispose() {
-        this._scene.onDisposeObservable.addOnce(() => {
-            console.log("StorySplat Viewer: Disposing camera manager and camera.");
-            // No need to remove custom wheel listener anymore
-            this._camera = null;
-        });
-    }
-    // --- UI Update Helper ---
-    _updateUIManager() {
-        if (!this._uiManager)
-            return;
-        this._uiManager.updateModeToggleButtons();
-        this._uiManager.updateExploreWalkToggleButtons();
-        this._uiManager.updateScrollControlsVisibility();
-    }
-    // --- Public API Methods ---
-    // Method to set the UIManager after instantiation
-    setUIManager(uiManager) {
-        this._uiManager = uiManager;
-        // Update UI immediately after manager is set
-        this._updateUIManager();
-    }
-    setPosition(position) {
-        if (this._camera) {
-            this._camera.position = position;
-        }
-    }
-    setTarget(target) {
-        if (this._camera) {
-            this._camera.setTarget(target);
-        }
-    }
-}
-
-// Import necessary loaders for .splat files (assuming it uses GLTF internally or a custom loader is registered)
-// If @babylonjs/loaders is needed and not globally imported, ensure it's imported somewhere,
-// e.g., in the main index.ts or here. For now, assume SceneLoader handles it.
-// import "@babylonjs/loaders/glTF"; // Example if GLTF loader is needed explicitly
-/**
- * Loads the primary Gaussian Splat asset into the scene.
- * @param scene - The BabylonJS scene to load the asset into.
- * @param data - The StorySplat data containing the model URL and scaling info.
- * @param onProgress - Optional callback function to report loading progress.
- *                   Receives percentage (0-100) and an optional status text.
- * @returns A promise that resolves with an array of the loaded AbstractMesh objects.
- */
-async function loadSplatAsset(scene, data, onProgress // Updated signature
-) {
-    var _a, _b, _c;
-    const modelUrl = data.loadedModelUrl; // Changed from modelUrl
-    if (!modelUrl) {
-        console.error("StorySplat Viewer: No loadedModelUrl provided in data.");
-        return Promise.reject(new Error("No loadedModelUrl provided in StorySplatData."));
-    }
-    const splatScale = (_a = data.splatScale) !== null && _a !== void 0 ? _a : 1.0;
-    const invertX = (_b = data.invertXScale) !== null && _b !== void 0 ? _b : false;
-    const invertY = (_c = data.invertYScale) !== null && _c !== void 0 ? _c : false;
-    console.log(`StorySplat Viewer: Loading splat asset from ${modelUrl}`);
-    try {
-        // Debug: Check what loaders are registered
-        console.log("StorySplat Viewer: Available SceneLoader plugins:", Object.keys(SceneLoader._RegisteredPlugins || {}));
-        const result = await SceneLoader.ImportMeshAsync("", // meshNames - empty string loads all
-        modelUrl, // rootUrl - the full URL
-        "", // sceneFilename - empty when using full URL
-        scene, (progressEvent) => {
-            if (onProgress) {
-                // Calculate percentage, handle indeterminate state
-                let percentage = 0;
-                if (progressEvent.lengthComputable && progressEvent.total > 0) {
-                    percentage = (progressEvent.loaded / progressEvent.total) * 100;
-                }
-                else if (progressEvent.loaded > 0) {
-                    // If not lengthComputable but loaded > 0, maybe indicate activity?
-                    // This part is tricky without total size. Could use a spinner state.
-                    // For simplicity, we'll report 0 or the calculated percentage.
-                }
-                // Report percentage and potentially a status text
-                const statusText = progressEvent.lengthComputable ? `${(progressEvent.loaded / 1024 / 1024).toFixed(2)}MB / ${(progressEvent.total / 1024 / 1024).toFixed(2)}MB` : 'Loading...';
-                onProgress(Math.round(percentage), statusText);
-            }
-        });
-        if (!result.meshes || result.meshes.length === 0) {
-            throw new Error(`No meshes found in the loaded asset: ${modelUrl}`);
-        }
-        console.log(`StorySplat Viewer: Successfully loaded ${result.meshes.length} meshes from ${modelUrl}.`);
-        result.meshes.forEach((mesh) => {
-            // Ensure the mesh is visible and pickable
-            mesh.isVisible = true;
-            mesh.isPickable = true; // Important for interactions like hotspots if they attach to splats
-            // Apply scaling and inversion
-            const scaleX = splatScale * (invertX ? -1 : 1);
-            const scaleY = splatScale * (invertY ? -1 : 1);
-            // Invert Z if only one of X or Y is inverted to maintain handedness
-            // If both inverted or neither inverted, Z scale matches splatScale sign
-            const scaleZ = splatScale * ((invertX !== invertY) ? -1 : 1);
-            mesh.scaling.set(scaleX, scaleY, scaleZ);
-            // Optional: Set collision properties if needed later
-            // mesh.checkCollisions = true; // Enable collisions if required
-            // Optional: Assign a name based on the URL for easier identification
-            mesh.name = `splatRoot_${modelUrl}`; // Name the root mesh if possible
-        });
-        // Add cleanup logic for the loaded meshes
-        const loadedMeshes = result.meshes; // Capture the meshes in this scope
-        const disposeObserver = scene.onDisposeObservable.addOnce(() => {
-            console.log(`StorySplat Viewer: Disposing splat asset: ${modelUrl}`);
-            loadedMeshes.forEach(mesh => {
-                if (mesh && !mesh.isDisposed()) {
-                    // Check parentage - only dispose root nodes added by the loader?
-                    // Or dispose all meshes returned by the loader. Assuming the latter for now.
-                    mesh.dispose(false, true); // Dispose mesh, materials, textures
-                }
-            });
-        });
-        // Store the observer reference on the meshes or a manager if needed for explicit cleanup later
-        // e.g., loadedMeshes[0].metadata = { disposeObserver };
-        return loadedMeshes;
-    }
-    catch (error) {
-        console.error(`StorySplat Viewer: Error loading splat asset from ${modelUrl}:`, error);
-        // Propagate the error
-        throw error;
-    }
-}
-
-/**
- * Class used to store geometry data (vertex buffers + index buffer)
- */
-class Geometry {
-    /**
-     *  Gets or sets the Bias Vector to apply on the bounding elements (box/sphere), the max extend is computed as v += v * bias.x + bias.y, the min is computed as v -= v * bias.x + bias.y
-     */
-    get boundingBias() {
-        return this._boundingBias;
-    }
-    /**
-     *  Gets or sets the Bias Vector to apply on the bounding elements (box/sphere), the max extend is computed as v += v * bias.x + bias.y, the min is computed as v -= v * bias.x + bias.y
-     */
-    set boundingBias(value) {
-        if (this._boundingBias) {
-            this._boundingBias.copyFrom(value);
-        }
-        else {
-            this._boundingBias = value.clone();
-        }
-        this._updateBoundingInfo(true, null);
-    }
-    /**
-     * Static function used to attach a new empty geometry to a mesh
-     * @param mesh defines the mesh to attach the geometry to
-     * @returns the new Geometry
-     */
-    static CreateGeometryForMesh(mesh) {
-        const geometry = new Geometry(Geometry.RandomId(), mesh.getScene());
-        geometry.applyToMesh(mesh);
-        return geometry;
-    }
-    /** Get the list of meshes using this geometry */
-    get meshes() {
-        return this._meshes;
-    }
-    /**
-     * Creates a new geometry
-     * @param id defines the unique ID
-     * @param scene defines the hosting scene
-     * @param vertexData defines the VertexData used to get geometry data
-     * @param updatable defines if geometry must be updatable (false by default)
-     * @param mesh defines the mesh that will be associated with the geometry
-     */
-    constructor(id, scene, vertexData, updatable = false, mesh = null) {
-        /**
-         * Gets the delay loading state of the geometry (none by default which means not delayed)
-         */
-        this.delayLoadState = 0;
-        this._totalVertices = 0;
-        this._isDisposed = false;
-        this._extend = {
-            minimum: new Vector3(-Number.MAX_VALUE, -Number.MAX_VALUE, -Number.MAX_VALUE),
-            maximum: new Vector3(Number.MAX_VALUE, Number.MAX_VALUE, Number.MAX_VALUE),
-        };
-        this._indexBufferIsUpdatable = false;
-        this._positionsCache = [];
-        /** @internal */
-        this._parentContainer = null;
-        /**
-         * If set to true (false by default), the bounding info applied to the meshes sharing this geometry will be the bounding info defined at the class level
-         * and won't be computed based on the vertex positions (which is what we get when useBoundingInfoFromGeometry = false)
-         */
-        this.useBoundingInfoFromGeometry = false;
-        this._scene = scene || EngineStore.LastCreatedScene;
-        if (!this._scene) {
-            return;
-        }
-        this.id = id;
-        this.uniqueId = this._scene.getUniqueId();
-        this._engine = this._scene.getEngine();
-        this._meshes = [];
-        //Init vertex buffer cache
-        this._vertexBuffers = {};
-        this._indices = [];
-        this._updatable = updatable;
-        // vertexData
-        if (vertexData) {
-            this.setAllVerticesData(vertexData, updatable);
-        }
-        else {
-            this._totalVertices = 0;
-        }
-        if (this._engine.getCaps().vertexArrayObject) {
-            this._vertexArrayObjects = {};
-        }
-        // applyToMesh
-        if (mesh) {
-            this.applyToMesh(mesh);
-            mesh.computeWorldMatrix(true);
-        }
-    }
-    /**
-     * Gets the current extend of the geometry
-     */
-    get extend() {
-        return this._extend;
-    }
-    /**
-     * Gets the hosting scene
-     * @returns the hosting Scene
-     */
-    getScene() {
-        return this._scene;
-    }
-    /**
-     * Gets the hosting engine
-     * @returns the hosting Engine
-     */
-    getEngine() {
-        return this._engine;
-    }
-    /**
-     * Defines if the geometry is ready to use
-     * @returns true if the geometry is ready to be used
-     */
-    isReady() {
-        return this.delayLoadState === 1 || this.delayLoadState === 0;
-    }
-    /**
-     * Gets a value indicating that the geometry should not be serialized
-     */
-    get doNotSerialize() {
-        for (let index = 0; index < this._meshes.length; index++) {
-            if (!this._meshes[index].doNotSerialize) {
-                return false;
-            }
-        }
-        return true;
-    }
-    /** @internal */
-    _rebuild() {
-        if (this._vertexArrayObjects) {
-            this._vertexArrayObjects = {};
-        }
-        // Index buffer
-        if (this._meshes.length !== 0 && this._indices) {
-            this._indexBuffer = this._engine.createIndexBuffer(this._indices, this._updatable, "Geometry_" + this.id + "_IndexBuffer");
-        }
-        // Vertex buffers
-        const buffers = new Set();
-        for (const key in this._vertexBuffers) {
-            buffers.add(this._vertexBuffers[key].getWrapperBuffer());
-        }
-        buffers.forEach((buffer) => {
-            buffer._rebuild();
-        });
-    }
-    /**
-     * Affects all geometry data in one call
-     * @param vertexData defines the geometry data
-     * @param updatable defines if the geometry must be flagged as updatable (false as default)
-     */
-    setAllVerticesData(vertexData, updatable) {
-        vertexData.applyToGeometry(this, updatable);
-        this._notifyUpdate();
-    }
-    /**
-     * Set specific vertex data
-     * @param kind defines the data kind (Position, normal, etc...)
-     * @param data defines the vertex data to use
-     * @param updatable defines if the vertex must be flagged as updatable (false as default)
-     * @param stride defines the stride to use (0 by default). This value is deduced from the kind value if not specified
-     */
-    setVerticesData(kind, data, updatable = false, stride) {
-        if (updatable && Array.isArray(data)) {
-            // to avoid converting to Float32Array at each draw call in engine.updateDynamicVertexBuffer, we make the conversion a single time here
-            data = new Float32Array(data);
-        }
-        const buffer = new VertexBuffer(this._engine, data, kind, {
-            updatable,
-            postponeInternalCreation: this._meshes.length === 0,
-            stride,
-            label: "Geometry_" + this.id + "_" + kind,
-        });
-        this.setVerticesBuffer(buffer);
-    }
-    /**
-     * Removes a specific vertex data
-     * @param kind defines the data kind (Position, normal, etc...)
-     */
-    removeVerticesData(kind) {
-        if (this._vertexBuffers[kind]) {
-            this._vertexBuffers[kind].dispose();
-            delete this._vertexBuffers[kind];
-        }
-        if (this._vertexArrayObjects) {
-            this._disposeVertexArrayObjects();
-        }
-    }
-    /**
-     * Affect a vertex buffer to the geometry. the vertexBuffer.getKind() function is used to determine where to store the data
-     * @param buffer defines the vertex buffer to use
-     * @param totalVertices defines the total number of vertices for position kind (could be null)
-     * @param disposeExistingBuffer disposes the existing buffer, if any (default: true)
-     */
-    setVerticesBuffer(buffer, totalVertices = null, disposeExistingBuffer = true) {
-        const kind = buffer.getKind();
-        if (this._vertexBuffers[kind] && disposeExistingBuffer) {
-            this._vertexBuffers[kind].dispose();
-        }
-        if (buffer._buffer && buffer._ownsBuffer) {
-            buffer._buffer._increaseReferences();
-        }
-        this._vertexBuffers[kind] = buffer;
-        const meshes = this._meshes;
-        const numOfMeshes = meshes.length;
-        if (kind === VertexBuffer.PositionKind) {
-            this._totalVertices = totalVertices ?? buffer._maxVerticesCount;
-            this._updateExtend(buffer.getFloatData(this._totalVertices));
-            this._resetPointsArrayCache();
-            // this._extend can be empty if buffer.getFloatData(this._totalVertices) returned null
-            const minimum = (this._extend && this._extend.minimum) || new Vector3(-Number.MAX_VALUE, -Number.MAX_VALUE, -Number.MAX_VALUE);
-            const maximum = (this._extend && this._extend.maximum) || new Vector3(Number.MAX_VALUE, Number.MAX_VALUE, Number.MAX_VALUE);
-            for (let index = 0; index < numOfMeshes; index++) {
-                const mesh = meshes[index];
-                mesh.buildBoundingInfo(minimum, maximum);
-                mesh._createGlobalSubMesh(mesh.isUnIndexed);
-                mesh.computeWorldMatrix(true);
-                mesh.synchronizeInstances();
-            }
-        }
-        this._notifyUpdate(kind);
+        this._notifyUpdate(kind);
     }
     /**
      * Update a specific vertex buffer
@@ -98988,292 +98411,898 @@ class StandardMaterial extends PushMaterial {
     static get EmissiveTextureEnabled() {
         return MaterialFlags.EmissiveTextureEnabled;
     }
-    static set EmissiveTextureEnabled(value) {
-        MaterialFlags.EmissiveTextureEnabled = value;
+    static set EmissiveTextureEnabled(value) {
+        MaterialFlags.EmissiveTextureEnabled = value;
+    }
+    /**
+     * Are specular textures enabled in the application.
+     */
+    static get SpecularTextureEnabled() {
+        return MaterialFlags.SpecularTextureEnabled;
+    }
+    static set SpecularTextureEnabled(value) {
+        MaterialFlags.SpecularTextureEnabled = value;
+    }
+    /**
+     * Are bump textures enabled in the application.
+     */
+    static get BumpTextureEnabled() {
+        return MaterialFlags.BumpTextureEnabled;
+    }
+    static set BumpTextureEnabled(value) {
+        MaterialFlags.BumpTextureEnabled = value;
+    }
+    /**
+     * Are lightmap textures enabled in the application.
+     */
+    static get LightmapTextureEnabled() {
+        return MaterialFlags.LightmapTextureEnabled;
+    }
+    static set LightmapTextureEnabled(value) {
+        MaterialFlags.LightmapTextureEnabled = value;
+    }
+    /**
+     * Are refraction textures enabled in the application.
+     */
+    static get RefractionTextureEnabled() {
+        return MaterialFlags.RefractionTextureEnabled;
+    }
+    static set RefractionTextureEnabled(value) {
+        MaterialFlags.RefractionTextureEnabled = value;
+    }
+    /**
+     * Are color grading textures enabled in the application.
+     */
+    static get ColorGradingTextureEnabled() {
+        return MaterialFlags.ColorGradingTextureEnabled;
+    }
+    static set ColorGradingTextureEnabled(value) {
+        MaterialFlags.ColorGradingTextureEnabled = value;
+    }
+    /**
+     * Are fresnels enabled in the application.
+     */
+    static get FresnelEnabled() {
+        return MaterialFlags.FresnelEnabled;
+    }
+    static set FresnelEnabled(value) {
+        MaterialFlags.FresnelEnabled = value;
+    }
+}
+/**
+ * Force all the standard materials to compile to glsl even on WebGPU engines.
+ * False by default. This is mostly meant for backward compatibility.
+ */
+StandardMaterial.ForceGLSL = false;
+__decorate([
+    serializeAsTexture("diffuseTexture")
+], StandardMaterial.prototype, "_diffuseTexture", void 0);
+__decorate([
+    expandToProperty("_markAllSubMeshesAsTexturesAndMiscDirty")
+], StandardMaterial.prototype, "diffuseTexture", void 0);
+__decorate([
+    serializeAsTexture("ambientTexture")
+], StandardMaterial.prototype, "_ambientTexture", void 0);
+__decorate([
+    expandToProperty("_markAllSubMeshesAsTexturesDirty")
+], StandardMaterial.prototype, "ambientTexture", void 0);
+__decorate([
+    serializeAsTexture("opacityTexture")
+], StandardMaterial.prototype, "_opacityTexture", void 0);
+__decorate([
+    expandToProperty("_markAllSubMeshesAsTexturesAndMiscDirty")
+], StandardMaterial.prototype, "opacityTexture", void 0);
+__decorate([
+    serializeAsTexture("reflectionTexture")
+], StandardMaterial.prototype, "_reflectionTexture", void 0);
+__decorate([
+    expandToProperty("_markAllSubMeshesAsTexturesDirty")
+], StandardMaterial.prototype, "reflectionTexture", void 0);
+__decorate([
+    serializeAsTexture("emissiveTexture")
+], StandardMaterial.prototype, "_emissiveTexture", void 0);
+__decorate([
+    expandToProperty("_markAllSubMeshesAsTexturesDirty")
+], StandardMaterial.prototype, "emissiveTexture", void 0);
+__decorate([
+    serializeAsTexture("specularTexture")
+], StandardMaterial.prototype, "_specularTexture", void 0);
+__decorate([
+    expandToProperty("_markAllSubMeshesAsTexturesDirty")
+], StandardMaterial.prototype, "specularTexture", void 0);
+__decorate([
+    serializeAsTexture("bumpTexture")
+], StandardMaterial.prototype, "_bumpTexture", void 0);
+__decorate([
+    expandToProperty("_markAllSubMeshesAsTexturesDirty")
+], StandardMaterial.prototype, "bumpTexture", void 0);
+__decorate([
+    serializeAsTexture("lightmapTexture")
+], StandardMaterial.prototype, "_lightmapTexture", void 0);
+__decorate([
+    expandToProperty("_markAllSubMeshesAsTexturesDirty")
+], StandardMaterial.prototype, "lightmapTexture", void 0);
+__decorate([
+    serializeAsTexture("refractionTexture")
+], StandardMaterial.prototype, "_refractionTexture", void 0);
+__decorate([
+    expandToProperty("_markAllSubMeshesAsTexturesDirty")
+], StandardMaterial.prototype, "refractionTexture", void 0);
+__decorate([
+    serializeAsColor3("ambient")
+], StandardMaterial.prototype, "ambientColor", void 0);
+__decorate([
+    serializeAsColor3("diffuse")
+], StandardMaterial.prototype, "diffuseColor", void 0);
+__decorate([
+    serializeAsColor3("specular")
+], StandardMaterial.prototype, "specularColor", void 0);
+__decorate([
+    serializeAsColor3("emissive")
+], StandardMaterial.prototype, "emissiveColor", void 0);
+__decorate([
+    serialize()
+], StandardMaterial.prototype, "specularPower", void 0);
+__decorate([
+    serialize("useAlphaFromDiffuseTexture")
+], StandardMaterial.prototype, "_useAlphaFromDiffuseTexture", void 0);
+__decorate([
+    expandToProperty("_markAllSubMeshesAsTexturesAndMiscDirty")
+], StandardMaterial.prototype, "useAlphaFromDiffuseTexture", void 0);
+__decorate([
+    serialize("useEmissiveAsIllumination")
+], StandardMaterial.prototype, "_useEmissiveAsIllumination", void 0);
+__decorate([
+    expandToProperty("_markAllSubMeshesAsTexturesDirty")
+], StandardMaterial.prototype, "useEmissiveAsIllumination", void 0);
+__decorate([
+    serialize("linkEmissiveWithDiffuse")
+], StandardMaterial.prototype, "_linkEmissiveWithDiffuse", void 0);
+__decorate([
+    expandToProperty("_markAllSubMeshesAsTexturesDirty")
+], StandardMaterial.prototype, "linkEmissiveWithDiffuse", void 0);
+__decorate([
+    serialize("useSpecularOverAlpha")
+], StandardMaterial.prototype, "_useSpecularOverAlpha", void 0);
+__decorate([
+    expandToProperty("_markAllSubMeshesAsTexturesDirty")
+], StandardMaterial.prototype, "useSpecularOverAlpha", void 0);
+__decorate([
+    serialize("useReflectionOverAlpha")
+], StandardMaterial.prototype, "_useReflectionOverAlpha", void 0);
+__decorate([
+    expandToProperty("_markAllSubMeshesAsTexturesDirty")
+], StandardMaterial.prototype, "useReflectionOverAlpha", void 0);
+__decorate([
+    serialize("disableLighting")
+], StandardMaterial.prototype, "_disableLighting", void 0);
+__decorate([
+    expandToProperty("_markAllSubMeshesAsLightsDirty")
+], StandardMaterial.prototype, "disableLighting", void 0);
+__decorate([
+    serialize("useObjectSpaceNormalMap")
+], StandardMaterial.prototype, "_useObjectSpaceNormalMap", void 0);
+__decorate([
+    expandToProperty("_markAllSubMeshesAsTexturesDirty")
+], StandardMaterial.prototype, "useObjectSpaceNormalMap", void 0);
+__decorate([
+    serialize("useParallax")
+], StandardMaterial.prototype, "_useParallax", void 0);
+__decorate([
+    expandToProperty("_markAllSubMeshesAsTexturesDirty")
+], StandardMaterial.prototype, "useParallax", void 0);
+__decorate([
+    serialize("useParallaxOcclusion")
+], StandardMaterial.prototype, "_useParallaxOcclusion", void 0);
+__decorate([
+    expandToProperty("_markAllSubMeshesAsTexturesDirty")
+], StandardMaterial.prototype, "useParallaxOcclusion", void 0);
+__decorate([
+    serialize()
+], StandardMaterial.prototype, "parallaxScaleBias", void 0);
+__decorate([
+    serialize("roughness")
+], StandardMaterial.prototype, "_roughness", void 0);
+__decorate([
+    expandToProperty("_markAllSubMeshesAsTexturesDirty")
+], StandardMaterial.prototype, "roughness", void 0);
+__decorate([
+    serialize()
+], StandardMaterial.prototype, "indexOfRefraction", void 0);
+__decorate([
+    serialize()
+], StandardMaterial.prototype, "invertRefractionY", void 0);
+__decorate([
+    serialize()
+], StandardMaterial.prototype, "alphaCutOff", void 0);
+__decorate([
+    serialize("useLightmapAsShadowmap")
+], StandardMaterial.prototype, "_useLightmapAsShadowmap", void 0);
+__decorate([
+    expandToProperty("_markAllSubMeshesAsTexturesDirty")
+], StandardMaterial.prototype, "useLightmapAsShadowmap", void 0);
+__decorate([
+    serializeAsFresnelParameters("diffuseFresnelParameters")
+], StandardMaterial.prototype, "_diffuseFresnelParameters", void 0);
+__decorate([
+    expandToProperty("_markAllSubMeshesAsFresnelDirty")
+], StandardMaterial.prototype, "diffuseFresnelParameters", void 0);
+__decorate([
+    serializeAsFresnelParameters("opacityFresnelParameters")
+], StandardMaterial.prototype, "_opacityFresnelParameters", void 0);
+__decorate([
+    expandToProperty("_markAllSubMeshesAsFresnelAndMiscDirty")
+], StandardMaterial.prototype, "opacityFresnelParameters", void 0);
+__decorate([
+    serializeAsFresnelParameters("reflectionFresnelParameters")
+], StandardMaterial.prototype, "_reflectionFresnelParameters", void 0);
+__decorate([
+    expandToProperty("_markAllSubMeshesAsFresnelDirty")
+], StandardMaterial.prototype, "reflectionFresnelParameters", void 0);
+__decorate([
+    serializeAsFresnelParameters("refractionFresnelParameters")
+], StandardMaterial.prototype, "_refractionFresnelParameters", void 0);
+__decorate([
+    expandToProperty("_markAllSubMeshesAsFresnelDirty")
+], StandardMaterial.prototype, "refractionFresnelParameters", void 0);
+__decorate([
+    serializeAsFresnelParameters("emissiveFresnelParameters")
+], StandardMaterial.prototype, "_emissiveFresnelParameters", void 0);
+__decorate([
+    expandToProperty("_markAllSubMeshesAsFresnelDirty")
+], StandardMaterial.prototype, "emissiveFresnelParameters", void 0);
+__decorate([
+    serialize("useReflectionFresnelFromSpecular")
+], StandardMaterial.prototype, "_useReflectionFresnelFromSpecular", void 0);
+__decorate([
+    expandToProperty("_markAllSubMeshesAsFresnelDirty")
+], StandardMaterial.prototype, "useReflectionFresnelFromSpecular", void 0);
+__decorate([
+    serialize("useGlossinessFromSpecularMapAlpha")
+], StandardMaterial.prototype, "_useGlossinessFromSpecularMapAlpha", void 0);
+__decorate([
+    expandToProperty("_markAllSubMeshesAsTexturesDirty")
+], StandardMaterial.prototype, "useGlossinessFromSpecularMapAlpha", void 0);
+__decorate([
+    serialize("maxSimultaneousLights")
+], StandardMaterial.prototype, "_maxSimultaneousLights", void 0);
+__decorate([
+    expandToProperty("_markAllSubMeshesAsLightsDirty")
+], StandardMaterial.prototype, "maxSimultaneousLights", void 0);
+__decorate([
+    serialize("invertNormalMapX")
+], StandardMaterial.prototype, "_invertNormalMapX", void 0);
+__decorate([
+    expandToProperty("_markAllSubMeshesAsTexturesDirty")
+], StandardMaterial.prototype, "invertNormalMapX", void 0);
+__decorate([
+    serialize("invertNormalMapY")
+], StandardMaterial.prototype, "_invertNormalMapY", void 0);
+__decorate([
+    expandToProperty("_markAllSubMeshesAsTexturesDirty")
+], StandardMaterial.prototype, "invertNormalMapY", void 0);
+__decorate([
+    serialize("twoSidedLighting")
+], StandardMaterial.prototype, "_twoSidedLighting", void 0);
+__decorate([
+    expandToProperty("_markAllSubMeshesAsTexturesDirty")
+], StandardMaterial.prototype, "twoSidedLighting", void 0);
+__decorate([
+    serialize("applyDecalMapAfterDetailMap")
+], StandardMaterial.prototype, "_applyDecalMapAfterDetailMap", void 0);
+__decorate([
+    expandToProperty("_markAllSubMeshesAsMiscDirty")
+], StandardMaterial.prototype, "applyDecalMapAfterDetailMap", void 0);
+RegisterClass("BABYLON.StandardMaterial", StandardMaterial);
+Scene.DefaultMaterialFactory = (scene) => {
+    return new StandardMaterial("default material", scene);
+};
+
+/**
+ * Basic check if the current environment appears to be a mobile device based on user agent.
+ * Note: User agent sniffing is generally unreliable; consider feature detection instead if possible.
+ * This function might return false positives or negatives.
+ * @returns True if the user agent string matches common mobile patterns, false otherwise.
+ */
+const isMobileDevice = () => {
+    if (typeof navigator === 'undefined' || !navigator.userAgent) {
+        return false; // Cannot determine without navigator.userAgent
+    }
+    return /android|webos|iphone|ipad|ipod|blackberry|iemobile|opera mini/i.test(navigator.userAgent.toLowerCase());
+};
+/**
+ * Converts a simple {r, g, b, a} object to a BabylonJS Color4 object.
+ * Handles potential undefined input. Alpha defaults to 1 if not provided.
+ * @param colorObj - The color object { r, g, b, a? } (values 0-1).
+ * @param defaultColor - The default Color4 to return if input is invalid.
+ * @returns A BabylonJS Color4 object.
+ */
+const toColor4 = (colorObj, defaultColor = new Color4(1, 1, 1, 1) // Default to opaque white
+) => {
+    if (colorObj && typeof colorObj.r === 'number' && typeof colorObj.g === 'number' && typeof colorObj.b === 'number') {
+        const alpha = typeof colorObj.a === 'number' ? colorObj.a : 1.0;
+        return new Color4(colorObj.r, colorObj.g, colorObj.b, alpha);
+    }
+    return defaultColor;
+};
+/**
+ * Converts a simple {x, y, z} object to a BabylonJS Vector3 object.
+ * Handles potential undefined input.
+ * @param vecObj - The vector object { x, y, z }.
+ * @param defaultVector - The default Vector3 to return if input is invalid.
+ * @returns A BabylonJS Vector3 object.
+ */
+const toVector3 = (vecObj, defaultVector = new Vector3(0, 0, 0) // Default to origin
+) => {
+    if (vecObj && typeof vecObj.x === 'number' && typeof vecObj.y === 'number' && typeof vecObj.z === 'number') {
+        return new Vector3(vecObj.x, vecObj.y, vecObj.z);
+    }
+    return defaultVector;
+};
+/**
+ * Converts a simple {_x, _y, _z, _w} object to a BabylonJS Quaternion object.
+ * Handles potential undefined input.
+ * @param quatObj - The quaternion object { _x, _y, _z, _w }.
+ * @param defaultQuaternion - The default Quaternion to return if input is invalid.
+ * @returns A BabylonJS Quaternion object.
+ */
+const toQuaternion = (quatObj, defaultQuaternion = Quaternion.Identity() // Default to identity
+) => {
+    if (quatObj && typeof quatObj._x === 'number' && typeof quatObj._y === 'number' && typeof quatObj._z === 'number' && typeof quatObj._w === 'number') {
+        return new Quaternion(quatObj._x, quatObj._y, quatObj._z, quatObj._w);
+    }
+    return defaultQuaternion;
+};
+/**
+ * Converts a hex color string (e.g., "#RRGGBB") to a BabylonJS Color3 object.
+ * Handles potential undefined or invalid input.
+ * @param hex - The hex color string.
+ * @param defaultColor - The default Color3 to return if input is invalid.
+ * @returns A BabylonJS Color3 object.
+ */
+const hexToColor3 = (hex, defaultColor = new Color3(1, 1, 1) // Default to white
+) => {
+    if (!hex) {
+        return defaultColor;
+    }
+    try {
+        return Color3.FromHexString(hex);
+    }
+    catch (error) {
+        console.warn(`Invalid hex color format for hexToColor3: ${hex}. Using default.`, error);
+        return defaultColor;
+    }
+};
+/**
+ * Applies opacity to a mesh and its children's materials.
+ * Handles StandardMaterial and potentially PBRMaterial alpha/transparencyMode.
+ * @param mesh - The root mesh to apply opacity to.
+ * @param opacity - The opacity value (0-1).
+ */
+function applyOpacityToMeshAndChildren(mesh, opacity) {
+    if (!mesh)
+        return;
+    const applyToMaterial = (material) => {
+        if (material) {
+            const clampedOpacity = Math.max(0, Math.min(1, opacity)); // Ensure opacity is 0-1
+            // StandardMaterial
+            if ('alpha' in material) {
+                material.alpha = clampedOpacity;
+            }
+            // PBRMaterial - requires transparencyMode adjustment
+            if ('transparencyMode' in material) {
+                const pbrMaterial = material;
+                if (clampedOpacity < 1) {
+                    // Use ALPHABLEND (numeric value 2) if transparent
+                    pbrMaterial.transparencyMode = 2; // BABYLON.Constants.PBRMATERIAL_ALPHABLEND;
+                    pbrMaterial.alpha = clampedOpacity;
+                }
+                else {
+                    // Reset to opaque if opacity is 1
+                    pbrMaterial.transparencyMode = null; // Or 0 for OPAQUE
+                    pbrMaterial.alpha = 1;
+                }
+            }
+        }
+    };
+    // Apply to the mesh's own material
+    applyToMaterial(mesh.material);
+    // Apply to materials of direct child meshes recursively (optional, depending on need)
+    // If you only want direct children, use getChildMeshes(true)
+    // If you want all descendants, use getChildMeshes(false) - potentially expensive
+    const children = mesh.getChildMeshes ? mesh.getChildMeshes(true) : []; // Direct children only
+    children.forEach(childMesh => {
+        applyOpacityToMeshAndChildren(childMesh, opacity); // Recursive call
+    });
+}
+
+/**
+ * Initializes the BabylonJS Engine and Scene.
+ * Attempts to use WebGPU first, falling back to WebGL2.
+ * @param canvas - The HTML canvas element to render to.
+ * @param data - The StorySplat data containing scene properties.
+ * @param options - Viewer configuration options.
+ * @returns A promise resolving with the initialized engine and scene, or rejecting on failure.
+ */
+async function initializeSceneAndEngine(canvas, data, options // Allow passing disableWebGPU internally
+) {
+    var _a;
+    // Ensure canvas fills its container
+    canvas.style.width = '100%';
+    canvas.style.height = '100%';
+    canvas.style.display = 'block';
+    canvas.style.verticalAlign = 'bottom'; // Prevent extra space below canvas
+    let engine;
+    const disableWebGPU = (_a = options === null || options === void 0 ? void 0 : options.disableWebGPU) !== null && _a !== void 0 ? _a : false;
+    if (disableWebGPU) {
+        // Force WebGL2
+        try {
+            engine = new Engine(canvas, true);
+            console.log("StorySplat Viewer: WebGPU disabled by option, using WebGL2.");
+        }
+        catch (err) {
+            console.error("StorySplat Viewer: Failed to initialize WebGL2 engine:", err);
+            throw new Error("Failed to initialize WebGL2 engine.");
+        }
+    }
+    else {
+        // Try WebGPU first, then fallback
+        try {
+            // Check if running in a secure context, required for WebGPU
+            if (!window.isSecureContext) {
+                throw new Error("WebGPU requires a secure context (HTTPS or localhost).");
+            }
+            if (WebGPUEngine && WebGPUEngine.IsSupportedAsync) {
+                const supported = await WebGPUEngine.IsSupportedAsync;
+                if (supported) {
+                    const webgpuEngine = new WebGPUEngine(canvas, {
+                        // Explicitly request high-performance adapter
+                        powerPreference: "high-performance",
+                        // Enable validation in development environments if needed
+                        // enableAllFeatures: true // Use cautiously, might impact performance
+                    });
+                    await webgpuEngine.initAsync();
+                    engine = webgpuEngine; // Use double assertion
+                    console.log("StorySplat Viewer: WebGPU engine initialized.");
+                }
+                else {
+                    throw new Error("WebGPU is not supported on this browser/device.");
+                }
+            }
+            else {
+                throw new Error("WebGPUEngine not available or IsSupportedAsync missing.");
+            }
+        }
+        catch (err) {
+            // Fallback to WebGL2 if WebGPU fails or is unavailable
+            console.warn("StorySplat Viewer: WebGPU unavailable or initialization failed, falling back to WebGL2:", err);
+            try {
+                engine = new Engine(canvas, true, {
+                // Options for WebGL engine if needed
+                // preserveDrawingBuffer: true, // Example option
+                // stencil: true
+                });
+                console.log("StorySplat Viewer: Initialized WebGL2 engine as fallback.");
+            }
+            catch (webglErr) {
+                console.error("StorySplat Viewer: Failed to initialize WebGL2 engine as fallback:", webglErr);
+                throw new Error("Failed to initialize WebGL2 engine as fallback.");
+            }
+        }
+    }
+    if (!engine) {
+        throw new Error("Failed to initialize any Babylon engine.");
+    }
+    const scene = new Scene(engine);
+    // Set transparent clear color for HTML mesh compatibility
+    scene.clearColor = new Color4(0, 0, 0, 0);
+    // Create background sphere for background color when no skybox is active
+    const defaultBgColor = new Color3(0.12, 0.12, 0.12); // Dark gray background to match HTML exports
+    let bgColor;
+    const bgColorOption = options === null || options === void 0 ? void 0 : options.backgroundColor; // Options still use {r,g,b,a} format
+    if (bgColorOption) {
+        const color4 = toColor4(bgColorOption, new Color4(defaultBgColor.r, defaultBgColor.g, defaultBgColor.b, 1));
+        bgColor = new Color3(color4.r, color4.g, color4.b);
+    }
+    else if (data.backgroundColor) {
+        bgColor = hexToColor3(data.backgroundColor, defaultBgColor);
+    }
+    else {
+        bgColor = defaultBgColor;
+    }
+    // Store the background color for later use
+    scene._backgroundColor = bgColor;
+    // Create default background color skybox
+    const skyboxMesh = MeshBuilder.CreateBox("backgroundColorSkybox", {
+        size: 1000,
+        sideOrientation: Mesh.BACKSIDE
+    }, scene);
+    const skyboxMaterial = new StandardMaterial("backgroundColorMaterial", scene);
+    skyboxMaterial.disableLighting = true;
+    skyboxMaterial.emissiveColor = bgColor;
+    skyboxMaterial.backFaceCulling = false;
+    skyboxMaterial.reflectionTexture = null;
+    skyboxMaterial.diffuseColor = new Color3(0, 0, 0);
+    skyboxMaterial.specularColor = new Color3(0, 0, 0);
+    skyboxMesh.material = skyboxMaterial;
+    skyboxMesh.infiniteDistance = true;
+    skyboxMesh.isPickable = false;
+    skyboxMesh.renderingGroupId = 0;
+    // Apply rotation if provided in data
+    if (data.skyboxRotation !== undefined && typeof data.skyboxRotation === 'number') {
+        skyboxMesh.rotation.y = data.skyboxRotation;
+    }
+    scene._backgroundColorSkybox = skyboxMesh;
+    // Ambient color is typically handled by lights (e.g., HemisphericLight groundColor)
+    // Removing direct ambientColor setting from sceneProperties
+    // Set a default ambient if needed, but lightingManager should handle specifics
+    scene.ambientColor = new Color3(0.2, 0.2, 0.2); // Default dim ambient
+    // Add resize listener
+    const resizeHandler = () => {
+        engine.resize();
+    };
+    window.addEventListener("resize", resizeHandler);
+    // Add a cleanup function to the scene context
+    scene.onDisposeObservable.addOnce(() => {
+        console.log("StorySplat Viewer: Disposing scene, removing resize listener.");
+        window.removeEventListener("resize", resizeHandler);
+        // Engine disposal is handled separately in the destroy function
+    });
+    return { engine, scene };
+}
+
+// Removed import for shared wheelHandler
+const DEFAULT_CAMERA_POSITION = new Vector3(0, 1.6, -5);
+const DEFAULT_CAMERA_TARGET = Vector3.Zero();
+const DEFAULT_FOV = 0.8;
+const DEFAULT_MIN_Z = 0.1;
+const DEFAULT_MAX_Z = 1000;
+const DEFAULT_SPEED = 0.1;
+const DEFAULT_INERTIA = 0.9;
+const DEFAULT_ANGULAR_SENSIBILITY = 2000;
+// Removed DEFAULT_WHEEL_DELTA_PERCENTAGE and DEFAULT_WHEEL_STEP as they are handled by shared handler or options
+// Walk Mode Defaults
+const DEFAULT_APPLY_GRAVITY = true;
+const DEFAULT_ELLIPSOID = new Vector3(0.5, 0.9, 0.5);
+const DEFAULT_GRAVITY = -9.81;
+class CameraManager {
+    constructor(canvas, scene, data, options, // Correct options parameter
+    analyticsManager // Correct analyticsManager parameter
+    ) {
+        var _a, _b, _c;
+        this._camera = null;
+        this._currentMode = 'explore';
+        this._uiManager = null; // Add UIManager reference
+        this._analyticsManager = null; // Add AnalyticsManager reference
+        this._canvas = canvas;
+        this._scene = scene;
+        this._data = data; // Store data object
+        this._viewerOptions = options;
+        this._analyticsManager = analyticsManager || null; // Store analytics manager
+        // this._uiManager = uiManager || null; // Don't store here initially
+        this._isMobile = isMobileDevice();
+        this._initializeCamera();
+        // Prioritize initial mode from data, then options, then default to 'explore'
+        const initialMode = (_c = (_a = this._data.initialCameraMode) !== null && _a !== void 0 ? _a : (_b = this._viewerOptions) === null || _b === void 0 ? void 0 : _b.defaultCameraMode) !== null && _c !== void 0 ? _c : 'explore';
+        this.setCameraMode(initialMode, true); // Assert type as CameraMode
+        this._setupSceneDispose();
+        // Removed _setupCustomWheelInput call
+    }
+    get camera() {
+        return this._camera;
+    }
+    get currentMode() {
+        return this._currentMode;
+    }
+    _initializeCamera() {
+        var _a, _b, _c, _d, _e, _f, _g, _h, _j, _k, _l, _m, _o, _p, _q, _r, _s, _t, _u, _v, _w, _x, _y, _z, _0, _1, _2, _3, _4, _5, _6;
+        let initialPosition = DEFAULT_CAMERA_POSITION;
+        let initialRotation = undefined; // Use rotation instead of target
+        // Try to get initial pose from the first waypoint
+        const firstWaypoint = (_a = this._data.waypoints) === null || _a === void 0 ? void 0 : _a[0];
+        if (firstWaypoint) {
+            initialPosition = new Vector3(firstWaypoint.x, firstWaypoint.y, firstWaypoint.z);
+            initialRotation = toQuaternion(firstWaypoint.rotation); // Use helper
+        }
+        this._camera = new UniversalCamera("viewerCamera", initialPosition, this._scene);
+        // Set initial rotation if derived from waypoint, otherwise set default target
+        if (initialRotation) {
+            this._camera.rotationQuaternion = initialRotation;
+        }
+        else {
+            this._camera.setTarget(DEFAULT_CAMERA_TARGET);
+        }
+        // --- Add Standard Inputs ---
+        this._camera.inputs.addKeyboard();
+        this._camera.inputs.addMouse();
+        if (this._isMobile) {
+            this._camera.inputs.addTouch();
+        }
+        // Keyboard bindings need to be set *after* inputs are added
+        this._setKeyboardInputs();
+        // --- Apply Common Settings ---
+        // Get settings from data (StorySplatData) or options (ViewerOptions)
+        this._camera.fov = (_b = this._data.fov) !== null && _b !== void 0 ? _b : DEFAULT_FOV; // FOV comes from data only
+        this._camera.minZ = (_e = (_d = (_c = this._viewerOptions) === null || _c === void 0 ? void 0 : _c.cameraMinZ) !== null && _d !== void 0 ? _d : this._data.minClipPlane) !== null && _e !== void 0 ? _e : DEFAULT_MIN_Z; // Use minClipPlane from data
+        this._camera.maxZ = (_h = (_g = (_f = this._viewerOptions) === null || _f === void 0 ? void 0 : _f.cameraMaxZ) !== null && _g !== void 0 ? _g : this._data.maxClipPlane) !== null && _h !== void 0 ? _h : DEFAULT_MAX_Z; // Use maxClipPlane from data
+        this._camera.speed = (_l = (_k = (_j = this._viewerOptions) === null || _j === void 0 ? void 0 : _j.cameraSpeed) !== null && _k !== void 0 ? _k : this._data.cameraMovementSpeed) !== null && _l !== void 0 ? _l : DEFAULT_SPEED; // Use cameraMovementSpeed from data
+        this._camera.inertia = (_o = (_m = this._viewerOptions) === null || _m === void 0 ? void 0 : _m.cameraInertia) !== null && _o !== void 0 ? _o : DEFAULT_INERTIA; // Inertia likely only in options
+        // Map cameraRotationSensitivity from data to angularSensibility if options don't provide it
+        const angularSensibility = (_q = (_p = this._viewerOptions) === null || _p === void 0 ? void 0 : _p.cameraAngularSensibility) !== null && _q !== void 0 ? _q : (this._data.cameraRotationSensitivity ? (DEFAULT_ANGULAR_SENSIBILITY / (this._data.cameraRotationSensitivity / 4000)) : DEFAULT_ANGULAR_SENSIBILITY); // Simple scaling based on default
+        this._camera.angularSensibility = angularSensibility;
+        this._camera.touchAngularSensibility = (_s = (_r = this._viewerOptions) === null || _r === void 0 ? void 0 : _r.cameraTouchAngularSensibility) !== null && _s !== void 0 ? _s : angularSensibility; // Use same sensitivity for touch by default
+        // Apply Y-axis inversion by negating sensitivity if needed
+        const shouldInvert = (_v = (_u = (_t = this._viewerOptions) === null || _t === void 0 ? void 0 : _t.invertCameraRotation) !== null && _u !== void 0 ? _u : this._data.invertCameraRotation) !== null && _v !== void 0 ? _v : false;
+        if (shouldInvert) {
+            this._camera.angularSensibility *= -1;
+            this._camera.touchAngularSensibility *= -1;
+            console.log("StorySplat Viewer: Inverting camera Y-axis rotation.");
+        }
+        // --- Wheel Input ---
+        // Default wheel input is now used unless options customize it elsewhere.
+        // No need to remove default or handle custom wheel here.
+        // Initial collision/gravity state
+        this._camera.checkCollisions = false;
+        this._camera.applyGravity = false;
+        // Ellipsoid primarily from options
+        this._camera.ellipsoid = ((_w = this._viewerOptions) === null || _w === void 0 ? void 0 : _w.cameraEllipsoid) ? toVector3(this._viewerOptions.cameraEllipsoid) : DEFAULT_ELLIPSOID.clone();
+        // Gravity primarily from options
+        const sceneGravityY = (_y = (_x = this._scene.gravity) === null || _x === void 0 ? void 0 : _x.y) !== null && _y !== void 0 ? _y : ((_0 = (_z = this._viewerOptions) === null || _z === void 0 ? void 0 : _z.gravity) !== null && _0 !== void 0 ? _0 : DEFAULT_GRAVITY);
+        this._scene.gravity = new Vector3(0, sceneGravityY, 0);
+        // Enable scene collisions if needed - removed checks for _initialSettings
+        if (((_2 = (_1 = this._viewerOptions) === null || _1 === void 0 ? void 0 : _1.allowedCameraModes) === null || _2 === void 0 ? void 0 : _2.includes('walk')) ||
+            ((_3 = this._viewerOptions) === null || _3 === void 0 ? void 0 : _3.defaultCameraMode) === 'walk' ||
+            ((_4 = this._viewerOptions) === null || _4 === void 0 ? void 0 : _4.exploreCollisions) ||
+            ((_5 = this._viewerOptions) === null || _5 === void 0 ? void 0 : _5.walkCollisions) ||
+            ((_6 = this._viewerOptions) === null || _6 === void 0 ? void 0 : _6.cameraEllipsoid) || // Check if ellipsoid is defined in options
+            this._scene.collisionsEnabled) {
+            this._scene.collisionsEnabled = true;
+            console.log("StorySplat Viewer: Scene collisions enabled for camera.");
+        }
+    }
+    setCameraMode(mode, immediate = false) {
+        var _a, _b, _c, _d, _e, _f, _g;
+        if (!this._camera)
+            return;
+        const allowedModes = (_b = (_a = this._viewerOptions) === null || _a === void 0 ? void 0 : _a.allowedCameraModes) !== null && _b !== void 0 ? _b : ['explore', 'walk', 'tour', 'hybrid'];
+        if (!allowedModes.includes(mode)) {
+            console.warn(`StorySplat Viewer: Camera mode "${mode}" is not allowed by options. Allowed: [${allowedModes.join(', ')}]`);
+            return;
+        }
+        const oldMode = this._currentMode;
+        if (oldMode === mode && !immediate)
+            return;
+        console.log(`StorySplat Viewer: Setting camera mode to ${mode}`);
+        this._currentMode = mode;
+        // Detach controls before reconfiguring
+        this._camera.detachControl();
+        // Reset mode-specific properties
+        this._camera.checkCollisions = false;
+        this._camera.applyGravity = false;
+        // Inputs are now added during initialization and persist.
+        // No need to remove/re-add input types here.
+        // detachControl/attachControl handles focus.
+        switch (mode) {
+            case 'explore':
+                this._configureExploreMode();
+                break;
+            case 'walk':
+                this._configureWalkMode();
+                break;
+            case 'tour':
+            case 'hybrid':
+                this._configureTourMode();
+                break;
+            default:
+                console.warn(`StorySplat Viewer: Unknown camera mode "${mode}". Defaulting to explore.`);
+                this._configureExploreMode();
+                this._currentMode = 'explore';
+        }
+        // Re-attach controls if globally enabled
+        if (((_c = this._viewerOptions) === null || _c === void 0 ? void 0 : _c.cameraControls) !== false) {
+            this._camera.attachControl(this._canvas, true);
+            // Removed DEBUG log
+            // Inputs are added during initialization, attachControl manages focus.
+        }
+        else {
+            console.log("StorySplat Viewer: Camera controls globally disabled by options.");
+            // No activation needed if controls are disabled
+        }
+        // Trigger callback and update UI
+        if (oldMode !== mode) {
+            (_e = (_d = this._viewerOptions) === null || _d === void 0 ? void 0 : _d.onCameraModeChanged) === null || _e === void 0 ? void 0 : _e.call(_d, mode);
+            (_f = this.onCameraModeChange) === null || _f === void 0 ? void 0 : _f.call(this, mode); // Call the new callback
+            (_g = this._analyticsManager) === null || _g === void 0 ? void 0 : _g.trackCameraModeChange(oldMode, mode); // Track event
+            this._updateUIManager(); // Notify UI Manager of the change
+        }
     }
-    /**
-     * Are specular textures enabled in the application.
-     */
-    static get SpecularTextureEnabled() {
-        return MaterialFlags.SpecularTextureEnabled;
+    _configureExploreMode() {
+        var _a, _b;
+        if (!this._camera)
+            return;
+        this._camera.checkCollisions = (_b = (_a = this._viewerOptions) === null || _a === void 0 ? void 0 : _a.exploreCollisions) !== null && _b !== void 0 ? _b : false;
+        this._camera.applyGravity = false;
+        // Inputs are now managed globally during initialization.
+        // This method only sets mode-specific camera properties.
+        console.log("Explore mode configured: Collisions=" + this._camera.checkCollisions);
     }
-    static set SpecularTextureEnabled(value) {
-        MaterialFlags.SpecularTextureEnabled = value;
+    _configureWalkMode() {
+        var _a, _b, _c, _d, _e, _f, _g;
+        if (!this._camera)
+            return;
+        this._camera.checkCollisions = (_b = (_a = this._viewerOptions) === null || _a === void 0 ? void 0 : _a.walkCollisions) !== null && _b !== void 0 ? _b : true;
+        this._camera.applyGravity = (_d = (_c = this._viewerOptions) === null || _c === void 0 ? void 0 : _c.walkApplyGravity) !== null && _d !== void 0 ? _d : DEFAULT_APPLY_GRAVITY;
+        // Gravity primarily from options
+        const sceneGravityY = (_f = (_e = this._viewerOptions) === null || _e === void 0 ? void 0 : _e.gravity) !== null && _f !== void 0 ? _f : DEFAULT_GRAVITY; // Already checks options
+        this._scene.gravity = new Vector3(0, sceneGravityY, 0);
+        // Ellipsoid primarily from options
+        this._camera.ellipsoid = ((_g = this._viewerOptions) === null || _g === void 0 ? void 0 : _g.cameraEllipsoid) ? toVector3(this._viewerOptions.cameraEllipsoid) : DEFAULT_ELLIPSOID.clone(); // Already checks options
+        // Inputs are now managed globally during initialization.
+        // This method only sets mode-specific camera properties.
+        console.log(`Walk mode configured: Gravity=${this._camera.applyGravity}, Collisions=${this._camera.checkCollisions}`);
     }
-    /**
-     * Are bump textures enabled in the application.
-     */
-    static get BumpTextureEnabled() {
-        return MaterialFlags.BumpTextureEnabled;
+    _configureTourMode() {
+        if (!this._camera)
+            return;
+        this._camera.checkCollisions = false;
+        this._camera.applyGravity = false;
+        // Inputs are now managed globally during initialization.
+        // Mouse/Touch rotation is handled by the default inputs added earlier.
+        // This method only sets mode-specific camera properties.
+        console.log("Tour/Hybrid mode configured: No gravity, no collisions.");
     }
-    static set BumpTextureEnabled(value) {
-        MaterialFlags.BumpTextureEnabled = value;
+    // Helper to set standard keyboard bindings
+    _setKeyboardInputs() {
+        if (!this._camera)
+            return;
+        const input = this._camera.inputs.attached.keyboard; // Use specific type
+        if (input) {
+            // Clear existing potentially conflicting bindings (optional but safer)
+            input.keysUp = [];
+            input.keysDown = [];
+            input.keysLeft = [];
+            input.keysRight = [];
+            input.keysUpward = [];
+            input.keysDownward = [];
+            // Standard WASD / Arrow Keys
+            input.keysUp.push(87, 38); // W, Up Arrow
+            input.keysDown.push(83, 40); // S, Down Arrow
+            input.keysLeft.push(65, 37); // A, Left Arrow
+            input.keysRight.push(68, 39); // D, Right Arrow
+            // Add Q/E for vertical movement
+            input.keysUpward = [69]; // E key for up
+            input.keysDownward = [81]; // Q key for down
+        }
     }
-    /**
-     * Are lightmap textures enabled in the application.
-     */
-    static get LightmapTextureEnabled() {
-        return MaterialFlags.LightmapTextureEnabled;
+    // --- Custom Mouse Wheel Input Handling Removed ---
+    // The default FreeCameraMouseWheelInput is now used.
+    _setupSceneDispose() {
+        this._scene.onDisposeObservable.addOnce(() => {
+            console.log("StorySplat Viewer: Disposing camera manager and camera.");
+            // No need to remove custom wheel listener anymore
+            this._camera = null;
+        });
     }
-    static set LightmapTextureEnabled(value) {
-        MaterialFlags.LightmapTextureEnabled = value;
+    // --- UI Update Helper ---
+    _updateUIManager() {
+        if (!this._uiManager)
+            return;
+        this._uiManager.updateModeToggleButtons();
+        this._uiManager.updateExploreWalkToggleButtons();
+        this._uiManager.updateScrollControlsVisibility();
     }
-    /**
-     * Are refraction textures enabled in the application.
-     */
-    static get RefractionTextureEnabled() {
-        return MaterialFlags.RefractionTextureEnabled;
+    // --- Public API Methods ---
+    // Method to set the UIManager after instantiation
+    setUIManager(uiManager) {
+        this._uiManager = uiManager;
+        // Update UI immediately after manager is set
+        this._updateUIManager();
     }
-    static set RefractionTextureEnabled(value) {
-        MaterialFlags.RefractionTextureEnabled = value;
+    setPosition(position) {
+        if (this._camera) {
+            this._camera.position = position;
+        }
     }
-    /**
-     * Are color grading textures enabled in the application.
-     */
-    static get ColorGradingTextureEnabled() {
-        return MaterialFlags.ColorGradingTextureEnabled;
+    setTarget(target) {
+        if (this._camera) {
+            this._camera.setTarget(target);
+        }
     }
-    static set ColorGradingTextureEnabled(value) {
-        MaterialFlags.ColorGradingTextureEnabled = value;
+}
+
+// Import necessary loaders for .splat files (assuming it uses GLTF internally or a custom loader is registered)
+// If @babylonjs/loaders is needed and not globally imported, ensure it's imported somewhere,
+// e.g., in the main index.ts or here. For now, assume SceneLoader handles it.
+// import "@babylonjs/loaders/glTF"; // Example if GLTF loader is needed explicitly
+/**
+ * Loads the primary Gaussian Splat asset into the scene.
+ * @param scene - The BabylonJS scene to load the asset into.
+ * @param data - The StorySplat data containing the model URL and scaling info.
+ * @param onProgress - Optional callback function to report loading progress.
+ *                   Receives percentage (0-100) and an optional status text.
+ * @returns A promise that resolves with an array of the loaded AbstractMesh objects.
+ */
+async function loadSplatAsset(scene, data, onProgress // Updated signature
+) {
+    var _a, _b, _c, _d, _e;
+    const modelUrl = data.loadedModelUrl; // Changed from modelUrl
+    if (!modelUrl) {
+        console.error("StorySplat Viewer: No loadedModelUrl provided in data.");
+        return Promise.reject(new Error("No loadedModelUrl provided in StorySplatData."));
     }
-    /**
-     * Are fresnels enabled in the application.
-     */
-    static get FresnelEnabled() {
-        return MaterialFlags.FresnelEnabled;
+    const splatScale = (_a = data.splatScale) !== null && _a !== void 0 ? _a : 1.0;
+    const invertX = (_b = data.invertXScale) !== null && _b !== void 0 ? _b : false;
+    const invertY = (_c = data.invertYScale) !== null && _c !== void 0 ? _c : false;
+    const position = (_d = data.splatPosition) !== null && _d !== void 0 ? _d : [0, 0, 0];
+    const rotation = (_e = data.splatRotation) !== null && _e !== void 0 ? _e : [0, 0, 0];
+    console.log(`StorySplat Viewer: Loading splat asset from ${modelUrl}`);
+    try {
+        // Debug: Check what loaders are registered
+        console.log("StorySplat Viewer: Available SceneLoader plugins:", Object.keys(SceneLoader._RegisteredPlugins || {}));
+        const result = await SceneLoader.ImportMeshAsync("", // meshNames - empty string loads all
+        modelUrl, // rootUrl - the full URL
+        "", // sceneFilename - empty when using full URL
+        scene, (progressEvent) => {
+            if (onProgress) {
+                // Calculate percentage, handle indeterminate state
+                let percentage = 0;
+                if (progressEvent.lengthComputable && progressEvent.total > 0) {
+                    percentage = (progressEvent.loaded / progressEvent.total) * 100;
+                }
+                else if (progressEvent.loaded > 0) {
+                    // If not lengthComputable but loaded > 0, maybe indicate activity?
+                    // This part is tricky without total size. Could use a spinner state.
+                    // For simplicity, we'll report 0 or the calculated percentage.
+                }
+                // Report percentage and potentially a status text
+                const statusText = progressEvent.lengthComputable ? `${(progressEvent.loaded / 1024 / 1024).toFixed(2)}MB / ${(progressEvent.total / 1024 / 1024).toFixed(2)}MB` : 'Loading...';
+                onProgress(Math.round(percentage), statusText);
+            }
+        });
+        if (!result.meshes || result.meshes.length === 0) {
+            throw new Error(`No meshes found in the loaded asset: ${modelUrl}`);
+        }
+        console.log(`StorySplat Viewer: Successfully loaded ${result.meshes.length} meshes from ${modelUrl}.`);
+        result.meshes.forEach((mesh) => {
+            // Ensure the mesh is visible and pickable
+            mesh.isVisible = true;
+            mesh.isPickable = true; // Important for interactions like hotspots if they attach to splats
+            // Apply scaling and inversion
+            const scaleX = splatScale * (invertX ? -1 : 1);
+            const scaleY = splatScale * (invertY ? -1 : 1);
+            // Invert Z if only one of X or Y is inverted to maintain handedness
+            // If both inverted or neither inverted, Z scale matches splatScale sign
+            const scaleZ = splatScale * ((invertX !== invertY) ? -1 : 1);
+            mesh.scaling.set(scaleX, scaleY, scaleZ);
+            mesh.position.set(position[0], position[1], position[2]);
+            mesh.rotation.set(rotation[0], rotation[1], rotation[2]);
+            // Optional: Set collision properties if needed later
+            // mesh.checkCollisions = true; // Enable collisions if required
+            // Optional: Assign a name based on the URL for easier identification
+            mesh.name = `splatRoot_${modelUrl}`; // Name the root mesh if possible
+        });
+        // Add cleanup logic for the loaded meshes
+        const loadedMeshes = result.meshes; // Capture the meshes in this scope
+        const disposeObserver = scene.onDisposeObservable.addOnce(() => {
+            console.log(`StorySplat Viewer: Disposing splat asset: ${modelUrl}`);
+            loadedMeshes.forEach(mesh => {
+                if (mesh && !mesh.isDisposed()) {
+                    // Check parentage - only dispose root nodes added by the loader?
+                    // Or dispose all meshes returned by the loader. Assuming the latter for now.
+                    mesh.dispose(false, true); // Dispose mesh, materials, textures
+                }
+            });
+        });
+        // Store the observer reference on the meshes or a manager if needed for explicit cleanup later
+        // e.g., loadedMeshes[0].metadata = { disposeObserver };
+        return loadedMeshes;
     }
-    static set FresnelEnabled(value) {
-        MaterialFlags.FresnelEnabled = value;
+    catch (error) {
+        console.error(`StorySplat Viewer: Error loading splat asset from ${modelUrl}:`, error);
+        // Propagate the error
+        throw error;
     }
 }
-/**
- * Force all the standard materials to compile to glsl even on WebGPU engines.
- * False by default. This is mostly meant for backward compatibility.
- */
-StandardMaterial.ForceGLSL = false;
-__decorate([
-    serializeAsTexture("diffuseTexture")
-], StandardMaterial.prototype, "_diffuseTexture", void 0);
-__decorate([
-    expandToProperty("_markAllSubMeshesAsTexturesAndMiscDirty")
-], StandardMaterial.prototype, "diffuseTexture", void 0);
-__decorate([
-    serializeAsTexture("ambientTexture")
-], StandardMaterial.prototype, "_ambientTexture", void 0);
-__decorate([
-    expandToProperty("_markAllSubMeshesAsTexturesDirty")
-], StandardMaterial.prototype, "ambientTexture", void 0);
-__decorate([
-    serializeAsTexture("opacityTexture")
-], StandardMaterial.prototype, "_opacityTexture", void 0);
-__decorate([
-    expandToProperty("_markAllSubMeshesAsTexturesAndMiscDirty")
-], StandardMaterial.prototype, "opacityTexture", void 0);
-__decorate([
-    serializeAsTexture("reflectionTexture")
-], StandardMaterial.prototype, "_reflectionTexture", void 0);
-__decorate([
-    expandToProperty("_markAllSubMeshesAsTexturesDirty")
-], StandardMaterial.prototype, "reflectionTexture", void 0);
-__decorate([
-    serializeAsTexture("emissiveTexture")
-], StandardMaterial.prototype, "_emissiveTexture", void 0);
-__decorate([
-    expandToProperty("_markAllSubMeshesAsTexturesDirty")
-], StandardMaterial.prototype, "emissiveTexture", void 0);
-__decorate([
-    serializeAsTexture("specularTexture")
-], StandardMaterial.prototype, "_specularTexture", void 0);
-__decorate([
-    expandToProperty("_markAllSubMeshesAsTexturesDirty")
-], StandardMaterial.prototype, "specularTexture", void 0);
-__decorate([
-    serializeAsTexture("bumpTexture")
-], StandardMaterial.prototype, "_bumpTexture", void 0);
-__decorate([
-    expandToProperty("_markAllSubMeshesAsTexturesDirty")
-], StandardMaterial.prototype, "bumpTexture", void 0);
-__decorate([
-    serializeAsTexture("lightmapTexture")
-], StandardMaterial.prototype, "_lightmapTexture", void 0);
-__decorate([
-    expandToProperty("_markAllSubMeshesAsTexturesDirty")
-], StandardMaterial.prototype, "lightmapTexture", void 0);
-__decorate([
-    serializeAsTexture("refractionTexture")
-], StandardMaterial.prototype, "_refractionTexture", void 0);
-__decorate([
-    expandToProperty("_markAllSubMeshesAsTexturesDirty")
-], StandardMaterial.prototype, "refractionTexture", void 0);
-__decorate([
-    serializeAsColor3("ambient")
-], StandardMaterial.prototype, "ambientColor", void 0);
-__decorate([
-    serializeAsColor3("diffuse")
-], StandardMaterial.prototype, "diffuseColor", void 0);
-__decorate([
-    serializeAsColor3("specular")
-], StandardMaterial.prototype, "specularColor", void 0);
-__decorate([
-    serializeAsColor3("emissive")
-], StandardMaterial.prototype, "emissiveColor", void 0);
-__decorate([
-    serialize()
-], StandardMaterial.prototype, "specularPower", void 0);
-__decorate([
-    serialize("useAlphaFromDiffuseTexture")
-], StandardMaterial.prototype, "_useAlphaFromDiffuseTexture", void 0);
-__decorate([
-    expandToProperty("_markAllSubMeshesAsTexturesAndMiscDirty")
-], StandardMaterial.prototype, "useAlphaFromDiffuseTexture", void 0);
-__decorate([
-    serialize("useEmissiveAsIllumination")
-], StandardMaterial.prototype, "_useEmissiveAsIllumination", void 0);
-__decorate([
-    expandToProperty("_markAllSubMeshesAsTexturesDirty")
-], StandardMaterial.prototype, "useEmissiveAsIllumination", void 0);
-__decorate([
-    serialize("linkEmissiveWithDiffuse")
-], StandardMaterial.prototype, "_linkEmissiveWithDiffuse", void 0);
-__decorate([
-    expandToProperty("_markAllSubMeshesAsTexturesDirty")
-], StandardMaterial.prototype, "linkEmissiveWithDiffuse", void 0);
-__decorate([
-    serialize("useSpecularOverAlpha")
-], StandardMaterial.prototype, "_useSpecularOverAlpha", void 0);
-__decorate([
-    expandToProperty("_markAllSubMeshesAsTexturesDirty")
-], StandardMaterial.prototype, "useSpecularOverAlpha", void 0);
-__decorate([
-    serialize("useReflectionOverAlpha")
-], StandardMaterial.prototype, "_useReflectionOverAlpha", void 0);
-__decorate([
-    expandToProperty("_markAllSubMeshesAsTexturesDirty")
-], StandardMaterial.prototype, "useReflectionOverAlpha", void 0);
-__decorate([
-    serialize("disableLighting")
-], StandardMaterial.prototype, "_disableLighting", void 0);
-__decorate([
-    expandToProperty("_markAllSubMeshesAsLightsDirty")
-], StandardMaterial.prototype, "disableLighting", void 0);
-__decorate([
-    serialize("useObjectSpaceNormalMap")
-], StandardMaterial.prototype, "_useObjectSpaceNormalMap", void 0);
-__decorate([
-    expandToProperty("_markAllSubMeshesAsTexturesDirty")
-], StandardMaterial.prototype, "useObjectSpaceNormalMap", void 0);
-__decorate([
-    serialize("useParallax")
-], StandardMaterial.prototype, "_useParallax", void 0);
-__decorate([
-    expandToProperty("_markAllSubMeshesAsTexturesDirty")
-], StandardMaterial.prototype, "useParallax", void 0);
-__decorate([
-    serialize("useParallaxOcclusion")
-], StandardMaterial.prototype, "_useParallaxOcclusion", void 0);
-__decorate([
-    expandToProperty("_markAllSubMeshesAsTexturesDirty")
-], StandardMaterial.prototype, "useParallaxOcclusion", void 0);
-__decorate([
-    serialize()
-], StandardMaterial.prototype, "parallaxScaleBias", void 0);
-__decorate([
-    serialize("roughness")
-], StandardMaterial.prototype, "_roughness", void 0);
-__decorate([
-    expandToProperty("_markAllSubMeshesAsTexturesDirty")
-], StandardMaterial.prototype, "roughness", void 0);
-__decorate([
-    serialize()
-], StandardMaterial.prototype, "indexOfRefraction", void 0);
-__decorate([
-    serialize()
-], StandardMaterial.prototype, "invertRefractionY", void 0);
-__decorate([
-    serialize()
-], StandardMaterial.prototype, "alphaCutOff", void 0);
-__decorate([
-    serialize("useLightmapAsShadowmap")
-], StandardMaterial.prototype, "_useLightmapAsShadowmap", void 0);
-__decorate([
-    expandToProperty("_markAllSubMeshesAsTexturesDirty")
-], StandardMaterial.prototype, "useLightmapAsShadowmap", void 0);
-__decorate([
-    serializeAsFresnelParameters("diffuseFresnelParameters")
-], StandardMaterial.prototype, "_diffuseFresnelParameters", void 0);
-__decorate([
-    expandToProperty("_markAllSubMeshesAsFresnelDirty")
-], StandardMaterial.prototype, "diffuseFresnelParameters", void 0);
-__decorate([
-    serializeAsFresnelParameters("opacityFresnelParameters")
-], StandardMaterial.prototype, "_opacityFresnelParameters", void 0);
-__decorate([
-    expandToProperty("_markAllSubMeshesAsFresnelAndMiscDirty")
-], StandardMaterial.prototype, "opacityFresnelParameters", void 0);
-__decorate([
-    serializeAsFresnelParameters("reflectionFresnelParameters")
-], StandardMaterial.prototype, "_reflectionFresnelParameters", void 0);
-__decorate([
-    expandToProperty("_markAllSubMeshesAsFresnelDirty")
-], StandardMaterial.prototype, "reflectionFresnelParameters", void 0);
-__decorate([
-    serializeAsFresnelParameters("refractionFresnelParameters")
-], StandardMaterial.prototype, "_refractionFresnelParameters", void 0);
-__decorate([
-    expandToProperty("_markAllSubMeshesAsFresnelDirty")
-], StandardMaterial.prototype, "refractionFresnelParameters", void 0);
-__decorate([
-    serializeAsFresnelParameters("emissiveFresnelParameters")
-], StandardMaterial.prototype, "_emissiveFresnelParameters", void 0);
-__decorate([
-    expandToProperty("_markAllSubMeshesAsFresnelDirty")
-], StandardMaterial.prototype, "emissiveFresnelParameters", void 0);
-__decorate([
-    serialize("useReflectionFresnelFromSpecular")
-], StandardMaterial.prototype, "_useReflectionFresnelFromSpecular", void 0);
-__decorate([
-    expandToProperty("_markAllSubMeshesAsFresnelDirty")
-], StandardMaterial.prototype, "useReflectionFresnelFromSpecular", void 0);
-__decorate([
-    serialize("useGlossinessFromSpecularMapAlpha")
-], StandardMaterial.prototype, "_useGlossinessFromSpecularMapAlpha", void 0);
-__decorate([
-    expandToProperty("_markAllSubMeshesAsTexturesDirty")
-], StandardMaterial.prototype, "useGlossinessFromSpecularMapAlpha", void 0);
-__decorate([
-    serialize("maxSimultaneousLights")
-], StandardMaterial.prototype, "_maxSimultaneousLights", void 0);
-__decorate([
-    expandToProperty("_markAllSubMeshesAsLightsDirty")
-], StandardMaterial.prototype, "maxSimultaneousLights", void 0);
-__decorate([
-    serialize("invertNormalMapX")
-], StandardMaterial.prototype, "_invertNormalMapX", void 0);
-__decorate([
-    expandToProperty("_markAllSubMeshesAsTexturesDirty")
-], StandardMaterial.prototype, "invertNormalMapX", void 0);
-__decorate([
-    serialize("invertNormalMapY")
-], StandardMaterial.prototype, "_invertNormalMapY", void 0);
-__decorate([
-    expandToProperty("_markAllSubMeshesAsTexturesDirty")
-], StandardMaterial.prototype, "invertNormalMapY", void 0);
-__decorate([
-    serialize("twoSidedLighting")
-], StandardMaterial.prototype, "_twoSidedLighting", void 0);
-__decorate([
-    expandToProperty("_markAllSubMeshesAsTexturesDirty")
-], StandardMaterial.prototype, "twoSidedLighting", void 0);
-__decorate([
-    serialize("applyDecalMapAfterDetailMap")
-], StandardMaterial.prototype, "_applyDecalMapAfterDetailMap", void 0);
-__decorate([
-    expandToProperty("_markAllSubMeshesAsMiscDirty")
-], StandardMaterial.prototype, "applyDecalMapAfterDetailMap", void 0);
-RegisterClass("BABYLON.StandardMaterial", StandardMaterial);
-Scene.DefaultMaterialFactory = (scene) => {
-    return new StandardMaterial("default material", scene);
-};
 
 ThinEngine.prototype.updateVideoTexture = function (texture, video, invertY) {
     if (!texture || texture._isDisabled) {
@@ -143326,8 +143355,10 @@ function setupSkybox(scene, options) {
             // Ensure the URL is absolute or correctly relative to the viewer's deployment location
             const texture = new BABYLON$1.CubeTexture(options.activeSkyboxUrl, scene);
             // Assign the texture to the scene's skybox
-            // Note: createDefaultSkybox replaces any existing skybox
-            scene.createDefaultSkybox(texture, true, 1000, 0.0, false); // PBR=true, scale=1000, blur=0.0, set reflection=false initially
+            const skybox = scene.createDefaultSkybox(texture, true, 1000, 0.0, false); // PBR=true, scale=1000, blur=0.0, set reflection=false initially
+            if (skybox && typeof options.skyboxRotation === "number") {
+                skybox.rotation.y = options.skyboxRotation;
+            }
             console.log(`Skybox loaded from: ${options.activeSkyboxUrl}`);
         }
         catch (error) {
@@ -164198,10 +164229,35 @@ class CustomScriptManager {
         // Clean up any previous executions
         this.cleanup();
         try {
+            const renderObservers = [];
+            // Create a wrapped version of scene.registerBeforeRender that we can track
+            const wrappedScene = Object.create(this.scene);
+            wrappedScene.registerBeforeRender = (callback) => {
+                // Wrap the callback in error handling
+                const safeCallback = () => {
+                    try {
+                        callback();
+                    }
+                    catch (err) {
+                        console.error('Error in custom script render callback:', err);
+                        // Remove all observers to prevent continuous errors
+                        renderObservers.forEach(observer => {
+                            this.scene.onBeforeRenderObservable.remove(observer);
+                        });
+                        renderObservers.length = 0;
+                    }
+                };
+                const observer = this.scene.onBeforeRenderObservable.add(safeCallback);
+                renderObservers.push(observer);
+                // Store cleanup function
+                this.scriptCleanup.push(() => {
+                    this.scene.onBeforeRenderObservable.remove(observer);
+                });
+            };
             // Create the execution context
             const func = new Function('scene', 'camera', 'BABYLON', 'canvas', 'getScrollPercentage', 'getCurrentWaypointIndex', 'getHotspots', 'getHTMLMeshes', 'getSplats', this.customScript);
-            // Execute the script
-            func(this.scene, this.camera, BABYLON$1, this.scene.getEngine().getRenderingCanvas(), () => this.scrollPercentage, () => this.currentWaypointIndex, () => this.hotspots, () => this.htmlMeshes, () => this.scene.meshes.filter(mesh => mesh.name.includes('splat')));
+            // Execute the script with wrapped scene
+            func(wrappedScene, this.camera, BABYLON$1, this.scene.getEngine().getRenderingCanvas(), () => this.scrollPercentage, () => this.currentWaypointIndex, () => this.hotspots, () => this.htmlMeshes, () => this.scene.meshes.filter(mesh => mesh.name.includes('splat')));
             console.log('Custom script executed successfully in viewer');
         }
         catch (error) {
@@ -165007,7 +165063,7 @@ options) {
                 // but keeping original scale/invert settings from transformed data.
                 const tempData = Object.assign(Object.assign({}, data), { loadedModelUrl: newSplatUrl, 
                     // Keep original scale/invert settings
-                    splatScale: data.splatScale, invertXScale: data.invertXScale, invertYScale: data.invertYScale, 
+                    splatScale: data.splatScale, invertXScale: data.invertXScale, invertYScale: data.invertYScale, splatPosition: data.splatPosition, splatRotation: data.splatRotation, 
                     // Ensure other potentially relevant fields from data are present if needed
                     waypoints: data.waypoints, hotspots: data.hotspots });
                 splatRootMeshes = await loadSplatAsset(scene, tempData, (percentage, text) => {