import type { IconComponent, IconName, IconSet } from './icon-types.js';
export type { IconCategory, IconComponent, IconMeta, IconName, IconProps, IconSet } from './icon-types.js';
declare const getIconOverrides: () => Partial<IconSet> | undefined;
/** @internal Used by the icon registry's `getIcon` (./icon-registry); not part of the public API. */
export { getIconOverrides };
/**
 * Provide icon overrides to all descendant components.
 * Must be called during component initialisation (e.g. in IconProvider).
 */
export declare function setIcons(overrides: Partial<IconSet>): void;
/**
 * Resolve an icon by name with a caller-supplied fallback. Returns the
 * context override (set via `IconProvider` / `setIcons`) when present,
 * otherwise the `fallback` the caller imported directly.
 *
 * Prefer this over `getIcon` inside components: because it never touches the
 * `DEFAULT_ICONS` registry, a component that imports its default icons
 * statically and resolves them here pulls ONLY those icons into the consumer
 * bundle — not the whole icon set. See docs/ICON-DESIGN.md →
 * "Icon resolution & tree-shaking".
 *
 * Must be called during component initialisation.
 */
export declare function resolveIcon(name: IconName, fallback: IconComponent): IconComponent;