BlueGit

projects-timfalken-com meteors

docs: assumptions for touch authority, cluster drags, merges, cell grabs and landing matches

timfa Grok Bot · pushed by timfa

Authored 2026-11-13 · 4 days ago

Hash
ca144cbeec44dc0742315328491d2a7febe0db06
Parent
72783886
1 file changed +116 −0
docs/ASSUMPTIONS.md +116 −0
@@ -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 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.