davideandClaude Sonnet 5.5
8f25143aa5
- Spezza il registro delle decisioni in docs/decisions/DD-XXX.md, con indice - Ripulisce DATABASE.md dalla storia delle migration e aggiunge la sezione Lettura - Riduce PROJECT_STATE.md a una pagina; la procedura di allestimento passa in OPERATIONS.md - Aggiunge OPERATIONS.md, GLOSSARIO.md, trappole note e checklist in ARCHITECTURE.md - Sintetizza la copertura test di badge.md e documenta docs/archive - Allinea AGENTS.md, README.md e la regola Cursor (tolto l'obbligo di develop, in contrasto con DD-019) Co-Authored-By: Claude Sonnet 5.5 <noreply@anthropic.com>
41 lines
2.0 KiB
Markdown
41 lines
2.0 KiB
Markdown
# DD-021 — Molle interrompibili al posto delle animazioni a durata fissa
|
|
|
|
**Data:** 5 settembre 2026
|
|
**Stato:** Accettata
|
|
|
|
**Contesto**
|
|
Il movimento era fatto con `@keyframes` CSS e transizioni a durata fissa. Funzionava, ma
|
|
nessuna di quelle animazioni può essere interrotta: se l'utente tocca o scorre a metà, la
|
|
sequenza va avanti per conto suo, e per ripartire deve prima finire. Mancava del tutto
|
|
qualsiasi gesto: il calendario si cambiava solo con due frecce.
|
|
|
|
Contemporaneamente 43 componenti su 45 in `src/components/ui/` non erano importati da nessuna
|
|
parte, e con loro ~45 dipendenze (tutti i `@radix-ui/*`, `recharts`, `react-hook-form`,
|
|
`date-fns`, `embla`, `cmdk`, …): superficie di aggiornamento e di sicurezza pagata a vuoto.
|
|
|
|
**Decisione**
|
|
Aggiungere **una** libreria di animazione — `motion` — e toglierne ~45 inutilizzate. I
|
|
parametri stanno in `src/lib/molla.ts` e sono i due di Apple (_Designing Fluid Interfaces_):
|
|
rimbalzo e durata, non massa/rigidità/smorzamento. `molla.ui` (nessun sorpasso) è il default;
|
|
`molla.slancio` si usa **solo** dopo un gesto che portava già inerzia.
|
|
|
|
**Alternative scartate**
|
|
|
|
- Tenere solo CSS con easing `linear()` e View Transitions → copre le comparse, non i gesti:
|
|
niente handoff di velocità, niente ripartenza dal valore corrente.
|
|
- GSAP → più grande e orientato alla timeline, cioè al modello prescritto che stiamo lasciando.
|
|
|
|
**Conseguenze**
|
|
|
|
- Le animazioni partono dal valore _a schermo_: un dato che cambia a metà transizione non
|
|
produce salti.
|
|
- Il movimento è ora codice JavaScript: senza JS non c'è comparsa (l'app già non funziona
|
|
senza, per auth e dati).
|
|
- `src/lib/motion.ts` resta solo per il movimento ridotto e i coriandoli.
|
|
- `src/components/ui/` non è più una libreria: aggiungere una primitiva shadcn significa
|
|
installarla, non pescarla da lì.
|
|
|
|
**Riesame**
|
|
Se il peso del bundle client diventasse un problema misurato, o se il web recuperasse
|
|
nativamente l'interrompibilità (`ScrollTimeline` e `linear()` sono un primo passo).
|