refactor: extract apply_applet_toggle, rooms_for_user & natus helpers to utils; DRY toggle views

- epic/utils.py (new): _planet_house, _compute_distinctions, rooms_for_user
- applets/utils.py: apply_applet_toggle replaces 5 copy-pasted toggle loops
- dashboard/views.py: use apply_applet_toggle; fix double free_tokens/tithe_tokens query in wallet(); promote _compute_distinctions import to module level
- gameboard/views.py: use apply_applet_toggle & rooms_for_user; fix double free_tokens query in toggle_game_applets
- billboard/views.py: use apply_applet_toggle & rooms_for_user
- SCSS: %tt-token-fields placeholder in _tooltips.scss; _gameboard & _game-kit @extend it
- epic/tests/unit/test_utils.py (new): coverage for _planet_house fallback path

Co-Authored-By: Claude Sonnet 4.6 <noreply@anthropic.com>

src/apps/gameboard/views.py

@@ -1,12 +1,11 @@
 from django.contrib.auth.decorators import login_required
-from django.db.models import Q
 from django.http import HttpResponse
 from django.shortcuts import get_object_or_404, redirect, render
 from django.utils import timezone
 
-from apps.applets.utils import applet_context
-from apps.applets.models import Applet, UserApplet
-from apps.epic.models import DeckVariant, Room, RoomInvite
+from apps.applets.utils import applet_context, apply_applet_toggle
+from apps.epic.models import DeckVariant, Room
+from apps.epic.utils import rooms_for_user
 from apps.lyric.models import Token
 
 
@@ -37,24 +36,18 @@ def gameboard(request):
             "free_count": len(free_tokens),
             "applets": applet_context(request.user, "gameboard"),
             "page_class": "page-gameboard",
-            "my_games": Room.objects.filter(
-                Q(owner=request.user) |
-                Q(gate_slots__gamer=request.user) |
-                Q(invites__invitee_email=request.user.email, invites__status=RoomInvite.PENDING)
-            ).distinct(),
+            "my_games": rooms_for_user(request.user),
         }
     )
 
 @login_required(login_url="/")
 def toggle_game_applets(request):
     checked = request.POST.getlist("applets")
-    for applet in Applet.objects.filter(context="gameboard"):
-        UserApplet.objects.update_or_create(
-            user=request.user,
-            applet=applet,
-            defaults={"visible": applet.slug in checked},
-        )
+    apply_applet_toggle(request.user, "gameboard", checked)
     if request.headers.get("HX-Request"):
+        free_tokens = list(request.user.tokens.filter(
+            token_type=Token.FREE, expires_at__gt=timezone.now()
+        ).order_by("expires_at"))
         return render(request, "apps/gameboard/_partials/_applets.html", {
             "applets": applet_context(request.user, "gameboard"),
             "pass_token": request.user.tokens.filter(token_type=Token.PASS).first() if request.user.is_staff else None,
@@ -63,17 +56,9 @@ def toggle_game_applets(request):
             "equipped_trinket_id": request.user.equipped_trinket_id,
             "equipped_deck_id": request.user.equipped_deck_id,
             "deck_variants": list(request.user.unlocked_decks.all()),
-            "free_tokens": list(request.user.tokens.filter(
-                token_type=Token.FREE, expires_at__gt=timezone.now()
-            ).order_by("expires_at")),
-            "free_count": request.user.tokens.filter(
-                token_type=Token.FREE, expires_at__gt=timezone.now()
-            ).count(),
-            "my_games": Room.objects.filter(
-                Q(owner=request.user) |
-                Q(gate_slots__gamer=request.user) |
-                Q(invites__invitee_email=request.user.email, invites__status=RoomInvite.PENDING)
-            ).distinct(),
+            "free_tokens": free_tokens,
+            "free_count": len(free_tokens),
+            "my_games": rooms_for_user(request.user),
         })
     return redirect("gameboard")
 
@@ -154,12 +139,7 @@ def game_kit(request):
 @login_required(login_url="/")
 def toggle_game_kit_sections(request):
     checked = request.POST.getlist("applets")
-    for applet in Applet.objects.filter(context="game-kit"):
-        UserApplet.objects.update_or_create(
-            user=request.user,
-            applet=applet,
-            defaults={"visible": applet.slug in checked},
-        )
+    apply_applet_toggle(request.user, "game-kit", checked)
     if request.headers.get("HX-Request"):
         return render(request, "apps/gameboard/_partials/_game_kit_sections.html",
                       _game_kit_context(request.user))