AI-native knowledge base & Evernote/Obsidian alternative with instant sync & native MCP. Free on Cloudflare or self-hosted via Docker.
HTML ai-agentcloudflarecloudflare-d1cloudflare-r2cloudflare-workersdockerelectronevernoteevernote-alternativeknowledge-basemcpnote-takingobsidian-alternativeoffline-firstpersonal-knowledge-basepwaself-hostedsqlitetiptapweb-clipper
import { useCallback, useEffect, useState } from "react";
import type { BubbleMenuProps } from "@tiptap/react/menus";
import type { EditorState } from "@tiptap/pm/state";
import {
AI_SELECTION_MENU_CHANGED_EVENT,
readAiSelectionMenuPreference,
} from "@/lib/ai-selection-menu-preference";
type BubbleMenuShouldShow = NonNullable<BubbleMenuProps["shouldShow"]>;
type BubbleMenuOptions = NonNullable<BubbleMenuProps["options"]>;
const AI_BUBBLE_MENU_OPTIONS: BubbleMenuOptions = { placement: "top" };
// Image/gallery node selections are non-empty too, but belong to the image
// controls. DOM text would also include their toolbar labels; read the doc.
export const hasAiTextSelection = ({ doc, selection }: Pick<EditorState, "doc" | "selection">): boolean => (
!selection.empty && selection.ranges.some(({ $from, $to }) => (
doc.textBetween($from.pos, $to.pos, " ", "").trim().length > 0
))
);
// The sidebar can stay open. A later selection still needs these actions.
export const shouldShowAiBubbleMenu = ({
editable,
enabled,
selectionEmpty,
selectionHasText,
}: {
editable: boolean;
enabled: boolean;
selectionEmpty: boolean;
selectionHasText: boolean;
}): boolean => enabled && editable && !selectionEmpty && selectionHasText;
export const useAiBubbleMenu = () => {
const [enabled, setEnabled] = useState(readAiSelectionMenuPreference);
useEffect(() => {
const syncPreference = () => setEnabled(readAiSelectionMenuPreference());
const handlePreferenceChanged = (event: Event) => {
const detail = (event as CustomEvent<boolean>).detail;
if (typeof detail === "boolean") {
setEnabled(detail);
return;
}
syncPreference();
};
window.addEventListener(AI_SELECTION_MENU_CHANGED_EVENT, handlePreferenceChanged);
window.addEventListener("storage", syncPreference);
return () => {
window.removeEventListener(AI_SELECTION_MENU_CHANGED_EVENT, handlePreferenceChanged);
window.removeEventListener("storage", syncPreference);
};
}, []);
// BubbleMenu dispatches an options-update transaction whenever these prop
// references change. Keep them stable so the editor's transaction-driven
// toolbar refresh cannot feed back into another BubbleMenu update.
const shouldShow = useCallback<BubbleMenuShouldShow>(
({ editor }) => shouldShowAiBubbleMenu({
editable: editor.isEditable,
enabled,
selectionEmpty: editor.state.selection.empty,
selectionHasText: hasAiTextSelection(editor.state),
}),
[enabled],
);
return {
options: AI_BUBBLE_MENU_OPTIONS,
shouldShow,
};
};