@dododog/ui 0.9.0 → 0.9.1

package/dist/components/Accordion/index.d.mts

@@ -0,0 +1,24 @@
+import * as React from 'react';
+
+interface AccordionItemData {
+    key: string;
+    title: string;
+    content: React.ReactNode;
+}
+interface AccordionProps {
+    items: AccordionItemData[];
+    defaultOpenIndex?: number | null;
+    /** Open multiple items by default (requires `allowMultiple`). Takes precedence over `defaultOpenIndex`. */
+    defaultOpenIndexes?: number[];
+    allowMultiple?: boolean;
+    className?: string;
+}
+declare const Accordion: React.ForwardRefExoticComponent<AccordionProps & React.RefAttributes<HTMLDivElement>>;
+interface AccordionItemProps {
+    title: string;
+    isOpen: boolean;
+    onToggle: () => void;
+    children: React.ReactNode;
+}
+
+export { Accordion, type AccordionItemData, type AccordionItemProps, type AccordionProps };

package/dist/components/Accordion/index.d.ts

@@ -0,0 +1,24 @@
+import * as React from 'react';
+
+interface AccordionItemData {
+    key: string;
+    title: string;
+    content: React.ReactNode;
+}
+interface AccordionProps {
+    items: AccordionItemData[];
+    defaultOpenIndex?: number | null;
+    /** Open multiple items by default (requires `allowMultiple`). Takes precedence over `defaultOpenIndex`. */
+    defaultOpenIndexes?: number[];
+    allowMultiple?: boolean;
+    className?: string;
+}
+declare const Accordion: React.ForwardRefExoticComponent<AccordionProps & React.RefAttributes<HTMLDivElement>>;
+interface AccordionItemProps {
+    title: string;
+    isOpen: boolean;
+    onToggle: () => void;
+    children: React.ReactNode;
+}
+
+export { Accordion, type AccordionItemData, type AccordionItemProps, type AccordionProps };

package/dist/components/Alert/index.d.mts

@@ -0,0 +1,40 @@
+import * as React from 'react';
+
+declare const variantStyles: {
+    warning: {
+        container: string;
+        icon: string;
+        dismiss: string;
+        retry: string;
+    };
+    error: {
+        container: string;
+        icon: string;
+        dismiss: string;
+        retry: string;
+    };
+    success: {
+        container: string;
+        icon: string;
+        dismiss: string;
+        retry: string;
+    };
+    info: {
+        container: string;
+        icon: string;
+        dismiss: string;
+        retry: string;
+    };
+};
+interface AlertProps {
+    message: string;
+    variant?: keyof typeof variantStyles;
+    onDismiss?: () => void;
+    onRetry?: () => void;
+    retryLabel?: string;
+    isRetrying?: boolean;
+    className?: string;
+}
+declare const Alert: React.ForwardRefExoticComponent<AlertProps & React.RefAttributes<HTMLDivElement>>;
+
+export { Alert, type AlertProps };

package/dist/components/Alert/index.d.ts

@@ -0,0 +1,40 @@
+import * as React from 'react';
+
+declare const variantStyles: {
+    warning: {
+        container: string;
+        icon: string;
+        dismiss: string;
+        retry: string;
+    };
+    error: {
+        container: string;
+        icon: string;
+        dismiss: string;
+        retry: string;
+    };
+    success: {
+        container: string;
+        icon: string;
+        dismiss: string;
+        retry: string;
+    };
+    info: {
+        container: string;
+        icon: string;
+        dismiss: string;
+        retry: string;
+    };
+};
+interface AlertProps {
+    message: string;
+    variant?: keyof typeof variantStyles;
+    onDismiss?: () => void;
+    onRetry?: () => void;
+    retryLabel?: string;
+    isRetrying?: boolean;
+    className?: string;
+}
+declare const Alert: React.ForwardRefExoticComponent<AlertProps & React.RefAttributes<HTMLDivElement>>;
+
+export { Alert, type AlertProps };

package/dist/components/AnchorTabs/index.d.mts

