@compa11y/react 0.1.0 → 0.1.3

package/dist/index.d.cts

@@ -1,5 +1,5 @@
 import * as React$1 from 'react';
-import React__default from 'react';
+import React__default, { ReactNode, InputHTMLAttributes, ButtonHTMLAttributes, TextareaHTMLAttributes } from 'react';
 import { FocusTrapOptions, AnnouncerOptions, KeyboardHandlers } from '@compa11y/core';
 export { announce, announceAssertive, announceError, announcePolite, announceProgress, announceStatus, aria, buildAriaProps, checks, createComponentWarnings, hasAccessibleName, isAndroid, isBrowser, isIOS, isMac, mergeAriaIds, prefersDarkMode, prefersHighContrast, prefersReducedMotion, setWarningHandler, warn } from '@compa11y/core';
 export { DialogCompound as Dialog, DialogActions, DialogActionsProps, Dialog as DialogBase, DialogClose, DialogCloseProps, DialogContent, DialogContentProps, DialogContextValue, DialogDescription, DialogDescriptionProps, DialogProps, DialogTitle, DialogTitleProps, DialogTrigger, DialogTriggerProps, useDialogContext } from './components/dialog/index.cjs';
@@ -7,7 +7,7 @@ export { ActionMenuCompound as ActionMenu, ActionMenu as ActionMenuBase, ActionM
 export { Tab, TabList, TabListProps, TabPanel, TabPanelProps, TabProps, TabsCompound as Tabs, Tabs as TabsBase, TabsContextValue, TabsProps, useTabsContext } from './components/tabs/index.cjs';
 export { Toast, ToastProvider, ToastProviderProps, ToastType, ToastViewport, ToastViewportProps, useToast, useToastHelpers } from './components/toast/index.cjs';
 export { ComboboxCompound as Combobox, Combobox as ComboboxBase, ComboboxInput, ComboboxInputProps, ComboboxListbox, ComboboxListboxProps, ComboboxOption, ComboboxOptionProps, ComboboxOption as ComboboxOptionType, ComboboxProps } from './components/combobox/index.cjs';
-import 'react/jsx-runtime';
+import * as react_jsx_runtime from 'react/jsx-runtime';
 
 /**
  * Generate a unique ID for accessibility purposes
@@ -358,6 +358,385 @@ declare function useRovingTabindexMap<T extends string>(ids: T[], options?: Omit
     previous: () => void;
 };
 
+interface SelectOption {
+    value: string;
+    label: string;
+    disabled?: boolean;
+}
+/**
+ * Accessible Select component
+ *
+ * A dropdown selection component following WAI-ARIA Listbox pattern.
+ * Unlike Combobox, Select uses a button trigger and does not support text filtering.
+ *
+ * @example
+ * ```tsx
+ * <Select
+ *   options={[
+ *     { value: 'apple', label: 'Apple' },
+ *     { value: 'banana', label: 'Banana' },
+ *   ]}
+ *   value={value}
+ *   onValueChange={setValue}
+ *   aria-label="Choose a fruit"
+ * >
+ *   <Select.Trigger placeholder="Pick a fruit..." />
+ *   <Select.Listbox />
+ * </Select>
+ * ```
+ */
+interface SelectProps {
+    /** List of options */
+    options: SelectOption[];
+    /** Controlled selected value */
+    value?: string | null;
+    /** Default value for uncontrolled mode */
+    defaultValue?: string;
+    /** Called when selection changes */
+    onValueChange?: (value: string | null) => void;
+    /** Whether the select is disabled */
+    disabled?: boolean;
+    /** Placeholder text when no value is selected */
+    placeholder?: string;
+    /** Accessible label */
+    'aria-label'?: string;
+    /** ID of labelling element */
+    'aria-labelledby'?: string;
+    children: React__default.ReactNode;
+}
+declare function Select({ options, value: controlledValue, defaultValue, onValueChange, disabled, placeholder, 'aria-label': ariaLabel, 'aria-labelledby': ariaLabelledBy, children, }: SelectProps): react_jsx_runtime.JSX.Element;
+interface SelectTriggerProps extends Omit<React__default.ButtonHTMLAttributes<HTMLButtonElement>, 'value'> {
+}
+declare const SelectTrigger: React__default.ForwardRefExoticComponent<SelectTriggerProps & React__default.RefAttributes<HTMLButtonElement>>;
+interface SelectListboxProps extends React__default.HTMLAttributes<HTMLUListElement> {
+    children?: React__default.ReactNode;
+}
+declare const SelectListbox: React__default.ForwardRefExoticComponent<SelectListboxProps & React__default.RefAttributes<HTMLUListElement>>;
+interface SelectOptionProps extends React__default.LiHTMLAttributes<HTMLLIElement> {
+    option: SelectOption;
+    index: number;
+}
+declare const SelectOptionItem: React__default.ForwardRefExoticComponent<SelectOptionProps & React__default.RefAttributes<HTMLLIElement>>;
+declare const SelectCompound: typeof Select & {
+    Trigger: React__default.ForwardRefExoticComponent<SelectTriggerProps & React__default.RefAttributes<HTMLButtonElement>>;
+    Listbox: React__default.ForwardRefExoticComponent<SelectListboxProps & React__default.RefAttributes<HTMLUListElement>>;
+    Option: React__default.ForwardRefExoticComponent<SelectOptionProps & React__default.RefAttributes<HTMLLIElement>>;
+};
+
+/**
+ * Checkbox Component
+ *
+ * Accessible checkbox and checkbox group components following WAI-ARIA patterns.
+ * Supports single checkboxes, checkbox groups with fieldset/legend, indeterminate
+ * (tri-state) for "select all" patterns, and full keyboard/screen reader support.
+ *
+ * @example
+ * ```tsx
+ * // Single checkbox
+ * <Checkbox label="Accept terms" checked={agreed} onCheckedChange={setAgreed} />
+ *
+ * // With hint text
+ * <Checkbox label="Subscribe" hint="We'll email you weekly." />
+ *
+ * // Indeterminate (select all)
+ * <Checkbox label="Select all" indeterminate={someChecked} checked={allChecked}
+ *   onCheckedChange={handleSelectAll} />
+ *
+ * // Checkbox group
+ * <Checkbox.Group legend="Select toppings" value={toppings} onValueChange={setToppings}>
+ *   <Checkbox value="cheese" label="Cheese" />
+ *   <Checkbox value="peppers" label="Peppers" />
+ *   <Checkbox value="olives" label="Olives" />
+ * </Checkbox.Group>
+ * ```
+ */
+
+interface CheckboxGroupContextValue {
+    /** Group name for form submission */
+    name: string;
+    /** Currently selected values */
+    value: string[];
+    /** Whether all checkboxes in the group are disabled */
+    disabled: boolean;
+    /** Whether to remove default styles */
+    unstyled: boolean;
+    /** Called when a checkbox in the group changes */
+    onCheckboxChange: (checkboxValue: string, checked: boolean) => void;
+}
+interface CheckboxGroupProps {
+    /** Controlled selected values */
+    value?: string[];
+    /** Default selected values (uncontrolled) */
+    defaultValue?: string[];
+    /** Called when selected values change */
+    onValueChange?: (value: string[]) => void;
+    /** Whether all checkboxes are disabled */
+    disabled?: boolean;
+    /** Group label displayed as fieldset legend */
+    legend?: React__default.ReactNode;
+    /** Group-level error message */
+    error?: React__default.ReactNode;
+    /** Layout orientation */
+    orientation?: 'horizontal' | 'vertical';
+    /** Group name for native inputs */
+    name?: string;
+    /** Remove default styles */
+    unstyled?: boolean;
+    /** Custom class name */
+    className?: string;
+    /** Children (Checkbox components) */
+    children: React__default.ReactNode;
+    /** Accessible label (if no visible legend) */
+    'aria-label'?: string;
+    /** Reference to external label element */
+    'aria-labelledby'?: string;
+}
+interface CheckboxProps extends Omit<React__default.InputHTMLAttributes<HTMLInputElement>, 'onChange' | 'type' | 'checked' | 'defaultChecked' | 'size'> {
+    /** Controlled checked state */
+    checked?: boolean;
+    /** Default checked state (uncontrolled) */
+    defaultChecked?: boolean;
+    /** Called when checked state changes */
+    onCheckedChange?: (checked: boolean) => void;
+    /** Whether the checkbox is in indeterminate/mixed state */
+    indeterminate?: boolean;
+    /** Visible label text */
+    label?: React__default.ReactNode;
+    /** Helper/description text */
+    hint?: React__default.ReactNode;
+    /** Error message */
+    error?: React__default.ReactNode;
+    /** Whether the checkbox is disabled */
+    disabled?: boolean;
+    /** Value for use in checkbox groups */
+    value?: string;
+    /** Whether the checkbox is required */
+    required?: boolean;
+    /** Remove default styles */
+    unstyled?: boolean;
+    /** Custom class name */
+    className?: string;
+    /** Size variant */
+    size?: 'sm' | 'md' | 'lg';
+}
+interface CheckboxIndicatorProps {
+    /** Custom indicator content (replaces default checkmark/dash) */
+    children?: React__default.ReactNode;
+    /** Custom class name */
+    className?: string;
+}
+/**
+ * Access the CheckboxGroup context. Returns null if not within a group.
+ */
+declare function useCheckboxGroupContext(): CheckboxGroupContextValue | null;
+/**
+ * CheckboxGroup - Groups related checkboxes with fieldset/legend semantics.
+ *
+ * Uses `<fieldset>` and `<legend>` for proper screen reader group labeling.
+ * Manages an array of selected values for controlled/uncontrolled usage.
+ *
+ * @example
+ * ```tsx
+ * <Checkbox.Group legend="Toppings" value={toppings} onValueChange={setToppings}>
+ *   <Checkbox value="cheese" label="Cheese" />
+ *   <Checkbox value="peppers" label="Peppers" />
+ * </Checkbox.Group>
+ * ```
+ */
+declare const CheckboxGroup: React__default.ForwardRefExoticComponent<CheckboxGroupProps & React__default.RefAttributes<HTMLFieldSetElement>>;
+/**
+ * Checkbox - An accessible checkbox with label, hint, error, and indeterminate support.
+ *
+ * Uses a native `<input type="checkbox">` for proper form integration and
+ * built-in keyboard behavior (Space to toggle, Tab to focus).
+ *
+ * Supports standalone usage and usage within a CheckboxGroup.
+ *
+ * @example
+ * ```tsx
+ * // Standalone
+ * <Checkbox label="Accept terms" checked={agreed} onCheckedChange={setAgreed} />
+ *
+ * // With hint
+ * <Checkbox label="Subscribe" hint="Weekly newsletter" />
+ *
+ * // Indeterminate
+ * <Checkbox label="Select all" indeterminate={someSelected} />
+ *
+ * // In a group
+ * <Checkbox.Group legend="Options" value={selected} onValueChange={setSelected}>
+ *   <Checkbox value="a" label="Option A" />
+ *   <Checkbox value="b" label="Option B" />
+ * </Checkbox.Group>
+ * ```
+ */
+declare const Checkbox: React__default.ForwardRefExoticComponent<CheckboxProps & React__default.RefAttributes<HTMLInputElement>>;
+/**
+ * CheckboxIndicator - Optional custom indicator for compound usage.
+ *
+ * When used inside a checkbox, replaces the default checkmark/dash icons.
+ * Primarily for advanced customization scenarios.
+ */
+declare const CheckboxIndicator: React__default.ForwardRefExoticComponent<CheckboxIndicatorProps & React__default.RefAttributes<HTMLDivElement>>;
+declare const CheckboxCompound: React__default.ForwardRefExoticComponent<CheckboxProps & React__default.RefAttributes<HTMLInputElement>> & {
+    Group: React__default.ForwardRefExoticComponent<CheckboxGroupProps & React__default.RefAttributes<HTMLFieldSetElement>>;
+    Indicator: React__default.ForwardRefExoticComponent<CheckboxIndicatorProps & React__default.RefAttributes<HTMLDivElement>>;
+};
+
+/**
+ * RadioGroup Component
+ *
+ * An accessible radio group for single-selection from a set of options.
+ * Follows WAI-ARIA Radio Group pattern with roving tabindex and
+ * selection-follows-focus keyboard behavior.
+ *
+ * @example
+ * ```tsx
+ * // Controlled
+ * <RadioGroup value={color} onValueChange={setColor} aria-label="Favorite color">
+ *   <RadioGroup.Radio value="red">Red</RadioGroup.Radio>
+ *   <RadioGroup.Radio value="green">Green</RadioGroup.Radio>
+ *   <RadioGroup.Radio value="blue">Blue</RadioGroup.Radio>
+ * </RadioGroup>
+ *
+ * // Uncontrolled
+ * <RadioGroup defaultValue="red" aria-label="Favorite color">
+ *   <RadioGroup.Radio value="red">Red</RadioGroup.Radio>
+ *   <RadioGroup.Radio value="green">Green</RadioGroup.Radio>
+ * </RadioGroup>
+ *
+ * // With legend (fieldset semantics)
+ * <RadioGroup legend="Delivery speed" required>
+ *   <RadioGroup.Radio value="standard">Standard</RadioGroup.Radio>
+ *   <RadioGroup.Radio value="express">Express</RadioGroup.Radio>
+ *   <RadioGroup.Radio value="overnight">Overnight</RadioGroup.Radio>
+ * </RadioGroup>
+ *
+ * // With error validation
+ * <RadioGroup legend="Payment method" required error="Please select a payment method">
+ *   <RadioGroup.Radio value="card">Credit Card</RadioGroup.Radio>
+ *   <RadioGroup.Radio value="paypal">PayPal</RadioGroup.Radio>
+ * </RadioGroup>
+ * ```
+ */
+
+interface RadioGroupContextValue {
+    /** Group name for native radio inputs */
+    name: string;
+    /** Currently selected value */
+    value: string | null;
+    /** Whether all radios are disabled */
+    disabled: boolean;
+    /** Whether disabled radios remain discoverable in tab order */
+    discoverable: boolean;
+    /** Whether selection is required */
+    required: boolean;
+    /** Whether to remove default styles */
+    unstyled: boolean;
+    /** Layout orientation */
+    orientation: 'horizontal' | 'vertical';
+    /** Called when selected value changes */
+    onValueChange: (value: string) => void;
+    /** Register a radio option with the group */
+    registerRadio: (value: string, disabled: boolean) => void;
+    /** Unregister a radio option from the group */
+    unregisterRadio: (value: string) => void;
+    /** Update a radio's disabled state */
+    updateRadioDisabled: (value: string, disabled: boolean) => void;
+}
+interface RadioGroupProps {
+    /** Controlled value */
+    value?: string;
+    /** Default value (uncontrolled) */
+    defaultValue?: string;
+    /** Called when selected value changes */
+    onValueChange?: (value: string) => void;
+    /** Whether all radios are disabled */
+    disabled?: boolean;
+    /** Whether disabled radios remain discoverable in tab order */
+    discoverable?: boolean;
+    /** Whether selection is required */
+    required?: boolean;
+    /** Layout orientation */
+    orientation?: 'horizontal' | 'vertical';
+    /** Group name for native radio inputs */
+    name?: string;
+    /** Group label displayed as fieldset legend */
+    legend?: React__default.ReactNode;
+    /** Helper/description text */
+    hint?: React__default.ReactNode;
+    /** Error message */
+    error?: React__default.ReactNode;
+    /** Remove default styles */
+    unstyled?: boolean;
+    /** Custom class name */
+    className?: string;
+    /** Children (Radio components) */
+    children: React__default.ReactNode;
+    /** Accessible label (if no visible legend) */
+    'aria-label'?: string;
+    /** Reference to external label element */
+    'aria-labelledby'?: string;
+}
+interface RadioProps {
+    /** Value for this radio option (required) */
+    value: string;
+    /** Whether this individual radio is disabled */
+    disabled?: boolean;
+    /** Whether disabled radio remains discoverable */
+    discoverable?: boolean;
+    /** Label text (alternative to children) */
+    label?: React__default.ReactNode;
+    /** Helper/description text */
+    hint?: React__default.ReactNode;
+    /** Remove default styles */
+    unstyled?: boolean;
+    /** Custom class name */
+    className?: string;
+    /** Children (typically label text) */
+    children?: React__default.ReactNode;
+    /** Accessible label */
+    'aria-label'?: string;
+}
+/**
+ * Access the RadioGroup context.
+ * Throws if used outside a RadioGroup.
+ */
+declare function useRadioGroupContext(): RadioGroupContextValue;
+/**
+ * RadioGroup - Groups related radio buttons with proper ARIA semantics.
+ *
+ * Uses `role="radiogroup"` with optional `<fieldset>/<legend>` for proper
+ * screen reader group labeling. Implements roving tabindex and
+ * selection-follows-focus keyboard behavior.
+ *
+ * Keyboard support:
+ * - Tab: Move into/out of the group
+ * - Arrow Down/Right: Move to next radio and select it
+ * - Arrow Up/Left: Move to previous radio and select it
+ * - Home: Move to first radio and select it
+ * - End: Move to last radio and select it
+ * - Space: Select the focused radio
+ */
+declare const RadioGroup: React__default.ForwardRefExoticComponent<RadioGroupProps & React__default.RefAttributes<HTMLDivElement>>;
+/**
+ * Radio - Individual radio option for use within a RadioGroup.
+ *
+ * Uses a native `<input type="radio">` (visually hidden) for full
+ * accessibility, with a custom visual indicator overlay.
+ *
+ * @example
+ * ```tsx
+ * <RadioGroup.Radio value="option1">Option 1</RadioGroup.Radio>
+ * <RadioGroup.Radio value="option2" label="Option 2" />
+ * <RadioGroup.Radio value="option3" disabled>Option 3 (unavailable)</RadioGroup.Radio>
+ * ```
+ */
+declare const Radio: React__default.ForwardRefExoticComponent<RadioProps & React__default.RefAttributes<HTMLInputElement>>;
+declare const RadioGroupCompound: React__default.ForwardRefExoticComponent<RadioGroupProps & React__default.RefAttributes<HTMLDivElement>> & {
+    Radio: React__default.ForwardRefExoticComponent<RadioProps & React__default.RefAttributes<HTMLInputElement>>;
+};
+
 interface SwitchProps extends Omit<React__default.ButtonHTMLAttributes<HTMLButtonElement>, 'onChange' | 'role'> {
     /** Controlled checked state */
     checked?: boolean;
@@ -399,4 +778,382 @@ interface SwitchProps extends Omit<React__default.ButtonHTMLAttributes<HTMLButto
  */
 declare const Switch: React__default.ForwardRefExoticComponent<SwitchProps & React__default.RefAttributes<HTMLButtonElement>>;
 
-export { type RovingTabindexItem, Switch, type SwitchProps, type UseFocusTrapOptions, type UseRovingTabindexOptions, useAnnounceLoading, useAnnounceOnChange, useAnnouncer, useFocusControl, useFocusManager, useFocusTrap, useFocusTrapControls, useFocusVisible, useFocusWithin, useGridKeyboard, useId, useIdScope, useIds, useKeyPressed, useKeyboard, useMenuKeyboard, useRovingTabindex, useRovingTabindexMap, useTabsKeyboard, useTypeAhead };
+/**
+ * Listbox Component
+ *
+ * An accessible listbox for single or multi-selection from a visible list.
+ * Follows WAI-ARIA Listbox pattern with aria-activedescendant,
+ * type-ahead search, option groups, and full keyboard support.
+ *
+ * @example
+ * ```tsx
+ * // Single select (selection follows focus)
+ * <Listbox value={fruit} onValueChange={setFruit} aria-label="Favorite fruit">
+ *   <Listbox.Option value="apple">Apple</Listbox.Option>
+ *   <Listbox.Option value="banana" disabled>Banana</Listbox.Option>
+ *   <Listbox.Group label="Citrus">
+ *     <Listbox.Option value="orange">Orange</Listbox.Option>
+ *   </Listbox.Group>
+ * </Listbox>
+ *
+ * // Multi select (focus independent of selection)
+ * <Listbox multiple value={toppings} onValueChange={setToppings} aria-label="Toppings">
+ *   <Listbox.Option value="cheese">Cheese</Listbox.Option>
+ *   <Listbox.Option value="pepperoni">Pepperoni</Listbox.Option>
+ * </Listbox>
+ * ```
+ */
+
+interface ListboxContextValue {
+    multiple: boolean;
+    disabled: boolean;
+    discoverable: boolean;
+    unstyled: boolean;
+    orientation: 'horizontal' | 'vertical';
+    selectedValues: Set<string>;
+    focusedValue: string | null;
+    onSelect: (value: string) => void;
+    onFocusOption: (value: string) => void;
+    registerOption: (value: string, disabled: boolean, label: string) => void;
+    unregisterOption: (value: string) => void;
+    updateOptionDisabled: (value: string, disabled: boolean) => void;
+    isSelected: (value: string) => boolean;
+    listboxId: string;
+}
+interface ListboxProps {
+    /** Controlled value — string for single, string[] for multi */
+    value?: string | string[];
+    /** Default value (uncontrolled) */
+    defaultValue?: string | string[];
+    /** Called when selection changes */
+    onValueChange?: (value: string | string[]) => void;
+    /** Enable multi-select mode */
+    multiple?: boolean;
+    /** Disable all options */
+    disabled?: boolean;
+    /** Keep disabled listbox in tab order */
+    discoverable?: boolean;
+    /** Layout orientation */
+    orientation?: 'horizontal' | 'vertical';
+    /** Remove default styles */
+    unstyled?: boolean;
+    /** Custom class name */
+    className?: string;
+    /** Children (Option and Group components) */
+    children: React__default.ReactNode;
+    /** Accessible label */
+    'aria-label'?: string;
+    /** Reference to external label element */
+    'aria-labelledby'?: string;
+}
+interface ListboxOptionProps {
+    /** Value for this option (required) */
+    value: string;
+    /** Whether this option is disabled */
+    disabled?: boolean;
+    /** Keep disabled option discoverable */
+    discoverable?: boolean;
+    /** Remove default styles */
+    unstyled?: boolean;
+    /** Custom class name */
+    className?: string;
+    /** Children (label content) */
+    children?: React__default.ReactNode;
+    /** Accessible label override */
+    'aria-label'?: string;
+}
+interface ListboxGroupProps {
+    /** Group label (required, visible) */
+    label: string;
+    /** Disable all options in this group */
+    disabled?: boolean;
+    /** Remove default styles */
+    unstyled?: boolean;
+    /** Custom class name */
+    className?: string;
+    /** Children (Option components) */
+    children: React__default.ReactNode;
+}
+declare function useListboxContext(): ListboxContextValue;
+declare const Listbox: React__default.ForwardRefExoticComponent<ListboxProps & React__default.RefAttributes<HTMLDivElement>>;
+declare const ListboxOption: React__default.ForwardRefExoticComponent<ListboxOptionProps & React__default.RefAttributes<HTMLDivElement>>;
+declare const ListboxGroup: React__default.ForwardRefExoticComponent<ListboxGroupProps & React__default.RefAttributes<HTMLDivElement>>;
+declare const ListboxCompound: React__default.ForwardRefExoticComponent<ListboxProps & React__default.RefAttributes<HTMLDivElement>> & {
+    Option: React__default.ForwardRefExoticComponent<ListboxOptionProps & React__default.RefAttributes<HTMLDivElement>>;
+    Group: React__default.ForwardRefExoticComponent<ListboxGroupProps & React__default.RefAttributes<HTMLDivElement>>;
+};
+
+type InputType = 'text' | 'email' | 'password' | 'number' | 'tel' | 'url' | 'search';
+interface InputProps {
+    /** Controlled value */
+    value?: string;
+    /** Uncontrolled default value */
+    defaultValue?: string;
+    /** Called when value changes */
+    onValueChange?: (value: string) => void;
+    /** Input type */
+    type?: InputType;
+    /** Visible label text (props mode) */
+    label?: ReactNode;
+    /** Hint/description text (props mode) */
+    hint?: ReactNode;
+    /** Error message (props mode) */
+    error?: ReactNode;
+    /** Whether the input is required */
+    required?: boolean;
+    /** Whether the input is disabled */
+    disabled?: boolean;
+    /** Whether the input is read-only */
+    readOnly?: boolean;
+    /** Accessible label when no visible label */
+    'aria-label'?: string;
+    /** ID of external labelling element */
+    'aria-labelledby'?: string;
+    /** Placeholder text */
+    placeholder?: string;
+    /** Input name for form submission */
+    name?: string;
+    /** Autocomplete hint */
+    autoComplete?: string;
+    /** Maximum character length */
+    maxLength?: number;
+    /** Minimum character length */
+    minLength?: number;
+    /** Validation pattern */
+    pattern?: string;
+    /** Input mode hint for virtual keyboards */
+    inputMode?: 'none' | 'text' | 'decimal' | 'numeric' | 'tel' | 'search' | 'email' | 'url';
+    /** Provided element ID (overrides generated) */
+    id?: string;
+    /** Remove default styles for full customization */
+    unstyled?: boolean;
+    /** CSS class name */
+    className?: string;
+    /** Focus event handler */
+    onFocus?: React.FocusEventHandler<HTMLInputElement>;
+    /** Blur event handler */
+    onBlur?: React.FocusEventHandler<HTMLInputElement>;
+    /** Children for compound mode */
+    children?: ReactNode;
+}
+interface InputFieldProps extends Omit<InputHTMLAttributes<HTMLInputElement>, 'type' | 'onChange' | 'value'> {
+    /** Input type */
+    type?: InputType;
+}
+interface InputLabelProps {
+    children: ReactNode;
+    className?: string;
+}
+interface InputHintProps {
+    children: ReactNode;
+    className?: string;
+}
+interface InputErrorProps {
+    children?: ReactNode;
+    className?: string;
+}
+interface InputContextValue {
+    fieldId: string;
+    labelId: string;
+    hintId: string;
+    errorId: string;
+    value: string;
+    setValue: (value: string) => void;
+    hasError: boolean;
+    disabled: boolean;
+    readOnly: boolean;
+    required: boolean;
+    isFocusVisible: boolean;
+    focusProps: {
+        onFocus: () => void;
+        onBlur: () => void;
+    };
+    unstyled: boolean;
+}
+declare function useInputContext(): InputContextValue;
+
+/**
+ * Input label sub-component
+ */
+declare const InputLabel: React$1.ForwardRefExoticComponent<InputLabelProps & React$1.RefAttributes<HTMLLabelElement>>;
+/**
+ * Input field sub-component (the actual <input> element)
+ */
+declare const InputField: React$1.ForwardRefExoticComponent<InputFieldProps & React$1.RefAttributes<HTMLInputElement>>;
+/**
+ * Input hint sub-component
+ */
+declare const InputHint: React$1.ForwardRefExoticComponent<InputHintProps & React$1.RefAttributes<HTMLDivElement>>;
+/**
+ * Input error sub-component - only renders when children are truthy
+ */
+declare const InputError: React$1.ForwardRefExoticComponent<InputErrorProps & React$1.RefAttributes<HTMLDivElement>>;
+/**
+ * Accessible Input component with label, hint, and error support.
+ *
+ * Supports two modes:
+ * - **Props mode**: Pass `label`, `hint`, `error` as props for automatic layout
+ * - **Compound mode**: Use `<Input.Label>`, `<Input.Field>`, etc. as children for custom layout
+ */
+declare const Input: React$1.ForwardRefExoticComponent<InputProps & React$1.RefAttributes<HTMLInputElement>>;
+declare const InputCompound: React$1.ForwardRefExoticComponent<InputProps & React$1.RefAttributes<HTMLInputElement>> & {
+    Label: React$1.ForwardRefExoticComponent<InputLabelProps & React$1.RefAttributes<HTMLLabelElement>>;
+    Field: React$1.ForwardRefExoticComponent<InputFieldProps & React$1.RefAttributes<HTMLInputElement>>;
+    Hint: React$1.ForwardRefExoticComponent<InputHintProps & React$1.RefAttributes<HTMLDivElement>>;
+    Error: React$1.ForwardRefExoticComponent<InputErrorProps & React$1.RefAttributes<HTMLDivElement>>;
+};
+
+type ButtonVariant = 'primary' | 'secondary' | 'danger' | 'outline' | 'ghost';
+type ButtonSize = 'sm' | 'md' | 'lg';
+interface ButtonProps extends Omit<ButtonHTMLAttributes<HTMLButtonElement>, 'disabled' | 'type'> {
+    /** Visual variant */
+    variant?: ButtonVariant;
+    /** Size */
+    size?: ButtonSize;
+    /** HTML button type */
+    type?: 'button' | 'submit' | 'reset';
+    /** Whether the button is disabled */
+    disabled?: boolean;
+    /**
+     * Whether disabled button remains discoverable via keyboard.
+     * When true, disabled button stays in tab order with aria-disabled.
+     * When false, disabled button is removed from tab order with native disabled.
+     * @default false
+     */
+    discoverable?: boolean;
+    /** Whether the button is in a loading state (sets aria-busy) */
+    loading?: boolean;
+    /** Remove default styles for full customization */
+    unstyled?: boolean;
+    /** Accessible label when no visible text */
+    'aria-label'?: string;
+    /** Children (button content) */
+    children?: ReactNode;
+}
+/**
+ * Accessible Button component with variant, size, and loading support.
+ *
+ * Uses `aria-disabled` + event prevention for discoverable disabled state,
+ * keeping the button in the tab order so keyboard users can find it.
+ */
+declare const Button: React$1.ForwardRefExoticComponent<ButtonProps & React$1.RefAttributes<HTMLButtonElement>>;
+
+type TextareaResize = 'none' | 'both' | 'horizontal' | 'vertical';
+interface TextareaProps {
+    /** Controlled value */
+    value?: string;
+    /** Uncontrolled default value */
+    defaultValue?: string;
+    /** Called when value changes */
+    onValueChange?: (value: string) => void;
+    /** Number of visible text rows */
+    rows?: number;
+    /** Resize behavior */
+    resize?: TextareaResize;
+    /** Visible label text (props mode) */
+    label?: ReactNode;
+    /** Hint/description text (props mode) */
+    hint?: ReactNode;
+    /** Error message (props mode) */
+    error?: ReactNode;
+    /** Whether the textarea is required */
+    required?: boolean;
+    /** Whether the textarea is disabled */
+    disabled?: boolean;
+    /** Whether the textarea is read-only */
+    readOnly?: boolean;
+    /** Accessible label when no visible label */
+    'aria-label'?: string;
+    /** ID of external labelling element */
+    'aria-labelledby'?: string;
+    /** Placeholder text */
+    placeholder?: string;
+    /** Textarea name for form submission */
+    name?: string;
+    /** Autocomplete hint */
+    autoComplete?: string;
+    /** Maximum character length */
+    maxLength?: number;
+    /** Minimum character length */
+    minLength?: number;
+    /** Provided element ID (overrides generated) */
+    id?: string;
+    /** Remove default styles for full customization */
+    unstyled?: boolean;
+    /** CSS class name */
+    className?: string;
+    /** Focus event handler */
+    onFocus?: React.FocusEventHandler<HTMLTextAreaElement>;
+    /** Blur event handler */
+    onBlur?: React.FocusEventHandler<HTMLTextAreaElement>;
+    /** Children for compound mode */
+    children?: ReactNode;
+}
+interface TextareaFieldProps extends Omit<TextareaHTMLAttributes<HTMLTextAreaElement>, 'onChange' | 'value'> {
+}
+interface TextareaLabelProps {
+    children: ReactNode;
+    className?: string;
+}
+interface TextareaHintProps {
+    children: ReactNode;
+    className?: string;
+}
+interface TextareaErrorProps {
+    children?: ReactNode;
+    className?: string;
+}
+interface TextareaContextValue {
+    fieldId: string;
+    labelId: string;
+    hintId: string;
+    errorId: string;
+    value: string;
+    setValue: (value: string) => void;
+    hasError: boolean;
+    disabled: boolean;
+    readOnly: boolean;
+    required: boolean;
+    rows: number;
+    resize: TextareaResize;
+    isFocusVisible: boolean;
+    focusProps: {
+        onFocus: () => void;
+        onBlur: () => void;
+    };
+    unstyled: boolean;
+}
+declare function useTextareaContext(): TextareaContextValue;
+
+/**
+ * Textarea label sub-component
+ */
+declare const TextareaLabel: React$1.ForwardRefExoticComponent<TextareaLabelProps & React$1.RefAttributes<HTMLLabelElement>>;
+/**
+ * Textarea field sub-component (the actual <textarea> element)
+ */
+declare const TextareaField: React$1.ForwardRefExoticComponent<TextareaFieldProps & React$1.RefAttributes<HTMLTextAreaElement>>;
+/**
+ * Textarea hint sub-component
+ */
+declare const TextareaHint: React$1.ForwardRefExoticComponent<TextareaHintProps & React$1.RefAttributes<HTMLDivElement>>;
+/**
+ * Textarea error sub-component - only renders when children are truthy
+ */
+declare const TextareaError: React$1.ForwardRefExoticComponent<TextareaErrorProps & React$1.RefAttributes<HTMLDivElement>>;
+/**
+ * Accessible Textarea component with label, hint, and error support.
+ *
+ * Supports two modes:
+ * - **Props mode**: Pass `label`, `hint`, `error` as props for automatic layout
+ * - **Compound mode**: Use `<Textarea.Label>`, `<Textarea.Field>`, etc. as children for custom layout
+ */
+declare const Textarea: React$1.ForwardRefExoticComponent<TextareaProps & React$1.RefAttributes<HTMLTextAreaElement>>;
+declare const TextareaCompound: React$1.ForwardRefExoticComponent<TextareaProps & React$1.RefAttributes<HTMLTextAreaElement>> & {
+    Label: React$1.ForwardRefExoticComponent<TextareaLabelProps & React$1.RefAttributes<HTMLLabelElement>>;
+    Field: React$1.ForwardRefExoticComponent<TextareaFieldProps & React$1.RefAttributes<HTMLTextAreaElement>>;
+    Hint: React$1.ForwardRefExoticComponent<TextareaHintProps & React$1.RefAttributes<HTMLDivElement>>;
+    Error: React$1.ForwardRefExoticComponent<TextareaErrorProps & React$1.RefAttributes<HTMLDivElement>>;
+};
+
+export { Button, type ButtonProps, CheckboxCompound as Checkbox, Checkbox as CheckboxBase, CheckboxGroup, type CheckboxGroupContextValue, type CheckboxGroupProps, CheckboxIndicator, type CheckboxIndicatorProps, type CheckboxProps, InputCompound as Input, Input as InputBase, type InputContextValue, InputError, type InputErrorProps, InputField, type InputFieldProps, InputHint, type InputHintProps, InputLabel, type InputLabelProps, type InputProps, ListboxCompound as Listbox, Listbox as ListboxBase, type ListboxContextValue, ListboxGroup, type ListboxGroupProps, ListboxOption, type ListboxOptionProps, type ListboxProps, Radio, RadioGroupCompound as RadioGroup, RadioGroup as RadioGroupBase, type RadioGroupContextValue, type RadioGroupProps, type RadioProps, type RovingTabindexItem, SelectCompound as Select, Select as SelectBase, SelectListbox, type SelectListboxProps, SelectOptionItem, type SelectOptionProps, type SelectOption as SelectOptionType, type SelectProps, SelectTrigger, type SelectTriggerProps, Switch, type SwitchProps, TextareaCompound as Textarea, Textarea as TextareaBase, type TextareaContextValue, TextareaError, type TextareaErrorProps, TextareaField, type TextareaFieldProps, TextareaHint, type TextareaHintProps, TextareaLabel, type TextareaLabelProps, type TextareaProps, type UseFocusTrapOptions, type UseRovingTabindexOptions, useAnnounceLoading, useAnnounceOnChange, useAnnouncer, useCheckboxGroupContext, useFocusControl, useFocusManager, useFocusTrap, useFocusTrapControls, useFocusVisible, useFocusWithin, useGridKeyboard, useId, useIdScope, useIds, useInputContext, useKeyPressed, useKeyboard, useListboxContext, useMenuKeyboard, useRadioGroupContext, useRovingTabindex, useRovingTabindexMap, useTabsKeyboard, useTextareaContext, useTypeAhead };