## Plan: Help Button + Full Rotation Controls (X, Y, Z) ### 1. Add rotX and rotZ to the store Update `src/stores/useModelStore.ts`: - Add `rotX: number` and `rotZ: number` to the `FineTuning` interface - Set defaults to 0 in `defaultFineTuning` ### 2. Apply rotX/rotZ to the XR model Update `src/pages/XRSession.tsx` (`XRModel` component): - Read `rotX`, `rotZ` from fineTuning - Change `rotation={[0, rotYRad, 0]}` to `rotation={[rotXRad, rotYRad, rotZRad]}` Update `ControllerFineTuning`: - Map additional controller inputs (e.g., A/B buttons or grip+joystick combos) to rotX/rotZ, or leave rotation to the HUD controls ### 3. Add rotX/rotZ controls to XRHud Update `src/components/XRHud.tsx`: - In the fine-tuning expanded panel, add rotation rows for X° and Z° alongside the existing Y° control (same `+/−` button pattern) ### 4. Create Help panel with (?) button Update `src/components/XRHud.tsx`: - Add a `HelpCircle` (?) icon button to the main toolbar - When pressed, open a full-height slide-out panel (same pattern as the checklist panel) containing a scrollable list of all tools and controls with descriptions: Content sections: - **Posicionar (Hit-Test)**: Tap to place model on real surfaces - **Snap**: Auto-align to detected planes (floor, wall, table) - **Mover (Free Move)**: Use left joystick for X/Y, right joystick for Z movement - **Grid**: Toggle reference grid - **Sólido / Wire / Bordas**: Render mode switching - **Medir**: Tap two points to measure distance in mm - **Screenshot**: Capture current AR view - **Inspeção**: Open checklist to approve/reject items - **Opacidade**: Adjust model transparency - **Posição (mm)**: Fine-tune X/Y/Z in 1mm steps - **Rotação X° / Y° / Z°**: Rotate model around each axis - **Controladores Quest 3**: Joystick left = move X/Y, joystick right = move Z + rotate Y, grip = hold to move (when Free Move is off) ### 5. Also apply rotX/rotZ in desktop ModelViewer (if used) Check `src/components/three/ModelViewer.tsx` and update rotation there too for consistency. ### Files to modify - `src/stores/useModelStore.ts` — add rotX, rotZ fields - `src/pages/XRSession.tsx` — apply 3-axis rotation, update controller mapping - `src/components/XRHud.tsx` — add rotation controls for X/Z, add help (?) panel - `src/components/three/ModelViewer.tsx` — apply rotX/rotZ if fineTuning is used there