SteelXR/.lovable/plan.md

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