import type { WidgetHeaderConfig } from '../../../../domains/widgets/shared/widget-header/types.js';
import type { CustomWidgetProps } from './types.js';
export type UseCustomWidgetCsvDownloadParams = Pick<CustomWidgetProps, 'title' | 'dataOptions' | 'filters' | 'highlights' | 'config' | 'dataSource'>;
export type UseCustomWidgetCsvDownloadResult = {
    headerConfig: WidgetHeaderConfig;
};
/**
 * Enhances a custom widget's header with CSV download capabilities:
 * - Adds the "Download > CSV File" header menu item.
 * - Executes the CSV query and downloads the result as a CSV file.
 *
 * @param widgetProps - Custom widget props needed for CSV
 * @returns Header config for {@link WidgetContainer}
 */
export declare function useCustomWidgetCsvDownload(widgetProps: UseCustomWidgetCsvDownloadParams): UseCustomWidgetCsvDownloadResult;