import { TableProps } from '../interfaces';
/**
 * Returns the 1-based sort priority index of `column` in the sort array, or null if not present.
 */
export declare function getSortIndex<T>(sortingColumns: ReadonlyArray<TableProps.SortingState<T>>, column: TableProps.ColumnDefinition<T>): number | null;
/**
 * Replace the entire sort state with a single column.
 */
export declare function replaceSort<T>(column: TableProps.ColumnDefinition<T>, isDescending: boolean): ReadonlyArray<TableProps.SortingState<T>>;
/**
 * Append a column at the end of the current sort.
 */
export declare function appendSort<T>(current: ReadonlyArray<TableProps.SortingState<T>>, column: TableProps.ColumnDefinition<T>, isDescending: boolean): ReadonlyArray<TableProps.SortingState<T>>;
/**
 * Toggle the direction of a column already in the sort, keeping its position.
 */
export declare function toggleDirection<T>(current: ReadonlyArray<TableProps.SortingState<T>>, column: TableProps.ColumnDefinition<T>): ReadonlyArray<TableProps.SortingState<T>>;
/**
 * Set the direction of a column already in the sort to a specific value, keeping its position.
 */
export declare function setDirection<T>(current: ReadonlyArray<TableProps.SortingState<T>>, column: TableProps.ColumnDefinition<T>, isDescending: boolean): ReadonlyArray<TableProps.SortingState<T>>;
/**
 * Remove a column from the sort and reindex remaining priorities.
 */
export declare function removeSort<T>(current: ReadonlyArray<TableProps.SortingState<T>>, column: TableProps.ColumnDefinition<T>): ReadonlyArray<TableProps.SortingState<T>>;
/**
 * Builds a screen-reader announcement for the current multi-column sort state by joining per-column
 * fragments in code (charts-style). The fragment renderers are resolved from i18n by the caller;
 * returns an empty string when the relevant renderers are unavailable so no announcement is made.
 */
export declare function buildSortLiveAnnouncement<T>({
  sortingColumns,
  columnDefinitions,
  renderSortColumn,
  renderSortOrder,
  sortCleared,
  formatList,
  resolveColumnLabel
}: {
  sortingColumns?: ReadonlyArray<TableProps.SortingState<T>>;
  columnDefinitions: ReadonlyArray<TableProps.ColumnDefinition<T>>;
  renderSortColumn?: (data: {
    columnLabel: string;
    isDescending: boolean;
  }) => string;
  renderSortOrder?: (data: {
    columns: string;
  }) => string;
  sortCleared?: string;
  formatList?: (parts: readonly string[]) => string;
  resolveColumnLabel?: (column: TableProps.ColumnDefinition<T> | undefined) => string | undefined;
}): string;