import * as react from 'react';
import { ReactNode } from 'react';
import { ThemeOverrideProps } from '@xsolla/xui-core';

type StatusPalette = "default" | "success" | "warning" | "alert" | "neutral";
type StatusSize = "sm" | "md" | "lg";
type StatusLabelType = "primary" | "dot-color";
interface StatusProps extends ThemeOverrideProps {
    /** Content/label to display next to the status dot */
    children?: ReactNode;
    /** Color palette of the status indicator */
    palette?: StatusPalette;
    /** Size of the status dot */
    size?: StatusSize;
    /** Label color mode */
    labelType?: StatusLabelType;
    /** Accessible label for screen readers. Required for complex children or localized content. */
    "aria-label"?: string;
    /** Live region behavior for dynamic status updates */
    "aria-live"?: "polite" | "assertive" | "off";
    testID?: string;
    id?: string;
}

/**
 * Status - An accessible status indicator component
 *
 * Displays a colored dot with optional label to indicate status.
 *
 * ## Accessibility Features
 *
 * - **Semantic Role**: Uses `role="status"` by default (implies `aria-live="polite"`)
 * - **ARIA Label**: Auto-generates for string children; provide explicit `aria-label` for complex children or localization
 * - **Live Region**: `aria-live="assertive"` switches to `role="alert"`, `"off"` disables announcements
 *
 */
declare const Status: react.ForwardRefExoticComponent<StatusProps & react.RefAttributes<HTMLDivElement>>;

export { Status, type StatusLabelType, type StatusPalette, type StatusProps, type StatusSize };