@minidev.fun/ui 1.0.3 → 1.0.5

package/dist/accordion.d.ts

@@ -0,0 +1,36 @@
+import { Accordion as Accordion_2 } from '@base-ui/react/accordion';
+import { JSX } from 'react/jsx-runtime';
+
+/**
+ * Root container for accordion items. Manages expand/collapse state and keyboard navigation.
+ * Supports single or multiple open items simultaneously.
+ */
+export declare function Accordion({ className, ...props }: Accordion_2.Root.Props): JSX.Element;
+
+/**
+ * Collapsible panel containing the accordion item's content.
+ * Automatically animates height on open/close with slide animation.
+ */
+export declare function AccordionContent({ className, children, ...props }: Accordion_2.Panel.Props): JSX.Element;
+
+export declare type AccordionContentProps = Accordion_2.Panel.Props;
+
+/**
+ * Container for a single accordion item. Groups trigger and content panel.
+ * Each item must have a unique `value` prop.
+ */
+export declare function AccordionItem({ className, ...props }: Accordion_2.Item.Props): JSX.Element;
+
+export declare type AccordionItemProps = Accordion_2.Item.Props;
+
+export declare type AccordionProps = Accordion_2.Root.Props;
+
+/**
+ * Button that toggles the accordion item open/closed.
+ * Automatically includes chevron icons that flip based on open state.
+ */
+export declare function AccordionTrigger({ className, children, ...props }: Accordion_2.Trigger.Props): JSX.Element;
+
+export declare type AccordionTriggerProps = Accordion_2.Trigger.Props;
+
+export { }

package/dist/alert-dialog.d.ts

