import { ComputedRef, Ref } from 'vue';
import { SelectionLimitSource } from './useSelectionLimit';
export type ListSelectionValue = string | number;
export type ListSelectionSource<T> = T | Ref<T> | ComputedRef<T> | (() => T);
export type WidenListSelectionValue<TValue extends ListSelectionValue> = TValue extends string ? string : TValue extends number ? number : TValue;
export interface UseListSelectionOptions<TItem, TValue extends ListSelectionValue = ListSelectionValue> {
    selected: ListSelectionSource<readonly TValue[]>;
    items?: ListSelectionSource<readonly TItem[]>;
    getValue?: (item: TItem) => TValue;
    disabled?: ListSelectionSource<boolean | null | undefined>;
    max?: SelectionLimitSource<number | null | undefined>;
}
export interface UseListSelectionReturn<TValue extends ListSelectionValue = ListSelectionValue> {
    selectedValues: ComputedRef<TValue[]>;
    selectedSet: ComputedRef<Set<TValue>>;
    itemValues: ComputedRef<TValue[]>;
    selectedCount: ComputedRef<number>;
    itemCount: ComputedRef<number>;
    isAllSelected: ComputedRef<boolean>;
    isLimited: ComputedRef<boolean>;
    isAtLimit: ComputedRef<boolean>;
    canAddMore: ComputedRef<boolean>;
    remaining: ComputedRef<number | undefined>;
    isSelected: (value: TValue) => boolean;
    isFullySelected: (values: readonly TValue[]) => boolean;
    isPartiallySelected: (values: readonly TValue[]) => boolean;
    selectValues: (values: readonly TValue[]) => TValue[];
    toggleValue: (value: TValue) => TValue[];
    toggleValues: (values: readonly TValue[]) => TValue[];
    selectAll: () => TValue[];
    toggleAll: () => TValue[];
    clear: () => TValue[];
}
/** Shared list-selection state for checkbox lists, sample selectors, and chip selectors. */
export declare function useListSelection<TItem = ListSelectionValue, TValue extends ListSelectionValue = TItem extends ListSelectionValue ? TItem : ListSelectionValue>(options: UseListSelectionOptions<TItem, TValue>): UseListSelectionReturn<WidenListSelectionValue<TValue>>;