@nice2dev/ui-3d 1.3.15 → 1.3.17

package/dist/cjs/model/useModelViewer.js

@@ -1,678 +1,646 @@
-'use strict';
-
-var ui = require('@nice2dev/ui');
-var React = require('react');
-var THREE = require('three');
-var OrbitControls_js = require('three/examples/jsm/controls/OrbitControls.js');
-var ColladaLoader_js = require('three/examples/jsm/loaders/ColladaLoader.js');
-var FBXLoader_js = require('three/examples/jsm/loaders/FBXLoader.js');
-var GLTFLoader_js = require('three/examples/jsm/loaders/GLTFLoader.js');
-var OBJLoader_js = require('three/examples/jsm/loaders/OBJLoader.js');
-var PLYLoader_js = require('three/examples/jsm/loaders/PLYLoader.js');
-var STLLoader_js = require('three/examples/jsm/loaders/STLLoader.js');
-var i18n = require('../core/i18n.js');
-var threeCompat = require('../core/threeCompat.js');
-
+"use strict";
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const ui = require("@nice2dev/ui");
+const React = require("react");
+const THREE = require("three");
+const OrbitControls_js = require("three/examples/jsm/controls/OrbitControls.js");
+const ColladaLoader_js = require("three/examples/jsm/loaders/ColladaLoader.js");
+const FBXLoader_js = require("three/examples/jsm/loaders/FBXLoader.js");
+const GLTFLoader_js = require("three/examples/jsm/loaders/GLTFLoader.js");
+const OBJLoader_js = require("three/examples/jsm/loaders/OBJLoader.js");
+const PLYLoader_js = require("three/examples/jsm/loaders/PLYLoader.js");
+const STLLoader_js = require("three/examples/jsm/loaders/STLLoader.js");
+const i18n = require("../core/i18n.js");
+const threeCompat = require("../core/threeCompat.js");
 function _interopNamespaceDefault(e) {
-   var n = Object.create(null);
-   if (e) {
-      Object.keys(e).forEach(function (k) {
-         if (k !== 'default') {
-            var d = Object.getOwnPropertyDescriptor(e, k);
-            Object.defineProperty(n, k, d.get ? d : {
-               enumerable: true,
-               get: function () { return e[k]; }
-            });
-         }
-      });
-   }
-   n.default = e;
-   return Object.freeze(n);
+  const n = Object.create(null, { [Symbol.toStringTag]: { value: "Module" } });
+  if (e) {
+    for (const k in e) {
+      if (k !== "default") {
+        const d = Object.getOwnPropertyDescriptor(e, k);
+        Object.defineProperty(n, k, d.get ? d : {
+          enumerable: true,
+          get: () => e[k]
+        });
+      }
+    }
+  }
+  n.default = e;
+  return Object.freeze(n);
 }
-
-var THREE__namespace = /*#__PURE__*/_interopNamespaceDefault(THREE);
-
-/**
- * useModelViewer — lightweight hook for the view-only 3D model viewer.
- *
- * Unlike useModelEditor this hook provides NO editing — just loading,
- * orbit/pan/zoom navigation, optional WASD first-person camera,
- * gamepad support, VR mode, annotations and measurement tools.
- *
- * Designed for ERP real-estate / rental-space visualisation and
- * product presentation.
- */
-/* ═══════════════════════════════════════════
-   Quality presets
-   ═══════════════════════════════════════════ */
+const THREE__namespace = /* @__PURE__ */ _interopNamespaceDefault(THREE);
 const QUALITY_MAP = {
-    low: { pixelRatio: 0.75, shadowMapSize: 512, antialias: false },
-    medium: { pixelRatio: 1, shadowMapSize: 1024, antialias: true },
-    high: { pixelRatio: 1, shadowMapSize: 2048, antialias: true },
-    ultra: { pixelRatio: 2, shadowMapSize: 4096, antialias: true },
+  low: { pixelRatio: 0.75, shadowMapSize: 512, antialias: false },
+  medium: { pixelRatio: 1, shadowMapSize: 1024, antialias: true },
+  high: { pixelRatio: 1, shadowMapSize: 2048, antialias: true },
+  ultra: { pixelRatio: 2, shadowMapSize: 4096, antialias: true }
 };
 const TONE_MAP = {
-    linear: THREE__namespace.LinearToneMapping,
-    reinhard: THREE__namespace.ReinhardToneMapping,
-    cineon: THREE__namespace.CineonToneMapping,
-    aces: THREE__namespace.ACESFilmicToneMapping,
-    agx: THREE__namespace.AgXToneMapping,
+  linear: THREE__namespace.LinearToneMapping,
+  reinhard: THREE__namespace.ReinhardToneMapping,
+  cineon: THREE__namespace.CineonToneMapping,
+  aces: THREE__namespace.ACESFilmicToneMapping,
+  agx: THREE__namespace.AgXToneMapping
 };