@@ -0,0 +1,114 @@
+import { AlertDialog as AlertDialog_2 } from '@base-ui/react/alert-dialog';
+import { Button as Button_2 } from '@base-ui/react/button';
+import { ClassProp } from 'class-variance-authority/types';
+import { JSX } from 'react/jsx-runtime';
+import * as React_2 from 'react';
+import { VariantProps } from 'class-variance-authority';
+
+/** Root container for alert dialog. Manages open state and accessibility. */
+export declare function AlertDialog({ ...props }: AlertDialogProps): JSX.Element;
+
+/** Primary action button. Inherits all Button variants. */
+export declare function AlertDialogAction({ className, ...props }: AlertDialogActionProps): JSX.Element;
+
+export declare type AlertDialogActionProps = React_2.ComponentProps<typeof Button>;
+
+/** Cancel button that closes the alert dialog. Defaults to outline variant. */
+export declare function AlertDialogCancel({ className, variant, size, ...props }: AlertDialogCancelProps): JSX.Element;
+
+export declare type AlertDialogCancelProps = AlertDialog_2.Close.Props & Pick<React_2.ComponentProps<typeof Button>, "variant" | "size">;
+
+/**
+ * Alert dialog content with automatic portal and backdrop.
+ * Centered, animated popup with two size variants.
+ */
+export declare function AlertDialogContent({ className, size, ...props }: AlertDialogContentProps): JSX.Element;
+
+export declare type AlertDialogContentProps = AlertDialog_2.Popup.Props & {
+    /** Dialog size variant. @default "default" */
+    size?: "default" | "sm";
+};
+
+/** Alert dialog description text. Supports links with automatic styling. */
+export declare function AlertDialogDescription({ className, ...props }: AlertDialogDescriptionProps): JSX.Element;
+
+export declare type AlertDialogDescriptionProps = React_2.ComponentProps<typeof AlertDialog_2.Description>;
+
+/** Footer section for action and cancel buttons. */
+export declare function AlertDialogFooter({ className, ...props }: AlertDialogFooterProps): JSX.Element;
+
+export declare type AlertDialogFooterProps = React_2.ComponentProps<"div">;
+
+/** Header section for title, description, and optional media icon. */
+export declare function AlertDialogHeader({ className, ...props }: AlertDialogHeaderProps): JSX.Element;
+
+export declare type AlertDialogHeaderProps = React_2.ComponentProps<"div">;
+
+/** Optional visual indicator icon container. Commonly used for warnings or errors. */
+export declare function AlertDialogMedia({ className, ...props }: AlertDialogMediaProps): JSX.Element;
+
+export declare type AlertDialogMediaProps = React_2.ComponentProps<"div">;
+
+/** Semi-transparent backdrop overlay with frosted glass effect. */
+export declare function AlertDialogOverlay({ className, ...props }: AlertDialogOverlayProps): JSX.Element;
+
+export declare type AlertDialogOverlayProps = AlertDialog_2.Backdrop.Props;
+
+/** Portal container for alert dialog content and overlay. */
+export declare function AlertDialogPortal({ ...props }: AlertDialogPortalProps): JSX.Element;
+
+export declare type AlertDialogPortalProps = AlertDialog_2.Portal.Props;
+
+export declare type AlertDialogProps = AlertDialog_2.Root.Props;
+
+/** Alert dialog title. Automatically announced by screen readers. */
+export declare function AlertDialogTitle({ className, ...props }: AlertDialogTitleProps): JSX.Element;
+
+export declare type AlertDialogTitleProps = React_2.ComponentProps<typeof AlertDialog_2.Title>;
+
+/** Button that opens the alert dialog. Use `render` prop to customize. */
+export declare function AlertDialogTrigger({ ...props }: AlertDialogTriggerProps): JSX.Element;
+
+export declare type AlertDialogTriggerProps = AlertDialog_2.Trigger.Props;
+
+/**
+ * Versatile button component with multiple visual variants and sizes.
+ *
+ * Supports icon placement via `data-icon="inline-start"` or `data-icon="inline-end"` attributes
+ * on child elements. Use the `render` prop to compose with other components or change the
+ * underlying element while maintaining button semantics.
+ *
+ * @example
+ * ```tsx
+ * // Basic button
+ * <Button variant="default">Click me</Button>
+ *
+ * // With icon
+ * <Button>
+ *   <PlusIcon data-icon="inline-start" />
+ *   Create
+ * </Button>
+ *
+ * // Icon only
+ * <Button size="icon" aria-label="Settings">
+ *   <SettingsIcon />
+ * </Button>
+ *
+ * // Custom element
+ * <Button render={<a href="/login" />}>Sign in</Button>
+ * ```
+ */
+declare function Button({ className, variant, size, ...props }: ButtonProps): JSX.Element;
+
+/**
+ * Props for the Button component.
+ * Combines Base UI Button props with variant styling options.
+ */
+declare type ButtonProps = Button_2.Props & VariantProps<typeof buttonVariants>;
+
+declare const buttonVariants: (props?: ({
+    variant?: "link" | "default" | "outline" | "success" | "destructive" | "info" | "primary" | "secondary" | "ghost" | "warning" | null | undefined;
+    size?: "default" | "icon" | "sm" | "lg" | "xs" | "icon-xs" | "icon-sm" | "icon-lg" | null | undefined;
+} & ClassProp) | undefined) => string;
+
+export { }

package/dist/alert.d.ts

@@ -0,0 +1,41 @@
+import { ClassProp } from 'class-variance-authority/types';
+import { JSX } from 'react/jsx-runtime';
+import * as React_2 from 'react';
+import { VariantProps } from 'class-variance-authority';
+
+/**
+ * Alert component for displaying contextual messages with optional icons and actions.
+ * Supports multiple semantic variants for different message types.
+ */
+export declare function Alert({ className, variant, ...props }: AlertProps): JSX.Element;
+
+/**
+ * Action area positioned in top-right of alert. Use for dismiss buttons or action CTAs.
+ */
+export declare function AlertAction({ className, ...props }: AlertActionProps): JSX.Element;
+
+export declare type AlertActionProps = React_2.ComponentProps<"div">;
+
+/**
+ * Description content for the alert. Supports inline links and paragraph formatting.
+ * Uses muted foreground color that adapts to variant.
+ */
+export declare function AlertDescription({ className, ...props }: AlertDescriptionProps): JSX.Element;
+
+export declare type AlertDescriptionProps = React_2.ComponentProps<"div">;
+
+export declare type AlertProps = React_2.ComponentProps<"div"> & VariantProps<typeof alertVariants>;
+
+/**
+ * Title heading for the alert. Automatically positions next to icon when present.
+ * Supports inline links with hover styling.
+ */
+export declare function AlertTitle({ className, ...props }: AlertTitleProps): JSX.Element;
+
+export declare type AlertTitleProps = React_2.ComponentProps<"div">;
+
+export declare const alertVariants: (props?: ({
+    variant?: "default" | "success" | "destructive" | "info" | "warning" | null | undefined;
+} & ClassProp) | undefined) => string;
+
+export { }

