import { WidgetHeaderConfig } from '../types.js';
/**
 * Adds the header menu ("⋮") button to a widget's header, when there is a menu to show.
 *
 * Call it **after** every feature that contributes menu entries (renaming, the download actions),
 * since whether the button exists depends on the finished menu. What goes *inside* the menu is a
 * separate model; see `resolveHeaderMenuItems` and `header-menu-architecture.md`.
 *
 * @param headerConfig - The widget's header config so far.
 * @returns The header config carrying the menu button, or unchanged when there is no menu to show.
 * @internal
 */
export declare const useWidgetHeaderMenu: (headerConfig: WidgetHeaderConfig | undefined) => WidgetHeaderConfig;