import { ReadonlyObservable } from '@usels/core';
import { ConfigurableWindow } from '../../shared/configurable.mjs';
import '@legendapp/state';

type KeyModifier = "Alt" | "AltGraph" | "CapsLock" | "Control" | "Fn" | "FnLock" | "Meta" | "NumLock" | "ScrollLock" | "Shift" | "Symbol" | "SymbolLock";
interface UseKeyModifierOptions<Initial extends boolean | null = null> extends ConfigurableWindow {
    /** Events to listen for modifier state changes */
    events?: string[];
    /** Initial value before any event fires */
    initial?: Initial;
}
type UseKeyModifierReturn<Initial extends boolean | null = null> = ReadonlyObservable<Initial extends boolean ? boolean : boolean | null>;
/**
 * Framework-agnostic reactive tracker for keyboard modifier key state.
 *
 * Uses `event.getModifierState()` to detect whether a modifier key
 * (Shift, Control, Alt, CapsLock, etc.) is currently active.
 */
declare function createKeyModifier<Initial extends boolean | null = null>(modifier: KeyModifier, options?: UseKeyModifierOptions<Initial>): UseKeyModifierReturn<Initial>;

export { type KeyModifier, type UseKeyModifierOptions, type UseKeyModifierReturn, createKeyModifier };