package/dist/aspect-ratio.d.ts

@@ -0,0 +1,14 @@
+import { JSX } from 'react/jsx-runtime';
+
+/**
+ * Container that maintains a consistent aspect ratio.
+ * Automatically adjusts height based on width to preserve proportions.
+ */
+export declare function AspectRatio({ ratio, className, ...props }: AspectRatioProps): JSX.Element;
+
+export declare type AspectRatioProps = React.ComponentProps<"div"> & {
+    /** Aspect ratio as width/height (e.g., 16/9, 1, 4/3) */
+    ratio: number;
+};
+
+export { }

package/dist/avatar.d.ts

@@ -0,0 +1,55 @@
+import { Avatar as Avatar_2 } from '@base-ui/react/avatar';
+import { JSX } from 'react/jsx-runtime';
+import * as React_2 from 'react';
+
+/**
+ * Avatar root component with size variants.
+ * Displays user profile images with automatic fallback support.
+ */
+export declare function Avatar({ className, size, ...props }: AvatarProps): JSX.Element;
+
+/**
+ * Badge positioned at bottom-right of avatar.
+ * Use for status indicators, verification badges, or notification dots.
+ */
+export declare function AvatarBadge({ className, ...props }: AvatarBadgeProps): JSX.Element;
+
+export declare type AvatarBadgeProps = React_2.ComponentProps<"span">;
+
+/**
+ * Fallback content shown when image is unavailable.
+ * Typically displays user initials or an icon.
+ */
+export declare function AvatarFallback({ className, ...props }: AvatarFallbackProps): JSX.Element;
+
+export declare type AvatarFallbackProps = Avatar_2.Fallback.Props;
+
+/**
+ * Container for stacked avatars with ring borders.
+ * Used to show team members or collaborators.
+ */
+export declare function AvatarGroup({ className, ...props }: AvatarGroupProps): JSX.Element;
+
+/**
+ * Counter badge showing additional hidden avatars in a group.
+ * Typically displays "+N" to indicate overflow count.
+ */
+export declare function AvatarGroupCount({ className, ...props }: AvatarGroupCountProps): JSX.Element;
+
+export declare type AvatarGroupCountProps = React_2.ComponentProps<"div">;
+
+export declare type AvatarGroupProps = React_2.ComponentProps<"div">;
+
+/**
+ * Avatar image element. Automatically shows fallback if image fails to load.
+ */
+export declare function AvatarImage({ className, ...props }: AvatarImageProps): JSX.Element;
+
+export declare type AvatarImageProps = Avatar_2.Image.Props;
+
+export declare type AvatarProps = Avatar_2.Root.Props & {
+    /** Avatar size variant. @default "default" */
+    size?: "default" | "sm" | "lg";
+};
+
+export { }

package/dist/badge.d.ts

@@ -0,0 +1,22 @@
+import { ClassProp } from 'class-variance-authority/types';
+import { JSXElementConstructor } from 'react';
+import { ReactElement } from 'react';
+import { useRender } from '@base-ui/react/use-render';
+import { VariantProps } from 'class-variance-authority';
+
+/**
+ * Badge component for displaying labels, counts, and status indicators.
+ *
+ * Supports multiple visual variants (default, outline, ghost, etc.) and semantic variants
+ * (success, warning, destructive, info). Icons can be added using `data-icon="inline-start"` or
+ * `data-icon="inline-end"` attributes on icon elements.
+ */
+export declare function Badge({ className, variant, render, ...props }: BadgeProps): ReactElement<unknown, string | JSXElementConstructor<any>>;
+
+export declare type BadgeProps = useRender.ComponentProps<"span"> & VariantProps<typeof badgeVariants>;
+
+export declare const badgeVariants: (props?: ({
+    variant?: "link" | "default" | "outline" | "success" | "destructive" | "info" | "secondary" | "ghost" | "warning" | null | undefined;
+} & ClassProp) | undefined) => string;
+
+export { }

