@tenerife.music/ui 1.0.3 → 1.0.6

package/dist/animation/tas.d.ts

@@ -1,5 +1,4 @@
-import { Duration, durations, Easing, easings, reducedMotion, Spring, springs, Transition, transitions } from '../tokens/motion';
-import { SpringConfig } from './types';
+import { Duration, durations, Easing, easings, reducedMotion, Transition, transitions } from '../tokens/motion';
 /**
  * Check if user prefers reduced motion
  * Checks both system preference and global override
@@ -10,71 +9,16 @@ export declare function shouldReduceMotion(override?: boolean | "auto"): boolean
  * Returns transition string using motion tokens
  */
 export declare function createTransition(transitionName?: Transition, customDuration?: Duration | string, customEasing?: Easing | string, reduceMotionOverride?: boolean | "auto"): string;
-/**
- * Create spring configuration for Framer Motion
- * Returns spring config object using motion tokens
- */
-export declare function createSpring(springName?: Spring, customConfig?: Partial<SpringConfig>, reduceMotionOverride?: boolean | "auto"): SpringConfig;
-/**
- * Get animation configuration with reduced motion support
- * Returns config object that respects user preferences
- */
-export declare function getAnimationConfig(config?: {
-    duration?: Duration | string | number;
-    easing?: Easing | string;
-    delay?: number;
-    spring?: Spring | Partial<SpringConfig>;
-    reduceMotion?: boolean | "auto";
-}): {
-    duration?: number | string;
-    ease?: string | number[];
-    delay?: number;
-    type?: "tween" | "spring";
-    [key: string]: unknown;
-};
-/**
- * Convert CSS transition to Framer Motion transition
- */
-export declare function cssTransitionToMotionTransition(cssTransition: string, reduceMotionOverride?: boolean | "auto"): {
-    duration?: number;
-    ease?: string | number[];
-    type?: "tween";
-};
-/**
- * Get keyframe animation configuration
- * Converts keyframe tokens to Framer Motion keyframes
- */
-export declare function getKeyframeConfig(_keyframeName: string, reduceMotionOverride?: boolean | "auto"): object | undefined;
 /**
  * Check if animations should be enabled
  * Global check for animation enablement
  */
 export declare function shouldEnableAnimations(globalEnable?: boolean, reduceMotionOverride?: boolean | "auto"): boolean;
-/**
- * Create reveal animation configuration
- * For scroll-triggered animations using Intersection Observer
- */
-export declare function createRevealConfig(options?: {
-    threshold?: number;
-    rootMargin?: string;
-    triggerOnce?: boolean;
-    reduceMotion?: boolean | "auto";
-}): {
-    initial: object;
-    animate: object;
-    transition: object;
-    viewport?: {
-        once?: boolean;
-        margin?: string;
-        amount?: number;
-    };
-};
 /**
  * Export motion tokens for direct access
  */
-export { durations, easings, reducedMotion, springs, transitions };
+export { durations, easings, reducedMotion, transitions };
 /**
  * Export types
  */
 export type { Duration, Easing, Transition };
-//# sourceMappingURL=tas.d.ts.map

package/dist/animation/types.d.ts

@@ -5,52 +5,14 @@ import { Spring as SpringToken } from '../tokens/motion';
 export type Spring = SpringToken;
 /**
  * Animation props for layout primitives
+ * Returns CSS class names for Motion Tokens V2 animations
  */
 export interface AnimationProps {
     /**
-     * Initial animation state (Framer Motion)
+     * CSS class name for the animation
+     * Maps to tm-motion-* utility classes
      */
-    initial?: string | object | false;
-    /**
-     * Animate to this state (Framer Motion)
-     */
-    animate?: string | object | false;
-    /**
-     * Exit animation state (Framer Motion)
-     */
-    exit?: string | object | false;
-    /**
-     * Transition configuration
-     */
-    transition?: string | object | Spring;
-    /**
-     * Animation on hover
-     */
-    whileHover?: object;
-    /**
-     * Animation on focus
-     */
-    whileFocus?: object;
-    /**
-     * Animation on tap
-     */
-    whileTap?: object;
-    /**
-     * Animation on drag
-     */
-    whileDrag?: object;
-    /**
-     * Animation on in view (Intersection Observer)
-     */
-    whileInView?: object;
-    /**
-     * Viewport options for whileInView
-     */
-    viewport?: {
-        once?: boolean;
-        margin?: string;
-        amount?: number;
-    };
+    className?: string;
 }
 /**
  * Transition configuration
@@ -90,17 +52,16 @@ export interface PresetConfig {
 export interface ComponentAnimationConfig {
     /**
      * Animation preset for initial mount/entrance
-     * Can be a preset name string or AnimationProps object
+     * Can be a preset name string or CSS class name
      */
