import { type FunctionComponent } from "react";
type ImportFn<Props> = () => Promise<{
    default: FunctionComponent<Props>;
}>;
type Preloader<Props> = {
    preload: ImportFn<Props>;
};
/**
 * A component type that supports lazy loading and preloading.
 */
export type LazyComponent<Props> = Props extends undefined ? FunctionComponent & Preloader<void> : FunctionComponent<Props> & Preloader<Props>;
type DefaultExport<Fn extends ImportFn<any>> = Awaited<ReturnType<Fn>>["default"];
type InferProps<Fn extends ImportFn<any>> = Parameters<DefaultExport<Fn>>[0];
/**
 * Wraps a dynamic import function to create a lazy-loaded component with preloading capabilities.
 *
 * @remarks
 * This utility extends React's `lazy` by attaching the original import function as a `preload` property.
 * This allows the router to fetch the component code before rendering it, improving perceived performance.
 *
 * @typeParam Fn - The dynamic import function type.
 * @param importStatement - The function that imports the component.
 * @returns A `LazyComponent` that can be rendered and preloaded.
 *
 * @example
 * ```ts
 * const UserProfile = lazy(() => import('./UserProfile'));
 * // Later...
 * UserProfile.preload(); // Start fetching code
 * ```
 */
export declare function lazy<Fn extends ImportFn<any>>(importStatement: Fn): LazyComponent<InferProps<Fn>>;
export {};