# Domain Entities - Unit 2: Display fallbacks
The site has no runtime data model and unit 2 adds none. The entities are the reveal phase of an element, the markers and ids the no-JavaScript CSS depends on, the preload link, and the per-page inventory of the largest paint. Existing entities (`ContentImage`, `SitePage`, `NavItem`) are unchanged. Rules: [business-rules.md](business-rules.md). Flows: [business-logic-model.md](business-logic-model.md).
## 1. Relationships
```mermaid
graph TD
Rect["ViewportMeasure: top edge and viewport height"]
Phase["RevealPhase: settled, hidden, revealed"]
Elem["Reveal element"]
Img["ContentImage: src, alt, width, height"]
Pair["DeferredImagePair: empty img plus noscript twin"]
Mark["JsOnlyMarker: data-requires-js, data-email-pending, data-deferred"]
Css["NoScriptStyleSheet in the head"]
Frag["FragmentTarget: mobile-nav, site-header"]
Link["PreloadLink: rel preload, as image"]
Row["FirstRow: always, from md, from lg, or none"]
Prof["PageImageProfile: largest paint per page and width"]
Rect -->|"decides first phase of"| Phase
Phase -->|"styles"| Elem
Img -->|"yields"| Pair
Pair -->|"first image carries"| Mark
Mark -->|"is hidden by"| Css
Frag -->|"is shown by"| Css
Img -->|"yields, only for picture"| Link
Prof -->|"says which page needs a"| Link
Row -->|"decides eager tiles and their"| Link
classDef value fill:#fbd38d,stroke:#92400e,stroke-width:1px,color:#000;
classDef entity fill:#63b3ed,stroke:#2b6cb0,stroke-width:1px,color:#000;
classDef build fill:#9ae6b4,stroke:#2f855a,stroke-width:1px,color:#000;
class Rect,Phase,Img value;
class Elem,Pair,Link,Prof,Row entity;
class Mark,Css,Frag build;
```
Text alternative: a measured rectangle sets the reveal phase, an image yields the deferred pair or a preload link, the first-row rule picks eager tiles, and the stylesheet acts on markers and targets.
## 2. Reveal phase
| Phase | When | `data-reveal` | opacity | transform | transition |
|---|---|---|---|---|---|
| `settled` | Prerender, hydrating render, in view at hydration, reduced motion, no observer | `visible` | 1 | none | none |
| `hidden` | After hydration, wholly below the viewport | `hidden` | 0 | `translateY(24px)` | none |
| `revealed` | Hidden element intersected (threshold 0.12, bottom margin 60 px) | `visible` | 1 | none | `opacity, transform`, 0.8 s, `smooth`, delay `delay` s |
Transitions: `settled` stays; `hidden` becomes `revealed`; `revealed` stays (P20, P21). `useReveal` returns `visible` (phase is not `hidden`) and `animated` (phase is `revealed`).
| Input of `startsHidden` | Type | Note |
|---|---|---|
| `top` | number | `getBoundingClientRect().top`; zero for `display: none` and in jsdom |
| `viewportHeight` | number | `window.innerHeight` |
Constants kept from `useReveal`: `threshold` 0.12, `rootMargin` `0px 0px -60px 0px`; `translateY(24px)` and the `reveal` duration token from `Reveal`.
## 3. Markers the no-JavaScript CSS acts on
| Marker | Meaning | Rule | Put on |
|---|---|---|---|
| `data-requires-js` | No function without JavaScript; hidden | BR-NJS-01 | Hamburger button (`NavigationBar`); chevron buttons (`NavSubmenu`, `MobileNavGroup`); `HeroArrows` buttons; `HeroPauseButton`; hero progress bar; `FilterBar` root; testimonial controls spacer (`CarouselPlaceholder`); footer Contact column (through `FooterColumn`) |
| `data-email-pending` | Placeholder for the address that never comes without JavaScript; hidden | BR-NJS-02 | Already there (unit 1): footer `li`, contact card `li` (two), gate sentence span, gate button placeholder |
| `data-deferred` | Photo that is empty until JavaScript sets its `src`; hidden while it has no `src` | BR-IMG-02 | The first `
` of `DeferredImage` |
| `data-submenu` and `data-submenu-panel` | Desktop submenu wrapper and its panel; panel opens on `:focus-within` | BR-NAV-09 | `NavSubmenu` wrapper `Box` and panel `Box` |
## 4. Fragment targets and ids
| Id | Element | Used by | Notes |
|---|---|---|---|
| `mobile-nav` | `MobileNav` panel (exists) | Open link `href`; `:target` rule | `position: fixed`; no scroll on navigation |
| `site-header` | `NavigationBar`'s `chakra.header` (new `id`) | Close link `href` | `position: fixed`; no scroll on navigation |
| `mobile-group-` | `MobileNavGroup` list (exists) | Selector prefix `[id^="mobile-group-"]` | Expanded without JavaScript |
| `submenu-` | `NavSubmenu` panel (exists) | `aria-controls` | Not styled by id; the rule uses `data-submenu-panel` |
| `main` | `SkipNavContent` (exists) | Skip link | Unchanged |
Classes written by hand in the CSS (no Emotion): `ns-menu-open`, `ns-menu-close`.
## 5. PreloadLink
| Field | Type | Value |
|---|---|---|
| `rel` | `'preload'` | constant |
| `as` | `'image'` | constant |
| `href` | string | `image.src`, the hashed asset URL Vite produced |
| `fetchPriority` | `'high'` | constant |
| `media` | string, optional | Only for a photo shown from one breakpoint (`ASIDE_MEDIA`, `(min-width: 64em)`) |
On `/portfolio` two links with `media` `(min-width: 48em)` (tile 2) and `(min-width: 64em)` (tile 3).
Written by React (not by this entity): one link per non-lazy `img` with `src`, inside the head (BR-PRE-01).
## 6. PageImageProfile (largest paint, preload source)
Sizes are transfer sizes from the Lighthouse reports. "React" means the hoisted link of BR-PRE-01.
| Page | Largest paint, below `lg` | Largest paint, from `lg` | Photo (KB) | Preload |
|---|---|---|---|---|
| `/` | h1 text | h1 text | Hero `hero-8` 224 | React, `fetchPriority="high"` (BR-PRE-07) |
| `/over-mij` | `andrea-portret` | same | 84 | React |
| `/portfolio` | grid tile 1 (`f41a1916`) at 412; tile 2 (`f41a1922`) at 768 | tile (`f41a7883`) | 54 to 144 each | Tile 1 React; tiles 2 and 3 `media` links 48em and 64em (BR-PRE-08 to 11) |
| `/soorten-fotoshoots` | `newborn` | same | 74 | React |
| `/soorten-fotoshoots/newborn` | `newborn` | same | 74 | React |
| `/soorten-fotoshoots/zwangerschap` | `zwangerschap` | same | 103 | React |
| `/soorten-fotoshoots/gezin` | `gezin` | same | 117 | React |
| `/soorten-fotoshoots/loveshoot` | `loveshoot` | same | 153 | React |
| `/soorten-fotoshoots/portret` | `portret` | same | 97 | React |
| `/contact` | intro text | `contact-D949P5Az` (aside photo) | 80 | Explicit `media` link (BR-PRE-02) |
| `/privacyverklaring` | footer logo | h1 text | none | None |
| 404 page | footer logo | footer logo | none | None |
Logos, preloaded by React on every page today: `logo-dark` 23 KB and `logo-light` 25 KB, 500 x 500 px, shown at 46 px. The light logo is used only on `/` from `lg` (BR-PRE-05). The 72 px contact portrait is 5 KB.
## 7. FirstRow
`FirstRow` is the answer of `firstRow(index, columns)` for one tile of the portfolio grid (BR-PRE-08).
| Input | Type | Value for the grid |
|---|---|---|
| `index` | number, 0 based | Position in the unfiltered list, reading order |
| `columns` | map of breakpoint media to column count | `base`: 1, `(min-width: 48em)`: 2, `(min-width: 64em)`: 3. One constant that `PortfolioGrid` also uses for `gridTemplateColumns` |
| Tile | `FirstRow` | Markup | Preload |
|---|---|---|---|
| 1 (index 0) | `'always'` | `Image` with `src`, `fetchPriority="high"` | React |
| 2 (index 1) | `{ media: '(min-width: 48em)' }` | `picture` with `source`, `DeferredImage` img, `loading="eager"` | `preloadImage` with `media` |
| 3 (index 2) | `{ media: '(min-width: 64em)' }` | same | `preloadImage` with `media` |
| 4 and up | `null` | `DeferredImage` | None |