Skip to content

The Open Standard for Generative UI

4.8 KB
Raw Blame
import { useLayoutEffect, useRef, type PointerEvent } from "react";
import { readPreference, writePreference } from "../../utils/preferences";
import { useAgentInterfaceStore } from "./_shared/store";

/* Keep DEFAULT in step with $sidebar-width in sidebar.scss. */
const DEFAULT_WIDTH = 272;
const MIN_WIDTH = 220;
const MAX_WIDTH = 420;
/* Dragged narrower than this, the sidebar snaps shut; dragged wider from the
   rail, it snaps open at MIN_WIDTH or wider. */
const COLLAPSE_AT = 150;
/* Lands on the default width when released within this many px of it. */
const SNAP_DISTANCE = 14;
const SAVE_DELAY_MS = 300;
const WIDTH_KEY = "openui-agent-sidebar-width";
const WIDTH_VAR = "--openui-agent-sidebar-width";

const isValidWidth = (width: unknown): width is number =>
  typeof width === "number" && width >= MIN_WIDTH && width <= MAX_WIDTH;

const fitWidth = (raw: number) => {
  const width = Math.min(Math.max(raw, MIN_WIDTH), MAX_WIDTH);
  return Math.abs(width - DEFAULT_WIDTH) <= SNAP_DISTANCE ? DEFAULT_WIDTH : width;
};

/**
 * The sidebar's right edge, draggable. It has no look of its own beyond the
 * resize cursor. The width lives in a CSS variable on the sidebar container,
 * written straight to the element so a drag doesn't re-render the tree, and is
 * saved as a preference once the pointer settles.
 */
export const SidebarResizeEdge = () => {
  const { isSidebarOpen, setIsSidebarOpen } = useAgentInterfaceStore((state) => ({
    isSidebarOpen: state.isSidebarOpen,
    setIsSidebarOpen: state.setIsSidebarOpen,
  }));
  const edgeRef = useRef<HTMLDivElement>(null);
  const widthRef = useRef(DEFAULT_WIDTH);
  const openRef = useRef(isSidebarOpen);
  openRef.current = isSidebarOpen;
  const dragRef = useRef<{ startX: number; startWidth: number; restoreWidth: number } | null>(null);
  const saveTimeoutRef = useRef<ReturnType<typeof setTimeout> | null>(null);

  const container = () => edgeRef.current?.parentElement ?? null;

  const applyWidth = (width: number) => {
    widthRef.current = width;
    container()?.style.setProperty(WIDTH_VAR, `${width}px`);
  };

  const scheduleSave = () => {
    if (saveTimeoutRef.current) clearTimeout(saveTimeoutRef.current);
    saveTimeoutRef.current = setTimeout(
      () => writePreference(WIDTH_KEY, widthRef.current),
      SAVE_DELAY_MS,
    );
  };

  // Before paint, so the sidebar opens at its saved width rather than the
  // default and then jumping: apply it with transitions off, force the style
  // to settle, then let transitions back on.
  useLayoutEffect(() => {
    const saved = readPreference<number>(WIDTH_KEY);
    const el = container();
    if (el && isValidWidth(saved)) {
      el.classList.add("openui-agent-sidebar-container--resizing");
      widthRef.current = saved;
      el.style.setProperty(WIDTH_VAR, `${saved}px`);
      void el.offsetWidth;
      el.classList.remove("openui-agent-sidebar-container--resizing");
    }
    return () => {
      if (saveTimeoutRef.current) clearTimeout(saveTimeoutRef.current);
      container()?.style.removeProperty(WIDTH_VAR);
    };
  }, []);

  const handlePointerDown = (event: PointerEvent<HTMLDivElement>) => {
    if (event.button !== 0) return;
    const el = container();
    if (!el) return;
    event.preventDefault();
    event.currentTarget.setPointerCapture(event.pointerId);
    dragRef.current = {
      startX: event.clientX,
      startWidth: openRef.current ? widthRef.current : el.getBoundingClientRect().width,
      restoreWidth: widthRef.current,
    };
    el.classList.add("openui-agent-sidebar-container--resizing");
    document.body.style.cursor = "col-resize";
    document.body.style.userSelect = "none";
  };

  const handlePointerMove = (event: PointerEvent<HTMLDivElement>) => {
    const drag = dragRef.current;
    if (!drag) return;
    const raw = drag.startWidth + event.clientX - drag.startX;

    if (raw < COLLAPSE_AT) {
      // Snapping shut keeps the width it had, so it reopens the same size
      // rather than at whatever the drag passed through on the way.
      applyWidth(drag.restoreWidth);
      if (openRef.current) setIsSidebarOpen(false);
      return;
    }

    if (!openRef.current) setIsSidebarOpen(true);
    applyWidth(fitWidth(raw));
  };

  const endDrag = (event: PointerEvent<HTMLDivElement>) => {
    if (!dragRef.current) return;
    dragRef.current = null;
    if (event.currentTarget.hasPointerCapture(event.pointerId)) {
      event.currentTarget.releasePointerCapture(event.pointerId);
    }
    container()?.classList.remove("openui-agent-sidebar-container--resizing");
    document.body.style.cursor = "";
    document.body.style.userSelect = "";
    scheduleSave();
  };

  return (
    <div
      ref={edgeRef}
      aria-hidden="true"
      className="openui-agent-sidebar-resize-edge"
      onPointerDown={handlePointerDown}
      onPointerMove={handlePointerMove}
      onPointerUp={endDrag}
      onPointerCancel={endDrag}
    />
  );
};