mirror of
https://github.com/DayuanJiang/next-ai-draw-io.git
synced 2026-10-12 20:49:53 +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
142 lines
5.1 KiB
TypeScript
142 lines
5.1 KiB
TypeScript
import { type ClassValue, clsx } from "clsx"
|
|
import { twMerge } from "tailwind-merge"
|
|
import { pageElement } from "@/lib/diagram-pages"
|
|
import {
|
|
decompressPageContent,
|
|
extractSvgEmbeddedXml,
|
|
} from "@/packages/mcp-server/src/load-diagram.ts"
|
|
import { hasCells } from "@/packages/mcp-server/src/pages.ts"
|
|
|
|
export function cn(...inputs: ClassValue[]) {
|
|
return twMerge(clsx(inputs))
|
|
}
|
|
|
|
// ============================================================================
|
|
// Diagram Constants
|
|
// ============================================================================
|
|
|
|
/**
|
|
* Minimum length for a "real" diagram XML (not just empty template).
|
|
* Empty mxfile templates are ~147-300 chars; real diagrams are larger.
|
|
*/
|
|
export const MIN_REAL_DIAGRAM_LENGTH = 300
|
|
|
|
/**
|
|
* Check if diagram XML represents a real diagram (not just empty template):
|
|
* it has a shape (however short), or is long enough to hold pages worth
|
|
* keeping.
|
|
* @param xml - The diagram XML string to check
|
|
* @returns true if the XML is a real diagram with content
|
|
*/
|
|
export function isRealDiagram(xml: string | undefined | null): boolean {
|
|
return !!xml && (hasCells(xml) || xml.length > MIN_REAL_DIAGRAM_LENGTH)
|
|
}
|
|
|
|
// ============================================================================
|
|
// mxCell XML Helpers
|
|
// ============================================================================
|
|
|
|
export { isMxCellXmlComplete } from "@/packages/mcp-server/src/new-diagram.ts"
|
|
|
|
/**
|
|
* Extract only complete mxCell elements from partial/streaming XML.
|
|
* This allows progressive rendering during streaming by ignoring incomplete trailing elements.
|
|
* @param xml - The partial XML string (may contain incomplete trailing mxCell)
|
|
* @returns XML string containing only complete mxCell elements
|
|
*/
|
|
export function extractCompleteMxCells(xml: string | undefined | null): string {
|
|
if (!xml) return ""
|
|
|
|
// Match self-closing <mxCell ... /> or <mxCell ...>...</mxCell>, in document order.
|
|
// The lazy [^>]*? tries "/>" first, so a self-closing cell never swallows
|
|
// the following cells up to the next </mxCell>.
|
|
// Quoted values may hold ">", so the tag ends at the first ">" outside them
|
|
const cellPattern =
|
|
/<mxCell\b(?:[^<>"']|"[^"]*"|'[^']*')*?(?:\/>|>[\s\S]*?<\/mxCell>)/g
|
|
|
|
return (xml.match(cellPattern) || []).join("\n")
|
|
}
|
|
|
|
/**
|
|
* Format XML string with proper indentation and line breaks
|
|
* @param xml - The XML string to format
|
|
* @param indent - The indentation string (default: ' ')
|
|
* @returns Formatted XML string
|
|
*/
|
|
export function formatXML(xml: string, indent: string = " "): string {
|
|
let formatted = ""
|
|
let pad = 0
|
|
|
|
// Remove existing whitespace between tags
|
|
xml = xml.replace(/>\s*</g, "><").trim()
|
|
|
|
// Split on tags
|
|
const tags = xml.split(/(?=<)|(?<=>)/g).filter(Boolean)
|
|
|
|
tags.forEach((node) => {
|
|
if (node.match(/^<\/\w/)) {
|
|
// Closing tag - decrease indent
|
|
pad = Math.max(0, pad - 1)
|
|
formatted += indent.repeat(pad) + node + "\n"
|
|
} else if (node.match(/^<\w[^>]*[^/]>.*$/)) {
|
|
// Opening tag
|
|
formatted += indent.repeat(pad) + node
|
|
// Only add newline if next item is a tag
|
|
const nextIndex = tags.indexOf(node) + 1
|
|
if (nextIndex < tags.length && tags[nextIndex].startsWith("<")) {
|
|
formatted += "\n"
|
|
if (!node.match(/^<\w[^>]*\/>$/)) {
|
|
pad++
|
|
}
|
|
}
|
|
} else if (node.match(/^<\w[^>]*\/>$/)) {
|
|
// Self-closing tag
|
|
formatted += indent.repeat(pad) + node + "\n"
|
|
} else if (node.startsWith("<")) {
|
|
// Other tags (like <?xml)
|
|
formatted += indent.repeat(pad) + node + "\n"
|
|
} else {
|
|
// Text content
|
|
formatted += node
|
|
}
|
|
})
|
|
|
|
return formatted.trim()
|
|
}
|
|
|
|
/**
|
|
* Decode an xmlsvg export (SVG data URL) into uncompressed diagram XML.
|
|
* One page is returned: the one with the given id, else the first; for the
|
|
* full multi-page document use the autosaved chartXML instead.
|
|
*/
|
|
export function extractDiagramXML(
|
|
xml_svg_string: string,
|
|
pageId?: string | null,
|
|
): string {
|
|
try {
|
|
// The data URL holds the SVG; its root element's content attribute
|
|
// holds the mxfile, whose pages are compressed
|
|
const svg = atob(xml_svg_string.slice(26))
|
|
const content = extractSvgEmbeddedXml(svg)
|
|
if (content === undefined) {
|
|
throw new Error("No SVG element found in the input string.")
|
|
}
|
|
if (!content) {
|
|
throw new Error("SVG element does not have a 'content' attribute.")
|
|
}
|
|
const doc = new DOMParser().parseFromString(content, "text/xml")
|
|
const diagram = pageElement(doc, pageId)
|
|
if (!diagram) {
|
|
throw new Error("No diagram element found")
|
|
}
|
|
const xml = decompressPageContent(diagram.textContent ?? "")
|
|
if (!xml) {
|
|
throw new Error("No encoded data found in the diagram element")
|
|
}
|
|
return xml
|
|
} catch (error) {
|
|
console.error("Error extracting diagram XML:", error)
|
|
throw error // Re-throw for caller handling
|
|
}
|
|
}
|