# Aannames — Meteors

Waar de specificatie ruimte liet, staat hier hoe we het hebben ingevuld.
Als iets onduidelijk was, volgden we de geest van Meteos en (voor de
selectie-tween) Tim's bestaande KWin-effecten.

## Fase 1 — physics-fixes (t1098u, t1100u, t1101u)

### 1. Vallende blokken landen op vliegende clusters

Een gespawnd (vallend) blok ging soms door een vliegende cluster heen,
omdat de val alleen keek naar stilliggende/settling/locked blokken.

Aanname: het vallende blok botst alleen in dezelfde kolom. Het landt op
het hoogste vliegende clustermlid onder hem, wordt vracht van die
cluster (`state = flying`, zelfde `clusterId` en `vy`, geen vlam) en
vliegt mee, inclusief omhoog als de cluster nog stijgt. Nieuwe vracht
zit precies 1 tegel boven het hoogste clustermlid in die kolom.

Omgekeerd, als een stijgende cluster een vallend blok inrijdt, geldt
hetzelfde. Een cluster die al geland is (rigid settling) telt als vaste
ondergrond: daar landt een vallend blok gewoon op, het wordt geen vracht.

### 2. Grijze clusters landen als starre groep

Voorheen werd elke kolom bij landing platgedrukt op de stapel, waardoor
gaten verdwenen.

Aanname: zodra één lid de vloer of een stil blok raakt, stopt de hele
cluster als star lichaam. De relatieve posities blijven; een deel kan
dus boven een gat blijven hangen. Gekleurde vracht (meegedragen blokken)
blijft tot het einde van de settle-tijd van 3 s bij de groep — ze
verkleuren niet opnieuw, maar vallen ook niet eerder. Na de conversie
van de grijze blokken naar willekeurige kleuren laat de hele groep los.
Blokken mét steun blijven liggen; blokken zónder steun vallen
afzonderlijk, vanuit rust, met dezelfde zwaartekracht als een gewone
val (eerst versnellen tot `fallSpeed`, zie punt 3). Gestapelde hangende
blokken vallen als stapel (ze blijven op elkaar rusten, zonder te
overlappen).

### 3. Vloeiende snelheidsovergang op de apex

Voorheen sprong `vy` op de apex in één frame naar `-fallSpeed`.

Aanname: vanaf de apex (vy = 0) versnelt de cluster (en een handmatige
sprong) met constante `fallAccel` totdat `fallSpeed` is bereikt; daarna
constante daalsnelheid. `apexEaseTime = 0.15 * fallTime` en
`fallAccel = fallSpeed / apexEaseTime`. Lage luchtweerstand (kleine
`fallTime`) geeft dus een kortere, snellere overgang. Voor Terra
(`fallTime = 3`) is dat 0,45 s. Hetzelfde geldt voor hangende blokken
die na conversie uit rust gaan vallen. Blokken die van boven het veld
binnenkomen (spawn) starten al op `fallSpeed` — die vallen al een
tijdje.

### 4. Bounce bij landing (planeetparameter)

Aanname: de bounce is visueel (squash van de sprite, plus een heel klein
optisch terugveren in Y) en verandert de simulatiefysica niet. Elk blok
dat op de vloer of op een ander blok landt, krijgt een bounce; hangende
leden van een starre groep die niets raken, niet.

Snelheid hangt af van de luchtweerstand van het veld, via `fallTime`
(1 = weinig lucht, 5 = veel lucht):

- `bounceDuration = 0.12 * fallTime` (Terra: 0,36 s; bij `fallTime = 1`
  twee keer zo snel als bij `fallTime = 2`, enz.)
- `bounceSquash = 0.16` (subtiele verticale squash naar 84%, met lichte
  horizontale compensatie)

Beide zijn planeetparameters, klaar voor fase 3.

### 5. Handmatige sprong van het bovenste blok (t1100u)

Het naar boven slepen van een blok dat al het bovenste van zijn kolom
is, moest een handmatige sprong starten (tot net onder de bovenrand).
De core vroeg eerder dat de aanwijzer in de lege ruimte boven de stapel
kwam (`y > top + 1 + 0,25`). Wie het bovenste blok vasthad en het
voorbij zijn eigen positie trok, maar niet een hele tegel het gat in,
kreeg geen sprong. Op touch kon `lostpointercapture` de sleep ook te
vroeg beëindigen.

Aanname:

- Begon de sleep al op het bovenste blok, dan is een trek van
  `LAUNCH_PULL = 0,35` tegel omhoog vanaf het drukpunt genoeg
  (“voorbij zijn eigen positie”), voor muis én touch (zelfde
  Pointer-Events-pad).
- Begon de sleep lager in de stapel, dan blijft de oude drempel gelden:
  eerst wisselen, en pas lanceren als de aanwijzer in de lege ruimte
  boven de (nieuwe) top zit. Zo lanceer je niet per ongeluk een blok
  dat je alleen naar de bovenste plek wilt schuiven.
- De view luistert na `pointerdown` op `window` voor `pointermove` /
  `pointerup` / `pointercancel`, zodat een sleep boven het canvas
  (nodig bij een volle kolom) niet verloren gaat. `lostpointercapture`
  beëindigt de sleep niet meer.

### 6. Selectie-tween (t1101u)

Een vastgehouden (geselecteerd) blok krijgt dezelfde schaal-animatie
als de **DEFAULT**-instellingen van Tim's KWin Click Tween-effect.

