Files
AndreaSlopFotografie/aidlc-docs/features/homepage-sections/inception/application-design/component-methods.md
T
SluijsensandClaude Opus 5.5 c81dcd3979 Adds the inception docs and design for the homepage sections
Refreshes the shared reverse engineering docs, adds the requirements,
application design and units for the homepage-sections feature, and
updates the static design: live prices and form fields, the new
Lieve woorden block and the coming-soon gate over the contact form.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
2026-10-19 23:46:30 +02:00

116 lines
4.9 KiB
Markdown

# Component Methods — homepage-sections
Signatures and data shapes. Detailed rules (validation messages, limits, carousel behaviour, spam thresholds) follow in Functional Design per unit.
## Content types (`content/types.ts`, additions)
```ts
// An image as the API will deliver it; src is a URL (bundled asset today)
interface ContentImage {
src: string;
alt: string;
width: number;
height: number;
}
interface PricingPackage {
id: string; // stable slug, e.g. 'newborn'; used in ?pakket= and as the shoot value
name: string; // 'Newborn'
price: number; // whole euros, e.g. 185
features: string[]; // '1-2 uur fotografie', ...
}
interface Testimonial {
id: string;
shoot: string; // label, e.g. 'Newbornshoot'
quote: string;
author: string; // 'Demi & Kevin'
image: ContentImage;
}
interface HomeContent {
intro: { title: string; lead: string; photos: ContentImage[] };
about: {
eyebrow: string;
title: string;
paragraphs: string[];
image: ContentImage;
link: { label: string; to: RoutePath };
};
pricing: { title: string; lead: string };
testimonials: { title: string };
contact: { title: string; lead: string };
instagram: { title: string; handle: string; photos: ContentImage[] };
}
// SiteContent gains:
interface SiteContent {
// ...existing fields
contactForm: { enabled: boolean };
}
```
Content modules (design Q2 = A): `content/packages.ts` → `PricingPackage[]`, `content/testimonials.ts` → `Testimonial[]`, `content/homeContent.ts` → `HomeContent`.
## Contact types (`contact/types.ts`)
```ts
interface ContactValues { // what the visitor typed
naam: string;
email: string;
shoot: string; // '' | a package id | 'overig'
bericht: string;
}
type ContactField = keyof ContactValues;
type ContactErrors = Partial<Record<ContactField, string>>;
interface ContactPayload { // what goes to POST /api/contact
naam: string;
email: string;
shoot: string;
bericht: string;
}
interface ShootOption { value: string; label: string }
```
## Components (props)
| Component | Props |
|---|---|
| `HomeSection` | `{ labelledBy: string; id?: string; tone?: 'paper' \| 'alt'; width?: 'default' \| 'narrow'; spacing?: 'default' \| 'tight'; children: ReactNode }` |
| `SectionHeading` | `{ id: string; title: string; eyebrow?: string; lead?: string; align?: 'center' \| 'start' }` |
| `Reveal` | `{ children: ReactNode; delay?: number }` |
| `FramedImage` | `{ image: ContentImage; aspectRatio: string }` |
| `IntroGallery` | `{ content: HomeContent['intro'] }` |
| `AboutBlock` | `{ content: HomeContent['about'] }` |
| `Pricing` | `{ content: HomeContent['pricing']; packages: PricingPackage[] }` |
| `PriceCard` | `{ pkg: PricingPackage }` |
| `Testimonials` | `{ content: HomeContent['testimonials']; testimonials: Testimonial[] }` |
| `ContactSection` | `{ content: HomeContent['contact']; packages: PricingPackage[]; enabled: boolean; email: EmailAddress; preselected?: string }` |
| `ContactFormGate` | `{ enabled: boolean; email: EmailAddress; children: ReactNode }` |
| `ContactForm` | `{ idPrefix: string; options: ShootOption[]; initialShoot?: string; submit?: (payload: ContactPayload) => Promise<void> }` (`submit` defaults to `submitContactForm`; injectable for tests) |
| `InstagramGrid` | `{ content: HomeContent['instagram']; profileUrl: string }` |
## Hooks
- `useReveal<T extends Element>(): { ref: RefObject<T>; visible: boolean }` — `visible` starts `true` when reduced motion is on or IntersectionObserver is missing; otherwise flips to `true` once and stops observing.
## Pure helpers (`lib/`, 100% coverage, property-based tests)
| Function | Purpose |
|---|---|
| `formatPrice(euros: number): string` | `185` → `'€ 185'` (nl-NL, no decimals) |
| `shootOptions(packages: PricingPackage[]): ShootOption[]` | package names in order + `{ value: 'overig', label: 'Overig' }` |
| `packageFromSearch(value: unknown, packages: PricingPackage[]): string \| undefined` | returns the id only if it matches a package |
| `validateContact(values: ContactValues, options: ShootOption[]): ContactErrors` | required fields, e-mail format, max lengths, shoot must be a known option |
| `toContactPayload(values: ContactValues): ContactPayload` | trims fields |
| `isLikelySpam(input: { honeypot: string; shownAt: number; now: number }): boolean` | honeypot filled or submitted too fast |
| `slideLabel(index: number, count: number): string` | `'Review 2 van 3'` for the live region and slide `aria-label` |
## Services / adapters
- `submitContactForm(payload: ContactPayload): Promise<void>` (`contact/submitContactForm.ts`) — today rejects with a generic error (no back-end); later `POST /api/contact`.
- Route search: `validateSearch: (search) => ({ pakket: typeof search.pakket === 'string' ? search.pakket : undefined })` on `/`; the page then resolves it with `packageFromSearch`.