package/dist/breadcrumb.d.ts

@@ -0,0 +1,54 @@
+import { JSX } from 'react/jsx-runtime';
+import * as React_2 from 'react';
+import { useRender } from '@base-ui/react/use-render';
+
+/**
+ * Root breadcrumb navigation container with semantic HTML and accessibility attributes.
+ */
+export declare function Breadcrumb({ className, ...props }: BreadcrumbProps): JSX.Element;
+
+/**
+ * Ellipsis indicator for collapsed breadcrumb sections in long paths.
+ */
+export declare function BreadcrumbEllipsis({ className, ...props }: BreadcrumbEllipsisProps): JSX.Element;
+
+export declare type BreadcrumbEllipsisProps = React_2.ComponentProps<"span">;
+
+/**
+ * Individual breadcrumb item wrapper. Contains links, pages, or ellipsis components.
+ */
+export declare function BreadcrumbItem({ className, ...props }: BreadcrumbItemProps): JSX.Element;
+
+export declare type BreadcrumbItemProps = React_2.ComponentProps<"li">;
+
+/**
+ * Interactive breadcrumb link for navigable parent pages. Supports custom rendering with `render` prop.
+ */
+export declare function BreadcrumbLink({ className, render, ...props }: BreadcrumbLinkProps): React_2.ReactElement<unknown, string | React_2.JSXElementConstructor<any>>;
+
+export declare type BreadcrumbLinkProps = useRender.ComponentProps<"a">;
+
+/**
+ * Ordered list container for breadcrumb items. Automatically styled with responsive spacing.
+ */
+export declare function BreadcrumbList({ className, ...props }: BreadcrumbListProps): JSX.Element;
+
+export declare type BreadcrumbListProps = React_2.ComponentProps<"ol">;
+
+/**
+ * Current page indicator (non-interactive). Rendered with higher contrast and accessibility attributes.
+ */
+export declare function BreadcrumbPage({ className, ...props }: BreadcrumbPageProps): JSX.Element;
+
+export declare type BreadcrumbPageProps = React_2.ComponentProps<"span">;
+
+export declare type BreadcrumbProps = React_2.ComponentProps<"nav">;
+
+/**
+ * Visual separator between breadcrumb items. Defaults to ChevronRightIcon but accepts custom children.
+ */
+export declare function BreadcrumbSeparator({ children, className, ...props }: BreadcrumbSeparatorProps): JSX.Element;
+
+export declare type BreadcrumbSeparatorProps = React_2.ComponentProps<"li">;
+
+export { }

package/dist/button-group.d.ts

@@ -0,0 +1,45 @@
+import { ClassProp } from 'class-variance-authority/types';
+import { JSX } from 'react/jsx-runtime';
+import { JSXElementConstructor } from 'react';
+import { ReactElement } from 'react';
+import { Separator as Separator_2 } from '@base-ui/react/separator';
+import { useRender } from '@base-ui/react/use-render';
+import { VariantProps } from 'class-variance-authority';
+
+/**
+ * Groups related buttons together with fused borders and shared styling.
+ * Supports horizontal and vertical orientations.
+ */
+export declare function ButtonGroup({ className, orientation, ...props }: ButtonGroupProps): JSX.Element;
+
+export declare type ButtonGroupProps = React.ComponentProps<"div"> & VariantProps<typeof buttonGroupVariants>;
+
+/**
+ * Visual separator between button groups or sections within a group.
+ * Automatically orients based on parent ButtonGroup orientation.
+ */
+export declare function ButtonGroupSeparator({ className, orientation, ...props }: ButtonGroupSeparatorProps): JSX.Element;
+
+export declare type ButtonGroupSeparatorProps = React.ComponentProps<typeof Separator>;
+
+/**
+ * Text or status display element within a button group.
+ * Use `render` prop to customize the underlying element.
+ */
+export declare function ButtonGroupText({ className, render, ...props }: ButtonGroupTextProps): ReactElement<unknown, string | JSXElementConstructor<any>>;
+
+export declare type ButtonGroupTextProps = useRender.ComponentProps<"div">;
+
+export declare const buttonGroupVariants: (props?: ({
+    orientation?: "horizontal" | "vertical" | null | undefined;
+} & ClassProp) | undefined) => string;
+
+/**
+ * Visual divider for separating content sections.
+ * Supports both horizontal (default) and vertical orientations.
+ */
+declare function Separator({ className, orientation, ...props }: SeparatorProps): JSX.Element;
+
+declare type SeparatorProps = Separator_2.Props;
+
+export { }

