import { CSSProperties, ReactElement, ReactNode } from 'react'; import { AnimatedNumberVariant } from '../motion/animated-number'; import { ChartLoadingStyle, ChartMotion, ChartPalette, ChartStyle, ChartSurface } from '../types'; export interface ProgressRange { id: string; label: string; value: number | null; /** Defaults to the card's `target`. */ target?: number; delta?: number; } export interface ProgressCardProps { /** Optional visible title. Use aria-label to name an embedded chart. */ title?: string; /** Show the header, including headline and period controls. Defaults to true. */ header?: boolean; /** Accessible name, independent of the visible title. */ 'aria-label'?: string; /** The measured amount. `null` shows a dash and an empty track, never zero. */ value?: number | null; /** The goal, in the same unit as the value. */ target: number; /** Words under the percentage. Defaults to "of goal". */ label?: string; /** * `ring` (default) is a thin full ring, `thick` a heavy ring around a soft disc, and `gauge` * a half ring that opens downward. */ variant?: 'ring' | 'thick' | 'gauge'; /** * Gives the ring depth: the fill is lit as a tube and the track becomes a groove. The arc keeps * its exact angle. */ depth?: boolean; /** Fractional change shown as a chip, e.g. 0.052 → +5.2%. */ delta?: number; deltaTone?: 'default' | 'inverse' | 'neutral'; /** Static period label, e.g. "Last 7 days". */ range?: string; /** Period select. Each range brings its own value, and optionally its own target and delta. */ ranges?: readonly ProgressRange[]; defaultRange?: string; /** Content below the ring, e.g. a note on how the goal was set. */ footer?: ReactNode; valueFormat?: Intl.NumberFormatOptions; locale?: string; formatValue?: (value: number) => string; /** Any CSS color for the progress. Defaults to the palette's first color. */ color?: string; surface?: ChartSurface; /** A glass tab tucked behind the card's top edge, e.g. a caption, a command, or actions. */ badge?: ReactNode; /** Headline motion: `count` (default), `pop`, `slide`, `roll`, `flow`, or `scramble`. */ numberStyle?: AnimatedNumberVariant; palette?: ChartPalette; loading?: boolean; loadingStyle?: ChartLoadingStyle; motion?: ChartMotion; className?: string; style?: CSSProperties | ChartStyle; } /** * One value against a goal: the value in the header, and a large ring or gauge with the * percentage reached. Past the goal the ring stays full and the percentage keeps counting. */ export declare function ProgressCard({ title, header, 'aria-label': ariaLabel, value: suppliedValue, target: suppliedTarget, label, variant, depth, delta: suppliedDelta, deltaTone, range, ranges, defaultRange, footer, valueFormat, locale, formatValue, color, surface, badge, numberStyle, palette, loading, loadingStyle, motion: motionMode, className, style, }: ProgressCardProps): ReactElement;