|
| 1 | +import { useCallback, useEffect, useRef, useState } from "react"; |
| 2 | +import { useNavigate } from "react-router-dom"; |
| 3 | +import { useGameStore } from "@/store/useGameStore"; |
| 4 | +import { useUIStore } from "@/store/useUIStore"; |
| 5 | +import { useScan } from "@/hooks/useGames"; |
| 6 | +import { api } from "@/lib/tauri"; |
| 7 | +import { getFastSteps, getStandardSteps, getDetailedSteps } from "./steps"; |
| 8 | +import TourSpotlight from "./TourSpotlight"; |
| 9 | +import TourCard from "./TourCard"; |
| 10 | +import TourFinale from "./TourFinale"; |
| 11 | +import type { TourStep } from "./steps"; |
| 12 | + |
| 13 | +function getSteps(mode: "fast" | "standard" | "detailed", deps: Parameters<typeof getFastSteps>[0]): TourStep[] { |
| 14 | + if (mode === "fast") return getFastSteps(deps); |
| 15 | + if (mode === "standard") return getStandardSteps(deps); |
| 16 | + return getDetailedSteps(deps); |
| 17 | +} |
| 18 | + |
| 19 | +export default function OnboardingTour() { |
| 20 | + const tourOpen = useUIStore((s) => s.tourOpen); |
| 21 | + const setTourOpen = useUIStore((s) => s.setTourOpen); |
| 22 | + const tourMode = useUIStore((s) => s.tourMode); |
| 23 | + const setDetailOpen = useUIStore((s) => s.setDetailOpen); |
| 24 | + const setAddGameOpen = useUIStore((s) => s.setAddGameOpen); |
| 25 | + const setSelectedGameId = useGameStore((s) => s.setSelectedGameId); |
| 26 | + const navigate = useNavigate(); |
| 27 | + const { scan } = useScan(); |
| 28 | + |
| 29 | + const [stepIndex, setStepIndex] = useState(0); |
| 30 | + const [steps, setSteps] = useState<TourStep[]>([]); |
| 31 | + const [loading, setLoading] = useState(false); |
| 32 | + const [showFinale, setShowFinale] = useState(false); |
| 33 | + const stepIndexRef = useRef(0); |
| 34 | + |
| 35 | + useEffect(() => { |
| 36 | + if (!tourOpen || !tourMode) return; |
| 37 | + const deps = { navigate, setSelectedGameId, setDetailOpen, setAddGameOpen, triggerScan: scan }; |
| 38 | + const newSteps = getSteps(tourMode, deps); |
| 39 | + setSteps(newSteps); |
| 40 | + setStepIndex(0); |
| 41 | + stepIndexRef.current = 0; |
| 42 | + setShowFinale(false); |
| 43 | + |
| 44 | + (async () => { |
| 45 | + const first = newSteps[0]; |
| 46 | + if (first?.before) { |
| 47 | + setLoading(true); |
| 48 | + try { await first.before(); } catch {} |
| 49 | + setLoading(false); |
| 50 | + } |
| 51 | + if (first?.afterRender) { |
| 52 | + try { await first.afterRender(); } catch {} |
| 53 | + } |
| 54 | + })(); |
| 55 | + }, [tourOpen, tourMode]); |
| 56 | + |
| 57 | + const finishTour = useCallback(async () => { |
| 58 | + setTourOpen(false); |
| 59 | + setShowFinale(false); |
| 60 | + setDetailOpen(false); |
| 61 | + setAddGameOpen(false); |
| 62 | + navigate("/"); |
| 63 | + await api.saveSetting("onboarding_completed", "true"); |
| 64 | + if (tourMode) await api.saveSetting("onboarding_tour_mode", tourMode); |
| 65 | + }, [tourMode, setTourOpen, setDetailOpen, setAddGameOpen, navigate]); |
| 66 | + |
| 67 | + const completeTour = useCallback(async () => { |
| 68 | + const currentStep = steps[stepIndexRef.current]; |
| 69 | + if (currentStep?.after) { |
| 70 | + try { await currentStep.after(); } catch {} |
| 71 | + } |
| 72 | + |
| 73 | + if (currentStep?.id === "done" || steps[stepIndexRef.current]?.id === "shortcuts") { |
| 74 | + setDetailOpen(false); |
| 75 | + setAddGameOpen(false); |
| 76 | + navigate("/"); |
| 77 | + setShowFinale(true); |
| 78 | + return; |
| 79 | + } |
| 80 | + |
| 81 | + await finishTour(); |
| 82 | + }, [steps, setDetailOpen, setAddGameOpen, navigate, finishTour]); |
| 83 | + |
| 84 | + const goToStep = useCallback(async (index: number) => { |
| 85 | + if (index < 0 || index >= steps.length) return; |
| 86 | + setLoading(true); |
| 87 | + |
| 88 | + const currentStep = steps[stepIndexRef.current]; |
| 89 | + if (currentStep?.after) { |
| 90 | + try { await currentStep.after(); } catch {} |
| 91 | + } |
| 92 | + |
| 93 | + const nextStep = steps[index]; |
| 94 | + |
| 95 | + if (nextStep.id === "done") { |
| 96 | + setDetailOpen(false); |
| 97 | + setAddGameOpen(false); |
| 98 | + navigate("/"); |
| 99 | + await new Promise((r) => requestAnimationFrame(r)); |
| 100 | + setShowFinale(true); |
| 101 | + setLoading(false); |
| 102 | + return; |
| 103 | + } |
| 104 | + |
| 105 | + if (nextStep.before) { |
| 106 | + try { await nextStep.before(); } catch {} |
| 107 | + } |
| 108 | + |
| 109 | + await new Promise((r) => requestAnimationFrame(r)); |
| 110 | + stepIndexRef.current = index; |
| 111 | + setStepIndex(index); |
| 112 | + setLoading(false); |
| 113 | + |
| 114 | + if (nextStep.afterRender) { |
| 115 | + try { await nextStep.afterRender(); } catch {} |
| 116 | + } |
| 117 | + }, [steps, setDetailOpen, setAddGameOpen, navigate]); |
| 118 | + |
| 119 | + const handleNext = useCallback(async () => { |
| 120 | + if (stepIndexRef.current >= steps.length - 1) { await completeTour(); return; } |
| 121 | + await goToStep(stepIndexRef.current + 1); |
| 122 | + }, [steps.length, completeTour, goToStep]); |
| 123 | + |
| 124 | + const handleBack = useCallback(async () => { |
| 125 | + if (stepIndexRef.current > 0) await goToStep(stepIndexRef.current - 1); |
| 126 | + }, [goToStep]); |
| 127 | + |
| 128 | + useEffect(() => { |
| 129 | + if (!tourOpen || showFinale) return; |
| 130 | + const handler = (e: KeyboardEvent) => { |
| 131 | + if (e.key === "Escape") { completeTour(); return; } |
| 132 | + if (e.key === "ArrowRight" || e.key === "Enter") { e.preventDefault(); handleNext(); return; } |
| 133 | + if (e.key === "ArrowLeft") { e.preventDefault(); handleBack(); } |
| 134 | + }; |
| 135 | + window.addEventListener("keydown", handler, true); |
| 136 | + return () => window.removeEventListener("keydown", handler, true); |
| 137 | + }, [tourOpen, showFinale, handleNext, handleBack, completeTour]); |
| 138 | + |
| 139 | + if (!tourOpen || steps.length === 0) return null; |
| 140 | + |
| 141 | + if (showFinale) { |
| 142 | + return <TourFinale onComplete={finishTour} />; |
| 143 | + } |
| 144 | + |
| 145 | + const step = steps[stepIndex]; |
| 146 | + const showChapters = tourMode === "detailed"; |
| 147 | + |
| 148 | + return ( |
| 149 | + <> |
| 150 | + <TourSpotlight target={step.target} stepId={step.id} /> |
| 151 | + <TourCard |
| 152 | + step={step} |
| 153 | + stepIndex={stepIndex} |
| 154 | + totalSteps={steps.length - 1} |
| 155 | + onNext={handleNext} |
| 156 | + onBack={handleBack} |
| 157 | + onSkip={completeTour} |
| 158 | + showChapters={showChapters} |
| 159 | + loading={loading} |
| 160 | + /> |
| 161 | + </> |
| 162 | + ); |
| 163 | +} |
0 commit comments