import type * as React from 'react';
import type { PolymorphicTag, PrimitivePropsWithRef } from '../utils/primitive.cjs';
/** The cancelable `CustomEvent` a {@link BadgeProps.onDelete} handler receives when a badge asks to be removed. */
export type BadgeDeleteEvent = CustomEvent<null>;
/** @internal Shared state distributed from {@link Badge} to its parts via context. */
export interface BadgeContextValue {
    /** The badge's own text, used to name the delete button and the removal announcement. */
    label: string;
    /** The word the delete button's generated name is built from — "Remove <label>". */
    deleteLabel: string;
    /** Whether this badge (or the whole group) is disabled. */
    disabled: boolean;
    /** Whether this badge reads as chosen. */
    selected: boolean;
    /** Dispatches the cancelable `delete`; if it survives, moves focus to a neighbour and announces the removal. No-op when disabled or without `onDelete`. */
    remove: () => void;
    /** Whether this badge sits inside a `TagGroup`. False when standalone, where removal has no group to resolve focus against. */
    grouped: boolean;
}
/** Props for the {@link Badge} root. */
export interface BadgeProps extends PrimitivePropsWithRef<'span'> {
    /**
     * Element name to render instead of the default `<span>`, from the library's tag allowlist; use `asChild` for an element needing its own attributes.
     * @default 'span'
     */
    as?: PolymorphicTag | undefined;
    /**
     * Renders a `BadgeLeading` slot before `children`.
     * @default undefined
     */
    leading?: React.ReactNode | undefined;
    /**
     * Renders a `BadgeTrailing` slot after `children`.
     * @default undefined
     */
    trailing?: React.ReactNode | undefined;
    /**
     * The badge's text, used to name the derived `BadgeDelete` and to announce the removal; rendered into a derived `BadgeLabel` when `children` is omitted.
     * @default '' — the delete button is named just "Remove" and removal is silent.
     */
    label?: string | undefined;
    /**
     * This badge's position in the rendered list, used to pick the group's single Tab stop; must match render order.
     * @default undefined — standalone, with no roving order to take part in.
     */
    index?: number | undefined;
    /**
     * Whether this badge reads as chosen, mirrored as `data-selected`; presentation only, no ARIA selection state.
     * @default false
     */
    selected?: boolean | undefined;
    /**
     * Disables this badge alone — it cannot be deleted, its delete button is disabled, and arrow-key navigation skips it; OR-ed with the group's own `disabled`.
     * @default false
     */
    disabled?: boolean | undefined;
    /**
     * Renders a derived `BadgeDelete`; ignored when `children` is given.
     * @default false
     */
    deletable?: boolean | undefined;
    /**
     * The word the derived `BadgeDelete`'s accessible name is built from — `"<deleteLabel> <label>"`.
     * @default 'Remove'
     */
    deleteLabel?: string | undefined;
    /**
     * Removes this badge from wherever the consumer renders it; call `preventDefault()` on the {@link BadgeDeleteEvent} to hold the removal for a confirmation step.
     * @default undefined — the badge is static: Delete/Backspace do nothing and `BadgeDelete` is inert.
     */
    onDelete?: ((event: BadgeDeleteEvent) => void) | undefined;
    /**
     * Renders the skin's text-free circle form, mirrored as a bare `data-dot`.
     * @default undefined — the badge renders its text.
     */
    dot?: boolean | undefined;
    /**
     * Corner rung the skin rounds the badge by, mirrored to `data-shape`.
     * @default undefined — the skin's own default corner.
     */
    shape?: 'pill' | 'rounded' | (string & {}) | undefined;
    /**
     * Size rung the skin scales the badge by, mirrored to `data-size` on the root.
     * @default undefined — the skin's own default size.
     */
    size?: 'sm' | 'md' | 'lg' | (string & {}) | undefined;
    /**
     * Severity rung the skin colours the badge by, mirrored to `data-status`.
     * @default undefined — the skin's own neutral styling.
     */
    status?: 'info' | 'success' | 'warning' | 'danger' | (string & {}) | undefined;
    /**
     * Visual weight rung the skin reads, mirrored to `data-variant` on the root.
     * @default undefined — the skin's own default weight.
     */
    variant?: 'solid' | 'outline' | 'subtle' | (string & {}) | undefined;
}
/** Props for {@link BadgeLeading}, the slot before a {@link Badge}'s text. */
export interface BadgeLeadingProps extends PrimitivePropsWithRef<'span'> {
}
/** Props for {@link BadgeTrailing}, the slot after a {@link Badge}'s text. */
export interface BadgeTrailingProps extends PrimitivePropsWithRef<'span'> {
}
/** Props for {@link BadgeLabel}, the wrapper around a {@link Badge}'s visible text. */
export interface BadgeLabelProps extends PrimitivePropsWithRef<'span'> {
}
/** Props for {@link BadgeDelete}, the button that removes its parent {@link Badge}. */
export interface BadgeDeleteProps extends PrimitivePropsWithRef<'button'> {
}