feat(WhereUI): animate live location ranking overtakes

[kyleve]

Posted by an AI agent on the user’s behalf.

Summary

• User-facing: animate live reversals between the two primary Locations cards with a lift, passing arc, and stamp-like settle.
• User-facing: keep the fixed visibility-aware 500 ms gate, one coordinated light haptic, and a Reduce Motion emphasis.
• User-facing: add a DEBUG-only Ranking Animation Lab with repeatable Play Next Overtake behavior and session-only controls.
• Internal: move each complete card, including its Liquid Glass, paper, microprint, artwork, and calendar transition source.
• Internal: keep the hierarchy stable while cards cross, then commit the real ranked source order at the identical endpoint.
• Internal: sample current motion settings when the gate releases without restarting its delay.
• Internal: add durable Liquid Glass guidance from the regression history to the root, WhereUI, and SnapshotKitTesting agent instructions.

Why

Liquid Glass renders separately from ordinary SwiftUI content. Reordering the ForEach hierarchy at animation start caused the card material to swap instantly and the lower card to grow from zero on later plays.

Each ranked card now owns an independent one-effect container. A region-keyed layout moves the complete surfaces while the hierarchy stays stable. The model commits the true visual and accessibility order after the crossing finishes. New reports keep the active pass intact and queue only the latest delayed reconciliation.

Review focus

• Counts and rank motion still release through the fixed 500 ms visibility-aware gate.
• Resolution and Planned Stay sheets leave reconciliation pending while they cover the cards.
• A newer report restarts that gate without cancelling or snapping an active pass.
• Motion-setting changes do not restart the gate, and the release uses the newest setting.
• The settled source order always matches the visual and accessibility order.
• Reduce Motion commits the reorder immediately and keeps a brief opacity emphasis.
• Spatial overtakes can draw past scroll bounds without changing settled clipping.
• Production and the lab share the same presentation, delay, cancellation, feedback, and motion path.
• Card Designer persistence, exports, and Apply to App behavior are unchanged.

Testing

• Live simulator recording verified the second and third swaps at 60 fps with both cards full-size throughout.
• ./swiftformat --lint
• ./xcstrings --lint
• ./sf-symbols --lint
• ./test --no-generate --no-build WhereUITests — 477 tests passed
• ./test --no-generate --only 'WhereUITests/LocationCardsReconciliationModifierTests' — 3 tests passed
• Bumper Bowling architecture validation passed
• Full snapshot review — 47 tests passed during implementation
• Final targeted Locations and Ranking Animation Lab snapshot review passed; the lab matched byte for byte
• git diff --check

[kyleve]

Posted by an AI agent on the user’s behalf.

Review focus: this guard is load-bearing. A report change during one visible session updates only the typed reconciliation target, preserving the displayed pair through the 500 ms gate. Initial presentation, year changes, and returning from hidden state synchronize immediately and quietly instead.

[kyleve]

Posted by an AI agent on the user’s behalf.

Review focus: the compositing boundary is intentional. Liquid Glass and Canvas-backed microprint can otherwise remain independent render layers during the keyframe scale and rotation; flattening the complete card here keeps those layers registered while leaving the settled Locations snapshots unchanged.