import { ComputedRef, Ref } from 'vue';
export type SortedItemsSource<T> = T | Ref<T> | ComputedRef<T> | (() => T);
export type SortOrder = 'asc' | 'desc';
export interface SortDescriptor<TKey extends string = string> {
    key: TKey;
    direction?: SortOrder | null;
}
export interface CompareSortValuesOptions {
    caseSensitive?: boolean;
}
export interface SortComparatorContext<TItem, TKey extends string = string> {
    key: TKey;
    direction: SortOrder;
    a: TItem;
    b: TItem;
}
export type SortComparator<TItem, TKey extends string = string> = (aValue: unknown, bValue: unknown, context: SortComparatorContext<TItem, TKey>) => number;
export interface UseSortedItemsOptions<TItem, TKey extends string = string> {
    items: SortedItemsSource<readonly TItem[]>;
    sort: SortedItemsSource<SortDescriptor<TKey> | null | undefined>;
    enabled?: SortedItemsSource<boolean | null | undefined>;
    caseSensitive?: SortedItemsSource<boolean | null | undefined>;
    getValue: (item: TItem, key: TKey) => unknown;
    compare?: SortComparator<TItem, TKey>;
}
export interface UseSortedItemsReturn<TItem, TKey extends string = string> {
    sort: ComputedRef<SortDescriptor<TKey> | null | undefined>;
    sortedItems: ComputedRef<TItem[]>;
}
/** Shared sorting for SDK tables and lists with stable empty-value handling. */
export declare function useSortedItems<TItem, TKey extends string = string>(options: UseSortedItemsOptions<TItem, TKey>): UseSortedItemsReturn<TItem, TKey>;
export declare function compareSortValues(aValue: unknown, bValue: unknown, direction?: SortOrder, options?: CompareSortValuesOptions): number;