# 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`.

3. **Static assets (optional, enabled by default)**
   - Extension mounts wildcard routes under `staticPrefix` (default `/static/**`).
   - Assets are served from classpath `/static/**`.
   - Uses Flash `Response.body(...)` for small payloads and `Response.stream(...)` for large payloads.
   - Supports ETag/304, gzip precompressed assets, MIME auto-resolution, and byte ranges.

## 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`
- `serveStatics`: `true`
- `staticPrefix`: `/static`
- `largeFileThresholdBytes`: `65536`
- static CORS: disabled (`false`)