export type AutoHideMode = "docked" | "pinned" | "hidden";
/**
 * Drives a "show on scroll up" element anchored to the top of `element`.
 *
 * - "docked": `element`'s top edge is still at/below the viewport top — render
 *   the target in its normal in-flow position.
 * - "hidden": scrolled past the top and the last scroll moved down — keep the
 *   target off-screen.
 * - "pinned": scrolled past the top but the last scroll moved up, or
 *   `forceVisible` is set — pin the target to the viewport top.
 *
 * Scroll direction is derived from `element`'s own bounding rect, so it works
 * regardless of which ancestor scroll container actually scrolls (same reason
 * useElementRect listens in the capture phase).
 */
export declare function useAutoHideOnScroll(element: HTMLElement | null, forceVisible: boolean): AutoHideMode;