import type { AngleStreamOptions, BatteryStatus, CalibrationResult, DeviceAdapterEvent, DeviceAdapterEventMap, DeviceError, DeviceInfo, DiscoveredDevice, ScanOptions, Unsubscribe } from './types.js';
/**
 * Device Adapter contract (spec §11.3).
 *
 * Every interaction with device firmware/BLE goes through this interface so
 * that business logic never touches transport details. A real BLE adapter and
 * the {@link SimulatedDeviceAdapter} are interchangeable behind this type.
 */
export interface DeviceAdapter {
    /** Discover nearby devices. Resolves with whatever was found before timeout. */
    scanDevices(options?: ScanOptions): Promise<DiscoveredDevice[]>;
    /** Connect to a device by id. Emits `connectionStateChanged`. */
    connectDevice(deviceId: string): Promise<DeviceInfo>;
    /** Disconnect the current device. */
    disconnectDevice(): Promise<void>;
    /**
     * Begin streaming angle samples. Samples arrive via the `angle` event.
     * Returns an unsubscribe handle that also stops the stream.
     */
    startAngleStream(options?: AngleStreamOptions): Promise<Unsubscribe>;
    /** Stop the angle stream. */
    stopAngleStream(): Promise<void>;
    /** Current battery level (0..100) and charging flag. */
    getBatteryLevel(): Promise<BatteryStatus>;
    /** Firmware version string of the connected device. */
    getFirmwareVersion(): Promise<string>;
    /** Run the calibration routine. Emits `calibration`. */
    calibrate(): Promise<CalibrationResult>;
    /** Full metadata for the connected device. */
    getDeviceInfo(): Promise<DeviceInfo>;
    /** Errors recorded since the last successful read. */
    getDeviceErrors(): Promise<DeviceError[]>;
    /** Subscribe to a typed event. Returns an unsubscribe function. */
    on<E extends DeviceAdapterEvent>(event: E, listener: (payload: DeviceAdapterEventMap[E]) => void): Unsubscribe;
}
/** Thrown when an operation requires an active connection but there is none. */
export declare class NotConnectedError extends Error {
    constructor();
}