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.
Python artificial-intelligencedagdata-sciencedata-visualizationdataflowdeveloper-toolsmachine-learningnotebookspipelinepythonreactivesqlweb-app
/* Copyright 2026 Marimo. All rights reserved. */
import { DatabaseIcon, DiamondPlusIcon, PlusIcon } from "lucide-react";
import { useRef, useState } from "react";
import { Button } from "@/components/editor/inputs/Inputs";
import { MinimalHotkeys } from "@/components/shortcuts/renderShortcut";
import {
DropdownMenu,
DropdownMenuContent,
DropdownMenuItem,
DropdownMenuTrigger,
} from "@/components/ui/dropdown-menu";
import { maybeAddMarimoImport } from "@/core/cells/add-missing-import";
import { useCellActions } from "@/core/cells/actions";
import { LanguageAdapters } from "@/core/codemirror/language/LanguageAdapters";
import { MARKDOWN_INITIAL_HIDE_CODE } from "@/core/codemirror/language/languages/markdown";
import {
getConnectionTooltip,
isAppInteractionDisabled,
} from "@/core/session/connection-utils";
import type { ConnectionState } from "@/core/session/types";
import { cn } from "@/utils/cn";
import { Tooltip } from "../../ui/tooltip";
import { MarkdownIcon, PythonIcon } from "./code/icons";
export const CreateCellButton = ({
connectionState,
onClick,
tooltipContent,
oneClickShortcut,
}: {
connectionState: ConnectionState;
tooltipContent: React.ReactNode;
onClick: ((opts: { code: string; hideCode?: boolean }) => void) | undefined;
oneClickShortcut: "shift" | "mod";
}) => {
const { createCell, addSetupCell } = useCellActions();
const shortcut = `${oneClickShortcut}-Click`;
const [open, setOpen] = useState(false);
// Time the dropdown last opened, to ignore the click that opened it
const openedAt = useRef(0);
const baseTooltipContent =
getConnectionTooltip(connectionState) || tooltipContent;
const finalTooltipContent = isAppInteractionDisabled(connectionState) ? (
baseTooltipContent
) : (
<div className="flex flex-col gap-4">
<div>{baseTooltipContent}</div>
<div className="text-xs text-muted-foreground font-medium pt-1 -mt-2 border-t border-border">
{<MinimalHotkeys shortcut={shortcut} className="inline" />}{" "}
<span>for other cell types</span>
</div>
</div>
);
const addPythonCell = () => {
onClick?.({ code: "" });
};
// NB: When adding the marimo import for markdown and SQL, we run it
// automatically regardless of whether autoinstantiate or lazy execution is
// enabled; the user experience is confusing otherwise (how does the user
// know they need to run import marimo as mo. first?).
const addMarkdownCell = () => {
maybeAddMarimoImport({ autoInstantiate: true, createCell });
onClick?.({
code: LanguageAdapters.markdown.defaultCode,
hideCode: MARKDOWN_INITIAL_HIDE_CODE,
});
};
const addSQLCell = () => {
maybeAddMarimoImport({ autoInstantiate: true, createCell });
onClick?.({ code: LanguageAdapters.sql.defaultCode });
};
const renderIcon = (icon: React.ReactNode) => {
return <div className="mr-3 text-muted-foreground">{icon}</div>;
};
const openDropdown = () => {
setOpen(true);
openedAt.current = Date.now();
};
// We use onPointerDownCapture (not onPointerDown) to intercept events in
// capture phase before Radix's DropdownMenuTrigger sees them. Radix ignores
// Ctrl+Click (likely to avoid interfering with browser), so we bypass its
// trigger entirely and manage the dropdown's open state ourselves.
const handlePointerDownCapture = (e: React.MouseEvent) => {
// Ignore right-clicks, handled by onContextMenuCapture
if (e.button === 2) {
return;
}
// Don't propagate event to Radix
e.preventDefault();
e.stopPropagation();
const hasModifier =
oneClickShortcut === "shift" ? e.shiftKey : e.metaKey || e.ctrlKey;
if (hasModifier) {
openDropdown();
} else {
addPythonCell();
}
};
const handleContextMenu = (e: React.MouseEvent) => {
e.preventDefault();
e.stopPropagation();
openDropdown();
};
const handleOpenChange = (isOpen: boolean) => {
setOpen(isOpen);
if (isOpen) {
openedAt.current = Date.now();
}
};
const handleFirstItemClick = (e: React.MouseEvent) => {
// Hack to prevent the first item from being clicked when the dropdown is
// opened: allow interactions only after a brief delay
if (Date.now() - openedAt.current < 200) {
e.preventDefault();
e.stopPropagation();
return;
}
addPythonCell();
};
return (
<DropdownMenu open={open} onOpenChange={handleOpenChange}>
<DropdownMenuTrigger asChild={true}>
<Button
className={cn(
"border-none hover-action shadow-none! bg-transparent! focus-visible:outline-hidden",
isAppInteractionDisabled(connectionState) && " inactive-button",
)}
onPointerDownCapture={handlePointerDownCapture}
onContextMenuCapture={handleContextMenu}
size="small"
data-testid="create-cell-button"
>
<Tooltip content={finalTooltipContent}>
<PlusIcon
strokeWidth={1.8}
size={14}
className="opacity-60 hover:opacity-90"
/>
</Tooltip>
</Button>
</DropdownMenuTrigger>
<DropdownMenuContent side="bottom" sideOffset={-30}>
<DropdownMenuItem onClick={handleFirstItemClick}>
{renderIcon(<PythonIcon />)}
Python cell
</DropdownMenuItem>
<DropdownMenuItem onClick={addMarkdownCell}>
{renderIcon(<MarkdownIcon />)}
Markdown cell
</DropdownMenuItem>
<DropdownMenuItem onClick={addSQLCell}>
{renderIcon(<DatabaseIcon size={13} strokeWidth={1.5} />)}
SQL cell
</DropdownMenuItem>
<DropdownMenuItem onClick={() => addSetupCell()}>
{renderIcon(<DiamondPlusIcon size={13} strokeWidth={1.5} />)}
Setup cell
</DropdownMenuItem>
</DropdownMenuContent>
</DropdownMenu>
);
};