Real-time monitoring dashboard for Proxmox VE, PBS, Docker, Kubernetes, TrueNAS and vSphere. Self-hosted, with alerts for failed backups, full disks, unhealthy containers and offline nodes.
Go aialertsdashboarddockerdocker-monitoringgohomelabinfrastructure-monitoringkubernetesmonitoringmspproxmoxproxmox-backup-serverproxmox-mail-gatewayproxmox-veself-hostedtruenastypescriptvspherewebhooks
import { createEffect, createMemo, createSignal, onCleanup } from 'solid-js';
import {
calculateHelpPopoverPosition,
getHelpPopoverMaxWidth,
getHelpPopoverPreferredPosition,
getHelpIconSize,
getMissingHelpContentWarning,
resolveHelpContent,
type HelpIconProps,
} from './helpIconModel';
export function useHelpIconState(props: HelpIconProps) {
const [isOpen, setIsOpen] = createSignal(false);
const [popoverPosition, setPopoverPosition] = createSignal({ top: 0, left: 0 });
const [buttonRef, setButtonRef] = createSignal<HTMLButtonElement>();
const [closeButtonRef, setCloseButtonRef] = createSignal<HTMLButtonElement>();
const [popoverRef, setPopoverRef] = createSignal<HTMLDivElement>();
const helpContent = createMemo(() => resolveHelpContent(props));
const size = createMemo(() => getHelpIconSize(props.size));
const maxWidth = createMemo(() => getHelpPopoverMaxWidth(props.maxWidth));
const preferredPosition = createMemo(() => getHelpPopoverPreferredPosition(props.position));
const closeAndRestoreFocus = () => {
setIsOpen(false);
buttonRef()?.focus({ preventScroll: true });
};
createEffect(() => {
if (!isOpen() || !buttonRef()) return;
const updatePosition = () => {
const button = buttonRef();
const popover = popoverRef();
if (!button || !popover) return;
setPopoverPosition(
calculateHelpPopoverPosition({
buttonRect: button.getBoundingClientRect(),
// Opening animations transform the visual box. Place the full layout
// box so the dialog remains contained when the animation finishes.
popoverRect: new DOMRect(0, 0, popover.offsetWidth, popover.offsetHeight),
preferredPosition: preferredPosition(),
viewportWidth: window.innerWidth,
viewportHeight: window.innerHeight,
}),
);
};
const frame = requestAnimationFrame(() => {
updatePosition();
closeButtonRef()?.focus({ preventScroll: true });
});
window.addEventListener('resize', updatePosition);
window.addEventListener('scroll', updatePosition, true);
const observer =
typeof ResizeObserver === 'undefined' ? undefined : new ResizeObserver(updatePosition);
const popover = popoverRef();
if (popover) observer?.observe(popover);
onCleanup(() => {
cancelAnimationFrame(frame);
window.removeEventListener('resize', updatePosition);
window.removeEventListener('scroll', updatePosition, true);
observer?.disconnect();
});
});
createEffect(() => {
if (!isOpen()) return;
const button = buttonRef();
const popover = popoverRef();
const handleClickOutside = (event: MouseEvent) => {
const target = event.target as Node;
if (button?.contains(target) || popover?.contains(target)) return;
setIsOpen(false);
};
const handleEscape = (event: KeyboardEvent) => {
if (event.key === 'Escape') {
closeAndRestoreFocus();
}
};
const timeoutId = setTimeout(() => {
document.addEventListener('click', handleClickOutside);
document.addEventListener('keydown', handleEscape);
}, 0);
onCleanup(() => {
clearTimeout(timeoutId);
document.removeEventListener('click', handleClickOutside);
document.removeEventListener('keydown', handleEscape);
});
});
const missingContentWarning = getMissingHelpContentWarning(props.contentId);
if (!helpContent() && missingContentWarning) {
console.warn(missingContentWarning);
}
const toggleOpen = (event: MouseEvent) => {
event.stopPropagation();
setIsOpen(!isOpen());
};
return {
buttonRef,
closeAndRestoreFocus,
helpContent,
isOpen,
maxWidth,
popoverPosition,
popoverRef,
preferredPosition,
setButtonRef,
setCloseButtonRef,
setIsOpen,
setPopoverRef,
size,
toggleOpen,
};
}