π OpenHands: AI-Driven Development
import React from "react";
export interface FixedPlacementBox {
top: number;
left: number;
width: number;
}
/** Clamp a fixed popover's `left` so its `width` stays `gutter` px inside the viewport. */
export function clampLeftToViewport(
left: number,
width: number,
gutter = 8,
): number {
return Math.max(gutter, Math.min(left, window.innerWidth - gutter - width));
}
/**
* Position a popover with `position: fixed`, anchored below the trigger and
* clamped within the viewport. Used by the conversation-panel "+ New
* conversation" menus when they're rendered inside an overflow-hidden
* sidebar and would otherwise be clipped.
*
* Returns the measured `{ top, left, width }` box (or `null` when the
* popover is closed or fixed placement is disabled). The hook also wires
* up window resize + capture-phase scroll listeners so the box follows the
* trigger as the page moves.
*/
export function usePopoverFixedPlacement(
triggerRef: React.RefObject<HTMLElement | null>,
options: { open: boolean; enabled: boolean; targetWidth?: number },
): FixedPlacementBox | null {
const { open, enabled, targetWidth = 16 * 16 } = options;
const [box, setBox] = React.useState<FixedPlacementBox | null>(null);
const measure = React.useCallback(() => {
const el = triggerRef.current;
if (!el) return;
const r = el.getBoundingClientRect();
const gutter = 8;
const width = Math.min(targetWidth, window.innerWidth - gutter * 2);
const left = clampLeftToViewport(r.right - width, width, gutter);
setBox({ top: r.bottom + 4, left, width });
}, [triggerRef, targetWidth]);
React.useLayoutEffect(() => {
if (!open || !enabled) {
setBox(null);
return undefined;
}
measure();
window.addEventListener("resize", measure);
window.addEventListener("scroll", measure, true);
return () => {
window.removeEventListener("resize", measure);
window.removeEventListener("scroll", measure, true);
};
}, [open, enabled, measure]);
return box;
}