Skip to content

The Open Standard for Generative UI

3.3 KB
Raw Blame
import { useCallback, useEffect, useState, type ReactNode } from "react";
import { createPortal } from "react-dom";
import { useRegisteredLibraries, type DevtoolsConfig } from "../lib";
import type { ColorMode } from "../theme";
import { DebugUI } from "./DebugUI";
import { debugMountNode, openDebugWindow } from "./eject";

/**
 * Session for OpenUI Debug: editor contents, registered libraries, tray vs
 * ejected window. Inspect stays independent — this hook never opens or closes
 * that tray. Escape should call `retract` (tray only); Debug's own close
 * button calls `close` (tray and popup).
 */
export function useDebug({
  theme,
  helpSeen,
  editorPct,
  setConfig,
}: {
  theme: ColorMode;
  helpSeen: boolean;
  editorPct: number;
  setConfig: (patch: Partial<DevtoolsConfig>) => void;
}): {
  trayOpen: boolean;
  canOpen: boolean;
  openWith: (response: string, libraryId?: string) => void;
  close: () => void;
  retract: () => void;
  view: ReactNode;
  portal: ReactNode;
} {
  const libraries = useRegisteredLibraries();
  const [trayOpen, setTrayOpen] = useState(false);
  const [popup, setPopup] = useState<Window | null>(null);
  const [popupBlocked, setPopupBlocked] = useState(false);
  const [code, setCode] = useState("");
  const [libraryId, setLibraryId] = useState<string | undefined>();
  const markHelpSeen = useCallback(() => setConfig({ helpSeen: true }), [setConfig]);

  useEffect(() => {
    if (!popup) return;
    const onGone = () => setPopup(null);
    popup.addEventListener("pagehide", onGone);
    return () => popup.removeEventListener("pagehide", onGone);
  }, [popup]);

  const close = useCallback(() => {
    if (popup) {
      popup.close();
      setPopup(null);
    }
    setTrayOpen(false);
    setPopupBlocked(false);
  }, [popup]);

  const retract = useCallback(() => setTrayOpen(false), []);

  const eject = useCallback(() => {
    const next = openDebugWindow();
    if (!next) {
      setPopupBlocked(true);
      return;
    }
    setPopupBlocked(false);
    setPopup(next);
    setTrayOpen(false);
  }, []);

  const minimize = useCallback(() => {
    if (popup) {
      popup.close();
      setPopup(null);
    }
    setPopupBlocked(false);
    setTrayOpen(true);
  }, [popup]);

  const open = useCallback(() => {
    setPopupBlocked(false);
    if (popup && !popup.closed) {
      popup.focus();
      return;
    }
    if (popup) setPopup(null);
    setTrayOpen(true);
  }, [popup]);

  const openWith = useCallback(
    (response: string, nextLibraryId?: string) => {
      setCode(response);
      setLibraryId(nextLibraryId);
      open();
    },
    [open],
  );

  const view = (
    <DebugUI
      libraries={libraries}
      code={code}
      onCodeChange={setCode}
      libraryId={libraryId}
      editorPct={editorPct}
      onEditorPctChange={(pct) => setConfig({ editorPct: pct })}
      ejected={Boolean(popup)}
      onEject={eject}
      onMinimize={minimize}
      onClose={close}
      theme={theme}
      onThemeChange={(next) => setConfig({ theme: next })}
      helpSeen={helpSeen}
      onHelpSeen={markHelpSeen}
      popupBlocked={popupBlocked}
    />
  );
  const popupRoot = popup ? debugMountNode(popup) : null;

  return {
    trayOpen,
    canOpen: libraries.length > 0,
    openWith,
    close,
    retract,
    view,
    portal: popupRoot ? createPortal(view, popupRoot) : null,
  };
}