add core view extension with JTE and Thymeleaf support

2026-04-21 00:32:09 +02:00
parent 34fd74068a
commit 9e19f439be
93 changed files with 2200 additions and 1404 deletions
@@ -0,0 +1,29 @@
+# Architecture
+
+`flash-ext-view-jte` has two layers:
+
+1. **Boot-time**
+   - `JteExtension` installs runtime + annotation processor.
+   - `JteTargetResolver` validates handlers and resolves `@Template`.
+   - Resolved targets are cached per handler class.
+
+2. **Request-time**
+   - Handler builds local `ViewModel`.
+   - Runtime injects globals under reserved `global` namespace and merges local model.
+   - jte renders template into `StringOutput`.
+
+## Handler Contract
+
+- Must extend `JteHandler`.
+- Must have route annotation (`@Route`, `@GET`, `@POST`, ...).
+- Must declare exactly one view annotation: `@Template`.
+
+Invalid configurations fail fast at startup.
+
+## Defaults
+
+- `templateRoot`: `/templates`
+- `contentType`: `gg.jte.ContentType.Html`
+- `developmentMode`: `Flash.DEV`
+- `usePrecompiled`: derived from `!developmentMode` unless explicitly set
+- `binaryStaticContent`: `false`