corekit-components 0.1.0

package/dist/index.d.ts

@@ -0,0 +1,842 @@
+import { ClassProp } from 'class-variance-authority/types';
+import { ComponentPropsWithRef } from 'react';
+import { ElementType } from 'react';
+import { ForwardRefExoticComponent } from 'react';
+import { JSX as JSX_2 } from 'react/jsx-runtime';
+import { ReactElement } from 'react';
+import { ReactNode } from 'react';
+import { ReactPortal } from 'react';
+import { RefAttributes } from 'react';
+import { VariantProps } from 'class-variance-authority';
+
+export declare const Accordion: ForwardRefExoticComponent<AccordionProps & RefAttributes<HTMLDivElement>>;
+
+export declare const AccordionItem: ForwardRefExoticComponent<AccordionItemProps & RefAttributes<HTMLDivElement>>;
+
+export declare interface AccordionItemProps {
+    /** Unique key for this item — used to track open/closed state */
+    itemKey: string;
+    /** The trigger/header content */
+    trigger: ReactNode;
+    /** The collapsible body content */
+    children: ReactNode;
+    /** Whether this item is disabled */
+    disabled?: boolean;
+    /** Additional class names for the item wrapper */
+    className?: string;
+}
+
+export declare interface AccordionProps {
+    /** Accordion items */
+    children: ReactNode;
+    /** Allow multiple items to be open at the same time */
+    multiple?: boolean;
+    /** Keys of items that are open by default (uncontrolled) */
+    defaultOpenKeys?: string[];
+    /** Keys of items that are open (controlled) */
+    openKeys?: string[];
+    /** Callback when open items change */
+    onOpenKeysChange?: (keys: string[]) => void;
+    /** Visual variant */
+    variant?: "default" | "bordered" | "separated";
+    /** Size variant */
+    size?: "sm" | "md" | "lg";
+    /** Additional class names for the accordion container */
+    className?: string;
+}
+
+export declare const accordionVariants: (props?: ({
+    variant?: "default" | "bordered" | "separated" | null | undefined;
+} & ClassProp) | undefined) => string;
+
+export declare const Autocomplete: ForwardRefExoticComponent<AutocompleteProps & RefAttributes<HTMLInputElement>>;
+
+export declare interface AutocompleteOption {
+    /** Unique value for the option */
+    value: string;
+    /** Display label for the option */
+    label: string;
+    /** Optional logo/icon rendered before the label */
+    logo?: ReactNode;
+    /** Whether the option is disabled */
+    disabled?: boolean;
+}
+
+export declare interface AutocompleteProps extends Omit<ComponentPropsWithRef<"input">, "ref" | "value" | "onChange" | "onSelect" | "size"> {
+    /** Size variant */
+    size?: "sm" | "md" | "lg";
+    /** Visual variant — resolved internally from error state */
+    /** List of options to display in the dropdown */
+    options: AutocompleteOption[];
+    /** Controlled input value */
+    value?: string;
+    /** Callback when input value changes */
+    onChange?: (value: string) => void;
+    /** Callback when an option is selected */
+    onSelect?: (option: AutocompleteOption) => void;
+    /** Label text rendered above the input */
+    label?: string;
+    /** Error message to display below the input */
+    error?: string;
+    /** Placeholder text for the input */
+    placeholder?: string;
+    /** Unique id linking the label and input */
+    id?: string;
+    /** Whether the dropdown is open (controlled) */
+    open?: boolean;
+    /** Callback when open state changes */
+    onOpenChange?: (open: boolean) => void;
+    /** Text to show when no options match */
+    emptyMessage?: string;
+}
+
+export declare const autocompleteVariants: (props?: ({
+    size?: "sm" | "md" | "lg" | null | undefined;
+    variant?: "default" | "error" | null | undefined;
+} & ClassProp) | undefined) => string;
+
+export declare const Avatar: ForwardRefExoticComponent<AvatarProps & RefAttributes<HTMLSpanElement>>;
+
+export declare const AvatarGroup: ForwardRefExoticComponent<AvatarGroupProps & RefAttributes<HTMLDivElement>>;
+
+export declare interface AvatarGroupProps {
+    /** Avatar elements to render */
+    children: ReactNode;
+    /** Maximum number of avatars to show before +N overflow */
+    max?: number;
+    /** Size applied to all avatars in the group */
+    size?: AvatarProps["size"];
+    /** Additional class names */
+    className?: string;
+}
+
+export declare interface AvatarProps extends Omit<ComponentPropsWithRef<"span">, "ref" | "children"> {
+    /** Image source URL */
+    src?: string;
+    /** Alt text for the image */
+    alt?: string;
+    /** Fallback text shown when there is no image (typically initials) */
+    fallback?: string;
+    /** Custom fallback icon or element */
+    fallbackIcon?: ReactNode;
+    /** Size variant */
+    size?: "xs" | "sm" | "md" | "lg" | "xl";
+    /** Shape variant */
+    shape?: "circle" | "square";
+    /** Visual colour variant for the fallback background */
+    color?: "primary" | "secondary" | "muted" | "gray";
+    /** Whether to show a status indicator dot */
+    status?: "online" | "offline" | "away" | "busy";
+    /** Position of the status indicator */
+    statusPosition?: "top-right" | "bottom-right";
+}
+
+export declare const avatarVariants: (props?: ({
+    size?: "sm" | "md" | "lg" | "xs" | "xl" | null | undefined;
+    shape?: "circle" | "square" | null | undefined;
+    color?: "primary" | "secondary" | "muted" | "gray" | null | undefined;
+} & ClassProp) | undefined) => string;
+
+export declare const Box: BoxComponent;
+
+export declare type BoxComponent = <T extends ElementType = "div">(props: BoxProps<T>) => ReactElement | null;
+
+export declare type BoxProps<T extends ElementType = "div"> = PolymorphicProps<T>;
+
+export declare const Button: ForwardRefExoticComponent<ButtonProps & RefAttributes<HTMLButtonElement>>;
+
+export declare interface ButtonProps extends Omit<ComponentPropsWithRef<"button">, "ref">, ButtonVariantProps {
+    /** Accessible label for the button when content is not descriptive */
+    "aria-label"?: string;
+}
+
+export declare type ButtonVariantProps = VariantProps<typeof buttonVariants>;
+
+export declare const buttonVariants: (props?: ({
+    variant?: "primary" | "secondary" | "outline" | "ghost" | null | undefined;
+    size?: "sm" | "md" | "lg" | null | undefined;
+} & ClassProp) | undefined) => string;
+
+export declare const Card: ForwardRefExoticComponent<CardProps & RefAttributes<HTMLDivElement>>;
+
+export declare const CardContent: ForwardRefExoticComponent<CardContentProps & RefAttributes<HTMLDivElement>>;
+
+export declare interface CardContentProps extends Omit<ComponentPropsWithRef<"div">, "ref"> {
+}
+
+export declare const CardFooter: ForwardRefExoticComponent<CardFooterProps & RefAttributes<HTMLDivElement>>;
+
+export declare interface CardFooterProps extends Omit<ComponentPropsWithRef<"div">, "ref"> {
+}
+
+export declare const CardHeader: ForwardRefExoticComponent<CardHeaderProps & RefAttributes<HTMLDivElement>>;
+
+export declare interface CardHeaderProps extends Omit<ComponentPropsWithRef<"div">, "ref"> {
+}
+
+export declare interface CardProps extends Omit<ComponentPropsWithRef<"div">, "ref"> {
+}
+
+export declare const Checkbox: ForwardRefExoticComponent<CheckboxProps & RefAttributes<HTMLInputElement>>;
+
+export declare interface CheckboxProps extends Omit<ComponentPropsWithRef<"input">, "ref" | "type" | "size"> {
+    /** Label text rendered next to the checkbox */
+    label?: ReactNode;
+    /** Description text rendered below the label */
+    description?: string;
+    /** Error message to display below the checkbox */
+    error?: string;
+    /** Size variant */
+    size?: "sm" | "md" | "lg";
+    /** Unique id linking the label and checkbox */
+    id?: string;
+}
+
+export declare const checkboxVariants: (props?: ({
+    size?: "sm" | "md" | "lg" | null | undefined;
+} & ClassProp) | undefined) => string;
+
+export declare type Color = keyof typeof colors;
+
+export declare const colors: {
+    readonly primary: "var(--color-primary)";
+    readonly secondary: "var(--color-secondary)";
+    readonly muted: "var(--color-muted)";
+};
+
+export declare type Direction = "ltr" | "rtl";
+
+export declare const EmptyState: ForwardRefExoticComponent<EmptyStateProps & RefAttributes<HTMLDivElement>>;
+
+export declare interface EmptyStateProps {
+    /** Icon or illustration rendered above the title */
+    icon?: ReactNode;
+    /** Full-width image / illustration (replaces icon when provided) */
+    image?: ReactNode;
+    /** Primary heading */
+    title: string;
+    /** Supporting description text */
+    description?: string;
+    /** Primary action — typically a Button element */
+    primaryAction?: ReactNode;
+    /** Secondary action — typically a link-style or ghost Button */
+    secondaryAction?: ReactNode;
+    /** Size variant controlling spacing and font sizes */
+    size?: "sm" | "md" | "lg";
+    /** Layout direction */
+    layout?: "vertical" | "horizontal";
+    /** Whether to render a bordered container */
+    bordered?: boolean;
+    /** Additional class names */
+    className?: string;
+}
+
+export declare const emptyStateVariants: (props?: ({
+    size?: "sm" | "md" | "lg" | null | undefined;
+    layout?: "horizontal" | "vertical" | null | undefined;
+    bordered?: boolean | null | undefined;
+} & ClassProp) | undefined) => string;
+
+export declare function FormatNumber({ value, format, locale: localeProp, currency: currencyProp, currencyDisplay, notation, signDisplay, minimumFractionDigits, maximumFractionDigits, decimals, unit, unitDisplay, prefix, suffix, children, className, as: Tag, ...rest }: FormatNumberProps): JSX_2.Element;
+
+export declare namespace FormatNumber {
+    var displayName: string;
+}
+
+export declare interface FormatNumberProps {
+    /** The numeric value to format */
+    value: number;
+    /** Formatting style */
+    format?: NumberFormatStyle;
+    /** BCP 47 locale string (default: "en-US") */
+    locale?: string;
+    /** ISO 4217 currency code when format="currency" or "accounting" */
+    currency?: string;
+    /** How to display the currency: "symbol" | "narrowSymbol" | "code" | "name" */
+    currencyDisplay?: "symbol" | "narrowSymbol" | "code" | "name";
+    /** Number notation */
+    notation?: NumberNotation;
+    /** Sign display mode */
+    signDisplay?: SignDisplay;
+    /** Minimum fraction digits */
+    minimumFractionDigits?: number;
+    /** Maximum fraction digits */
+    maximumFractionDigits?: number;
+    /** Shorthand: sets both min and max fraction digits */
+    decimals?: number;
+    /** Unit for format="unit" (e.g. "kilogram", "mile-per-hour") */
+    unit?: string;
+    /** How to display the unit: "short" | "long" | "narrow" */
+    unitDisplay?: "short" | "long" | "narrow";
+    /** Prefix rendered before the formatted value */
+    prefix?: string;
+    /** Suffix rendered after the formatted value */
+    suffix?: string;
+    /** Render prop — receives the formatted string, return custom JSX */
+    children?: (formatted: string) => ReactNode;
+    /** Additional class names for the wrapping <span> */
+    className?: string;
+    /** HTML element to render (default: "span") */
+    as?: "span" | "p" | "div" | "strong" | "em" | "data";
+}
+
+export declare const Input: ForwardRefExoticComponent<InputProps & RefAttributes<HTMLInputElement>>;
+
+export declare interface InputProps extends Omit<ComponentPropsWithRef<"input">, "ref"> {
+    /** Label text rendered above the input */
+    label?: string;
+    /** Error message to display below the input */
+    error?: string;
+    /** Unique id linking the label and input */
+    id?: string;
+}
+
+export declare const List: ForwardRefExoticComponent<ListProps & RefAttributes<HTMLUListElement>>;
+
+export declare const ListItem: ForwardRefExoticComponent<ListItemProps & RefAttributes<HTMLLIElement>>;
+
+export declare interface ListItemProps extends Omit<ComponentPropsWithRef<"li">, "ref"> {
+    /** Leading element — icon, avatar, or any ReactNode */
+    leading?: ReactNode;
+    /** Trailing element — badge, action button, etc. */
+    trailing?: ReactNode;
+    /** Secondary text rendered below the primary content */
+    secondary?: ReactNode;
+    /** Whether this item is currently selected / active */
+    selected?: boolean;
+    /** Whether this item is disabled */
+    disabled?: boolean;
+    /** Click handler — makes the item interactive */
+    onClick?: React.MouseEventHandler<HTMLLIElement>;
+    /** Additional class names */
+    className?: string;
+    children: ReactNode;
+}
+
+export declare interface ListProps extends Omit<ComponentPropsWithRef<"ul">, "ref"> {
+    /** Visual variant */
+    variant?: "plain" | "bordered" | "divided" | "striped";
+    /** Size variant controlling padding and font */
+    size?: "sm" | "md" | "lg";
+    /** Render as an ordered list (`<ol>`) */
+    ordered?: boolean;
+    /** Whether list items are interactive / clickable */
+    interactive?: boolean;
+    /** Additional class names */
+    className?: string;
+    children: ReactNode;
+}
+
+export declare const ListSubheader: {
+    ({ children, className }: ListSubheaderProps): JSX_2.Element;
+    displayName: string;
+};
+
+export declare interface ListSubheaderProps {
+    /** Subheader text or element */
+    children: ReactNode;
+    /** Additional class names */
+    className?: string;
+}
+
+export declare const listVariants: (props?: ({
+    variant?: "bordered" | "plain" | "divided" | "striped" | null | undefined;
+    size?: "sm" | "md" | "lg" | null | undefined;
+} & ClassProp) | undefined) => string;
+
+export declare interface LocaleContextValue {
+    /** BCP 47 locale string (e.g. "en-US", "de-DE", "ja-JP") */
+    locale: string;
+    /** ISO 4217 default currency code (e.g. "USD", "EUR", "INR") */
+    currency: string;
+    /** Text direction */
+    direction: Direction;
+    /** IANA timezone (e.g. "America/New_York", "Europe/Berlin") */
+    timezone: string;
+}
+
+export declare function LocaleProvider({ locale, currency, direction, timezone, children, }: LocaleProviderProps): JSX_2.Element;
+
+export declare namespace LocaleProvider {
+    var displayName: string;
+}
+
+export declare interface LocaleProviderProps extends Partial<LocaleContextValue> {
+    /** Child components that will receive locale context */
+    children: ReactNode;
+}
+
+export declare const Marquee: ForwardRefExoticComponent<MarqueeProps & RefAttributes<HTMLDivElement>>;
+
+export declare interface MarqueeProps {
+    /** Content to scroll — will be duplicated for seamless looping */
+    children: ReactNode;
+    /** Scroll direction */
+    direction?: "left" | "right" | "up" | "down";
+    /** Animation speed variant */
+    speed?: "slow" | "normal" | "fast";
+    /** Custom animation duration in seconds (overrides speed) */
+    duration?: number;
+    /** Pause animation on hover */
+    pauseOnHover?: boolean;
+    /** Number of times to duplicate the content for a seamless loop */
+    repeat?: number;
+    /** Gap between repeated items (Tailwind spacing value, e.g. "4", "8") */
+    gap?: "2" | "4" | "6" | "8" | "12" | "16";
+    /** Show gradient fade on the edges */
+    fade?: boolean;
+    /** Fade width as a CSS value (default "4rem") */
+    fadeWidth?: string;
+    /** Whether the marquee is playing or paused */
+    playing?: boolean;
+    /** Additional class names for the outer container */
+    className?: string;
+}
+
+export declare const marqueeVariants: (props?: ({
+    direction?: "left" | "right" | "up" | "down" | null | undefined;
+    fade?: boolean | null | undefined;
+} & ClassProp) | undefined) => string;
+
+export declare const Modal: {
+    ({ open, onClose, children, className, closeOnBackdropClick, closeOnEsc, ...props }: ModalProps): ReactPortal | null;
+    displayName: string;
+};
+
+export declare interface ModalProps {
+    /** Whether the modal is open */
+    open: boolean;
+    /** Callback fired when the modal requests to close */
+    onClose: () => void;
+    /** Content to render inside the modal */
+    children: ReactNode;
+    /** Accessible label for the modal dialog */
+    "aria-label"?: string;
+    /** Id of element that labels the modal */
+    "aria-labelledby"?: string;
+    /** Id of element that describes the modal */
+    "aria-describedby"?: string;
+    /** Additional class names for the modal content panel */
+    className?: string;
+    /** Whether clicking the backdrop closes the modal (default: true) */
+    closeOnBackdropClick?: boolean;
+    /** Whether pressing ESC closes the modal (default: true) */
+    closeOnEsc?: boolean;
+}
+
+export declare type NumberFormatStyle = "number" | "currency" | "percent" | "compact" | "decimal" | "unit" | "filesize" | "duration" | "ordinal" | "accounting";
+
+export declare type NumberNotation = "standard" | "compact" | "scientific" | "engineering";
+
+declare type PolymorphicProps<T extends ElementType, Props = object> = Props & Omit<ComponentPropsWithRef<T>, keyof Props | "ref"> & {
+    /** The HTML element or React component to render as */
+    as?: T;
+    ref?: PolymorphicRef<T>;
+};
+
+declare type PolymorphicRef<T extends ElementType> = ComponentPropsWithRef<T>["ref"];
+
+/**
+ * Radio group — renders a list of RadioItem components from options.
+ */
+export declare const Radio: ForwardRefExoticComponent<RadioProps & RefAttributes<HTMLFieldSetElement>>;
+
+/**
+ * Individual radio input — can be used standalone.
+ */
+export declare const RadioItem: ForwardRefExoticComponent<RadioItemProps & RefAttributes<HTMLInputElement>>;
+
+export declare interface RadioItemProps extends Omit<ComponentPropsWithRef<"input">, "ref" | "type" | "size"> {
+    /** Label text rendered next to the radio */
+    label?: ReactNode;
+    /** Description text rendered below the label */
+    description?: string;
+    /** Size variant */
+    size?: "sm" | "md" | "lg";
+    /** Unique id linking the label and radio */
+    id?: string;
+}
+
+export declare interface RadioOption {
+    /** Unique value for the radio option */
+    value: string;
+    /** Display label for the option */
+    label: ReactNode;
+    /** Description text rendered below the label */
+    description?: string;
+    /** Whether the option is disabled */
+    disabled?: boolean;
+}
+
+export declare interface RadioProps extends Omit<ComponentPropsWithRef<"fieldset">, "ref" | "onChange" | "defaultValue"> {
+    /** Label text rendered above the radio group */
+    label?: string;
+    /** Error message to display below the radio group */
+    error?: string;
+    /** Size variant */
+    size?: "sm" | "md" | "lg";
+    /** Unique name for the radio group */
+    name: string;
+    /** Controlled selected value */
+    value?: string;
+    /** Default selected value (uncontrolled) */
+    defaultValue?: string;
+    /** Callback when value changes */
+    onChange?: (value: string) => void;
+    /** List of radio options */
+    options: RadioOption[];
+    /** Layout direction */
+    direction?: "vertical" | "horizontal";
+    /** Unique id for the radio group */
+    id?: string;
+}
+
+export declare const radioVariants: (props?: ({
+    size?: "sm" | "md" | "lg" | null | undefined;
+} & ClassProp) | undefined) => string;
+
+export declare type Radius = keyof typeof radius;
+
+export declare const radius: {
+    readonly sm: "var(--radius-sm)";
+    readonly md: "var(--radius-md)";
+    readonly lg: "var(--radius-lg)";
+};
+
+export declare type SignDisplay = "auto" | "always" | "never" | "exceptZero";
+
+export declare const Skeleton: ForwardRefExoticComponent<SkeletonProps & RefAttributes<HTMLDivElement>>;
+
+export declare interface SkeletonProps extends Omit<ComponentPropsWithRef<"div">, "ref" | "children"> {
+    /** Shape of the skeleton placeholder */
+    variant?: "text" | "circular" | "rectangular" | "rounded";
+    /** Size preset (affects default height for text, diameter for circular, etc.) */
+    size?: "sm" | "md" | "lg";
+    /** Loading animation style */
+    animation?: "pulse" | "wave" | "none";
+    /** Width — number (px) or CSS string (e.g. "100%", "12rem") */
+    width?: number | string;
+    /** Height — number (px) or CSS string */
+    height?: number | string;
+    /** Number of text lines to render (only used with variant="text") */
+    lines?: number;
+    /** Gap between lines in px (only used when lines > 1, default 8) */
+    lineGap?: number;
+    /** Width of the last line for a natural paragraph look (default "75%") */
+    lastLineWidth?: string;
+}
+
+export declare const skeletonVariants: (props?: ({
+    variant?: "text" | "circular" | "rectangular" | "rounded" | null | undefined;
+    size?: "sm" | "md" | "lg" | null | undefined;
+    animation?: "none" | "pulse" | "wave" | null | undefined;
+} & ClassProp) | undefined) => string;
+
+export declare const Snackbar: {
+    ({ open, onClose, message, variant, position, autoCloseDuration, showCloseButton, action, icon, className, ...props }: SnackbarProps): ReactPortal | null;
+    displayName: string;
+};
+
+export declare type SnackbarPosition = "top-left" | "top-center" | "top-right" | "bottom-left" | "bottom-center" | "bottom-right";
+
+export declare interface SnackbarProps {
+    /** Whether the snackbar is visible */
+    open: boolean;
+    /** Callback fired when the snackbar requests to be closed */
+    onClose: () => void;
+    /** The message to display */
+    message: ReactNode;
+    /** Visual variant controlling colour and icon */
+    variant?: SnackbarVariant;
+    /** Where on the viewport the snackbar appears */
+    position?: SnackbarPosition;
+    /** Auto-close after this many milliseconds. `0` or `false` disables auto-close. */
+    autoCloseDuration?: number | false;
+    /** Show a close (✕) button */
+    showCloseButton?: boolean;
+    /** Optional action element (e.g. an "Undo" button) rendered after the message */
+    action?: ReactNode;
+    /** Optional icon override. Set to `null` to hide the default icon. */
+    icon?: ReactNode | null;
+    /** Additional class names for the snackbar container */
+    className?: string;
+    /** Accessible label for the snackbar region */
+    "aria-label"?: string;
+}
+
+export declare type SnackbarVariant = "info" | "success" | "warning" | "error";
+
+export declare const snackbarVariants: (props?: ({
+    variant?: "error" | "info" | "success" | "warning" | null | undefined;
+} & ClassProp) | undefined) => string;
+
+export declare type Spacing = keyof typeof spacing;
+
+export declare const spacing: {
+    readonly 1: "var(--space-1)";
+    readonly 2: "var(--space-2)";
+    readonly 4: "var(--space-4)";
+};
+
+export declare const Stack: ForwardRefExoticComponent<StackProps & RefAttributes<HTMLDivElement>>;
+
+export declare interface StackProps extends Omit<ComponentPropsWithRef<"div">, "ref">, StackVariantProps {
+}
+
+export declare type StackVariantProps = VariantProps<typeof stackVariants>;
+
+export declare const stackVariants: (props?: ({
+    direction?: "horizontal" | "vertical" | null | undefined;
+    gap?: 1 | 2 | 4 | null | undefined;
+    align?: "center" | "end" | "start" | "stretch" | null | undefined;
+    justify?: "center" | "end" | "start" | "between" | null | undefined;
+    wrap?: boolean | null | undefined;
+} & ClassProp) | undefined) => string;
+
+export declare const Stat: ForwardRefExoticComponent<StatProps & RefAttributes<HTMLDivElement>>;
+
+export declare const StatGroup: ForwardRefExoticComponent<StatGroupProps & RefAttributes<HTMLDivElement>>;
+
+export declare interface StatGroupProps {
+    /** Number of columns (defaults to child count) */
+    columns?: 1 | 2 | 3 | 4 | 5 | 6;
+    /** Gap between items */
+    gap?: "2" | "4" | "6" | "8";
+    /** Whether to add dividers between items */
+    dividers?: boolean;
+    /** Additional class names */
+    className?: string;
+    children: ReactNode;
+}
+
+export declare const statGroupVariants: (props?: ({
+    columns?: 1 | 2 | 3 | 4 | 5 | 6 | null | undefined;
+    gap?: "2" | "4" | "6" | "8" | null | undefined;
+    dividers?: boolean | null | undefined;
+} & ClassProp) | undefined) => string;
+
+export declare interface StatProps {
+    /** The numeric value to display (will be animated) */
+    value: number;
+    /** Label displayed below the value */
+    label: string;
+    /** Prefix rendered before the value (e.g. "$", "€") */
+    prefix?: string;
+    /** Suffix rendered after the value (e.g. "%", "users") */
+    suffix?: string;
+    /** Number formatting style */
+    format?: "number" | "currency" | "percent" | "compact";
+    /** Locale string for Intl.NumberFormat (default: "en-US") */
+    locale?: string;
+    /** Number of decimal places */
+    decimals?: number;
+    /** Duration of the counting animation in milliseconds */
+    animationDuration?: number;
+    /** Whether counting animation is enabled */
+    animated?: boolean;
+    /** Trend direction — shows an arrow indicator */
+    trend?: "up" | "down" | "neutral";
+    /** Text shown next to the trend indicator (e.g. "+12%", "-3.2%") */
+    trendValue?: string;
+    /** Optional icon rendered above / beside the value */
+    icon?: ReactNode;
+    /** Visual variant */
+    variant?: "default" | "bordered" | "filled" | "minimal";
+    /** Size variant */
+    size?: "sm" | "md" | "lg";
+    /** Additional class names */
+    className?: string;
+}
+
+export declare const statVariants: (props?: ({
+    variant?: "default" | "filled" | "bordered" | "minimal" | null | undefined;
+    size?: "sm" | "md" | "lg" | null | undefined;
+} & ClassProp) | undefined) => string;
+
+export declare const Switch: ForwardRefExoticComponent<SwitchProps & RefAttributes<HTMLInputElement>>;
+
+export declare interface SwitchProps extends Omit<ComponentPropsWithRef<"input">, "ref" | "type" | "size"> {
+    /** Label text rendered next to the switch */
+    label?: ReactNode;
+    /** Description text rendered below the label */
+    description?: string;
+    /** Error message to display below the switch */
+    error?: string;
+    /** Size variant */
+    size?: "sm" | "md" | "lg";
+    /** Unique id linking the label and switch */
+    id?: string;
+}
+
+/**
+ * Track — the pill-shaped container the knob sits inside.
+ * Grey when off, primary when on.
+ */
+export declare const switchVariants: (props?: ({
+    size?: "sm" | "md" | "lg" | null | undefined;
+} & ClassProp) | undefined) => string;
+
+export declare interface TabItem {
+    /** Unique key identifying this tab */
+    key: string;
+    /** Tab label (rendered in the trigger) */
+    label: ReactNode;
+    /** Tab panel content */
+    content: ReactNode;
+    /** Optional icon rendered before the label */
+    icon?: ReactNode;
+    /** Whether this tab is disabled */
+    disabled?: boolean;
+}
+
+export declare const Tabs: ForwardRefExoticComponent<TabsProps & RefAttributes<HTMLDivElement>>;
+
+export declare interface TabsProps {
+    /** Array of tab definitions */
+    items: TabItem[];
+    /** Currently active tab key (controlled) */
+    activeKey?: string;
+    /** Default active tab key (uncontrolled) */
+    defaultActiveKey?: string;
+    /** Callback when active tab changes */
+    onTabChange?: (key: string) => void;
+    /** Visual variant */
+    variant?: "underline" | "pills" | "bordered" | "lifted";
+    /** Size variant */
+    size?: "sm" | "md" | "lg";
+    /** Whether the tabs stretch to fill the container */
+    fullWidth?: boolean;
+    /** Tab alignment when not fullWidth */
+    align?: "start" | "center" | "end";
+    /** Whether tab panels have a transition animation */
+    animated?: boolean;
+    /** Orientation */
+    orientation?: "horizontal" | "vertical";
+    /** Additional class names for the root container */
+    className?: string;
+}
+
+export declare const tabsVariants: (props?: ({
+    orientation?: "horizontal" | "vertical" | null | undefined;
+} & ClassProp) | undefined) => string;
+
+export declare const Timeline: ForwardRefExoticComponent<TimelineProps & RefAttributes<HTMLDivElement>>;
+
+export declare const TimelineItem: ForwardRefExoticComponent<TimelineItemProps & {
+/* Excluded from this release type: _variant */
+/* Excluded from this release type: _size */
+/* Excluded from this release type: _orientation */
+/* Excluded from this release type: _lineStyle */
+/* Excluded from this release type: _isLast */
+/* Excluded from this release type: _trailingLine */
+/* Excluded from this release type: _alternate */
+/* Excluded from this release type: _index */
+} & RefAttributes<HTMLDivElement>>;
+
+export declare interface TimelineItemProps {
+    /** Primary title / heading */
+    title: string;
+    /** Supporting description or body content */
+    description?: ReactNode;
+    /** Timestamp or date string */
+    date?: string;
+    /** Custom icon rendered inside the dot */
+    icon?: ReactNode;
+    /** Dot color — maps to Tailwind color classes */
+    color?: "primary" | "secondary" | "green" | "red" | "yellow" | "gray";
+    /** Status of this timeline step */
+    status?: "completed" | "active" | "pending";
+    /** Additional class names for this item */
+    className?: string;
+}
+
+export declare interface TimelineProps {
+    /** Timeline items */
+    children: ReactNode;
+    /** Visual variant */
+    variant?: "default" | "outlined" | "filled";
+    /** Size variant */
+    size?: "sm" | "md" | "lg";
+    /** Layout direction */
+    orientation?: "vertical" | "horizontal";
+    /** Line style between items */
+    lineStyle?: "solid" | "dashed" | "dotted";
+    /** Whether the last item shows a trailing line */
+    trailingLine?: boolean;
+    /** Alternate items on left/right (vertical only) */
+    alternate?: boolean;
+    /** Additional class names for the container */
+    className?: string;
+}
+
+export declare const timelineVariants: (props?: ({
+    orientation?: "horizontal" | "vertical" | null | undefined;
+    size?: "sm" | "md" | "lg" | null | undefined;
+} & ClassProp) | undefined) => string;
+
+/**
+ * Return only the currency code.
+ * Convenience shortcut for `useLocale().currency`.
+ */
+export declare function useCurrency(): string;
+
+/**
+ * Return only the text direction.
+ * Convenience shortcut for `useLocale().direction`.
+ */
+export declare function useDirection(): "ltr" | "rtl";
+
+export declare function useFormatNumber(opts?: UseFormatNumberOptions): {
+    format: (value: number) => string;
+};
+
+export declare interface UseFormatNumberOptions {
+    /** Formatting style */
+    format?: NumberFormatStyle;
+    /** BCP 47 locale string */
+    locale?: string;
+    /** ISO 4217 currency code */
+    currency?: string;
+    /** How to display the currency */
+    currencyDisplay?: "symbol" | "narrowSymbol" | "code" | "name";
+    /** Number notation */
+    notation?: NumberNotation;
+    /** Sign display mode */
+    signDisplay?: SignDisplay;
+    /** Minimum fraction digits */
+    minimumFractionDigits?: number;
+    /** Maximum fraction digits */
+    maximumFractionDigits?: number;
+    /** Shorthand: sets both min and max fraction digits */
+    decimals?: number;
+    /** Unit for format="unit" */
+    unit?: string;
+    /** How to display the unit */
+    unitDisplay?: "short" | "long" | "narrow";
+    /** Prefix prepended to the formatted value */
+    prefix?: string;
+    /** Suffix appended to the formatted value */
+    suffix?: string;
+}
+
+/**
+ * Read the current locale context.
+ *
+ * - Inside a `<LocaleProvider>`: returns the provider's values.
+ * - Outside any provider: returns sensible defaults (`en-US`, `USD`, `ltr`).
+ */
+export declare function useLocale(): LocaleContextValue;
+
+/**
+ * Return only the locale string.
+ * Convenience shortcut for `useLocale().locale`.
+ */
+export declare function useLocaleString(): string;
+
+/**
+ * Return only the timezone.
+ * Convenience shortcut for `useLocale().timezone`.
+ */
+export declare function useTimezone(): string;
+
+export { }