import { BadgeCountVariant } from '@mezzanine-ui/core/badge';
/**
 * 徽章元件，用於顯示數字計數、狀態圓點或文字標籤。
 *
 * 支援四種 variant 類型：count（數字計數）、dot（狀態圓點）、dot 含文字以及 text（純文字標籤）。
 * 計數型徽章可設定 `overflowCount` 限制最大顯示數值；當 `count` 為 0 時徽章自動隱藏。
 * 使用 `children` 時（僅限 dot 型），徽章會以覆疊方式出現在子元素右上角。
 *
 * @example
 * ```tsx
 * import Badge from '@mezzanine-ui/react/Badge';
 *
 * // 數字計數徽章
 * <Badge variant="count-alert" count={5} />
 *
 * // 超出上限顯示 99+
 * <Badge variant="count-brand" count={120} overflowCount={99} />
 *
 * // 狀態圓點（附著於圖示右上角）
 * <Badge variant="dot-alert">
 *   <BellIcon />
 * </Badge>
 *
 * // 文字徽章
 * <Badge variant="text-brand" text="NEW" />
 * ```
 *
 * @see {@link BadgeContainer} 搭配容器元件使用絕對定位覆疊效果
 */
declare const Badge: import("react").ForwardRefExoticComponent<(Omit<Omit<NativeElementPropsWithoutKeyAndRef<"span">, "children"> & {
    children?: never;
    count: number;
    overflowCount?: number;
    size?: never;
    text?: never;
    variant: BadgeCountVariant;
}, "ref"> | Omit<Omit<NativeElementPropsWithoutKeyAndRef<"span">, "children"> & {
    children?: never;
    count?: never;
    overflowCount?: never;
    size?: import("@mezzanine-ui/core/badge").BadgeTextSize;
    text?: string;
    variant: import("@mezzanine-ui/core/badge").BadgeDotVariant;
}, "ref"> | Omit<Omit<NativeElementPropsWithoutKeyAndRef<"span">, "children"> & {
    children?: import("react").ReactNode;
    count?: never;
    overflowCount?: never;
    size?: never;
    text?: never;
    variant: import("@mezzanine-ui/core/badge").BadgeDotVariant;
}, "ref"> | Omit<Omit<NativeElementPropsWithoutKeyAndRef<"span">, "children"> & {
    children?: never;
    count?: never;
    overflowCount?: never;
    size?: import("@mezzanine-ui/core/badge").BadgeTextSize;
    text: string;
    variant: import("@mezzanine-ui/core/badge").BadgeTextVariant;
}, "ref">) & import("react").RefAttributes<HTMLSpanElement>>;
export default Badge;