@pascal-app/viewer 1.1.1 → 1.1.3

package/README.md

@@ -353,6 +353,7 @@ import { LiveWalkthroughController, useViewer, Viewer } from '@pascal-app/viewer
 import {
   ParametricViewerRooms,
   SceneLoader,
+  ViewerCameraControls,
   ViewerControlsBar,
   ViewerSceneHeader,
   ViewerSelectionManager,
@@ -367,6 +368,7 @@ function ProjectViewer({ ready, name }: { ready: boolean; name: string }) {
     <div className="relative h-full w-full">
       <ViewerStage>
         <Viewer selectionManager="custom">
+          <ViewerCameraControls />
           <LiveWalkthroughController />
           <ViewerSelectionManager />
           <ParametricViewerRooms />
@@ -399,6 +401,28 @@ mounted, zones draw no tinted volume: a room shows through its pill and highligh
 `LiveWalkthroughController` moves the camera. Read `useFirstPersonHud` for the HUD's room and
 interaction props, as in the live walkthrough example above.
 
+### Camera controls and opening poses
+
+Mount `ViewerCameraControls` (`ViewerCameraControlsProps`) inside `Viewer` for right-drag orbit,
+middle-drag or Space + left-drag pan, wheel dolly (orthographic zoom), touch controls and the
+controls bar's frame, top-view and 90° orbit events. It synchronizes navigation with the floor
+plan, opens live scenes on the site's saved camera and unmounts its controls during walkthrough.
+Both optional props default to `false`: `glbActive` lets `GlbScene` frame the baked scene, and
+`holdOpening` leaves the opening view to an explicit pose. Distance limits remain 5–100 metres.
+
+`parseOpeningCamera(raw: string | null)` reads `px,py,pz,tx,ty,tz[,fov]` or returns `'saved'`;
+invalid input returns `null`. Coordinates are bounded to ±1000 metres, position and target must
+be at least 0.01 metres apart, and optional FOV is 10–120 degrees. `savedSceneCamera(nodes)`
+resolves the site's saved camera, then the building's, returning `OpeningCameraPose | null`.
+`OpeningCameraPose` has `position` and `target` tuples and an optional `fov`.
+
+For an explicit pose, pass `holdOpening={true}` to the controls and mount `ViewerOpeningCamera`
+(`ViewerOpeningCameraProps`) inside `Viewer` with `pose`, `ready` and `onApplied`. Once the scene
+is ready and controls exist, it applies the pose on the next animation frame without a transition,
+updates perspective FOV when supplied, then calls `onApplied`. It applies once per mount; keep
+the loader visible until the callback fires. Resolve `'saved'` through `savedSceneCamera` before
+passing a pose. These components and helpers all export from `@pascal-app/viewer/ui`.
+
 ## Asset CDN Helpers
 
 ```typescript

package/dist/ui/components/viewer-camera-controls.d.ts

@@ -0,0 +1,7 @@
+export type ViewerCameraControlsProps = {
+    glbActive?: boolean;
+    /** A `?camera=` pose owns the opening view. */
+    holdOpening?: boolean;
+};
+export declare const ViewerCameraControls: ({ glbActive, holdOpening, }?: ViewerCameraControlsProps) => import("react").JSX.Element | null;
+//# sourceMappingURL=viewer-camera-controls.d.ts.map

package/dist/ui/components/viewer-camera-controls.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewer-camera-controls.d.ts","sourceRoot":"","sources":["../../../src/ui/components/viewer-camera-controls.tsx"],"names":[],"mappings":"AAUA,MAAM,MAAM,yBAAyB,GAAG;IACtC,SAAS,CAAC,EAAE,OAAO,CAAA;IACnB,+CAA+C;IAC/C,WAAW,CAAC,EAAE,OAAO,CAAA;CACtB,CAAA;AAED,eAAO,MAAM,oBAAoB,iCAG9B,yBAAyB,uCAyM3B,CAAA"}

package/dist/ui/components/viewer-camera-controls.js

@@ -0,0 +1,162 @@
+'use client';
+import { jsx as _jsx } from "react/jsx-runtime";
+import { emitter, useScene } from '@pascal-app/core';
+import { CameraControls, CameraControlsImpl } from '@react-three/drei';
+import { useThree } from '@react-three/fiber';
+import { useCallback, useEffect, useMemo, useRef } from 'react';
+import useViewer from '../../store/use-viewer';
+import { frameViewerCamera } from '../lib/viewer-selection';
+import { useViewerCameraNavigationSync } from './use-viewer-camera-navigation-sync';
+export const ViewerCameraControls = ({ glbActive = false, holdOpening = false, } = {}) => {
+    const controls = useRef(null);
+    const site = useScene((s) => Object.values(s.nodes).find((node) => node.type === 'site'));
+    const cameraMode = useViewer((s) => s.cameraMode);
+    const walkthroughMode = useViewer((s) => s.walkthroughMode);
+    const firstLoad = useRef(true);
+    const opened = useRef(false);
+    const camera = useThree((state) => state.camera);
+    const publishNavigationPose = useViewerCameraNavigationSync(controls);
+    // Configure mouse buttons - same as editor
+    const mouseButtons = useMemo(() => {
+        const wheelAction = cameraMode === 'orthographic'
+            ? CameraControlsImpl.ACTION.ZOOM
+            : CameraControlsImpl.ACTION.DOLLY;
+        return {
+            left: CameraControlsImpl.ACTION.NONE,
+            middle: CameraControlsImpl.ACTION.SCREEN_PAN,
+            right: CameraControlsImpl.ACTION.ROTATE,
+            wheel: wheelAction,
+        };
+    }, [cameraMode]);
+    const touches = useMemo(() => ({
+        one: CameraControlsImpl.ACTION.TOUCH_ROTATE,
+        three: CameraControlsImpl.ACTION.TOUCH_ROTATE,
+        two: cameraMode === 'orthographic'
+            ? CameraControlsImpl.ACTION.TOUCH_ZOOM_TRUCK
+            : CameraControlsImpl.ACTION.TOUCH_DOLLY_TRUCK,
+    }), [cameraMode]);
+    // The parametric scene opens on the site's saved view (the baked one frames
+    // itself in `GlbScene`). After that only the navigation moves the camera.
+    useEffect(() => {
+        if (!controls.current || glbActive)
+            return;
+        // A default pose first, unless an opening pose places the camera: the saved
+        // view then animates from the pose instead of snapping to the default first.
+        if (firstLoad.current) {
+            firstLoad.current = false;
+            if (!holdOpening)
+                controls.current.setLookAt(30, 30, 30, 0, 0, 0, false);
+        }
+        if (opened.current || !site)
+            return;
+        opened.current = true;
+        if (holdOpening || !site.camera)
+            return;
+        const { position, target } = site.camera;
+        requestAnimationFrame(() => {
+            controls.current?.setLookAt(position[0], position[1], position[2], target[0], target[1], target[2], true);
+        });
+    }, [site, glbActive, holdOpening]);
+    // The bar, the floor list and the sidebar frame what they select.
+    useEffect(() => {
+        const onFrame = (event) => {
+            const control = controls.current;
+            if (!control)
+                return;
+            frameViewerCamera(control, camera, event);
+        };
+        emitter.on('camera-controls:frame', onFrame);
+        return () => emitter.off('camera-controls:frame', onFrame);
+    }, [camera]);
+    useEffect(() => {
+        const handleTopView = () => {
+            if (!controls.current)
+                return;
+            const currentPolarAngle = controls.current.polarAngle;
+            // Toggle: if already near top view (< 0.1 radians ≈ 5.7°), go back to 45°
+            // Otherwise, go to top view (0°)
+            const targetAngle = currentPolarAngle < 0.1 ? Math.PI / 4 : 0;
+            controls.current.rotatePolarTo(targetAngle, true);
+        };
+        const handleOrbitCW = () => {
+            if (!controls.current)
+                return;
+            const currentAzimuth = controls.current.azimuthAngle;
+            const currentPolar = controls.current.polarAngle;
+            // Round to nearest 90° increment, then rotate 90° clockwise
+            const rounded = Math.round(currentAzimuth / (Math.PI / 2)) * (Math.PI / 2);
+            const target = rounded - Math.PI / 2;
+            controls.current.rotateTo(target, currentPolar, true);
+        };
+        const handleOrbitCCW = () => {
+            if (!controls.current)
+                return;
+            const currentAzimuth = controls.current.azimuthAngle;
+            const currentPolar = controls.current.polarAngle;
+            // Round to nearest 90° increment, then rotate 90° counter-clockwise
+            const rounded = Math.round(currentAzimuth / (Math.PI / 2)) * (Math.PI / 2);
+            const target = rounded + Math.PI / 2;
+            controls.current.rotateTo(target, currentPolar, true);
+        };
+        emitter.on('camera-controls:top-view', handleTopView);
+        emitter.on('camera-controls:orbit-cw', handleOrbitCW);
+        emitter.on('camera-controls:orbit-ccw', handleOrbitCCW);
+        return () => {
+            emitter.off('camera-controls:top-view', handleTopView);
+            emitter.off('camera-controls:orbit-cw', handleOrbitCW);
+            emitter.off('camera-controls:orbit-ccw', handleOrbitCCW);
+        };
+    }, []);
+    useEffect(() => {
+        const keyState = {
+            space: false,
+        };
+        const updateConfig = () => {
+            if (!controls.current)
+                return;
+            const wheelAction = cameraMode === 'orthographic'
+                ? CameraControlsImpl.ACTION.ZOOM
+                : CameraControlsImpl.ACTION.DOLLY;
+            controls.current.mouseButtons.wheel = wheelAction;
+            controls.current.mouseButtons.middle = CameraControlsImpl.ACTION.SCREEN_PAN;
+            controls.current.mouseButtons.right = CameraControlsImpl.ACTION.ROTATE;
+            controls.current.mouseButtons.left = keyState.space
+                ? CameraControlsImpl.ACTION.SCREEN_PAN
+                : CameraControlsImpl.ACTION.NONE;
+        };
+        const onKeyDown = (event) => {
+            if (event.code !== 'Space')
+                return;
+            keyState.space = true;
+            document.body.style.cursor = 'grab';
+            updateConfig();
+        };
+        const onKeyUp = (event) => {
+            if (event.code !== 'Space')
+                return;
+            keyState.space = false;
+            document.body.style.cursor = '';
+            updateConfig();
+        };
+        document.addEventListener('keydown', onKeyDown);
+        document.addEventListener('keyup', onKeyUp);
+        updateConfig();
+        return () => {
+            document.removeEventListener('keydown', onKeyDown);
+            document.removeEventListener('keyup', onKeyUp);
+            if (document.body.style.cursor === 'grab') {
+                document.body.style.cursor = '';
+            }
+        };
+    }, [cameraMode]);
+    const onTransitionStart = useCallback(() => {
+        useViewer.getState().setCameraDragging(true);
+    }, []);
+    const onRest = useCallback(() => {
+        useViewer.getState().setCameraDragging(false);
+    }, []);
+    if (walkthroughMode) {
+        return null;
+    }
+    return (_jsx(CameraControls, { makeDefault: true, maxDistance: 100, maxPolarAngle: Math.PI / 2 - 0.1, minDistance: 5, minPolarAngle: 0, mouseButtons: mouseButtons, onRest: onRest, onSleep: onRest, onTransitionStart: onTransitionStart, onUpdate: publishNavigationPose, ref: controls, restThreshold: 0.01, touches: touches }));
+};

package/dist/ui/components/viewer-opening-camera.d.ts

@@ -0,0 +1,14 @@
+import type { OpeningCameraPose } from '../lib/opening-camera';
+export type ViewerOpeningCameraProps = {
+    onApplied: () => void;
+    pose: OpeningCameraPose;
+    ready: boolean;
+};
+/**
+ * Puts the camera on the opening pose once the scene is on screen. Both
+ * framing paths move the camera first (`ViewerCameraControls` to the site's
+ * bookmark, `GlbScene` to the building), so the pose lands a frame after
+ * readiness and without a transition: the last move is the one that sticks.
+ */
+export declare function ViewerOpeningCamera({ onApplied, pose, ready }: ViewerOpeningCameraProps): null;
+//# sourceMappingURL=viewer-opening-camera.d.ts.map

package/dist/ui/components/viewer-opening-camera.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"viewer-opening-camera.d.ts","sourceRoot":"","sources":["../../../src/ui/components/viewer-opening-camera.tsx"],"names":[],"mappings":"AAKA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAA;AAc9D,MAAM,MAAM,wBAAwB,GAAG;IACrC,SAAS,EAAE,MAAM,IAAI,CAAA;IACrB,IAAI,EAAE,iBAAiB,CAAA;IACvB,KAAK,EAAE,OAAO,CAAA;CACf,CAAA;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,wBAAwB,QAuBvF"}

package/dist/ui/components/viewer-opening-camera.js

@@ -0,0 +1,32 @@
+'use client';
+import { useThree } from '@react-three/fiber';
+import { useEffect, useRef } from 'react';
+/**
+ * Puts the camera on the opening pose once the scene is on screen. Both
+ * framing paths move the camera first (`ViewerCameraControls` to the site's
+ * bookmark, `GlbScene` to the building), so the pose lands a frame after
+ * readiness and without a transition: the last move is the one that sticks.
+ */
+export function ViewerOpeningCamera({ onApplied, pose, ready }) {
+    const controls = useThree((state) => state.controls);
+    const camera = useThree((state) => state.camera);
+    const applied = useRef(false);
+    useEffect(() => {
+        if (applied.current || !(ready && controls))
+            return;
+        const frame = requestAnimationFrame(() => {
+            applied.current = true;
+            const perspective = camera;
+            if (pose.fov !== undefined && perspective.isPerspectiveCamera) {
+                perspective.fov = pose.fov;
+                perspective.updateProjectionMatrix();
+            }
+            const [px, py, pz] = pose.position;
+            const [tx, ty, tz] = pose.target;
+            controls.setLookAt(px, py, pz, tx, ty, tz, false);
+            onApplied();
+        });
+        return () => cancelAnimationFrame(frame);
+    }, [camera, controls, onApplied, pose, ready]);
+    return null;
+}

package/dist/ui/index.d.ts

@@ -11,8 +11,10 @@ export { ParametricViewerRooms, ViewerRooms } from './components/rooms/viewer-ro
 export { SceneLoader, SceneLoadFailed } from './components/scene-loader';
 export { openSkyPanel, SKY_DOCK_HEIGHT, SkyControl, useSkyPanel } from './components/sky-control';
 export { useViewerCameraNavigationSync } from './components/use-viewer-camera-navigation-sync';
+export { ViewerCameraControls, type ViewerCameraControlsProps, } from './components/viewer-camera-controls';
 export { ViewerControlsBar, type ViewerControlsBarProps } from './components/viewer-controls-bar';
 export { ViewerHoverLabel, viewerHoverLabel } from './components/viewer-hover-label';
+export { ViewerOpeningCamera, type ViewerOpeningCameraProps, } from './components/viewer-opening-camera';
 export { type ViewerLinkProps, ViewerSceneHeader, type ViewerSceneHeaderProps, } from './components/viewer-scene-header';
 export { ViewerSelectionManager } from './components/viewer-selection-manager';
 export { ViewerStage, type ViewerStageProps } from './components/viewer-stage';
@@ -30,6 +32,7 @@ export { belowGradeShown, followBelowGrade, followGroundWindowBox, gradeStanding
 export { type CameraPoseApplicationPlan, normalizeCameraPose, planCameraPoseApplication, publishInitialCameraPose, releaseCameraPoseEventSuppression, stepCameraPoseInterpolation, withCameraPoseDistance, } from './lib/camera-pose';
 export { authoredLevelName, localizedLevelName } from './lib/level-name';
 export { nodeDisplayLabel } from './lib/node-display-label';
+export { type OpeningCameraPose, parseOpeningCamera, savedSceneCamera, } from './lib/opening-camera';
 export { formatRoomArea } from './lib/room-area';
 export { type RoomAssemblyHeights, resolveRoomAssemblyHeights } from './lib/room-assembly-overlay';
 export { type DescriptorTranslator, displayRoomName, editedRoomName, ROOM_NAME_MESSAGES, } from './lib/room-name-messages';

package/dist/ui/index.d.ts.map

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

package/dist/ui/index.js

@@ -11,8 +11,10 @@ export { ParametricViewerRooms, ViewerRooms } from './components/rooms/viewer-ro
 export { SceneLoader, SceneLoadFailed } from './components/scene-loader';
 export { openSkyPanel, SKY_DOCK_HEIGHT, SkyControl, useSkyPanel } from './components/sky-control';
 export { useViewerCameraNavigationSync } from './components/use-viewer-camera-navigation-sync';
+export { ViewerCameraControls, } from './components/viewer-camera-controls';
 export { ViewerControlsBar } from './components/viewer-controls-bar';
 export { ViewerHoverLabel, viewerHoverLabel } from './components/viewer-hover-label';
+export { ViewerOpeningCamera, } from './components/viewer-opening-camera';
 export { ViewerSceneHeader, } from './components/viewer-scene-header';
 export { ViewerSelectionManager } from './components/viewer-selection-manager';
 export { ViewerStage } from './components/viewer-stage';
@@ -30,6 +32,7 @@ export { belowGradeShown, followBelowGrade, followGroundWindowBox, gradeStanding
 export { normalizeCameraPose, planCameraPoseApplication, publishInitialCameraPose, releaseCameraPoseEventSuppression, stepCameraPoseInterpolation, withCameraPoseDistance, } from './lib/camera-pose';
 export { authoredLevelName, localizedLevelName } from './lib/level-name';
 export { nodeDisplayLabel } from './lib/node-display-label';
+export { parseOpeningCamera, savedSceneCamera, } from './lib/opening-camera';
 export { formatRoomArea } from './lib/room-area';
 export { resolveRoomAssemblyHeights } from './lib/room-assembly-overlay';
 export { displayRoomName, editedRoomName, ROOM_NAME_MESSAGES, } from './lib/room-name-messages';

package/dist/ui/lib/opening-camera.d.ts

@@ -0,0 +1,22 @@
+import type { AnyNode } from '@pascal-app/core';
+type Vec3 = [number, number, number];
+export type OpeningCameraPose = {
+    position: Vec3;
+    target: Vec3;
+    fov?: number;
+};
+/**
+ * Reads `?camera=`: `px,py,pz,tx,ty,tz[,fov]` in scene metres and degrees, or
+ * `saved` for the view saved on the scene. Anything else is null, so a
+ * malformed link opens on the default view instead of a broken one.
+ */
+export declare function parseOpeningCamera(raw: string | null): OpeningCameraPose | 'saved' | null;
+/**
+ * The view saved on the scene: the camera captured on the site in the editor,
+ * else the one on the building. Both viewer paths already open near it by
+ * default, but they disagree on which node wins (the parametric viewer reads
+ * the site, the baked one the building); `camera=saved` pins one rule.
+ */
+export declare function savedSceneCamera(nodes: Readonly<Record<string, AnyNode>>): OpeningCameraPose | null;
+export {};
+//# sourceMappingURL=opening-camera.d.ts.map

package/dist/ui/lib/opening-camera.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"opening-camera.d.ts","sourceRoot":"","sources":["../../../src/ui/lib/opening-camera.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAA;AAE/C,KAAK,IAAI,GAAG,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAA;AAEpC,MAAM,MAAM,iBAAiB,GAAG;IAAE,QAAQ,EAAE,IAAI,CAAC;IAAC,MAAM,EAAE,IAAI,CAAC;IAAC,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAO9E;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,GAAG,iBAAiB,GAAG,OAAO,GAAG,IAAI,CAqBzF;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GACvC,iBAAiB,GAAG,IAAI,CAM1B"}

package/dist/ui/lib/opening-camera.js

@@ -0,0 +1,42 @@
+// The viewer camera's far plane is 1000 m; a pose beyond it frames nothing.
+const MAX_COORDINATE = 1000;
+const MIN_FOV = 10;
+const MAX_FOV = 120;
+/**
+ * Reads `?camera=`: `px,py,pz,tx,ty,tz[,fov]` in scene metres and degrees, or
+ * `saved` for the view saved on the scene. Anything else is null, so a
+ * malformed link opens on the default view instead of a broken one.
+ */
+export function parseOpeningCamera(raw) {
+    if (raw === 'saved')
+        return 'saved';
+    const parts = raw?.split(',') ?? [];
+    if (parts.length !== 6 && parts.length !== 7)
+        return null;
+    if (parts.some((part) => part.trim() === ''))
+        return null;
+    const values = parts.map(Number);
+    const [px, py, pz, tx, ty, tz, fov] = values;
+    if (values.slice(0, 6).some((value) => !(Math.abs(value) <= MAX_COORDINATE)))
+        return null;
+    if (Math.hypot(px - tx, py - ty, pz - tz) < 0.01)
+        return null;
+    const pose = { position: [px, py, pz], target: [tx, ty, tz] };
+    if (fov === undefined)
+        return pose;
+    if (!(fov >= MIN_FOV && fov <= MAX_FOV))
+        return null;
+    return { ...pose, fov };
+}
+/**
+ * The view saved on the scene: the camera captured on the site in the editor,
+ * else the one on the building. Both viewer paths already open near it by
+ * default, but they disagree on which node wins (the parametric viewer reads
+ * the site, the baked one the building); `camera=saved` pins one rule.
+ */
+export function savedSceneCamera(nodes) {
+    const all = Object.values(nodes);
+    const saved = all.find((node) => node.type === 'site')?.camera ??
+        all.find((node) => node.type === 'building')?.camera;
+    return saved ? { position: saved.position, target: saved.target } : null;
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pascal-app/viewer",
-  "version": "1.1.1",
+  "version": "1.1.3",
   "description": "3D viewer component for Pascal building editor",
   "type": "module",
   "main": "./dist/index.js",
@@ -48,7 +48,7 @@
     "prepublishOnly": "npm run build"
   },
   "peerDependencies": {
-    "@pascal-app/core": "^1.1.1",
+    "@pascal-app/core": "^1.1.3",
     "@react-three/drei": "^10",
     "@react-three/fiber": "^9",
     "react": "^19",
@@ -72,7 +72,7 @@
     "zustand": "^5"
   },
   "devDependencies": {
-    "@pascal-app/core": "^1.1.1",
+    "@pascal-app/core": "^1.1.3",
     "@pascal/typescript-config": "*",
     "@react-three/test-renderer": "^9.1.1",
     "@types/howler": "^2.2.13",