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 { EditorView, keymap } from "@codemirror/view";
import type { HotkeyProvider } from "@/core/hotkeys/hotkeys";
import { invariant } from "@/utils/invariant";
import { smartScrollIntoView } from "../../utils/scroll";
import { cellActionsState, cellIdState } from "./cells/state";
import { formatEditorViews, formattingChangeEffect } from "./format";
import {
getCurrentLanguageAdapter,
toggleToLanguage,
} from "./language/commands";
/**
* Add a keymap to format the code in the editor.
*/
export function formatKeymapExtension(hotkeys: HotkeyProvider) {
return keymap.of([
{
key: hotkeys.getHotkey("cell.format").key,
preventDefault: true,
run: (ev) => {
const cellId = ev.state.facet(cellIdState);
formatEditorViews({ [cellId]: ev });
return true;
},
},
{
key: hotkeys.getHotkey("cell.viewAsMarkdown").key,
preventDefault: true,
run: (ev) => {
const currentLanguage = getCurrentLanguageAdapter(ev);
const destinationLanguage =
currentLanguage === "markdown" ? "python" : "markdown";
const response = toggleToLanguage(ev, destinationLanguage, {
force: true,
});
// Handle post-toggle actions
if (response === "markdown") {
const actions = ev.state.facet(cellActionsState);
actions.afterToggleMarkdown();
}
return response !== false;
},
},
{
key: hotkeys.getHotkey("cell.viewAsSQL").key,
preventDefault: true,
run: (ev) => {
const currentLanguage = getCurrentLanguageAdapter(ev);
const destinationLanguage =
currentLanguage === "sql" ? "python" : "sql";
const response = toggleToLanguage(ev, destinationLanguage, {
force: true,
});
if (response === "sql") {
const actions = ev.state.facet(cellActionsState);
actions.afterToggleSQL();
}
return response !== false;
},
},
]);
}
/**
* Scroll the active line into view when the editor is resized,
* with an offset.
*
* This is necessary when typings at the edges of the editor
* and the user is blocked by the hovering action bar.
*/
export function scrollActiveLineIntoViewExtension() {
return EditorView.updateListener.of((update) => {
// Ignore if the editor does not have focus, ignore
if (!update.view.hasFocus) {
return;
}
// A new line was added, scroll the active line into view
if (update.heightChanged && update.docChanged) {
// Ignore formatting changes
const isFormattingChange = update.transactions.some((tr) =>
tr.effects.some((effect) => effect.is(formattingChangeEffect)),
);
if (isFormattingChange) {
return;
}
scrollActiveLineIntoView(update.view, { behavior: "smooth" });
}
});
}
export function scrollActiveLineIntoView(
editor: EditorView,
opts: {
behavior: "smooth" | "instant";
},
) {
const activeLines = editor.dom.getElementsByClassName(
"cm-activeLine cm-line",
);
// Only scroll if there is an active line
if (activeLines.length === 1) {
const activeLine = activeLines[0] as HTMLElement;
const appEl = document.getElementById("App");
invariant(appEl, "App not found");
smartScrollIntoView(activeLine, {
offset: { top: 30, bottom: 150 },
body: appEl,
behavior: opts.behavior,
});
}
}