-    animation?: "fadeIn" | "fadeInUp" | "fadeInDown" | "fadeInLeft" | "fadeInRight" | "slideInUp" | "slideInDown" | "slideInLeft" | "slideInRight" | "scaleIn" | AnimationProps;
+    animation?: "fadeIn" | "fadeInUp" | "fadeInDown" | "fadeInLeft" | "fadeInRight" | "slideInUp" | "slideInDown" | "slideInLeft" | "slideInRight" | "scaleIn" | string;
     /**
      * Animation preset for hover state
-     * Can be a preset name string or AnimationProps object
+     * Can be a preset name string or CSS class name
      */
-    hoverAnimation?: "hoverLift" | "hoverScale" | "tapScale" | AnimationProps;
+    hoverAnimation?: "hoverLift" | "hoverScale" | "tapScale" | string;
     /**
-     * Custom animation props (overrides preset names)
+     * Custom animation class name (overrides preset names)
      */
     animationProps?: AnimationProps;
 }
-//# sourceMappingURL=types.d.ts.map

package/dist/animation/useInView.d.ts

@@ -0,0 +1,36 @@
+/**
+ * useInView Hook
+ *
+ * Native Intersection Observer hook for scroll-triggered animations.
+ * SSR-safe implementation that works without framer-motion.
+ */
+export interface UseInViewOptions {
+    /**
+     * Trigger animation only once
+     */
+    once?: boolean;
+    /**
+     * Root margin for Intersection Observer
+     * e.g., "-100px" or "0px 0px -100px 0px"
+     */
+    margin?: string;
+    /**
+     * Threshold for intersection (0-1)
+     */
+    threshold?: number;
+}
+export interface UseInViewReturn {
+    /**
+     * Ref to attach to the element to observe
+     */
+    ref: React.RefObject<HTMLElement | null>;
+    /**
+     * Whether the element is currently in view
+     */
+    isInView: boolean;
+}
+/**
+ * Hook to detect when an element enters the viewport
+ * Uses native Intersection Observer API
+ */
+export declare function useInView(options?: UseInViewOptions): UseInViewReturn;

package/dist/animation/utils.d.ts

@@ -4,4 +4,3 @@ import { AnimationProps, ComponentAnimationConfig } from './types';
  * Merges animation, hoverAnimation, and custom animationProps
  */
 export declare function resolveComponentAnimations(config?: ComponentAnimationConfig): AnimationProps;
-//# sourceMappingURL=utils.d.ts.map

package/dist/components/SectionBuilder.d.ts

@@ -34,4 +34,3 @@ import * as React from "react";
  */
 export declare const SectionBuilder: React.ForwardRefExoticComponent<SectionBuilderProps & React.RefAttributes<HTMLElement>>;
 export type { SectionBuilderConfig, SectionBuilderProps } from './SectionBuilder.types';
-//# sourceMappingURL=SectionBuilder.d.ts.map

package/dist/components/SectionBuilder.presets.d.ts

