Shows client reviews one at a time with the framed photo, a large quotation mark, the shoot type and the names. Uses Chakra's carousel for paging, looping and swiping with our own controls, so visitors who prefer reduced motion get instant changes, and loads the carousel only when the section comes near the screen so the hero does not wait for it. Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
6.3 KiB
6.3 KiB
Code Generation Plan — Unit 4: Lieve woorden
This plan is the single source of truth for Code Generation of unit 4.
Unit context
- Requirements: FR-HP-05, FR-HP-11, FR-HP-12, NFR-HP-01/02/03/05/06
- Functional design: lieve-woorden/functional-design/ — BR-REV-01…11
- Depends on: unit 1 (
HomeSection,SectionHeading,Reveal,DeferredImage), unit 2 (FramedImage) - PBT: full —
visibleTestimonials,slideLabel; PBT-06 N/A (carousel state machine is Chakra's/Zag's). - Conventions as in units 1–3.
Findings that shape the plan (from the installed @zag-js/carousel 1.43.3)
- Reduced motion: the built-in triggers, indicators and arrow keys call
scrollTo({ behavior: 'smooth' })from JavaScript; CSSscroll-behaviorcannot override that. The API does accept aninstantflag (scrollPrev(instant),scrollNext(instant),scrollTo(page, instant)). → We keep Chakra's carousel for state, snapping, looping, swiping, slide semantics and hidden off-screen slides, but render our own previous/next buttons and dots (and arrow-key handling on the controls) that passinstant = prefersReducedMotion(BR-REV-06). - Double announcement: the item group already carries
aria-live="polite". → We set it tooffand keep one own polite live region with "Review n van m" (BR-REV-08). - Labels: Zag's default translations are English. →
translations.item = slideLabelso slides are "Review n van m" (BR-REV-09).
Steps
Images and content
- Step 1 — Extend the one-off resize script with a centre crop to a target aspect ratio. Prepare the two live photos, cropped to 4:5 from the centre and resized to 880×1100, quality 80:
IMG_2497-5.jpg→web/src/assets/home/review-trouwshoot.jpg,5-F41A4650-scaled.jpg→web/src/assets/home/review-newbornshoot.jpg. Record the script change in the summary. - Step 2 —
content/types.ts:Testimonial { id; shoot; quote; author; image: ContentImage };HomeContent.testimonials { title }. - Step 3 —
content/testimonials.tswith the two live reviews (full texts from FR-HP-05, alt texts from domain-entities.md);homeContent.testimonials.title = 'Lieve woorden'.
Pure helpers
- Step 4 —
lib/visibleTestimonials.ts(+ test): invariants filter, first-wins de-duplication. Properties: valid + unique; subsequence; idempotent; oracle. - Step 5 —
lib/slideLabel.ts(+ test):slideLabel(index, count)→Review ${index + 1} van ${count}. Properties: numbers round-trip; form and range invariant. - Step 6 —
test/arbitraries.ts:testimonial,uniqueTestimonials,anyTestimonial.
Components
- Step 7 —
components/home/Testimonials/TestimonialSlide.tsx: grid5fr 7frfromlg(stacked below, photo max 420 px),FramedImage4/5, decorative quotation mark (aria-hidden), shoot as eyebrow (accent.deep),figure>Blockquote>figcaption"— author";data-testid="testimonial-<id>". - Step 8 —
components/home/Testimonials/Testimonials.tsx:visibleTestimonials; none →null; one →TestimonialSlidewithout carousel; two or more →useCarousel({ slideCount, loop: true, allowMouseDrag: true, translations })+Carousel.RootProvider(aria-label="Reviews",aria-roledescription="carrousel"),Carousel.ItemGroupwitharia-live="off"and stretched items (equal height, BR-REV-07), oneCarousel.Itemper review; own controls: "Vorige review" / "Volgende review" buttons (Ant Design left/right outlined icons, offline), one dot per review (aria-label="Review n",aria-currenton the current one, 44 px hit area), arrow keys on the control bar; every control calls the API withinstant = reducedMotion;onPageChangesets the politeVisuallyHiddenlive region toslideLabel.HomeSection tone="alt", centred heading. - Step 9 — Tests:
TestimonialSlide.test.tsx(photo alt, shoot, quote in a blockquote, author caption, quotation mark hidden, axe) andTestimonials.test.tsx(region "Lieve woorden"; two slides labelled "Review 1 van 2" / "Review 2 van 2"; buttons and dots named in Dutch; next from the last review goes to the first (loop) and is announced; a dot jumps to its review and marks itself current; arrow keys move; with reduced motion the API is called withinstant; one review → no controls; none → no section; invalid reviews skipped; live region empty on load; axe clean).
Route
- Step 10 —
routes/index.tsx: renderTestimonialsafterPricingwithhomeContent.testimonialsandtestimonials. - Step 11 —
app.test.tsx: "Lieve woorden" in the page-order check.
Verification and wrap-up
- Step 12 —
pnpm check(incl. Lighthouse); visual check at 1440, 390 (CDP), including a swipe/next to the second review. - Step 13 —
construction/lieve-woorden/code/code-summary.md. - Step 14 — Commit (including the pending audit/state updates) — "Adds the Lieve woorden section to the homepage" + attribution. Not pushed.
Fixes during Step 12
- Step 12a — Real-browser check showed the next slide's sand block over the quote and the own block clipped: 4 rem
spacingbetween slides, 1.5 rem padding left/bottom per slide (fromsm). - Step 12b — Home mobile Lighthouse median 0.83 → 0.81 with the carousel in the route chunk.
React.lazyalone did not help; the carousel moved toTestimonialCarousel.tsxand loads only when the section is within 200 px of the screen (heading always rendered, placeholder of the measured height). Median back to 0.83.
Requirement / rule traceability
| Item | Steps |
|---|---|
| FR-HP-05 | 2, 3, 7–11 |
| BR-REV-01 | 4, 8, 9 |
| BR-REV-02 | 8, 9 |
| BR-REV-03/04/05 | 8, 9 |
| BR-REV-06 | 8, 9 (finding 1) |
| BR-REV-07 | 8, 12 |
| BR-REV-08 | 5, 8, 9 (finding 2) |
| BR-REV-09 | 5, 8, 9 (finding 3) |
| BR-REV-10 | 8 (Zag sets aria-hidden on off-screen slides), 9 |
| BR-REV-11 | 7, 9 |
| NFR-HP-05 | 1, 7 (deferred image), 12 |
Extension compliance (planned)
- Security: content rendered as text; no new dependencies (Chakra Carousel and Ant Design icons already installed); no external resources.
- PBT: PBT-02 (slideLabel round-trip), PBT-03 (invariants), PBT-04 (idempotency), PBT-05 (oracle), PBT-07 (generators), PBT-08/09 (existing), PBT-10 (example tests); PBT-06 N/A.