import { ComponentPropsWithoutRef, ReactNode, Ref } from 'react';
import { LayoutUtilProps } from '../../types';
/**
 * Represents an item in the listview with a label and optional disabled state.
 * @template T - The type of additional properties for the item
 */
type ItemType<T> = T & {
    /** The display label for the item */
    label: string;
    /** Whether the item is disabled and cannot be selected */
    disabled?: boolean;
};
/**
 * Props for the ListView component
 * @template T - The type of additional properties for items
 * @extends LayoutUtilProps
 */
type ListViewWithItems<T> = Omit<ComponentPropsWithoutRef<"div">, "children"> & {
    /** Array of items to render */
    items: ItemType<T>[];
    /** Default selected items (uncontrolled) */
    defaultSelected?: ItemType<T>[];
    /** Optional render function for items */
    children?: ({ items }: {
        items: ItemType<T>[];
    }) => ReactNode;
};
/**
 * Props for the ListView component without items array
 * @extends ComponentPropsWithoutRef<"div">
 */
type ListViewWithOutItems = ComponentPropsWithoutRef<"div"> & {
    /** Default selected items (uncontrolled) */
    defaultSelected?: string[];
};
/**
 * Option object for internal focus and selection management
 */
export type Option = {
    /** The DOM node for the option */
    node: Element;
    /** Focusable elements within the option */
    focusables: NodeListOf<Element>;
};
/**
 * Represents the focused item in the listview
 */
export type FocusedItem = {
    /** Row index of the focused item */
    row: number;
    /** Column index of the focused item */
    col: number;
};
/**
 * Props for the ListView component
 * @template T - The type of additional properties for items
 * @extends LayoutUtilProps
 */
export type ListViewProps<T> = LayoutUtilProps & {
    /** Currently indeterminate items (controlled) */
    indeterminate?: unknown[];
    /** Callback when selection changes */
    onSelectionChange?: (value: unknown[]) => void;
    /** Currently selected items (controlled) */
    selected?: ItemType<T>[];
} & (ListViewWithItems<T> | ListViewWithOutItems);
declare const ListViewElement: {
    <T>(props: ListViewProps<T>, ref: Ref<HTMLDivElement>): import("react/jsx-runtime").JSX.Element;
    displayName: string;
};
/**
 * ListView component for displaying a list of selectable items in a grid layout.
 *
 * Features:
 * - Supports single and multiple selection modes
 * - Keyboard navigation with arrow keys
 * - Customizable item rendering
 * - Controlled and uncontrolled modes
 * - Accessible with proper ARIA attributes
 * - Focus management for interactive elements
 * - Layout utilities for positioning and spacing
 *
 * @template T - The type of additional properties for items
 * @example
 * <ListView items={[{ label: "Item 1" }, { label: "Item 2" }]} onSelectionChange={handleSelection}>
 *   {({ items }) => items.map(item => (
 *     <ListView.Option key={item.label} item={item} />
 *   ))}
 * </ListView>
 */
export declare const ListView: (<T>(props: ListViewProps<T> & {
    ref?: React.ForwardedRef<HTMLUListElement>;
}) => ReturnType<typeof ListViewElement>) & {
    /**
     * ListViewOption component for individual selectable items within a listview.
     *
     * Features:
     * - Displays selectable options with proper ARIA attributes
     * - Supports disabled state for non-selectable options
     * - Keyboard navigation support
     * - Accessible with screen reader support
     *
     * @example
     * <ListView.Option item={{ label: "Option 1" }} />
     */
    Option: import('react').ForwardRefExoticComponent<import('./ListViewOption').ListViewOptionProps & import('react').RefAttributes<HTMLDivElement>>;
    /**
     * ListViewOptionCell component for rendering a cell within a listview option.
     *
     * Features:
     * - Renders a grid cell for option content
     * - Supports custom content and layout
     * - Accessible with proper ARIA attributes
     *
     * @example
     * <ListView.OptionCell>Custom cell content</ListView.OptionCell>
     */
    OptionCell: import('react').ForwardRefExoticComponent<Omit<import('react').DetailedHTMLProps<import('react').HTMLAttributes<HTMLDivElement>, HTMLDivElement>, "ref"> & import('react').RefAttributes<HTMLDivElement>>;
};
export {};