Skip to content

A reactive notebook for Python — run reproducible experiments, query with SQL, execute as a script, deploy as an app, and version with git. Stored as pure Python. All in a modern, AI-native editor.

12.2 KB
Raw Blame
/* Copyright 2026 Marimo. All rights reserved. */

import { useAtomValue } from "jotai";
import * as React from "react";
import {
  type CellGraph,
  cellGraphsAtom,
  isVariableAffectedBySelectedCell,
} from "@/components/editor/chrome/wrapper/minimap-state";
import { useCellData, useCellRuntime } from "@/core/cells/cells";
import { useCellActions } from "@/core/cells/actions";
import { cellFocusAtom, useCellFocusActions } from "@/core/cells/focus";
import type { CellId } from "@/core/cells/ids";
import { useLayout } from "@/core/cells/layout";
import { useVariables } from "@/core/variables/state";
import { cn } from "@/utils/cn";
import { extractCellPreview } from "./utils/cell-preview";

interface MinimapCellProps {
  cellId: CellId;
  index: number;
  cellPositions: Readonly<Record<CellId, number>>;
}

const MinimapCell: React.FC<MinimapCellProps> = (props) => {
  const focusState = useAtomValue(cellFocusAtom);
  const graphs = useAtomValue(cellGraphsAtom);
  const actions = useCellActions();
  const focusActions = useCellFocusActions();

  const cell = {
    id: props.cellId,
    graph: graphs[props.cellId],
    code: useCellData(props.cellId).code,
    hasError: useCellRuntime(props.cellId).errored,
  };

  let selectedCell: undefined | { id: CellId; graph: CellGraph };
  if (focusState.focusedCellId && graphs[focusState.focusedCellId]) {
    selectedCell = {
      id: focusState.focusedCellId,
      graph: graphs[focusState.focusedCellId],
    };
  }

  const isSelected = selectedCell?.id === cell.id;
  const preview = extractCellPreview(cell.code);
  const circleRadius = isNonReferenceableCell(cell.graph) ? 1.5 : 3;

  const handleClick = () => {
    if (isSelected) {
      // If clicking the already focused cell, blur it
      focusActions.blurCell();
    } else {
      // Otherwise focus the cell
      actions.focusCell({ cellId: cell.id, where: "exact" });
      focusActions.focusCell({ cellId: cell.id });
    }
  };

  return (
    <button
      type="button"
      data-node-id={cell.id}
      className={cn(
        "group bg-transparent text-left w-full flex relative justify-between items-center",
        "border-none rounded cursor-pointer",
        "h-[21px] pl-[65px] font-inherit",
        isSelected
          ? "text-primary-foreground"
          : "text-(--gray-8) hover:text-(--gray-9)",
      )}
      onClick={handleClick}
      // Prevent the default mousedown behavior to avoid blur events on the currently
      // focused cell. Without this, clicking the minimap causes a flicker as the focus
      // transitions from current cell -> null -> new cell.
      onMouseDown={(e) => e.preventDefault()}
    >
      <span
        className="absolute left-0 top-0 h-full w-5 flex items-center justify-end pr-1.5 text-[10px] tabular-nums pointer-events-none select-none text-(--gray-9)"
        aria-hidden="true"
      >
        {props.index}
      </span>
      <div
        className={cn(
          "group-hover:bg-(--gray-2) flex h-full w-full px-0.5 items-center rounded",
          isSelected && "bg-primary group-hover:bg-primary",
        )}
      >
        <div
          className="truncate px-1 font-mono text-sm flex gap-1"
          title={cell.code}
        >
          {cell.graph.variables.length > 0 ? (
            <VariablesList cell={cell} selectedCell={selectedCell} />
          ) : (
            <span className="overflow-hidden text-ellipsis whitespace-nowrap max-w-full">
              {preview.text ?? <span className="italic">empty</span>}
            </span>
          )}
        </div>
      </div>
      <svg
        className={cn(
          "absolute overflow-visible top-[10.5px] left-[calc(var(--spacing-extra-small,8px)+31px)] pointer-events-none",
          isSelected ? "z-1" : "z-0",
          getTextColor({ cell, selectedCell }),
        )}
        width="1"
        height="1"
      >
        <title>Cell dependency connections for cell {cell.id}</title>
        {isSelected ? (
          <SelectedCell
            cell={cell}
            cellPositions={props.cellPositions}
            circleRadius={circleRadius}
          />
        ) : (
          <UnselectedCell
            cell={cell}
            selectedCell={selectedCell}
            circleRadius={circleRadius}
          />
        )}
      </svg>
    </button>
  );
};

