import type { Item } from "../../types.mjs";
import type { PencerePlugin } from "../plugin.mjs";
export interface SlideshowPluginOptions {
	/** Delay between auto-advances, in ms. Default: 4000. */
	intervalMs?: number;
	/** Auto-start when the viewer opens. Default: true. */
	autoStart?: boolean;
	/** Pause on hover over the stage. Default: true. */
	pauseOnHover?: boolean;
}
/**
* Reference plugin (#4): auto-advance slideshow. Wires into
* `didOpen` to start the timer, `didNavigate` to reset it, and
* `willClose` to stop. On hover-capable devices pauses while the
* stage is hovered.
*
* Proves the plugin contract surface:
*   - narrow ctx (core + events + dom + registerHook)
*   - no access to private viewer internals
*   - clean uninstall that undoes every side effect
*/
export declare function slideshowPlugin<T extends Item = Item>(options?: SlideshowPluginOptions): PencerePlugin<T>;