/**
 * @usevyre/react — Stat + StatGroup
 *
 * AI CONTEXT:
 * ┌──────────────────────────────────────────────────────────────────┐
 * │ Component:  Stat (+ StatGroup)                                    │
 * │ Import:     import { Stat, StatGroup } from "@usevyre/react"       │
 * │                                                                   │
 * │ Presentational dashboard KPI. No state.                           │
 * │                                                                   │
 * │   label        = string (required)                                │
 * │   value        = string | number (required, large)                │
 * │   delta?       = string | number  (the change amount)             │
 * │   trend?       = "up" | "down" | "neutral"  (CONTROLS the color   │
 * │                   — up=success, down=danger, neutral=muted)        │
 * │   deltaLabel?  = string  (e.g. "vs last month")                   │
 * │   icon?        = ReactNode                                         │
 * │   size         = "sm" | "md"(default) | "lg"                      │
 * │                                                                   │
 * │ trend is EXPLICIT so "churn down = good" can stay green.          │
 * │ Wrap several in <StatGroup> for an evenly-split row with dividers.│
 * └──────────────────────────────────────────────────────────────────┘
 *
 * @example
 * <StatGroup>
 *   <Stat label="Revenue" value="$48.2k" delta="+12%" trend="up"
 *         deltaLabel="vs last month" />
 *   <Stat label="Churn" value="2.1%" delta="-0.4%" trend="up"
 *         deltaLabel="lower is better" />
 *   <Stat label="Orders" value="1,204" delta="0%" trend="neutral" />
 * </StatGroup>
 */
import React from "react";
import type { BaseProps } from "../../types";
export type StatTrend = "up" | "down" | "neutral";
export interface StatProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "title">, BaseProps {
    /** Metric name (required) */
    label: string;
    /** The headline figure (required) */
    value: string | number;
    /** The change amount, e.g. "+12%" or 24 */
    delta?: string | number;
    /** Explicitly sets the delta color — up=success, down=danger, neutral=muted */
    trend?: StatTrend;
    /** Context for the delta, e.g. "vs last month" */
    deltaLabel?: string;
    /** Optional leading icon */
    icon?: React.ReactNode;
    size?: "sm" | "md" | "lg";
}
export declare const Stat: React.ForwardRefExoticComponent<StatProps & React.RefAttributes<HTMLDivElement>>;
export interface StatGroupProps extends React.HTMLAttributes<HTMLDivElement>, BaseProps {
    children?: React.ReactNode;
}
export declare const StatGroup: React.ForwardRefExoticComponent<StatGroupProps & React.RefAttributes<HTMLDivElement>>;