-/* ═══════════════════════════════════════════
-   Hook
-   ═══════════════════════════════════════════ */
 function useModelViewer(props = {}) {
-    var _a;
-    const { t } = i18n.useNiceTranslation();
-    const { src, format, navigationMode: initNavMode = 'orbit', quality = 'high', autoRotateSpeed: initAutoRotate = 0, backgroundColor = 'var(--nice-bg, #1a1a2e)', showGrid: initShowGrid = true, shadows = true, gamepad = false, cameraPresets: _cameraPresets = [], annotations: _annotations = [], hotspots: _hotspots = [], floorPlans: _floorPlans = [], onHotspotClick: _onHotspotClick, onAnnotationClick: _onAnnotationClick, onLoadProgress, onLoad, onError, clippingPlanes = [], measureMode: initMeasureMode = false, measurements: _measurements = [], onMeasure: _onMeasure, minDistance = 0.1, maxDistance = 1000, fov = 50, vr: _vr = false, walkSpeed = 5, ambientIntensity = 0.5, directionalIntensity = 0.8, antiAlias = true, toneMapping = 'aces', exposure = 1, } = props;
-    /* ── refs ── */
-    const mountRef = React.useRef(null);
-    const rendererRef = React.useRef(null);
-    const sceneRef = React.useRef(new THREE__namespace.Scene());
-    const cameraRef = React.useRef(new THREE__namespace.PerspectiveCamera(fov, 1, 0.01, 10000));
-    const orbitRef = React.useRef(null);
-    // Created once: useRef's argument runs on every render, and three r183 warns per Clock.
-    const clockRef = React.useRef(null);
-    (_a = clockRef.current) !== null && _a !== void 0 ? _a : (clockRef.current = threeCompat.createFrameClock());
-    const mixerRef = React.useRef(null);
-    const rafRef = React.useRef(0);
-    const rootRef = React.useRef(null);
-    const gridRef = React.useRef(null);
-    const clipsRef = React.useRef([]);
-    const keysRef = React.useRef(new Set());
-    React.useRef(null);
-    const disposeRef = React.useRef(false);
-    /* ── state ── */
-    const [loading, setLoading] = React.useState(false);
-    const [loadProgress, setLoadProgress] = React.useState(0);
-    const [error, setError] = React.useState(null);
-    const [navMode, setNavMode] = React.useState(initNavMode);
-    const [projection, setProjection] = React.useState('perspective');
-    const [wireframe, setWireframe] = React.useState(false);
-    const [gridVisible, setGridVisible] = React.useState(initShowGrid);
-    const [autoRotate, setAutoRotate] = React.useState(initAutoRotate);
-    const [polyCount, setPolyCount] = React.useState(0);
-    const [meshCount, setMeshCount] = React.useState(0);
-    const [animNames, setAnimNames] = React.useState([]);
-    const [activeAnimIdx, setActiveAnimIdx] = React.useState(-1);
-    const [isPlaying, setIsPlaying] = React.useState(false);
-    const [animTime, setAnimTime] = React.useState(0);
-    const [animDuration, setAnimDuration] = React.useState(0);
-    const [animSpeed, setAnimSpeed] = React.useState(1);
-    const [isFullscreen, setIsFullscreen] = React.useState(false);
-    const [activeFloorPlanId, setActiveFloorPlanId] = React.useState(null);
-    const [annotationsVisible, setAnnotationsVisible] = React.useState(true);
-    const [clippingEnabled, setClippingEnabled] = React.useState(clippingPlanes.length > 0);
-    const [clippingPosition, setClippingPosition] = React.useState(0);
-    const [clippingAxis, setClippingAxis] = React.useState('y');
-    const [measureModeActive, setMeasureModeActive] = React.useState(initMeasureMode);
-    const [dimensions, setDimensions] = React.useState(null);
-    const [statusText, setStatusText] = React.useState('Ready');
-    /* ── scene setup ── */
-    React.useEffect(() => {
-        var _a;
-        const mount = mountRef.current;
-        if (!mount) {
-            return;
-        }
-        disposeRef.current = false;
-        const q = QUALITY_MAP[quality];
-        const renderer = new THREE__namespace.WebGLRenderer({
-            antialias: q.antialias && antiAlias,
-            alpha: backgroundColor === 'transparent',
-            preserveDrawingBuffer: true,
-        });
-        renderer.setPixelRatio(Math.min(window.devicePixelRatio, q.pixelRatio));
-        renderer.setSize(mount.clientWidth, mount.clientHeight);
-        renderer.toneMapping = (_a = TONE_MAP[toneMapping]) !== null && _a !== void 0 ? _a : THREE__namespace.ACESFilmicToneMapping;
-        renderer.toneMappingExposure = exposure;
-        renderer.outputColorSpace = THREE__namespace.SRGBColorSpace;
-        if (shadows) {
-            renderer.shadowMap.enabled = true;
-            renderer.shadowMap.type = threeCompat.SOFT_SHADOW_MAP;
-        }
-        mount.appendChild(renderer.domElement);
-        rendererRef.current = renderer;
-        const scene = sceneRef.current;
-        if (backgroundColor !== 'transparent') {
-            // The default is a var() token, which THREE.Color cannot parse (it warns and paints
-            // white); resolve it against the viewer first.
-            scene.background = new THREE__namespace.Color(ui.resolveCssColor(backgroundColor, mount));
-        }
-        // Lights
-        const amb = new THREE__namespace.AmbientLight(0xffffff, ambientIntensity);
-        scene.add(amb);
-        const dir = new THREE__namespace.DirectionalLight(0xffffff, directionalIntensity);
-        dir.position.set(5, 10, 7);
-        if (shadows) {
-            dir.castShadow = true;
-            dir.shadow.mapSize.setScalar(q.shadowMapSize);
-        }
-        scene.add(dir);
-        const hemi = new THREE__namespace.HemisphereLight(0xaaccff, 0x445522, 0.3);
-        scene.add(hemi);
-        // Grid
-        const grid = new THREE__namespace.GridHelper(50, 50, 0x444444, 0x333333);
-        grid.visible = initShowGrid;
-        scene.add(grid);
-        gridRef.current = grid;
-        // Camera
-        const camera = cameraRef.current;
-        camera.position.set(5, 4, 8);
-        camera.lookAt(0, 0, 0);
-        // OrbitControls
-        const orbit = new OrbitControls_js.OrbitControls(camera, renderer.domElement);
-        orbit.enableDamping = true;
-        orbit.dampingFactor = 0.08;
-        orbit.minDistance = minDistance;
-        orbit.maxDistance = maxDistance;
-        orbit.autoRotate = initAutoRotate > 0;
-        orbit.autoRotateSpeed = initAutoRotate;
-        orbitRef.current = orbit;
-        // Resize observer
-        const ro = new ResizeObserver(() => {
-            if (!mount || disposeRef.current) {
-                return;
-            }
-            const w = mount.clientWidth;
-            const h = mount.clientHeight;
-            camera.aspect = w / h;
-            camera.updateProjectionMatrix();
-            renderer.setSize(w, h);
-        });
-        ro.observe(mount);
-        // Animation loop
-        const animate = () => {
-            var _a, _b, _c, _d, _e, _f;
-            if (disposeRef.current) {
-                return;
-            }
-            rafRef.current = requestAnimationFrame(animate);
-            const dt = (_b = (_a = clockRef.current) === null || _a === void 0 ? void 0 : _a.getDelta()) !== null && _b !== void 0 ? _b : 0;
-            // Gamepad FPS-style nav
-            if (gamepad && navMode === 'fps') {
-                // The pads the input engine read this frame (1.3.0: the engine is the only pad reader).
-                const gp = (_c = ui.getInputEngine().gamepadSnapshot[0]) !== null && _c !== void 0 ? _c : null;
-                if (gp) {
-                    const lx = (_d = gp.axes[0]) !== null && _d !== void 0 ? _d : 0;
-                    const ly = (_e = gp.axes[1]) !== null && _e !== void 0 ? _e : 0;
-                    const rx = (_f = gp.axes[2]) !== null && _f !== void 0 ? _f : 0;
-                    const fwd = new THREE__namespace.Vector3();
-                    camera.getWorldDirection(fwd);
-                    fwd.y = 0;
-                    fwd.normalize();
-                    const right = new THREE__namespace.Vector3().crossVectors(fwd, camera.up).normalize();
-                    camera.position.addScaledVector(fwd, -ly * walkSpeed * dt);
-                    camera.position.addScaledVector(right, lx * walkSpeed * dt);
-                    orbit.target.addScaledVector(fwd, -ly * walkSpeed * dt);
-                    orbit.target.addScaledVector(right, lx * walkSpeed * dt);
-                    camera.rotateY(-rx * 2 * dt);
-                }
-            }
-            // Keyboard WASD
-            if (navMode === 'fps' || navMode === 'walkthrough') {
-                const fwd = new THREE__namespace.Vector3();
-                camera.getWorldDirection(fwd);
-                fwd.y = 0;
-                fwd.normalize();
-                const right = new THREE__namespace.Vector3().crossVectors(fwd, camera.up).normalize();
-                const speed = walkSpeed * dt;
-                if (keysRef.current.has('w') || keysRef.current.has('arrowup')) {
-                    camera.position.addScaledVector(fwd, speed);
-                    orbit.target.addScaledVector(fwd, speed);
-                }
-                if (keysRef.current.has('s') || keysRef.current.has('arrowdown')) {
-                    camera.position.addScaledVector(fwd, -speed);
-                    orbit.target.addScaledVector(fwd, -speed);
-                }
-                if (keysRef.current.has('a') || keysRef.current.has('arrowleft')) {
-                    camera.position.addScaledVector(right, -speed);
-                    orbit.target.addScaledVector(right, -speed);
-                }
-                if (keysRef.current.has('d') || keysRef.current.has('arrowright')) {
-                    camera.position.addScaledVector(right, speed);
-                    orbit.target.addScaledVector(right, speed);
-                }
-                if (keysRef.current.has('q')) {
-                    camera.position.y += speed;
-                    orbit.target.y += speed;
-                }
-                if (keysRef.current.has('e')) {
-                    camera.position.y -= speed;
-                    orbit.target.y -= speed;
-                }
-            }
-            if (mixerRef.current) {
-                mixerRef.current.update(dt);
-            }
-            orbit.update();
-            renderer.render(scene, camera);
-        };
-        animate();
-        // Keyboard listeners
-        const onKeyDown = (e) => keysRef.current.add(e.key.toLowerCase());
-        const onKeyUp = (e) => keysRef.current.delete(e.key.toLowerCase());
-        mount.addEventListener('keydown', onKeyDown);
-        mount.addEventListener('keyup', onKeyUp);
-        // Fullscreen
-        const onFSChange = () => setIsFullscreen(!!document.fullscreenElement);
-        document.addEventListener('fullscreenchange', onFSChange);
-        return () => {
-            disposeRef.current = true;
-            cancelAnimationFrame(rafRef.current);
-            ro.disconnect();
-            orbit.dispose();
-            renderer.dispose();
-            mount.removeEventListener('keydown', onKeyDown);
-            mount.removeEventListener('keyup', onKeyUp);
-            document.removeEventListener('fullscreenchange', onFSChange);
-            if (mount.contains(renderer.domElement)) {
-                mount.removeChild(renderer.domElement);
-            }
-        };
-        // eslint-disable-next-line react-hooks/exhaustive-deps
-    }, []);
-    /* ── update grid visibility ── */
-    React.useEffect(() => {
-        if (gridRef.current) {
-            gridRef.current.visible = gridVisible;
-        }
-    }, [gridVisible]);
-    /* ── update auto-rotate ── */
-    React.useEffect(() => {
-        if (orbitRef.current) {
-            orbitRef.current.autoRotate = autoRotate > 0;
-            orbitRef.current.autoRotateSpeed = autoRotate;
-        }
-    }, [autoRotate]);
-    /* ── wireframe toggle ── */
-    React.useEffect(() => {
-        if (!rootRef.current) {
-            return;
-        }
-        rootRef.current.traverse((c) => {
-            if (c.isMesh) {
-                const mat = c.material;
-                const mats = Array.isArray(mat) ? mat : [mat];
-                mats.forEach((m) => {
-                    if ('wireframe' in m) {
-                        m.wireframe = wireframe;
-                    }
-                });
-            }
+  const { t } = i18n.useNiceTranslation();
+  const {
+    src,
+    format,
+    navigationMode: initNavMode = "orbit",
+    quality = "high",
+    autoRotateSpeed: initAutoRotate = 0,
+    backgroundColor = "var(--nice-bg, #1a1a2e)",
+    showGrid: initShowGrid = true,
+    shadows = true,
+    gamepad = false,
+    cameraPresets: _cameraPresets = [],
+    annotations: _annotations = [],
+    hotspots: _hotspots = [],
+    floorPlans: _floorPlans = [],
+    onHotspotClick: _onHotspotClick,
+    onAnnotationClick: _onAnnotationClick,
+    onLoadProgress,
+    onLoad,
+    onError,
+    clippingPlanes = [],
+    measureMode: initMeasureMode = false,
+    measurements: _measurements = [],
+    onMeasure: _onMeasure,
+    minDistance = 0.1,
+    maxDistance = 1e3,
+    fov = 50,
+    vr: _vr = false,
+    walkSpeed = 5,
+    ambientIntensity = 0.5,
+    directionalIntensity = 0.8,
+    antiAlias = true,
+    toneMapping = "aces",
+    exposure = 1
+  } = props;
+  const mountRef = React.useRef(null);
+  const rendererRef = React.useRef(null);
+  const sceneRef = React.useRef(new THREE__namespace.Scene());
+  const cameraRef = React.useRef(new THREE__namespace.PerspectiveCamera(fov, 1, 0.01, 1e4));
+  const orbitRef = React.useRef(null);
+  const clockRef = React.useRef(null);
+  clockRef.current ?? (clockRef.current = threeCompat.createFrameClock());
+  const mixerRef = React.useRef(null);
+  const rafRef = React.useRef(0);
+  const rootRef = React.useRef(null);
+  const gridRef = React.useRef(null);
+  const clipsRef = React.useRef([]);
+  const keysRef = React.useRef(/* @__PURE__ */ new Set());
+  React.useRef(null);
+  const disposeRef = React.useRef(false);
+  const [loading, setLoading] = React.useState(false);
+  const [loadProgress, setLoadProgress] = React.useState(0);
+  const [error, setError] = React.useState(null);
+  const [navMode, setNavMode] = React.useState(initNavMode);
+  const [projection, setProjection] = React.useState("perspective");
+  const [wireframe, setWireframe] = React.useState(false);
+  const [gridVisible, setGridVisible] = React.useState(initShowGrid);
+  const [autoRotate, setAutoRotate] = React.useState(initAutoRotate);
+  const [polyCount, setPolyCount] = React.useState(0);
+  const [meshCount, setMeshCount] = React.useState(0);
+  const [animNames, setAnimNames] = React.useState([]);
+  const [activeAnimIdx, setActiveAnimIdx] = React.useState(-1);
+  const [isPlaying, setIsPlaying] = React.useState(false);
+  const [animTime, setAnimTime] = React.useState(0);
+  const [animDuration, setAnimDuration] = React.useState(0);
+  const [animSpeed, setAnimSpeed] = React.useState(1);
+  const [isFullscreen, setIsFullscreen] = React.useState(false);
+  const [activeFloorPlanId, setActiveFloorPlanId] = React.useState(null);
+  const [annotationsVisible, setAnnotationsVisible] = React.useState(true);
+  const [clippingEnabled, setClippingEnabled] = React.useState(clippingPlanes.length > 0);
+  const [clippingPosition, setClippingPosition] = React.useState(0);
+  const [clippingAxis, setClippingAxis] = React.useState("y");
+  const [measureModeActive, setMeasureModeActive] = React.useState(initMeasureMode);
+  const [dimensions, setDimensions] = React.useState(null);
+  const [statusText, setStatusText] = React.useState("Ready");
+  React.useEffect(() => {
+    const mount = mountRef.current;
+    if (!mount) {
+      return;
+    }
+    disposeRef.current = false;
+    const q = QUALITY_MAP[quality];
+    const renderer = new THREE__namespace.WebGLRenderer({
+      antialias: q.antialias && antiAlias,
+      alpha: backgroundColor === "transparent",
+      preserveDrawingBuffer: true
+    });
+    renderer.setPixelRatio(Math.min(window.devicePixelRatio, q.pixelRatio));
+    renderer.setSize(mount.clientWidth, mount.clientHeight);
+    renderer.toneMapping = TONE_MAP[toneMapping] ?? THREE__namespace.ACESFilmicToneMapping;
+    renderer.toneMappingExposure = exposure;
+    renderer.outputColorSpace = THREE__namespace.SRGBColorSpace;
+    if (shadows) {
+      renderer.shadowMap.enabled = true;
+      renderer.shadowMap.type = threeCompat.SOFT_SHADOW_MAP;
+    }
+    mount.appendChild(renderer.domElement);
+    rendererRef.current = renderer;
+    const scene = sceneRef.current;
+    if (backgroundColor !== "transparent") {
+      scene.background = new THREE__namespace.Color(ui.resolveCssColor(backgroundColor, mount));
+    }
+    const amb = new THREE__namespace.AmbientLight(16777215, ambientIntensity);
+    scene.add(amb);
+    const dir = new THREE__namespace.DirectionalLight(16777215, directionalIntensity);
+    dir.position.set(5, 10, 7);
+    if (shadows) {
+      dir.castShadow = true;
+      dir.shadow.mapSize.setScalar(q.shadowMapSize);
+    }
+    scene.add(dir);
+    const hemi = new THREE__namespace.HemisphereLight(11193599, 4478242, 0.3);
+    scene.add(hemi);
+    const grid = new THREE__namespace.GridHelper(50, 50, 4473924, 3355443);
+    grid.visible = initShowGrid;
+    scene.add(grid);
+    gridRef.current = grid;
+    const camera = cameraRef.current;
+    camera.position.set(5, 4, 8);
+    camera.lookAt(0, 0, 0);
+    const orbit = new OrbitControls_js.OrbitControls(camera, renderer.domElement);
+    orbit.enableDamping = true;
+    orbit.dampingFactor = 0.08;
+    orbit.minDistance = minDistance;
+    orbit.maxDistance = maxDistance;
+    orbit.autoRotate = initAutoRotate > 0;
+    orbit.autoRotateSpeed = initAutoRotate;
+    orbitRef.current = orbit;
+    const ro = new ResizeObserver(() => {
+      if (!mount || disposeRef.current) {
+        return;
+      }
+      const w = mount.clientWidth;
+      const h = mount.clientHeight;
+      camera.aspect = w / h;
+      camera.updateProjectionMatrix();
+      renderer.setSize(w, h);
+    });
+    ro.observe(mount);
+    const animate = () => {
+      if (disposeRef.current) {
+        return;
+      }
+      rafRef.current = requestAnimationFrame(animate);
+      const dt = clockRef.current?.getDelta() ?? 0;
+      if (gamepad && navMode === "fps") {
+        const gp = ui.getInputEngine().gamepadSnapshot[0] ?? null;
+        if (gp) {
+          const lx = gp.axes[0] ?? 0;
+          const ly = gp.axes[1] ?? 0;
+          const rx = gp.axes[2] ?? 0;
+          const fwd = new THREE__namespace.Vector3();
+          camera.getWorldDirection(fwd);
+          fwd.y = 0;
+          fwd.normalize();
+          const right = new THREE__namespace.Vector3().crossVectors(fwd, camera.up).normalize();
+          camera.position.addScaledVector(fwd, -ly * walkSpeed * dt);
+          camera.position.addScaledVector(right, lx * walkSpeed * dt);
+          orbit.target.addScaledVector(fwd, -ly * walkSpeed * dt);
+          orbit.target.addScaledVector(right, lx * walkSpeed * dt);
+          camera.rotateY(-rx * 2 * dt);
+        }
+      }
+      if (navMode === "fps" || navMode === "walkthrough") {
+        const fwd = new THREE__namespace.Vector3();
+        camera.getWorldDirection(fwd);
+        fwd.y = 0;
+        fwd.normalize();
+        const right = new THREE__namespace.Vector3().crossVectors(fwd, camera.up).normalize();
+        const speed = walkSpeed * dt;
+        if (keysRef.current.has("w") || keysRef.current.has("arrowup")) {
+          camera.position.addScaledVector(fwd, speed);
+          orbit.target.addScaledVector(fwd, speed);
+        }
+        if (keysRef.current.has("s") || keysRef.current.has("arrowdown")) {
+          camera.position.addScaledVector(fwd, -speed);
+          orbit.target.addScaledVector(fwd, -speed);
+        }
+        if (keysRef.current.has("a") || keysRef.current.has("arrowleft")) {
+          camera.position.addScaledVector(right, -speed);
+          orbit.target.addScaledVector(right, -speed);
+        }
+        if (keysRef.current.has("d") || keysRef.current.has("arrowright")) {
+          camera.position.addScaledVector(right, speed);
+          orbit.target.addScaledVector(right, speed);
+        }
+        if (keysRef.current.has("q")) {
+          camera.position.y += speed;
+          orbit.target.y += speed;
+        }
+        if (keysRef.current.has("e")) {
+          camera.position.y -= speed;
+          orbit.target.y -= speed;
+        }
+      }
+      if (mixerRef.current) {
+        mixerRef.current.update(dt);
+      }
+      orbit.update();
+      renderer.render(scene, camera);
+    };
+    animate();
+    const onKeyDown = (e) => keysRef.current.add(e.key.toLowerCase());
+    const onKeyUp = (e) => keysRef.current.delete(e.key.toLowerCase());
+    mount.addEventListener("keydown", onKeyDown);
+    mount.addEventListener("keyup", onKeyUp);
+    const onFSChange = () => setIsFullscreen(!!document.fullscreenElement);
+    document.addEventListener("fullscreenchange", onFSChange);
+    return () => {
+      disposeRef.current = true;
+      cancelAnimationFrame(rafRef.current);
+      ro.disconnect();
+      orbit.dispose();
+      renderer.dispose();
+      mount.removeEventListener("keydown", onKeyDown);
+      mount.removeEventListener("keyup", onKeyUp);
+      document.removeEventListener("fullscreenchange", onFSChange);
+      if (mount.contains(renderer.domElement)) {
+        mount.removeChild(renderer.domElement);
+      }
+    };
+  }, []);
+  React.useEffect(() => {
+    if (gridRef.current) {
+      gridRef.current.visible = gridVisible;
+    }
+  }, [gridVisible]);
+  React.useEffect(() => {
+    if (orbitRef.current) {
+      orbitRef.current.autoRotate = autoRotate > 0;
+      orbitRef.current.autoRotateSpeed = autoRotate;
+    }
+  }, [autoRotate]);
+  React.useEffect(() => {
+    if (!rootRef.current) {
+      return;
+    }
+    rootRef.current.traverse((c) => {
+      if (c.isMesh) {
+        const mat = c.material;
+        const mats = Array.isArray(mat) ? mat : [mat];
+        mats.forEach((m) => {
+          if ("wireframe" in m) {
+            m.wireframe = wireframe;
+          }
         });
-    }, [wireframe]);
-    /* ── clipping ── */
-    React.useEffect(() => {
-        const renderer = rendererRef.current;
-        if (!renderer) {
-            return;
-        }
-        if (clippingEnabled) {
-            const normal = new THREE__namespace.Vector3(clippingAxis === 'x' ? 1 : 0, clippingAxis === 'y' ? 1 : 0, clippingAxis === 'z' ? 1 : 0);
-            const plane = new THREE__namespace.Plane(normal, -clippingPosition);
-            renderer.clippingPlanes = [plane];
-        }
-        else {
-            renderer.clippingPlanes = [];
-        }
-    }, [clippingEnabled, clippingPosition, clippingAxis]);
-    /* ── counting helpers ── */
-    const countScene = React.useCallback(() => {
-        let tris = 0;
-        let meshes = 0;
-        sceneRef.current.traverse((c) => {
+      }
+    });
+  }, [wireframe]);
+  React.useEffect(() => {
+    const renderer = rendererRef.current;
+    if (!renderer) {
+      return;
+    }
+    if (clippingEnabled) {
+      const normal = new THREE__namespace.Vector3(
+        clippingAxis === "x" ? 1 : 0,
+        clippingAxis === "y" ? 1 : 0,
+        clippingAxis === "z" ? 1 : 0
+      );
+      const plane = new THREE__namespace.Plane(normal, -clippingPosition);
+      renderer.clippingPlanes = [plane];
+    } else {
+      renderer.clippingPlanes = [];
+    }
+  }, [clippingEnabled, clippingPosition, clippingAxis]);
+  const countScene = React.useCallback(() => {
+    let tris = 0;
+    let meshes = 0;
+    sceneRef.current.traverse((c) => {
+      if (c.isMesh) {
+        meshes++;
+        const geo = c.geometry;
+        if (geo.index) {
+          tris += geo.index.count / 3;
+        } else if (geo.attributes.position) {
+          tris += geo.attributes.position.count / 3;
+        }
+      }
+    });
+    setPolyCount(Math.round(tris));
+    setMeshCount(meshes);
+  }, []);
+  const detectFormat = React.useCallback((url, hint) => {
+    if (hint) {
+      return hint;
+    }
+    const ext = url.split(".").pop()?.split("?")[0]?.toLowerCase() ?? "";
+    return ext;
+  }, []);
+  const loadModel = React.useCallback(
+    async (url, fmt) => {
+      setLoading(true);
+      setLoadProgress(0);
+      setError(null);
+      setStatusText(t("useModelViewer.loading", "Loading…"));
+      const detectedFmt = detectFormat(url, fmt);
+      const onProgress = (e) => {
+        if (e.lengthComputable) {
+          const p = e.loaded / e.total;
+          setLoadProgress(p);
+          onLoadProgress?.(p);
+        }
+      };
+      try {
+        let obj = null;
+        let clips = [];
+        if (detectedFmt === "fbx") {
+          const loader = new FBXLoader_js.FBXLoader();
+          const group = await loader.loadAsync(url, onProgress);
+          clips = group.animations ?? [];
+          obj = group;
+        } else if (detectedFmt === "glb" || detectedFmt === "gltf") {
+          const loader = new GLTFLoader_js.GLTFLoader();
+          const gltf = await loader.loadAsync(url, onProgress);
+          clips = gltf.animations ?? [];
+          obj = gltf.scene;
+        } else if (detectedFmt === "obj") {
+          const loader = new OBJLoader_js.OBJLoader();
+          obj = await loader.loadAsync(url, onProgress);
+        } else if (detectedFmt === "dae") {
+          const loader = new ColladaLoader_js.ColladaLoader();
+          const result = await loader.loadAsync(url, onProgress);
+          if (result) {
+            clips = result.scene.animations ?? [];
+            obj = result.scene;
+          }
+        } else if (detectedFmt === "stl") {
+          const loader = new STLLoader_js.STLLoader();
+          const geo = await loader.loadAsync(url, onProgress);
+          const mat = new THREE__namespace.MeshStandardMaterial({
+            color: 11184810,
+            metalness: 0.3,
+            roughness: 0.6
+          });
+          const mesh = new THREE__namespace.Mesh(geo, mat);
+          mesh.castShadow = true;
+          mesh.receiveShadow = true;
+          obj = mesh;
+        } else if (detectedFmt === "ply") {
+          const loader = new PLYLoader_js.PLYLoader();
+          const geo = await loader.loadAsync(url, onProgress);
+          geo.computeVertexNormals();
+          const mat = new THREE__namespace.MeshStandardMaterial({
+            color: 11184810,
+            vertexColors: !!geo.attributes.color
+          });
+          obj = new THREE__namespace.Mesh(geo, mat);
+        } else {
+          throw new Error(`Unsupported format: ${detectedFmt}`);
+        }
+        if (obj) {
+          if (rootRef.current) {
+            sceneRef.current.remove(rootRef.current);
+          }
+          obj.traverse((c) => {
             if (c.isMesh) {
-                meshes++;
-                const geo = c.geometry;
-                if (geo.index) {
-                    tris += geo.index.count / 3;
-                }
-                else if (geo.attributes.position) {
-                    tris += geo.attributes.position.count / 3;
-                }
-            }
-        });
-        setPolyCount(Math.round(tris));
-        setMeshCount(meshes);
-    }, []);
-    /* ── detect format from URL ── */
-    const detectFormat = React.useCallback((url, hint) => {
-        var _a, _b, _c;
-        if (hint) {
-            return hint;
-        }
-        const ext = (_c = (_b = (_a = url.split('.').pop()) === null || _a === void 0 ? void 0 : _a.split('?')[0]) === null || _b === void 0 ? void 0 : _b.toLowerCase()) !== null && _c !== void 0 ? _c : '';
-        return ext;
-    }, []);
-    /* ── load model ── */
-    const loadModel = React.useCallback(async (url, fmt) => {
-        var _a, _b, _c;
-        setLoading(true);
-        setLoadProgress(0);
-        setError(null);
-        setStatusText(t('useModelViewer.loading', 'Loading…'));
-        const detectedFmt = detectFormat(url, fmt);
-        const onProgress = (e) => {
-            if (e.lengthComputable) {
-                const p = e.loaded / e.total;
-                setLoadProgress(p);
-                onLoadProgress === null || onLoadProgress === void 0 ? void 0 : onLoadProgress(p);
-            }
-        };
-        try {
-            let obj = null;
-            let clips = [];
-            if (detectedFmt === 'fbx') {
-                const loader = new FBXLoader_js.FBXLoader();
-                const group = await loader.loadAsync(url, onProgress);
-                clips = (_a = group.animations) !== null && _a !== void 0 ? _a : [];
-                obj = group;
-            }
-            else if (detectedFmt === 'glb' || detectedFmt === 'gltf') {
-                const loader = new GLTFLoader_js.GLTFLoader();
-                const gltf = await loader.loadAsync(url, onProgress);
-                clips = (_b = gltf.animations) !== null && _b !== void 0 ? _b : [];
-                obj = gltf.scene;
-            }
-            else if (detectedFmt === 'obj') {
-                const loader = new OBJLoader_js.OBJLoader();
-                obj = await loader.loadAsync(url, onProgress);
+              c.castShadow = true;
+              c.receiveShadow = true;
             }
-            else if (detectedFmt === 'dae') {
-                const loader = new ColladaLoader_js.ColladaLoader();
-                const result = await loader.loadAsync(url, onProgress);
-                if (result) {
-                    clips = (_c = result.scene.animations) !== null && _c !== void 0 ? _c : [];
-                    obj = result.scene;
-                }
+          });
+          const box = new THREE__namespace.Box3().setFromObject(obj);
+          const size = box.getSize(new THREE__namespace.Vector3());
+          const maxDim = Math.max(size.x, size.y, size.z);
+          if (maxDim > 0) {
+            const target = 5;
+            if (maxDim > target * 2 || maxDim < target * 0.1) {
+              const scale = target / maxDim;
+              obj.scale.multiplyScalar(scale);
             }
-            else if (detectedFmt === 'stl') {
-                const loader = new STLLoader_js.STLLoader();
-                const geo = await loader.loadAsync(url, onProgress);
-                const mat = new THREE__namespace.MeshStandardMaterial({
-                    color: 0xaaaaaa,
-                    metalness: 0.3,
-                    roughness: 0.6,
-                });
-                const mesh = new THREE__namespace.Mesh(geo, mat);
-                mesh.castShadow = true;
-                mesh.receiveShadow = true;
-                obj = mesh;
-            }
-            else if (detectedFmt === 'ply') {
-                const loader = new PLYLoader_js.PLYLoader();
-                const geo = await loader.loadAsync(url, onProgress);
-                geo.computeVertexNormals();
-                const mat = new THREE__namespace.MeshStandardMaterial({
-                    color: 0xaaaaaa,
-                    vertexColors: !!geo.attributes.color,
-                });
-                obj = new THREE__namespace.Mesh(geo, mat);
-            }
-            else {
-                throw new Error(`Unsupported format: ${detectedFmt}`);
-            }
-            if (obj) {
-                // Remove previous model
-                if (rootRef.current) {
-                    sceneRef.current.remove(rootRef.current);
-                }
-                // Enable shadows
-                obj.traverse((c) => {
-                    if (c.isMesh) {
-                        c.castShadow = true;
-                        c.receiveShadow = true;
-                    }
-                });
-                // Auto-scale to normalized size
-                const box = new THREE__namespace.Box3().setFromObject(obj);
-                const size = box.getSize(new THREE__namespace.Vector3());
-                const maxDim = Math.max(size.x, size.y, size.z);
-                if (maxDim > 0) {
-                    const target = 5;
-                    if (maxDim > target * 2 || maxDim < target * 0.1) {
-                        const scale = target / maxDim;
-                        obj.scale.multiplyScalar(scale);
-                    }
-                }
-                // Center model
-                const box2 = new THREE__namespace.Box3().setFromObject(obj);
-                const center = box2.getCenter(new THREE__namespace.Vector3());
-                obj.position.sub(center);
-                obj.position.y += box2.getSize(new THREE__namespace.Vector3()).y / 2;
-                sceneRef.current.add(obj);
-                rootRef.current = obj;
-                // Update dimensions
-                const finalBox = new THREE__namespace.Box3().setFromObject(obj);
-                const s = finalBox.getSize(new THREE__namespace.Vector3());
-                setDimensions({
-                    width: +s.x.toFixed(2),
-                    height: +s.y.toFixed(2),
-                    depth: +s.z.toFixed(2),
-                });
-                // Animations
-                clipsRef.current = clips;
-                setAnimNames(clips.map((c, i) => c.name || `Clip ${i + 1}`));
-                if (clips.length > 0) {
-                    const mixer = new THREE__namespace.AnimationMixer(obj);
-                    mixerRef.current = mixer;
-                }
-                countScene();
-                setStatusText(t('useModelViewer.loadedTrisMeshes', 'Loaded – {polyCount} tris, {meshCount} meshes')
-                    .replace('{polyCount}', String(polyCount))
-                    .replace('{meshCount}', String(meshCount)));
-                onLoad === null || onLoad === void 0 ? void 0 : onLoad();
-            }
-        }
-        catch (err) {
-            const msg = err instanceof Error ? err.message : String(err);
-            setError(msg);
-            setStatusText(t('useModelViewer.error', 'Error: {msg}').replace('{msg}', String(msg)));
-            onError === null || onError === void 0 ? void 0 : onError(err instanceof Error ? err : new Error(msg));
-        }
-        finally {
-            setLoading(false);
-            setLoadProgress(1);
-        }
-    }, [countScene, detectFormat, onLoad, onError, onLoadProgress, polyCount, meshCount, t]);
-    /* ── auto-load from src ── */
-    React.useEffect(() => {
-        if (src) {
-            loadModel(src, format);
-        }
-    }, [src, format, loadModel]);
-    /* ── loadFile from disk ── */
-    const loadFile = React.useCallback(async (file) => {
-        var _a;
-        const url = URL.createObjectURL(file);
-        const ext = (_a = file.name.split('.').pop()) === null || _a === void 0 ? void 0 : _a.toLowerCase();
-        try {
-            await loadModel(url, ext);
-        }
-        finally {
-            URL.revokeObjectURL(url);
-        }
-    }, [loadModel]);
-    /* ── loadUrl ── */
-    const loadUrl = React.useCallback(async (url, fmt) => {
-        await loadModel(url, fmt);
-    }, [loadModel]);
-    /* ── animation controls ── */
-    const playAnimation = React.useCallback((index) => {
-        if (!mixerRef.current || index < 0 || index >= clipsRef.current.length) {
-            return;
-        }
-        mixerRef.current.stopAllAction();
-        const clip = clipsRef.current[index];
-        const action = mixerRef.current.clipAction(clip);
-        action.reset().play();
-        setActiveAnimIdx(index);
-        setIsPlaying(true);
-        setAnimDuration(clip.duration);
-    }, []);
-    const togglePlay = React.useCallback(() => {
-        if (!mixerRef.current) {
-            return;
-        }
-        if (isPlaying) {
-            mixerRef.current.timeScale = 0;
-            setIsPlaying(false);
-        }
-        else {
-            mixerRef.current.timeScale = animSpeed;
-            setIsPlaying(true);
-            if (activeAnimIdx < 0 && clipsRef.current.length > 0) {
-                playAnimation(0);
-            }
-        }
-    }, [isPlaying, animSpeed, activeAnimIdx, playAnimation]);
-    const seekAnim = React.useCallback((t) => {
-        if (mixerRef.current) {
-            mixerRef.current.setTime(t);
-        }
-        setAnimTime(t);
-    }, []);
-    /* ── camera presets ── */
-    const goToPreset = React.useCallback((preset) => {
-        const cam = cameraRef.current;
-        const orbit = orbitRef.current;
-        if (!orbit) {
-            return;
-        }
-        cam.position.set(...preset.position);
-        orbit.target.set(...preset.target);
-        if (preset.fov) {
-            cam.fov = preset.fov;
-        }
-        cam.updateProjectionMatrix();
-        orbit.update();
-    }, []);
-    const resetCamera = React.useCallback(() => {
-        const cam = cameraRef.current;
-        cam.position.set(5, 4, 8);
-        if (orbitRef.current) {
-            orbitRef.current.target.set(0, 0, 0);
-            orbitRef.current.update();
-        }
-    }, []);
-    const zoomToFit = React.useCallback(() => {
-        if (!rootRef.current) {
-            return;
-        }
-        const box = new THREE__namespace.Box3().setFromObject(rootRef.current);
-        const center = box.getCenter(new THREE__namespace.Vector3());
-        const size = box.getSize(new THREE__namespace.Vector3());
-        const maxDim = Math.max(size.x, size.y, size.z);
-        const cam = cameraRef.current;
-        const dist = maxDim / (2 * Math.tan((cam.fov * Math.PI) / 360));
-        cam.position.copy(center).add(new THREE__namespace.Vector3(0, 0, dist * 1.5));
-        if (orbitRef.current) {
-            orbitRef.current.target.copy(center);
-            orbitRef.current.update();
-        }
-    }, []);
-    /* ── screenshot ── */
-    const screenshot = React.useCallback((width, height) => {
-        const renderer = rendererRef.current;
-        if (!renderer) {
-            return '';
-        }
-        if (width && height) {
-            renderer.setSize(width, height);
-            cameraRef.current.aspect = width / height;
-            cameraRef.current.updateProjectionMatrix();
-        }
-        renderer.render(sceneRef.current, cameraRef.current);
-        const url = renderer.domElement.toDataURL('image/png');
-        if (width && height && mountRef.current) {
-            const w = mountRef.current.clientWidth;
-            const h = mountRef.current.clientHeight;
-            renderer.setSize(w, h);
-            cameraRef.current.aspect = w / h;
-            cameraRef.current.updateProjectionMatrix();
-        }
-        return url;
-    }, []);
-    /* ── fullscreen ── */
-    const toggleFullscreen = React.useCallback(() => {
-        if (!mountRef.current) {
-            return;
-        }
-        if (document.fullscreenElement) {
-            document.exitFullscreen();
-        }
-        else {
-            mountRef.current.requestFullscreen();
-        }
-    }, []);
-    /* ── dispose ── */
-    const dispose = React.useCallback(() => {
-        var _a;
-        disposeRef.current = true;
-        cancelAnimationFrame(rafRef.current);
-        (_a = rendererRef.current) === null || _a === void 0 ? void 0 : _a.dispose();
-    }, []);
-    /* ── finalise status text ── */
-    React.useEffect(() => {
-        if (!loading && !error && polyCount > 0) {
-            setStatusText(t('useModelViewer.trianglesMeshesAnimationS', '{polyCount} triangles · {meshCount} meshes · {animNames} animation(s)')
-                .replace('{polyCount}', String(polyCount.toLocaleString()))
-                .replace('{meshCount}', String(meshCount))
-                .replace('{animNames}', String(animNames.length)));
-        }
-    }, [loading, error, polyCount, meshCount, animNames.length, t]);
-    return {
-        mountRef,
-        loading,
-        loadProgress,
-        error,
-        navigationMode: navMode,
-        setNavigationMode: setNavMode,
-        projection,
-        setProjection,
-        wireframe,
-        setWireframe,
-        showGrid: gridVisible,
-        setShowGrid: setGridVisible,
-        autoRotateSpeed: autoRotate,
-        setAutoRotateSpeed: setAutoRotate,
-        polyCount,
-        meshCount,
-        animations: animNames,
-        activeAnimIdx,
-        playAnimation,
-        togglePlay,
-        isPlaying,
-        animTime,
-        animDuration,
-        seekAnim,
-        animSpeed,
-        setAnimSpeed,
-        goToPreset,
-        resetCamera,
-        zoomToFit,
-        screenshot,
-        toggleFullscreen,
-        isFullscreen,
-        loadFile,
-        loadUrl,
-        activeFloorPlanId,
-        setActiveFloorPlanId,
-        annotationsVisible,
-        setAnnotationsVisible,
-        measureMode: measureModeActive,
-        setMeasureMode: setMeasureModeActive,
-        clippingEnabled,
-        setClippingEnabled,
-        clippingPosition,
-        setClippingPosition,
-        clippingAxis,
-        setClippingAxis,
-        dimensions,
-        statusText,
-        dispose,
-    };
+          }
+          const box2 = new THREE__namespace.Box3().setFromObject(obj);
+          const center = box2.getCenter(new THREE__namespace.Vector3());
+          obj.position.sub(center);
+          obj.position.y += box2.getSize(new THREE__namespace.Vector3()).y / 2;
+          sceneRef.current.add(obj);
+          rootRef.current = obj;
+          const finalBox = new THREE__namespace.Box3().setFromObject(obj);
+          const s = finalBox.getSize(new THREE__namespace.Vector3());
+          setDimensions({
+            width: +s.x.toFixed(2),
+            height: +s.y.toFixed(2),
+            depth: +s.z.toFixed(2)
+          });
+          clipsRef.current = clips;
+          setAnimNames(clips.map((c, i) => c.name || `Clip ${i + 1}`));
+          if (clips.length > 0) {
+            const mixer = new THREE__namespace.AnimationMixer(obj);
+            mixerRef.current = mixer;
+          }
+          countScene();
+          setStatusText(
+            t("useModelViewer.loadedTrisMeshes", "Loaded – {polyCount} tris, {meshCount} meshes").replace("{polyCount}", String(polyCount)).replace("{meshCount}", String(meshCount))
+          );
+          onLoad?.();
+        }
+      } catch (err) {
+        const msg = err instanceof Error ? err.message : String(err);
+        setError(msg);
+        setStatusText(t("useModelViewer.error", "Error: {msg}").replace("{msg}", String(msg)));
+        onError?.(err instanceof Error ? err : new Error(msg));
+      } finally {
+        setLoading(false);
+        setLoadProgress(1);
+      }
+    },
+    [countScene, detectFormat, onLoad, onError, onLoadProgress, polyCount, meshCount, t]
+  );
+  React.useEffect(() => {
+    if (src) {
+      loadModel(src, format);
+    }
+  }, [src, format, loadModel]);
+  const loadFile = React.useCallback(
+    async (file) => {
+      const url = URL.createObjectURL(file);
+      const ext = file.name.split(".").pop()?.toLowerCase();
+      try {
+        await loadModel(url, ext);
+      } finally {
+        URL.revokeObjectURL(url);
+      }
+    },
+    [loadModel]
+  );
+  const loadUrl = React.useCallback(
+    async (url, fmt) => {
+      await loadModel(url, fmt);
+    },
+    [loadModel]
+  );
+  const playAnimation = React.useCallback((index) => {
+    if (!mixerRef.current || index < 0 || index >= clipsRef.current.length) {
+      return;
+    }
+    mixerRef.current.stopAllAction();
+    const clip = clipsRef.current[index];
+    const action = mixerRef.current.clipAction(clip);
+    action.reset().play();
+    setActiveAnimIdx(index);
+    setIsPlaying(true);
+    setAnimDuration(clip.duration);
+  }, []);
+  const togglePlay = React.useCallback(() => {
+    if (!mixerRef.current) {
+      return;
+    }
+    if (isPlaying) {
+      mixerRef.current.timeScale = 0;
+      setIsPlaying(false);
+    } else {
+      mixerRef.current.timeScale = animSpeed;
+      setIsPlaying(true);
+      if (activeAnimIdx < 0 && clipsRef.current.length > 0) {
+        playAnimation(0);
+      }
+    }
+  }, [isPlaying, animSpeed, activeAnimIdx, playAnimation]);
+  const seekAnim = React.useCallback((t2) => {
+    if (mixerRef.current) {
+      mixerRef.current.setTime(t2);
+    }
+    setAnimTime(t2);
+  }, []);
+  const goToPreset = React.useCallback((preset) => {
+    const cam = cameraRef.current;
+    const orbit = orbitRef.current;
+    if (!orbit) {
+      return;
+    }
+    cam.position.set(...preset.position);
+    orbit.target.set(...preset.target);
+    if (preset.fov) {
+      cam.fov = preset.fov;
+    }
+    cam.updateProjectionMatrix();
+    orbit.update();
+  }, []);
+  const resetCamera = React.useCallback(() => {
+    const cam = cameraRef.current;
+    cam.position.set(5, 4, 8);
+    if (orbitRef.current) {
+      orbitRef.current.target.set(0, 0, 0);
+      orbitRef.current.update();
+    }
+  }, []);
+  const zoomToFit = React.useCallback(() => {
+    if (!rootRef.current) {
+      return;
+    }
+    const box = new THREE__namespace.Box3().setFromObject(rootRef.current);
+    const center = box.getCenter(new THREE__namespace.Vector3());
+    const size = box.getSize(new THREE__namespace.Vector3());
+    const maxDim = Math.max(size.x, size.y, size.z);
+    const cam = cameraRef.current;
+    const dist = maxDim / (2 * Math.tan(cam.fov * Math.PI / 360));
+    cam.position.copy(center).add(new THREE__namespace.Vector3(0, 0, dist * 1.5));
+    if (orbitRef.current) {
+      orbitRef.current.target.copy(center);
+      orbitRef.current.update();
+    }
+  }, []);
+  const screenshot = React.useCallback((width, height) => {
+    const renderer = rendererRef.current;
+    if (!renderer) {
+      return "";
+    }
+    if (width && height) {
+      renderer.setSize(width, height);
+      cameraRef.current.aspect = width / height;
+      cameraRef.current.updateProjectionMatrix();
+    }
+    renderer.render(sceneRef.current, cameraRef.current);
+    const url = renderer.domElement.toDataURL("image/png");
+    if (width && height && mountRef.current) {
+      const w = mountRef.current.clientWidth;
+      const h = mountRef.current.clientHeight;
+      renderer.setSize(w, h);
+      cameraRef.current.aspect = w / h;
+      cameraRef.current.updateProjectionMatrix();
+    }
+    return url;
+  }, []);
+  const toggleFullscreen = React.useCallback(() => {
+    if (!mountRef.current) {
+      return;
+    }
+    if (document.fullscreenElement) {
+      document.exitFullscreen();
+    } else {
+      mountRef.current.requestFullscreen();
+    }
+  }, []);
+  const dispose = React.useCallback(() => {
+    disposeRef.current = true;
+    cancelAnimationFrame(rafRef.current);
+    rendererRef.current?.dispose();
+  }, []);
+  React.useEffect(() => {
+    if (!loading && !error && polyCount > 0) {
+      setStatusText(
+        t(
+          "useModelViewer.trianglesMeshesAnimationS",
+          "{polyCount} triangles · {meshCount} meshes · {animNames} animation(s)"
+        ).replace("{polyCount}", String(polyCount.toLocaleString())).replace("{meshCount}", String(meshCount)).replace("{animNames}", String(animNames.length))
+      );
+    }
+  }, [loading, error, polyCount, meshCount, animNames.length, t]);
+  return {
+    mountRef,
+    loading,
+    loadProgress,
+    error,
+    navigationMode: navMode,
+    setNavigationMode: setNavMode,
+    projection,
+    setProjection,
+    wireframe,
+    setWireframe,
+    showGrid: gridVisible,
+    setShowGrid: setGridVisible,
+    autoRotateSpeed: autoRotate,
+    setAutoRotateSpeed: setAutoRotate,
+    polyCount,
+    meshCount,
+    animations: animNames,
+    activeAnimIdx,
+    playAnimation,
+    togglePlay,
+    isPlaying,
+    animTime,
+    animDuration,
+    seekAnim,
+    animSpeed,
+    setAnimSpeed,
+    goToPreset,
+    resetCamera,
+    zoomToFit,
+    screenshot,
+    toggleFullscreen,
+    isFullscreen,
+    loadFile,
+    loadUrl,
+    activeFloorPlanId,
+    setActiveFloorPlanId,
+    annotationsVisible,
+    setAnnotationsVisible,
+    measureMode: measureModeActive,
+    setMeasureMode: setMeasureModeActive,
+    clippingEnabled,
+    setClippingEnabled,
+    clippingPosition,
+    setClippingPosition,
+    clippingAxis,
+    setClippingAxis,
+    dimensions,
+    statusText,
+    dispose
+  };
 }
-
 exports.useModelViewer = useModelViewer;