Function useTutorial

apps/chat/src/hooks/useTutorial.js:75–512

(isOpen, onClose, customSteps = null)

};

export const useTutorial = (isOpen, onClose, customSteps = null) => {
    const [currentStep, setCurrentStep] = useState(0);
    const [previousStep, setPreviousStep] = useState(0);
    const [highlightRect, setHighlightRect] = useState(null);
    const [tooltipPosition, setTooltipPosition] = useState({
        x: 0,
        y: 0,
        width: TUTORIAL_CONFIG.TOOLTIP_WIDTH,
        arrowDirection: "none",
    });
    const [animationState, setAnimationState] = useState({
        isTransitioning: false,
        contentVisible: true,
        transitionProgress: 1,
    });
    const [isInitialized, setIsInitialized] = useState(false);

    const timeoutRef = useRef(null);
    const animationFrameRef = useRef(null);
    const isMountedRef = useRef(true);
    const debounceRef = useRef(null);
    const updatePositionsRef = useRef(null);
    const lastAnimatedStepRef = useRef(0);

    const steps = useMemo(() => {
        return customSteps || DEFAULT_TUTORIAL_STEPS;
    }, [customSteps]);

    const currentStepData = useMemo(() => {
        return steps[currentStep] || steps[0];
    }, [steps, currentStep]);

    const _viewport = useMemo(() => {
        if (typeof window === "undefined") {
            return { width: 1024, height: 768, isMobile: false };
        }
        const width = window.innerWidth;
        const height = window.innerHeight;
        return {
            width,
            height,
            isMobile: width <= TUTORIAL_CONFIG.MOBILE_BREAKPOINT,
        };
    }, []);

    const clearAllTimers = useCallback(() => {
        if (timeoutRef.current) {
            clearTimeout(timeoutRef.current);
            timeoutRef.current = null;
        }
        if (animationFrameRef.current) {
            cancelAnimationFrame(animationFrameRef.current);
            animationFrameRef.current = null;
        }
        if (debounceRef.current) {
            clearTimeout(debounceRef.current);
            debounceRef.current = null;
        }