package/dist/button.d.ts

@@ -0,0 +1,46 @@
+import { Button as Button_2 } from '@base-ui/react/button';
+import { ClassProp } from 'class-variance-authority/types';
+import { JSX } from 'react/jsx-runtime';
+import { VariantProps } from 'class-variance-authority';
+
+/**
+ * Versatile button component with multiple visual variants and sizes.
+ *
+ * Supports icon placement via `data-icon="inline-start"` or `data-icon="inline-end"` attributes
+ * on child elements. Use the `render` prop to compose with other components or change the
+ * underlying element while maintaining button semantics.
+ *
+ * @example
+ * ```tsx
+ * // Basic button
+ * <Button variant="default">Click me</Button>
+ *
+ * // With icon
+ * <Button>
+ *   <PlusIcon data-icon="inline-start" />
+ *   Create
+ * </Button>
+ *
+ * // Icon only
+ * <Button size="icon" aria-label="Settings">
+ *   <SettingsIcon />
+ * </Button>
+ *
+ * // Custom element
+ * <Button render={<a href="/login" />}>Sign in</Button>
+ * ```
+ */
+export declare function Button({ className, variant, size, ...props }: ButtonProps): JSX.Element;
+
+/**
+ * Props for the Button component.
+ * Combines Base UI Button props with variant styling options.
+ */
+export declare type ButtonProps = Button_2.Props & VariantProps<typeof buttonVariants>;
+
+export declare const buttonVariants: (props?: ({
+    variant?: "link" | "default" | "outline" | "success" | "destructive" | "info" | "primary" | "secondary" | "ghost" | "warning" | null | undefined;
+    size?: "default" | "icon" | "sm" | "lg" | "xs" | "icon-xs" | "icon-sm" | "icon-lg" | null | undefined;
+} & ClassProp) | undefined) => string;
+
+export { }

package/dist/calendar.d.ts

