{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "ds-guided-tour",
  "title": "Guided Tour",
  "description": "A presentation component for a guided tour or onboarding card.",
  "dependencies": [
    "lucide-react"
  ],
  "registryDependencies": [
    "@lema-ds/button",
    "@lema-ds/ui-i18n",
    "@lema-ds/ds-locale-provider"
  ],
  "files": [
    {
      "path": "components/ds/ds-guided-tour.tsx",
      "content": "\"use client\"\n\nimport * as React from \"react\"\nimport { XIcon } from \"lucide-react\"\nimport { cn } from \"@/lib/utils\"\nimport { Button } from \"@/components/ui/button\"\nimport { UI_I18N, type UILocale } from \"@/lib/ui-i18n\"\nimport { useUILocale } from \"@/components/ui/ds-locale-provider\"\n\n// ── Types ──\n\nexport interface TourStep {\n  id: string\n  title: string\n  content: React.ReactNode\n}\n\nexport interface GuidedTourProps extends React.HTMLAttributes<HTMLDivElement> {\n  steps: TourStep[]\n  currentStep: number\n  onNext: () => void\n  onPrev?: () => void\n  onSkip?: () => void\n  onFinish?: () => void\n  locale?: UILocale\n}\n\n// ── Component ──\n\nexport const GuidedTour = React.forwardRef<HTMLDivElement, GuidedTourProps>(\n  (\n    {\n      className,\n      steps,\n      currentStep,\n      onNext,\n      onPrev,\n      onSkip,\n      onFinish,\n      locale: localeProp,\n      ...props\n    },\n    ref\n  ) => {\n    const locale = useUILocale(localeProp)\n    const i18n = UI_I18N[locale].guidedTour\n    const step = steps[currentStep]\n    const isFirstStep = currentStep === 0\n    const isLastStep = currentStep === steps.length - 1\n\n    React.useEffect(() => {\n      const onKey = (e: KeyboardEvent) => {\n        if (e.key === \"Escape\") onSkip?.()\n      }\n      window.addEventListener(\"keydown\", onKey)\n      return () => window.removeEventListener(\"keydown\", onKey)\n    }, [onSkip])\n\n    if (!step) return null\n\n    return (\n      <div\n        ref={ref}\n        className={cn(\n          \"relative flex w-80 flex-col rounded-lg border bg-popover p-4 text-popover-foreground shadow-lg\",\n          className\n        )}\n        data-slot=\"ds-guided-tour\"\n        role=\"dialog\"\n        aria-modal=\"true\"\n        aria-label={step.title}\n        aria-live=\"polite\"\n        tabIndex={-1}\n        {...props}\n      >\n        <div className=\"mb-2 flex items-center justify-between gap-4\">\n          <h4 className=\"font-semibold\">{step.title}</h4>\n          {onSkip && (\n            <Button\n              variant=\"ghost\"\n              size=\"icon\"\n              className=\"size-6 shrink-0 text-muted-foreground\"\n              onClick={onSkip}\n              aria-label={i18n.skip}\n            >\n              <XIcon className=\"size-4\" />\n            </Button>\n          )}\n        </div>\n\n        <div className=\"mb-6 text-sm text-muted-foreground\">{step.content}</div>\n\n        <div className=\"mt-auto flex items-center justify-between\">\n          <span className=\"sr-only\" aria-live=\"polite\">\n            {`Step ${currentStep + 1} of ${steps.length}`}\n          </span>\n          <div\n            className=\"flex gap-1\"\n            role=\"progressbar\"\n            aria-valuenow={currentStep + 1}\n            aria-valuemin={1}\n            aria-valuemax={steps.length}\n            aria-label={step.title}\n          >\n            {steps.map((s, index) => (\n              <span\n                key={s.id}\n                className={cn(\n                  \"size-1.5 rounded-full transition-colors\",\n                  index === currentStep\n                    ? \"bg-primary\"\n                    : \"bg-muted-foreground/30\"\n                )}\n                aria-hidden=\"true\"\n              />\n            ))}\n          </div>\n          <div className=\"flex items-center gap-2\">\n            {!isFirstStep && onPrev && (\n              <Button\n                variant=\"ghost\"\n                size=\"sm\"\n                onClick={onPrev}\n                className=\"h-7 text-xs\"\n              >\n                {i18n.previous}\n              </Button>\n            )}\n            <Button\n              variant=\"default\"\n              size=\"sm\"\n              onClick={isLastStep ? onFinish : onNext}\n              className=\"h-7 text-xs\"\n            >\n              {isLastStep ? i18n.finish : i18n.next}\n            </Button>\n          </div>\n        </div>\n      </div>\n    )\n  }\n)\nGuidedTour.displayName = \"GuidedTour\"\n",
      "type": "registry:ui"
    }
  ],
  "type": "registry:ui"
}
