import { type SaasflareComponentProps } from "../../providers";
/** A single segment of the bar. */
export interface CategoryBarSegment {
    /** Numeric value driving the segment width (auto-normalized). */
    value: number;
    /** Any CSS color. Falls back to a derived primary tint. */
    color?: string;
    /** Optional label shown below the segment when `showLabels` is true. */
    label?: string;
}
/** Props for the CategoryBar component. */
export interface CategoryBarProps extends SaasflareComponentProps {
    /** Segments to render, left-to-right. */
    segments: CategoryBarSegment[];
    /** Bar height in pixels. Default: `8`. */
    height?: number;
    /** Render labels + percentages under each segment. */
    showLabels?: boolean;
    /** Formats the percentage text. Default: `"NN%"`. */
    valueFormatter?: (percent: number) => string;
    /** Additional class names. */
    className?: string;
    /** Accessible label for the bar group. */
    "aria-label"?: string;
}
/**
 * Segmented progress bar with optional labels.
 *
 * @component
 * @layer core
 */
export declare function CategoryBar({ segments, height, showLabels, valueFormatter, className, surface, radius, animated, iconWeight, "aria-label": ariaLabel, }: CategoryBarProps): import("react/jsx-runtime").JSX.Element | null;