i spent the last year just spinning

2026-04-17 18:56:06 +02:00
parent 9efbe38c0c
commit e161497f2c
77 changed files with 2545 additions and 877 deletions
@@ -0,0 +1,23 @@
+# Architecture
+
+`flash-ext-view` runs in two layers:
+
+1. **Boot-time**
+   - `ViewExtension` registers `ViewRuntime` and an annotation processor.
+   - `ViewTargetResolver` validates handlers and maps annotations to `ViewTarget`.
+   - Resolved targets are cached per handler class.
+
+2. **Request-time**
+   - Handler builds local `ViewModel`.
+   - `ViewRuntime` injects extension globals under reserved `global` namespace, then merges local model.
+   - `ViewEngineAdapter` renders `RenderOutput`.
+
+## Valid Handler Contract
+
+- Must extend `ViewHandler`.
+- Must have route annotation (`@Route`, `@GET`, `@POST`, ...).
+- Must declare exactly one view annotation:
+  - `@Page`
+  - `@Partial`
+
+Invalid configurations fail fast at startup.