"use client"; import type { PropsWithChildren } from "react"; import { useMemo } from "react"; import type { OnboardingTourStep } from "@gfazioli/mantine-onboarding-tour"; import { clientApi } from "@homarr/api/client"; import { useRequiredBoard } from "@homarr/boards/context"; import { createDocumentationLink } from "@homarr/definitions"; import { useScopedI18n } from "@homarr/translation/client"; import { useBoardPermissions } from "~/components/board/permissions/client"; import { TourShell } from "./tour-shell"; import { TourStepContent } from "./tour-step-content"; export const BoardTourProvider = ({ children }: PropsWithChildren) => { const t = useScopedI18n("onboardingTour.board"); const board = useRequiredBoard(); const { hasChangeAccess } = useBoardPermissions(board); const utils = clientApi.useUtils(); const { data: tourStatus } = clientApi.user.getTourStatus.useQuery(); const { mutate: completeTour } = clientApi.user.completeTour.useMutation({ onSuccess() { void utils.user.getTourStatus.invalidate(); }, }); const started = tourStatus !== undefined && !tourStatus.completedBoardTour; const handleEnd = () => { utils.user.getTourStatus.setData(undefined, { completedManageTour: tourStatus?.completedManageTour ?? false, completedBoardTour: true, }); completeTour({ tour: "board" }); }; const steps = useMemo(() => { const allSteps: (OnboardingTourStep & { requiresChangeAccess?: boolean })[] = [ { id: "board-search", title: t("welcome.title"), content: ( ), }, { id: "board-edit-mode", title: t("editMode.title"), requiresChangeAccess: true, content: ( ), }, { id: "board-settings", title: t("settings.title"), requiresChangeAccess: true, content: ( ), }, { id: "board-switcher", title: t("switcher.title"), content: ( ), }, { id: "board-user-menu", title: t("userMenu.title"), content: ( ), }, ]; return allSteps.filter((step) => !step.requiresChangeAccess || hasChangeAccess) as OnboardingTourStep[]; }, [hasChangeAccess, t]); return ( {children} ); };