/**
 * @file Badge.tsx
 * @input Uses React, HTMLAttributes
 * @output Exports Badge component, BadgeProps, BadgeVariant types
 * @position Core implementation; consumed by index.ts
 *
 * SYNC: When modified, update these files to stay in sync:
 * - /packages/core/src/Badge/Badge.doc.mjs (props table, features, implementation notes)
 * - /packages/core/src/Badge/Badge.test.tsx (tests for new/changed behavior)
 * - /packages/core/src/Badge/index.ts (exports if types change)
 * - /apps/storybook/stories/Badge.stories.tsx (storybook stories)
 * - /packages/cli/assets/templates/blocks/components/Badge/ (showcase blocks)
 */
import type { ReactNode } from 'react';
import type { BaseProps } from '../BaseProps';
import type { BadgeVariantMap } from './index';
/**
 * Badge variant type derived from BadgeVariantMap.
 * Extensible via module augmentation of BadgeVariantMap.
 */
export type BadgeVariant = keyof BadgeVariantMap;
export interface BadgeProps extends BaseProps<HTMLSpanElement> {
    /** Ref forwarded to the root element */
    ref?: React.Ref<HTMLSpanElement>;
    /**
     * The visual style variant of the badge.
     * @default 'neutral'
     */
    variant?: BadgeVariant;
    /**
     * The badge label text.
     */
    label: ReactNode;
    /**
     * Optional icon to display before the label.
     */
    icon?: ReactNode;
}
/**
 * A badge component for displaying status indicators, counts, or labels.
 *
 * Styles use Astryx theme tokens via StyleX.
 * Wrap your app in <Theme> to apply a theme.
 *
 * @example
 * ```
 * <Badge label="Active" />
 * <Badge variant="success" label="Active" />
 * <Badge variant="error" label="3" />
 * <Badge variant="purple" label="Engineering" />
 * ```
 */
export declare function Badge({ variant, label, icon, xstyle, className, style, ref, ...props }: BadgeProps): import("react").JSX.Element;
export declare namespace Badge {
    var displayName: string;
}
//# sourceMappingURL=Badge.d.ts.map