47 lines
1.1 KiB
Markdown
47 lines
1.1 KiB
Markdown
# ViewData (Website Templates)
|
|
|
|
ViewData is the **only** allowed input type for Templates in `apps/website`.
|
|
|
|
## 1) Definition
|
|
|
|
ViewData is a JSON-serializable, template-ready data structure:
|
|
|
|
- primitives (strings/numbers/booleans)
|
|
- arrays and plain objects
|
|
- `null` for missing values
|
|
|
|
## 2) What ViewData is NOT
|
|
|
|
ViewData is not:
|
|
|
|
- a Page DTO (raw transport)
|
|
- a ViewModel (client-only class)
|
|
- a Display Object instance
|
|
|
|
## 3) Construction rules
|
|
|
|
ViewData MUST be created in client code:
|
|
|
|
1) Initial SSR-safe render: `ViewData = fromDTO(PageDTO)`
|
|
2) Post-hydration render: `ViewData = fromViewModel(ViewModel)`
|
|
|
|
Templates MUST NOT compute derived values.
|
|
|
|
## 4) Determinism rules
|
|
|
|
Any formatting used to produce ViewData MUST be deterministic.
|
|
|
|
Forbidden anywhere in formatting code paths:
|
|
|
|
- `Intl.*`
|
|
- `Date.toLocaleString()` / `Date.toLocaleDateString()` / `Date.toLocaleTimeString()`
|
|
|
|
Reason: SSR and browser outputs can differ.
|
|
|
|
## 5) Relationship to Display Objects
|
|
|
|
Display Objects are used to implement formatting/mapping, but their instances MUST NOT be stored inside ViewData.
|
|
|
|
Only primitive outputs produced by Display Objects may appear in ViewData.
|
|
|