export declare const DEFAULT_HOVER_SELECTORS: string[];

/* Excluded from this release type: Input */

/**
 * The Interface for interaction state.
 * Plugins should use Module Augmentation to add their specific properties to this interface.
 *
 * @example
 * declare module '@supermousejs/core' {
 *   interface InteractionState {
 *     magnetic: boolean | number;
 *     text: string;
 *   }
 * }
 */
export declare interface InteractionState {
    /**
     * Allow arbitrary keys for rapid prototyping.
     * For type safety, use module augmentation to define expected keys.
     */
    [key: string]: any;
}

export declare interface MousePosition {
    x: number;
    y: number;
}

export declare interface MouseState {
    /** The raw position from the latest pointer event, before smoothing is applied. */
    pointer: MousePosition;
    /** The current goal position that the core loop is driving toward. */
    target: MousePosition;
    /** The smoothed/interpolated position used for rendering. */
    smooth: MousePosition;
    /** The current movement vector derived from the smoothed state. */
    velocity: MousePosition;
    /** The current movement angle in degrees, derived from velocity. */
    angle: number;
    /** Whether the pointer is currently pressed down. */
    isDown: boolean;
    /** Whether the pointer is currently hovering over a registered interactive element. */
    isHover: boolean;
    /** Whether the runtime has temporarily restored the native cursor due to native-input heuristics. */
    isNative: boolean;
    /**
     * If set, this overrides all auto-detection logic.
     * 'auto' = Force Native Cursor (Show)
     * 'none' = Force Custom Cursor (Hide Native)
     * null = Let the Core decide based on isNative/isHover
     */
    forcedCursor: "auto" | "none" | null;
    /** The DOM element currently being hovered, if any. */
    hoverTarget: HTMLElement | null;
    /** Whether the user has `prefers-reduced-motion` enabled. */
    reducedMotion: boolean;
    /** Whether the system has received valid input coordinates at least once. */
    hasReceivedInput: boolean;
    /** Defines a specific geometric shape the cursor should conform to. */
    shape: ShapeState | null;
    /** Centralized store for hover metadata from data attributes. */
    interaction: InteractionState;
}

export declare type NativeIgnoreStrategy = "auto" | "tag" | "css";

export declare interface ShapeState {
    width: number;
    height: number;
    borderRadius: number;
}

/* Excluded from this release type: Stage */

/**
 * Supermouse Runtime Loop
 *
 * This class orchestrates the application state, manages the animation loop,
 * and coordinates data flow between the internal systems, and the plugins.
 *
 * @default
 */
export declare class Supermouse {
    static readonly version: string;
    readonly version: string;
    state: MouseState;
    /**
     * Configuration options.
     */
    options: SupermouseOptions;
    private plugins;
    private stage;
    private input;
    private rafId;
    private lastTime;
    private isRunning;
    private hoverSelectors;
    /**
     * Creates a new Supermouse instance.
     *
     * @param options - Global configuration options.
     * @throws Will throw if running in a non-browser environment (window/document undefined).
     */
    constructor(options?: SupermouseOptions);
    /**
     * Retrieves a registered plugin instance by its unique name.
     */
    getPlugin(name: string): SupermousePlugin | undefined;
    /**
     * Returns whether the cursor system is currently enabled (processing input).
     */
    get isEnabled(): boolean;
    /**
     * Enables a specific plugin by name.
     * Triggers the `onEnable` lifecycle hook of the plugin.
     */
    enablePlugin(name: string): void;
    /**
     * Disables a specific plugin by name.
     * Triggers the `onDisable` lifecycle hook.
     */
    disablePlugin(name: string): void;
    /**
     * Toggles the enabled state of a plugin.
     */
    togglePlugin(name: string): void;
    registerHoverTarget(selector: string): void;
    /**
     * The fixed container element where plugins should append their DOM nodes.
     */
    get container(): HTMLDivElement;
    /**
     * Sets the native cursor visibility.
     *
     * @param mode
     */
    setNativeCursor(mode: "hide" | "show" | "auto"): void;
    private init;
    enable(): void;
    disable(): void;
    /**
     * Registers a new plugin.
     *
     * @param plugin - The plugin object to install.
     */
    use(plugin: SupermousePlugin): this;
    private reset;
    private startLoop;
    /**
     * Starts the animation loop. This is automatically called if `autoStart` is true.
     * Plugins can call this method to resume the loop if it has been stopped.
     */
    start(): void;
    /**
     * Manually steps the animation loop.
     *
     * @param time Current timestamp in milliseconds.
     */
    step(time: number): void;
    private runPluginSafe;
    /**
     * Runs on every animation frame.
     */
    private tick;
    /**
     * Destroys the instance.
     */
    destroy(): void;
}

