import type { MenuItem } from '../../../shared/types/menu-item';
import type { WidgetProps } from '../components/widget/types';
import type { WidgetHeaderConfig } from '../shared/widget-header/types';
/**
 * Transformer: adds a menu item to a header config (pure, non-mutating).
 *
 * @param menuItem - The menu item to append to toolbar.menu.items.
 * @returns A transformer that maps WidgetHeaderConfig to WidgetHeaderConfig with the menu item appended.
 * @internal
 */
export declare function withMenuItemInHeaderConfig(menuItem: MenuItem): (headerConfig: WidgetHeaderConfig) => WidgetHeaderConfig;
/**
 * Adds a menu item to the widget header (transforms full WidgetProps).
 *
 * @param menuItem - The menu item to add.
 * @returns A transformer that maps WidgetProps to WidgetProps with the item in config.header.toolbar.menu.items.
 * @internal
 */
export declare function withHeaderMenuItem(menuItem: MenuItem): (widget: WidgetProps) => WidgetProps;