docs: assumptions for touch authority, cluster drags, merges, cell grabs and landing matches
@@ -318,3 +318,119 @@ Aanname:
318
318
dus op de planeetkiezer, in de HUD en in de lobby. 0 % miss is 100 %
319
319
Power; Aurel 0 %, Terra 44 %, Cinder 92 %.
320
320
321
322
## t1106 — touch is leidend bij een echte aanraking
323
324
- De Playwright-tests van t1104 waren circulair: ze rekenden `field_to_client`
325
met dezelfde CSS-rectformule als `fieldFromEvent`, dus ze konden de bug
326
op Tims echte telefoon niet reproduceren. Onderzoek met CDP-touch op
327
emulated Android (DPR 2,625/3), live site, URL-balk-resize, pointercancel
328
en vallende kolommen liet zien dat correcte CSS-coördinaten wél 1:1
329
blijven. De echte fout zat in de gebeurtenissen zelf.
330
- Op mobiel kan `PointerEvent.clientX/Y` tijdens een touch verkeerd zijn
331
(onder andere bij een gezoomde visual viewport), terwijl
332
`TouchEvent.changedTouches` de juiste plek houdt. Een reeks
333
`pointermove`s die naar een ander veld-Y interpoleren, liep daardoor de
334
hele kolom af — precies “één vakje slepen, blokje helemaal naar boven
335
of beneden”.
336
- Aanvullend: `preventDefault` op een PointerEvent houdt op veel mobiele
337
browsers het touch-scrollen niet tegen (daarvoor is een niet-passieve
338
`touchmove` nodig). `setPointerCapture` eindigt daar vaak in
339
`pointercancel`. `layout()` draaide elke frame en kon het canvas
340
midden in een sleep verplaatsen (URL-balk).
341
- Oplossing: zolang een echte `touchstart` is binnengekomen
342
(`app.activeTouchId`), zijn Touch Events leidend. `pointermove` /
343
`pointerup` / `pointercancel` worden dan genegeerd. Als er geen
344
TouchEvent komt (pointer-only touch, zoals sommige Playwright-paden),
345
blijven de pointer-events gewoon werken. Document-listeners voor
346
touch staan tijdens het spel op `{capture:true, passive:false}` en
347
roepen `preventDefault` aan. Geen `setPointerCapture`. `pointercancel`
348
en `touchcancel` beëindigen de sleep zonder lancering. `layout()`
349
bevriest zolang er een sleep loopt en `layoutIfNeeded` slaat over als
350
de viewport niet veranderde. Canvas heeft `touch-action:none` en
351
`position:fixed`; `html,body` hebben `overscroll-behavior: none`.
352
- Debug: `?debug=drag` of `localStorage.meteors-debug-drag=1` toont een
353
overlay (`#drag-debug`) met fase, event, bron, fieldY, doelrij, blockY,
354
launch-intent, touchId en pointerId.
355
- Regressietest: vergiftigde `pointermove`s naar fieldY 9,5 plus
356
correcte `touchmove`s naar 1,5 laten het blokje op y=1 staan, niet
357
op de top. Die test faalde op het oude pointer-only pad.
358
359
## t1107 — slepen onder een vliegende cluster en door een gelande
360
361
- `isColumnStill` blijft streng (false zodra er iets vliegt, valt of
362
settlet in de kolom). Alleen het sleep-pad gebruikt
363
`columnAllowsDrag` (`!isColumnLocked`) en `isDraggableBlock`.
364
- Blokjes die stil of settlend op de grond staan, zijn sleepbaar, ook
365
als er in dezelfde kolom een vliegende cluster boven hangt. De
366
vliegende cluster zelf is niet sleepbaar: in Meteos speel je op de
367
grond, raketten in de lucht herschik je niet.
368
- Een gelande cluster (fase `landed`: grijze raketblokjes en gekoppeld
369
cargo, state SETTLING) is wél sleepbaar, zolang de kolom een
370
aaneengesloten stapel is (geen gat). `swapToward` stopt bij een gat.
371
Hangende leden (SETTLING telt als grounded) horen bij de stapel-top.
372
- Van plaats wisselen *binnen* dezelfde gelande cluster verandert alleen
373
de posities. Een blokje *uit* de cluster wisselen haalt het eruit:
374
een grijs blokje blijft settlen op zijn eigen resterende timer en
375
recolored alleen; gekleurd cargo wordt STILL als het steun heeft,
376
anders FALLING. Een blokje *in* de cluster wisselen krijgt dat
377
`clusterId`, wordt SETTLING en `flame` uit. Een grijs blokje dat
378
instapt met `settleTime` 0 kan de groeps-release vertragen tot zijn
379
eigen 3 s om is. Lidmaatschap wordt pas ná de join van de ander
380
gewist, zodat `leaveCluster` een nog niet-lege cluster niet verwijdert.
381
- `startManualLaunch` roept eerst `leaveCluster` aan, zodat een gooien
382
vanuit een gelande groep het blokje losmaakt.
383
384
## t1108 — een gegooid blokje botst met vallende blokjes
385
386
- Een handmatig omhoog gegooid blokje (state MANUAL) botst met vallende
387
blokjes op dezelfde manier als twee vliegende clusters: ze smelten
388
samen tot één vliegende cluster. Snelheid, vertraging en spronghoogte
389
zijn het massagemiddelde per blokje (zelfde regel als
390
`mergeClusterGroup`). Een stapel aaneengesloten vallende blokjes
391
gaat in één keer mee.
392
- Ze kunnen elkaar in één substep niet kruisen: zowel `integrateManual`
393
als `integrateFalling` kijken naar het hele pad van die stap
394
(swept overlap) en mergen vóór de posities elkaar passeren.
395
`packClusterOverlaps` legt ze naast elkaar.
396
- De cluster krijgt `fromManual: true`. Vallend cargo dat daarna op
397
zo'n cluster landt, wordt óók middeled (niet alleen “meegepakt” met
398
de clustersnelheid). Gewone match-raketten houden de oude regel:
399
cargo neemt `cluster.vy` over, zonder middelen. Dat pad is
400
onveranderd.
401
- De spronghoogte van de worp wordt bij lancering bewaard als
402
`manualJumpHeight`, zodat de merge die kan middelen.
403
404
## t1109 — pakken per rooster-cel, niet per sprite
405
406
- Hit-testing keek naar de afstand tot de simulatie-rechthoek van het
407
blokje, met een drempel. Visueel staan sprites vaak iets naar binnen
408
(padding, bounce, scale, tween), en de speler moest precies op de
409
getekende sprite drukken.
410
- Nu: de druk wordt een cel `floor(col)`, `floor(y)`. Elke druk binnen
411
die cel — hoeken, kieren tussen sprites, een visueel verschoven
412
sprite — pakt het blokje dat die cel inneemt. Dat gebruikt
413
simulatiecellen, niet de getekende bounds (tweens blijven view-only).
414
- Staat er geen blokje in die cel (midden in een animatie, y niet
415
geheel), dan de dichtstbijzijnde sleepbare in dezelfde kolom binnen
416
een halve tegel (`SNAP_Y = 0,5`). Alleen als de primaire cel leeg is
417
en de druk dicht bij de rand zit, geldt nog een kleine horizontale
418
slop naar de buurkolom. Lanceren-door-optrekken blijft.
419
420
## t1110 — match na landing van een cluster, en grotere vlammen
421
422
- Als een vliegende cluster landt en samen met al liggende blokjes een
423
geldige rij vormt (3 of meer dezelfde kleur, horizontaal of
424
verticaal), telt dat als een match en worden het raketten.
425
- Aanname: grijze raketblokjes hebben geen kleur en doen niet mee aan
426
een match zolang ze grijs zijn. Gekleurd cargo in de gelande cluster
427
(SETTLING) is wél matchbaar, meteen bij de landing, ook in een
428
gemengde rij met al stilliggende blokjes. Zodra de grijze blokjes
429
recoloren en de groep wordt losgelaten, geldt hetzelfde voor die
430
nieuwe kleuren: een gemengde rij met rustende buren lanceert in
431
dezelfde tick.
432
- `findMatchLines` neemt daarom STILL én SETTLING mee, zolang
433
`color >= 0`. Grijze SETTLING (geen kleur) blijft uitgesloten.
434
- De vlam onder raketten is 3× zo groot, in lengte én breedte
435
(`0,85 × 3` tegels). De bovenkant van de vlam blijft op dezelfde
436
overlap in het blokje; de extra lengte steekt naar beneden uit.
@@ -318,3 +318,119 @@ Aanname:318
dus op de planeetkiezer, in de HUD en in de lobby. 0 % miss is 100 %318
dus op de planeetkiezer, in de HUD en in de lobby. 0 % miss is 100 %319
Power; Aurel 0 %, Terra 44 %, Cinder 92 %.319
Power; Aurel 0 %, Terra 44 %, Cinder 92 %.320
320
321
322
## t1106 — touch is leidend bij een echte aanraking323
324
- De Playwright-tests van t1104 waren circulair: ze rekenden `field_to_client`325
met dezelfde CSS-rectformule als `fieldFromEvent`, dus ze konden de bug326
op Tims echte telefoon niet reproduceren. Onderzoek met CDP-touch op327
emulated Android (DPR 2,625/3), live site, URL-balk-resize, pointercancel328
en vallende kolommen liet zien dat correcte CSS-coördinaten wél 1:1329
blijven. De echte fout zat in de gebeurtenissen zelf.330
- Op mobiel kan `PointerEvent.clientX/Y` tijdens een touch verkeerd zijn331
(onder andere bij een gezoomde visual viewport), terwijl332
`TouchEvent.changedTouches` de juiste plek houdt. Een reeks333
`pointermove`s die naar een ander veld-Y interpoleren, liep daardoor de334
hele kolom af — precies “één vakje slepen, blokje helemaal naar boven335
of beneden”.336
- Aanvullend: `preventDefault` op een PointerEvent houdt op veel mobiele337
browsers het touch-scrollen niet tegen (daarvoor is een niet-passieve338
`touchmove` nodig). `setPointerCapture` eindigt daar vaak in339
`pointercancel`. `layout()` draaide elke frame en kon het canvas340
midden in een sleep verplaatsen (URL-balk).341
- Oplossing: zolang een echte `touchstart` is binnengekomen342
(`app.activeTouchId`), zijn Touch Events leidend. `pointermove` /343
`pointerup` / `pointercancel` worden dan genegeerd. Als er geen344
TouchEvent komt (pointer-only touch, zoals sommige Playwright-paden),345
blijven de pointer-events gewoon werken. Document-listeners voor346
touch staan tijdens het spel op `{capture:true, passive:false}` en347
roepen `preventDefault` aan. Geen `setPointerCapture`. `pointercancel`348
en `touchcancel` beëindigen de sleep zonder lancering. `layout()`349
bevriest zolang er een sleep loopt en `layoutIfNeeded` slaat over als350
de viewport niet veranderde. Canvas heeft `touch-action:none` en351
`position:fixed`; `html,body` hebben `overscroll-behavior: none`.352
- Debug: `?debug=drag` of `localStorage.meteors-debug-drag=1` toont een353
overlay (`#drag-debug`) met fase, event, bron, fieldY, doelrij, blockY,354
launch-intent, touchId en pointerId.355
- Regressietest: vergiftigde `pointermove`s naar fieldY 9,5 plus356
correcte `touchmove`s naar 1,5 laten het blokje op y=1 staan, niet357
op de top. Die test faalde op het oude pointer-only pad.358
359
## t1107 — slepen onder een vliegende cluster en door een gelande360
361
- `isColumnStill` blijft streng (false zodra er iets vliegt, valt of362
settlet in de kolom). Alleen het sleep-pad gebruikt363
`columnAllowsDrag` (`!isColumnLocked`) en `isDraggableBlock`.364
- Blokjes die stil of settlend op de grond staan, zijn sleepbaar, ook365
als er in dezelfde kolom een vliegende cluster boven hangt. De366
vliegende cluster zelf is niet sleepbaar: in Meteos speel je op de367
grond, raketten in de lucht herschik je niet.368
- Een gelande cluster (fase `landed`: grijze raketblokjes en gekoppeld369
cargo, state SETTLING) is wél sleepbaar, zolang de kolom een370
aaneengesloten stapel is (geen gat). `swapToward` stopt bij een gat.371
Hangende leden (SETTLING telt als grounded) horen bij de stapel-top.372
- Van plaats wisselen *binnen* dezelfde gelande cluster verandert alleen373
de posities. Een blokje *uit* de cluster wisselen haalt het eruit:374
een grijs blokje blijft settlen op zijn eigen resterende timer en375
recolored alleen; gekleurd cargo wordt STILL als het steun heeft,376
anders FALLING. Een blokje *in* de cluster wisselen krijgt dat377
`clusterId`, wordt SETTLING en `flame` uit. Een grijs blokje dat378
instapt met `settleTime` 0 kan de groeps-release vertragen tot zijn379
eigen 3 s om is. Lidmaatschap wordt pas ná de join van de ander380
gewist, zodat `leaveCluster` een nog niet-lege cluster niet verwijdert.381
- `startManualLaunch` roept eerst `leaveCluster` aan, zodat een gooien382
vanuit een gelande groep het blokje losmaakt.383
384
## t1108 — een gegooid blokje botst met vallende blokjes385
386
- Een handmatig omhoog gegooid blokje (state MANUAL) botst met vallende387
blokjes op dezelfde manier als twee vliegende clusters: ze smelten388
samen tot één vliegende cluster. Snelheid, vertraging en spronghoogte389
zijn het massagemiddelde per blokje (zelfde regel als390
`mergeClusterGroup`). Een stapel aaneengesloten vallende blokjes391
gaat in één keer mee.392
- Ze kunnen elkaar in één substep niet kruisen: zowel `integrateManual`393
als `integrateFalling` kijken naar het hele pad van die stap394
(swept overlap) en mergen vóór de posities elkaar passeren.395
`packClusterOverlaps` legt ze naast elkaar.396
- De cluster krijgt `fromManual: true`. Vallend cargo dat daarna op397
zo'n cluster landt, wordt óók middeled (niet alleen “meegepakt” met398
de clustersnelheid). Gewone match-raketten houden de oude regel:399
cargo neemt `cluster.vy` over, zonder middelen. Dat pad is400
onveranderd.401
- De spronghoogte van de worp wordt bij lancering bewaard als402
`manualJumpHeight`, zodat de merge die kan middelen.403
404
## t1109 — pakken per rooster-cel, niet per sprite405
406
- Hit-testing keek naar de afstand tot de simulatie-rechthoek van het407
blokje, met een drempel. Visueel staan sprites vaak iets naar binnen408
(padding, bounce, scale, tween), en de speler moest precies op de409
getekende sprite drukken.410
- Nu: de druk wordt een cel `floor(col)`, `floor(y)`. Elke druk binnen411
die cel — hoeken, kieren tussen sprites, een visueel verschoven412
sprite — pakt het blokje dat die cel inneemt. Dat gebruikt413
simulatiecellen, niet de getekende bounds (tweens blijven view-only).414
- Staat er geen blokje in die cel (midden in een animatie, y niet415
geheel), dan de dichtstbijzijnde sleepbare in dezelfde kolom binnen416
een halve tegel (`SNAP_Y = 0,5`). Alleen als de primaire cel leeg is417
en de druk dicht bij de rand zit, geldt nog een kleine horizontale418
slop naar de buurkolom. Lanceren-door-optrekken blijft.419
420
## t1110 — match na landing van een cluster, en grotere vlammen421
422
- Als een vliegende cluster landt en samen met al liggende blokjes een423
geldige rij vormt (3 of meer dezelfde kleur, horizontaal of424
verticaal), telt dat als een match en worden het raketten.425
- Aanname: grijze raketblokjes hebben geen kleur en doen niet mee aan426
een match zolang ze grijs zijn. Gekleurd cargo in de gelande cluster427
(SETTLING) is wél matchbaar, meteen bij de landing, ook in een428
gemengde rij met al stilliggende blokjes. Zodra de grijze blokjes429
recoloren en de groep wordt losgelaten, geldt hetzelfde voor die430
nieuwe kleuren: een gemengde rij met rustende buren lanceert in431
dezelfde tick.432
- `findMatchLines` neemt daarom STILL én SETTLING mee, zolang433
`color >= 0`. Grijze SETTLING (geen kleur) blijft uitgesloten.434
- De vlam onder raketten is 3× zo groot, in lengte én breedte435
(`0,85 × 3` tegels). De bovenkant van de vlam blijft op dezelfde436
overlap in het blokje; de extra lengte steekt naar beneden uit.