mirror of
https://github.com/DayuanJiang/next-ai-draw-io.git
synced 2026-10-13 04:59:51 +08:00
## Problem
Two audits of the repository (a workflow of finder, dedup and per-file verifier agents, run on 2026-10-11 against 1f4141e and again against 07f3e3c after a first round of refactoring) found dead code and features that were more machinery than the app needs: an Electron configuration-preset system with its own settings window, three copies of the about page, a hand-written `.env` parser, an "extended" system prompt nobody selected, two data migrations for formats from 2025-12 and 2026-01, a server-side example cache, type-to-confirm provider deletion, 81 unused dictionary keys, wrapper components around single call sites, and a long tail of unused exports, props, options and tests.
## Change
Every item below was either approved one by one or covered by "fix all of the others".
- **Electron:** the configuration-preset system is gone (settings window, preload, IPC, menu entry, dev watcher); `config-manager.ts` keeps only `userLocale`; `.env` files are parsed with `dotenv`. Entitlements file and a duplicate CI workflow removed; `test.yml` gets a type check and concurrency.
- **Server:** no extended prompt, no example cache, no `ENABLE_HISTORY_XML_REPLACE`, no message metadata or `hasConfig`; the connection test is one shared helper; EdgeOne loses its mock branch and model aliases; `DEBUG_LLM_PAYLOAD` logs message structure instead of payloads; Langfuse scoring helper; `apiKeyEnv` arrays kept and documented in `env.example` and the provider docs.
- **Pages:** one about page per language from a single component (old `/cn` and `/ja` URLs redirect with 308); layout uses `hasLocale`; the GitHub icon is a local component instead of `react-icons`; Cloudflare deploys without an R2 cache by default.
- **Chat and canvas:** the legacy `diagramHistory` conversion, the localStorage chat migration and the templates storage are gone; `chat-engine` reads the diagram through the context's refs; the diagram context has one tagged export path (`requestTaggedExport` / `fetchDiagramXml`); the screenshot check uses fetch + JSON and `generateText` with `Output.object`; `load-diagram` accepts `<svg:svg>` and strips the XML prolog.
- **Settings UI:** `model-selector` inlines its Dialog, Command and Tooltip; `ai-elements/model-selector`, `button-with-tooltip`, `error-toast` removed; no type-to-confirm, no footer, no `bedrockApiKey`; `use-model-config` loses the old-format migration; one reasoning component; the shimmer is CSS (no `motion`, no `@radix-ui/react-use-controllable-state`); 81 dictionary keys removed in all four languages.
- **MCP server:** `registerTool` / `ok` / `fail` replace per-tool try/catch; `syncFromBrowser`, `commitDocument`, `describePages`; the hand-written XML syntax check, unused result fields, `pickPageSelector`, `expandStyles` and the `host` attribute handling are gone; tests get a shared `setup.ts` and drive the server through the SDK client.
- **Prompt:** the web app's style rules come from the MCP drawing guide (`styleRules`), byte-identical to before.
- **Tests:** shared e2e helpers (`openApp`, `sse`, `toolCallEvents`, `chunkedReplies`); placeholder specs dropped; `settings-review-fixes` split by topic; unit tests use `vi.stubEnv`.
- **Dependencies removed:** `@xmldom/xmldom`, `remark-gfm`, `@anthropic-ai/tokenizer`, `@testing-library/user-event`, `concurrently`, `wait-on`, `eslint`, `eslint-config-next`, `@vitest/coverage-v8`, `shx`, `motion`, `@radix-ui/react-use-controllable-state`, `react-icons`.
Source lines: 74,983 before, 67,418 after (excluding lockfiles).
The last commit merges #984 (the canvas shell). Where the shell, the classic page or their tests depend on a wire format or signature this branch had changed, main's version wins (export fields of the poll response, `addHistory` signature); where main only extended code this branch restructured, main's change is carried into the new structure (`start_session`, `get_selection`, `prepareNewDiagram`, the diagram context's `requestExport`).
## Testing
- `tsc --noEmit` for the web app, `packages/mcp-server`, its shell and `electron`: clean
- `biome ci`: 0 errors (37 pre-existing warnings)
- Root `vitest run`: 719 passed; `packages/mcp-server` `vitest run`: 372 passed
- `next build`: clean
- Playwright, whole web suite on the dev server (4 workers): 280 tests, 279 passed; `language.spec.ts` "a stale offer to switch without saving does nothing once a message is being sent" failed under parallel load and passed alone, as it does on main
207 lines
8.1 KiB
TypeScript
207 lines
8.1 KiB
TypeScript
import { act, renderHook } from "@testing-library/react"
|
|
import type React from "react"
|
|
import { afterEach, describe, expect, it, vi } from "vitest"
|
|
import { DiagramProvider, useDiagram } from "@/contexts/diagram-context"
|
|
import { useCanvasStore } from "@/stores/canvas-store"
|
|
|
|
vi.mock("sonner", () => ({ toast: { success: vi.fn() } }))
|
|
// No editor to drive: every load is a full load, and the page to show after
|
|
// it is recorded
|
|
const selectPage = vi.fn((_id: string) => true)
|
|
vi.mock("@/lib/drawio/editor-bridge", () => ({
|
|
canReplaceDiagram: () => false,
|
|
commitDiagram: vi.fn(),
|
|
previewDiagram: vi.fn(),
|
|
resetPreview: vi.fn(),
|
|
revertPreview: vi.fn(),
|
|
selectPage: (id: string) => selectPage(id),
|
|
}))
|
|
|
|
const doc = (pages: string) => `<mxfile>${pages}</mxfile>`
|
|
const page = (id: string, label: string) =>
|
|
`<diagram id="${id}" name="${id}"><mxGraphModel><root><mxCell id="0"/><mxCell id="1" parent="0"/><mxCell id="c-${id}" value="${label}" vertex="1" parent="1"><mxGeometry as="geometry"/></mxCell></root></mxGraphModel></diagram>`
|
|
|
|
// The provider with a stand-in draw.io that records loads and exports
|
|
function setup() {
|
|
const { result } = renderHook(() => useDiagram(), {
|
|
wrapper: ({ children }: { children: React.ReactNode }) => (
|
|
<DiagramProvider>{children}</DiagramProvider>
|
|
),
|
|
})
|
|
const requests: { format: string; message: string; pageId?: string }[] = []
|
|
const loads: string[] = []
|
|
result.current.drawioRef.current = {
|
|
exportDiagram: (r: any) => requests.push(r),
|
|
load: ({ xml }: { xml: string }) => loads.push(xml),
|
|
} as any
|
|
const reply = (
|
|
request: { message: string },
|
|
data: string | undefined,
|
|
xml?: string,
|
|
) =>
|
|
act(() =>
|
|
result.current.handleDiagramExport({
|
|
event: "export",
|
|
data,
|
|
xml,
|
|
format: "png",
|
|
message: request,
|
|
} as any),
|
|
)
|
|
return { result, requests, loads, reply }
|
|
}
|
|
|
|
afterEach(() => {
|
|
vi.restoreAllMocks()
|
|
vi.useRealTimers()
|
|
useCanvasStore.setState({ currentPageId: null })
|
|
})
|
|
|
|
describe("requestExport", () => {
|
|
it("passes the request on and resolves with its own answer", async () => {
|
|
const { result, requests, reply } = setup()
|
|
const png = result.current.requestExport({
|
|
format: "png",
|
|
pageId: "p2",
|
|
width: 700,
|
|
})
|
|
const xml = result.current.requestExport({ format: "xml" })
|
|
expect(requests).toMatchObject([
|
|
{ format: "png", pageId: "p2", width: 700 },
|
|
{ format: "xml" },
|
|
])
|
|
// The XML export answers first, with the document instead of data
|
|
reply(requests[1], undefined, "<mxfile>doc</mxfile>")
|
|
expect(await xml).toEqual({
|
|
data: undefined,
|
|
xml: "<mxfile>doc</mxfile>",
|
|
})
|
|
reply(requests[0], "data:image/png;base64,AAAA")
|
|
expect(await png).toEqual({
|
|
data: "data:image/png;base64,AAAA",
|
|
xml: undefined,
|
|
})
|
|
})
|
|
|
|
it("resolves to null when draw.io does not answer in time", async () => {
|
|
vi.useFakeTimers()
|
|
const { result, requests, reply } = setup()
|
|
const pending = result.current.requestExport({ format: "svg" }, 1000)
|
|
await vi.advanceTimersByTimeAsync(1000)
|
|
expect(await pending).toBeNull()
|
|
// A late answer goes nowhere
|
|
reply(requests[0], "data:image/svg+xml;base64,AAAA")
|
|
expect(await pending).toBeNull()
|
|
})
|
|
|
|
it("resolves to null without draw.io", async () => {
|
|
const { result } = setup()
|
|
result.current.drawioRef.current = null
|
|
expect(await result.current.requestExport({ format: "svg" })).toBeNull()
|
|
})
|
|
})
|
|
|
|
describe("showTransient", () => {
|
|
type Result = ReturnType<typeof setup>["result"]
|
|
// Load the document, with draw.io's "load" reports: its first one makes
|
|
// the provider send the document once more, which draw.io reports too
|
|
const start = (result: Result, xml: string) =>
|
|
act(() => {
|
|
result.current.loadDiagram(xml, true)
|
|
result.current.onDrawioLoad()
|
|
result.current.onDrawioLoad()
|
|
})
|
|
const loaded = (result: Result) => act(() => result.current.onDrawioLoad())
|
|
const autosave = (result: Result, xml: string) =>
|
|
act(() => result.current.handleDiagramAutoSave({ xml }))
|
|
|
|
it("shows the document without recording it, and ignores its autosaves until the next load", () => {
|
|
const { result, loads } = setup()
|
|
start(result, doc(page("p1", "real")))
|
|
expect(result.current.chartXML).toContain('value="real"')
|
|
|
|
act(() => {
|
|
result.current.showTransient(doc(page("p2", "projection")))
|
|
})
|
|
loaded(result)
|
|
expect(loads.at(-1)).toContain('value="projection"')
|
|
expect(result.current.chartXML).toContain('value="real"')
|
|
autosave(result, doc(page("p2", "projection edited")))
|
|
expect(result.current.chartXML).toContain('value="real"')
|
|
|
|
// The real document comes back: recorded, and once draw.io reports
|
|
// the load, saves count again
|
|
act(() => {
|
|
result.current.loadDiagram(doc(page("p1", "real again")), true)
|
|
})
|
|
loaded(result)
|
|
expect(result.current.chartXML).toContain('value="real again"')
|
|
autosave(result, doc(page("p1", "real edited")))
|
|
expect(result.current.chartXML).toContain('value="real edited"')
|
|
})
|
|
|
|
it("keeps the document over a projection autosave that comes before draw.io reports the load back", () => {
|
|
const { result, loads } = setup()
|
|
const twoPages = doc(page("p1", "one") + page("p2", "two"))
|
|
start(result, twoPages)
|
|
act(() => {
|
|
result.current.showTransient(doc(page("p2", "two")))
|
|
})
|
|
loaded(result)
|
|
// The restore load is sent; the user's last drag on the projection
|
|
// is autosaved before draw.io gets to the load
|
|
act(() => {
|
|
result.current.loadDiagram(twoPages, true, "load")
|
|
})
|
|
autosave(result, doc(page("p2", "two moved")))
|
|
const isDocument = (xml: string | undefined) =>
|
|
!!xml && xml.includes('id="p1"') && !xml.includes("two moved")
|
|
expect(isDocument(result.current.chartXMLRef.current)).toBe(true)
|
|
loaded(result)
|
|
expect(isDocument(result.current.chartXMLRef.current)).toBe(true)
|
|
// The frame starts over (an external draw.io on a theme switch) and
|
|
// gets the document, not the projection
|
|
act(() => {
|
|
result.current.resetDrawioReady()
|
|
})
|
|
loaded(result)
|
|
expect(isDocument(loads.at(-1))).toBe(true)
|
|
})
|
|
|
|
it("ignores an autosave of the document a full load replaces", () => {
|
|
const { result } = setup()
|
|
start(result, doc(page("p1", "first")))
|
|
act(() => {
|
|
result.current.loadDiagram(doc(page("p1", "second")), true, "load")
|
|
})
|
|
// draw.io autosaved the user's last change of the first document
|
|
// before it got to the load
|
|
autosave(result, doc(page("p1", "first moved")))
|
|
expect(result.current.chartXML).toContain('value="second"')
|
|
loaded(result)
|
|
autosave(result, doc(page("p1", "second moved")))
|
|
expect(result.current.chartXML).toContain('value="second moved"')
|
|
})
|
|
|
|
it("goes back to the page the user was on before the projection", () => {
|
|
const { result } = setup()
|
|
const twoPages = doc(page("p1", "one") + page("p2", "two"))
|
|
act(() => {
|
|
result.current.loadDiagram(twoPages, true)
|
|
result.current.onDrawioLoad()
|
|
})
|
|
// The user is on page two; the projection shows page one
|
|
useCanvasStore.setState({ currentPageId: "p2" })
|
|
act(() => {
|
|
result.current.showTransient(doc(page("p1", "one")))
|
|
})
|
|
useCanvasStore.setState({ currentPageId: "p1" })
|
|
selectPage.mockClear()
|
|
act(() => {
|
|
result.current.loadDiagram(twoPages, true)
|
|
result.current.onDrawioLoad()
|
|
})
|
|
expect(selectPage).toHaveBeenCalledWith("p2")
|
|
})
|
|
})
|