{
  "$schema": "https://ui.shadcn.com/schema/registry-item.json",
  "name": "ds-carousel",
  "title": "Carousel UI",
  "description": "Extended carousel with autoplay support via embla-carousel-autoplay, multiple nav variants (side/overlay/bottom/none), card/showcase/minimal display modes, dot indicators, responsive slides-per-view, external API control via setApi, i18n aria-labels, and skeleton loading. Wraps the shadcn Carousel primitive.",
  "dependencies": [
    "embla-carousel-autoplay",
    "embla-carousel-react",
    "class-variance-authority",
    "lucide-react"
  ],
  "registryDependencies": [
    "@lema-ds/carousel",
    "@lema-ds/skeleton",
    "@lema-ds/ui-i18n",
    "@lema-ds/ds-locale-provider"
  ],
  "files": [
    {
      "path": "components/ds/ds-carousel.tsx",
      "content": "\"use client\"\n\nimport * as React from \"react\"\nimport Autoplay from \"embla-carousel-autoplay\"\nimport type { UseEmblaCarouselType } from \"embla-carousel-react\"\nimport { cva } from \"class-variance-authority\"\nimport type { VariantProps } from \"class-variance-authority\"\n\nimport { cn } from \"@/lib/utils\"\nimport { UI_I18N, type UILocale } from \"@/lib/ui-i18n\"\nimport { useUILocale } from \"@/components/ui/ds-locale-provider\"\nimport {\n  Carousel as CarouselRoot,\n  CarouselContent,\n  CarouselItem,\n  CarouselPrevious,\n  CarouselNext,\n  useCarousel,\n} from \"@/components/ui/carousel\"\nimport { Skeleton } from \"@/components/ui/skeleton\"\nimport { ChevronLeftIcon, ChevronRightIcon } from \"lucide-react\"\n\n// ── Types ──\n\nexport type CarouselApi = UseEmblaCarouselType[1]\n\nexport type CarouselVariant = \"default\" | \"cards\" | \"showcase\" | \"minimal\"\nexport type CarouselNavPosition = \"side\" | \"overlay\" | \"bottom\" | \"none\"\nexport type CarouselNavVariant = \"outline\" | \"ghost\" | \"primary\" | \"secondary\"\nexport type CarouselNavSize = \"icon-sm\" | \"icon\" | \"icon-lg\"\nexport type CarouselDotPosition = \"bottom\" | \"overlay\"\nexport type CarouselDotVariant = \"filled\" | \"outline\"\n\nexport interface CarouselSlidesPerView {\n  sm?: number\n  md?: number\n  lg?: number\n}\n\nexport interface CarouselProps extends VariantProps<typeof carouselVariants> {\n  variant?: CarouselVariant\n  orientation?: \"horizontal\" | \"vertical\"\n  setApi?: (api: CarouselApi) => void\n  slidesPerView?: number | CarouselSlidesPerView\n  autoplayInterval?: number\n  pauseOnHover?: boolean\n  showDots?: boolean\n  showProgress?: boolean\n  loading?: boolean\n  loadingSlideCount?: number\n  locale?: UILocale\n  navVariant?: CarouselNavVariant\n  navSize?: CarouselNavSize\n  navPosition?: CarouselNavPosition\n  dotVariant?: CarouselDotVariant\n  dotPosition?: CarouselDotPosition\n  loop?: boolean\n  align?: \"start\" | \"center\" | \"end\"\n  skipSnaps?: boolean\n  className?: string\n  children?: React.ReactNode\n}\n\n// ── Variants ──\n\nexport const carouselVariants = cva(\"\", {\n  variants: {\n    variant: {\n      default: \"\",\n      cards:\n        \"[&_[data-slot=carousel-item]>*]:rounded-xl [&_[data-slot=carousel-item]>*]:border [&_[data-slot=carousel-item]>*]:border-border [&_[data-slot=carousel-item]>*]:bg-card [&_[data-slot=carousel-item]>*]:shadow-sm\",\n      showcase: \"[&_[data-slot=carousel-content]]:overflow-visible\",\n      minimal: \"\",\n    },\n  },\n  defaultVariants: {\n    variant: \"default\",\n  },\n})\n\n// ── Helpers ──\n\nfunction resolveSlidesPerView(\n  slidesPerView: number | CarouselSlidesPerView | undefined\n): string {\n  if (!slidesPerView) return \"\"\n  if (typeof slidesPerView === \"number\") {\n    if (slidesPerView === 1) return \"\"\n    if (slidesPerView === 2) return \"md:basis-1/2\"\n    if (slidesPerView === 3) return \"md:basis-1/3\"\n    if (slidesPerView === 4) return \"md:basis-1/4\"\n    if (slidesPerView === 5) return \"md:basis-1/5\"\n    if (slidesPerView === 6) return \"md:basis-1/6\"\n    return \"\"\n  }\n  const parts: string[] = []\n  if (slidesPerView.sm) parts.push(`basis-1/${slidesPerView.sm}`)\n  if (slidesPerView.md) parts.push(`md:basis-1/${slidesPerView.md}`)\n  if (slidesPerView.lg) parts.push(`lg:basis-1/${slidesPerView.lg}`)\n  return parts.join(\" \")\n}\n\nfunction navOverrides(navVariant: CarouselNavVariant): {\n  variant: \"outline\" | \"ghost\" | \"default\"\n  className: string\n} {\n  const base =\n    \"absolute z-10 touch-manipulation rounded-full transition-all duration-200\"\n  switch (navVariant) {\n    case \"primary\":\n      return {\n        variant: \"default\",\n        className: cn(\n          base,\n          \"bg-primary text-primary-foreground hover:bg-primary/90\"\n        ),\n      }\n    case \"secondary\":\n      return {\n        variant: \"default\",\n        className: cn(\n          base,\n          \"bg-secondary text-secondary-foreground hover:bg-secondary/80\"\n        ),\n      }\n    case \"ghost\":\n      return { variant: \"ghost\", className: base }\n    default:\n      return { variant: \"outline\", className: base }\n  }\n}\n\nfunction navPositionClasses(\n  pos: CarouselNavPosition,\n  orientation: \"horizontal\" | \"vertical\"\n) {\n  if (pos === \"overlay\") {\n    return orientation === \"horizontal\"\n      ? \"left-3 opacity-0 group-hover/carousel:opacity-100 group-focus-within/carousel:opacity-100 focus-visible:opacity-100\"\n      : \"top-3 rotate-90 opacity-0 group-hover/carousel:opacity-100 group-focus-within/carousel:opacity-100 focus-visible:opacity-100\"\n  }\n  if (pos === \"bottom\") {\n    return orientation === \"horizontal\"\n      ? \"static mx-1\"\n      : \"static mx-1 rotate-90\"\n  }\n  return \"\"\n}\n\nfunction navPositionNextClasses(\n  pos: CarouselNavPosition,\n  orientation: \"horizontal\" | \"vertical\"\n) {\n  if (pos === \"overlay\") {\n    return orientation === \"horizontal\"\n      ? \"right-3 opacity-0 group-hover/carousel:opacity-100 group-focus-within/carousel:opacity-100 focus-visible:opacity-100\"\n      : \"bottom-3 rotate-90 opacity-0 group-hover/carousel:opacity-100 group-focus-within/carousel:opacity-100 focus-visible:opacity-100\"\n  }\n  if (pos === \"bottom\") {\n    return orientation === \"horizontal\"\n      ? \"static mx-1\"\n      : \"static mx-1 rotate-90\"\n  }\n  return \"\"\n}\n\n// ── CarouselProgress ──\n\nfunction CarouselProgress({\n  orientation,\n}: {\n  orientation: \"horizontal\" | \"vertical\"\n}) {\n  const { api } = useCarousel()\n  const [progress, setProgress] = React.useState(0)\n\n  React.useEffect(() => {\n    if (!api) return\n    const handler = () => setProgress(api.scrollProgress())\n    api.on(\"scroll\", handler)\n    api.on(\"select\", handler)\n    api.on(\"init\", handler)\n    return () => {\n      api.off(\"scroll\", handler)\n      api.off(\"select\", handler)\n      api.off(\"init\", handler)\n    }\n  }, [api])\n\n  return (\n    <div\n      data-slot=\"ds-carousel-progress\"\n      className={cn(\n        \"absolute z-10 rounded-full bg-muted\",\n        orientation === \"horizontal\"\n          ? \"inset-x-0 top-0 h-1\"\n          : \"inset-y-0 left-0 w-1\"\n      )}\n    >\n      <div\n        className={cn(\n          \"rounded-full bg-primary transition-all duration-300\",\n          orientation === \"horizontal\" ? \"h-full\" : \"w-full\"\n        )}\n        style={\n          orientation === \"horizontal\"\n            ? { width: `${Math.abs(progress) * 100}%` }\n            : { height: `${Math.abs(progress) * 100}%` }\n        }\n      />\n    </div>\n  )\n}\n\n// ── CarouselDots ──\n\nfunction CarouselDots({\n  dotVariant,\n  dotPosition,\n  locale,\n}: {\n  dotVariant: CarouselDotVariant\n  dotPosition: CarouselDotPosition\n  locale: UILocale\n}) {\n  const { api, orientation } = useCarousel()\n  const [selectedIndex, setSelectedIndex] = React.useState(0)\n  const [scrollSnaps, setScrollSnaps] = React.useState<number[]>([])\n  const i18n = UI_I18N[locale]\n\n  React.useEffect(() => {\n    if (!api) return\n    const handler = () => {\n      setSelectedIndex(api.selectedScrollSnap())\n      setScrollSnaps(api.scrollSnapList())\n    }\n    api.on(\"init\", handler)\n    api.on(\"select\", handler)\n    api.on(\"reInit\", handler)\n    handler()\n    return () => {\n      api.off(\"init\", handler)\n      api.off(\"select\", handler)\n      api.off(\"reInit\", handler)\n    }\n  }, [api])\n\n  if (scrollSnaps.length <= 1) return null\n\n  return (\n    <div\n      data-slot=\"ds-carousel-dots\"\n      className={cn(\n        \"flex flex-wrap items-center justify-center gap-2\",\n        dotPosition === \"bottom\" && \"mt-4\",\n        dotPosition === \"overlay\" && \"absolute inset-x-0 bottom-3\",\n        orientation === \"vertical\" && \"flex-col\"\n      )}\n      role=\"tablist\"\n      aria-label={i18n.carousel.goToSlide}\n    >\n      {scrollSnaps.map((_, index) => (\n        <button\n          key={index}\n          type=\"button\"\n          role=\"tab\"\n          aria-selected={index === selectedIndex}\n          aria-label={`${i18n.carousel.goToSlide} ${index + 1}`}\n          onClick={() => api?.scrollTo(index)}\n          className={cn(\n            \"relative -m-3 flex size-2.5 items-center justify-center rounded-full p-3 transition-all duration-200 focus-visible:ring-2 focus-visible:ring-ring focus-visible:ring-offset-2 focus-visible:outline-none sm:-m-2 sm:p-2\",\n            dotVariant === \"filled\" &&\n              (index === selectedIndex\n                ? \"bg-primary\"\n                : \"bg-muted-foreground/30 hover:bg-muted-foreground/50\"),\n            dotVariant === \"outline\" &&\n              (index === selectedIndex\n                ? \"border-2 border-primary bg-primary/10\"\n                : \"border-2 border-muted-foreground/30 bg-transparent hover:border-muted-foreground/50\")\n          )}\n        >\n          <span\n            className={cn(\n              \"size-2.5 rounded-full\",\n              index === selectedIndex ? \"bg-primary\" : \"bg-transparent\"\n            )}\n            aria-hidden=\"true\"\n          />\n        </button>\n      ))}\n    </div>\n  )\n}\n\n// ── Component ──\n\nexport function Carousel({\n  variant = \"default\",\n  orientation = \"horizontal\",\n  setApi,\n  slidesPerView,\n  autoplayInterval,\n  pauseOnHover = true,\n  showDots = true,\n  showProgress = false,\n  loading = false,\n  loadingSlideCount = 4,\n  locale: localeProp,\n  navVariant: navVariantProp = \"outline\",\n  navSize = \"icon-sm\",\n  navPosition: navPositionProp,\n  dotVariant = \"filled\",\n  dotPosition = \"bottom\",\n  loop = false,\n  align = \"start\",\n  skipSnaps = false,\n  className,\n  children,\n}: CarouselProps) {\n  const locale = useUILocale(localeProp)\n  const containerRef = React.useRef<HTMLDivElement>(null)\n  const [internalApi, setInternalApi] = React.useState<CarouselApi | undefined>(\n    undefined\n  )\n\n  const handleSetApi = React.useCallback(\n    (api: CarouselApi) => {\n      setInternalApi(api)\n      setApi?.(api)\n    },\n    [setApi]\n  )\n\n  const autoplayPlugin = React.useMemo(() => {\n    if (!autoplayInterval || autoplayInterval <= 0) return null\n    if (\n      typeof window !== \"undefined\" &&\n      window.matchMedia(\"(prefers-reduced-motion: reduce)\").matches\n    )\n      return null\n    return Autoplay({\n      delay: autoplayInterval,\n      stopOnInteraction: true,\n      stopOnMouseEnter: pauseOnHover,\n    })\n  }, [autoplayInterval, pauseOnHover])\n\n  const plugins = React.useMemo(\n    () => (autoplayPlugin ? [autoplayPlugin] : undefined),\n    [autoplayPlugin]\n  )\n\n  // Pause autoplay when not in viewport — respects prefers-reduced-motion\n  // and avoids background work when carousel is off-screen.\n  React.useEffect(() => {\n    if (!internalApi || !autoplayPlugin || !containerRef.current) return\n    const node = containerRef.current\n    const autoplay = (\n      internalApi.plugins() as unknown as {\n        autoplay?: { play: () => void; stop: () => void }\n      }\n    )?.autoplay\n    if (!autoplay) return\n    if (typeof IntersectionObserver === \"undefined\") return\n    const observer = new IntersectionObserver(\n      (entries) => {\n        const entry = entries[0]\n        if (!entry) return\n        if (entry.isIntersecting) {\n          if (\n            typeof window !== \"undefined\" &&\n            !window.matchMedia(\"(prefers-reduced-motion: reduce)\").matches\n          ) {\n            autoplay.play()\n          }\n        } else {\n          autoplay.stop()\n        }\n      },\n      { threshold: 0.2 }\n    )\n    observer.observe(node)\n    return () => observer.disconnect()\n  }, [internalApi, autoplayPlugin])\n\n  const resolvedNavPosition: CarouselNavPosition =\n    navPositionProp ??\n    (variant === \"minimal\"\n      ? \"none\"\n      : variant === \"showcase\"\n        ? \"overlay\"\n        : \"side\")\n\n  const navWrap = navOverrides(navVariantProp)\n  const i18n = UI_I18N[locale]\n  const spv = resolveSlidesPerView(slidesPerView)\n\n  if (loading) {\n    return (\n      <div\n        data-slot=\"ds-carousel\"\n        className={cn(\"relative\", carouselVariants({ variant }), className)}\n      >\n        <div className=\"overflow-hidden\">\n          <div\n            className={cn(\n              \"flex\",\n              orientation === \"horizontal\" ? \"-ml-4\" : \"-mt-4 flex-col\"\n            )}\n          >\n            {Array.from({ length: loadingSlideCount }).map((_, i) => (\n              <div\n                key={i}\n                className={cn(\n                  \"min-w-0 shrink-0 grow-0 basis-full pl-4\",\n                  spv,\n                  orientation === \"vertical\" && \"basis-auto pt-4 pl-0\"\n                )}\n              >\n                <Skeleton\n                  className={cn(\n                    \"h-48 w-full rounded-xl\",\n                    variant === \"cards\" && \"h-64\",\n                    variant === \"showcase\" && \"h-96\"\n                  )}\n                />\n              </div>\n            ))}\n          </div>\n        </div>\n      </div>\n    )\n  }\n\n  return (\n    <div ref={containerRef} data-slot=\"ds-carousel-viewport-sentinel\">\n      <CarouselRoot\n        data-slot=\"ds-carousel\"\n        className={cn(\n          \"group/carousel relative\",\n          carouselVariants({ variant }),\n          className\n        )}\n        opts={{ loop, align, skipSnaps }}\n        plugins={plugins}\n        orientation={orientation}\n        setApi={handleSetApi}\n      >\n        {showProgress && <CarouselProgress orientation={orientation} />}\n\n        <CarouselContent>\n          {React.Children.map(children, (child) => (\n            <CarouselItem\n              className={cn(spv, orientation === \"vertical\" && \"basis-auto\")}\n            >\n              {child}\n            </CarouselItem>\n          ))}\n        </CarouselContent>\n\n        {resolvedNavPosition !== \"none\" && (\n          <>\n            <CarouselPrevious\n              data-slot=\"ds-carousel-prev\"\n              variant={navWrap.variant}\n              size={navSize}\n              aria-label={i18n.carousel.previous}\n              disabled={!loop ? undefined : undefined}\n              className={cn(\n                navWrap.className,\n                navPositionClasses(resolvedNavPosition, orientation)\n              )}\n            >\n              <ChevronLeftIcon />\n            </CarouselPrevious>\n            <CarouselNext\n              data-slot=\"ds-carousel-next\"\n              variant={navWrap.variant}\n              size={navSize}\n              aria-label={i18n.carousel.next}\n              className={cn(\n                navWrap.className,\n                navPositionNextClasses(resolvedNavPosition, orientation)\n              )}\n            >\n              <ChevronRightIcon />\n            </CarouselNext>\n          </>\n        )}\n\n        {showDots && (\n          <CarouselDots\n            dotVariant={dotVariant}\n            dotPosition={dotPosition}\n            locale={locale}\n          />\n        )}\n      </CarouselRoot>\n    </div>\n  )\n}\n",
      "type": "registry:ui"
    }
  ],
  "type": "registry:ui"
}
