A masonry photo grid that keeps the reading order (pure CSS, no measuring in the browser), an accessible lightbox on Chakra's Dialog with wrap-around browsing, keys, swipe and preloading, and a filter bar of toggle buttons. They work on generic gallery items, so other pages can use them. The swipe logic moves out of the hero into a shared hook; the hero behaves as before. The rules behind them live in pure helpers with property-based tests. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
3.0 KiB
3.0 KiB
Domain Entities — Unit 2: Gallery building blocks
Generic entities only; nothing here knows about shoot types, filters on the portfolio, or the URL (that is unit 3).
Relationships
graph TD
Item["GalleryItem"] -->|"thumb"| Thumb["ContentImage (grid size, alt)"]
Item -->|"full"| Full["ImageSource (lightbox size)"]
Item -->|"caption?"| Caption["visible caption text"]
Grid["PortfolioGrid"] -->|"shows list of"| Item
Box["Lightbox"] -->|"shows one of"| Item
Box -->|"driven by"| State["LightboxState"]
Filter["FilterBar"] -->|"offers list of"| Option["FilterOption"]
Swipe["useSwipe"] -->|"compares"| Points["two Points"]
classDef entity fill:#2196F3,stroke:#0d47a1,color:#000;
classDef comp fill:#4CAF50,stroke:#2e7d32,color:#000;
classDef value fill:#e2e8f0,stroke:#4a5568,color:#000;
class Item,State,Option entity;
class Grid,Box,Filter,Swipe comp;
class Thumb,Full,Caption,Points value;
Text alternative: a GalleryItem has a grid image with alt text, a large image and an optional caption; the grid shows a list of items, the lightbox shows one item at a time driven by a LightboxState; the filter bar offers FilterOptions; useSwipe compares two touch points.
Entities
GalleryItem
| Field | Type | Rule |
|---|---|---|
id |
string |
Unique within a list; used as React key and test id suffix |
thumb |
ContentImage (src, alt, width, height) |
Grid size (~800 px wide), photo's own aspect ratio; alt is the description for both sizes |
full |
ImageSource (src, width, height) |
Lightbox size (~1600–2000 px); same aspect ratio as thumb (± rounding) |
caption? |
string |
Visible under the large image; empty or missing → no caption element |
ImageSource
{ src: string; width: number; height: number } — width, height positive integers (intrinsic size).
FilterOption
| Field | Type | Rule |
|---|---|---|
id |
string |
Unique within the options |
label |
string |
Visible text (Dutch) |
LightboxState
A closed lightbox, or an open one at a position in the current list.
| Variant | Shape | Meaning |
|---|---|---|
| closed | { open: false } |
No dialog |
| open | { open: true; index: number; count: number } |
Showing item index of a list of count (0 ≤ index < count, count ≥ 1) |
Events: open(index, count), next, prev, first, last, close, listChanged(count) (see business-rules BR-LB-09).
Point
{ x: number; y: number } — a touch position in CSS pixels (start and end of a swipe).
Masonry dimensions
| Name | Value | Meaning |
|---|---|---|
ROWS_PER_COLUMN_WIDTH (K) |
40 | One implicit grid row is 1/40 of the column width |
GAP_ROWS |
2 | Vertical gap between photos, in rows (≈ 5% of the column width) |
EAGER_COUNT |
3 | First items in the list that load immediately |
PRELOAD_RADIUS |
2 | Large images preloaded on each side of the current one |
SWIPE_THRESHOLD |
50 px | Minimum horizontal travel for a swipe (same as the hero today) |