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
256 lines
9.1 KiB
TypeScript
256 lines
9.1 KiB
TypeScript
"use client"
|
|
|
|
import { forwardRef, useEffect, useImperativeHandle, useRef } from "react"
|
|
import {
|
|
DRAWIO_CONFIG,
|
|
EMPTY_DRAWIO_DOCUMENT,
|
|
} from "@/lib/drawio/drawio-config"
|
|
import {
|
|
attachEditor,
|
|
detachEditor,
|
|
watchForEditorUi,
|
|
} from "@/lib/drawio/editor-bridge"
|
|
|
|
export interface DrawioExportEvent {
|
|
event: "export"
|
|
format: string
|
|
data: string
|
|
xml: string
|
|
message: { message?: string; [key: string]: unknown }
|
|
}
|
|
|
|
export interface DrawioFrameHandle {
|
|
load: (data: { xml: string }) => void
|
|
exportDiagram: (data: {
|
|
format: string
|
|
message?: string
|
|
[key: string]: unknown
|
|
}) => void
|
|
}
|
|
|
|
interface DrawioFrameProps {
|
|
src: string
|
|
/**
|
|
* Theme CSS: sent with the configure message (works cross-origin too)
|
|
* and, same origin, injected as a <style> so it updates without a reload
|
|
*/
|
|
css: string
|
|
/** draw.io's dark mode, switched in place when the editor is reachable */
|
|
dark: boolean
|
|
onLoad?: () => void
|
|
onAutoSave?: (data: { xml?: string }) => void
|
|
onExport?: (data: DrawioExportEvent) => void
|
|
/** Called once we know whether the editor can be driven directly */
|
|
onEditorAccess?: (hasEditor: boolean) => void
|
|
}
|
|
|
|
const STYLE_ID = "next-ai-drawio-theme"
|
|
|
|
/**
|
|
* The draw.io editor in an iframe, speaking draw.io's postMessage embed
|
|
* protocol (same messages react-drawio used). When the iframe is same-origin
|
|
* it also hands the editor object to editor-bridge for direct control.
|
|
*/
|
|
export const DrawioFrame = forwardRef<DrawioFrameHandle, DrawioFrameProps>(
|
|
function DrawioFrame(
|
|
{ src, css, dark, onLoad, onAutoSave, onExport, onEditorAccess },
|
|
ref,
|
|
) {
|
|
const iframeRef = useRef<HTMLIFrameElement>(null)
|
|
const editorUiRef = useRef<any>(null)
|
|
const attachedRef = useRef(false)
|
|
const cssRef = useRef(css)
|
|
cssRef.current = css
|
|
const darkRef = useRef(dark)
|
|
darkRef.current = dark
|
|
// Handlers change on every render; the message listener reads refs
|
|
const handlersRef = useRef({
|
|
onLoad,
|
|
onAutoSave,
|
|
onExport,
|
|
onEditorAccess,
|
|
})
|
|
handlersRef.current = { onLoad, onAutoSave, onExport, onEditorAccess }
|
|
|
|
// draw.io's origin: messages go only there, and only its messages
|
|
// count (the frame could be navigated to another site)
|
|
// (read on use: there is no window while the page renders on the server)
|
|
const drawioOrigin = () => new URL(src, window.location.href).origin
|
|
|
|
const send = (action: string, data: Record<string, unknown> = {}) => {
|
|
iframeRef.current?.contentWindow?.postMessage(
|
|
JSON.stringify({ action, ...data }),
|
|
drawioOrigin(),
|
|
)
|
|
}
|
|
|
|
useImperativeHandle(ref, () => ({
|
|
load: ({ xml }) => send("load", { xml, autosave: 1 }),
|
|
exportDiagram: (data) => send("export", data),
|
|
}))
|
|
|
|
// Same-origin only: keep the theme CSS current without a reload
|
|
const applyThemeCss = () => {
|
|
if (!attachedRef.current) return
|
|
try {
|
|
const doc = iframeRef.current?.contentDocument
|
|
if (!doc?.head) return
|
|
let style = doc.getElementById(STYLE_ID)
|
|
if (!style) {
|
|
style = doc.createElement("style")
|
|
style.id = STYLE_ID
|
|
doc.head.appendChild(style)
|
|
}
|
|
style.textContent = cssRef.current
|
|
} catch {
|
|
// Cross-origin: the configure message already applied it
|
|
}
|
|
}
|
|
|
|
useEffect(() => {
|
|
applyThemeCss()
|
|
}, [css])
|
|
|
|
// Same-origin only: draw.io's own dark mode, without a reload
|
|
const applyDarkMode = () => {
|
|
if (!attachedRef.current) return
|
|
try {
|
|
// Runs on every load: switch only when it differs
|
|
const frameWindow = iframeRef.current?.contentWindow as any
|
|
if (frameWindow?.Editor?.isDarkMode?.() === darkRef.current) {
|
|
return
|
|
}
|
|
editorUiRef.current?.setDarkMode?.(darkRef.current)
|
|
} catch (error) {
|
|
console.warn("Failed to set draw.io's dark mode:", error)
|
|
}
|
|
}
|
|
|
|
useEffect(() => {
|
|
applyDarkMode()
|
|
}, [dark])
|
|
|
|
useEffect(() => {
|
|
const iframe = iframeRef.current
|
|
if (!iframe) return
|
|
editorUiRef.current = null
|
|
attachedRef.current = false
|
|
let reported: boolean | null = null
|
|
const report = (value: boolean) => {
|
|
if (reported === value) return
|
|
reported = value
|
|
handlersRef.current.onEditorAccess?.(value)
|
|
}
|
|
|
|
// Watch for draw.io's scripts so the editor object can be caught
|
|
// as it starts. Stops once hooked, or when the frame turns out to
|
|
// be cross-origin.
|
|
const startedAt = Date.now()
|
|
const poll = setInterval(() => {
|
|
const frameWindow = iframe.contentWindow as any
|
|
if (!frameWindow) return
|
|
let ready = false
|
|
try {
|
|
ready =
|
|
frameWindow.location.href !== "about:blank" &&
|
|
!!frameWindow.EditorUi
|
|
} catch {
|
|
clearInterval(poll)
|
|
report(false)
|
|
return
|
|
}
|
|
if (ready) {
|
|
clearInterval(poll)
|
|
// Called on every action state update: once per editor
|
|
const ok = watchForEditorUi(frameWindow, (ui) => {
|
|
if (editorUiRef.current === ui) return
|
|
editorUiRef.current = ui
|
|
// draw.io follows the system's theme on its own:
|
|
// keep the app's
|
|
ui.addListener?.("darkModeChanged", () =>
|
|
applyDarkMode(),
|
|
)
|
|
})
|
|
if (!ok) report(false)
|
|
} else if (Date.now() - startedAt > 60_000) {
|
|
clearInterval(poll)
|
|
}
|
|
}, 5)
|
|
|
|
const handleMessage = (event: MessageEvent) => {
|
|
if (event.source !== iframe.contentWindow) return
|
|
if (event.origin !== drawioOrigin()) return
|
|
if (typeof event.data !== "string") return
|
|
let data: any
|
|
try {
|
|
data = JSON.parse(event.data)
|
|
} catch {
|
|
return
|
|
}
|
|
const handlers = handlersRef.current
|
|
switch (data.event) {
|
|
case "init":
|
|
send("load", {
|
|
xml: EMPTY_DRAWIO_DOCUMENT,
|
|
autosave: 1,
|
|
})
|
|
break
|
|
case "configure":
|
|
send("configure", {
|
|
config: {
|
|
...DRAWIO_CONFIG,
|
|
css: cssRef.current,
|
|
},
|
|
})
|
|
break
|
|
case "load": {
|
|
const tryAttach = () => {
|
|
const ui = editorUiRef.current
|
|
if (!ui || !iframe.contentWindow) return false
|
|
attachEditor(ui, iframe.contentWindow)
|
|
attachedRef.current = true
|
|
applyThemeCss()
|
|
applyDarkMode()
|
|
report(true)
|
|
return true
|
|
}
|
|
// The editor object is usually caught before the
|
|
// first load; give it a moment, then fall back to
|
|
// draw.io's own toolbar
|
|
if (!tryAttach()) {
|
|
setTimeout(() => {
|
|
if (!tryAttach()) report(false)
|
|
}, 800)
|
|
}
|
|
handlers.onLoad?.()
|
|
break
|
|
}
|
|
case "autosave":
|
|
handlers.onAutoSave?.(data)
|
|
break
|
|
case "export":
|
|
handlers.onExport?.(data)
|
|
break
|
|
}
|
|
}
|
|
|
|
window.addEventListener("message", handleMessage)
|
|
return () => {
|
|
clearInterval(poll)
|
|
window.removeEventListener("message", handleMessage)
|
|
detachEditor()
|
|
}
|
|
}, [src])
|
|
|
|
return (
|
|
<iframe
|
|
ref={iframeRef}
|
|
src={src}
|
|
title="draw.io"
|
|
allow="clipboard-read; clipboard-write"
|
|
className="block h-full w-full border-0"
|
|
/>
|
|
)
|
|
},
|
|
)
|