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 type { Cell, Table } from "@tanstack/react-table";
import useEvent from "react-use-event-hook";
import { Events } from "@/utils/events";
import { type SelectedCell, useCellSelectionReducerActions } from "./atoms";
export interface UseCellRangeSelectionProps<TData> {
table: Table<TData>;
}
/*
* Pure hook that provides only actions without causing re-renders.
* Use this in components that only need to trigger actions.
*/
export const useCellRangeSelection = <TData>({
table,
}: UseCellRangeSelectionProps<TData>) => {
const actions = useCellSelectionReducerActions();
const handleCopy = useEvent(() => {
actions.handleCopy({
table,
onCopyComplete: () => {
// Auto-clear after 500ms
setTimeout(() => {
actions.setCopiedCells(new Set());
}, 500);
},
});
});
const updateSelection = useEvent(
(newCell: SelectedCell, isShiftKey: boolean) => {
actions.updateSelection({ newCell, isShiftKey, table });
},
);
const navigate = useEvent(
(
e: React.KeyboardEvent<HTMLElement>,
direction: "up" | "down" | "left" | "right",
) => {
actions.navigate({ direction, isShiftKey: e.shiftKey, table });
},
);
const handleCellFocus = useEvent((cell: Cell<TData, unknown>) => {
actions.setFocusedCell({
cellId: cell.id,
rowId: cell.row.id,
columnId: cell.column.id,
});
});
const handleCellsKeyDown = useEvent(
(e: React.KeyboardEvent<HTMLElement>, cell: Cell<TData, unknown>) => {
if (e.defaultPrevented || isInteractiveTarget(e)) {
return;
}
switch (e.key) {
case "c":
if (Events.isMetaOrCtrl(e)) {
handleCopy();
}
break;
case "ArrowDown":
e.preventDefault();
navigate(e, "down");
break;
case "ArrowUp":
e.preventDefault();
navigate(e, "up");
break;
case "ArrowLeft":
e.preventDefault();
navigate(e, "left");
break;
case "ArrowRight":
e.preventDefault();
navigate(e, "right");
break;
case "Enter":
case " ":
e.preventDefault();
updateSelection(
{
cellId: cell.id,
rowId: cell.row.id,
columnId: cell.column.id,
},
false,
);
if (table.options.enableCellSelection) {
cell.toggleSelected?.();
} else if (cell.row.getCanSelect()) {
cell.row.toggleSelected();
}
break;
case "Escape":
actions.clearSelection();
break;
case "a":
if (e.metaKey || e.ctrlKey) {
e.preventDefault();
actions.selectAllCells(table);
}
break;
}
},
);
const handleCellMouseDown = useEvent(
(e: React.MouseEvent, cell: Cell<TData, unknown>) => {
// Right-clicks will trigger context menu, so avoid updating selected cells
if (e.buttons === 2) {
return;
}
if (isInteractiveTarget(e)) {
return;
}
actions.handleCellMouseDown({
cell,
isShiftKey: e.shiftKey,
isCtrlKey: e.ctrlKey,
table,
});
},
);
const handleCellMouseUp = useEvent(() => {
actions.setIsSelecting(false);
});
const handleCellMouseOver = useEvent(
(e: React.MouseEvent, cell: Cell<TData, unknown>) => {
if (e.buttons === 1) {
actions.updateRangeSelection({ cell, table });
}
},
);
return {
handleCellMouseDown,
handleCellMouseUp,
handleCellMouseOver,
handleCopy,
handleCellsKeyDown,
handleCellFocus,
updateSelection,
clearSelection: actions.clearSelection,
};
};
const INTERACTIVE_SELECTOR =
'input, button, select, textarea, a, label, [role="checkbox"], [role="button"], [contenteditable="true"], marimo-ui-element';
// `<marimo-ui-element>` wraps every stateful UIElement, but content-wrapper
// UIElements like `mo.lazy` and `mo.routes` are themselves inert. Clicks on
// their inner content should still allow cell selection.
// See https://github.com/marimo-team/marimo/issues/9189.
const CONTENT_WRAPPER_MARIMO_TAGS: ReadonlySet<string> = new Set([
"marimo-lazy",
"marimo-routes",
]);
/**
* Skip cell selection when the click target is inside an interactive element
* (e.g. a checkbox or button rendered as rich cell content).
*
* Walks `composedPath()` so we can see through Shadow DOM boundaries used by
* marimo plugins. Without this, `event.target` is retargeted to the outermost
* shadow host (e.g. `<marimo-lazy>`), hiding any genuinely interactive
* descendants rendered inside the shadow tree.
*/
export function isInteractiveTarget(e: React.SyntheticEvent): boolean {
const path: readonly EventTarget[] =
typeof e.nativeEvent?.composedPath === "function"
? e.nativeEvent.composedPath()
: [e.target];
for (const node of path) {
if (node === e.currentTarget) {
break;
}
if (!(node instanceof Element) || !node.matches(INTERACTIVE_SELECTOR)) {
continue;
}
// A `<marimo-ui-element>` directly wrapping a passive content-wrapper is
// inert; keep walking to find a real interactive ancestor (if any).
if (node.localName === "marimo-ui-element") {
const inner = node.firstElementChild;
if (inner && CONTENT_WRAPPER_MARIMO_TAGS.has(inner.localName)) {
continue;
}
}
return true;
}
return false;
}