@@ -0,0 +1,68 @@
+import { Button as Button_2 } from '@base-ui/react/button';
+import { ClassProp } from 'class-variance-authority/types';
+import { DayButton } from 'react-day-picker';
+import { DayPicker } from 'react-day-picker';
+import { JSX } from 'react/jsx-runtime';
+import * as React_2 from 'react';
+import { VariantProps } from 'class-variance-authority';
+
+/**
+ * Versatile button component with multiple visual variants and sizes.
+ *
+ * Supports icon placement via `data-icon="inline-start"` or `data-icon="inline-end"` attributes
+ * on child elements. Use the `render` prop to compose with other components or change the
+ * underlying element while maintaining button semantics.
+ *
+ * @example
+ * ```tsx
+ * // Basic button
+ * <Button variant="default">Click me</Button>
+ *
+ * // With icon
+ * <Button>
+ *   <PlusIcon data-icon="inline-start" />
+ *   Create
+ * </Button>
+ *
+ * // Icon only
+ * <Button size="icon" aria-label="Settings">
+ *   <SettingsIcon />
+ * </Button>
+ *
+ * // Custom element
+ * <Button render={<a href="/login" />}>Sign in</Button>
+ * ```
+ */
+declare function Button({ className, variant, size, ...props }: ButtonProps): JSX.Element;
+
+/**
+ * Props for the Button component.
+ * Combines Base UI Button props with variant styling options.
+ */
+declare type ButtonProps = Button_2.Props & VariantProps<typeof buttonVariants>;
+
+declare const buttonVariants: (props?: ({
+    variant?: "link" | "default" | "outline" | "success" | "destructive" | "info" | "primary" | "secondary" | "ghost" | "warning" | null | undefined;
+    size?: "default" | "icon" | "sm" | "lg" | "xs" | "icon-xs" | "icon-sm" | "icon-lg" | null | undefined;
+} & ClassProp) | undefined) => string;
+
+/**
+ * Calendar component for date selection with single, range, or multiple modes.
+ * Built on react-day-picker with customizable appearance and navigation.
+ */
+export declare function Calendar({ className, classNames, showOutsideDays, captionLayout, buttonVariant, formatters, components, ...props }: CalendarProps): JSX.Element;
+
+/**
+ * Internal day button component with range and selection state styling.
+ * Handles focus management and applies appropriate styles for single, range, and multiple selection modes.
+ */
+export declare function CalendarDayButton({ className, day, modifiers, ...props }: CalendarDayButtonProps): JSX.Element;
+
+export declare type CalendarDayButtonProps = React_2.ComponentProps<typeof DayButton>;
+
+export declare type CalendarProps = React_2.ComponentProps<typeof DayPicker> & {
+    /** Visual style variant for navigation buttons. @default "ghost" */
+    buttonVariant?: React_2.ComponentProps<typeof Button>["variant"];
+};
+
+export { }

package/dist/card.d.ts

@@ -0,0 +1,45 @@
+import { JSX } from 'react/jsx-runtime';
+import * as React_2 from 'react';
+
+/**
+ * Card container with shadow, border, and rounded corners.
+ * Use compound components (CardHeader, CardContent, etc.) to compose card layouts.
+ */
+export declare function Card({ className, size, ...props }: CardProps): JSX.Element;
+
+/** Action button or control positioned in top-right corner of CardHeader. */
+export declare function CardAction({ className, ...props }: CardActionProps): JSX.Element;
+
+export declare type CardActionProps = React_2.ComponentProps<"div">;
+
+/** Main content area of the card. */
+export declare function CardContent({ className, ...props }: CardContentProps): JSX.Element;
+
+export declare type CardContentProps = React_2.ComponentProps<"div">;
+
+/** Card description providing secondary context below the title. */
+export declare function CardDescription({ className, ...props }: CardDescriptionProps): JSX.Element;
+
+export declare type CardDescriptionProps = React_2.ComponentProps<"div">;
+
+/** Card footer for actions or metadata. Add `border-t` class for visual separation. */
+export declare function CardFooter({ className, ...props }: CardFooterProps): JSX.Element;
+
+export declare type CardFooterProps = React_2.ComponentProps<"div">;
+
+/** Card header with grid layout supporting title, description, and optional action button. */
+export declare function CardHeader({ className, ...props }: CardHeaderProps): JSX.Element;
+
+export declare type CardHeaderProps = React_2.ComponentProps<"div">;
+
+export declare type CardProps = React_2.ComponentProps<"div"> & {
+    /** Card size affecting padding and spacing. @default "default" */
+    size?: "default" | "sm";
+};
+
+/** Card title, typically a heading or name. */
+export declare function CardTitle({ className, ...props }: CardTitleProps): JSX.Element;
+
+export declare type CardTitleProps = React_2.ComponentProps<"div">;
+
+export { }

package/dist/carousel.d.ts