@@ -0,0 +1,59 @@
+import * as React from 'react';
+
+interface AnchorTabItem {
+    /**
+     * Identifiant de la section cible : doit correspondre à l'attribut `id` de
+     * l'élément de section dans le DOM (le lien pointe sur `#{key}`).
+     */
+    key: string;
+    /** Libellé affiché de l'onglet. */
+    label: string;
+}
+interface AnchorTabsProps {
+    /** Onglets d'ancrage, dans l'ordre d'apparition des sections. */
+    items: AnchorTabItem[];
+    /** Classes supplémentaires appliquées à la barre `<nav>`. */
+    className?: string;
+    /** Libellé ARIA de la navigation. */
+    ariaLabel?: string;
+    /**
+     * Décalage (px) réservé en haut de page pour le scroll-spy ET le défilement
+     * au clic (barre sticky / header). Défaut : 96.
+     */
+    offsetTop?: number;
+    /** Notifié à chaque changement de section active (scroll ou clic). */
+    onActiveChange?: (key: string) => void;
+    /**
+     * Épingle la barre (position fixed) tant qu'au moins une des sections
+     * ancrées reste dans le viewport — au-delà de la portée d'un simple
+     * `position: sticky` limité au parent. Un espace réservé conserve la
+     * hauteur de la barre (aucun layout shift).
+     */
+    pinWhileSectionsVisible?: boolean;
+    /** Ordonnée (px) de l'épinglage sous le header. Défaut : 72. */
+    pinTop?: number;
+    /** Classes du conteneur/sentinelle (ex. `hidden lg:block`). */
+    containerClassName?: string;
+    /**
+     * Présentation de la barre :
+     * - `underline` (défaut) : rangée d'onglets sur fond blanc, actif souligné ;
+     * - `pills` : chips arrondies posées sur le fond de page (pattern
+     *   FilterPill) — actif rempli `primary`, inactifs en pill blanche bordée.
+     */
+    variant?: "underline" | "pills";
+}
+/**
+ * Barre d'onglets d'ancrage (desktop) avec scroll-spy.
+ *
+ * Présente une rangée de liens `<a href="#{key}">` ; l'onglet dont la section
+ * est actuellement en haut du viewport (au-delà de `offsetTop`) est souligné.
+ * Le composant observe le défilement de la fenêtre (via `requestAnimationFrame`)
+ * pour déterminer la section courante et défile en douceur au clic.
+ *
+ * Les sections cibles doivent porter l'`id` correspondant à chaque `key`. Le
+ * positionnement (sticky, largeur, visibilité responsive) reste à la charge de
+ * l'appelant via `className`.
+ */
+declare const AnchorTabs: React.ForwardRefExoticComponent<AnchorTabsProps & React.RefAttributes<HTMLElement>>;
+
+export { type AnchorTabItem, AnchorTabs, type AnchorTabsProps };

package/dist/components/AnchorTabs/index.d.ts

