feat: add structured react flow view

Author: StoneHub

AGENTS.md

@@ -9,11 +9,12 @@
 - Start with `README.md` for setup, scripts, and env vars.
 - Read `docs/deployment.md` and `docs/release-checklist.md` before changing CI or release behavior.
 - When touching the new layout/mobile flow, read `docs/ux-effects-plan.md`.
+- When touching the React Flow renderer or alternate view modes, read `docs/react-flow-structured-view-plan.md`.
 
 ## Working Rules
 - Read the existing code and docs before changing behavior.
 - Prefer minimal, local changes over broad rewrites.
-- If a task spans multiple files, the most likely hotspots are `src/App.tsx`, `src/GraphManager.ts`, `src/components/*`, `src/hooks/useGraphState.ts`, and matching tests under `src/`.
+- If a task spans multiple files, the most likely hotspots are `src/App.tsx`, `src/GraphManager.ts`, `src/components/*`, `src/features/structured-view/*`, `src/hooks/useGraphState.ts`, and matching tests under `src/`.
 - Do not commit generated local artifacts such as `.preview.*` or `.playwright-cli/`.
 - If instructions or release steps seem stale, call that out explicitly in the handoff.
 
@@ -22,6 +23,7 @@
 - Core local checks are `npm run lint`, `npm run test`, and `npm run build`.
 - Use `npm run check` as the default pre-merge gate.
 - If UI, search, or mobile interaction behavior changes, also run `npm run smoke`.
+- Local smoke runs need the same Playwright setup that CI uses: `npm install --no-save playwright` and `npx playwright install chromium`.
 
 ## Done Means
 - The requested behavior is implemented on the intended branch.

README.md

@@ -21,6 +21,12 @@ Live: `https://wikiconnectionsmap.web.app/`
 ### Test
 - `npm run test`
 
+### Smoke Test
+- `npm install --no-save playwright`
+- `npx playwright install chromium`
+- `npm run preview -- --host 127.0.0.1 --port 4173`
+- `npm run smoke`
+
 ## Environment
 - Copy `.env.example` to `.env.local` for local overrides.
 - `VITE_WIKI_API_CONTACT_EMAIL` is used for the Wikipedia API identification header.

package-lock.json

@@ -16,6 +16,7 @@
     "check": "npm run lint && npm run test && npm run build"
   },
   "dependencies": {
+    "@xyflow/react": "^12.10.1",
     "d3": "^7.9.0",
     "react": "^18.2.0",
     "react-dom": "^18.2.0"