Skip to content

Automate browser based workflows with AI

11.1 KB
Raw Blame
import {
  useState,
  useRef,
  useEffect,
  useCallback,
  ReactNode,
  Fragment,
} from "react";

export interface RadialMenuItem {
  id: string;
  enabled?: boolean;
  hidden?: boolean;
  text?: string;
  icon: React.ReactNode;
  onClick: () => void;
}

interface RadialMenuProps {
  items: RadialMenuItem[];
  children: ReactNode;
  /**
   * The size of the buttons in CSS pixel units (e.g., "40px"). If not provided,
   * defaults to "40px".
   */
  buttonSize?: string;
  /**
   * The gap between items in degrees (for radial layout) or pixels (for vertical layout).
   * If not provided, items are evenly spaced around the circle (radial) or use 8px gap (vertical).
   */
  gap?: number;
  /**
   * The radius of the radial menu, in CSS pixel units (e.g., "100px").
   */
  radius?: string;
  /**
   * The starting angle offset in degrees for the first item. If not provided,
   * defaults to 0 degrees (top of the circle).
   */
  startAt?: number;
  /**
   * If true, rotates the text so its baseline runs parallel to the radial line.
   */
  rotateText?: boolean;
  /**
   * Layout mode: "radial" (circular) or "vertical" (stacked list to the right).
   * Defaults to "radial".
   */
  layout?: "radial" | "vertical";
  /**
   * Called when the menu's pinned (click-locked) state changes, so a consumer
   * can reflect the active selection (e.g. a highlight ring on the trigger).
   */
  onPinnedChange?: (pinned: boolean) => void;
}

const proportionalAngle = (
  index: number,
  numItems: number,
  startAtDegrees: number = 0,
) => {
  const normalizedStart = ((startAtDegrees % 360) + 360) % 360;
  const startRadians = (normalizedStart * Math.PI) / 180;

  const angleStep = (2 * Math.PI) / numItems;
  const angle = angleStep * index - Math.PI / 2 + startRadians;

  return angle;
};

const gappedAngle = (
  index: number,
  gapDegrees: number,
  startAtDegrees: number = 0,
) => {
  const normalizedGap = ((gapDegrees % 360) + 360) % 360;
  const normalizedStart = ((startAtDegrees % 360) + 360) % 360;
  const gapRadians = (normalizedGap * Math.PI) / 180;
  const startRadians = (normalizedStart * Math.PI) / 180;

  // each item is the previous item's angle + gap tart from top (-PI/2) + startAt offset,
  // then add gap * index
  const angle = -Math.PI / 2 + startRadians + index * gapRadians;

  return angle;
};

