supabase/apps/studio/components/ui/SortableSection.tsx

import { useDndMonitor } from '@dnd-kit/core'
import { useSortable } from '@dnd-kit/sortable'
import { GripVertical } from 'lucide-react'
import type { CSSProperties, PropsWithChildren, ReactNode } from 'react'
import { useEffect, useRef, useState } from 'react'
import { Button, cn, DropdownMenu, DropdownMenuTrigger } from 'ui'

const GRIP_WIDTH_REM = 1.5
const ACTIONS_WIDTH_REM = 1.75
const CONTROL_GAP_REM = 1

export const SortableSection = ({
  id,
  children,
  actions,
  sectionWidth,
  gripClassName,
  gripDropdownContent,
}: PropsWithChildren<{
  id: string
  /** Caps the section at this width and centres it, with the controls alongside it. */
  sectionWidth?: string
  gripClassName?: string
  actions?: ReactNode
  gripDropdownContent?: ReactNode
}>) => {
  const { attributes, listeners, setNodeRef, transform, transition, isDragging } = useSortable({
    id,
  })

  const [menuOpen, setMenuOpen] = useState(false)
  const isDraggingRef = useRef(false)
  const openTimeoutRef = useRef<ReturnType<typeof setTimeout>>(undefined)

  useDndMonitor({
    onDragStart: (event) => {
      if (event.active.id === id) {
        isDraggingRef.current = true
        clearTimeout(openTimeoutRef.current)
        setMenuOpen(false)
      }
    },
    onDragEnd: (event) => {
      if (event.active.id === id) isDraggingRef.current = false
    },
    onDragCancel: (event) => {
      if (event.active.id === id) isDraggingRef.current = false
    },
  })

  useEffect(() => () => clearTimeout(openTimeoutRef.current), [])

  // Carried twice — once as the controls, once as padding — so the section stays centred.
  const gutterRem = (actions ? ACTIONS_WIDTH_REM : 0) + GRIP_WIDTH_REM + CONTROL_GAP_REM

  const style: CSSProperties = {
    transform: transform
      ? `translate3d(${Math.round(transform.x)}px, ${Math.round(transform.y)}px, 0)`
      : undefined,
    transition,
    ...(sectionWidth && {
      marginInline: 'auto',
      maxWidth: `calc(${sectionWidth} + ${2 * gutterRem}rem)`,
      paddingRight: `${gutterRem}rem`,
    }),
  }

  return (
    <div
      ref={setNodeRef}
      style={style}
      className="group relative will-change-transform flex w-full items-start gap-x-4 min-w-0 print:break-inside-avoid"
    >
      <div className={cn('flex items-center', gripClassName)}>
        {actions}
        <DropdownMenu
          open={menuOpen}
          onOpenChange={(open) => {
            clearTimeout(openTimeoutRef.current)

            if (!open) {
              setMenuOpen(false)
              return
            }

            openTimeoutRef.current = setTimeout(() => {
              if (!isDraggingRef.current) setMenuOpen(true)
            }, 150)
          }}
        >
          <DropdownMenuTrigger asChild>
            <Button
              type="button"
              variant="text"
              aria-label="Drag to reorder section"
              className={cn(
                'w-6 text-foreground-muted hover:text-foreground cursor-grab active:cursor-grabbing',
                'rounded-sm focus-ring'
              )}
              {...attributes}
              {...listeners}
              tabIndex={0}
              icon={<GripVertical />}
            />
          </DropdownMenuTrigger>
          {gripDropdownContent}
        </DropdownMenu>
      </div>
      <div className={cn('w-full min-w-0', isDragging && 'opacity-70')}>{children}</div>
    </div>
  )
}