@@ -226,4 +226,3 @@ export interface TestimonialPresetProps {
  * ```
  */
 export declare function createTestimonialConfig(props: TestimonialPresetProps): SectionBuilderConfig;
-//# sourceMappingURL=SectionBuilder.presets.d.ts.map

package/dist/components/SectionBuilder.types.d.ts

@@ -324,4 +324,3 @@ export interface SectionBuilderProps extends Omit<SectionBuilderConfig, "as" | "
      */
     animation?: ComponentAnimationConfig;
 }
-//# sourceMappingURL=SectionBuilder.types.d.ts.map

package/dist/components/admin/Dashboard.d.ts

@@ -6,4 +6,3 @@ interface DashboardProps {
 }
 export declare const Dashboard: React.FC<DashboardProps>;
 export {};
-//# sourceMappingURL=Dashboard.d.ts.map

package/dist/components/admin/UserManagement.d.ts

@@ -6,4 +6,3 @@ interface UserManagementProps {
 }
 export declare const UserManagement: React.FC<UserManagementProps>;
 export {};
-//# sourceMappingURL=UserManagement.d.ts.map

package/dist/components/auth/LoginForm.d.ts

@@ -9,4 +9,3 @@ interface LoginFormProps {
 }
 export declare const LoginForm: React.FC<LoginFormProps>;
 export {};
-//# sourceMappingURL=LoginForm.d.ts.map

package/dist/components/auth/ProfileCard.d.ts

@@ -7,4 +7,3 @@ interface ProfileCardProps {
 }
 export declare const ProfileCard: React.FC<ProfileCardProps>;
 export {};
-//# sourceMappingURL=ProfileCard.d.ts.map

package/dist/components/auth/RegisterForm.d.ts

@@ -11,4 +11,3 @@ interface RegisterFormProps {
 }
 export declare const RegisterForm: React.FC<RegisterFormProps>;
 export {};
-//# sourceMappingURL=RegisterForm.d.ts.map

package/dist/components/cards/ArtistCard/ArtistCard.d.ts

@@ -0,0 +1,22 @@
+import { ArtistCardProps } from './ArtistCard.types';
+import * as React from "react";
+/**
+ * ArtistCard Component
+ *
+ * Domain-specific card component for displaying artist information.
+ * Uses CardBase for layout and DOMAIN_TOKENS for all styling.
+ * Supports size variants (default, compact) and style variants (default, featured).
+ *
+ * @example
+ * ```tsx
+ * <ArtistCard
+ *   name="Artist Name"
+ *   genres="Jazz, Blues"
+ *   followers={1200}
+ *   plays={50000}
+ *   followersLabel="followers"
+ *   playsLabel="plays"
+ * />
+ * ```
+ */
+export declare const ArtistCard: React.ForwardRefExoticComponent<ArtistCardProps & React.RefAttributes<HTMLDivElement>>;

package/dist/components/cards/ArtistCard/ArtistCard.types.d.ts

@@ -0,0 +1,46 @@
+import { ComponentAnimationConfig } from '../../../animation/types';
+import * as React from "react";
+/**
+ * ArtistCard Size Variant
+ */
+export type ArtistCardSize = "default" | "compact";
+/**
+ * ArtistCard Style Variant
+ */
+export type ArtistCardVariant = "default" | "featured";
+/**
+ * Props for ArtistCard component.
+ * All props are flat and domain-agnostic. Consumer should provide pre-localized strings.
+ */
+export interface ArtistCardProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** Artist name (pre-localized string, required) */
+    name: string;
+    /** Artist description (pre-localized string, optional) */
+    description?: string;
+    /** Genres as comma-separated string (e.g., "Jazz, Blues, Rock", optional) */
+    genres?: string;
+    /** Follower count for popularity metric (optional) */
+    followers?: number;
+    /** Plays/listens count for popularity metric (optional) */
+    plays?: number;
+    /** Image URL (optional) */
+    imageUrl?: string;
+    /** Link URL for artist details page (optional) */
+    href?: string;
+    /** Whether this is a featured artist */
+    featured?: boolean;
+    /** Show image section */
+    showImage?: boolean;
+    /** Badge text for featured artists (optional) */
+    popularBadgeText?: string;
+    /** Label for followers count (required) */
+    followersLabel: string;
+    /** Label for plays count (required) */
+    playsLabel: string;
+    /** Size variant - controls padding and gap */
+    size?: ArtistCardSize;
+    /** Style variant - controls visual appearance */
+    variant?: ArtistCardVariant;
+    /** Animation configuration for entrance and hover animations */
+    animation?: ComponentAnimationConfig;
+}

package/dist/components/cards/ArtistCard/ArtistCard.variants.d.ts

@@ -0,0 +1,83 @@
+/**
+ * ArtistCard Variants
+ *
+ * CVA-based variant system for ArtistCard component.
+ * Supports size variants (default, compact) and style variants (default, featured).
+ * All styling uses token-based values from DOMAIN_TOKENS, TEXT_TOKENS, ICON_TOKENS, and MOTION_TOKENS.
+ */
+/**
+ * ArtistCard root wrapper variant
+ * Base wrapper for the card component
+ */
+export declare const artistCardVariants: (props?: ({
+    size?: "default" | "compact" | null | undefined;
+    variant?: "default" | "featured" | null | undefined;
+} & import('class-variance-authority/types').ClassProp) | undefined) => string;
+/**
+ * Badge positioning variant
+ * Uses absolute positioning for featured badge overlay
+ */
+export declare const artistCardBadgeVariants: (props?: ({
+    size?: "default" | "compact" | null | undefined;
+} & import('class-variance-authority/types').ClassProp) | undefined) => string;
+/**
+ * Badge surface variant
+ * Uses DOMAIN_TOKENS.badges for styling
+ */
+export declare const artistCardBadgeSurfaceVariants: (props?: ({
+    size?: "default" | "compact" | null | undefined;
+    variant?: "default" | "featured" | null | undefined;
+} & import('class-variance-authority/types').ClassProp) | undefined) => string;
+/**
+ * ArtistCard Image Overlay Variants
+ *
+ * CVA-based variant system for image overlay on hover.
+ * Uses DOMAIN_TOKENS.image.overlay and MOTION_TOKENS.
+ */
+export declare const artistCardImageOverlayVariants: (props?: ({
+    size?: "default" | "compact" | null | undefined;
+} & import('class-variance-authority/types').ClassProp) | undefined) => string;
+/**
+ * ArtistCard Image Transform Variants
+ *
+ * CVA-based variant system for image scale on hover.
+ * Uses DOMAIN_TOKENS.motion.hover and MOTION_TOKENS.
+ */
+export declare const artistCardImageTransformVariants: (props?: ({
+    size?: "default" | "compact" | null | undefined;
+} & import('class-variance-authority/types').ClassProp) | undefined) => string;
+/**
+ * Metadata container variant
+ * Uses DOMAIN_TOKENS.metadata for spacing
+ */
+export declare const artistCardMetadataVariants: (props?: ({
+    size?: "default" | "compact" | null | undefined;
+} & import('class-variance-authority/types').ClassProp) | undefined) => string;
+/**
+ * Metadata item variant
+ * Uses DOMAIN_TOKENS.metadata for icon and text styling
+ */
+export declare const artistCardMetadataItemVariants: (props?: ({
+    size?: "default" | "compact" | null | undefined;
+} & import('class-variance-authority/types').ClassProp) | undefined) => string;
+/**
+ * Metadata icon variant
+ * Uses ICON_TOKENS for sizing and colors
+ */
+export declare const artistCardMetadataIconVariants: (props?: ({
+    size?: "default" | "compact" | null | undefined;
+} & import('class-variance-authority/types').ClassProp) | undefined) => string;
+/**
+ * Genres display variant
+ * Uses DOMAIN_TOKENS.metadata for text styling
+ */
+export declare const artistCardGenresVariants: (props?: ({
+    size?: "default" | "compact" | null | undefined;
+} & import('class-variance-authority/types').ClassProp) | undefined) => string;
+/**
+ * Footer border variant
+ * Uses DOMAIN_TOKENS for border and spacing
+ */
+export declare const artistCardFooterBorderVariants: (props?: ({
+    size?: "default" | "compact" | null | undefined;
+} & import('class-variance-authority/types').ClassProp) | undefined) => string;

package/dist/components/cards/ArtistCard/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * ArtistCard Component Exports
+ *
+ * Barrel exports for ArtistCard component and related types/variants.
+ */
+export { ArtistCard } from './ArtistCard';
+export type { ArtistCardProps, ArtistCardSize, ArtistCardVariant } from './ArtistCard.types';
+export { artistCardBadgeSurfaceVariants, artistCardBadgeVariants, artistCardFooterBorderVariants, artistCardGenresVariants, artistCardImageOverlayVariants, artistCardImageTransformVariants, artistCardMetadataIconVariants, artistCardMetadataItemVariants, artistCardMetadataVariants, artistCardVariants, } from './ArtistCard.variants';

package/dist/components/cards/CardBase/CardBase.d.ts

@@ -0,0 +1,45 @@
+import { CardBaseContentWrapperProps, CardBaseFooterWrapperProps, CardBaseImageWrapperProps, CardBaseProps } from './CardBase.types';
+/**
+ * CardBase Component
+ *
+ * Reusable card layout component with CVA architecture.
+ * Provides pure layout wrappers (ImageWrapper, ContentWrapper, FooterWrapper)
+ * with no domain logic. All styling uses token-based values.
+ *
+ * Architecture:
+ * <CardBase>
+ *   <ImageWrapper />
+ *   <ContentWrapper />
+ *   <FooterWrapper />
+ * </CardBase>
+ */
+import * as React from "react";
+/**
+ * CardBase Root Component
+ *
+ * Main container for card layout. Uses CVA variants for size and style.
+ * All styling comes from DOMAIN_TOKENS, MOTION_TOKENS.
+ */
+declare const CardBase: React.ForwardRefExoticComponent<CardBaseProps & React.RefAttributes<HTMLDivElement>>;
+/**
+ * CardBase ImageWrapper Component
+ *
+ * Layout wrapper for card images. Uses DOMAIN_TOKENS.image for styling.
+ * Provides aspect ratio, border radius, and overflow handling.
+ */
+declare const CardBaseImageWrapper: React.ForwardRefExoticComponent<CardBaseImageWrapperProps & React.RefAttributes<HTMLDivElement>>;
+/**
+ * CardBase ContentWrapper Component
+ *
+ * Layout wrapper for card content. Uses flex column layout.
+ * Spacing is controlled by parent CardBase size variant.
+ */
+declare const CardBaseContentWrapper: React.ForwardRefExoticComponent<CardBaseContentWrapperProps & React.RefAttributes<HTMLDivElement>>;
+/**
+ * CardBase FooterWrapper Component
+ *
+ * Layout wrapper for card footer. Uses flex layout.
+ * Spacing is controlled by parent CardBase size variant.
+ */
+declare const CardBaseFooterWrapper: React.ForwardRefExoticComponent<CardBaseFooterWrapperProps & React.RefAttributes<HTMLDivElement>>;
+export { CardBase, CardBaseContentWrapper, CardBaseFooterWrapper, CardBaseImageWrapper };

package/dist/components/cards/CardBase/CardBase.types.d.ts

@@ -0,0 +1,70 @@
+import * as React from "react";
+/**
+ * CardBase Size Variant
+ */
+export type CardBaseSize = "default" | "compact";
+/**
+ * CardBase Style Variant
+ */
+export type CardBaseVariant = "default" | "featured";
+/**
+ * CardBase Root Component Props
+ */
+export interface CardBaseProps extends React.HTMLAttributes<HTMLDivElement> {
+    /**
+     * Size variant - controls padding and gap
+     * @default "default"
+     */
+    size?: CardBaseSize;
+    /**
+     * Style variant - controls visual appearance
+     * @default "default"
+     */
+    variant?: CardBaseVariant;
+    /**
+     * Additional CSS classes
+     */
+    className?: string;
+}
+/**
+ * CardBase ImageWrapper Props
+ */
+export interface CardBaseImageWrapperProps extends React.HTMLAttributes<HTMLDivElement> {
+    /**
+     * Size variant - inherited from parent CardBase
+     * @default "default"
+     */
+    size?: CardBaseSize;
+    /**
+     * Additional CSS classes
+     */
+    className?: string;
+}
+/**
+ * CardBase ContentWrapper Props
+ */
+export interface CardBaseContentWrapperProps extends React.HTMLAttributes<HTMLDivElement> {
+    /**
+     * Size variant - inherited from parent CardBase
+     * @default "default"
+     */
+    size?: CardBaseSize;
+    /**
+     * Additional CSS classes
+     */
+    className?: string;
+}
+/**
+ * CardBase FooterWrapper Props
+ */
+export interface CardBaseFooterWrapperProps extends React.HTMLAttributes<HTMLDivElement> {
+    /**
+     * Size variant - inherited from parent CardBase
+     * @default "default"
+     */
+    size?: CardBaseSize;
+    /**
+     * Additional CSS classes
+     */
+    className?: string;
+}

package/dist/components/cards/CardBase/CardBase.variants.d.ts

@@ -0,0 +1,38 @@
+/**
+ * CardBase Variants
+ *
+ * CVA-based variant system for CardBase component.
+ * Supports size variants (default, compact) and style variants (default, featured).
+ * All styling uses token-based values from DOMAIN_TOKENS and MOTION_TOKENS.
+ */
+export declare const cardBaseVariants: (props?: ({
+    size?: "default" | "compact" | null | undefined;
+    variant?: "default" | "featured" | null | undefined;
+} & import('class-variance-authority/types').ClassProp) | undefined) => string;
+/**
+ * CardBase ImageWrapper Variants
+ *
+ * CVA-based variant system for ImageWrapper component.
+ * Uses DOMAIN_TOKENS.image for aspect ratio and radius.
+ */
+export declare const cardBaseImageVariants: (props?: ({
+    size?: "default" | "compact" | null | undefined;
+} & import('class-variance-authority/types').ClassProp) | undefined) => string;
+/**
+ * CardBase ContentWrapper Variants
+ *
+ * CVA-based variant system for ContentWrapper component.
+ * Uses layout tokens for spacing.
+ */
+export declare const cardBaseContentVariants: (props?: ({
+    size?: "default" | "compact" | null | undefined;
+} & import('class-variance-authority/types').ClassProp) | undefined) => string;
+/**
+ * CardBase FooterWrapper Variants
+ *
+ * CVA-based variant system for FooterWrapper component.
+ * Uses layout tokens for spacing.
+ */
+export declare const cardBaseFooterVariants: (props?: ({
+    size?: "default" | "compact" | null | undefined;
+} & import('class-variance-authority/types').ClassProp) | undefined) => string;

package/dist/components/cards/CardBase/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * CardBase Component Exports
+ *
+ * Barrel exports for CardBase component and its layout wrappers.
+ */
+export { CardBase, CardBaseContentWrapper, CardBaseFooterWrapper, CardBaseImageWrapper, } from './CardBase';
+export type { CardBaseContentWrapperProps, CardBaseFooterWrapperProps, CardBaseImageWrapperProps, CardBaseProps, CardBaseSize, CardBaseVariant, } from './CardBase.types';
+export { cardBaseContentVariants, cardBaseFooterVariants, cardBaseImageVariants, cardBaseVariants, } from './CardBase.variants';

package/dist/components/cards/CategoryCard/CategoryCard.d.ts

@@ -0,0 +1,18 @@
+import { CategoryCardProps } from './CategoryCard.types';
+import * as React from "react";
+/**
+ * CategoryCard Component
+ *
+ * Domain-specific card component for displaying category information.
+ * Uses CardBase for layout and DOMAIN_TOKENS for all styling.
+ *
+ * @example
+ * ```tsx
+ * <CategoryCard
+ *   title="Jazz"
+ *   description="Explore jazz events"
+ *   href="/categories/jazz"
+ * />
+ * ```
+ */
+export declare const CategoryCard: React.ForwardRefExoticComponent<CategoryCardProps & React.RefAttributes<HTMLDivElement>>;

package/dist/components/cards/CategoryCard/CategoryCard.types.d.ts

@@ -0,0 +1,38 @@
+import { ComponentAnimationConfig } from '../../../animation/types';
+import * as React from "react";
+/**
+ * CategoryCard Size Variant
+ */
+export type CategoryCardSize = "default" | "compact";
+/**
+ * CategoryCard Style Variant
+ */
+export type CategoryCardVariant = "default" | "featured";
+/**
+ * Props for CategoryCard component.
+ * All props are flat and domain-agnostic. Consumer should provide pre-localized strings.
+ */
+export interface CategoryCardProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** Category title (pre-localized string, required) */
+    title: string;
+    /** Category description (pre-localized string, optional) */
+    description?: string;
+    /** Image URL (optional) */
+    imageUrl?: string;
+    /** Link URL for category details page (optional) */
+    href?: string;
+    /** Whether this is a featured category */
+    featured?: boolean;
+    /** Badge text for featured categories (optional) */
+    featuredBadgeText?: string;
+    /** Show image section */
+    showImage?: boolean;
+    /** Size variant - controls padding and spacing */
+    size?: CategoryCardSize;
+    /** Style variant - controls visual appearance */
+    variant?: CategoryCardVariant;
+    /** Additional CSS classes */
+    className?: string;
+    /** Animation configuration for entrance and hover animations */
+    animation?: ComponentAnimationConfig;
+}

package/dist/components/cards/CategoryCard/CategoryCard.variants.d.ts

@@ -0,0 +1,21 @@
+/**
+ * CategoryCard Variants
+ *
+ * CVA-based variant system for CategoryCard component.
+ * Supports size variants (default, compact) and style variants (default, featured).
+ * All styling uses token-based values from DOMAIN_TOKENS and TEXT_TOKENS.
+ */
+/**
+ * Badge positioning variant
+ * Uses absolute positioning for featured badge overlay
+ */
+export declare const categoryCardBadgeVariants: (props?: ({
+    size?: "default" | "compact" | null | undefined;
+} & import('class-variance-authority/types').ClassProp) | undefined) => string;
+/**
+ * Badge surface variant
+ * Uses DOMAIN_TOKENS.badges for styling
+ */
+export declare const categoryCardBadgeSurfaceVariants: (props?: ({
+    variant?: "default" | "featured" | null | undefined;
+} & import('class-variance-authority/types').ClassProp) | undefined) => string;

package/dist/components/cards/CategoryCard/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * CategoryCard Component Exports
+ *
+ * Barrel exports for CategoryCard component and related types.
+ */
+export { CategoryCard } from './CategoryCard';
+export type { CategoryCardProps, CategoryCardSize, CategoryCardVariant, } from './CategoryCard.types';