export function RadialMenu({
  items,
  children,
  buttonSize,
  radius,
  gap,
  startAt,
  rotateText,
  layout = "radial",
  onPinnedChange,
}: RadialMenuProps) {
  const [isOpen, setIsOpen] = useState(false);
  const [isPinned, setIsPinned] = useState(false);
  const [calculatedRadius, setCalculatedRadius] = useState<number>(100);

  const close = useCallback(() => {
    setIsOpen(false);
    setIsPinned(false);
  }, []);
  const wrapperRef = useRef<HTMLDivElement>(null);
  const rootRef = useRef<HTMLDivElement>(null);

  useEffect(() => {
    if (!isOpen) {
      return;
    }

    const handleMouseDown = (event: MouseEvent) => {
      const root = rootRef.current;
      if (root && !root.contains(event.target as Node)) {
        close();
      }
    };
    const handleEscKey = (event: KeyboardEvent) => {
      if (event.key === "Escape") {
        close();
      }
    };

    document.addEventListener("mousedown", handleMouseDown, true);
    document.addEventListener("keydown", handleEscKey);
    return () => {
      document.removeEventListener("mousedown", handleMouseDown, true);
      document.removeEventListener("keydown", handleEscKey);
    };
  }, [isOpen, close]);

  useEffect(() => {
    onPinnedChange?.(isPinned);
  }, [isPinned, onPinnedChange]);

  // effect to calculate radius based on wrapped component size if not provided
  useEffect(() => {
    if (!radius && wrapperRef.current) {
      const { width, height } = wrapperRef.current.getBoundingClientRect();
      const minDimension = Math.min(width, height);
      setCalculatedRadius(minDimension);
    } else if (radius) {
      const numericRadius = parseFloat(radius);
      setCalculatedRadius(numericRadius);
    }
  }, [radius, children]);

  const radiusValue = radius || `${calculatedRadius}px`;
  const numRadius = parseFloat(radiusValue);
  const visibleItems = items.filter((item) => !item.hidden);
  const padSizeVertical = numRadius * 2;
  const padSizeHorizontal = padSizeVertical * 4;

  return (
    <div
      ref={rootRef}
      className="relative z-[1000000]"
      onMouseLeave={() => {
        if (!isPinned) {
          setIsOpen(false);
        }
      }}
    >
      {/* a pad (buffer) to widen the hover deactivation area; disabled while
          pinned so outside clicks pass through to the canvas underneath */}
      <div
        className="absolute left-1/2 top-1/2 z-10"
        style={{
          width: `${padSizeHorizontal}px`,
          height: `${padSizeVertical}px`,
          pointerEvents: isOpen && !isPinned ? "auto" : "none",
          transform: "translate(-50%, -50%)",
        }}
      />

      <div
        ref={wrapperRef}
        className="relative z-20"
        onClick={(e) => {
          e.preventDefault();
          e.stopPropagation();
          if (isPinned) {
            close();
          } else {
            setIsOpen(true);
            setIsPinned(true);
          }
        }}
        onMouseEnter={() => {
          setIsOpen(true);
        }}
      >
        <div className="pointer-events-none">{children}</div>
      </div>

      {visibleItems.map((item, index) => {
        const isEnabled = item.enabled !== false;
        const btnSize = buttonSize ?? "40px";
        const btnSizeNum = parseFloat(btnSize);

        if (layout === "vertical") {
          // Vertical layout: stack items to the right of center
          const verticalGap = gap ?? 8;
          const xOffset = numRadius;
          // Center the stack vertically around the middle item
          const totalHeight =
            visibleItems.length * btnSizeNum +
            (visibleItems.length - 1) * verticalGap;
          const startY = -totalHeight / 2 + btnSizeNum / 2;
          const yOffset = startY + index * (btnSizeNum + verticalGap);

          return (
            <div
              key={item.id}
              onClick={() => {
                if (isEnabled) {
                  item.onClick();
                  close();
                }
              }}
              className="absolute left-1/2 top-1/2 z-30 flex cursor-pointer items-center gap-2 transition-all duration-300 ease-out"
              style={{
                transform: isOpen
                  ? `translate(0%, -50%) translate(${xOffset}px, ${yOffset}px) scale(1)`
                  : `translate(0%, -50%) translate(0, 0) scale(0)`,
                opacity: isOpen ? (isEnabled ? 1 : 0.5) : 0,
                pointerEvents: isOpen ? (isEnabled ? "auto" : "none") : "none",
                transitionDelay: isOpen ? `${index * 50}ms` : "0ms",
              }}
            >
              <button
                disabled={!isEnabled}
                className="flex items-center justify-center rounded-full bg-white shadow-lg hover:bg-gray-50 disabled:cursor-not-allowed"
                style={{
                  width: btnSize,
                  height: btnSize,
                }}
              >
                <div className="text-gray-700">{item.icon}</div>
              </button>
              {item.text && (
                <span
                  className="whitespace-nowrap rounded bg-white px-2 py-1 text-xs text-gray-700 shadow-md"
                  style={{
                    opacity: isEnabled ? 1 : 0.5,
                    cursor: isEnabled ? "pointer" : "not-allowed",
                  }}
                >
                  {item.text}
                </span>
              )}
            </div>
          );
        }

        // Radial layout (default)
        const angle =
          gap !== undefined
            ? gappedAngle(index, gap, startAt)
            : proportionalAngle(index, visibleItems.length, startAt);
        const x = Math.cos(angle) * parseFloat(radiusValue);
        const y = Math.sin(angle) * parseFloat(radiusValue);

        // calculate text offset along the radial line
        const textDistance = 0.375 * numRadius;
        const textX = Math.cos(angle) * textDistance;
        const textY = Math.sin(angle) * textDistance;

        // convert angle from radians to degrees for CSS rotation
        const angleDegrees = (angle * 180) / Math.PI;
        // normalize angle to 0-360 range
        const normalizedAngle = ((angleDegrees % 360) + 360) % 360;
        // flip text if it would be upside-down (between 90° and 270°)
        const textTransform =
          normalizedAngle > 90 && normalizedAngle < 270
            ? "scaleY(-1) scaleX(-1)"
            : "scaleY(1)";

        return (
          <Fragment key={item.id}>
            <button
              onClick={() => {
                item.onClick();
                close();
              }}
              disabled={!isEnabled}
              className="absolute left-1/2 top-1/2 z-30 flex items-center justify-center rounded-full bg-white shadow-lg transition-all duration-300 ease-out hover:bg-gray-50 disabled:cursor-not-allowed"
              style={{
                width: btnSize,
                height: btnSize,
                transform: isOpen
                  ? `translate(-50%, -50%) translate(${x}px, ${y}px) scale(1)`
                  : "translate(-50%, -50%) translate(0, 0) scale(0)",
                opacity: isOpen ? (isEnabled ? 1 : 0.5) : 0,
                pointerEvents: isOpen ? "auto" : "none",
                transitionDelay: isOpen ? `${index * 50}ms` : "0ms",
              }}
            >
              <div className="text-gray-700">{item.icon}</div>
            </button>
            {item.text && (
              <div
                key={`${item.id}-text`}
                onClick={() => {
                  item.onClick();
                  close();
                }}
                className="absolute left-1/2 top-1/2 z-30 cursor-pointer whitespace-nowrap rounded bg-white px-2 py-1 text-xs text-gray-700 shadow-md transition-all duration-300 ease-out"
                style={{
                  transform: isOpen
                    ? rotateText
                      ? `translate(0%, -50%) translate(${x + textX}px, ${y + textY}px) rotate(${angleDegrees}deg) scale(1)`
                      : `translate(0%, -50%) translate(${x + textX}px, ${y + textY}px) scale(1)`
                    : `translate(0%, -50%) translate(0, 0) scale(0.5) rotate(${angleDegrees}deg)`,
                  opacity: isOpen ? (isEnabled ? 1 : 0.5) : 0,
                  transformOrigin: "left center",
                  pointerEvents: isOpen ? "auto" : "none",
                  transitionDelay: isOpen ? `${index * 50}ms` : "0ms",
                }}
              >
                <span
                  style={{
                    display: "inline-block",
                    transform: textTransform,
                    opacity: isEnabled ? 1 : 0.5,
                    cursor: isEnabled ? "pointer" : "not-allowed",
                  }}
                >
                  {item.text}
                </span>
              </div>
            )}
          </Fragment>
        );
      })}
    </div>
  );
}