From dc9471dfb434ae33a788ab27cbbeae94a2af10e4 Mon Sep 17 00:00:00 2001
From: Joshua <joshua@cnjmail.com>
Date: Sat, 26 Sep 2026 08:01:39 -0400
Subject: [PATCH] fix(panel): keep the party-board hint clear of the dock
MIME-Version: 1.0
Content-Type: text/plain; charset=UTF-8
Content-Transfer-Encoding: 8bit

The hint line is a <p> whose user-agent 1em top margin was never reset,
so at 1920x1080 its box rendered at ~954-988px, under the dock (top edge
950px). Reset the margin, restore the PANEL-SPEC §2 27px/600 size, and
move the hint up to top: 896px so its 37.8px line box ends at ~934px,
16px above the dock. The dock keeps its 84px height and 46px inset.

Add a source-level regression test asserting the hint's margin reset
and that top + font-size x line-height sits at least 12px above
1080 - dock bottom - dock height.

Co-Authored-By: Claude Opus 5.5 <noreply@anthropic.com>
---
 .../nestquest/www/nestquest-cards.js          |  5 ++--
 frontend/src/cards/party-board.ts             |  5 ++--
 tests/test_panel_cards.py                     | 30 +++++++++++++++++++
 3 files changed, 36 insertions(+), 4 deletions(-)

diff --git a/custom_components/nestquest/www/nestquest-cards.js b/custom_components/nestquest/www/nestquest-cards.js
index d67e35d..8f0296d 100644
--- a/custom_components/nestquest/www/nestquest-cards.js
+++ b/custom_components/nestquest/www/nestquest-cards.js
@@ -906,11 +906,12 @@ const $t = "polygon(0 0, 100% 0, 100% 62%, 50% 100%, 0 62%)", $e = "polygon(50%
 
   .hint {
     position: absolute;
-    top: 930px;
+    top: 896px;
     left: 0;
     right: 0;
+    margin: 0;
     font-family: var(--nq-p-font-body);
-    font-size: 24px;
+    font-size: 27px;
     font-weight: 600;
     line-height: 1.4;
     text-align: center;
diff --git a/frontend/src/cards/party-board.ts b/frontend/src/cards/party-board.ts
index 65c7925..0a7569b 100644
--- a/frontend/src/cards/party-board.ts
+++ b/frontend/src/cards/party-board.ts
@@ -497,11 +497,12 @@ const boardStyles = css`
 
   .hint {
     position: absolute;
-    top: 930px;
+    top: 896px;
     left: 0;
     right: 0;
+    margin: 0;
     font-family: var(--nq-p-font-body);
-    font-size: 24px;
+    font-size: 27px;
     font-weight: 600;
     line-height: 1.4;
     text-align: center;
diff --git a/tests/test_panel_cards.py b/tests/test_panel_cards.py
index 2b01162..2ef824f 100644
--- a/tests/test_panel_cards.py
+++ b/tests/test_panel_cards.py
@@ -411,6 +411,36 @@ def test_panel_hard_rules_hold_in_the_card_sources() -> None:
     assert "@click" not in sealed_template
 
 
+def test_party_board_hint_clears_the_dock() -> None:
+    """PANEL-SPEC §2/§2.3: the hint line reads fully above the dock at
+    1920x1080. The hint's line box (top + font-size x line-height) must
+    end above the dock's top edge (1080 - bottom inset - dock height)
+    with a visible gap, at the 27px/600 design size. The hint is a <p>,
+    so its user-agent 1em top margin must be reset or it shifts the box
+    down by a whole font-size."""
+    style = _style_literal(_read(PARTY_BOARD), STYLE_CONSTANTS[PARTY_BOARD])
+    rules = {selector.strip(): body for selector, body in _css_rules(style)}
+    sizes = _size_tokens(_read(REWARD_TOKENS))
+
+    def px(body: str, prop: str) -> float:
+        declared = re.search(rf"(?<![-\w]){prop}:\s*([^;]+);", body)
+        assert declared is not None, prop
+        value = _font_size_px(declared.group(1), sizes)
+        assert value is not None, f"{prop}: {declared.group(1)}"
+        return value
+
+    board, hint, dock = rules[".board"], rules[".hint"], rules[".dock"]
+    assert "margin: 0;" in hint
+    line_height = float(re.search(r"line-height:\s*([\d.]+);", hint).group(1))
+    hint_bottom = px(hint, "top") + px(hint, "font-size") * line_height
+    dock_top = px(board, "height") - px(dock, "bottom") - px(dock, "height")
+    assert px(dock, "height") == 84
+    assert px(dock, "bottom") == 46
+    assert hint_bottom + 12 <= dock_top, (hint_bottom, dock_top)
+    assert px(hint, "font-size") == 27
+    assert "font-weight: 600;" in hint
+
+
 def test_panel_text_sizes_respect_the_22px_floor() -> None:
     """PANEL-SPEC §1: no body text below 22px. Every font-size in the
     panel styles resolves against the panel size tokens or an explicit
-- 
2.55.0