shadcn-glass-ui 1.0.10 → 2.0.0

package/dist/index.d.ts

@@ -1,2391 +1 @@
-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>>;
-
-/**
- * Props for the AlertGlass component
- *
- * A glass-themed alert with semantic variants, dismissible option, and automatic icon selection.
- * Features theme-aware styling and WCAG-compliant role attributes.
- *
- * @accessibility
- * - **Keyboard Navigation:** Dismissible alerts include a keyboard-accessible close button (Tab + Enter/Space)
- * - **Focus Management:** Close button receives visible focus ring (WCAG 2.4.7)
- * - **Screen Readers:** Uses `role="alert"` for immediate announcement to screen readers (WCAG 4.1.3)
- * - **Icon Semantics:** Icons are decorative and hidden from screen readers with `aria-hidden="true"`
- * - **Variant Semantics:** Each variant uses distinct colors and icons for multi-modal communication (color + icon)
- * - **Touch Targets:** Dismiss button meets minimum 44x44px touch target (WCAG 2.5.5)
- * - **Color Contrast:** All variant text and backgrounds meet WCAG AA contrast ratio 4.5:1
- * - **Motion:** Transitions respect `prefers-reduced-motion` settings
- *
- * @example
- * ```tsx
- * // Basic alert (info/default variant)
- * <AlertGlass title="Information" variant="default">
- *   This is an informational message
- * </AlertGlass>
- *
- * // Error alert with aria-live for dynamic updates
- * <AlertGlass variant="destructive" title="Error" aria-live="assertive">
- *   Your session has expired. Please log in again.
- * </AlertGlass>
- *
- * // Success alert
- * <AlertGlass variant="success" title="Success">
- *   Your changes have been saved successfully.
- * </AlertGlass>
- *
- * // Warning alert
- * <AlertGlass variant="warning" title="Warning">
- *   Your subscription expires in 3 days.
- * </AlertGlass>
- *
- * // Dismissible alert with accessible close button
- * <AlertGlass
- *   variant="default"
- *   title="Welcome"
- *   dismissible
- *   onDismiss={() => setShowAlert(false)}
- * >
- *   Check out our new features!
- * </AlertGlass>
- *
- * // Alert without title
- * <AlertGlass variant="destructive">
- *   Quick error message without title
- * </AlertGlass>
- *
- * // Form validation alert
- * <form onSubmit={handleSubmit}>
- *   {formError && (
- *     <AlertGlass variant="destructive" title="Validation Error" role="alert">
- *       {formError}
- *     </AlertGlass>
- *   )}
- *   <InputGlass label="Email" />
- *   <ButtonGlass type="submit">Submit</ButtonGlass>
- * </form>
- * ```
- */
-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>>;
-
-/**
- * Props for the BadgeGlass component
- *
- * A glass-themed badge with semantic variants and optional animated status dot.
- * Features shadcn/ui compatible variants plus extended Glass UI variants.
- *
- * @accessibility
- * - **Keyboard Navigation:** Badges are non-interactive by default (display-only)
- * - **Focus Management:** N/A - badges do not receive focus unless wrapped in interactive elements
- * - **Screen Readers:** Semantic `<span>` element, content announced naturally
- * - **Status Indicators:** Use `aria-label` to provide context for status badges (e.g., "Status: Active")
- * - **Animated Dot:** Pulse animation respects `prefers-reduced-motion` settings
- * - **Touch Targets:** N/A for display badges, ensure 44x44px if wrapping in button/link (WCAG 2.5.5)
- * - **Color Contrast:** All variant text meets WCAG AA contrast ratio 4.5:1 against badge background
- * - **Motion:** Dot pulse animation can be disabled for users with motion sensitivity
- *
- * @example
- * ```tsx
- * // Basic badge with variant
- * <BadgeGlass variant="default">New</BadgeGlass>
- *
- * // Status badge with aria-label for screen readers
- * <BadgeGlass variant="success" aria-label="Status: Active">
- *   Active
- * </BadgeGlass>
- *
- * // Different variants (shadcn/ui compatible)
- * <BadgeGlass variant="default">Default</BadgeGlass>
- * <BadgeGlass variant="secondary">Secondary</BadgeGlass>
- * <BadgeGlass variant="destructive">Error</BadgeGlass>
- * <BadgeGlass variant="outline">Outline</BadgeGlass>
- *
- * // Extended Glass UI variants
- * <BadgeGlass variant="success">Success</BadgeGlass>
- * <BadgeGlass variant="warning">Warning</BadgeGlass>
- * <BadgeGlass variant="info">Info</BadgeGlass>
- *
- * // With animated status dot
- * <BadgeGlass variant="success" dot aria-label="Status: Online">
- *   Online
- * </BadgeGlass>
- * <BadgeGlass variant="destructive" dot aria-label="Status: Offline">
- *   Offline
- * </BadgeGlass>
- *
- * // Size variants
- * <BadgeGlass size="sm">Small</BadgeGlass>
- * <BadgeGlass size="md">Medium</BadgeGlass>
- * <BadgeGlass size="lg">Large</BadgeGlass>
- *
- * // Inside interactive elements (ensure accessible labels)
- * <button aria-label="Filter by active status">
- *   Filter: <BadgeGlass variant="success">Active</BadgeGlass>
- * </button>
- *
- * // Count badge with semantic meaning
- * <div>
- *   <span>Notifications</span>
- *   <BadgeGlass variant="destructive" aria-label="3 unread notifications">
- *     3
- *   </BadgeGlass>
- * </div>
- * ```
- */
-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.
- *
- * @accessibility
- * - **Keyboard Navigation:** Fully keyboard accessible with native `<button>` element
- * - **Focus Management:** Visible focus ring using `--focus-glow` CSS variable (WCAG 2.4.7)
- * - **Screen Readers:** Semantic `<button>` element, disabled state announced automatically
- * - **Loading State:** When loading=true, button is disabled and loading spinner is visible
- * - **Touch Targets:** Minimum 44x44px touch target (WCAG 2.5.5) via size variants
- * - **Color Contrast:** All variants meet WCAG AA contrast ratio 4.5:1 minimum
- * - **Motion:** Respects `prefers-reduced-motion` for ripple/shine animations
- *
- * @example
- * ```tsx
- * // Basic button
- * <ButtonGlass variant="primary">Click me</ButtonGlass>
- *
- * // With icon and aria-label for icon-only buttons
- * <ButtonGlass icon={Check} iconPosition="left">Save</ButtonGlass>
- * <ButtonGlass icon={X} size="icon" aria-label="Close dialog" />
- *
- * // Loading state (automatically disables and shows spinner)
- * <ButtonGlass loading aria-live="polite">Processing...</ButtonGlass>
- *
- * // Different variants
- * <ButtonGlass variant="ghost">Cancel</ButtonGlass>
- * <ButtonGlass variant="success">Confirm</ButtonGlass>
- * <ButtonGlass variant="destructive">Delete</ButtonGlass>
- *
- * // As a link (asChild pattern) - maintains semantic HTML
- * <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>
- *
- * // Form submit button
- * <ButtonGlass type="submit" variant="primary">
- *   Submit Form
- * </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>>;
-
-/**
- * Props for the CheckboxGlass component
- *
- * A glass-themed checkbox with accessible keyboard navigation, focus management,
- * and touch-friendly targets. Features glow effects and theme-aware styling.
- *
- * @accessibility
- * - **Keyboard Navigation:** Full keyboard support with Enter/Space to toggle, Tab to focus (WCAG 2.1.1)
- * - **Focus Management:** Visible focus ring using `--focus-glow` CSS variable (WCAG 2.4.7)
- * - **Screen Readers:** Dual implementation with native `<input type="checkbox">` (hidden) + visual `<div role="checkbox">`
- * - **ARIA Attributes:** Uses `role="checkbox"` and `aria-checked` for proper state announcement
- * - **Label Association:** Visual label automatically associated with checkbox via `<label>` wrapper
- * - **Touch Targets:** 44x44px minimum touch area per Apple HIG (WCAG 2.5.5 compliance)
- * - **Color Contrast:** Check mark and backgrounds meet WCAG AA contrast ratio 4.5:1
- * - **Motion:** Transitions respect `prefers-reduced-motion` settings
- *
- * @example
- * ```tsx
- * // Basic checkbox with label
- * <CheckboxGlass checked={agreed} onChange={setAgreed} label="I agree to terms" />
- *
- * // Checkbox with accessible name (no visual label)
- * <CheckboxGlass
- *   checked={checked}
- *   onChange={setChecked}
- *   aria-label="Select all items"
- * />
- *
- * // Form integration with validation
- * <form onSubmit={handleSubmit}>
- *   <CheckboxGlass
- *     checked={newsletter}
- *     onChange={setNewsletter}
- *     label="Subscribe to newsletter"
- *     aria-describedby="newsletter-help"
- *   />
- *   <p id="newsletter-help">Receive weekly updates</p>
- *   <CheckboxGlass
- *     checked={terms}
- *     onChange={setTerms}
- *     label="Accept terms and conditions"
- *     required
- *     aria-invalid={submitted && !terms}
- *   />
- *   {submitted && !terms && (
- *     <span role="alert">You must accept the terms</span>
- *   )}
- * </form>
- *
- * // Disabled checkbox (state announced to screen readers)
- * <CheckboxGlass
- *   checked={true}
- *   onChange={() => {}}
- *   label="This option is locked"
- *   disabled
- * />
- *
- * // Checkbox group with fieldset
- * <fieldset>
- *   <legend>Select your interests</legend>
- *   <CheckboxGlass
- *     checked={interests.tech}
- *     onChange={(checked) => setInterests({ ...interests, tech: checked })}
- *     label="Technology"
- *   />
- *   <CheckboxGlass
- *     checked={interests.design}
- *     onChange={(checked) => setInterests({ ...interests, design: checked })}
- *     label="Design"
- *   />
- * </fieldset>
- * ```
- */
-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>>;
-
-/**
- * Props for the DropdownGlass component
- *
- * A glass-themed dropdown menu with accessible keyboard navigation, based on Radix UI primitives.
- * Features theme-aware styling, smooth animations, and WCAG-compliant interactions.
- *
- * @accessibility
- * - **Keyboard Navigation:** Arrow keys navigate menu items, Enter/Space activates, Escape closes (WCAG 2.1.1)
- * - **Focus Management:** Focus trapped within menu when open, returned to trigger on close (WCAG 2.4.3)
- * - **Screen Readers:** Uses `role="menu"` and `role="menuitem"` for proper menu semantics (WCAG 4.1.3)
- * - **ARIA Attributes:** Items marked with `data-highlighted` state for screen reader announcement
- * - **Trigger Association:** Menu automatically associated with trigger button via Radix UI primitives
- * - **Touch Targets:** All menu items meet minimum 44x44px touch target (WCAG 2.5.5)
- * - **Color Contrast:** Menu text and backgrounds meet WCAG AA contrast ratio 4.5:1
- * - **Motion:** Open/close animations respect `prefers-reduced-motion` settings
- *
- * @example
- * ```tsx
- * // Basic dropdown with icon items
- * <DropdownGlass
- *   trigger={
- *     <button aria-label="Open menu">
- *       <MoreVertical className="w-5 h-5" />
- *     </button>
- *   }
- *   items={[
- *     { label: 'Edit', icon: Edit, onClick: handleEdit },
- *     { label: 'Delete', icon: Trash, onClick: handleDelete, danger: true }
- *   ]}
- * />
- *
- * // Dropdown with dividers and alignment
- * <DropdownGlass
- *   trigger={<ButtonGlass>Actions</ButtonGlass>}
- *   align="right"
- *   items={[
- *     { label: 'View', icon: Eye, onClick: () => navigate('/view') },
- *     { label: 'Edit', icon: Edit, onClick: () => setEditMode(true) },
- *     { divider: true },
- *     { label: 'Archive', icon: Archive, onClick: handleArchive },
- *     { divider: true },
- *     { label: 'Delete', icon: Trash, onClick: handleDelete, danger: true }
- *   ]}
- * />
- *
- * // Dropdown in table row (ensure trigger has accessible label)
- * <DropdownGlass
- *   trigger={
- *     <button aria-label={`Actions for ${user.name}`}>
- *       <MoreHorizontal />
- *     </button>
- *   }
- *   items={[
- *     { label: 'View Profile', onClick: () => viewProfile(user.id) },
- *     { label: 'Send Message', onClick: () => sendMessage(user.id) }
- *   ]}
- * />
- *
- * // Dropdown with keyboard-friendly trigger
- * <DropdownGlass
- *   trigger={
- *     <ButtonGlass
- *       icon={Settings}
- *       variant="ghost"
- *       aria-haspopup="menu"
- *       aria-label="Settings menu"
- *     >
- *       Settings
- *     </ButtonGlass>
- *   }
- *   items={[
- *     { label: 'Preferences', icon: Sliders, onClick: () => navigate('/settings/preferences') },
- *     { label: 'Security', icon: Lock, onClick: () => navigate('/settings/security') },
- *     { divider: true },
- *     { label: 'Log Out', icon: LogOut, onClick: handleLogout }
- *   ]}
- * />
- *
- * // Advanced: Using Radix primitives directly (see component JSDoc for examples)
- * ```
- */
-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
- *
- * A glass-themed container with configurable blur, glow effects, and hover animations.
- * Features polymorphic rendering via `asChild` for semantic HTML flexibility.
- *
- * @accessibility
- * - **Keyboard Navigation:** When used with `asChild` as a link/button, inherits native keyboard support (Enter/Space activation)
- * - **Focus Management:** Focus ring applied to child element when using `asChild` pattern with interactive elements
- * - **Screen Readers:** Semantic HTML preserved via `asChild` - use appropriate elements (`<a>`, `<button>`, `<article>`)
- * - **Hover State:** Hover effects are purely visual and do not affect functionality (progressive enhancement)
- * - **Touch Targets:** When interactive, ensure child element meets minimum 44x44px touch target (WCAG 2.5.5)
- * - **Color Contrast:** Card border and background meet WCAG AA contrast requirements, content contrast is consumer's responsibility
- * - **Motion:** Hover scale animation respects `prefers-reduced-motion` settings via CSS transitions
- *
- * @example
- * ```tsx
- * // Basic card
- * <GlassCard intensity="medium">Content</GlassCard>
- *
- * // As a clickable link with accessible name
- * <GlassCard asChild intensity="medium">
- *   <a href="/details" aria-label="View product details">
- *     <h3>Product Title</h3>
- *     <p>Description</p>
- *   </a>
- * </GlassCard>
- *
- * // Different intensity levels
- * <GlassCard intensity="subtle">Subtle blur</GlassCard>
- * <GlassCard intensity="medium">Standard blur</GlassCard>
- * <GlassCard intensity="strong">Heavy blur</GlassCard>
- *
- * // With glow effects
- * <GlassCard glow="blue">Blue glow card</GlassCard>
- * <GlassCard glow="violet">Violet glow card</GlassCard>
- * <GlassCard glow="cyan">Cyan glow card</GlassCard>
- *
- * // As a button (interactive) with role
- * <GlassCard asChild hover intensity="medium">
- *   <button onClick={handleClick} aria-label="Open settings">
- *     <Settings className="w-6 h-6" />
- *     <span>Settings</span>
- *   </button>
- * </GlassCard>
- *
- * // Article card with semantic HTML
- * <GlassCard asChild intensity="medium" padding="lg">
- *   <article>
- *     <header><h2>Article Title</h2></header>
- *     <p>Article content...</p>
- *     <footer>Published: Jan 1, 2025</footer>
- *   </article>
- * </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.
- *
- * @accessibility
- * - **Keyboard Navigation:** Full keyboard support with native `<input>` element, standard tab navigation
- * - **Focus Management:** Visible focus ring using `--focus-glow` CSS variable (WCAG 2.4.7)
- * - **Screen Readers:** Semantic `<label>` elements properly associated via `htmlFor`, error/success messages announced with `aria-describedby`
- * - **Error State:** Red border and error message displayed below input, programmatically associated for screen readers
- * - **Success State:** Green border and success message displayed below input, programmatically associated for screen readers
- * - **Touch Targets:** Minimum 44x44px touch target on mobile devices (WCAG 2.5.5)
- * - **Color Contrast:** All text meets WCAG AA contrast ratio 4.5:1 minimum against backgrounds
- * - **Motion:** Icon color transitions respect `prefers-reduced-motion` settings
- *
- * @example
- * ```tsx
- * // Basic input with label
- * <InputGlass label="Email" placeholder="you@example.com" />
- *
- * // With aria-describedby for additional context
- * <InputGlass
- *   label="Username"
- *   placeholder="Enter username"
- *   aria-describedby="username-help"
- * />
- * <span id="username-help">Must be 3-20 characters</span>
- *
- * // With validation states (automatically announced to screen readers)
- * <InputGlass label="Username" error="Username is required" />
- * <InputGlass label="Password" success="Strong password" type="password" />
- *
- * // With icon and accessible label
- * <InputGlass
- *   icon={Search}
- *   placeholder="Search..."
- *   aria-label="Search products"
- * />
- * <InputGlass icon={Mail} iconPosition="right" type="email" />
- *
- * // Disabled state (automatically announced)
- * <InputGlass label="Email" disabled value="locked@example.com" />
- *
- * // Form integration with accessible error handling
- * <form onSubmit={handleSubmit}>
- *   <InputGlass
- *     label="Email"
- *     type="email"
- *     required
- *     error={errors.email}
- *     aria-invalid={!!errors.email}
- *   />
- *   <InputGlass
- *     label="Password"
- *     type="password"
- *     icon={Lock}
- *     error={errors.password}
- *   />
- *   <ButtonGlass type="submit">Sign In</ButtonGlass>
- * </form>
- * ```
- */
-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;
-}
-
-/**
- * Props for ModalGlass.Root component
- *
- * Root component that provides context and manages open/close state for the modal.
- * Handles keyboard events, body scroll lock, and accessibility attributes.
- *
- * @accessibility
- * - **Keyboard Navigation:** Escape key closes modal, Tab key traps focus within modal content
- * - **Focus Management:** Focus automatically moved to modal on open, returned to trigger on close (WCAG 2.4.3)
- * - **Screen Readers:** Uses `role="dialog"` and `aria-modal="true"` for proper modal semantics (WCAG 4.1.3)
- * - **Title Association:** Modal title automatically linked via `aria-labelledby="modal-title"`
- * - **Description Association:** Optional description linked via `aria-describedby="modal-description"`
- * - **Body Scroll Lock:** Prevents background scrolling when modal is open (improves UX and focus management)
- * - **Touch Targets:** All interactive elements (close button, action buttons) meet 44x44px minimum (WCAG 2.5.5)
- * - **Color Contrast:** Modal content and overlay meet WCAG AA contrast requirements
- * - **Motion:** Open/close animations respect `prefers-reduced-motion` settings
- *
- * @example
- * ```tsx
- * // Basic modal with title and description
- * <ModalGlass.Root open={open} onOpenChange={setOpen}>
- *   <ModalGlass.Overlay />
- *   <ModalGlass.Content>
- *     <ModalGlass.Header>
- *       <ModalGlass.Title>Confirm Action</ModalGlass.Title>
- *       <ModalGlass.Description>
- *         This action cannot be undone.
- *       </ModalGlass.Description>
- *       <ModalGlass.Close />
- *     </ModalGlass.Header>
- *     <ModalGlass.Body>
- *       <p>Are you sure you want to proceed?</p>
- *     </ModalGlass.Body>
- *     <ModalGlass.Footer>
- *       <ButtonGlass variant="ghost" onClick={() => setOpen(false)}>
- *         Cancel
- *       </ButtonGlass>
- *       <ButtonGlass variant="destructive" onClick={handleConfirm}>
- *         Confirm
- *       </ButtonGlass>
- *     </ModalGlass.Footer>
- *   </ModalGlass.Content>
- * </ModalGlass.Root>
- *
- * // Different sizes
- * <ModalGlass.Root open={open} onOpenChange={setOpen} size="sm">
- *   {// Small modal content}
- * </ModalGlass.Root>
- * <ModalGlass.Root open={open} onOpenChange={setOpen} size="lg">
- *   {// Large modal content}
- * </ModalGlass.Root>
- *
- * // Form modal with proper focus management
- * <ModalGlass.Root open={open} onOpenChange={setOpen}>
- *   <ModalGlass.Overlay />
- *   <ModalGlass.Content>
- *     <ModalGlass.Header>
- *       <ModalGlass.Title>Create Account</ModalGlass.Title>
- *       <ModalGlass.Close />
- *     </ModalGlass.Header>
- *     <ModalGlass.Body>
- *       <form id="signup-form" onSubmit={handleSubmit}>
- *         <InputGlass label="Email" type="email" required />
- *         <InputGlass label="Password" type="password" required />
- *       </form>
- *     </ModalGlass.Body>
- *     <ModalGlass.Footer>
- *       <ButtonGlass variant="ghost" onClick={() => setOpen(false)}>
- *         Cancel
- *       </ButtonGlass>
- *       <ButtonGlass type="submit" form="signup-form">
- *         Sign Up
- *       </ButtonGlass>
- *     </ModalGlass.Footer>
- *   </ModalGlass.Content>
- * </ModalGlass.Root>
- *
- * // Alert modal (no close button)
- * <ModalGlass.Root open={showAlert} onOpenChange={setShowAlert}>
- *   <ModalGlass.Overlay />
- *   <ModalGlass.Content>
- *     <ModalGlass.Header>
- *       <ModalGlass.Title>Session Expired</ModalGlass.Title>
- *     </ModalGlass.Header>
- *     <ModalGlass.Body>
- *       Your session has expired. Please log in again.
- *     </ModalGlass.Body>
- *     <ModalGlass.Footer>
- *       <ButtonGlass onClick={handleLogin}>Log In</ButtonGlass>
- *     </ModalGlass.Footer>
- *   </ModalGlass.Content>
- * </ModalGlass.Root>
- * ```
- */
-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;
-}
-
-/**
- * Props for TabsGlass.Root component
- *
- * Root component that manages tab state and provides context for child components.
- * Features accessible keyboard navigation and ARIA attributes.
- *
- * @accessibility
- * - **Keyboard Navigation:** Arrow keys navigate between tabs, Tab moves to tab panel content (WCAG 2.1.1)
- * - **Focus Management:** Visible focus ring on active tab using `--focus-glow` CSS variable (WCAG 2.4.7)
- * - **Screen Readers:** Uses `role="tablist"`, `role="tab"`, `role="tabpanel"` for proper tab semantics (WCAG 4.1.3)
- * - **ARIA Attributes:** Tabs marked with `aria-selected`, panels with `aria-hidden` for state announcement
- * - **Active State:** Visual indicator (underline) plus color change for multi-modal feedback
- * - **Touch Targets:** Tab triggers meet minimum 44x44px touch target (WCAG 2.5.5)
- * - **Color Contrast:** Active and inactive tab text meet WCAG AA contrast ratio 4.5:1
- * - **Motion:** Transitions and indicator animations respect `prefers-reduced-motion` settings
- *
- * @example
- * ```tsx
- * // Basic tabs
- * <TabsGlass.Root value={activeTab} onValueChange={setActiveTab}>
- *   <TabsGlass.List>
- *     <TabsGlass.Trigger value="overview">Overview</TabsGlass.Trigger>
- *     <TabsGlass.Trigger value="analytics">Analytics</TabsGlass.Trigger>
- *     <TabsGlass.Trigger value="settings">Settings</TabsGlass.Trigger>
- *   </TabsGlass.List>
- *   <TabsGlass.Content value="overview">
- *     <h2>Overview</h2>
- *     <p>Overview content here</p>
- *   </TabsGlass.Content>
- *   <TabsGlass.Content value="analytics">
- *     <h2>Analytics</h2>
- *     <p>Analytics content here</p>
- *   </TabsGlass.Content>
- *   <TabsGlass.Content value="settings">
- *     <h2>Settings</h2>
- *     <p>Settings content here</p>
- *   </TabsGlass.Content>
- * </TabsGlass.Root>
- *
- * // Tabs with icons (ensure accessible labels)
- * <TabsGlass.Root value={activeTab} onValueChange={setActiveTab}>
- *   <TabsGlass.List>
- *     <TabsGlass.Trigger value="home" aria-label="Home dashboard">
- *       <Home className="w-4 h-4" />
- *     </TabsGlass.Trigger>
- *     <TabsGlass.Trigger value="search" aria-label="Search">
- *       <Search className="w-4 h-4" />
- *     </TabsGlass.Trigger>
- *   </TabsGlass.List>
- *   <TabsGlass.Content value="home">Dashboard content</TabsGlass.Content>
- *   <TabsGlass.Content value="search">Search content</TabsGlass.Content>
- * </TabsGlass.Root>
- *
- * // Disabled tab (announced to screen readers)
- * <TabsGlass.Root value={activeTab} onValueChange={setActiveTab}>
- *   <TabsGlass.List>
- *     <TabsGlass.Trigger value="tab1">Available Tab</TabsGlass.Trigger>
- *     <TabsGlass.Trigger value="tab2" disabled>
- *       Locked Tab
- *     </TabsGlass.Trigger>
- *   </TabsGlass.List>
- *   <TabsGlass.Content value="tab1">Content 1</TabsGlass.Content>
- * </TabsGlass.Root>
- *
- * // Form tabs with proper focus management
- * <TabsGlass.Root value={currentStep} onValueChange={setCurrentStep}>
- *   <TabsGlass.List aria-label="Registration steps">
- *     <TabsGlass.Trigger value="account">Account Info</TabsGlass.Trigger>
- *     <TabsGlass.Trigger value="profile">Profile Details</TabsGlass.Trigger>
- *     <TabsGlass.Trigger value="confirm">Confirmation</TabsGlass.Trigger>
- *   </TabsGlass.List>
- *   <TabsGlass.Content value="account">
- *     <InputGlass label="Email" type="email" />
- *   </TabsGlass.Content>
- *   <TabsGlass.Content value="profile">
- *     <InputGlass label="Name" />
- *   </TabsGlass.Content>
- *   <TabsGlass.Content value="confirm">
- *     <p>Review your information</p>
- *   </TabsGlass.Content>
- * </TabsGlass.Root>
- * ```
- */
-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>>;
-
-/**
- * Props for the TooltipGlass component
- *
- * A glass-themed tooltip with configurable positioning and unified dark design.
- * Features smooth animations and WCAG-compliant accessibility attributes.
- *
- * @accessibility
- * - **Keyboard Navigation:** Tooltip appears on focus for keyboard users (same as hover)
- * - **Focus Management:** Tooltip does not trap focus, allows normal navigation flow
- * - **Screen Readers:** Uses `aria-describedby` to associate tooltip with trigger element (WCAG 4.1.3)
- * - **ARIA Attributes:** Tooltip marked with `role="tooltip"` and unique ID for proper association
- * - **Dismissible:** Tooltip dismisses on mouse leave, focus blur, or Escape key
- * - **Touch Targets:** N/A - tooltips appear on hover/focus, do not require direct interaction
- * - **Color Contrast:** Tooltip text meets WCAG AA contrast ratio 4.5:1 against dark background
- * - **Motion:** Fade-in animation respects `prefers-reduced-motion` settings
- *
- * @example
- * ```tsx
- * // Basic tooltip
- * <TooltipGlass content="Click to edit">
- *   <button><Edit className="w-4 h-4" /></button>
- * </TooltipGlass>
- *
- * // Different positions
- * <TooltipGlass content="Top tooltip" position="top">
- *   <ButtonGlass>Hover me</ButtonGlass>
- * </TooltipGlass>
- * <TooltipGlass content="Bottom tooltip" position="bottom">
- *   <ButtonGlass>Hover me</ButtonGlass>
- * </TooltipGlass>
- * <TooltipGlass content="Left tooltip" position="left">
- *   <ButtonGlass>Hover me</ButtonGlass>
- * </TooltipGlass>
- * <TooltipGlass content="Right tooltip" position="right">
- *   <ButtonGlass>Hover me</ButtonGlass>
- * </TooltipGlass>
- *
- * // Icon button with accessible tooltip (provides label)
- * <TooltipGlass content="Delete item">
- *   <ButtonGlass
- *     icon={Trash}
- *     size="icon"
- *     variant="ghost"
- *     aria-label="Delete item"
- *   />
- * </TooltipGlass>
- *
- * // Informational tooltip on text
- * <TooltipGlass content="This feature requires a Pro subscription">
- *   <span className="underline decoration-dotted">Pro Feature</span>
- * </TooltipGlass>
- *
- * // Badge with tooltip for additional context
- * <TooltipGlass content="Last updated 2 hours ago" position="top">
- *   <BadgeGlass variant="success" dot>
- *     Active
- *   </BadgeGlass>
- * </TooltipGlass>
- *
- * // Disabled button with explanation tooltip
- * <TooltipGlass content="Save your changes first to enable this action">
- *   <span>
- *     <ButtonGlass disabled aria-describedby="tooltip-id">
- *       Export
- *     </ButtonGlass>
- *   </span>
- * </TooltipGlass>
- * ```
- */
-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 { }