import * as React from "react";
export type ScreenTitleVariant = "simple" | "image" | "cover" | "profile";
export type ScreenTitleSize = "default" | "compact";
/**
 * ScreenTitle - A versatile page header component with multiple layout variants
 */
export interface ScreenTitleProps extends Omit<React.HTMLAttributes<HTMLDivElement>, "size" | "title"> {
    /** The variant/style of the title component */
    variant: ScreenTitleVariant;
    /** Main title content as a string (required) */
    title: string;
    /**
     * Optional subtitle for DYNAMIC CONTENT ONLY - use only on detail/item pages to show specific
     * information about the current item (e.g., user role, product specs, team stats).
     * Do NOT use for static UI text or generic page descriptions.
     * Generic pages like "Dashboard" or "Settings" should NOT have subtitles.
     *
     * When passing a string, default styling (text-secondary, whitespace-pre-wrap) is applied automatically.
     * Pass a ReactNode for full control over styling and layout of dynamic metadata.
     */
    subtitle?: React.ReactNode;
    /** Primary image URL */
    image?: string;
    /** Cover/header image URL (for cover and profile variants) */
    coverImage?: string;
    /** Size of the component */
    size?: ScreenTitleSize;
    /** Controls/actions rendered in the component */
    controls?: React.ReactNode;
    /** Additional CSS classes */
    className?: string;
}
export declare const ScreenTitle: React.ForwardRefExoticComponent<ScreenTitleProps & React.RefAttributes<HTMLDivElement>>;
//# sourceMappingURL=screen-title.d.ts.map