Bron (op deze box): `/workspace/click-tween/`, specifiek:

- `settings.h`: `clickTime = 150` ms, `releaseTime = 720` ms,
  `clickEasing = easeOutBack`, `releaseEasing = easeOutElastic`
- `clicktween.cpp`: pers-doel `0.8`, loslaat-doel `1.0`; een onderbroken
  animatie start vanaf de huidige schaal (`QVariantAnimation`)
- `README.md`: “krimpt naar 80% in 150 ms”, “groeit in 720 ms terug”,
  “curveparameters zijn Qt-standaardwaarden”

Qt `QEasingCurve`-standaardwaarden, ook in de README genoemd:

- Back-overshoot: `1.70158`
- Elastic: amplitude `1.0`, periode `0.3`

Het blok blijft op 80% zolang het geselecteerd is, en veert bij loslaten
terug (ook als het ondertussen gelanceerd wordt). Muis en touch gebruiken
dezelfde tween.

## Fase 2 — multiplayer (volgt)

Zie latere secties zodra fase 2 landt. De miss-kans van 30% wordt een
parameter (`missChance`, standaard 0,30); de planeetformule
`Planet.missChance` (60%–5% via Power) is voor fase 3.

## Deploy: vreemde bestanden en favicon.ico

De FTP-guard blokkeert alleen een duidelijk verkeerd doel (FTP-root, pad
zonder `meteors` als laatste segment, map buiten `$timftproot`). Extra
bestanden die al in de remote map staan, worden alleen gelogd: we gebruiken
nooit `--delete`, dus ze blijven staan en zijn onschadelijk.

`favicon.ico` op de server wordt niet overschreven en niet verwijderd
(mogelijk van Tim of de host). De deploy sluit dat bestand uit van de
upload, ook als er lokaal een `build/favicon.ico` staat voor eigen gebruik.

### 7. Recolor stuurt blokken niet extra hard naar boven (t1102)

Na het herkleuren van een gelande grijze groep schoten blokken erboven
soms heel hard van de bovenkant af. Oorzaak: een restant van de
lanceringssnelheid (`vy` omhoog) of van een handmatige sprong, dat
na de release in `integrateFalling` alsnog werd gebruikt. Daarnaast
telde `releaseUnsupported` in dezelfde tick nog de hangende leden als
steun, zodat blokken die erop stonden `still` bleven en in
`resolveMatches` een match in de lucht konden vormen.

Aanname / aanpak:

- Bij elke overgang naar `still` of `falling` na release (en bij het
  loslaten van ongesteunde still-blokken) wordt `clearFlightState`
  aangeroepen: `vy = 0`, geen vlam, geen restant van een handmatige
  sprong.
- `releaseUnsupported` draait opnieuw ná `advanceSettle`, zodat
  blokken op zojuist losgelaten hangende leden vanaf rust vallen
  voordat er gematcht wordt.
- Een échte nieuwe match na herkleuren is toegestaan en gebruikt de
  normale sprong: `launchVelocity(planet, jumpHeight)` en de bijbehorende
  deceleratie, niet een opgetelde of achtergebleven `vy`. Dat zit in
  een regressietest (inclusief een kunstmatig achtergebleven `vy = 40`).

### 8. Botsende vliegende clusters smelten samen (t1102)

Twee (of meer) vliegende clusters die in dezelfde kolom in Y
overlappen, worden één cluster.

Aanname: de nieuwe snelheid is het **massagewogen gemiddelde op
blok-aantal** (niet het eenvoudige gemiddelde van de twee
clustersnelheden):

    vy = (n1·vy1 + n2·vy2) / (n1 + n2)

Hetzelfde gewogen gemiddelde geldt voor `decel` en `jumpHeight`.
De fase is `up` als de samengevoegde `vy > 0`, anders `down`.
Overlappende leden in één kolom worden van onder naar boven
aangepakt, zodat de hogere strak op de lagere rust (geen twee
blokken in dezelfde cel). Keuze vastgelegd: gewogen op blok-aantal.

### 9. Direct vastpakken, geen long-press (t1102 / t1103)

Er is **geen** long-press en **geen** wachttijd. Een blok wordt op
`pointerdown` (tap of klik) meteen vastgepakt en blijft in de sleep
zolang de vinger of muisknop omlaag is; loslaten beëindigt de sleep.
De click-tween start in hetzelfde moment als `pointerdown`.

Aanname:

- Verticaal: snap naar het dichtstbijzijnde still-blok in de kolom,
  tot `SNAP_Y = 0,65` tegel (een iets misplaatste druk pakt nog).
- Horizontaal: op de druk, als de aanwijzer binnen
  `HORIZONTAL_SLOP = 0,35` tegel van de kolomrand zit, mag het
  buurblok gepakt worden. Tijdens de sleep blijft de startkolom
  vast, ook bij een iets diagonale beweging.
- Wisselen: alleen een **minimale** opgetelde verticale afstand
  `SWAP_DISTANCE = 0,25` tegel per stap, zonder vertraging vóór de
  sleep. Een enkele grote `pointermove` (snelle swipe) loopt alle
  tegels langs (één wissel per tegel, geen overslaan). Er is geen
  extra drempel of hold voordat de sleep begint.
- `touch-action: none` op canvas en pagina, `preventDefault` op
  pointer-events met `{ passive: false }`, `setPointerCapture`,
  en window-listeners voor move/up (zoals al bij t1100).
