import { ComputedRef, MaybeRefOrGetter, Ref } from '../../node_modules/vue';
import { IconSize, TextColorVariant } from '../types';
/**
 * Reactive options for {@link useAppIcon}. They mirror the `AppIcon` component
 * props that drive its color, sizing and hover state.
 */
export interface UseAppIconOptions {
    /**
     * Requested icon size: a preset key, a raw CSS value or a percentage.
     */
    size: MaybeRefOrGetter<IconSize | string | undefined>;
    /**
     * Scale factor applied to the icon size through a CSS custom property.
     */
    scale: MaybeRefOrGetter<number>;
    /**
     * Bootstrap color variant for the icon.
     */
    variant: MaybeRefOrGetter<TextColorVariant | undefined>;
    /**
     * Bootstrap color variant applied while hovered.
     */
    hoverVariant: MaybeRefOrGetter<TextColorVariant | undefined>;
    /**
     * Forces the icon into its hover state when true.
     */
    hover: MaybeRefOrGetter<boolean | undefined>;
    /**
     * Duration of the spin animation.
     */
    spinDuration: MaybeRefOrGetter<string>;
    /**
     * Duration of the beat animation.
     */
    beatDuration: MaybeRefOrGetter<string>;
    /**
     * Duration of the fade animation.
     */
    fadeDuration: MaybeRefOrGetter<string>;
    /**
     * Enable spinning animation.
     */
    spin: MaybeRefOrGetter<boolean | undefined>;
    /**
     * Reverse the direction of the spin animation.
     */
    spinReverse: MaybeRefOrGetter<boolean | undefined>;
    /**
     * Enable pulsing beat animation.
     */
    beat: MaybeRefOrGetter<boolean | undefined>;
    /**
     * Enable fade in/out animation.
     */
    fade: MaybeRefOrGetter<boolean | undefined>;
}
/**
 * Reactive API returned by {@link useAppIcon}.
 */
export interface UseAppIcon {
    currentHover: Ref<boolean>;
    color: ComputedRef<string>;
    isPercentSize: ComputedRef<boolean>;
    isRawSize: ComputedRef<boolean>;
    hasSize: ComputedRef<boolean>;
    style: ComputedRef<Record<string, string | number | undefined>>;
    classList: ComputedRef<Record<string, boolean | undefined>>;
}
/**
 * Derives the inline style and class list for the `AppIcon` component: tracks
 * the hover state (driven by both the `hover` prop and mouse events),
 * classifies the requested size (preset / raw CSS / percentage) and resolves
 * the active color variant.
 *
 * Internal building block for `AppIcon`; not exported from `@icij/murmur-next`.
 *
 * @param options - Reactive icon options (see {@link UseAppIconOptions}).
 * @returns The {@link UseAppIcon} API: the mutable `currentHover` flag plus the
 *   `style` and `classList` bindings (and the size predicates they rely on).
 * @example
 * import { toRef } from 'vue'
 * import { useAppIcon } from '@/composables/useAppIcon'
 *
 * const { currentHover, style, classList } = useAppIcon({
 *   size: toRef(props, 'size'),
 *   scale: toRef(props, 'scale'),
 *   variant: toRef(props, 'variant'),
 *   hoverVariant: toRef(props, 'hoverVariant'),
 *   hover: toRef(props, 'hover'),
 *   spinDuration: toRef(props, 'spinDuration'),
 *   beatDuration: toRef(props, 'beatDuration'),
 *   fadeDuration: toRef(props, 'fadeDuration'),
 *   spin: toRef(props, 'spin'),
 *   spinReverse: toRef(props, 'spinReverse'),
 *   beat: toRef(props, 'beat'),
 *   fade: toRef(props, 'fade')
 * })
 */
export declare function useAppIcon(options: UseAppIconOptions): UseAppIcon;
export default useAppIcon;