/**
 * @fileoverview Saasflare PageHeader — top-level page title with actions.
 * @module packages/ui/components/ui/page-header
 * @layer core
 *
 * Composed component for SaaS page headers with breadcrumbs,
 * title, description, and an action slot for buttons.
 *
 * @example
 * import { PageHeader } from "@saasflare/ui";
 *
 * <PageHeader
 *   title="Team Settings"
 *   description="Manage your team members and their permissions."
 *   actions={<Button>Invite Member</Button>}
 * />
 */
import * as React from "react";
import { type SaasflareComponentProps } from "../../providers";
/** Props for the PageHeader component */
interface PageHeaderProps extends Omit<React.ComponentProps<"div">, keyof SaasflareComponentProps>, SaasflareComponentProps {
    /** Page title */
    title: string;
    /** Optional description below the title */
    description?: string;
    /** Optional breadcrumb element rendered above the title */
    breadcrumbs?: React.ReactNode;
    /** Action slot (buttons, etc.) aligned to the right */
    actions?: React.ReactNode;
}
/**
 * Page header with title, description, breadcrumbs, and action slot.
 *
 * @component
 * @layer core
 *
 * @param {string} title - Page title text
 * @param {string} description - Optional subtitle / description
 * @param {React.ReactNode} breadcrumbs - Optional breadcrumb navigation
 * @param {React.ReactNode} actions - Action buttons aligned right
 *
 * @example
 * <PageHeader
 *   breadcrumbs={<Breadcrumb>...</Breadcrumb>}
 *   title="Billing"
 *   description="Manage your subscription and payment methods."
 *   actions={
 *     <>
 *       <Button variant="outline">Cancel Plan</Button>
 *       <Button>Upgrade</Button>
 *     </>
 *   }
 * />
 */
declare function PageHeader({ title, description, breadcrumbs, actions, className, surface, radius, animated, iconWeight, ...props }: PageHeaderProps): import("react/jsx-runtime").JSX.Element;
export { PageHeader, type PageHeaderProps };