import * as React from 'react';
import { type ButtonProps } from '../../../atoms/buttons/Button/index.js';
import { type ToggleGroupItemProps, type ToggleGroupProps } from '../../../atoms/buttons/Toggle/index.js';
import { type InputProps } from '../../../atoms/forms/Input/index.js';
export type SectionHeaderSize = 'sm' | 'md';
export type SectionHeaderHeadingLevel = 1 | 2 | 3 | 4 | 5 | 6;
export interface SectionHeaderAction extends Omit<ButtonProps, 'children' | 'render'> {
    label: React.ReactNode;
}
export interface SectionHeaderToggle extends Omit<ToggleGroupItemProps, 'children'> {
    label: React.ReactNode;
    value: string;
}
export interface SectionHeaderToggleGroup extends Omit<ToggleGroupProps, 'children' | 'label'> {
    items: SectionHeaderToggle[];
}
export interface SectionHeaderTab {
    label: React.ReactNode;
    value?: string;
    active?: boolean;
    leadingIcon?: React.ReactNode;
    onClick?: React.MouseEventHandler<HTMLButtonElement>;
}
export interface SectionHeaderSearchProps extends Omit<InputProps, 'size' | 'shape' | 'startIcon' | 'endIcon' | 'appearance'> {
    placeholder?: string;
    ariaLabel?: string;
    /** Optional interactive filter control rendered beside the search input */
    filterButton?: React.ReactNode;
}
export interface SectionHeaderProps extends Omit<React.ComponentPropsWithoutRef<'header'>, 'title'> {
    /** Section title */
    title: React.ReactNode;
    /** Supporting text below the title */
    supportingText?: React.ReactNode;
    /** Heading/text size from the Figma variants */
    size?: SectionHeaderSize;
    /** Semantic heading level for the section title */
    headingLevel?: SectionHeaderHeadingLevel;
    /** Action buttons rendered to the right of the title block */
    actions?: SectionHeaderAction[];
    /** Optional grouped selection controls rendered as a segmented control */
    toggleGroup?: SectionHeaderToggleGroup;
    /** Optional search input rendered to the right of the title block */
    search?: SectionHeaderSearchProps;
    /** Optional tabs row rendered below the header controls */
    tabs?: SectionHeaderTab[];
    /** Trailing menu control rendered after the action buttons */
    menuButton?: React.ReactNode;
    /** Show the bottom divider */
    showDivider?: boolean;
}
declare const SectionHeader: React.ForwardRefExoticComponent<SectionHeaderProps & React.RefAttributes<HTMLElement>>;
export { SectionHeader };