'use client'; import * as React from 'react'; import useEmblaCarousel, { type UseEmblaCarouselType } from 'embla-carousel-react'; import { ArrowLeft, ArrowRight } from 'lucide-react'; import { cn } from '../../shared/utils'; import { Button } from '../button'; type CarouselApi = UseEmblaCarouselType[1]; type UseCarouselParameters = Parameters; type CarouselOptions = UseCarouselParameters[0]; type CarouselPlugin = UseCarouselParameters[1]; type CarouselProps = { opts?: CarouselOptions; plugins?: CarouselPlugin; orientation?: 'horizontal' | 'vertical'; setApi?: (api: CarouselApi) => void; }; type CarouselContextProps = { carouselRef: ReturnType[0]; api: ReturnType[1]; scrollPrev: () => void; scrollNext: () => void; canScrollPrev: boolean; canScrollNext: boolean; } & CarouselProps; const orientationToEmblaAxis: Record<'horizontal' | 'vertical', 'x' | 'y'> = { horizontal: 'x', vertical: 'y', }; const emblaAxisToOrientation: Record<'x' | 'y', 'horizontal' | 'vertical'> = { x: 'horizontal', y: 'vertical', }; const carouselContentClasses: Record<'horizontal' | 'vertical', string> = { horizontal: '-ml-4', vertical: '-mt-4 flex-col', }; const carouselItemClasses: Record<'horizontal' | 'vertical', string> = { horizontal: 'pl-4', vertical: 'pt-4', }; const carouselPreviousPositionClasses: Record<'horizontal' | 'vertical', string> = { horizontal: 'top-1/2 -left-12 -translate-y-1/2', vertical: '-top-12 left-1/2 -translate-x-1/2 rotate-90', }; const carouselNextPositionClasses: Record<'horizontal' | 'vertical', string> = { horizontal: 'top-1/2 -right-12 -translate-y-1/2', vertical: '-bottom-12 left-1/2 -translate-x-1/2 rotate-90', }; const CarouselContext = React.createContext(null); function useCarousel() { const context = React.useContext(CarouselContext); if (!context) { throw new Error('useCarousel must be used within a '); } return context; } /** * Smooth horizontal (or vertical) content slider powered by Embla Carousel. * * @description * Built on embla-carousel. Slide sizing is controlled via Tailwind flex-basis * utilities on `` (e.g., `basis-1/3` for 3-up layouts). * * @ai-rules * 1. Always include `` and `` for interactive navigation controls. * 2. NEVER put infinite data tables inside a Carousel — use `` for scrollable lists. * 3. Each slide must be wrapped in ``. */ function Carousel({ orientation = 'horizontal', opts, setApi, plugins, className, children, ...props }: React.ComponentProps<'div'> & CarouselProps) { const [carouselRef, api] = useEmblaCarousel( { ...opts, axis: orientationToEmblaAxis[orientation], }, plugins ); const [canScrollPrev, setCanScrollPrev] = React.useState(false); const [canScrollNext, setCanScrollNext] = React.useState(false); const onSelect = React.useCallback((api: CarouselApi) => { if (!api) return; setCanScrollPrev(api.canScrollPrev()); setCanScrollNext(api.canScrollNext()); }, []); const scrollPrev = React.useCallback(() => { api?.scrollPrev(); }, [api]); const scrollNext = React.useCallback(() => { api?.scrollNext(); }, [api]); const handleKeyDown = React.useCallback( (event: React.KeyboardEvent) => { if (event.key === 'ArrowLeft') { event.preventDefault(); scrollPrev(); } else if (event.key === 'ArrowRight') { event.preventDefault(); scrollNext(); } }, [scrollPrev, scrollNext] ); React.useEffect(() => { if (!api || !setApi) return; setApi(api); }, [api, setApi]); React.useEffect(() => { if (!api) return; onSelect(api); api.on('reInit', onSelect); api.on('select', onSelect); return () => { api?.off('select', onSelect); }; }, [api, onSelect]); return (
{children}
); } function CarouselContent({ className, ...props }: React.ComponentProps<'div'>) { const { carouselRef, orientation = 'horizontal' } = useCarousel(); return (
); } function CarouselItem({ className, ...props }: React.ComponentProps<'div'>) { const { orientation = 'horizontal' } = useCarousel(); return (
); } interface CarouselPreviousProps extends React.ComponentProps { /** Screen-reader label for the previous-slide button. @default "Previous slide" */ previousLabel?: string; } function CarouselPrevious({ className, variant = 'outline', size = 'icon', previousLabel = 'Previous slide', ...props }: CarouselPreviousProps) { const { orientation = 'horizontal', scrollPrev, canScrollPrev } = useCarousel(); return ( ); } interface CarouselNextProps extends React.ComponentProps { /** Screen-reader label for the next-slide button. @default "Next slide" */ nextLabel?: string; } function CarouselNext({ className, variant = 'outline', size = 'icon', nextLabel = 'Next slide', ...props }: CarouselNextProps) { const { orientation = 'horizontal', scrollNext, canScrollNext } = useCarousel(); return ( ); } export { type CarouselApi, Carousel, CarouselContent, CarouselItem, CarouselPrevious, CarouselNext, };