import { type SettingOption, type SettingsStore } from "./settingsModel.js";
/** Stored value for "render every display refresh" — the browser's vsync-locked rate. */
export declare const FRAME_RATE_LIMIT_DISPLAY = "display";
/**
 * Frame-rate limit choices. Browsers always present on the display's vsync, so the uncapped
 * option runs at the monitor's refresh rate; the numeric caps skip refreshes to save GPU and battery.
 */
export declare const FRAME_RATE_LIMIT_OPTIONS: readonly SettingOption[];
/** The player's frame-rate cap in frames per second, or 0 for the display rate. */
export declare function readFrameRateLimit(store: Pick<SettingsStore, "get">): number;
/**
 * Frame pacing for a capped render loop driven by display refreshes. Returns the new frame
 * anchor when a frame should render at `now`, or `null` to skip this refresh. The anchor keeps
 * the remainder so a 60 cap on a 144 Hz display averages 60 instead of drifting to 48.
 */
export declare function paceFrame(now: number, anchor: number, fps: number): number | null;