Rapport: voet met legenda op elke pagina (#113, nabespreking)

[Nozzit]

What and why

Vervolg op #132 (issue #113) — gestapeld op die branch (bevat de laatste #132-commit 1cf581b via merge); de base kan na de merge van #132 naar main worden gezet. Refs #113. Let op: ci.yml triggert alleen op PR's naar main, dus op deze PR draait geen CI zolang de base de #132-branch is; tot de retarget zijn de lokale suites hieronder de poort.

De Gantt-afdruk tekent één voetstrook (projectnaam, afdrukdatum, legenda, merk) onder de laatste rij, en de pagineerders herhaalden alleen de kop: bij elke meerpagina-afdruk stond de legenda dus alleen op de laatste pagina. Dat bestond al, maar "een blad per persoon" (#132) maakt het onhoudbaar — een uitgedeeld vel met rode en blauwe balken zonder legenda (bevinding 5 van de hyperkritische review op #132).

De voet is nu, net als de kop, een herhaalbaar blok:

• RenderReportResult.footerHeight (verplicht, zoals headerHeight): de render meldt zijn voethoogte (schaalt mee met de rapport-lettergrootte; tabelrenders en de lege staat melden 0).
• tileLayout.computeTileLayout kent repeatFooterHeightPx: de body loopt van onder de kop tot boven de voet (repeatFooterSrcY); elke pagina houdt onderaan het printgebied footerTopPt vrij (boven de paginanummer-marge, nu PAGE_NUMBER_PT). De voet wordt uit één vast bronvenster getekend, footerWindow (x vanaf 0, één paginabreedte, op de linkermarge) — níét per kolomvenster gesneden — en de render legt de voetinhoud binnen PrintOptions.footerLayoutWidth (= footerLayoutWidthFor(layout): één paginabreedte zodra de voet herhaald wordt, anders undefined = de oude render), zodat naam, legenda en merk op élk vel compleet zijn, ook met de tijdlijn over meerdere pagina's. Herhaald wordt er alleen als er meer dan één vel is: meer dan één rij, of meer dan één kolom, of een gedwongen paginaovergang (blad per resource); past alles op één vel, dan blijft de voet onder de laatste rij. Zonder de optie is de tegeling én de render byte-identiek (op het weggehaalde nepnummer na, zie onder); dezelfde degeneratievangnetten als de kop.
• Raster-pagineerder (paginate.ts), vector-pagineerder (paginateVector.ts) én de preview (renderPrintPreviewPage) tekenen de strook één keer per pagina uit dat venster, alle drie via dezelfde footerLayoutWidthFor. De vector-tak doet bij meer dan één kolom één extra render-pass met de voetbreedte (zoals de CJK-pass; alleen als die breedte écht kleiner is dan het canvas, met herhaalde coverage-poort); raster-export en preview kennen de layout al vóór hun render. De preview rendert per pagina één volledige pass extra voor de strook, net als voor de kop (staat in CLAUDE.md; een offscreen-cache voor kop én voet is een aparte klus).
• Instelling Voet op elke pagina herhalen (repeatFooter, standaard aan zoals de kop) in ops-reportSettings, checkbox naast "Kop op elke pagina herhalen"; 14 locales; gids nl+en (optiebullet met de kosten, het éénpagina-geval en het paginanummer; in de resourcediagram-sectie vervangt "elk uitgedeeld vel zijn eigen legenda" de zin dat de voet op het laatste vel staat).
• Het vaste "Pagina 1 van 1" in de voet is weg (het echte "n / totaal" drukken de pagineerders in de ondermarge) — ook met de optie uit; de daarmee dode labels.page/labels.of zijn uit PrintOptions, ReportPanel, vijf testfixtures en de 14 report.json-locales.

Schermbewijs: artifacts/resourcediagram/03-voet-op-elke-pagina-pagina-2.png — pagina 2 van het resourcediagram met blad per resource, mét voet.

Hyperkritische reviews (subagent, Opus), drie rondes. Ronde 1 ("nee, nog niet", verwerkt in 59ab7a1): voet per kolom gesneden ⇒ legenda in één kolom; éénpagina-afdruk kreeg de voet aan de onderrand; footerHeight optioneel; dode labels + weessleutels; browsertest telde vensters i.p.v. inhoud; kosten ongedocumenteerd; fixture op de cachegrens; moduledoc/naam. Ronde 2 ("nee", verwerkt in 99d6107): één rij × N kolommen kreeg geen herhaling én een in kolom 1 geperste, gesneden voet; voetbreedte ging onvoorwaardelijk mee ⇒ UIT-stand ≠ oude render, drie paden uiteen; browsertest bewees geometrie, geen inhoud; hoogtefilter aan lettergrootte 100 % geklonken; twee bovengrenzen voor gedwongen posities; één fixture over het hoofd gezien. Ronde 3 ("ja — mag door", restpunten verwerkt in de laatste commit): loze extra vector-pass door float-< (~5 % van de breedtes); coverage-poort na die pass; testparser met q/Q-stack en hoogte t.o.v. de papierhoogte; gids over het paginanummer; previewkosten in CLAUDE.md. De reviewer mat de PDF-vorm zelf na met een eigen headless vector-export in acht configuraties en vond geen tekstlek tussen body en voet.

How it was verified

• npm run verify green — lokaal op de Rapport: voet met legenda op elke pagina (#113, nabespreking) #135-branch: typecheck, lint, cycles, verify:docs (34 × 14), verify:i18n, de rapportbatterijen (check-print-report, check-reports, beide settings-checks, plus check-today-label, check-split-bar-render, check-print-working-exceptions, check-print-raster-export-streaming, check-dependency-style voor de labelverwijdering), de volledige planningssuite (exit 0, incl. tijdzone-matrix) en de volledige browsersuite (142/144 — de twee bekende sandbox-fouten in just-updated-dialog.spec.ts op de proxy-CA, niet op CI; zie Rapport: resourcediagram — de Gantt-afdruk per resource, met een blad per persoon (#113) #132). Na de laatste commit opnieuw: typecheck, lint, docs, check-print-report en report-footer.spec.ts (2/2).
• Nieuwe regressie: tests/planning/check-print-report.ts (voethoogte gemeld en geschaald; voet = precies het stuk onder de laatste rijgrens; tegeling zonder optie byte-identiek en de voet hangt dan aan de laatste tegel; met optie eindigt de laatste body-tegel boven de voet, pagina's eindigen nog op rijgrenzen, kop + body + voet passen in het printgebied; te hoge voet ⇒ niet herhaald; zonder kop en in actual; twee kolommen: footerWindow = één paginabreedte vanaf x=0, en met footerLayoutWidth staat alle voettekst incl. het merk binnen die breedte zonder dat de canvasmaten veranderen; éénpagina ⇒ voet niet herhaald, tegeling identiek; één rij × twee kolommen ⇒ wél herhaald, ook in actual; blad-per-resource ⇒ wél; gedwongen positie in de voetstrook zet de herhaling niet aan; footerLayoutWidthFor undefined zonder herhaling; geen nep-paginanummer), nieuw tests/planning/check-report-footer-setting.ts (default aan, opslag van vóór de optie, rommel, round-trip; bedraad in run.sh), tests/browser/report-footer.spec.ts (parseert per PDF-pagina de tegelvensters met een q/Q-stack: precies één voetvenster op de onderrand van het printgebied, vanaf x = 24, één volle printbreedte breed en met ≥ 4 tekstoperatoren — mét voet op elke pagina, óók met "Tijdlijn over 2 pagina's"; zonder voet nergens; tweede scenario: 6 taken ⇒ één vel zonder los voetvenster, met de tijdlijn over 2 pagina's ⇒ twee vellen die elk de volle voet mét tekst dragen).
• tests/browser/report-preview-performance.spec.ts: fixture 260 → 200 rijen (6 van maxPages 7, met marge). Die test materialiseert bewust de hele preview; met 260 rijen stond het paginatotaal precies op de grens en kost de voet per pagina één strook body.

Does this touch

• Project data — n.v.t. (app-voorkeur in ops-reportSettings).
• Scheduling logic — n.v.t.
• User-visible text — repeatFooter via t(...) in alle 14 report.json-locales (+ page/of verwijderd); verify:i18n groen.
• @tauri-apps/* — n.v.t.

Documentation

• public/docs/{nl,en}/gids-rapporten-printen.md: bullet Voet op elke pagina herhalen (incl. meerdere kolommen, éénpagina-geval, de kosten, de botsing met blad-per-resource en het paginanummer in de ondermarge); resourcediagram-sectie aangepast.
• CLAUDE.md: rapportparagraaf (voet als herhaalbaar blok, de keten footerHeight → repeatFooterHeightPx/repeatFooter, de previewkosten).
• docs/CHANGELOG.md bewust niet (alleen bij een release).

🤖 Generated with Claude Code

https://claude.ai/code/session_014zosxbSXvi3YSGmeN1MsQq