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,65 @@
+# flash-ext-view-thymeleaf
+
+Opinionated Thymeleaf SSR extension for Flash.
+
+This module keeps Thymeleaf semantics front and center:
+
+- `ThymeleafExtension`
+- `ThymeleafHandler`
+- `@Template` and `@Fragment`
+- `ViewModel` from `flash-ext-view-core`
+- `global.*` reserved namespace
+
+The extension uses Thymeleaf-native patterns (`template` names resolved by prefix/suffix,
+fragment selection via `template :: fragment`) while keeping Flash boot-time fail-fast checks.
+
+## Quick Start
+
+```java
+import dev.relism.extension.FlashApp;
+import dev.relism.ext.view.core.ViewModel;
+import dev.relism.ext.view.thymeleaf.*;
+
+FlashApp.create(8080)
+    .install(new ThymeleafExtension()
+        .addGlobal("appName", req -> "Flash")
+        .addGlobal("requestPath", req -> req.path()))
+    .scan("com.example.web")
+    .startAndBlock();
+```
+
+```java
+import dev.relism.ext.view.core.ViewModel;
+import dev.relism.ext.view.thymeleaf.*;
+import dev.relism.routing.GET;
+
+@GET("/")
+@Template("pages/home")
+public final class HomePage extends ThymeleafHandler {
+    @Override
+    public ViewModel render(dev.relism.models.Request req) {
+        return ViewModel.of("title", "Home");
+    }
+}
+```
+
+## Fragment Example
+
+```java
+@GET("/users/rows")
+@Fragment(template = "fragments/users", value = "rows")
+public final class UserRows extends ThymeleafHandler {
+    @Override
+    public ViewModel render(dev.relism.models.Request req) {
+        return ViewModel.of("users", List.of());
+    }
+}
+```
+
+## Docs
+
+- `docs/architecture.md`
+- `docs/handlers.md`
+- `docs/model-and-globals.md`
+- `docs/fragments.md`
+- `docs/performance.md`