const VariablesList: React.FC<{
  cell: { id: CellId; graph: CellGraph };
  selectedCell?: { id: CellId; graph: CellGraph };
}> = ({ cell, selectedCell }) => {
  const variables = useVariables();
  const isSelected = cell.id === selectedCell?.id;
  return (
    <>
      {cell.graph.variables.map((varName, idx) => {
        const variable = variables[varName];
        return (
          <React.Fragment key={varName}>
            {idx > 0 && ", "}
            <span
              className={cn({
                "font-bold": isSelected,
                "text-foreground": selectedCell === undefined,
                "text-primary font-medium":
                  !isSelected &&
                  isVariableAffectedBySelectedCell(variable, selectedCell),
              })}
            >
              {varName}
            </span>
          </React.Fragment>
        );
      })}
    </>
  );
};

// Connection paths (for selected)
const SelectedCell = (options: {
  cell: { id: CellId; graph: CellGraph };
  cellPositions: Record<CellId, number>;
  circleRadius: number;
}) => {
  const { cell, cellPositions, circleRadius } = options;
  const dy = 21;
  const paths: React.ReactElement[] = [];
  const currentY = cellPositions[cell.id] ?? 0;

  // First, identify all cycles (nodes that are both parent and child)
  const cycles = new Set<CellId>();
  for (const parentCellId of cell.graph.parents) {
    if (cell.graph.children.has(parentCellId)) {
      cycles.add(parentCellId);
    }
  }

  // Add cycle paths first
  for (const cycleCellId of cycles) {
    const targetY = cellPositions[cycleCellId];
    if (targetY !== undefined) {
      const yDiff = (targetY - currentY) * dy;
      // Draw a rectangular path around both nodes to show the cycle
      paths.push(
        <path
          key={`${cell.id}-cycle-${cycleCellId}`}
          d={`M -3 0 H -7 v ${yDiff} h 14 v ${-yDiff} H 3`}
          fill="none"
          strokeWidth="2"
          stroke="currentColor"
        />,
      );
    }
  }

  // Add regular upstream connections (excluding cycles)
  for (const parentCellId of cell.graph.parents) {
    if (cycles.has(parentCellId)) {
      continue; // Skip - already handled as cycle
    }
    const targetY = cellPositions[parentCellId];
    if (targetY !== undefined) {
      const yDiff = (targetY - currentY) * dy;
      paths.push(
        <path
          key={`${cell.id}-up-${parentCellId}`}
          d={`M -3 0 H -7 v ${yDiff} h -4`}
          fill="none"
          strokeWidth="2"
          stroke="currentColor"
        />,
      );
    }
  }

  // Add regular downstream connections (excluding cycles)
  for (const childCellId of cell.graph.children) {
    if (cycles.has(childCellId)) {
      continue; // Skip - already handled as cycle
    }
    const targetY = cellPositions[childCellId];
    if (targetY !== undefined) {
      const yDiff = (targetY - currentY) * dy;
      paths.push(
        <path
          key={`${cell.id}-down-${childCellId}`}
          d={`M 3 0 H 7 v ${yDiff} h 4`}
          fill="none"
          strokeWidth="2"
          stroke="currentColor"
        />,
      );
    }
  }

  return (
    <g transform="translate(0, 0)">
      <circle
        r={circleRadius}
        fill="currentColor"
        className="pointer-events-auto"
      />
      <g className="pen pointer-events-auto">{paths}</g>
    </g>
  );
};

