# 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"] 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 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 entity; class Mark,Css,Frag build; ``` Text alternative: a measured rectangle sets the reveal phase, a content image yields the deferred pair or a preload link, and the no-JavaScript stylesheet acts on markers and fragment 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)`) | 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 | None (BR-PRE-08) | | `/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.