Skip to content

armgit / Pulse

Public Imported from GitHub
0

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.

3.8 KB
Raw Blame
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,
  };
}