import type { WidgetsPanelLayout } from '../../../domains/dashboarding/dashboard-model/types.js';
import type { WidgetProps } from '../../../domains/widgets/components/widget/types';
import type { ContextfulTransformer } from '../../../shared/utils/utility-types/transformer.js';
/**
 * The dashboard widgets a narrative describes: the non-narrative widgets visible in the layout, in
 * layout order, or every non-narrative widget, in list order, when there is no layout. A widget
 * that is not in the layout does not count as visible.
 * @param widgets - Dashboard widgets.
 * @param layout - Widgets-panel layout, hidden cells included.
 * @returns The widgets to narrate.
 * @internal
 */
export declare function getNarrativeSiblings(widgets: readonly WidgetProps[], layout?: WidgetsPanelLayout): WidgetProps[];
/**
 * Hands every narrative widget the dashboard widgets it describes: the other widgets that are
 * visible in the layout, in layout order, with the props they have at this point of the pipeline
 * (dashboard filters and highlights already connected). Narrative widgets never describe each
 * other. A widget that is not in the layout does not count as visible.
 *
 * @param layout - Final widgets-panel layout, hidden cells included.
 * @returns Transformer of the connected widget props: the same list, with `widgets` set on each
 *   narrative widget; the input when there is none.
 * @internal
 */
export declare const withNarrativeSiblings: ContextfulTransformer<WidgetProps[], WidgetsPanelLayout>;