From 1a59fc3125c8ea24f0dd8d8320c3f5f3b18aea63 Mon Sep 17 00:00:00 2001 From: Sluijsens Date: Mon, 16 Nov 2026 16:49:07 +0100 Subject: [PATCH] Hero module: assumptions and deferred questions Co-Authored-By: Claude Sonnet 5.5 --- .../assumptions-and-open-questions.md | 16 ++++++++++++++++ 1 file changed, 16 insertions(+) create mode 100644 aidlc-docs/features/hero-module/assumptions-and-open-questions.md diff --git a/aidlc-docs/features/hero-module/assumptions-and-open-questions.md b/aidlc-docs/features/hero-module/assumptions-and-open-questions.md new file mode 100644 index 0000000..501ade9 --- /dev/null +++ b/aidlc-docs/features/hero-module/assumptions-and-open-questions.md @@ -0,0 +1,16 @@ +# Hero module: assumptions and deferred questions (ASF side) + +Written while Bryan was away; he decides later. Each point: question, assumption, what changes with another answer, where in the code. + +| # | Question | Assumption | If the answer differs | Where | +|---|----------|------------|-----------------------|-------| +| 1 | Focus points of the 8 photos | Estimates from the seed (e.g. hero-8 0.50/0.55) | Change x/y in the seed (CMS) and in the baked values | `web/src/content/heroContent.ts`, `web/contract/host-injection/hero/seed.json` | +| 2 | Is the baked hero cropped around the focus point too? | Yes: object-position from the estimates, so baked and live look the same | Pass `focus: null` for the baked slides to get plain centre crop | `heroContent.ts` | +| 3 | Button target `#anchor` and https: plain link, `/path`: router link | As said | Make all plain links | `web/src/components/Hero/HeroButton.tsx` | +| 4 | Single display (one photo) or slideshow with one slide | No arrows, pause or progress bar for one slide | Show controls anyway | `Hero.tsx` (`shown.length > 1`) | +| 5 | Title with a new line | `
` in the plain HTML, `pre-line` in the slider | One line only | `heroHtml.ts`, `Hero.tsx` | +| 6 | Where does the head preload marker come from | Build step adds it to the finished HTML (React cannot write a head comment) | Host adds the head region itself | `web/config/heroPreload.ts` | +| 7 | Hero texts (aria, baked title, alts) | In `nl.json`, block `hero` | Other wording: edit the file | `web/src/i18n/nl.json` | +| 8 | Without a host block the site asks `/api/v1/hero` (8 s time-out) | Yes, like packages and banners | Remove the call: baked only | `web/src/components/Hero/useHero.ts` | +| 9 | Style of the plain hero before hydration | Matches the slider's first frame (checked by screenshot at 1280 and 390 px) | Adjust CSS | `.cms-hero-*` in `web/src/theme.ts` | +| 10 | AVIF for slides 2..n only | As agreed with the CMS session | Add AVIF to the first photo and its preload (then two fetches) | `Hero.tsx` (`SlidePicture`) |