import { CommonProps, Refable, type Styleable } from "@trackunit/react-components";
import { ReactElement, ReactNode } from "react";
export interface LabelProps extends CommonProps, Refable<HTMLLabelElement>, Styleable {
    /**
     * ID of the label.
     */
    id?: string;
    /**
     * Specifies the element to which the label belongs to.
     */
    htmlFor?: string;
    /**
     * The label value.
     */
    children?: ReactNode;
    /**
     * Whether the label is disabled or not.
     */
    disabled?: boolean;
    /**
     * A boolean flag to set invalid mode
     * can be used for indicating errors
     */
    isInvalid?: boolean;
}
/**
 * Label renders a styled `<label>` element for form input fields.
 * This component is typically **not used directly** — it is rendered internally by `FormGroup` and
 * all Field components (e.g., `TextField`, `CheckboxField`, `TimeRangeField`). Use it only when
 * building a custom form group layout that cannot use `FormGroup`.
 *
 * ### When to use
 * Use Label only when constructing a custom form field wrapper that cannot use `FormGroup`.
 *
 * ### When not to use
 * Do not use Label directly for standard form fields — use the appropriate Field component (e.g., `TextField`, `CheckboxField`) which includes Label automatically.
 *
 * @param {LabelProps} props - The props for the Label component
 * @returns {ReactElement} Label component
 */
export declare const Label: ({ id, htmlFor, children, className, "data-testid": dataTestId, disabled, isInvalid, style, ref, }: LabelProps) => ReactElement;