import { ImgHTMLAttributes, Ref, default as React } from 'react';
import { SafeExtract, SafeOmit } from '../../.deps/utils/src';
import { Size } from '../../tokens/types';
type ImageContainerProps = SafeOmit<ImgHTMLAttributes<HTMLImageElement>, 'className' | 'src' | 'srcSet' | 'alt' | 'style'>;
export interface ImageProps extends ImageContainerProps {
    /**
     * Ref for the underlying image element.
     */
    ref?: Ref<HTMLImageElement>;
    /**
     * Image source URL.
     */
    src: string | null | undefined;
    /**
     * The `srcSet` attribute for the image.
     */
    srcSet?: string | undefined;
    /**
     * Alternative text for the image. Use an empty string for decorative images.
     */
    alt: string;
    /**
     * Custom aspect ratio for the fixed layout.
     * @default '3 / 2'
     */
    aspectRatio?: `${number} / ${number}` | number;
    /**
     * Whether the image should use its intrinsic aspect ratio.
     * @default false
     */
    responsive?: boolean;
    /**
     * Controls how the image fits inside its box.
     * @default 'contain'
     */
    fit?: 'contain' | 'cover';
    /**
     * Sets predefined image width.
     * @default 'md'
     */
    size?: SafeExtract<Size, 'sm' | 'md' | 'lg' | 'full'>;
}
export declare const Image: ({ alt: altProp, aspectRatio, fit, ref, responsive, size, src: srcProp, srcSet, ...rest }: ImageProps) => React.JSX.Element;
export {};