import { Spacing } from '../../types/spacing';
import { HeatmapLayoutType } from './types';

/** Resolves fixed `[width, height]` from `cellSize`, or `null` when cells should stretch. */
export declare function getHeatmapFixedCellDimensions(cellSize?: number | [number, number]): [number, number] | null;
/** Computes the grid's pixel size from fixed `cellSize`, grid dimensions, gap, and label bleed. */
export declare function getHeatmapIntrinsicSize(cellSize: number | [number, number], columns: number, rows: number, gap: number, bleed: Spacing): {
    width: number;
    height: number;
};
/** Resolves cell width and height from `cellSize` and the available grid area. */
export declare function resolveHeatmapCellSize(cellSize: number | [number, number] | undefined, availW: number, availH: number, columns: number, rows: number, gap: number): {
    cellWidth: number;
    cellHeight: number;
};
/** Resolves the grid dimensions from the total number of cells, the fill layout, and any explicit dimensions. */
export declare function getHeatmapGridSize(total: number, layout: HeatmapLayoutType | `${HeatmapLayoutType}`, numRows?: number, numColumns?: number): {
    rows: number;
    columns: number;
};
/** Maps a position in the linear sequence to its `{ row, column }` in the grid. */
export declare function getHeatmapCellPosition(gridIndex: number, layout: HeatmapLayoutType | `${HeatmapLayoutType}`, rows: number, columns: number): {
    row: number;
    column: number;
};