@digilogiclabs/saas-factory-ui 1.12.0 → 1.12.1

package/dist/web/index.d.mts

@@ -4637,6 +4637,187 @@ interface NewsTickerProps<T> {
 }
 declare function NewsTicker<T>({ items, speed, height, variant, className, getKey, getLabel, getHref, getDot, filters, sorts, onItemClick, linkComponent, emptyMessage, }: NewsTickerProps<T>): react_jsx_runtime.JSX.Element;
 
+/**
+ * FilterableGrid — A polished, generic grid component with built-in
+ * search, faceted filtering, sorting, category navigation, quick tabs,
+ * grid/list layout toggling, pagination, and stagger animations.
+ *
+ * Self-themed via shadcn-style CSS variables (`--card`, `--primary`,
+ * `--border`, `--muted-foreground`, etc.), so it automatically adapts
+ * to whatever design system the consuming app uses — including
+ * light/dark mode. Each token is also exposed as `--fg-*` so consumers
+ * can override individual values without disturbing their wider theme.
+ *
+ * Card rendering is fully delegated to consumers via `renderCard`, so
+ * the component imposes no opinion on item shape or visual treatment.
+ *
+ * Supports two modes:
+ *
+ * - **`client`** (default): Items are filtered, sorted, and paginated
+ *   in memory. Use this when the full dataset is small and known up
+ *   front.
+ * - **`server`**: The component renders `items` as-is and emits
+ *   `onStateChange` whenever search/filters/sort/layout change so the
+ *   parent can refetch. Use this when filters drive a server query
+ *   (e.g., URL-driven Next.js server components).
+ *
+ * The category bar can be replaced wholesale via `renderCategoryNav`,
+ * allowing consumers to drop in `<NewsTicker />` or any other nav.
+ *
+ * @example
+ * ```tsx
+ * import { FilterableGrid } from "@digilogiclabs/saas-factory-ui";
+ *
+ * <FilterableGrid
+ *   items={sports}
+ *   getId={(s) => s.slug}
+ *   getLabel={(s) => s.name}
+ *   getCategory={(s) => s.category}
+ *   categories={CATEGORIES}
+ *   filters={FILTERS}
+ *   sorts={SORTS}
+ *   quickTabs={[
+ *     { key: "favorites", label: "Favorites", filter: (s) => favs.includes(s.slug) },
+ *   ]}
+ *   pageSize={24}
+ *   renderCard={(sport, i, ctx) => (
+ *     <SportCard key={sport.slug} sport={sport} layout={ctx.layout} index={i} />
+ *   )}
+ * />
+ * ```
+ */
+interface FilterableGridCategory {
+    key: string;
+    label: string;
+    icon?: React$1.ReactNode;
+}
+interface FilterableGridFilterOption {
+    value: string;
+    label: string;
+    icon?: React$1.ReactNode;
+    count?: number;
+}
+interface FilterableGridFilter {
+    /** Item field key to filter on (must match a property of T) */
+    key: string;
+    label: string;
+    options: FilterableGridFilterOption[];
+    /** Allow multiple values per filter group (default true) */
+    multi?: boolean;
+}
+interface FilterableGridSort<T> {
+    key: string;
+    label: string;
+    fn: (a: T, b: T) => number;
+}
+interface FilterableGridQuickTab<T> {
+    key: string;
+    label: string;
+    icon?: React$1.ReactNode;
+    count?: number;
+    /** Predicate (only used in client mode). In server mode the parent reads
+     *  the active quick tab from `onStateChange` and applies its own logic. */
+    filter?: (item: T) => boolean;
+}
+type FilterableGridLayout = "grid" | "list";
+interface FilterableGridState {
+    search: string;
+    category: string | null;
+    filters: Record<string, string[]>;
+    sort: string | null;
+    layout: FilterableGridLayout;
+    quickTab: string | null;
+}
+interface FilterableGridCategoryNavProps {
+    categories: FilterableGridCategory[];
+    activeCategory: string | null;
+    onCategoryChange: (category: string | null) => void;
+    quickTabs: ReadonlyArray<FilterableGridQuickTab<unknown>>;
+    activeQuickTab: string | null;
+    onQuickTabChange: (key: string | null) => void;
+    labels: FilterableGridLabels;
+}
+interface FilterableGridRenderCardContext {
+    layout: FilterableGridLayout;
+    isFav: boolean;
+    index: number;
+}
+interface FilterableGridLabels {
+    searchPlaceholder: string;
+    searchAriaLabel: string;
+    clearSearchAriaLabel: string;
+    allCategories: string;
+    clearAll: string;
+    showMore: string;
+    remaining: string;
+    noResults: string;
+    clearFilters: string;
+    itemsLabel: string;
+    showing: string;
+    filtersTitle: string;
+    filtersAriaLabel: string;
+    filtersTriggerLabel: string;
+    closeFiltersLabel: string;
+    sortByTitle: string;
+    layoutGridLabel: string;
+    layoutListLabel: string;
+    layoutToggleAriaLabel: string;
+    countAnnouncement: (count: number, total: number) => string;
+}
+interface FilterableGridProps<T> {
+    /** Items to display. In `client` mode these are filtered locally;
+     *  in `server` mode they are rendered as-is. */
+    items: T[];
+    /** Filtering mode (default `"client"`) */
+    mode?: "client" | "server";
+    /** Stable id for each item (used for favorites + React keys). Default: `item.id` */
+    getId?: (item: T) => string;
+    /** Display label fallback (used by default `getSearchText`). Default: `item.label || item.name || item.title` */
+    getLabel?: (item: T) => string;
+    /** Category key for client-mode category filtering. Default: `item.category` */
+    getCategory?: (item: T) => string | undefined;
+    /** Searchable text for client-mode search. Default: `getLabel(item)` */
+    getSearchText?: (item: T) => string;
+    categories?: FilterableGridCategory[];
+    filters?: FilterableGridFilter[];
+    sorts?: FilterableGridSort<T>[];
+    quickTabs?: FilterableGridQuickTab<T>[];
+    defaultSort?: string | null;
+    defaultCategory?: string | null;
+    defaultLayout?: FilterableGridLayout;
+    /** Items per page in client mode. `0` disables pagination. */
+    pageSize?: number;
+    showLayoutToggle?: boolean;
+    showSearch?: boolean;
+    showCount?: boolean;
+    /** Search debounce in ms (default 300, set to 0 to disable) */
+    searchDebounceMs?: number;
+    /** Maximum index to apply stagger animation delay to (default 9) */
+    staggerCap?: number;
+    /** Per-card stagger step in ms (default 50) */
+    staggerStepMs?: number;
+    /** Replace the entire category/quick-tab nav with a custom component
+     *  (e.g. `<NewsTicker />`). Receives all the state needed to render. */
+    renderCategoryNav?: (props: FilterableGridCategoryNavProps) => React$1.ReactNode;
+    /** Required: card renderer. The component is intentionally card-agnostic. */
+    renderCard: (item: T, index: number, ctx: FilterableGridRenderCardContext) => React$1.ReactNode;
+    renderEmpty?: (state: FilterableGridState) => React$1.ReactNode;
+    renderSkeleton?: (count: number) => React$1.ReactNode;
+    loading?: boolean;
+    hasMore?: boolean;
+    totalCount?: number;
+    onLoadMore?: () => void;
+    /** Fires whenever the internal filter state changes. Use this in
+     *  `server` mode to translate state into a fetch / URL update. */
+    onStateChange?: (state: FilterableGridState) => void;
+    favorites?: string[];
+    onFavoriteToggle?: (item: T) => void;
+    onItemClick?: (item: T) => void;
+    labels?: Partial<FilterableGridLabels>;
+    className?: string;
+}
+declare function FilterableGrid<T>({ items, mode, getId, getLabel, getCategory, getSearchText, categories, filters, sorts, quickTabs, defaultSort, defaultCategory, defaultLayout, pageSize, showLayoutToggle, showSearch, showCount, searchDebounceMs, staggerCap, staggerStepMs, renderCategoryNav, renderCard, renderEmpty, renderSkeleton, loading, hasMore: serverHasMore, totalCount: serverTotalCount, onLoadMore: serverOnLoadMore, onStateChange, favorites, onItemClick, labels: labelOverrides, className, }: FilterableGridProps<T>): react_jsx_runtime.JSX.Element;
+
 /**
  * ErrorBoundary - Catches JavaScript errors in child component trees.
  *
@@ -5031,4 +5212,4 @@ declare class OptimizedStateManager {
 }
 declare const stateManager: OptimizedStateManager;
 
-export { ANIMATION_DURATION, Accordion, AccordionItem, type AccordionItemProps, type AccordionProps, type ActivityType, type AdvancedAudioTrack, AdvancedPlayer, type AdvancedPlayerProps, Alert, AlertDescription, AlertTitle, AnalyticsDashboard, AnimatedSectionTitle, type AnimatedSectionTitleProps, type AnimationTokens, Breadcrumbs as AppBreadcrumbs, AppShell, AudioFeed, type AudioFeedProps, AudioPlayer, type AudioPlayerProps, SearchWithFilters as AudioSearch, type AudioTrack, type AudioTrackCardData, AuthLayout, Avatar, AvatarFallback, AvatarImage, Badge, BarChart, type BarChart3IconBand, type BarChartProps, type BaseAccordionItemProps, type BaseAccordionProps, type BaseBreadcrumbsProps, type BaseChartProps, type BaseComponentProps, type BaseEmptyStateProps, type BaseSliderProps, type BaseSwitchProps, type BaseTextareaProps, type BaseTheme, type BorderRadiusScale, type BreadcrumbItem$1 as BreadcrumbItem, Breadcrumbs$1 as Breadcrumbs, type BreadcrumbsProps$1 as BreadcrumbsProps, type BugReportPayload, BugReporter, type BugReporterProps, Button, type ButtonVariants, type CTAAction, CTACluster, type CTAClusterProps, type CacheStrategy, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Chart, type ChartDataPoint$1 as ChartDataPoint, type ChartProps, type ChartSeries, Checkbox, CollaborativePlaylist, type CollaborativePlaylistData, type CollaborativePlaylistProps, type Collaborator, type CollaboratorRole, type Column$1 as Column, CommandPalette, type Comment, type CommentData, CommentSystem, type CommentSystemProps, type CommentUser, type ComponentProps, type ComponentSize, type ComponentVariant, Container$1 as Container, ConversionKPI, type CrossfadeMode, DashboardGrid, DashboardLayout, DashboardWidget, type DashboardWidgetProps, DataGrid, type DataGridProps, type DataItem, DataTable, type Column as DataTableColumn, type DataTableProps, type DateFilter, Dialog, DialogContent, DialogDescription, DialogHeader, DialogTitle, DialogTrigger, DropdownMenu, DropdownMenuContent, DropdownMenuItem, DropdownMenuLabel, DropdownMenuSeparator, DropdownMenuTrigger, type DurationFilter, EmptyState, type EmptyStateProps, EnhancedScrollToTop, type EnhancedScrollToTopProps, type EnvConfig, ErrorAnimation, ErrorBoundary, type ErrorBoundaryProps, ErrorFallback, type ErrorFallbackProps, type ExportOptions, type ExportService, FeatureGrid, type FeatureGridProps, FeatureHighlight, type FeatureItem, type FeedFilter, type FeedItem, type FeedSortOrder, type FeedbackCategory, FilterChip, type FilterChipProps, type FilterConfig, FixedAudioBar, type FixedAudioBarProps, Form, FormBuilder, type FormBuilderProps, FormDescription, type FormField, FormGroup, FormLabel, FormMessage, FormProgress, type FormProps, type FormSchema, FormSection, type GenreFilter, type GlassmorphismTokens, GradientBorderCard, type GradientBorderCardProps, Grid$1 as Grid, GridItem, HamburgerIcon, type HamburgerIconProps, Header, HeaderActions, HeaderBrand, HeaderContainer, HeaderDesktopNav, HeaderMobileTrigger, HeaderNavLink, Hero, HeroCTA, HeroContent, type HeroProps, HeroSubtitle, HeroTitle, InfoAnimation, Input, type InputVariants, type IntersectionObserverOptions, KPIDashboard, type KPIData, KPIWidget, type KPIWidgetProps, Label, LavaLamp, type LavaLampProps, LazyImage, type LazyImagePlaceholder, type LazyImageProps, LineChart, type LineChartProps, LoadingSpinner, LogoCloud, type LogoCloudProps, type LogoItem, MobileContainer, type MobileContainerProps, MobileContent, MobileEmailInput, MobileForm, MobileFormActions, MobileFormField, MobileFormGroup, type MobileFormProps, MobileFormSection, MobileGrid, MobileHero, type MobileHeroProps, MobileNavButton, MobileNavContent, MobileNavDrawer, MobileNavFooter, MobileNavHeader, MobileNavLink, MobileNavOverlay, MobileNavTrigger, MobileNavigation, MobileOTPInput, MobilePage, MobilePhoneInput, MobileSection, MobileSticky, Modal, type NativeComponentProps, Container as NativeContainer, Grid as NativeGrid, Section as NativeSection, type NativeStyle, Pagination as NavigationPagination, Stepper as NavigationStepper, Tabs as NavigationTabs, NetworkAwareContent, type NetworkAwareContentProps, type NetworkInfo, type NetworkSpeed, type NetworkType, NewsTicker, type NewsTickerFilter, type NewsTickerFilterOption, type NewsTickerProps, type NewsTickerSort, NotificationCenter, type NotificationCenterProps, type NotificationItem, type NotificationType, type NotificationUser, TrackCard as NowPlayingCard, OfflineWrapper, type OfflineWrapperProps, Onboarding, OptimizedStateManager, type OptimizedStoreOptions, PageHeader, type PageHeaderProps, PageShell, type PageShellProps, PageTransition, type PageTransitionDirection, type PageTransitionProps, type PageTransitionType, Pagination$1 as Pagination, type PaginationConfig, PaginationInfo, type PaginationInfoProps, type PaginationProps$1 as PaginationProps, type PerformanceMetrics, type PieChartProps, Platform, type PlatformConfig, type PlatformSelect, type PlatformSelectMultiple, type PlatformType, type PlaybackQuality, type PlaybackState, type PlaylistActivity, PlaylistBuilder, type PlaylistBuilderProps, PlaylistBuilder as PlaylistCard, type PlaylistData, PlaylistBuilder as PlaylistSidebar, type PlaylistTrack, type PlaylistVisibility, Preloader, type PreloaderProps, PremiumCard, PremiumCardContent, PremiumCardFooter, PremiumCardHeader, type PremiumCardProps, PricingHero, type PricingHeroProps, type PricingPlan, Progress, ProgressiveImage, type ProgressiveImageProps, type ProgressiveImageStrategy, type ProgressiveImageTransition, PullToRefresh, type PullToRefreshProps, PulseIndicator, type PulseIndicatorProps, type PulseStatus, QuickForm, type RefreshState, type RepeatMode, type ResponsiveColumns, ResponsiveFlex, ResponsiveGrid, type ResponsiveGridProps, ResponsiveHeader, type ResponsiveHeaderProps, RevenueKPI, SafeAreaWrapper, ScrollProgressBar, type ScrollProgressBarProps, ScrollProgressLine, type ScrollProgressLineProps, ScrollToTop, type ScrollToTopProps, type SearchCategory, type SearchFilters, type SearchResult, type SearchSortBy, type SearchSuggestion, SearchWithFilters, type SearchWithFiltersProps, Section$1 as Section, SectionBlock, type SectionBlockProps, SectionLabel, type SectionLabelProps, SectionTitle, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, type SelectionConfig, SettingsLayout, type ShareOption, Sidebar, SimpleHero, SimpleResponsiveHeader, type Size, Skeleton, SkeletonAvatar, SkeletonButton, SkeletonCard, SkeletonText, Slider, type SliderProps, type SocialAction, SocialActions, type SocialActionsProps, type SocialLinks, type SortConfig, type SpacingScale, Stack, SuccessAnimation, type SuccessAnimationProps, SuccessCheckmark, type SwipeAction, SwipeableCard, type SwipeableCardProps, Switch, type SwitchProps, THEME_COLORS, type TabItem$1 as TabItem, TabNavigation, type TabNavigationProps, Tabs$1 as Tabs, TabsContent, TabsList, TabsTrigger, Textarea, type TextareaProps, type Theme, type ThemeColors, ThemeProvider, ThemeToggle, type ThemeToggleProps, Toast$1 as Toast, ToastAction, type ToastActionElement, ToastClose, ToastDescription, ToastIcon, type ToastIconProps, type ToastProps, ToastProvider, ToastTitle, type ToastVariant, ToastViewport, Toaster, Tooltip$1 as Tooltip, TooltipContent, type TooltipProps$1 as TooltipProps, TooltipProvider, TooltipRoot, TooltipTrigger, TouchInput, type TouchInputProps, Tour, Tooltip as TourTooltip, type Track, TrackCard, type TrackCardProps, AudioFeed as TrackList, type TrendingSection, type TrendingTrack, TrendingTracks, type TrendingTracksProps, type TutorialAction, TutorialEmbed, type TutorialEmbedProps, TutorialGallery, type TutorialGalleryProps, type TutorialMedia, type TutorialMetadata, TutorialSequence, type TutorialSequenceProps, type TutorialStep, type UseIntersectionObserverResult, type UsePerformanceObserverOptions, UserProfile, type UserProfileData, type UserProfileProps, type UserStats, UsersKPI, VARIANT_ICONS, type Variant, type VideoAuthor, type VideoChapter, VideoPlayer, type VideoPlayerProps, type VideoQuality, type VideoSubtitle, type VideoTrack, VirtualScrollList, type VirtualScrollListProps, type VirtualizationConfig, type VirtualizedItem, type VisualizerType, WarningAnimation, type WaveformData, WaveformPlayer, type WaveformPlayerProps, type WebComponentProps, type WebStyle, WelcomeModal, Z_INDEX, accordionVariants, animationPresets, audioAppTabs, audioPlayerVariants, breadcrumbsVariants, cn, commonValidators, containerVariants, contentVariants, createDataStore, createFormStore, createOptimizedStore, cssAnimations, dailyTrendingConfig, detectAuthProvider, disableScroll, durations, emptyStateVariants, enableScroll, fadeInOut, formVariants, formatCurrency, formatDate, formatNumber, genreChartsConfigs, getConfig, getEnvInfo, getEnvVar, getScrollbarWidth, gridVariants, hamburgerVariants, headerVariants, heroVariants, inputVariants, isBrowser, isExpo, isNative, isWeb, labelVariants, musicAppTabs, nativeConfig, podcastAppTabs, scaleInOut, slideUp, sliderVariants, stateManager, stickyActionsVariants, switchVariants, textareaVariants, theme, themes, timingFunctions, toast, toastVariants, useAnimationTokens, useCache, useClickOutside, useCustomPerformanceTracking, useDebouncedCallback, useEscapeKey, useGlassmorphism, useInfiniteScroll, useIntersectionObserver, useLazyLoad, useLockBody, useMediaQuery, useMobileNavigation, useMounted, useNetworkInfo, useOfflineState, useOptimizedMemo, useOptimizedStoreSelector, usePerformanceObserver, useRenderPerformanceTracking, useTheme, useThrottledCallback, useToast, useVirtualization, useVisibilityTracking, validateEmail, validateEnvConfig, validatePassword, videoPlayerVariants, webAnimations, webConfig, weeklyChartsConfig, withNetworkAware, withPageTransition };
+export { ANIMATION_DURATION, Accordion, AccordionItem, type AccordionItemProps, type AccordionProps, type ActivityType, type AdvancedAudioTrack, AdvancedPlayer, type AdvancedPlayerProps, Alert, AlertDescription, AlertTitle, AnalyticsDashboard, AnimatedSectionTitle, type AnimatedSectionTitleProps, type AnimationTokens, Breadcrumbs as AppBreadcrumbs, AppShell, AudioFeed, type AudioFeedProps, AudioPlayer, type AudioPlayerProps, SearchWithFilters as AudioSearch, type AudioTrack, type AudioTrackCardData, AuthLayout, Avatar, AvatarFallback, AvatarImage, Badge, BarChart, type BarChart3IconBand, type BarChartProps, type BaseAccordionItemProps, type BaseAccordionProps, type BaseBreadcrumbsProps, type BaseChartProps, type BaseComponentProps, type BaseEmptyStateProps, type BaseSliderProps, type BaseSwitchProps, type BaseTextareaProps, type BaseTheme, type BorderRadiusScale, type BreadcrumbItem$1 as BreadcrumbItem, Breadcrumbs$1 as Breadcrumbs, type BreadcrumbsProps$1 as BreadcrumbsProps, type BugReportPayload, BugReporter, type BugReporterProps, Button, type ButtonVariants, type CTAAction, CTACluster, type CTAClusterProps, type CacheStrategy, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Chart, type ChartDataPoint$1 as ChartDataPoint, type ChartProps, type ChartSeries, Checkbox, CollaborativePlaylist, type CollaborativePlaylistData, type CollaborativePlaylistProps, type Collaborator, type CollaboratorRole, type Column$1 as Column, CommandPalette, type Comment, type CommentData, CommentSystem, type CommentSystemProps, type CommentUser, type ComponentProps, type ComponentSize, type ComponentVariant, Container$1 as Container, ConversionKPI, type CrossfadeMode, DashboardGrid, DashboardLayout, DashboardWidget, type DashboardWidgetProps, DataGrid, type DataGridProps, type DataItem, DataTable, type Column as DataTableColumn, type DataTableProps, type DateFilter, Dialog, DialogContent, DialogDescription, DialogHeader, DialogTitle, DialogTrigger, DropdownMenu, DropdownMenuContent, DropdownMenuItem, DropdownMenuLabel, DropdownMenuSeparator, DropdownMenuTrigger, type DurationFilter, EmptyState, type EmptyStateProps, EnhancedScrollToTop, type EnhancedScrollToTopProps, type EnvConfig, ErrorAnimation, ErrorBoundary, type ErrorBoundaryProps, ErrorFallback, type ErrorFallbackProps, type ExportOptions, type ExportService, FeatureGrid, type FeatureGridProps, FeatureHighlight, type FeatureItem, type FeedFilter, type FeedItem, type FeedSortOrder, type FeedbackCategory, FilterChip, type FilterChipProps, type FilterConfig, FilterableGrid, type FilterableGridCategory, type FilterableGridCategoryNavProps, type FilterableGridFilter, type FilterableGridFilterOption, type FilterableGridLabels, type FilterableGridLayout, type FilterableGridProps, type FilterableGridQuickTab, type FilterableGridRenderCardContext, type FilterableGridSort, type FilterableGridState, FixedAudioBar, type FixedAudioBarProps, Form, FormBuilder, type FormBuilderProps, FormDescription, type FormField, FormGroup, FormLabel, FormMessage, FormProgress, type FormProps, type FormSchema, FormSection, type GenreFilter, type GlassmorphismTokens, GradientBorderCard, type GradientBorderCardProps, Grid$1 as Grid, GridItem, HamburgerIcon, type HamburgerIconProps, Header, HeaderActions, HeaderBrand, HeaderContainer, HeaderDesktopNav, HeaderMobileTrigger, HeaderNavLink, Hero, HeroCTA, HeroContent, type HeroProps, HeroSubtitle, HeroTitle, InfoAnimation, Input, type InputVariants, type IntersectionObserverOptions, KPIDashboard, type KPIData, KPIWidget, type KPIWidgetProps, Label, LavaLamp, type LavaLampProps, LazyImage, type LazyImagePlaceholder, type LazyImageProps, LineChart, type LineChartProps, LoadingSpinner, LogoCloud, type LogoCloudProps, type LogoItem, MobileContainer, type MobileContainerProps, MobileContent, MobileEmailInput, MobileForm, MobileFormActions, MobileFormField, MobileFormGroup, type MobileFormProps, MobileFormSection, MobileGrid, MobileHero, type MobileHeroProps, MobileNavButton, MobileNavContent, MobileNavDrawer, MobileNavFooter, MobileNavHeader, MobileNavLink, MobileNavOverlay, MobileNavTrigger, MobileNavigation, MobileOTPInput, MobilePage, MobilePhoneInput, MobileSection, MobileSticky, Modal, type NativeComponentProps, Container as NativeContainer, Grid as NativeGrid, Section as NativeSection, type NativeStyle, Pagination as NavigationPagination, Stepper as NavigationStepper, Tabs as NavigationTabs, NetworkAwareContent, type NetworkAwareContentProps, type NetworkInfo, type NetworkSpeed, type NetworkType, NewsTicker, type NewsTickerFilter, type NewsTickerFilterOption, type NewsTickerProps, type NewsTickerSort, NotificationCenter, type NotificationCenterProps, type NotificationItem, type NotificationType, type NotificationUser, TrackCard as NowPlayingCard, OfflineWrapper, type OfflineWrapperProps, Onboarding, OptimizedStateManager, type OptimizedStoreOptions, PageHeader, type PageHeaderProps, PageShell, type PageShellProps, PageTransition, type PageTransitionDirection, type PageTransitionProps, type PageTransitionType, Pagination$1 as Pagination, type PaginationConfig, PaginationInfo, type PaginationInfoProps, type PaginationProps$1 as PaginationProps, type PerformanceMetrics, type PieChartProps, Platform, type PlatformConfig, type PlatformSelect, type PlatformSelectMultiple, type PlatformType, type PlaybackQuality, type PlaybackState, type PlaylistActivity, PlaylistBuilder, type PlaylistBuilderProps, PlaylistBuilder as PlaylistCard, type PlaylistData, PlaylistBuilder as PlaylistSidebar, type PlaylistTrack, type PlaylistVisibility, Preloader, type PreloaderProps, PremiumCard, PremiumCardContent, PremiumCardFooter, PremiumCardHeader, type PremiumCardProps, PricingHero, type PricingHeroProps, type PricingPlan, Progress, ProgressiveImage, type ProgressiveImageProps, type ProgressiveImageStrategy, type ProgressiveImageTransition, PullToRefresh, type PullToRefreshProps, PulseIndicator, type PulseIndicatorProps, type PulseStatus, QuickForm, type RefreshState, type RepeatMode, type ResponsiveColumns, ResponsiveFlex, ResponsiveGrid, type ResponsiveGridProps, ResponsiveHeader, type ResponsiveHeaderProps, RevenueKPI, SafeAreaWrapper, ScrollProgressBar, type ScrollProgressBarProps, ScrollProgressLine, type ScrollProgressLineProps, ScrollToTop, type ScrollToTopProps, type SearchCategory, type SearchFilters, type SearchResult, type SearchSortBy, type SearchSuggestion, SearchWithFilters, type SearchWithFiltersProps, Section$1 as Section, SectionBlock, type SectionBlockProps, SectionLabel, type SectionLabelProps, SectionTitle, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, type SelectionConfig, SettingsLayout, type ShareOption, Sidebar, SimpleHero, SimpleResponsiveHeader, type Size, Skeleton, SkeletonAvatar, SkeletonButton, SkeletonCard, SkeletonText, Slider, type SliderProps, type SocialAction, SocialActions, type SocialActionsProps, type SocialLinks, type SortConfig, type SpacingScale, Stack, SuccessAnimation, type SuccessAnimationProps, SuccessCheckmark, type SwipeAction, SwipeableCard, type SwipeableCardProps, Switch, type SwitchProps, THEME_COLORS, type TabItem$1 as TabItem, TabNavigation, type TabNavigationProps, Tabs$1 as Tabs, TabsContent, TabsList, TabsTrigger, Textarea, type TextareaProps, type Theme, type ThemeColors, ThemeProvider, ThemeToggle, type ThemeToggleProps, Toast$1 as Toast, ToastAction, type ToastActionElement, ToastClose, ToastDescription, ToastIcon, type ToastIconProps, type ToastProps, ToastProvider, ToastTitle, type ToastVariant, ToastViewport, Toaster, Tooltip$1 as Tooltip, TooltipContent, type TooltipProps$1 as TooltipProps, TooltipProvider, TooltipRoot, TooltipTrigger, TouchInput, type TouchInputProps, Tour, Tooltip as TourTooltip, type Track, TrackCard, type TrackCardProps, AudioFeed as TrackList, type TrendingSection, type TrendingTrack, TrendingTracks, type TrendingTracksProps, type TutorialAction, TutorialEmbed, type TutorialEmbedProps, TutorialGallery, type TutorialGalleryProps, type TutorialMedia, type TutorialMetadata, TutorialSequence, type TutorialSequenceProps, type TutorialStep, type UseIntersectionObserverResult, type UsePerformanceObserverOptions, UserProfile, type UserProfileData, type UserProfileProps, type UserStats, UsersKPI, VARIANT_ICONS, type Variant, type VideoAuthor, type VideoChapter, VideoPlayer, type VideoPlayerProps, type VideoQuality, type VideoSubtitle, type VideoTrack, VirtualScrollList, type VirtualScrollListProps, type VirtualizationConfig, type VirtualizedItem, type VisualizerType, WarningAnimation, type WaveformData, WaveformPlayer, type WaveformPlayerProps, type WebComponentProps, type WebStyle, WelcomeModal, Z_INDEX, accordionVariants, animationPresets, audioAppTabs, audioPlayerVariants, breadcrumbsVariants, cn, commonValidators, containerVariants, contentVariants, createDataStore, createFormStore, createOptimizedStore, cssAnimations, dailyTrendingConfig, detectAuthProvider, disableScroll, durations, emptyStateVariants, enableScroll, fadeInOut, formVariants, formatCurrency, formatDate, formatNumber, genreChartsConfigs, getConfig, getEnvInfo, getEnvVar, getScrollbarWidth, gridVariants, hamburgerVariants, headerVariants, heroVariants, inputVariants, isBrowser, isExpo, isNative, isWeb, labelVariants, musicAppTabs, nativeConfig, podcastAppTabs, scaleInOut, slideUp, sliderVariants, stateManager, stickyActionsVariants, switchVariants, textareaVariants, theme, themes, timingFunctions, toast, toastVariants, useAnimationTokens, useCache, useClickOutside, useCustomPerformanceTracking, useDebouncedCallback, useEscapeKey, useGlassmorphism, useInfiniteScroll, useIntersectionObserver, useLazyLoad, useLockBody, useMediaQuery, useMobileNavigation, useMounted, useNetworkInfo, useOfflineState, useOptimizedMemo, useOptimizedStoreSelector, usePerformanceObserver, useRenderPerformanceTracking, useTheme, useThrottledCallback, useToast, useVirtualization, useVisibilityTracking, validateEmail, validateEnvConfig, validatePassword, videoPlayerVariants, webAnimations, webConfig, weeklyChartsConfig, withNetworkAware, withPageTransition };

package/dist/web/index.d.ts

@@ -4637,6 +4637,187 @@ interface NewsTickerProps<T> {
 }
 declare function NewsTicker<T>({ items, speed, height, variant, className, getKey, getLabel, getHref, getDot, filters, sorts, onItemClick, linkComponent, emptyMessage, }: NewsTickerProps<T>): react_jsx_runtime.JSX.Element;
 
+/**
+ * FilterableGrid — A polished, generic grid component with built-in
+ * search, faceted filtering, sorting, category navigation, quick tabs,
+ * grid/list layout toggling, pagination, and stagger animations.
+ *
+ * Self-themed via shadcn-style CSS variables (`--card`, `--primary`,
+ * `--border`, `--muted-foreground`, etc.), so it automatically adapts
+ * to whatever design system the consuming app uses — including
+ * light/dark mode. Each token is also exposed as `--fg-*` so consumers
+ * can override individual values without disturbing their wider theme.
+ *
+ * Card rendering is fully delegated to consumers via `renderCard`, so
+ * the component imposes no opinion on item shape or visual treatment.
+ *
+ * Supports two modes:
+ *
+ * - **`client`** (default): Items are filtered, sorted, and paginated
+ *   in memory. Use this when the full dataset is small and known up
+ *   front.
+ * - **`server`**: The component renders `items` as-is and emits
+ *   `onStateChange` whenever search/filters/sort/layout change so the
+ *   parent can refetch. Use this when filters drive a server query
+ *   (e.g., URL-driven Next.js server components).
+ *
+ * The category bar can be replaced wholesale via `renderCategoryNav`,
+ * allowing consumers to drop in `<NewsTicker />` or any other nav.
+ *
+ * @example
+ * ```tsx
+ * import { FilterableGrid } from "@digilogiclabs/saas-factory-ui";
+ *
+ * <FilterableGrid
+ *   items={sports}
+ *   getId={(s) => s.slug}
+ *   getLabel={(s) => s.name}
+ *   getCategory={(s) => s.category}
+ *   categories={CATEGORIES}
+ *   filters={FILTERS}
+ *   sorts={SORTS}
+ *   quickTabs={[
+ *     { key: "favorites", label: "Favorites", filter: (s) => favs.includes(s.slug) },
+ *   ]}
+ *   pageSize={24}
+ *   renderCard={(sport, i, ctx) => (
+ *     <SportCard key={sport.slug} sport={sport} layout={ctx.layout} index={i} />
+ *   )}
+ * />
+ * ```
+ */
+interface FilterableGridCategory {
+    key: string;
+    label: string;
+    icon?: React$1.ReactNode;
+}
+interface FilterableGridFilterOption {
+    value: string;
+    label: string;
+    icon?: React$1.ReactNode;
+    count?: number;
+}
+interface FilterableGridFilter {
+    /** Item field key to filter on (must match a property of T) */
+    key: string;
+    label: string;
+    options: FilterableGridFilterOption[];
+    /** Allow multiple values per filter group (default true) */
+    multi?: boolean;
+}
+interface FilterableGridSort<T> {
+    key: string;
+    label: string;
+    fn: (a: T, b: T) => number;
+}
+interface FilterableGridQuickTab<T> {
+    key: string;
+    label: string;
+    icon?: React$1.ReactNode;
+    count?: number;
+    /** Predicate (only used in client mode). In server mode the parent reads
+     *  the active quick tab from `onStateChange` and applies its own logic. */
+    filter?: (item: T) => boolean;
+}
+type FilterableGridLayout = "grid" | "list";
+interface FilterableGridState {
+    search: string;
+    category: string | null;
+    filters: Record<string, string[]>;
+    sort: string | null;
+    layout: FilterableGridLayout;
+    quickTab: string | null;
+}
+interface FilterableGridCategoryNavProps {
+    categories: FilterableGridCategory[];
+    activeCategory: string | null;
+    onCategoryChange: (category: string | null) => void;
+    quickTabs: ReadonlyArray<FilterableGridQuickTab<unknown>>;
+    activeQuickTab: string | null;
+    onQuickTabChange: (key: string | null) => void;
+    labels: FilterableGridLabels;
+}
+interface FilterableGridRenderCardContext {
+    layout: FilterableGridLayout;
+    isFav: boolean;
+    index: number;
+}
+interface FilterableGridLabels {
+    searchPlaceholder: string;
+    searchAriaLabel: string;
+    clearSearchAriaLabel: string;
+    allCategories: string;
+    clearAll: string;
+    showMore: string;
+    remaining: string;
+    noResults: string;
+    clearFilters: string;
+    itemsLabel: string;
+    showing: string;
+    filtersTitle: string;
+    filtersAriaLabel: string;
+    filtersTriggerLabel: string;
+    closeFiltersLabel: string;
+    sortByTitle: string;
+    layoutGridLabel: string;
+    layoutListLabel: string;
+    layoutToggleAriaLabel: string;
+    countAnnouncement: (count: number, total: number) => string;
+}
+interface FilterableGridProps<T> {
+    /** Items to display. In `client` mode these are filtered locally;
+     *  in `server` mode they are rendered as-is. */
+    items: T[];
+    /** Filtering mode (default `"client"`) */
+    mode?: "client" | "server";
+    /** Stable id for each item (used for favorites + React keys). Default: `item.id` */
+    getId?: (item: T) => string;
+    /** Display label fallback (used by default `getSearchText`). Default: `item.label || item.name || item.title` */
+    getLabel?: (item: T) => string;
+    /** Category key for client-mode category filtering. Default: `item.category` */
+    getCategory?: (item: T) => string | undefined;
+    /** Searchable text for client-mode search. Default: `getLabel(item)` */
+    getSearchText?: (item: T) => string;
+    categories?: FilterableGridCategory[];
+    filters?: FilterableGridFilter[];
+    sorts?: FilterableGridSort<T>[];
+    quickTabs?: FilterableGridQuickTab<T>[];
+    defaultSort?: string | null;
+    defaultCategory?: string | null;
+    defaultLayout?: FilterableGridLayout;
+    /** Items per page in client mode. `0` disables pagination. */
+    pageSize?: number;
+    showLayoutToggle?: boolean;
+    showSearch?: boolean;
+    showCount?: boolean;
+    /** Search debounce in ms (default 300, set to 0 to disable) */
+    searchDebounceMs?: number;
+    /** Maximum index to apply stagger animation delay to (default 9) */
+    staggerCap?: number;
+    /** Per-card stagger step in ms (default 50) */
+    staggerStepMs?: number;
+    /** Replace the entire category/quick-tab nav with a custom component
+     *  (e.g. `<NewsTicker />`). Receives all the state needed to render. */
+    renderCategoryNav?: (props: FilterableGridCategoryNavProps) => React$1.ReactNode;
+    /** Required: card renderer. The component is intentionally card-agnostic. */
+    renderCard: (item: T, index: number, ctx: FilterableGridRenderCardContext) => React$1.ReactNode;
+    renderEmpty?: (state: FilterableGridState) => React$1.ReactNode;
+    renderSkeleton?: (count: number) => React$1.ReactNode;
+    loading?: boolean;
+    hasMore?: boolean;
+    totalCount?: number;
+    onLoadMore?: () => void;
+    /** Fires whenever the internal filter state changes. Use this in
+     *  `server` mode to translate state into a fetch / URL update. */
+    onStateChange?: (state: FilterableGridState) => void;
+    favorites?: string[];
+    onFavoriteToggle?: (item: T) => void;
+    onItemClick?: (item: T) => void;
+    labels?: Partial<FilterableGridLabels>;
+    className?: string;
+}
+declare function FilterableGrid<T>({ items, mode, getId, getLabel, getCategory, getSearchText, categories, filters, sorts, quickTabs, defaultSort, defaultCategory, defaultLayout, pageSize, showLayoutToggle, showSearch, showCount, searchDebounceMs, staggerCap, staggerStepMs, renderCategoryNav, renderCard, renderEmpty, renderSkeleton, loading, hasMore: serverHasMore, totalCount: serverTotalCount, onLoadMore: serverOnLoadMore, onStateChange, favorites, onItemClick, labels: labelOverrides, className, }: FilterableGridProps<T>): react_jsx_runtime.JSX.Element;
+
 /**
  * ErrorBoundary - Catches JavaScript errors in child component trees.
  *
@@ -5031,4 +5212,4 @@ declare class OptimizedStateManager {
 }
 declare const stateManager: OptimizedStateManager;
 
-export { ANIMATION_DURATION, Accordion, AccordionItem, type AccordionItemProps, type AccordionProps, type ActivityType, type AdvancedAudioTrack, AdvancedPlayer, type AdvancedPlayerProps, Alert, AlertDescription, AlertTitle, AnalyticsDashboard, AnimatedSectionTitle, type AnimatedSectionTitleProps, type AnimationTokens, Breadcrumbs as AppBreadcrumbs, AppShell, AudioFeed, type AudioFeedProps, AudioPlayer, type AudioPlayerProps, SearchWithFilters as AudioSearch, type AudioTrack, type AudioTrackCardData, AuthLayout, Avatar, AvatarFallback, AvatarImage, Badge, BarChart, type BarChart3IconBand, type BarChartProps, type BaseAccordionItemProps, type BaseAccordionProps, type BaseBreadcrumbsProps, type BaseChartProps, type BaseComponentProps, type BaseEmptyStateProps, type BaseSliderProps, type BaseSwitchProps, type BaseTextareaProps, type BaseTheme, type BorderRadiusScale, type BreadcrumbItem$1 as BreadcrumbItem, Breadcrumbs$1 as Breadcrumbs, type BreadcrumbsProps$1 as BreadcrumbsProps, type BugReportPayload, BugReporter, type BugReporterProps, Button, type ButtonVariants, type CTAAction, CTACluster, type CTAClusterProps, type CacheStrategy, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Chart, type ChartDataPoint$1 as ChartDataPoint, type ChartProps, type ChartSeries, Checkbox, CollaborativePlaylist, type CollaborativePlaylistData, type CollaborativePlaylistProps, type Collaborator, type CollaboratorRole, type Column$1 as Column, CommandPalette, type Comment, type CommentData, CommentSystem, type CommentSystemProps, type CommentUser, type ComponentProps, type ComponentSize, type ComponentVariant, Container$1 as Container, ConversionKPI, type CrossfadeMode, DashboardGrid, DashboardLayout, DashboardWidget, type DashboardWidgetProps, DataGrid, type DataGridProps, type DataItem, DataTable, type Column as DataTableColumn, type DataTableProps, type DateFilter, Dialog, DialogContent, DialogDescription, DialogHeader, DialogTitle, DialogTrigger, DropdownMenu, DropdownMenuContent, DropdownMenuItem, DropdownMenuLabel, DropdownMenuSeparator, DropdownMenuTrigger, type DurationFilter, EmptyState, type EmptyStateProps, EnhancedScrollToTop, type EnhancedScrollToTopProps, type EnvConfig, ErrorAnimation, ErrorBoundary, type ErrorBoundaryProps, ErrorFallback, type ErrorFallbackProps, type ExportOptions, type ExportService, FeatureGrid, type FeatureGridProps, FeatureHighlight, type FeatureItem, type FeedFilter, type FeedItem, type FeedSortOrder, type FeedbackCategory, FilterChip, type FilterChipProps, type FilterConfig, FixedAudioBar, type FixedAudioBarProps, Form, FormBuilder, type FormBuilderProps, FormDescription, type FormField, FormGroup, FormLabel, FormMessage, FormProgress, type FormProps, type FormSchema, FormSection, type GenreFilter, type GlassmorphismTokens, GradientBorderCard, type GradientBorderCardProps, Grid$1 as Grid, GridItem, HamburgerIcon, type HamburgerIconProps, Header, HeaderActions, HeaderBrand, HeaderContainer, HeaderDesktopNav, HeaderMobileTrigger, HeaderNavLink, Hero, HeroCTA, HeroContent, type HeroProps, HeroSubtitle, HeroTitle, InfoAnimation, Input, type InputVariants, type IntersectionObserverOptions, KPIDashboard, type KPIData, KPIWidget, type KPIWidgetProps, Label, LavaLamp, type LavaLampProps, LazyImage, type LazyImagePlaceholder, type LazyImageProps, LineChart, type LineChartProps, LoadingSpinner, LogoCloud, type LogoCloudProps, type LogoItem, MobileContainer, type MobileContainerProps, MobileContent, MobileEmailInput, MobileForm, MobileFormActions, MobileFormField, MobileFormGroup, type MobileFormProps, MobileFormSection, MobileGrid, MobileHero, type MobileHeroProps, MobileNavButton, MobileNavContent, MobileNavDrawer, MobileNavFooter, MobileNavHeader, MobileNavLink, MobileNavOverlay, MobileNavTrigger, MobileNavigation, MobileOTPInput, MobilePage, MobilePhoneInput, MobileSection, MobileSticky, Modal, type NativeComponentProps, Container as NativeContainer, Grid as NativeGrid, Section as NativeSection, type NativeStyle, Pagination as NavigationPagination, Stepper as NavigationStepper, Tabs as NavigationTabs, NetworkAwareContent, type NetworkAwareContentProps, type NetworkInfo, type NetworkSpeed, type NetworkType, NewsTicker, type NewsTickerFilter, type NewsTickerFilterOption, type NewsTickerProps, type NewsTickerSort, NotificationCenter, type NotificationCenterProps, type NotificationItem, type NotificationType, type NotificationUser, TrackCard as NowPlayingCard, OfflineWrapper, type OfflineWrapperProps, Onboarding, OptimizedStateManager, type OptimizedStoreOptions, PageHeader, type PageHeaderProps, PageShell, type PageShellProps, PageTransition, type PageTransitionDirection, type PageTransitionProps, type PageTransitionType, Pagination$1 as Pagination, type PaginationConfig, PaginationInfo, type PaginationInfoProps, type PaginationProps$1 as PaginationProps, type PerformanceMetrics, type PieChartProps, Platform, type PlatformConfig, type PlatformSelect, type PlatformSelectMultiple, type PlatformType, type PlaybackQuality, type PlaybackState, type PlaylistActivity, PlaylistBuilder, type PlaylistBuilderProps, PlaylistBuilder as PlaylistCard, type PlaylistData, PlaylistBuilder as PlaylistSidebar, type PlaylistTrack, type PlaylistVisibility, Preloader, type PreloaderProps, PremiumCard, PremiumCardContent, PremiumCardFooter, PremiumCardHeader, type PremiumCardProps, PricingHero, type PricingHeroProps, type PricingPlan, Progress, ProgressiveImage, type ProgressiveImageProps, type ProgressiveImageStrategy, type ProgressiveImageTransition, PullToRefresh, type PullToRefreshProps, PulseIndicator, type PulseIndicatorProps, type PulseStatus, QuickForm, type RefreshState, type RepeatMode, type ResponsiveColumns, ResponsiveFlex, ResponsiveGrid, type ResponsiveGridProps, ResponsiveHeader, type ResponsiveHeaderProps, RevenueKPI, SafeAreaWrapper, ScrollProgressBar, type ScrollProgressBarProps, ScrollProgressLine, type ScrollProgressLineProps, ScrollToTop, type ScrollToTopProps, type SearchCategory, type SearchFilters, type SearchResult, type SearchSortBy, type SearchSuggestion, SearchWithFilters, type SearchWithFiltersProps, Section$1 as Section, SectionBlock, type SectionBlockProps, SectionLabel, type SectionLabelProps, SectionTitle, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, type SelectionConfig, SettingsLayout, type ShareOption, Sidebar, SimpleHero, SimpleResponsiveHeader, type Size, Skeleton, SkeletonAvatar, SkeletonButton, SkeletonCard, SkeletonText, Slider, type SliderProps, type SocialAction, SocialActions, type SocialActionsProps, type SocialLinks, type SortConfig, type SpacingScale, Stack, SuccessAnimation, type SuccessAnimationProps, SuccessCheckmark, type SwipeAction, SwipeableCard, type SwipeableCardProps, Switch, type SwitchProps, THEME_COLORS, type TabItem$1 as TabItem, TabNavigation, type TabNavigationProps, Tabs$1 as Tabs, TabsContent, TabsList, TabsTrigger, Textarea, type TextareaProps, type Theme, type ThemeColors, ThemeProvider, ThemeToggle, type ThemeToggleProps, Toast$1 as Toast, ToastAction, type ToastActionElement, ToastClose, ToastDescription, ToastIcon, type ToastIconProps, type ToastProps, ToastProvider, ToastTitle, type ToastVariant, ToastViewport, Toaster, Tooltip$1 as Tooltip, TooltipContent, type TooltipProps$1 as TooltipProps, TooltipProvider, TooltipRoot, TooltipTrigger, TouchInput, type TouchInputProps, Tour, Tooltip as TourTooltip, type Track, TrackCard, type TrackCardProps, AudioFeed as TrackList, type TrendingSection, type TrendingTrack, TrendingTracks, type TrendingTracksProps, type TutorialAction, TutorialEmbed, type TutorialEmbedProps, TutorialGallery, type TutorialGalleryProps, type TutorialMedia, type TutorialMetadata, TutorialSequence, type TutorialSequenceProps, type TutorialStep, type UseIntersectionObserverResult, type UsePerformanceObserverOptions, UserProfile, type UserProfileData, type UserProfileProps, type UserStats, UsersKPI, VARIANT_ICONS, type Variant, type VideoAuthor, type VideoChapter, VideoPlayer, type VideoPlayerProps, type VideoQuality, type VideoSubtitle, type VideoTrack, VirtualScrollList, type VirtualScrollListProps, type VirtualizationConfig, type VirtualizedItem, type VisualizerType, WarningAnimation, type WaveformData, WaveformPlayer, type WaveformPlayerProps, type WebComponentProps, type WebStyle, WelcomeModal, Z_INDEX, accordionVariants, animationPresets, audioAppTabs, audioPlayerVariants, breadcrumbsVariants, cn, commonValidators, containerVariants, contentVariants, createDataStore, createFormStore, createOptimizedStore, cssAnimations, dailyTrendingConfig, detectAuthProvider, disableScroll, durations, emptyStateVariants, enableScroll, fadeInOut, formVariants, formatCurrency, formatDate, formatNumber, genreChartsConfigs, getConfig, getEnvInfo, getEnvVar, getScrollbarWidth, gridVariants, hamburgerVariants, headerVariants, heroVariants, inputVariants, isBrowser, isExpo, isNative, isWeb, labelVariants, musicAppTabs, nativeConfig, podcastAppTabs, scaleInOut, slideUp, sliderVariants, stateManager, stickyActionsVariants, switchVariants, textareaVariants, theme, themes, timingFunctions, toast, toastVariants, useAnimationTokens, useCache, useClickOutside, useCustomPerformanceTracking, useDebouncedCallback, useEscapeKey, useGlassmorphism, useInfiniteScroll, useIntersectionObserver, useLazyLoad, useLockBody, useMediaQuery, useMobileNavigation, useMounted, useNetworkInfo, useOfflineState, useOptimizedMemo, useOptimizedStoreSelector, usePerformanceObserver, useRenderPerformanceTracking, useTheme, useThrottledCallback, useToast, useVirtualization, useVisibilityTracking, validateEmail, validateEnvConfig, validatePassword, videoPlayerVariants, webAnimations, webConfig, weeklyChartsConfig, withNetworkAware, withPageTransition };
+export { ANIMATION_DURATION, Accordion, AccordionItem, type AccordionItemProps, type AccordionProps, type ActivityType, type AdvancedAudioTrack, AdvancedPlayer, type AdvancedPlayerProps, Alert, AlertDescription, AlertTitle, AnalyticsDashboard, AnimatedSectionTitle, type AnimatedSectionTitleProps, type AnimationTokens, Breadcrumbs as AppBreadcrumbs, AppShell, AudioFeed, type AudioFeedProps, AudioPlayer, type AudioPlayerProps, SearchWithFilters as AudioSearch, type AudioTrack, type AudioTrackCardData, AuthLayout, Avatar, AvatarFallback, AvatarImage, Badge, BarChart, type BarChart3IconBand, type BarChartProps, type BaseAccordionItemProps, type BaseAccordionProps, type BaseBreadcrumbsProps, type BaseChartProps, type BaseComponentProps, type BaseEmptyStateProps, type BaseSliderProps, type BaseSwitchProps, type BaseTextareaProps, type BaseTheme, type BorderRadiusScale, type BreadcrumbItem$1 as BreadcrumbItem, Breadcrumbs$1 as Breadcrumbs, type BreadcrumbsProps$1 as BreadcrumbsProps, type BugReportPayload, BugReporter, type BugReporterProps, Button, type ButtonVariants, type CTAAction, CTACluster, type CTAClusterProps, type CacheStrategy, Card, CardContent, CardDescription, CardFooter, CardHeader, CardTitle, Chart, type ChartDataPoint$1 as ChartDataPoint, type ChartProps, type ChartSeries, Checkbox, CollaborativePlaylist, type CollaborativePlaylistData, type CollaborativePlaylistProps, type Collaborator, type CollaboratorRole, type Column$1 as Column, CommandPalette, type Comment, type CommentData, CommentSystem, type CommentSystemProps, type CommentUser, type ComponentProps, type ComponentSize, type ComponentVariant, Container$1 as Container, ConversionKPI, type CrossfadeMode, DashboardGrid, DashboardLayout, DashboardWidget, type DashboardWidgetProps, DataGrid, type DataGridProps, type DataItem, DataTable, type Column as DataTableColumn, type DataTableProps, type DateFilter, Dialog, DialogContent, DialogDescription, DialogHeader, DialogTitle, DialogTrigger, DropdownMenu, DropdownMenuContent, DropdownMenuItem, DropdownMenuLabel, DropdownMenuSeparator, DropdownMenuTrigger, type DurationFilter, EmptyState, type EmptyStateProps, EnhancedScrollToTop, type EnhancedScrollToTopProps, type EnvConfig, ErrorAnimation, ErrorBoundary, type ErrorBoundaryProps, ErrorFallback, type ErrorFallbackProps, type ExportOptions, type ExportService, FeatureGrid, type FeatureGridProps, FeatureHighlight, type FeatureItem, type FeedFilter, type FeedItem, type FeedSortOrder, type FeedbackCategory, FilterChip, type FilterChipProps, type FilterConfig, FilterableGrid, type FilterableGridCategory, type FilterableGridCategoryNavProps, type FilterableGridFilter, type FilterableGridFilterOption, type FilterableGridLabels, type FilterableGridLayout, type FilterableGridProps, type FilterableGridQuickTab, type FilterableGridRenderCardContext, type FilterableGridSort, type FilterableGridState, FixedAudioBar, type FixedAudioBarProps, Form, FormBuilder, type FormBuilderProps, FormDescription, type FormField, FormGroup, FormLabel, FormMessage, FormProgress, type FormProps, type FormSchema, FormSection, type GenreFilter, type GlassmorphismTokens, GradientBorderCard, type GradientBorderCardProps, Grid$1 as Grid, GridItem, HamburgerIcon, type HamburgerIconProps, Header, HeaderActions, HeaderBrand, HeaderContainer, HeaderDesktopNav, HeaderMobileTrigger, HeaderNavLink, Hero, HeroCTA, HeroContent, type HeroProps, HeroSubtitle, HeroTitle, InfoAnimation, Input, type InputVariants, type IntersectionObserverOptions, KPIDashboard, type KPIData, KPIWidget, type KPIWidgetProps, Label, LavaLamp, type LavaLampProps, LazyImage, type LazyImagePlaceholder, type LazyImageProps, LineChart, type LineChartProps, LoadingSpinner, LogoCloud, type LogoCloudProps, type LogoItem, MobileContainer, type MobileContainerProps, MobileContent, MobileEmailInput, MobileForm, MobileFormActions, MobileFormField, MobileFormGroup, type MobileFormProps, MobileFormSection, MobileGrid, MobileHero, type MobileHeroProps, MobileNavButton, MobileNavContent, MobileNavDrawer, MobileNavFooter, MobileNavHeader, MobileNavLink, MobileNavOverlay, MobileNavTrigger, MobileNavigation, MobileOTPInput, MobilePage, MobilePhoneInput, MobileSection, MobileSticky, Modal, type NativeComponentProps, Container as NativeContainer, Grid as NativeGrid, Section as NativeSection, type NativeStyle, Pagination as NavigationPagination, Stepper as NavigationStepper, Tabs as NavigationTabs, NetworkAwareContent, type NetworkAwareContentProps, type NetworkInfo, type NetworkSpeed, type NetworkType, NewsTicker, type NewsTickerFilter, type NewsTickerFilterOption, type NewsTickerProps, type NewsTickerSort, NotificationCenter, type NotificationCenterProps, type NotificationItem, type NotificationType, type NotificationUser, TrackCard as NowPlayingCard, OfflineWrapper, type OfflineWrapperProps, Onboarding, OptimizedStateManager, type OptimizedStoreOptions, PageHeader, type PageHeaderProps, PageShell, type PageShellProps, PageTransition, type PageTransitionDirection, type PageTransitionProps, type PageTransitionType, Pagination$1 as Pagination, type PaginationConfig, PaginationInfo, type PaginationInfoProps, type PaginationProps$1 as PaginationProps, type PerformanceMetrics, type PieChartProps, Platform, type PlatformConfig, type PlatformSelect, type PlatformSelectMultiple, type PlatformType, type PlaybackQuality, type PlaybackState, type PlaylistActivity, PlaylistBuilder, type PlaylistBuilderProps, PlaylistBuilder as PlaylistCard, type PlaylistData, PlaylistBuilder as PlaylistSidebar, type PlaylistTrack, type PlaylistVisibility, Preloader, type PreloaderProps, PremiumCard, PremiumCardContent, PremiumCardFooter, PremiumCardHeader, type PremiumCardProps, PricingHero, type PricingHeroProps, type PricingPlan, Progress, ProgressiveImage, type ProgressiveImageProps, type ProgressiveImageStrategy, type ProgressiveImageTransition, PullToRefresh, type PullToRefreshProps, PulseIndicator, type PulseIndicatorProps, type PulseStatus, QuickForm, type RefreshState, type RepeatMode, type ResponsiveColumns, ResponsiveFlex, ResponsiveGrid, type ResponsiveGridProps, ResponsiveHeader, type ResponsiveHeaderProps, RevenueKPI, SafeAreaWrapper, ScrollProgressBar, type ScrollProgressBarProps, ScrollProgressLine, type ScrollProgressLineProps, ScrollToTop, type ScrollToTopProps, type SearchCategory, type SearchFilters, type SearchResult, type SearchSortBy, type SearchSuggestion, SearchWithFilters, type SearchWithFiltersProps, Section$1 as Section, SectionBlock, type SectionBlockProps, SectionLabel, type SectionLabelProps, SectionTitle, Select, SelectContent, SelectGroup, SelectItem, SelectLabel, SelectScrollDownButton, SelectScrollUpButton, SelectSeparator, SelectTrigger, SelectValue, type SelectionConfig, SettingsLayout, type ShareOption, Sidebar, SimpleHero, SimpleResponsiveHeader, type Size, Skeleton, SkeletonAvatar, SkeletonButton, SkeletonCard, SkeletonText, Slider, type SliderProps, type SocialAction, SocialActions, type SocialActionsProps, type SocialLinks, type SortConfig, type SpacingScale, Stack, SuccessAnimation, type SuccessAnimationProps, SuccessCheckmark, type SwipeAction, SwipeableCard, type SwipeableCardProps, Switch, type SwitchProps, THEME_COLORS, type TabItem$1 as TabItem, TabNavigation, type TabNavigationProps, Tabs$1 as Tabs, TabsContent, TabsList, TabsTrigger, Textarea, type TextareaProps, type Theme, type ThemeColors, ThemeProvider, ThemeToggle, type ThemeToggleProps, Toast$1 as Toast, ToastAction, type ToastActionElement, ToastClose, ToastDescription, ToastIcon, type ToastIconProps, type ToastProps, ToastProvider, ToastTitle, type ToastVariant, ToastViewport, Toaster, Tooltip$1 as Tooltip, TooltipContent, type TooltipProps$1 as TooltipProps, TooltipProvider, TooltipRoot, TooltipTrigger, TouchInput, type TouchInputProps, Tour, Tooltip as TourTooltip, type Track, TrackCard, type TrackCardProps, AudioFeed as TrackList, type TrendingSection, type TrendingTrack, TrendingTracks, type TrendingTracksProps, type TutorialAction, TutorialEmbed, type TutorialEmbedProps, TutorialGallery, type TutorialGalleryProps, type TutorialMedia, type TutorialMetadata, TutorialSequence, type TutorialSequenceProps, type TutorialStep, type UseIntersectionObserverResult, type UsePerformanceObserverOptions, UserProfile, type UserProfileData, type UserProfileProps, type UserStats, UsersKPI, VARIANT_ICONS, type Variant, type VideoAuthor, type VideoChapter, VideoPlayer, type VideoPlayerProps, type VideoQuality, type VideoSubtitle, type VideoTrack, VirtualScrollList, type VirtualScrollListProps, type VirtualizationConfig, type VirtualizedItem, type VisualizerType, WarningAnimation, type WaveformData, WaveformPlayer, type WaveformPlayerProps, type WebComponentProps, type WebStyle, WelcomeModal, Z_INDEX, accordionVariants, animationPresets, audioAppTabs, audioPlayerVariants, breadcrumbsVariants, cn, commonValidators, containerVariants, contentVariants, createDataStore, createFormStore, createOptimizedStore, cssAnimations, dailyTrendingConfig, detectAuthProvider, disableScroll, durations, emptyStateVariants, enableScroll, fadeInOut, formVariants, formatCurrency, formatDate, formatNumber, genreChartsConfigs, getConfig, getEnvInfo, getEnvVar, getScrollbarWidth, gridVariants, hamburgerVariants, headerVariants, heroVariants, inputVariants, isBrowser, isExpo, isNative, isWeb, labelVariants, musicAppTabs, nativeConfig, podcastAppTabs, scaleInOut, slideUp, sliderVariants, stateManager, stickyActionsVariants, switchVariants, textareaVariants, theme, themes, timingFunctions, toast, toastVariants, useAnimationTokens, useCache, useClickOutside, useCustomPerformanceTracking, useDebouncedCallback, useEscapeKey, useGlassmorphism, useInfiniteScroll, useIntersectionObserver, useLazyLoad, useLockBody, useMediaQuery, useMobileNavigation, useMounted, useNetworkInfo, useOfflineState, useOptimizedMemo, useOptimizedStoreSelector, usePerformanceObserver, useRenderPerformanceTracking, useTheme, useThrottledCallback, useToast, useVirtualization, useVisibilityTracking, validateEmail, validateEnvConfig, validatePassword, videoPlayerVariants, webAnimations, webConfig, weeklyChartsConfig, withNetworkAware, withPageTransition };