@@ -0,0 +1,59 @@
+import * as React from 'react';
+
+interface AnchorTabItem {
+    /**
+     * Identifiant de la section cible : doit correspondre à l'attribut `id` de
+     * l'élément de section dans le DOM (le lien pointe sur `#{key}`).
+     */
+    key: string;
+    /** Libellé affiché de l'onglet. */
+    label: string;
+}
+interface AnchorTabsProps {
+    /** Onglets d'ancrage, dans l'ordre d'apparition des sections. */
+    items: AnchorTabItem[];
+    /** Classes supplémentaires appliquées à la barre `<nav>`. */
+    className?: string;
+    /** Libellé ARIA de la navigation. */
+    ariaLabel?: string;
+    /**
+     * Décalage (px) réservé en haut de page pour le scroll-spy ET le défilement
+     * au clic (barre sticky / header). Défaut : 96.
+     */
+    offsetTop?: number;
+    /** Notifié à chaque changement de section active (scroll ou clic). */
+    onActiveChange?: (key: string) => void;
+    /**
+     * Épingle la barre (position fixed) tant qu'au moins une des sections
+     * ancrées reste dans le viewport — au-delà de la portée d'un simple
+     * `position: sticky` limité au parent. Un espace réservé conserve la
+     * hauteur de la barre (aucun layout shift).
+     */
+    pinWhileSectionsVisible?: boolean;
+    /** Ordonnée (px) de l'épinglage sous le header. Défaut : 72. */
+    pinTop?: number;
+    /** Classes du conteneur/sentinelle (ex. `hidden lg:block`). */
+    containerClassName?: string;
+    /**
+     * Présentation de la barre :
+     * - `underline` (défaut) : rangée d'onglets sur fond blanc, actif souligné ;
+     * - `pills` : chips arrondies posées sur le fond de page (pattern
+     *   FilterPill) — actif rempli `primary`, inactifs en pill blanche bordée.
+     */
+    variant?: "underline" | "pills";
+}
+/**
+ * Barre d'onglets d'ancrage (desktop) avec scroll-spy.
+ *
+ * Présente une rangée de liens `<a href="#{key}">` ; l'onglet dont la section
+ * est actuellement en haut du viewport (au-delà de `offsetTop`) est souligné.
+ * Le composant observe le défilement de la fenêtre (via `requestAnimationFrame`)
+ * pour déterminer la section courante et défile en douceur au clic.
+ *
+ * Les sections cibles doivent porter l'`id` correspondant à chaque `key`. Le
+ * positionnement (sticky, largeur, visibilité responsive) reste à la charge de
+ * l'appelant via `className`.
+ */
+declare const AnchorTabs: React.ForwardRefExoticComponent<AnchorTabsProps & React.RefAttributes<HTMLElement>>;
+
+export { type AnchorTabItem, AnchorTabs, type AnchorTabsProps };

package/dist/components/Autocomplete/index.d.mts

