import React from "react";
import type { LucideIcon } from "lucide-react";
/**
 * Rendering a Lucide icon chosen at runtime, without shipping all 1,600 of them
 * on the login screen.
 *
 * `@rebasepro/ui` used to re-export lucide's whole `icons` map:
 *
 *     export { icons as lucideIcons } from "lucide-react";
 *
 * That map is an object literal holding a reference to every icon component in
 * the library, so a tree-shaker cannot drop a single one — reaching the map
 * reaches all of them. Two callers reached it, both by name lookup: `getIcon`
 * in `@rebasepro/app` (a collection's `icon: "ShoppingCart"`) and the admin's
 * icon picker. That put 822 kB of SVG components into the entry chunk's static
 * graph, `modulepreload`ed before authentication.
 *
 * The ~130 icons the product's own chrome uses are still plain named imports
 * from `lucide-react`, which tree-shake to just those. Only the by-name lookup
 * goes through here, and it pays for the map once, asynchronously, the first
 * time a runtime-chosen icon is rendered.
 */
type IconsMap = Record<string, LucideIcon | undefined>;
/**
 * The full lucide icon map, fetched on first use and cached for the session.
 *
 * Prefer {@link LucideIconByName}. This is here for callers that need to know
 * whether a name resolves, such as the icon picker's grid.
 */
export declare function loadLucideIcons(): Promise<IconsMap>;
/** The map if it has already been fetched, otherwise `undefined`. Never fetches. */
export declare function getLoadedLucideIcons(): IconsMap | undefined;
/**
 * Subscribe to the icon map.
 *
 * Returns it synchronously once loaded — including on the very first render of
 * every icon after the first one anywhere, which is what stops a page full of
 * icons from each flashing its placeholder.
 */
export declare function useLucideIcons(): IconsMap | undefined;
/**
 * The same resolution order the two call sites used against the eager map:
 * exact name, then PascalCase, then `CircleAlert` as the visible "unknown icon".
 */
export declare function resolveLucideIcon(icons: IconsMap, name: string): LucideIcon | undefined;
export type LucideIconByNameProps = {
    /**
     * A PascalCase lucide icon name, e.g. `"ShoppingCart"`. Whether a name
     * exists can be answered ahead of the fetch with `iconKeys`, which is a
     * plain string array and costs nothing.
     */
    name: string;
    size?: number;
    className?: string;
    /** Rendered while the icon set is in flight. Defaults to a blank box of `size`. */
    fallback?: React.ReactNode;
};
/**
 * An icon named at runtime. Renders `fallback` until the icon set arrives.
 */
export declare const LucideIconByName: React.MemoExoticComponent<({ name, size, className, fallback }: LucideIconByNameProps) => React.JSX.Element>;
export {};