@@ -0,0 +1,116 @@
+import { Button as Button_2 } from '@base-ui/react/button';
+import { ClassProp } from 'class-variance-authority/types';
+import { default as default_2 } from 'embla-carousel-react';
+import { JSX } from 'react/jsx-runtime';
+import * as React_2 from 'react';
+import { UseEmblaCarouselType } from 'embla-carousel-react';
+import { VariantProps } from 'class-variance-authority';
+
+/**
+ * Versatile button component with multiple visual variants and sizes.
+ *
+ * Supports icon placement via `data-icon="inline-start"` or `data-icon="inline-end"` attributes
+ * on child elements. Use the `render` prop to compose with other components or change the
+ * underlying element while maintaining button semantics.
+ *
+ * @example
+ * ```tsx
+ * // Basic button
+ * <Button variant="default">Click me</Button>
+ *
+ * // With icon
+ * <Button>
+ *   <PlusIcon data-icon="inline-start" />
+ *   Create
+ * </Button>
+ *
+ * // Icon only
+ * <Button size="icon" aria-label="Settings">
+ *   <SettingsIcon />
+ * </Button>
+ *
+ * // Custom element
+ * <Button render={<a href="/login" />}>Sign in</Button>
+ * ```
+ */
+declare function Button({ className, variant, size, ...props }: ButtonProps): JSX.Element;
+
+/**
+ * Props for the Button component.
+ * Combines Base UI Button props with variant styling options.
+ */
+declare type ButtonProps = Button_2.Props & VariantProps<typeof buttonVariants>;
+
+declare const buttonVariants: (props?: ({
+    variant?: "link" | "default" | "outline" | "success" | "destructive" | "info" | "primary" | "secondary" | "ghost" | "warning" | null | undefined;
+    size?: "default" | "icon" | "sm" | "lg" | "xs" | "icon-xs" | "icon-sm" | "icon-lg" | null | undefined;
+} & ClassProp) | undefined) => string;
+
+/**
+ * Carousel root component. Provides context and manages scroll state.
+ * Supports both horizontal and vertical orientations with keyboard navigation.
+ */
+export declare function Carousel({ orientation, opts, setApi, plugins, className, children, ...props }: CarouselProps): JSX.Element;
+
+export declare type CarouselApi = UseEmblaCarouselType[1];
+
+/**
+ * Container for carousel items. Handles overflow and flex layout.
+ */
+export declare function CarouselContent({ className, ...props }: CarouselContentProps): JSX.Element;
+
+export declare type CarouselContentProps = React_2.ComponentProps<"div">;
+
+declare type CarouselContextProps = {
+    carouselRef: ReturnType<typeof default_2>[0];
+    api: ReturnType<typeof default_2>[1];
+    scrollPrev: () => void;
+    scrollNext: () => void;
+    canScrollPrev: boolean;
+    canScrollNext: boolean;
+} & CarouselProps;
+
+/**
+ * Individual carousel slide. Use `basis-*` classes to control items per view.
+ */
+export declare function CarouselItem({ className, ...props }: CarouselItemProps): JSX.Element;
+
+export declare type CarouselItemProps = React_2.ComponentProps<"div">;
+
+/**
+ * Button to navigate to next slide. Automatically disabled when at end (unless loop is enabled).
+ */
+export declare function CarouselNext({ className, variant, size, ...props }: CarouselNextProps): JSX.Element;
+
+export declare type CarouselNextProps = React_2.ComponentProps<typeof Button>;
+
+declare type CarouselOptions = UseCarouselParameters[0];
+
+declare type CarouselPlugin = UseCarouselParameters[1];
+
+/**
+ * Button to navigate to previous slide. Automatically disabled when at start (unless loop is enabled).
+ */
+export declare function CarouselPrevious({ className, variant, size, ...props }: CarouselPreviousProps): JSX.Element;
+
+export declare type CarouselPreviousProps = React_2.ComponentProps<typeof Button>;
+
+export declare type CarouselProps = React_2.ComponentProps<"div"> & {
+    /** Embla carousel options (loop, align, slidesToScroll, etc.) */
+    opts?: CarouselOptions;
+    /** Embla carousel plugins */
+    plugins?: CarouselPlugin;
+    /** Carousel scroll direction. @default "horizontal" */
+    orientation?: "horizontal" | "vertical";
+    /** Callback to receive the carousel API instance for programmatic control */
+    setApi?: (api: CarouselApi) => void;
+};
+
+/**
+ * Hook to access carousel context. Must be used within a Carousel component.
+ */
+export declare function useCarousel(): CarouselContextProps;
+
+declare type UseCarouselParameters = Parameters<typeof default_2>;
+
+export { }