first commit

frontend/README.md

@@ -0,0 +1,24 @@
+# Frontend (React + TypeScript) — placeholder
+
+Phase 0 task **"React + TypeScript frontend scaffolding"** (Dev 2) and all later
+viewer/editor UI lives here. Not implemented yet — this session scaffolds the
+C++ build pipeline only.
+
+Planned responsibilities (see the engine blueprint §9):
+
+- Layered viewer: canvas layer, selection layer, annotation layer, overlay layer.
+- PDF <-> canvas <-> zoomed coordinate mapping.
+- Virtualized page rendering (only visible pages).
+- Talks to the gateway over HTTP; later, to the engine directly via WASM.
+
+Setup when implemented: Vite + React + **TypeScript strict mode** from day one.
+
+```
+frontend/
+  package.json
+  tsconfig.json        # "strict": true
+  src/
+    components/
+    viewer/
+    lib/
+```