import type { HeaderSubpagePropsShared } from "@metamask/design-system-shared";
import type { ComponentProps } from "react";
import type { BoxProps } from "../Box/index.cjs";
import type { ButtonIconProps } from "../ButtonIcon/index.cjs";
import type { TextProps } from "../Text/index.cjs";
/**
 * Props for back/close ButtonIcons that override iconName and make ariaLabel optional.
 * The component provides default ariaLabels ("Go back", "Close").
 */
type NavigationButtonIconProps = Partial<Omit<ButtonIconProps, 'iconName'>> & {
    [key: `data-${string}`]: string | undefined;
};
/**
 * HeaderSubpage component props.
 *
 * Subpage navigation header with optional back/close button shortcuts.
 * Provides a consistent header pattern for secondary screens and modal-style
 * navigation flows.
 */
export type HeaderSubpageProps = Omit<ComponentProps<'header'>, 'title' | 'children'> & HeaderSubpagePropsShared & {
    /**
     * Props passed to the title Text component when title is a string.
     */
    titleProps?: Partial<TextProps>;
    /**
     * Props passed to the description Text component when description is a string.
     */
    descriptionProps?: Partial<TextProps>;
    /**
     * Additional props to pass to the back ButtonIcon.
     * If provided, a back button will be rendered with these props spread.
     */
    backButtonProps?: NavigationButtonIconProps;
    /**
     * Additional props to pass to the close ButtonIcon.
     * If provided, a close button will be added with these props spread.
     */
    closeButtonProps?: NavigationButtonIconProps;
    /**
     * Optional ButtonIcon props to render as the start accessory.
     * Only used if `startAccessory` is not provided.
     */
    startButtonIconProps?: ButtonIconProps & {
        [key: `data-${string}`]: string | undefined;
    };
    /**
     * Optional array of ButtonIcon props to render as additional end accessories.
     * Rendered in reverse order (first item appears rightmost).
     * Only used if `endAccessory` is not provided.
     */
    endButtonIconProps?: (ButtonIconProps & {
        [key: `data-${string}`]: string | undefined;
    })[];
    /**
     * Gap between start/end accessories and the content.
     * Uses spacing scale (1 = 4px, 2 = 8px, etc.).
     *
     * @default 2
     */
    accessoryGap?: BoxProps['gap'];
    /**
     * Optional prop for additional CSS classes to be applied to the HeaderSubpage component.
     */
    className?: string;
    /**
     * Optional CSS styles to be applied to the component.
     */
    style?: React.CSSProperties;
};
export {};
//# sourceMappingURL=HeaderSubpage.types.d.cts.map