// @vitest-environment jsdom import { act } from "react"; import { createRoot } from "react-dom/client"; import { afterEach, beforeEach, describe, expect, it, vi } from "vitest"; import { buildSkillMentionHref } from "@paperclipai/shared"; import { computeMentionMenuPosition, findClosestAutocompleteAnchor, findMentionMatch, isSameAutocompleteSession, MarkdownEditor, placeCaretAfterMentionAnchor, shouldAcceptAutocompleteKey, } from "./MarkdownEditor"; const mdxEditorMockState = vi.hoisted(() => ({ emitMountEmptyReset: false, })); vi.mock("@mdxeditor/editor", async () => { const React = await import("react"); function setForwardedRef(ref: React.ForwardedRef, value: T | null) { if (typeof ref === "function") { ref(value); return; } if (ref) { (ref as React.MutableRefObject).current = value; } } const MDXEditor = React.forwardRef(function MockMDXEditor( { markdown, placeholder, onChange, }: { markdown: string; placeholder?: string; onChange?: (value: string) => void; }, forwardedRef: React.ForwardedRef<{ setMarkdown: (value: string) => void; focus: () => void } | null>, ) { const [content, setContent] = React.useState(markdown); const handle = React.useMemo(() => ({ setMarkdown: (value: string) => setContent(value), focus: () => {}, }), []); React.useEffect(() => { setForwardedRef(forwardedRef, null); const timer = window.setTimeout(() => { setForwardedRef(forwardedRef, handle); if (mdxEditorMockState.emitMountEmptyReset) { setContent(""); onChange?.(""); } }, 0); return () => { window.clearTimeout(timer); setForwardedRef(forwardedRef, null); }; }, []); return
{content || placeholder || ""}
; }); return { CodeMirrorEditor: () => null, MDXEditor, codeBlockPlugin: () => ({}), codeMirrorPlugin: () => ({}), createRootEditorSubscription$: Symbol("createRootEditorSubscription$"), headingsPlugin: () => ({}), imagePlugin: () => ({}), linkDialogPlugin: () => ({}), linkPlugin: () => ({}), listsPlugin: () => ({}), markdownShortcutPlugin: () => ({}), quotePlugin: () => ({}), realmPlugin: (plugin: unknown) => plugin, tablePlugin: () => ({}), thematicBreakPlugin: () => ({}), }; }); vi.mock("../lib/mention-deletion", () => ({ mentionDeletionPlugin: () => ({}), })); vi.mock("../lib/paste-normalization", () => ({ pasteNormalizationPlugin: () => ({}), })); // eslint-disable-next-line @typescript-eslint/no-explicit-any (globalThis as any).IS_REACT_ACT_ENVIRONMENT = true; async function flush() { await act(async () => { await new Promise((resolve) => setTimeout(resolve, 0)); }); } describe("MarkdownEditor", () => { let container: HTMLDivElement; beforeEach(() => { container = document.createElement("div"); document.body.appendChild(container); }); afterEach(() => { container.remove(); vi.clearAllMocks(); mdxEditorMockState.emitMountEmptyReset = false; }); it("applies async external value updates once the editor ref becomes ready", async () => { const root = createRoot(container); await act(async () => { root.render( {}} placeholder="Markdown body" />, ); }); await act(async () => { root.render( {}} placeholder="Markdown body" />, ); }); await flush(); expect(container.textContent).toContain("Loaded plan body"); await act(async () => { root.unmount(); }); }); it("keeps the external value when the unfocused editor emits an empty mount reset", async () => { mdxEditorMockState.emitMountEmptyReset = true; const handleChange = vi.fn(); const root = createRoot(container); await act(async () => { root.render( , ); }); await flush(); expect(container.textContent).toContain("Loaded plan body"); expect(handleChange).not.toHaveBeenCalled(); await act(async () => { root.unmount(); }); }); it("anchors the mention menu inside the visual viewport when mobile offsets are present", () => { expect( computeMentionMenuPosition( { viewportTop: 180, viewportLeft: 120 }, { offsetLeft: 24, offsetTop: 320, width: 320, height: 260 }, ), ).toEqual({ top: 372, left: 144, }); }); it("clamps the mention menu back into view near the viewport edges", () => { expect( computeMentionMenuPosition( { viewportTop: 260, viewportLeft: 240 }, { offsetLeft: 0, offsetTop: 0, width: 280, height: 220 }, ), ).toEqual({ top: 12, left: 92, }); }); it("keeps a short mention menu on the same line when it fits below the caret", () => { expect( computeMentionMenuPosition( { viewportTop: 160, viewportLeft: 120 }, { offsetLeft: 0, offsetTop: 0, width: 320, height: 220 }, { width: 188, height: 42 }, ), ).toEqual({ top: 164, left: 120, }); }); it("keeps mention queries active across spaces", () => { expect(findMentionMatch("Ping @Paperclip App", "Ping @Paperclip App".length)).toEqual({ trigger: "mention", marker: "@", query: "Paperclip App", atPos: 5, endPos: "Ping @Paperclip App".length, }); }); it("still rejects slash commands once spaces are typed", () => { expect(findMentionMatch("/open issue", "/open issue".length)).toBeNull(); }); it("does not treat Enter as skill autocomplete accept", () => { expect(shouldAcceptAutocompleteKey("Enter", "skill")).toBe(false); expect(shouldAcceptAutocompleteKey("Enter", "skill", true)).toBe(true); expect(shouldAcceptAutocompleteKey("Enter", "mention")).toBe(true); expect(shouldAcceptAutocompleteKey("Tab", "skill")).toBe(true); }); it("keeps the same autocomplete session active while the slash query is unchanged", () => { const textNode = document.createTextNode("/agent"); expect(isSameAutocompleteSession( { trigger: "skill", marker: "/", query: "agent", textNode, atPos: 0, endPos: 6, }, { trigger: "skill", marker: "/", query: "agent", textNode, atPos: 0, endPos: 6, }, )).toBe(true); expect(isSameAutocompleteSession( { trigger: "skill", marker: "/", query: "agent", textNode, atPos: 0, endPos: 6, }, { trigger: "skill", marker: "/", query: "agent-browser", textNode, atPos: 0, endPos: 14, }, )).toBe(false); }); it("finds skill anchors by mention metadata instead of visible text", () => { const editable = document.createElement("div"); const skillLink = document.createElement("a"); skillLink.setAttribute("href", buildSkillMentionHref("skill-123", "agent-browser")); skillLink.textContent = "/agent-browser "; editable.appendChild(skillLink); const found = findClosestAutocompleteAnchor(editable, { id: "skill:skill-123", kind: "skill", skillId: "skill-123", key: "agent-browser", name: "Agent Browser", slug: "agent-browser", description: null, href: buildSkillMentionHref("skill-123", "agent-browser"), aliases: ["agent-browser", "Agent Browser"], }); expect(found).toBe(skillLink); }); it("places the caret after the mention's trailing space when present", () => { const editable = document.createElement("div"); editable.contentEditable = "true"; document.body.appendChild(editable); const skillLink = document.createElement("a"); skillLink.setAttribute("href", buildSkillMentionHref("skill-123", "agent-browser")); skillLink.textContent = "/agent-browser"; const trailingSpace = document.createTextNode(" "); editable.append(skillLink, trailingSpace); expect(placeCaretAfterMentionAnchor(skillLink)).toBe(true); const selection = window.getSelection(); expect(selection?.anchorNode).toBe(trailingSpace); expect(selection?.anchorOffset).toBe(1); editable.remove(); }); });