/**
 * Meter: a semantic gauge for a known, bounded measurement (disk usage, a
 * score, remaining quota). A leaf: one root `role="meter"` node carrying the
 * ARIA value range, containing a single fill `<div>` whose width reflects the
 * clamped percentage. Unlike a ProgressBar (task completion), a Meter reports a
 * static reading. Colour tokens follow the repo's `--status-*` semantic palette
 * (matching `Status`) so `success`/`warning`/`danger` read consistently.
 *
 * @example
 * ```tsx
 * import { Meter } from "veryfront/ui";
 *
 * <Meter value={82} variant="warning" label="Disk 82% full" />;
 * ```
 *
 * @module react/components/ui/meter
 */
import * as React from "react";
import { type VariantProps } from "./cva.js";
/** Fill colour by semantic variant: token-pure, keyed to the repo palette. */
declare const meterFill: (props?: ({
    variant?: "default" | "success" | "warning" | "danger" | null | undefined;
} & {
    class?: import("../../../utils/clsx.js").ClassValue;
    className?: import("../../../utils/clsx.js").ClassValue;
}) | undefined) => string;
/** Props accepted by `<Meter>`. */
export interface MeterProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "children">, VariantProps<typeof meterFill> {
    /** Current reading. Clamped into `[min, max]`. @default (required) */
    value: number;
    /** Lower bound of the range. @default 0 */
    min?: number;
    /** Upper bound of the range. @default 100 */
    max?: number;
    /** Semantic colour of the fill. @default "default" */
    variant?: "default" | "success" | "warning" | "danger";
    /** Human-readable reading for assistive tech (`aria-valuetext`). @default undefined */
    label?: string;
    /** React 19: ref is a regular prop. */
    ref?: React.Ref<HTMLDivElement>;
}
/** Render a semantic gauge with a fill sized to the clamped value. */
export declare function Meter({ value, min, max, variant, label, className, ref, ...props }: MeterProps): React.ReactElement;
export {};
//# sourceMappingURL=meter.d.ts.map