import * as React from "react";
import * as LabelPrimitive from "@radix-ui/react-label";
/**
 * Label Component
 *
 * An accessible label component built on Radix UI Label primitive.
 * Provides proper accessibility for form controls with automatic associations.
 *
 * @example
 * ```tsx
 * // Basic usage
 * <Label htmlFor="email">Email Address</Label>
 * <Input id="email" type="email" />
 *
 * // With required indicator
 * <Label htmlFor="password" required>Password</Label>
 * <Input id="password" type="password" />
 *
 * // With optional indicator
 * <Label htmlFor="phone" optional>Phone Number</Label>
 * <Input id="phone" type="tel" />
 * ```
 */
export interface LabelProps extends React.ComponentPropsWithoutRef<typeof LabelPrimitive.Root> {
    /**
     * Shows a required indicator (*)
     */
    required?: boolean;
    /**
     * Shows an optional indicator (optional)
     */
    optional?: boolean;
}
declare const Label: React.ForwardRefExoticComponent<LabelProps & React.RefAttributes<HTMLLabelElement>>;
export { Label };
//# sourceMappingURL=label.d.ts.map