/**
 * On-screen zoom controls.
 *
 * Wheel, pinch and double-click are gestures, and a map whose only way to change
 * scale is a gesture is unusable for a whole class of reader: there is no keyboard
 * path, a trackpad wheel over a scrolling page is a fight, and on a narrow screen
 * a pinch competes with the page. So the buttons render by default, for the same
 * reason the breadcrumb does: a view you can enter but not navigate is a trap.
 *
 * They are HTML rather than SVG, positioned over the plot. Two consequences worth
 * having: each control is a real `<button>`, so it is focusable, announced and
 * disabled by the platform rather than by imitation, and none of it lands in the
 * exported SVG, where a zoom button would be furniture printed onto the map.
 *
 * Every gesture ends up in `ZoomPan`, which listens on the plot; a pointerdown on
 * a button that reached it would start a pan, and a rapid double-tap on `+` would
 * be read as a double-click zoom on the geography underneath. Both are stopped
 * here, at the only place that knows the pointer was on furniture.
 *
 * @module components/ZoomControls
 */
import type { ZoomControlsOptions } from '../types';
/** State the buttons describe, which is the camera plus "is the globe turned". */
export interface ZoomControlsState {
    k: number;
    minZoom: number;
    maxZoom: number;
    /** Whether anything (scale, pan, rotation) is left for reset to undo. */
    moved: boolean;
}
export declare class ZoomControls {
    readonly container: HTMLElement;
    readonly onStep: (direction: 1 | -1) => void;
    readonly onReset: () => void;
    options: ZoomControlsOptions;
    private root;
    private inButton;
    private outButton;
    private resetButton;
    /**
     * The last state written, so `sync` is free to be called from every camera
     * frame. A pan emits changes at 60Hz and none of them move a button.
     */
    private _synced;
    constructor({ container, options, onStep, onReset, }: {
        container: HTMLElement;
        options: ZoomControlsOptions;
        /** `1` steps in, `-1` steps out, by the configured zoom step. */
        onStep: (direction: 1 | -1) => void;
        onReset: () => void;
    });
    /** Build the controls, or take them down when this config turns them off. */
    render(state: ZoomControlsState): void;
    /**
     * Reflect the camera in the buttons' disabled state.
     *
     * A `+` that still looks live at maximum scale is a control that lies, and the
     * pair going flat is also how a reader learns the range has an end.
     */
    sync(state: ZoomControlsState): void;
    private _button;
    destroy(): void;
}
//# sourceMappingURL=ZoomControls.d.ts.map