// Connection indicators for non-selected cells
function UnselectedCell(options: {
  cell: { id: CellId; graph: CellGraph };
  selectedCell?: { id: CellId; graph: CellGraph };
  circleRadius: number;
}) {
  const { cell, selectedCell, circleRadius } = options;

  const hasAncestors = cell.graph.ancestors.size > 0;
  const hasDescendants = cell.graph.descendants.size > 0;

  if (!selectedCell) {
    // There is no selection, so show all upstream/downstream indicators
    return drawConnectionGlyph({
      circleRadius,
      leftWisker: hasAncestors,
      rightWisker: hasDescendants,
    });
  }

  const isAncestorOfSelected = selectedCell.graph.ancestors.has(cell.id);
  const isDescendantOfSelected = selectedCell.graph.descendants.has(cell.id);
  if (isAncestorOfSelected || isDescendantOfSelected) {
    return drawConnectionGlyph({
      circleRadius,
      leftWisker: hasAncestors,
      rightWisker: hasDescendants,
      // Node is a part of the current selection, need to jitter
      // If it's both ancestor and descendant (cycle), keep it centered
      shift:
        isAncestorOfSelected && isDescendantOfSelected
          ? undefined
          : isAncestorOfSelected
            ? "left"
            : "right",
    });
  }

  // Node is outside of the current selection (keep center & hide upstream/downstream indicators)
  return drawConnectionGlyph({
    circleRadius,
    leftWisker: false,
    rightWisker: false,
  });
}

function drawConnectionGlyph(options: {
  circleRadius: number;
  leftWisker: boolean;
  rightWisker: boolean;
  shift?: "left" | "right";
}) {
  const { circleRadius, leftWisker, rightWisker, shift } = options;
  const dx = shift === undefined ? 0 : shift === "left" ? -14 : 14;
  return (
    <g transform={`translate(${dx}, 0)`}>
      <g>
        {/* Whisker pointing left (has upstream connections) */}
        {leftWisker && (
          <path
            d="M 0 0 h -8"
            fill="none"
            strokeWidth="2"
            stroke="currentColor"
          />
        )}
        {/* Whisker pointing right (has downstream connections) */}
        {rightWisker && (
          <path
            d="M 0 0 h 8"
            fill="none"
            strokeWidth="2"
            stroke="currentColor"
          />
        )}
      </g>
      <circle
        r={circleRadius}
        fill="currentColor"
        className="pointer-events-auto"
      />
    </g>
  );
}

/**
 * Color for the node/connections in the SVG diagram
 */
function getTextColor({
  cell,
  selectedCell,
}: {
  cell: { id: CellId; hasError: boolean; graph: CellGraph };
  selectedCell?: { id: CellId; graph: CellGraph };
}) {
  if (cell.hasError) {
    return "text-destructive";
  }

  // Nothing selected. Nodes that declare or uses variables
  if (!selectedCell && !isNonReferenceableCell(cell.graph)) {
    return "text-foreground";
  }

  // Inside the selected graph
  if (
    selectedCell?.id === cell.id ||
    selectedCell?.graph.parents.has(cell.id) ||
    selectedCell?.graph.children.has(cell.id)
  ) {
    return "text-primary";
  }

  return "text-(--gray-8)";
}

/**
 * Whether a cell is unconnected AND does not declare any variables
 */
function isNonReferenceableCell(graph: CellGraph): boolean {
  return (
    graph.variables.length === 0 &&
    graph.ancestors.size === 0 &&
    graph.descendants.size === 0
  );
}

/**
 * Minimap content component for display in the dependencies panel.
 * Shows a scrollable list of cells with dependency visualization.
 */
export const MinimapContent: React.FC = () => {
  const layout = useLayout();
  const rows = layout.columns.flatMap((column, index) =>
    column.ids.map((cellId, position) => ({
      cellId,
      startsColumn: index > 0 && position === 0,
    })),
  );
  const cellPositions: Record<CellId, number> = Object.fromEntries(
    rows.map(({ cellId }, idx) => [cellId, idx]),
  );

  return (
    <div className="overflow-y-auto overflow-x-hidden flex-1 scrollbar-none h-full max-w-80">
      <div className="py-3 pl-3 pr-4 relative min-h-full">
        {rows.map(({ cellId, startsColumn }, idx) => {
          return (
            <React.Fragment key={cellId}>
              {/* Subtle visual divider between nodes */}
              {startsColumn && (
                <div
                  className="absolute left-5 w-[36px] h-px bg-(--gray-4) pointer-events-none"
                  aria-hidden="true"
                />
              )}
              <MinimapCell
                cellId={cellId}
                index={idx}
                cellPositions={cellPositions}
              />
            </React.Fragment>
          );
        })}
      </div>
      {/* Invisible element to prevent SVG overflow from affecting scroll */}
      <div className="h-0 overflow-hidden" aria-hidden="true" />
    </div>
  );
};