/**
 * Configuration options passed to the Supermouse constructor.
 */
export declare interface SupermouseOptions {
    /**
     * The interpolation factor (0 to 1). Lower is smoother/slower.
     * @default 0.15
     */
    smoothness?: number;
    /**
     * List of CSS selectors that trigger the "Hover" state.
     * Overrides the default set if provided.
     */
    hoverSelectors?: string[];
    /**
     * Whether to enable custom cursor effects on touch devices.
     * @default false
     */
    enableTouch?: boolean;
    /**
     * Whether to automatically disable the custom cursor on devices with coarse pointers.
     * @default true
     */
    autoDisableOnMobile?: boolean;
    /**
     * Strategy for detecting when to fallback to the native cursor.
     * - `'auto'`: Checks both HTML tags and CSS cursor styles (Accurate but slower).
     * - `'tag'`: Checks only semantic tags like <input>, <textarea> (Fastest, prevents layout thrashing).
     * - `'css'`: Checks only computed CSS cursor styles (Slow, triggers reflow).
     * - `null`: Never fallback to native cursor.
     *
     * @default 'auto'
     */
    ignoreOnNative?: NativeIgnoreStrategy | null;
    /**
     * Whether to hide the native cursor via scoped CSS injection on the container.
     * When enabled, the stage toggles `cursor: none` on the configured container and
     * on registered hover targets.
     * @default true
     */
    hideCursor?: boolean;
    /**
     * Whether to hide the custom cursor when the pointer leaves the browser viewport.
     * When enabled the runtime clears the cursor back to an off-screen position to avoid stale hover state.
     * @default true
     */
    hideOnLeave?: boolean;
    /**
     * List of plugins to initialize with the instance.
     */
    plugins?: SupermousePlugin[];
    /**
     * The DOM element to append the cursor stage to.
     * @default document.body
     */
    container?: HTMLElement;
    /**
     * Whether to start the internal animation loop automatically.
     * @default true
     */
    autoStart?: boolean;
    /**
     * Semantic rules mapping CSS selectors to interaction state.
     * Rules are evaluated against hovered elements and merged into `state.interaction`.
     * Matching data attributes on the same element are also read and can override or enrich the final object.
     * @example { 'button': { icon: 'pointer' } }
     */
    rules?: Record<string, InteractionState>;
    /**
     * Custom strategy to resolve interaction state from a hovered element.
     * When provided, this callback bypasses the default `rules` + `data-[prefix]-*` scraping and
     * returns the interaction payload directly for the current hover target.
     */
    resolveInteraction?: (target: HTMLElement) => InteractionState;
    /**
     * The prefix used for data attributes to store hover metadata.
     * For example, if dataPrefix is "supermouse", then the attribute would be "data-supermouse-*".
     * This allows for multiple instances of Supermouse to coexist without conflicting data attributes.
     * @default "supermouse"
     */
    dataPrefix?: string;
}

/**
 * Interface for defining a Supermouse Plugin.
 */
export declare interface SupermousePlugin {
    /** Unique name for the plugin. Used for toggling/retrieval. */
    name: string;
    /** Execution priority. Lower numbers run first. */
    priority?: number;
    /** If false, update() will not be called. */
    isEnabled?: boolean;
    /** Called when `app.use()` is executed. */
    install?: (instance: Supermouse) => void;
    /** Called on every animation frame with the frame delta time in milliseconds. */
    update?: (instance: Supermouse, deltaTime: number) => void;
    /** Called when the plugin is removed or the app is destroyed. */
    destroy?: (instance: Supermouse) => void;
    /** Called when the plugin is enabled via .enablePlugin() */
    onEnable?: (instance: Supermouse) => void;
    /** Called when the plugin is disabled via .disablePlugin() */
    onDisable?: (instance: Supermouse) => void;
}

/**
 * Allows a property to be a static value or a function that returns the value based on state.
 * This is primarily useful for plugin option definitions that should react to the current runtime state.
 */
export declare type ValueOrGetter<T> = T | ((state: MouseState) => T);

export { }