/**
 * @file LayoutHeader.tsx
 * @input Uses React StyleX
 * @output Exports LayoutHeader component and LayoutHeaderProps
 * @position Top bar / header area for Layout. Use for page titles, app bars,
 *   toolbar areas, or any fixed-height content at the top of a layout.
 *
 * SYNC: When modified, update these files to stay in sync:
 * - /packages/core/src/Layout/Layout.doc.mjs
 * - /apps/storybook/stories/Layout.stories.tsx
 * - /packages/cli/assets/templates/blocks/components/Layout/ (showcase blocks)
 */
import type { AriaRole, ReactNode } from 'react';
import type { BaseProps } from '../BaseProps';
import type { SizeValue, SpacingStep } from '../utils/types';
export interface LayoutHeaderProps extends BaseProps<HTMLDivElement> {
    ref?: React.Ref<HTMLDivElement>;
    /**
     * Content to render inside the header.
     */
    children?: ReactNode;
    /**
     * Adds a themed border at the bottom edge.
     * When false, spacing collapse is applied automatically for seamless visual flow.
     * When not set, falls back to the parent Layout's `defaultHasDividers`, then `false`.
     * @default false
     */
    hasDivider?: boolean;
    /**
     * Height of the header.
     * Numbers are treated as pixels, strings are used as-is.
     */
    height?: SizeValue;
    /**
     * Internal padding of the header using the spacing scale.
     * Accepts numeric spacing steps: 0, 0.5, 1, 1.5, 2, 3, 4, 5, 6, 8, 10.
     * Overrides the default padding from the layout container.
     */
    padding?: SpacingStep;
    /**
     * Accessible label for the landmark.
     * Required when role is set and multiple landmarks of the same type exist.
     */
    label?: string;
    /**
     * ARIA landmark role for accessibility.
     * Use 'banner' only for site-wide headers (not in nested layouts).
     */
    role?: AriaRole;
}
/**
 * Top bar / header for Layout. Use for page titles, app bars, or toolbars.
 * Renders in the header slot with optional divider and padding control.
 *
 * Already provides its own padding — don't add padding to children.
 * Use `padding={0}` if your content manages its own padding (e.g. TopNav).
 *
 * @example
 * ```
 * <LayoutContainer variant="card">
 *   <Layout
 *     header={<LayoutHeader hasDivider>Page Title</LayoutHeader>}
 *     content={<LayoutContent>...</LayoutContent>}
 *   />
 * </LayoutContainer>
 * ```
 */
export declare function LayoutHeader({ children, hasDivider, height, label, padding, role, xstyle, className, style, ref, ...props }: LayoutHeaderProps): import("react").JSX.Element;
export declare namespace LayoutHeader {
    var displayName: string;
}
//# sourceMappingURL=LayoutHeader.d.ts.map