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 { CompletionResult } from "@codemirror/autocomplete";
import type { Tooltip } from "@codemirror/view";
import { DeferredRequestRegistry } from "@/core/network/DeferredRequestRegistry";
import type { CodeCompletionRequest } from "@/core/network/types";
import { isPlatformMac } from "../../hotkeys/shortcuts";
import type {
CompletionOption,
CompletionResultMessage,
} from "../../kernel/messages";
import "../../../components/editor/documentation.css";
import { getRequestClient } from "@/core/network/requests";
function constructCompletionInfoNode(
innerHtml?: string | null,
showGoToDefinitionHint = false,
): HTMLElement | null {
if (!innerHtml) {
return null;
}
const container = document.createElement("span");
container.classList.add("mo-cm-tooltip");
container.classList.add("docs-documentation");
if (showGoToDefinitionHint) {
container.classList.add("cm-tooltip-section");
}
container.style.display = "flex";
container.style.flexDirection = "column";
container.style.gap = ".8rem";
container.innerHTML = innerHtml;
if (showGoToDefinitionHint) {
const instructionDiv = document.createElement("div");
instructionDiv.classList.add(
"text-xs",
"text-muted-foreground",
"font-medium",
"pt-1",
"-mt-2",
"border-t",
"border-border",
);
// Create kbd element for the key symbol
const kbd = document.createElement("kbd");
kbd.className =
"ml-1 rounded-md bg-muted/40 px-2 text-[0.75rem] font-prose center border border-foreground/20 text-muted-foreground inline whitespace-nowrap";
kbd.textContent = isPlatformMac() ? "⌘" : "Ctrl";
// Add the instruction text
instructionDiv.append(document.createTextNode("Jump to defining cell "));
instructionDiv.append(kbd);
instructionDiv.append(document.createTextNode(" + Click"));
container.append(instructionDiv);
}
return container;
}
export const AUTOCOMPLETER = new DeferredRequestRegistry<
Omit<CodeCompletionRequest, "id">,
CompletionResultMessage | null
>(
"autocomplete-result",
async (requestId, req) => {
const { sendCodeCompletionRequest } = getRequestClient();
await sendCodeCompletionRequest({
id: requestId,
...req,
});
},
// We don't resolve previous requests
// because they may be used for tooltips or live documentation.
);
// Boost params and properties so they appear first
const BOOSTS: Record<CompletionOption["type"], number> = {
param: 3,
property: 2,
// everything else is equal so alphabetically sorted
};
export const Autocompleter = {
/**
* Convert a CompletionResultMessage to a CompletionResult
*/
asCompletionResult(
position: number,
message: CompletionResultMessage,
): CompletionResult {
return {
from: position - message.prefix_length,
options: message.options.map((option) => {
return {
label: option.name,
type: option.type,
boost: BOOSTS[option.type] ?? 1,
info: () => constructCompletionInfoNode(option.completion_info),
};
}),
validFor: /^\w*$/,
};
},
/**
* Convert a CompletionResultMessage to a Tooltip
*/
asHoverTooltip({
position,
message,
limitToType,
excludeTypes,
exactName,
showGoToDefinitionHint = false,
}: {
position: number;
message: CompletionResultMessage;
limitToType?: "tooltip";
excludeTypes?: string[];
exactName?: string;
showGoToDefinitionHint?: boolean;
}): (Tooltip & { html?: string | null }) | undefined {
const firstOption = getFirstOption(message.options, exactName);
if (!firstOption) {
return undefined;
}
const from = position - message.prefix_length;
const dom = constructCompletionInfoNode(
firstOption.completion_info,
showGoToDefinitionHint,
);
if (!dom) {
return;
}
if (limitToType && firstOption.type !== limitToType) {
return;
}
if (excludeTypes?.includes(firstOption.type)) {
return;
}
return {
pos: from,
html: firstOption.completion_info,
end: from + firstOption.name.length,
above: true,
create: () => ({ dom, resize: false }),
};
},
};
function getFirstOption(
options: CompletionOption[],
tieBreak?: string,
): CompletionOption | undefined {
if (options.length === 0) {
return undefined;
}
if (options.length === 1) {
// One option
return options[0];
}
if (tieBreak) {
// Tie break to a matching name
return options.find((option) => option.name === tieBreak);
}
return undefined;
}