import { FC, HTMLAttributes, Ref } from 'react';
import { HeadingAs, HeadingSize } from './types';
export interface HeadingProps extends HTMLAttributes<HTMLHeadingElement> {
    /**
     * The HTML heading tag to render (e.g., 'h1', 'h2').
     * Defines semantic structure and accessibility level.
     */
    as?: HeadingAs;
    /**
     * Visual size of the heading, independent of the `as` tag.
     * Typically mapped to a design system's type scale.
     * Accepts values from 1 (smallest) to 11 (largest).
     */
    size?: HeadingSize;
    /**
     * Font weight of the heading text.
     *
     * - 400: Regular
     * - 500: Medium
     * - 600: Semi-bold
     * - 700: Bold
     * - 900: Extra bold
     */
    fontWeight?: 400 | 500 | 600 | 700 | 900;
    /**
     * Ref to the native HTML heading element.
     * Useful for DOM access or focus management.
     */
    ref?: Ref<HTMLHeadingElement>;
}
/** The Heading component renders a semantic HTML heading (h1–h6) with customizable visual size and font weight, enabling flexible typography while preserving document structure */
export declare const Heading: FC<HeadingProps>;