@@ -0,0 +1,27 @@
+import * as class_variance_authority_types from 'class-variance-authority/types';
+import * as React from 'react';
+import { VariantProps } from 'class-variance-authority';
+
+declare const autocompleteInputVariants: (props?: ({
+    size?: "sm" | "md" | "lg" | null | undefined;
+    variant?: "default" | "error" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface AutocompleteSuggestion {
+    value: string;
+    label: string;
+}
+interface AutocompleteProps extends VariantProps<typeof autocompleteInputVariants> {
+    value: string;
+    onChange: (value: string) => void;
+    onSelect?: (suggestion: AutocompleteSuggestion) => void;
+    suggestions: AutocompleteSuggestion[];
+    loading?: boolean;
+    placeholder?: string;
+    label?: string;
+    error?: string;
+    renderSuggestion?: (suggestion: AutocompleteSuggestion) => React.ReactNode;
+    className?: string;
+}
+declare const Autocomplete: React.ForwardRefExoticComponent<AutocompleteProps & React.RefAttributes<HTMLDivElement>>;
+
+export { Autocomplete, type AutocompleteProps, type AutocompleteSuggestion, autocompleteInputVariants };

package/dist/components/Autocomplete/index.d.ts

@@ -0,0 +1,27 @@
+import * as class_variance_authority_types from 'class-variance-authority/types';
+import * as React from 'react';
+import { VariantProps } from 'class-variance-authority';
+
+declare const autocompleteInputVariants: (props?: ({
+    size?: "sm" | "md" | "lg" | null | undefined;
+    variant?: "default" | "error" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface AutocompleteSuggestion {
+    value: string;
+    label: string;
+}
+interface AutocompleteProps extends VariantProps<typeof autocompleteInputVariants> {
+    value: string;
+    onChange: (value: string) => void;
+    onSelect?: (suggestion: AutocompleteSuggestion) => void;
+    suggestions: AutocompleteSuggestion[];
+    loading?: boolean;
+    placeholder?: string;
+    label?: string;
+    error?: string;
+    renderSuggestion?: (suggestion: AutocompleteSuggestion) => React.ReactNode;
+    className?: string;
+}
+declare const Autocomplete: React.ForwardRefExoticComponent<AutocompleteProps & React.RefAttributes<HTMLDivElement>>;
+
+export { Autocomplete, type AutocompleteProps, type AutocompleteSuggestion, autocompleteInputVariants };

package/dist/components/Avatar/index.d.mts

@@ -0,0 +1,13 @@
+import * as React from 'react';
+
+interface AvatarProps {
+    src?: string | null;
+    alt?: string;
+    initials?: string;
+    size?: "sm" | "md" | "lg";
+    badge?: number;
+    className?: string;
+}
+declare const Avatar: React.ForwardRefExoticComponent<AvatarProps & React.RefAttributes<HTMLDivElement>>;
+
+export { Avatar, type AvatarProps };

package/dist/components/Avatar/index.d.ts

@@ -0,0 +1,13 @@
+import * as React from 'react';
+
+interface AvatarProps {
+    src?: string | null;
+    alt?: string;
+    initials?: string;
+    size?: "sm" | "md" | "lg";
+    badge?: number;
+    className?: string;
+}
+declare const Avatar: React.ForwardRefExoticComponent<AvatarProps & React.RefAttributes<HTMLDivElement>>;
+
+export { Avatar, type AvatarProps };

package/dist/components/Badge/index.d.mts

@@ -0,0 +1,13 @@
+import * as class_variance_authority_types from 'class-variance-authority/types';
+import * as React from 'react';
+import { VariantProps } from 'class-variance-authority';
+
+declare const badgeVariants: (props?: ({
+    variant?: "secondary" | "accent" | "outline" | "default" | "success" | "warning" | null | undefined;
+    size?: "sm" | "md" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface BadgeProps extends React.HTMLAttributes<HTMLSpanElement>, VariantProps<typeof badgeVariants> {
+}
+declare const Badge: React.ForwardRefExoticComponent<BadgeProps & React.RefAttributes<HTMLSpanElement>>;
+
+export { Badge, type BadgeProps, badgeVariants };

package/dist/components/Badge/index.d.ts

@@ -0,0 +1,13 @@
+import * as class_variance_authority_types from 'class-variance-authority/types';
+import * as React from 'react';
+import { VariantProps } from 'class-variance-authority';
+
+declare const badgeVariants: (props?: ({
+    variant?: "secondary" | "accent" | "outline" | "default" | "success" | "warning" | null | undefined;
+    size?: "sm" | "md" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface BadgeProps extends React.HTMLAttributes<HTMLSpanElement>, VariantProps<typeof badgeVariants> {
+}
+declare const Badge: React.ForwardRefExoticComponent<BadgeProps & React.RefAttributes<HTMLSpanElement>>;
+
+export { Badge, type BadgeProps, badgeVariants };

package/dist/components/Banner/index.d.mts

@@ -0,0 +1,19 @@
+import * as class_variance_authority_types from 'class-variance-authority/types';
+import * as React from 'react';
+import { VariantProps } from 'class-variance-authority';
+
+declare const bannerVariants: (props?: ({
+    variant?: "error" | "success" | "warning" | "info" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface BannerProps extends React.HTMLAttributes<HTMLDivElement>, VariantProps<typeof bannerVariants> {
+    title?: string;
+    icon?: React.ReactNode;
+    onDismiss?: () => void;
+    action?: {
+        label: string;
+        onClick: () => void;
+    };
+}
+declare const Banner: React.ForwardRefExoticComponent<BannerProps & React.RefAttributes<HTMLDivElement>>;
+
+export { Banner, type BannerProps, bannerVariants };

package/dist/components/Banner/index.d.ts

@@ -0,0 +1,19 @@
+import * as class_variance_authority_types from 'class-variance-authority/types';
+import * as React from 'react';
+import { VariantProps } from 'class-variance-authority';
+
+declare const bannerVariants: (props?: ({
+    variant?: "error" | "success" | "warning" | "info" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface BannerProps extends React.HTMLAttributes<HTMLDivElement>, VariantProps<typeof bannerVariants> {
+    title?: string;
+    icon?: React.ReactNode;
+    onDismiss?: () => void;
+    action?: {
+        label: string;
+        onClick: () => void;
+    };
+}
+declare const Banner: React.ForwardRefExoticComponent<BannerProps & React.RefAttributes<HTMLDivElement>>;
+
+export { Banner, type BannerProps, bannerVariants };

package/dist/components/BottomNavBar/index.d.mts

@@ -0,0 +1,17 @@
+import * as React from 'react';
+
+interface BottomNavItem {
+    key: string;
+    label: string;
+    icon: React.ReactNode;
+    href: string;
+    isActive?: boolean;
+}
+interface BottomNavBarProps {
+    items: BottomNavItem[];
+    className?: string;
+    onNavigate?: (href: string) => void;
+}
+declare const BottomNavBar: React.ForwardRefExoticComponent<BottomNavBarProps & React.RefAttributes<HTMLElement>>;
+
+export { BottomNavBar, type BottomNavBarProps, type BottomNavItem };

package/dist/components/BottomNavBar/index.d.ts

@@ -0,0 +1,17 @@
+import * as React from 'react';
+
+interface BottomNavItem {
+    key: string;
+    label: string;
+    icon: React.ReactNode;
+    href: string;
+    isActive?: boolean;
+}
+interface BottomNavBarProps {
+    items: BottomNavItem[];
+    className?: string;
+    onNavigate?: (href: string) => void;
+}
+declare const BottomNavBar: React.ForwardRefExoticComponent<BottomNavBarProps & React.RefAttributes<HTMLElement>>;
+
+export { BottomNavBar, type BottomNavBarProps, type BottomNavItem };

package/dist/components/Breadcrumb/index.d.mts

@@ -0,0 +1,23 @@
+import * as class_variance_authority_types from 'class-variance-authority/types';
+import * as React from 'react';
+import { VariantProps } from 'class-variance-authority';
+
+declare const breadcrumbVariants: (props?: ({
+    variant?: "default" | "light" | "dark" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface BreadcrumbItem {
+    label: string;
+    href: string;
+}
+interface BreadcrumbProps extends React.HTMLAttributes<HTMLElement>, VariantProps<typeof breadcrumbVariants> {
+    items: BreadcrumbItem[];
+    /** Render custom link component (e.g. Next.js Link). Receives href, className, children. */
+    renderLink?: (props: {
+        href: string;
+        className: string;
+        children: React.ReactNode;
+    }) => React.ReactNode;
+}
+declare const Breadcrumb: React.ForwardRefExoticComponent<BreadcrumbProps & React.RefAttributes<HTMLElement>>;
+
+export { Breadcrumb, type BreadcrumbItem, type BreadcrumbProps, breadcrumbVariants };

package/dist/components/Breadcrumb/index.d.ts

@@ -0,0 +1,23 @@
+import * as class_variance_authority_types from 'class-variance-authority/types';
+import * as React from 'react';
+import { VariantProps } from 'class-variance-authority';
+
+declare const breadcrumbVariants: (props?: ({
+    variant?: "default" | "light" | "dark" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface BreadcrumbItem {
+    label: string;
+    href: string;
+}
+interface BreadcrumbProps extends React.HTMLAttributes<HTMLElement>, VariantProps<typeof breadcrumbVariants> {
+    items: BreadcrumbItem[];
+    /** Render custom link component (e.g. Next.js Link). Receives href, className, children. */
+    renderLink?: (props: {
+        href: string;
+        className: string;
+        children: React.ReactNode;
+    }) => React.ReactNode;
+}
+declare const Breadcrumb: React.ForwardRefExoticComponent<BreadcrumbProps & React.RefAttributes<HTMLElement>>;
+
+export { Breadcrumb, type BreadcrumbItem, type BreadcrumbProps, breadcrumbVariants };

package/dist/components/Button/index.d.mts

@@ -0,0 +1,17 @@
+import * as class_variance_authority_types from 'class-variance-authority/types';
+import * as React from 'react';
+import { VariantProps } from 'class-variance-authority';
+
+declare const buttonVariants: (props?: ({
+    variant?: "primary" | "secondary" | "accent" | "outline" | "ghost" | null | undefined;
+    size?: "sm" | "md" | "lg" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface ButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement>, VariantProps<typeof buttonVariants> {
+    asChild?: boolean;
+    isLoading?: boolean;
+    leftIcon?: React.ReactNode;
+    rightIcon?: React.ReactNode;
+}
+declare const Button: React.ForwardRefExoticComponent<ButtonProps & React.RefAttributes<HTMLButtonElement>>;
+
+export { Button, type ButtonProps, buttonVariants };

package/dist/components/Button/index.d.ts

@@ -0,0 +1,17 @@
+import * as class_variance_authority_types from 'class-variance-authority/types';
+import * as React from 'react';
+import { VariantProps } from 'class-variance-authority';
+
+declare const buttonVariants: (props?: ({
+    variant?: "primary" | "secondary" | "accent" | "outline" | "ghost" | null | undefined;
+    size?: "sm" | "md" | "lg" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface ButtonProps extends React.ButtonHTMLAttributes<HTMLButtonElement>, VariantProps<typeof buttonVariants> {
+    asChild?: boolean;
+    isLoading?: boolean;
+    leftIcon?: React.ReactNode;
+    rightIcon?: React.ReactNode;
+}
+declare const Button: React.ForwardRefExoticComponent<ButtonProps & React.RefAttributes<HTMLButtonElement>>;
+
+export { Button, type ButtonProps, buttonVariants };

package/dist/components/Card/index.d.mts

@@ -0,0 +1,30 @@
+import * as class_variance_authority_types from 'class-variance-authority/types';
+import * as React from 'react';
+import { VariantProps } from 'class-variance-authority';
+
+declare const cardVariants: (props?: ({
+    padding?: "sm" | "md" | "lg" | "none" | null | undefined;
+    hover?: boolean | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface CardProps extends React.HTMLAttributes<HTMLDivElement>, VariantProps<typeof cardVariants> {
+}
+declare const Card: React.ForwardRefExoticComponent<CardProps & React.RefAttributes<HTMLDivElement>>;
+declare const cardImageVariants: (props?: ({
+    aspectRatio?: "square" | "video" | "wide" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface CardImageProps extends React.HTMLAttributes<HTMLDivElement>, VariantProps<typeof cardImageVariants> {
+    overlay?: React.ReactNode;
+}
+declare const CardImage: React.ForwardRefExoticComponent<CardImageProps & React.RefAttributes<HTMLDivElement>>;
+interface CardContentProps extends React.HTMLAttributes<HTMLDivElement> {
+}
+declare const CardContent: React.ForwardRefExoticComponent<CardContentProps & React.RefAttributes<HTMLDivElement>>;
+interface CardTitleProps extends React.HTMLAttributes<HTMLHeadingElement> {
+    as?: "h2" | "h3" | "h4";
+}
+declare const CardTitle: React.ForwardRefExoticComponent<CardTitleProps & React.RefAttributes<HTMLHeadingElement>>;
+interface CardDescriptionProps extends React.HTMLAttributes<HTMLParagraphElement> {
+}
+declare const CardDescription: React.ForwardRefExoticComponent<CardDescriptionProps & React.RefAttributes<HTMLParagraphElement>>;
+
+export { Card, CardContent, type CardContentProps, CardDescription, type CardDescriptionProps, CardImage, type CardImageProps, type CardProps, CardTitle, type CardTitleProps, cardImageVariants, cardVariants };

package/dist/components/Card/index.d.ts

@@ -0,0 +1,30 @@
+import * as class_variance_authority_types from 'class-variance-authority/types';
+import * as React from 'react';
+import { VariantProps } from 'class-variance-authority';
+
+declare const cardVariants: (props?: ({
+    padding?: "sm" | "md" | "lg" | "none" | null | undefined;
+    hover?: boolean | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface CardProps extends React.HTMLAttributes<HTMLDivElement>, VariantProps<typeof cardVariants> {
+}
+declare const Card: React.ForwardRefExoticComponent<CardProps & React.RefAttributes<HTMLDivElement>>;
+declare const cardImageVariants: (props?: ({
+    aspectRatio?: "square" | "video" | "wide" | null | undefined;
+} & class_variance_authority_types.ClassProp) | undefined) => string;
+interface CardImageProps extends React.HTMLAttributes<HTMLDivElement>, VariantProps<typeof cardImageVariants> {
+    overlay?: React.ReactNode;
+}
+declare const CardImage: React.ForwardRefExoticComponent<CardImageProps & React.RefAttributes<HTMLDivElement>>;
+interface CardContentProps extends React.HTMLAttributes<HTMLDivElement> {
+}
+declare const CardContent: React.ForwardRefExoticComponent<CardContentProps & React.RefAttributes<HTMLDivElement>>;
+interface CardTitleProps extends React.HTMLAttributes<HTMLHeadingElement> {
+    as?: "h2" | "h3" | "h4";
+}
+declare const CardTitle: React.ForwardRefExoticComponent<CardTitleProps & React.RefAttributes<HTMLHeadingElement>>;
+interface CardDescriptionProps extends React.HTMLAttributes<HTMLParagraphElement> {
+}
+declare const CardDescription: React.ForwardRefExoticComponent<CardDescriptionProps & React.RefAttributes<HTMLParagraphElement>>;
+
+export { Card, CardContent, type CardContentProps, CardDescription, type CardDescriptionProps, CardImage, type CardImageProps, type CardProps, CardTitle, type CardTitleProps, cardImageVariants, cardVariants };

package/dist/components/CardList/index.d.mts

@@ -0,0 +1,30 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import React__default from 'react';
+
+interface CardListProps<T> {
+    items: T[];
+    renderItem: (item: T, index: number) => React__default.ReactNode;
+    keyExtractor: (item: T) => string;
+    /** Number of items per "page" for stagger delay reset (defaults to items.length) */
+    pageSize?: number;
+    /** Stagger delay between each item in ms (default: 50) */
+    staggerDelay?: number;
+    /** Show initial loading skeleton */
+    loading?: boolean;
+    /** Skeleton component displayed during initial loading */
+    loadingSkeleton?: React__default.ReactNode;
+    /** Whether more items can be loaded */
+    hasMore?: boolean;
+    /** Whether more items are currently being loaded */
+    loadingMore?: boolean;
+    /** Ref for the infinite scroll sentinel element */
+    loadMoreRef?: React__default.RefObject<HTMLDivElement>;
+    /** Skeleton displayed while loading more items */
+    loadMoreSkeleton?: React__default.ReactNode;
+    /** Gap class between items (default: "gap-4") */
+    gap?: string;
+    className?: string;
+}
+declare function CardList<T>({ items, renderItem, keyExtractor, pageSize, staggerDelay, loading, loadingSkeleton, hasMore, loadingMore, loadMoreRef, loadMoreSkeleton, gap, className, }: CardListProps<T>): react_jsx_runtime.JSX.Element;
+
+export { CardList, type CardListProps };

package/dist/components/CardList/index.d.ts

@@ -0,0 +1,30 @@
+import * as react_jsx_runtime from 'react/jsx-runtime';
+import React__default from 'react';
+
+interface CardListProps<T> {
+    items: T[];
+    renderItem: (item: T, index: number) => React__default.ReactNode;
+    keyExtractor: (item: T) => string;
+    /** Number of items per "page" for stagger delay reset (defaults to items.length) */
+    pageSize?: number;
+    /** Stagger delay between each item in ms (default: 50) */
+    staggerDelay?: number;
+    /** Show initial loading skeleton */
+    loading?: boolean;
+    /** Skeleton component displayed during initial loading */
+    loadingSkeleton?: React__default.ReactNode;
+    /** Whether more items can be loaded */
+    hasMore?: boolean;
+    /** Whether more items are currently being loaded */
+    loadingMore?: boolean;
+    /** Ref for the infinite scroll sentinel element */
+    loadMoreRef?: React__default.RefObject<HTMLDivElement>;
+    /** Skeleton displayed while loading more items */
+    loadMoreSkeleton?: React__default.ReactNode;
+    /** Gap class between items (default: "gap-4") */
+    gap?: string;
+    className?: string;
+}
+declare function CardList<T>({ items, renderItem, keyExtractor, pageSize, staggerDelay, loading, loadingSkeleton, hasMore, loadingMore, loadMoreRef, loadMoreSkeleton, gap, className, }: CardListProps<T>): react_jsx_runtime.JSX.Element;
+
+export { CardList, type CardListProps };