shadcn-glass-ui 1.0.0

package/dist/index.d.ts

@@ -0,0 +1,1761 @@
+import { ButtonHTMLAttributes } from 'react';
+import { ClassProp } from 'class-variance-authority/types';
+import { ClassValue } from 'clsx';
+import { FC } from 'react';
+import { FocusEvent as FocusEvent_2 } from 'react';
+import { ForwardRefExoticComponent } from 'react';
+import { HTMLAttributes } from 'react';
+import { InputHTMLAttributes } from 'react';
+import { JSX } from 'react/jsx-runtime';
+import { KeyboardEvent as KeyboardEvent_2 } from 'react';
+import { LucideIcon } from 'lucide-react';
+import { MouseEvent as MouseEvent_2 } from 'react';
+import * as React_2 from 'react';
+import { ReactNode } from 'react';
+import { RefAttributes } from 'react';
+import { VariantProps } from 'class-variance-authority';
+
+export declare const AICardGlass: ForwardRefExoticComponent<AICardGlassProps & RefAttributes<HTMLDivElement>>;
+
+declare interface AICardGlassProps extends React.HTMLAttributes<HTMLDivElement> {
+    readonly onGenerate?: () => void;
+    readonly features?: readonly string[];
+    readonly estimatedTime?: string;
+}
+
+export declare const AlertGlass: ForwardRefExoticComponent<AlertGlassProps & RefAttributes<HTMLDivElement>>;
+
+export declare interface AlertGlassProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'style' | 'title'>, VariantProps<typeof alertVariants> {
+    readonly title?: string;
+    readonly children: ReactNode;
+    readonly dismissible?: boolean;
+    readonly onDismiss?: () => void;
+}
+
+export declare type AlertType = AlertVariant;
+
+/**
+ * AlertGlass CVA Variants
+ * Extracted for Fast Refresh compatibility
+ */
+export declare type AlertVariant = 'default' | 'destructive' | 'success' | 'warning' | 'info' | 'error';
+
+export declare const alertVariants: (props?: ({
+    variant?: "default" | "destructive" | "success" | "warning" | "info" | "error" | null | undefined;
+} & ClassProp) | undefined) => string;
+
+export declare const AvatarGlass: ForwardRefExoticComponent<AvatarGlassProps & RefAttributes<HTMLDivElement>>;
+
+/**
+ * Props for the AvatarGlass component
+ *
+ * A glass-themed avatar component with status indicators and size variants.
+ * Displays user initials with theme-aware styling and optional status badge.
+ *
+ * @example
+ * ```tsx
+ * // Basic avatar
+ * <AvatarGlass name="John Doe" />
+ *
+ * // With status indicator
+ * <AvatarGlass name="Jane Smith" status="online" size="lg" />
+ *
+ * // Different sizes
+ * <AvatarGlass name="Alex" size="sm" />
+ * <AvatarGlass name="Sam" size="xl" />
+ *
+ * // As a link (asChild pattern)
+ * <AvatarGlass asChild name="Sarah Connor" status="online">
+ *   <a href="/profile/sarah">View Profile</a>
+ * </AvatarGlass>
+ * ```
+ */
+export declare interface AvatarGlassProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'style'>, VariantProps<typeof avatarSizes> {
+    /**
+     * Render as child element instead of div (polymorphic rendering).
+     * Useful for making avatars clickable links.
+     * @default false
+     * @example
+     * ```tsx
+     * <AvatarGlass asChild name="John">
+     *   <a href="/profile">View Profile</a>
+     * </AvatarGlass>
+     * ```
+     */
+    readonly asChild?: boolean;
+    /**
+     * Full name of the user. Automatically generates initials (first 2 letters).
+     * @example "John Doe" → "JD"
+     */
+    readonly name: string;
+    /**
+     * Optional status indicator with glow effect
+     * @default undefined
+     */
+    readonly status?: AvatarStatus;
+    /**
+     * Size variant of the avatar
+     * @default "md"
+     */
+    readonly size?: 'sm' | 'md' | 'lg' | 'xl';
+}
+
+/**
+ * AvatarGlass CVA Variants
+ * Extracted for Fast Refresh compatibility
+ */
+export declare type AvatarSize = 'sm' | 'md' | 'lg' | 'xl';
+
+export declare const avatarSizes: (props?: ({
+    size?: "sm" | "md" | "lg" | "xl" | null | undefined;
+} & ClassProp) | undefined) => string;
+
+/**
+ * Avatar status indicator type
+ */
+export declare type AvatarStatus = 'online' | 'offline' | 'busy' | 'away';
+
+export declare const BadgeGlass: ForwardRefExoticComponent<BadgeGlassProps & RefAttributes<HTMLSpanElement>>;
+
+export declare interface BadgeGlassProps extends Omit<React.HTMLAttributes<HTMLSpanElement>, 'style'>, VariantProps<typeof badgeVariants> {
+    readonly children: ReactNode;
+    readonly variant?: BadgeVariant;
+    readonly dot?: boolean;
+}
+
+export declare type BadgeSize = 'sm' | 'md' | 'lg';
+
+/**
+ * BadgeGlass CVA Variants
+ * Extracted for Fast Refresh compatibility
+ */
+export declare type BadgeVariant = 'default' | 'secondary' | 'destructive' | 'outline' | 'success' | 'warning' | 'info';
+
+export declare const badgeVariants: (props?: ({
+    size?: "sm" | "md" | "lg" | null | undefined;
+} & ClassProp) | undefined) => string;
+
+export declare const BaseProgressGlass: ForwardRefExoticComponent<BaseProgressGlassProps & RefAttributes<HTMLDivElement>>;
+
+declare interface BaseProgressGlassProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'children'> {
+    readonly value?: number;
+    readonly max?: number;
+    readonly children?: ReactNode | ((percentage: number) => ReactNode);
+}
+
+declare type Breakpoint = keyof typeof BREAKPOINTS;
+
+/**
+ * Tailwind CSS breakpoints
+ * @see https://tailwindcss.com/docs/responsive-design
+ */
+declare const BREAKPOINTS: {
+    readonly xs: 0;
+    readonly sm: 640;
+    readonly md: 768;
+    readonly lg: 1024;
+    readonly xl: 1280;
+    readonly '2xl': 1536;
+};
+
+export declare const ButtonGlass: ForwardRefExoticComponent<ButtonGlassProps & RefAttributes<HTMLButtonElement>>;
+
+/**
+ * Props for the ButtonGlass component
+ *
+ * A glass-themed button with ripple effects, loading states, and icon support.
+ * Features theme-aware styling and hover animations.
+ *
+ * @example
+ * ```tsx
+ * // Basic button
+ * <ButtonGlass variant="primary">Click me</ButtonGlass>
+ *
+ * // With icon
+ * <ButtonGlass icon={Check} iconPosition="left">Save</ButtonGlass>
+ *
+ * // Loading state
+ * <ButtonGlass loading>Processing...</ButtonGlass>
+ *
+ * // Different variants
+ * <ButtonGlass variant="ghost">Cancel</ButtonGlass>
+ * <ButtonGlass variant="success">Confirm</ButtonGlass>
+ *
+ * // As a link (asChild pattern)
+ * <ButtonGlass asChild variant="primary">
+ *   <a href="/dashboard">Go to Dashboard</a>
+ * </ButtonGlass>
+ *
+ * // With Next.js Link
+ * <ButtonGlass asChild variant="ghost">
+ *   <Link href="/settings">Settings</Link>
+ * </ButtonGlass>
+ * ```
+ */
+export declare interface ButtonGlassProps extends Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, 'style'>, VariantProps<typeof buttonGlassVariants> {
+    /**
+     * Render as child element instead of button (polymorphic rendering).
+     * Useful for rendering buttons as links or other interactive elements.
+     *
+     * **Note:** When using `asChild`, decorative effects (ripple, shine, glow)
+     * are disabled to maintain compatibility with Radix UI Slot.
+     * Only styles and event handlers are passed to the child element.
+     *
+     * @default false
+     * @example
+     * ```tsx
+     * <ButtonGlass asChild>
+     *   <a href="/about">About Us</a>
+     * </ButtonGlass>
+     * ```
+     */
+    readonly asChild?: boolean;
+    /**
+     * Visual style variant of the button
+     * @default "primary"
+     */
+    readonly variant?: ButtonGlassVariant;
+    /**
+     * Show loading spinner and disable interactions
+     * @default false
+     */
+    readonly loading?: boolean;
+    /**
+     * Icon component from lucide-react to display
+     * @example icon={Check}
+     */
+    readonly icon?: LucideIcon;
+    /**
+     * Position of the icon relative to button text
+     * @default "left"
+     */
+    readonly iconPosition?: 'left' | 'right';
+    /**
+     * Size variant of the button
+     * @default "md"
+     */
+    readonly size?: 'sm' | 'md' | 'lg' | 'icon';
+}
+
+export declare type ButtonGlassSize = 'sm' | 'md' | 'lg' | 'xl' | 'icon';
+
+/**
+ * ButtonGlass CVA Variants
+ * Extracted for Fast Refresh compatibility
+ */
+export declare type ButtonGlassVariant = 'primary' | 'secondary' | 'ghost' | 'destructive' | 'success' | 'text';
+
+export declare const buttonGlassVariants: (props?: ({
+    variant?: "destructive" | "success" | "text" | "secondary" | "primary" | "ghost" | null | undefined;
+    size?: "sm" | "md" | "lg" | "xl" | "icon" | null | undefined;
+} & ClassProp) | undefined) => string;
+
+export declare const cardIntensity: (props?: ({
+    intensity?: "medium" | "strong" | "subtle" | null | undefined;
+    hover?: boolean | null | undefined;
+    padding?: "default" | "none" | "compact" | "featured" | null | undefined;
+} & ClassProp) | undefined) => string;
+
+export declare const CareerStatsGlass: ForwardRefExoticComponent<CareerStatsGlassProps & RefAttributes<HTMLDivElement>>;
+
+declare interface CareerStatsGlassProps extends React.HTMLAttributes<HTMLDivElement> {
+    readonly totalCommits?: number;
+    readonly totalPRs?: number;
+    readonly totalRepos?: number;
+    readonly years?: readonly YearData[];
+}
+
+export declare const CareerStatsHeaderGlass: ForwardRefExoticComponent<CareerStatsHeaderGlassProps & RefAttributes<HTMLDivElement>>;
+
+declare interface CareerStatsHeaderGlassProps extends HTMLAttributes<HTMLDivElement> {
+    /** Total commits count */
+    readonly totalCommits: number;
+    /** Total pull requests count */
+    readonly totalPRs: number;
+    /** Total repositories count */
+    readonly totalRepos: number;
+    /** Header title */
+    readonly title?: string;
+    /** Stats wrap on mobile */
+    readonly wrapStats?: boolean;
+}
+
+export declare const CheckboxGlass: ForwardRefExoticComponent<CheckboxGlassProps & RefAttributes<HTMLInputElement>>;
+
+export declare interface CheckboxGlassProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, 'onChange'> {
+    readonly checked: boolean;
+    readonly onChange?: (checked: boolean) => void;
+    readonly label?: string;
+}
+
+declare type CircularMetricColor = 'emerald' | 'amber' | 'blue' | 'red';
+
+/**
+ * CircularMetricGlass - Compact circular progress metric display
+ *
+ * Designed for mobile layouts where rectangular MetricCardGlass is too wide.
+ * Shows a circular progress indicator with percentage inside and label below.
+ *
+ * @example
+ * ```tsx
+ * <CircularMetricGlass label="Reg" value={84} color="emerald" />
+ * ```
+ */
+export declare const CircularMetricGlass: ForwardRefExoticComponent<CircularMetricGlassProps & RefAttributes<HTMLDivElement>>;
+
+declare interface CircularMetricGlassProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** Metric label (e.g., "Reg", "Imp") */
+    readonly label: string;
+    /** Metric value (0-100) */
+    readonly value: number;
+    /** Metric color */
+    readonly color?: CircularMetricColor;
+    /** Size variant */
+    readonly size?: 'sm' | 'md';
+}
+
+export declare const CircularProgressGlass: ForwardRefExoticComponent<CircularProgressGlassProps & RefAttributes<HTMLDivElement>>;
+
+declare interface CircularProgressGlassProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'children'>, VariantProps<typeof circularProgressVariants> {
+    /** Progress value (0-100) for determinate variant */
+    readonly value?: number;
+    /** Variant type */
+    readonly variant?: 'determinate' | 'indeterminate';
+    /** Stroke width in pixels */
+    readonly thickness?: number;
+    /** Background track width in pixels */
+    readonly trackWidth?: number;
+    /** Progress color gradient */
+    readonly color?: CircularProgressGradient;
+    /** Track color (background circle) */
+    readonly trackColor?: string;
+    /** Show percentage label in center */
+    readonly showLabel?: boolean;
+    /** Custom label text (overrides percentage) */
+    readonly label?: string;
+    /** Custom color for the center label text */
+    readonly labelColor?: string;
+    /** Show glow effect */
+    readonly showGlow?: boolean;
+    /** Glow intensity */
+    readonly glowIntensity?: 'low' | 'medium' | 'high';
+    /** Stroke linecap style */
+    readonly strokeLinecap?: 'round' | 'butt' | 'square';
+    /** Animation duration in seconds */
+    readonly animationDuration?: number;
+}
+
+declare type CircularProgressGradient = 'violet' | 'blue' | 'cyan' | 'amber' | 'emerald' | 'rose';
+
+declare const circularProgressVariants: (props?: ({
+    size?: "sm" | "md" | "lg" | "xl" | null | undefined;
+} & ClassProp) | undefined) => string;
+
+/**
+ * Combine class names with Tailwind merge support (shadcn standard)
+ * @param inputs - Array of class values
+ * @returns Merged class string
+ */
+export declare const cn: (...inputs: ClassValue[]) => string;
+
+export declare const ComboBoxGlass: <T = string>(props: ComboBoxGlassProps<T> & {
+    ref?: React.ForwardedRef<HTMLButtonElement>;
+}) => ReturnType<typeof ComboBoxGlassInner>;
+
+declare function ComboBoxGlassInner<T = string>({ options, value, onChange, placeholder, emptyText, searchPlaceholder, glassVariant, disabled, className, popoverClassName, clearable, side, align, label, error, success, required, size, searchable, icon: TriggerIcon, }: ComboBoxGlassProps<T>, ref: React.ForwardedRef<HTMLButtonElement>): JSX.Element;
+
+declare namespace ComboBoxGlassInner {
+    var displayName: string;
+}
+
+declare interface ComboBoxGlassProps<T = string> {
+    /** Available options */
+    readonly options: readonly ComboBoxOption<T>[];
+    /** Currently selected value */
+    readonly value?: T;
+    /** Callback when value changes */
+    readonly onChange?: (value: T | undefined) => void;
+    /** Placeholder text for trigger button */
+    readonly placeholder?: string;
+    /** Text shown when no results found */
+    readonly emptyText?: string;
+    /** Placeholder for search input */
+    readonly searchPlaceholder?: string;
+    /** Glass variant style */
+    readonly glassVariant?: GlassVariant;
+    /** Disabled state */
+    readonly disabled?: boolean;
+    /** Custom className for container */
+    readonly className?: string;
+    /** Custom className for popover content */
+    readonly popoverClassName?: string;
+    /** Allow clearing selection */
+    readonly clearable?: boolean;
+    /** Popover side */
+    readonly side?: 'top' | 'right' | 'bottom' | 'left';
+    /** Popover alignment */
+    readonly align?: 'start' | 'center' | 'end';
+    /** Label text displayed above the field */
+    readonly label?: string;
+    /** Error message - displays in red below the field */
+    readonly error?: string;
+    /** Success message - displays in green if no error */
+    readonly success?: string;
+    /** Shows required asterisk (*) next to label */
+    readonly required?: boolean;
+    /** Size variant (affects trigger button height and padding) */
+    readonly size?: InputGlassSize;
+    /** Enable/disable search functionality */
+    readonly searchable?: boolean;
+    /** Optional icon for trigger button (displayed before text) */
+    readonly icon?: LucideIcon;
+}
+
+declare interface ComboBoxOption<T = string> {
+    readonly value: T;
+    readonly label: string;
+    readonly disabled?: boolean;
+    /** Optional icon component for the option */
+    readonly icon?: LucideIcon;
+}
+
+export declare const ContributionMetricsGlass: ForwardRefExoticComponent<ContributionMetricsGlassProps & RefAttributes<HTMLDivElement>>;
+
+declare interface ContributionMetricsGlassProps extends HTMLAttributes<HTMLDivElement> {
+    /** User's commit count */
+    readonly userCommits: number;
+    /** User's contribution percentage */
+    readonly userContribution: number;
+    /** Total project commits (calculated if not provided) */
+    readonly totalProjectCommits?: number;
+    /** Estimated lines of code */
+    readonly estimatedLines?: number;
+    /** Grid layout (1 or 2 columns) */
+    readonly columns?: 1 | 2;
+}
+
+/**
+ * DropdownGlass CVA Variants
+ * Extracted for Fast Refresh compatibility
+ */
+export declare type DropdownAlign = 'left' | 'right';
+
+export declare const dropdownAlign: (props?: ({
+    align?: "left" | "right" | null | undefined;
+} & ClassProp) | undefined) => string;
+
+export declare const DropdownGlass: React_2.ForwardRefExoticComponent<DropdownGlassProps & React_2.RefAttributes<HTMLDivElement>>;
+
+export declare interface DropdownGlassProps {
+    readonly trigger: React_2.ReactNode;
+    readonly items: readonly DropdownItem[];
+    readonly align?: 'left' | 'right';
+    readonly className?: string;
+}
+
+export declare interface DropdownItem {
+    readonly label?: string;
+    readonly icon?: LucideIcon;
+    readonly onClick?: () => void;
+    readonly danger?: boolean;
+    readonly divider?: boolean;
+}
+
+export declare const ExpandableHeaderGlass: ForwardRefExoticComponent<ExpandableHeaderGlassProps & RefAttributes<HTMLButtonElement>>;
+
+declare interface ExpandableHeaderGlassProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'title'> {
+    /** Header title */
+    readonly title: ReactNode;
+    /** Leading icon component */
+    readonly icon?: LucideIcon;
+    /** Icon color (CSS variable or color value) */
+    readonly iconColor?: string;
+    /** Expanded state */
+    readonly expanded: boolean;
+    /** Toggle callback */
+    readonly onToggle?: () => void;
+}
+
+export declare const FlagAlertGlass: ForwardRefExoticComponent<FlagAlertGlassProps & RefAttributes<HTMLDivElement>>;
+
+declare interface FlagAlertGlassProps extends React.HTMLAttributes<HTMLDivElement> {
+    readonly type?: FlagType;
+    readonly title: string;
+    readonly description?: string;
+}
+
+declare interface FlagData {
+    readonly type: FlagType;
+    readonly title: string;
+    readonly description?: string;
+}
+
+export declare const FlagsSectionGlass: ForwardRefExoticComponent<FlagsSectionGlassProps & RefAttributes<HTMLDivElement>>;
+
+declare interface FlagsSectionGlassProps extends React.HTMLAttributes<HTMLDivElement> {
+    readonly flags?: readonly FlagData[];
+    readonly expanded?: boolean;
+    readonly onToggle?: () => void;
+}
+
+declare type FlagType = "warning" | "danger";
+
+/**
+ * FormFieldWrapper component
+ *
+ * Provides consistent structure for form fields with labels and validation messages.
+ * Used by InputGlass, SliderGlass, and other form components.
+ *
+ * @example
+ * ```tsx
+ * // Basic usage
+ * <FormFieldWrapper label="Email" htmlFor="email-input">
+ *   <input id="email-input" type="email" />
+ * </FormFieldWrapper>
+ *
+ * // With validation
+ * <FormFieldWrapper
+ *   label="Username"
+ *   error="Username is required"
+ *   required
+ *   htmlFor="username"
+ * >
+ *   <input id="username" />
+ * </FormFieldWrapper>
+ *
+ * // Success state
+ * <FormFieldWrapper
+ *   label="Password"
+ *   success="Strong password"
+ *   htmlFor="password"
+ * >
+ *   <input id="password" type="password" />
+ * </FormFieldWrapper>
+ * ```
+ */
+export declare const FormFieldWrapper: ForwardRefExoticComponent<FormFieldWrapperProps & RefAttributes<HTMLDivElement>>;
+
+/**
+ * Props for the FormFieldWrapper component
+ */
+declare interface FormFieldWrapperProps extends HTMLAttributes<HTMLDivElement> {
+    /**
+     * Label text displayed above the field
+     */
+    label?: string;
+    /**
+     * Error message - takes priority over success
+     * Displays in red below the field
+     */
+    error?: string;
+    /**
+     * Success message - displays in green if no error
+     * Displays below the field
+     */
+    success?: string;
+    /**
+     * ID to link label with input via htmlFor
+     * Should match the input's id attribute
+     */
+    htmlFor?: string;
+    /**
+     * Shows red asterisk (*) next to label
+     * @default false
+     */
+    required?: boolean;
+    /**
+     * The form control element(s) to wrap
+     */
+    children: ReactNode;
+}
+
+export declare function getNextTheme(current: Theme): Theme;
+
+export declare function getThemeConfig(theme: Theme): ThemeConfig;
+
+export declare const GlassCard: ForwardRefExoticComponent<GlassCardProps & RefAttributes<HTMLDivElement>>;
+
+/**
+ * Props for the GlassCard component
+ *
+ * @example
+ * ```tsx
+ * // Basic card
+ * <GlassCard intensity="medium">Content</GlassCard>
+ *
+ * // As a clickable link
+ * <GlassCard asChild intensity="medium">
+ *   <a href="/details">View Details</a>
+ * </GlassCard>
+ * ```
+ */
+export declare interface GlassCardProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'style'>, VariantProps<typeof cardIntensity> {
+    /**
+     * Render as child element instead of div (polymorphic rendering).
+     * Useful for making cards clickable links or custom interactive elements.
+     * @default false
+     * @example
+     * ```tsx
+     * <GlassCard asChild>
+     *   <a href="/article">Article Content</a>
+     * </GlassCard>
+     * ```
+     */
+    readonly asChild?: boolean;
+    readonly children: ReactNode;
+    readonly glow?: GlowType;
+    readonly padding?: PaddingType;
+}
+
+declare type GlassVariant = 'glass' | 'frosted' | 'fluted' | 'crystal';
+
+/**
+ * GlassCard CVA Variants
+ * Extracted for Fast Refresh compatibility
+ */
+export declare type GlowType = 'blue' | 'violet' | 'cyan' | null;
+
+export declare const HeaderBrandingGlass: ForwardRefExoticComponent<HeaderBrandingGlassProps & RefAttributes<HTMLDivElement>>;
+
+declare interface HeaderBrandingGlassProps extends HTMLAttributes<HTMLDivElement> {
+    /** Logo icon component */
+    readonly logoIcon: LucideIcon;
+    /** Main title */
+    readonly title: string;
+    /** Subtitle (hidden on mobile) */
+    readonly subtitle?: string;
+    /** Logo click handler */
+    readonly onLogoClick?: () => void;
+    /** Logo aria label */
+    readonly logoAriaLabel?: string;
+}
+
+export declare const HeaderNavGlass: ForwardRefExoticComponent<HeaderNavGlassProps & RefAttributes<HTMLElement>>;
+
+declare interface HeaderNavGlassProps extends React.HTMLAttributes<HTMLElement> {
+    readonly username?: string;
+    readonly onSearch?: (value: string) => void;
+    readonly onThemeToggle?: () => void;
+}
+
+export declare const IconButtonGlass: ForwardRefExoticComponent<IconButtonGlassProps & RefAttributes<HTMLButtonElement>>;
+
+declare interface IconButtonGlassProps extends ButtonHTMLAttributes<HTMLButtonElement>, VariantProps<typeof iconButtonVariants> {
+    /** Lucide icon component */
+    readonly icon: LucideIcon;
+    /** Icon size in pixels (default: 20) */
+    readonly iconSize?: number;
+    /** Accessible label for screen readers */
+    readonly 'aria-label': string;
+}
+
+declare const iconButtonVariants: (props?: ({
+    size?: "sm" | "md" | "lg" | "touch" | null | undefined;
+    variant?: "ghost" | "subtle" | "gradient" | null | undefined;
+} & ClassProp) | undefined) => string;
+
+export declare const InputGlass: ForwardRefExoticComponent<InputGlassProps & RefAttributes<HTMLInputElement>>;
+
+/**
+ * Props for the InputGlass component
+ *
+ * A glass-themed input field with labels, validation states, and icon support.
+ * Features focus glow effects and theme-aware styling.
+ *
+ * @example
+ * ```tsx
+ * // Basic input with label
+ * <InputGlass label="Email" placeholder="you@example.com" />
+ *
+ * // With validation states
+ * <InputGlass label="Username" error="Username is required" />
+ * <InputGlass label="Password" success="Strong password" type="password" />
+ *
+ * // With icon
+ * <InputGlass icon={Search} placeholder="Search..." />
+ * <InputGlass icon={Mail} iconPosition="right" />
+ * ```
+ */
+export declare interface InputGlassProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'size'>, VariantProps<typeof inputVariants> {
+    /**
+     * Label text displayed above the input field
+     */
+    readonly label?: string;
+    /**
+     * Error message to display below the input (red styling)
+     */
+    readonly error?: string;
+    /**
+     * Success message to display below the input (green styling)
+     */
+    readonly success?: string;
+    /**
+     * Icon component from lucide-react to display
+     * @example icon={Search}
+     */
+    readonly icon?: LucideIcon;
+    /**
+     * Position of the icon relative to input text
+     * @default "left"
+     */
+    readonly iconPosition?: 'left' | 'right';
+    /**
+     * @deprecated Use `size` prop instead. Will be removed in v4.0
+     * @default "md"
+     */
+    readonly inputSize?: 'sm' | 'md' | 'lg';
+}
+
+/**
+ * InputGlass CVA Variants
+ * Extracted for Fast Refresh compatibility
+ */
+export declare type InputGlassSize = 'sm' | 'md' | 'lg';
+
+export declare const inputVariants: (props?: ({
+    size?: "sm" | "md" | "lg" | null | undefined;
+} & ClassProp) | undefined) => string;
+
+export declare type IntensityType = 'subtle' | 'medium' | 'strong';
+
+/**
+ * InteractiveCard component
+ *
+ * Provides consistent hover animations and glass effects for card components.
+ * Replaces ~80 lines of duplicated hover state management across 4+ components.
+ *
+ * @example
+ * ```tsx
+ * // Basic usage
+ * <InteractiveCard>
+ *   <h3>Card Title</h3>
+ *   <p>Card content</p>
+ * </InteractiveCard>
+ *
+ * // With hover effects
+ * <InteractiveCard
+ *   hoverLift
+ *   hoverGlow="var(--glow-primary)"
+ *   hoverBg="var(--card-hover-bg)"
+ *   hoverBorderColor="var(--card-hover-border)"
+ * >
+ *   <MetricContent />
+ * </InteractiveCard>
+ *
+ * // Custom blur and rounding
+ * <InteractiveCard
+ *   blur="md"
+ *   rounded="rounded-3xl"
+ *   baseBg="var(--metric-emerald-bg)"
+ * >
+ *   <StatusCard />
+ * </InteractiveCard>
+ * ```
+ */
+export declare const InteractiveCard: ForwardRefExoticComponent<InteractiveCardProps & RefAttributes<HTMLDivElement>>;
+
+/**
+ * Props for the InteractiveCard component
+ */
+declare interface InteractiveCardProps extends HTMLAttributes<HTMLDivElement> {
+    /**
+     * Enable hover lift effect (translateY -2px)
+     * @default true
+     */
+    hoverLift?: boolean;
+    /**
+     * CSS variable for hover glow effect
+     * @example 'var(--glow-primary)'
+     */
+    hoverGlow?: string;
+    /**
+     * CSS variable for hover background
+     * @example 'var(--card-hover-bg)'
+     */
+    hoverBg?: string;
+    /**
+     * CSS variable for base background
+     * @default 'var(--card-bg)'
+     */
+    baseBg?: string;
+    /**
+     * CSS variable for border color
+     * @default 'var(--card-border)'
+     */
+    borderColor?: string;
+    /**
+     * CSS variable for hover border color
+     */
+    hoverBorderColor?: string;
+    /**
+     * Blur level for glass effect
+     * @default 'sm'
+     */
+    blur?: 'sm' | 'md' | 'lg' | 'xl';
+    /**
+     * Disable all hover interactions
+     * @default false
+     */
+    disabled?: boolean;
+    /**
+     * Border radius class
+     * @default 'rounded-2xl'
+     */
+    rounded?: 'rounded-xl' | 'rounded-2xl' | 'rounded-3xl';
+    /**
+     * Transition speed
+     * @default 'var(--transition-slow)'
+     */
+    transition?: string;
+}
+
+export declare const LanguageBarGlass: ForwardRefExoticComponent<LanguageBarGlassProps & RefAttributes<HTMLDivElement>>;
+
+declare interface LanguageBarGlassProps extends React.HTMLAttributes<HTMLDivElement> {
+    readonly languages: readonly LanguageData[];
+    readonly showLegend?: boolean;
+}
+
+declare interface LanguageData {
+    readonly name: string;
+    readonly percent: number;
+    readonly color?: string;
+}
+
+export declare const MetricCardGlass: ForwardRefExoticComponent<MetricCardGlassProps & RefAttributes<HTMLDivElement>>;
+
+declare interface MetricCardGlassProps extends React.HTMLAttributes<HTMLDivElement> {
+    readonly label: string;
+    readonly value: number;
+    readonly color?: MetricColor;
+}
+
+declare type MetricColor = "emerald" | "amber" | "blue" | "red";
+
+declare interface MetricData {
+    readonly label: string;
+    readonly value: number;
+    readonly color: MetricColor;
+}
+
+declare interface MetricData_2 {
+    readonly label: string;
+    readonly value: number;
+    readonly color: MetricColor;
+}
+
+export declare const MetricsGridGlass: ForwardRefExoticComponent<MetricsGridGlassProps & RefAttributes<HTMLDivElement>>;
+
+declare interface MetricsGridGlassProps extends HTMLAttributes<HTMLDivElement> {
+    /** Array of metrics to display */
+    readonly metrics: readonly MetricData[];
+    /** Number of columns on desktop (1-6) */
+    readonly columns?: 1 | 2 | 3 | 4 | 5 | 6;
+    /** Gap size */
+    readonly gap?: 'sm' | 'md' | 'lg';
+}
+
+declare interface ModalBodyProps {
+    children: ReactNode;
+    className?: string;
+}
+
+declare interface ModalCloseProps {
+    className?: string;
+}
+
+declare interface ModalContentProps {
+    children: ReactNode;
+    className?: string;
+}
+
+declare interface ModalDescriptionProps {
+    children: ReactNode;
+    className?: string;
+}
+
+declare interface ModalFooterProps {
+    children: ReactNode;
+    className?: string;
+}
+
+/**
+ * ModalGlass - Compound Component API
+ *
+ * @example
+ * ```tsx
+ * <ModalGlass.Root open={open} onOpenChange={setOpen}>
+ *   <ModalGlass.Overlay />
+ *   <ModalGlass.Content>
+ *     <ModalGlass.Header>
+ *       <ModalGlass.Title>Confirm</ModalGlass.Title>
+ *       <ModalGlass.Description>Are you sure?</ModalGlass.Description>
+ *       <ModalGlass.Close />
+ *     </ModalGlass.Header>
+ *     <ModalGlass.Body>
+ *       <p>Body content</p>
+ *     </ModalGlass.Body>
+ *     <ModalGlass.Footer>
+ *       <ButtonGlass>Cancel</ButtonGlass>
+ *     </ModalGlass.Footer>
+ *   </ModalGlass.Content>
+ * </ModalGlass.Root>
+ * ```
+ */
+export declare const ModalGlass: {
+    Root: FC<ModalRootProps>;
+    Overlay: FC<ModalOverlayProps>;
+    Content: ForwardRefExoticComponent<ModalContentProps & RefAttributes<HTMLDivElement>>;
+    Header: FC<ModalHeaderProps>;
+    Body: FC<ModalBodyProps>;
+    Footer: FC<ModalFooterProps>;
+    Title: FC<ModalTitleProps>;
+    Description: FC<ModalDescriptionProps>;
+    Close: FC<ModalCloseProps>;
+};
+
+declare interface ModalHeaderProps {
+    children: ReactNode;
+    className?: string;
+}
+
+declare interface ModalOverlayProps {
+    className?: string;
+}
+
+declare interface ModalRootProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** Open state */
+    open: boolean;
+    /** Callback when open state changes */
+    onOpenChange?: (open: boolean) => void;
+    /** Size variant */
+    size?: ModalSize;
+    /** Child components */
+    children: ReactNode;
+}
+
+/**
+ * ModalGlass CVA Variants
+ * Extracted for Fast Refresh compatibility
+ */
+export declare type ModalSize = 'sm' | 'md' | 'lg' | 'xl' | 'full';
+
+export declare const modalSizes: (props?: ({
+    size?: "sm" | "md" | "lg" | "xl" | "full" | null | undefined;
+} & ClassProp) | undefined) => string;
+
+declare interface ModalTitleProps {
+    children: ReactNode;
+    className?: string;
+}
+
+export declare const NotificationGlass: ForwardRefExoticComponent<NotificationGlassProps & RefAttributes<HTMLDivElement>>;
+
+export declare interface NotificationGlassProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'title' | 'style'>, VariantProps<typeof notificationVariants> {
+    readonly title: string;
+    readonly message: string;
+    /** Notification variant (shadcn/ui compatible) */
+    readonly variant?: 'default' | 'destructive' | 'success' | 'warning';
+    /** @deprecated Use variant prop instead. Will be removed in next major version. */
+    readonly type?: NotificationType;
+    readonly onClose: () => void;
+}
+
+/**
+ * NotificationGlass CVA Variants
+ * Extracted for Fast Refresh compatibility
+ */
+export declare type NotificationType = 'info' | 'success' | 'warning' | 'error';
+
+export declare const notificationVariants: (props?: ({
+    type?: "success" | "warning" | "info" | "error" | null | undefined;
+} & ClassProp) | undefined) => string;
+
+declare type OwnershipFilter = 'your' | 'contrib' | 'all';
+
+export declare type PaddingType = 'none' | 'compact' | 'default' | 'featured';
+
+export declare const PopoverGlass: React_2.ForwardRefExoticComponent<PopoverGlassProps & React_2.RefAttributes<HTMLDivElement>>;
+
+declare interface PopoverGlassProps {
+    /** The trigger element that opens the popover */
+    readonly trigger: React_2.ReactNode;
+    /** The content to display inside the popover */
+    readonly children: React_2.ReactNode;
+    /** The preferred side of the trigger to render against */
+    readonly side?: 'top' | 'right' | 'bottom' | 'left';
+    /** The preferred alignment against the trigger */
+    readonly align?: 'start' | 'center' | 'end';
+    /** The distance in pixels from the trigger */
+    readonly sideOffset?: number;
+    /** Controlled open state */
+    readonly open?: boolean;
+    /** Callback when open state changes */
+    readonly onOpenChange?: (open: boolean) => void;
+    /** Whether to show the arrow pointer */
+    readonly showArrow?: boolean;
+    /** Additional class name for the content wrapper */
+    readonly className?: string;
+}
+
+export declare const ProfileAvatarGlass: ForwardRefExoticComponent<ProfileAvatarGlassProps & RefAttributes<HTMLDivElement>>;
+
+declare interface ProfileAvatarGlassProps extends React.HTMLAttributes<HTMLDivElement> {
+    readonly initials: string;
+    readonly size?: ProfileAvatarSize;
+    readonly status?: ProfileAvatarStatus;
+    readonly glowing?: boolean;
+}
+
+declare type ProfileAvatarSize = "sm" | "md" | "lg" | "xl";
+
+declare type ProfileAvatarStatus = "online" | "offline" | "busy" | "away";
+
+export declare const ProfileHeaderGlass: ForwardRefExoticComponent<ProfileHeaderGlassProps & RefAttributes<HTMLDivElement>>;
+
+declare interface ProfileHeaderGlassProps extends React.HTMLAttributes<HTMLDivElement> {
+    readonly name?: string;
+    readonly username?: string;
+    readonly joinDate?: string;
+    readonly stats?: ProfileStats;
+    readonly languages?: readonly LanguageData[];
+    readonly onAIGenerate?: () => void;
+}
+
+declare interface ProfileStats {
+    readonly repos?: number;
+    readonly followers?: number;
+    readonly following?: number;
+}
+
+export declare const ProgressGlass: ForwardRefExoticComponent<ProgressGlassProps & RefAttributes<HTMLDivElement>>;
+
+export declare interface ProgressGlassProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'style'>, VariantProps<typeof progressSizes> {
+    readonly value: number;
+    readonly gradient?: ProgressGradient;
+    readonly showLabel?: boolean;
+}
+
+export declare type ProgressGradient = 'violet' | 'blue' | 'cyan' | 'amber' | 'emerald' | 'rose';
+
+/**
+ * ProgressGlass CVA Variants
+ * Extracted for Fast Refresh compatibility
+ */
+export declare type ProgressSize = 'sm' | 'md' | 'lg' | 'xl';
+
+export declare const progressSizes: (props?: ({
+    size?: "sm" | "md" | "lg" | "xl" | null | undefined;
+} & ClassProp) | undefined) => string;
+
+export declare const ProjectsListGlass: ForwardRefExoticComponent<ProjectsListGlassProps & RefAttributes<HTMLDivElement>>;
+
+declare interface ProjectsListGlassProps extends React.HTMLAttributes<HTMLDivElement> {
+    /** List of repositories to display */
+    readonly repositories: readonly Repository[];
+    /** Show only flagged (non-green) repositories */
+    readonly showFlaggedOnly?: boolean;
+    /** Filter by creation year */
+    readonly selectedYear?: number | null;
+    /** Callback to clear all filters */
+    readonly onClearFilters?: () => void;
+    /** Custom title (overrides auto-generated) */
+    readonly title?: string;
+    /** Current ownership filter */
+    readonly ownershipFilter?: OwnershipFilter;
+    /** Callback when ownership filter changes */
+    readonly onOwnershipChange?: (filter: OwnershipFilter) => void;
+    /** Current sort field */
+    readonly sortBy?: SortField;
+    /** Current sort order */
+    readonly sortOrder?: SortOrder;
+    /** Callback when sort changes */
+    readonly onSortChange?: (field: SortField, order: SortOrder) => void;
+    /** Show header controls (sort dropdown, ownership filter). Default: true when callbacks provided */
+    readonly showControls?: boolean;
+}
+
+export declare const RainbowProgressGlass: ForwardRefExoticComponent<RainbowProgressGlassProps & RefAttributes<HTMLDivElement>>;
+
+declare interface RainbowProgressGlassProps extends React.HTMLAttributes<HTMLDivElement> {
+    readonly value: number;
+    readonly size?: RainbowProgressSize;
+    readonly showGlow?: boolean;
+}
+
+declare type RainbowProgressSize = "sm" | "md" | "lg" | "xl";
+
+declare interface Repository {
+    readonly name: string;
+    readonly languages: string;
+    readonly commits: number;
+    readonly contribution: number;
+    readonly stars?: number;
+    readonly flagType?: RepositoryFlagType;
+    readonly issues?: readonly string[];
+    readonly createdYear?: number;
+    /** Ownership type for Your/Contrib filtering */
+    readonly ownership?: 'your' | 'contrib';
+}
+
+export declare const RepositoryCardGlass: ForwardRefExoticComponent<RepositoryCardGlassProps & RefAttributes<HTMLDivElement>>;
+
+declare interface RepositoryCardGlassProps extends React.HTMLAttributes<HTMLDivElement> {
+    readonly name: string;
+    readonly languages: string;
+    readonly commits: number;
+    readonly contribution: number;
+    readonly stars?: number;
+    readonly flagType?: RepositoryFlagType;
+    readonly issues?: readonly string[];
+    readonly expanded?: boolean;
+    readonly onToggle?: () => void;
+    readonly onGitHubClick?: () => void;
+    readonly onAIAnalysisClick?: () => void;
+}
+
+declare type RepositoryFlagType = "green" | "yellow" | "red";
+
+declare type RepositoryFlagType_2 = 'green' | 'yellow' | 'red';
+
+export declare const RepositoryHeaderGlass: ForwardRefExoticComponent<RepositoryHeaderGlassProps & RefAttributes<HTMLDivElement>>;
+
+declare interface RepositoryHeaderGlassProps extends HTMLAttributes<HTMLDivElement> {
+    /** Repository name */
+    readonly name: string;
+    /** Flag/status type */
+    readonly flagType?: RepositoryFlagType_2;
+    /** Star count */
+    readonly stars?: number;
+    /** Is expanded state */
+    readonly expanded?: boolean;
+    /** Abbreviated star count for mobile (1.2k instead of 1234) */
+    readonly abbreviatedStars?: boolean;
+}
+
+export declare const RepositoryMetadataGlass: ForwardRefExoticComponent<RepositoryMetadataGlassProps & RefAttributes<HTMLDivElement>>;
+
+declare interface RepositoryMetadataGlassProps extends HTMLAttributes<HTMLDivElement> {
+    /** Programming languages used */
+    readonly languages: string;
+    /** Number of commits */
+    readonly commits: number;
+    /** Contribution percentage */
+    readonly contribution: number;
+    /** Stacked layout for mobile */
+    readonly stacked?: boolean;
+}
+
+export declare const SearchBoxGlass: ForwardRefExoticComponent<SearchBoxGlassProps & RefAttributes<HTMLInputElement>>;
+
+declare interface SearchBoxGlassProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'onSubmit' | 'onChange'> {
+    /** Callback when search is submitted (Enter key or button click) */
+    readonly onSubmit?: (value: string) => void;
+    /** Initial search value */
+    readonly defaultValue?: string;
+    /** Controlled value */
+    readonly value?: string;
+    /** Controlled change handler */
+    readonly onChange?: (value: string) => void;
+    /** Compact variant for mobile (icon only button) */
+    readonly variant?: 'default' | 'compact';
+    /** Input width class (default: w-48) */
+    readonly inputWidth?: string;
+}
+
+export declare const SegmentedControlGlass: ForwardRefExoticComponent<SegmentedControlGlassProps & RefAttributes<HTMLDivElement>>;
+
+declare interface SegmentedControlGlassProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "onChange"> {
+    readonly options: readonly SegmentOption[];
+    readonly value: string;
+    readonly onChange?: (value: string) => void;
+}
+
+declare interface SegmentOption {
+    readonly value: string;
+    readonly label: string;
+}
+
+/**
+ * Alert CVA Variants (shadcn/ui)
+ * Extracted for Fast Refresh compatibility
+ */
+export declare const shadcnAlertVariants: (props?: ({
+    variant?: "default" | "destructive" | null | undefined;
+} & ClassProp) | undefined) => string;
+
+/**
+ * Badge CVA Variants (shadcn/ui)
+ * Extracted for Fast Refresh compatibility
+ */
+export declare const shadcnBadgeVariants: (props?: ({
+    variant?: "default" | "destructive" | "secondary" | "outline" | null | undefined;
+} & ClassProp) | undefined) => string;
+
+/**
+ * Button CVA Variants (shadcn/ui)
+ * Extracted for Fast Refresh compatibility
+ */
+export declare const shadcnButtonVariants: (props?: ({
+    variant?: "default" | "destructive" | "link" | "secondary" | "outline" | "ghost" | null | undefined;
+    size?: "default" | "sm" | "lg" | "icon" | "icon-sm" | "icon-lg" | null | undefined;
+} & ClassProp) | undefined) => string;
+
+export declare const SkeletonGlass: ForwardRefExoticComponent<SkeletonGlassProps & RefAttributes<HTMLDivElement>>;
+
+export declare interface SkeletonGlassProps extends React.HTMLAttributes<HTMLDivElement>, VariantProps<typeof skeletonVariants> {
+    readonly width?: string | number;
+    readonly height?: string | number;
+}
+
+/**
+ * SkeletonGlass CVA Variants
+ * Extracted for Fast Refresh compatibility
+ */
+export declare type SkeletonVariant = 'text' | 'title' | 'avatar' | 'thumbnail' | 'card';
+
+export declare const skeletonVariants: (props?: ({
+    variant?: "title" | "text" | "avatar" | "thumbnail" | "card" | null | undefined;
+} & ClassProp) | undefined) => string;
+
+export declare const SliderGlass: ForwardRefExoticComponent<SliderGlassProps & RefAttributes<HTMLInputElement>>;
+
+export declare interface SliderGlassProps extends Omit<React.InputHTMLAttributes<HTMLInputElement>, 'onChange' | 'value'> {
+    readonly value: number;
+    readonly onChange: (value: number) => void;
+    readonly min?: number;
+    readonly max?: number;
+    readonly step?: number;
+    readonly showValue?: boolean;
+    readonly label?: string;
+    readonly error?: string;
+    readonly success?: string;
+}
+
+export declare const SortDropdownGlass: ForwardRefExoticComponent<SortDropdownGlassProps & RefAttributes<HTMLDivElement>>;
+
+declare interface SortDropdownGlassProps extends Omit<React.HTMLAttributes<HTMLDivElement>, 'onChange'> {
+    /** Current sort field */
+    readonly sortBy: SortField;
+    /** Current sort order */
+    readonly sortOrder: SortOrder;
+    /** Callback when sort changes */
+    readonly onSortChange: (field: SortField, order: SortOrder) => void;
+    /** Available sort options (default: all) */
+    readonly options?: readonly SortField[];
+    /** Compact mode for mobile */
+    readonly compact?: boolean;
+}
+
+declare type SortField = 'commits' | 'stars' | 'name' | 'contribution';
+
+declare type SortOrder = 'asc' | 'desc';
+
+export declare const StatItemGlass: ForwardRefExoticComponent<StatItemGlassProps & RefAttributes<HTMLSpanElement>>;
+
+declare interface StatItemGlassProps extends HTMLAttributes<HTMLSpanElement>, VariantProps<typeof statItemVariants> {
+    /** Lucide icon component */
+    readonly icon: LucideIcon;
+    /** Stat value (number or formatted string) */
+    readonly value: number | string;
+    /** Stat label */
+    readonly label: string;
+    /** Icon size in pixels */
+    readonly iconSize?: number;
+    /** Abbreviated format for mobile (1.2k instead of 1234) */
+    readonly abbreviated?: boolean;
+}
+
+declare const statItemVariants: (props?: ({
+    size?: "sm" | "md" | "lg" | null | undefined;
+    layout?: "horizontal" | "vertical" | null | undefined;
+} & ClassProp) | undefined) => string;
+
+export declare const StatusIndicatorGlass: ForwardRefExoticComponent<StatusIndicatorGlassProps & RefAttributes<HTMLDivElement>>;
+
+declare interface StatusIndicatorGlassProps extends React.HTMLAttributes<HTMLDivElement> {
+    readonly type?: StatusType;
+    readonly size?: StatusSize;
+}
+
+declare type StatusSize = "normal" | "large";
+
+export declare const statusSizes: (props?: ({
+    size?: "sm" | "md" | "lg" | "xl" | null | undefined;
+} & ClassProp) | undefined) => string;
+
+declare type StatusType = "green" | "yellow" | "red";
+
+export declare interface TabItem {
+    readonly id: string;
+    readonly label: string;
+}
+
+declare interface TabsContentProps {
+    /** Value of the tab this content belongs to */
+    value: string;
+    /** Content to display when tab is active */
+    children: ReactNode;
+    /** Optional className */
+    className?: string;
+}
+
+/**
+ * TabsGlass - Compound Component API
+ *
+ * @example
+ * ```tsx
+ * <TabsGlass.Root value={activeTab} onValueChange={setActiveTab}>
+ *   <TabsGlass.List>
+ *     <TabsGlass.Trigger value="tab1">Overview</TabsGlass.Trigger>
+ *     <TabsGlass.Trigger value="tab2">Analytics</TabsGlass.Trigger>
+ *   </TabsGlass.List>
+ *   <TabsGlass.Content value="tab1">
+ *     <p>Overview content</p>
+ *   </TabsGlass.Content>
+ *   <TabsGlass.Content value="tab2">
+ *     <p>Analytics content</p>
+ *   </TabsGlass.Content>
+ * </TabsGlass.Root>
+ * ```
+ *
+ * @since v1.0.0 - Legacy API removed (tabs/activeTab/onChange props)
+ */
+export declare const TabsGlass: {
+    Root: FC<TabsRootProps>;
+    List: ForwardRefExoticComponent<TabsListProps & RefAttributes<HTMLDivElement>>;
+    Trigger: ForwardRefExoticComponent<TabsTriggerProps & RefAttributes<HTMLButtonElement>>;
+    Content: FC<TabsContentProps>;
+};
+
+declare interface TabsListProps extends React.HTMLAttributes<HTMLDivElement> {
+    children: ReactNode;
+    className?: string;
+}
+
+declare interface TabsRootProps {
+    /** Current active tab value */
+    value: string;
+    /** Callback when tab value changes */
+    onValueChange?: (value: string) => void;
+    /** Child components */
+    children: ReactNode;
+    /** Optional className for container */
+    className?: string;
+}
+
+declare interface TabsTriggerProps {
+    /** Value of this tab */
+    value: string;
+    /** Tab label/content */
+    children: ReactNode;
+    /** Optional className */
+    className?: string;
+    /** Disabled state */
+    disabled?: boolean;
+}
+
+export declare type Theme = "light" | "aurora" | "glass";
+
+export declare const THEME_CONFIG: Record<Theme, ThemeConfig>;
+
+export declare interface ThemeConfig {
+    readonly label: string;
+    readonly icon: LucideIcon;
+}
+
+export declare interface ThemeContextValue {
+    readonly theme: Theme;
+    readonly setTheme: (theme: Theme) => void;
+    readonly cycleTheme: () => void;
+}
+
+export declare function ThemeProvider({ children, defaultTheme, storageKey, }: ThemeProviderProps): JSX.Element;
+
+declare interface ThemeProviderProps {
+    readonly children: ReactNode;
+    readonly defaultTheme?: Theme;
+    readonly storageKey?: string;
+}
+
+export declare const THEMES: readonly Theme[];
+
+export declare const ThemeToggleGlass: ForwardRefExoticComponent<ThemeToggleGlassProps & RefAttributes<HTMLButtonElement>>;
+
+declare interface ThemeToggleGlassProps extends ButtonHTMLAttributes<HTMLButtonElement> {
+    /** Custom theme toggle handler (overrides default cycleTheme) */
+    readonly onToggle?: () => void;
+    /** Icon size in pixels (default: 20) */
+    readonly iconSize?: number;
+    /** Show icon only (hide label on mobile) */
+    readonly iconOnly?: boolean;
+}
+
+export declare const ToggleGlass: ForwardRefExoticComponent<ToggleGlassProps & RefAttributes<HTMLButtonElement>>;
+
+export declare interface ToggleGlassProps extends Omit<React.ButtonHTMLAttributes<HTMLButtonElement>, 'onChange'>, VariantProps<typeof toggleSizes> {
+    readonly checked: boolean;
+    readonly onChange?: (checked: boolean) => void;
+    readonly label?: string;
+}
+
+/**
+ * ToggleGlass CVA Variants
+ * Extracted for Fast Refresh compatibility
+ */
+export declare type ToggleGlassSize = 'sm' | 'md' | 'lg';
+
+export declare const toggleSizes: (props?: ({
+    size?: "sm" | "md" | "lg" | null | undefined;
+} & ClassProp) | undefined) => string;
+
+export declare const TooltipGlass: ForwardRefExoticComponent<TooltipGlassProps & RefAttributes<HTMLDivElement>>;
+
+export declare interface TooltipGlassProps extends VariantProps<typeof tooltipPositions> {
+    readonly children: ReactNode;
+    readonly content: string;
+    readonly position?: TooltipPosition;
+    readonly className?: string;
+}
+
+/**
+ * TooltipGlass CVA Variants
+ * Extracted for Fast Refresh compatibility
+ */
+export declare type TooltipPosition = 'top' | 'bottom' | 'left' | 'right';
+
+export declare const tooltipPositions: (props?: ({
+    position?: "bottom" | "left" | "right" | "top" | null | undefined;
+} & ClassProp) | undefined) => string;
+
+/**
+ * TouchTarget wrapper component
+ *
+ * Ensures interactive elements meet accessibility standards for touch devices.
+ * Automatically applies minimum dimensions and optional centering.
+ *
+ * @example
+ * ```tsx
+ * // Basic usage with default 44px minimum
+ * <TouchTarget>
+ *   <button className="w-8 h-8">×</button>
+ * </TouchTarget>
+ *
+ * // Material Design 48px minimum
+ * <TouchTarget minSize={48}>
+ *   <Checkbox />
+ * </TouchTarget>
+ *
+ * // Custom alignment
+ * <TouchTarget center={false} className="justify-start">
+ *   <IconButton />
+ * </TouchTarget>
+ * ```
+ */
+export declare const TouchTarget: ForwardRefExoticComponent<TouchTargetProps & RefAttributes<HTMLDivElement>>;
+
+/**
+ * Props for the TouchTarget component
+ */
+declare interface TouchTargetProps extends HTMLAttributes<HTMLDivElement> {
+    /**
+     * Child element(s) to wrap with touch target
+     */
+    children: ReactNode;
+    /**
+     * Minimum touch target size in pixels
+     * @default 44 - Apple HIG minimum
+     */
+    minSize?: 44 | 48;
+    /**
+     * Center content within touch target
+     * @default true
+     */
+    center?: boolean;
+}
+
+export declare const TrustScoreCardGlass: ForwardRefExoticComponent<TrustScoreCardGlassProps & RefAttributes<HTMLDivElement>>;
+
+declare interface TrustScoreCardGlassProps extends React.HTMLAttributes<HTMLDivElement> {
+    readonly score?: number;
+    readonly metrics?: readonly MetricData_2[];
+}
+
+export declare const TrustScoreDisplayGlass: ForwardRefExoticComponent<TrustScoreDisplayGlassProps & RefAttributes<HTMLDivElement>>;
+
+declare interface TrustScoreDisplayGlassProps extends HTMLAttributes<HTMLDivElement> {
+    /** Score value (0-100) */
+    readonly score: number;
+    /** Maximum score (default: 100) */
+    readonly maxScore?: number;
+    /** Title text */
+    readonly title?: string;
+    /** Show icon */
+    readonly showIcon?: boolean;
+    /** Size variant */
+    readonly size?: 'sm' | 'md' | 'lg';
+}
+
+/**
+ * Hook for managing focus state with optional focus-visible support.
+ *
+ * @example Basic usage
+ * ```tsx
+ * const { isFocused, focusProps } = useFocus();
+ *
+ * return (
+ *   <input
+ *     {...focusProps}
+ *     style={{
+ *       borderColor: isFocused ? 'violet' : 'gray',
+ *     }}
+ *   />
+ * );
+ * ```
+ *
+ * @example Focus-visible for keyboard navigation
+ * ```tsx
+ * const { isFocusVisible, focusProps } = useFocus({ focusVisible: true });
+ *
+ * return (
+ *   <button
+ *     {...focusProps}
+ *     style={{
+ *       outline: isFocusVisible ? '2px solid violet' : 'none',
+ *     }}
+ *   >
+ *     Click or Tab to me
+ *   </button>
+ * );
+ * ```
+ */
+export declare function useFocus(options?: UseFocusOptions): UseFocusReturn;
+
+declare interface UseFocusOptions {
+    /** Callback when focus state changes */
+    onFocusChange?: (isFocused: boolean) => void;
+    /** Include focus-visible behavior (keyboard focus only) */
+    focusVisible?: boolean;
+    /** Callback for keyboard events while focused */
+    onKeyDown?: (e: KeyboardEvent_2) => void;
+}
+
+declare interface UseFocusReturn {
+    /** Current focus state */
+    isFocused: boolean;
+    /** True only when focused via keyboard (if focusVisible enabled) */
+    isFocusVisible: boolean;
+    /** Props to spread on the target element */
+    focusProps: {
+        onFocus: (e: FocusEvent_2) => void;
+        onBlur: (e: FocusEvent_2) => void;
+        onKeyDown?: (e: KeyboardEvent_2) => void;
+    };
+    /** Manually set focus state */
+    setIsFocused: (value: boolean) => void;
+    /** Reference to track if last focus was from keyboard */
+    focusRef: React.RefObject<boolean>;
+}
+
+/**
+ * Hook for managing hover state with optional delays and focus support.
+ *
+ * @example
+ * ```tsx
+ * const { isHovered, hoverProps } = useHover();
+ *
+ * return (
+ *   <div
+ *     {...hoverProps}
+ *     style={{ opacity: isHovered ? 1 : 0.8 }}
+ *   >
+ *     Hover me
+ *   </div>
+ * );
+ * ```
+ *
+ * @example With options
+ * ```tsx
+ * const { isHovered, hoverProps } = useHover({
+ *   enterDelay: 100,
+ *   leaveDelay: 200,
+ *   includeFocus: true,
+ *   onHoverChange: (hover) => console.log('Hovered:', hover),
+ * });
+ * ```
+ */
+export declare function useHover(options?: UseHoverOptions): UseHoverReturn;
+
+declare interface UseHoverOptions {
+    /** Delay before hover state becomes true (ms) */
+    enterDelay?: number;
+    /** Delay before hover state becomes false (ms) */
+    leaveDelay?: number;
+    /** Include focus events for accessibility */
+    includeFocus?: boolean;
+    /** Callback when hover state changes */
+    onHoverChange?: (isHovered: boolean) => void;
+}
+
+declare interface UseHoverReturn {
+    /** Current hover state */
+    isHovered: boolean;
+    /** Props to spread on the target element */
+    hoverProps: {
+        onMouseEnter: (e: MouseEvent_2) => void;
+        onMouseLeave: (e: MouseEvent_2) => void;
+        onFocus?: (e: FocusEvent_2) => void;
+        onBlur?: (e: FocusEvent_2) => void;
+    };
+    /** Manually set hover state */
+    setIsHovered: (value: boolean) => void;
+}
+
+/**
+ * Hook to detect current responsive breakpoint
+ *
+ * @returns Responsive state with current breakpoint and device type flags
+ *
+ * @example
+ * ```tsx
+ * const { isMobile, isTablet, isDesktop, currentBreakpoint } = useResponsive();
+ *
+ * return (
+ *   <div className={isMobile ? 'flex-col' : 'flex-row'}>
+ *     {currentBreakpoint === 'lg' && <Sidebar />}
+ *   </div>
+ * );
+ * ```
+ */
+export declare function useResponsive(): UseResponsiveReturn;
+
+declare interface UseResponsiveReturn {
+    /** Window width is less than 768px (mobile) */
+    isMobile: boolean;
+    /** Window width is >= 768px and < 1024px (tablet) */
+    isTablet: boolean;
+    /** Window width is >= 1024px (desktop) */
+    isDesktop: boolean;
+    /** Current active breakpoint */
+    currentBreakpoint: Breakpoint;
+    /** Current window width in pixels */
+    width: number;
+}
+
+export declare const UserInfoGlass: ForwardRefExoticComponent<UserInfoGlassProps & RefAttributes<HTMLDivElement>>;
+
+declare interface UserInfoGlassProps extends HTMLAttributes<HTMLDivElement> {
+    /** Full name */
+    readonly name: string;
+    /** Username (without @) */
+    readonly username: string;
+    /** Join date string (e.g., "Jan 2023") */
+    readonly joinDate: string;
+    /** Username link URL (default: #) */
+    readonly profileUrl?: string;
+    /** Layout orientation */
+    readonly layout?: 'vertical' | 'horizontal';
+}
+
+export declare const UserStatsLineGlass: ForwardRefExoticComponent<UserStatsLineGlassProps & RefAttributes<HTMLDivElement>>;
+
+declare interface UserStatsLineGlassProps extends HTMLAttributes<HTMLDivElement> {
+    /** Number of repositories */
+    readonly repos: number;
+    /** Number of followers */
+    readonly followers: number;
+    /** Number of following */
+    readonly following: number;
+    /** Wrap stats on mobile */
+    readonly wrap?: boolean;
+    /** Abbreviated numbers for mobile (1.2k instead of 1234) */
+    readonly abbreviated?: boolean;
+}
+
+export declare function useTheme(): ThemeContextValue;
+
+/**
+ * Hook to extract and use wallpaper tint color
+ *
+ * @example
+ * ```tsx
+ * const { tintColor, isLoading } = useWallpaperTint({
+ *   imageUrl: '/path/to/background.jpg',
+ * });
+ *
+ * // Use tintColor in CSS variables
+ * <div style={{ '--wallpaper-tint': tintColor }}>
+ *   <GlassCard />
+ * </div>
+ * ```
+ */
+export declare const useWallpaperTint: (options?: WallpaperTintOptions) => WallpaperTintResult;
+
+declare interface WallpaperTintOptions {
+    /**
+     * The image URL to sample for tint color
+     */
+    imageUrl?: string;
+    /**
+     * Debounce delay in milliseconds
+     * @default 300
+     */
+    debounceMs?: number;
+    /**
+     * Number of sample points to take from the image
+     * @default 10
+     */
+    sampleSize?: number;
+    /**
+     * Whether to enable the tint extraction
+     * @default true
+     */
+    enabled?: boolean;
+}
+
+declare interface WallpaperTintResult {
+    /**
+     * The extracted tint color in RGB format
+     * Example: "120, 80, 200"
+     */
+    tintColor: string | null;
+    /**
+     * Whether the tint extraction is in progress
+     */
+    isLoading: boolean;
+    /**
+     * Error message if extraction failed
+     */
+    error: string | null;
+    /**
+     * Re-extract the tint color from the current image
+     */
+    refresh: () => void;
+}
+
+export declare const YearCardGlass: ForwardRefExoticComponent<YearCardGlassProps & RefAttributes<HTMLDivElement>>;
+
+declare interface YearCardGlassProps extends React.HTMLAttributes<HTMLDivElement> {
+    readonly year: string | number;
+    readonly emoji: string;
+    readonly label: string;
+    readonly commits: string;
+    readonly progress: number;
+    readonly isExpanded?: boolean;
+    readonly gradient?: ProgressGradient;
+    readonly prs?: number;
+    readonly repos?: number;
+    readonly onShowYear?: () => void;
+}
+
+declare interface YearData {
+    readonly year: string | number;
+    readonly emoji: string;
+    readonly label: string;
+    readonly commits: string;
+    readonly progress: number;
+    readonly prs?: number;
+    readonly repos?: number;
+}
+
+export { }