mirror of
https://github.com/AmanTahiliani/box-box.git
synced 2026-08-08 12:07:23 -04:00
Compare commits
49 Commits
5408a45bbd
...
feat/issue
| Author | SHA1 | Date | |
|---|---|---|---|
|
|
e8de2068c1 | ||
|
|
1782fd313c | ||
|
|
be7eb3c034 | ||
|
|
71523641ad | ||
|
|
e51cabba62 | ||
|
|
fc6fc36d8f | ||
|
|
16d82afad5 | ||
|
|
91199ff5c0 | ||
|
|
144e93ee44 | ||
|
|
f4f5071e26 | ||
|
|
a1d71900d1 | ||
|
|
34b060238a | ||
|
|
a9920f0dd4 | ||
|
|
7c8a75f7ca | ||
|
|
e0174f7bf1 | ||
|
|
2d6fa531f2 | ||
|
|
8fd358748d | ||
|
|
b0fd252096 | ||
|
|
ad379e0f07 | ||
|
|
9ee14e5c89 | ||
|
|
cc4337be88 | ||
|
|
addfd6d24d | ||
|
|
b5d070e116 | ||
|
|
233eefaf12 | ||
|
|
51b0238b09 | ||
|
|
24bcac8038 | ||
|
|
93ac0ccebb | ||
|
|
66bf649729 | ||
|
|
2ddc930efe | ||
|
|
7d0b25b66e | ||
|
|
bc18a20829 | ||
|
|
2795ccf11b | ||
|
|
4813b958a0 | ||
|
|
a97e3caa4f | ||
|
|
655df9845b | ||
|
|
2d49a8bd00 | ||
|
|
4e62e93ea2 | ||
|
|
eacd5f26e9 | ||
|
|
ba7f653e3c | ||
|
|
f2bf1fd0fc | ||
|
|
6c72c12821 | ||
|
|
98126a06f9 | ||
|
|
47f0cd6d12 | ||
|
|
26642e3ff6 | ||
|
|
0977861806 | ||
|
|
c5a7ad51eb | ||
|
|
75ca5f4deb | ||
|
|
094620fa08 | ||
|
|
7263949260 |
58
.agents/README.md
Normal file
58
.agents/README.md
Normal file
@@ -0,0 +1,58 @@
|
|||||||
|
# `.agents/` — harness-agnostic agentic dev toolkit
|
||||||
|
|
||||||
|
Portable skills, prompts, and scripts that drive the box-box development lifecycle.
|
||||||
|
Any harness (Claude, Codex, opencode, …) can read these — the canonical workflows
|
||||||
|
live here, not in a tool-specific folder. The shared project context every harness
|
||||||
|
reads is `AGENTS.md` (→ `CLAUDE.md`).
|
||||||
|
|
||||||
|
## Layout
|
||||||
|
|
||||||
|
```
|
||||||
|
skills/ Codex/open agent skills: groom, write-spec, implement, review, lenses
|
||||||
|
personas/ grill.md (base) + lens overlays (architect, …) — the interrogation voices
|
||||||
|
prompts/ ready-spec.md (groomed spec), implement.md/review.md dispatch prompts
|
||||||
|
lib/gh.sh GitHub issue + Project (#2) state helpers: issue_*, set_stage/effort/priority
|
||||||
|
lib/dispatch.sh dispatch(): Ready issue → worktree → harness → gate → PR
|
||||||
|
harnesses.sh headless adapters (one fn per harness) + run_gate — the ONLY tool-specific code
|
||||||
|
bin/dev CLI: `dev implement <issue#> --harness <name> [--dry-run]`
|
||||||
|
```
|
||||||
|
|
||||||
|
## The lifecycle
|
||||||
|
|
||||||
|
`Icebox → Research → Ready → In Progress → In Review → Done` (the Project `Stage` field).
|
||||||
|
|
||||||
|
- **Groom** (interactive, Claude): `/groom <issue#>` runs a seeded grill-me → writes a
|
||||||
|
Ready spec into the issue body → sets Effort/Priority → leaves Stage at `Research`.
|
||||||
|
You review and flip to `Ready`.
|
||||||
|
- **Implement** (recommended harnesses: `codex` or `cursor`): `.agents/bin/dev implement <issue#> --harness <name>`
|
||||||
|
(or `/implement …` in Claude to supervise) → isolated worktree → runs the harness
|
||||||
|
headless on the spec → build gate → opens a PR → sets Stage `In Review`.
|
||||||
|
- **Review + merge**: use the `review` skill from a harness different from the
|
||||||
|
implementer to create a local review packet and PR comment, then you merge.
|
||||||
|
|
||||||
|
## Skills and harnesses
|
||||||
|
|
||||||
|
`.agents/skills` is the canonical home for reusable workflows. Codex discovers
|
||||||
|
repo skills from that path directly, and Claude can use the same files through
|
||||||
|
`.claude/skills -> ../.agents/skills`. Other harnesses can read the same
|
||||||
|
`SKILL.md` files explicitly or enter the workflow through `.agents/bin/dev`.
|
||||||
|
Do not put canonical workflow instructions under `.claude/`; that directory is
|
||||||
|
local adapter state.
|
||||||
|
|
||||||
|
## Adding / fixing a harness
|
||||||
|
|
||||||
|
Edit one function in `harnesses.sh`: `harness_<name> <workdir> <promptfile>`, running the
|
||||||
|
tool non-interactively in `<workdir>` on the prompt. For current implementation
|
||||||
|
dispatch, prefer `codex` or `cursor`; `claude` and `opencode` remain available, and
|
||||||
|
`pi` still needs flag verification before trusting.
|
||||||
|
|
||||||
|
`agy` / Antigravity is deliberately disabled for non-dry-run dispatch as of
|
||||||
|
2026-07-04. Phase 1 testing found the headless path unreliable: with
|
||||||
|
`--new-project` it ignored the prompt and tried to scaffold, while without it the CLI
|
||||||
|
could resume a stale conversation and hang past the print timeout. Keep using
|
||||||
|
`.agents/bin/dev implement <issue#> --harness agy --dry-run` for prompt inspection
|
||||||
|
only; real dispatch should use `codex` or `cursor` until a fresh Antigravity
|
||||||
|
headless invocation is verified and documented.
|
||||||
|
|
||||||
|
Always `--dry-run` a new harness first: it renders the exact prompt and plan, touching
|
||||||
|
nothing (no worktree, PR, or state change).
|
||||||
45
.agents/bin/dev
Executable file
45
.agents/bin/dev
Executable file
@@ -0,0 +1,45 @@
|
|||||||
|
#!/usr/bin/env bash
|
||||||
|
# .agents/bin/dev — box-box agentic dev CLI. Works from any harness's shell.
|
||||||
|
#
|
||||||
|
# dev implement <issue#> --harness <codex|cursor|claude|opencode|pi|agy> [--dry-run] [--base <branch>]
|
||||||
|
#
|
||||||
|
# Grooming is driven interactively via the Claude Code /groom skill; this CLI covers
|
||||||
|
# the implement lane (dispatch a Ready issue to a harness → worktree → gate → PR).
|
||||||
|
|
||||||
|
set -o pipefail
|
||||||
|
ROOT="$(cd "$(dirname "${BASH_SOURCE[0]:-$0}")/../.." && pwd)"
|
||||||
|
|
||||||
|
usage() {
|
||||||
|
cat >&2 <<EOF
|
||||||
|
box-box dev CLI
|
||||||
|
|
||||||
|
dev implement <issue#> --harness <name> [--dry-run] [--base <branch>]
|
||||||
|
|
||||||
|
harnesses: codex, cursor (recommended) · claude, opencode (available) · agy (dry-run only, disabled for dispatch) · pi (verify flags)
|
||||||
|
--dry-run render the prompt + plan, touch nothing (no worktree/PR/state change)
|
||||||
|
--base base branch for the worktree/PR (default: main)
|
||||||
|
EOF
|
||||||
|
exit 2
|
||||||
|
}
|
||||||
|
|
||||||
|
cmd="${1:-}"; shift 2>/dev/null || true
|
||||||
|
case "$cmd" in
|
||||||
|
implement)
|
||||||
|
issue="${1:-}"; shift 2>/dev/null || true
|
||||||
|
harness=""; passthru=()
|
||||||
|
while [ $# -gt 0 ]; do
|
||||||
|
case "$1" in
|
||||||
|
--harness) harness="${2:-}"; shift 2 ;;
|
||||||
|
--dry-run) passthru+=(--dry-run); shift ;;
|
||||||
|
--base) passthru+=(--base "${2:-}"); shift 2 ;;
|
||||||
|
*) echo "unknown arg: $1" >&2; usage ;;
|
||||||
|
esac
|
||||||
|
done
|
||||||
|
[ -n "$issue" ] && [ -n "$harness" ] || usage
|
||||||
|
# shellcheck source=/dev/null
|
||||||
|
source "$ROOT/.agents/lib/dispatch.sh"
|
||||||
|
dispatch "$issue" "$harness" ${passthru[@]+"${passthru[@]}"}
|
||||||
|
;;
|
||||||
|
""|-h|--help|help) usage ;;
|
||||||
|
*) echo "unknown command: $cmd" >&2; usage ;;
|
||||||
|
esac
|
||||||
71
.agents/harnesses.sh
Normal file
71
.agents/harnesses.sh
Normal file
@@ -0,0 +1,71 @@
|
|||||||
|
#!/usr/bin/env bash
|
||||||
|
# .agents/harnesses.sh — headless harness adapters.
|
||||||
|
#
|
||||||
|
# ONE function per harness: harness_<name> <workdir> <promptfile>
|
||||||
|
# Each runs the harness NON-INTERACTIVELY inside <workdir>, feeding it the rendered
|
||||||
|
# prompt, expected to edit files (and ideally commit). This is the ONLY harness-specific
|
||||||
|
# code in the toolkit — tune the exact flags here per tool/version.
|
||||||
|
#
|
||||||
|
# Autonomy note: these run unattended, so each uses the tool's "just do it" mode
|
||||||
|
# (accept edits / full-auto). Only run harnesses you trust on code you can review via PR.
|
||||||
|
|
||||||
|
# ---- MUST-HAVE ----
|
||||||
|
|
||||||
|
harness_disabled_reason() { # <name> -> reason on stdout; 0 means disabled
|
||||||
|
case "$1" in
|
||||||
|
agy)
|
||||||
|
cat <<'EOF'
|
||||||
|
agy is disabled for implementation dispatch as of 2026-07-04: Antigravity headless mode was observed to ignore prompts with --new-project, resume stale conversations without it, and hang past print timeouts. Use codex or cursor until a fresh headless invocation is verified.
|
||||||
|
EOF
|
||||||
|
return 0
|
||||||
|
;;
|
||||||
|
*) return 1 ;;
|
||||||
|
esac
|
||||||
|
}
|
||||||
|
|
||||||
|
harness_claude() { # Claude Code — print mode, auto-accept edits
|
||||||
|
local dir="$1" prompt="$2"
|
||||||
|
( cd "$dir" && claude -p "$(cat "$prompt")" --permission-mode acceptEdits )
|
||||||
|
}
|
||||||
|
|
||||||
|
harness_codex() { # OpenAI Codex CLI — non-interactive exec, full auto
|
||||||
|
local dir="$1" prompt="$2"
|
||||||
|
( cd "$dir" && codex exec --full-auto "$(cat "$prompt")" )
|
||||||
|
}
|
||||||
|
|
||||||
|
harness_opencode() { # opencode — non-interactive run
|
||||||
|
local dir="$1" prompt="$2"
|
||||||
|
( cd "$dir" && opencode run "$(cat "$prompt")" )
|
||||||
|
}
|
||||||
|
|
||||||
|
harness_cursor() { # Cursor CLI agent — composer-2.5, headless full-auto
|
||||||
|
local dir="$1" prompt="$2"
|
||||||
|
( cd "$dir" && cursor-agent -p "$(cat "$prompt")" --model composer-2.5 --force --trust )
|
||||||
|
}
|
||||||
|
|
||||||
|
harness_agy() { # Antigravity CLI — disabled until headless is verified
|
||||||
|
local reason
|
||||||
|
reason="$(harness_disabled_reason agy)"
|
||||||
|
echo "harness_agy: $reason" >&2
|
||||||
|
return 2
|
||||||
|
}
|
||||||
|
|
||||||
|
# ---- NICE-TO-HAVE (verify the exact invocation for your version before trusting) ----
|
||||||
|
|
||||||
|
harness_pi() { # pi — CONFIRM headless CLI + flags
|
||||||
|
local dir="$1" prompt="$2"
|
||||||
|
( cd "$dir" && pi run "$(cat "$prompt")" ) # placeholder — verify
|
||||||
|
}
|
||||||
|
|
||||||
|
# ---- build/typecheck gate (fast, local) ----
|
||||||
|
# Returns non-zero on failure. This is a smoke gate — CI runs the full suite. Tune freely.
|
||||||
|
run_gate() {
|
||||||
|
local dir="$1"
|
||||||
|
( cd "$dir" && go build ./... ) || return 1
|
||||||
|
if [ -d "$dir/frontend/node_modules" ]; then
|
||||||
|
( cd "$dir/frontend" && npx tsc --noEmit ) || return 1
|
||||||
|
else
|
||||||
|
echo " (gate: frontend deps absent in worktree — tsc/vitest deferred to CI)" >&2
|
||||||
|
fi
|
||||||
|
return 0
|
||||||
|
}
|
||||||
130
.agents/lib/dispatch.sh
Normal file
130
.agents/lib/dispatch.sh
Normal file
@@ -0,0 +1,130 @@
|
|||||||
|
#!/usr/bin/env bash
|
||||||
|
# .agents/lib/dispatch.sh — implement a Ready issue with a chosen harness in an
|
||||||
|
# isolated git worktree, run the build gate, and open a PR.
|
||||||
|
#
|
||||||
|
# Source it, then: dispatch <issue#> <harness> [--dry-run] [--base <branch>]
|
||||||
|
# (or use the CLI: .agents/bin/dev implement <issue#> --harness <name> [--dry-run])
|
||||||
|
|
||||||
|
_AGENTS_DIR="$(cd "$(dirname "${BASH_SOURCE[0]}")/.." && pwd)"
|
||||||
|
# shellcheck source=/dev/null
|
||||||
|
source "$_AGENTS_DIR/lib/gh.sh"
|
||||||
|
# shellcheck source=/dev/null
|
||||||
|
source "$_AGENTS_DIR/harnesses.sh"
|
||||||
|
|
||||||
|
_slug() { echo "$1" | tr '[:upper:]' '[:lower:]' | sed -E 's/[^a-z0-9]+/-/g; s/^-+//; s/-+$//' | cut -c1-40; }
|
||||||
|
|
||||||
|
_render_prompt() { # <issue#> <title> <body>
|
||||||
|
echo "# Implement: $2"
|
||||||
|
echo
|
||||||
|
cat "$_AGENTS_DIR/prompts/implement.md"
|
||||||
|
echo; echo "---"; echo
|
||||||
|
echo "## Spec — issue #$1"
|
||||||
|
echo
|
||||||
|
echo "$3"
|
||||||
|
}
|
||||||
|
|
||||||
|
_pr_body() { # <issue#> <harness> <gate>
|
||||||
|
cat <<EOF
|
||||||
|
Implements #$1.
|
||||||
|
|
||||||
|
- **Harness:** $2 (dispatched via \`.agents/bin/dev\`)
|
||||||
|
- **Local gate** (\`go build\` + \`tsc --noEmit\`): **$3**
|
||||||
|
- Full test suite + independent review run in CI / by a reviewer harness.
|
||||||
|
|
||||||
|
See #$1 for the groomed spec, Test Plan, and Definition of Done.
|
||||||
|
|
||||||
|
Closes #$1
|
||||||
|
EOF
|
||||||
|
}
|
||||||
|
|
||||||
|
dispatch() { # <issue#> <harness> [--dry-run] [--base <branch>]
|
||||||
|
local issue="$1" harness="$2"; shift 2 || { echo "usage: dispatch <issue#> <harness> [--dry-run] [--base <branch>]"; return 2; }
|
||||||
|
local dry=0 base="main"
|
||||||
|
while [ $# -gt 0 ]; do
|
||||||
|
case "$1" in
|
||||||
|
--dry-run) dry=1 ;;
|
||||||
|
--base) base="$2"; shift ;;
|
||||||
|
*) echo "dispatch: unknown flag '$1'" >&2; return 2 ;;
|
||||||
|
esac; shift
|
||||||
|
done
|
||||||
|
|
||||||
|
# adapter must exist
|
||||||
|
if ! declare -f "harness_$harness" >/dev/null 2>&1; then
|
||||||
|
echo "no adapter for harness '$harness' — add harness_$harness() to .agents/harnesses.sh" >&2; return 2
|
||||||
|
fi
|
||||||
|
if [ "$dry" != 1 ] && declare -f harness_disabled_reason >/dev/null 2>&1; then
|
||||||
|
local disabled_reason
|
||||||
|
if disabled_reason="$(harness_disabled_reason "$harness")"; then
|
||||||
|
echo "harness '$harness' is disabled for non-dry-run dispatch." >&2
|
||||||
|
echo " $disabled_reason" >&2
|
||||||
|
echo " Use --dry-run for prompt inspection, or dispatch with --harness codex/cursor." >&2
|
||||||
|
return 2
|
||||||
|
fi
|
||||||
|
fi
|
||||||
|
|
||||||
|
local repo_root title body slug branch wt prompt
|
||||||
|
repo_root="$(git rev-parse --show-toplevel)" || return 1
|
||||||
|
title="$(issue_title "$issue")" || { echo "issue #$issue not found on $REPO" >&2; return 1; }
|
||||||
|
body="$(issue_body "$issue")"
|
||||||
|
slug="$(_slug "$title")"
|
||||||
|
branch="feat/issue-${issue}-${slug}"
|
||||||
|
wt="$repo_root/.worktrees/issue-${issue}"
|
||||||
|
prompt="$(mktemp "${TMPDIR:-/tmp}/boxbox-prompt-${issue}.XXXX")"
|
||||||
|
_render_prompt "$issue" "$title" "$body" > "$prompt"
|
||||||
|
|
||||||
|
echo "── dispatch #$issue → $harness ──"
|
||||||
|
echo " title : $title"
|
||||||
|
echo " branch : $branch"
|
||||||
|
echo " worktree : $wt"
|
||||||
|
echo " base : $base"
|
||||||
|
echo " prompt : $prompt"
|
||||||
|
|
||||||
|
if [ "$dry" = 1 ]; then
|
||||||
|
echo " [dry-run] no worktree / harness / PR / state change. Prompt preview:"
|
||||||
|
sed 's/^/ | /' "$prompt"
|
||||||
|
return 0
|
||||||
|
fi
|
||||||
|
|
||||||
|
# preflight: warn (don't block) if not Ready
|
||||||
|
local stage; stage="$(get_field "$issue" Stage)"
|
||||||
|
[ "$stage" = "Ready" ] || echo " ⚠ Stage is '$stage' (not Ready) — dispatching anyway"
|
||||||
|
|
||||||
|
# isolated worktree
|
||||||
|
if [ -d "$wt" ]; then
|
||||||
|
echo " worktree exists — reusing"
|
||||||
|
else
|
||||||
|
git -C "$repo_root" worktree add -b "$branch" "$wt" "$base" || return 1
|
||||||
|
fi
|
||||||
|
|
||||||
|
set_stage "$issue" "In Progress"
|
||||||
|
|
||||||
|
echo " running $harness (headless)…"
|
||||||
|
( harness_"$harness" "$wt" "$prompt" ); local hrc=$?
|
||||||
|
echo " $harness exited ($hrc)"
|
||||||
|
|
||||||
|
# fallback commit: guarantee a PR-able branch even if the harness didn't commit
|
||||||
|
if [ -n "$(git -C "$wt" status --porcelain)" ]; then
|
||||||
|
git -C "$wt" add -A
|
||||||
|
git -C "$wt" commit -q -m "feat(#$issue): $title
|
||||||
|
|
||||||
|
Implemented by $harness via .agents/dev dispatch." && echo " committed leftover changes"
|
||||||
|
fi
|
||||||
|
|
||||||
|
# gate
|
||||||
|
local gate="passed"
|
||||||
|
run_gate "$wt" || gate="FAILED"
|
||||||
|
echo " gate: $gate"
|
||||||
|
|
||||||
|
# PR (only if there are commits ahead of base)
|
||||||
|
if [ -n "$(git -C "$wt" log "$base..$branch" --oneline 2>/dev/null)" ]; then
|
||||||
|
git -C "$wt" push -u origin "$branch" || { echo " push failed — inspect $wt" >&2; return 1; }
|
||||||
|
local draft=""; [ "$gate" = "FAILED" ] && draft="--draft"
|
||||||
|
local pr
|
||||||
|
pr="$(gh pr create -R "$REPO" --head "$branch" --base "$base" $draft \
|
||||||
|
--title "$title (#$issue)" --body "$(_pr_body "$issue" "$harness" "$gate")")" || { echo " gh pr create failed" >&2; return 1; }
|
||||||
|
echo " PR: $pr${draft:+ (draft — gate failed)}"
|
||||||
|
set_stage "$issue" "In Review"
|
||||||
|
else
|
||||||
|
echo " no commits on $branch — leaving Stage 'In Progress'. Inspect the worktree: $wt" >&2
|
||||||
|
fi
|
||||||
|
}
|
||||||
68
.agents/lib/gh.sh
Normal file
68
.agents/lib/gh.sh
Normal file
@@ -0,0 +1,68 @@
|
|||||||
|
#!/usr/bin/env bash
|
||||||
|
# .agents/lib/gh.sh — harness-agnostic helpers for the box-box agentic dev lifecycle.
|
||||||
|
#
|
||||||
|
# Source it, then call the functions:
|
||||||
|
# source .agents/lib/gh.sh
|
||||||
|
# issue_json 9 ; set_stage 9 Research ; set_effort 9 M
|
||||||
|
#
|
||||||
|
# Requires: gh (authed, with `project` scope), jq.
|
||||||
|
# Config is overridable via env vars.
|
||||||
|
|
||||||
|
REPO="${BOXBOX_REPO:-AmanTahiliani/box-box}"
|
||||||
|
PROJECT_OWNER="${BOXBOX_PROJECT_OWNER:-AmanTahiliani}"
|
||||||
|
PROJECT_NUMBER="${BOXBOX_PROJECT_NUMBER:-2}"
|
||||||
|
|
||||||
|
_BOXBOX_CACHE="${TMPDIR:-/tmp}/boxbox-agent"
|
||||||
|
mkdir -p "$_BOXBOX_CACHE" 2>/dev/null
|
||||||
|
|
||||||
|
# ---------- issues ----------
|
||||||
|
issue_json() { gh issue view "$1" -R "$REPO" --json number,title,body,labels,url,state; }
|
||||||
|
issue_body() { gh issue view "$1" -R "$REPO" --json body -q .body; }
|
||||||
|
issue_title() { gh issue view "$1" -R "$REPO" --json title -q .title; }
|
||||||
|
issue_url() { gh issue view "$1" -R "$REPO" --json url -q .url; }
|
||||||
|
set_issue_body() { gh issue edit "$1" -R "$REPO" --body-file "$2"; } # <issue#> <file>
|
||||||
|
add_comment() { gh issue comment "$1" -R "$REPO" --body-file "$2"; } # <issue#> <file>
|
||||||
|
|
||||||
|
# Native sub-issue children of an epic (issue numbers, one per line).
|
||||||
|
sub_issues() {
|
||||||
|
gh api graphql -H "GraphQL-Features: sub_issues" -f query='
|
||||||
|
query($owner:String!,$repo:String!,$num:Int!){
|
||||||
|
repository(owner:$owner,name:$repo){
|
||||||
|
issue(number:$num){ subIssues(first:50){ nodes{ number } } } } }' \
|
||||||
|
-F owner="${REPO%/*}" -F repo="${REPO#*/}" -F num="$1" \
|
||||||
|
-q '.data.repository.issue.subIssues.nodes[].number'
|
||||||
|
}
|
||||||
|
|
||||||
|
# ---------- project fields (cached per shell invocation) ----------
|
||||||
|
_fields_file="$_BOXBOX_CACHE/fields.json"
|
||||||
|
_items_file="$_BOXBOX_CACHE/items.json"
|
||||||
|
_pid_file="$_BOXBOX_CACHE/project_id"
|
||||||
|
|
||||||
|
_refresh_fields() { gh project field-list "$PROJECT_NUMBER" --owner "$PROJECT_OWNER" --format json > "$_fields_file"; }
|
||||||
|
_refresh_items() { gh project item-list "$PROJECT_NUMBER" --owner "$PROJECT_OWNER" --format json --limit 200 > "$_items_file"; }
|
||||||
|
project_refresh() { _refresh_fields; _refresh_items; } # call once at the start of a session to get fresh state
|
||||||
|
|
||||||
|
_project_id() { [ -s "$_pid_file" ] || gh project view "$PROJECT_NUMBER" --owner "$PROJECT_OWNER" --format json | jq -r .id > "$_pid_file"; cat "$_pid_file"; }
|
||||||
|
_field_id() { [ -s "$_fields_file" ] || _refresh_fields; jq -r --arg n "$1" '.fields[]|select(.name==$n)|.id' "$_fields_file"; }
|
||||||
|
_option_id() { [ -s "$_fields_file" ] || _refresh_fields; jq -r --arg f "$1" --arg o "$2" '.fields[]|select(.name==$f)|.options[]?|select(.name==$o)|.id' "$_fields_file"; }
|
||||||
|
_item_id() { [ -s "$_items_file" ] || _refresh_items; jq -r --arg n "$1" '.items[]|select(.content.number==($n|tonumber))|.id' "$_items_file"; }
|
||||||
|
|
||||||
|
# set_field <issue#> <FieldName> <OptionName> (single-select fields: Stage/Priority/Effort/Phase)
|
||||||
|
set_field() {
|
||||||
|
local item opt fld pid
|
||||||
|
item="$(_item_id "$1")"; fld="$(_field_id "$2")"; opt="$(_option_id "$2" "$3")"; pid="$(_project_id)"
|
||||||
|
if [ -z "$item" ] || [ -z "$fld" ] || [ -z "$opt" ]; then
|
||||||
|
echo "set_field: could not resolve issue=$1 field=$2 option=$3 (item=$item field=$fld opt=$opt)" >&2; return 1
|
||||||
|
fi
|
||||||
|
gh project item-edit --id "$item" --project-id "$pid" --field-id "$fld" --single-select-option-id "$opt" >/dev/null \
|
||||||
|
&& echo "set #$1 $2=$3"
|
||||||
|
}
|
||||||
|
set_stage() { set_field "$1" Stage "$2"; }
|
||||||
|
set_priority() { set_field "$1" Priority "$2"; }
|
||||||
|
set_effort() { set_field "$1" Effort "$2"; }
|
||||||
|
|
||||||
|
# get_field <issue#> <FieldName> -> current value (single-word field names only)
|
||||||
|
get_field() {
|
||||||
|
[ -s "$_items_file" ] || _refresh_items
|
||||||
|
jq -r --arg n "$1" --arg f "$2" '.items[]|select(.content.number==($n|tonumber))|.[($f|ascii_downcase)] // "-"' "$_items_file"
|
||||||
|
}
|
||||||
35
.agents/personas/architect.md
Normal file
35
.agents/personas/architect.md
Normal file
@@ -0,0 +1,35 @@
|
|||||||
|
# Lens overlay: Architect
|
||||||
|
|
||||||
|
Apply this **on top of** the base grill (`grill.md`). Bias every question toward
|
||||||
|
technical soundness and fit with the existing box-box architecture.
|
||||||
|
|
||||||
|
## box-box context to hold
|
||||||
|
|
||||||
|
- **Backend (Go):** `internal/api` (OpenF1 client, cache, 37 endpoints), `internal/web`
|
||||||
|
(REST handlers + SSE hub, route table in `server.go`), `internal/store` (domain
|
||||||
|
SQLite), `internal/query` (read models over the domain DB), `internal/ingest`,
|
||||||
|
`internal/live` (SignalR).
|
||||||
|
- **Frontend (React+Vite+TS):** TanStack Router/Query, `src/api.ts` (typed fetchers),
|
||||||
|
`src/types.ts` (payload mirrors), `src/lib` (client helpers), `src/pages`,
|
||||||
|
`src/components` (incl. `components/live`).
|
||||||
|
- **Patterns to respect** (see CLAUDE.md "How To Extend"): ServeMux longest-prefix
|
||||||
|
route ordering in `server.go`, cache TTL tiers, `?source=openf1|local|auto`
|
||||||
|
resolution, two-phase standings load, lazy tab loads, stale-data fallback banner.
|
||||||
|
|
||||||
|
## Grill especially on
|
||||||
|
|
||||||
|
- **Reuse vs new:** does existing code already do this (a TUI equivalent in
|
||||||
|
`internal/ui/*.go`, a query model, an `api.ts` fetcher)? Port vs rebuild.
|
||||||
|
- **Data flow & source:** OpenF1 live vs domain DB vs cache; payload size; rate
|
||||||
|
limits; how `?source` is handled.
|
||||||
|
- **Seams:** which files/modules change; new endpoint (mind registration order!) vs
|
||||||
|
extend an existing one; new component vs extend; where shared logic lives
|
||||||
|
(`frontend/src/lib/*`).
|
||||||
|
- **Testability:** how does this land in `go test` / `vitest` / hermetic Playwright?
|
||||||
|
What seam makes it testable without live OpenF1?
|
||||||
|
- **Risk:** domain-DB migrations, perf on large sessions, backward compat, and
|
||||||
|
failure / stale-data behavior.
|
||||||
|
|
||||||
|
Keep questions concrete and decision-shaped — e.g. *"port the GPS normalization from
|
||||||
|
`internal/ui/trackmap.go`, or recompute in a shared `frontend/src/lib/trackmap.ts` so
|
||||||
|
it's unit-testable?"* — each with your recommendation.
|
||||||
51
.agents/personas/grill.md
Normal file
51
.agents/personas/grill.md
Normal file
@@ -0,0 +1,51 @@
|
|||||||
|
# Persona: The Grill
|
||||||
|
|
||||||
|
You run a **grill-me** session. Instead of the human prompting you, **you interrogate
|
||||||
|
the human** until you share a design concept for one specific piece of work (a GitHub
|
||||||
|
issue or epic). The shared understanding — not the document — is the real output.
|
||||||
|
|
||||||
|
## Before you ask anything
|
||||||
|
|
||||||
|
Load the full context of the target:
|
||||||
|
|
||||||
|
- Read the issue title + body (and any notes already on it).
|
||||||
|
- Read `CLAUDE.md`.
|
||||||
|
- Explore the code paths the work implicates.
|
||||||
|
|
||||||
|
## Rules
|
||||||
|
|
||||||
|
1. **One question at a time.** Walk each branch of the design tree and resolve
|
||||||
|
dependencies in order — a later question often depends on an earlier answer.
|
||||||
|
2. **Recommend, consequence-first.** Every question carries your recommended answer
|
||||||
|
and a short "why". **Calibrate to a technically fluent reader who does not know
|
||||||
|
*this project's* internals.** Assume general engineering literacy (APIs, streaming,
|
||||||
|
latency, front/back-end, caching, etc.) and don't explain those. **Do** unpack
|
||||||
|
anything project-specific: internal file/type/endpoint names, bespoke architecture
|
||||||
|
choices, and why they matter *here* — a few words is enough, no lectures. Above all,
|
||||||
|
lead each option with the **practical consequence** a decision can be made on
|
||||||
|
(effort, risk, what ships sooner, how it feels to use), so the reader can choose
|
||||||
|
without needing the implementation detail. Recommendation first, with why it's the
|
||||||
|
better call **for them**.
|
||||||
|
- *Example — keep the mechanism, but lead with the tradeoff:* "**A (recommended):**
|
||||||
|
reuse the existing SSE snapshot — cheapest to build, but cars jump a little
|
||||||
|
between updates. **B:** a dedicated ~4Hz position stream — more work now, but
|
||||||
|
motion is smooth and it sets up interpolation later." (Names the real mechanism;
|
||||||
|
the choice is still obvious from the consequences.)
|
||||||
|
3. **Hybrid asking.**
|
||||||
|
- Decision with clear discrete options → present a **structured choice**, the
|
||||||
|
recommendation first. *(In Claude Code: use the AskUserQuestion tool; put the
|
||||||
|
recommended option first and end its label with "(Recommended)".)* Write each
|
||||||
|
option's description in the plain-language, consequence-first style from rule 2 —
|
||||||
|
the label can be terse, but the description must be understandable on its own.
|
||||||
|
- Genuinely open-ended → ask in **prose**.
|
||||||
|
4. **Explore before you ask.** If the codebase or the issue already answers a
|
||||||
|
question, do **not** ask — state what you found and the assumption you're
|
||||||
|
proceeding with, then move on. Only ask about real forks the human must decide.
|
||||||
|
5. **Stay in scope.** Grill the design of *this* work, not the whole app. Note
|
||||||
|
out-of-scope temptations instead of chasing them.
|
||||||
|
|
||||||
|
## Termination
|
||||||
|
|
||||||
|
Stop when no unresolved branches remain and you could write the spec yourself with no
|
||||||
|
open questions. Summarize the shared design concept in 3–6 bullets, confirm it with
|
||||||
|
the human, then hand off to `write-spec`.
|
||||||
21
.agents/prompts/implement.md
Normal file
21
.agents/prompts/implement.md
Normal file
@@ -0,0 +1,21 @@
|
|||||||
|
You are an autonomous coding agent working in an **isolated git worktree** on the
|
||||||
|
**box-box** repo. Implement the groomed spec below as a single, focused, story-sized
|
||||||
|
change — then commit it.
|
||||||
|
|
||||||
|
## Ground rules
|
||||||
|
- Read `AGENTS.md` / `CLAUDE.md` first and follow the project's conventions exactly
|
||||||
|
(architecture, route-registration order in `server.go`, cache TTL tiers,
|
||||||
|
`api.ts`/`types.ts` mirrors, test layout).
|
||||||
|
- Implement ONLY this story's scope. Honor the spec's **Out of Scope** — do not build
|
||||||
|
deferred items, even if tempting.
|
||||||
|
- If the spec has an **early spike / risk** step, do that FIRST and note the result in
|
||||||
|
your commit message (and adjust the approach if the spike says to).
|
||||||
|
- Add or extend tests per the **Test Plan**. Make the relevant suites pass:
|
||||||
|
`go build ./...`, `go test ./...`, and in `frontend/`: `npm run test`, `tsc --noEmit`.
|
||||||
|
- Keep the change reviewable and story-sized. **Commit your work** with a clear,
|
||||||
|
conventional message when done (the dispatcher opens the PR).
|
||||||
|
- Satisfy every item in the spec's **Definition of Done**.
|
||||||
|
|
||||||
|
If something in the spec is ambiguous or turns out to be wrong once you're in the code,
|
||||||
|
make the smallest reasonable decision, implement it, and call it out clearly in the
|
||||||
|
commit message / PR so the reviewer can catch it — do not silently expand scope.
|
||||||
27
.agents/prompts/ready-spec.md
Normal file
27
.agents/prompts/ready-spec.md
Normal file
@@ -0,0 +1,27 @@
|
|||||||
|
## Context
|
||||||
|
{one paragraph: the problem and why it matters, grounded in the grooming}
|
||||||
|
|
||||||
|
## Acceptance Criteria
|
||||||
|
- [ ] {observable behaviour 1}
|
||||||
|
- [ ] {observable behaviour 2}
|
||||||
|
|
||||||
|
## Technical Approach
|
||||||
|
- **Files to touch:** {real paths}
|
||||||
|
- **Data source:** {OpenF1 live | domain DB | cache | ...}
|
||||||
|
- **Endpoints/components:** {new or extended — note route-registration order if new}
|
||||||
|
- **Key decisions:** {the forks resolved during the grill}
|
||||||
|
|
||||||
|
## Test Plan
|
||||||
|
- {cases mapped to the real suites: go test · vitest · hermetic Playwright}
|
||||||
|
|
||||||
|
## Out of Scope
|
||||||
|
- {explicitly deferred}
|
||||||
|
|
||||||
|
## Definition of Done
|
||||||
|
- [ ] Tests added and green (`go test` · `vitest` · `tsc --noEmit` · hermetic Playwright as applicable)
|
||||||
|
- [ ] Matches CLAUDE.md conventions (route order, cache TTLs, `api.ts`/`types.ts` mirrors)
|
||||||
|
- [ ] No console / preview errors (UI verified in preview)
|
||||||
|
- [ ] Story-sized PR, linked to this issue
|
||||||
|
|
||||||
|
---
|
||||||
|
_Groomed {date} · Effort {S|M|L} · Priority {P0|P1|P2} · via /groom_
|
||||||
20
.agents/prompts/review.md
Normal file
20
.agents/prompts/review.md
Normal file
@@ -0,0 +1,20 @@
|
|||||||
|
You are an independent reviewer for a box-box pull request. Review the PR against
|
||||||
|
the linked GitHub issue spec, not against your own preferred scope.
|
||||||
|
|
||||||
|
## Ground rules
|
||||||
|
- Use a harness different from the implementer when possible.
|
||||||
|
- Read `AGENTS.md` / `CLAUDE.md`, the PR body/diff, and the linked issue body.
|
||||||
|
- Run the relevant local gates and capture logs under `.review/issue-<n>-pr-<pr>/logs`.
|
||||||
|
- For UI changes, create a local visual packet under `.review/issue-<n>-pr-<pr>/`
|
||||||
|
with desktop and mobile screenshots for the affected routes.
|
||||||
|
- If screenshots should appear inline on GitHub, publish only review artifacts to
|
||||||
|
a separate artifact branch, never to `main` or the product PR branch.
|
||||||
|
- Post a PR comment with pass/fail status, acceptance-criteria alignment, local
|
||||||
|
artifact paths, screenshot links when available, and caveats.
|
||||||
|
- Do not merge. The human owns the merge gate.
|
||||||
|
|
||||||
|
## Output
|
||||||
|
- A local packet with `summary.md`, optional `index.html`, screenshots, logs, and
|
||||||
|
any visual diffs.
|
||||||
|
- A GitHub PR comment that makes the review visually scannable.
|
||||||
|
- A clear recommendation: pass, pass with caveats, or needs changes.
|
||||||
42
.agents/skills/groom/SKILL.md
Normal file
42
.agents/skills/groom/SKILL.md
Normal file
@@ -0,0 +1,42 @@
|
|||||||
|
---
|
||||||
|
name: groom
|
||||||
|
description: Groom a box-box GitHub issue into a Ready spec via a seeded grill-me interrogation. Use when the user asks to groom an issue, for example "/groom <issue-number>" or "$groom <issue-number>" with optional "--lens architect". Single-issue path: asks targeted questions, writes a structured spec into the issue body, sets Effort/Priority, and leaves Stage at Research for approval.
|
||||||
|
argument-hint: <issue-number> [--lens architect]
|
||||||
|
---
|
||||||
|
|
||||||
|
# /groom — refine one issue into a Ready spec
|
||||||
|
|
||||||
|
Groom issue **$ARGUMENTS** on the box-box roadmap (Project #2): drive it from the
|
||||||
|
backlog into a fully-specified Ready ticket through a grill-me session.
|
||||||
|
|
||||||
|
## 0. Setup
|
||||||
|
- Parse the first token of the arguments as the **issue number**. An optional
|
||||||
|
`--lens <name>` pulls in a lens overlay (currently: `architect`).
|
||||||
|
- Run: `source .agents/lib/gh.sh && project_refresh` (fresh field/item state).
|
||||||
|
- Load context **before asking anything**: `issue_json <n>`, read `CLAUDE.md`, and
|
||||||
|
explore the code paths the issue implicates.
|
||||||
|
- Move it into grooming if it isn't already there: `set_stage <n> Research`.
|
||||||
|
|
||||||
|
## 1. Grill
|
||||||
|
- Read `.agents/personas/grill.md`. If `--lens <name>` was given, also read
|
||||||
|
`.agents/personas/<name>.md` and apply it on top.
|
||||||
|
- Run the grill exactly per those rules: **one question at a time**, recommendation
|
||||||
|
first, **hybrid** asking (AskUserQuestion for discrete decisions with the
|
||||||
|
recommended option first and labelled "(Recommended)"; prose for open-ended), and
|
||||||
|
**explore the code to self-answer** wherever possible — only ask about genuine forks.
|
||||||
|
- Track the resolved decisions as you go.
|
||||||
|
|
||||||
|
## 2. Synthesize
|
||||||
|
- When no open branches remain, summarize the shared design concept in 3–6 bullets and
|
||||||
|
confirm it with the user.
|
||||||
|
- Then invoke the **write-spec** skill for issue `<n>`, handing it the resolved
|
||||||
|
decisions, so it renders `.agents/prompts/ready-spec.md` into the issue body and
|
||||||
|
sets Effort + Priority.
|
||||||
|
|
||||||
|
## 3. Hand back (human gate)
|
||||||
|
- Do **not** auto-advance to Ready — that's the user's call. Report that the spec is
|
||||||
|
written, Stage is `Research`, and they should review the issue and flip Stage →
|
||||||
|
`Ready` when satisfied (`set_stage <n> Ready`).
|
||||||
|
- Print the issue URL (`issue_url <n>`).
|
||||||
|
|
||||||
|
Stay focused on THIS issue's design throughout. Note but don't chase out-of-scope ideas.
|
||||||
32
.agents/skills/implement/SKILL.md
Normal file
32
.agents/skills/implement/SKILL.md
Normal file
@@ -0,0 +1,32 @@
|
|||||||
|
---
|
||||||
|
name: implement
|
||||||
|
description: Dispatch a Ready box-box issue to a coding harness (claude/codex/opencode/pi/cursor) in an isolated git worktree, run the build gate, and open a PR. Use when supervising implementation via "/implement <issue-number> --harness <name> [--dry-run]" or from any harness terminal with .agents/bin/dev.
|
||||||
|
argument-hint: <issue-number> --harness <claude|codex|opencode|pi|cursor> [--dry-run]
|
||||||
|
---
|
||||||
|
|
||||||
|
# /implement — dispatch an issue to a harness (supervised)
|
||||||
|
|
||||||
|
Supervise the implementation of issue **$ARGUMENTS**. You are SUPERVISING, not coding —
|
||||||
|
a fresh harness does the work in its own isolated worktree with clean context. Do not
|
||||||
|
edit project files yourself.
|
||||||
|
|
||||||
|
## Steps
|
||||||
|
1. Parse: `<issue-number> --harness <name> [--dry-run] [--base <branch>]`.
|
||||||
|
2. **Preflight (report, don't hard-block):** `source .agents/lib/gh.sh` and check
|
||||||
|
`get_field <n> Stage` is `Ready` and the issue body has an "## Acceptance Criteria"
|
||||||
|
section (a groomed spec). If it's not Ready or has no spec, say so and recommend
|
||||||
|
`/groom <n>` first — proceed only if the user confirms.
|
||||||
|
3. **Dispatch:** run `.agents/bin/dev implement <n> --harness <name> [flags]`. For a
|
||||||
|
first run against an unfamiliar harness, suggest `--dry-run` first so the user can
|
||||||
|
eyeball the prompt.
|
||||||
|
4. **Report the outcome:** branch, worktree path, gate result (pass/FAILED → draft PR),
|
||||||
|
and the PR URL. On success, Stage will be `In Review`.
|
||||||
|
5. If no PR was created (no changes, or push failed), surface exactly why and point at
|
||||||
|
the worktree (`.worktrees/issue-<n>`) so the user can inspect. Diagnose from the
|
||||||
|
dispatcher output; recommend a fix or re-run — don't silently take over the coding.
|
||||||
|
|
||||||
|
## Notes
|
||||||
|
- The harness adapters and the gate live in `.agents/harnesses.sh` — the single place
|
||||||
|
to tune per-tool flags.
|
||||||
|
- From any harness shell, run the same thing directly:
|
||||||
|
`.agents/bin/dev implement <n> --harness <name>`.
|
||||||
22
.agents/skills/lens-architect/SKILL.md
Normal file
22
.agents/skills/lens-architect/SKILL.md
Normal file
@@ -0,0 +1,22 @@
|
|||||||
|
---
|
||||||
|
name: lens-architect
|
||||||
|
description: Grill/analyze a box-box issue or epic from a software-architecture perspective and post the findings as a comment. Use standalone as "/lens-architect <issue-number>" for an on-the-fly architecture review, or let /groom compose it via "--lens architect". Reads the base grill + architect persona and focuses on reuse, data flow, seams, testability, and risk.
|
||||||
|
argument-hint: <issue-number>
|
||||||
|
---
|
||||||
|
|
||||||
|
# /lens-architect — architecture lens
|
||||||
|
|
||||||
|
Target: issue **$ARGUMENTS** (box-box, Project #2).
|
||||||
|
|
||||||
|
1. `source .agents/lib/gh.sh`; load context (`issue_json <n>`, `CLAUDE.md`, and the
|
||||||
|
relevant code paths).
|
||||||
|
2. Read `.agents/personas/grill.md` + `.agents/personas/architect.md` and run a focused
|
||||||
|
grill from the architecture lens: hybrid asking (AskUserQuestion for discrete
|
||||||
|
decisions, recommendation first; prose otherwise), recommend every answer, and
|
||||||
|
explore the code to self-answer before asking.
|
||||||
|
3. When aligned, write an **"## Architecture review"** summary (decisions taken,
|
||||||
|
files/seams affected, risks, the test seam) to a temp file and `add_comment <n> <file>`.
|
||||||
|
4. Print the issue URL.
|
||||||
|
|
||||||
|
If invoked from **within /groom**, skip the comment — instead return the architecture
|
||||||
|
decisions inline so groom can fold them into the spec.
|
||||||
53
.agents/skills/review/SKILL.md
Normal file
53
.agents/skills/review/SKILL.md
Normal file
@@ -0,0 +1,53 @@
|
|||||||
|
---
|
||||||
|
name: review
|
||||||
|
description: Locally review a box-box PR against its linked GitHub issue spec, run tests, capture visual screenshots when applicable, create a .review packet, and post a GitHub PR comment. Use when a ticket implementation is ready for independent local review before the human merge gate.
|
||||||
|
argument-hint: <pr-number> [--harness <name>] [--publish-screenshots]
|
||||||
|
---
|
||||||
|
|
||||||
|
# /review — local independent PR review
|
||||||
|
|
||||||
|
Review PR **$ARGUMENTS** for box-box using the local-only lifecycle. You are
|
||||||
|
reviewing, not implementing. Do not merge the PR.
|
||||||
|
|
||||||
|
## 0. Setup
|
||||||
|
- Parse the PR number. Optional `--harness <name>` records which reviewer harness is
|
||||||
|
acting; optional `--publish-screenshots` allows pushing visual artifacts to a
|
||||||
|
dedicated artifact branch.
|
||||||
|
- Read `.agents/prompts/review.md`, `AGENTS.md`, the PR metadata/diff, and the linked
|
||||||
|
issue body.
|
||||||
|
- Identify the implementer harness from the PR body when present. If it matches the
|
||||||
|
reviewer harness, call that out as a reduced independence caveat.
|
||||||
|
- Create `.review/issue-<issue>-pr-<pr>/logs`, `screenshots`, and `artifacts`.
|
||||||
|
|
||||||
|
## 1. Verify
|
||||||
|
- Run the smallest meaningful gates first, then broaden based on risk:
|
||||||
|
`go test` for touched Go packages, `npm run test` and `npm run build` for frontend
|
||||||
|
changes, and hermetic Playwright when user-facing routes changed.
|
||||||
|
- Save all command output to `.review/issue-<issue>-pr-<pr>/logs`.
|
||||||
|
- Inspect the diff for spec conformance, scope leaks, missing tests, and known project
|
||||||
|
conventions from `AGENTS.md`.
|
||||||
|
|
||||||
|
## 2. Visual Packet
|
||||||
|
- If the PR changes UI, start a local seeded or mocked preview and capture desktop and
|
||||||
|
mobile screenshots for affected routes.
|
||||||
|
- Prefer hermetic mocks/seeded data over live external state.
|
||||||
|
- Save screenshots under `.review/issue-<issue>-pr-<pr>/screenshots`.
|
||||||
|
- Create a concise `summary.md`; create `index.html` when screenshots exist.
|
||||||
|
|
||||||
|
## 3. Publish
|
||||||
|
- If `--publish-screenshots` is present, publish only review artifacts to a dedicated
|
||||||
|
branch such as `review-artifacts/pr-<pr>/` and use raw GitHub URLs in the comment.
|
||||||
|
- Post a PR comment with:
|
||||||
|
- reviewer harness and implementer harness
|
||||||
|
- result: pass, pass with caveats, or needs changes
|
||||||
|
- local packet path
|
||||||
|
- gates run and results
|
||||||
|
- acceptance-criteria checklist
|
||||||
|
- screenshots or artifact links when available
|
||||||
|
- caveats that the human must inspect
|
||||||
|
- If the result is pass/pass-with-caveats, set the linked issue's custom Project
|
||||||
|
`Stage` to `In Review` using `.agents/lib/gh.sh`. Do not set `Done`.
|
||||||
|
|
||||||
|
## 4. Hand Back
|
||||||
|
- Tell the human exactly what to open locally and what decision remains theirs.
|
||||||
|
- Do not merge or delete worktrees.
|
||||||
30
.agents/skills/write-spec/SKILL.md
Normal file
30
.agents/skills/write-spec/SKILL.md
Normal file
@@ -0,0 +1,30 @@
|
|||||||
|
---
|
||||||
|
name: write-spec
|
||||||
|
description: Render a groomed design into the box-box Ready-spec template and write it into a GitHub issue body, then set Effort and Priority. Called by /groom after a grill session, or run standalone as "/write-spec <issue-number>" to (re)write an issue's spec from agreed decisions. Does not change Stage.
|
||||||
|
argument-hint: <issue-number>
|
||||||
|
---
|
||||||
|
|
||||||
|
# /write-spec — write the Ready spec into an issue
|
||||||
|
|
||||||
|
Target issue: **$ARGUMENTS** (box-box, Project #2).
|
||||||
|
|
||||||
|
## Steps
|
||||||
|
1. `source .agents/lib/gh.sh`
|
||||||
|
2. Gather the agreed design decisions: from the current grooming conversation if one
|
||||||
|
is in progress; otherwise ask the user for the key points, or read the issue and
|
||||||
|
explore the code to draft them and confirm.
|
||||||
|
3. Read `.agents/prompts/ready-spec.md` and fill every placeholder:
|
||||||
|
- Concrete, **behavioural** acceptance criteria (checkboxes).
|
||||||
|
- Technical approach grounded in **real files/paths** and the chosen data source.
|
||||||
|
- Test plan mapped to the actual suites (`go test` · `vitest` · hermetic Playwright).
|
||||||
|
- Explicit out-of-scope.
|
||||||
|
- Keep the Definition of Done checklist verbatim.
|
||||||
|
- Stamp the footer: date (from the current-date context), Effort (S/M/L),
|
||||||
|
Priority (P0–P2).
|
||||||
|
4. Write it into the issue body: save the filled template to a temp file under the
|
||||||
|
scratchpad and `set_issue_body <n> <file>`. The spec is the single source of truth —
|
||||||
|
only preserve prior body text that captures decisions the spec doesn't.
|
||||||
|
5. Set fields: `set_effort <n> <S|M|L>` and `set_priority <n> <P0|P1|P2>`.
|
||||||
|
6. Print the issue URL and a one-line summary of what was written.
|
||||||
|
|
||||||
|
Do **not** change Stage — `/groom` owns state transitions.
|
||||||
59
.agents/test/dispatch_disabled_harness_test.sh
Executable file
59
.agents/test/dispatch_disabled_harness_test.sh
Executable file
@@ -0,0 +1,59 @@
|
|||||||
|
#!/usr/bin/env bash
|
||||||
|
set -euo pipefail
|
||||||
|
|
||||||
|
ROOT="$(cd "$(dirname "${BASH_SOURCE[0]}")/../.." && pwd)"
|
||||||
|
cd "$ROOT"
|
||||||
|
|
||||||
|
# shellcheck source=/dev/null
|
||||||
|
source "$ROOT/.agents/lib/dispatch.sh"
|
||||||
|
|
||||||
|
issue_title() { echo "Disable agy harness smoke"; }
|
||||||
|
issue_body() { echo "## Spec"; echo; echo "Smoke prompt body"; }
|
||||||
|
get_field() { echo "Ready"; }
|
||||||
|
set_stage() { echo "unexpected set_stage $*" >&2; return 99; }
|
||||||
|
run_gate() { echo "unexpected run_gate $*" >&2; return 99; }
|
||||||
|
|
||||||
|
unexpected_git_file="$(mktemp "${TMPDIR:-/tmp}/boxbox-agy-git.XXXX")"
|
||||||
|
rm -f "$unexpected_git_file"
|
||||||
|
git() {
|
||||||
|
if [ "${1:-}" = "rev-parse" ]; then
|
||||||
|
command git "$@"
|
||||||
|
return
|
||||||
|
fi
|
||||||
|
echo "unexpected git $*" >&2
|
||||||
|
touch "$unexpected_git_file"
|
||||||
|
return 99
|
||||||
|
}
|
||||||
|
|
||||||
|
set +e
|
||||||
|
non_dry_output="$(dispatch 47 agy 2>&1)"
|
||||||
|
non_dry_status=$?
|
||||||
|
set -e
|
||||||
|
|
||||||
|
[ "$non_dry_status" -eq 2 ] || {
|
||||||
|
echo "expected agy non-dry-run to exit 2, got $non_dry_status" >&2
|
||||||
|
echo "$non_dry_output" >&2
|
||||||
|
exit 1
|
||||||
|
}
|
||||||
|
[[ "$non_dry_output" == *"harness 'agy' is disabled"* ]] || {
|
||||||
|
echo "expected disabled-harness message" >&2
|
||||||
|
echo "$non_dry_output" >&2
|
||||||
|
exit 1
|
||||||
|
}
|
||||||
|
[ ! -e "$unexpected_git_file" ] || {
|
||||||
|
echo "agy non-dry-run reached git before failing" >&2
|
||||||
|
echo "$non_dry_output" >&2
|
||||||
|
exit 1
|
||||||
|
}
|
||||||
|
|
||||||
|
dry_output="$(dispatch 47 agy --dry-run 2>&1)"
|
||||||
|
[[ "$dry_output" == *"[dry-run] no worktree / harness / PR / state change"* ]] || {
|
||||||
|
echo "expected agy dry-run to render dispatch preview" >&2
|
||||||
|
echo "$dry_output" >&2
|
||||||
|
exit 1
|
||||||
|
}
|
||||||
|
[[ "$dry_output" == *"Smoke prompt body"* ]] || {
|
||||||
|
echo "expected agy dry-run prompt body" >&2
|
||||||
|
echo "$dry_output" >&2
|
||||||
|
exit 1
|
||||||
|
}
|
||||||
1
.claude/skills
Symbolic link
1
.claude/skills
Symbolic link
@@ -0,0 +1 @@
|
|||||||
|
../.agents/skills
|
||||||
9
.gitignore
vendored
9
.gitignore
vendored
@@ -22,7 +22,8 @@ frontend/node_modules/
|
|||||||
frontend/dist/
|
frontend/dist/
|
||||||
|
|
||||||
# Local Claude workspace settings
|
# Local Claude workspace settings
|
||||||
.claude/
|
.claude/*
|
||||||
|
!.claude/skills
|
||||||
|
|
||||||
# Playwright
|
# Playwright
|
||||||
node_modules/
|
node_modules/
|
||||||
@@ -31,3 +32,9 @@ node_modules/
|
|||||||
/blob-report/
|
/blob-report/
|
||||||
/playwright/.cache/
|
/playwright/.cache/
|
||||||
/playwright/.auth/
|
/playwright/.auth/
|
||||||
|
|
||||||
|
# agentic dev: isolated implementation worktrees
|
||||||
|
.worktrees/
|
||||||
|
|
||||||
|
# agentic dev: local review packets
|
||||||
|
.review/
|
||||||
|
|||||||
46
cmd/main.go
46
cmd/main.go
@@ -27,6 +27,7 @@ func main() {
|
|||||||
ingestMeeting := flag.Int("ingest-meeting", 0, "Ingest meeting metadata and Race Hub datasets for all sessions")
|
ingestMeeting := flag.Int("ingest-meeting", 0, "Ingest meeting metadata and Race Hub datasets for all sessions")
|
||||||
ingestSession := flag.Int("ingest-session", 0, "Ingest Race Hub datasets for a session key")
|
ingestSession := flag.Int("ingest-session", 0, "Ingest Race Hub datasets for a session key")
|
||||||
ingestNews := flag.Bool("ingest-news", false, "Refresh RSS/Atom paddock briefing feeds")
|
ingestNews := flag.Bool("ingest-news", false, "Refresh RSS/Atom paddock briefing feeds")
|
||||||
|
prefetchTrackOutlines := flag.Int("prefetch-track-outlines", 0, "Warm the web track-outline cache for a season year (for web-only hosts, run before --web so /api/v1/track-outline can serve live maps)")
|
||||||
dryRun := flag.Bool("dry-run", false, "Preview ingestion without writing domain rows")
|
dryRun := flag.Bool("dry-run", false, "Preview ingestion without writing domain rows")
|
||||||
force := flag.Bool("force", false, "Re-ingest datasets even if already tracked in the session_coverage table as completed")
|
force := flag.Bool("force", false, "Re-ingest datasets even if already tracked in the session_coverage table as completed")
|
||||||
coverageYear := flag.Int("coverage", 0, "Show season coverage report for the given year")
|
coverageYear := flag.Int("coverage", 0, "Show season coverage report for the given year")
|
||||||
@@ -76,11 +77,21 @@ func main() {
|
|||||||
if *ingestNews {
|
if *ingestNews {
|
||||||
ingestFlags++
|
ingestFlags++
|
||||||
}
|
}
|
||||||
|
if *prefetchTrackOutlines != 0 {
|
||||||
|
ingestFlags++
|
||||||
|
}
|
||||||
if ingestFlags > 0 {
|
if ingestFlags > 0 {
|
||||||
if ingestFlags > 1 {
|
if ingestFlags > 1 {
|
||||||
fmt.Fprintln(os.Stderr, "box-box: only one of --ingest-year, --backfill-season, --ingest-meeting, --ingest-session, or --ingest-news may be set")
|
fmt.Fprintln(os.Stderr, "box-box: only one of --ingest-year, --backfill-season, --ingest-meeting, --ingest-session, --ingest-news, or --prefetch-track-outlines may be set")
|
||||||
os.Exit(1)
|
os.Exit(1)
|
||||||
}
|
}
|
||||||
|
if *prefetchTrackOutlines != 0 {
|
||||||
|
if err := runTrackOutlinePrefetch(client, *prefetchTrackOutlines); err != nil {
|
||||||
|
fmt.Fprintf(os.Stderr, "box-box track outline prefetch error: %v\n", err)
|
||||||
|
os.Exit(1)
|
||||||
|
}
|
||||||
|
return
|
||||||
|
}
|
||||||
if *ingestNews {
|
if *ingestNews {
|
||||||
if err := runNewsIngestion(*dryRun, *dbPath); err != nil {
|
if err := runNewsIngestion(*dryRun, *dbPath); err != nil {
|
||||||
fmt.Fprintf(os.Stderr, "box-box ingest error: %v\n", err)
|
fmt.Fprintf(os.Stderr, "box-box ingest error: %v\n", err)
|
||||||
@@ -88,7 +99,7 @@ func main() {
|
|||||||
}
|
}
|
||||||
return
|
return
|
||||||
}
|
}
|
||||||
|
|
||||||
yearVal := *ingestYear
|
yearVal := *ingestYear
|
||||||
if *backfillSeason != 0 {
|
if *backfillSeason != 0 {
|
||||||
yearVal = *backfillSeason
|
yearVal = *backfillSeason
|
||||||
@@ -174,6 +185,35 @@ func runIngestion(client *api.OpenF1Client, year, meetingKey, sessionKey int, fo
|
|||||||
return err
|
return err
|
||||||
}
|
}
|
||||||
|
|
||||||
|
func runTrackOutlinePrefetch(client *api.OpenF1Client, year int) error {
|
||||||
|
log.SetOutput(os.Stderr)
|
||||||
|
|
||||||
|
fmt.Fprintf(os.Stderr, "track outlines: warming HTTP cache %s for %d\n", api.DefaultCacheDBPath(), year)
|
||||||
|
|
||||||
|
meetings, err := client.GetMeetingsForYear(year)
|
||||||
|
if err != nil {
|
||||||
|
return fmt.Errorf("fetch meetings for %d: %w", year, err)
|
||||||
|
}
|
||||||
|
|
||||||
|
result := client.PrefetchTrackOutlinesForYear(year, meetings)
|
||||||
|
fmt.Printf(
|
||||||
|
"track outlines %d: cached %d/%d unique circuit(s) before, %d/%d after; %d skipped, %d fetched, %d failed\n",
|
||||||
|
result.Year,
|
||||||
|
result.CachedBefore,
|
||||||
|
result.UniqueCircuits,
|
||||||
|
result.CachedAfter,
|
||||||
|
result.UniqueCircuits,
|
||||||
|
result.Skipped,
|
||||||
|
result.Fetched,
|
||||||
|
result.Failed,
|
||||||
|
)
|
||||||
|
|
||||||
|
if result.CachedAfter == 0 {
|
||||||
|
return fmt.Errorf("cached zero track outlines for %d", year)
|
||||||
|
}
|
||||||
|
return nil
|
||||||
|
}
|
||||||
|
|
||||||
func runNewsIngestion(dryRun bool, dbPath string) error {
|
func runNewsIngestion(dryRun bool, dbPath string) error {
|
||||||
log.SetOutput(os.Stderr)
|
log.SetOutput(os.Stderr)
|
||||||
|
|
||||||
@@ -275,7 +315,7 @@ func runCoverageReport(year int, dbPath string) error {
|
|||||||
}
|
}
|
||||||
|
|
||||||
fmt.Printf("\n--- Season %d Coverage Report ---\n\n", year)
|
fmt.Printf("\n--- Season %d Coverage Report ---\n\n", year)
|
||||||
fmt.Printf("%-35s | %-5s | %-2s | %-2s | %-2s | %-2s | %-2s | %-2s | %-2s | %-2s | %-2s\n",
|
fmt.Printf("%-35s | %-5s | %-2s | %-2s | %-2s | %-2s | %-2s | %-2s | %-2s | %-2s | %-2s\n",
|
||||||
"Meeting / Session (Key)", "ID", "DR", "SR", "SG", "ST", "PS", "PO", "RC", "WE", "LA")
|
"Meeting / Session (Key)", "ID", "DR", "SR", "SG", "ST", "PS", "PO", "RC", "WE", "LA")
|
||||||
fmt.Println(strings.Repeat("-", 82))
|
fmt.Println(strings.Repeat("-", 82))
|
||||||
|
|
||||||
|
|||||||
198
docs/PRODUCT_ROADMAP.md
Normal file
198
docs/PRODUCT_ROADMAP.md
Normal file
@@ -0,0 +1,198 @@
|
|||||||
|
# box-box — Product & UX Roadmap
|
||||||
|
|
||||||
|
> An F1-geek + product/UX analysis of box-box as an F1 companion, and a
|
||||||
|
> prioritized plan to make it richer than "data in tables" — for both live race
|
||||||
|
> weekends and the quiet stretch between rounds.
|
||||||
|
|
||||||
|
## Where the app is today (honest read)
|
||||||
|
|
||||||
|
box-box has a strong data layer with two front doors (TUI + web) and six web
|
||||||
|
surfaces:
|
||||||
|
|
||||||
|
| Surface | What it does today | Where it's thin |
|
||||||
|
|---|---|---|
|
||||||
|
| **Command Center** (`/`) | Hero weekend + countdown, season calendar, championship snapshot, weekend schedule, news | Strong launcher, but tells you *when*, rarely *what to care about*. It's a menu, not a companion |
|
||||||
|
| **Race Hub** (`/race-hub`) | Per-session tabs: Overview, Race Story (position-evolution scrubber), Strategy (stints), Laps, Conditions, Race Control | `RaceStoryCanvas` is the best "beyond tables" work in the app. Everything else is still tables |
|
||||||
|
| **Live Timing** (`/live`) | SSE timing tower, battle chips, gap sparklines, pinned drivers, RC feed | Solid tower, but it's "a spreadsheet that updates" — no track map, no telemetry, no "what just happened" |
|
||||||
|
| **Championship** (`/championship`) | Standings + hub stats (wins/poles/form) + points simulator | Good; the simulator is a genuine differentiator |
|
||||||
|
| **Briefing** (`/briefing`) | 7 RSS feeds (FIA, BBC, Autosport, RaceFans, Guardian, RACER, F1 YouTube) + readability extraction | Passive reading list, not tied to the season narrative |
|
||||||
|
| **Data Library** (`/admin`) | Ingestion / coverage admin | Fine as-is |
|
||||||
|
|
||||||
|
**Biggest finding:** the app already *pulls* the richest data in F1 — GPS
|
||||||
|
`Location`, full car telemetry (throttle / brake / DRS / gear / rpm / speed),
|
||||||
|
team-radio audio, mini-sector `Segments`, speed traps, overtakes — and the web
|
||||||
|
app visualizes almost none of it. The **track map exists only in the TUI**
|
||||||
|
(`internal/ui/trackmap.go`); telemetry is fetched and shown to nobody. This is a
|
||||||
|
large latent asset.
|
||||||
|
|
||||||
|
## Core product thesis
|
||||||
|
|
||||||
|
An F1 companion serves two different jobs; the app currently treats them the same
|
||||||
|
(data, in tables, per session):
|
||||||
|
|
||||||
|
1. **On a race weekend — the "second screen."** The user is watching the
|
||||||
|
broadcast (or can't, and wants to *feel* it). They want: what's happening now,
|
||||||
|
why it matters, what to watch next. The broadcast supplies emotion; box-box
|
||||||
|
should supply **the data the broadcast doesn't show** — the delta the director
|
||||||
|
cut away from, the undercut developing, the tyre cliff approaching.
|
||||||
|
|
||||||
|
2. **Between races — "understand the season."** No live action. The user wants to
|
||||||
|
make sense of what happened and anticipate what's next: rewatch the story of
|
||||||
|
the last race, argue strategy, track the title fight, get smart before the next
|
||||||
|
round.
|
||||||
|
|
||||||
|
Everything below makes each job *feel* like a companion instead of a database.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Race-weekend experience ("second screen")
|
||||||
|
|
||||||
|
### 1. Live Track Map — highest-leverage missing feature
|
||||||
|
Port the TUI's GPS outline (`trackmap.go`, `GetLocation`) to a web SVG dot-map:
|
||||||
|
cars as team-colored dots on the circuit outline, DRS zones highlighted, sectors
|
||||||
|
tinted by status. Turn mini-sectors purple/green live using the `Segments` data
|
||||||
|
already fetched. Tap a car → mini-telemetry readout. This is what turns "updating
|
||||||
|
spreadsheet" into "I'm watching the race."
|
||||||
|
|
||||||
|
### 2. "What just happened" synthesized event rail — the companion voice
|
||||||
|
Combine Race Control + overtakes + pit stops + position deltas into plain-English
|
||||||
|
beats: *"LAP 34 — VER pits (2.4s), rejoins P4 behind NOR — undercut on RUS is
|
||||||
|
live."* The inputs all exist; this is a synthesis layer, not new data. It's the
|
||||||
|
difference between *data* and *commentary*.
|
||||||
|
|
||||||
|
### 3. Telemetry compare overlay
|
||||||
|
On the tower / a driver panel, pick two drivers → overlaid speed/throttle/brake
|
||||||
|
traces + delta-time graph for their last comparable lap. *The* tifosi feature —
|
||||||
|
"where did Leclerc lose the lap." `/api/v1/laps/comparison` + car data already
|
||||||
|
exist; this needs a chart, not a table.
|
||||||
|
|
||||||
|
### 4. Live strategy / tyre-degradation view
|
||||||
|
Stints + tyre age + pit-lane times → live pit window and tyre-cliff panel, with
|
||||||
|
**undercut/overcut threat** indicators from gap-to-car-behind vs. pit-loss time.
|
||||||
|
The pit-window calculator exists in the TUI (`pitwindow.go`); bring it to the web
|
||||||
|
and make it live.
|
||||||
|
|
||||||
|
### 5. Team radio, surfaced
|
||||||
|
`GetTeamRadio` returns audio clips. Add a "Radio" ticker on the live page — play
|
||||||
|
button + driver + timestamp. Peak emotional content, and no rival dashboard has it
|
||||||
|
inline.
|
||||||
|
|
||||||
|
### 6. Session-aware Command Center
|
||||||
|
When a session is live, the home hero should pull the top battles, leader gap, and
|
||||||
|
last RC flag onto the front page instead of only saying "LIVE." Make the front
|
||||||
|
page reactive to the moment.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Between-races experience ("understand the season")
|
||||||
|
|
||||||
|
### 7. Race replay as a first-class story
|
||||||
|
Grow `RaceStoryCanvas` from a scrubber into a narrative replay: auto-generated
|
||||||
|
"chapters" (start, first pit phase, VSC, decisive overtake, finish) with a
|
||||||
|
headline each (derived from RC + position swings), and scrub the position graph
|
||||||
|
and track map together. The "watch the race in 90 seconds" mode that makes people
|
||||||
|
open the app on a Tuesday.
|
||||||
|
|
||||||
|
### 8. Driver pages + rivalry view (a real gap)
|
||||||
|
No driver profile exists in the web app. Add a **driver page** (season form,
|
||||||
|
teammate H2H — already computed in the champ hub — quali vs. race pace, tyre
|
||||||
|
management, track-by-track) and a **rivalry view** (two drivers → cumulative
|
||||||
|
points, H2H, gap-over-season). Feeds the argument every fan has.
|
||||||
|
|
||||||
|
### 9. Next-race preview / "get smart" page
|
||||||
|
Between races the app goes quiet. Fill it: circuit characteristics, last year's
|
||||||
|
result (2023/24 is cached), typical strategy (1 vs 2 stop), DRS zones, weather
|
||||||
|
outlook, and the storylines (title-fight math to watch). Turn dead air into
|
||||||
|
anticipation.
|
||||||
|
|
||||||
|
### 10. Championship scenario narratives
|
||||||
|
Extend the simulator from "drag points around" to narrative permutations:
|
||||||
|
*"VER clinches if he outscores NOR by 9 this weekend"* / *"first race McLaren can
|
||||||
|
seal constructors'."* The stuff fans actually search for.
|
||||||
|
|
||||||
|
### 11. Briefing → calendar-aware season digest
|
||||||
|
Reframe the news reader into a paddock digest tied to the calendar: group by GP,
|
||||||
|
tag by team/driver, surface a "since last race" summary. Optionally an
|
||||||
|
LLM-generated weekly briefing (a `claude-haiku` summarization pass over ingested
|
||||||
|
RSS — cheap and on-brand).
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## New / better data sources
|
||||||
|
|
||||||
|
- **Jolpica (Ergast successor, `api.jolpi.ca`)** — free historical results back to
|
||||||
|
1950: qualifying, pit stops, lap times, circuit metadata. Unlocks all-time
|
||||||
|
records, "best-ever at this track," and career stats OpenF1 (2023+) can't give.
|
||||||
|
High value for driver pages and the "get smart" preview.
|
||||||
|
- **OpenF1 weather timeseries** — already fetched; plot it as a session-long strip
|
||||||
|
(track temp / rain / wind) instead of a table. Weather narrates strategy.
|
||||||
|
- **Circuit metadata / DRS zones / corner names** — enriches the track map and
|
||||||
|
previews. Some is in OpenF1 circuit info; curate the rest once as static data.
|
||||||
|
- **Static per-race context** — a tiny curated JSON per round (tyre allocation,
|
||||||
|
notable stats) goes a long way for previews.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Cross-cutting UX principles
|
||||||
|
|
||||||
|
1. **Replace tables with a shape wherever a shape carries the meaning.** Lap times
|
||||||
|
→ a trace with fastest lap marked. Stints → a horizontal tyre timeline. Gaps →
|
||||||
|
the sparkline already shipped. Keep tables only where data is genuinely tabular
|
||||||
|
(standings) — but annotate them.
|
||||||
|
2. **Always answer "so what?"** Every number sits next to its meaning (a gap next
|
||||||
|
to "undercut live," a tyre age next to "5 laps from the cliff").
|
||||||
|
3. **One primary "moment" per screen.** The Command Center should always have a
|
||||||
|
single obvious "here's what to watch/do now."
|
||||||
|
4. **Make between-races feel alive.** The app currently rewards you only on
|
||||||
|
Sundays. Previews, digests, replays, and rivalries give a reason to open it
|
||||||
|
midweek.
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Suggested sequencing (impact × effort)
|
||||||
|
|
||||||
|
**Phase 1 — turn live into a companion (highest impact; data already in hand)**
|
||||||
|
1. Web track map (SVG + GPS + mini-sectors)
|
||||||
|
2. Telemetry compare overlay (speed/throttle/brake + delta)
|
||||||
|
3. "What just happened" synthesized event rail
|
||||||
|
4. Team radio ticker
|
||||||
|
|
||||||
|
**Phase 2 — own the between-races window**
|
||||||
|
5. Narrative race replay (grow `RaceStoryCanvas`)
|
||||||
|
6. Driver pages + rivalry view
|
||||||
|
7. Next-race preview page
|
||||||
|
|
||||||
|
**Phase 3 — depth & reach**
|
||||||
|
8. Jolpica/Ergast historical integration + all-time records
|
||||||
|
9. Championship scenario narratives
|
||||||
|
10. Calendar-aware briefing digest (optional LLM summaries)
|
||||||
|
|
||||||
|
---
|
||||||
|
|
||||||
|
## Execution tracking (GitHub)
|
||||||
|
|
||||||
|
This roadmap is tracked on GitHub:
|
||||||
|
|
||||||
|
- **Project board:** https://github.com/users/AmanTahiliani/projects/2 ("box-box Roadmap")
|
||||||
|
- **Epics:** issues #2–#8 (label `epic`), one per epic above, on Phase milestones
|
||||||
|
- **Stories:** issues #9–#31, wired as native **sub-issues** under their epic (progress rolls up automatically)
|
||||||
|
- **Labels:** `epic`, `enabler`, `research`, `area:{live,viz,between-races,championship,data,ux}`
|
||||||
|
- **Milestones:** `Phase 1 — Live Companion`, `Phase 2 — Between-Races`, `Phase 3 — Depth & Reach`
|
||||||
|
|
||||||
|
**Board fields:** `Stage` (Icebox → Research → Ready → In Progress → In Review → Done),
|
||||||
|
`Priority` (P0–P2), `Effort` (S/M/L), `Phase` (1–3).
|
||||||
|
|
||||||
|
**Working model — active vs. bank:**
|
||||||
|
- Only **1–2 epics active** at a time (currently **E1 Live Race Companion** + **E2 Viz
|
||||||
|
Primitives**); the other five epics are the theme-level idea bank.
|
||||||
|
- `Stage = Icebox` is the story-level bank. The 10 E1/E2 stories are seeded to
|
||||||
|
`Ready`; everything else is `Icebox`. Promote a handful to `Ready`/`In Progress`
|
||||||
|
per cycle; use `Research` to scope a vague idea before it's `Ready`.
|
||||||
|
**Board views** (built):
|
||||||
|
- **Backlog** — Table, all epics with expandable sub-issues: the full bank.
|
||||||
|
- **Board** — grouped by `Stage`, filtered `-stage:Icebox`: the active-WIP wall.
|
||||||
|
- **Roadmap** — Table grouped by `Phase` (Phase 1/2/3). Note: this is a
|
||||||
|
phase-grouped table, not a timeline. A true timeline roadmap needs a date or
|
||||||
|
iteration field (GitHub won't draw/persist a roadmap layout without one); add a
|
||||||
|
`Target date` field and populate it once phases have real target dates, then
|
||||||
|
switch this view to the Roadmap layout.
|
||||||
BIN
docs/phase-1/screenshots/command-center-hero-between.png
Normal file
BIN
docs/phase-1/screenshots/command-center-hero-between.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 66 KiB |
BIN
docs/phase-1/screenshots/live-event-tyre-radio-mocked.png
Normal file
BIN
docs/phase-1/screenshots/live-event-tyre-radio-mocked.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 102 KiB |
BIN
docs/phase-1/screenshots/race-hub-compare-telemetry-delta.png
Normal file
BIN
docs/phase-1/screenshots/race-hub-compare-telemetry-delta.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 93 KiB |
BIN
docs/phase-1/screenshots/race-hub-strategy-timeline.png
Normal file
BIN
docs/phase-1/screenshots/race-hub-strategy-timeline.png
Normal file
Binary file not shown.
|
After Width: | Height: | Size: 42 KiB |
@@ -1,11 +1,17 @@
|
|||||||
import type {
|
import type {
|
||||||
ArticleContent,
|
ArticleContent,
|
||||||
|
CarDataSample,
|
||||||
ChampionshipHub,
|
ChampionshipHub,
|
||||||
|
EnrichedGrid,
|
||||||
|
EnrichedResult,
|
||||||
|
LapsComparisonResponse,
|
||||||
LiveStateResponse,
|
LiveStateResponse,
|
||||||
|
LiveSessionMeta,
|
||||||
Meeting,
|
Meeting,
|
||||||
NewsItem,
|
NewsItem,
|
||||||
RaceHub,
|
RaceHub,
|
||||||
Session,
|
Session,
|
||||||
|
TrackOutline,
|
||||||
Weekend,
|
Weekend,
|
||||||
} from './types'
|
} from './types'
|
||||||
|
|
||||||
@@ -36,7 +42,11 @@ export async function fetchLocalMeetings(year: number): Promise<Meeting[]> {
|
|||||||
}
|
}
|
||||||
|
|
||||||
export async function fetchSeasonMeetings(year: number): Promise<Meeting[]> {
|
export async function fetchSeasonMeetings(year: number): Promise<Meeting[]> {
|
||||||
const res = await fetch(`/api/v1/meetings?year=${year}&source=openf1`)
|
return fetchMeetings(year, 'openf1')
|
||||||
|
}
|
||||||
|
|
||||||
|
export async function fetchMeetings(year: number, source = 'auto'): Promise<Meeting[]> {
|
||||||
|
const res = await fetch(`/api/v1/meetings?year=${year}&source=${source}`)
|
||||||
if (!res.ok) {
|
if (!res.ok) {
|
||||||
throw new Error(`API ${res.status}: ${res.statusText}`)
|
throw new Error(`API ${res.status}: ${res.statusText}`)
|
||||||
}
|
}
|
||||||
@@ -44,6 +54,32 @@ export async function fetchSeasonMeetings(year: number): Promise<Meeting[]> {
|
|||||||
return Array.isArray(meetings) ? meetings : []
|
return Array.isArray(meetings) ? meetings : []
|
||||||
}
|
}
|
||||||
|
|
||||||
|
export async function fetchResults(sessionKey: number, source = 'auto'): Promise<EnrichedResult[]> {
|
||||||
|
const res = await fetch(`/api/v1/results?session_key=${sessionKey}&source=${source}`)
|
||||||
|
if (!res.ok) {
|
||||||
|
throw new Error(`API ${res.status}: ${res.statusText}`)
|
||||||
|
}
|
||||||
|
const results = await res.json()
|
||||||
|
return Array.isArray(results) ? results : []
|
||||||
|
}
|
||||||
|
|
||||||
|
export async function fetchStartingGrid(sessionKey: number, source = 'auto'): Promise<EnrichedGrid[]> {
|
||||||
|
const res = await fetch(`/api/v1/grid?session_key=${sessionKey}&source=${source}`)
|
||||||
|
if (!res.ok) {
|
||||||
|
throw new Error(`API ${res.status}: ${res.statusText}`)
|
||||||
|
}
|
||||||
|
const grid = await res.json()
|
||||||
|
return Array.isArray(grid) ? grid : []
|
||||||
|
}
|
||||||
|
|
||||||
|
export async function fetchTrackOutline(circuitKey: number, year: number): Promise<TrackOutline | null> {
|
||||||
|
const res = await fetch(`/api/v1/track-outline?circuit_key=${circuitKey}&year=${year}`)
|
||||||
|
if (!res.ok) return null
|
||||||
|
const data = await res.json()
|
||||||
|
if (data?.error || !Array.isArray(data?.points) || data.points.length < 2) return null
|
||||||
|
return data as TrackOutline
|
||||||
|
}
|
||||||
|
|
||||||
export async function fetchSessions(meetingKey: number, source = 'openf1'): Promise<Session[]> {
|
export async function fetchSessions(meetingKey: number, source = 'openf1'): Promise<Session[]> {
|
||||||
const res = await fetch(`/api/v1/sessions?meeting_key=${meetingKey}&source=${source}`)
|
const res = await fetch(`/api/v1/sessions?meeting_key=${meetingKey}&source=${source}`)
|
||||||
if (!res.ok) {
|
if (!res.ok) {
|
||||||
@@ -80,6 +116,20 @@ export async function fetchLiveState(): Promise<LiveStateResponse> {
|
|||||||
return res.json()
|
return res.json()
|
||||||
}
|
}
|
||||||
|
|
||||||
|
export async function fetchLiveTrackOutline(
|
||||||
|
session: LiveSessionMeta,
|
||||||
|
year = new Date().getFullYear(),
|
||||||
|
): Promise<TrackOutline> {
|
||||||
|
const params = new URLSearchParams({ year: year.toString() })
|
||||||
|
if (session.MeetingName) params.set('meeting_name', session.MeetingName)
|
||||||
|
if (session.CircuitName) params.set('circuit_name', session.CircuitName)
|
||||||
|
const res = await fetch(`/api/v1/track-outline?${params.toString()}`)
|
||||||
|
if (!res.ok) {
|
||||||
|
throw new Error(`API ${res.status}: ${res.statusText}`)
|
||||||
|
}
|
||||||
|
return res.json()
|
||||||
|
}
|
||||||
|
|
||||||
export async function fetchNews(limit?: number, source?: string): Promise<NewsItem[]> {
|
export async function fetchNews(limit?: number, source?: string): Promise<NewsItem[]> {
|
||||||
const params = new URLSearchParams()
|
const params = new URLSearchParams()
|
||||||
if (limit) params.set('limit', limit.toString())
|
if (limit) params.set('limit', limit.toString())
|
||||||
@@ -110,3 +160,32 @@ export async function markNewsRead(articleUrl: string): Promise<void> {
|
|||||||
body: JSON.stringify({ url: articleUrl }),
|
body: JSON.stringify({ url: articleUrl }),
|
||||||
})
|
})
|
||||||
}
|
}
|
||||||
|
|
||||||
|
export async function fetchTelemetry(
|
||||||
|
sessionKey: number,
|
||||||
|
driverNumber: number,
|
||||||
|
): Promise<CarDataSample[]> {
|
||||||
|
const res = await fetch(
|
||||||
|
`/api/v1/telemetry?session_key=${sessionKey}&driver_number=${driverNumber}`,
|
||||||
|
)
|
||||||
|
if (!res.ok) {
|
||||||
|
throw new Error(`API ${res.status}: ${res.statusText}`)
|
||||||
|
}
|
||||||
|
const data = await res.json()
|
||||||
|
return Array.isArray(data) ? data : []
|
||||||
|
}
|
||||||
|
|
||||||
|
export async function fetchLapsComparison(
|
||||||
|
sessionKey: number,
|
||||||
|
drivers?: number[],
|
||||||
|
): Promise<LapsComparisonResponse> {
|
||||||
|
const params = new URLSearchParams({ session_key: String(sessionKey) })
|
||||||
|
if (drivers?.length) {
|
||||||
|
params.set('drivers', drivers.join(','))
|
||||||
|
}
|
||||||
|
const res = await fetch(`/api/v1/laps/comparison?${params}`)
|
||||||
|
if (!res.ok) {
|
||||||
|
throw new Error(`API ${res.status}: ${res.statusText}`)
|
||||||
|
}
|
||||||
|
return res.json()
|
||||||
|
}
|
||||||
|
|||||||
415
frontend/src/components/CommandCenterHero.tsx
Normal file
415
frontend/src/components/CommandCenterHero.tsx
Normal file
@@ -0,0 +1,415 @@
|
|||||||
|
import { Link } from '@tanstack/react-router'
|
||||||
|
import { Activity, ArrowRight, Play } from 'lucide-react'
|
||||||
|
import { sessionTypeAbbrev } from '../lib/coverage'
|
||||||
|
import { countryDecal, countryFlag, formatGpDateRange } from '../lib/gpIdentity'
|
||||||
|
import { classifySessionStatus, type HeroStateKind } from '../lib/hero'
|
||||||
|
import { sortLiveTimingRows, trackStatusInfo } from '../lib/live'
|
||||||
|
import {
|
||||||
|
formatCountdown,
|
||||||
|
formatSessionScheduleTime,
|
||||||
|
meetingStartTime,
|
||||||
|
sessionStartTime,
|
||||||
|
type FocusMeetingKind,
|
||||||
|
} from '../lib/schedule'
|
||||||
|
import type { EnrichedResult, LiveStreamData, Meeting, Session, WeekendSession } from '../types'
|
||||||
|
import '../styles/hero.css'
|
||||||
|
|
||||||
|
export interface CommandCenterHeroProps {
|
||||||
|
state: HeroStateKind
|
||||||
|
now: Date
|
||||||
|
accent: string
|
||||||
|
liveActive: boolean
|
||||||
|
liveData: LiveStreamData | null | undefined
|
||||||
|
focusMeeting: Meeting
|
||||||
|
focusKind: FocusMeetingKind
|
||||||
|
sessions: WeekendSession[]
|
||||||
|
currentSession: Session | null
|
||||||
|
nextSession: Session | null
|
||||||
|
analysisSessionKey?: number
|
||||||
|
analysisSessionName?: string
|
||||||
|
lastRaceName: string
|
||||||
|
lastRacePodium: EnrichedResult[]
|
||||||
|
lastRaceSessionKey?: number
|
||||||
|
nextMeeting: Meeting | null
|
||||||
|
}
|
||||||
|
|
||||||
|
export function CommandCenterHero({
|
||||||
|
state,
|
||||||
|
now,
|
||||||
|
accent,
|
||||||
|
liveActive,
|
||||||
|
liveData,
|
||||||
|
focusMeeting,
|
||||||
|
focusKind,
|
||||||
|
sessions,
|
||||||
|
currentSession,
|
||||||
|
nextSession,
|
||||||
|
analysisSessionKey,
|
||||||
|
analysisSessionName,
|
||||||
|
lastRaceName,
|
||||||
|
lastRacePodium,
|
||||||
|
lastRaceSessionKey,
|
||||||
|
nextMeeting,
|
||||||
|
}: CommandCenterHeroProps) {
|
||||||
|
const accentStyle = {
|
||||||
|
'--gp-accent': accent,
|
||||||
|
'--hero-accent': accent,
|
||||||
|
} as React.CSSProperties
|
||||||
|
|
||||||
|
return (
|
||||||
|
<div className="hero-panel cc-hero" data-testid="cc-focus">
|
||||||
|
<section className="hero-card ui-card glass-panel" style={accentStyle}>
|
||||||
|
<div
|
||||||
|
className={`hero-accent${state === 'live' ? ' hero-accent--live' : ''}`}
|
||||||
|
aria-hidden="true"
|
||||||
|
/>
|
||||||
|
<div className="hero-body">
|
||||||
|
<div className="hero-inner">
|
||||||
|
{state === 'live' && (
|
||||||
|
<LiveHero
|
||||||
|
liveActive={liveActive}
|
||||||
|
liveData={liveData}
|
||||||
|
currentSession={currentSession}
|
||||||
|
focusMeeting={focusMeeting}
|
||||||
|
/>
|
||||||
|
)}
|
||||||
|
{state === 'upcoming' && (
|
||||||
|
<UpcomingHero
|
||||||
|
now={now}
|
||||||
|
focusMeeting={focusMeeting}
|
||||||
|
focusKind={focusKind}
|
||||||
|
sessions={sessions}
|
||||||
|
currentSession={currentSession}
|
||||||
|
nextSession={nextSession}
|
||||||
|
liveActive={liveActive}
|
||||||
|
analysisSessionKey={analysisSessionKey}
|
||||||
|
analysisSessionName={analysisSessionName}
|
||||||
|
/>
|
||||||
|
)}
|
||||||
|
{state === 'between' && (
|
||||||
|
<BetweenHero
|
||||||
|
now={now}
|
||||||
|
lastRaceName={lastRaceName}
|
||||||
|
lastRacePodium={lastRacePodium}
|
||||||
|
lastRaceSessionKey={lastRaceSessionKey}
|
||||||
|
nextMeeting={nextMeeting}
|
||||||
|
analysisSessionKey={analysisSessionKey}
|
||||||
|
analysisSessionName={analysisSessionName}
|
||||||
|
/>
|
||||||
|
)}
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</section>
|
||||||
|
</div>
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
function LiveHero({
|
||||||
|
liveActive,
|
||||||
|
liveData,
|
||||||
|
currentSession,
|
||||||
|
focusMeeting,
|
||||||
|
}: {
|
||||||
|
liveActive: boolean
|
||||||
|
liveData: LiveStreamData | null | undefined
|
||||||
|
currentSession: Session | null
|
||||||
|
focusMeeting: Meeting
|
||||||
|
}) {
|
||||||
|
const sessionName =
|
||||||
|
liveData?.Session?.SessionName ?? currentSession?.session_name ?? 'Live session'
|
||||||
|
const trackStatus = trackStatusInfo(liveData?.TrackStatus)
|
||||||
|
const topThree = sortLiveTimingRows(liveData).filter((r) => r.Position > 0).slice(0, 3)
|
||||||
|
const decal = countryDecal(focusMeeting)
|
||||||
|
|
||||||
|
return (
|
||||||
|
<>
|
||||||
|
<div className="hero-row">
|
||||||
|
<span className="hero-decal mono">{decal}</span>
|
||||||
|
<div className="hero-identity">
|
||||||
|
<div className="hero-eyebrow hero-eyebrow--live mono">● Live now</div>
|
||||||
|
<h1 className="hero-title">{sessionName}</h1>
|
||||||
|
<div className="hero-sub mono">
|
||||||
|
{[focusMeeting.meeting_name, focusMeeting.circuit_short_name].filter(Boolean).join(' · ')}
|
||||||
|
</div>
|
||||||
|
<div className={`hero-track-status hero-track-status--${trackStatus.key}`}>
|
||||||
|
{trackStatus.label}
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
{topThree.length > 0 && (
|
||||||
|
<div className="hero-timing" data-testid="hero-live-timing">
|
||||||
|
{topThree.map((row) => (
|
||||||
|
<div key={row.RacingNumber} className="hero-timing-row">
|
||||||
|
<span className={`hero-timing-pos hero-timing-pos--p${row.Position}`}>
|
||||||
|
P{row.Position}
|
||||||
|
</span>
|
||||||
|
<span className="hero-timing-driver">
|
||||||
|
<span
|
||||||
|
className="hero-timing-bar"
|
||||||
|
style={{ background: `#${row.Info?.TeamColour ?? '9aa0a6'}` }}
|
||||||
|
/>
|
||||||
|
{row.Info?.Tla ?? row.RacingNumber}
|
||||||
|
</span>
|
||||||
|
<span className="hero-timing-gap">
|
||||||
|
{row.Position === 1 ? 'LEAD' : row.Driver.Interval || row.Driver.GapToLeader || '—'}
|
||||||
|
</span>
|
||||||
|
</div>
|
||||||
|
))}
|
||||||
|
</div>
|
||||||
|
)}
|
||||||
|
<div className="hero-countdown">
|
||||||
|
<div className="hero-cd-label mono">{liveActive ? 'SignalR' : 'On track'}</div>
|
||||||
|
<div className="hero-cd-value hero-cd-value--live mono">LIVE</div>
|
||||||
|
<div className="hero-cd-sub mono">{sessionName}</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
<div className="hero-actions">
|
||||||
|
<Link to="/live" className="hero-cta hero-cta--primary" data-testid="hero-live-link">
|
||||||
|
Open Live Timing <ArrowRight size={16} />
|
||||||
|
</Link>
|
||||||
|
</div>
|
||||||
|
</>
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
function UpcomingHero({
|
||||||
|
now,
|
||||||
|
focusMeeting,
|
||||||
|
focusKind,
|
||||||
|
sessions,
|
||||||
|
currentSession,
|
||||||
|
nextSession,
|
||||||
|
liveActive,
|
||||||
|
analysisSessionKey,
|
||||||
|
analysisSessionName,
|
||||||
|
}: {
|
||||||
|
now: Date
|
||||||
|
focusMeeting: Meeting
|
||||||
|
focusKind: FocusMeetingKind
|
||||||
|
sessions: WeekendSession[]
|
||||||
|
currentSession: Session | null
|
||||||
|
nextSession: Session | null
|
||||||
|
liveActive: boolean
|
||||||
|
analysisSessionKey?: number
|
||||||
|
analysisSessionName?: string
|
||||||
|
}) {
|
||||||
|
const decal = countryDecal(focusMeeting)
|
||||||
|
const countdownTarget =
|
||||||
|
nextSession && sessionStartTime(nextSession)
|
||||||
|
? sessionStartTime(nextSession)!
|
||||||
|
: meetingStartTime(focusMeeting)
|
||||||
|
|
||||||
|
const kindLabel =
|
||||||
|
focusKind === 'current'
|
||||||
|
? 'Current weekend'
|
||||||
|
: focusKind === 'next'
|
||||||
|
? 'Next weekend'
|
||||||
|
: 'Weekend'
|
||||||
|
|
||||||
|
const sortedSessions = [...sessions].sort((a, b) => {
|
||||||
|
const left = sessionStartTime(a.session)?.getTime() ?? 0
|
||||||
|
const right = sessionStartTime(b.session)?.getTime() ?? 0
|
||||||
|
return left - right
|
||||||
|
})
|
||||||
|
|
||||||
|
return (
|
||||||
|
<>
|
||||||
|
<div className="hero-row">
|
||||||
|
<span className="hero-decal mono">{decal}</span>
|
||||||
|
<div className="hero-identity">
|
||||||
|
<div className="hero-eyebrow mono">{kindLabel}</div>
|
||||||
|
<h1 className="hero-title">{focusMeeting.meeting_name}</h1>
|
||||||
|
<div className="hero-sub mono">
|
||||||
|
{[focusMeeting.location, focusMeeting.circuit_short_name].filter(Boolean).join(' · ')}
|
||||||
|
</div>
|
||||||
|
<div className="hero-sub mono">{formatGpDateRange(focusMeeting)}</div>
|
||||||
|
</div>
|
||||||
|
<div className="hero-countdown" data-testid="hero-countdown">
|
||||||
|
{nextSession ? (
|
||||||
|
<>
|
||||||
|
<div className="hero-cd-label mono">Next · {nextSession.session_name}</div>
|
||||||
|
{countdownTarget && (
|
||||||
|
<div className="hero-cd-value mono">{formatCountdown(countdownTarget, now)}</div>
|
||||||
|
)}
|
||||||
|
<div className="hero-cd-sub mono">{formatSessionScheduleTime(nextSession.date_start)}</div>
|
||||||
|
</>
|
||||||
|
) : (
|
||||||
|
<>
|
||||||
|
<div className="hero-cd-label mono">Status</div>
|
||||||
|
<div className="hero-cd-value mono">Complete</div>
|
||||||
|
<div className="hero-cd-sub mono">Weekend finished</div>
|
||||||
|
</>
|
||||||
|
)}
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
{sortedSessions.length > 0 && (
|
||||||
|
<div className="hero-schedule-strip" data-testid="hero-schedule-strip" role="list">
|
||||||
|
{sortedSessions.map(({ session }) => {
|
||||||
|
const status = classifySessionStatus(session, now)
|
||||||
|
const isNext = nextSession?.session_key === session.session_key
|
||||||
|
const isCurrent = currentSession?.session_key === session.session_key
|
||||||
|
const isLive = isCurrent && liveActive
|
||||||
|
return (
|
||||||
|
<Link
|
||||||
|
key={session.session_key}
|
||||||
|
to="/race-hub"
|
||||||
|
search={{ session_key: session.session_key }}
|
||||||
|
className={`hero-schedule-card${isNext ? ' is-next' : ''}${
|
||||||
|
status === 'done' ? ' is-done' : ''
|
||||||
|
}${isLive ? ' is-live' : ''}`}
|
||||||
|
role="listitem"
|
||||||
|
>
|
||||||
|
<div className="hero-schedule-abbrev mono">
|
||||||
|
{sessionTypeAbbrev(session.session_type, session.session_name)}
|
||||||
|
</div>
|
||||||
|
<div className="hero-schedule-name">{session.session_name}</div>
|
||||||
|
<div className="hero-schedule-time mono">
|
||||||
|
{formatSessionScheduleTime(session.date_start)}
|
||||||
|
</div>
|
||||||
|
<div
|
||||||
|
className={`hero-schedule-marker mono${
|
||||||
|
isLive ? ' hero-schedule-marker--live' : isNext ? ' hero-schedule-marker--next' : ''
|
||||||
|
}`}
|
||||||
|
>
|
||||||
|
{isCurrent ? 'On track' : status === 'done' ? 'Done' : isNext ? 'Next' : 'Upcoming'}
|
||||||
|
</div>
|
||||||
|
</Link>
|
||||||
|
)
|
||||||
|
})}
|
||||||
|
</div>
|
||||||
|
)}
|
||||||
|
|
||||||
|
<div className="hero-actions">
|
||||||
|
<Link
|
||||||
|
to="/live"
|
||||||
|
className="hero-secondary-link"
|
||||||
|
style={{ display: 'inline-flex', alignItems: 'center', gap: '6px' }}
|
||||||
|
>
|
||||||
|
<Play size={14} /> Watch Live
|
||||||
|
</Link>
|
||||||
|
{analysisSessionKey != null && (
|
||||||
|
<Link
|
||||||
|
to="/race-hub"
|
||||||
|
search={{ session_key: analysisSessionKey }}
|
||||||
|
className="hero-secondary-link"
|
||||||
|
data-testid="hero-analysis-link"
|
||||||
|
style={{ display: 'inline-flex', alignItems: 'center', gap: '6px' }}
|
||||||
|
>
|
||||||
|
<Activity size={14} /> Open Analysis
|
||||||
|
{analysisSessionName ? ` · ${analysisSessionName}` : ''}
|
||||||
|
</Link>
|
||||||
|
)}
|
||||||
|
</div>
|
||||||
|
</>
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
function BetweenHero({
|
||||||
|
now,
|
||||||
|
lastRaceName,
|
||||||
|
lastRacePodium,
|
||||||
|
lastRaceSessionKey,
|
||||||
|
nextMeeting,
|
||||||
|
analysisSessionKey,
|
||||||
|
analysisSessionName,
|
||||||
|
}: {
|
||||||
|
now: Date
|
||||||
|
lastRaceName: string
|
||||||
|
lastRacePodium: EnrichedResult[]
|
||||||
|
lastRaceSessionKey?: number
|
||||||
|
nextMeeting: Meeting | null
|
||||||
|
analysisSessionKey?: number
|
||||||
|
analysisSessionName?: string
|
||||||
|
}) {
|
||||||
|
const nextStart = nextMeeting ? meetingStartTime(nextMeeting) : null
|
||||||
|
const podium = lastRacePodium
|
||||||
|
.filter((r) => r.position >= 1 && r.position <= 3)
|
||||||
|
.sort((a, b) => a.position - b.position)
|
||||||
|
|
||||||
|
return (
|
||||||
|
<>
|
||||||
|
<div className="hero-row">
|
||||||
|
<div className="hero-identity">
|
||||||
|
<div className="hero-eyebrow mono">Between race weekends</div>
|
||||||
|
{lastRaceName && (
|
||||||
|
<h1 className="hero-title" data-testid="hero-last-race">
|
||||||
|
After {lastRaceName}
|
||||||
|
</h1>
|
||||||
|
)}
|
||||||
|
{!lastRaceName && <h1 className="hero-title">Season pause</h1>}
|
||||||
|
</div>
|
||||||
|
|
||||||
|
{podium.length > 0 && (
|
||||||
|
<div className="hero-podium" data-testid="hero-podium">
|
||||||
|
{podium.map((r) => (
|
||||||
|
<div key={r.driver_number} className="hero-podium-row">
|
||||||
|
<span className={`hero-podium-pos hero-podium-pos--p${r.position} mono`}>
|
||||||
|
P{r.position}
|
||||||
|
</span>
|
||||||
|
<span className="hero-podium-driver">
|
||||||
|
<span
|
||||||
|
className="hero-timing-bar"
|
||||||
|
style={{ background: `#${r.team_colour}` }}
|
||||||
|
/>
|
||||||
|
{r.name_acronym}
|
||||||
|
</span>
|
||||||
|
</div>
|
||||||
|
))}
|
||||||
|
</div>
|
||||||
|
)}
|
||||||
|
|
||||||
|
{nextMeeting && (
|
||||||
|
<div className="hero-countdown" data-testid="hero-next-gp-countdown">
|
||||||
|
<div className="hero-between-next">
|
||||||
|
{countryFlag(nextMeeting) && (
|
||||||
|
<span className="hero-flag" aria-hidden="true">
|
||||||
|
{countryFlag(nextMeeting)}
|
||||||
|
</span>
|
||||||
|
)}
|
||||||
|
<div>
|
||||||
|
<div className="hero-cd-label mono">Next GP</div>
|
||||||
|
<div className="hero-title" style={{ fontSize: '20px' }}>
|
||||||
|
{nextMeeting.meeting_name}
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
{nextStart && (
|
||||||
|
<>
|
||||||
|
<div className="hero-cd-value mono" style={{ marginTop: 'var(--s3)' }}>
|
||||||
|
{formatCountdown(nextStart, now)}
|
||||||
|
</div>
|
||||||
|
<div className="hero-cd-sub mono">{formatGpDateRange(nextMeeting)}</div>
|
||||||
|
</>
|
||||||
|
)}
|
||||||
|
</div>
|
||||||
|
)}
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div className="hero-actions">
|
||||||
|
{lastRaceSessionKey != null && (
|
||||||
|
<Link
|
||||||
|
to="/race-hub"
|
||||||
|
search={{ session_key: lastRaceSessionKey }}
|
||||||
|
className="hero-secondary-link"
|
||||||
|
data-testid="hero-last-race-link"
|
||||||
|
>
|
||||||
|
View {lastRaceName || 'last race'} results →
|
||||||
|
</Link>
|
||||||
|
)}
|
||||||
|
{analysisSessionKey != null && analysisSessionKey !== lastRaceSessionKey && (
|
||||||
|
<Link
|
||||||
|
to="/race-hub"
|
||||||
|
search={{ session_key: analysisSessionKey }}
|
||||||
|
className="hero-secondary-link"
|
||||||
|
data-testid="hero-analysis-link"
|
||||||
|
>
|
||||||
|
Open Analysis{analysisSessionName ? ` · ${analysisSessionName}` : ''}
|
||||||
|
</Link>
|
||||||
|
)}
|
||||||
|
<Link to="/live" className="hero-secondary-link">
|
||||||
|
Live Timing →
|
||||||
|
</Link>
|
||||||
|
</div>
|
||||||
|
</>
|
||||||
|
)
|
||||||
|
}
|
||||||
253
frontend/src/components/CompareView.tsx
Normal file
253
frontend/src/components/CompareView.tsx
Normal file
@@ -0,0 +1,253 @@
|
|||||||
|
import { useEffect, useMemo, useRef, useState } from 'react'
|
||||||
|
import { useQuery } from '@tanstack/react-query'
|
||||||
|
import { fetchLapsComparison, fetchTelemetry } from '../api'
|
||||||
|
import {
|
||||||
|
buildBestLapTraceSeries,
|
||||||
|
compareDriverOptions,
|
||||||
|
comparisonToDeltaSeries,
|
||||||
|
defaultCompareDriverNumbers,
|
||||||
|
formatPitLapsCaption,
|
||||||
|
} from '../lib/compare'
|
||||||
|
import type { Driver, EnrichedResult } from '../types'
|
||||||
|
import { teamColor } from '../utils'
|
||||||
|
import { DriverCell } from './DriverCell'
|
||||||
|
import { TelemetryTraceChart } from './charts/TelemetryTraceChart'
|
||||||
|
import { DeltaTimeGraph } from './charts/DeltaTimeGraph'
|
||||||
|
import '../styles/compare-view.css'
|
||||||
|
|
||||||
|
interface Props {
|
||||||
|
sessionKey: number
|
||||||
|
results: EnrichedResult[]
|
||||||
|
drivers: Driver[]
|
||||||
|
}
|
||||||
|
|
||||||
|
function SectionState({
|
||||||
|
loading,
|
||||||
|
error,
|
||||||
|
empty,
|
||||||
|
emptyMessage,
|
||||||
|
children,
|
||||||
|
}: {
|
||||||
|
loading: boolean
|
||||||
|
error: Error | null
|
||||||
|
empty: boolean
|
||||||
|
emptyMessage: string
|
||||||
|
children: React.ReactNode
|
||||||
|
}) {
|
||||||
|
if (loading) {
|
||||||
|
return <div className="loading-state">loading…</div>
|
||||||
|
}
|
||||||
|
if (error) {
|
||||||
|
return <div className="error-box">{error.message}</div>
|
||||||
|
}
|
||||||
|
if (empty) {
|
||||||
|
return <div className="missing-notice">{emptyMessage}</div>
|
||||||
|
}
|
||||||
|
return <>{children}</>
|
||||||
|
}
|
||||||
|
|
||||||
|
export function CompareView({ sessionKey, results, drivers }: Props) {
|
||||||
|
const driverOptions = useMemo(
|
||||||
|
() => compareDriverOptions(drivers, results),
|
||||||
|
[drivers, results],
|
||||||
|
)
|
||||||
|
|
||||||
|
const initialPair = useMemo(
|
||||||
|
() => defaultCompareDriverNumbers(results, drivers),
|
||||||
|
[results, drivers],
|
||||||
|
)
|
||||||
|
|
||||||
|
const previousSessionKey = useRef(sessionKey)
|
||||||
|
const [driverA, setDriverA] = useState<number | null>(initialPair?.[0] ?? null)
|
||||||
|
const [driverB, setDriverB] = useState<number | null>(initialPair?.[1] ?? null)
|
||||||
|
|
||||||
|
useEffect(() => {
|
||||||
|
if (previousSessionKey.current !== sessionKey) {
|
||||||
|
previousSessionKey.current = sessionKey
|
||||||
|
setDriverA(initialPair?.[0] ?? null)
|
||||||
|
setDriverB(initialPair?.[1] ?? null)
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
|
if (driverA != null && driverB != null) return
|
||||||
|
if (!initialPair) return
|
||||||
|
setDriverA(initialPair[0])
|
||||||
|
setDriverB(initialPair[1])
|
||||||
|
}, [sessionKey, initialPair, driverA, driverB])
|
||||||
|
|
||||||
|
const pair = useMemo((): [number, number] | null => {
|
||||||
|
if (driverA == null || driverB == null || driverA === driverB) return null
|
||||||
|
return [driverA, driverB]
|
||||||
|
}, [driverA, driverB])
|
||||||
|
|
||||||
|
const comparisonQuery = useQuery({
|
||||||
|
queryKey: ['laps-comparison', sessionKey, pair?.[0], pair?.[1]],
|
||||||
|
queryFn: () => fetchLapsComparison(sessionKey, pair!),
|
||||||
|
enabled: pair != null,
|
||||||
|
staleTime: 60_000,
|
||||||
|
})
|
||||||
|
|
||||||
|
const telemetryAQuery = useQuery({
|
||||||
|
queryKey: ['telemetry', sessionKey, pair?.[0]],
|
||||||
|
queryFn: () => fetchTelemetry(sessionKey, pair![0]),
|
||||||
|
enabled: pair != null,
|
||||||
|
staleTime: 60_000,
|
||||||
|
})
|
||||||
|
|
||||||
|
const telemetryBQuery = useQuery({
|
||||||
|
queryKey: ['telemetry', sessionKey, pair?.[1]],
|
||||||
|
queryFn: () => fetchTelemetry(sessionKey, pair![1]),
|
||||||
|
enabled: pair != null,
|
||||||
|
staleTime: 60_000,
|
||||||
|
})
|
||||||
|
|
||||||
|
const comparison = comparisonQuery.data
|
||||||
|
const referenceLabel = useMemo(() => {
|
||||||
|
if (!pair) return undefined
|
||||||
|
const meta = comparison?.drivers.find((d) => d.driver_number === pair[0])
|
||||||
|
const session = drivers.find((d) => d.driver_number === pair[0])
|
||||||
|
return meta?.name_acronym || session?.name_acronym
|
||||||
|
}, [pair, comparison, drivers])
|
||||||
|
|
||||||
|
const deltaSeries = useMemo(() => {
|
||||||
|
if (!comparison || !pair) return []
|
||||||
|
return comparisonToDeltaSeries(comparison, pair, drivers)
|
||||||
|
}, [comparison, pair, drivers])
|
||||||
|
|
||||||
|
const pitCaption = useMemo(() => {
|
||||||
|
if (!comparison || !pair) return null
|
||||||
|
return formatPitLapsCaption(comparison.pit_laps, pair, comparison, drivers)
|
||||||
|
}, [comparison, pair, drivers])
|
||||||
|
|
||||||
|
const traceSeries = useMemo(() => {
|
||||||
|
if (!pair || !comparison) return []
|
||||||
|
const out = []
|
||||||
|
|
||||||
|
for (const dn of pair) {
|
||||||
|
const comp = comparison.drivers.find((d) => d.driver_number === dn)
|
||||||
|
const session = drivers.find((d) => d.driver_number === dn)
|
||||||
|
const label = comp?.name_acronym || session?.name_acronym || `#${dn}`
|
||||||
|
const color = teamColor(comp?.team_colour || session?.team_colour)
|
||||||
|
|
||||||
|
const carData =
|
||||||
|
dn === pair[0] ? (telemetryAQuery.data ?? []) : (telemetryBQuery.data ?? [])
|
||||||
|
const series = buildBestLapTraceSeries(carData, comp?.laps ?? [], label, color)
|
||||||
|
if (series) out.push(series)
|
||||||
|
}
|
||||||
|
|
||||||
|
return out
|
||||||
|
}, [pair, comparison, drivers, telemetryAQuery.data, telemetryBQuery.data])
|
||||||
|
|
||||||
|
const telemetryLoading = telemetryAQuery.isLoading || telemetryBQuery.isLoading
|
||||||
|
const telemetryError = telemetryAQuery.error ?? telemetryBQuery.error
|
||||||
|
|
||||||
|
if (driverOptions.length < 2) {
|
||||||
|
return (
|
||||||
|
<div className="missing-notice" data-testid="compare-view-empty">
|
||||||
|
Need at least two drivers in this session to compare.
|
||||||
|
</div>
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
const driverAInfo = driverOptions.find((d) => d.driver_number === driverA)
|
||||||
|
const driverBInfo = driverOptions.find((d) => d.driver_number === driverB)
|
||||||
|
|
||||||
|
return (
|
||||||
|
<div className="compare-view" data-testid="compare-view">
|
||||||
|
<div className="compare-pickers">
|
||||||
|
<div className="compare-picker">
|
||||||
|
<span className="compare-picker-label">Reference</span>
|
||||||
|
<select
|
||||||
|
className="compare-picker-select"
|
||||||
|
value={driverA ?? ''}
|
||||||
|
onChange={(e) => setDriverA(Number(e.target.value))}
|
||||||
|
data-testid="compare-picker-a"
|
||||||
|
>
|
||||||
|
{driverOptions.map((d) => (
|
||||||
|
<option key={d.driver_number} value={d.driver_number}>
|
||||||
|
{d.name_acronym} · #{d.driver_number}
|
||||||
|
</option>
|
||||||
|
))}
|
||||||
|
</select>
|
||||||
|
{driverAInfo && (
|
||||||
|
<DriverCell
|
||||||
|
acronym={driverAInfo.name_acronym}
|
||||||
|
number={driverAInfo.driver_number}
|
||||||
|
colour={driverAInfo.team_colour}
|
||||||
|
/>
|
||||||
|
)}
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div className="compare-picker">
|
||||||
|
<span className="compare-picker-label">Challenger</span>
|
||||||
|
<select
|
||||||
|
className="compare-picker-select"
|
||||||
|
value={driverB ?? ''}
|
||||||
|
onChange={(e) => setDriverB(Number(e.target.value))}
|
||||||
|
data-testid="compare-picker-b"
|
||||||
|
>
|
||||||
|
{driverOptions.map((d) => (
|
||||||
|
<option key={d.driver_number} value={d.driver_number}>
|
||||||
|
{d.name_acronym} · #{d.driver_number}
|
||||||
|
</option>
|
||||||
|
))}
|
||||||
|
</select>
|
||||||
|
{driverBInfo && (
|
||||||
|
<DriverCell
|
||||||
|
acronym={driverBInfo.name_acronym}
|
||||||
|
number={driverBInfo.driver_number}
|
||||||
|
colour={driverBInfo.team_colour}
|
||||||
|
/>
|
||||||
|
)}
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
{driverA === driverB && (
|
||||||
|
<div className="analysis-notice">
|
||||||
|
<strong>Pick two different drivers</strong> to run a comparison.
|
||||||
|
</div>
|
||||||
|
)}
|
||||||
|
|
||||||
|
<section className="compare-section" data-testid="compare-telemetry-section">
|
||||||
|
<div>
|
||||||
|
<div className="compare-section-title">Best lap telemetry</div>
|
||||||
|
<div className="compare-section-meta">
|
||||||
|
Speed, throttle, and brake traces for each driver's fastest lap
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
<SectionState
|
||||||
|
loading={telemetryLoading}
|
||||||
|
error={telemetryError instanceof Error ? telemetryError : null}
|
||||||
|
empty={!telemetryLoading && !telemetryError && traceSeries.length === 0}
|
||||||
|
emptyMessage="No telemetry samples for the best laps. Car data may not be available for this session."
|
||||||
|
>
|
||||||
|
<TelemetryTraceChart series={traceSeries} />
|
||||||
|
</SectionState>
|
||||||
|
</section>
|
||||||
|
|
||||||
|
<section className="compare-section" data-testid="compare-pace-section">
|
||||||
|
<div>
|
||||||
|
<div className="compare-section-title">Race pace</div>
|
||||||
|
<div className="compare-section-meta">
|
||||||
|
Cumulative lap-time delta vs {referenceLabel ?? 'reference'}. Deltas are plotted
|
||||||
|
only where the reference lap is valid; gaps appear when the reference has no lap
|
||||||
|
time.
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
<SectionState
|
||||||
|
loading={comparisonQuery.isLoading}
|
||||||
|
error={comparisonQuery.error instanceof Error ? comparisonQuery.error : null}
|
||||||
|
empty={!comparisonQuery.isLoading && !comparisonQuery.error && deltaSeries.length < 2}
|
||||||
|
emptyMessage="No lap comparison data for the selected drivers."
|
||||||
|
>
|
||||||
|
<DeltaTimeGraph series={deltaSeries} referenceLabel={referenceLabel} />
|
||||||
|
{pitCaption && (
|
||||||
|
<p className="compare-pit-caption" data-testid="compare-pit-caption">
|
||||||
|
{pitCaption}
|
||||||
|
</p>
|
||||||
|
)}
|
||||||
|
</SectionState>
|
||||||
|
</section>
|
||||||
|
</div>
|
||||||
|
)
|
||||||
|
}
|
||||||
26
frontend/src/components/Meaning.tsx
Normal file
26
frontend/src/components/Meaning.tsx
Normal file
@@ -0,0 +1,26 @@
|
|||||||
|
import type { ReactNode } from 'react'
|
||||||
|
import '../styles/meaning.css'
|
||||||
|
|
||||||
|
export interface MeaningProps {
|
||||||
|
value: ReactNode
|
||||||
|
meaning?: string | null
|
||||||
|
/** Long-form explanation for the native tooltip; falls back to meaning. */
|
||||||
|
title?: string | null
|
||||||
|
tone?: 'good' | 'bad' | 'neutral' | 'warn'
|
||||||
|
}
|
||||||
|
|
||||||
|
export function Meaning({ value, meaning, title, tone }: MeaningProps) {
|
||||||
|
if (!meaning) {
|
||||||
|
return <>{value}</>
|
||||||
|
}
|
||||||
|
|
||||||
|
const tooltip = title ?? meaning
|
||||||
|
const toneClass = tone ? `meaning-caption--${tone}` : ''
|
||||||
|
|
||||||
|
return (
|
||||||
|
<span className="meaning" title={tooltip}>
|
||||||
|
<span className="meaning-value">{value}</span>
|
||||||
|
<span className={`meaning-caption ${toneClass}`.trim()}>{meaning}</span>
|
||||||
|
</span>
|
||||||
|
)
|
||||||
|
}
|
||||||
@@ -16,6 +16,9 @@ export function Nav() {
|
|||||||
<Link to="/race-hub" search={{}} activeProps={{ className: 'active' }}>
|
<Link to="/race-hub" search={{}} activeProps={{ className: 'active' }}>
|
||||||
Race Hub
|
Race Hub
|
||||||
</Link>
|
</Link>
|
||||||
|
<Link to="/preview" activeProps={{ className: 'active' }}>
|
||||||
|
Preview
|
||||||
|
</Link>
|
||||||
<Link to="/championship" activeProps={{ className: 'active' }}>
|
<Link to="/championship" activeProps={{ className: 'active' }}>
|
||||||
Championship
|
Championship
|
||||||
</Link>
|
</Link>
|
||||||
|
|||||||
@@ -1,28 +1,9 @@
|
|||||||
import type { EnrichedResult, Stint, PitStop } from '../types'
|
import type { EnrichedResult, Stint, PitStop } from '../types'
|
||||||
import { compareFinishPosition } from '../utils'
|
import { compareFinishPosition } from '../utils'
|
||||||
|
import {
|
||||||
const COMPOUND_COLORS: Record<string, string> = {
|
TyreStintTimeline,
|
||||||
SOFT: '#e8002d',
|
type StintTimelineRow,
|
||||||
MEDIUM: '#ffd600',
|
} from './charts/TyreStintTimeline'
|
||||||
HARD: '#e8e8e4',
|
|
||||||
INTERMEDIATE: '#39b54a',
|
|
||||||
WET: '#0067ff',
|
|
||||||
}
|
|
||||||
|
|
||||||
function compoundColor(c: string): string {
|
|
||||||
return COMPOUND_COLORS[c.toUpperCase()] ?? '#666'
|
|
||||||
}
|
|
||||||
|
|
||||||
function compoundInitial(c: string): string {
|
|
||||||
const abbr: Record<string, string> = {
|
|
||||||
SOFT: 'S',
|
|
||||||
MEDIUM: 'M',
|
|
||||||
HARD: 'H',
|
|
||||||
INTERMEDIATE: 'I',
|
|
||||||
WET: 'W',
|
|
||||||
}
|
|
||||||
return abbr[c.toUpperCase()] ?? c[0] ?? '?'
|
|
||||||
}
|
|
||||||
|
|
||||||
interface Props {
|
interface Props {
|
||||||
results: EnrichedResult[]
|
results: EnrichedResult[]
|
||||||
@@ -89,147 +70,33 @@ export function StrategyView({ results, stints, pit_stops, hasStints }: Props) {
|
|||||||
const cmp = compareFinishPosition(a.position, b.position)
|
const cmp = compareFinishPosition(a.position, b.position)
|
||||||
return cmp !== 0 ? cmp : a.driver_number - b.driver_number
|
return cmp !== 0 ? cmp : a.driver_number - b.driver_number
|
||||||
})
|
})
|
||||||
|
|
||||||
const totalLaps = Math.max(
|
const totalLaps = Math.max(
|
||||||
...stints.map((s) => s.lap_end),
|
...stints.map((s) => s.lap_end),
|
||||||
...results.map((r) => r.number_of_laps),
|
...results.map((r) => r.number_of_laps),
|
||||||
1
|
1,
|
||||||
)
|
)
|
||||||
|
|
||||||
const SVG_W = 640
|
const timelineRows: StintTimelineRow[] = sortedDrivers.map((driver) => ({
|
||||||
const LEFT = 48
|
label: driver.name_acronym || String(driver.driver_number),
|
||||||
const RIGHT = 12
|
color: driver.team_colour ? `#${driver.team_colour}` : '#888',
|
||||||
const ROW_H = 28
|
stints: stints
|
||||||
const BAR_H = 14
|
.filter((s) => s.driver_number === driver.driver_number)
|
||||||
const BAR_Y = 7
|
.map((s) => ({
|
||||||
const BAR_W = SVG_W - LEFT - RIGHT
|
compound: s.compound,
|
||||||
const SVG_H = sortedDrivers.length * ROW_H + 8
|
lapStart: s.lap_start,
|
||||||
|
lapEnd: s.lap_end,
|
||||||
const lapX = (lap: number) => LEFT + ((lap - 1) / totalLaps) * BAR_W
|
isNew: s.tyre_age_at_start === 0,
|
||||||
const stintW = (s: Stint) =>
|
})),
|
||||||
Math.max(2, ((s.lap_end - s.lap_start + 1) / totalLaps) * BAR_W)
|
pitStops: pit_stops
|
||||||
|
.filter((p) => p.driver_number === driver.driver_number)
|
||||||
const usedCompounds = [...new Set(stints.map((s) => s.compound.toUpperCase()))].filter(
|
.map((p) => p.lap_number)
|
||||||
(c) => c in COMPOUND_COLORS
|
.sort((a, b) => a - b),
|
||||||
)
|
}))
|
||||||
|
|
||||||
return (
|
return (
|
||||||
<div data-testid="strategy-chart">
|
<div data-testid="strategy-chart">
|
||||||
<div className="scroll-x">
|
<TyreStintTimeline rows={timelineRows} totalLaps={totalLaps} />
|
||||||
<svg
|
|
||||||
viewBox={`0 0 ${SVG_W} ${SVG_H}`}
|
|
||||||
style={{ width: '100%', minWidth: 280, maxWidth: SVG_W, display: 'block' }}
|
|
||||||
role="img"
|
|
||||||
aria-label="Race strategy stint chart"
|
|
||||||
>
|
|
||||||
{sortedDrivers.map((driver, i) => {
|
|
||||||
const rowY = i * ROW_H
|
|
||||||
const color = driver.team_colour ? `#${driver.team_colour}` : '#888'
|
|
||||||
const dStints = stints.filter((s) => s.driver_number === driver.driver_number)
|
|
||||||
const dPits = pit_stops.filter((p) => p.driver_number === driver.driver_number)
|
|
||||||
|
|
||||||
return (
|
|
||||||
<g key={driver.driver_number} transform={`translate(0,${rowY})`}>
|
|
||||||
<text
|
|
||||||
x={LEFT - 5}
|
|
||||||
y={BAR_Y + BAR_H / 2 + 4}
|
|
||||||
textAnchor="end"
|
|
||||||
fill={color}
|
|
||||||
fontFamily="var(--f-mono)"
|
|
||||||
fontWeight={700}
|
|
||||||
fontSize={10}
|
|
||||||
>
|
|
||||||
{driver.name_acronym}
|
|
||||||
</text>
|
|
||||||
|
|
||||||
{dStints.map((stint, si) => {
|
|
||||||
const x = lapX(stint.lap_start)
|
|
||||||
const w = stintW(stint)
|
|
||||||
const fill = compoundColor(stint.compound)
|
|
||||||
return (
|
|
||||||
<g key={si}>
|
|
||||||
<rect x={x} y={BAR_Y} width={w} height={BAR_H} fill={fill} rx={1.5} />
|
|
||||||
{w > 18 && (
|
|
||||||
<text
|
|
||||||
x={x + w / 2}
|
|
||||||
y={BAR_Y + BAR_H / 2 + 4}
|
|
||||||
textAnchor="middle"
|
|
||||||
fill="#111"
|
|
||||||
fontFamily="var(--f-mono)"
|
|
||||||
fontWeight={700}
|
|
||||||
fontSize={8}
|
|
||||||
>
|
|
||||||
{compoundInitial(stint.compound)}
|
|
||||||
</text>
|
|
||||||
)}
|
|
||||||
</g>
|
|
||||||
)
|
|
||||||
})}
|
|
||||||
|
|
||||||
{dPits.map((pit, pi) => {
|
|
||||||
const x = lapX(pit.lap_number)
|
|
||||||
return (
|
|
||||||
<line
|
|
||||||
key={pi}
|
|
||||||
x1={x}
|
|
||||||
x2={x}
|
|
||||||
y1={BAR_Y - 3}
|
|
||||||
y2={BAR_Y + BAR_H + 3}
|
|
||||||
stroke="var(--text)"
|
|
||||||
strokeWidth={1.5}
|
|
||||||
opacity={0.7}
|
|
||||||
/>
|
|
||||||
)
|
|
||||||
})}
|
|
||||||
</g>
|
|
||||||
)
|
|
||||||
})}
|
|
||||||
</svg>
|
|
||||||
</div>
|
|
||||||
|
|
||||||
<div
|
|
||||||
style={{
|
|
||||||
display: 'flex',
|
|
||||||
gap: 'var(--s4)',
|
|
||||||
flexWrap: 'wrap',
|
|
||||||
marginTop: 'var(--s4)',
|
|
||||||
fontSize: 11,
|
|
||||||
color: 'var(--text-3)',
|
|
||||||
alignItems: 'center',
|
|
||||||
}}
|
|
||||||
>
|
|
||||||
{usedCompounds.map((c) => (
|
|
||||||
<span key={c} style={{ display: 'inline-flex', alignItems: 'center', gap: 4 }}>
|
|
||||||
<span
|
|
||||||
style={{
|
|
||||||
width: 10,
|
|
||||||
height: 10,
|
|
||||||
background: COMPOUND_COLORS[c],
|
|
||||||
borderRadius: 2,
|
|
||||||
display: 'inline-block',
|
|
||||||
border: c === 'HARD' ? '1px solid #555' : undefined,
|
|
||||||
}}
|
|
||||||
/>
|
|
||||||
{c.charAt(0) + c.slice(1).toLowerCase()}
|
|
||||||
</span>
|
|
||||||
))}
|
|
||||||
{pit_stops.length > 0 && (
|
|
||||||
<span style={{ display: 'inline-flex', alignItems: 'center', gap: 5, marginLeft: 4 }}>
|
|
||||||
<span
|
|
||||||
style={{
|
|
||||||
width: 1,
|
|
||||||
height: 12,
|
|
||||||
background: 'var(--text)',
|
|
||||||
display: 'inline-block',
|
|
||||||
opacity: 0.7,
|
|
||||||
}}
|
|
||||||
/>
|
|
||||||
Pit stop
|
|
||||||
</span>
|
|
||||||
)}
|
|
||||||
<span style={{ marginLeft: 'auto', fontFamily: 'var(--f-mono)', fontSize: 10 }}>
|
|
||||||
{totalLaps} laps
|
|
||||||
</span>
|
|
||||||
</div>
|
|
||||||
</div>
|
</div>
|
||||||
)
|
)
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -2,6 +2,7 @@ export type Tab =
|
|||||||
| 'overview'
|
| 'overview'
|
||||||
| 'race_story'
|
| 'race_story'
|
||||||
| 'strategy'
|
| 'strategy'
|
||||||
|
| 'compare'
|
||||||
| 'lap_data'
|
| 'lap_data'
|
||||||
| 'conditions'
|
| 'conditions'
|
||||||
| 'race_control'
|
| 'race_control'
|
||||||
@@ -11,6 +12,7 @@ const TABS: { id: Tab; label: string }[] = [
|
|||||||
{ id: 'overview', label: 'Overview' },
|
{ id: 'overview', label: 'Overview' },
|
||||||
{ id: 'race_story', label: 'Race Story' },
|
{ id: 'race_story', label: 'Race Story' },
|
||||||
{ id: 'strategy', label: 'Strategy' },
|
{ id: 'strategy', label: 'Strategy' },
|
||||||
|
{ id: 'compare', label: 'Compare' },
|
||||||
{ id: 'lap_data', label: 'Lap Data' },
|
{ id: 'lap_data', label: 'Lap Data' },
|
||||||
{ id: 'conditions', label: 'Conditions' },
|
{ id: 'conditions', label: 'Conditions' },
|
||||||
{ id: 'race_control', label: 'Race Control' },
|
{ id: 'race_control', label: 'Race Control' },
|
||||||
|
|||||||
282
frontend/src/components/charts/DeltaTimeGraph.tsx
Normal file
282
frontend/src/components/charts/DeltaTimeGraph.tsx
Normal file
@@ -0,0 +1,282 @@
|
|||||||
|
import { useCallback, useMemo, useRef, useState } from 'react'
|
||||||
|
import {
|
||||||
|
computeCumulativeDeltas,
|
||||||
|
deltaPolylineSegments,
|
||||||
|
formatDeltaSeconds,
|
||||||
|
type DeltaSeries,
|
||||||
|
type DriverDeltaResult,
|
||||||
|
} from '../../lib/delta'
|
||||||
|
import '../../styles/delta-graph.css'
|
||||||
|
|
||||||
|
export type { DeltaSeries }
|
||||||
|
|
||||||
|
export interface DeltaTimeGraphProps {
|
||||||
|
series: DeltaSeries[]
|
||||||
|
referenceLabel?: string
|
||||||
|
}
|
||||||
|
|
||||||
|
const W = 640
|
||||||
|
const H = 220
|
||||||
|
const PL = 44
|
||||||
|
const PR = 16
|
||||||
|
const PT = 12
|
||||||
|
const PB = 28
|
||||||
|
|
||||||
|
function lapCount(series: ReadonlyArray<DeltaSeries>): number {
|
||||||
|
return series.reduce((max, s) => Math.max(max, s.lapTimes.length), 0)
|
||||||
|
}
|
||||||
|
|
||||||
|
function yExtent(drivers: ReadonlyArray<DriverDeltaResult>): { min: number; max: number } {
|
||||||
|
let min = 0
|
||||||
|
let max = 0
|
||||||
|
for (const driver of drivers) {
|
||||||
|
for (const delta of driver.deltas) {
|
||||||
|
if (delta === null) continue
|
||||||
|
min = Math.min(min, delta)
|
||||||
|
max = Math.max(max, delta)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if (min === max) {
|
||||||
|
const pad = 1
|
||||||
|
return { min: min - pad, max: max + pad }
|
||||||
|
}
|
||||||
|
const span = max - min
|
||||||
|
const pad = span * 0.08
|
||||||
|
return { min: min - pad, max: max + pad }
|
||||||
|
}
|
||||||
|
|
||||||
|
function niceYTicks(min: number, max: number): number[] {
|
||||||
|
const span = max - min
|
||||||
|
if (span <= 0) return [0]
|
||||||
|
const rough = span / 4
|
||||||
|
const magnitude = Math.pow(10, Math.floor(Math.log10(rough)))
|
||||||
|
const step = Math.ceil(rough / magnitude) * magnitude
|
||||||
|
const ticks: number[] = []
|
||||||
|
const start = Math.ceil(min / step) * step
|
||||||
|
for (let v = start; v <= max + step * 0.01; v += step) {
|
||||||
|
ticks.push(Number(v.toFixed(6)))
|
||||||
|
}
|
||||||
|
if (!ticks.some((t) => Math.abs(t) < step * 0.01)) {
|
||||||
|
ticks.push(0)
|
||||||
|
ticks.sort((a, b) => a - b)
|
||||||
|
}
|
||||||
|
return ticks
|
||||||
|
}
|
||||||
|
|
||||||
|
export function DeltaTimeGraph({ series, referenceLabel }: DeltaTimeGraphProps) {
|
||||||
|
const svgRef = useRef<SVGSVGElement>(null)
|
||||||
|
const [hoverLap, setHoverLap] = useState<number | null>(null)
|
||||||
|
|
||||||
|
const drivers = useMemo(
|
||||||
|
() => computeCumulativeDeltas(series, referenceLabel),
|
||||||
|
[series, referenceLabel],
|
||||||
|
)
|
||||||
|
|
||||||
|
const laps = useMemo(() => lapCount(series), [series])
|
||||||
|
const plotW = W - PL - PR
|
||||||
|
const plotH = H - PT - PB
|
||||||
|
const { min: yMin, max: yMax } = useMemo(() => yExtent(drivers), [drivers])
|
||||||
|
const yTicks = useMemo(() => niceYTicks(yMin, yMax), [yMin, yMax])
|
||||||
|
|
||||||
|
const toX = useCallback(
|
||||||
|
(lapIndex: number) => {
|
||||||
|
if (laps <= 1) return PL + plotW / 2
|
||||||
|
return PL + (lapIndex / (laps - 1)) * plotW
|
||||||
|
},
|
||||||
|
[laps, plotW],
|
||||||
|
)
|
||||||
|
|
||||||
|
const toY = useCallback(
|
||||||
|
(delta: number) => {
|
||||||
|
const span = yMax - yMin || 1
|
||||||
|
return PT + ((delta - yMin) / span) * plotH
|
||||||
|
},
|
||||||
|
[yMin, yMax, plotH],
|
||||||
|
)
|
||||||
|
|
||||||
|
const lapTickNumbers = useMemo(() => {
|
||||||
|
const ticks: number[] = []
|
||||||
|
for (let lap = 5; lap <= laps; lap += 5) {
|
||||||
|
ticks.push(lap)
|
||||||
|
}
|
||||||
|
return ticks
|
||||||
|
}, [laps])
|
||||||
|
|
||||||
|
const handlePointerMove = useCallback(
|
||||||
|
(e: React.PointerEvent<SVGRectElement> | React.MouseEvent<SVGRectElement>) => {
|
||||||
|
if (!svgRef.current || laps === 0) return
|
||||||
|
const rect = svgRef.current.getBoundingClientRect()
|
||||||
|
if (rect.width <= 0) return
|
||||||
|
const x = ((e.clientX - rect.left) / rect.width) * W
|
||||||
|
const frac = Math.max(0, Math.min(1, (x - PL) / plotW))
|
||||||
|
const lapIndex = laps <= 1 ? 0 : Math.round(frac * (laps - 1))
|
||||||
|
if (!Number.isFinite(lapIndex)) return
|
||||||
|
setHoverLap(Math.max(0, Math.min(laps - 1, lapIndex)))
|
||||||
|
},
|
||||||
|
[laps, plotW],
|
||||||
|
)
|
||||||
|
|
||||||
|
const handlePointerLeave = useCallback(() => setHoverLap(null), [])
|
||||||
|
|
||||||
|
if (series.length === 0 || laps === 0) {
|
||||||
|
return (
|
||||||
|
<div className="delta-graph" data-testid="delta-time-graph-empty">
|
||||||
|
<p className="delta-graph-empty">No lap data to compare.</p>
|
||||||
|
</div>
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
if (drivers.length === 0) {
|
||||||
|
return (
|
||||||
|
<div className="delta-graph" data-testid="delta-time-graph-empty">
|
||||||
|
<p className="delta-graph-empty">Select at least two drivers to compare.</p>
|
||||||
|
</div>
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
const hoverX = hoverLap !== null ? toX(hoverLap) : null
|
||||||
|
const tooltipRows = hoverLap !== null
|
||||||
|
? drivers
|
||||||
|
.map((d) => {
|
||||||
|
const delta = d.deltas[hoverLap]
|
||||||
|
if (delta == null) return null
|
||||||
|
return { label: d.label, color: d.color, delta }
|
||||||
|
})
|
||||||
|
.filter((row): row is { label: string; color: string; delta: number } => row !== null)
|
||||||
|
: []
|
||||||
|
|
||||||
|
const tooltipH = 18 + tooltipRows.length * 14
|
||||||
|
const tooltipW = 120
|
||||||
|
const tooltipX = hoverX !== null ? Math.min(Math.max(hoverX + 8, PL), W - PR - tooltipW) : 0
|
||||||
|
const tooltipY = PT
|
||||||
|
|
||||||
|
return (
|
||||||
|
<div className="delta-graph" data-testid="delta-time-graph">
|
||||||
|
<svg
|
||||||
|
ref={svgRef}
|
||||||
|
className="delta-graph-svg"
|
||||||
|
viewBox={`0 0 ${W} ${H}`}
|
||||||
|
role="img"
|
||||||
|
aria-label="Cumulative delta time chart"
|
||||||
|
>
|
||||||
|
{yTicks.map((tick) => (
|
||||||
|
<g key={`y-${tick}`}>
|
||||||
|
<line
|
||||||
|
x1={PL}
|
||||||
|
x2={W - PR}
|
||||||
|
y1={toY(tick)}
|
||||||
|
y2={toY(tick)}
|
||||||
|
className={Math.abs(tick) < 1e-9 ? 'delta-graph-zero-line' : 'delta-graph-grid-line'}
|
||||||
|
data-testid={Math.abs(tick) < 1e-9 ? 'delta-zero-line' : undefined}
|
||||||
|
/>
|
||||||
|
<text
|
||||||
|
x={PL - 6}
|
||||||
|
y={toY(tick) + 3}
|
||||||
|
textAnchor="end"
|
||||||
|
className="delta-graph-axis-label"
|
||||||
|
>
|
||||||
|
{formatDeltaSeconds(tick)}
|
||||||
|
</text>
|
||||||
|
</g>
|
||||||
|
))}
|
||||||
|
|
||||||
|
{lapTickNumbers.map((lap) => {
|
||||||
|
const x = toX(lap - 1)
|
||||||
|
return (
|
||||||
|
<g key={`lap-${lap}`}>
|
||||||
|
<line
|
||||||
|
x1={x}
|
||||||
|
x2={x}
|
||||||
|
y1={H - PB}
|
||||||
|
y2={H - PB + 4}
|
||||||
|
className="delta-graph-grid-line"
|
||||||
|
/>
|
||||||
|
<text
|
||||||
|
x={x}
|
||||||
|
y={H - PB + 16}
|
||||||
|
textAnchor="middle"
|
||||||
|
className="delta-graph-axis-label"
|
||||||
|
>
|
||||||
|
{lap}
|
||||||
|
</text>
|
||||||
|
</g>
|
||||||
|
)
|
||||||
|
})}
|
||||||
|
|
||||||
|
{drivers.map((driver) => {
|
||||||
|
const segments = deltaPolylineSegments(driver.deltas, (lapIndex, delta) =>
|
||||||
|
`${toX(lapIndex).toFixed(1)},${toY(delta).toFixed(1)}`,
|
||||||
|
)
|
||||||
|
return (
|
||||||
|
<g key={driver.label} data-testid={`delta-line-${driver.label}`}>
|
||||||
|
{segments.map((points, i) => (
|
||||||
|
<polyline
|
||||||
|
key={`${driver.label}-${i}`}
|
||||||
|
points={points}
|
||||||
|
className="delta-graph-driver-line"
|
||||||
|
stroke={driver.color}
|
||||||
|
/>
|
||||||
|
))}
|
||||||
|
</g>
|
||||||
|
)
|
||||||
|
})}
|
||||||
|
|
||||||
|
{hoverX !== null && (
|
||||||
|
<>
|
||||||
|
<line
|
||||||
|
x1={hoverX}
|
||||||
|
x2={hoverX}
|
||||||
|
y1={PT}
|
||||||
|
y2={H - PB}
|
||||||
|
className="delta-graph-crosshair"
|
||||||
|
data-testid="delta-crosshair"
|
||||||
|
/>
|
||||||
|
{tooltipRows.length > 0 && (
|
||||||
|
<g className="delta-graph-tooltip" data-testid="delta-tooltip">
|
||||||
|
<rect
|
||||||
|
x={tooltipX}
|
||||||
|
y={tooltipY}
|
||||||
|
width={tooltipW}
|
||||||
|
height={tooltipH}
|
||||||
|
rx={4}
|
||||||
|
className="delta-graph-tooltip-bg"
|
||||||
|
/>
|
||||||
|
<text
|
||||||
|
x={tooltipX + 8}
|
||||||
|
y={tooltipY + 14}
|
||||||
|
className="delta-graph-tooltip-title"
|
||||||
|
>
|
||||||
|
Lap {hoverLap! + 1}
|
||||||
|
</text>
|
||||||
|
{tooltipRows.map((row, i) => (
|
||||||
|
<text
|
||||||
|
key={row.label}
|
||||||
|
x={tooltipX + 8}
|
||||||
|
y={tooltipY + 28 + i * 14}
|
||||||
|
className="delta-graph-tooltip-row"
|
||||||
|
fill={row.color}
|
||||||
|
>
|
||||||
|
{row.label} {formatDeltaSeconds(row.delta)}
|
||||||
|
</text>
|
||||||
|
))}
|
||||||
|
</g>
|
||||||
|
)}
|
||||||
|
</>
|
||||||
|
)}
|
||||||
|
|
||||||
|
<rect
|
||||||
|
x={PL}
|
||||||
|
y={PT}
|
||||||
|
width={plotW}
|
||||||
|
height={plotH}
|
||||||
|
fill="transparent"
|
||||||
|
className="delta-graph-hover-layer"
|
||||||
|
onPointerMove={handlePointerMove}
|
||||||
|
onMouseMove={handlePointerMove}
|
||||||
|
onPointerLeave={handlePointerLeave}
|
||||||
|
onMouseLeave={handlePointerLeave}
|
||||||
|
/>
|
||||||
|
</svg>
|
||||||
|
</div>
|
||||||
|
)
|
||||||
|
}
|
||||||
194
frontend/src/components/charts/TelemetryTraceChart.tsx
Normal file
194
frontend/src/components/charts/TelemetryTraceChart.tsx
Normal file
@@ -0,0 +1,194 @@
|
|||||||
|
import { useMemo, useRef, useState } from 'react'
|
||||||
|
import '../../styles/telemetry-trace.css'
|
||||||
|
|
||||||
|
export interface TelemetryTraceSample {
|
||||||
|
speed: number
|
||||||
|
throttle: number
|
||||||
|
brake: number
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface TelemetryTraceSeries {
|
||||||
|
label: string
|
||||||
|
color: string
|
||||||
|
samples: TelemetryTraceSample[]
|
||||||
|
}
|
||||||
|
|
||||||
|
export type TelemetryTraceChannel = 'speed' | 'throttle' | 'brake'
|
||||||
|
|
||||||
|
export interface TelemetryTraceChartProps {
|
||||||
|
series: TelemetryTraceSeries[]
|
||||||
|
channels?: TelemetryTraceChannel[]
|
||||||
|
/** Height of each channel panel in SVG units (viewBox space). */
|
||||||
|
height?: number
|
||||||
|
}
|
||||||
|
|
||||||
|
const VIEW_WIDTH = 800
|
||||||
|
const PANEL_GAP = 18
|
||||||
|
const PAD_TOP = 6
|
||||||
|
const PAD_BOTTOM = 6
|
||||||
|
|
||||||
|
const CHANNEL_LABELS: Record<TelemetryTraceChannel, string> = {
|
||||||
|
speed: 'Speed',
|
||||||
|
throttle: 'Throttle',
|
||||||
|
brake: 'Brake',
|
||||||
|
}
|
||||||
|
|
||||||
|
const clamp = (v: number, min: number, max: number) => Math.min(max, Math.max(min, v))
|
||||||
|
|
||||||
|
function channelValue(sample: TelemetryTraceSample, channel: TelemetryTraceChannel): number {
|
||||||
|
const raw = sample[channel]
|
||||||
|
// Throttle/brake are percentages; clamp so out-of-range API values can't
|
||||||
|
// draw outside the panel. Speed is clamped to >= 0.
|
||||||
|
if (channel === 'speed') return Math.max(0, raw)
|
||||||
|
return clamp(raw, 0, 100)
|
||||||
|
}
|
||||||
|
|
||||||
|
function formatValue(value: number, channel: TelemetryTraceChannel): string {
|
||||||
|
if (channel === 'speed') return `${Math.round(value)} km/h`
|
||||||
|
return `${Math.round(value)}%`
|
||||||
|
}
|
||||||
|
|
||||||
|
export function TelemetryTraceChart({
|
||||||
|
series,
|
||||||
|
channels = ['speed', 'throttle', 'brake'],
|
||||||
|
height = 110,
|
||||||
|
}: TelemetryTraceChartProps) {
|
||||||
|
const svgRef = useRef<SVGSVGElement | null>(null)
|
||||||
|
const [hoverIndex, setHoverIndex] = useState<number | null>(null)
|
||||||
|
|
||||||
|
// Series are index-aligned; mismatched lengths are clamped to the shortest
|
||||||
|
// series so every drawn x has a value for every driver.
|
||||||
|
const sampleCount = useMemo(
|
||||||
|
() => (series.length === 0 ? 0 : Math.min(...series.map((s) => s.samples.length))),
|
||||||
|
[series],
|
||||||
|
)
|
||||||
|
|
||||||
|
const speedMax = useMemo(() => {
|
||||||
|
let max = 0
|
||||||
|
for (const s of series) {
|
||||||
|
for (let i = 0; i < sampleCount; i++) {
|
||||||
|
max = Math.max(max, channelValue(s.samples[i], 'speed'))
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return max > 0 ? max : 1
|
||||||
|
}, [series, sampleCount])
|
||||||
|
|
||||||
|
if (series.length === 0 || sampleCount === 0 || channels.length === 0) {
|
||||||
|
return <div className="telemetry-trace-empty">No telemetry data</div>
|
||||||
|
}
|
||||||
|
|
||||||
|
// Clamp a stale hover index in case the series prop shrank between renders.
|
||||||
|
const hover = hoverIndex === null ? null : Math.min(hoverIndex, sampleCount - 1)
|
||||||
|
|
||||||
|
const panelHeight = height
|
||||||
|
const totalHeight = channels.length * panelHeight + (channels.length - 1) * PANEL_GAP
|
||||||
|
const xAt = (i: number) => (i / Math.max(1, sampleCount - 1)) * VIEW_WIDTH
|
||||||
|
|
||||||
|
const channelMax = (channel: TelemetryTraceChannel) => (channel === 'speed' ? speedMax : 100)
|
||||||
|
|
||||||
|
const yAt = (value: number, channel: TelemetryTraceChannel, panelTop: number) => {
|
||||||
|
const usable = panelHeight - PAD_TOP - PAD_BOTTOM
|
||||||
|
const frac = channelValue({ speed: value, throttle: value, brake: value }, channel) / channelMax(channel)
|
||||||
|
return panelTop + PAD_TOP + (1 - frac) * usable
|
||||||
|
}
|
||||||
|
|
||||||
|
const handleMouseMove = (e: React.MouseEvent<SVGSVGElement>) => {
|
||||||
|
const rect = svgRef.current?.getBoundingClientRect()
|
||||||
|
if (!rect || rect.width === 0) {
|
||||||
|
setHoverIndex(0)
|
||||||
|
return
|
||||||
|
}
|
||||||
|
const frac = clamp((e.clientX - rect.left) / rect.width, 0, 1)
|
||||||
|
setHoverIndex(clamp(Math.round(frac * (sampleCount - 1)), 0, sampleCount - 1))
|
||||||
|
}
|
||||||
|
|
||||||
|
return (
|
||||||
|
<div className="telemetry-trace" data-testid="telemetry-trace">
|
||||||
|
<div className="telemetry-trace-legend">
|
||||||
|
{series.map((s) => (
|
||||||
|
<span key={s.label} className="telemetry-trace-legend-item">
|
||||||
|
<span className="telemetry-trace-swatch" style={{ background: s.color }} aria-hidden="true" />
|
||||||
|
{s.label}
|
||||||
|
</span>
|
||||||
|
))}
|
||||||
|
</div>
|
||||||
|
<svg
|
||||||
|
ref={svgRef}
|
||||||
|
className="telemetry-trace-svg"
|
||||||
|
viewBox={`0 0 ${VIEW_WIDTH} ${totalHeight}`}
|
||||||
|
role="img"
|
||||||
|
aria-label="Telemetry trace chart"
|
||||||
|
onMouseMove={handleMouseMove}
|
||||||
|
onMouseLeave={() => setHoverIndex(null)}
|
||||||
|
>
|
||||||
|
{channels.map((channel, panelIdx) => {
|
||||||
|
const panelTop = panelIdx * (panelHeight + PANEL_GAP)
|
||||||
|
return (
|
||||||
|
<g key={channel} className="telemetry-trace-panel" data-channel={channel}>
|
||||||
|
<rect
|
||||||
|
className="telemetry-trace-panel-bg"
|
||||||
|
x={0}
|
||||||
|
y={panelTop}
|
||||||
|
width={VIEW_WIDTH}
|
||||||
|
height={panelHeight}
|
||||||
|
/>
|
||||||
|
<text className="telemetry-trace-panel-title" x={6} y={panelTop + 13}>
|
||||||
|
{CHANNEL_LABELS[channel]}
|
||||||
|
</text>
|
||||||
|
<text className="telemetry-trace-axis-max" x={VIEW_WIDTH - 6} y={panelTop + 13} textAnchor="end">
|
||||||
|
{channel === 'speed' ? `${Math.round(speedMax)} km/h` : '100%'}
|
||||||
|
</text>
|
||||||
|
{series.map((s) => {
|
||||||
|
const points = Array.from({ length: sampleCount }, (_, i) => {
|
||||||
|
const x = xAt(i)
|
||||||
|
const y = yAt(s.samples[i][channel], channel, panelTop)
|
||||||
|
return `${x.toFixed(2)},${y.toFixed(2)}`
|
||||||
|
}).join(' ')
|
||||||
|
return (
|
||||||
|
<polyline
|
||||||
|
key={s.label}
|
||||||
|
className="telemetry-trace-line"
|
||||||
|
data-channel={channel}
|
||||||
|
data-series={s.label}
|
||||||
|
points={points}
|
||||||
|
fill="none"
|
||||||
|
stroke={s.color}
|
||||||
|
strokeWidth={1.6}
|
||||||
|
strokeLinejoin="round"
|
||||||
|
strokeLinecap="round"
|
||||||
|
/>
|
||||||
|
)
|
||||||
|
})}
|
||||||
|
</g>
|
||||||
|
)
|
||||||
|
})}
|
||||||
|
{hover !== null && (
|
||||||
|
<line
|
||||||
|
className="telemetry-trace-crosshair"
|
||||||
|
data-testid="telemetry-trace-crosshair"
|
||||||
|
x1={xAt(hover)}
|
||||||
|
y1={0}
|
||||||
|
x2={xAt(hover)}
|
||||||
|
y2={totalHeight}
|
||||||
|
/>
|
||||||
|
)}
|
||||||
|
</svg>
|
||||||
|
{hover !== null && (
|
||||||
|
<div className="telemetry-trace-readout" data-testid="telemetry-trace-readout">
|
||||||
|
<span className="telemetry-trace-readout-index">Sample {hover}</span>
|
||||||
|
{series.map((s) => (
|
||||||
|
<span key={s.label} className="telemetry-trace-readout-driver">
|
||||||
|
<span className="telemetry-trace-swatch" style={{ background: s.color }} aria-hidden="true" />
|
||||||
|
<span className="telemetry-trace-readout-label">{s.label}</span>
|
||||||
|
{channels.map((channel) => (
|
||||||
|
<span key={channel} className="telemetry-trace-readout-value">
|
||||||
|
{formatValue(channelValue(s.samples[hover], channel), channel)}
|
||||||
|
</span>
|
||||||
|
))}
|
||||||
|
</span>
|
||||||
|
))}
|
||||||
|
</div>
|
||||||
|
)}
|
||||||
|
</div>
|
||||||
|
)
|
||||||
|
}
|
||||||
207
frontend/src/components/charts/TyreStintTimeline.tsx
Normal file
207
frontend/src/components/charts/TyreStintTimeline.tsx
Normal file
@@ -0,0 +1,207 @@
|
|||||||
|
import { compoundClass } from '../../lib/live'
|
||||||
|
import '../../styles/stint-timeline.css'
|
||||||
|
|
||||||
|
export interface StintTimelineStint {
|
||||||
|
compound: string
|
||||||
|
lapStart: number
|
||||||
|
lapEnd: number
|
||||||
|
isNew?: boolean
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface StintTimelineRow {
|
||||||
|
label: string
|
||||||
|
color: string
|
||||||
|
stints: StintTimelineStint[]
|
||||||
|
/** Lap numbers where the driver pitted; optional — rows without stops render normally. */
|
||||||
|
pitStops?: number[]
|
||||||
|
}
|
||||||
|
|
||||||
|
interface TyreStintTimelineProps {
|
||||||
|
rows: StintTimelineRow[]
|
||||||
|
totalLaps: number
|
||||||
|
}
|
||||||
|
|
||||||
|
const SVG_W = 640
|
||||||
|
const LEFT = 48
|
||||||
|
const RIGHT = 12
|
||||||
|
const ROW_H = 28
|
||||||
|
const BAR_H = 14
|
||||||
|
const BAR_Y = 7
|
||||||
|
const AXIS_H = 20
|
||||||
|
const BAR_W = SVG_W - LEFT - RIGHT
|
||||||
|
|
||||||
|
const COMPOUND_ORDER = ['SOFT', 'MEDIUM', 'HARD', 'INTERMEDIATE', 'WET'] as const
|
||||||
|
|
||||||
|
function compoundLabel(compound: string): string {
|
||||||
|
const upper = compound.toUpperCase()
|
||||||
|
if (upper === 'INTERMEDIATE') return 'Intermediate'
|
||||||
|
return upper.charAt(0) + upper.slice(1).toLowerCase()
|
||||||
|
}
|
||||||
|
|
||||||
|
function stintLength(stint: StintTimelineStint): number {
|
||||||
|
return stint.lapEnd - stint.lapStart + 1
|
||||||
|
}
|
||||||
|
|
||||||
|
function stintTitle(stint: StintTimelineStint): string {
|
||||||
|
const length = stintLength(stint)
|
||||||
|
return `${compoundLabel(stint.compound)} · L${stint.lapStart}–${stint.lapEnd} · ${length} lap${length === 1 ? '' : 's'}`
|
||||||
|
}
|
||||||
|
|
||||||
|
function lapX(lap: number, totalLaps: number): number {
|
||||||
|
return LEFT + (lap / totalLaps) * BAR_W
|
||||||
|
}
|
||||||
|
|
||||||
|
function stintBarX(stint: StintTimelineStint, totalLaps: number): number {
|
||||||
|
return LEFT + ((stint.lapStart - 1) / totalLaps) * BAR_W
|
||||||
|
}
|
||||||
|
|
||||||
|
function stintBarW(stint: StintTimelineStint, totalLaps: number): number {
|
||||||
|
return Math.max(2, (stintLength(stint) / totalLaps) * BAR_W)
|
||||||
|
}
|
||||||
|
|
||||||
|
function pitMarkerX(lapNumber: number, totalLaps: number): number {
|
||||||
|
return LEFT + ((lapNumber - 1) / totalLaps) * BAR_W
|
||||||
|
}
|
||||||
|
|
||||||
|
function pitMarkerTitle(driverLabel: string, lapNumber: number): string {
|
||||||
|
return `${driverLabel} pit stop · L${lapNumber}`
|
||||||
|
}
|
||||||
|
|
||||||
|
function axisTicks(totalLaps: number): number[] {
|
||||||
|
const ticks: number[] = []
|
||||||
|
for (let lap = 0; lap <= totalLaps; lap += 10) {
|
||||||
|
ticks.push(lap)
|
||||||
|
}
|
||||||
|
return ticks
|
||||||
|
}
|
||||||
|
|
||||||
|
function collectUsedCompounds(rows: StintTimelineRow[]): string[] {
|
||||||
|
const seen = new Set<string>()
|
||||||
|
for (const row of rows) {
|
||||||
|
for (const stint of row.stints) {
|
||||||
|
seen.add(stint.compound.toUpperCase())
|
||||||
|
}
|
||||||
|
}
|
||||||
|
const ordered = COMPOUND_ORDER.filter((c) => seen.has(c))
|
||||||
|
const extras = [...seen]
|
||||||
|
.filter((c) => !COMPOUND_ORDER.includes(c as (typeof COMPOUND_ORDER)[number]))
|
||||||
|
.sort()
|
||||||
|
return [...ordered, ...extras]
|
||||||
|
}
|
||||||
|
|
||||||
|
export function TyreStintTimeline({ rows, totalLaps }: TyreStintTimelineProps) {
|
||||||
|
const safeTotal = Math.max(totalLaps, 1)
|
||||||
|
const usedCompounds = collectUsedCompounds(rows)
|
||||||
|
const ticks = axisTicks(safeTotal)
|
||||||
|
const chartH = rows.length * ROW_H
|
||||||
|
const svgH = chartH + AXIS_H + 4
|
||||||
|
|
||||||
|
if (rows.length === 0) {
|
||||||
|
return (
|
||||||
|
<div className="stint-timeline" data-testid="stint-timeline-empty">
|
||||||
|
<div className="stint-timeline__empty">No stint data to display.</div>
|
||||||
|
</div>
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
return (
|
||||||
|
<div className="stint-timeline" data-testid="stint-timeline">
|
||||||
|
<div className="stint-timeline__scroll">
|
||||||
|
<svg
|
||||||
|
viewBox={`0 0 ${SVG_W} ${svgH}`}
|
||||||
|
className="stint-timeline__svg"
|
||||||
|
role="img"
|
||||||
|
aria-label="Tyre stint timeline"
|
||||||
|
>
|
||||||
|
{rows.map((row, i) => {
|
||||||
|
const rowY = i * ROW_H
|
||||||
|
return (
|
||||||
|
<g key={`${row.label}-${i}`} transform={`translate(0,${rowY})`}>
|
||||||
|
<text
|
||||||
|
x={LEFT - 5}
|
||||||
|
y={BAR_Y + BAR_H / 2 + 4}
|
||||||
|
textAnchor="end"
|
||||||
|
fill={row.color}
|
||||||
|
className="stint-timeline__label"
|
||||||
|
>
|
||||||
|
{row.label}
|
||||||
|
</text>
|
||||||
|
|
||||||
|
{row.stints.map((stint, si) => (
|
||||||
|
<rect
|
||||||
|
key={si}
|
||||||
|
x={stintBarX(stint, safeTotal)}
|
||||||
|
y={BAR_Y}
|
||||||
|
width={stintBarW(stint, safeTotal)}
|
||||||
|
height={BAR_H}
|
||||||
|
rx={3}
|
||||||
|
className={`stint-timeline__bar ${compoundClass(stint.compound)}${stint.isNew ? ' stint-timeline__bar--new' : ''}`}
|
||||||
|
>
|
||||||
|
<title>{stintTitle(stint)}</title>
|
||||||
|
</rect>
|
||||||
|
))}
|
||||||
|
|
||||||
|
{(row.pitStops ?? []).map((lapNumber, pi) => (
|
||||||
|
<line
|
||||||
|
key={`pit-${pi}`}
|
||||||
|
x1={pitMarkerX(lapNumber, safeTotal)}
|
||||||
|
x2={pitMarkerX(lapNumber, safeTotal)}
|
||||||
|
y1={BAR_Y - 3}
|
||||||
|
y2={BAR_Y + BAR_H + 3}
|
||||||
|
className="stint-timeline__pit-marker"
|
||||||
|
data-testid="pit-marker"
|
||||||
|
data-lap={lapNumber}
|
||||||
|
>
|
||||||
|
<title>{pitMarkerTitle(row.label, lapNumber)}</title>
|
||||||
|
</line>
|
||||||
|
))}
|
||||||
|
</g>
|
||||||
|
)
|
||||||
|
})}
|
||||||
|
|
||||||
|
<g transform={`translate(0,${chartH})`}>
|
||||||
|
<line
|
||||||
|
x1={LEFT}
|
||||||
|
x2={LEFT + BAR_W}
|
||||||
|
y1={0}
|
||||||
|
y2={0}
|
||||||
|
className="stint-timeline__axis-line"
|
||||||
|
/>
|
||||||
|
{ticks.map((lap) => (
|
||||||
|
<g key={lap}>
|
||||||
|
<line
|
||||||
|
x1={lapX(lap, safeTotal)}
|
||||||
|
x2={lapX(lap, safeTotal)}
|
||||||
|
y1={0}
|
||||||
|
y2={4}
|
||||||
|
className="stint-timeline__axis-line"
|
||||||
|
/>
|
||||||
|
<text
|
||||||
|
x={lapX(lap, safeTotal)}
|
||||||
|
y={14}
|
||||||
|
textAnchor="middle"
|
||||||
|
className="stint-timeline__axis-tick"
|
||||||
|
>
|
||||||
|
{lap}
|
||||||
|
</text>
|
||||||
|
</g>
|
||||||
|
))}
|
||||||
|
</g>
|
||||||
|
</svg>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<div className="stint-timeline__legend">
|
||||||
|
{usedCompounds.map((compound) => (
|
||||||
|
<span key={compound} className="stint-timeline__legend-item">
|
||||||
|
<span
|
||||||
|
className={`stint-timeline__legend-swatch ${compoundClass(compound)}`}
|
||||||
|
data-testid={`legend-${compound.toLowerCase()}`}
|
||||||
|
/>
|
||||||
|
{compoundLabel(compound)}
|
||||||
|
</span>
|
||||||
|
))}
|
||||||
|
<span className="stint-timeline__meta">{safeTotal} laps</span>
|
||||||
|
</div>
|
||||||
|
</div>
|
||||||
|
)
|
||||||
|
}
|
||||||
72
frontend/src/components/live/EventRail.tsx
Normal file
72
frontend/src/components/live/EventRail.tsx
Normal file
@@ -0,0 +1,72 @@
|
|||||||
|
import { useAutoAnimate } from '@formkit/auto-animate/react'
|
||||||
|
import {
|
||||||
|
Flag,
|
||||||
|
LogOut,
|
||||||
|
Megaphone,
|
||||||
|
OctagonX,
|
||||||
|
Swords,
|
||||||
|
Timer,
|
||||||
|
TrendingDown,
|
||||||
|
TrendingUp,
|
||||||
|
Wrench,
|
||||||
|
Zap,
|
||||||
|
} from 'lucide-react'
|
||||||
|
import type { LucideIcon } from 'lucide-react'
|
||||||
|
import type { LiveDriverInfo } from '../../types'
|
||||||
|
import type { LiveEvent, LiveEventKind } from '../../lib/events'
|
||||||
|
import { teamColor } from '../../utils'
|
||||||
|
import '../../styles/event-rail.css'
|
||||||
|
|
||||||
|
interface Props {
|
||||||
|
events: LiveEvent[]
|
||||||
|
driverInfo?: Record<string, LiveDriverInfo>
|
||||||
|
}
|
||||||
|
|
||||||
|
const KIND_ICONS: Record<LiveEventKind, LucideIcon> = {
|
||||||
|
overtake: Swords,
|
||||||
|
'position-gain': TrendingUp,
|
||||||
|
'position-loss': TrendingDown,
|
||||||
|
'pit-in': Wrench,
|
||||||
|
'pit-out': LogOut,
|
||||||
|
'personal-best': Timer,
|
||||||
|
'fastest-lap': Zap,
|
||||||
|
retirement: OctagonX,
|
||||||
|
'track-status': Flag,
|
||||||
|
'race-control': Megaphone,
|
||||||
|
}
|
||||||
|
|
||||||
|
export function EventRail({ events, driverInfo }: Props) {
|
||||||
|
const [listRef] = useAutoAnimate<HTMLDivElement>()
|
||||||
|
|
||||||
|
return (
|
||||||
|
<section className="event-rail panel-glass" data-testid="event-rail">
|
||||||
|
<div className="sec-header sticky-header">
|
||||||
|
<span className="sec-title">What Just Happened</span>
|
||||||
|
{events.length > 0 && <span className="sec-meta">{events.length} events</span>}
|
||||||
|
</div>
|
||||||
|
{events.length === 0 ? (
|
||||||
|
<div className="missing-notice">Events will appear here as the session unfolds.</div>
|
||||||
|
) : (
|
||||||
|
<div className="event-rail-list" ref={listRef}>
|
||||||
|
{events.map((event) => {
|
||||||
|
const Icon = KIND_ICONS[event.kind] ?? Megaphone
|
||||||
|
const colour = driverInfo?.[event.racingNumbers[0]]?.TeamColour
|
||||||
|
const accent = event.racingNumbers.length > 0 ? teamColor(colour) : 'var(--border-2)'
|
||||||
|
return (
|
||||||
|
<div className={`event-rail-row event-kind-${event.kind}`} key={event.id} style={{ borderLeftColor: accent }}>
|
||||||
|
<span className="event-rail-icon" aria-hidden="true">
|
||||||
|
<Icon size={14} />
|
||||||
|
</span>
|
||||||
|
<div className="event-rail-body">
|
||||||
|
<span className="event-rail-headline">{event.headline}</span>
|
||||||
|
{event.detail && <span className="event-rail-detail">{event.detail}</span>}
|
||||||
|
</div>
|
||||||
|
{event.lap > 0 && <span className="event-rail-lap">L{event.lap}</span>}
|
||||||
|
</div>
|
||||||
|
)
|
||||||
|
})}
|
||||||
|
</div>
|
||||||
|
)}
|
||||||
|
</section>
|
||||||
|
)
|
||||||
|
}
|
||||||
@@ -5,18 +5,20 @@ import { WeatherStrip } from './WeatherStrip'
|
|||||||
|
|
||||||
interface Props {
|
interface Props {
|
||||||
isLive: boolean
|
isLive: boolean
|
||||||
|
isArchive?: boolean
|
||||||
snapshot: LiveStreamData
|
snapshot: LiveStreamData
|
||||||
rows: LiveTimingRow[]
|
rows: LiveTimingRow[]
|
||||||
connection: 'connected' | 'connecting' | 'disconnected' | 'error'
|
connection: 'connected' | 'connecting' | 'disconnected' | 'error'
|
||||||
now: number
|
now: number
|
||||||
}
|
}
|
||||||
|
|
||||||
export function SessionBanner({ isLive, snapshot, rows, connection, now }: Props) {
|
export function SessionBanner({ isLive, isArchive = false, snapshot, rows, connection, now }: Props) {
|
||||||
const session = snapshot.Session
|
const session = snapshot.Session
|
||||||
const clock = extrapolateClock(snapshot.Clock, snapshot.ClockRefTime, snapshot.ClockExtrapolating, now)
|
const clock = extrapolateClock(snapshot.Clock, snapshot.ClockRefTime, snapshot.ClockExtrapolating, now)
|
||||||
const display = liveSessionDisplay(session, rows)
|
const display = liveSessionDisplay(session, rows)
|
||||||
const atRiskLabel =
|
const atRiskLabel =
|
||||||
display.atRiskStart && display.atRiskEnd ? `P${display.atRiskStart}-P${display.atRiskEnd} at risk` : ''
|
display.atRiskStart && display.atRiskEnd ? `P${display.atRiskStart}-P${display.atRiskEnd} at risk` : ''
|
||||||
|
const stateLabel = isLive ? 'live' : isArchive ? 'archive' : 'stale'
|
||||||
|
|
||||||
return (
|
return (
|
||||||
<section className="live-banner">
|
<section className="live-banner">
|
||||||
@@ -39,7 +41,7 @@ export function SessionBanner({ isLive, snapshot, rows, connection, now }: Props
|
|||||||
<span>
|
<span>
|
||||||
L<strong>{snapshot.CurrentLap || '-'}</strong>/<strong>{snapshot.TotalLaps || '-'}</strong>
|
L<strong>{snapshot.CurrentLap || '-'}</strong>/<strong>{snapshot.TotalLaps || '-'}</strong>
|
||||||
</span>
|
</span>
|
||||||
<span className={isLive ? 'live-state live-state-on' : 'live-state'}>{isLive ? 'live' : 'stale'}</span>
|
<span className={isLive ? 'live-state live-state-on' : 'live-state'}>{stateLabel}</span>
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
|
|||||||
108
frontend/src/components/live/TeamRadioTicker.tsx
Normal file
108
frontend/src/components/live/TeamRadioTicker.tsx
Normal file
@@ -0,0 +1,108 @@
|
|||||||
|
import { useMemo, useRef, useState } from 'react'
|
||||||
|
import { Pause, Play } from 'lucide-react'
|
||||||
|
import type { LiveDriverInfo, LiveRadioCapture, LiveSessionMeta } from '../../types'
|
||||||
|
import { radioCaptureKey, radioClipUrl } from '../../lib/radio'
|
||||||
|
import { teamColor } from '../../utils'
|
||||||
|
import '../../styles/team-radio.css'
|
||||||
|
|
||||||
|
interface Props {
|
||||||
|
captures?: LiveRadioCapture[]
|
||||||
|
driverInfo?: Record<string, LiveDriverInfo>
|
||||||
|
session?: LiveSessionMeta
|
||||||
|
}
|
||||||
|
|
||||||
|
function relativeTime(utc: string): string {
|
||||||
|
const timestamp = new Date(utc).getTime()
|
||||||
|
if (!utc || Number.isNaN(timestamp)) return '--'
|
||||||
|
|
||||||
|
const diffSeconds = Math.max(0, Math.floor((Date.now() - timestamp) / 1000))
|
||||||
|
if (diffSeconds < 60) return `${diffSeconds}s ago`
|
||||||
|
const minutes = Math.floor(diffSeconds / 60)
|
||||||
|
if (minutes < 60) return `${minutes}m ago`
|
||||||
|
const hours = Math.floor(minutes / 60)
|
||||||
|
if (hours < 24) return `${hours}h ago`
|
||||||
|
return new Date(utc).toLocaleTimeString([], { hour: '2-digit', minute: '2-digit' })
|
||||||
|
}
|
||||||
|
|
||||||
|
function driverLabel(info: LiveDriverInfo | undefined, racingNumber: string): string {
|
||||||
|
return info?.Tla || racingNumber
|
||||||
|
}
|
||||||
|
|
||||||
|
export function TeamRadioTicker({ captures = [], driverInfo = {}, session }: Props) {
|
||||||
|
const audioRef = useRef<HTMLAudioElement | null>(null)
|
||||||
|
const [playingKey, setPlayingKey] = useState<string | null>(null)
|
||||||
|
|
||||||
|
const newestFirst = useMemo(() => [...captures].reverse(), [captures])
|
||||||
|
|
||||||
|
const toggleCapture = (capture: LiveRadioCapture) => {
|
||||||
|
const key = radioCaptureKey(capture)
|
||||||
|
const audio = audioRef.current
|
||||||
|
const url = radioClipUrl(session, capture)
|
||||||
|
if (!audio || !url) return
|
||||||
|
|
||||||
|
if (playingKey === key) {
|
||||||
|
audio.pause()
|
||||||
|
setPlayingKey(null)
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
|
audio.pause()
|
||||||
|
audio.src = url
|
||||||
|
setPlayingKey(key)
|
||||||
|
const play = audio.play()
|
||||||
|
if (play) {
|
||||||
|
play.catch(() => setPlayingKey(null))
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
return (
|
||||||
|
<section className="team-radio panel-glass" data-testid="team-radio-ticker">
|
||||||
|
<div className="sec-header sticky-header">
|
||||||
|
<span className="sec-title">Team Radio</span>
|
||||||
|
{captures.length > 0 && <span className="sec-meta">{captures.length} clips</span>}
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<audio
|
||||||
|
ref={audioRef}
|
||||||
|
className="team-radio-audio"
|
||||||
|
onEnded={() => setPlayingKey(null)}
|
||||||
|
/>
|
||||||
|
|
||||||
|
{newestFirst.length === 0 ? (
|
||||||
|
<div className="missing-notice">No team radio clips in the current live snapshot.</div>
|
||||||
|
) : (
|
||||||
|
<div className="team-radio-list">
|
||||||
|
{newestFirst.map((capture) => {
|
||||||
|
const key = radioCaptureKey(capture)
|
||||||
|
const info = driverInfo[capture.RacingNumber]
|
||||||
|
const label = driverLabel(info, capture.RacingNumber)
|
||||||
|
const isPlaying = playingKey === key
|
||||||
|
const url = radioClipUrl(session, capture)
|
||||||
|
|
||||||
|
return (
|
||||||
|
<div className="team-radio-row" key={key}>
|
||||||
|
<button
|
||||||
|
className="team-radio-play"
|
||||||
|
type="button"
|
||||||
|
aria-label={`${isPlaying ? 'Pause' : 'Play'} ${label} radio`}
|
||||||
|
disabled={!url}
|
||||||
|
onClick={() => toggleCapture(capture)}
|
||||||
|
>
|
||||||
|
{isPlaying ? <Pause size={14} /> : <Play size={14} />}
|
||||||
|
</button>
|
||||||
|
<span
|
||||||
|
className="team-radio-driver"
|
||||||
|
style={{ borderColor: teamColor(info?.TeamColour) }}
|
||||||
|
title={info?.TeamName || undefined}
|
||||||
|
>
|
||||||
|
{label}
|
||||||
|
</span>
|
||||||
|
<span className="team-radio-time">{relativeTime(capture.Utc)}</span>
|
||||||
|
</div>
|
||||||
|
)
|
||||||
|
})}
|
||||||
|
</div>
|
||||||
|
)}
|
||||||
|
</section>
|
||||||
|
)
|
||||||
|
}
|
||||||
@@ -12,6 +12,9 @@ import {
|
|||||||
tyreLabel,
|
tyreLabel,
|
||||||
} from '../../lib/live'
|
} from '../../lib/live'
|
||||||
import type { GapHistoryMap } from '../../lib/gapHistory'
|
import type { GapHistoryMap } from '../../lib/gapHistory'
|
||||||
|
import { parseIntervalSeconds } from '../../lib/gapHistory'
|
||||||
|
import { intervalMeaning } from '../../lib/meaning'
|
||||||
|
import { Meaning } from '../Meaning'
|
||||||
import { GapSparkline } from './GapSparkline'
|
import { GapSparkline } from './GapSparkline'
|
||||||
import { StintHistory } from './StintHistory'
|
import { StintHistory } from './StintHistory'
|
||||||
import { Pin } from 'lucide-react'
|
import { Pin } from 'lucide-react'
|
||||||
@@ -100,7 +103,11 @@ export function TimingTower({
|
|||||||
const showCutoffAfter = row.Position === sessionDisplay.cutoffPosition
|
const showCutoffAfter = row.Position === sessionDisplay.cutoffPosition
|
||||||
|
|
||||||
const gapText = gapMode === 'interval' && isRace ? (driver.Interval || driver.GapToLeader) : driver.GapToLeader
|
const gapText = gapMode === 'interval' && isRace ? (driver.Interval || driver.GapToLeader) : driver.GapToLeader
|
||||||
|
const intervalAnnotation =
|
||||||
|
gapMode === 'interval' && isRace && row.Position > 1
|
||||||
|
? intervalMeaning(parseIntervalSeconds(gapText))
|
||||||
|
: null
|
||||||
|
|
||||||
const renderSector = (idx: number) => {
|
const renderSector = (idx: number) => {
|
||||||
const sec = driver.Sectors?.[idx]
|
const sec = driver.Sectors?.[idx]
|
||||||
if (!sec) return '-'
|
if (!sec) return '-'
|
||||||
@@ -149,7 +156,14 @@ export function TimingTower({
|
|||||||
<td className={driver.LastLapOB ? 'mono lap-ob' : driver.LastLapPB ? 'mono lap-pb' : 'mono'}>
|
<td className={driver.LastLapOB ? 'mono lap-ob' : driver.LastLapPB ? 'mono lap-pb' : 'mono'}>
|
||||||
{driver.LastLapTime || '-'}
|
{driver.LastLapTime || '-'}
|
||||||
</td>
|
</td>
|
||||||
<td className="mono">{gapText || '-'}</td>
|
<td className="mono">
|
||||||
|
<Meaning
|
||||||
|
value={gapText || '-'}
|
||||||
|
meaning={intervalAnnotation?.caption}
|
||||||
|
title={intervalAnnotation?.title}
|
||||||
|
tone={intervalAnnotation?.tone}
|
||||||
|
/>
|
||||||
|
</td>
|
||||||
|
|
||||||
{isRace && (
|
{isRace && (
|
||||||
<td className="spark-cell">
|
<td className="spark-cell">
|
||||||
|
|||||||
145
frontend/src/components/live/TrackMap.tsx
Normal file
145
frontend/src/components/live/TrackMap.tsx
Normal file
@@ -0,0 +1,145 @@
|
|||||||
|
import { useMemo, useState } from 'react'
|
||||||
|
import type {
|
||||||
|
LiveDriverData,
|
||||||
|
LiveDriverInfo,
|
||||||
|
LivePosition,
|
||||||
|
LiveTelemetry,
|
||||||
|
TrackOutline,
|
||||||
|
} from '../../types'
|
||||||
|
import {
|
||||||
|
buildOutlinePath,
|
||||||
|
canvasToSvg,
|
||||||
|
isOnTrack,
|
||||||
|
normalizeRawPoint,
|
||||||
|
} from '../../lib/trackmap'
|
||||||
|
|
||||||
|
interface Props {
|
||||||
|
outline?: TrackOutline | null
|
||||||
|
positions: Record<string, LivePosition>
|
||||||
|
telemetry?: Record<string, LiveTelemetry>
|
||||||
|
drivers?: Record<string, LiveDriverData>
|
||||||
|
driverInfo?: Record<string, LiveDriverInfo>
|
||||||
|
loading?: boolean
|
||||||
|
}
|
||||||
|
|
||||||
|
export function TrackMap({
|
||||||
|
outline,
|
||||||
|
positions,
|
||||||
|
telemetry = {},
|
||||||
|
drivers = {},
|
||||||
|
driverInfo = {},
|
||||||
|
loading = false,
|
||||||
|
}: Props) {
|
||||||
|
const [selected, setSelected] = useState<string | null>(null)
|
||||||
|
const outlinePath = useMemo(() => buildOutlinePath(outline?.points ?? []), [outline])
|
||||||
|
const cars = useMemo(() => {
|
||||||
|
if (!outline?.bounds) return []
|
||||||
|
return Object.entries(positions)
|
||||||
|
.map(([number, position]) => {
|
||||||
|
const canvas = normalizeRawPoint(position, outline.bounds)
|
||||||
|
return {
|
||||||
|
number,
|
||||||
|
position,
|
||||||
|
svg: canvasToSvg(canvas),
|
||||||
|
info: driverInfo[number],
|
||||||
|
driver: drivers[number],
|
||||||
|
telemetry: telemetry[number],
|
||||||
|
active: isOnTrack(position.status) && !drivers[number]?.Retired,
|
||||||
|
}
|
||||||
|
})
|
||||||
|
.sort((a, b) => Number(a.number) - Number(b.number))
|
||||||
|
}, [driverInfo, drivers, outline?.bounds, positions, telemetry])
|
||||||
|
|
||||||
|
const selectedCar = selected ? cars.find((car) => car.number === selected) : null
|
||||||
|
|
||||||
|
if (loading) {
|
||||||
|
return (
|
||||||
|
<section className="live-track-panel" data-testid="track-map">
|
||||||
|
<div className="sec-header">
|
||||||
|
<span className="sec-title">Track Map</span>
|
||||||
|
</div>
|
||||||
|
<div className="track-map-empty">loading cached circuit outline...</div>
|
||||||
|
</section>
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
if (!outline || !outlinePath) {
|
||||||
|
return (
|
||||||
|
<section className="live-track-panel" data-testid="track-map">
|
||||||
|
<div className="sec-header">
|
||||||
|
<span className="sec-title">Track Map</span>
|
||||||
|
</div>
|
||||||
|
<div className="track-map-empty">track outline unavailable for this live session</div>
|
||||||
|
</section>
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
return (
|
||||||
|
<section className="live-track-panel" data-testid="track-map">
|
||||||
|
<div className="sec-header">
|
||||||
|
<span className="sec-title">Track Map</span>
|
||||||
|
<span className="sec-meta">{cars.length ? `${cars.length} cars` : 'waiting for GPS'}</span>
|
||||||
|
</div>
|
||||||
|
<div className="track-map-stage">
|
||||||
|
<svg className="track-map-svg" viewBox="0 0 100 100" role="img" aria-label="Live track map">
|
||||||
|
<path className="track-map-outline-shadow" d={outlinePath} />
|
||||||
|
<path className="track-map-outline" d={outlinePath} />
|
||||||
|
{cars.map((car) => {
|
||||||
|
const label = car.info?.Tla || car.number
|
||||||
|
return (
|
||||||
|
<g
|
||||||
|
key={car.number}
|
||||||
|
role="button"
|
||||||
|
tabIndex={0}
|
||||||
|
aria-label={`${label} telemetry`}
|
||||||
|
className={`track-car ${car.active ? 'track-car-active' : 'track-car-inactive'} ${selected === car.number ? 'track-car-selected' : ''}`}
|
||||||
|
transform={`translate(${car.svg.x.toFixed(2)} ${car.svg.y.toFixed(2)})`}
|
||||||
|
onClick={() => setSelected(car.number)}
|
||||||
|
onKeyDown={(event) => {
|
||||||
|
if (event.key === 'Enter' || event.key === ' ') {
|
||||||
|
event.preventDefault()
|
||||||
|
setSelected(car.number)
|
||||||
|
}
|
||||||
|
}}
|
||||||
|
>
|
||||||
|
<circle r="2.8" fill={teamColor(car.info)} />
|
||||||
|
<text y="0.85">{label}</text>
|
||||||
|
</g>
|
||||||
|
)
|
||||||
|
})}
|
||||||
|
</svg>
|
||||||
|
{cars.length === 0 && <div className="track-map-empty track-map-overlay">waiting for live GPS</div>}
|
||||||
|
{selectedCar && (
|
||||||
|
<div className="track-telemetry" data-testid="track-telemetry">
|
||||||
|
<div className="track-telemetry-head">
|
||||||
|
<span className="track-driver-code">{selectedCar.info?.Tla || selectedCar.number}</span>
|
||||||
|
<span>{selectedCar.position.status || 'OnTrack'}</span>
|
||||||
|
</div>
|
||||||
|
<dl>
|
||||||
|
<Metric label="SPD" value={selectedCar.telemetry?.Speed} suffix="km/h" />
|
||||||
|
<Metric label="THR" value={selectedCar.telemetry?.Throttle} suffix="%" />
|
||||||
|
<Metric label="BRK" value={selectedCar.telemetry?.Brake} suffix="%" />
|
||||||
|
<Metric label="DRS" value={selectedCar.telemetry?.DRS} />
|
||||||
|
<Metric label="GEAR" value={selectedCar.telemetry?.NGear} />
|
||||||
|
</dl>
|
||||||
|
</div>
|
||||||
|
)}
|
||||||
|
</div>
|
||||||
|
</section>
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
function Metric({ label, value, suffix = '' }: { label: string; value: number | undefined; suffix?: string }) {
|
||||||
|
return (
|
||||||
|
<>
|
||||||
|
<dt>{label}</dt>
|
||||||
|
<dd>{value === undefined ? '-' : `${value}${suffix}`}</dd>
|
||||||
|
</>
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
function teamColor(info: LiveDriverInfo | undefined): string {
|
||||||
|
const raw = info?.TeamColour?.trim()
|
||||||
|
if (!raw) return '#777777'
|
||||||
|
return raw.startsWith('#') ? raw : `#${raw}`
|
||||||
|
}
|
||||||
140
frontend/src/components/live/TyreDegPanel.tsx
Normal file
140
frontend/src/components/live/TyreDegPanel.tsx
Normal file
@@ -0,0 +1,140 @@
|
|||||||
|
import { useEffect, useMemo, useState } from 'react'
|
||||||
|
import { teamColor } from '../../utils'
|
||||||
|
import type { LiveTimingRow } from '../../lib/live'
|
||||||
|
import { compoundClass, driverCode, tyreLabel } from '../../lib/live'
|
||||||
|
import { sparklinePoints } from '../../lib/gapHistory'
|
||||||
|
import { isRaceSession } from '../../lib/battles'
|
||||||
|
import type { StintHistoryMap } from '../../lib/tyredeg'
|
||||||
|
import {
|
||||||
|
PIT_LOSS_SECONDS,
|
||||||
|
degradationModel,
|
||||||
|
estimatePitRejoin,
|
||||||
|
formatSlope,
|
||||||
|
recordStintSamples,
|
||||||
|
stintInputFromRow,
|
||||||
|
} from '../../lib/tyredeg'
|
||||||
|
import { tyreAgeMeaning } from '../../lib/meaning'
|
||||||
|
import { Meaning } from '../Meaning'
|
||||||
|
import '../../styles/tyredeg.css'
|
||||||
|
|
||||||
|
const TOP_DRIVER_COUNT = 10
|
||||||
|
const SPARK_WIDTH = 64
|
||||||
|
const SPARK_HEIGHT = 16
|
||||||
|
|
||||||
|
interface Props {
|
||||||
|
rows: LiveTimingRow[]
|
||||||
|
sessionType: string | undefined
|
||||||
|
pinned: string[]
|
||||||
|
}
|
||||||
|
|
||||||
|
function StintSparkline({ seconds }: { seconds: number[] }) {
|
||||||
|
if (seconds.length < 2) return <span className="tyredeg-spark-empty">·</span>
|
||||||
|
const points = sparklinePoints(seconds, SPARK_WIDTH, SPARK_HEIGHT)
|
||||||
|
return (
|
||||||
|
<svg
|
||||||
|
className="tyredeg-spark"
|
||||||
|
width={SPARK_WIDTH}
|
||||||
|
height={SPARK_HEIGHT}
|
||||||
|
viewBox={`0 0 ${SPARK_WIDTH} ${SPARK_HEIGHT}`}
|
||||||
|
aria-hidden="true"
|
||||||
|
focusable="false"
|
||||||
|
>
|
||||||
|
<polyline
|
||||||
|
points={points}
|
||||||
|
fill="none"
|
||||||
|
stroke="currentColor"
|
||||||
|
strokeWidth="1.2"
|
||||||
|
strokeLinejoin="round"
|
||||||
|
strokeLinecap="round"
|
||||||
|
/>
|
||||||
|
</svg>
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
export function TyreDegPanel({ rows, sessionType, pinned }: Props) {
|
||||||
|
const [collapsed, setCollapsed] = useState(false)
|
||||||
|
const [stints, setStints] = useState<StintHistoryMap>({})
|
||||||
|
|
||||||
|
// One lap-history update per received snapshot (rows is rebuilt per snapshot).
|
||||||
|
useEffect(() => {
|
||||||
|
if (rows.length === 0) return
|
||||||
|
setStints((prev) => recordStintSamples(prev, rows.map(stintInputFromRow)))
|
||||||
|
}, [rows])
|
||||||
|
|
||||||
|
const isRace = isRaceSession(sessionType)
|
||||||
|
|
||||||
|
const visible = useMemo(
|
||||||
|
() =>
|
||||||
|
rows.filter(
|
||||||
|
(row) =>
|
||||||
|
row.Position > 0 &&
|
||||||
|
!row.Driver.Retired &&
|
||||||
|
(row.Position <= TOP_DRIVER_COUNT || pinned.includes(row.RacingNumber)),
|
||||||
|
),
|
||||||
|
[rows, pinned],
|
||||||
|
)
|
||||||
|
|
||||||
|
if (visible.length === 0) return null
|
||||||
|
|
||||||
|
return (
|
||||||
|
<section className="live-tyredeg-panel" data-testid="tyredeg-panel">
|
||||||
|
<button
|
||||||
|
type="button"
|
||||||
|
className="sec-header tyredeg-toggle"
|
||||||
|
onClick={() => setCollapsed((prev) => !prev)}
|
||||||
|
aria-expanded={!collapsed}
|
||||||
|
>
|
||||||
|
<span className="sec-title">Tyre Deg & Pit Window</span>
|
||||||
|
{isRace && <span className="sec-meta">rejoin assumes ~{PIT_LOSS_SECONDS}s pit loss</span>}
|
||||||
|
<span className="tyredeg-chevron" aria-hidden="true">{collapsed ? '▸' : '▾'}</span>
|
||||||
|
</button>
|
||||||
|
|
||||||
|
{!collapsed && (
|
||||||
|
<div className="tyredeg-rows">
|
||||||
|
{visible.map((row) => {
|
||||||
|
const model = degradationModel(stints[row.RacingNumber]?.samples ?? [])
|
||||||
|
const rejoin = isRace ? estimatePitRejoin(rows, row.RacingNumber) : null
|
||||||
|
const ageAnnotation = tyreAgeMeaning(row.Tyre?.Compound, row.Tyre?.Age)
|
||||||
|
return (
|
||||||
|
<div className="tyredeg-row" key={row.RacingNumber} data-testid="tyredeg-row">
|
||||||
|
<span className="tyredeg-pos mono">P{row.Position}</span>
|
||||||
|
<span className="drv-bar" style={{ background: teamColor(row.Info?.TeamColour) }} />
|
||||||
|
<span className="drv-code">{driverCode(row)}</span>
|
||||||
|
<span className={`tyre-badge ${compoundClass(row.Tyre?.Compound)}`}>
|
||||||
|
<Meaning
|
||||||
|
value={tyreLabel(row.Tyre)}
|
||||||
|
meaning={ageAnnotation?.caption}
|
||||||
|
title={ageAnnotation?.title}
|
||||||
|
tone={ageAnnotation?.tone}
|
||||||
|
/>
|
||||||
|
</span>
|
||||||
|
{model ? (
|
||||||
|
<>
|
||||||
|
<span className={`tyredeg-trend tyredeg-trend-${model.trend}`}>
|
||||||
|
<StintSparkline seconds={model.samples.map((sample) => sample.seconds)} />
|
||||||
|
</span>
|
||||||
|
<span className={`tyredeg-slope mono tyredeg-trend-${model.trend}`}>
|
||||||
|
{formatSlope(model.slope)}
|
||||||
|
</span>
|
||||||
|
</>
|
||||||
|
) : (
|
||||||
|
<span className="tyredeg-warmup">warming up</span>
|
||||||
|
)}
|
||||||
|
{rejoin && (
|
||||||
|
<span className="tyredeg-rejoin mono" title={`Pits now: rejoins ~P${rejoin.rejoinPosition}`}>
|
||||||
|
→ ~P{rejoin.rejoinPosition}
|
||||||
|
{rejoin.aheadCode && rejoin.behindCode && (
|
||||||
|
<span className="tyredeg-rejoin-between">
|
||||||
|
{rejoin.aheadCode} · {rejoin.behindCode}
|
||||||
|
</span>
|
||||||
|
)}
|
||||||
|
</span>
|
||||||
|
)}
|
||||||
|
</div>
|
||||||
|
)
|
||||||
|
})}
|
||||||
|
</div>
|
||||||
|
)}
|
||||||
|
</section>
|
||||||
|
)
|
||||||
|
}
|
||||||
202
frontend/src/lib/compare.ts
Normal file
202
frontend/src/lib/compare.ts
Normal file
@@ -0,0 +1,202 @@
|
|||||||
|
// Driver comparison mapping — pure functions for telemetry traces and lap deltas.
|
||||||
|
|
||||||
|
import type { TelemetryTraceSeries } from '../components/charts/TelemetryTraceChart'
|
||||||
|
import type { DeltaSeries } from '../lib/delta'
|
||||||
|
import type {
|
||||||
|
CarDataSample,
|
||||||
|
ComparisonLap,
|
||||||
|
Driver,
|
||||||
|
EnrichedResult,
|
||||||
|
LapsComparisonResponse,
|
||||||
|
} from '../types'
|
||||||
|
import { compareFinishPosition, teamColor } from '../utils'
|
||||||
|
|
||||||
|
function sortDriversByResults(drivers: Driver[], results: EnrichedResult[]): Driver[] {
|
||||||
|
const order = new Map(
|
||||||
|
[...results]
|
||||||
|
.filter((r) => r.position > 0)
|
||||||
|
.sort((a, b) => compareFinishPosition(a.position, b.position))
|
||||||
|
.map((r, i) => [r.driver_number, i]),
|
||||||
|
)
|
||||||
|
return [...drivers].sort((a, b) => {
|
||||||
|
const ao = order.get(a.driver_number) ?? 999
|
||||||
|
const bo = order.get(b.driver_number) ?? 999
|
||||||
|
if (ao !== bo) return ao - bo
|
||||||
|
return a.driver_number - b.driver_number
|
||||||
|
})
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Default compare pair: top two classified finishers, else first two session drivers. */
|
||||||
|
export function defaultCompareDriverNumbers(
|
||||||
|
results: EnrichedResult[],
|
||||||
|
drivers: Driver[],
|
||||||
|
): [number, number] | null {
|
||||||
|
const classified = [...results]
|
||||||
|
.filter((r) => r.position > 0)
|
||||||
|
.sort((a, b) => compareFinishPosition(a.position, b.position))
|
||||||
|
|
||||||
|
if (classified.length >= 2) {
|
||||||
|
return [classified[0].driver_number, classified[1].driver_number]
|
||||||
|
}
|
||||||
|
|
||||||
|
if (drivers.length >= 2) {
|
||||||
|
const sorted = sortDriversByResults(drivers, results)
|
||||||
|
return [sorted[0].driver_number, sorted[1].driver_number]
|
||||||
|
}
|
||||||
|
|
||||||
|
if (classified.length === 1 && drivers.length >= 1) {
|
||||||
|
const other = drivers.find((d) => d.driver_number !== classified[0].driver_number)
|
||||||
|
if (other) return [classified[0].driver_number, other.driver_number]
|
||||||
|
}
|
||||||
|
|
||||||
|
return null
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Lap records → per-lap duration array (index 0 = lap 1); null for pit/out laps. */
|
||||||
|
export function lapsToLapTimes(laps: ComparisonLap[]): (number | null)[] {
|
||||||
|
if (laps.length === 0) return []
|
||||||
|
|
||||||
|
const maxLap = laps.reduce((max, lap) => Math.max(max, lap.lap_number), 0)
|
||||||
|
const times: (number | null)[] = Array.from({ length: maxLap }, () => null)
|
||||||
|
|
||||||
|
for (const lap of laps) {
|
||||||
|
const idx = lap.lap_number - 1
|
||||||
|
if (idx < 0) continue
|
||||||
|
if (lap.is_pit_out_lap || lap.lap_duration == null || lap.lap_duration <= 0) {
|
||||||
|
times[idx] = null
|
||||||
|
} else {
|
||||||
|
times[idx] = lap.lap_duration
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
return times
|
||||||
|
}
|
||||||
|
|
||||||
|
export function findBestLap(laps: ComparisonLap[]): ComparisonLap | null {
|
||||||
|
let best: ComparisonLap | null = null
|
||||||
|
for (const lap of laps) {
|
||||||
|
if (lap.lap_duration == null || lap.lap_duration <= 0) continue
|
||||||
|
if (!best || (best.lap_duration ?? Infinity) > lap.lap_duration) {
|
||||||
|
best = lap
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return best
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Keep car-data samples whose timestamps fall within a lap window. */
|
||||||
|
export function filterCarDataToLap(
|
||||||
|
samples: CarDataSample[],
|
||||||
|
lap: ComparisonLap,
|
||||||
|
): CarDataSample[] {
|
||||||
|
if (!lap.date_start || samples.length === 0) return samples
|
||||||
|
|
||||||
|
const start = new Date(lap.date_start).getTime()
|
||||||
|
if (!Number.isFinite(start)) return samples
|
||||||
|
|
||||||
|
const end = start + (lap.lap_duration ?? 0) * 1000 + 500
|
||||||
|
|
||||||
|
return samples.filter((s) => {
|
||||||
|
const t = new Date(s.date).getTime()
|
||||||
|
return Number.isFinite(t) && t >= start && t <= end
|
||||||
|
})
|
||||||
|
}
|
||||||
|
|
||||||
|
export function carDataToTraceSeries(
|
||||||
|
samples: CarDataSample[],
|
||||||
|
label: string,
|
||||||
|
color: string,
|
||||||
|
): TelemetryTraceSeries {
|
||||||
|
return {
|
||||||
|
label,
|
||||||
|
color,
|
||||||
|
samples: samples.map((s) => ({
|
||||||
|
speed: s.speed,
|
||||||
|
throttle: s.throttle,
|
||||||
|
brake: s.brake,
|
||||||
|
})),
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
export function buildBestLapTraceSeries(
|
||||||
|
carData: CarDataSample[],
|
||||||
|
laps: ComparisonLap[],
|
||||||
|
label: string,
|
||||||
|
color: string,
|
||||||
|
): TelemetryTraceSeries | null {
|
||||||
|
const best = findBestLap(laps)
|
||||||
|
if (!best) return null
|
||||||
|
|
||||||
|
const filtered = filterCarDataToLap(carData, best)
|
||||||
|
if (filtered.length === 0) return null
|
||||||
|
|
||||||
|
return carDataToTraceSeries(filtered, label, color)
|
||||||
|
}
|
||||||
|
|
||||||
|
function driverMeta(
|
||||||
|
driverNumber: number,
|
||||||
|
comparison: LapsComparisonResponse | undefined,
|
||||||
|
drivers: Driver[],
|
||||||
|
): { label: string; color: string; laps: ComparisonLap[] } {
|
||||||
|
const comp = comparison?.drivers.find((d) => d.driver_number === driverNumber)
|
||||||
|
const session = drivers.find((d) => d.driver_number === driverNumber)
|
||||||
|
return {
|
||||||
|
label: comp?.name_acronym || session?.name_acronym || `#${driverNumber}`,
|
||||||
|
color: teamColor(comp?.team_colour || session?.team_colour),
|
||||||
|
laps: comp?.laps ?? [],
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
export function comparisonToDeltaSeries(
|
||||||
|
comparison: LapsComparisonResponse,
|
||||||
|
driverNumbers: [number, number],
|
||||||
|
drivers: Driver[],
|
||||||
|
): DeltaSeries[] {
|
||||||
|
return driverNumbers.map((dn) => {
|
||||||
|
const meta = driverMeta(dn, comparison, drivers)
|
||||||
|
return {
|
||||||
|
label: meta.label,
|
||||||
|
color: meta.color,
|
||||||
|
lapTimes: lapsToLapTimes(meta.laps),
|
||||||
|
}
|
||||||
|
})
|
||||||
|
}
|
||||||
|
|
||||||
|
export function formatPitLapsCaption(
|
||||||
|
pitLaps: Record<string, number[]>,
|
||||||
|
driverNumbers: [number, number],
|
||||||
|
comparison: LapsComparisonResponse | undefined,
|
||||||
|
drivers: Driver[],
|
||||||
|
): string | null {
|
||||||
|
const parts: string[] = []
|
||||||
|
|
||||||
|
for (const dn of driverNumbers) {
|
||||||
|
const laps = pitLaps[String(dn)]
|
||||||
|
if (!laps?.length) continue
|
||||||
|
const meta = driverMeta(dn, comparison, drivers)
|
||||||
|
parts.push(`${meta.label}: L${laps.join(', L')}`)
|
||||||
|
}
|
||||||
|
|
||||||
|
return parts.length > 0 ? `Pit stops — ${parts.join(' · ')}` : null
|
||||||
|
}
|
||||||
|
|
||||||
|
export function compareDriverOptions(
|
||||||
|
drivers: Driver[],
|
||||||
|
results: EnrichedResult[],
|
||||||
|
): Driver[] {
|
||||||
|
if (drivers.length > 0) {
|
||||||
|
return sortDriversByResults(drivers, results)
|
||||||
|
}
|
||||||
|
return results.map((r) => ({
|
||||||
|
driver_number: r.driver_number,
|
||||||
|
name_acronym: r.name_acronym,
|
||||||
|
full_name: r.full_name,
|
||||||
|
first_name: '',
|
||||||
|
last_name: '',
|
||||||
|
team_name: r.team_name,
|
||||||
|
team_colour: r.team_colour,
|
||||||
|
headshot_url: '',
|
||||||
|
broadcast_name: r.full_name,
|
||||||
|
session_key: r.session_key,
|
||||||
|
meeting_key: r.meeting_key,
|
||||||
|
}))
|
||||||
|
}
|
||||||
127
frontend/src/lib/delta.ts
Normal file
127
frontend/src/lib/delta.ts
Normal file
@@ -0,0 +1,127 @@
|
|||||||
|
// Cumulative lap-time delta math for driver comparison charts.
|
||||||
|
// Pure functions only — no React — so everything is unit-testable.
|
||||||
|
|
||||||
|
export interface DeltaSeries {
|
||||||
|
label: string
|
||||||
|
color: string
|
||||||
|
/** Lap duration in seconds; null = no time (pit/out lap). */
|
||||||
|
lapTimes: (number | null)[]
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface DriverDeltaResult {
|
||||||
|
label: string
|
||||||
|
color: string
|
||||||
|
/** Cumulative delta vs reference (seconds); null when that lap has no time. */
|
||||||
|
deltas: (number | null)[]
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Format a delta value for axis labels and tooltips (e.g. "+2.5s", "-1.2s"). */
|
||||||
|
export function formatDeltaSeconds(delta: number): string {
|
||||||
|
const sign = delta >= 0 ? '+' : ''
|
||||||
|
return `${sign}${delta.toFixed(1)}s`
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Cumulative lap time aligned to reference-valid laps only.
|
||||||
|
* Laps where the reference is null are skipped for every series so later deltas
|
||||||
|
* do not compare against a frozen baseline while challengers keep accumulating.
|
||||||
|
*/
|
||||||
|
function buildAlignedCumulative(
|
||||||
|
lapTimes: ReadonlyArray<number | null>,
|
||||||
|
referenceLapTimes: ReadonlyArray<number | null>,
|
||||||
|
): number[] {
|
||||||
|
const cumulative: number[] = []
|
||||||
|
let running = 0
|
||||||
|
const length = Math.max(lapTimes.length, referenceLapTimes.length)
|
||||||
|
|
||||||
|
for (let i = 0; i < length; i++) {
|
||||||
|
if (referenceLapTimes[i] == null) {
|
||||||
|
cumulative.push(running)
|
||||||
|
continue
|
||||||
|
}
|
||||||
|
const lap = lapTimes[i]
|
||||||
|
if (lap != null) {
|
||||||
|
running += lap
|
||||||
|
}
|
||||||
|
cumulative.push(running)
|
||||||
|
}
|
||||||
|
|
||||||
|
return cumulative
|
||||||
|
}
|
||||||
|
|
||||||
|
function resolveReference(
|
||||||
|
series: ReadonlyArray<DeltaSeries>,
|
||||||
|
referenceLabel?: string,
|
||||||
|
): DeltaSeries | null {
|
||||||
|
if (series.length === 0) return null
|
||||||
|
if (referenceLabel) {
|
||||||
|
return series.find((s) => s.label === referenceLabel) ?? series[0]
|
||||||
|
}
|
||||||
|
return series[0]
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Compute per-lap cumulative time delta for each non-reference driver.
|
||||||
|
* Positive = behind reference; negative = ahead.
|
||||||
|
* Deltas are only emitted where the reference lap is valid; reference-null laps
|
||||||
|
* gap every series. Challenger-null laps gap only that driver's line.
|
||||||
|
*/
|
||||||
|
export function computeCumulativeDeltas(
|
||||||
|
series: ReadonlyArray<DeltaSeries>,
|
||||||
|
referenceLabel?: string,
|
||||||
|
): DriverDeltaResult[] {
|
||||||
|
const reference = resolveReference(series, referenceLabel)
|
||||||
|
if (!reference) return []
|
||||||
|
|
||||||
|
const refLapTimes = reference.lapTimes
|
||||||
|
const refCumulative = buildAlignedCumulative(refLapTimes, refLapTimes)
|
||||||
|
|
||||||
|
return series
|
||||||
|
.filter((s) => s.label !== reference.label)
|
||||||
|
.map((driver) => {
|
||||||
|
const driverCumulative = buildAlignedCumulative(driver.lapTimes, refLapTimes)
|
||||||
|
const lapCount = Math.max(driver.lapTimes.length, refCumulative.length)
|
||||||
|
const deltas: (number | null)[] = []
|
||||||
|
|
||||||
|
for (let i = 0; i < lapCount; i++) {
|
||||||
|
if (refLapTimes[i] == null || driver.lapTimes[i] == null) {
|
||||||
|
deltas.push(null)
|
||||||
|
continue
|
||||||
|
}
|
||||||
|
deltas.push(driverCumulative[i] - refCumulative[i])
|
||||||
|
}
|
||||||
|
|
||||||
|
return {
|
||||||
|
label: driver.label,
|
||||||
|
color: driver.color,
|
||||||
|
deltas,
|
||||||
|
}
|
||||||
|
})
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Split delta samples into contiguous SVG polyline point strings (gaps at null laps). */
|
||||||
|
export function deltaPolylineSegments(
|
||||||
|
deltas: ReadonlyArray<number | null>,
|
||||||
|
toPoint: (lapIndex: number, delta: number) => string,
|
||||||
|
): string[] {
|
||||||
|
const segments: string[] = []
|
||||||
|
let current: string[] = []
|
||||||
|
|
||||||
|
for (let i = 0; i < deltas.length; i++) {
|
||||||
|
const value = deltas[i]
|
||||||
|
if (value === null) {
|
||||||
|
if (current.length > 0) {
|
||||||
|
segments.push(current.join(' '))
|
||||||
|
current = []
|
||||||
|
}
|
||||||
|
continue
|
||||||
|
}
|
||||||
|
current.push(toPoint(i, value))
|
||||||
|
}
|
||||||
|
|
||||||
|
if (current.length > 0) {
|
||||||
|
segments.push(current.join(' '))
|
||||||
|
}
|
||||||
|
|
||||||
|
return segments
|
||||||
|
}
|
||||||
318
frontend/src/lib/events.ts
Normal file
318
frontend/src/lib/events.ts
Normal file
@@ -0,0 +1,318 @@
|
|||||||
|
// "What just happened" event synthesis for the live page.
|
||||||
|
// Pure functions only — no React, no side effects — so everything is unit-testable.
|
||||||
|
// Mirrors the gapHistory/battles precedent: successive LiveStreamData snapshots
|
||||||
|
// in, typed events out; the page owns the buffer, this module owns the diffing.
|
||||||
|
|
||||||
|
import type {
|
||||||
|
LiveDriverData,
|
||||||
|
LiveRCMessage,
|
||||||
|
LiveSessionMeta,
|
||||||
|
LiveStreamData,
|
||||||
|
} from '../types'
|
||||||
|
|
||||||
|
export const MAX_EVENTS = 30
|
||||||
|
|
||||||
|
export type LiveEventKind =
|
||||||
|
| 'overtake'
|
||||||
|
| 'position-gain'
|
||||||
|
| 'position-loss'
|
||||||
|
| 'pit-in'
|
||||||
|
| 'pit-out'
|
||||||
|
| 'personal-best'
|
||||||
|
| 'fastest-lap'
|
||||||
|
| 'retirement'
|
||||||
|
| 'track-status'
|
||||||
|
| 'race-control'
|
||||||
|
|
||||||
|
export interface LiveEvent {
|
||||||
|
id: string
|
||||||
|
kind: LiveEventKind
|
||||||
|
lap: number
|
||||||
|
timestamp: string
|
||||||
|
headline: string
|
||||||
|
detail?: string
|
||||||
|
racingNumbers: string[]
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Identity of the running session, used to reset the event buffer when a new
|
||||||
|
* session starts. LiveSessionMeta carries no numeric session key, so the
|
||||||
|
* meeting + session name/type triple stands in for one.
|
||||||
|
*/
|
||||||
|
export function sessionSignature(session: LiveSessionMeta | null | undefined): string {
|
||||||
|
if (!session) return ''
|
||||||
|
return [session.MeetingName, session.SessionName, session.SessionType].join('|')
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Prepend freshly diffed events onto the newest-first buffer, dropping any
|
||||||
|
* whose id is already present (re-renders and replayed diffs must not
|
||||||
|
* duplicate) and evicting the oldest events beyond `cap`.
|
||||||
|
*/
|
||||||
|
export function appendEvents(
|
||||||
|
buffer: ReadonlyArray<LiveEvent>,
|
||||||
|
incoming: ReadonlyArray<LiveEvent>,
|
||||||
|
cap = MAX_EVENTS,
|
||||||
|
): LiveEvent[] {
|
||||||
|
const seen = new Set(buffer.map((event) => event.id))
|
||||||
|
const fresh = incoming.filter((event) => {
|
||||||
|
if (seen.has(event.id)) return false
|
||||||
|
seen.add(event.id)
|
||||||
|
return true
|
||||||
|
})
|
||||||
|
if (fresh.length === 0) return [...buffer]
|
||||||
|
// Within one diff the array is oldest-first; reverse so the last-produced
|
||||||
|
// event ends up at the top of the newest-first rail.
|
||||||
|
return [...fresh.reverse(), ...buffer].slice(0, cap)
|
||||||
|
}
|
||||||
|
|
||||||
|
const TRACK_STATUS_HEADLINES: Record<string, string> = {
|
||||||
|
'1': 'Green flag — track clear',
|
||||||
|
'2': 'Yellow flag',
|
||||||
|
'4': 'Safety Car deployed',
|
||||||
|
'5': 'Red flag — session stopped',
|
||||||
|
'6': 'Virtual Safety Car deployed',
|
||||||
|
'7': 'Virtual Safety Car ending',
|
||||||
|
}
|
||||||
|
|
||||||
|
const RC_CATEGORIES = new Set(['flag', 'safetycar', 'drs'])
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Diff two successive live snapshots into a chronological list of synthesized
|
||||||
|
* events. Callers are expected to feed genuinely consecutive snapshots of the
|
||||||
|
* same session; diffing across a session boundary is the caller's job to
|
||||||
|
* prevent (see sessionSignature).
|
||||||
|
*/
|
||||||
|
export function diffSnapshots(prev: LiveStreamData, next: LiveStreamData): LiveEvent[] {
|
||||||
|
if (!prev || !next || prev === next) return []
|
||||||
|
|
||||||
|
const events: LiveEvent[] = []
|
||||||
|
const lap = next.CurrentLap || 0
|
||||||
|
const timestamp = next.Clock || ''
|
||||||
|
const code = (racingNumber: string): string =>
|
||||||
|
next.DriverInfo?.[racingNumber]?.Tla ||
|
||||||
|
prev.DriverInfo?.[racingNumber]?.Tla ||
|
||||||
|
`#${racingNumber}`
|
||||||
|
|
||||||
|
diffTrackStatus(prev, next, lap, timestamp, events)
|
||||||
|
diffRaceControl(prev, next, events)
|
||||||
|
|
||||||
|
const prevDrivers = prev.Drivers ?? {}
|
||||||
|
const nextDrivers = next.Drivers ?? {}
|
||||||
|
const numbers = Object.keys(nextDrivers).filter((number) => prevDrivers[number])
|
||||||
|
|
||||||
|
// Racing numbers whose position loss is already explained by an overtake
|
||||||
|
// event, so we don't also report a generic "drops to Pn".
|
||||||
|
const overtakenNumbers = new Set<string>()
|
||||||
|
|
||||||
|
for (const number of numbers) {
|
||||||
|
const before = prevDrivers[number]
|
||||||
|
const after = nextDrivers[number]
|
||||||
|
|
||||||
|
if (!before.Retired && after.Retired) {
|
||||||
|
events.push({
|
||||||
|
id: `ret:${number}`,
|
||||||
|
kind: 'retirement',
|
||||||
|
lap,
|
||||||
|
timestamp,
|
||||||
|
headline: `${code(number)} retires`,
|
||||||
|
detail: before.Position > 0 ? `Was running P${before.Position}` : undefined,
|
||||||
|
racingNumbers: [number],
|
||||||
|
})
|
||||||
|
}
|
||||||
|
|
||||||
|
if (!before.InPit && after.InPit && !after.Retired) {
|
||||||
|
const fromPosition = before.Position > 0 ? ` from P${before.Position}` : ''
|
||||||
|
events.push({
|
||||||
|
id: `pit-in:${number}:l${lap}`,
|
||||||
|
kind: 'pit-in',
|
||||||
|
lap,
|
||||||
|
timestamp,
|
||||||
|
headline: `${code(number)} pits${fromPosition}`,
|
||||||
|
racingNumbers: [number],
|
||||||
|
})
|
||||||
|
}
|
||||||
|
|
||||||
|
if (before.InPit && !after.InPit && !after.Retired) {
|
||||||
|
const compound = next.Tyres?.[number]?.Compound || ''
|
||||||
|
const stops = Math.max(0, (next.Stints?.[number]?.length ?? 0) - 1)
|
||||||
|
const parts = [compound, stops > 0 ? `${ordinal(stops)} stop` : ''].filter(Boolean)
|
||||||
|
const rejoined = after.Position > 0 ? ` P${after.Position}` : ''
|
||||||
|
events.push({
|
||||||
|
id: `pit-out:${number}:l${lap}`,
|
||||||
|
kind: 'pit-out',
|
||||||
|
lap,
|
||||||
|
timestamp,
|
||||||
|
headline: `${code(number)} rejoins${rejoined}${parts.length > 0 ? ` (${parts.join(', ')})` : ''}`,
|
||||||
|
racingNumbers: [number],
|
||||||
|
})
|
||||||
|
}
|
||||||
|
|
||||||
|
diffBestLap(number, before, after, code, lap, timestamp, events)
|
||||||
|
}
|
||||||
|
|
||||||
|
// Position gains, with overtake attribution via position swaps.
|
||||||
|
for (const number of numbers) {
|
||||||
|
const before = prevDrivers[number]
|
||||||
|
const after = nextDrivers[number]
|
||||||
|
if (before.Position <= 0 || after.Position <= 0) continue
|
||||||
|
if (after.Position >= before.Position) continue
|
||||||
|
if (after.InPit || after.Retired) continue
|
||||||
|
|
||||||
|
const overtaken = numbers.find((other) => {
|
||||||
|
if (other === number) return false
|
||||||
|
const otherBefore = prevDrivers[other]
|
||||||
|
const otherAfter = nextDrivers[other]
|
||||||
|
return (
|
||||||
|
otherBefore.Position === after.Position &&
|
||||||
|
otherAfter.Position > otherBefore.Position &&
|
||||||
|
!otherAfter.InPit &&
|
||||||
|
!otherAfter.Retired
|
||||||
|
)
|
||||||
|
})
|
||||||
|
|
||||||
|
if (overtaken) {
|
||||||
|
overtakenNumbers.add(overtaken)
|
||||||
|
events.push({
|
||||||
|
id: `overtake:${number}:${overtaken}:p${after.Position}:l${lap}`,
|
||||||
|
kind: 'overtake',
|
||||||
|
lap,
|
||||||
|
timestamp,
|
||||||
|
headline: `${code(number)} overtakes ${code(overtaken)} for P${after.Position}`,
|
||||||
|
detail: before.Position - after.Position > 1 ? `Up from P${before.Position}` : undefined,
|
||||||
|
racingNumbers: [number, overtaken],
|
||||||
|
})
|
||||||
|
} else {
|
||||||
|
events.push({
|
||||||
|
id: `pos:${number}:${before.Position}-${after.Position}:l${lap}`,
|
||||||
|
kind: 'position-gain',
|
||||||
|
lap,
|
||||||
|
timestamp,
|
||||||
|
headline: `${code(number)} moves up to P${after.Position} (from P${before.Position})`,
|
||||||
|
racingNumbers: [number],
|
||||||
|
})
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
// Position losses not already explained by an overtake or a pit visit.
|
||||||
|
for (const number of numbers) {
|
||||||
|
const before = prevDrivers[number]
|
||||||
|
const after = nextDrivers[number]
|
||||||
|
if (before.Position <= 0 || after.Position <= 0) continue
|
||||||
|
if (after.Position <= before.Position) continue
|
||||||
|
if (overtakenNumbers.has(number)) continue
|
||||||
|
if (after.InPit || after.PitOut || after.Retired || before.InPit) continue
|
||||||
|
|
||||||
|
events.push({
|
||||||
|
id: `pos:${number}:${before.Position}-${after.Position}:l${lap}`,
|
||||||
|
kind: 'position-loss',
|
||||||
|
lap,
|
||||||
|
timestamp,
|
||||||
|
headline: `${code(number)} drops to P${after.Position} (from P${before.Position})`,
|
||||||
|
racingNumbers: [number],
|
||||||
|
})
|
||||||
|
}
|
||||||
|
|
||||||
|
return events
|
||||||
|
}
|
||||||
|
|
||||||
|
function diffTrackStatus(
|
||||||
|
prev: LiveStreamData,
|
||||||
|
next: LiveStreamData,
|
||||||
|
lap: number,
|
||||||
|
timestamp: string,
|
||||||
|
events: LiveEvent[],
|
||||||
|
): void {
|
||||||
|
if (!prev.TrackStatus || !next.TrackStatus) return
|
||||||
|
if (prev.TrackStatus === next.TrackStatus) return
|
||||||
|
events.push({
|
||||||
|
id: `track:${next.TrackStatus}:l${lap}`,
|
||||||
|
kind: 'track-status',
|
||||||
|
lap,
|
||||||
|
timestamp,
|
||||||
|
headline: TRACK_STATUS_HEADLINES[next.TrackStatus] ?? `Track status ${next.TrackStatus}`,
|
||||||
|
racingNumbers: [],
|
||||||
|
})
|
||||||
|
}
|
||||||
|
|
||||||
|
function diffRaceControl(prev: LiveStreamData, next: LiveStreamData, events: LiveEvent[]): void {
|
||||||
|
const prevMessages = prev.RCMessages ?? []
|
||||||
|
const seen = new Set(prevMessages.map(rcMessageKey))
|
||||||
|
for (const message of next.RCMessages ?? []) {
|
||||||
|
if (!message.Message || seen.has(rcMessageKey(message))) continue
|
||||||
|
if (!RC_CATEGORIES.has((message.Category || '').toLowerCase())) continue
|
||||||
|
events.push({
|
||||||
|
id: `rc:${rcMessageKey(message)}`,
|
||||||
|
kind: 'race-control',
|
||||||
|
lap: message.Lap || 0,
|
||||||
|
timestamp: message.Time || '',
|
||||||
|
headline: humanizeRaceControl(message.Message),
|
||||||
|
racingNumbers: carNumbersIn(message.Message),
|
||||||
|
})
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function diffBestLap(
|
||||||
|
number: string,
|
||||||
|
before: LiveDriverData,
|
||||||
|
after: LiveDriverData,
|
||||||
|
code: (racingNumber: string) => string,
|
||||||
|
lap: number,
|
||||||
|
timestamp: string,
|
||||||
|
events: LiveEvent[],
|
||||||
|
): void {
|
||||||
|
if (!after.LastLapTime) return
|
||||||
|
const isNewLap = after.LastLapTime !== before.LastLapTime
|
||||||
|
|
||||||
|
if (after.LastLapOB && (isNewLap || !before.LastLapOB)) {
|
||||||
|
events.push({
|
||||||
|
id: `ob:${number}:${after.LastLapTime}`,
|
||||||
|
kind: 'fastest-lap',
|
||||||
|
lap,
|
||||||
|
timestamp,
|
||||||
|
headline: `${code(number)} sets the fastest lap — ${after.LastLapTime}`,
|
||||||
|
racingNumbers: [number],
|
||||||
|
})
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
|
if (after.LastLapPB && !after.LastLapOB && (isNewLap || !before.LastLapPB)) {
|
||||||
|
events.push({
|
||||||
|
id: `pb:${number}:${after.LastLapTime}`,
|
||||||
|
kind: 'personal-best',
|
||||||
|
lap,
|
||||||
|
timestamp,
|
||||||
|
headline: `${code(number)} sets a personal best — ${after.LastLapTime}`,
|
||||||
|
racingNumbers: [number],
|
||||||
|
})
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function rcMessageKey(message: LiveRCMessage): string {
|
||||||
|
return `${message.Time}:${message.Message}`
|
||||||
|
}
|
||||||
|
|
||||||
|
/** "SAFETY CAR DEPLOYED" -> "Safety car deployed", keeping known acronyms upper-cased. */
|
||||||
|
export function humanizeRaceControl(message: string): string {
|
||||||
|
const lower = message.trim().toLowerCase()
|
||||||
|
if (!lower) return ''
|
||||||
|
const sentence = lower.charAt(0).toUpperCase() + lower.slice(1)
|
||||||
|
return sentence.replace(/\b(drs|vsc|sc|fia)\b/gi, (acronym) => acronym.toUpperCase())
|
||||||
|
}
|
||||||
|
|
||||||
|
function carNumbersIn(message: string): string[] {
|
||||||
|
const numbers: string[] = []
|
||||||
|
for (const match of message.matchAll(/CAR (\d+)/gi)) {
|
||||||
|
if (!numbers.includes(match[1])) numbers.push(match[1])
|
||||||
|
}
|
||||||
|
return numbers
|
||||||
|
}
|
||||||
|
|
||||||
|
function ordinal(n: number): string {
|
||||||
|
const rem10 = n % 10
|
||||||
|
const rem100 = n % 100
|
||||||
|
if (rem10 === 1 && rem100 !== 11) return `${n}st`
|
||||||
|
if (rem10 === 2 && rem100 !== 12) return `${n}nd`
|
||||||
|
if (rem10 === 3 && rem100 !== 13) return `${n}rd`
|
||||||
|
return `${n}th`
|
||||||
|
}
|
||||||
27
frontend/src/lib/hero.ts
Normal file
27
frontend/src/lib/hero.ts
Normal file
@@ -0,0 +1,27 @@
|
|||||||
|
import type { Session } from '../types'
|
||||||
|
import { sessionEndTime, sessionStartTime, type FocusMeetingKind } from './schedule'
|
||||||
|
|
||||||
|
export type HeroStateKind = 'live' | 'upcoming' | 'between'
|
||||||
|
|
||||||
|
export interface HeroStateInputs {
|
||||||
|
now: Date
|
||||||
|
liveActive: boolean
|
||||||
|
currentSession: Session | null
|
||||||
|
focusKind: FocusMeetingKind | null
|
||||||
|
}
|
||||||
|
|
||||||
|
export function classifySessionStatus(session: Session, now: Date): 'live' | 'done' | 'upcoming' {
|
||||||
|
const start = sessionStartTime(session)
|
||||||
|
const end = sessionEndTime(session)
|
||||||
|
if (start && end && now >= start && now < end) return 'live'
|
||||||
|
if (start && now >= start) return 'done'
|
||||||
|
return 'upcoming'
|
||||||
|
}
|
||||||
|
|
||||||
|
export function heroState(inputs: HeroStateInputs): HeroStateKind {
|
||||||
|
const { liveActive, currentSession, focusKind } = inputs
|
||||||
|
|
||||||
|
if (liveActive || currentSession) return 'live'
|
||||||
|
if (focusKind === 'current') return 'upcoming'
|
||||||
|
return 'between'
|
||||||
|
}
|
||||||
146
frontend/src/lib/meaning.ts
Normal file
146
frontend/src/lib/meaning.ts
Normal file
@@ -0,0 +1,146 @@
|
|||||||
|
// Pure interpretation helpers for pairing numbers with their "so-what".
|
||||||
|
// Thresholds are exported consts so they are cheap to tune in one place.
|
||||||
|
|
||||||
|
import { PIT_LOSS_SECONDS } from './tyredeg'
|
||||||
|
|
||||||
|
/** Gaps under this (seconds) are DRS attack range. */
|
||||||
|
export const INTERVAL_DRS_MAX_SECONDS = 1.0
|
||||||
|
|
||||||
|
/** Lower bound of the undercut window (seconds); contiguous with DRS range. */
|
||||||
|
export const INTERVAL_UNDERCUT_MIN_SECONDS = INTERVAL_DRS_MAX_SECONDS
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Upper bound of the undercut window (seconds). Kept well below typical pit
|
||||||
|
* loss ({@link PIT_LOSS_SECONDS}s) — only a few seconds matter for strategy.
|
||||||
|
*/
|
||||||
|
export const INTERVAL_UNDERCUT_MAX_SECONDS = Math.min(3.0, PIT_LOSS_SECONDS / 7)
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Rough per-compound cliff lap estimates (dry compounds). Wet/intermediate
|
||||||
|
* values are conservative — deg varies wildly with conditions.
|
||||||
|
*/
|
||||||
|
export const TYRE_CLIFF_LAPS: Readonly<Record<string, number>> = {
|
||||||
|
SOFT: 18,
|
||||||
|
MEDIUM: 28,
|
||||||
|
HARD: 38,
|
||||||
|
INTERMEDIATE: 20,
|
||||||
|
WET: 15,
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Default cliff when compound is unknown. */
|
||||||
|
export const TYRE_CLIFF_DEFAULT_LAPS = 25
|
||||||
|
|
||||||
|
/** Championship max points per race (winner). */
|
||||||
|
export const MAX_POINTS_PER_ROUND = 25
|
||||||
|
|
||||||
|
export interface MeaningAnnotation {
|
||||||
|
caption: string
|
||||||
|
title: string
|
||||||
|
tone?: 'good' | 'bad' | 'neutral' | 'warn'
|
||||||
|
}
|
||||||
|
|
||||||
|
function cliffLaps(compound: string | null | undefined): number {
|
||||||
|
if (!compound) return TYRE_CLIFF_DEFAULT_LAPS
|
||||||
|
return TYRE_CLIFF_LAPS[compound.toUpperCase()] ?? TYRE_CLIFF_DEFAULT_LAPS
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Interval / gap-to-ahead meaning for the live timing tower.
|
||||||
|
* Returns null for leader gaps, out-of-range values, or unparsable input.
|
||||||
|
*/
|
||||||
|
export function intervalMeaning(seconds: number | null | undefined): MeaningAnnotation | null {
|
||||||
|
if (seconds == null || !Number.isFinite(seconds) || seconds < 0) return null
|
||||||
|
|
||||||
|
if (seconds < INTERVAL_DRS_MAX_SECONDS) {
|
||||||
|
return {
|
||||||
|
caption: 'DRS range',
|
||||||
|
title: `Within ${INTERVAL_DRS_MAX_SECONDS}s — DRS enabled next straight`,
|
||||||
|
tone: 'good',
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
if (seconds >= INTERVAL_UNDERCUT_MIN_SECONDS && seconds <= INTERVAL_UNDERCUT_MAX_SECONDS) {
|
||||||
|
return {
|
||||||
|
caption: 'undercut window',
|
||||||
|
title: `${INTERVAL_UNDERCUT_MIN_SECONDS}–${INTERVAL_UNDERCUT_MAX_SECONDS}s — pit now could gain a position (vs ~${PIT_LOSS_SECONDS}s stop)`,
|
||||||
|
tone: 'warn',
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
return null
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Tyre-age meaning for deg / stint panels.
|
||||||
|
*/
|
||||||
|
export function tyreAgeMeaning(
|
||||||
|
compound: string | null | undefined,
|
||||||
|
age: number | null | undefined,
|
||||||
|
): MeaningAnnotation | null {
|
||||||
|
if (age == null || !Number.isFinite(age) || age < 0) return null
|
||||||
|
|
||||||
|
const cliff = cliffLaps(compound)
|
||||||
|
const freshEnd = Math.ceil(cliff * 0.25)
|
||||||
|
const midEnd = Math.ceil(cliff * 0.65)
|
||||||
|
|
||||||
|
if (age <= freshEnd) {
|
||||||
|
return {
|
||||||
|
caption: 'fresh',
|
||||||
|
title: `${age} lap${age === 1 ? '' : 's'} on ${compound ?? 'tyre'} — early stint grip`,
|
||||||
|
tone: 'good',
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
if (age <= midEnd) {
|
||||||
|
return {
|
||||||
|
caption: 'mid-life',
|
||||||
|
title: `${age} laps — tyre in its working window before cliff (~${cliff} laps)`,
|
||||||
|
tone: 'neutral',
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
const lapsToCliff = cliff - age
|
||||||
|
if (lapsToCliff <= 0) {
|
||||||
|
return {
|
||||||
|
caption: 'past cliff',
|
||||||
|
title: `${age} laps — beyond typical ${compound ?? 'tyre'} cliff (~${cliff} laps)`,
|
||||||
|
tone: 'bad',
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
return {
|
||||||
|
caption: `~${lapsToCliff} laps to cliff`,
|
||||||
|
title: `${age} of ~${cliff} laps before deg cliff on ${compound ?? 'tyre'}`,
|
||||||
|
tone: 'warn',
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Points gap to the driver directly ahead — catchable-or-not v1.
|
||||||
|
*/
|
||||||
|
export function pointsGapMeaning(
|
||||||
|
gapToAhead: number | null | undefined,
|
||||||
|
roundsLeft: number,
|
||||||
|
driverAhead?: string | null,
|
||||||
|
): MeaningAnnotation | null {
|
||||||
|
if (gapToAhead == null || !Number.isFinite(gapToAhead) || gapToAhead <= 0) return null
|
||||||
|
if (!Number.isFinite(roundsLeft) || roundsLeft <= 0) return null
|
||||||
|
|
||||||
|
const maxCatchable = roundsLeft * MAX_POINTS_PER_ROUND
|
||||||
|
const ahead = driverAhead?.trim() || 'ahead'
|
||||||
|
|
||||||
|
if (gapToAhead > maxCatchable) {
|
||||||
|
return {
|
||||||
|
caption: 'out of reach',
|
||||||
|
title: `+${gapToAhead} pts with ${roundsLeft} round${roundsLeft === 1 ? '' : 's'} left (max ${maxCatchable} available)`,
|
||||||
|
tone: 'bad',
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
const perRound = Math.ceil(gapToAhead / roundsLeft)
|
||||||
|
return {
|
||||||
|
caption: `~${perRound} pts/round`,
|
||||||
|
title: `Needs ~${perRound} pts per round on ${ahead} to catch (${gapToAhead} pts in ${roundsLeft} round${roundsLeft === 1 ? '' : 's'})`,
|
||||||
|
tone: perRound <= 10 ? 'good' : 'warn',
|
||||||
|
}
|
||||||
|
}
|
||||||
123
frontend/src/lib/preview.ts
Normal file
123
frontend/src/lib/preview.ts
Normal file
@@ -0,0 +1,123 @@
|
|||||||
|
import type { ChampionshipHub, EnrichedGrid, EnrichedResult, Meeting, Session } from '../types'
|
||||||
|
import {
|
||||||
|
currentAndNextSession,
|
||||||
|
nextUpcomingMeeting,
|
||||||
|
sessionStartTime,
|
||||||
|
sortSessionsByStart,
|
||||||
|
} from './schedule'
|
||||||
|
|
||||||
|
export const RACE_WIN_POINTS = 25
|
||||||
|
export const SPRINT_WIN_POINTS = 8
|
||||||
|
export const SPRINT_WEEKEND_MAX_POINTS = RACE_WIN_POINTS + SPRINT_WIN_POINTS
|
||||||
|
|
||||||
|
export function pickPreviewMeeting(meetings: Meeting[], now: Date): Meeting | null {
|
||||||
|
const active = meetings.filter((m) => !m.is_cancelled)
|
||||||
|
return nextUpcomingMeeting(active, now)
|
||||||
|
}
|
||||||
|
|
||||||
|
export function findPriorYearMeetingByCircuit(
|
||||||
|
priorYearMeetings: Meeting[],
|
||||||
|
circuitKey: number | undefined,
|
||||||
|
): Meeting | null {
|
||||||
|
if (!circuitKey) return null
|
||||||
|
return priorYearMeetings.find((m) => m.circuit_key === circuitKey && !m.is_cancelled) ?? null
|
||||||
|
}
|
||||||
|
|
||||||
|
export function findRaceSession(sessions: Session[]): Session | null {
|
||||||
|
const sorted = sortSessionsByStart(sessions)
|
||||||
|
return (
|
||||||
|
sorted.find((s) => {
|
||||||
|
const type = s.session_type?.toLowerCase() ?? ''
|
||||||
|
return type.includes('race') && !type.includes('sprint')
|
||||||
|
}) ?? null
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
export function isSprintWeekend(sessions: Session[]): boolean {
|
||||||
|
return sessions.some((s) => {
|
||||||
|
const label = `${s.session_type} ${s.session_name}`.toLowerCase()
|
||||||
|
return /\bsprint\b/.test(label) && !label.includes('sprint qualifying') && !label.includes('sprint shootout')
|
||||||
|
})
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface PodiumPlace {
|
||||||
|
position: number
|
||||||
|
name_acronym: string
|
||||||
|
full_name: string
|
||||||
|
team_name: string
|
||||||
|
team_colour: string
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface PolePosition {
|
||||||
|
name_acronym: string
|
||||||
|
full_name: string
|
||||||
|
team_name: string
|
||||||
|
team_colour: string
|
||||||
|
}
|
||||||
|
|
||||||
|
export function extractPodium(results: EnrichedResult[]): PodiumPlace[] {
|
||||||
|
return results
|
||||||
|
.filter((r) => r.position >= 1 && r.position <= 3 && !r.dns && !r.dsq)
|
||||||
|
.sort((a, b) => a.position - b.position)
|
||||||
|
.map((r) => ({
|
||||||
|
position: r.position,
|
||||||
|
name_acronym: r.name_acronym,
|
||||||
|
full_name: r.full_name,
|
||||||
|
team_name: r.team_name,
|
||||||
|
team_colour: r.team_colour,
|
||||||
|
}))
|
||||||
|
}
|
||||||
|
|
||||||
|
export function extractPole(grid: EnrichedGrid[]): PolePosition | null {
|
||||||
|
const pole = grid.find((g) => g.position === 1)
|
||||||
|
if (!pole) return null
|
||||||
|
return {
|
||||||
|
name_acronym: pole.name_acronym,
|
||||||
|
full_name: pole.full_name,
|
||||||
|
team_name: pole.team_name,
|
||||||
|
team_colour: pole.team_colour,
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface TitleFightDriver {
|
||||||
|
name_acronym: string
|
||||||
|
full_name: string
|
||||||
|
team_colour: string
|
||||||
|
points: number
|
||||||
|
position: number
|
||||||
|
gapToLeader: number
|
||||||
|
gapAfterRaceWin: number
|
||||||
|
gapAfterSprintWeekendMax: number
|
||||||
|
}
|
||||||
|
|
||||||
|
export function buildTitleFightContext(hub: ChampionshipHub): TitleFightDriver[] {
|
||||||
|
if (hub.drivers.length === 0) return []
|
||||||
|
const leader = hub.drivers[0]
|
||||||
|
return hub.drivers.slice(0, 3).map((d) => ({
|
||||||
|
name_acronym: d.name_acronym,
|
||||||
|
full_name: d.full_name,
|
||||||
|
team_colour: d.team_colour,
|
||||||
|
points: d.points,
|
||||||
|
position: d.position,
|
||||||
|
gapToLeader: leader.points - d.points,
|
||||||
|
gapAfterRaceWin: leader.points - (d.points + RACE_WIN_POINTS),
|
||||||
|
gapAfterSprintWeekendMax: leader.points - (d.points + SPRINT_WEEKEND_MAX_POINTS),
|
||||||
|
}))
|
||||||
|
}
|
||||||
|
|
||||||
|
export function countdownTargetSession(sessions: Session[], now: Date): Session | null {
|
||||||
|
const sorted = sortSessionsByStart(sessions)
|
||||||
|
const { next } = currentAndNextSession(sorted, now)
|
||||||
|
if (next) return next
|
||||||
|
for (const session of sorted) {
|
||||||
|
const start = sessionStartTime(session)
|
||||||
|
if (start && start > now) return session
|
||||||
|
}
|
||||||
|
return null
|
||||||
|
}
|
||||||
|
|
||||||
|
export function formatPointsGap(gap: number): string {
|
||||||
|
if (gap === 0) return 'LEADER'
|
||||||
|
const sign = gap > 0 ? '+' : ''
|
||||||
|
return `${sign}${Number.isInteger(gap) ? gap : gap.toFixed(1)}`
|
||||||
|
}
|
||||||
22
frontend/src/lib/radio.ts
Normal file
22
frontend/src/lib/radio.ts
Normal file
@@ -0,0 +1,22 @@
|
|||||||
|
import type { LiveRadioCapture, LiveSessionMeta } from '../types'
|
||||||
|
|
||||||
|
export const LIVE_TIMING_STATIC_BASE = 'https://livetiming.formula1.com/static/'
|
||||||
|
|
||||||
|
export function radioClipUrl(
|
||||||
|
session: Pick<LiveSessionMeta, 'Path'> | null | undefined,
|
||||||
|
capture: Pick<LiveRadioCapture, 'Path'> | null | undefined,
|
||||||
|
): string {
|
||||||
|
const sessionPath = session?.Path?.trim()
|
||||||
|
const capturePath = capture?.Path?.trim()
|
||||||
|
if (!sessionPath || !capturePath) return ''
|
||||||
|
if (/^https?:\/\//i.test(capturePath)) return capturePath
|
||||||
|
|
||||||
|
const base = LIVE_TIMING_STATIC_BASE.replace(/\/+$/, '')
|
||||||
|
const normalizedSession = sessionPath.replace(/^\/+|\/+$/g, '')
|
||||||
|
const normalizedCapture = capturePath.replace(/^\/+/g, '')
|
||||||
|
return `${base}/${normalizedSession}/${normalizedCapture}`
|
||||||
|
}
|
||||||
|
|
||||||
|
export function radioCaptureKey(capture: LiveRadioCapture): string {
|
||||||
|
return `${capture.Utc}-${capture.RacingNumber}-${capture.Path}`
|
||||||
|
}
|
||||||
66
frontend/src/lib/trackmap.ts
Normal file
66
frontend/src/lib/trackmap.ts
Normal file
@@ -0,0 +1,66 @@
|
|||||||
|
import type { LivePosition, TrackBounds, TrackPoint } from '../types'
|
||||||
|
|
||||||
|
export interface CanvasPoint {
|
||||||
|
x: number
|
||||||
|
y: number
|
||||||
|
}
|
||||||
|
|
||||||
|
const VIEWBOX_SIZE = 100
|
||||||
|
|
||||||
|
export function normalizeRawPoint(
|
||||||
|
point: Pick<LivePosition, 'x' | 'y'>,
|
||||||
|
bounds: TrackBounds,
|
||||||
|
): CanvasPoint {
|
||||||
|
return {
|
||||||
|
x: normalizeAxis(point.x, bounds.minX, bounds.maxX),
|
||||||
|
y: 1 - normalizeAxis(point.y, bounds.minY, bounds.maxY),
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
export function outlinePointToCanvas(point: TrackPoint): CanvasPoint {
|
||||||
|
return {
|
||||||
|
x: clamp01(point.x),
|
||||||
|
y: 1 - clamp01(point.y),
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
export function buildOutlinePath(points: ReadonlyArray<TrackPoint>): string {
|
||||||
|
if (points.length < 2) return ''
|
||||||
|
|
||||||
|
return points
|
||||||
|
.map((point, index) => {
|
||||||
|
const canvas = outlinePointToCanvas(point)
|
||||||
|
const command = index === 0 ? 'M' : 'L'
|
||||||
|
return `${command} ${formatSvgCoord(canvas.x)} ${formatSvgCoord(canvas.y)}`
|
||||||
|
})
|
||||||
|
.join(' ')
|
||||||
|
}
|
||||||
|
|
||||||
|
export function canvasToSvg(point: CanvasPoint): CanvasPoint {
|
||||||
|
return {
|
||||||
|
x: clamp01(point.x) * VIEWBOX_SIZE,
|
||||||
|
y: clamp01(point.y) * VIEWBOX_SIZE,
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
export function isOnTrack(status: string | null | undefined): boolean {
|
||||||
|
if (!status) return true
|
||||||
|
const normalized = status.toLowerCase()
|
||||||
|
return normalized === 'ontrack' || normalized === 'on-track' || normalized === 'on_track'
|
||||||
|
}
|
||||||
|
|
||||||
|
function normalizeAxis(value: number, min: number, max: number): number {
|
||||||
|
const range = max - min
|
||||||
|
if (!Number.isFinite(value) || !Number.isFinite(min) || !Number.isFinite(max)) return 0.5
|
||||||
|
if (range === 0) return 0.5
|
||||||
|
return clamp01((value - min) / range)
|
||||||
|
}
|
||||||
|
|
||||||
|
function clamp01(value: number): number {
|
||||||
|
if (!Number.isFinite(value)) return 0.5
|
||||||
|
return Math.min(1, Math.max(0, value))
|
||||||
|
}
|
||||||
|
|
||||||
|
function formatSvgCoord(value: number): string {
|
||||||
|
return (value * VIEWBOX_SIZE).toFixed(2)
|
||||||
|
}
|
||||||
271
frontend/src/lib/tyredeg.ts
Normal file
271
frontend/src/lib/tyredeg.ts
Normal file
@@ -0,0 +1,271 @@
|
|||||||
|
// Tyre degradation + pit-window estimation for the live timing page.
|
||||||
|
// Pure functions only — no React, no side effects — so everything is unit-testable.
|
||||||
|
//
|
||||||
|
// Lap-time samples are accumulated client-side from successive SSE snapshots
|
||||||
|
// (mirroring the gapHistory/battles precedent); nothing here talks to the server.
|
||||||
|
|
||||||
|
import type { LiveTimingRow } from './live'
|
||||||
|
import { driverCode } from './live'
|
||||||
|
import { parseIntervalSeconds } from './gapHistory'
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Rough typical pit-lane time loss (entry + stop + exit vs a flying lap), in
|
||||||
|
* seconds. Per-track values are deliberately out of scope for v1.
|
||||||
|
*/
|
||||||
|
export const PIT_LOSS_SECONDS = 22
|
||||||
|
|
||||||
|
/** Minimum clean laps in the current stint before a slope is trustworthy. */
|
||||||
|
export const MIN_CLEAN_LAPS = 4
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Laps more than this many seconds off the stint median are treated as
|
||||||
|
* outliers (traffic, spins, safety car) and excluded from the fit.
|
||||||
|
*/
|
||||||
|
export const OUTLIER_DELTA_SECONDS = 5
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Slope classification thresholds (seconds per lap):
|
||||||
|
* slope <= -DEG_SLOPE_THRESHOLD -> 'improving' (track evolution, fuel burn dominating)
|
||||||
|
* slope >= +DEG_SLOPE_THRESHOLD -> 'degrading' (tyre wear dominating)
|
||||||
|
* otherwise -> 'stable'
|
||||||
|
*/
|
||||||
|
export const DEG_SLOPE_THRESHOLD = 0.05
|
||||||
|
|
||||||
|
/** Safety cap so a very long stint cannot grow the buffer unbounded. */
|
||||||
|
export const MAX_STINT_SAMPLES = 80
|
||||||
|
|
||||||
|
export type DegTrend = 'improving' | 'stable' | 'degrading'
|
||||||
|
|
||||||
|
export interface StintSample {
|
||||||
|
lap: number
|
||||||
|
seconds: number
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface DriverStintHistory {
|
||||||
|
compound: string
|
||||||
|
tyreAge: number
|
||||||
|
lastLapNumber: number
|
||||||
|
lastLapTime: string
|
||||||
|
/** The next completed lap is an out-lap (fresh stint) and must be discarded. */
|
||||||
|
skipNextLap: boolean
|
||||||
|
samples: StintSample[]
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Per-driver current-stint lap history, keyed by racing number. */
|
||||||
|
export type StintHistoryMap = Record<string, DriverStintHistory>
|
||||||
|
|
||||||
|
export interface StintLapInput {
|
||||||
|
racingNumber: string
|
||||||
|
lapNumber: number
|
||||||
|
lastLapTime: string
|
||||||
|
compound: string
|
||||||
|
tyreAge: number
|
||||||
|
inPit: boolean
|
||||||
|
pitOut: boolean
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Parse an F1 live-timing lap time string ("1:23.456", "83.456") into seconds.
|
||||||
|
* Same conventions as parseIntervalSeconds, but a lap time is never signed and
|
||||||
|
* never a lapped/leader marker; zero or negative values are rejected.
|
||||||
|
*/
|
||||||
|
export function parseLapTimeSeconds(raw: string | null | undefined): number | null {
|
||||||
|
const value = parseIntervalSeconds(raw)
|
||||||
|
if (value === null || value <= 0) return null
|
||||||
|
return value
|
||||||
|
}
|
||||||
|
|
||||||
|
export function stintInputFromRow(row: LiveTimingRow): StintLapInput {
|
||||||
|
return {
|
||||||
|
racingNumber: row.RacingNumber,
|
||||||
|
lapNumber: row.Driver.NumberOfLaps || 0,
|
||||||
|
lastLapTime: row.Driver.LastLapTime || '',
|
||||||
|
compound: row.Tyre?.Compound || '',
|
||||||
|
tyreAge: row.Tyre?.Age ?? 0,
|
||||||
|
inPit: Boolean(row.Driver.InPit),
|
||||||
|
pitOut: Boolean(row.Driver.PitOut),
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Record one snapshot's worth of lap samples for each driver's current stint.
|
||||||
|
* Returns a new map (input is not mutated); drivers missing from `inputs` are
|
||||||
|
* pruned.
|
||||||
|
*
|
||||||
|
* A lap counts as completed when LastLapTime changes to a new non-empty value
|
||||||
|
* (NumberOfLaps can tick before the lap time arrives, so the time string is
|
||||||
|
* the trigger; a sample for the same lap number is replaced, not duplicated).
|
||||||
|
* The stint buffer resets when the compound changes or the tyre age drops
|
||||||
|
* (new set fitted), and laps completed in the pit lane (in-lap), on pit exit
|
||||||
|
* (out-lap), or immediately after a reset are excluded.
|
||||||
|
*/
|
||||||
|
export function recordStintSamples(
|
||||||
|
history: StintHistoryMap,
|
||||||
|
inputs: ReadonlyArray<StintLapInput>,
|
||||||
|
): StintHistoryMap {
|
||||||
|
const next: StintHistoryMap = {}
|
||||||
|
|
||||||
|
for (const input of inputs) {
|
||||||
|
if (!input.racingNumber) continue
|
||||||
|
|
||||||
|
const prior = history[input.racingNumber]
|
||||||
|
if (!prior) {
|
||||||
|
next[input.racingNumber] = {
|
||||||
|
compound: input.compound,
|
||||||
|
tyreAge: input.tyreAge,
|
||||||
|
lastLapNumber: input.lapNumber,
|
||||||
|
lastLapTime: input.lastLapTime,
|
||||||
|
skipNextLap: false,
|
||||||
|
samples: [],
|
||||||
|
}
|
||||||
|
continue
|
||||||
|
}
|
||||||
|
|
||||||
|
let samples = prior.samples
|
||||||
|
let skipNextLap = prior.skipNextLap
|
||||||
|
|
||||||
|
const compoundChanged = Boolean(input.compound) && Boolean(prior.compound) && input.compound !== prior.compound
|
||||||
|
const freshSet = input.tyreAge < prior.tyreAge
|
||||||
|
if (compoundChanged || freshSet || input.inPit) {
|
||||||
|
// Stint over (or a new one starting): drop the old laps and flag the
|
||||||
|
// upcoming out-lap for exclusion.
|
||||||
|
samples = []
|
||||||
|
skipNextLap = true
|
||||||
|
}
|
||||||
|
|
||||||
|
const lapCompleted = Boolean(input.lastLapTime) && input.lastLapTime !== prior.lastLapTime
|
||||||
|
if (lapCompleted) {
|
||||||
|
const seconds = parseLapTimeSeconds(input.lastLapTime)
|
||||||
|
const dirty = input.inPit || input.pitOut || skipNextLap
|
||||||
|
if (seconds !== null && !dirty) {
|
||||||
|
const last = samples[samples.length - 1]
|
||||||
|
if (last && last.lap === input.lapNumber) {
|
||||||
|
samples = [...samples.slice(0, -1), { lap: input.lapNumber, seconds }]
|
||||||
|
} else {
|
||||||
|
samples = [...samples, { lap: input.lapNumber, seconds }]
|
||||||
|
if (samples.length > MAX_STINT_SAMPLES) {
|
||||||
|
samples = samples.slice(samples.length - MAX_STINT_SAMPLES)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if (!input.inPit) skipNextLap = false
|
||||||
|
}
|
||||||
|
|
||||||
|
next[input.racingNumber] = {
|
||||||
|
compound: input.compound || prior.compound,
|
||||||
|
tyreAge: input.tyreAge,
|
||||||
|
lastLapNumber: input.lapNumber,
|
||||||
|
lastLapTime: input.lastLapTime || prior.lastLapTime,
|
||||||
|
skipNextLap,
|
||||||
|
samples,
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
return next
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface DegModel {
|
||||||
|
/** Least-squares slope of lap time vs lap number, in seconds per lap. */
|
||||||
|
slope: number
|
||||||
|
trend: DegTrend
|
||||||
|
/** Clean (outlier-filtered) samples the fit ran over, in lap order. */
|
||||||
|
samples: StintSample[]
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Drop laps more than OUTLIER_DELTA_SECONDS off the stint median. */
|
||||||
|
export function cleanStintSamples(
|
||||||
|
samples: ReadonlyArray<StintSample>,
|
||||||
|
maxDelta = OUTLIER_DELTA_SECONDS,
|
||||||
|
): StintSample[] {
|
||||||
|
if (samples.length === 0) return []
|
||||||
|
const sorted = samples.map((sample) => sample.seconds).sort((a, b) => a - b)
|
||||||
|
const mid = Math.floor(sorted.length / 2)
|
||||||
|
const median = sorted.length % 2 === 1 ? sorted[mid] : (sorted[mid - 1] + sorted[mid]) / 2
|
||||||
|
return samples.filter((sample) => Math.abs(sample.seconds - median) <= maxDelta)
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Fit a linear degradation model over the stint's clean laps.
|
||||||
|
* Returns null with fewer than MIN_CLEAN_LAPS clean samples — the caller
|
||||||
|
* should show a "warming up" placeholder rather than a junk slope.
|
||||||
|
*/
|
||||||
|
export function degradationModel(samples: ReadonlyArray<StintSample>): DegModel | null {
|
||||||
|
const clean = cleanStintSamples(samples)
|
||||||
|
if (clean.length < MIN_CLEAN_LAPS) return null
|
||||||
|
|
||||||
|
const n = clean.length
|
||||||
|
const meanLap = clean.reduce((sum, s) => sum + s.lap, 0) / n
|
||||||
|
const meanSec = clean.reduce((sum, s) => sum + s.seconds, 0) / n
|
||||||
|
|
||||||
|
let numerator = 0
|
||||||
|
let denominator = 0
|
||||||
|
for (const sample of clean) {
|
||||||
|
numerator += (sample.lap - meanLap) * (sample.seconds - meanSec)
|
||||||
|
denominator += (sample.lap - meanLap) ** 2
|
||||||
|
}
|
||||||
|
if (denominator === 0) return null
|
||||||
|
|
||||||
|
const slope = numerator / denominator
|
||||||
|
const trend: DegTrend =
|
||||||
|
slope <= -DEG_SLOPE_THRESHOLD ? 'improving' : slope >= DEG_SLOPE_THRESHOLD ? 'degrading' : 'stable'
|
||||||
|
|
||||||
|
return { slope, trend, samples: clean }
|
||||||
|
}
|
||||||
|
|
||||||
|
/** "+0.08s/lap" / "-0.12s/lap" display form. */
|
||||||
|
export function formatSlope(slope: number): string {
|
||||||
|
const sign = slope >= 0 ? '+' : '−'
|
||||||
|
return `${sign}${Math.abs(slope).toFixed(2)}s/lap`
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface PitRejoinEstimate {
|
||||||
|
rejoinPosition: number
|
||||||
|
/** Cars behind that would get past during the stop. */
|
||||||
|
positionsLost: number
|
||||||
|
/** Driver code directly ahead after rejoining, if any. */
|
||||||
|
aheadCode: string | null
|
||||||
|
/** Driver code directly behind after rejoining, if any. */
|
||||||
|
behindCode: string | null
|
||||||
|
}
|
||||||
|
|
||||||
|
/**
|
||||||
|
* Estimate where a driver rejoins after a pit stop costing `pitLoss` seconds.
|
||||||
|
*
|
||||||
|
* Walks the cars behind the driver, accumulating their Interval (gap to car
|
||||||
|
* ahead) values: every car whose cumulative gap to the driver is under the
|
||||||
|
* pit loss gets past. An unparsable interval (lapped marker like "1L") ends
|
||||||
|
* the walk — those cars are at least a lap down and stay behind. Cars in the
|
||||||
|
* pits or retired are excluded from the ladder.
|
||||||
|
*/
|
||||||
|
export function estimatePitRejoin(
|
||||||
|
rows: ReadonlyArray<LiveTimingRow>,
|
||||||
|
racingNumber: string,
|
||||||
|
pitLoss = PIT_LOSS_SECONDS,
|
||||||
|
): PitRejoinEstimate | null {
|
||||||
|
const ladder = rows
|
||||||
|
.filter((row) => row.Position > 0 && !row.Driver.Retired && !row.Driver.InPit)
|
||||||
|
.sort((a, b) => a.Position - b.Position)
|
||||||
|
|
||||||
|
const index = ladder.findIndex((row) => row.RacingNumber === racingNumber)
|
||||||
|
if (index === -1) return null
|
||||||
|
|
||||||
|
let cumulative = 0
|
||||||
|
let positionsLost = 0
|
||||||
|
for (let i = index + 1; i < ladder.length; i++) {
|
||||||
|
const gap = parseIntervalSeconds(ladder[i].Driver.Interval)
|
||||||
|
if (gap === null) break
|
||||||
|
cumulative += Math.max(0, gap)
|
||||||
|
if (cumulative >= pitLoss) break
|
||||||
|
positionsLost += 1
|
||||||
|
}
|
||||||
|
|
||||||
|
const ahead = positionsLost > 0 ? ladder[index + positionsLost] : ladder[index - 1]
|
||||||
|
const behind = ladder[index + positionsLost + 1]
|
||||||
|
|
||||||
|
return {
|
||||||
|
rejoinPosition: ladder[index].Position + positionsLost,
|
||||||
|
positionsLost,
|
||||||
|
aheadCode: ahead ? driverCode(ahead) : null,
|
||||||
|
behindCode: behind ? driverCode(behind) : null,
|
||||||
|
}
|
||||||
|
}
|
||||||
@@ -4,6 +4,8 @@ import { fetchChampionshipHub, fetchSeasons } from '../api'
|
|||||||
import { teamColor } from '../utils'
|
import { teamColor } from '../utils'
|
||||||
import type { ChampHubDriver, ChampionshipHub } from '../types'
|
import type { ChampHubDriver, ChampionshipHub } from '../types'
|
||||||
import { ChampionshipSimulator } from '../components/ChampionshipSimulator'
|
import { ChampionshipSimulator } from '../components/ChampionshipSimulator'
|
||||||
|
import { Meaning } from '../components/Meaning'
|
||||||
|
import { pointsGapMeaning } from '../lib/meaning'
|
||||||
|
|
||||||
type View = 'drivers' | 'constructors' | 'progression' | 'simulator'
|
type View = 'drivers' | 'constructors' | 'progression' | 'simulator'
|
||||||
|
|
||||||
@@ -138,6 +140,8 @@ function ChampionshipBody({ hub, view, setView }: BodyProps) {
|
|||||||
color: teamColor(d.team_colour),
|
color: teamColor(d.team_colour),
|
||||||
gapLeader: i === 0 ? 'LEADER' : `+${fmtPts(gapLeaderNum)}`,
|
gapLeader: i === 0 ? 'LEADER' : `+${fmtPts(gapLeaderNum)}`,
|
||||||
gapAhead: gapAheadNum == null ? '—' : `+${fmtPts(gapAheadNum)}`,
|
gapAhead: gapAheadNum == null ? '—' : `+${fmtPts(gapAheadNum)}`,
|
||||||
|
gapAheadNum,
|
||||||
|
driverAhead: i === 0 ? null : drivers[i - 1].name_acronym,
|
||||||
spark: sparkPoints(d.form),
|
spark: sparkPoints(d.form),
|
||||||
h2h: `${d.teammate_wins}–${d.teammate_losses}`,
|
h2h: `${d.teammate_wins}–${d.teammate_losses}`,
|
||||||
h2hWin: d.teammate_wins >= d.teammate_losses,
|
h2hWin: d.teammate_wins >= d.teammate_losses,
|
||||||
@@ -233,7 +237,12 @@ function ChampionshipBody({ hub, view, setView }: BodyProps) {
|
|||||||
</div>
|
</div>
|
||||||
|
|
||||||
{view === 'drivers' && (
|
{view === 'drivers' && (
|
||||||
<DriversView enriched={enriched} leaderPoints={leader.points} titleMath={titleMath} />
|
<DriversView
|
||||||
|
enriched={enriched}
|
||||||
|
leaderPoints={leader.points}
|
||||||
|
titleMath={titleMath}
|
||||||
|
roundsLeft={hub.rounds_left}
|
||||||
|
/>
|
||||||
)}
|
)}
|
||||||
{view === 'constructors' && <ConstructorsView hub={hub} />}
|
{view === 'constructors' && <ConstructorsView hub={hub} />}
|
||||||
{view === 'progression' && <ProgressionView hub={hub} />}
|
{view === 'progression' && <ProgressionView hub={hub} />}
|
||||||
@@ -248,6 +257,8 @@ interface EnrichedDriver {
|
|||||||
color: string
|
color: string
|
||||||
gapLeader: string
|
gapLeader: string
|
||||||
gapAhead: string
|
gapAhead: string
|
||||||
|
gapAheadNum: number | null
|
||||||
|
driverAhead: string | null
|
||||||
spark: string
|
spark: string
|
||||||
h2h: string
|
h2h: string
|
||||||
h2hWin: boolean
|
h2hWin: boolean
|
||||||
@@ -259,10 +270,12 @@ function DriversView({
|
|||||||
enriched,
|
enriched,
|
||||||
leaderPoints,
|
leaderPoints,
|
||||||
titleMath,
|
titleMath,
|
||||||
|
roundsLeft,
|
||||||
}: {
|
}: {
|
||||||
enriched: EnrichedDriver[]
|
enriched: EnrichedDriver[]
|
||||||
leaderPoints: number
|
leaderPoints: number
|
||||||
titleMath: string
|
titleMath: string
|
||||||
|
roundsLeft: number
|
||||||
}) {
|
}) {
|
||||||
const podium = enriched.slice(0, 3)
|
const podium = enriched.slice(0, 3)
|
||||||
return (
|
return (
|
||||||
@@ -357,7 +370,19 @@ function DriversView({
|
|||||||
<td className="champ-td-team">{e.d.team_name}</td>
|
<td className="champ-td-team">{e.d.team_name}</td>
|
||||||
<td className="r mono champ-td-pts">{fmtPts(e.d.points)}</td>
|
<td className="r mono champ-td-pts">{fmtPts(e.d.points)}</td>
|
||||||
<td className="r mono champ-td-muted">{e.gapLeader}</td>
|
<td className="r mono champ-td-muted">{e.gapLeader}</td>
|
||||||
<td className="r mono champ-td-dim">{e.gapAhead}</td>
|
<td className="r mono champ-td-dim">
|
||||||
|
{(() => {
|
||||||
|
const gapAnnotation = pointsGapMeaning(e.gapAheadNum, roundsLeft, e.driverAhead)
|
||||||
|
return (
|
||||||
|
<Meaning
|
||||||
|
value={e.gapAhead}
|
||||||
|
meaning={gapAnnotation?.caption}
|
||||||
|
title={gapAnnotation?.title}
|
||||||
|
tone={gapAnnotation?.tone}
|
||||||
|
/>
|
||||||
|
)
|
||||||
|
})()}
|
||||||
|
</td>
|
||||||
<td className="c mono" style={{ color: e.d.wins > 0 ? 'var(--text)' : 'var(--text-3)' }}>
|
<td className="c mono" style={{ color: e.d.wins > 0 ? 'var(--text)' : 'var(--text-3)' }}>
|
||||||
{e.d.wins}
|
{e.d.wins}
|
||||||
</td>
|
</td>
|
||||||
|
|||||||
@@ -1,38 +1,38 @@
|
|||||||
import { useEffect, useMemo, useState } from 'react'
|
import { useEffect, useMemo, useState } from 'react'
|
||||||
import { useQueries, useQuery } from '@tanstack/react-query'
|
import { useQueries, useQuery } from '@tanstack/react-query'
|
||||||
import { Link } from '@tanstack/react-router'
|
import { Link } from '@tanstack/react-router'
|
||||||
import { fetchLiveState, fetchLocalMeetings, fetchSeasonMeetings, fetchSeasons, fetchSessions, fetchWeekend, fetchChampionshipHub } from '../api'
|
import {
|
||||||
|
fetchChampionshipHub,
|
||||||
|
fetchLiveState,
|
||||||
|
fetchLocalMeetings,
|
||||||
|
fetchRaceHub,
|
||||||
|
fetchSeasonMeetings,
|
||||||
|
fetchSeasons,
|
||||||
|
fetchSessions,
|
||||||
|
fetchWeekend,
|
||||||
|
} from '../api'
|
||||||
|
import { CommandCenterHero } from '../components/CommandCenterHero'
|
||||||
|
import { PaddockBriefing } from '../components/PaddockBriefing'
|
||||||
import { RACE_HUB_DATASETS, countWeekendStats, formatCoverageHint, sessionTypeAbbrev } from '../lib/coverage'
|
import { RACE_HUB_DATASETS, countWeekendStats, formatCoverageHint, sessionTypeAbbrev } from '../lib/coverage'
|
||||||
|
import { countryAccent, countryDecal, countryFlag, formatGpDateRange } from '../lib/gpIdentity'
|
||||||
|
import { classifySessionStatus, heroState } from '../lib/hero'
|
||||||
import {
|
import {
|
||||||
currentAndNextSession,
|
currentAndNextSession,
|
||||||
focusMeetingKind,
|
focusMeetingKind,
|
||||||
formatCountdown,
|
|
||||||
formatSessionScheduleTime,
|
formatSessionScheduleTime,
|
||||||
meetingHasStarted,
|
meetingHasStarted,
|
||||||
|
mostRecentPastMeeting,
|
||||||
|
nextUpcomingMeeting,
|
||||||
pickFocusMeeting,
|
pickFocusMeeting,
|
||||||
sessionEndTime,
|
|
||||||
sessionStartTime,
|
|
||||||
sortSessionsByStart,
|
sortSessionsByStart,
|
||||||
} from '../lib/schedule'
|
} from '../lib/schedule'
|
||||||
import { countryAccent, countryDecal, countryFlag, formatGpDateRange } from '../lib/gpIdentity'
|
|
||||||
import type { Meeting, Session, Weekend, WeekendSession } from '../types'
|
import type { Meeting, Session, Weekend, WeekendSession } from '../types'
|
||||||
import { PaddockBriefing } from '../components/PaddockBriefing'
|
import { Trophy } from 'lucide-react'
|
||||||
import { Play, Activity, Calendar, Trophy } from 'lucide-react'
|
|
||||||
|
|
||||||
type WeekendStatusKind = 'live' | 'current' | 'next' | 'recent' | 'fallback'
|
|
||||||
|
|
||||||
const missingDatasets = Object.fromEntries(
|
const missingDatasets = Object.fromEntries(
|
||||||
RACE_HUB_DATASETS.map((dataset) => [dataset, { status: 'missing', source: 'none', count: 0 }]),
|
RACE_HUB_DATASETS.map((dataset) => [dataset, { status: 'missing', source: 'none', count: 0 }]),
|
||||||
) as WeekendSession['datasets']
|
) as WeekendSession['datasets']
|
||||||
|
|
||||||
function classifySessionStatus(session: Session, now: Date): 'live' | 'done' | 'upcoming' {
|
|
||||||
const start = sessionStartTime(session)
|
|
||||||
const end = sessionEndTime(session)
|
|
||||||
if (start && end && now >= start && now < end) return 'live'
|
|
||||||
if (start && now >= start) return 'done'
|
|
||||||
return 'upcoming'
|
|
||||||
}
|
|
||||||
|
|
||||||
function meetingStatus(meeting: Meeting, focusKey: number | undefined, now: Date) {
|
function meetingStatus(meeting: Meeting, focusKey: number | undefined, now: Date) {
|
||||||
if (meeting.meeting_key === focusKey) return 'focus'
|
if (meeting.meeting_key === focusKey) return 'focus'
|
||||||
if (meetingHasStarted(meeting, now)) return 'past'
|
if (meetingHasStarted(meeting, now)) return 'past'
|
||||||
@@ -148,7 +148,36 @@ export function CommandCenterPage() {
|
|||||||
focusWeekendSessions[0]?.session
|
focusWeekendSessions[0]?.session
|
||||||
const analysisSessionKey = actionSession?.session_key
|
const analysisSessionKey = actionSession?.session_key
|
||||||
|
|
||||||
const weekendsLoading = weekendQueries.some((q) => q.isLoading)
|
const liveActive = liveQuery.data?.is_live === true
|
||||||
|
const heroStateKind = heroState({
|
||||||
|
now: nowDate,
|
||||||
|
liveActive,
|
||||||
|
currentSession,
|
||||||
|
focusKind,
|
||||||
|
})
|
||||||
|
|
||||||
|
const lastPastMeeting = useMemo(
|
||||||
|
() => mostRecentPastMeeting(focusMeetings, nowDate),
|
||||||
|
[focusMeetings, nowDate],
|
||||||
|
)
|
||||||
|
const lastPastWeekend = lastPastMeeting ? weekendsByKey.get(lastPastMeeting.meeting_key) : undefined
|
||||||
|
const lastRaceAnalysis = pickAnalysisSession(lastPastWeekend)
|
||||||
|
const lastRaceSessionKey = lastRaceAnalysis?.session.session_key
|
||||||
|
|
||||||
|
const lastRaceHubQuery = useQuery({
|
||||||
|
queryKey: ['race-hub', lastRaceSessionKey, 'hero-podium'],
|
||||||
|
queryFn: () => fetchRaceHub(lastRaceSessionKey!),
|
||||||
|
enabled: lastRaceSessionKey != null && heroStateKind === 'between',
|
||||||
|
staleTime: 60_000,
|
||||||
|
})
|
||||||
|
|
||||||
|
const nextMeetingForHero = useMemo(() => {
|
||||||
|
if (heroStateKind !== 'between') return null
|
||||||
|
return nextUpcomingMeeting(focusMeetings, nowDate)
|
||||||
|
}, [heroStateKind, focusMeetings, nowDate])
|
||||||
|
|
||||||
|
const lastRacePodium = lastRaceHubQuery.data?.results ?? []
|
||||||
|
const lastRaceName = champHub?.last_race ?? lastPastMeeting?.meeting_name ?? ''
|
||||||
|
|
||||||
if (seasonsQuery.isLoading) {
|
if (seasonsQuery.isLoading) {
|
||||||
return <div className="page loading-state">loading command center…</div>
|
return <div className="page loading-state">loading command center…</div>
|
||||||
@@ -189,19 +218,7 @@ export function CommandCenterPage() {
|
|||||||
)
|
)
|
||||||
}
|
}
|
||||||
|
|
||||||
const liveActive = liveQuery.data?.is_live === true
|
|
||||||
const statusKind: WeekendStatusKind = liveActive
|
|
||||||
? 'live'
|
|
||||||
: focusKind === 'current'
|
|
||||||
? 'current'
|
|
||||||
: focusKind === 'next'
|
|
||||||
? 'next'
|
|
||||||
: focusKind === 'recent'
|
|
||||||
? 'recent'
|
|
||||||
: 'fallback'
|
|
||||||
|
|
||||||
const accent = countryAccent(focusMeeting ?? null)
|
const accent = countryAccent(focusMeeting ?? null)
|
||||||
const decal = countryDecal(focusMeeting ?? null)
|
|
||||||
const accentStyle = { '--gp-accent': accent } as React.CSSProperties
|
const accentStyle = { '--gp-accent': accent } as React.CSSProperties
|
||||||
|
|
||||||
return (
|
return (
|
||||||
@@ -224,76 +241,25 @@ export function CommandCenterPage() {
|
|||||||
</div>
|
</div>
|
||||||
)}
|
)}
|
||||||
|
|
||||||
{focusMeeting && (
|
{focusMeeting && focusKind && (
|
||||||
<div className="cc-hero">
|
<CommandCenterHero
|
||||||
<section className="cc-weekend-band ui-card glass-panel" data-testid="cc-focus">
|
state={heroStateKind}
|
||||||
<div className="cc-band-accent" aria-hidden="true" />
|
now={nowDate}
|
||||||
<div className="cc-band-body">
|
accent={accent}
|
||||||
<div className="cc-band-row">
|
liveActive={liveActive}
|
||||||
<span className="cc-band-decal mono">{decal}</span>
|
liveData={liveQuery.data?.data}
|
||||||
<div className="cc-band-titles">
|
focusMeeting={focusMeeting}
|
||||||
<div className="cc-band-eyebrow mono">
|
focusKind={focusKind}
|
||||||
<WeekendKindLabel kind={statusKind} />
|
sessions={focusWeekendSessions}
|
||||||
</div>
|
currentSession={currentSession}
|
||||||
<h1 className="cc-band-name">{focusMeeting.meeting_name}</h1>
|
nextSession={nextSession}
|
||||||
<div className="cc-band-sub mono">
|
analysisSessionKey={analysisSessionKey}
|
||||||
{[focusMeeting.location, focusMeeting.circuit_short_name]
|
analysisSessionName={actionSession?.session_name}
|
||||||
.filter(Boolean)
|
lastRaceName={lastRaceName}
|
||||||
.join(' · ')}
|
lastRacePodium={lastRacePodium}
|
||||||
</div>
|
lastRaceSessionKey={lastRaceSessionKey}
|
||||||
<div className="cc-band-sub mono cc-band-dates">{formatGpDateRange(focusMeeting)}</div>
|
nextMeeting={nextMeetingForHero}
|
||||||
</div>
|
/>
|
||||||
<CountdownBlock
|
|
||||||
liveActive={liveActive}
|
|
||||||
currentSession={currentSession}
|
|
||||||
nextSession={nextSession}
|
|
||||||
meeting={focusMeeting}
|
|
||||||
now={nowDate}
|
|
||||||
/>
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
</section>
|
|
||||||
|
|
||||||
<div className="cc-actions-row" data-testid="cc-actions">
|
|
||||||
<Link
|
|
||||||
to="/live"
|
|
||||||
className={`cc-pri-action ui-card interactive ${liveActive ? 'is-live ui-cta-primary' : ''}`}
|
|
||||||
data-testid="cc-action-live"
|
|
||||||
>
|
|
||||||
<span className="cc-pri-label" style={{ display: 'flex', alignItems: 'center', gap: '8px' }}><Play size={16} /> Watch Live</span>
|
|
||||||
<span className="cc-pri-meta mono">{liveActive ? 'Feed active' : 'Standby'}</span>
|
|
||||||
</Link>
|
|
||||||
<Link
|
|
||||||
to="/race-hub"
|
|
||||||
search={analysisSessionKey ? { session_key: analysisSessionKey } : {}}
|
|
||||||
className="cc-pri-action ui-card interactive"
|
|
||||||
data-testid="cc-action-race-hub"
|
|
||||||
>
|
|
||||||
<span className="cc-pri-label" style={{ display: 'flex', alignItems: 'center', gap: '8px' }}><Activity size={16} /> Open Analysis</span>
|
|
||||||
<span className="cc-pri-meta mono">
|
|
||||||
{actionSession
|
|
||||||
? `${actionSession.session_name} · session ${actionSession.session_key}`
|
|
||||||
: 'Pick a session'}
|
|
||||||
</span>
|
|
||||||
</Link>
|
|
||||||
{nextSession && sessionStartTime(nextSession) && (
|
|
||||||
<a
|
|
||||||
href="#cc-schedule"
|
|
||||||
className="cc-pri-action ui-card interactive"
|
|
||||||
data-testid="cc-action-schedule"
|
|
||||||
onClick={(e) => {
|
|
||||||
e.preventDefault()
|
|
||||||
document.getElementById('cc-schedule')?.scrollIntoView({ behavior: 'smooth' })
|
|
||||||
}}
|
|
||||||
>
|
|
||||||
<span className="cc-pri-label" style={{ display: 'flex', alignItems: 'center', gap: '8px' }}><Calendar size={16} /> Schedule</span>
|
|
||||||
<span className="cc-pri-meta mono">
|
|
||||||
next: {nextSession.session_name}
|
|
||||||
</span>
|
|
||||||
</a>
|
|
||||||
)}
|
|
||||||
</div>
|
|
||||||
</div>
|
|
||||||
)}
|
)}
|
||||||
|
|
||||||
<div className="cc-dashboard-grid">
|
<div className="cc-dashboard-grid">
|
||||||
@@ -483,65 +449,3 @@ function FormSparkline({ form, color }: { form: number[], color: string }) {
|
|||||||
)
|
)
|
||||||
}
|
}
|
||||||
|
|
||||||
function WeekendKindLabel({ kind }: { kind: WeekendStatusKind }) {
|
|
||||||
switch (kind) {
|
|
||||||
case 'live':
|
|
||||||
return <span className="cc-kind cc-kind-live">● Live now</span>
|
|
||||||
case 'current':
|
|
||||||
return <span className="cc-kind cc-kind-current">Current weekend</span>
|
|
||||||
case 'next':
|
|
||||||
return <span className="cc-kind cc-kind-next">Next weekend</span>
|
|
||||||
case 'recent':
|
|
||||||
return <span className="cc-kind cc-kind-recent">Recent weekend</span>
|
|
||||||
default:
|
|
||||||
return <span className="cc-kind">Weekend</span>
|
|
||||||
}
|
|
||||||
}
|
|
||||||
|
|
||||||
interface CountdownBlockProps {
|
|
||||||
liveActive: boolean
|
|
||||||
currentSession: Session | null
|
|
||||||
nextSession: Session | null
|
|
||||||
meeting: Meeting
|
|
||||||
now: Date
|
|
||||||
}
|
|
||||||
|
|
||||||
function CountdownBlock({ liveActive, currentSession, nextSession, meeting, now }: CountdownBlockProps) {
|
|
||||||
if (liveActive) {
|
|
||||||
return (
|
|
||||||
<div className="cc-countdown-block">
|
|
||||||
<div className="cc-cd-label mono">SignalR</div>
|
|
||||||
<div className="cc-cd-value cc-cd-live">LIVE</div>
|
|
||||||
<div className="cc-cd-sub mono">{currentSession?.session_name ?? 'Feed connected'}</div>
|
|
||||||
</div>
|
|
||||||
)
|
|
||||||
}
|
|
||||||
if (currentSession) {
|
|
||||||
return (
|
|
||||||
<div className="cc-countdown-block">
|
|
||||||
<div className="cc-cd-label mono">On Track</div>
|
|
||||||
<div className="cc-cd-value cc-cd-current">{currentSession.session_name}</div>
|
|
||||||
<div className="cc-cd-sub mono">In session</div>
|
|
||||||
</div>
|
|
||||||
)
|
|
||||||
}
|
|
||||||
if (nextSession && sessionStartTime(nextSession)) {
|
|
||||||
return (
|
|
||||||
<div className="cc-countdown-block">
|
|
||||||
<div className="cc-cd-label mono">Next · {nextSession.session_name}</div>
|
|
||||||
<div className="cc-cd-value mono">{formatCountdown(sessionStartTime(nextSession)!, now)}</div>
|
|
||||||
<div className="cc-cd-sub mono">{formatSessionScheduleTime(nextSession.date_start)}</div>
|
|
||||||
</div>
|
|
||||||
)
|
|
||||||
}
|
|
||||||
if (meetingHasStarted(meeting, now)) {
|
|
||||||
return (
|
|
||||||
<div className="cc-countdown-block">
|
|
||||||
<div className="cc-cd-label mono">Status</div>
|
|
||||||
<div className="cc-cd-value cc-cd-done">Complete</div>
|
|
||||||
<div className="cc-cd-sub mono">Weekend finished</div>
|
|
||||||
</div>
|
|
||||||
)
|
|
||||||
}
|
|
||||||
return null
|
|
||||||
}
|
|
||||||
|
|||||||
@@ -1,7 +1,7 @@
|
|||||||
import { useEffect, useMemo, useState } from 'react'
|
import { useEffect, useMemo, useRef, useState } from 'react'
|
||||||
import { useQuery } from '@tanstack/react-query'
|
import { useQuery } from '@tanstack/react-query'
|
||||||
import { fetchLiveState } from '../api'
|
import { fetchLiveState } from '../api'
|
||||||
import type { LiveStreamData } from '../types'
|
import type { LivePosition, LiveStreamData } from '../types'
|
||||||
import {
|
import {
|
||||||
loadPinnedDrivers,
|
loadPinnedDrivers,
|
||||||
mergeVisibleSectors,
|
mergeVisibleSectors,
|
||||||
@@ -15,24 +15,41 @@ import type { VisibleSectorState } from '../lib/live'
|
|||||||
import type { GapHistoryMap } from '../lib/gapHistory'
|
import type { GapHistoryMap } from '../lib/gapHistory'
|
||||||
import { recordGapSamples } from '../lib/gapHistory'
|
import { recordGapSamples } from '../lib/gapHistory'
|
||||||
import { battleNumbers, detectBattles } from '../lib/battles'
|
import { battleNumbers, detectBattles } from '../lib/battles'
|
||||||
|
import type { LiveEvent } from '../lib/events'
|
||||||
|
import { appendEvents, diffSnapshots, sessionSignature } from '../lib/events'
|
||||||
import { SessionBanner } from '../components/live/SessionBanner'
|
import { SessionBanner } from '../components/live/SessionBanner'
|
||||||
import { TrackStatusBanner } from '../components/live/TrackStatusBanner'
|
import { TrackStatusBanner } from '../components/live/TrackStatusBanner'
|
||||||
import { TimingTower } from '../components/live/TimingTower'
|
import { TimingTower } from '../components/live/TimingTower'
|
||||||
import { BattleChips } from '../components/live/BattleChips'
|
import { BattleChips } from '../components/live/BattleChips'
|
||||||
import { PinnedDrivers } from '../components/live/PinnedDrivers'
|
import { PinnedDrivers } from '../components/live/PinnedDrivers'
|
||||||
import { RaceControlFeed } from '../components/live/RaceControlFeed'
|
import { RaceControlFeed } from '../components/live/RaceControlFeed'
|
||||||
import { Radio } from 'lucide-react'
|
import { EventRail } from '../components/live/EventRail'
|
||||||
|
import { TeamRadioTicker } from '../components/live/TeamRadioTicker'
|
||||||
|
import { TyreDegPanel } from '../components/live/TyreDegPanel'
|
||||||
|
import { Archive, Radio } from 'lucide-react'
|
||||||
|
|
||||||
type StreamStatus = 'connecting' | 'connected' | 'disconnected' | 'error'
|
type StreamStatus = 'connecting' | 'connected' | 'disconnected' | 'error'
|
||||||
|
|
||||||
export function LiveTimingPage() {
|
export function LiveTimingPage() {
|
||||||
const [snapshot, setSnapshot] = useState<LiveStreamData | null>(null)
|
const [activeSnapshot, setActiveSnapshot] = useState<LiveStreamData | null>(null)
|
||||||
|
const [archiveSnapshot, setArchiveSnapshot] = useState<LiveStreamData | null>(null)
|
||||||
|
const [archivePositions, setArchivePositions] = useState<Record<string, LivePosition>>({})
|
||||||
|
const [archiveSnapshotAt, setArchiveSnapshotAt] = useState<string | null>(null)
|
||||||
|
const [archiveMode, setArchiveMode] = useState(false)
|
||||||
const [isLive, setIsLive] = useState(false)
|
const [isLive, setIsLive] = useState(false)
|
||||||
const [streamStatus, setStreamStatus] = useState<StreamStatus>('connecting')
|
const [streamStatus, setStreamStatus] = useState<StreamStatus>('connecting')
|
||||||
const [now, setNow] = useState(Date.now())
|
const [now, setNow] = useState(Date.now())
|
||||||
const [gapHistory, setGapHistory] = useState<GapHistoryMap>({})
|
const [gapHistory, setGapHistory] = useState<GapHistoryMap>({})
|
||||||
const [pinned, setPinned] = useState<string[]>(() => loadPinnedDrivers())
|
const [pinned, setPinned] = useState<string[]>(() => loadPinnedDrivers())
|
||||||
const [visibleSectors, setVisibleSectors] = useState<VisibleSectorState>({})
|
const [visibleSectors, setVisibleSectors] = useState<VisibleSectorState>({})
|
||||||
|
const [positions, setPositions] = useState<Record<string, LivePosition>>({})
|
||||||
|
const [events, setEvents] = useState<LiveEvent[]>([])
|
||||||
|
const prevSnapshotRef = useRef<LiveStreamData | null>(null)
|
||||||
|
const sessionSigRef = useRef('')
|
||||||
|
const isLiveRef = useRef(false)
|
||||||
|
const archiveModeRef = useRef(false)
|
||||||
|
const snapshot = isLive ? activeSnapshot : archiveMode ? archiveSnapshot : null
|
||||||
|
const hasArchive = Boolean(archiveSnapshot)
|
||||||
|
|
||||||
const { data, isLoading, isError, error } = useQuery({
|
const { data, isLoading, isError, error } = useQuery({
|
||||||
queryKey: ['live-state'],
|
queryKey: ['live-state'],
|
||||||
@@ -42,10 +59,29 @@ export function LiveTimingPage() {
|
|||||||
|
|
||||||
useEffect(() => {
|
useEffect(() => {
|
||||||
if (!data) return
|
if (!data) return
|
||||||
setIsLive(data.is_live)
|
const nextLive = data.is_live && Boolean(data.data)
|
||||||
setSnapshot(data.data)
|
setIsLive(nextLive)
|
||||||
|
isLiveRef.current = nextLive
|
||||||
|
if (nextLive && data.data) {
|
||||||
|
setActiveSnapshot(data.data)
|
||||||
|
setArchiveMode(false)
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
|
setActiveSnapshot(null)
|
||||||
|
setArchiveSnapshot(data.last_snapshot ?? null)
|
||||||
|
setArchivePositions(data.last_positions ?? {})
|
||||||
|
setArchiveSnapshotAt(data.last_snapshot_at ?? null)
|
||||||
|
setArchiveMode((current) => current && Boolean(data.last_snapshot))
|
||||||
}, [data])
|
}, [data])
|
||||||
|
|
||||||
|
useEffect(() => {
|
||||||
|
archiveModeRef.current = archiveMode
|
||||||
|
if (archiveMode) {
|
||||||
|
setPositions(archivePositions)
|
||||||
|
}
|
||||||
|
}, [archiveMode, archivePositions])
|
||||||
|
|
||||||
useEffect(() => {
|
useEffect(() => {
|
||||||
const timer = window.setInterval(() => setNow(Date.now()), 1000)
|
const timer = window.setInterval(() => setNow(Date.now()), 1000)
|
||||||
return () => window.clearInterval(timer)
|
return () => window.clearInterval(timer)
|
||||||
@@ -68,8 +104,23 @@ export function LiveTimingPage() {
|
|||||||
events.addEventListener('snapshot', (event) => {
|
events.addEventListener('snapshot', (event) => {
|
||||||
const state = parseLiveStateEvent(event.data)
|
const state = parseLiveStateEvent(event.data)
|
||||||
if (!state || cancelled) return
|
if (!state || cancelled) return
|
||||||
setIsLive(state.is_live)
|
const nextLive = state.is_live && Boolean(state.data)
|
||||||
setSnapshot(state.data)
|
setIsLive(nextLive)
|
||||||
|
if (nextLive && state.data) {
|
||||||
|
if (!isLiveRef.current || archiveModeRef.current) {
|
||||||
|
setPositions({})
|
||||||
|
}
|
||||||
|
isLiveRef.current = true
|
||||||
|
setActiveSnapshot(state.data)
|
||||||
|
setArchiveMode(false)
|
||||||
|
} else {
|
||||||
|
isLiveRef.current = false
|
||||||
|
setActiveSnapshot(null)
|
||||||
|
setArchiveSnapshot(state.last_snapshot ?? null)
|
||||||
|
setArchivePositions(state.last_positions ?? {})
|
||||||
|
setArchiveSnapshotAt(state.last_snapshot_at ?? null)
|
||||||
|
setArchiveMode((current) => current && Boolean(state.last_snapshot))
|
||||||
|
}
|
||||||
setStreamStatus('connected')
|
setStreamStatus('connected')
|
||||||
})
|
})
|
||||||
|
|
||||||
@@ -77,6 +128,17 @@ export function LiveTimingPage() {
|
|||||||
if (!cancelled) setStreamStatus('connected')
|
if (!cancelled) setStreamStatus('connected')
|
||||||
})
|
})
|
||||||
|
|
||||||
|
events.addEventListener('positions', (event) => {
|
||||||
|
if (cancelled) return
|
||||||
|
try {
|
||||||
|
const parsed = JSON.parse(event.data) as Record<string, LivePosition>
|
||||||
|
setPositions(parsed && typeof parsed === 'object' ? parsed : {})
|
||||||
|
setStreamStatus('connected')
|
||||||
|
} catch {
|
||||||
|
// Ignore malformed transient frames; the next 4Hz update will replace it.
|
||||||
|
}
|
||||||
|
})
|
||||||
|
|
||||||
events.onerror = () => {
|
events.onerror = () => {
|
||||||
if (!cancelled) setStreamStatus('disconnected')
|
if (!cancelled) setStreamStatus('disconnected')
|
||||||
}
|
}
|
||||||
@@ -87,6 +149,23 @@ export function LiveTimingPage() {
|
|||||||
}
|
}
|
||||||
}, [])
|
}, [])
|
||||||
|
|
||||||
|
// Synthesize "what just happened" events from successive snapshots; the
|
||||||
|
// buffer resets whenever a different session starts streaming.
|
||||||
|
useEffect(() => {
|
||||||
|
if (!snapshot) return
|
||||||
|
const signature = sessionSignature(snapshot.Session)
|
||||||
|
const prev = prevSnapshotRef.current
|
||||||
|
prevSnapshotRef.current = snapshot
|
||||||
|
if (signature !== sessionSigRef.current) {
|
||||||
|
sessionSigRef.current = signature
|
||||||
|
setEvents([])
|
||||||
|
return
|
||||||
|
}
|
||||||
|
if (!prev || prev === snapshot) return
|
||||||
|
const fresh = diffSnapshots(prev, snapshot)
|
||||||
|
if (fresh.length > 0) setEvents((current) => appendEvents(current, fresh))
|
||||||
|
}, [snapshot])
|
||||||
|
|
||||||
const rawRows = useMemo(() => sortLiveTimingRows(snapshot), [snapshot])
|
const rawRows = useMemo(() => sortLiveTimingRows(snapshot), [snapshot])
|
||||||
|
|
||||||
useEffect(() => {
|
useEffect(() => {
|
||||||
@@ -124,6 +203,19 @@ export function LiveTimingPage() {
|
|||||||
setPinned((prev) => togglePin(prev, racingNumber))
|
setPinned((prev) => togglePin(prev, racingNumber))
|
||||||
}
|
}
|
||||||
|
|
||||||
|
const handleViewArchive = () => {
|
||||||
|
if (!archiveSnapshot) return
|
||||||
|
setIsLive(false)
|
||||||
|
setArchiveMode(true)
|
||||||
|
setPositions(archivePositions)
|
||||||
|
}
|
||||||
|
|
||||||
|
const archiveTimestamp = archiveSnapshotAt ? new Date(archiveSnapshotAt) : null
|
||||||
|
const archiveLabel =
|
||||||
|
archiveTimestamp && !Number.isNaN(archiveTimestamp.getTime())
|
||||||
|
? `Archived snapshot from ${archiveTimestamp.toLocaleString()}`
|
||||||
|
: 'Archived live timing snapshot'
|
||||||
|
|
||||||
return (
|
return (
|
||||||
<div className="page live-page" data-testid="live-page">
|
<div className="page live-page" data-testid="live-page">
|
||||||
{isError && (
|
{isError && (
|
||||||
@@ -132,12 +224,18 @@ export function LiveTimingPage() {
|
|||||||
</div>
|
</div>
|
||||||
)}
|
)}
|
||||||
|
|
||||||
{streamStatus === 'disconnected' && snapshot && (
|
{streamStatus === 'disconnected' && snapshot && !archiveMode && (
|
||||||
<div className="live-status-strip live-status-warn">
|
<div className="live-status-strip live-status-warn">
|
||||||
Stream disconnected — showing last received snapshot
|
Stream disconnected — showing last received snapshot
|
||||||
</div>
|
</div>
|
||||||
)}
|
)}
|
||||||
|
|
||||||
|
{archiveMode && snapshot && (
|
||||||
|
<div className="live-status-strip live-status-archive" data-testid="live-archive-strip">
|
||||||
|
{archiveLabel} — live updates are paused for this archive view
|
||||||
|
</div>
|
||||||
|
)}
|
||||||
|
|
||||||
{isLoading && !snapshot && (
|
{isLoading && !snapshot && (
|
||||||
<div className="loading-state">connecting to live timing…</div>
|
<div className="loading-state">connecting to live timing…</div>
|
||||||
)}
|
)}
|
||||||
@@ -152,14 +250,28 @@ export function LiveTimingPage() {
|
|||||||
<p className="empty-state-desc" style={{ color: 'var(--text-2)' }}>
|
<p className="empty-state-desc" style={{ color: 'var(--text-2)' }}>
|
||||||
The telemetry feed is currently offline. <br /><br /> Check the <a href="/" style={{ color: 'var(--red)', textDecoration: 'underline' }}>Command Center</a> for the weekend schedule or explore historical data in the <a href="/race-hub" style={{ color: 'var(--red)', textDecoration: 'underline' }}>Race Hub</a>.
|
The telemetry feed is currently offline. <br /><br /> Check the <a href="/" style={{ color: 'var(--red)', textDecoration: 'underline' }}>Command Center</a> for the weekend schedule or explore historical data in the <a href="/race-hub" style={{ color: 'var(--red)', textDecoration: 'underline' }}>Race Hub</a>.
|
||||||
</p>
|
</p>
|
||||||
|
{hasArchive && (
|
||||||
|
<button type="button" className="live-archive-btn" onClick={handleViewArchive}>
|
||||||
|
<Archive size={15} />
|
||||||
|
View Last Session
|
||||||
|
</button>
|
||||||
|
)}
|
||||||
</div>
|
</div>
|
||||||
)}
|
)}
|
||||||
|
|
||||||
{snapshot && (
|
{snapshot && (
|
||||||
<>
|
<>
|
||||||
<SessionBanner isLive={isLive} snapshot={snapshot} rows={rows} connection={streamStatus} now={now} />
|
<SessionBanner
|
||||||
|
isLive={isLive}
|
||||||
|
isArchive={archiveMode}
|
||||||
|
snapshot={snapshot}
|
||||||
|
rows={rows}
|
||||||
|
connection={streamStatus}
|
||||||
|
now={now}
|
||||||
|
/>
|
||||||
<TrackStatusBanner status={snapshot.TrackStatus} />
|
<TrackStatusBanner status={snapshot.TrackStatus} />
|
||||||
<PinnedDrivers rows={rows} history={gapHistory} pinned={pinned} onToggle={handleTogglePin} />
|
<PinnedDrivers rows={rows} history={gapHistory} pinned={pinned} onToggle={handleTogglePin} />
|
||||||
|
<TyreDegPanel rows={rows} sessionType={snapshot.Session?.SessionType} pinned={pinned} />
|
||||||
<div className="live-columns">
|
<div className="live-columns">
|
||||||
<div className="live-tower-col">
|
<div className="live-tower-col">
|
||||||
<div className="sec-header">
|
<div className="sec-header">
|
||||||
@@ -178,7 +290,13 @@ export function LiveTimingPage() {
|
|||||||
/>
|
/>
|
||||||
</div>
|
</div>
|
||||||
<div className="live-rc-col">
|
<div className="live-rc-col">
|
||||||
|
<TeamRadioTicker
|
||||||
|
captures={snapshot.TeamRadio ?? []}
|
||||||
|
driverInfo={snapshot.DriverInfo}
|
||||||
|
session={snapshot.Session}
|
||||||
|
/>
|
||||||
<RaceControlFeed messages={snapshot.RCMessages ?? []} driverInfo={snapshot.DriverInfo} />
|
<RaceControlFeed messages={snapshot.RCMessages ?? []} driverInfo={snapshot.DriverInfo} />
|
||||||
|
<EventRail events={events} driverInfo={snapshot.DriverInfo} />
|
||||||
</div>
|
</div>
|
||||||
</div>
|
</div>
|
||||||
</>
|
</>
|
||||||
|
|||||||
@@ -13,6 +13,7 @@ import { TabBar, type Tab } from '../components/TabBar'
|
|||||||
import { DatasetStatusView } from '../components/DatasetStatusView'
|
import { DatasetStatusView } from '../components/DatasetStatusView'
|
||||||
import { StrategyView } from '../components/StrategyView'
|
import { StrategyView } from '../components/StrategyView'
|
||||||
import { LapsView } from '../components/LapsView'
|
import { LapsView } from '../components/LapsView'
|
||||||
|
import { CompareView } from '../components/CompareView'
|
||||||
import { RaceControlView } from '../components/RaceControlView'
|
import { RaceControlView } from '../components/RaceControlView'
|
||||||
import { WeatherView } from '../components/WeatherView'
|
import { WeatherView } from '../components/WeatherView'
|
||||||
import { OverviewView } from '../components/OverviewView'
|
import { OverviewView } from '../components/OverviewView'
|
||||||
@@ -307,6 +308,19 @@ export function RaceHubPage({ sessionKey }: Props) {
|
|||||||
</div>
|
</div>
|
||||||
)}
|
)}
|
||||||
|
|
||||||
|
{activeTab === 'compare' && (
|
||||||
|
<div className="data-section">
|
||||||
|
<div className="sec-header">
|
||||||
|
<span className="sec-title">Driver Compare</span>
|
||||||
|
</div>
|
||||||
|
<CompareView
|
||||||
|
sessionKey={sessionKey}
|
||||||
|
results={data.results}
|
||||||
|
drivers={data.drivers}
|
||||||
|
/>
|
||||||
|
</div>
|
||||||
|
)}
|
||||||
|
|
||||||
{activeTab === 'lap_data' && (
|
{activeTab === 'lap_data' && (
|
||||||
<div className="data-section">
|
<div className="data-section">
|
||||||
<div className="sec-header">
|
<div className="sec-header">
|
||||||
|
|||||||
442
frontend/src/pages/RacePreviewPage.tsx
Normal file
442
frontend/src/pages/RacePreviewPage.tsx
Normal file
@@ -0,0 +1,442 @@
|
|||||||
|
import { useEffect, useMemo, useState, type ReactNode } from 'react'
|
||||||
|
import { useQuery } from '@tanstack/react-query'
|
||||||
|
import {
|
||||||
|
fetchChampionshipHub,
|
||||||
|
fetchMeetings,
|
||||||
|
fetchResults,
|
||||||
|
fetchSeasons,
|
||||||
|
fetchSessions,
|
||||||
|
fetchStartingGrid,
|
||||||
|
fetchTrackOutline,
|
||||||
|
} from '../api'
|
||||||
|
import { countryAccent, countryFlag, formatGpDateRange } from '../lib/gpIdentity'
|
||||||
|
import {
|
||||||
|
buildTitleFightContext,
|
||||||
|
countdownTargetSession,
|
||||||
|
extractPodium,
|
||||||
|
extractPole,
|
||||||
|
findPriorYearMeetingByCircuit,
|
||||||
|
findRaceSession,
|
||||||
|
formatPointsGap,
|
||||||
|
isSprintWeekend,
|
||||||
|
pickPreviewMeeting,
|
||||||
|
RACE_WIN_POINTS,
|
||||||
|
SPRINT_WEEKEND_MAX_POINTS,
|
||||||
|
} from '../lib/preview'
|
||||||
|
import { formatCountdown, formatSessionScheduleTime, sessionStartTime, sortSessionsByStart } from '../lib/schedule'
|
||||||
|
import { buildOutlinePath } from '../lib/trackmap'
|
||||||
|
import { teamColor } from '../utils'
|
||||||
|
import type { Meeting, Session, TrackOutline } from '../types'
|
||||||
|
import '../styles/preview.css'
|
||||||
|
|
||||||
|
function SectionState({
|
||||||
|
loading,
|
||||||
|
error,
|
||||||
|
empty,
|
||||||
|
emptyMessage,
|
||||||
|
children,
|
||||||
|
}: {
|
||||||
|
loading?: boolean
|
||||||
|
error?: Error | null
|
||||||
|
empty?: boolean
|
||||||
|
emptyMessage?: string
|
||||||
|
children: ReactNode
|
||||||
|
}) {
|
||||||
|
if (loading) {
|
||||||
|
return <div className="preview-section-state">Loading…</div>
|
||||||
|
}
|
||||||
|
if (error) {
|
||||||
|
return (
|
||||||
|
<div className="preview-section-state error">
|
||||||
|
{error instanceof Error ? error.message : 'Failed to load'}
|
||||||
|
</div>
|
||||||
|
)
|
||||||
|
}
|
||||||
|
if (empty) {
|
||||||
|
return <div className="preview-section-state">{emptyMessage ?? 'No data available'}</div>
|
||||||
|
}
|
||||||
|
return <>{children}</>
|
||||||
|
}
|
||||||
|
|
||||||
|
function TrackOutlineCard({
|
||||||
|
outline,
|
||||||
|
loading,
|
||||||
|
error,
|
||||||
|
accent,
|
||||||
|
}: {
|
||||||
|
outline: TrackOutline | null | undefined
|
||||||
|
loading: boolean
|
||||||
|
error: Error | null
|
||||||
|
accent: string
|
||||||
|
}) {
|
||||||
|
const outlinePath = useMemo(() => buildOutlinePath(outline?.points ?? []), [outline])
|
||||||
|
|
||||||
|
return (
|
||||||
|
<section className="preview-card" data-testid="preview-track-card">
|
||||||
|
<h2 className="preview-card-title">Circuit</h2>
|
||||||
|
<SectionState
|
||||||
|
loading={loading}
|
||||||
|
error={error}
|
||||||
|
empty={!outline || !outlinePath}
|
||||||
|
emptyMessage="Track outline unavailable for this circuit"
|
||||||
|
>
|
||||||
|
<div className="preview-track-stage" style={{ ['--preview-accent' as string]: accent }}>
|
||||||
|
<svg className="preview-track-svg" viewBox="0 0 100 100" role="img" aria-label="Circuit outline">
|
||||||
|
<path className="preview-track-shadow" d={outlinePath} />
|
||||||
|
<path className="preview-track-outline" d={outlinePath} />
|
||||||
|
</svg>
|
||||||
|
</div>
|
||||||
|
</SectionState>
|
||||||
|
</section>
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
function LastYearCard({
|
||||||
|
year,
|
||||||
|
loading,
|
||||||
|
error,
|
||||||
|
podium,
|
||||||
|
pole,
|
||||||
|
isFirstTime,
|
||||||
|
}: {
|
||||||
|
year: number | null
|
||||||
|
loading: boolean
|
||||||
|
error: Error | null
|
||||||
|
podium: ReturnType<typeof extractPodium>
|
||||||
|
pole: ReturnType<typeof extractPole>
|
||||||
|
isFirstTime: boolean
|
||||||
|
}) {
|
||||||
|
return (
|
||||||
|
<section className="preview-card" data-testid="preview-last-year-card">
|
||||||
|
<h2 className="preview-card-title">Last year here</h2>
|
||||||
|
{year != null && !isFirstTime && <p className="preview-card-sub">{year} race weekend</p>}
|
||||||
|
<SectionState
|
||||||
|
loading={loading}
|
||||||
|
error={error}
|
||||||
|
empty={isFirstTime || podium.length === 0}
|
||||||
|
emptyMessage={
|
||||||
|
isFirstTime
|
||||||
|
? 'First time on the calendar — no prior race at this circuit'
|
||||||
|
: 'No race results available for the previous visit'
|
||||||
|
}
|
||||||
|
>
|
||||||
|
<div className="preview-podium">
|
||||||
|
{podium.map((place) => (
|
||||||
|
<div key={place.position} className="preview-podium-row">
|
||||||
|
<span className="preview-podium-pos">P{place.position}</span>
|
||||||
|
<span className="preview-podium-code" style={{ color: teamColor(place.team_colour) }}>
|
||||||
|
{place.name_acronym}
|
||||||
|
</span>
|
||||||
|
<span className="preview-podium-team">{place.team_name}</span>
|
||||||
|
</div>
|
||||||
|
))}
|
||||||
|
</div>
|
||||||
|
{pole && (
|
||||||
|
<p className="preview-pole">
|
||||||
|
Pole: <strong style={{ color: teamColor(pole.team_colour) }}>{pole.name_acronym}</strong>{' '}
|
||||||
|
({pole.team_name})
|
||||||
|
</p>
|
||||||
|
)}
|
||||||
|
</SectionState>
|
||||||
|
</section>
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
function TitleFightCard({
|
||||||
|
loading,
|
||||||
|
error,
|
||||||
|
drivers,
|
||||||
|
sprintWeekend,
|
||||||
|
season,
|
||||||
|
}: {
|
||||||
|
loading: boolean
|
||||||
|
error: Error | null
|
||||||
|
drivers: ReturnType<typeof buildTitleFightContext>
|
||||||
|
sprintWeekend: boolean
|
||||||
|
season: number | null
|
||||||
|
}) {
|
||||||
|
return (
|
||||||
|
<section className="preview-card preview-card--wide" data-testid="preview-title-fight-card">
|
||||||
|
<h2 className="preview-card-title">Title fight context</h2>
|
||||||
|
{season != null && <p className="preview-card-sub">{season} drivers' championship · top 3</p>}
|
||||||
|
<SectionState
|
||||||
|
loading={loading}
|
||||||
|
error={error}
|
||||||
|
empty={drivers.length === 0}
|
||||||
|
emptyMessage="Championship standings not available"
|
||||||
|
>
|
||||||
|
<table className="preview-title-table">
|
||||||
|
<thead>
|
||||||
|
<tr>
|
||||||
|
<th>Driver</th>
|
||||||
|
<th>Pts</th>
|
||||||
|
<th>Gap</th>
|
||||||
|
<th>If win (+{RACE_WIN_POINTS})</th>
|
||||||
|
</tr>
|
||||||
|
</thead>
|
||||||
|
<tbody>
|
||||||
|
{drivers.map((d) => (
|
||||||
|
<tr key={d.name_acronym}>
|
||||||
|
<td>
|
||||||
|
<span style={{ color: teamColor(d.team_colour), fontWeight: 600 }}>{d.name_acronym}</span>
|
||||||
|
</td>
|
||||||
|
<td className="mono">{d.points}</td>
|
||||||
|
<td className="mono">{formatPointsGap(d.gapToLeader)}</td>
|
||||||
|
<td className="mono">
|
||||||
|
{d.position === 1 ? 'LEADER' : formatPointsGap(d.gapAfterRaceWin)}
|
||||||
|
</td>
|
||||||
|
</tr>
|
||||||
|
))}
|
||||||
|
</tbody>
|
||||||
|
</table>
|
||||||
|
{sprintWeekend && (
|
||||||
|
<p className="preview-sprint-note" data-testid="preview-sprint-note">
|
||||||
|
Sprint weekend: up to {SPRINT_WEEKEND_MAX_POINTS} pts available (race win {RACE_WIN_POINTS} + sprint win
|
||||||
|
8). Max gain would reduce gaps by {SPRINT_WEEKEND_MAX_POINTS} vs a standard race win.
|
||||||
|
</p>
|
||||||
|
)}
|
||||||
|
</SectionState>
|
||||||
|
</section>
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
function PreviewHeader({
|
||||||
|
meeting,
|
||||||
|
sessions,
|
||||||
|
countdownSession,
|
||||||
|
now,
|
||||||
|
accent,
|
||||||
|
}: {
|
||||||
|
meeting: Meeting
|
||||||
|
sessions: Session[]
|
||||||
|
countdownSession: Session | null
|
||||||
|
now: Date
|
||||||
|
accent: string
|
||||||
|
}) {
|
||||||
|
const countdownTarget = countdownSession ? sessionStartTime(countdownSession) : null
|
||||||
|
|
||||||
|
return (
|
||||||
|
<header
|
||||||
|
className="preview-header"
|
||||||
|
data-testid="preview-header"
|
||||||
|
style={{ ['--preview-accent' as string]: accent }}
|
||||||
|
>
|
||||||
|
<div className="preview-header-accent" />
|
||||||
|
<div className="preview-header-body">
|
||||||
|
<div className="preview-header-top">
|
||||||
|
<div>
|
||||||
|
<h1 className="preview-gp-name">
|
||||||
|
{countryFlag(meeting) && <span className="preview-gp-flag">{countryFlag(meeting)}</span>}
|
||||||
|
{meeting.meeting_name}
|
||||||
|
</h1>
|
||||||
|
<p className="preview-circuit">
|
||||||
|
{meeting.circuit_short_name}
|
||||||
|
{meeting.location ? ` · ${meeting.location}` : ''}
|
||||||
|
{formatGpDateRange(meeting) ? ` · ${formatGpDateRange(meeting)}` : ''}
|
||||||
|
</p>
|
||||||
|
</div>
|
||||||
|
{countdownTarget && (
|
||||||
|
<div className="preview-countdown" data-testid="preview-countdown">
|
||||||
|
<span className="preview-countdown-label">
|
||||||
|
{countdownSession?.session_name ?? 'Next session'}
|
||||||
|
</span>
|
||||||
|
<span className="preview-countdown-value">{formatCountdown(countdownTarget, now)}</span>
|
||||||
|
</div>
|
||||||
|
)}
|
||||||
|
</div>
|
||||||
|
{sessions.length > 0 && (
|
||||||
|
<div className="preview-schedule" data-testid="preview-schedule">
|
||||||
|
{sessions.map((session) => (
|
||||||
|
<div key={session.session_key} className="preview-schedule-item">
|
||||||
|
<span className="preview-schedule-name">{session.session_name}</span>
|
||||||
|
<span className="preview-schedule-time">{formatSessionScheduleTime(session.date_start)}</span>
|
||||||
|
</div>
|
||||||
|
))}
|
||||||
|
</div>
|
||||||
|
)}
|
||||||
|
</div>
|
||||||
|
</header>
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
export function RacePreviewPage() {
|
||||||
|
const [now, setNow] = useState(() => Date.now())
|
||||||
|
|
||||||
|
useEffect(() => {
|
||||||
|
const timer = window.setInterval(() => setNow(Date.now()), 1000)
|
||||||
|
return () => window.clearInterval(timer)
|
||||||
|
}, [])
|
||||||
|
|
||||||
|
const nowDate = useMemo(() => new Date(now), [now])
|
||||||
|
|
||||||
|
const seasonsQuery = useQuery({
|
||||||
|
queryKey: ['seasons'],
|
||||||
|
queryFn: fetchSeasons,
|
||||||
|
})
|
||||||
|
|
||||||
|
const latestSeason = seasonsQuery.data?.[0] ?? null
|
||||||
|
|
||||||
|
const meetingsQuery = useQuery({
|
||||||
|
queryKey: ['meetings', latestSeason, 'auto'],
|
||||||
|
queryFn: () => fetchMeetings(latestSeason!, 'auto'),
|
||||||
|
enabled: latestSeason != null,
|
||||||
|
})
|
||||||
|
|
||||||
|
const previewMeeting = useMemo(
|
||||||
|
() => pickPreviewMeeting(meetingsQuery.data ?? [], nowDate),
|
||||||
|
[meetingsQuery.data, nowDate],
|
||||||
|
)
|
||||||
|
|
||||||
|
const sessionsQuery = useQuery({
|
||||||
|
queryKey: ['sessions', previewMeeting?.meeting_key, 'auto'],
|
||||||
|
queryFn: () => fetchSessions(previewMeeting!.meeting_key, 'auto'),
|
||||||
|
enabled: previewMeeting != null,
|
||||||
|
})
|
||||||
|
|
||||||
|
const sessions = useMemo(
|
||||||
|
() => sortSessionsByStart(sessionsQuery.data ?? []),
|
||||||
|
[sessionsQuery.data],
|
||||||
|
)
|
||||||
|
|
||||||
|
const countdownSession = useMemo(() => countdownTargetSession(sessions, nowDate), [sessions, nowDate])
|
||||||
|
const sprintWeekend = useMemo(() => isSprintWeekend(sessions), [sessions])
|
||||||
|
|
||||||
|
const priorYear = previewMeeting ? previewMeeting.year - 1 : null
|
||||||
|
|
||||||
|
const priorMeetingsQuery = useQuery({
|
||||||
|
queryKey: ['meetings', priorYear, 'auto'],
|
||||||
|
queryFn: () => fetchMeetings(priorYear!, 'auto'),
|
||||||
|
enabled: priorYear != null && previewMeeting != null,
|
||||||
|
})
|
||||||
|
|
||||||
|
const priorMeeting = useMemo(
|
||||||
|
() => findPriorYearMeetingByCircuit(priorMeetingsQuery.data ?? [], previewMeeting?.circuit_key),
|
||||||
|
[priorMeetingsQuery.data, previewMeeting?.circuit_key],
|
||||||
|
)
|
||||||
|
|
||||||
|
const priorSessionsQuery = useQuery({
|
||||||
|
queryKey: ['sessions', priorMeeting?.meeting_key, 'auto'],
|
||||||
|
queryFn: () => fetchSessions(priorMeeting!.meeting_key, 'auto'),
|
||||||
|
enabled: priorMeeting != null,
|
||||||
|
})
|
||||||
|
|
||||||
|
const priorRaceSession = useMemo(
|
||||||
|
() => findRaceSession(priorSessionsQuery.data ?? []),
|
||||||
|
[priorSessionsQuery.data],
|
||||||
|
)
|
||||||
|
|
||||||
|
const priorResultsQuery = useQuery({
|
||||||
|
queryKey: ['results', priorRaceSession?.session_key, 'auto'],
|
||||||
|
queryFn: () => fetchResults(priorRaceSession!.session_key, 'auto'),
|
||||||
|
enabled: priorRaceSession != null,
|
||||||
|
})
|
||||||
|
|
||||||
|
const priorGridQuery = useQuery({
|
||||||
|
queryKey: ['grid', priorRaceSession?.session_key, 'auto'],
|
||||||
|
queryFn: () => fetchStartingGrid(priorRaceSession!.session_key, 'auto'),
|
||||||
|
enabled: priorRaceSession != null,
|
||||||
|
})
|
||||||
|
|
||||||
|
const trackOutlineQuery = useQuery({
|
||||||
|
queryKey: ['track-outline', previewMeeting?.circuit_key, previewMeeting?.year],
|
||||||
|
queryFn: () => fetchTrackOutline(previewMeeting!.circuit_key!, previewMeeting!.year),
|
||||||
|
enabled: previewMeeting?.circuit_key != null && previewMeeting.circuit_key > 0,
|
||||||
|
})
|
||||||
|
|
||||||
|
const championshipQuery = useQuery({
|
||||||
|
queryKey: ['championship-hub', latestSeason],
|
||||||
|
queryFn: () => fetchChampionshipHub(latestSeason!),
|
||||||
|
enabled: latestSeason != null,
|
||||||
|
})
|
||||||
|
|
||||||
|
const podium = useMemo(() => extractPodium(priorResultsQuery.data ?? []), [priorResultsQuery.data])
|
||||||
|
const pole = useMemo(() => extractPole(priorGridQuery.data ?? []), [priorGridQuery.data])
|
||||||
|
const titleFight = useMemo(
|
||||||
|
() => (championshipQuery.data ? buildTitleFightContext(championshipQuery.data) : []),
|
||||||
|
[championshipQuery.data],
|
||||||
|
)
|
||||||
|
|
||||||
|
const accent = countryAccent(previewMeeting)
|
||||||
|
const isFirstTimeCircuit = priorMeeting == null && priorYear != null && !priorMeetingsQuery.isLoading
|
||||||
|
|
||||||
|
if (seasonsQuery.isLoading || meetingsQuery.isLoading) {
|
||||||
|
return <div className="page loading-state" data-testid="preview-loading">loading preview…</div>
|
||||||
|
}
|
||||||
|
|
||||||
|
if (seasonsQuery.isError || meetingsQuery.isError) {
|
||||||
|
const err = seasonsQuery.error ?? meetingsQuery.error
|
||||||
|
return (
|
||||||
|
<div className="page error-box" data-testid="preview-error">
|
||||||
|
{err instanceof Error ? err.message : 'Failed to load preview'}
|
||||||
|
</div>
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
if (!previewMeeting) {
|
||||||
|
return (
|
||||||
|
<div className="preview-page" data-testid="preview-season-over">
|
||||||
|
<div className="preview-empty">
|
||||||
|
<span className="preview-empty-eyebrow mono">box-box · race preview</span>
|
||||||
|
<h1 className="preview-empty-title">Season complete</h1>
|
||||||
|
<p className="preview-empty-sub">
|
||||||
|
No upcoming races on the {latestSeason ?? 'current'} calendar. Check back when the next season schedule is
|
||||||
|
published.
|
||||||
|
</p>
|
||||||
|
</div>
|
||||||
|
{titleFight.length > 0 && (
|
||||||
|
<TitleFightCard
|
||||||
|
loading={championshipQuery.isLoading}
|
||||||
|
error={championshipQuery.isError ? (championshipQuery.error as Error) : null}
|
||||||
|
drivers={titleFight}
|
||||||
|
sprintWeekend={false}
|
||||||
|
season={latestSeason}
|
||||||
|
/>
|
||||||
|
)}
|
||||||
|
</div>
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
return (
|
||||||
|
<div className="preview-page" data-testid="preview-page">
|
||||||
|
<PreviewHeader
|
||||||
|
meeting={previewMeeting}
|
||||||
|
sessions={sessions}
|
||||||
|
countdownSession={countdownSession}
|
||||||
|
now={nowDate}
|
||||||
|
accent={accent}
|
||||||
|
/>
|
||||||
|
|
||||||
|
<div className="preview-grid">
|
||||||
|
<TrackOutlineCard
|
||||||
|
outline={trackOutlineQuery.data}
|
||||||
|
loading={trackOutlineQuery.isLoading}
|
||||||
|
error={trackOutlineQuery.isError ? (trackOutlineQuery.error as Error) : null}
|
||||||
|
accent={accent}
|
||||||
|
/>
|
||||||
|
|
||||||
|
<LastYearCard
|
||||||
|
year={priorMeeting?.year ?? priorYear}
|
||||||
|
loading={priorMeetingsQuery.isLoading || priorSessionsQuery.isLoading || priorResultsQuery.isLoading}
|
||||||
|
error={
|
||||||
|
priorMeetingsQuery.isError
|
||||||
|
? (priorMeetingsQuery.error as Error)
|
||||||
|
: priorResultsQuery.isError
|
||||||
|
? (priorResultsQuery.error as Error)
|
||||||
|
: null
|
||||||
|
}
|
||||||
|
podium={podium}
|
||||||
|
pole={pole}
|
||||||
|
isFirstTime={isFirstTimeCircuit}
|
||||||
|
/>
|
||||||
|
</div>
|
||||||
|
|
||||||
|
<TitleFightCard
|
||||||
|
loading={championshipQuery.isLoading}
|
||||||
|
error={championshipQuery.isError ? (championshipQuery.error as Error) : null}
|
||||||
|
drivers={titleFight}
|
||||||
|
sprintWeekend={sprintWeekend}
|
||||||
|
season={latestSeason}
|
||||||
|
/>
|
||||||
|
</div>
|
||||||
|
)
|
||||||
|
}
|
||||||
@@ -6,6 +6,7 @@ import { DataLibraryPage } from './pages/DataLibraryPage'
|
|||||||
import { LiveTimingPage } from './pages/LiveTimingPage'
|
import { LiveTimingPage } from './pages/LiveTimingPage'
|
||||||
import { BriefingPage } from './pages/BriefingPage'
|
import { BriefingPage } from './pages/BriefingPage'
|
||||||
import { ChampionshipPage } from './pages/ChampionshipPage'
|
import { ChampionshipPage } from './pages/ChampionshipPage'
|
||||||
|
import { RacePreviewPage } from './pages/RacePreviewPage'
|
||||||
|
|
||||||
type RaceHubSearch = {
|
type RaceHubSearch = {
|
||||||
session_key?: number
|
session_key?: number
|
||||||
@@ -70,6 +71,12 @@ export const briefingRoute = createRoute({
|
|||||||
component: BriefingPage,
|
component: BriefingPage,
|
||||||
})
|
})
|
||||||
|
|
||||||
|
export const previewRoute = createRoute({
|
||||||
|
getParentRoute: () => rootRoute,
|
||||||
|
path: '/preview',
|
||||||
|
component: RacePreviewPage,
|
||||||
|
})
|
||||||
|
|
||||||
const routeTree = rootRoute.addChildren([
|
const routeTree = rootRoute.addChildren([
|
||||||
commandCenterRoute,
|
commandCenterRoute,
|
||||||
raceHubRoute,
|
raceHubRoute,
|
||||||
@@ -78,6 +85,7 @@ const routeTree = rootRoute.addChildren([
|
|||||||
liveTimingRoute,
|
liveTimingRoute,
|
||||||
championshipRoute,
|
championshipRoute,
|
||||||
briefingRoute,
|
briefingRoute,
|
||||||
|
previewRoute,
|
||||||
])
|
])
|
||||||
|
|
||||||
export const router = createRouter({ routeTree })
|
export const router = createRouter({ routeTree })
|
||||||
|
|||||||
@@ -649,6 +649,141 @@ a { color: inherit; text-decoration: none; }
|
|||||||
gap: var(--s5);
|
gap: var(--s5);
|
||||||
}
|
}
|
||||||
|
|
||||||
|
.live-track-panel {
|
||||||
|
margin-bottom: var(--s5);
|
||||||
|
}
|
||||||
|
|
||||||
|
.track-map-stage {
|
||||||
|
position: relative;
|
||||||
|
min-height: 360px;
|
||||||
|
border: 1px solid var(--border);
|
||||||
|
background: var(--surface);
|
||||||
|
overflow: hidden;
|
||||||
|
}
|
||||||
|
|
||||||
|
.track-map-svg {
|
||||||
|
display: block;
|
||||||
|
width: 100%;
|
||||||
|
height: 360px;
|
||||||
|
}
|
||||||
|
|
||||||
|
.track-map-outline-shadow,
|
||||||
|
.track-map-outline {
|
||||||
|
fill: none;
|
||||||
|
stroke-linecap: round;
|
||||||
|
stroke-linejoin: round;
|
||||||
|
}
|
||||||
|
|
||||||
|
.track-map-outline-shadow {
|
||||||
|
stroke: rgba(255, 255, 255, 0.08);
|
||||||
|
stroke-width: 5;
|
||||||
|
}
|
||||||
|
|
||||||
|
.track-map-outline {
|
||||||
|
stroke: var(--surface-3);
|
||||||
|
stroke-width: 2.4;
|
||||||
|
}
|
||||||
|
|
||||||
|
.track-car {
|
||||||
|
cursor: pointer;
|
||||||
|
outline: none;
|
||||||
|
}
|
||||||
|
|
||||||
|
.track-car circle {
|
||||||
|
stroke: #050505;
|
||||||
|
stroke-width: 0.7;
|
||||||
|
transition: r 0.12s, opacity 0.12s, stroke 0.12s;
|
||||||
|
}
|
||||||
|
|
||||||
|
.track-car text {
|
||||||
|
fill: #fff;
|
||||||
|
font-family: var(--f-mono);
|
||||||
|
font-size: 2.1px;
|
||||||
|
font-weight: 800;
|
||||||
|
pointer-events: none;
|
||||||
|
text-anchor: middle;
|
||||||
|
paint-order: stroke;
|
||||||
|
stroke: rgba(0, 0, 0, 0.85);
|
||||||
|
stroke-width: 0.7;
|
||||||
|
}
|
||||||
|
|
||||||
|
.track-car:hover circle,
|
||||||
|
.track-car:focus-visible circle,
|
||||||
|
.track-car-selected circle {
|
||||||
|
r: 3.7;
|
||||||
|
stroke: #fff;
|
||||||
|
}
|
||||||
|
|
||||||
|
.track-car-inactive {
|
||||||
|
opacity: 0.35;
|
||||||
|
filter: grayscale(0.8);
|
||||||
|
}
|
||||||
|
|
||||||
|
.track-map-empty {
|
||||||
|
display: grid;
|
||||||
|
min-height: 160px;
|
||||||
|
place-items: center;
|
||||||
|
color: var(--text-3);
|
||||||
|
font-family: var(--f-mono);
|
||||||
|
font-size: 11px;
|
||||||
|
text-transform: uppercase;
|
||||||
|
}
|
||||||
|
|
||||||
|
.track-map-overlay {
|
||||||
|
position: absolute;
|
||||||
|
inset: 0;
|
||||||
|
pointer-events: none;
|
||||||
|
}
|
||||||
|
|
||||||
|
.track-telemetry {
|
||||||
|
position: absolute;
|
||||||
|
right: var(--s5);
|
||||||
|
bottom: var(--s5);
|
||||||
|
width: min(260px, calc(100% - 32px));
|
||||||
|
padding: var(--s4);
|
||||||
|
border: 1px solid var(--border-2);
|
||||||
|
background: rgba(10, 10, 10, 0.88);
|
||||||
|
backdrop-filter: blur(10px);
|
||||||
|
}
|
||||||
|
|
||||||
|
.track-telemetry-head {
|
||||||
|
display: flex;
|
||||||
|
align-items: center;
|
||||||
|
justify-content: space-between;
|
||||||
|
gap: var(--s4);
|
||||||
|
margin-bottom: var(--s3);
|
||||||
|
color: var(--text-3);
|
||||||
|
font-family: var(--f-mono);
|
||||||
|
font-size: 10px;
|
||||||
|
text-transform: uppercase;
|
||||||
|
}
|
||||||
|
|
||||||
|
.track-driver-code {
|
||||||
|
color: var(--text);
|
||||||
|
font-size: 13px;
|
||||||
|
font-weight: 800;
|
||||||
|
}
|
||||||
|
|
||||||
|
.track-telemetry dl {
|
||||||
|
display: grid;
|
||||||
|
grid-template-columns: repeat(5, minmax(0, 1fr));
|
||||||
|
gap: var(--s3);
|
||||||
|
}
|
||||||
|
|
||||||
|
.track-telemetry dt {
|
||||||
|
color: var(--text-3);
|
||||||
|
font-family: var(--f-mono);
|
||||||
|
font-size: 9px;
|
||||||
|
}
|
||||||
|
|
||||||
|
.track-telemetry dd {
|
||||||
|
color: var(--text);
|
||||||
|
font-family: var(--f-mono);
|
||||||
|
font-size: 12px;
|
||||||
|
font-weight: 700;
|
||||||
|
min-width: 0;
|
||||||
|
}
|
||||||
|
|
||||||
@media (min-width: 900px) {
|
@media (min-width: 900px) {
|
||||||
.live-columns {
|
.live-columns {
|
||||||
display: grid;
|
display: grid;
|
||||||
@@ -673,6 +808,12 @@ a { color: inherit; text-decoration: none; }
|
|||||||
color: var(--yellow);
|
color: var(--yellow);
|
||||||
}
|
}
|
||||||
|
|
||||||
|
.live-status-archive {
|
||||||
|
background: rgba(70, 140, 255, 0.08);
|
||||||
|
border: 1px solid rgba(70, 140, 255, 0.24);
|
||||||
|
color: #8bb7ff;
|
||||||
|
}
|
||||||
|
|
||||||
/* ── Live empty state ── */
|
/* ── Live empty state ── */
|
||||||
.live-empty-status {
|
.live-empty-status {
|
||||||
display: flex;
|
display: flex;
|
||||||
@@ -680,6 +821,29 @@ a { color: inherit; text-decoration: none; }
|
|||||||
margin-bottom: var(--s4);
|
margin-bottom: var(--s4);
|
||||||
}
|
}
|
||||||
|
|
||||||
|
.live-archive-btn {
|
||||||
|
display: inline-flex;
|
||||||
|
align-items: center;
|
||||||
|
justify-content: center;
|
||||||
|
gap: var(--s2);
|
||||||
|
margin-top: var(--s5);
|
||||||
|
min-height: 36px;
|
||||||
|
padding: 0 var(--s4);
|
||||||
|
border: 1px solid rgba(255, 255, 255, 0.16);
|
||||||
|
border-radius: 4px;
|
||||||
|
background: rgba(255, 255, 255, 0.06);
|
||||||
|
color: var(--text);
|
||||||
|
font-family: var(--f-mono);
|
||||||
|
font-size: 11px;
|
||||||
|
font-weight: 800;
|
||||||
|
text-transform: uppercase;
|
||||||
|
}
|
||||||
|
|
||||||
|
.live-archive-btn:hover {
|
||||||
|
border-color: rgba(255, 255, 255, 0.28);
|
||||||
|
background: rgba(255, 255, 255, 0.1);
|
||||||
|
}
|
||||||
|
|
||||||
.mono { font-family: var(--f-mono); }
|
.mono { font-family: var(--f-mono); }
|
||||||
|
|
||||||
.live-conn,
|
.live-conn,
|
||||||
|
|||||||
78
frontend/src/styles/compare-view.css
Normal file
78
frontend/src/styles/compare-view.css
Normal file
@@ -0,0 +1,78 @@
|
|||||||
|
.compare-view {
|
||||||
|
display: flex;
|
||||||
|
flex-direction: column;
|
||||||
|
gap: var(--s5);
|
||||||
|
}
|
||||||
|
|
||||||
|
.compare-pickers {
|
||||||
|
display: flex;
|
||||||
|
flex-wrap: wrap;
|
||||||
|
gap: var(--s4);
|
||||||
|
align-items: flex-end;
|
||||||
|
}
|
||||||
|
|
||||||
|
.compare-picker {
|
||||||
|
display: flex;
|
||||||
|
flex-direction: column;
|
||||||
|
gap: var(--s3);
|
||||||
|
min-width: 180px;
|
||||||
|
}
|
||||||
|
|
||||||
|
.compare-picker-label {
|
||||||
|
font-family: var(--f-mono);
|
||||||
|
font-size: 11px;
|
||||||
|
letter-spacing: 0.06em;
|
||||||
|
text-transform: uppercase;
|
||||||
|
color: var(--text-3);
|
||||||
|
}
|
||||||
|
|
||||||
|
.compare-picker-select {
|
||||||
|
font-family: var(--f-mono);
|
||||||
|
font-size: 13px;
|
||||||
|
padding: var(--s2) var(--s3);
|
||||||
|
border: 1px solid var(--border);
|
||||||
|
border-radius: var(--r1);
|
||||||
|
background: var(--surface-2);
|
||||||
|
color: var(--text);
|
||||||
|
}
|
||||||
|
|
||||||
|
.compare-picker-select:focus {
|
||||||
|
outline: 2px solid var(--gp-accent, var(--red));
|
||||||
|
outline-offset: 1px;
|
||||||
|
}
|
||||||
|
|
||||||
|
.compare-section {
|
||||||
|
display: flex;
|
||||||
|
flex-direction: column;
|
||||||
|
gap: var(--s3);
|
||||||
|
}
|
||||||
|
|
||||||
|
.compare-section-title {
|
||||||
|
font-family: var(--f-mono);
|
||||||
|
font-size: 12px;
|
||||||
|
letter-spacing: 0.05em;
|
||||||
|
text-transform: uppercase;
|
||||||
|
color: var(--text-2);
|
||||||
|
}
|
||||||
|
|
||||||
|
.compare-section-meta {
|
||||||
|
font-family: var(--f-mono);
|
||||||
|
font-size: 11px;
|
||||||
|
color: var(--text-3);
|
||||||
|
}
|
||||||
|
|
||||||
|
.compare-pit-caption {
|
||||||
|
font-family: var(--f-mono);
|
||||||
|
font-size: 11px;
|
||||||
|
color: var(--text-3);
|
||||||
|
margin: 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
.compare-stale-notice {
|
||||||
|
font-size: 12px;
|
||||||
|
color: var(--amber, #f59e0b);
|
||||||
|
background: rgba(245, 158, 11, 0.08);
|
||||||
|
border: 1px solid rgba(245, 158, 11, 0.25);
|
||||||
|
border-radius: var(--r1);
|
||||||
|
padding: var(--s2) var(--s3);
|
||||||
|
}
|
||||||
76
frontend/src/styles/delta-graph.css
Normal file
76
frontend/src/styles/delta-graph.css
Normal file
@@ -0,0 +1,76 @@
|
|||||||
|
.delta-graph {
|
||||||
|
width: 100%;
|
||||||
|
min-width: 280px;
|
||||||
|
max-width: 640px;
|
||||||
|
}
|
||||||
|
|
||||||
|
.delta-graph-svg {
|
||||||
|
display: block;
|
||||||
|
width: 100%;
|
||||||
|
}
|
||||||
|
|
||||||
|
.delta-graph-empty {
|
||||||
|
padding: 1.5rem 1rem;
|
||||||
|
text-align: center;
|
||||||
|
color: var(--text-3);
|
||||||
|
font-size: 0.875rem;
|
||||||
|
}
|
||||||
|
|
||||||
|
.delta-graph-zero-line {
|
||||||
|
stroke: var(--text-3);
|
||||||
|
stroke-width: 1;
|
||||||
|
stroke-dasharray: 4 3;
|
||||||
|
}
|
||||||
|
|
||||||
|
.delta-graph-grid-line {
|
||||||
|
stroke: var(--border);
|
||||||
|
stroke-width: 0.5;
|
||||||
|
}
|
||||||
|
|
||||||
|
.delta-graph-axis-label {
|
||||||
|
fill: var(--text-3);
|
||||||
|
font-family: var(--f-mono);
|
||||||
|
font-size: 9px;
|
||||||
|
}
|
||||||
|
|
||||||
|
.delta-graph-driver-line {
|
||||||
|
fill: none;
|
||||||
|
stroke-width: 2;
|
||||||
|
stroke-linejoin: round;
|
||||||
|
stroke-linecap: round;
|
||||||
|
}
|
||||||
|
|
||||||
|
.delta-graph-crosshair {
|
||||||
|
stroke: var(--text-2);
|
||||||
|
stroke-width: 1;
|
||||||
|
stroke-dasharray: 3 3;
|
||||||
|
pointer-events: none;
|
||||||
|
}
|
||||||
|
|
||||||
|
.delta-graph-hover-layer {
|
||||||
|
cursor: crosshair;
|
||||||
|
touch-action: none;
|
||||||
|
}
|
||||||
|
|
||||||
|
.delta-graph-tooltip {
|
||||||
|
pointer-events: none;
|
||||||
|
}
|
||||||
|
|
||||||
|
.delta-graph-tooltip-bg {
|
||||||
|
fill: var(--bg-elevated, var(--bg));
|
||||||
|
stroke: var(--border);
|
||||||
|
stroke-width: 1;
|
||||||
|
}
|
||||||
|
|
||||||
|
.delta-graph-tooltip-title {
|
||||||
|
fill: var(--text-1);
|
||||||
|
font-family: var(--f-mono);
|
||||||
|
font-size: 10px;
|
||||||
|
font-weight: 600;
|
||||||
|
}
|
||||||
|
|
||||||
|
.delta-graph-tooltip-row {
|
||||||
|
fill: var(--text-2);
|
||||||
|
font-family: var(--f-mono);
|
||||||
|
font-size: 9px;
|
||||||
|
}
|
||||||
67
frontend/src/styles/event-rail.css
Normal file
67
frontend/src/styles/event-rail.css
Normal file
@@ -0,0 +1,67 @@
|
|||||||
|
/* ── "What just happened" event rail (live page) ── */
|
||||||
|
|
||||||
|
.event-rail {
|
||||||
|
margin-top: var(--s5);
|
||||||
|
}
|
||||||
|
|
||||||
|
.event-rail-list {
|
||||||
|
display: flex;
|
||||||
|
flex-direction: column;
|
||||||
|
gap: var(--s3);
|
||||||
|
padding-top: var(--s4);
|
||||||
|
}
|
||||||
|
|
||||||
|
.event-rail-row {
|
||||||
|
display: flex;
|
||||||
|
align-items: flex-start;
|
||||||
|
gap: var(--s4);
|
||||||
|
padding: var(--s3) var(--s4);
|
||||||
|
border-left: 3px solid var(--border-2);
|
||||||
|
background: rgba(255, 255, 255, 0.03);
|
||||||
|
border-radius: 0 4px 4px 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
.event-rail-icon {
|
||||||
|
display: inline-flex;
|
||||||
|
align-items: center;
|
||||||
|
color: var(--text-2);
|
||||||
|
padding-top: 1px;
|
||||||
|
flex-shrink: 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
.event-kind-fastest-lap .event-rail-icon { color: var(--purple); }
|
||||||
|
.event-kind-personal-best .event-rail-icon { color: var(--green); }
|
||||||
|
.event-kind-overtake .event-rail-icon,
|
||||||
|
.event-kind-position-gain .event-rail-icon { color: var(--green); }
|
||||||
|
.event-kind-position-loss .event-rail-icon { color: var(--yellow); }
|
||||||
|
.event-kind-retirement .event-rail-icon,
|
||||||
|
.event-kind-track-status .event-rail-icon { color: var(--red); }
|
||||||
|
.event-kind-pit-in .event-rail-icon,
|
||||||
|
.event-kind-pit-out .event-rail-icon { color: var(--blue); }
|
||||||
|
|
||||||
|
.event-rail-body {
|
||||||
|
display: flex;
|
||||||
|
flex-direction: column;
|
||||||
|
gap: var(--s1);
|
||||||
|
min-width: 0;
|
||||||
|
flex: 1;
|
||||||
|
}
|
||||||
|
|
||||||
|
.event-rail-headline {
|
||||||
|
font-size: 12px;
|
||||||
|
color: var(--text);
|
||||||
|
line-height: 1.4;
|
||||||
|
}
|
||||||
|
|
||||||
|
.event-rail-detail {
|
||||||
|
font-size: 11px;
|
||||||
|
color: var(--text-2);
|
||||||
|
}
|
||||||
|
|
||||||
|
.event-rail-lap {
|
||||||
|
font-family: var(--f-mono);
|
||||||
|
font-size: 10px;
|
||||||
|
color: var(--text-3);
|
||||||
|
flex-shrink: 0;
|
||||||
|
padding-top: 2px;
|
||||||
|
}
|
||||||
373
frontend/src/styles/hero.css
Normal file
373
frontend/src/styles/hero.css
Normal file
@@ -0,0 +1,373 @@
|
|||||||
|
.hero-panel {
|
||||||
|
display: flex;
|
||||||
|
flex-direction: column;
|
||||||
|
gap: var(--s4);
|
||||||
|
}
|
||||||
|
|
||||||
|
.hero-card {
|
||||||
|
display: flex;
|
||||||
|
background: var(--surface);
|
||||||
|
border: 1px solid rgba(255, 255, 255, 0.08);
|
||||||
|
border-radius: 8px;
|
||||||
|
overflow: hidden;
|
||||||
|
min-height: 124px;
|
||||||
|
}
|
||||||
|
|
||||||
|
.hero-accent {
|
||||||
|
width: 4px;
|
||||||
|
flex-shrink: 0;
|
||||||
|
box-shadow: 0 0 12px var(--hero-accent, var(--gp-accent));
|
||||||
|
background: var(--hero-accent, var(--gp-accent));
|
||||||
|
}
|
||||||
|
|
||||||
|
.hero-accent--live {
|
||||||
|
animation: hero-pulse 1.4s ease-in-out infinite;
|
||||||
|
}
|
||||||
|
|
||||||
|
@keyframes hero-pulse {
|
||||||
|
0%, 100% { opacity: 1; }
|
||||||
|
50% { opacity: 0.55; }
|
||||||
|
}
|
||||||
|
|
||||||
|
.hero-body {
|
||||||
|
flex: 1;
|
||||||
|
padding: var(--s5);
|
||||||
|
min-width: 0;
|
||||||
|
position: relative;
|
||||||
|
overflow: hidden;
|
||||||
|
background:
|
||||||
|
radial-gradient(ellipse at top right, color-mix(in srgb, var(--gp-accent) 15%, transparent), transparent 60%),
|
||||||
|
linear-gradient(to right, rgba(255, 255, 255, 0.03) 1px, transparent 1px),
|
||||||
|
linear-gradient(to bottom, rgba(255, 255, 255, 0.03) 1px, transparent 1px),
|
||||||
|
var(--surface);
|
||||||
|
background-size: 100% 100%, 20px 20px, 20px 20px, 100% 100%;
|
||||||
|
}
|
||||||
|
|
||||||
|
.hero-body::after {
|
||||||
|
content: "";
|
||||||
|
position: absolute;
|
||||||
|
inset: 0;
|
||||||
|
background: linear-gradient(90deg, transparent 0%, rgba(0, 0, 0, 0.3) 100%);
|
||||||
|
pointer-events: none;
|
||||||
|
}
|
||||||
|
|
||||||
|
.hero-inner {
|
||||||
|
position: relative;
|
||||||
|
z-index: 1;
|
||||||
|
display: flex;
|
||||||
|
flex-direction: column;
|
||||||
|
gap: var(--s5);
|
||||||
|
}
|
||||||
|
|
||||||
|
.hero-row {
|
||||||
|
display: flex;
|
||||||
|
align-items: stretch;
|
||||||
|
gap: var(--s6);
|
||||||
|
min-width: 0;
|
||||||
|
flex-wrap: wrap;
|
||||||
|
}
|
||||||
|
|
||||||
|
.hero-identity {
|
||||||
|
flex: 1;
|
||||||
|
min-width: 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
.hero-decal {
|
||||||
|
font-size: 56px;
|
||||||
|
font-weight: 800;
|
||||||
|
line-height: 0.85;
|
||||||
|
letter-spacing: -0.04em;
|
||||||
|
color: color-mix(in srgb, var(--gp-accent) 35%, var(--text-3));
|
||||||
|
opacity: 0.9;
|
||||||
|
flex-shrink: 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
.hero-eyebrow {
|
||||||
|
font-size: 10px;
|
||||||
|
font-weight: 700;
|
||||||
|
letter-spacing: 0.14em;
|
||||||
|
text-transform: uppercase;
|
||||||
|
color: var(--text-3);
|
||||||
|
margin-bottom: var(--s2);
|
||||||
|
}
|
||||||
|
|
||||||
|
.hero-eyebrow--live {
|
||||||
|
color: var(--red);
|
||||||
|
}
|
||||||
|
|
||||||
|
.hero-title {
|
||||||
|
font-size: 28px;
|
||||||
|
font-weight: 800;
|
||||||
|
letter-spacing: -0.02em;
|
||||||
|
line-height: 1.1;
|
||||||
|
margin: 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
.hero-sub {
|
||||||
|
font-size: 12px;
|
||||||
|
color: var(--text-2);
|
||||||
|
margin-top: var(--s2);
|
||||||
|
}
|
||||||
|
|
||||||
|
.hero-countdown {
|
||||||
|
text-align: right;
|
||||||
|
flex-shrink: 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
.hero-cd-label {
|
||||||
|
font-size: 10px;
|
||||||
|
font-weight: 700;
|
||||||
|
letter-spacing: 0.12em;
|
||||||
|
text-transform: uppercase;
|
||||||
|
color: var(--text-3);
|
||||||
|
margin-bottom: var(--s2);
|
||||||
|
}
|
||||||
|
|
||||||
|
.hero-cd-value {
|
||||||
|
font-size: 22px;
|
||||||
|
font-weight: 700;
|
||||||
|
font-variant-numeric: tabular-nums;
|
||||||
|
color: var(--text);
|
||||||
|
}
|
||||||
|
|
||||||
|
.hero-cd-value--live {
|
||||||
|
color: var(--red);
|
||||||
|
font-size: 28px;
|
||||||
|
letter-spacing: 0.08em;
|
||||||
|
}
|
||||||
|
|
||||||
|
.hero-cd-sub {
|
||||||
|
font-size: 11px;
|
||||||
|
color: var(--text-3);
|
||||||
|
margin-top: var(--s2);
|
||||||
|
}
|
||||||
|
|
||||||
|
.hero-track-status {
|
||||||
|
display: inline-flex;
|
||||||
|
align-items: center;
|
||||||
|
gap: var(--s3);
|
||||||
|
font-size: 10px;
|
||||||
|
font-weight: 700;
|
||||||
|
letter-spacing: 0.12em;
|
||||||
|
text-transform: uppercase;
|
||||||
|
padding: var(--s2) var(--s3);
|
||||||
|
border-radius: 4px;
|
||||||
|
margin-top: var(--s3);
|
||||||
|
}
|
||||||
|
|
||||||
|
.hero-track-status--green { color: #3dd68c; background: rgba(61, 214, 140, 0.1); }
|
||||||
|
.hero-track-status--yellow { color: #f5c842; background: rgba(245, 200, 66, 0.1); }
|
||||||
|
.hero-track-status--sc,
|
||||||
|
.hero-track-status--vsc { color: #f5a623; background: rgba(245, 166, 35, 0.12); }
|
||||||
|
.hero-track-status--red { color: var(--red); background: rgba(225, 6, 0, 0.12); }
|
||||||
|
.hero-track-status--unknown { color: var(--text-3); background: rgba(255, 255, 255, 0.05); }
|
||||||
|
|
||||||
|
.hero-timing {
|
||||||
|
display: flex;
|
||||||
|
flex-direction: column;
|
||||||
|
gap: var(--s2);
|
||||||
|
min-width: 200px;
|
||||||
|
}
|
||||||
|
|
||||||
|
.hero-timing-row {
|
||||||
|
display: grid;
|
||||||
|
grid-template-columns: 28px 1fr auto;
|
||||||
|
align-items: center;
|
||||||
|
gap: var(--s3);
|
||||||
|
padding: var(--s2) var(--s3);
|
||||||
|
background: rgba(255, 255, 255, 0.03);
|
||||||
|
border-radius: 6px;
|
||||||
|
font-size: 13px;
|
||||||
|
}
|
||||||
|
|
||||||
|
.hero-timing-pos {
|
||||||
|
font-weight: 700;
|
||||||
|
color: var(--text-3);
|
||||||
|
font-variant-numeric: tabular-nums;
|
||||||
|
}
|
||||||
|
|
||||||
|
.hero-timing-pos--p1 { color: #ffd700; }
|
||||||
|
.hero-timing-pos--p2 { color: #c0c0c0; }
|
||||||
|
.hero-timing-pos--p3 { color: #cd7f32; }
|
||||||
|
|
||||||
|
.hero-timing-bar {
|
||||||
|
width: 3px;
|
||||||
|
height: 14px;
|
||||||
|
border-radius: 2px;
|
||||||
|
flex-shrink: 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
.hero-timing-driver {
|
||||||
|
display: flex;
|
||||||
|
align-items: center;
|
||||||
|
gap: var(--s3);
|
||||||
|
font-weight: 600;
|
||||||
|
font-family: var(--f-mono);
|
||||||
|
}
|
||||||
|
|
||||||
|
.hero-timing-gap {
|
||||||
|
font-size: 11px;
|
||||||
|
color: var(--text-3);
|
||||||
|
font-family: var(--f-mono);
|
||||||
|
font-variant-numeric: tabular-nums;
|
||||||
|
}
|
||||||
|
|
||||||
|
.hero-cta {
|
||||||
|
display: inline-flex;
|
||||||
|
align-items: center;
|
||||||
|
gap: var(--s3);
|
||||||
|
font-size: 14px;
|
||||||
|
font-weight: 700;
|
||||||
|
color: var(--red);
|
||||||
|
text-decoration: none;
|
||||||
|
transition: opacity 0.1s;
|
||||||
|
}
|
||||||
|
|
||||||
|
.hero-cta:hover {
|
||||||
|
opacity: 0.85;
|
||||||
|
}
|
||||||
|
|
||||||
|
.hero-cta--primary {
|
||||||
|
padding: var(--s3) var(--s5);
|
||||||
|
background: rgba(225, 6, 0, 0.12);
|
||||||
|
border: 1px solid rgba(225, 6, 0, 0.35);
|
||||||
|
border-radius: 6px;
|
||||||
|
}
|
||||||
|
|
||||||
|
.hero-actions {
|
||||||
|
display: flex;
|
||||||
|
flex-wrap: wrap;
|
||||||
|
gap: var(--s3);
|
||||||
|
align-items: center;
|
||||||
|
}
|
||||||
|
|
||||||
|
.hero-secondary-link {
|
||||||
|
font-size: 12px;
|
||||||
|
font-weight: 600;
|
||||||
|
color: var(--text-2);
|
||||||
|
text-decoration: none;
|
||||||
|
}
|
||||||
|
|
||||||
|
.hero-secondary-link:hover {
|
||||||
|
color: var(--text);
|
||||||
|
}
|
||||||
|
|
||||||
|
.hero-schedule-strip {
|
||||||
|
display: flex;
|
||||||
|
gap: var(--s3);
|
||||||
|
overflow-x: auto;
|
||||||
|
padding-bottom: var(--s2);
|
||||||
|
}
|
||||||
|
|
||||||
|
.hero-schedule-card {
|
||||||
|
flex: 0 0 auto;
|
||||||
|
min-width: 120px;
|
||||||
|
padding: var(--s3) var(--s4);
|
||||||
|
border-radius: 6px;
|
||||||
|
border: 1px solid rgba(255, 255, 255, 0.06);
|
||||||
|
background: rgba(255, 255, 255, 0.02);
|
||||||
|
text-decoration: none;
|
||||||
|
color: inherit;
|
||||||
|
transition: background 0.1s, border-color 0.1s;
|
||||||
|
}
|
||||||
|
|
||||||
|
.hero-schedule-card:hover {
|
||||||
|
background: rgba(255, 255, 255, 0.05);
|
||||||
|
}
|
||||||
|
|
||||||
|
.hero-schedule-card.is-next {
|
||||||
|
border-color: color-mix(in srgb, var(--gp-accent) 50%, transparent);
|
||||||
|
background: color-mix(in srgb, var(--gp-accent) 8%, transparent);
|
||||||
|
}
|
||||||
|
|
||||||
|
.hero-schedule-card.is-done {
|
||||||
|
opacity: 0.55;
|
||||||
|
}
|
||||||
|
|
||||||
|
.hero-schedule-card.is-live {
|
||||||
|
border-color: rgba(225, 6, 0, 0.4);
|
||||||
|
background: rgba(225, 6, 0, 0.08);
|
||||||
|
}
|
||||||
|
|
||||||
|
.hero-schedule-abbrev {
|
||||||
|
font-size: 10px;
|
||||||
|
font-weight: 700;
|
||||||
|
letter-spacing: 0.1em;
|
||||||
|
color: var(--text-3);
|
||||||
|
}
|
||||||
|
|
||||||
|
.hero-schedule-name {
|
||||||
|
font-size: 12px;
|
||||||
|
font-weight: 600;
|
||||||
|
margin: var(--s2) 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
.hero-schedule-time {
|
||||||
|
font-size: 10px;
|
||||||
|
color: var(--text-3);
|
||||||
|
}
|
||||||
|
|
||||||
|
.hero-schedule-marker {
|
||||||
|
font-size: 9px;
|
||||||
|
font-weight: 700;
|
||||||
|
letter-spacing: 0.1em;
|
||||||
|
text-transform: uppercase;
|
||||||
|
margin-top: var(--s2);
|
||||||
|
color: var(--text-3);
|
||||||
|
}
|
||||||
|
|
||||||
|
.hero-schedule-marker--next { color: var(--gp-accent); }
|
||||||
|
.hero-schedule-marker--live { color: var(--red); }
|
||||||
|
|
||||||
|
.hero-podium {
|
||||||
|
display: flex;
|
||||||
|
flex-direction: column;
|
||||||
|
gap: var(--s2);
|
||||||
|
min-width: 200px;
|
||||||
|
}
|
||||||
|
|
||||||
|
.hero-podium-row {
|
||||||
|
display: grid;
|
||||||
|
grid-template-columns: 32px 1fr;
|
||||||
|
align-items: center;
|
||||||
|
gap: var(--s3);
|
||||||
|
padding: var(--s2) var(--s3);
|
||||||
|
background: rgba(255, 255, 255, 0.03);
|
||||||
|
border-radius: 6px;
|
||||||
|
font-size: 13px;
|
||||||
|
}
|
||||||
|
|
||||||
|
.hero-podium-pos {
|
||||||
|
font-weight: 700;
|
||||||
|
font-family: var(--f-mono);
|
||||||
|
color: var(--text-3);
|
||||||
|
}
|
||||||
|
|
||||||
|
.hero-podium-pos--p1 { color: #ffd700; }
|
||||||
|
.hero-podium-pos--p2 { color: #c0c0c0; }
|
||||||
|
.hero-podium-pos--p3 { color: #cd7f32; }
|
||||||
|
|
||||||
|
.hero-podium-driver {
|
||||||
|
display: flex;
|
||||||
|
align-items: center;
|
||||||
|
gap: var(--s3);
|
||||||
|
font-weight: 600;
|
||||||
|
font-family: var(--f-mono);
|
||||||
|
}
|
||||||
|
|
||||||
|
.hero-between-next {
|
||||||
|
display: flex;
|
||||||
|
align-items: center;
|
||||||
|
gap: var(--s4);
|
||||||
|
}
|
||||||
|
|
||||||
|
.hero-flag {
|
||||||
|
font-size: 32px;
|
||||||
|
line-height: 1;
|
||||||
|
}
|
||||||
|
|
||||||
|
@media (min-width: 700px) {
|
||||||
|
.hero-row {
|
||||||
|
flex-wrap: nowrap;
|
||||||
|
}
|
||||||
|
}
|
||||||
48
frontend/src/styles/meaning.css
Normal file
48
frontend/src/styles/meaning.css
Normal file
@@ -0,0 +1,48 @@
|
|||||||
|
/* Compact value + muted meaning caption (issue #18). */
|
||||||
|
|
||||||
|
.meaning {
|
||||||
|
display: inline-flex;
|
||||||
|
flex-direction: column;
|
||||||
|
align-items: inherit;
|
||||||
|
gap: 1px;
|
||||||
|
line-height: 1.2;
|
||||||
|
}
|
||||||
|
|
||||||
|
.meaning-value {
|
||||||
|
/* inherits table cell mono styling from parent */
|
||||||
|
}
|
||||||
|
|
||||||
|
.meaning-caption {
|
||||||
|
font-size: 10px;
|
||||||
|
font-family: var(--f-mono);
|
||||||
|
color: var(--text-3);
|
||||||
|
letter-spacing: 0.02em;
|
||||||
|
white-space: nowrap;
|
||||||
|
}
|
||||||
|
|
||||||
|
.meaning-caption--good {
|
||||||
|
color: var(--green);
|
||||||
|
}
|
||||||
|
|
||||||
|
.meaning-caption--bad {
|
||||||
|
color: var(--red);
|
||||||
|
}
|
||||||
|
|
||||||
|
.meaning-caption--warn {
|
||||||
|
color: var(--yellow, #e8c547);
|
||||||
|
}
|
||||||
|
|
||||||
|
.meaning-caption--neutral {
|
||||||
|
color: var(--text-3);
|
||||||
|
}
|
||||||
|
|
||||||
|
/* Table cells: right-align caption under numeric values */
|
||||||
|
td.r .meaning,
|
||||||
|
.champ-td-dim .meaning,
|
||||||
|
.champ-td-muted .meaning {
|
||||||
|
align-items: flex-end;
|
||||||
|
}
|
||||||
|
|
||||||
|
.tyredeg-row .meaning {
|
||||||
|
align-items: flex-start;
|
||||||
|
}
|
||||||
309
frontend/src/styles/preview.css
Normal file
309
frontend/src/styles/preview.css
Normal file
@@ -0,0 +1,309 @@
|
|||||||
|
.preview-page {
|
||||||
|
display: flex;
|
||||||
|
flex-direction: column;
|
||||||
|
gap: var(--s6);
|
||||||
|
padding: var(--s6);
|
||||||
|
max-width: 1200px;
|
||||||
|
margin: 0 auto;
|
||||||
|
}
|
||||||
|
|
||||||
|
.preview-empty {
|
||||||
|
display: flex;
|
||||||
|
flex-direction: column;
|
||||||
|
align-items: center;
|
||||||
|
justify-content: center;
|
||||||
|
gap: var(--s4);
|
||||||
|
min-height: 320px;
|
||||||
|
text-align: center;
|
||||||
|
padding: var(--s8);
|
||||||
|
background: var(--surface);
|
||||||
|
border: 1px solid rgba(255, 255, 255, 0.08);
|
||||||
|
border-radius: 8px;
|
||||||
|
}
|
||||||
|
|
||||||
|
.preview-empty-eyebrow {
|
||||||
|
font-size: 0.7rem;
|
||||||
|
letter-spacing: 0.12em;
|
||||||
|
text-transform: uppercase;
|
||||||
|
color: var(--text-3);
|
||||||
|
}
|
||||||
|
|
||||||
|
.preview-empty-title {
|
||||||
|
font-size: 1.5rem;
|
||||||
|
font-weight: 600;
|
||||||
|
margin: 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
.preview-empty-sub {
|
||||||
|
color: var(--text-2);
|
||||||
|
max-width: 36rem;
|
||||||
|
margin: 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
.preview-header {
|
||||||
|
display: flex;
|
||||||
|
background: var(--surface);
|
||||||
|
border: 1px solid rgba(255, 255, 255, 0.08);
|
||||||
|
border-radius: 8px;
|
||||||
|
overflow: hidden;
|
||||||
|
min-height: 140px;
|
||||||
|
}
|
||||||
|
|
||||||
|
.preview-header-accent {
|
||||||
|
width: 4px;
|
||||||
|
flex-shrink: 0;
|
||||||
|
background: var(--preview-accent, var(--gp-accent));
|
||||||
|
box-shadow: 0 0 12px var(--preview-accent, var(--gp-accent));
|
||||||
|
}
|
||||||
|
|
||||||
|
.preview-header-body {
|
||||||
|
flex: 1;
|
||||||
|
padding: var(--s5);
|
||||||
|
display: flex;
|
||||||
|
flex-direction: column;
|
||||||
|
gap: var(--s4);
|
||||||
|
min-width: 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
.preview-header-top {
|
||||||
|
display: flex;
|
||||||
|
flex-wrap: wrap;
|
||||||
|
align-items: flex-start;
|
||||||
|
justify-content: space-between;
|
||||||
|
gap: var(--s4);
|
||||||
|
}
|
||||||
|
|
||||||
|
.preview-gp-name {
|
||||||
|
font-size: 1.4rem;
|
||||||
|
font-weight: 600;
|
||||||
|
margin: 0;
|
||||||
|
display: flex;
|
||||||
|
align-items: center;
|
||||||
|
gap: var(--s3);
|
||||||
|
}
|
||||||
|
|
||||||
|
.preview-gp-flag {
|
||||||
|
font-size: 1.5rem;
|
||||||
|
line-height: 1;
|
||||||
|
}
|
||||||
|
|
||||||
|
.preview-circuit {
|
||||||
|
color: var(--text-2);
|
||||||
|
font-size: 0.9rem;
|
||||||
|
margin: 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
.preview-countdown {
|
||||||
|
text-align: right;
|
||||||
|
}
|
||||||
|
|
||||||
|
.preview-countdown-label {
|
||||||
|
display: block;
|
||||||
|
font-size: 0.7rem;
|
||||||
|
letter-spacing: 0.08em;
|
||||||
|
text-transform: uppercase;
|
||||||
|
color: var(--text-3);
|
||||||
|
margin-bottom: var(--s1);
|
||||||
|
}
|
||||||
|
|
||||||
|
.preview-countdown-value {
|
||||||
|
font-family: var(--mono);
|
||||||
|
font-size: 1.1rem;
|
||||||
|
font-variant-numeric: tabular-nums;
|
||||||
|
color: var(--text-1);
|
||||||
|
}
|
||||||
|
|
||||||
|
.preview-schedule {
|
||||||
|
display: grid;
|
||||||
|
grid-template-columns: repeat(auto-fill, minmax(160px, 1fr));
|
||||||
|
gap: var(--s2);
|
||||||
|
}
|
||||||
|
|
||||||
|
.preview-schedule-item {
|
||||||
|
display: flex;
|
||||||
|
flex-direction: column;
|
||||||
|
gap: 2px;
|
||||||
|
padding: var(--s2) var(--s3);
|
||||||
|
background: rgba(255, 255, 255, 0.03);
|
||||||
|
border-radius: 4px;
|
||||||
|
font-size: 0.8rem;
|
||||||
|
}
|
||||||
|
|
||||||
|
.preview-schedule-name {
|
||||||
|
font-weight: 600;
|
||||||
|
color: var(--text-1);
|
||||||
|
}
|
||||||
|
|
||||||
|
.preview-schedule-time {
|
||||||
|
font-family: var(--mono);
|
||||||
|
font-size: 0.75rem;
|
||||||
|
color: var(--text-2);
|
||||||
|
}
|
||||||
|
|
||||||
|
.preview-grid {
|
||||||
|
display: grid;
|
||||||
|
grid-template-columns: repeat(auto-fit, minmax(280px, 1fr));
|
||||||
|
gap: var(--s5);
|
||||||
|
}
|
||||||
|
|
||||||
|
.preview-card {
|
||||||
|
background: var(--surface);
|
||||||
|
border: 1px solid rgba(255, 255, 255, 0.08);
|
||||||
|
border-radius: 8px;
|
||||||
|
padding: var(--s5);
|
||||||
|
display: flex;
|
||||||
|
flex-direction: column;
|
||||||
|
gap: var(--s4);
|
||||||
|
min-height: 200px;
|
||||||
|
}
|
||||||
|
|
||||||
|
.preview-card-title {
|
||||||
|
font-size: 0.75rem;
|
||||||
|
letter-spacing: 0.1em;
|
||||||
|
text-transform: uppercase;
|
||||||
|
color: var(--text-3);
|
||||||
|
margin: 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
.preview-card-sub {
|
||||||
|
font-size: 0.85rem;
|
||||||
|
color: var(--text-2);
|
||||||
|
margin: calc(-1 * var(--s2)) 0 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
.preview-track-stage {
|
||||||
|
display: flex;
|
||||||
|
align-items: center;
|
||||||
|
justify-content: center;
|
||||||
|
flex: 1;
|
||||||
|
min-height: 180px;
|
||||||
|
padding: var(--s4);
|
||||||
|
}
|
||||||
|
|
||||||
|
.preview-track-svg {
|
||||||
|
width: 100%;
|
||||||
|
max-width: 280px;
|
||||||
|
height: auto;
|
||||||
|
}
|
||||||
|
|
||||||
|
.preview-track-outline {
|
||||||
|
fill: none;
|
||||||
|
stroke: var(--preview-accent, var(--gp-accent));
|
||||||
|
stroke-width: 1.8;
|
||||||
|
stroke-linecap: round;
|
||||||
|
stroke-linejoin: round;
|
||||||
|
opacity: 0.9;
|
||||||
|
}
|
||||||
|
|
||||||
|
.preview-track-shadow {
|
||||||
|
fill: none;
|
||||||
|
stroke: rgba(0, 0, 0, 0.5);
|
||||||
|
stroke-width: 3;
|
||||||
|
stroke-linecap: round;
|
||||||
|
stroke-linejoin: round;
|
||||||
|
}
|
||||||
|
|
||||||
|
.preview-podium {
|
||||||
|
display: flex;
|
||||||
|
flex-direction: column;
|
||||||
|
gap: var(--s3);
|
||||||
|
}
|
||||||
|
|
||||||
|
.preview-podium-row {
|
||||||
|
display: flex;
|
||||||
|
align-items: center;
|
||||||
|
gap: var(--s3);
|
||||||
|
font-size: 0.9rem;
|
||||||
|
}
|
||||||
|
|
||||||
|
.preview-podium-pos {
|
||||||
|
width: 1.5rem;
|
||||||
|
font-family: var(--mono);
|
||||||
|
font-weight: 600;
|
||||||
|
color: var(--text-3);
|
||||||
|
}
|
||||||
|
|
||||||
|
.preview-podium-code {
|
||||||
|
font-weight: 600;
|
||||||
|
min-width: 2.5rem;
|
||||||
|
}
|
||||||
|
|
||||||
|
.preview-podium-team {
|
||||||
|
color: var(--text-2);
|
||||||
|
font-size: 0.8rem;
|
||||||
|
}
|
||||||
|
|
||||||
|
.preview-pole {
|
||||||
|
padding-top: var(--s3);
|
||||||
|
border-top: 1px solid rgba(255, 255, 255, 0.06);
|
||||||
|
font-size: 0.85rem;
|
||||||
|
color: var(--text-2);
|
||||||
|
}
|
||||||
|
|
||||||
|
.preview-pole strong {
|
||||||
|
color: var(--text-1);
|
||||||
|
}
|
||||||
|
|
||||||
|
.preview-title-table {
|
||||||
|
width: 100%;
|
||||||
|
border-collapse: collapse;
|
||||||
|
font-size: 0.85rem;
|
||||||
|
}
|
||||||
|
|
||||||
|
.preview-title-table th,
|
||||||
|
.preview-title-table td {
|
||||||
|
padding: var(--s2) var(--s3);
|
||||||
|
text-align: left;
|
||||||
|
border-bottom: 1px solid rgba(255, 255, 255, 0.05);
|
||||||
|
}
|
||||||
|
|
||||||
|
.preview-title-table th {
|
||||||
|
font-size: 0.7rem;
|
||||||
|
letter-spacing: 0.06em;
|
||||||
|
text-transform: uppercase;
|
||||||
|
color: var(--text-3);
|
||||||
|
font-weight: 500;
|
||||||
|
}
|
||||||
|
|
||||||
|
.preview-title-table td.mono {
|
||||||
|
font-family: var(--mono);
|
||||||
|
font-variant-numeric: tabular-nums;
|
||||||
|
}
|
||||||
|
|
||||||
|
.preview-sprint-note {
|
||||||
|
font-size: 0.8rem;
|
||||||
|
color: var(--text-2);
|
||||||
|
margin: 0;
|
||||||
|
padding: var(--s3);
|
||||||
|
background: rgba(255, 255, 255, 0.03);
|
||||||
|
border-radius: 4px;
|
||||||
|
}
|
||||||
|
|
||||||
|
.preview-section-state {
|
||||||
|
flex: 1;
|
||||||
|
display: flex;
|
||||||
|
align-items: center;
|
||||||
|
justify-content: center;
|
||||||
|
color: var(--text-3);
|
||||||
|
font-size: 0.85rem;
|
||||||
|
text-align: center;
|
||||||
|
padding: var(--s5);
|
||||||
|
}
|
||||||
|
|
||||||
|
.preview-section-state.error {
|
||||||
|
color: var(--red, #e74c3c);
|
||||||
|
}
|
||||||
|
|
||||||
|
@media (max-width: 640px) {
|
||||||
|
.preview-page {
|
||||||
|
padding: var(--s4);
|
||||||
|
}
|
||||||
|
|
||||||
|
.preview-header-top {
|
||||||
|
flex-direction: column;
|
||||||
|
}
|
||||||
|
|
||||||
|
.preview-countdown {
|
||||||
|
text-align: left;
|
||||||
|
}
|
||||||
|
}
|
||||||
101
frontend/src/styles/stint-timeline.css
Normal file
101
frontend/src/styles/stint-timeline.css
Normal file
@@ -0,0 +1,101 @@
|
|||||||
|
.stint-timeline {
|
||||||
|
--stint-left: 48px;
|
||||||
|
--stint-right: 12px;
|
||||||
|
--stint-row-h: 28px;
|
||||||
|
--stint-bar-h: 14px;
|
||||||
|
--stint-axis-h: 20px;
|
||||||
|
}
|
||||||
|
|
||||||
|
.stint-timeline__scroll {
|
||||||
|
overflow-x: auto;
|
||||||
|
}
|
||||||
|
|
||||||
|
.stint-timeline__svg {
|
||||||
|
width: 100%;
|
||||||
|
min-width: 280px;
|
||||||
|
max-width: 640px;
|
||||||
|
display: block;
|
||||||
|
}
|
||||||
|
|
||||||
|
.stint-timeline__label {
|
||||||
|
font-family: var(--f-mono);
|
||||||
|
font-weight: 700;
|
||||||
|
font-size: 10px;
|
||||||
|
}
|
||||||
|
|
||||||
|
.stint-timeline__bar {
|
||||||
|
stroke: none;
|
||||||
|
}
|
||||||
|
|
||||||
|
.stint-timeline__bar.tyre-soft { fill: var(--tyre-soft); }
|
||||||
|
.stint-timeline__bar.tyre-medium { fill: var(--tyre-medium); }
|
||||||
|
.stint-timeline__bar.tyre-hard { fill: var(--tyre-hard); stroke: #555; stroke-width: 0.5; }
|
||||||
|
.stint-timeline__bar.tyre-inter { fill: var(--tyre-inter); }
|
||||||
|
.stint-timeline__bar.tyre-wet { fill: var(--tyre-wet); }
|
||||||
|
.stint-timeline__bar.tyre-unknown { fill: var(--surface-2); stroke: var(--border-2); stroke-width: 0.5; }
|
||||||
|
|
||||||
|
.stint-timeline__bar--new {
|
||||||
|
stroke: var(--text);
|
||||||
|
stroke-width: 1;
|
||||||
|
stroke-dasharray: 2 1;
|
||||||
|
}
|
||||||
|
|
||||||
|
.stint-timeline__pit-marker {
|
||||||
|
stroke: var(--text);
|
||||||
|
stroke-width: 1.5;
|
||||||
|
opacity: 0.7;
|
||||||
|
pointer-events: stroke;
|
||||||
|
}
|
||||||
|
|
||||||
|
.stint-timeline__axis-tick {
|
||||||
|
font-family: var(--f-mono);
|
||||||
|
font-size: 9px;
|
||||||
|
fill: var(--text-3);
|
||||||
|
}
|
||||||
|
|
||||||
|
.stint-timeline__axis-line {
|
||||||
|
stroke: var(--border-2);
|
||||||
|
stroke-width: 1;
|
||||||
|
}
|
||||||
|
|
||||||
|
.stint-timeline__legend {
|
||||||
|
display: flex;
|
||||||
|
gap: var(--s4);
|
||||||
|
flex-wrap: wrap;
|
||||||
|
margin-top: var(--s4);
|
||||||
|
font-size: 11px;
|
||||||
|
color: var(--text-3);
|
||||||
|
align-items: center;
|
||||||
|
}
|
||||||
|
|
||||||
|
.stint-timeline__legend-swatch {
|
||||||
|
width: 10px;
|
||||||
|
height: 10px;
|
||||||
|
border-radius: 2px;
|
||||||
|
display: inline-block;
|
||||||
|
}
|
||||||
|
|
||||||
|
.stint-timeline__legend-swatch.tyre-hard {
|
||||||
|
border: 1px solid #555;
|
||||||
|
}
|
||||||
|
|
||||||
|
.stint-timeline__legend-item {
|
||||||
|
display: inline-flex;
|
||||||
|
align-items: center;
|
||||||
|
gap: 4px;
|
||||||
|
}
|
||||||
|
|
||||||
|
.stint-timeline__meta {
|
||||||
|
margin-left: auto;
|
||||||
|
font-family: var(--f-mono);
|
||||||
|
font-size: 10px;
|
||||||
|
}
|
||||||
|
|
||||||
|
.stint-timeline__empty {
|
||||||
|
padding: var(--s5);
|
||||||
|
color: var(--text-3);
|
||||||
|
font-size: 13px;
|
||||||
|
text-align: center;
|
||||||
|
border: 1px dashed var(--border-2);
|
||||||
|
border-radius: var(--r2);
|
||||||
|
}
|
||||||
82
frontend/src/styles/team-radio.css
Normal file
82
frontend/src/styles/team-radio.css
Normal file
@@ -0,0 +1,82 @@
|
|||||||
|
.team-radio {
|
||||||
|
display: flex;
|
||||||
|
flex-direction: column;
|
||||||
|
min-height: 0;
|
||||||
|
overflow: hidden;
|
||||||
|
}
|
||||||
|
|
||||||
|
.team-radio-audio {
|
||||||
|
display: none;
|
||||||
|
}
|
||||||
|
|
||||||
|
.team-radio-list {
|
||||||
|
display: flex;
|
||||||
|
flex-direction: column;
|
||||||
|
gap: 6px;
|
||||||
|
max-height: 260px;
|
||||||
|
overflow-y: auto;
|
||||||
|
padding-right: 2px;
|
||||||
|
}
|
||||||
|
|
||||||
|
.team-radio-row {
|
||||||
|
display: grid;
|
||||||
|
grid-template-columns: 28px minmax(44px, 56px) minmax(68px, 1fr);
|
||||||
|
align-items: center;
|
||||||
|
gap: 8px;
|
||||||
|
min-height: 34px;
|
||||||
|
padding: 6px 0;
|
||||||
|
border-bottom: 1px solid rgba(255, 255, 255, 0.08);
|
||||||
|
}
|
||||||
|
|
||||||
|
.team-radio-row:last-child {
|
||||||
|
border-bottom: 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
.team-radio-play {
|
||||||
|
display: inline-flex;
|
||||||
|
align-items: center;
|
||||||
|
justify-content: center;
|
||||||
|
width: 28px;
|
||||||
|
height: 28px;
|
||||||
|
padding: 0;
|
||||||
|
border: 1px solid rgba(255, 255, 255, 0.18);
|
||||||
|
border-radius: 50%;
|
||||||
|
color: var(--text-1);
|
||||||
|
background: rgba(255, 255, 255, 0.06);
|
||||||
|
cursor: pointer;
|
||||||
|
}
|
||||||
|
|
||||||
|
.team-radio-play:hover:not(:disabled),
|
||||||
|
.team-radio-play:focus-visible:not(:disabled) {
|
||||||
|
border-color: rgba(255, 255, 255, 0.36);
|
||||||
|
background: rgba(255, 255, 255, 0.12);
|
||||||
|
}
|
||||||
|
|
||||||
|
.team-radio-play:disabled {
|
||||||
|
color: var(--text-3);
|
||||||
|
cursor: not-allowed;
|
||||||
|
opacity: 0.55;
|
||||||
|
}
|
||||||
|
|
||||||
|
.team-radio-driver {
|
||||||
|
display: inline-flex;
|
||||||
|
align-items: center;
|
||||||
|
justify-content: center;
|
||||||
|
min-width: 44px;
|
||||||
|
height: 24px;
|
||||||
|
border-left: 3px solid var(--text-3);
|
||||||
|
color: var(--text-1);
|
||||||
|
font-family: var(--font-mono);
|
||||||
|
font-size: 12px;
|
||||||
|
font-weight: 700;
|
||||||
|
letter-spacing: 0;
|
||||||
|
}
|
||||||
|
|
||||||
|
.team-radio-time {
|
||||||
|
min-width: 0;
|
||||||
|
color: var(--text-2);
|
||||||
|
font-family: var(--font-mono);
|
||||||
|
font-size: 12px;
|
||||||
|
text-align: right;
|
||||||
|
white-space: nowrap;
|
||||||
|
}
|
||||||
101
frontend/src/styles/telemetry-trace.css
Normal file
101
frontend/src/styles/telemetry-trace.css
Normal file
@@ -0,0 +1,101 @@
|
|||||||
|
.telemetry-trace {
|
||||||
|
display: flex;
|
||||||
|
flex-direction: column;
|
||||||
|
gap: 8px;
|
||||||
|
}
|
||||||
|
|
||||||
|
.telemetry-trace-empty {
|
||||||
|
padding: 24px;
|
||||||
|
text-align: center;
|
||||||
|
color: var(--text-3);
|
||||||
|
font-size: 13px;
|
||||||
|
background: var(--surface);
|
||||||
|
border: 1px solid var(--border);
|
||||||
|
border-radius: 8px;
|
||||||
|
}
|
||||||
|
|
||||||
|
.telemetry-trace-legend {
|
||||||
|
display: flex;
|
||||||
|
flex-wrap: wrap;
|
||||||
|
gap: 14px;
|
||||||
|
font-size: 12px;
|
||||||
|
color: var(--text-2);
|
||||||
|
}
|
||||||
|
|
||||||
|
.telemetry-trace-legend-item {
|
||||||
|
display: inline-flex;
|
||||||
|
align-items: center;
|
||||||
|
gap: 6px;
|
||||||
|
}
|
||||||
|
|
||||||
|
.telemetry-trace-swatch {
|
||||||
|
display: inline-block;
|
||||||
|
width: 10px;
|
||||||
|
height: 10px;
|
||||||
|
border-radius: 2px;
|
||||||
|
flex: none;
|
||||||
|
}
|
||||||
|
|
||||||
|
.telemetry-trace-svg {
|
||||||
|
display: block;
|
||||||
|
width: 100%;
|
||||||
|
height: auto;
|
||||||
|
}
|
||||||
|
|
||||||
|
.telemetry-trace-panel-bg {
|
||||||
|
fill: var(--surface);
|
||||||
|
stroke: var(--border);
|
||||||
|
stroke-width: 1;
|
||||||
|
rx: 4;
|
||||||
|
}
|
||||||
|
|
||||||
|
.telemetry-trace-panel-title {
|
||||||
|
fill: var(--text-2);
|
||||||
|
font-size: 11px;
|
||||||
|
text-transform: uppercase;
|
||||||
|
letter-spacing: 0.06em;
|
||||||
|
}
|
||||||
|
|
||||||
|
.telemetry-trace-axis-max {
|
||||||
|
fill: var(--text-3);
|
||||||
|
font-size: 10px;
|
||||||
|
}
|
||||||
|
|
||||||
|
.telemetry-trace-crosshair {
|
||||||
|
stroke: var(--text-2);
|
||||||
|
stroke-width: 1;
|
||||||
|
stroke-dasharray: 3 3;
|
||||||
|
pointer-events: none;
|
||||||
|
}
|
||||||
|
|
||||||
|
.telemetry-trace-readout {
|
||||||
|
display: flex;
|
||||||
|
flex-wrap: wrap;
|
||||||
|
align-items: center;
|
||||||
|
gap: 12px;
|
||||||
|
padding: 6px 10px;
|
||||||
|
font-size: 12px;
|
||||||
|
color: var(--text-2);
|
||||||
|
background: var(--surface-h);
|
||||||
|
border: 1px solid var(--border);
|
||||||
|
border-radius: 6px;
|
||||||
|
}
|
||||||
|
|
||||||
|
.telemetry-trace-readout-index {
|
||||||
|
color: var(--text-3);
|
||||||
|
}
|
||||||
|
|
||||||
|
.telemetry-trace-readout-driver {
|
||||||
|
display: inline-flex;
|
||||||
|
align-items: center;
|
||||||
|
gap: 6px;
|
||||||
|
}
|
||||||
|
|
||||||
|
.telemetry-trace-readout-label {
|
||||||
|
color: var(--text);
|
||||||
|
font-weight: 600;
|
||||||
|
}
|
||||||
|
|
||||||
|
.telemetry-trace-readout-value {
|
||||||
|
font-variant-numeric: tabular-nums;
|
||||||
|
}
|
||||||
84
frontend/src/styles/tyredeg.css
Normal file
84
frontend/src/styles/tyredeg.css
Normal file
@@ -0,0 +1,84 @@
|
|||||||
|
/* Live tyre-degradation & pit-window panel (see components/live/TyreDegPanel.tsx) */
|
||||||
|
|
||||||
|
.live-tyredeg-panel {
|
||||||
|
margin-bottom: var(--s5);
|
||||||
|
}
|
||||||
|
|
||||||
|
.tyredeg-toggle {
|
||||||
|
width: 100%;
|
||||||
|
background: none;
|
||||||
|
border: none;
|
||||||
|
padding: 0;
|
||||||
|
cursor: pointer;
|
||||||
|
text-align: left;
|
||||||
|
}
|
||||||
|
|
||||||
|
.tyredeg-chevron {
|
||||||
|
margin-left: auto;
|
||||||
|
font-size: 10px;
|
||||||
|
color: var(--text-3);
|
||||||
|
}
|
||||||
|
|
||||||
|
.tyredeg-rows {
|
||||||
|
display: flex;
|
||||||
|
flex-direction: column;
|
||||||
|
gap: 3px;
|
||||||
|
}
|
||||||
|
|
||||||
|
.tyredeg-row {
|
||||||
|
display: flex;
|
||||||
|
align-items: center;
|
||||||
|
gap: var(--s4);
|
||||||
|
padding: var(--s2) var(--s4);
|
||||||
|
background: var(--surface);
|
||||||
|
border: 1px solid var(--border);
|
||||||
|
border-radius: 3px;
|
||||||
|
font-size: 12px;
|
||||||
|
}
|
||||||
|
|
||||||
|
.tyredeg-row .drv-bar { height: 16px; }
|
||||||
|
|
||||||
|
.tyredeg-pos {
|
||||||
|
min-width: 28px;
|
||||||
|
color: var(--text-2);
|
||||||
|
font-size: 11px;
|
||||||
|
}
|
||||||
|
|
||||||
|
.tyredeg-spark { display: block; }
|
||||||
|
.tyredeg-spark-empty { color: var(--text-3); }
|
||||||
|
|
||||||
|
.tyredeg-trend { display: inline-flex; align-items: center; }
|
||||||
|
.tyredeg-trend-improving { color: var(--green); }
|
||||||
|
.tyredeg-trend-stable { color: var(--text-3); }
|
||||||
|
.tyredeg-trend-degrading { color: #ff6b6b; }
|
||||||
|
|
||||||
|
.tyredeg-slope {
|
||||||
|
min-width: 78px;
|
||||||
|
font-size: 11px;
|
||||||
|
}
|
||||||
|
|
||||||
|
.tyredeg-warmup {
|
||||||
|
color: var(--text-3);
|
||||||
|
font-size: 11px;
|
||||||
|
font-style: italic;
|
||||||
|
}
|
||||||
|
|
||||||
|
.tyredeg-rejoin {
|
||||||
|
margin-left: auto;
|
||||||
|
display: inline-flex;
|
||||||
|
align-items: baseline;
|
||||||
|
gap: var(--s3);
|
||||||
|
color: var(--text-2);
|
||||||
|
font-size: 11px;
|
||||||
|
white-space: nowrap;
|
||||||
|
}
|
||||||
|
|
||||||
|
.tyredeg-rejoin-between {
|
||||||
|
color: var(--text-3);
|
||||||
|
font-size: 10px;
|
||||||
|
}
|
||||||
|
|
||||||
|
@media (max-width: 640px) {
|
||||||
|
.tyredeg-rejoin-between { display: none; }
|
||||||
|
.tyredeg-slope { min-width: 0; }
|
||||||
|
}
|
||||||
@@ -112,6 +112,7 @@ describe('ChampionshipPage', () => {
|
|||||||
expect(screen.getAllByText('VER').length).toBeGreaterThan(0)
|
expect(screen.getAllByText('VER').length).toBeGreaterThan(0)
|
||||||
expect(screen.getByText('Monaco GP', { exact: false })).toBeInTheDocument()
|
expect(screen.getByText('Monaco GP', { exact: false })).toBeInTheDocument()
|
||||||
expect(screen.getByTestId('champ-titlemath')).toHaveTextContent('mathematically win the title')
|
expect(screen.getByTestId('champ-titlemath')).toHaveTextContent('mathematically win the title')
|
||||||
|
expect(screen.getAllByText('~10 pts/round').length).toBeGreaterThan(0)
|
||||||
})
|
})
|
||||||
|
|
||||||
it('switches to constructors and progression views', async () => {
|
it('switches to constructors and progression views', async () => {
|
||||||
|
|||||||
@@ -12,9 +12,20 @@ vi.mock('../api', () => ({
|
|||||||
fetchSessions: vi.fn(),
|
fetchSessions: vi.fn(),
|
||||||
fetchWeekend: vi.fn(),
|
fetchWeekend: vi.fn(),
|
||||||
fetchLiveState: vi.fn(),
|
fetchLiveState: vi.fn(),
|
||||||
|
fetchChampionshipHub: vi.fn(),
|
||||||
|
fetchRaceHub: vi.fn(),
|
||||||
}))
|
}))
|
||||||
|
|
||||||
import { fetchSeasons, fetchLocalMeetings, fetchSeasonMeetings, fetchSessions, fetchWeekend, fetchLiveState } from '../api'
|
import {
|
||||||
|
fetchSeasons,
|
||||||
|
fetchLocalMeetings,
|
||||||
|
fetchSeasonMeetings,
|
||||||
|
fetchSessions,
|
||||||
|
fetchWeekend,
|
||||||
|
fetchLiveState,
|
||||||
|
fetchChampionshipHub,
|
||||||
|
fetchRaceHub,
|
||||||
|
} from '../api'
|
||||||
|
|
||||||
const mockFetchSeasons = vi.mocked(fetchSeasons)
|
const mockFetchSeasons = vi.mocked(fetchSeasons)
|
||||||
const mockFetchLocalMeetings = vi.mocked(fetchLocalMeetings)
|
const mockFetchLocalMeetings = vi.mocked(fetchLocalMeetings)
|
||||||
@@ -22,6 +33,8 @@ const mockFetchSeasonMeetings = vi.mocked(fetchSeasonMeetings)
|
|||||||
const mockFetchSessions = vi.mocked(fetchSessions)
|
const mockFetchSessions = vi.mocked(fetchSessions)
|
||||||
const mockFetchWeekend = vi.mocked(fetchWeekend)
|
const mockFetchWeekend = vi.mocked(fetchWeekend)
|
||||||
const mockFetchLiveState = vi.mocked(fetchLiveState)
|
const mockFetchLiveState = vi.mocked(fetchLiveState)
|
||||||
|
const mockFetchChampionshipHub = vi.mocked(fetchChampionshipHub)
|
||||||
|
const mockFetchRaceHub = vi.mocked(fetchRaceHub)
|
||||||
|
|
||||||
const meeting: Meeting = {
|
const meeting: Meeting = {
|
||||||
meeting_key: 1229,
|
meeting_key: 1229,
|
||||||
@@ -102,6 +115,48 @@ describe('CommandCenterPage', () => {
|
|||||||
vi.clearAllMocks()
|
vi.clearAllMocks()
|
||||||
mockFetchLiveState.mockResolvedValue({ is_live: false, data: null })
|
mockFetchLiveState.mockResolvedValue({ is_live: false, data: null })
|
||||||
mockFetchSessions.mockResolvedValue([])
|
mockFetchSessions.mockResolvedValue([])
|
||||||
|
mockFetchChampionshipHub.mockResolvedValue({
|
||||||
|
season: 2025,
|
||||||
|
round: 1,
|
||||||
|
total_rounds: 1,
|
||||||
|
rounds_left: 0,
|
||||||
|
last_race: 'Monaco',
|
||||||
|
round_labels: ['R1'],
|
||||||
|
drivers: [],
|
||||||
|
teams: [],
|
||||||
|
})
|
||||||
|
mockFetchRaceHub.mockResolvedValue({
|
||||||
|
source: 'local',
|
||||||
|
session_key: 9472,
|
||||||
|
datasets: fullDatasets,
|
||||||
|
results: [
|
||||||
|
{
|
||||||
|
driver_number: 1,
|
||||||
|
position: 1,
|
||||||
|
name_acronym: 'VER',
|
||||||
|
full_name: 'Max Verstappen',
|
||||||
|
team_name: 'Red Bull Racing',
|
||||||
|
team_colour: '3671c6',
|
||||||
|
dnf: false,
|
||||||
|
dns: false,
|
||||||
|
dsq: false,
|
||||||
|
duration: 7200,
|
||||||
|
gap_to_leader: null,
|
||||||
|
number_of_laps: 78,
|
||||||
|
points: 25,
|
||||||
|
session_key: 9472,
|
||||||
|
meeting_key: 1229,
|
||||||
|
},
|
||||||
|
],
|
||||||
|
starting_grid: [],
|
||||||
|
drivers: [],
|
||||||
|
stints: [],
|
||||||
|
pit_stops: [],
|
||||||
|
positions: [],
|
||||||
|
race_control: [],
|
||||||
|
weather: [],
|
||||||
|
laps: [],
|
||||||
|
})
|
||||||
})
|
})
|
||||||
|
|
||||||
it('shows empty state when no seasons are ingested', async () => {
|
it('shows empty state when no seasons are ingested', async () => {
|
||||||
@@ -131,11 +186,10 @@ describe('CommandCenterPage', () => {
|
|||||||
expect(screen.getByTestId('cc-session-9472')).toBeInTheDocument()
|
expect(screen.getByTestId('cc-session-9472')).toBeInTheDocument()
|
||||||
})
|
})
|
||||||
expect(screen.getByTestId('cc-focus')).toHaveTextContent('Monaco')
|
expect(screen.getByTestId('cc-focus')).toHaveTextContent('Monaco')
|
||||||
expect(screen.getByTestId('cc-focus')).toHaveTextContent('MON')
|
|
||||||
expect(screen.getByTestId('cc-season-calendar')).toHaveTextContent('Season Calendar')
|
expect(screen.getByTestId('cc-season-calendar')).toHaveTextContent('Season Calendar')
|
||||||
expect(screen.getByTestId('cc-calendar-1229')).toHaveTextContent('R01')
|
expect(screen.getByTestId('cc-calendar-1229')).toHaveTextContent('R01')
|
||||||
expect(screen.getByText('No live session')).toBeInTheDocument()
|
expect(screen.getByText('No live session')).toBeInTheDocument()
|
||||||
expect(screen.getByTestId('cc-action-race-hub')).toHaveTextContent('Race')
|
expect(screen.getByTestId('hero-last-race-link')).toHaveTextContent('Monaco')
|
||||||
})
|
})
|
||||||
|
|
||||||
it('uses OpenF1 calendar metadata to focus the current weekend when local ingest is behind', async () => {
|
it('uses OpenF1 calendar metadata to focus the current weekend when local ingest is behind', async () => {
|
||||||
@@ -181,9 +235,9 @@ describe('CommandCenterPage', () => {
|
|||||||
await waitFor(() => {
|
await waitFor(() => {
|
||||||
expect(screen.getByTestId('cc-focus')).toHaveTextContent('Monaco')
|
expect(screen.getByTestId('cc-focus')).toHaveTextContent('Monaco')
|
||||||
})
|
})
|
||||||
expect(screen.getByTestId('cc-focus')).toHaveTextContent('Current weekend')
|
expect(screen.getByTestId('cc-focus')).toHaveTextContent('Live now')
|
||||||
expect(screen.getByTestId('cc-session-9602')).toHaveTextContent('On track')
|
expect(screen.getByTestId('cc-session-9602')).toHaveTextContent('On track')
|
||||||
expect(screen.getByTestId('cc-action-race-hub')).toHaveTextContent('Qualifying')
|
expect(screen.getByTestId('hero-live-link')).toHaveAttribute('href', '/live')
|
||||||
|
|
||||||
vi.useRealTimers()
|
vi.useRealTimers()
|
||||||
})
|
})
|
||||||
|
|||||||
@@ -7,9 +7,10 @@ import { BattleChips } from '../components/live/BattleChips'
|
|||||||
import { GapSparkline } from '../components/live/GapSparkline'
|
import { GapSparkline } from '../components/live/GapSparkline'
|
||||||
import { PinnedDrivers } from '../components/live/PinnedDrivers'
|
import { PinnedDrivers } from '../components/live/PinnedDrivers'
|
||||||
import { TimingTower } from '../components/live/TimingTower'
|
import { TimingTower } from '../components/live/TimingTower'
|
||||||
|
import { TrackMap } from '../components/live/TrackMap'
|
||||||
import { detectBattles } from '../lib/battles'
|
import { detectBattles } from '../lib/battles'
|
||||||
import type { LiveTimingRow } from '../lib/live'
|
import type { LiveTimingRow } from '../lib/live'
|
||||||
import type { LiveDriverData, LiveWeatherData } from '../types'
|
import type { LiveDriverData, LiveWeatherData, TrackOutline } from '../types'
|
||||||
|
|
||||||
function makeRow(
|
function makeRow(
|
||||||
number: string,
|
number: string,
|
||||||
@@ -188,6 +189,26 @@ describe('TimingTower', () => {
|
|||||||
expect(screen.getByText(/no driver timing rows/i)).toBeInTheDocument()
|
expect(screen.getByText(/no driver timing rows/i)).toBeInTheDocument()
|
||||||
})
|
})
|
||||||
|
|
||||||
|
it('annotates DRS-range intervals in race mode', () => {
|
||||||
|
const raceRows = [
|
||||||
|
makeRow('1', 1, 'VER'),
|
||||||
|
makeRow('4', 2, 'NOR', { Interval: '+0.4', GapToLeader: '+0.4' }),
|
||||||
|
]
|
||||||
|
render(
|
||||||
|
<TimingTower
|
||||||
|
rows={raceRows}
|
||||||
|
session={{
|
||||||
|
MeetingName: 'Monaco Grand Prix',
|
||||||
|
CircuitName: 'Monaco',
|
||||||
|
SessionType: 'Race',
|
||||||
|
SessionName: 'Race',
|
||||||
|
Path: '',
|
||||||
|
}}
|
||||||
|
/>,
|
||||||
|
)
|
||||||
|
expect(screen.getByText('DRS range')).toBeInTheDocument()
|
||||||
|
})
|
||||||
|
|
||||||
it('renders the SQ1 cutoff after P17 and marks rows below as at risk', () => {
|
it('renders the SQ1 cutoff after P17 and marks rows below as at risk', () => {
|
||||||
const sprintRows = Array.from({ length: 22 }, (_, index) =>
|
const sprintRows = Array.from({ length: 22 }, (_, index) =>
|
||||||
makeRow(String(index + 1), index + 1, `D${index + 1}`),
|
makeRow(String(index + 1), index + 1, `D${index + 1}`),
|
||||||
@@ -200,6 +221,7 @@ describe('TimingTower', () => {
|
|||||||
CircuitName: 'Silverstone',
|
CircuitName: 'Silverstone',
|
||||||
SessionType: 'Sprint Qualifying',
|
SessionType: 'Sprint Qualifying',
|
||||||
SessionName: 'Sprint Qualifying',
|
SessionName: 'Sprint Qualifying',
|
||||||
|
Path: '',
|
||||||
}}
|
}}
|
||||||
/>,
|
/>,
|
||||||
)
|
)
|
||||||
@@ -241,3 +263,66 @@ describe('PinnedDrivers', () => {
|
|||||||
expect(screen.queryByTestId('pinned-strip')).not.toBeInTheDocument()
|
expect(screen.queryByTestId('pinned-strip')).not.toBeInTheDocument()
|
||||||
})
|
})
|
||||||
})
|
})
|
||||||
|
|
||||||
|
describe('TrackMap', () => {
|
||||||
|
const outline: TrackOutline = {
|
||||||
|
circuit_key: 9,
|
||||||
|
bounds: { minX: 0, maxX: 100, minY: 0, maxY: 100 },
|
||||||
|
points: [
|
||||||
|
{ x: 0, y: 0 },
|
||||||
|
{ x: 1, y: 0 },
|
||||||
|
{ x: 1, y: 1 },
|
||||||
|
{ x: 0, y: 1 },
|
||||||
|
],
|
||||||
|
}
|
||||||
|
|
||||||
|
it('renders car dots and opens mini telemetry on tap', () => {
|
||||||
|
render(
|
||||||
|
<TrackMap
|
||||||
|
outline={outline}
|
||||||
|
positions={{
|
||||||
|
'4': { x: 50, y: 25, z: 0, status: 'OnTrack' },
|
||||||
|
'81': { x: 25, y: 75, z: 0, status: 'OffTrack' },
|
||||||
|
}}
|
||||||
|
telemetry={{
|
||||||
|
'4': { Speed: 302, Throttle: 88, Brake: 0, DRS: 10, NGear: 8, RPM: 11111 },
|
||||||
|
}}
|
||||||
|
driverInfo={{
|
||||||
|
'4': {
|
||||||
|
RacingNumber: '4',
|
||||||
|
BroadcastName: 'L NORRIS',
|
||||||
|
Tla: 'NOR',
|
||||||
|
TeamName: 'McLaren',
|
||||||
|
TeamColour: 'ff8000',
|
||||||
|
FirstName: 'Lando',
|
||||||
|
LastName: 'Norris',
|
||||||
|
},
|
||||||
|
'81': {
|
||||||
|
RacingNumber: '81',
|
||||||
|
BroadcastName: 'O PIASTRI',
|
||||||
|
Tla: 'PIA',
|
||||||
|
TeamName: 'McLaren',
|
||||||
|
TeamColour: 'ff8000',
|
||||||
|
FirstName: 'Oscar',
|
||||||
|
LastName: 'Piastri',
|
||||||
|
},
|
||||||
|
}}
|
||||||
|
/>,
|
||||||
|
)
|
||||||
|
|
||||||
|
expect(screen.getByTestId('track-map')).toHaveTextContent('2 cars')
|
||||||
|
fireEvent.click(screen.getByRole('button', { name: /NOR telemetry/i }))
|
||||||
|
const readout = screen.getByTestId('track-telemetry')
|
||||||
|
expect(readout).toHaveTextContent('NOR')
|
||||||
|
expect(readout).toHaveTextContent('302km/h')
|
||||||
|
expect(readout).toHaveTextContent('88%')
|
||||||
|
expect(readout).toHaveTextContent('DRS')
|
||||||
|
expect(readout).toHaveTextContent('10')
|
||||||
|
expect(screen.getByRole('button', { name: /PIA telemetry/i })).toHaveClass('track-car-inactive')
|
||||||
|
})
|
||||||
|
|
||||||
|
it('renders an empty state without outline data', () => {
|
||||||
|
render(<TrackMap outline={null} positions={{}} />)
|
||||||
|
expect(screen.getByTestId('track-map')).toHaveTextContent(/track outline unavailable/i)
|
||||||
|
})
|
||||||
|
})
|
||||||
|
|||||||
166
frontend/src/test/LiveTimingPage.test.tsx
Normal file
166
frontend/src/test/LiveTimingPage.test.tsx
Normal file
@@ -0,0 +1,166 @@
|
|||||||
|
import { QueryClient, QueryClientProvider } from '@tanstack/react-query'
|
||||||
|
import { fireEvent, render, screen, waitFor } from '@testing-library/react'
|
||||||
|
import { beforeEach, describe, expect, it, vi } from 'vitest'
|
||||||
|
import { LiveTimingPage } from '../pages/LiveTimingPage'
|
||||||
|
import type { LiveStateResponse, LiveStreamData } from '../types'
|
||||||
|
|
||||||
|
vi.mock('../api', () => ({
|
||||||
|
fetchLiveState: vi.fn(),
|
||||||
|
fetchLiveTrackOutline: vi.fn(),
|
||||||
|
}))
|
||||||
|
|
||||||
|
import { fetchLiveState, fetchLiveTrackOutline } from '../api'
|
||||||
|
|
||||||
|
const mockFetchLiveState = vi.mocked(fetchLiveState)
|
||||||
|
const mockFetchLiveTrackOutline = vi.mocked(fetchLiveTrackOutline)
|
||||||
|
|
||||||
|
class MockEventSource {
|
||||||
|
onopen: (() => void) | null = null
|
||||||
|
onerror: (() => void) | null = null
|
||||||
|
|
||||||
|
constructor() {
|
||||||
|
setTimeout(() => this.onopen?.(), 0)
|
||||||
|
}
|
||||||
|
|
||||||
|
addEventListener() {}
|
||||||
|
close() {}
|
||||||
|
}
|
||||||
|
|
||||||
|
const archivedSnapshot: LiveStreamData = {
|
||||||
|
Drivers: {
|
||||||
|
'1': {
|
||||||
|
RacingNumber: '1',
|
||||||
|
Position: 1,
|
||||||
|
PrevPosition: 1,
|
||||||
|
GapToLeader: '',
|
||||||
|
Interval: '',
|
||||||
|
LastLapTime: '1:21.345',
|
||||||
|
LastLapPB: false,
|
||||||
|
LastLapOB: false,
|
||||||
|
BestLapTime: '1:20.987',
|
||||||
|
BestLapPB: false,
|
||||||
|
BestLapOB: false,
|
||||||
|
BestLapNum: 22,
|
||||||
|
InPit: false,
|
||||||
|
PitOut: false,
|
||||||
|
Retired: false,
|
||||||
|
KnockedOut: false,
|
||||||
|
Cutoff: false,
|
||||||
|
OnFlyingLap: false,
|
||||||
|
NumberOfLaps: 30,
|
||||||
|
SpeedTrap: '',
|
||||||
|
Sectors: [],
|
||||||
|
},
|
||||||
|
},
|
||||||
|
DriverInfo: {
|
||||||
|
'1': {
|
||||||
|
RacingNumber: '1',
|
||||||
|
BroadcastName: 'M VERSTAPPEN',
|
||||||
|
Tla: 'VER',
|
||||||
|
TeamName: 'Red Bull Racing',
|
||||||
|
TeamColour: '3671C6',
|
||||||
|
FirstName: 'Max',
|
||||||
|
LastName: 'Verstappen',
|
||||||
|
},
|
||||||
|
},
|
||||||
|
Tyres: {
|
||||||
|
'1': { Compound: 'HARD', New: false, Age: 12 },
|
||||||
|
},
|
||||||
|
Telemetry: {},
|
||||||
|
RCMessages: [],
|
||||||
|
Weather: {
|
||||||
|
AirTemp: 22,
|
||||||
|
TrackTemp: 41,
|
||||||
|
Humidity: 58,
|
||||||
|
WindSpeed: 3,
|
||||||
|
WindDir: 180,
|
||||||
|
Rainfall: false,
|
||||||
|
},
|
||||||
|
Session: {
|
||||||
|
MeetingName: 'Testonia Grand Prix',
|
||||||
|
CircuitName: 'Testring',
|
||||||
|
SessionType: 'Race',
|
||||||
|
SessionName: 'Race',
|
||||||
|
Path: '',
|
||||||
|
},
|
||||||
|
TeamRadio: [],
|
||||||
|
SessionStatus: 'Finished',
|
||||||
|
TrackStatus: '1',
|
||||||
|
CurrentLap: 57,
|
||||||
|
TotalLaps: 57,
|
||||||
|
Clock: '',
|
||||||
|
ClockRefTime: '',
|
||||||
|
ClockExtrapolating: false,
|
||||||
|
Stints: {},
|
||||||
|
}
|
||||||
|
|
||||||
|
function renderPage(response: LiveStateResponse) {
|
||||||
|
const queryClient = new QueryClient({
|
||||||
|
defaultOptions: { queries: { retry: false } },
|
||||||
|
})
|
||||||
|
mockFetchLiveState.mockResolvedValue(response)
|
||||||
|
mockFetchLiveTrackOutline.mockResolvedValue({
|
||||||
|
circuit_key: 1,
|
||||||
|
points: [],
|
||||||
|
bounds: { minX: 0, maxX: 1, minY: 0, maxY: 1 },
|
||||||
|
})
|
||||||
|
|
||||||
|
return render(
|
||||||
|
<QueryClientProvider client={queryClient}>
|
||||||
|
<LiveTimingPage />
|
||||||
|
</QueryClientProvider>,
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
describe('LiveTimingPage archive mode', () => {
|
||||||
|
beforeEach(() => {
|
||||||
|
vi.clearAllMocks()
|
||||||
|
Object.defineProperty(window, 'EventSource', {
|
||||||
|
value: MockEventSource,
|
||||||
|
writable: true,
|
||||||
|
configurable: true,
|
||||||
|
})
|
||||||
|
})
|
||||||
|
|
||||||
|
it('keeps archived snapshots behind the View Last Session action', async () => {
|
||||||
|
renderPage({
|
||||||
|
is_live: false,
|
||||||
|
data: null,
|
||||||
|
last_snapshot: archivedSnapshot,
|
||||||
|
last_positions: {
|
||||||
|
'1': { x: 10, y: 20, z: 0, status: 'OnTrack' },
|
||||||
|
},
|
||||||
|
last_snapshot_at: '2026-07-04T14:00:00Z',
|
||||||
|
})
|
||||||
|
|
||||||
|
expect(await screen.findByTestId('live-empty')).toHaveTextContent('No live session active')
|
||||||
|
expect(screen.queryByText('Timing Tower')).not.toBeInTheDocument()
|
||||||
|
|
||||||
|
fireEvent.click(screen.getByRole('button', { name: /view last session/i }))
|
||||||
|
|
||||||
|
await waitFor(() => {
|
||||||
|
expect(screen.getByTestId('live-archive-strip')).toHaveTextContent('Archived snapshot')
|
||||||
|
})
|
||||||
|
expect(screen.getByText('Timing Tower')).toBeInTheDocument()
|
||||||
|
expect(screen.getAllByText('VER').length).toBeGreaterThan(0)
|
||||||
|
expect(screen.getByText('archive')).toBeInTheDocument()
|
||||||
|
})
|
||||||
|
|
||||||
|
it('does not show the archive action when no snapshot is retained', async () => {
|
||||||
|
renderPage({ is_live: false, data: null })
|
||||||
|
|
||||||
|
expect(await screen.findByTestId('live-empty')).toHaveTextContent('No live session active')
|
||||||
|
expect(screen.queryByRole('button', { name: /view last session/i })).not.toBeInTheDocument()
|
||||||
|
})
|
||||||
|
|
||||||
|
it('temporarily omits the track map while live GPS is unavailable', async () => {
|
||||||
|
renderPage({
|
||||||
|
is_live: true,
|
||||||
|
data: { ...archivedSnapshot, SessionStatus: 'Started' },
|
||||||
|
})
|
||||||
|
|
||||||
|
expect(await screen.findByText('Timing Tower')).toBeInTheDocument()
|
||||||
|
expect(screen.queryByText('Track Map')).not.toBeInTheDocument()
|
||||||
|
expect(mockFetchLiveTrackOutline).not.toHaveBeenCalled()
|
||||||
|
})
|
||||||
|
})
|
||||||
26
frontend/src/test/Meaning.test.tsx
Normal file
26
frontend/src/test/Meaning.test.tsx
Normal file
@@ -0,0 +1,26 @@
|
|||||||
|
import { describe, expect, it } from 'vitest'
|
||||||
|
import { render, screen } from '@testing-library/react'
|
||||||
|
import { Meaning } from '../components/Meaning'
|
||||||
|
|
||||||
|
describe('Meaning', () => {
|
||||||
|
it('renders bare value when meaning is null', () => {
|
||||||
|
render(<Meaning value="+1.234" meaning={null} />)
|
||||||
|
expect(screen.getByText('+1.234')).toBeInTheDocument()
|
||||||
|
expect(screen.queryByText('DRS range')).not.toBeInTheDocument()
|
||||||
|
})
|
||||||
|
|
||||||
|
it('renders value with caption and tooltip title', () => {
|
||||||
|
render(
|
||||||
|
<Meaning
|
||||||
|
value="+0.4"
|
||||||
|
meaning="DRS range"
|
||||||
|
title="Within 1.0s — DRS enabled next straight"
|
||||||
|
tone="good"
|
||||||
|
/>,
|
||||||
|
)
|
||||||
|
const value = screen.getByText('+0.4')
|
||||||
|
expect(value).toBeInTheDocument()
|
||||||
|
expect(screen.getByText('DRS range')).toHaveClass('meaning-caption--good')
|
||||||
|
expect(value.closest('.meaning')).toHaveAttribute('title', 'Within 1.0s — DRS enabled next straight')
|
||||||
|
})
|
||||||
|
})
|
||||||
276
frontend/src/test/RacePreviewPage.test.tsx
Normal file
276
frontend/src/test/RacePreviewPage.test.tsx
Normal file
@@ -0,0 +1,276 @@
|
|||||||
|
import { describe, it, expect, vi, beforeEach } from 'vitest'
|
||||||
|
import { render, screen, waitFor } from '@testing-library/react'
|
||||||
|
import { QueryClient, QueryClientProvider } from '@tanstack/react-query'
|
||||||
|
import { RouterProvider, createRouter, createRootRoute, createRoute } from '@tanstack/react-router'
|
||||||
|
import { RacePreviewPage } from '../pages/RacePreviewPage'
|
||||||
|
import type { ChampHubDriver, ChampionshipHub, EnrichedGrid, EnrichedResult, Meeting, Session, TrackOutline } from '../types'
|
||||||
|
|
||||||
|
vi.mock('../api', () => ({
|
||||||
|
fetchSeasons: vi.fn(),
|
||||||
|
fetchMeetings: vi.fn(),
|
||||||
|
fetchSessions: vi.fn(),
|
||||||
|
fetchResults: vi.fn(),
|
||||||
|
fetchStartingGrid: vi.fn(),
|
||||||
|
fetchTrackOutline: vi.fn(),
|
||||||
|
fetchChampionshipHub: vi.fn(),
|
||||||
|
}))
|
||||||
|
|
||||||
|
import {
|
||||||
|
fetchSeasons,
|
||||||
|
fetchMeetings,
|
||||||
|
fetchSessions,
|
||||||
|
fetchResults,
|
||||||
|
fetchStartingGrid,
|
||||||
|
fetchTrackOutline,
|
||||||
|
fetchChampionshipHub,
|
||||||
|
} from '../api'
|
||||||
|
|
||||||
|
const mockFetchSeasons = vi.mocked(fetchSeasons)
|
||||||
|
const mockFetchMeetings = vi.mocked(fetchMeetings)
|
||||||
|
const mockFetchSessions = vi.mocked(fetchSessions)
|
||||||
|
const mockFetchResults = vi.mocked(fetchResults)
|
||||||
|
const mockFetchStartingGrid = vi.mocked(fetchStartingGrid)
|
||||||
|
const mockFetchTrackOutline = vi.mocked(fetchTrackOutline)
|
||||||
|
const mockFetchChampionshipHub = vi.mocked(fetchChampionshipHub)
|
||||||
|
|
||||||
|
const upcomingMeeting: Meeting = {
|
||||||
|
meeting_key: 100,
|
||||||
|
meeting_name: 'Monaco',
|
||||||
|
meeting_official_name: 'Monaco GP',
|
||||||
|
location: 'Monaco',
|
||||||
|
country_name: 'Monaco',
|
||||||
|
country_code: 'MON',
|
||||||
|
country_flag: '',
|
||||||
|
circuit_key: 10,
|
||||||
|
circuit_short_name: 'Monaco',
|
||||||
|
date_start: '2099-05-22T00:00:00+00:00',
|
||||||
|
date_end: '2099-05-24T23:59:59+00:00',
|
||||||
|
year: 2099,
|
||||||
|
}
|
||||||
|
|
||||||
|
const priorMeeting: Meeting = {
|
||||||
|
...upcomingMeeting,
|
||||||
|
meeting_key: 90,
|
||||||
|
year: 2098,
|
||||||
|
date_start: '2098-05-22T00:00:00+00:00',
|
||||||
|
date_end: '2098-05-24T23:59:59+00:00',
|
||||||
|
}
|
||||||
|
|
||||||
|
const sessions: Session[] = [
|
||||||
|
{
|
||||||
|
session_key: 1,
|
||||||
|
session_name: 'FP1',
|
||||||
|
session_type: 'Practice',
|
||||||
|
meeting_key: 100,
|
||||||
|
date_start: '2099-05-22T10:00:00+00:00',
|
||||||
|
date_end: '2099-05-22T11:00:00+00:00',
|
||||||
|
gmt_offset: '02:00:00',
|
||||||
|
},
|
||||||
|
{
|
||||||
|
session_key: 2,
|
||||||
|
session_name: 'Sprint',
|
||||||
|
session_type: 'Sprint',
|
||||||
|
meeting_key: 100,
|
||||||
|
date_start: '2099-05-23T10:00:00+00:00',
|
||||||
|
date_end: '2099-05-23T11:00:00+00:00',
|
||||||
|
gmt_offset: '02:00:00',
|
||||||
|
},
|
||||||
|
{
|
||||||
|
session_key: 3,
|
||||||
|
session_name: 'Race',
|
||||||
|
session_type: 'Race',
|
||||||
|
meeting_key: 100,
|
||||||
|
date_start: '2099-05-24T13:00:00+00:00',
|
||||||
|
date_end: '2099-05-24T15:00:00+00:00',
|
||||||
|
gmt_offset: '02:00:00',
|
||||||
|
},
|
||||||
|
]
|
||||||
|
|
||||||
|
const priorRaceSession: Session = {
|
||||||
|
session_key: 50,
|
||||||
|
session_name: 'Race',
|
||||||
|
session_type: 'Race',
|
||||||
|
meeting_key: 90,
|
||||||
|
date_start: '2098-05-24T13:00:00+00:00',
|
||||||
|
date_end: '2098-05-24T15:00:00+00:00',
|
||||||
|
gmt_offset: '02:00:00',
|
||||||
|
}
|
||||||
|
|
||||||
|
const hubDriver = (over: Partial<ChampHubDriver>): ChampHubDriver => ({
|
||||||
|
driver_number: 1,
|
||||||
|
name_acronym: 'VER',
|
||||||
|
full_name: 'Max Verstappen',
|
||||||
|
team_name: 'Red Bull',
|
||||||
|
team_colour: '3671c6',
|
||||||
|
points: 200,
|
||||||
|
position: 1,
|
||||||
|
wins: 5,
|
||||||
|
podiums: 8,
|
||||||
|
poles: 4,
|
||||||
|
form: [25],
|
||||||
|
cumulative: [200],
|
||||||
|
teammate_wins: 9,
|
||||||
|
teammate_losses: 1,
|
||||||
|
...over,
|
||||||
|
})
|
||||||
|
|
||||||
|
const hub: ChampionshipHub = {
|
||||||
|
season: 2099,
|
||||||
|
round: 5,
|
||||||
|
total_rounds: 24,
|
||||||
|
rounds_left: 19,
|
||||||
|
last_race: 'Monaco GP',
|
||||||
|
round_labels: ['R1'],
|
||||||
|
drivers: [
|
||||||
|
hubDriver({}),
|
||||||
|
hubDriver({ driver_number: 4, name_acronym: 'NOR', points: 160, position: 2 }),
|
||||||
|
hubDriver({ driver_number: 16, name_acronym: 'LEC', points: 120, position: 3 }),
|
||||||
|
],
|
||||||
|
teams: [],
|
||||||
|
}
|
||||||
|
|
||||||
|
const results: EnrichedResult[] = [
|
||||||
|
{
|
||||||
|
driver_number: 1,
|
||||||
|
position: 1,
|
||||||
|
name_acronym: 'VER',
|
||||||
|
full_name: 'Max Verstappen',
|
||||||
|
team_name: 'Red Bull',
|
||||||
|
team_colour: '3671c6',
|
||||||
|
dnf: false,
|
||||||
|
dns: false,
|
||||||
|
dsq: false,
|
||||||
|
duration: 100,
|
||||||
|
gap_to_leader: 0,
|
||||||
|
number_of_laps: 78,
|
||||||
|
points: 25,
|
||||||
|
session_key: 50,
|
||||||
|
meeting_key: 90,
|
||||||
|
},
|
||||||
|
]
|
||||||
|
|
||||||
|
const grid: EnrichedGrid[] = [
|
||||||
|
{
|
||||||
|
driver_number: 4,
|
||||||
|
position: 1,
|
||||||
|
name_acronym: 'NOR',
|
||||||
|
full_name: 'Lando Norris',
|
||||||
|
team_name: 'McLaren',
|
||||||
|
team_colour: 'ff8000',
|
||||||
|
session_key: 50,
|
||||||
|
meeting_key: 90,
|
||||||
|
lap_duration: 70,
|
||||||
|
},
|
||||||
|
]
|
||||||
|
|
||||||
|
const outline: TrackOutline = {
|
||||||
|
circuit_key: 10,
|
||||||
|
points: [
|
||||||
|
{ x: 0.1, y: 0.2 },
|
||||||
|
{ x: 0.5, y: 0.5 },
|
||||||
|
{ x: 0.9, y: 0.8 },
|
||||||
|
],
|
||||||
|
bounds: { minX: 0, maxX: 1, minY: 0, maxY: 1 },
|
||||||
|
}
|
||||||
|
|
||||||
|
function renderPage() {
|
||||||
|
const queryClient = new QueryClient({ defaultOptions: { queries: { retry: false } } })
|
||||||
|
const rootRoute = createRootRoute({
|
||||||
|
component: () => (
|
||||||
|
<QueryClientProvider client={queryClient}>
|
||||||
|
<RacePreviewPage />
|
||||||
|
</QueryClientProvider>
|
||||||
|
),
|
||||||
|
})
|
||||||
|
const indexRoute = createRoute({ getParentRoute: () => rootRoute, path: '/', component: RacePreviewPage })
|
||||||
|
const router = createRouter({ routeTree: rootRoute.addChildren([indexRoute]) })
|
||||||
|
return render(<RouterProvider router={router} />)
|
||||||
|
}
|
||||||
|
|
||||||
|
describe('RacePreviewPage', () => {
|
||||||
|
beforeEach(() => {
|
||||||
|
vi.clearAllMocks()
|
||||||
|
mockFetchSeasons.mockResolvedValue([2099])
|
||||||
|
mockFetchChampionshipHub.mockResolvedValue(hub)
|
||||||
|
mockFetchTrackOutline.mockResolvedValue(outline)
|
||||||
|
mockFetchResults.mockResolvedValue(results)
|
||||||
|
mockFetchStartingGrid.mockResolvedValue(grid)
|
||||||
|
})
|
||||||
|
|
||||||
|
it('renders upcoming race preview with sections', async () => {
|
||||||
|
mockFetchMeetings.mockImplementation(async (year: number) => {
|
||||||
|
if (year === 2099) return [upcomingMeeting]
|
||||||
|
if (year === 2098) return [priorMeeting]
|
||||||
|
return []
|
||||||
|
})
|
||||||
|
mockFetchSessions.mockImplementation(async (meetingKey: number) => {
|
||||||
|
if (meetingKey === 100) return sessions
|
||||||
|
if (meetingKey === 90) return [priorRaceSession]
|
||||||
|
return []
|
||||||
|
})
|
||||||
|
|
||||||
|
renderPage()
|
||||||
|
|
||||||
|
await waitFor(() => {
|
||||||
|
expect(screen.getByTestId('preview-page')).toBeInTheDocument()
|
||||||
|
})
|
||||||
|
|
||||||
|
await waitFor(() => {
|
||||||
|
expect(screen.getByTestId('preview-countdown')).toBeInTheDocument()
|
||||||
|
})
|
||||||
|
|
||||||
|
expect(screen.getByTestId('preview-header')).toHaveTextContent('Monaco')
|
||||||
|
expect(screen.getByTestId('preview-schedule')).toHaveTextContent('FP1')
|
||||||
|
expect(screen.getByTestId('preview-track-card')).toBeInTheDocument()
|
||||||
|
|
||||||
|
await waitFor(() => {
|
||||||
|
expect(screen.getByTestId('preview-last-year-card')).toHaveTextContent('VER')
|
||||||
|
})
|
||||||
|
|
||||||
|
expect(screen.getByTestId('preview-title-fight-card')).toHaveTextContent('NOR')
|
||||||
|
expect(screen.getByTestId('preview-sprint-note')).toBeInTheDocument()
|
||||||
|
})
|
||||||
|
|
||||||
|
it('renders season-over state when no upcoming meeting', async () => {
|
||||||
|
mockFetchMeetings.mockResolvedValue([
|
||||||
|
{
|
||||||
|
...upcomingMeeting,
|
||||||
|
date_start: '2020-05-22T00:00:00+00:00',
|
||||||
|
date_end: '2020-05-24T23:59:59+00:00',
|
||||||
|
},
|
||||||
|
])
|
||||||
|
|
||||||
|
renderPage()
|
||||||
|
|
||||||
|
await waitFor(() => {
|
||||||
|
expect(screen.getByTestId('preview-season-over')).toBeInTheDocument()
|
||||||
|
})
|
||||||
|
|
||||||
|
expect(screen.getByText('Season complete')).toBeInTheDocument()
|
||||||
|
expect(screen.getByTestId('preview-title-fight-card')).toBeInTheDocument()
|
||||||
|
expect(screen.queryByTestId('preview-header')).not.toBeInTheDocument()
|
||||||
|
})
|
||||||
|
|
||||||
|
it('shows first-time circuit empty state', async () => {
|
||||||
|
const newCircuit: Meeting = {
|
||||||
|
...upcomingMeeting,
|
||||||
|
meeting_key: 200,
|
||||||
|
circuit_key: 999,
|
||||||
|
meeting_name: 'New GP',
|
||||||
|
}
|
||||||
|
|
||||||
|
mockFetchMeetings.mockImplementation(async (year: number) => {
|
||||||
|
if (year === 2099) return [newCircuit]
|
||||||
|
if (year === 2098) return [priorMeeting]
|
||||||
|
return []
|
||||||
|
})
|
||||||
|
mockFetchSessions.mockResolvedValue(sessions)
|
||||||
|
mockFetchTrackOutline.mockResolvedValue(null)
|
||||||
|
|
||||||
|
renderPage()
|
||||||
|
|
||||||
|
await waitFor(() => {
|
||||||
|
expect(screen.getByTestId('preview-last-year-card')).toHaveTextContent('First time on the calendar')
|
||||||
|
})
|
||||||
|
})
|
||||||
|
})
|
||||||
@@ -106,6 +106,17 @@ describe('StrategyView — stints available', () => {
|
|||||||
)
|
)
|
||||||
expect(screen.queryByText(/Stints not available/i)).not.toBeInTheDocument()
|
expect(screen.queryByText(/Stints not available/i)).not.toBeInTheDocument()
|
||||||
})
|
})
|
||||||
|
|
||||||
|
it('maps pit_stops into timeline pit markers for the matching driver', () => {
|
||||||
|
const { container } = render(
|
||||||
|
<StrategyView results={results} stints={stints} pit_stops={pitStops} hasStints={true} />
|
||||||
|
)
|
||||||
|
const markers = container.querySelectorAll('[data-testid="pit-marker"]')
|
||||||
|
expect(markers).toHaveLength(1)
|
||||||
|
expect(markers[0]).toHaveAttribute('data-lap', '19')
|
||||||
|
const titles = [...container.querySelectorAll('title')].map((t) => t.textContent)
|
||||||
|
expect(titles).toContain('HAM pit stop · L19')
|
||||||
|
})
|
||||||
})
|
})
|
||||||
|
|
||||||
describe('StrategyView — stints missing', () => {
|
describe('StrategyView — stints missing', () => {
|
||||||
|
|||||||
@@ -8,6 +8,7 @@ describe('TabBar', () => {
|
|||||||
expect(screen.getByRole('tab', { name: 'Overview' })).toBeInTheDocument()
|
expect(screen.getByRole('tab', { name: 'Overview' })).toBeInTheDocument()
|
||||||
expect(screen.getByRole('tab', { name: 'Race Story' })).toBeInTheDocument()
|
expect(screen.getByRole('tab', { name: 'Race Story' })).toBeInTheDocument()
|
||||||
expect(screen.getByRole('tab', { name: 'Strategy' })).toBeInTheDocument()
|
expect(screen.getByRole('tab', { name: 'Strategy' })).toBeInTheDocument()
|
||||||
|
expect(screen.getByRole('tab', { name: 'Compare' })).toBeInTheDocument()
|
||||||
expect(screen.getByRole('tab', { name: 'Lap Data' })).toBeInTheDocument()
|
expect(screen.getByRole('tab', { name: 'Lap Data' })).toBeInTheDocument()
|
||||||
expect(screen.getByRole('tab', { name: 'Conditions' })).toBeInTheDocument()
|
expect(screen.getByRole('tab', { name: 'Conditions' })).toBeInTheDocument()
|
||||||
expect(screen.getByRole('tab', { name: 'Race Control' })).toBeInTheDocument()
|
expect(screen.getByRole('tab', { name: 'Race Control' })).toBeInTheDocument()
|
||||||
|
|||||||
87
frontend/src/test/TeamRadioTicker.test.tsx
Normal file
87
frontend/src/test/TeamRadioTicker.test.tsx
Normal file
@@ -0,0 +1,87 @@
|
|||||||
|
import { afterEach, describe, expect, it, vi } from 'vitest'
|
||||||
|
import { fireEvent, render, screen } from '@testing-library/react'
|
||||||
|
import { TeamRadioTicker } from '../components/live/TeamRadioTicker'
|
||||||
|
import { radioClipUrl } from '../lib/radio'
|
||||||
|
import type { LiveDriverInfo, LiveRadioCapture, LiveSessionMeta } from '../types'
|
||||||
|
|
||||||
|
const session: LiveSessionMeta = {
|
||||||
|
MeetingName: 'British Grand Prix',
|
||||||
|
CircuitName: 'Silverstone',
|
||||||
|
SessionType: 'Race',
|
||||||
|
SessionName: 'Race',
|
||||||
|
Path: '/2026/2026-07-05_British_Grand_Prix/2026-07-05_Race/',
|
||||||
|
}
|
||||||
|
|
||||||
|
const driverInfo: Record<string, LiveDriverInfo> = {
|
||||||
|
'4': {
|
||||||
|
RacingNumber: '4',
|
||||||
|
BroadcastName: 'L NORRIS',
|
||||||
|
Tla: 'NOR',
|
||||||
|
TeamName: 'McLaren',
|
||||||
|
TeamColour: 'ff8000',
|
||||||
|
FirstName: 'Lando',
|
||||||
|
LastName: 'Norris',
|
||||||
|
},
|
||||||
|
'16': {
|
||||||
|
RacingNumber: '16',
|
||||||
|
BroadcastName: 'C LECLERC',
|
||||||
|
Tla: 'LEC',
|
||||||
|
TeamName: 'Ferrari',
|
||||||
|
TeamColour: 'e8002d',
|
||||||
|
FirstName: 'Charles',
|
||||||
|
LastName: 'Leclerc',
|
||||||
|
},
|
||||||
|
}
|
||||||
|
|
||||||
|
const captures: LiveRadioCapture[] = [
|
||||||
|
{ Utc: '2026-07-05T14:05:00Z', RacingNumber: '16', Path: '/TeamRadio/LEC-1.mp3' },
|
||||||
|
{ Utc: '2026-07-05T14:07:00Z', RacingNumber: '4', Path: 'TeamRadio/NOR-1.mp3' },
|
||||||
|
]
|
||||||
|
|
||||||
|
afterEach(() => {
|
||||||
|
vi.restoreAllMocks()
|
||||||
|
})
|
||||||
|
|
||||||
|
describe('radioClipUrl', () => {
|
||||||
|
it('builds static CDN URLs from the session path and capture path', () => {
|
||||||
|
expect(radioClipUrl(session, captures[0])).toBe(
|
||||||
|
'https://livetiming.formula1.com/static/2026/2026-07-05_British_Grand_Prix/2026-07-05_Race/TeamRadio/LEC-1.mp3',
|
||||||
|
)
|
||||||
|
})
|
||||||
|
|
||||||
|
it('returns an empty URL without path data', () => {
|
||||||
|
expect(radioClipUrl({ ...session, Path: '' }, captures[0])).toBe('')
|
||||||
|
expect(radioClipUrl(session, { ...captures[0], Path: '' })).toBe('')
|
||||||
|
})
|
||||||
|
})
|
||||||
|
|
||||||
|
describe('TeamRadioTicker', () => {
|
||||||
|
it('renders captures newest first with driver labels', () => {
|
||||||
|
vi.spyOn(Date, 'now').mockReturnValue(Date.parse('2026-07-05T14:10:00Z'))
|
||||||
|
|
||||||
|
render(<TeamRadioTicker captures={captures} driverInfo={driverInfo} session={session} />)
|
||||||
|
|
||||||
|
const rows = screen.getAllByRole('button')
|
||||||
|
expect(rows).toHaveLength(2)
|
||||||
|
expect(screen.getByText('NOR')).toBeInTheDocument()
|
||||||
|
expect(screen.getByText('LEC')).toBeInTheDocument()
|
||||||
|
expect(screen.getAllByText(/m ago/).map((node) => node.textContent)).toEqual(['3m ago', '5m ago'])
|
||||||
|
})
|
||||||
|
|
||||||
|
it('uses one audio element and toggles play/pause per clip', () => {
|
||||||
|
const play = vi.spyOn(window.HTMLMediaElement.prototype, 'play').mockResolvedValue()
|
||||||
|
const pause = vi.spyOn(window.HTMLMediaElement.prototype, 'pause').mockImplementation(() => {})
|
||||||
|
|
||||||
|
render(<TeamRadioTicker captures={captures} driverInfo={driverInfo} session={session} />)
|
||||||
|
|
||||||
|
fireEvent.click(screen.getByLabelText('Play NOR radio'))
|
||||||
|
expect(play).toHaveBeenCalledTimes(1)
|
||||||
|
expect(document.querySelectorAll('audio')).toHaveLength(1)
|
||||||
|
expect(document.querySelector('audio')?.getAttribute('src')).toBe(
|
||||||
|
'https://livetiming.formula1.com/static/2026/2026-07-05_British_Grand_Prix/2026-07-05_Race/TeamRadio/NOR-1.mp3',
|
||||||
|
)
|
||||||
|
|
||||||
|
fireEvent.click(screen.getByLabelText('Pause NOR radio'))
|
||||||
|
expect(pause).toHaveBeenCalled()
|
||||||
|
})
|
||||||
|
})
|
||||||
108
frontend/src/test/TyreDegPanel.test.tsx
Normal file
108
frontend/src/test/TyreDegPanel.test.tsx
Normal file
@@ -0,0 +1,108 @@
|
|||||||
|
import { describe, expect, it } from 'vitest'
|
||||||
|
import { fireEvent, render, screen } from '@testing-library/react'
|
||||||
|
import { TyreDegPanel } from '../components/live/TyreDegPanel'
|
||||||
|
import type { LiveTimingRow } from '../lib/live'
|
||||||
|
import type { LiveDriverData, LiveTyreData } from '../types'
|
||||||
|
|
||||||
|
function makeRow(
|
||||||
|
number: string,
|
||||||
|
position: number,
|
||||||
|
tla: string,
|
||||||
|
driver: Partial<LiveDriverData> = {},
|
||||||
|
tyre: Partial<LiveTyreData> = {},
|
||||||
|
): LiveTimingRow {
|
||||||
|
return {
|
||||||
|
RacingNumber: number,
|
||||||
|
Position: position,
|
||||||
|
Driver: {
|
||||||
|
RacingNumber: number,
|
||||||
|
Position: position,
|
||||||
|
Interval: position === 1 ? '' : '+5.0',
|
||||||
|
GapToLeader: '',
|
||||||
|
LastLapTime: '1:30.000',
|
||||||
|
NumberOfLaps: 10,
|
||||||
|
InPit: false,
|
||||||
|
PitOut: false,
|
||||||
|
Retired: false,
|
||||||
|
...driver,
|
||||||
|
} as LiveDriverData,
|
||||||
|
Info: {
|
||||||
|
RacingNumber: number,
|
||||||
|
BroadcastName: '',
|
||||||
|
Tla: tla,
|
||||||
|
TeamName: '',
|
||||||
|
TeamColour: '3671c6',
|
||||||
|
FirstName: '',
|
||||||
|
LastName: '',
|
||||||
|
},
|
||||||
|
Tyre: { Compound: 'MEDIUM', New: false, Age: 5, ...tyre } as LiveTyreData,
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function snapshotRows(lap: number, lastLapTime: string): LiveTimingRow[] {
|
||||||
|
return [
|
||||||
|
makeRow('1', 1, 'VER', { NumberOfLaps: lap, LastLapTime: lastLapTime }),
|
||||||
|
makeRow('4', 2, 'NOR', { NumberOfLaps: lap, LastLapTime: lastLapTime }),
|
||||||
|
]
|
||||||
|
}
|
||||||
|
|
||||||
|
describe('TyreDegPanel', () => {
|
||||||
|
it('shows a warming-up placeholder until enough clean laps accumulate', () => {
|
||||||
|
render(<TyreDegPanel rows={snapshotRows(3, '1:30.000')} sessionType="Race" pinned={[]} />)
|
||||||
|
const panel = screen.getByTestId('tyredeg-panel')
|
||||||
|
expect(panel).toHaveTextContent('VER')
|
||||||
|
expect(panel).toHaveTextContent('M +5')
|
||||||
|
expect(panel).toHaveTextContent('fresh')
|
||||||
|
expect(panel).toHaveTextContent('warming up')
|
||||||
|
})
|
||||||
|
|
||||||
|
it('annotates tyre age meaning on stint rows', () => {
|
||||||
|
const rows = [
|
||||||
|
makeRow('1', 1, 'VER', { NumberOfLaps: 10, LastLapTime: '1:30.000' }, { Compound: 'MEDIUM', Age: 12 }),
|
||||||
|
]
|
||||||
|
render(<TyreDegPanel rows={rows} sessionType="Race" pinned={[]} />)
|
||||||
|
expect(screen.getByText('mid-life')).toBeInTheDocument()
|
||||||
|
})
|
||||||
|
|
||||||
|
it('renders slope and rejoin estimate once laps accumulate across snapshots', () => {
|
||||||
|
const { rerender } = render(
|
||||||
|
<TyreDegPanel rows={snapshotRows(1, '1:30.000')} sessionType="Race" pinned={[]} />,
|
||||||
|
)
|
||||||
|
// Five completed laps at +0.1s/lap after the first observed snapshot.
|
||||||
|
for (let lap = 2; lap <= 6; lap++) {
|
||||||
|
const time = `1:30.${String((lap - 1) * 100).padStart(3, '0')}`
|
||||||
|
rerender(<TyreDegPanel rows={snapshotRows(lap, time)} sessionType="Race" pinned={[]} />)
|
||||||
|
}
|
||||||
|
|
||||||
|
const panel = screen.getByTestId('tyredeg-panel')
|
||||||
|
expect(panel).toHaveTextContent('+0.10s/lap')
|
||||||
|
expect(panel).not.toHaveTextContent('warming up')
|
||||||
|
// VER pits from P1 with NOR +5.0 behind: NOR gets past -> rejoin ~P2.
|
||||||
|
expect(panel).toHaveTextContent('→ ~P2')
|
||||||
|
})
|
||||||
|
|
||||||
|
it('hides the rejoin estimate outside race sessions and collapses on toggle', () => {
|
||||||
|
render(<TyreDegPanel rows={snapshotRows(3, '1:30.000')} sessionType="Qualifying" pinned={[]} />)
|
||||||
|
const panel = screen.getByTestId('tyredeg-panel')
|
||||||
|
expect(panel).not.toHaveTextContent('~P')
|
||||||
|
|
||||||
|
expect(screen.getAllByTestId('tyredeg-row')).toHaveLength(2)
|
||||||
|
fireEvent.click(screen.getByRole('button', { name: /tyre deg/i }))
|
||||||
|
expect(screen.queryAllByTestId('tyredeg-row')).toHaveLength(0)
|
||||||
|
})
|
||||||
|
|
||||||
|
it('limits rows to the top ten plus pinned drivers', () => {
|
||||||
|
const rows = Array.from({ length: 15 }, (_, index) =>
|
||||||
|
makeRow(String(index + 1), index + 1, `D${index + 1}`),
|
||||||
|
)
|
||||||
|
render(<TyreDegPanel rows={rows} sessionType="Race" pinned={['14']} />)
|
||||||
|
expect(screen.getAllByTestId('tyredeg-row')).toHaveLength(11)
|
||||||
|
expect(screen.getByText('D14')).toBeInTheDocument()
|
||||||
|
expect(screen.queryByText('D12')).not.toBeInTheDocument()
|
||||||
|
})
|
||||||
|
|
||||||
|
it('renders nothing without rows', () => {
|
||||||
|
render(<TyreDegPanel rows={[]} sessionType="Race" pinned={[]} />)
|
||||||
|
expect(screen.queryByTestId('tyredeg-panel')).not.toBeInTheDocument()
|
||||||
|
})
|
||||||
|
})
|
||||||
439
frontend/src/test/compare-view.test.tsx
Normal file
439
frontend/src/test/compare-view.test.tsx
Normal file
@@ -0,0 +1,439 @@
|
|||||||
|
import { describe, it, expect, vi, beforeEach } from 'vitest'
|
||||||
|
import { fireEvent, render, screen, waitFor } from '@testing-library/react'
|
||||||
|
import { QueryClient, QueryClientProvider } from '@tanstack/react-query'
|
||||||
|
import { CompareView } from '../components/CompareView'
|
||||||
|
import type { Driver, EnrichedResult, LapsComparisonResponse } from '../types'
|
||||||
|
import {
|
||||||
|
buildBestLapTraceSeries,
|
||||||
|
carDataToTraceSeries,
|
||||||
|
comparisonToDeltaSeries,
|
||||||
|
defaultCompareDriverNumbers,
|
||||||
|
filterCarDataToLap,
|
||||||
|
findBestLap,
|
||||||
|
formatPitLapsCaption,
|
||||||
|
lapsToLapTimes,
|
||||||
|
} from '../lib/compare'
|
||||||
|
import { computeCumulativeDeltas } from '../lib/delta'
|
||||||
|
|
||||||
|
vi.mock('../api', () => ({
|
||||||
|
fetchTelemetry: vi.fn(),
|
||||||
|
fetchLapsComparison: vi.fn(),
|
||||||
|
}))
|
||||||
|
|
||||||
|
import { fetchTelemetry, fetchLapsComparison } from '../api'
|
||||||
|
|
||||||
|
const mockFetchTelemetry = vi.mocked(fetchTelemetry)
|
||||||
|
const mockFetchLapsComparison = vi.mocked(fetchLapsComparison)
|
||||||
|
|
||||||
|
const results: EnrichedResult[] = [
|
||||||
|
{
|
||||||
|
driver_number: 1,
|
||||||
|
position: 1,
|
||||||
|
name_acronym: 'VER',
|
||||||
|
full_name: 'Max Verstappen',
|
||||||
|
team_name: 'Red Bull Racing',
|
||||||
|
team_colour: '3671C6',
|
||||||
|
dnf: false,
|
||||||
|
dns: false,
|
||||||
|
dsq: false,
|
||||||
|
duration: null,
|
||||||
|
gap_to_leader: null,
|
||||||
|
number_of_laps: 78,
|
||||||
|
points: 25,
|
||||||
|
session_key: 9472,
|
||||||
|
meeting_key: 1229,
|
||||||
|
},
|
||||||
|
{
|
||||||
|
driver_number: 44,
|
||||||
|
position: 2,
|
||||||
|
name_acronym: 'HAM',
|
||||||
|
full_name: 'Lewis Hamilton',
|
||||||
|
team_name: 'Ferrari',
|
||||||
|
team_colour: 'E8002D',
|
||||||
|
dnf: false,
|
||||||
|
dns: false,
|
||||||
|
dsq: false,
|
||||||
|
duration: null,
|
||||||
|
gap_to_leader: 5.1,
|
||||||
|
number_of_laps: 78,
|
||||||
|
points: 18,
|
||||||
|
session_key: 9472,
|
||||||
|
meeting_key: 1229,
|
||||||
|
},
|
||||||
|
]
|
||||||
|
|
||||||
|
const drivers: Driver[] = [
|
||||||
|
{
|
||||||
|
driver_number: 1,
|
||||||
|
name_acronym: 'VER',
|
||||||
|
full_name: 'Max Verstappen',
|
||||||
|
first_name: 'Max',
|
||||||
|
last_name: 'Verstappen',
|
||||||
|
team_name: 'Red Bull Racing',
|
||||||
|
team_colour: '3671C6',
|
||||||
|
headshot_url: '',
|
||||||
|
broadcast_name: 'M VERSTAPPEN',
|
||||||
|
session_key: 9472,
|
||||||
|
meeting_key: 1229,
|
||||||
|
},
|
||||||
|
{
|
||||||
|
driver_number: 44,
|
||||||
|
name_acronym: 'HAM',
|
||||||
|
full_name: 'Lewis Hamilton',
|
||||||
|
first_name: 'Lewis',
|
||||||
|
last_name: 'Hamilton',
|
||||||
|
team_name: 'Ferrari',
|
||||||
|
team_colour: 'E8002D',
|
||||||
|
headshot_url: '',
|
||||||
|
broadcast_name: 'L HAMILTON',
|
||||||
|
session_key: 9472,
|
||||||
|
meeting_key: 1229,
|
||||||
|
},
|
||||||
|
]
|
||||||
|
|
||||||
|
const comparison: LapsComparisonResponse = {
|
||||||
|
session_key: 9472,
|
||||||
|
sc_periods: [],
|
||||||
|
pit_laps: { '44': [19, 40] },
|
||||||
|
drivers: [
|
||||||
|
{
|
||||||
|
driver_number: 1,
|
||||||
|
name_acronym: 'VER',
|
||||||
|
team_colour: '3671C6',
|
||||||
|
laps: [
|
||||||
|
{
|
||||||
|
session_key: 9472,
|
||||||
|
driver_number: 1,
|
||||||
|
meeting_key: 1229,
|
||||||
|
lap_number: 1,
|
||||||
|
date_start: '2025-05-25T13:00:00.000Z',
|
||||||
|
lap_duration: 92.1,
|
||||||
|
is_pit_out_lap: false,
|
||||||
|
},
|
||||||
|
{
|
||||||
|
session_key: 9472,
|
||||||
|
driver_number: 1,
|
||||||
|
meeting_key: 1229,
|
||||||
|
lap_number: 2,
|
||||||
|
date_start: '2025-05-25T13:01:32.100Z',
|
||||||
|
lap_duration: 90.5,
|
||||||
|
is_pit_out_lap: false,
|
||||||
|
},
|
||||||
|
],
|
||||||
|
},
|
||||||
|
{
|
||||||
|
driver_number: 44,
|
||||||
|
name_acronym: 'HAM',
|
||||||
|
team_colour: 'E8002D',
|
||||||
|
laps: [
|
||||||
|
{
|
||||||
|
session_key: 9472,
|
||||||
|
driver_number: 44,
|
||||||
|
meeting_key: 1229,
|
||||||
|
lap_number: 1,
|
||||||
|
date_start: '2025-05-25T13:00:01.000Z',
|
||||||
|
lap_duration: 93.0,
|
||||||
|
is_pit_out_lap: false,
|
||||||
|
},
|
||||||
|
{
|
||||||
|
session_key: 9472,
|
||||||
|
driver_number: 44,
|
||||||
|
meeting_key: 1229,
|
||||||
|
lap_number: 2,
|
||||||
|
date_start: '2025-05-25T13:01:34.000Z',
|
||||||
|
lap_duration: null,
|
||||||
|
is_pit_out_lap: true,
|
||||||
|
},
|
||||||
|
{
|
||||||
|
session_key: 9472,
|
||||||
|
driver_number: 44,
|
||||||
|
meeting_key: 1229,
|
||||||
|
lap_number: 3,
|
||||||
|
date_start: '2025-05-25T13:03:10.000Z',
|
||||||
|
lap_duration: 91.2,
|
||||||
|
is_pit_out_lap: false,
|
||||||
|
},
|
||||||
|
],
|
||||||
|
},
|
||||||
|
],
|
||||||
|
}
|
||||||
|
|
||||||
|
const nextSessionResults: EnrichedResult[] = [
|
||||||
|
{
|
||||||
|
driver_number: 16,
|
||||||
|
position: 1,
|
||||||
|
name_acronym: 'LEC',
|
||||||
|
full_name: 'Charles Leclerc',
|
||||||
|
team_name: 'Ferrari',
|
||||||
|
team_colour: 'E8002D',
|
||||||
|
dnf: false,
|
||||||
|
dns: false,
|
||||||
|
dsq: false,
|
||||||
|
duration: null,
|
||||||
|
gap_to_leader: null,
|
||||||
|
number_of_laps: 57,
|
||||||
|
points: 25,
|
||||||
|
session_key: 9550,
|
||||||
|
meeting_key: 1234,
|
||||||
|
},
|
||||||
|
{
|
||||||
|
driver_number: 55,
|
||||||
|
position: 2,
|
||||||
|
name_acronym: 'SAI',
|
||||||
|
full_name: 'Carlos Sainz',
|
||||||
|
team_name: 'Williams',
|
||||||
|
team_colour: '64C4FF',
|
||||||
|
dnf: false,
|
||||||
|
dns: false,
|
||||||
|
dsq: false,
|
||||||
|
duration: null,
|
||||||
|
gap_to_leader: 3.2,
|
||||||
|
number_of_laps: 57,
|
||||||
|
points: 18,
|
||||||
|
session_key: 9550,
|
||||||
|
meeting_key: 1234,
|
||||||
|
},
|
||||||
|
]
|
||||||
|
|
||||||
|
const nextSessionDrivers: Driver[] = [
|
||||||
|
{
|
||||||
|
driver_number: 16,
|
||||||
|
name_acronym: 'LEC',
|
||||||
|
full_name: 'Charles Leclerc',
|
||||||
|
first_name: 'Charles',
|
||||||
|
last_name: 'Leclerc',
|
||||||
|
team_name: 'Ferrari',
|
||||||
|
team_colour: 'E8002D',
|
||||||
|
headshot_url: '',
|
||||||
|
broadcast_name: 'C LECLERC',
|
||||||
|
session_key: 9550,
|
||||||
|
meeting_key: 1234,
|
||||||
|
},
|
||||||
|
{
|
||||||
|
driver_number: 55,
|
||||||
|
name_acronym: 'SAI',
|
||||||
|
full_name: 'Carlos Sainz',
|
||||||
|
first_name: 'Carlos',
|
||||||
|
last_name: 'Sainz',
|
||||||
|
team_name: 'Williams',
|
||||||
|
team_colour: '64C4FF',
|
||||||
|
headshot_url: '',
|
||||||
|
broadcast_name: 'C SAINZ',
|
||||||
|
session_key: 9550,
|
||||||
|
meeting_key: 1234,
|
||||||
|
},
|
||||||
|
]
|
||||||
|
|
||||||
|
function renderCompareView(
|
||||||
|
props: {
|
||||||
|
sessionKey?: number
|
||||||
|
results?: EnrichedResult[]
|
||||||
|
drivers?: Driver[]
|
||||||
|
} = {},
|
||||||
|
) {
|
||||||
|
const client = new QueryClient({
|
||||||
|
defaultOptions: { queries: { retry: false } },
|
||||||
|
})
|
||||||
|
return render(
|
||||||
|
<QueryClientProvider client={client}>
|
||||||
|
<CompareView
|
||||||
|
sessionKey={props.sessionKey ?? 9472}
|
||||||
|
results={props.results ?? results}
|
||||||
|
drivers={props.drivers ?? drivers}
|
||||||
|
/>
|
||||||
|
</QueryClientProvider>,
|
||||||
|
)
|
||||||
|
}
|
||||||
|
|
||||||
|
describe('compare mapping helpers', () => {
|
||||||
|
it('defaults to top two finishers', () => {
|
||||||
|
expect(defaultCompareDriverNumbers(results, drivers)).toEqual([1, 44])
|
||||||
|
})
|
||||||
|
|
||||||
|
it('maps comparison laps to delta series with null pit laps', () => {
|
||||||
|
const series = comparisonToDeltaSeries(comparison, [1, 44], drivers)
|
||||||
|
expect(series).toHaveLength(2)
|
||||||
|
expect(series[0].label).toBe('VER')
|
||||||
|
expect(series[1].lapTimes[1]).toBeNull()
|
||||||
|
|
||||||
|
const deltas = computeCumulativeDeltas(series, 'VER')
|
||||||
|
expect(deltas[0].deltas[0]).toBeCloseTo(0.9)
|
||||||
|
})
|
||||||
|
|
||||||
|
it('maps car data to trace series', () => {
|
||||||
|
const trace = carDataToTraceSeries(
|
||||||
|
[
|
||||||
|
{
|
||||||
|
speed: 300,
|
||||||
|
throttle: 100,
|
||||||
|
brake: 0,
|
||||||
|
date: '',
|
||||||
|
driver_number: 1,
|
||||||
|
drs: 0,
|
||||||
|
meeting_key: 1,
|
||||||
|
n_gear: 8,
|
||||||
|
rpm: 12000,
|
||||||
|
session_key: 1,
|
||||||
|
},
|
||||||
|
],
|
||||||
|
'VER',
|
||||||
|
'#3671C6',
|
||||||
|
)
|
||||||
|
expect(trace.samples[0]).toEqual({ speed: 300, throttle: 100, brake: 0 })
|
||||||
|
})
|
||||||
|
|
||||||
|
it('filters car data to best lap window', () => {
|
||||||
|
const best = findBestLap(comparison.drivers[0].laps)
|
||||||
|
expect(best?.lap_number).toBe(2)
|
||||||
|
|
||||||
|
const samples = [
|
||||||
|
{
|
||||||
|
date: '2025-05-25T13:01:32.100Z',
|
||||||
|
speed: 280,
|
||||||
|
throttle: 90,
|
||||||
|
brake: 0,
|
||||||
|
driver_number: 1,
|
||||||
|
drs: 0,
|
||||||
|
meeting_key: 1229,
|
||||||
|
n_gear: 7,
|
||||||
|
rpm: 11000,
|
||||||
|
session_key: 9472,
|
||||||
|
},
|
||||||
|
{
|
||||||
|
date: '2025-05-25T13:00:00.000Z',
|
||||||
|
speed: 200,
|
||||||
|
throttle: 50,
|
||||||
|
brake: 10,
|
||||||
|
driver_number: 1,
|
||||||
|
drs: 0,
|
||||||
|
meeting_key: 1229,
|
||||||
|
n_gear: 4,
|
||||||
|
rpm: 9000,
|
||||||
|
session_key: 9472,
|
||||||
|
},
|
||||||
|
]
|
||||||
|
|
||||||
|
const filtered = filterCarDataToLap(samples, best!)
|
||||||
|
expect(filtered).toHaveLength(1)
|
||||||
|
expect(filtered[0].speed).toBe(280)
|
||||||
|
})
|
||||||
|
|
||||||
|
it('builds best-lap trace series from car data and laps', () => {
|
||||||
|
const series = buildBestLapTraceSeries(
|
||||||
|
[
|
||||||
|
{
|
||||||
|
date: '2025-05-25T13:01:33.000Z',
|
||||||
|
speed: 310,
|
||||||
|
throttle: 100,
|
||||||
|
brake: 0,
|
||||||
|
driver_number: 1,
|
||||||
|
drs: 10,
|
||||||
|
meeting_key: 1229,
|
||||||
|
n_gear: 8,
|
||||||
|
rpm: 12000,
|
||||||
|
session_key: 9472,
|
||||||
|
},
|
||||||
|
],
|
||||||
|
comparison.drivers[0].laps,
|
||||||
|
'VER',
|
||||||
|
'#3671C6',
|
||||||
|
)
|
||||||
|
expect(series?.samples).toHaveLength(1)
|
||||||
|
expect(series?.samples[0].speed).toBe(310)
|
||||||
|
})
|
||||||
|
|
||||||
|
it('maps laps to lap time arrays with nulls', () => {
|
||||||
|
expect(lapsToLapTimes(comparison.drivers[1].laps)).toEqual([93.0, null, 91.2])
|
||||||
|
})
|
||||||
|
|
||||||
|
it('formats pit lap captions', () => {
|
||||||
|
expect(formatPitLapsCaption(comparison.pit_laps, [1, 44], comparison, drivers)).toBe(
|
||||||
|
'Pit stops — HAM: L19, L40',
|
||||||
|
)
|
||||||
|
})
|
||||||
|
})
|
||||||
|
|
||||||
|
describe('CompareView', () => {
|
||||||
|
beforeEach(() => {
|
||||||
|
vi.clearAllMocks()
|
||||||
|
mockFetchLapsComparison.mockResolvedValue(comparison)
|
||||||
|
mockFetchTelemetry.mockResolvedValue([
|
||||||
|
{
|
||||||
|
date: '2025-05-25T13:01:33.000Z',
|
||||||
|
speed: 310,
|
||||||
|
throttle: 100,
|
||||||
|
brake: 0,
|
||||||
|
driver_number: 1,
|
||||||
|
drs: 10,
|
||||||
|
meeting_key: 1229,
|
||||||
|
n_gear: 8,
|
||||||
|
rpm: 12000,
|
||||||
|
session_key: 9472,
|
||||||
|
},
|
||||||
|
])
|
||||||
|
})
|
||||||
|
|
||||||
|
it('renders pickers defaulting to top two finishers', async () => {
|
||||||
|
renderCompareView()
|
||||||
|
expect(screen.getByTestId('compare-picker-a')).toHaveValue('1')
|
||||||
|
expect(screen.getByTestId('compare-picker-b')).toHaveValue('44')
|
||||||
|
expect(screen.getAllByText('VER').length).toBeGreaterThan(0)
|
||||||
|
expect(screen.getAllByText('HAM').length).toBeGreaterThan(0)
|
||||||
|
})
|
||||||
|
|
||||||
|
it('resets the selected pair when the mounted session changes', async () => {
|
||||||
|
const { rerender } = renderCompareView()
|
||||||
|
|
||||||
|
fireEvent.change(screen.getByTestId('compare-picker-a'), { target: { value: '44' } })
|
||||||
|
expect(screen.getByTestId('compare-picker-a')).toHaveValue('44')
|
||||||
|
|
||||||
|
rerender(
|
||||||
|
<QueryClientProvider client={new QueryClient({ defaultOptions: { queries: { retry: false } } })}>
|
||||||
|
<CompareView
|
||||||
|
sessionKey={9550}
|
||||||
|
results={nextSessionResults}
|
||||||
|
drivers={nextSessionDrivers}
|
||||||
|
/>
|
||||||
|
</QueryClientProvider>,
|
||||||
|
)
|
||||||
|
|
||||||
|
await waitFor(() => {
|
||||||
|
expect(screen.getByTestId('compare-picker-a')).toHaveValue('16')
|
||||||
|
expect(screen.getByTestId('compare-picker-b')).toHaveValue('55')
|
||||||
|
})
|
||||||
|
})
|
||||||
|
|
||||||
|
it('renders telemetry and pace sections with mocked queries', async () => {
|
||||||
|
renderCompareView()
|
||||||
|
|
||||||
|
await waitFor(() => {
|
||||||
|
expect(mockFetchLapsComparison).toHaveBeenCalledWith(9472, [1, 44])
|
||||||
|
})
|
||||||
|
|
||||||
|
await waitFor(() => {
|
||||||
|
expect(screen.getByTestId('telemetry-trace')).toBeInTheDocument()
|
||||||
|
})
|
||||||
|
|
||||||
|
expect(screen.getByTestId('delta-time-graph')).toBeInTheDocument()
|
||||||
|
expect(screen.getByTestId('compare-pit-caption')).toHaveTextContent('HAM: L19, L40')
|
||||||
|
})
|
||||||
|
|
||||||
|
it('shows error state when comparison fetch fails', async () => {
|
||||||
|
mockFetchLapsComparison.mockRejectedValue(new Error('comparison unavailable'))
|
||||||
|
renderCompareView()
|
||||||
|
|
||||||
|
await waitFor(() => {
|
||||||
|
expect(screen.getByText('comparison unavailable')).toBeInTheDocument()
|
||||||
|
})
|
||||||
|
})
|
||||||
|
|
||||||
|
it('shows empty state when fewer than two drivers', () => {
|
||||||
|
const client = new QueryClient({ defaultOptions: { queries: { retry: false } } })
|
||||||
|
render(
|
||||||
|
<QueryClientProvider client={client}>
|
||||||
|
<CompareView sessionKey={9472} results={[]} drivers={[drivers[0]]} />
|
||||||
|
</QueryClientProvider>,
|
||||||
|
)
|
||||||
|
expect(screen.getByTestId('compare-view-empty')).toBeInTheDocument()
|
||||||
|
})
|
||||||
|
})
|
||||||
196
frontend/src/test/delta-time-graph.test.tsx
Normal file
196
frontend/src/test/delta-time-graph.test.tsx
Normal file
@@ -0,0 +1,196 @@
|
|||||||
|
import { describe, expect, it, vi } from 'vitest'
|
||||||
|
import { render, screen, fireEvent } from '@testing-library/react'
|
||||||
|
import { DeltaTimeGraph } from '../components/charts/DeltaTimeGraph'
|
||||||
|
import {
|
||||||
|
computeCumulativeDeltas,
|
||||||
|
deltaPolylineSegments,
|
||||||
|
formatDeltaSeconds,
|
||||||
|
type DeltaSeries,
|
||||||
|
} from '../lib/delta'
|
||||||
|
|
||||||
|
const reference: DeltaSeries = {
|
||||||
|
label: 'VER',
|
||||||
|
color: '#3671C6',
|
||||||
|
lapTimes: [90, 91, 92],
|
||||||
|
}
|
||||||
|
|
||||||
|
const challenger: DeltaSeries = {
|
||||||
|
label: 'HAM',
|
||||||
|
color: '#E8002D',
|
||||||
|
lapTimes: [89, 92, 90],
|
||||||
|
}
|
||||||
|
|
||||||
|
describe('formatDeltaSeconds', () => {
|
||||||
|
it('formats signed deltas with one decimal and s suffix', () => {
|
||||||
|
expect(formatDeltaSeconds(2.5)).toBe('+2.5s')
|
||||||
|
expect(formatDeltaSeconds(-1.2)).toBe('-1.2s')
|
||||||
|
expect(formatDeltaSeconds(0)).toBe('+0.0s')
|
||||||
|
})
|
||||||
|
})
|
||||||
|
|
||||||
|
describe('computeCumulativeDeltas', () => {
|
||||||
|
it('computes cumulative delta vs the first series by default', () => {
|
||||||
|
const result = computeCumulativeDeltas([reference, challenger])
|
||||||
|
expect(result).toHaveLength(1)
|
||||||
|
expect(result[0].label).toBe('HAM')
|
||||||
|
// Lap 1: 89-90=-1, Lap 2: (89+92)-(90+91)=0, Lap 3: (89+92+90)-(90+91+92)=-2
|
||||||
|
expect(result[0].deltas[0]).toBeCloseTo(-1)
|
||||||
|
expect(result[0].deltas[1]).toBeCloseTo(0)
|
||||||
|
expect(result[0].deltas[2]).toBeCloseTo(-2)
|
||||||
|
})
|
||||||
|
|
||||||
|
it('respects an explicit reference label', () => {
|
||||||
|
const result = computeCumulativeDeltas([reference, challenger], 'HAM')
|
||||||
|
expect(result).toHaveLength(1)
|
||||||
|
expect(result[0].label).toBe('VER')
|
||||||
|
expect(result[0].deltas[0]).toBeCloseTo(1)
|
||||||
|
expect(result[0].deltas[2]).toBeCloseTo(2)
|
||||||
|
})
|
||||||
|
|
||||||
|
it('emits null for challenger missing lap times while carrying cumulative forward', () => {
|
||||||
|
const withNull: DeltaSeries = {
|
||||||
|
label: 'NOR',
|
||||||
|
color: '#FF8000',
|
||||||
|
lapTimes: [88, null, 93],
|
||||||
|
}
|
||||||
|
const result = computeCumulativeDeltas([reference, withNull])
|
||||||
|
expect(result[0].deltas[0]).toBeCloseTo(-2)
|
||||||
|
expect(result[0].deltas[1]).toBeNull()
|
||||||
|
// After null: NOR cum=181, VER cum=273 → delta -92
|
||||||
|
expect(result[0].deltas[2]).toBeCloseTo(-92)
|
||||||
|
})
|
||||||
|
|
||||||
|
it('gaps all drivers when the reference lap is null and resumes without that window', () => {
|
||||||
|
const refWithNull: DeltaSeries = {
|
||||||
|
label: 'VER',
|
||||||
|
color: '#3671C6',
|
||||||
|
lapTimes: [90, null, 92],
|
||||||
|
}
|
||||||
|
const validChallenger: DeltaSeries = {
|
||||||
|
label: 'HAM',
|
||||||
|
color: '#E8002D',
|
||||||
|
lapTimes: [89, 91, 90],
|
||||||
|
}
|
||||||
|
const result = computeCumulativeDeltas([refWithNull, validChallenger])
|
||||||
|
expect(result[0].deltas[0]).toBeCloseTo(-1)
|
||||||
|
expect(result[0].deltas[1]).toBeNull()
|
||||||
|
// Lap 3 excludes the reference-null window for both: (89+90) - (90+92) = -3
|
||||||
|
expect(result[0].deltas[2]).toBeCloseTo(-3)
|
||||||
|
})
|
||||||
|
|
||||||
|
it('gaps challenger laps beyond a shorter reference series', () => {
|
||||||
|
const shortReference: DeltaSeries = {
|
||||||
|
label: 'VER',
|
||||||
|
color: '#3671C6',
|
||||||
|
lapTimes: [90, 91],
|
||||||
|
}
|
||||||
|
const longerChallenger: DeltaSeries = {
|
||||||
|
label: 'HAM',
|
||||||
|
color: '#E8002D',
|
||||||
|
lapTimes: [89, 92, 90],
|
||||||
|
}
|
||||||
|
const result = computeCumulativeDeltas([shortReference, longerChallenger])
|
||||||
|
expect(result[0].deltas[0]).toBeCloseTo(-1)
|
||||||
|
expect(result[0].deltas[1]).toBeCloseTo(0)
|
||||||
|
expect(result[0].deltas[2]).toBeNull()
|
||||||
|
})
|
||||||
|
|
||||||
|
it('returns an empty array when only one series is provided', () => {
|
||||||
|
expect(computeCumulativeDeltas([reference])).toEqual([])
|
||||||
|
})
|
||||||
|
})
|
||||||
|
|
||||||
|
describe('deltaPolylineSegments', () => {
|
||||||
|
it('splits polylines at null laps', () => {
|
||||||
|
const segments = deltaPolylineSegments(
|
||||||
|
[1, null, 2],
|
||||||
|
(lap, delta) => `${lap},${delta}`,
|
||||||
|
)
|
||||||
|
expect(segments).toEqual(['0,1', '2,2'])
|
||||||
|
})
|
||||||
|
})
|
||||||
|
|
||||||
|
describe('DeltaTimeGraph', () => {
|
||||||
|
it('renders an empty state with no series', () => {
|
||||||
|
render(<DeltaTimeGraph series={[]} />)
|
||||||
|
expect(screen.getByTestId('delta-time-graph-empty')).toBeInTheDocument()
|
||||||
|
expect(screen.getByText(/No lap data/i)).toBeInTheDocument()
|
||||||
|
})
|
||||||
|
|
||||||
|
it('renders an empty state with only the reference driver', () => {
|
||||||
|
render(<DeltaTimeGraph series={[reference]} />)
|
||||||
|
expect(screen.getByTestId('delta-time-graph-empty')).toBeInTheDocument()
|
||||||
|
expect(screen.getByText(/at least two drivers/i)).toBeInTheDocument()
|
||||||
|
})
|
||||||
|
|
||||||
|
it('renders a zero line and one polyline per non-reference driver', () => {
|
||||||
|
const { container } = render(<DeltaTimeGraph series={[reference, challenger]} />)
|
||||||
|
expect(screen.getByTestId('delta-time-graph')).toBeInTheDocument()
|
||||||
|
expect(container.querySelector('[data-testid="delta-zero-line"]')).toBeInTheDocument()
|
||||||
|
expect(screen.getByTestId('delta-line-HAM')).toBeInTheDocument()
|
||||||
|
expect(container.querySelectorAll('.delta-graph-driver-line')).toHaveLength(1)
|
||||||
|
expect(screen.queryByTestId('delta-line-VER')).not.toBeInTheDocument()
|
||||||
|
})
|
||||||
|
|
||||||
|
it('splits polylines at reference-null laps', () => {
|
||||||
|
const refWithNull: DeltaSeries = {
|
||||||
|
label: 'VER',
|
||||||
|
color: '#3671C6',
|
||||||
|
lapTimes: [90, null, 92],
|
||||||
|
}
|
||||||
|
const { container } = render(
|
||||||
|
<DeltaTimeGraph series={[refWithNull, challenger]} />,
|
||||||
|
)
|
||||||
|
const lines = container.querySelectorAll('.delta-graph-driver-line')
|
||||||
|
expect(lines.length).toBeGreaterThan(1)
|
||||||
|
})
|
||||||
|
|
||||||
|
it('shows a crosshair tooltip on hover', () => {
|
||||||
|
vi.spyOn(SVGSVGElement.prototype, 'getBoundingClientRect').mockReturnValue({
|
||||||
|
x: 0,
|
||||||
|
y: 0,
|
||||||
|
left: 0,
|
||||||
|
top: 0,
|
||||||
|
width: 640,
|
||||||
|
height: 220,
|
||||||
|
right: 640,
|
||||||
|
bottom: 220,
|
||||||
|
toJSON: () => ({}),
|
||||||
|
})
|
||||||
|
const { container } = render(<DeltaTimeGraph series={[reference, challenger]} />)
|
||||||
|
const hoverLayer = container.querySelector('.delta-graph-hover-layer')
|
||||||
|
expect(hoverLayer).toBeTruthy()
|
||||||
|
fireEvent.mouseMove(hoverLayer!, { clientX: 44, clientY: 100 })
|
||||||
|
expect(screen.getByTestId('delta-crosshair')).toBeInTheDocument()
|
||||||
|
expect(screen.getByTestId('delta-tooltip')).toBeInTheDocument()
|
||||||
|
expect(screen.getByText(/Lap 1/)).toBeInTheDocument()
|
||||||
|
vi.restoreAllMocks()
|
||||||
|
})
|
||||||
|
|
||||||
|
it('omits tooltip rows on reference-null laps', () => {
|
||||||
|
vi.spyOn(SVGSVGElement.prototype, 'getBoundingClientRect').mockReturnValue({
|
||||||
|
x: 0,
|
||||||
|
y: 0,
|
||||||
|
left: 0,
|
||||||
|
top: 0,
|
||||||
|
width: 640,
|
||||||
|
height: 220,
|
||||||
|
right: 640,
|
||||||
|
bottom: 220,
|
||||||
|
toJSON: () => ({}),
|
||||||
|
})
|
||||||
|
const refWithNull: DeltaSeries = {
|
||||||
|
label: 'VER',
|
||||||
|
color: '#3671C6',
|
||||||
|
lapTimes: [90, null, 92],
|
||||||
|
}
|
||||||
|
const { container } = render(
|
||||||
|
<DeltaTimeGraph series={[refWithNull, challenger]} />,
|
||||||
|
)
|
||||||
|
const hoverLayer = container.querySelector('.delta-graph-hover-layer')
|
||||||
|
fireEvent.mouseMove(hoverLayer!, { clientX: 352, clientY: 100 })
|
||||||
|
expect(screen.getByTestId('delta-crosshair')).toBeInTheDocument()
|
||||||
|
expect(screen.queryByTestId('delta-tooltip')).not.toBeInTheDocument()
|
||||||
|
vi.restoreAllMocks()
|
||||||
|
})
|
||||||
|
})
|
||||||
268
frontend/src/test/events.test.ts
Normal file
268
frontend/src/test/events.test.ts
Normal file
@@ -0,0 +1,268 @@
|
|||||||
|
import { describe, expect, it } from 'vitest'
|
||||||
|
import {
|
||||||
|
MAX_EVENTS,
|
||||||
|
appendEvents,
|
||||||
|
diffSnapshots,
|
||||||
|
humanizeRaceControl,
|
||||||
|
sessionSignature,
|
||||||
|
} from '../lib/events'
|
||||||
|
import type { LiveEvent } from '../lib/events'
|
||||||
|
import type {
|
||||||
|
LiveDriverData,
|
||||||
|
LiveDriverInfo,
|
||||||
|
LiveRCMessage,
|
||||||
|
LiveStreamData,
|
||||||
|
} from '../types'
|
||||||
|
|
||||||
|
function driver(number: string, position: number, overrides: Partial<LiveDriverData> = {}): LiveDriverData {
|
||||||
|
return {
|
||||||
|
RacingNumber: number,
|
||||||
|
Position: position,
|
||||||
|
PrevPosition: position,
|
||||||
|
GapToLeader: '',
|
||||||
|
Interval: '',
|
||||||
|
LastLapTime: '',
|
||||||
|
LastLapPB: false,
|
||||||
|
LastLapOB: false,
|
||||||
|
BestLapTime: '',
|
||||||
|
BestLapPB: false,
|
||||||
|
BestLapOB: false,
|
||||||
|
BestLapNum: 0,
|
||||||
|
InPit: false,
|
||||||
|
PitOut: false,
|
||||||
|
Retired: false,
|
||||||
|
KnockedOut: false,
|
||||||
|
Cutoff: false,
|
||||||
|
OnFlyingLap: false,
|
||||||
|
NumberOfLaps: 10,
|
||||||
|
SpeedTrap: '',
|
||||||
|
Sectors: [],
|
||||||
|
...overrides,
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function info(number: string, tla: string): LiveDriverInfo {
|
||||||
|
return {
|
||||||
|
RacingNumber: number,
|
||||||
|
BroadcastName: tla,
|
||||||
|
Tla: tla,
|
||||||
|
TeamName: '',
|
||||||
|
TeamColour: '3671C6',
|
||||||
|
FirstName: '',
|
||||||
|
LastName: '',
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function snapshot(
|
||||||
|
drivers: Record<string, LiveDriverData>,
|
||||||
|
overrides: Partial<LiveStreamData> = {},
|
||||||
|
): LiveStreamData {
|
||||||
|
return {
|
||||||
|
Drivers: drivers,
|
||||||
|
DriverInfo: {
|
||||||
|
'1': info('1', 'VER'),
|
||||||
|
'4': info('4', 'NOR'),
|
||||||
|
'44': info('44', 'HAM'),
|
||||||
|
},
|
||||||
|
Tyres: {},
|
||||||
|
RCMessages: [],
|
||||||
|
TeamRadio: [],
|
||||||
|
Weather: {} as LiveStreamData['Weather'],
|
||||||
|
Session: {
|
||||||
|
MeetingName: 'Test Grand Prix',
|
||||||
|
CircuitName: 'Test Circuit',
|
||||||
|
SessionType: 'Race',
|
||||||
|
SessionName: 'Race',
|
||||||
|
Path: '',
|
||||||
|
},
|
||||||
|
TrackStatus: '1',
|
||||||
|
CurrentLap: 12,
|
||||||
|
TotalLaps: 57,
|
||||||
|
Clock: '01:23:45',
|
||||||
|
ClockRefTime: '',
|
||||||
|
ClockExtrapolating: false,
|
||||||
|
Stints: {},
|
||||||
|
...overrides,
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
function rc(message: string, category: string, overrides: Partial<LiveRCMessage> = {}): LiveRCMessage {
|
||||||
|
return { Time: '2026-07-03T14:00:00Z', Category: category, Flag: '', Message: message, Lap: 12, ...overrides }
|
||||||
|
}
|
||||||
|
|
||||||
|
describe('diffSnapshots', () => {
|
||||||
|
it('returns no events for identical snapshots', () => {
|
||||||
|
const prev = snapshot({ '1': driver('1', 1), '44': driver('44', 2) })
|
||||||
|
const next = snapshot({ '1': driver('1', 1), '44': driver('44', 2) })
|
||||||
|
expect(diffSnapshots(prev, next)).toEqual([])
|
||||||
|
})
|
||||||
|
|
||||||
|
it('reports an overtake when two drivers swap positions', () => {
|
||||||
|
const prev = snapshot({ '1': driver('1', 3), '44': driver('44', 2) })
|
||||||
|
const next = snapshot({ '1': driver('1', 2), '44': driver('44', 3) })
|
||||||
|
const events = diffSnapshots(prev, next)
|
||||||
|
expect(events).toHaveLength(1)
|
||||||
|
expect(events[0].kind).toBe('overtake')
|
||||||
|
expect(events[0].headline).toBe('VER overtakes HAM for P2')
|
||||||
|
expect(events[0].racingNumbers).toEqual(['1', '44'])
|
||||||
|
expect(events[0].lap).toBe(12)
|
||||||
|
})
|
||||||
|
|
||||||
|
it('reports a generic gain when the displaced driver pitted instead', () => {
|
||||||
|
const prev = snapshot({ '1': driver('1', 3), '44': driver('44', 2) })
|
||||||
|
const next = snapshot({ '1': driver('1', 2), '44': driver('44', 5, { InPit: true }) })
|
||||||
|
const events = diffSnapshots(prev, next)
|
||||||
|
const gain = events.find((event) => event.kind === 'position-gain')
|
||||||
|
expect(gain?.headline).toBe('VER moves up to P2 (from P3)')
|
||||||
|
// HAM's drop is covered by the pit-in event, not a position-loss one.
|
||||||
|
expect(events.some((event) => event.kind === 'position-loss')).toBe(false)
|
||||||
|
expect(events.some((event) => event.kind === 'pit-in')).toBe(true)
|
||||||
|
})
|
||||||
|
|
||||||
|
it('reports a position loss not explained by an overtake or pit stop', () => {
|
||||||
|
const prev = snapshot({ '44': driver('44', 3) })
|
||||||
|
const next = snapshot({ '44': driver('44', 6) })
|
||||||
|
const events = diffSnapshots(prev, next)
|
||||||
|
expect(events).toHaveLength(1)
|
||||||
|
expect(events[0].kind).toBe('position-loss')
|
||||||
|
expect(events[0].headline).toBe('HAM drops to P6 (from P3)')
|
||||||
|
})
|
||||||
|
|
||||||
|
it('reports pit entry with the position pitted from', () => {
|
||||||
|
const prev = snapshot({ '4': driver('4', 3) })
|
||||||
|
const next = snapshot({ '4': driver('4', 3, { InPit: true }) })
|
||||||
|
const events = diffSnapshots(prev, next)
|
||||||
|
expect(events).toHaveLength(1)
|
||||||
|
expect(events[0].kind).toBe('pit-in')
|
||||||
|
expect(events[0].headline).toBe('NOR pits from P3')
|
||||||
|
expect(events[0].racingNumbers).toEqual(['4'])
|
||||||
|
})
|
||||||
|
|
||||||
|
it('reports pit exit with rejoin position, compound, and stop count', () => {
|
||||||
|
const prev = snapshot({ '4': driver('4', 3, { InPit: true }) })
|
||||||
|
const next = snapshot(
|
||||||
|
{ '4': driver('4', 6, { PitOut: true }) },
|
||||||
|
{
|
||||||
|
Tyres: { '4': { Compound: 'MEDIUM', New: true, Age: 0 } },
|
||||||
|
Stints: {
|
||||||
|
'4': [
|
||||||
|
{ Compound: 'SOFT', New: true, Laps: 12 },
|
||||||
|
{ Compound: 'HARD', New: true, Laps: 20 },
|
||||||
|
{ Compound: 'MEDIUM', New: true, Laps: 0 },
|
||||||
|
],
|
||||||
|
},
|
||||||
|
},
|
||||||
|
)
|
||||||
|
const events = diffSnapshots(prev, next)
|
||||||
|
expect(events).toHaveLength(1)
|
||||||
|
expect(events[0].kind).toBe('pit-out')
|
||||||
|
expect(events[0].headline).toBe('NOR rejoins P6 (MEDIUM, 2nd stop)')
|
||||||
|
})
|
||||||
|
|
||||||
|
it('reports personal and overall best laps once per lap time', () => {
|
||||||
|
const prev = snapshot({
|
||||||
|
'1': driver('1', 1, { LastLapTime: '1:24.500' }),
|
||||||
|
'4': driver('4', 2, { LastLapTime: '1:25.100' }),
|
||||||
|
})
|
||||||
|
const next = snapshot({
|
||||||
|
'1': driver('1', 1, { LastLapTime: '1:23.456', LastLapPB: true, LastLapOB: true }),
|
||||||
|
'4': driver('4', 2, { LastLapTime: '1:24.900', LastLapPB: true }),
|
||||||
|
})
|
||||||
|
const events = diffSnapshots(prev, next)
|
||||||
|
const fastest = events.find((event) => event.kind === 'fastest-lap')
|
||||||
|
const personal = events.find((event) => event.kind === 'personal-best')
|
||||||
|
expect(fastest?.headline).toBe('VER sets the fastest lap — 1:23.456')
|
||||||
|
expect(personal?.headline).toBe('NOR sets a personal best — 1:24.900')
|
||||||
|
// A repeat diff of the same state produces nothing new.
|
||||||
|
expect(diffSnapshots(next, snapshot(next.Drivers))).toEqual([])
|
||||||
|
})
|
||||||
|
|
||||||
|
it('reports a retirement with the last running position', () => {
|
||||||
|
const prev = snapshot({ '44': driver('44', 5) })
|
||||||
|
const next = snapshot({ '44': driver('44', 5, { Retired: true }) })
|
||||||
|
const events = diffSnapshots(prev, next)
|
||||||
|
expect(events).toHaveLength(1)
|
||||||
|
expect(events[0].kind).toBe('retirement')
|
||||||
|
expect(events[0].headline).toBe('HAM retires')
|
||||||
|
expect(events[0].detail).toBe('Was running P5')
|
||||||
|
})
|
||||||
|
|
||||||
|
it('reports track status transitions as human sentences', () => {
|
||||||
|
const prev = snapshot({ '1': driver('1', 1) })
|
||||||
|
const next = snapshot({ '1': driver('1', 1) }, { TrackStatus: '4' })
|
||||||
|
const events = diffSnapshots(prev, next)
|
||||||
|
expect(events).toHaveLength(1)
|
||||||
|
expect(events[0].kind).toBe('track-status')
|
||||||
|
expect(events[0].headline).toBe('Safety Car deployed')
|
||||||
|
})
|
||||||
|
|
||||||
|
it('reports new Flag/SafetyCar/Drs race-control messages and skips other categories', () => {
|
||||||
|
const existing = rc('YELLOW IN TRACK SECTOR 7', 'Flag', { Time: '2026-07-03T13:00:00Z' })
|
||||||
|
const prev = snapshot({ '1': driver('1', 1) }, { RCMessages: [existing] })
|
||||||
|
const next = snapshot({ '1': driver('1', 1) }, {
|
||||||
|
RCMessages: [
|
||||||
|
existing,
|
||||||
|
rc('DRS ENABLED', 'Drs'),
|
||||||
|
rc('FIA STEWARDS: CAR 4 (NOR) UNDER INVESTIGATION', 'Other'),
|
||||||
|
],
|
||||||
|
})
|
||||||
|
const events = diffSnapshots(prev, next)
|
||||||
|
expect(events).toHaveLength(1)
|
||||||
|
expect(events[0].kind).toBe('race-control')
|
||||||
|
expect(events[0].headline).toBe('DRS enabled')
|
||||||
|
})
|
||||||
|
|
||||||
|
it('produces stable ids across repeated diffs of the same snapshots', () => {
|
||||||
|
const prev = snapshot({ '1': driver('1', 3), '44': driver('44', 2) })
|
||||||
|
const next = snapshot({ '1': driver('1', 2), '44': driver('44', 3) })
|
||||||
|
const first = diffSnapshots(prev, next)
|
||||||
|
const second = diffSnapshots(prev, next)
|
||||||
|
expect(first.map((event) => event.id)).toEqual(second.map((event) => event.id))
|
||||||
|
})
|
||||||
|
})
|
||||||
|
|
||||||
|
describe('humanizeRaceControl', () => {
|
||||||
|
it('sentence-cases while preserving acronyms', () => {
|
||||||
|
expect(humanizeRaceControl('SAFETY CAR DEPLOYED')).toBe('Safety car deployed')
|
||||||
|
expect(humanizeRaceControl('DRS ENABLED')).toBe('DRS enabled')
|
||||||
|
expect(humanizeRaceControl('VSC DEPLOYED')).toBe('VSC deployed')
|
||||||
|
})
|
||||||
|
})
|
||||||
|
|
||||||
|
describe('appendEvents', () => {
|
||||||
|
const event = (id: string): LiveEvent => ({
|
||||||
|
id,
|
||||||
|
kind: 'race-control',
|
||||||
|
lap: 1,
|
||||||
|
timestamp: '',
|
||||||
|
headline: id,
|
||||||
|
racingNumbers: [],
|
||||||
|
})
|
||||||
|
|
||||||
|
it('prepends new events newest-first and dedups by id', () => {
|
||||||
|
const buffer = appendEvents([event('a')], [event('a'), event('b'), event('c')])
|
||||||
|
expect(buffer.map((entry) => entry.id)).toEqual(['c', 'b', 'a'])
|
||||||
|
// Re-appending the same diff output changes nothing.
|
||||||
|
const again = appendEvents(buffer, [event('b'), event('c')])
|
||||||
|
expect(again.map((entry) => entry.id)).toEqual(['c', 'b', 'a'])
|
||||||
|
})
|
||||||
|
|
||||||
|
it('evicts the oldest events beyond the cap', () => {
|
||||||
|
let buffer: LiveEvent[] = []
|
||||||
|
for (let index = 0; index < MAX_EVENTS + 5; index += 1) {
|
||||||
|
buffer = appendEvents(buffer, [event(`event-${index}`)])
|
||||||
|
}
|
||||||
|
expect(buffer).toHaveLength(MAX_EVENTS)
|
||||||
|
expect(buffer[0].id).toBe(`event-${MAX_EVENTS + 4}`)
|
||||||
|
expect(buffer[buffer.length - 1].id).toBe('event-5')
|
||||||
|
})
|
||||||
|
})
|
||||||
|
|
||||||
|
describe('sessionSignature', () => {
|
||||||
|
it('changes when the session changes, enabling buffer resets', () => {
|
||||||
|
const race = snapshot({}).Session
|
||||||
|
expect(sessionSignature(race)).toBe('Test Grand Prix|Race|Race')
|
||||||
|
expect(sessionSignature({ ...race, SessionName: 'Qualifying' })).not.toBe(sessionSignature(race))
|
||||||
|
expect(sessionSignature(null)).toBe('')
|
||||||
|
})
|
||||||
|
})
|
||||||
123
frontend/src/test/hero.test.ts
Normal file
123
frontend/src/test/hero.test.ts
Normal file
@@ -0,0 +1,123 @@
|
|||||||
|
import { describe, it, expect } from 'vitest'
|
||||||
|
import { heroState, classifySessionStatus } from '../lib/hero'
|
||||||
|
import { currentAndNextSession } from '../lib/schedule'
|
||||||
|
import type { Session } from '../types'
|
||||||
|
|
||||||
|
const session = (overrides: Partial<Session> = {}): Session => ({
|
||||||
|
session_key: 9472,
|
||||||
|
session_name: 'Race',
|
||||||
|
session_type: 'Race',
|
||||||
|
meeting_key: 1,
|
||||||
|
date_start: '2025-05-25T13:00:00+00:00',
|
||||||
|
date_end: '2025-05-25T15:00:00+00:00',
|
||||||
|
gmt_offset: '02:00:00',
|
||||||
|
...overrides,
|
||||||
|
})
|
||||||
|
|
||||||
|
describe('heroState', () => {
|
||||||
|
it('returns live when the live snapshot is active', () => {
|
||||||
|
const now = new Date('2025-05-24T12:00:00Z')
|
||||||
|
expect(
|
||||||
|
heroState({
|
||||||
|
now,
|
||||||
|
liveActive: true,
|
||||||
|
currentSession: null,
|
||||||
|
focusKind: 'current',
|
||||||
|
}),
|
||||||
|
).toBe('live')
|
||||||
|
})
|
||||||
|
|
||||||
|
it('returns live when a session is in progress', () => {
|
||||||
|
const now = new Date('2025-05-25T14:00:00Z')
|
||||||
|
const sessions = [session()]
|
||||||
|
const { current } = currentAndNextSession(sessions, now)
|
||||||
|
expect(
|
||||||
|
heroState({
|
||||||
|
now,
|
||||||
|
liveActive: false,
|
||||||
|
currentSession: current,
|
||||||
|
focusKind: 'current',
|
||||||
|
}),
|
||||||
|
).toBe('live')
|
||||||
|
})
|
||||||
|
|
||||||
|
it('returns upcoming during a focus weekend gap before the next session', () => {
|
||||||
|
const now = new Date('2025-05-24T12:00:00Z')
|
||||||
|
const sessions = [
|
||||||
|
session({
|
||||||
|
session_key: 1,
|
||||||
|
session_name: 'FP1',
|
||||||
|
date_start: '2025-05-23T10:00:00+00:00',
|
||||||
|
date_end: '2025-05-23T11:00:00+00:00',
|
||||||
|
}),
|
||||||
|
session({
|
||||||
|
session_key: 2,
|
||||||
|
session_name: 'Race',
|
||||||
|
date_start: '2025-05-25T13:00:00+00:00',
|
||||||
|
date_end: '2025-05-25T15:00:00+00:00',
|
||||||
|
}),
|
||||||
|
]
|
||||||
|
const { current, next } = currentAndNextSession(sessions, now)
|
||||||
|
expect(current).toBeNull()
|
||||||
|
expect(next?.session_key).toBe(2)
|
||||||
|
expect(
|
||||||
|
heroState({
|
||||||
|
now,
|
||||||
|
liveActive: false,
|
||||||
|
currentSession: current,
|
||||||
|
focusKind: 'current',
|
||||||
|
}),
|
||||||
|
).toBe('upcoming')
|
||||||
|
})
|
||||||
|
|
||||||
|
it('returns upcoming when the weekend just ended but is still the focus weekend', () => {
|
||||||
|
const now = new Date('2025-05-25T16:00:00Z')
|
||||||
|
const sessions = [session()]
|
||||||
|
const { current } = currentAndNextSession(sessions, now)
|
||||||
|
expect(current).toBeNull()
|
||||||
|
expect(
|
||||||
|
heroState({
|
||||||
|
now,
|
||||||
|
liveActive: false,
|
||||||
|
currentSession: current,
|
||||||
|
focusKind: 'current',
|
||||||
|
}),
|
||||||
|
).toBe('upcoming')
|
||||||
|
})
|
||||||
|
|
||||||
|
it('returns between before the next grand prix weekend', () => {
|
||||||
|
const now = new Date('2025-06-01T12:00:00Z')
|
||||||
|
expect(
|
||||||
|
heroState({
|
||||||
|
now,
|
||||||
|
liveActive: false,
|
||||||
|
currentSession: null,
|
||||||
|
focusKind: 'next',
|
||||||
|
}),
|
||||||
|
).toBe('between')
|
||||||
|
})
|
||||||
|
|
||||||
|
it('returns between after the season when only a recent meeting remains', () => {
|
||||||
|
const now = new Date('2026-01-01T00:00:00Z')
|
||||||
|
expect(
|
||||||
|
heroState({
|
||||||
|
now,
|
||||||
|
liveActive: false,
|
||||||
|
currentSession: null,
|
||||||
|
focusKind: 'recent',
|
||||||
|
}),
|
||||||
|
).toBe('between')
|
||||||
|
})
|
||||||
|
})
|
||||||
|
|
||||||
|
describe('classifySessionStatus', () => {
|
||||||
|
it('marks a session as done immediately after it ends', () => {
|
||||||
|
const now = new Date('2025-05-25T15:00:00Z')
|
||||||
|
expect(classifySessionStatus(session(), now)).toBe('done')
|
||||||
|
})
|
||||||
|
|
||||||
|
it('marks a session as live during its window', () => {
|
||||||
|
const now = new Date('2025-05-25T14:00:00Z')
|
||||||
|
expect(classifySessionStatus(session(), now)).toBe('live')
|
||||||
|
})
|
||||||
|
})
|
||||||
257
frontend/src/test/hero.test.tsx
Normal file
257
frontend/src/test/hero.test.tsx
Normal file
@@ -0,0 +1,257 @@
|
|||||||
|
import { describe, it, expect, vi } from 'vitest'
|
||||||
|
import type { ComponentProps, ReactNode } from 'react'
|
||||||
|
import { render, screen } from '@testing-library/react'
|
||||||
|
import type { EnrichedResult, LiveStreamData, Meeting, WeekendSession } from '../types'
|
||||||
|
|
||||||
|
vi.mock('@tanstack/react-router', () => ({
|
||||||
|
Link: ({
|
||||||
|
to,
|
||||||
|
children,
|
||||||
|
...rest
|
||||||
|
}: {
|
||||||
|
to: string
|
||||||
|
children: ReactNode
|
||||||
|
className?: string
|
||||||
|
'data-testid'?: string
|
||||||
|
}) => (
|
||||||
|
<a href={to} {...rest}>
|
||||||
|
{children}
|
||||||
|
</a>
|
||||||
|
),
|
||||||
|
}))
|
||||||
|
|
||||||
|
import { CommandCenterHero } from '../components/CommandCenterHero'
|
||||||
|
|
||||||
|
const focusMeeting: Meeting = {
|
||||||
|
meeting_key: 1229,
|
||||||
|
meeting_name: 'Monaco',
|
||||||
|
meeting_official_name: 'FORMULA 1 GRAND PRIX DE MONACO 2025',
|
||||||
|
location: 'Monaco',
|
||||||
|
country_name: 'Monaco',
|
||||||
|
country_code: 'MON',
|
||||||
|
country_flag: '',
|
||||||
|
circuit_short_name: 'Monaco',
|
||||||
|
date_start: '2025-05-23T00:00:00+00:00',
|
||||||
|
date_end: '2025-05-25T00:00:00+00:00',
|
||||||
|
year: 2025,
|
||||||
|
}
|
||||||
|
|
||||||
|
const weekendSessions: WeekendSession[] = [
|
||||||
|
{
|
||||||
|
session: {
|
||||||
|
session_key: 9472,
|
||||||
|
session_name: 'Race',
|
||||||
|
session_type: 'Race',
|
||||||
|
meeting_key: 1229,
|
||||||
|
date_start: '2025-05-25T13:00:00+00:00',
|
||||||
|
date_end: '2025-05-25T15:00:00+00:00',
|
||||||
|
gmt_offset: '02:00:00',
|
||||||
|
},
|
||||||
|
source: 'local',
|
||||||
|
datasets: {} as WeekendSession['datasets'],
|
||||||
|
},
|
||||||
|
]
|
||||||
|
|
||||||
|
const liveData: LiveStreamData = {
|
||||||
|
Drivers: {
|
||||||
|
'1': {
|
||||||
|
RacingNumber: '1',
|
||||||
|
Position: 1,
|
||||||
|
PrevPosition: 1,
|
||||||
|
GapToLeader: '',
|
||||||
|
Interval: '',
|
||||||
|
LastLapTime: '1:14.000',
|
||||||
|
LastLapPB: false,
|
||||||
|
LastLapOB: false,
|
||||||
|
BestLapTime: '1:13.500',
|
||||||
|
BestLapPB: false,
|
||||||
|
BestLapOB: false,
|
||||||
|
BestLapNum: 10,
|
||||||
|
InPit: false,
|
||||||
|
PitOut: false,
|
||||||
|
Retired: false,
|
||||||
|
KnockedOut: false,
|
||||||
|
Cutoff: false,
|
||||||
|
OnFlyingLap: false,
|
||||||
|
NumberOfLaps: 10,
|
||||||
|
SpeedTrap: '',
|
||||||
|
Sectors: [],
|
||||||
|
},
|
||||||
|
'44': {
|
||||||
|
RacingNumber: '44',
|
||||||
|
Position: 2,
|
||||||
|
PrevPosition: 2,
|
||||||
|
GapToLeader: '+1.2',
|
||||||
|
Interval: '+1.2',
|
||||||
|
LastLapTime: '1:14.200',
|
||||||
|
LastLapPB: false,
|
||||||
|
LastLapOB: false,
|
||||||
|
BestLapTime: '1:13.700',
|
||||||
|
BestLapPB: false,
|
||||||
|
BestLapOB: false,
|
||||||
|
BestLapNum: 10,
|
||||||
|
InPit: false,
|
||||||
|
PitOut: false,
|
||||||
|
Retired: false,
|
||||||
|
KnockedOut: false,
|
||||||
|
Cutoff: false,
|
||||||
|
OnFlyingLap: false,
|
||||||
|
NumberOfLaps: 10,
|
||||||
|
SpeedTrap: '',
|
||||||
|
Sectors: [],
|
||||||
|
},
|
||||||
|
},
|
||||||
|
DriverInfo: {
|
||||||
|
'1': {
|
||||||
|
RacingNumber: '1',
|
||||||
|
BroadcastName: 'M VERSTAPPEN',
|
||||||
|
Tla: 'VER',
|
||||||
|
TeamName: 'Red Bull Racing',
|
||||||
|
TeamColour: '3671c6',
|
||||||
|
FirstName: 'Max',
|
||||||
|
LastName: 'Verstappen',
|
||||||
|
},
|
||||||
|
'44': {
|
||||||
|
RacingNumber: '44',
|
||||||
|
BroadcastName: 'L HAMILTON',
|
||||||
|
Tla: 'HAM',
|
||||||
|
TeamName: 'Ferrari',
|
||||||
|
TeamColour: 'e8002d',
|
||||||
|
FirstName: 'Lewis',
|
||||||
|
LastName: 'Hamilton',
|
||||||
|
},
|
||||||
|
},
|
||||||
|
Tyres: {},
|
||||||
|
RCMessages: [],
|
||||||
|
Weather: {
|
||||||
|
AirTemp: 20,
|
||||||
|
TrackTemp: 30,
|
||||||
|
Humidity: 50,
|
||||||
|
WindSpeed: 1,
|
||||||
|
WindDir: 0,
|
||||||
|
Rainfall: false,
|
||||||
|
},
|
||||||
|
Session: {
|
||||||
|
MeetingName: 'Monaco',
|
||||||
|
CircuitName: 'Monaco',
|
||||||
|
SessionType: 'Race',
|
||||||
|
SessionName: 'Race',
|
||||||
|
},
|
||||||
|
TrackStatus: '1',
|
||||||
|
CurrentLap: 10,
|
||||||
|
TotalLaps: 78,
|
||||||
|
Clock: '',
|
||||||
|
ClockRefTime: '',
|
||||||
|
ClockExtrapolating: false,
|
||||||
|
Stints: {},
|
||||||
|
}
|
||||||
|
|
||||||
|
const podium: EnrichedResult[] = [
|
||||||
|
{
|
||||||
|
driver_number: 1,
|
||||||
|
position: 1,
|
||||||
|
name_acronym: 'VER',
|
||||||
|
full_name: 'Max Verstappen',
|
||||||
|
team_name: 'Red Bull Racing',
|
||||||
|
team_colour: '3671c6',
|
||||||
|
dnf: false,
|
||||||
|
dns: false,
|
||||||
|
dsq: false,
|
||||||
|
duration: 7200,
|
||||||
|
gap_to_leader: null,
|
||||||
|
number_of_laps: 78,
|
||||||
|
points: 25,
|
||||||
|
session_key: 9472,
|
||||||
|
meeting_key: 1229,
|
||||||
|
},
|
||||||
|
{
|
||||||
|
driver_number: 44,
|
||||||
|
position: 2,
|
||||||
|
name_acronym: 'HAM',
|
||||||
|
full_name: 'Lewis Hamilton',
|
||||||
|
team_name: 'Ferrari',
|
||||||
|
team_colour: 'e8002d',
|
||||||
|
dnf: false,
|
||||||
|
dns: false,
|
||||||
|
dsq: false,
|
||||||
|
duration: 7205,
|
||||||
|
gap_to_leader: 3.2,
|
||||||
|
number_of_laps: 78,
|
||||||
|
points: 18,
|
||||||
|
session_key: 9472,
|
||||||
|
meeting_key: 1229,
|
||||||
|
},
|
||||||
|
]
|
||||||
|
|
||||||
|
function renderHero(overrides: Partial<ComponentProps<typeof CommandCenterHero>> = {}) {
|
||||||
|
const props: ComponentProps<typeof CommandCenterHero> = {
|
||||||
|
state: 'upcoming',
|
||||||
|
now: new Date('2025-05-24T12:00:00Z'),
|
||||||
|
accent: '#d61a3e',
|
||||||
|
liveActive: false,
|
||||||
|
liveData: null,
|
||||||
|
focusMeeting,
|
||||||
|
focusKind: 'current',
|
||||||
|
sessions: weekendSessions,
|
||||||
|
currentSession: null,
|
||||||
|
nextSession: weekendSessions[0].session,
|
||||||
|
lastRaceName: '',
|
||||||
|
lastRacePodium: [],
|
||||||
|
nextMeeting: null,
|
||||||
|
...overrides,
|
||||||
|
}
|
||||||
|
|
||||||
|
return render(<CommandCenterHero {...props} />)
|
||||||
|
}
|
||||||
|
|
||||||
|
describe('CommandCenterHero', () => {
|
||||||
|
it('renders live timing link and top three in live state', () => {
|
||||||
|
renderHero({
|
||||||
|
state: 'live',
|
||||||
|
liveActive: true,
|
||||||
|
liveData,
|
||||||
|
currentSession: weekendSessions[0].session,
|
||||||
|
})
|
||||||
|
|
||||||
|
expect(screen.getByTestId('hero-live-link')).toHaveAttribute('href', '/live')
|
||||||
|
expect(screen.getByTestId('hero-live-timing')).toHaveTextContent('VER')
|
||||||
|
expect(screen.getByTestId('hero-live-timing')).toHaveTextContent('HAM')
|
||||||
|
expect(screen.getByText('TRACK CLEAR')).toBeInTheDocument()
|
||||||
|
})
|
||||||
|
|
||||||
|
it('renders countdown and schedule strip in upcoming state', () => {
|
||||||
|
renderHero({
|
||||||
|
state: 'upcoming',
|
||||||
|
nextSession: weekendSessions[0].session,
|
||||||
|
})
|
||||||
|
|
||||||
|
expect(screen.getByTestId('hero-countdown')).toHaveTextContent('1d 01h 00m 00s')
|
||||||
|
expect(screen.getByTestId('hero-schedule-strip')).toHaveTextContent('Race')
|
||||||
|
expect(screen.getByTestId('hero-schedule-strip')).toHaveTextContent('Next')
|
||||||
|
})
|
||||||
|
|
||||||
|
it('renders last race podium and next GP countdown in between state', () => {
|
||||||
|
const nextMeeting: Meeting = {
|
||||||
|
...focusMeeting,
|
||||||
|
meeting_key: 1301,
|
||||||
|
meeting_name: 'Canada',
|
||||||
|
country_code: 'CAN',
|
||||||
|
date_start: '2025-06-06T00:00:00+00:00',
|
||||||
|
date_end: '2025-06-08T00:00:00+00:00',
|
||||||
|
}
|
||||||
|
|
||||||
|
renderHero({
|
||||||
|
state: 'between',
|
||||||
|
lastRaceName: 'Monaco',
|
||||||
|
lastRacePodium: podium,
|
||||||
|
nextMeeting,
|
||||||
|
now: new Date('2025-06-01T12:00:00Z'),
|
||||||
|
})
|
||||||
|
|
||||||
|
expect(screen.getByTestId('hero-last-race')).toHaveTextContent('After Monaco')
|
||||||
|
expect(screen.getByTestId('hero-podium')).toHaveTextContent('VER')
|
||||||
|
expect(screen.getByTestId('hero-podium')).toHaveTextContent('HAM')
|
||||||
|
expect(screen.getByTestId('hero-next-gp-countdown')).toHaveTextContent('Canada')
|
||||||
|
expect(screen.getByTestId('hero-next-gp-countdown')).toHaveTextContent('4d')
|
||||||
|
})
|
||||||
|
})
|
||||||
@@ -100,7 +100,8 @@ const snapshot: LiveStreamData = {
|
|||||||
{ Time: '14:08', Category: 'Drs', Flag: '', Message: 'DRS ENABLED', Lap: 3 },
|
{ Time: '14:08', Category: 'Drs', Flag: '', Message: 'DRS ENABLED', Lap: 3 },
|
||||||
],
|
],
|
||||||
Weather: { AirTemp: 20, TrackTemp: 31, Humidity: 55, WindSpeed: 2, WindDir: 180, Rainfall: false },
|
Weather: { AirTemp: 20, TrackTemp: 31, Humidity: 55, WindSpeed: 2, WindDir: 180, Rainfall: false },
|
||||||
Session: { MeetingName: 'Monaco Grand Prix', CircuitName: 'Monaco', SessionType: 'Race', SessionName: 'Race' },
|
Session: { MeetingName: 'Monaco Grand Prix', CircuitName: 'Monaco', SessionType: 'Race', SessionName: 'Race', Path: '2026/Monaco/Race' },
|
||||||
|
TeamRadio: [],
|
||||||
TrackStatus: '1',
|
TrackStatus: '1',
|
||||||
CurrentLap: 21,
|
CurrentLap: 21,
|
||||||
TotalLaps: 78,
|
TotalLaps: 78,
|
||||||
@@ -162,6 +163,20 @@ describe('live transforms', () => {
|
|||||||
expect(parsed?.data?.Drivers['16'].RacingNumber).toBe('16')
|
expect(parsed?.data?.Drivers['16'].RacingNumber).toBe('16')
|
||||||
})
|
})
|
||||||
|
|
||||||
|
it('parses archived EventSource snapshots separately from active data', () => {
|
||||||
|
const parsed = parseLiveStateEvent(JSON.stringify({
|
||||||
|
is_live: false,
|
||||||
|
data: null,
|
||||||
|
last_snapshot: snapshot,
|
||||||
|
last_positions: { '16': { x: 1, y: 2, z: 3, status: 'OnTrack' } },
|
||||||
|
last_snapshot_at: '2026-07-04T14:00:00Z',
|
||||||
|
}))
|
||||||
|
expect(parsed?.is_live).toBe(false)
|
||||||
|
expect(parsed?.data).toBeNull()
|
||||||
|
expect(parsed?.last_snapshot?.Drivers['16'].RacingNumber).toBe('16')
|
||||||
|
expect(parsed?.last_positions?.['16'].status).toBe('OnTrack')
|
||||||
|
})
|
||||||
|
|
||||||
it('sorts timing rows by live position and includes drivers with metadata only', () => {
|
it('sorts timing rows by live position and includes drivers with metadata only', () => {
|
||||||
const rows = sortLiveTimingRows(snapshot)
|
const rows = sortLiveTimingRows(snapshot)
|
||||||
expect(rows.map((row) => row.RacingNumber)).toEqual(['16', '1', '44'])
|
expect(rows.map((row) => row.RacingNumber)).toEqual(['16', '1', '44'])
|
||||||
@@ -220,7 +235,7 @@ describe('track status mapping', () => {
|
|||||||
describe('live qualifying display', () => {
|
describe('live qualifying display', () => {
|
||||||
it('puts the SQ1 cutoff after P17 for a 22-car sprint qualifying session', () => {
|
it('puts the SQ1 cutoff after P17 for a 22-car sprint qualifying session', () => {
|
||||||
const display = liveSessionDisplay(
|
const display = liveSessionDisplay(
|
||||||
{ MeetingName: 'British Grand Prix', CircuitName: 'Silverstone', SessionType: 'Sprint Qualifying', SessionName: 'Sprint Qualifying' },
|
{ MeetingName: 'British Grand Prix', CircuitName: 'Silverstone', SessionType: 'Sprint Qualifying', SessionName: 'Sprint Qualifying', Path: '' },
|
||||||
rows(22),
|
rows(22),
|
||||||
)
|
)
|
||||||
expect(display.phaseLabel).toBe('SQ1')
|
expect(display.phaseLabel).toBe('SQ1')
|
||||||
@@ -232,7 +247,7 @@ describe('live qualifying display', () => {
|
|||||||
|
|
||||||
it('keeps the normal Q1 cutoff after P15 for a 20-car qualifying session', () => {
|
it('keeps the normal Q1 cutoff after P15 for a 20-car qualifying session', () => {
|
||||||
const display = liveSessionDisplay(
|
const display = liveSessionDisplay(
|
||||||
{ MeetingName: 'Monaco Grand Prix', CircuitName: 'Monaco', SessionType: 'Qualifying', SessionName: 'Qualifying' },
|
{ MeetingName: 'Monaco Grand Prix', CircuitName: 'Monaco', SessionType: 'Qualifying', SessionName: 'Qualifying', Path: '' },
|
||||||
rows(20),
|
rows(20),
|
||||||
)
|
)
|
||||||
expect(display.phaseLabel).toBe('Q1')
|
expect(display.phaseLabel).toBe('Q1')
|
||||||
@@ -241,7 +256,7 @@ describe('live qualifying display', () => {
|
|||||||
|
|
||||||
it('moves phase 2 cutoff after P10 once five cars are knocked out', () => {
|
it('moves phase 2 cutoff after P10 once five cars are knocked out', () => {
|
||||||
const display = liveSessionDisplay(
|
const display = liveSessionDisplay(
|
||||||
{ MeetingName: 'Monaco Grand Prix', CircuitName: 'Monaco', SessionType: 'Qualifying', SessionName: 'Qualifying' },
|
{ MeetingName: 'Monaco Grand Prix', CircuitName: 'Monaco', SessionType: 'Qualifying', SessionName: 'Qualifying', Path: '' },
|
||||||
rows(20, 5),
|
rows(20, 5),
|
||||||
)
|
)
|
||||||
expect(display.phaseLabel).toBe('Q2')
|
expect(display.phaseLabel).toBe('Q2')
|
||||||
@@ -251,13 +266,13 @@ describe('live qualifying display', () => {
|
|||||||
it('shows no cutoff for race sessions or Q3', () => {
|
it('shows no cutoff for race sessions or Q3', () => {
|
||||||
expect(
|
expect(
|
||||||
liveSessionDisplay(
|
liveSessionDisplay(
|
||||||
{ MeetingName: 'Monaco Grand Prix', CircuitName: 'Monaco', SessionType: 'Race', SessionName: 'Race' },
|
{ MeetingName: 'Monaco Grand Prix', CircuitName: 'Monaco', SessionType: 'Race', SessionName: 'Race', Path: '' },
|
||||||
rows(20),
|
rows(20),
|
||||||
).cutoffPosition,
|
).cutoffPosition,
|
||||||
).toBeNull()
|
).toBeNull()
|
||||||
expect(
|
expect(
|
||||||
liveSessionDisplay(
|
liveSessionDisplay(
|
||||||
{ MeetingName: 'Monaco Grand Prix', CircuitName: 'Monaco', SessionType: 'Qualifying', SessionName: 'Q3' },
|
{ MeetingName: 'Monaco Grand Prix', CircuitName: 'Monaco', SessionType: 'Qualifying', SessionName: 'Q3', Path: '' },
|
||||||
rows(10),
|
rows(10),
|
||||||
).cutoffPosition,
|
).cutoffPosition,
|
||||||
).toBeNull()
|
).toBeNull()
|
||||||
|
|||||||
71
frontend/src/test/meaning.test.ts
Normal file
71
frontend/src/test/meaning.test.ts
Normal file
@@ -0,0 +1,71 @@
|
|||||||
|
import { describe, expect, it } from 'vitest'
|
||||||
|
import {
|
||||||
|
INTERVAL_DRS_MAX_SECONDS,
|
||||||
|
INTERVAL_UNDERCUT_MAX_SECONDS,
|
||||||
|
INTERVAL_UNDERCUT_MIN_SECONDS,
|
||||||
|
MAX_POINTS_PER_ROUND,
|
||||||
|
TYRE_CLIFF_LAPS,
|
||||||
|
intervalMeaning,
|
||||||
|
pointsGapMeaning,
|
||||||
|
tyreAgeMeaning,
|
||||||
|
} from '../lib/meaning'
|
||||||
|
|
||||||
|
describe('intervalMeaning', () => {
|
||||||
|
it('returns DRS range below the threshold', () => {
|
||||||
|
expect(intervalMeaning(0.4)?.caption).toBe('DRS range')
|
||||||
|
expect(intervalMeaning(INTERVAL_DRS_MAX_SECONDS - 0.01)?.caption).toBe('DRS range')
|
||||||
|
})
|
||||||
|
|
||||||
|
it('returns undercut window in the middle band', () => {
|
||||||
|
expect(intervalMeaning(INTERVAL_UNDERCUT_MIN_SECONDS)?.caption).toBe('undercut window')
|
||||||
|
expect(intervalMeaning(2.0)?.caption).toBe('undercut window')
|
||||||
|
expect(intervalMeaning(INTERVAL_UNDERCUT_MAX_SECONDS)?.caption).toBe('undercut window')
|
||||||
|
})
|
||||||
|
|
||||||
|
it('returns null outside known bands', () => {
|
||||||
|
expect(intervalMeaning(INTERVAL_UNDERCUT_MAX_SECONDS + 0.5)).toBeNull()
|
||||||
|
expect(intervalMeaning(10)).toBeNull()
|
||||||
|
expect(intervalMeaning(null)).toBeNull()
|
||||||
|
expect(intervalMeaning(undefined)).toBeNull()
|
||||||
|
expect(intervalMeaning(-1)).toBeNull()
|
||||||
|
})
|
||||||
|
})
|
||||||
|
|
||||||
|
describe('tyreAgeMeaning', () => {
|
||||||
|
it('labels fresh, mid-life, and laps-to-cliff for SOFT', () => {
|
||||||
|
const cliff = TYRE_CLIFF_LAPS.SOFT
|
||||||
|
expect(tyreAgeMeaning('SOFT', 2)?.caption).toBe('fresh')
|
||||||
|
expect(tyreAgeMeaning('SOFT', Math.ceil(cliff * 0.5))?.caption).toBe('mid-life')
|
||||||
|
expect(tyreAgeMeaning('SOFT', cliff - 2)?.caption).toBe('~2 laps to cliff')
|
||||||
|
expect(tyreAgeMeaning('SOFT', cliff + 5)?.caption).toBe('past cliff')
|
||||||
|
})
|
||||||
|
|
||||||
|
it('handles unknown compounds with defaults', () => {
|
||||||
|
expect(tyreAgeMeaning('UNKNOWN', 3)?.caption).toBe('fresh')
|
||||||
|
expect(tyreAgeMeaning(undefined, 3)?.caption).toBe('fresh')
|
||||||
|
})
|
||||||
|
|
||||||
|
it('returns null for invalid age', () => {
|
||||||
|
expect(tyreAgeMeaning('MEDIUM', null)).toBeNull()
|
||||||
|
expect(tyreAgeMeaning('MEDIUM', -1)).toBeNull()
|
||||||
|
})
|
||||||
|
})
|
||||||
|
|
||||||
|
describe('pointsGapMeaning', () => {
|
||||||
|
it('computes catchable pts/round', () => {
|
||||||
|
const result = pointsGapMeaning(40, 4, 'VER')
|
||||||
|
expect(result?.caption).toBe('~10 pts/round')
|
||||||
|
expect(result?.title).toContain('VER')
|
||||||
|
})
|
||||||
|
|
||||||
|
it('marks uncatchable gaps', () => {
|
||||||
|
const max = 3 * MAX_POINTS_PER_ROUND
|
||||||
|
expect(pointsGapMeaning(max + 1, 3, 'VER')?.caption).toBe('out of reach')
|
||||||
|
})
|
||||||
|
|
||||||
|
it('returns null for leader or invalid input', () => {
|
||||||
|
expect(pointsGapMeaning(0, 4)).toBeNull()
|
||||||
|
expect(pointsGapMeaning(10, 0)).toBeNull()
|
||||||
|
expect(pointsGapMeaning(null, 4)).toBeNull()
|
||||||
|
})
|
||||||
|
})
|
||||||
226
frontend/src/test/preview.test.ts
Normal file
226
frontend/src/test/preview.test.ts
Normal file
@@ -0,0 +1,226 @@
|
|||||||
|
import { describe, it, expect } from 'vitest'
|
||||||
|
import type { ChampHubDriver, ChampionshipHub, EnrichedGrid, EnrichedResult, Meeting, Session } from '../types'
|
||||||
|
import {
|
||||||
|
buildTitleFightContext,
|
||||||
|
countdownTargetSession,
|
||||||
|
extractPodium,
|
||||||
|
extractPole,
|
||||||
|
findPriorYearMeetingByCircuit,
|
||||||
|
findRaceSession,
|
||||||
|
formatPointsGap,
|
||||||
|
isSprintWeekend,
|
||||||
|
pickPreviewMeeting,
|
||||||
|
RACE_WIN_POINTS,
|
||||||
|
SPRINT_WEEKEND_MAX_POINTS,
|
||||||
|
} from '../lib/preview'
|
||||||
|
|
||||||
|
const meeting = (overrides: Partial<Meeting> = {}): Meeting => ({
|
||||||
|
meeting_key: 1,
|
||||||
|
meeting_name: 'Monaco',
|
||||||
|
meeting_official_name: 'Monaco GP',
|
||||||
|
location: 'Monaco',
|
||||||
|
country_name: 'Monaco',
|
||||||
|
country_code: 'MON',
|
||||||
|
country_flag: '',
|
||||||
|
circuit_key: 10,
|
||||||
|
circuit_short_name: 'Monaco',
|
||||||
|
date_start: '2026-05-22T00:00:00+00:00',
|
||||||
|
date_end: '2026-05-24T23:59:59+00:00',
|
||||||
|
year: 2026,
|
||||||
|
...overrides,
|
||||||
|
})
|
||||||
|
|
||||||
|
const session = (overrides: Partial<Session> = {}): Session => ({
|
||||||
|
session_key: 100,
|
||||||
|
session_name: 'Race',
|
||||||
|
session_type: 'Race',
|
||||||
|
meeting_key: 1,
|
||||||
|
date_start: '2026-05-24T13:00:00+00:00',
|
||||||
|
date_end: '2026-05-24T15:00:00+00:00',
|
||||||
|
gmt_offset: '02:00:00',
|
||||||
|
...overrides,
|
||||||
|
})
|
||||||
|
|
||||||
|
const hubDriver = (over: Partial<ChampHubDriver>): ChampHubDriver => ({
|
||||||
|
driver_number: 1,
|
||||||
|
name_acronym: 'VER',
|
||||||
|
full_name: 'Max Verstappen',
|
||||||
|
team_name: 'Red Bull',
|
||||||
|
team_colour: '3671c6',
|
||||||
|
points: 200,
|
||||||
|
position: 1,
|
||||||
|
wins: 5,
|
||||||
|
podiums: 8,
|
||||||
|
poles: 4,
|
||||||
|
form: [25],
|
||||||
|
cumulative: [200],
|
||||||
|
teammate_wins: 9,
|
||||||
|
teammate_losses: 1,
|
||||||
|
...over,
|
||||||
|
})
|
||||||
|
|
||||||
|
describe('preview lib', () => {
|
||||||
|
it('picks the next upcoming meeting', () => {
|
||||||
|
const now = new Date('2026-01-01T00:00:00Z')
|
||||||
|
const meetings = [
|
||||||
|
meeting({ meeting_key: 1, date_start: '2026-05-22T00:00:00+00:00' }),
|
||||||
|
meeting({ meeting_key: 2, meeting_name: 'Spain', date_start: '2026-06-12T00:00:00+00:00' }),
|
||||||
|
]
|
||||||
|
expect(pickPreviewMeeting(meetings, now)?.meeting_key).toBe(1)
|
||||||
|
})
|
||||||
|
|
||||||
|
it('returns null when no upcoming meeting exists', () => {
|
||||||
|
const now = new Date('2027-01-01T00:00:00Z')
|
||||||
|
const meetings = [meeting({ date_start: '2026-05-22T00:00:00+00:00' })]
|
||||||
|
expect(pickPreviewMeeting(meetings, now)).toBeNull()
|
||||||
|
})
|
||||||
|
|
||||||
|
it('skips cancelled meetings', () => {
|
||||||
|
const now = new Date('2026-01-01T00:00:00Z')
|
||||||
|
const meetings = [meeting({ is_cancelled: true })]
|
||||||
|
expect(pickPreviewMeeting(meetings, now)).toBeNull()
|
||||||
|
})
|
||||||
|
|
||||||
|
it('matches prior-year meeting by circuit_key', () => {
|
||||||
|
const prior = [
|
||||||
|
meeting({ meeting_key: 50, year: 2025, circuit_key: 10 }),
|
||||||
|
meeting({ meeting_key: 51, year: 2025, circuit_key: 20, meeting_name: 'Spain' }),
|
||||||
|
]
|
||||||
|
expect(findPriorYearMeetingByCircuit(prior, 10)?.meeting_key).toBe(50)
|
||||||
|
expect(findPriorYearMeetingByCircuit(prior, 99)).toBeNull()
|
||||||
|
expect(findPriorYearMeetingByCircuit(prior, undefined)).toBeNull()
|
||||||
|
})
|
||||||
|
|
||||||
|
it('finds the grand prix race session', () => {
|
||||||
|
const sessions = [
|
||||||
|
session({ session_key: 1, session_name: 'FP1', session_type: 'Practice', date_start: '2026-05-22T10:00:00+00:00' }),
|
||||||
|
session({ session_key: 2, session_name: 'Sprint', session_type: 'Sprint', date_start: '2026-05-23T10:00:00+00:00' }),
|
||||||
|
session({ session_key: 3, session_name: 'Race', session_type: 'Race', date_start: '2026-05-24T13:00:00+00:00' }),
|
||||||
|
]
|
||||||
|
expect(findRaceSession(sessions)?.session_key).toBe(3)
|
||||||
|
})
|
||||||
|
|
||||||
|
it('detects sprint weekends', () => {
|
||||||
|
const sprint = [
|
||||||
|
session({ session_type: 'Practice' }),
|
||||||
|
session({ session_name: 'Sprint', session_type: 'Sprint' }),
|
||||||
|
session({ session_type: 'Race' }),
|
||||||
|
]
|
||||||
|
const normal = [session({ session_type: 'Practice' }), session({ session_type: 'Race' })]
|
||||||
|
expect(isSprintWeekend(sprint)).toBe(true)
|
||||||
|
expect(isSprintWeekend(normal)).toBe(false)
|
||||||
|
})
|
||||||
|
|
||||||
|
it('extracts podium and pole', () => {
|
||||||
|
const results: EnrichedResult[] = [
|
||||||
|
{
|
||||||
|
driver_number: 1,
|
||||||
|
position: 1,
|
||||||
|
name_acronym: 'VER',
|
||||||
|
full_name: 'Max Verstappen',
|
||||||
|
team_name: 'Red Bull',
|
||||||
|
team_colour: '3671c6',
|
||||||
|
dnf: false,
|
||||||
|
dns: false,
|
||||||
|
dsq: false,
|
||||||
|
duration: 100,
|
||||||
|
gap_to_leader: 0,
|
||||||
|
number_of_laps: 78,
|
||||||
|
points: 25,
|
||||||
|
session_key: 1,
|
||||||
|
meeting_key: 1,
|
||||||
|
},
|
||||||
|
{
|
||||||
|
driver_number: 4,
|
||||||
|
position: 2,
|
||||||
|
name_acronym: 'NOR',
|
||||||
|
full_name: 'Lando Norris',
|
||||||
|
team_name: 'McLaren',
|
||||||
|
team_colour: 'ff8000',
|
||||||
|
dnf: false,
|
||||||
|
dns: false,
|
||||||
|
dsq: false,
|
||||||
|
duration: 101,
|
||||||
|
gap_to_leader: 1,
|
||||||
|
number_of_laps: 78,
|
||||||
|
points: 18,
|
||||||
|
session_key: 1,
|
||||||
|
meeting_key: 1,
|
||||||
|
},
|
||||||
|
{
|
||||||
|
driver_number: 16,
|
||||||
|
position: 3,
|
||||||
|
name_acronym: 'LEC',
|
||||||
|
full_name: 'Charles Leclerc',
|
||||||
|
team_name: 'Ferrari',
|
||||||
|
team_colour: 'e8002d',
|
||||||
|
dnf: false,
|
||||||
|
dns: false,
|
||||||
|
dsq: false,
|
||||||
|
duration: 102,
|
||||||
|
gap_to_leader: 2,
|
||||||
|
number_of_laps: 78,
|
||||||
|
points: 15,
|
||||||
|
session_key: 1,
|
||||||
|
meeting_key: 1,
|
||||||
|
},
|
||||||
|
]
|
||||||
|
|
||||||
|
const grid: EnrichedGrid[] = [
|
||||||
|
{
|
||||||
|
driver_number: 4,
|
||||||
|
position: 1,
|
||||||
|
name_acronym: 'NOR',
|
||||||
|
full_name: 'Lando Norris',
|
||||||
|
team_name: 'McLaren',
|
||||||
|
team_colour: 'ff8000',
|
||||||
|
session_key: 1,
|
||||||
|
meeting_key: 1,
|
||||||
|
lap_duration: 70,
|
||||||
|
},
|
||||||
|
]
|
||||||
|
|
||||||
|
const podium = extractPodium(results)
|
||||||
|
expect(podium.map((p) => p.name_acronym)).toEqual(['VER', 'NOR', 'LEC'])
|
||||||
|
expect(extractPole(grid)?.name_acronym).toBe('NOR')
|
||||||
|
})
|
||||||
|
|
||||||
|
it('builds title fight gaps for top 3', () => {
|
||||||
|
const hub: ChampionshipHub = {
|
||||||
|
season: 2026,
|
||||||
|
round: 5,
|
||||||
|
total_rounds: 24,
|
||||||
|
rounds_left: 19,
|
||||||
|
last_race: 'Monaco GP',
|
||||||
|
round_labels: ['R1'],
|
||||||
|
drivers: [
|
||||||
|
hubDriver({ points: 200, position: 1 }),
|
||||||
|
hubDriver({ driver_number: 4, name_acronym: 'NOR', points: 160, position: 2 }),
|
||||||
|
hubDriver({ driver_number: 16, name_acronym: 'LEC', points: 120, position: 3 }),
|
||||||
|
],
|
||||||
|
teams: [],
|
||||||
|
}
|
||||||
|
|
||||||
|
const rows = buildTitleFightContext(hub)
|
||||||
|
expect(rows).toHaveLength(3)
|
||||||
|
expect(rows[0].gapToLeader).toBe(0)
|
||||||
|
expect(rows[1].gapToLeader).toBe(40)
|
||||||
|
expect(rows[1].gapAfterRaceWin).toBe(15)
|
||||||
|
expect(rows[2].gapAfterSprintWeekendMax).toBe(200 - (120 + SPRINT_WEEKEND_MAX_POINTS))
|
||||||
|
expect(RACE_WIN_POINTS).toBe(25)
|
||||||
|
})
|
||||||
|
|
||||||
|
it('formats points gaps', () => {
|
||||||
|
expect(formatPointsGap(0)).toBe('LEADER')
|
||||||
|
expect(formatPointsGap(40)).toBe('+40')
|
||||||
|
})
|
||||||
|
|
||||||
|
it('picks countdown target as next future session', () => {
|
||||||
|
const sessions = [
|
||||||
|
session({ session_key: 1, session_name: 'FP1', session_type: 'Practice', date_start: '2026-05-22T10:00:00+00:00', date_end: '2026-05-22T11:00:00+00:00' }),
|
||||||
|
session({ session_key: 2, session_name: 'Race', session_type: 'Race', date_start: '2026-05-24T13:00:00+00:00', date_end: '2026-05-24T15:00:00+00:00' }),
|
||||||
|
]
|
||||||
|
const now = new Date('2026-05-23T12:00:00Z')
|
||||||
|
expect(countdownTargetSession(sessions, now)?.session_key).toBe(2)
|
||||||
|
})
|
||||||
|
})
|
||||||
118
frontend/src/test/telemetry-trace-chart.test.tsx
Normal file
118
frontend/src/test/telemetry-trace-chart.test.tsx
Normal file
@@ -0,0 +1,118 @@
|
|||||||
|
import { describe, expect, it } from 'vitest'
|
||||||
|
import { fireEvent, render, screen } from '@testing-library/react'
|
||||||
|
import {
|
||||||
|
TelemetryTraceChart,
|
||||||
|
type TelemetryTraceSeries,
|
||||||
|
} from '../components/charts/TelemetryTraceChart'
|
||||||
|
|
||||||
|
function makeSeries(label: string, color: string, speeds: number[]): TelemetryTraceSeries {
|
||||||
|
return {
|
||||||
|
label,
|
||||||
|
color,
|
||||||
|
samples: speeds.map((speed, i) => ({
|
||||||
|
speed,
|
||||||
|
throttle: (i * 25) % 101,
|
||||||
|
brake: i % 2 === 0 ? 100 : 0,
|
||||||
|
})),
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
const VER = makeSeries('VER', '#2563eb', [280, 310, 190, 90, 240])
|
||||||
|
const LEC = makeSeries('LEC', '#dc2626', [275, 305, 200, 95, 235])
|
||||||
|
|
||||||
|
describe('TelemetryTraceChart', () => {
|
||||||
|
it('renders one polyline per series per channel', () => {
|
||||||
|
const { container } = render(<TelemetryTraceChart series={[VER, LEC]} />)
|
||||||
|
const lines = container.querySelectorAll('polyline.telemetry-trace-line')
|
||||||
|
expect(lines).toHaveLength(2 * 3)
|
||||||
|
for (const channel of ['speed', 'throttle', 'brake']) {
|
||||||
|
expect(
|
||||||
|
container.querySelectorAll(`polyline.telemetry-trace-line[data-channel="${channel}"]`),
|
||||||
|
).toHaveLength(2)
|
||||||
|
}
|
||||||
|
expect(
|
||||||
|
container.querySelectorAll('polyline.telemetry-trace-line[data-series="VER"]'),
|
||||||
|
).toHaveLength(3)
|
||||||
|
})
|
||||||
|
|
||||||
|
it('respects the channels prop', () => {
|
||||||
|
const { container } = render(<TelemetryTraceChart series={[VER]} channels={['speed']} />)
|
||||||
|
expect(container.querySelectorAll('polyline.telemetry-trace-line')).toHaveLength(1)
|
||||||
|
expect(container.querySelectorAll('.telemetry-trace-panel')).toHaveLength(1)
|
||||||
|
})
|
||||||
|
|
||||||
|
it('renders an empty state for no series', () => {
|
||||||
|
render(<TelemetryTraceChart series={[]} />)
|
||||||
|
expect(screen.getByText('No telemetry data')).toBeInTheDocument()
|
||||||
|
})
|
||||||
|
|
||||||
|
it('renders an empty state when a series has no samples', () => {
|
||||||
|
render(<TelemetryTraceChart series={[makeSeries('VER', '#2563eb', [])]} />)
|
||||||
|
expect(screen.getByText('No telemetry data')).toBeInTheDocument()
|
||||||
|
})
|
||||||
|
|
||||||
|
it('survives a single sample and mismatched series lengths', () => {
|
||||||
|
const short = makeSeries('VER', '#2563eb', [300])
|
||||||
|
const long = makeSeries('LEC', '#dc2626', [280, 290, 300])
|
||||||
|
const { container } = render(<TelemetryTraceChart series={[short, long]} />)
|
||||||
|
// Clamped to the shortest series: every polyline has exactly one point.
|
||||||
|
const lines = container.querySelectorAll('polyline.telemetry-trace-line')
|
||||||
|
expect(lines).toHaveLength(6)
|
||||||
|
for (const line of lines) {
|
||||||
|
expect(line.getAttribute('points')!.trim().split(' ')).toHaveLength(1)
|
||||||
|
}
|
||||||
|
})
|
||||||
|
|
||||||
|
it('clamps throttle values to 0-100 within the panel', () => {
|
||||||
|
const wild: TelemetryTraceSeries = {
|
||||||
|
label: 'VER',
|
||||||
|
color: '#2563eb',
|
||||||
|
samples: [
|
||||||
|
{ speed: 100, throttle: 150, brake: 0 },
|
||||||
|
{ speed: 100, throttle: -20, brake: 0 },
|
||||||
|
{ speed: 100, throttle: 50, brake: 0 },
|
||||||
|
],
|
||||||
|
}
|
||||||
|
const { container } = render(
|
||||||
|
<TelemetryTraceChart series={[wild]} channels={['throttle']} height={110} />,
|
||||||
|
)
|
||||||
|
const line = container.querySelector('polyline.telemetry-trace-line[data-channel="throttle"]')!
|
||||||
|
const ys = line
|
||||||
|
.getAttribute('points')!
|
||||||
|
.split(' ')
|
||||||
|
.map((p) => Number(p.split(',')[1]))
|
||||||
|
// Panel occupies y 0..110 with 6px padding; clamped values pin to the edges.
|
||||||
|
expect(ys[0]).toBeCloseTo(6, 1) // 150% -> 100% -> panel top
|
||||||
|
expect(ys[1]).toBeCloseTo(104, 1) // -20% -> 0% -> panel bottom
|
||||||
|
expect(ys[2]).toBeCloseTo(55, 1) // 50% -> middle
|
||||||
|
})
|
||||||
|
|
||||||
|
it('shows the speed axis max in km/h', () => {
|
||||||
|
render(<TelemetryTraceChart series={[VER]} channels={['speed']} />)
|
||||||
|
expect(screen.getByText('310 km/h')).toBeInTheDocument()
|
||||||
|
})
|
||||||
|
|
||||||
|
it('lists every series in the legend with a color swatch', () => {
|
||||||
|
const { container } = render(<TelemetryTraceChart series={[VER, LEC]} />)
|
||||||
|
const legend = container.querySelector('.telemetry-trace-legend')!
|
||||||
|
expect(legend.textContent).toContain('VER')
|
||||||
|
expect(legend.textContent).toContain('LEC')
|
||||||
|
expect(legend.querySelectorAll('.telemetry-trace-swatch')).toHaveLength(2)
|
||||||
|
})
|
||||||
|
|
||||||
|
it('shows a crosshair and per-driver readout on hover, hides on leave', () => {
|
||||||
|
const { container } = render(<TelemetryTraceChart series={[VER, LEC]} />)
|
||||||
|
const svg = container.querySelector('svg.telemetry-trace-svg')!
|
||||||
|
expect(screen.queryByTestId('telemetry-trace-crosshair')).not.toBeInTheDocument()
|
||||||
|
|
||||||
|
fireEvent.mouseMove(svg, { clientX: 0, clientY: 10 })
|
||||||
|
expect(screen.getByTestId('telemetry-trace-crosshair')).toBeInTheDocument()
|
||||||
|
const readout = screen.getByTestId('telemetry-trace-readout')
|
||||||
|
expect(readout.textContent).toContain('VER')
|
||||||
|
expect(readout.textContent).toContain('LEC')
|
||||||
|
expect(readout.textContent).toContain('km/h')
|
||||||
|
|
||||||
|
fireEvent.mouseLeave(svg)
|
||||||
|
expect(screen.queryByTestId('telemetry-trace-crosshair')).not.toBeInTheDocument()
|
||||||
|
})
|
||||||
|
})
|
||||||
39
frontend/src/test/trackmap.test.ts
Normal file
39
frontend/src/test/trackmap.test.ts
Normal file
@@ -0,0 +1,39 @@
|
|||||||
|
import { describe, expect, it } from 'vitest'
|
||||||
|
import {
|
||||||
|
buildOutlinePath,
|
||||||
|
canvasToSvg,
|
||||||
|
isOnTrack,
|
||||||
|
normalizeRawPoint,
|
||||||
|
outlinePointToCanvas,
|
||||||
|
} from '../lib/trackmap'
|
||||||
|
|
||||||
|
describe('track map transforms', () => {
|
||||||
|
it('normalizes raw F1 coordinates into canvas space', () => {
|
||||||
|
const point = normalizeRawPoint(
|
||||||
|
{ x: 50, y: 75 },
|
||||||
|
{ minX: 0, maxX: 100, minY: 50, maxY: 100 },
|
||||||
|
)
|
||||||
|
expect(point).toEqual({ x: 0.5, y: 0.5 })
|
||||||
|
expect(canvasToSvg(point)).toEqual({ x: 50, y: 50 })
|
||||||
|
})
|
||||||
|
|
||||||
|
it('centers zero-range bounds and clamps out-of-range points', () => {
|
||||||
|
expect(normalizeRawPoint({ x: 10, y: 20 }, { minX: 10, maxX: 10, minY: 20, maxY: 20 }))
|
||||||
|
.toEqual({ x: 0.5, y: 0.5 })
|
||||||
|
expect(normalizeRawPoint({ x: 20, y: 5 }, { minX: 10, maxX: 15, minY: 10, maxY: 15 }))
|
||||||
|
.toEqual({ x: 1, y: 1 })
|
||||||
|
})
|
||||||
|
|
||||||
|
it('builds an SVG path from normalized outline points', () => {
|
||||||
|
expect(outlinePointToCanvas({ x: 0.25, y: 0.75 })).toEqual({ x: 0.25, y: 0.25 })
|
||||||
|
expect(buildOutlinePath([{ x: 0, y: 0 }, { x: 1, y: 1 }]))
|
||||||
|
.toBe('M 0.00 100.00 L 100.00 0.00')
|
||||||
|
expect(buildOutlinePath([{ x: 0, y: 0 }])).toBe('')
|
||||||
|
})
|
||||||
|
|
||||||
|
it('classifies on-track status defensively', () => {
|
||||||
|
expect(isOnTrack('OnTrack')).toBe(true)
|
||||||
|
expect(isOnTrack('OffTrack')).toBe(false)
|
||||||
|
expect(isOnTrack('')).toBe(true)
|
||||||
|
})
|
||||||
|
})
|
||||||
204
frontend/src/test/tyre-stint-timeline.test.tsx
Normal file
204
frontend/src/test/tyre-stint-timeline.test.tsx
Normal file
@@ -0,0 +1,204 @@
|
|||||||
|
import { describe, it, expect } from 'vitest'
|
||||||
|
import { render, screen } from '@testing-library/react'
|
||||||
|
import { TyreStintTimeline, type StintTimelineRow } from '../components/charts/TyreStintTimeline'
|
||||||
|
import { StrategyView } from '../components/StrategyView'
|
||||||
|
import type { EnrichedResult, Stint, PitStop } from '../types'
|
||||||
|
|
||||||
|
const sampleRows: StintTimelineRow[] = [
|
||||||
|
{
|
||||||
|
label: 'VER',
|
||||||
|
color: '#3671C6',
|
||||||
|
stints: [
|
||||||
|
{ compound: 'MEDIUM', lapStart: 1, lapEnd: 30 },
|
||||||
|
{ compound: 'SOFT', lapStart: 31, lapEnd: 78 },
|
||||||
|
],
|
||||||
|
},
|
||||||
|
{
|
||||||
|
label: 'HAM',
|
||||||
|
color: '#E8002D',
|
||||||
|
stints: [{ compound: 'SOFT', lapStart: 1, lapEnd: 18 }],
|
||||||
|
},
|
||||||
|
]
|
||||||
|
|
||||||
|
describe('TyreStintTimeline', () => {
|
||||||
|
it('renders one rect per stint', () => {
|
||||||
|
const { container } = render(
|
||||||
|
<TyreStintTimeline rows={sampleRows} totalLaps={78} />,
|
||||||
|
)
|
||||||
|
expect(container.querySelectorAll('.stint-timeline__bar')).toHaveLength(3)
|
||||||
|
})
|
||||||
|
|
||||||
|
it('maps compounds to color classes', () => {
|
||||||
|
const { container } = render(
|
||||||
|
<TyreStintTimeline rows={sampleRows} totalLaps={78} />,
|
||||||
|
)
|
||||||
|
const bars = container.querySelectorAll('.stint-timeline__bar')
|
||||||
|
expect(bars[0]).toHaveClass('tyre-medium')
|
||||||
|
expect(bars[1]).toHaveClass('tyre-soft')
|
||||||
|
expect(bars[2]).toHaveClass('tyre-soft')
|
||||||
|
})
|
||||||
|
|
||||||
|
it('shows native title with compound, lap range, and stint length', () => {
|
||||||
|
const { container } = render(
|
||||||
|
<TyreStintTimeline rows={sampleRows} totalLaps={78} />,
|
||||||
|
)
|
||||||
|
const titles = [...container.querySelectorAll('title')].map((t) => t.textContent)
|
||||||
|
expect(titles).toContain('Medium · L1–30 · 30 laps')
|
||||||
|
expect(titles).toContain('Soft · L31–78 · 48 laps')
|
||||||
|
expect(titles).toContain('Soft · L1–18 · 18 laps')
|
||||||
|
})
|
||||||
|
|
||||||
|
it('renders lap-axis ticks every 10 laps', () => {
|
||||||
|
render(<TyreStintTimeline rows={sampleRows} totalLaps={78} />)
|
||||||
|
expect(screen.getByText('0')).toBeInTheDocument()
|
||||||
|
expect(screen.getByText('10')).toBeInTheDocument()
|
||||||
|
expect(screen.getByText('20')).toBeInTheDocument()
|
||||||
|
expect(screen.getByText('70')).toBeInTheDocument()
|
||||||
|
})
|
||||||
|
|
||||||
|
it('shows legend only for used compounds', () => {
|
||||||
|
render(<TyreStintTimeline rows={sampleRows} totalLaps={78} />)
|
||||||
|
expect(screen.getByTestId('legend-soft')).toBeInTheDocument()
|
||||||
|
expect(screen.getByTestId('legend-medium')).toBeInTheDocument()
|
||||||
|
expect(screen.queryByTestId('legend-hard')).not.toBeInTheDocument()
|
||||||
|
expect(screen.queryByTestId('legend-wet')).not.toBeInTheDocument()
|
||||||
|
expect(screen.getByText('Soft')).toBeInTheDocument()
|
||||||
|
expect(screen.getByText('Medium')).toBeInTheDocument()
|
||||||
|
})
|
||||||
|
|
||||||
|
it('renders empty state when rows are empty', () => {
|
||||||
|
render(<TyreStintTimeline rows={[]} totalLaps={50} />)
|
||||||
|
expect(screen.getByTestId('stint-timeline-empty')).toBeInTheDocument()
|
||||||
|
expect(screen.getByText(/No stint data/i)).toBeInTheDocument()
|
||||||
|
})
|
||||||
|
|
||||||
|
it('renders one pit marker per stop at the correct lap position', () => {
|
||||||
|
const rowsWithPits: StintTimelineRow[] = [
|
||||||
|
{
|
||||||
|
label: 'HAM',
|
||||||
|
color: '#E8002D',
|
||||||
|
stints: [{ compound: 'SOFT', lapStart: 1, lapEnd: 18 }],
|
||||||
|
pitStops: [19],
|
||||||
|
},
|
||||||
|
{
|
||||||
|
label: 'VER',
|
||||||
|
color: '#3671C6',
|
||||||
|
stints: [
|
||||||
|
{ compound: 'MEDIUM', lapStart: 1, lapEnd: 30 },
|
||||||
|
{ compound: 'SOFT', lapStart: 31, lapEnd: 78 },
|
||||||
|
],
|
||||||
|
pitStops: [31, 52],
|
||||||
|
},
|
||||||
|
]
|
||||||
|
const { container } = render(
|
||||||
|
<TyreStintTimeline rows={rowsWithPits} totalLaps={78} />,
|
||||||
|
)
|
||||||
|
const markers = container.querySelectorAll('[data-testid="pit-marker"]')
|
||||||
|
expect(markers).toHaveLength(3)
|
||||||
|
expect(markers[0]).toHaveAttribute('data-lap', '19')
|
||||||
|
expect(markers[1]).toHaveAttribute('data-lap', '31')
|
||||||
|
expect(markers[2]).toHaveAttribute('data-lap', '52')
|
||||||
|
expect(container.querySelectorAll('.stint-timeline__bar')).toHaveLength(3)
|
||||||
|
})
|
||||||
|
|
||||||
|
it('positions pit markers using lap_number and includes driver in tooltip', () => {
|
||||||
|
const rows: StintTimelineRow[] = [
|
||||||
|
{
|
||||||
|
label: 'HAM',
|
||||||
|
color: '#E8002D',
|
||||||
|
stints: [{ compound: 'SOFT', lapStart: 1, lapEnd: 18 }],
|
||||||
|
pitStops: [19],
|
||||||
|
},
|
||||||
|
]
|
||||||
|
const { container } = render(<TyreStintTimeline rows={rows} totalLaps={78} />)
|
||||||
|
const marker = container.querySelector('[data-testid="pit-marker"]') as SVGLineElement
|
||||||
|
expect(marker).toBeTruthy()
|
||||||
|
// lap 19 → x = 48 + (18/78) * 580 ≈ 181.85
|
||||||
|
expect(Number(marker.getAttribute('x1'))).toBeCloseTo(181.85, 1)
|
||||||
|
const titles = [...container.querySelectorAll('title')].map((t) => t.textContent)
|
||||||
|
expect(titles).toContain('HAM pit stop · L19')
|
||||||
|
})
|
||||||
|
|
||||||
|
it('leaves rows without pit data unchanged', () => {
|
||||||
|
const { container } = render(
|
||||||
|
<TyreStintTimeline rows={sampleRows} totalLaps={78} />,
|
||||||
|
)
|
||||||
|
expect(container.querySelectorAll('[data-testid="pit-marker"]')).toHaveLength(0)
|
||||||
|
expect(container.querySelectorAll('.stint-timeline__bar')).toHaveLength(3)
|
||||||
|
})
|
||||||
|
})
|
||||||
|
|
||||||
|
const results: EnrichedResult[] = [
|
||||||
|
{
|
||||||
|
driver_number: 1,
|
||||||
|
position: 1,
|
||||||
|
name_acronym: 'VER',
|
||||||
|
full_name: 'Max Verstappen',
|
||||||
|
team_name: 'Red Bull Racing',
|
||||||
|
team_colour: '3671C6',
|
||||||
|
dnf: false,
|
||||||
|
dns: false,
|
||||||
|
dsq: false,
|
||||||
|
duration: null,
|
||||||
|
gap_to_leader: null,
|
||||||
|
number_of_laps: 78,
|
||||||
|
points: 25,
|
||||||
|
session_key: 9472,
|
||||||
|
meeting_key: 1229,
|
||||||
|
},
|
||||||
|
{
|
||||||
|
driver_number: 44,
|
||||||
|
position: 2,
|
||||||
|
name_acronym: 'HAM',
|
||||||
|
full_name: 'Lewis Hamilton',
|
||||||
|
team_name: 'Ferrari',
|
||||||
|
team_colour: 'E8002D',
|
||||||
|
dnf: false,
|
||||||
|
dns: false,
|
||||||
|
dsq: false,
|
||||||
|
duration: null,
|
||||||
|
gap_to_leader: 5.1,
|
||||||
|
number_of_laps: 78,
|
||||||
|
points: 18,
|
||||||
|
session_key: 9472,
|
||||||
|
meeting_key: 1229,
|
||||||
|
},
|
||||||
|
]
|
||||||
|
|
||||||
|
const stints: Stint[] = [
|
||||||
|
{
|
||||||
|
session_key: 9472,
|
||||||
|
driver_number: 1,
|
||||||
|
meeting_key: 1229,
|
||||||
|
stint_number: 1,
|
||||||
|
compound: 'MEDIUM',
|
||||||
|
lap_start: 1,
|
||||||
|
lap_end: 30,
|
||||||
|
tyre_age_at_start: 0,
|
||||||
|
},
|
||||||
|
{
|
||||||
|
session_key: 9472,
|
||||||
|
driver_number: 44,
|
||||||
|
meeting_key: 1229,
|
||||||
|
stint_number: 1,
|
||||||
|
compound: 'SOFT',
|
||||||
|
lap_start: 1,
|
||||||
|
lap_end: 18,
|
||||||
|
tyre_age_at_start: 0,
|
||||||
|
},
|
||||||
|
]
|
||||||
|
|
||||||
|
const pitStops: PitStop[] = []
|
||||||
|
|
||||||
|
describe('StrategyView integration', () => {
|
||||||
|
it('renders timeline when stints exist', () => {
|
||||||
|
const { container } = render(
|
||||||
|
<StrategyView results={results} stints={stints} pit_stops={pitStops} hasStints={true} />,
|
||||||
|
)
|
||||||
|
expect(container.querySelector('[data-testid="strategy-chart"]')).toBeInTheDocument()
|
||||||
|
expect(screen.getByTestId('stint-timeline')).toBeInTheDocument()
|
||||||
|
expect(screen.getByText('VER')).toBeInTheDocument()
|
||||||
|
expect(screen.getByText('HAM')).toBeInTheDocument()
|
||||||
|
expect(container.querySelectorAll('.stint-timeline__bar')).toHaveLength(2)
|
||||||
|
})
|
||||||
|
})
|
||||||
281
frontend/src/test/tyredeg.test.ts
Normal file
281
frontend/src/test/tyredeg.test.ts
Normal file
@@ -0,0 +1,281 @@
|
|||||||
|
import { describe, expect, it } from 'vitest'
|
||||||
|
import {
|
||||||
|
DEG_SLOPE_THRESHOLD,
|
||||||
|
MIN_CLEAN_LAPS,
|
||||||
|
PIT_LOSS_SECONDS,
|
||||||
|
cleanStintSamples,
|
||||||
|
degradationModel,
|
||||||
|
estimatePitRejoin,
|
||||||
|
formatSlope,
|
||||||
|
parseLapTimeSeconds,
|
||||||
|
recordStintSamples,
|
||||||
|
stintInputFromRow,
|
||||||
|
} from '../lib/tyredeg'
|
||||||
|
import type { StintHistoryMap, StintLapInput, StintSample } from '../lib/tyredeg'
|
||||||
|
import type { LiveTimingRow } from '../lib/live'
|
||||||
|
import type { LiveDriverData } from '../types'
|
||||||
|
|
||||||
|
function makeInput(overrides: Partial<StintLapInput> = {}): StintLapInput {
|
||||||
|
return {
|
||||||
|
racingNumber: '1',
|
||||||
|
lapNumber: 1,
|
||||||
|
lastLapTime: '1:30.000',
|
||||||
|
compound: 'MEDIUM',
|
||||||
|
tyreAge: 1,
|
||||||
|
inPit: false,
|
||||||
|
pitOut: false,
|
||||||
|
...overrides,
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
/** Feed a sequence of snapshots for one driver through the accumulator. */
|
||||||
|
function accumulate(snapshots: Array<Partial<StintLapInput>>): StintHistoryMap {
|
||||||
|
let history: StintHistoryMap = {}
|
||||||
|
for (const snapshot of snapshots) {
|
||||||
|
history = recordStintSamples(history, [makeInput(snapshot)])
|
||||||
|
}
|
||||||
|
return history
|
||||||
|
}
|
||||||
|
|
||||||
|
function makeRow(
|
||||||
|
number: string,
|
||||||
|
position: number,
|
||||||
|
tla: string,
|
||||||
|
driver: Partial<LiveDriverData> = {},
|
||||||
|
): LiveTimingRow {
|
||||||
|
return {
|
||||||
|
RacingNumber: number,
|
||||||
|
Position: position,
|
||||||
|
Driver: {
|
||||||
|
RacingNumber: number,
|
||||||
|
Position: position,
|
||||||
|
Interval: '',
|
||||||
|
GapToLeader: '',
|
||||||
|
LastLapTime: '1:30.000',
|
||||||
|
NumberOfLaps: 10,
|
||||||
|
InPit: false,
|
||||||
|
PitOut: false,
|
||||||
|
Retired: false,
|
||||||
|
...driver,
|
||||||
|
} as LiveDriverData,
|
||||||
|
Info: {
|
||||||
|
RacingNumber: number,
|
||||||
|
BroadcastName: '',
|
||||||
|
Tla: tla,
|
||||||
|
TeamName: '',
|
||||||
|
TeamColour: '3671c6',
|
||||||
|
FirstName: '',
|
||||||
|
LastName: '',
|
||||||
|
},
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
describe('parseLapTimeSeconds', () => {
|
||||||
|
it('parses minute-form and plain-second lap times', () => {
|
||||||
|
expect(parseLapTimeSeconds('1:23.456')).toBeCloseTo(83.456)
|
||||||
|
expect(parseLapTimeSeconds('83.456')).toBeCloseTo(83.456)
|
||||||
|
})
|
||||||
|
|
||||||
|
it('rejects empty, garbage, and non-positive values', () => {
|
||||||
|
expect(parseLapTimeSeconds('')).toBeNull()
|
||||||
|
expect(parseLapTimeSeconds(undefined)).toBeNull()
|
||||||
|
expect(parseLapTimeSeconds(null)).toBeNull()
|
||||||
|
expect(parseLapTimeSeconds('LAP 12')).toBeNull()
|
||||||
|
expect(parseLapTimeSeconds('-1:30.000')).toBeNull()
|
||||||
|
})
|
||||||
|
})
|
||||||
|
|
||||||
|
describe('recordStintSamples', () => {
|
||||||
|
it('accumulates one sample per completed lap across snapshots', () => {
|
||||||
|
const history = accumulate([
|
||||||
|
{ lapNumber: 1, lastLapTime: '1:30.000' },
|
||||||
|
{ lapNumber: 2, lastLapTime: '1:30.100' },
|
||||||
|
{ lapNumber: 2, lastLapTime: '1:30.100' }, // repeated snapshot, same lap
|
||||||
|
{ lapNumber: 3, lastLapTime: '1:30.200' },
|
||||||
|
])
|
||||||
|
expect(history['1'].samples).toEqual([
|
||||||
|
{ lap: 2, seconds: 90.1 },
|
||||||
|
{ lap: 3, seconds: 90.2 },
|
||||||
|
])
|
||||||
|
})
|
||||||
|
|
||||||
|
it('does not record a lap from the very first snapshot seen', () => {
|
||||||
|
const history = accumulate([{ lapNumber: 5, lastLapTime: '1:29.000' }])
|
||||||
|
expect(history['1'].samples).toEqual([])
|
||||||
|
})
|
||||||
|
|
||||||
|
it('replaces (not duplicates) a sample when the lap time is corrected', () => {
|
||||||
|
const history = accumulate([
|
||||||
|
{ lapNumber: 1, lastLapTime: '1:30.000' },
|
||||||
|
{ lapNumber: 2, lastLapTime: '1:30.500' },
|
||||||
|
{ lapNumber: 2, lastLapTime: '1:30.400' }, // late correction for lap 2
|
||||||
|
])
|
||||||
|
expect(history['1'].samples).toEqual([{ lap: 2, seconds: 90.4 }])
|
||||||
|
})
|
||||||
|
|
||||||
|
it('resets the stint on compound change and skips the next lap', () => {
|
||||||
|
const history = accumulate([
|
||||||
|
{ lapNumber: 1, lastLapTime: '1:30.000', compound: 'SOFT', tyreAge: 1 },
|
||||||
|
{ lapNumber: 2, lastLapTime: '1:30.100', compound: 'SOFT', tyreAge: 2 },
|
||||||
|
{ lapNumber: 3, lastLapTime: '1:30.200', compound: 'SOFT', tyreAge: 3 },
|
||||||
|
// Boxed for hards: old samples dropped, out-lap (lap 4) excluded.
|
||||||
|
{ lapNumber: 4, lastLapTime: '1:52.000', compound: 'HARD', tyreAge: 0 },
|
||||||
|
{ lapNumber: 5, lastLapTime: '1:31.000', compound: 'HARD', tyreAge: 1 },
|
||||||
|
{ lapNumber: 6, lastLapTime: '1:31.100', compound: 'HARD', tyreAge: 2 },
|
||||||
|
])
|
||||||
|
expect(history['1'].samples).toEqual([
|
||||||
|
{ lap: 5, seconds: 91.0 },
|
||||||
|
{ lap: 6, seconds: 91.1 },
|
||||||
|
])
|
||||||
|
})
|
||||||
|
|
||||||
|
it('resets on a fresh set of the same compound (tyre age drops)', () => {
|
||||||
|
const history = accumulate([
|
||||||
|
{ lapNumber: 1, lastLapTime: '1:30.000', tyreAge: 10 },
|
||||||
|
{ lapNumber: 2, lastLapTime: '1:30.100', tyreAge: 11 },
|
||||||
|
{ lapNumber: 3, lastLapTime: '1:50.000', tyreAge: 0 }, // new mediums
|
||||||
|
{ lapNumber: 4, lastLapTime: '1:30.500', tyreAge: 1 },
|
||||||
|
])
|
||||||
|
expect(history['1'].samples).toEqual([{ lap: 4, seconds: 90.5 }])
|
||||||
|
})
|
||||||
|
|
||||||
|
it('excludes laps completed in the pit lane or on pit exit', () => {
|
||||||
|
const history = accumulate([
|
||||||
|
{ lapNumber: 1, lastLapTime: '1:30.000' },
|
||||||
|
{ lapNumber: 2, lastLapTime: '1:30.100' },
|
||||||
|
{ lapNumber: 3, lastLapTime: '1:48.000', inPit: true }, // in-lap
|
||||||
|
{ lapNumber: 4, lastLapTime: '1:45.000', pitOut: true, tyreAge: 0 }, // out-lap
|
||||||
|
{ lapNumber: 5, lastLapTime: '1:30.300', tyreAge: 1 },
|
||||||
|
])
|
||||||
|
expect(history['1'].samples).toEqual([{ lap: 5, seconds: 90.3 }])
|
||||||
|
})
|
||||||
|
|
||||||
|
it('prunes drivers missing from the snapshot and does not mutate input', () => {
|
||||||
|
const initial = accumulate([
|
||||||
|
{ lapNumber: 1, lastLapTime: '1:30.000' },
|
||||||
|
{ lapNumber: 2, lastLapTime: '1:30.100' },
|
||||||
|
])
|
||||||
|
const next = recordStintSamples(initial, [makeInput({ racingNumber: '44' })])
|
||||||
|
expect(next['1']).toBeUndefined()
|
||||||
|
expect(next['44']).toBeDefined()
|
||||||
|
expect(initial['1'].samples).toHaveLength(1)
|
||||||
|
})
|
||||||
|
})
|
||||||
|
|
||||||
|
describe('degradationModel', () => {
|
||||||
|
const series = (times: number[], startLap = 1): StintSample[] =>
|
||||||
|
times.map((seconds, index) => ({ lap: startLap + index, seconds }))
|
||||||
|
|
||||||
|
it('fits the slope of a known linear series', () => {
|
||||||
|
const model = degradationModel(series([90.0, 90.1, 90.2, 90.3, 90.4]))
|
||||||
|
expect(model).not.toBeNull()
|
||||||
|
expect(model!.slope).toBeCloseTo(0.1, 5)
|
||||||
|
expect(model!.trend).toBe('degrading')
|
||||||
|
})
|
||||||
|
|
||||||
|
it('classifies improving and stable stints', () => {
|
||||||
|
expect(degradationModel(series([91.0, 90.8, 90.6, 90.4]))!.trend).toBe('improving')
|
||||||
|
expect(degradationModel(series([90.0, 90.01, 90.0, 90.02, 90.01]))!.trend).toBe('stable')
|
||||||
|
// A slope clearly under the threshold stays stable.
|
||||||
|
expect(DEG_SLOPE_THRESHOLD).toBeGreaterThan(0.03)
|
||||||
|
expect(degradationModel(series([90.0, 90.03, 90.06, 90.09, 90.12]))!.trend).toBe('stable')
|
||||||
|
})
|
||||||
|
|
||||||
|
it('excludes outliers more than ~5s off the stint median', () => {
|
||||||
|
// Clean laps follow +0.1s/lap; the 97.5 (traffic/spin) must not skew the fit.
|
||||||
|
const samples = series([90.0, 90.1, 97.5, 90.3, 90.4, 90.5])
|
||||||
|
expect(cleanStintSamples(samples)).toHaveLength(5)
|
||||||
|
const model = degradationModel(samples)
|
||||||
|
expect(model!.samples).toHaveLength(5)
|
||||||
|
expect(model!.slope).toBeCloseTo(0.1, 5)
|
||||||
|
})
|
||||||
|
|
||||||
|
it('returns null with fewer than MIN_CLEAN_LAPS clean laps', () => {
|
||||||
|
expect(degradationModel(series([90.0, 90.1, 90.2]))).toBeNull()
|
||||||
|
// 4 raw laps but one outlier -> only 3 clean -> still warming up
|
||||||
|
expect(degradationModel(series([90.0, 90.1, 90.2, 99.0]))).toBeNull()
|
||||||
|
expect(MIN_CLEAN_LAPS).toBe(4)
|
||||||
|
})
|
||||||
|
})
|
||||||
|
|
||||||
|
describe('formatSlope', () => {
|
||||||
|
it('renders signed seconds-per-lap', () => {
|
||||||
|
expect(formatSlope(0.083)).toBe('+0.08s/lap')
|
||||||
|
expect(formatSlope(-0.125)).toBe('−0.13s/lap')
|
||||||
|
})
|
||||||
|
})
|
||||||
|
|
||||||
|
describe('estimatePitRejoin', () => {
|
||||||
|
const ladder = [
|
||||||
|
makeRow('1', 1, 'VER'),
|
||||||
|
makeRow('4', 2, 'NOR', { Interval: '+5.0' }),
|
||||||
|
makeRow('44', 3, 'HAM', { Interval: '+10.0' }),
|
||||||
|
makeRow('14', 4, 'ALO', { Interval: '+15.0' }),
|
||||||
|
makeRow('16', 5, 'LEC', { Interval: '+20.0' }),
|
||||||
|
]
|
||||||
|
|
||||||
|
it('projects the rejoin slot between the right cars', () => {
|
||||||
|
// VER pits from P1: NOR (5s) and HAM (15s cumulative) get past;
|
||||||
|
// ALO would be 30s back -> stays behind. Rejoin ~P3.
|
||||||
|
const estimate = estimatePitRejoin(ladder, '1')
|
||||||
|
expect(estimate).toEqual({
|
||||||
|
rejoinPosition: 3,
|
||||||
|
positionsLost: 2,
|
||||||
|
aheadCode: 'HAM',
|
||||||
|
behindCode: 'ALO',
|
||||||
|
})
|
||||||
|
})
|
||||||
|
|
||||||
|
it('keeps position when the cars behind are further than the pit loss', () => {
|
||||||
|
const estimate = estimatePitRejoin(ladder, '14')
|
||||||
|
// LEC is 20s behind ALO — inside the 22s window, so he gets past.
|
||||||
|
expect(estimate!.rejoinPosition).toBe(5)
|
||||||
|
expect(estimate!.aheadCode).toBe('LEC')
|
||||||
|
expect(estimate!.behindCode).toBeNull()
|
||||||
|
|
||||||
|
const wide = estimatePitRejoin(
|
||||||
|
[makeRow('1', 1, 'VER'), makeRow('4', 2, 'NOR', { Interval: `+${PIT_LOSS_SECONDS + 3}.0` })],
|
||||||
|
'1',
|
||||||
|
)
|
||||||
|
expect(wide!.rejoinPosition).toBe(1)
|
||||||
|
expect(wide!.positionsLost).toBe(0)
|
||||||
|
expect(wide!.behindCode).toBe('NOR')
|
||||||
|
})
|
||||||
|
|
||||||
|
it('stops the ladder walk at lapped cars and skips pitted/retired ones', () => {
|
||||||
|
const estimate = estimatePitRejoin(
|
||||||
|
[
|
||||||
|
makeRow('1', 1, 'VER'),
|
||||||
|
makeRow('4', 2, 'NOR', { Interval: '+5.0', InPit: true }), // mid-stop, excluded
|
||||||
|
makeRow('44', 3, 'HAM', { Interval: '+10.0' }),
|
||||||
|
makeRow('16', 4, 'LEC', { Interval: '1L' }), // lapped — walk ends here
|
||||||
|
makeRow('14', 5, 'ALO', { Interval: '+2.0' }),
|
||||||
|
],
|
||||||
|
'1',
|
||||||
|
)
|
||||||
|
expect(estimate!.positionsLost).toBe(1) // only HAM gets past
|
||||||
|
expect(estimate!.rejoinPosition).toBe(2)
|
||||||
|
expect(estimate!.aheadCode).toBe('HAM')
|
||||||
|
expect(estimate!.behindCode).toBe('LEC')
|
||||||
|
})
|
||||||
|
|
||||||
|
it('returns null for unknown drivers', () => {
|
||||||
|
expect(estimatePitRejoin(ladder, '99')).toBeNull()
|
||||||
|
})
|
||||||
|
})
|
||||||
|
|
||||||
|
describe('stintInputFromRow', () => {
|
||||||
|
it('maps tower rows into accumulator inputs', () => {
|
||||||
|
const row = makeRow('4', 2, 'NOR', { NumberOfLaps: 12, LastLapTime: '1:29.900' })
|
||||||
|
row.Tyre = { Compound: 'HARD', New: false, Age: 7 }
|
||||||
|
expect(stintInputFromRow(row)).toEqual({
|
||||||
|
racingNumber: '4',
|
||||||
|
lapNumber: 12,
|
||||||
|
lastLapTime: '1:29.900',
|
||||||
|
compound: 'HARD',
|
||||||
|
tyreAge: 7,
|
||||||
|
inPit: false,
|
||||||
|
pitOut: false,
|
||||||
|
})
|
||||||
|
})
|
||||||
|
})
|
||||||
@@ -12,6 +12,7 @@ export interface Meeting {
|
|||||||
country_name: string
|
country_name: string
|
||||||
country_code: string
|
country_code: string
|
||||||
country_flag: string
|
country_flag: string
|
||||||
|
circuit_key?: number
|
||||||
circuit_short_name: string
|
circuit_short_name: string
|
||||||
date_start: string
|
date_start: string
|
||||||
date_end: string
|
date_end: string
|
||||||
@@ -23,6 +24,7 @@ export interface Session {
|
|||||||
session_key: number
|
session_key: number
|
||||||
session_name: string
|
session_name: string
|
||||||
session_type: string
|
session_type: string
|
||||||
|
circuit_key?: number
|
||||||
meeting_key: number
|
meeting_key: number
|
||||||
date_start: string
|
date_start: string
|
||||||
date_end: string
|
date_end: string
|
||||||
@@ -158,6 +160,37 @@ export interface Lap {
|
|||||||
is_pit_out_lap: boolean
|
is_pit_out_lap: boolean
|
||||||
}
|
}
|
||||||
|
|
||||||
|
export interface CarDataSample {
|
||||||
|
brake: number
|
||||||
|
date: string
|
||||||
|
driver_number: number
|
||||||
|
drs: number
|
||||||
|
meeting_key: number
|
||||||
|
n_gear: number
|
||||||
|
rpm: number
|
||||||
|
session_key: number
|
||||||
|
speed: number
|
||||||
|
throttle: number
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface ComparisonLap extends Lap {
|
||||||
|
compound?: string
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface ComparisonDriver {
|
||||||
|
driver_number: number
|
||||||
|
name_acronym: string
|
||||||
|
team_colour: string
|
||||||
|
laps: ComparisonLap[]
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface LapsComparisonResponse {
|
||||||
|
session_key: number
|
||||||
|
sc_periods: unknown[]
|
||||||
|
pit_laps: Record<string, number[]>
|
||||||
|
drivers: ComparisonDriver[]
|
||||||
|
}
|
||||||
|
|
||||||
export interface WeekendSession {
|
export interface WeekendSession {
|
||||||
session: Session
|
session: Session
|
||||||
source: 'local' | 'partial' | 'none' | 'cancelled'
|
source: 'local' | 'partial' | 'none' | 'cancelled'
|
||||||
@@ -175,6 +208,25 @@ export interface Weekend {
|
|||||||
export interface LiveStateResponse {
|
export interface LiveStateResponse {
|
||||||
is_live: boolean
|
is_live: boolean
|
||||||
data: LiveStreamData | null
|
data: LiveStreamData | null
|
||||||
|
last_snapshot?: LiveStreamData | null
|
||||||
|
last_positions?: Record<string, LivePosition> | null
|
||||||
|
last_snapshot_at?: string
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface LivePosition {
|
||||||
|
x: number
|
||||||
|
y: number
|
||||||
|
z: number
|
||||||
|
status: string
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface LiveTelemetry {
|
||||||
|
Speed: number
|
||||||
|
Throttle: number
|
||||||
|
Brake: number
|
||||||
|
DRS: number
|
||||||
|
NGear: number
|
||||||
|
RPM: number
|
||||||
}
|
}
|
||||||
|
|
||||||
export interface LiveSectorData {
|
export interface LiveSectorData {
|
||||||
@@ -245,6 +297,7 @@ export interface LiveSessionMeta {
|
|||||||
CircuitName: string
|
CircuitName: string
|
||||||
SessionType: string
|
SessionType: string
|
||||||
SessionName: string
|
SessionName: string
|
||||||
|
Path: string
|
||||||
}
|
}
|
||||||
|
|
||||||
export interface LiveStintData {
|
export interface LiveStintData {
|
||||||
@@ -253,13 +306,22 @@ export interface LiveStintData {
|
|||||||
Laps: number
|
Laps: number
|
||||||
}
|
}
|
||||||
|
|
||||||
|
export interface LiveRadioCapture {
|
||||||
|
Utc: string
|
||||||
|
RacingNumber: string
|
||||||
|
Path: string
|
||||||
|
}
|
||||||
|
|
||||||
export interface LiveStreamData {
|
export interface LiveStreamData {
|
||||||
Drivers: Record<string, LiveDriverData>
|
Drivers: Record<string, LiveDriverData>
|
||||||
DriverInfo: Record<string, LiveDriverInfo>
|
DriverInfo: Record<string, LiveDriverInfo>
|
||||||
Tyres: Record<string, LiveTyreData>
|
Tyres: Record<string, LiveTyreData>
|
||||||
|
Telemetry?: Record<string, LiveTelemetry>
|
||||||
RCMessages: LiveRCMessage[]
|
RCMessages: LiveRCMessage[]
|
||||||
Weather: LiveWeatherData
|
Weather: LiveWeatherData
|
||||||
Session: LiveSessionMeta
|
Session: LiveSessionMeta
|
||||||
|
TeamRadio: LiveRadioCapture[]
|
||||||
|
SessionStatus?: string
|
||||||
TrackStatus: string
|
TrackStatus: string
|
||||||
CurrentLap: number
|
CurrentLap: number
|
||||||
TotalLaps: number
|
TotalLaps: number
|
||||||
@@ -269,6 +331,24 @@ export interface LiveStreamData {
|
|||||||
Stints: Record<string, LiveStintData[]>
|
Stints: Record<string, LiveStintData[]>
|
||||||
}
|
}
|
||||||
|
|
||||||
|
export interface TrackPoint {
|
||||||
|
x: number
|
||||||
|
y: number
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface TrackBounds {
|
||||||
|
minX: number
|
||||||
|
maxX: number
|
||||||
|
minY: number
|
||||||
|
maxY: number
|
||||||
|
}
|
||||||
|
|
||||||
|
export interface TrackOutline {
|
||||||
|
circuit_key: number
|
||||||
|
points: TrackPoint[]
|
||||||
|
bounds: TrackBounds
|
||||||
|
}
|
||||||
|
|
||||||
export interface ChampHubDriver {
|
export interface ChampHubDriver {
|
||||||
driver_number: number
|
driver_number: number
|
||||||
name_acronym: string
|
name_acronym: string
|
||||||
|
|||||||
@@ -94,6 +94,12 @@ func cacheDBPath() string {
|
|||||||
return filepath.Join(".cache", "box-box", "cache.db")
|
return filepath.Join(".cache", "box-box", "cache.db")
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// DefaultCacheDBPath returns the HTTP cache database path used by the OpenF1
|
||||||
|
// client in both TUI and web modes.
|
||||||
|
func DefaultCacheDBPath() string {
|
||||||
|
return cacheDBPath()
|
||||||
|
}
|
||||||
|
|
||||||
// ttlForURL determines the appropriate TTL based on the URL pattern.
|
// ttlForURL determines the appropriate TTL based on the URL pattern.
|
||||||
// Returns 0 (CacheTTLForever) for historical data that will never change.
|
// Returns 0 (CacheTTLForever) for historical data that will never change.
|
||||||
func ttlForURL(url string) time.Duration {
|
func ttlForURL(url string) time.Duration {
|
||||||
|
|||||||
@@ -623,6 +623,19 @@ func (c *OpenF1Client) GetTeamRadio(sessionKey, driverNumber int) ([]models.Team
|
|||||||
// to maximise the chance of finding data quickly.
|
// to maximise the chance of finding data quickly.
|
||||||
var candidateDrivers = []int{1, 11, 44, 16, 55, 4, 14, 63, 81, 24}
|
var candidateDrivers = []int{1, 11, 44, 16, 55, 4, 14, 63, 81, 24}
|
||||||
|
|
||||||
|
// TrackOutlinePrefetchResult summarizes a season track-outline cache warming
|
||||||
|
// run. Counts are scoped to the unique non-zero circuit keys in the provided
|
||||||
|
// meeting list.
|
||||||
|
type TrackOutlinePrefetchResult struct {
|
||||||
|
Year int
|
||||||
|
UniqueCircuits int
|
||||||
|
CachedBefore int
|
||||||
|
CachedAfter int
|
||||||
|
Skipped int
|
||||||
|
Fetched int
|
||||||
|
Failed int
|
||||||
|
}
|
||||||
|
|
||||||
// PrefetchTrackOutlines fetches GPS location data for every circuit in the
|
// PrefetchTrackOutlines fetches GPS location data for every circuit in the
|
||||||
// provided meeting list and stores it in the cache so the track map tab can
|
// provided meeting list and stores it in the cache so the track map tab can
|
||||||
// render during live sessions when the free-tier API is locked.
|
// render during live sessions when the free-tier API is locked.
|
||||||
@@ -632,28 +645,58 @@ var candidateDrivers = []int{1, 11, 44, 16, 55, 4, 14, 63, 81, 24}
|
|||||||
// Errors per-circuit are silently ignored — this is a best-effort operation
|
// Errors per-circuit are silently ignored — this is a best-effort operation
|
||||||
// and must never block or crash the main UI.
|
// and must never block or crash the main UI.
|
||||||
func (c *OpenF1Client) PrefetchTrackOutlines(meetings []models.Meeting) {
|
func (c *OpenF1Client) PrefetchTrackOutlines(meetings []models.Meeting) {
|
||||||
|
year := time.Now().Year()
|
||||||
|
for _, m := range meetings {
|
||||||
|
if m.Year != 0 {
|
||||||
|
year = m.Year
|
||||||
|
break
|
||||||
|
}
|
||||||
|
}
|
||||||
|
_ = c.PrefetchTrackOutlinesForYear(year, meetings)
|
||||||
|
}
|
||||||
|
|
||||||
|
// PrefetchTrackOutlinesForYear fetches and caches track outlines for unique
|
||||||
|
// circuits in the provided meeting list, storing them under the explicit season
|
||||||
|
// year. Unlike PrefetchTrackOutlines, it returns accounting suitable for CLI
|
||||||
|
// cache-warming workflows.
|
||||||
|
func (c *OpenF1Client) PrefetchTrackOutlinesForYear(year int, meetings []models.Meeting) TrackOutlinePrefetchResult {
|
||||||
const maxWorkers = 3
|
const maxWorkers = 3
|
||||||
|
|
||||||
year := time.Now().Year()
|
result := TrackOutlinePrefetchResult{Year: year}
|
||||||
|
uniqueByCircuit := make(map[int]models.Meeting)
|
||||||
// Filter to meetings that need fetching.
|
var unique []models.Meeting
|
||||||
var pending []models.Meeting
|
|
||||||
for _, m := range meetings {
|
for _, m := range meetings {
|
||||||
if m.CircuitKey == 0 {
|
if m.CircuitKey == 0 {
|
||||||
continue
|
continue
|
||||||
}
|
}
|
||||||
|
if _, exists := uniqueByCircuit[m.CircuitKey]; exists {
|
||||||
|
continue
|
||||||
|
}
|
||||||
|
uniqueByCircuit[m.CircuitKey] = m
|
||||||
|
unique = append(unique, m)
|
||||||
|
}
|
||||||
|
|
||||||
|
result.UniqueCircuits = len(unique)
|
||||||
|
|
||||||
|
// Filter to meetings that need fetching.
|
||||||
|
var pending []models.Meeting
|
||||||
|
for _, m := range unique {
|
||||||
if _, ok := c.cache.GetTrackOutline(m.CircuitKey, year); ok {
|
if _, ok := c.cache.GetTrackOutline(m.CircuitKey, year); ok {
|
||||||
|
result.CachedBefore++
|
||||||
|
result.Skipped++
|
||||||
continue // already cached for this season
|
continue // already cached for this season
|
||||||
}
|
}
|
||||||
pending = append(pending, m)
|
pending = append(pending, m)
|
||||||
}
|
}
|
||||||
|
|
||||||
if len(pending) == 0 {
|
if len(pending) == 0 {
|
||||||
return
|
result.CachedAfter = result.CachedBefore
|
||||||
|
return result
|
||||||
}
|
}
|
||||||
|
|
||||||
sem := make(chan struct{}, maxWorkers)
|
sem := make(chan struct{}, maxWorkers)
|
||||||
var wg sync.WaitGroup
|
var wg sync.WaitGroup
|
||||||
|
var mu sync.Mutex
|
||||||
|
|
||||||
for _, mtg := range pending {
|
for _, mtg := range pending {
|
||||||
mtg := mtg // capture
|
mtg := mtg // capture
|
||||||
@@ -662,19 +705,34 @@ func (c *OpenF1Client) PrefetchTrackOutlines(meetings []models.Meeting) {
|
|||||||
go func() {
|
go func() {
|
||||||
defer wg.Done()
|
defer wg.Done()
|
||||||
defer func() { <-sem }()
|
defer func() { <-sem }()
|
||||||
c.prefetchCircuit(mtg, year)
|
ok := c.prefetchCircuit(mtg, year)
|
||||||
|
mu.Lock()
|
||||||
|
if ok {
|
||||||
|
result.Fetched++
|
||||||
|
} else {
|
||||||
|
result.Failed++
|
||||||
|
}
|
||||||
|
mu.Unlock()
|
||||||
}()
|
}()
|
||||||
}
|
}
|
||||||
|
|
||||||
wg.Wait()
|
wg.Wait()
|
||||||
|
|
||||||
|
for _, m := range unique {
|
||||||
|
if _, ok := c.cache.GetTrackOutline(m.CircuitKey, year); ok {
|
||||||
|
result.CachedAfter++
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
return result
|
||||||
}
|
}
|
||||||
|
|
||||||
// prefetchCircuit fetches the track outline for a single meeting and stores it.
|
// prefetchCircuit fetches the track outline for a single meeting and stores it.
|
||||||
// It prefers completed sessions (past date_end) so the data is full and stable.
|
// It prefers completed sessions (past date_end) so the data is full and stable.
|
||||||
func (c *OpenF1Client) prefetchCircuit(mtg models.Meeting, year int) {
|
func (c *OpenF1Client) prefetchCircuit(mtg models.Meeting, year int) bool {
|
||||||
sessions, err := c.GetSessionsForMeeting(int(mtg.MeetingKey))
|
sessions, err := c.GetSessionsForMeeting(int(mtg.MeetingKey))
|
||||||
if err != nil || len(sessions) == 0 {
|
if err != nil || len(sessions) == 0 {
|
||||||
return
|
return false
|
||||||
}
|
}
|
||||||
|
|
||||||
// Pick the best session: prefer a completed race, then any session with
|
// Pick the best session: prefer a completed race, then any session with
|
||||||
@@ -696,7 +754,7 @@ func (c *OpenF1Client) prefetchCircuit(mtg models.Meeting, year int) {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
if bestSession == nil {
|
if bestSession == nil {
|
||||||
return
|
return false
|
||||||
}
|
}
|
||||||
|
|
||||||
// Try candidate drivers in order until we find one with enough points.
|
// Try candidate drivers in order until we find one with enough points.
|
||||||
@@ -706,7 +764,7 @@ func (c *OpenF1Client) prefetchCircuit(mtg models.Meeting, year int) {
|
|||||||
continue
|
continue
|
||||||
}
|
}
|
||||||
// Store under the circuit key for this year and stop.
|
// Store under the circuit key for this year and stop.
|
||||||
_ = c.cache.SetTrackOutline(mtg.CircuitKey, year, locs)
|
return c.cache.SetTrackOutline(mtg.CircuitKey, year, locs) == nil
|
||||||
return
|
|
||||||
}
|
}
|
||||||
|
return false
|
||||||
}
|
}
|
||||||
|
|||||||
109
internal/api/track_outline_prefetch_test.go
Normal file
109
internal/api/track_outline_prefetch_test.go
Normal file
@@ -0,0 +1,109 @@
|
|||||||
|
package api
|
||||||
|
|
||||||
|
import (
|
||||||
|
"encoding/json"
|
||||||
|
"net/http"
|
||||||
|
"net/http/httptest"
|
||||||
|
"strconv"
|
||||||
|
"testing"
|
||||||
|
"time"
|
||||||
|
|
||||||
|
"github.com/AmanTahiliani/box-box/internal/models"
|
||||||
|
)
|
||||||
|
|
||||||
|
func newTrackOutlineTestClient(t *testing.T, srvURL string) *OpenF1Client {
|
||||||
|
t.Helper()
|
||||||
|
t.Setenv("HOME", t.TempDir())
|
||||||
|
t.Setenv("XDG_CACHE_HOME", t.TempDir())
|
||||||
|
|
||||||
|
c := NewOpenF1Client(srvURL, 5*time.Second)
|
||||||
|
c.pacer = &requestPacer{}
|
||||||
|
t.Cleanup(func() { _ = c.Close() })
|
||||||
|
return c
|
||||||
|
}
|
||||||
|
|
||||||
|
func TestPrefetchTrackOutlinesForYearSkipsCachedAndWritesLocations(t *testing.T) {
|
||||||
|
var sessionsByMeeting = map[string][]models.Session{
|
||||||
|
"202": {
|
||||||
|
{
|
||||||
|
SessionKey: 9002,
|
||||||
|
SessionName: "Race",
|
||||||
|
MeetingKey: 202,
|
||||||
|
CircuitKey: 2,
|
||||||
|
DateEnd: "2026-01-01T12:00:00+00:00",
|
||||||
|
},
|
||||||
|
},
|
||||||
|
}
|
||||||
|
var sessionsRequested []string
|
||||||
|
var locationsRequested []string
|
||||||
|
|
||||||
|
srv := httptest.NewServer(http.HandlerFunc(func(w http.ResponseWriter, r *http.Request) {
|
||||||
|
switch r.URL.Path {
|
||||||
|
case "/v1/sessions":
|
||||||
|
meetingKey := r.URL.Query().Get("meeting_key")
|
||||||
|
sessionsRequested = append(sessionsRequested, meetingKey)
|
||||||
|
_ = json.NewEncoder(w).Encode(sessionsByMeeting[meetingKey])
|
||||||
|
case "/v1/location":
|
||||||
|
sessionKey := r.URL.Query().Get("session_key")
|
||||||
|
driverNumber := r.URL.Query().Get("driver_number")
|
||||||
|
locationsRequested = append(locationsRequested, sessionKey+"/"+driverNumber)
|
||||||
|
_ = json.NewEncoder(w).Encode(testLocations(9002, 1, 51))
|
||||||
|
default:
|
||||||
|
t.Fatalf("unexpected request path %s", r.URL.Path)
|
||||||
|
}
|
||||||
|
}))
|
||||||
|
defer srv.Close()
|
||||||
|
|
||||||
|
client := newTrackOutlineTestClient(t, srv.URL)
|
||||||
|
if err := client.Cache().SetTrackOutline(1, 2026, testLocations(9001, 1, 51)); err != nil {
|
||||||
|
t.Fatalf("SetTrackOutline() error = %v", err)
|
||||||
|
}
|
||||||
|
|
||||||
|
result := client.PrefetchTrackOutlinesForYear(2026, []models.Meeting{
|
||||||
|
{MeetingKey: 101, Year: 2026, Circuit: models.Circuit{CircuitKey: 1}},
|
||||||
|
{MeetingKey: 202, Year: 2026, Circuit: models.Circuit{CircuitKey: 2}},
|
||||||
|
{MeetingKey: 303, Year: 2026, Circuit: models.Circuit{CircuitKey: 2}},
|
||||||
|
})
|
||||||
|
|
||||||
|
if result.UniqueCircuits != 2 {
|
||||||
|
t.Fatalf("UniqueCircuits = %d, want 2", result.UniqueCircuits)
|
||||||
|
}
|
||||||
|
if result.CachedBefore != 1 || result.Skipped != 1 || result.Fetched != 1 || result.Failed != 0 || result.CachedAfter != 2 {
|
||||||
|
t.Fatalf("unexpected result: %+v", result)
|
||||||
|
}
|
||||||
|
if got, want := len(sessionsRequested), 1; got != want {
|
||||||
|
t.Fatalf("sessions requested %d time(s), want %d: %v", got, want, sessionsRequested)
|
||||||
|
}
|
||||||
|
if sessionsRequested[0] != "202" {
|
||||||
|
t.Fatalf("requested meeting %s, want 202", sessionsRequested[0])
|
||||||
|
}
|
||||||
|
if got, want := len(locationsRequested), 1; got != want {
|
||||||
|
t.Fatalf("locations requested %d time(s), want %d: %v", got, want, locationsRequested)
|
||||||
|
}
|
||||||
|
if locationsRequested[0] != "9002/1" {
|
||||||
|
t.Fatalf("requested location %s, want 9002/1", locationsRequested[0])
|
||||||
|
}
|
||||||
|
|
||||||
|
locs, ok := client.Cache().GetTrackOutline(2, 2026)
|
||||||
|
if !ok {
|
||||||
|
t.Fatal("expected circuit 2 outline to be cached")
|
||||||
|
}
|
||||||
|
if len(locs) != 51 {
|
||||||
|
t.Fatalf("cached %d locations, want 51", len(locs))
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
func testLocations(sessionKey, driverNumber, count int) []models.Location {
|
||||||
|
locs := make([]models.Location, count)
|
||||||
|
for i := range locs {
|
||||||
|
locs[i] = models.Location{
|
||||||
|
Date: "2026-01-01T12:00:" + strconv.Itoa(i%60) + "+00:00",
|
||||||
|
DriverNumber: driverNumber,
|
||||||
|
MeetingKey: 202,
|
||||||
|
SessionKey: sessionKey,
|
||||||
|
X: float64(i),
|
||||||
|
Y: float64(i * 2),
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return locs
|
||||||
|
}
|
||||||
@@ -1,7 +1,11 @@
|
|||||||
package live_test
|
package live_test
|
||||||
|
|
||||||
import (
|
import (
|
||||||
|
"bytes"
|
||||||
|
"compress/flate"
|
||||||
|
"encoding/base64"
|
||||||
"encoding/json"
|
"encoding/json"
|
||||||
|
"fmt"
|
||||||
"testing"
|
"testing"
|
||||||
"time"
|
"time"
|
||||||
|
|
||||||
@@ -158,6 +162,68 @@ func TestProcessTopicTimingData(t *testing.T) {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
func TestProcessTopicCompressedPositionAndCarData(t *testing.T) {
|
||||||
|
state := live.NewState()
|
||||||
|
positionPayload := `{
|
||||||
|
"Position": [
|
||||||
|
{"Timestamp": "2026-07-03T14:00:00Z", "Entries": {
|
||||||
|
"1": {"Status": "OnTrack", "X": 1000, "Y": -200, "Z": 3},
|
||||||
|
"44": {"Status": "OffTrack", "X": 1200, "Y": -250, "Z": 2}
|
||||||
|
}}
|
||||||
|
]
|
||||||
|
}`
|
||||||
|
if !state.ProcessTopic("Position.z", encodedDeflatePayload(t, positionPayload)) {
|
||||||
|
t.Fatal("Position.z should update state")
|
||||||
|
}
|
||||||
|
|
||||||
|
snap := state.Snapshot()
|
||||||
|
if !snap.PositionUpdated || snap.SnapshotUpdated {
|
||||||
|
t.Fatalf("position flags = position:%v snapshot:%v", snap.PositionUpdated, snap.SnapshotUpdated)
|
||||||
|
}
|
||||||
|
if got := snap.Positions["1"]; got.X != 1000 || got.Y != -200 || got.Z != 3 || got.Status != "OnTrack" {
|
||||||
|
t.Fatalf("position 1 = %+v", got)
|
||||||
|
}
|
||||||
|
if got := snap.Positions["44"]; got.Status != "OffTrack" {
|
||||||
|
t.Fatalf("position 44 = %+v", got)
|
||||||
|
}
|
||||||
|
|
||||||
|
carPayload := `{
|
||||||
|
"Entries": [
|
||||||
|
{"Utc": "2026-07-03T14:00:00Z", "Cars": {
|
||||||
|
"1": {"Channels": {"0": 11234, "2": 318, "3": 8, "4": 92, "5": 0, "45": 10}}
|
||||||
|
}}
|
||||||
|
]
|
||||||
|
}`
|
||||||
|
if !state.ProcessTopic("CarData.z", encodedDeflatePayload(t, carPayload)) {
|
||||||
|
t.Fatal("CarData.z should update state")
|
||||||
|
}
|
||||||
|
snap = state.Snapshot()
|
||||||
|
if !snap.SnapshotUpdated {
|
||||||
|
t.Fatal("CarData should mark snapshot updated")
|
||||||
|
}
|
||||||
|
tel := snap.Telemetry["1"]
|
||||||
|
if tel.RPM != 11234 || tel.Speed != 318 || tel.NGear != 8 || tel.Throttle != 92 || tel.Brake != 0 || tel.DRS != 10 {
|
||||||
|
t.Fatalf("telemetry = %+v", tel)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
func TestProcessTopicSessionInfoCircuitName(t *testing.T) {
|
||||||
|
state := live.NewState()
|
||||||
|
state.ProcessTopic("SessionInfo", json.RawMessage(`{
|
||||||
|
"Meeting": {"Name": "British Grand Prix", "Circuit": {"ShortName": "Silverstone"}},
|
||||||
|
"Name": "Race",
|
||||||
|
"Type": "Race",
|
||||||
|
"Path": "2026/2026-07-05_British_Grand_Prix/2026-07-05_Race/"
|
||||||
|
}`))
|
||||||
|
s := state.Snapshot().Session
|
||||||
|
if s.MeetingName != "British Grand Prix" || s.CircuitName != "Silverstone" {
|
||||||
|
t.Fatalf("session = %+v", s)
|
||||||
|
}
|
||||||
|
if s.Path != "2026/2026-07-05_British_Grand_Prix/2026-07-05_Race/" {
|
||||||
|
t.Fatalf("session path = %q", s.Path)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
func TestProcessTopicDriverList(t *testing.T) {
|
func TestProcessTopicDriverList(t *testing.T) {
|
||||||
state := live.NewState()
|
state := live.NewState()
|
||||||
data := json.RawMessage(`{"63": {"RacingNumber": "63", "Tla": "RUS", "TeamName": "Mercedes", "TeamColour": "27F4D2"}}`)
|
data := json.RawMessage(`{"63": {"RacingNumber": "63", "Tla": "RUS", "TeamName": "Mercedes", "TeamColour": "27F4D2"}}`)
|
||||||
@@ -207,6 +273,40 @@ func TestProcessTopicTrackStatus(t *testing.T) {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
func TestProcessTopicSessionStatus(t *testing.T) {
|
||||||
|
state := live.NewState()
|
||||||
|
if !state.ProcessTopic("SessionStatus", json.RawMessage(`{"Status": "Finished"}`)) {
|
||||||
|
t.Fatal("SessionStatus should update state")
|
||||||
|
}
|
||||||
|
snap := state.Snapshot()
|
||||||
|
if snap.SessionStatus != "Finished" {
|
||||||
|
t.Fatalf("session status = %q, want Finished", snap.SessionStatus)
|
||||||
|
}
|
||||||
|
if !snap.SnapshotUpdated {
|
||||||
|
t.Fatal("SessionStatus should mark snapshot updated")
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
func TestSessionStatusIsActive(t *testing.T) {
|
||||||
|
tests := []struct {
|
||||||
|
status string
|
||||||
|
want bool
|
||||||
|
}{
|
||||||
|
{"Started", true},
|
||||||
|
{"Resumed", true},
|
||||||
|
{"Finished", false},
|
||||||
|
{"Finalised", false},
|
||||||
|
{"Ends", false},
|
||||||
|
{"Aborted", false},
|
||||||
|
{"", false},
|
||||||
|
}
|
||||||
|
for _, tt := range tests {
|
||||||
|
if got := live.SessionStatusIsActive(tt.status); got != tt.want {
|
||||||
|
t.Errorf("SessionStatusIsActive(%q) = %v, want %v", tt.status, got, tt.want)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
func TestProcessTopicRaceControlMessages(t *testing.T) {
|
func TestProcessTopicRaceControlMessages(t *testing.T) {
|
||||||
state := live.NewState()
|
state := live.NewState()
|
||||||
data := json.RawMessage(`{
|
data := json.RawMessage(`{
|
||||||
@@ -224,6 +324,68 @@ func TestProcessTopicRaceControlMessages(t *testing.T) {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
func TestProcessTopicTeamRadioSnapshotAndPatch(t *testing.T) {
|
||||||
|
state := live.NewState()
|
||||||
|
snapshot := json.RawMessage(`{
|
||||||
|
"Captures": [
|
||||||
|
{"Utc": "2026-07-05T14:05:30Z", "RacingNumber": "4", "Path": "TeamRadio/NOR-1.mp3"},
|
||||||
|
{"Utc": "2026-07-05T14:04:10Z", "RacingNumber": "16", "Path": "TeamRadio/LEC-1.mp3"}
|
||||||
|
]
|
||||||
|
}`)
|
||||||
|
|
||||||
|
if !state.ProcessTopic("TeamRadio", snapshot) {
|
||||||
|
t.Fatal("TeamRadio snapshot should update state")
|
||||||
|
}
|
||||||
|
|
||||||
|
patch := json.RawMessage(`{
|
||||||
|
"Captures": {
|
||||||
|
"2": {"Utc": "2026-07-05T14:06:00Z", "RacingNumber": "44", "Path": "TeamRadio/HAM-1.mp3"}
|
||||||
|
}
|
||||||
|
}`)
|
||||||
|
if !state.ProcessTopic("TeamRadio", patch) {
|
||||||
|
t.Fatal("TeamRadio keyed patch should update state")
|
||||||
|
}
|
||||||
|
|
||||||
|
radio := state.Snapshot().TeamRadio
|
||||||
|
if len(radio) != 3 {
|
||||||
|
t.Fatalf("radio captures = %d, want 3", len(radio))
|
||||||
|
}
|
||||||
|
if radio[0].RacingNumber != "16" || radio[1].RacingNumber != "4" || radio[2].RacingNumber != "44" {
|
||||||
|
t.Fatalf("radio order = %+v", radio)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
func TestProcessTopicTeamRadioMalformed(t *testing.T) {
|
||||||
|
state := live.NewState()
|
||||||
|
if state.ProcessTopic("TeamRadio", json.RawMessage(`{"Captures": {"1": {"Utc": "2026-07-05T14:06:00Z", "Path": "missing-driver.mp3"}}}`)) {
|
||||||
|
t.Fatal("incomplete TeamRadio capture should not update state")
|
||||||
|
}
|
||||||
|
if state.ProcessTopic("TeamRadio", json.RawMessage(`{"Captures": "not-a-list"}`)) {
|
||||||
|
t.Fatal("unexpected TeamRadio captures shape should not update state")
|
||||||
|
}
|
||||||
|
if len(state.Snapshot().TeamRadio) != 0 {
|
||||||
|
t.Fatalf("malformed captures mutated state: %+v", state.Snapshot().TeamRadio)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
func TestProcessTopicTeamRadioCapsAtTwenty(t *testing.T) {
|
||||||
|
state := live.NewState()
|
||||||
|
for i := 0; i < 25; i++ {
|
||||||
|
payload := json.RawMessage([]byte(fmt.Sprintf(`{
|
||||||
|
"Captures": [{"Utc": "2026-07-05T14:%02d:00Z", "RacingNumber": "%d", "Path": "TeamRadio/%02d.mp3"}]
|
||||||
|
}`, i, i, i)))
|
||||||
|
state.ProcessTopic("TeamRadio", payload)
|
||||||
|
}
|
||||||
|
|
||||||
|
radio := state.Snapshot().TeamRadio
|
||||||
|
if len(radio) != 20 {
|
||||||
|
t.Fatalf("radio captures = %d, want 20", len(radio))
|
||||||
|
}
|
||||||
|
if radio[0].Utc != "2026-07-05T14:05:00Z" || radio[19].Utc != "2026-07-05T14:24:00Z" {
|
||||||
|
t.Fatalf("radio cap kept wrong captures: first=%+v last=%+v", radio[0], radio[19])
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
func TestProcessTopicWeatherData(t *testing.T) {
|
func TestProcessTopicWeatherData(t *testing.T) {
|
||||||
state := live.NewState()
|
state := live.NewState()
|
||||||
state.ProcessTopic("WeatherData", json.RawMessage(`{
|
state.ProcessTopic("WeatherData", json.RawMessage(`{
|
||||||
@@ -356,3 +518,23 @@ func TestProcessMessageEmptyPayload(t *testing.T) {
|
|||||||
t.Error("empty envelope should not update state")
|
t.Error("empty envelope should not update state")
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
func encodedDeflatePayload(t *testing.T, payload string) json.RawMessage {
|
||||||
|
t.Helper()
|
||||||
|
var buf bytes.Buffer
|
||||||
|
w, err := flate.NewWriter(&buf, flate.DefaultCompression)
|
||||||
|
if err != nil {
|
||||||
|
t.Fatalf("flate.NewWriter() error = %v", err)
|
||||||
|
}
|
||||||
|
if _, err := w.Write([]byte(payload)); err != nil {
|
||||||
|
t.Fatalf("flate write error = %v", err)
|
||||||
|
}
|
||||||
|
if err := w.Close(); err != nil {
|
||||||
|
t.Fatalf("flate close error = %v", err)
|
||||||
|
}
|
||||||
|
raw, err := json.Marshal(base64.StdEncoding.EncodeToString(buf.Bytes()))
|
||||||
|
if err != nil {
|
||||||
|
t.Fatalf("marshal payload error = %v", err)
|
||||||
|
}
|
||||||
|
return raw
|
||||||
|
}
|
||||||
|
|||||||
@@ -96,6 +96,8 @@ func connectToF1SignalRCore(dataChan chan LiveStreamData) error {
|
|||||||
topics := []string{
|
topics := []string{
|
||||||
"Heartbeat",
|
"Heartbeat",
|
||||||
"TimingData",
|
"TimingData",
|
||||||
|
"Position.z",
|
||||||
|
"CarData.z",
|
||||||
"DriverList",
|
"DriverList",
|
||||||
"LapCount",
|
"LapCount",
|
||||||
"ExtrapolatedClock",
|
"ExtrapolatedClock",
|
||||||
@@ -103,6 +105,7 @@ func connectToF1SignalRCore(dataChan chan LiveStreamData) error {
|
|||||||
"RaceControlMessages",
|
"RaceControlMessages",
|
||||||
"WeatherData",
|
"WeatherData",
|
||||||
"SessionInfo",
|
"SessionInfo",
|
||||||
|
"TeamRadio",
|
||||||
"CurrentTyres",
|
"CurrentTyres",
|
||||||
"TimingAppData",
|
"TimingAppData",
|
||||||
"TimingStats",
|
"TimingStats",
|
||||||
@@ -194,7 +197,7 @@ func connectToF1LegacySignalR(dataChan chan LiveStreamData) error {
|
|||||||
return err
|
return err
|
||||||
}
|
}
|
||||||
|
|
||||||
subscribeMsg := []byte(`{"H":"Streaming","M":"Subscribe","A":[["Heartbeat","TimingData","DriverList","LapCount","ExtrapolatedClock","TrackStatus","RaceControlMessages","WeatherData","SessionInfo","CurrentTyres","TimingAppData","TimingStats"]],"I":1}`)
|
subscribeMsg := []byte(`{"H":"Streaming","M":"Subscribe","A":[["Heartbeat","TimingData","Position.z","CarData.z","DriverList","LapCount","ExtrapolatedClock","TrackStatus","RaceControlMessages","WeatherData","SessionInfo","TeamRadio","CurrentTyres","TimingAppData","TimingStats","SessionStatus"]],"I":1}`)
|
||||||
err = c.WriteMessage(websocket.TextMessage, subscribeMsg)
|
err = c.WriteMessage(websocket.TextMessage, subscribeMsg)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
return err
|
return err
|
||||||
|
|||||||
@@ -1,8 +1,16 @@
|
|||||||
package live
|
package live
|
||||||
|
|
||||||
import (
|
import (
|
||||||
|
"bytes"
|
||||||
|
"compress/flate"
|
||||||
|
"compress/zlib"
|
||||||
|
"encoding/base64"
|
||||||
"encoding/json"
|
"encoding/json"
|
||||||
"fmt"
|
"fmt"
|
||||||
|
"io"
|
||||||
|
"log"
|
||||||
|
"sort"
|
||||||
|
"strings"
|
||||||
"time"
|
"time"
|
||||||
)
|
)
|
||||||
|
|
||||||
@@ -11,19 +19,26 @@ type State struct {
|
|||||||
Drivers map[string]LiveDriverData
|
Drivers map[string]LiveDriverData
|
||||||
DriverInfo map[string]F1DriverListEntry
|
DriverInfo map[string]F1DriverListEntry
|
||||||
Tyres map[string]LiveTyreData
|
Tyres map[string]LiveTyreData
|
||||||
|
Telemetry map[string]LiveTelemetryData
|
||||||
|
Positions map[string]LivePositionData
|
||||||
Stints map[string][]LiveStintData
|
Stints map[string][]LiveStintData
|
||||||
RCMessages []LiveRCMessage
|
RCMessages []LiveRCMessage
|
||||||
Weather LiveWeatherData
|
Weather LiveWeatherData
|
||||||
Session LiveSessionMeta
|
Session LiveSessionMeta
|
||||||
|
TeamRadio []LiveRadioCapture
|
||||||
|
SessionStatus string
|
||||||
TrackStatus string
|
TrackStatus string
|
||||||
CurrentLap int
|
CurrentLap int
|
||||||
TotalLaps int
|
TotalLaps int
|
||||||
Clock string
|
Clock string
|
||||||
ClockRefTime time.Time
|
ClockRefTime time.Time
|
||||||
ClockExtrapolating bool
|
ClockExtrapolating bool
|
||||||
|
positionUpdated bool
|
||||||
|
snapshotUpdated bool
|
||||||
}
|
}
|
||||||
|
|
||||||
const signalRRecordSeparator = byte(0x1e)
|
const signalRRecordSeparator = byte(0x1e)
|
||||||
|
const maxTeamRadioCaptures = 20
|
||||||
|
|
||||||
// NewState returns an empty live timing accumulator.
|
// NewState returns an empty live timing accumulator.
|
||||||
func NewState() *State {
|
func NewState() *State {
|
||||||
@@ -31,6 +46,8 @@ func NewState() *State {
|
|||||||
Drivers: make(map[string]LiveDriverData),
|
Drivers: make(map[string]LiveDriverData),
|
||||||
DriverInfo: make(map[string]F1DriverListEntry),
|
DriverInfo: make(map[string]F1DriverListEntry),
|
||||||
Tyres: make(map[string]LiveTyreData),
|
Tyres: make(map[string]LiveTyreData),
|
||||||
|
Telemetry: make(map[string]LiveTelemetryData),
|
||||||
|
Positions: make(map[string]LivePositionData),
|
||||||
Stints: make(map[string][]LiveStintData),
|
Stints: make(map[string][]LiveStintData),
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
@@ -49,8 +66,18 @@ func (s *State) Snapshot() LiveStreamData {
|
|||||||
for k, v := range s.Tyres {
|
for k, v := range s.Tyres {
|
||||||
cpyTyres[k] = v
|
cpyTyres[k] = v
|
||||||
}
|
}
|
||||||
|
cpyTelemetry := make(map[string]LiveTelemetryData, len(s.Telemetry))
|
||||||
|
for k, v := range s.Telemetry {
|
||||||
|
cpyTelemetry[k] = v
|
||||||
|
}
|
||||||
|
cpyPositions := make(map[string]LivePositionData, len(s.Positions))
|
||||||
|
for k, v := range s.Positions {
|
||||||
|
cpyPositions[k] = v
|
||||||
|
}
|
||||||
cpyRC := make([]LiveRCMessage, len(s.RCMessages))
|
cpyRC := make([]LiveRCMessage, len(s.RCMessages))
|
||||||
copy(cpyRC, s.RCMessages)
|
copy(cpyRC, s.RCMessages)
|
||||||
|
cpyRadio := make([]LiveRadioCapture, len(s.TeamRadio))
|
||||||
|
copy(cpyRadio, s.TeamRadio)
|
||||||
cpyStints := make(map[string][]LiveStintData, len(s.Stints))
|
cpyStints := make(map[string][]LiveStintData, len(s.Stints))
|
||||||
for k, v := range s.Stints {
|
for k, v := range s.Stints {
|
||||||
st := make([]LiveStintData, len(v))
|
st := make([]LiveStintData, len(v))
|
||||||
@@ -62,9 +89,12 @@ func (s *State) Snapshot() LiveStreamData {
|
|||||||
Drivers: cpyDrivers,
|
Drivers: cpyDrivers,
|
||||||
DriverInfo: cpyInfo,
|
DriverInfo: cpyInfo,
|
||||||
Tyres: cpyTyres,
|
Tyres: cpyTyres,
|
||||||
|
Telemetry: cpyTelemetry,
|
||||||
RCMessages: cpyRC,
|
RCMessages: cpyRC,
|
||||||
Weather: s.Weather,
|
Weather: s.Weather,
|
||||||
Session: s.Session,
|
Session: s.Session,
|
||||||
|
TeamRadio: cpyRadio,
|
||||||
|
SessionStatus: s.SessionStatus,
|
||||||
TrackStatus: s.TrackStatus,
|
TrackStatus: s.TrackStatus,
|
||||||
CurrentLap: s.CurrentLap,
|
CurrentLap: s.CurrentLap,
|
||||||
TotalLaps: s.TotalLaps,
|
TotalLaps: s.TotalLaps,
|
||||||
@@ -72,11 +102,16 @@ func (s *State) Snapshot() LiveStreamData {
|
|||||||
ClockRefTime: s.ClockRefTime,
|
ClockRefTime: s.ClockRefTime,
|
||||||
ClockExtrapolating: s.ClockExtrapolating,
|
ClockExtrapolating: s.ClockExtrapolating,
|
||||||
Stints: cpyStints,
|
Stints: cpyStints,
|
||||||
|
Positions: cpyPositions,
|
||||||
|
PositionUpdated: s.positionUpdated,
|
||||||
|
SnapshotUpdated: s.snapshotUpdated,
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
// ProcessMessage parses a raw SignalR WebSocket frame and applies any updates.
|
// ProcessMessage parses a raw SignalR WebSocket frame and applies any updates.
|
||||||
func (s *State) ProcessMessage(message []byte) bool {
|
func (s *State) ProcessMessage(message []byte) bool {
|
||||||
|
s.clearTransientFlags()
|
||||||
|
|
||||||
var parsed F1SignalRMessage
|
var parsed F1SignalRMessage
|
||||||
if err := json.Unmarshal(message, &parsed); err != nil {
|
if err := json.Unmarshal(message, &parsed); err != nil {
|
||||||
return false
|
return false
|
||||||
@@ -111,6 +146,8 @@ func (s *State) ProcessMessage(message []byte) bool {
|
|||||||
// ProcessCoreMessage parses one or more SignalR Core JSON frames and applies
|
// ProcessCoreMessage parses one or more SignalR Core JSON frames and applies
|
||||||
// completion snapshots and feed deltas from the current official F1 live timing hub.
|
// completion snapshots and feed deltas from the current official F1 live timing hub.
|
||||||
func (s *State) ProcessCoreMessage(message []byte) bool {
|
func (s *State) ProcessCoreMessage(message []byte) bool {
|
||||||
|
s.clearTransientFlags()
|
||||||
|
|
||||||
updated := false
|
updated := false
|
||||||
for _, frame := range splitSignalRFrames(message) {
|
for _, frame := range splitSignalRFrames(message) {
|
||||||
var envelope struct {
|
var envelope struct {
|
||||||
@@ -156,7 +193,15 @@ func (s *State) ProcessCoreMessage(message []byte) bool {
|
|||||||
// ProcessTopic applies a single topic payload to the accumulator.
|
// ProcessTopic applies a single topic payload to the accumulator.
|
||||||
func (s *State) ProcessTopic(topic string, data json.RawMessage) bool {
|
func (s *State) ProcessTopic(topic string, data json.RawMessage) bool {
|
||||||
updated := false
|
updated := false
|
||||||
switch topic {
|
baseTopic := strings.TrimSuffix(topic, ".z")
|
||||||
|
if topic != baseTopic {
|
||||||
|
var ok bool
|
||||||
|
data, ok = inflateTopicPayload(data)
|
||||||
|
if !ok {
|
||||||
|
return false
|
||||||
|
}
|
||||||
|
}
|
||||||
|
switch baseTopic {
|
||||||
case "TimingData":
|
case "TimingData":
|
||||||
var td struct {
|
var td struct {
|
||||||
Lines map[string]json.RawMessage `json:"Lines"`
|
Lines map[string]json.RawMessage `json:"Lines"`
|
||||||
@@ -170,6 +215,10 @@ func (s *State) ProcessTopic(topic string, data json.RawMessage) bool {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
case "Position":
|
||||||
|
updated = s.updatePositions(data)
|
||||||
|
case "CarData":
|
||||||
|
updated = s.updateTelemetry(data)
|
||||||
case "DriverList":
|
case "DriverList":
|
||||||
var dlMap map[string]json.RawMessage
|
var dlMap map[string]json.RawMessage
|
||||||
if json.Unmarshal(data, &dlMap) == nil {
|
if json.Unmarshal(data, &dlMap) == nil {
|
||||||
@@ -226,6 +275,14 @@ func (s *State) ProcessTopic(topic string, data json.RawMessage) bool {
|
|||||||
s.TrackStatus = ts.Status
|
s.TrackStatus = ts.Status
|
||||||
updated = true
|
updated = true
|
||||||
}
|
}
|
||||||
|
case "SessionStatus":
|
||||||
|
var ss struct {
|
||||||
|
Status string `json:"Status"`
|
||||||
|
}
|
||||||
|
if json.Unmarshal(data, &ss) == nil && ss.Status != "" {
|
||||||
|
s.SessionStatus = ss.Status
|
||||||
|
updated = true
|
||||||
|
}
|
||||||
case "RaceControlMessages":
|
case "RaceControlMessages":
|
||||||
var rcm struct {
|
var rcm struct {
|
||||||
Messages json.RawMessage `json:"Messages"`
|
Messages json.RawMessage `json:"Messages"`
|
||||||
@@ -288,23 +345,35 @@ func (s *State) ProcessTopic(topic string, data json.RawMessage) bool {
|
|||||||
case "SessionInfo":
|
case "SessionInfo":
|
||||||
var si struct {
|
var si struct {
|
||||||
Meeting struct {
|
Meeting struct {
|
||||||
Name string `json:"Name"`
|
Name string `json:"Name"`
|
||||||
|
Circuit struct {
|
||||||
|
ShortName string `json:"ShortName"`
|
||||||
|
} `json:"Circuit"`
|
||||||
} `json:"Meeting"`
|
} `json:"Meeting"`
|
||||||
Name string `json:"Name"`
|
Name string `json:"Name"`
|
||||||
Type string `json:"Type"`
|
Type string `json:"Type"`
|
||||||
|
Path string `json:"Path"`
|
||||||
}
|
}
|
||||||
if json.Unmarshal(data, &si) == nil {
|
if json.Unmarshal(data, &si) == nil {
|
||||||
if si.Meeting.Name != "" {
|
if si.Meeting.Name != "" {
|
||||||
s.Session.MeetingName = si.Meeting.Name
|
s.Session.MeetingName = si.Meeting.Name
|
||||||
}
|
}
|
||||||
|
if si.Meeting.Circuit.ShortName != "" {
|
||||||
|
s.Session.CircuitName = si.Meeting.Circuit.ShortName
|
||||||
|
}
|
||||||
if si.Name != "" {
|
if si.Name != "" {
|
||||||
s.Session.SessionName = si.Name
|
s.Session.SessionName = si.Name
|
||||||
}
|
}
|
||||||
if si.Type != "" {
|
if si.Type != "" {
|
||||||
s.Session.SessionType = si.Type
|
s.Session.SessionType = si.Type
|
||||||
}
|
}
|
||||||
|
if si.Path != "" {
|
||||||
|
s.Session.Path = si.Path
|
||||||
|
}
|
||||||
updated = true
|
updated = true
|
||||||
}
|
}
|
||||||
|
case "TeamRadio":
|
||||||
|
updated = s.updateTeamRadio(data)
|
||||||
case "CurrentTyres":
|
case "CurrentTyres":
|
||||||
var ct map[string]json.RawMessage
|
var ct map[string]json.RawMessage
|
||||||
if json.Unmarshal(data, &ct) == nil {
|
if json.Unmarshal(data, &ct) == nil {
|
||||||
@@ -386,9 +455,233 @@ func (s *State) ProcessTopic(topic string, data json.RawMessage) bool {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
if updated {
|
||||||
|
if baseTopic == "Position" {
|
||||||
|
s.positionUpdated = true
|
||||||
|
} else {
|
||||||
|
s.snapshotUpdated = true
|
||||||
|
}
|
||||||
|
}
|
||||||
return updated
|
return updated
|
||||||
}
|
}
|
||||||
|
|
||||||
|
func (s *State) clearTransientFlags() {
|
||||||
|
s.positionUpdated = false
|
||||||
|
s.snapshotUpdated = false
|
||||||
|
}
|
||||||
|
|
||||||
|
func inflateTopicPayload(data json.RawMessage) (json.RawMessage, bool) {
|
||||||
|
var encoded string
|
||||||
|
if err := json.Unmarshal(data, &encoded); err != nil {
|
||||||
|
var wrapper struct {
|
||||||
|
Z string `json:"z"`
|
||||||
|
}
|
||||||
|
if json.Unmarshal(data, &wrapper) != nil || wrapper.Z == "" {
|
||||||
|
return nil, false
|
||||||
|
}
|
||||||
|
encoded = wrapper.Z
|
||||||
|
}
|
||||||
|
|
||||||
|
compressed, err := base64.StdEncoding.DecodeString(encoded)
|
||||||
|
if err != nil {
|
||||||
|
return nil, false
|
||||||
|
}
|
||||||
|
if inflated, ok := readCompressed(zlib.NewReader(bytes.NewReader(compressed))); ok {
|
||||||
|
return json.RawMessage(inflated), true
|
||||||
|
}
|
||||||
|
if inflated, ok := readCompressed(func() (io.ReadCloser, error) {
|
||||||
|
return flate.NewReader(bytes.NewReader(compressed)), nil
|
||||||
|
}()); ok {
|
||||||
|
return json.RawMessage(inflated), true
|
||||||
|
}
|
||||||
|
return nil, false
|
||||||
|
}
|
||||||
|
|
||||||
|
func readCompressed(r io.ReadCloser, err error) ([]byte, bool) {
|
||||||
|
if err != nil {
|
||||||
|
return nil, false
|
||||||
|
}
|
||||||
|
defer r.Close()
|
||||||
|
out, err := io.ReadAll(r)
|
||||||
|
return out, err == nil
|
||||||
|
}
|
||||||
|
|
||||||
|
func (s *State) updateTeamRadio(data json.RawMessage) bool {
|
||||||
|
var payload struct {
|
||||||
|
Captures json.RawMessage `json:"Captures"`
|
||||||
|
}
|
||||||
|
if err := json.Unmarshal(data, &payload); err != nil {
|
||||||
|
log.Printf("live: skipping malformed TeamRadio payload: %v", err)
|
||||||
|
return false
|
||||||
|
}
|
||||||
|
if len(payload.Captures) == 0 || string(payload.Captures) == "null" {
|
||||||
|
log.Printf("live: skipping TeamRadio payload without Captures")
|
||||||
|
return false
|
||||||
|
}
|
||||||
|
|
||||||
|
captures := indexedRawValues(payload.Captures)
|
||||||
|
if len(captures) == 0 {
|
||||||
|
log.Printf("live: skipping TeamRadio payload with unexpected Captures shape")
|
||||||
|
return false
|
||||||
|
}
|
||||||
|
|
||||||
|
updated := false
|
||||||
|
for _, captureRaw := range captures {
|
||||||
|
var capture LiveRadioCapture
|
||||||
|
if err := json.Unmarshal(captureRaw.Raw, &capture); err != nil {
|
||||||
|
log.Printf("live: skipping malformed TeamRadio capture: %v", err)
|
||||||
|
continue
|
||||||
|
}
|
||||||
|
if capture.Utc == "" || capture.RacingNumber == "" || capture.Path == "" {
|
||||||
|
log.Printf("live: skipping incomplete TeamRadio capture: utc=%q racing_number=%q path=%q", capture.Utc, capture.RacingNumber, capture.Path)
|
||||||
|
continue
|
||||||
|
}
|
||||||
|
if s.hasTeamRadioCapture(capture) {
|
||||||
|
continue
|
||||||
|
}
|
||||||
|
s.TeamRadio = append(s.TeamRadio, capture)
|
||||||
|
updated = true
|
||||||
|
}
|
||||||
|
if updated {
|
||||||
|
sort.SliceStable(s.TeamRadio, func(i, j int) bool {
|
||||||
|
return s.TeamRadio[i].Utc < s.TeamRadio[j].Utc
|
||||||
|
})
|
||||||
|
if len(s.TeamRadio) > maxTeamRadioCaptures {
|
||||||
|
s.TeamRadio = append([]LiveRadioCapture(nil), s.TeamRadio[len(s.TeamRadio)-maxTeamRadioCaptures:]...)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return updated
|
||||||
|
}
|
||||||
|
|
||||||
|
func (s *State) hasTeamRadioCapture(capture LiveRadioCapture) bool {
|
||||||
|
for _, existing := range s.TeamRadio {
|
||||||
|
if existing.Utc == capture.Utc && existing.RacingNumber == capture.RacingNumber && existing.Path == capture.Path {
|
||||||
|
return true
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return false
|
||||||
|
}
|
||||||
|
|
||||||
|
func (s *State) updatePositions(data json.RawMessage) bool {
|
||||||
|
var payload struct {
|
||||||
|
Position json.RawMessage `json:"Position"`
|
||||||
|
}
|
||||||
|
if json.Unmarshal(data, &payload) != nil || len(payload.Position) == 0 {
|
||||||
|
return false
|
||||||
|
}
|
||||||
|
|
||||||
|
updated := false
|
||||||
|
for _, sampleRaw := range indexedRawValues(payload.Position) {
|
||||||
|
var sample struct {
|
||||||
|
Entries map[string]struct {
|
||||||
|
Status string `json:"Status"`
|
||||||
|
X json.Number `json:"X"`
|
||||||
|
Y json.Number `json:"Y"`
|
||||||
|
Z json.Number `json:"Z"`
|
||||||
|
} `json:"Entries"`
|
||||||
|
}
|
||||||
|
if json.Unmarshal(sampleRaw.Raw, &sample) != nil {
|
||||||
|
continue
|
||||||
|
}
|
||||||
|
for num, entry := range sample.Entries {
|
||||||
|
x, okX := numberToFloat(entry.X)
|
||||||
|
y, okY := numberToFloat(entry.Y)
|
||||||
|
z, okZ := numberToFloat(entry.Z)
|
||||||
|
if !okX || !okY {
|
||||||
|
continue
|
||||||
|
}
|
||||||
|
if !okZ {
|
||||||
|
z = 0
|
||||||
|
}
|
||||||
|
s.Positions[num] = LivePositionData{
|
||||||
|
X: x,
|
||||||
|
Y: y,
|
||||||
|
Z: z,
|
||||||
|
Status: entry.Status,
|
||||||
|
}
|
||||||
|
updated = true
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return updated
|
||||||
|
}
|
||||||
|
|
||||||
|
func (s *State) updateTelemetry(data json.RawMessage) bool {
|
||||||
|
var payload struct {
|
||||||
|
Entries json.RawMessage `json:"Entries"`
|
||||||
|
}
|
||||||
|
if json.Unmarshal(data, &payload) != nil || len(payload.Entries) == 0 {
|
||||||
|
return false
|
||||||
|
}
|
||||||
|
|
||||||
|
updated := false
|
||||||
|
for _, entryRaw := range indexedRawValues(payload.Entries) {
|
||||||
|
var entry struct {
|
||||||
|
Cars map[string]struct {
|
||||||
|
Channels map[string]json.RawMessage `json:"Channels"`
|
||||||
|
} `json:"Cars"`
|
||||||
|
}
|
||||||
|
if json.Unmarshal(entryRaw.Raw, &entry) != nil {
|
||||||
|
continue
|
||||||
|
}
|
||||||
|
for num, car := range entry.Cars {
|
||||||
|
t := s.Telemetry[num]
|
||||||
|
if v, ok := channelInt(car.Channels, "0"); ok {
|
||||||
|
t.RPM = v
|
||||||
|
}
|
||||||
|
if v, ok := channelInt(car.Channels, "2"); ok {
|
||||||
|
t.Speed = v
|
||||||
|
}
|
||||||
|
if v, ok := channelInt(car.Channels, "3"); ok {
|
||||||
|
t.NGear = v
|
||||||
|
}
|
||||||
|
if v, ok := channelInt(car.Channels, "4"); ok {
|
||||||
|
t.Throttle = v
|
||||||
|
}
|
||||||
|
if v, ok := channelInt(car.Channels, "5"); ok {
|
||||||
|
t.Brake = v
|
||||||
|
}
|
||||||
|
if v, ok := channelInt(car.Channels, "45"); ok {
|
||||||
|
t.DRS = v
|
||||||
|
}
|
||||||
|
s.Telemetry[num] = t
|
||||||
|
updated = true
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return updated
|
||||||
|
}
|
||||||
|
|
||||||
|
func channelInt(channels map[string]json.RawMessage, key string) (int, bool) {
|
||||||
|
raw, ok := channels[key]
|
||||||
|
if !ok {
|
||||||
|
return 0, false
|
||||||
|
}
|
||||||
|
var n json.Number
|
||||||
|
if json.Unmarshal(raw, &n) == nil {
|
||||||
|
if i, err := n.Int64(); err == nil {
|
||||||
|
return int(i), true
|
||||||
|
}
|
||||||
|
if f, err := n.Float64(); err == nil {
|
||||||
|
return int(f), true
|
||||||
|
}
|
||||||
|
}
|
||||||
|
var s string
|
||||||
|
if json.Unmarshal(raw, &s) == nil {
|
||||||
|
var i int
|
||||||
|
if _, err := fmt.Sscanf(s, "%d", &i); err == nil {
|
||||||
|
return i, true
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return 0, false
|
||||||
|
}
|
||||||
|
|
||||||
|
func numberToFloat(n json.Number) (float64, bool) {
|
||||||
|
if n == "" {
|
||||||
|
return 0, false
|
||||||
|
}
|
||||||
|
v, err := n.Float64()
|
||||||
|
return v, err == nil
|
||||||
|
}
|
||||||
|
|
||||||
func updateDriver(drivers map[string]LiveDriverData, num string, line F1TimingLine) {
|
func updateDriver(drivers map[string]LiveDriverData, num string, line F1TimingLine) {
|
||||||
d, exists := drivers[num]
|
d, exists := drivers[num]
|
||||||
if !exists {
|
if !exists {
|
||||||
@@ -585,6 +878,9 @@ func indexedRawValues(raw json.RawMessage) []indexedRaw {
|
|||||||
fmt.Sscanf(k, "%d", &i)
|
fmt.Sscanf(k, "%d", &i)
|
||||||
values = append(values, indexedRaw{Index: i, Raw: v})
|
values = append(values, indexedRaw{Index: i, Raw: v})
|
||||||
}
|
}
|
||||||
|
sort.Slice(values, func(i, j int) bool {
|
||||||
|
return values[i].Index < values[j].Index
|
||||||
|
})
|
||||||
return values
|
return values
|
||||||
}
|
}
|
||||||
|
|
||||||
|
|||||||
@@ -85,6 +85,25 @@ type LiveSessionMeta struct {
|
|||||||
CircuitName string
|
CircuitName string
|
||||||
SessionType string
|
SessionType string
|
||||||
SessionName string
|
SessionName string
|
||||||
|
Path string
|
||||||
|
}
|
||||||
|
|
||||||
|
// LivePositionData is the latest raw F1 GPS position for one driver.
|
||||||
|
type LivePositionData struct {
|
||||||
|
X float64 `json:"x"`
|
||||||
|
Y float64 `json:"y"`
|
||||||
|
Z float64 `json:"z"`
|
||||||
|
Status string `json:"status"`
|
||||||
|
}
|
||||||
|
|
||||||
|
// LiveTelemetryData is the latest car telemetry for one driver.
|
||||||
|
type LiveTelemetryData struct {
|
||||||
|
Speed int `json:"Speed"`
|
||||||
|
Throttle int `json:"Throttle"`
|
||||||
|
Brake int `json:"Brake"`
|
||||||
|
DRS int `json:"DRS"`
|
||||||
|
NGear int `json:"NGear"`
|
||||||
|
RPM int `json:"RPM"`
|
||||||
}
|
}
|
||||||
|
|
||||||
// LiveSectorData holds a single sector time and flags.
|
// LiveSectorData holds a single sector time and flags.
|
||||||
@@ -126,14 +145,24 @@ type LiveStintData struct {
|
|||||||
Laps int
|
Laps int
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// LiveRadioCapture is one team radio audio clip from the live timing feed.
|
||||||
|
type LiveRadioCapture struct {
|
||||||
|
Utc string
|
||||||
|
RacingNumber string
|
||||||
|
Path string
|
||||||
|
}
|
||||||
|
|
||||||
// LiveStreamData is an immutable snapshot of all live timing state.
|
// LiveStreamData is an immutable snapshot of all live timing state.
|
||||||
type LiveStreamData struct {
|
type LiveStreamData struct {
|
||||||
Drivers map[string]LiveDriverData
|
Drivers map[string]LiveDriverData
|
||||||
DriverInfo map[string]F1DriverListEntry
|
DriverInfo map[string]F1DriverListEntry
|
||||||
Tyres map[string]LiveTyreData
|
Tyres map[string]LiveTyreData
|
||||||
|
Telemetry map[string]LiveTelemetryData
|
||||||
RCMessages []LiveRCMessage
|
RCMessages []LiveRCMessage
|
||||||
Weather LiveWeatherData
|
Weather LiveWeatherData
|
||||||
Session LiveSessionMeta
|
Session LiveSessionMeta
|
||||||
|
TeamRadio []LiveRadioCapture
|
||||||
|
SessionStatus string
|
||||||
TrackStatus string // "1"=green "2"=yellow "4"=SC "5"=red "6"=VSC
|
TrackStatus string // "1"=green "2"=yellow "4"=SC "5"=red "6"=VSC
|
||||||
CurrentLap int
|
CurrentLap int
|
||||||
TotalLaps int
|
TotalLaps int
|
||||||
@@ -141,4 +170,31 @@ type LiveStreamData struct {
|
|||||||
ClockRefTime time.Time // UTC when Clock was accurate
|
ClockRefTime time.Time // UTC when Clock was accurate
|
||||||
ClockExtrapolating bool // true = actively counting down
|
ClockExtrapolating bool // true = actively counting down
|
||||||
Stints map[string][]LiveStintData
|
Stints map[string][]LiveStintData
|
||||||
|
Positions map[string]LivePositionData `json:"-"`
|
||||||
|
PositionUpdated bool `json:"-"`
|
||||||
|
SnapshotUpdated bool `json:"-"`
|
||||||
|
}
|
||||||
|
|
||||||
|
// SessionStatusIsActive reports whether a raw F1 live timing SessionStatus
|
||||||
|
// value represents an actively running session.
|
||||||
|
func SessionStatusIsActive(status string) bool {
|
||||||
|
switch normalizeSessionStatus(status) {
|
||||||
|
case "started", "resumed":
|
||||||
|
return true
|
||||||
|
default:
|
||||||
|
return false
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
|
func normalizeSessionStatus(status string) string {
|
||||||
|
out := make([]rune, 0, len(status))
|
||||||
|
for _, r := range status {
|
||||||
|
switch {
|
||||||
|
case r >= 'A' && r <= 'Z':
|
||||||
|
out = append(out, r+'a'-'A')
|
||||||
|
case r >= 'a' && r <= 'z', r >= '0' && r <= '9':
|
||||||
|
out = append(out, r)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return string(out)
|
||||||
}
|
}
|
||||||
|
|||||||
@@ -26,6 +26,15 @@ type ChampionshipInputs struct {
|
|||||||
}
|
}
|
||||||
|
|
||||||
// GetChampionshipInputs derives championship hub inputs from ingested season data.
|
// GetChampionshipInputs derives championship hub inputs from ingested season data.
|
||||||
|
//
|
||||||
|
// 2026 note: Bahrain (meeting 1282 / session 11261) and Saudi Arabia (1283 / 11269)
|
||||||
|
// are cancelled due to Force Majeure (regional conflict) — OpenF1 returns no results
|
||||||
|
// for those sessions. This is intentional, which is why 2026 shows Round 9/24 after
|
||||||
|
// Silverstone instead of Round 11.
|
||||||
|
//
|
||||||
|
// Points: F1 Sprint points (SessionName == "Sprint") must be included alongside Race
|
||||||
|
// points. Both appear as SessionType "Race" in OpenF1 /api/v1/sessions, so we match
|
||||||
|
// on SessionName. Fix for #57.
|
||||||
func (s *Service) GetChampionshipInputs(year int) (ChampionshipInputs, error) {
|
func (s *Service) GetChampionshipInputs(year int) (ChampionshipInputs, error) {
|
||||||
meetings, err := s.ListMeetingsByYear(year)
|
meetings, err := s.ListMeetingsByYear(year)
|
||||||
if err != nil {
|
if err != nil {
|
||||||
@@ -51,60 +60,101 @@ func (s *Service) GetChampionshipInputs(year int) (ChampionshipInputs, error) {
|
|||||||
}
|
}
|
||||||
|
|
||||||
raceKey := 0
|
raceKey := 0
|
||||||
|
sprintKey := 0
|
||||||
for _, sess := range sessions {
|
for _, sess := range sessions {
|
||||||
if strings.EqualFold(sess.SessionName, "Race") {
|
if strings.EqualFold(sess.SessionName, "Race") {
|
||||||
raceKey = sess.SessionKey
|
raceKey = sess.SessionKey
|
||||||
break
|
} else if strings.EqualFold(sess.SessionName, "Sprint") {
|
||||||
|
sprintKey = sess.SessionKey
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
if raceKey == 0 {
|
if raceKey == 0 && sprintKey == 0 {
|
||||||
continue
|
continue
|
||||||
}
|
}
|
||||||
|
|
||||||
results, err := s.store.ListSessionResults(raceKey)
|
// Always build Races slice from the Race session only (for UI),
|
||||||
if err != nil {
|
// but include sprint points for standings.
|
||||||
return ChampionshipInputs{}, err
|
var raceResults []models.SessionResult
|
||||||
}
|
var raceGrid []models.StartingGrid
|
||||||
grid, err := s.store.ListStartingGrid(raceKey)
|
|
||||||
if err != nil {
|
|
||||||
return ChampionshipInputs{}, err
|
|
||||||
}
|
|
||||||
|
|
||||||
race := ChampionshipRace{
|
if raceKey != 0 {
|
||||||
Meeting: meeting,
|
results, err := s.store.ListSessionResults(raceKey)
|
||||||
RaceSessionKey: raceKey,
|
if err != nil {
|
||||||
Results: make([]models.SessionResult, 0, len(results)),
|
return ChampionshipInputs{}, err
|
||||||
Grid: make([]models.StartingGrid, 0, len(grid)),
|
}
|
||||||
}
|
grid, err := s.store.ListStartingGrid(raceKey)
|
||||||
for _, result := range results {
|
if err != nil {
|
||||||
race.Results = append(race.Results, resultToModel(result))
|
return ChampionshipInputs{}, err
|
||||||
}
|
}
|
||||||
for _, entry := range grid {
|
race := ChampionshipRace{
|
||||||
race.Grid = append(race.Grid, gridToModel(entry))
|
Meeting: meeting,
|
||||||
}
|
RaceSessionKey: raceKey,
|
||||||
inputs.Races = append(inputs.Races, race)
|
Results: make([]models.SessionResult, 0, len(results)),
|
||||||
|
Grid: make([]models.StartingGrid, 0, len(grid)),
|
||||||
|
}
|
||||||
|
for _, result := range results {
|
||||||
|
race.Results = append(race.Results, resultToModel(result))
|
||||||
|
}
|
||||||
|
for _, entry := range grid {
|
||||||
|
race.Grid = append(race.Grid, gridToModel(entry))
|
||||||
|
}
|
||||||
|
inputs.Races = append(inputs.Races, race)
|
||||||
|
raceResults = race.Results
|
||||||
|
|
||||||
if len(results) == 0 {
|
if len(results) > 0 {
|
||||||
continue
|
latestSessionKey = raceKey
|
||||||
}
|
latestMeetingKey = int(meeting.MeetingKey)
|
||||||
|
drivers, err := s.driversForSession(raceKey)
|
||||||
latestSessionKey = raceKey
|
if err != nil {
|
||||||
latestMeetingKey = int(meeting.MeetingKey)
|
return ChampionshipInputs{}, err
|
||||||
drivers, err := s.driversForSession(raceKey)
|
}
|
||||||
if err != nil {
|
for _, d := range drivers {
|
||||||
return ChampionshipInputs{}, err
|
inputs.DriverMap[d.DriverNumber] = d
|
||||||
}
|
}
|
||||||
for _, d := range drivers {
|
for _, result := range results {
|
||||||
inputs.DriverMap[d.DriverNumber] = d
|
pointsByDriver[result.DriverNumber] += result.Points
|
||||||
}
|
team := inputs.DriverMap[result.DriverNumber].TeamName
|
||||||
|
if team != "" {
|
||||||
for _, result := range results {
|
pointsByTeam[team] += result.Points
|
||||||
pointsByDriver[result.DriverNumber] += result.Points
|
}
|
||||||
team := inputs.DriverMap[result.DriverNumber].TeamName
|
}
|
||||||
if team != "" {
|
|
||||||
pointsByTeam[team] += result.Points
|
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
// Include sprint points if present.
|
||||||
|
// Note: 2026 has 4 sprints up to British GP (Chinese GP 11240, Miami 11275,
|
||||||
|
// Canadian 11286, British 11321) totaling e.g. ANT 21 = 4+3+6+8, RUS 26.
|
||||||
|
if sprintKey != 0 {
|
||||||
|
sprintResults, err := s.store.ListSessionResults(sprintKey)
|
||||||
|
if err != nil {
|
||||||
|
return ChampionshipInputs{}, err
|
||||||
|
}
|
||||||
|
if len(sprintResults) > 0 {
|
||||||
|
// Ensure driver map includes sprint-only drivers if any.
|
||||||
|
sprintDrivers, err := s.driversForSession(sprintKey)
|
||||||
|
if err == nil {
|
||||||
|
for _, d := range sprintDrivers {
|
||||||
|
if _, ok := inputs.DriverMap[d.DriverNumber]; !ok {
|
||||||
|
inputs.DriverMap[d.DriverNumber] = d
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
for _, result := range sprintResults {
|
||||||
|
pointsByDriver[result.DriverNumber] += result.Points
|
||||||
|
team := inputs.DriverMap[result.DriverNumber].TeamName
|
||||||
|
if team != "" {
|
||||||
|
pointsByTeam[team] += result.Points
|
||||||
|
}
|
||||||
|
}
|
||||||
|
// If this meeting had no race results (edge), still track latest.
|
||||||
|
if len(raceResults) == 0 {
|
||||||
|
latestSessionKey = sprintKey
|
||||||
|
latestMeetingKey = int(meeting.MeetingKey)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
_ = raceResults
|
||||||
|
_ = raceGrid
|
||||||
}
|
}
|
||||||
|
|
||||||
inputs.Champ = derivedDriverStandings(pointsByDriver, latestMeetingKey, latestSessionKey)
|
inputs.Champ = derivedDriverStandings(pointsByDriver, latestMeetingKey, latestSessionKey)
|
||||||
|
|||||||
@@ -375,3 +375,56 @@ func TestGetWeekendWithSessions(t *testing.T) {
|
|||||||
t.Fatalf("first session drivers = %+v, want available", weekend.Sessions[0].Datasets["drivers"])
|
t.Fatalf("first session drivers = %+v, want available", weekend.Sessions[0].Datasets["drivers"])
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
func TestGetChampionshipInputsIncludesSprintPoints(t *testing.T) {
|
||||||
|
// Regression for #57: Race-only aggregation dropped Sprint points.
|
||||||
|
// Setup: same meeting 1229 has Race (9472) 25pts + Sprint (9473) 8pts => total 33.
|
||||||
|
svc := openTestService(t)
|
||||||
|
seedRaceHubData(t, svc.store)
|
||||||
|
|
||||||
|
// Add sprint session for same meeting
|
||||||
|
if err := svc.store.UpsertSession(store.Session{
|
||||||
|
SessionKey: 9473,
|
||||||
|
MeetingKey: 1229,
|
||||||
|
SessionName: "Sprint",
|
||||||
|
SessionType: "Race", // OpenF1 uses SessionType Race even for Sprint
|
||||||
|
DateStart: "2025-05-24T13:00:00+00:00",
|
||||||
|
}); err != nil {
|
||||||
|
t.Fatalf("UpsertSession sprint error = %v", err)
|
||||||
|
}
|
||||||
|
if err := svc.store.UpsertSessionDriver(store.SessionDriver{
|
||||||
|
SessionKey: 9473, DriverNumber: 1, MeetingKey: 1229, TeamName: "Red Bull Racing",
|
||||||
|
}); err != nil {
|
||||||
|
t.Fatalf("UpsertSessionDriver sprint error = %v", err)
|
||||||
|
}
|
||||||
|
|
||||||
|
// Race points 25
|
||||||
|
if err := svc.store.UpsertSessionResult(store.SessionResult{
|
||||||
|
SessionKey: 9472, DriverNumber: 1, MeetingKey: 1229, Position: 1, Points: 25,
|
||||||
|
}); err != nil {
|
||||||
|
t.Fatalf("UpsertSessionResult race error = %v", err)
|
||||||
|
}
|
||||||
|
// Sprint points 8
|
||||||
|
if err := svc.store.UpsertSessionResult(store.SessionResult{
|
||||||
|
SessionKey: 9473, DriverNumber: 1, MeetingKey: 1229, Position: 1, Points: 8,
|
||||||
|
}); err != nil {
|
||||||
|
t.Fatalf("UpsertSessionResult sprint error = %v", err)
|
||||||
|
}
|
||||||
|
|
||||||
|
inputs, err := svc.GetChampionshipInputs(2025)
|
||||||
|
if err != nil {
|
||||||
|
t.Fatalf("GetChampionshipInputs() error = %v", err)
|
||||||
|
}
|
||||||
|
if len(inputs.Races) != 1 {
|
||||||
|
t.Fatalf("Races len = %d, want 1 race entry", len(inputs.Races))
|
||||||
|
}
|
||||||
|
if len(inputs.Champ) != 1 {
|
||||||
|
t.Fatalf("Champ len = %d, want 1", len(inputs.Champ))
|
||||||
|
}
|
||||||
|
if inputs.Champ[0].PointsCurrent != 33 {
|
||||||
|
t.Fatalf("PointsCurrent = %v, want 33 (25 race + 8 sprint)", inputs.Champ[0].PointsCurrent)
|
||||||
|
}
|
||||||
|
if len(inputs.Teams) != 1 || inputs.Teams[0].PointsCurrent != 33 {
|
||||||
|
t.Fatalf("Teams = %+v, want Red Bull 33", inputs.Teams)
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|||||||
@@ -1046,21 +1046,35 @@ type trackPoint struct {
|
|||||||
Y float64 `json:"y"`
|
Y float64 `json:"y"`
|
||||||
}
|
}
|
||||||
|
|
||||||
|
type trackBounds struct {
|
||||||
|
MinX float64 `json:"minX"`
|
||||||
|
MaxX float64 `json:"maxX"`
|
||||||
|
MinY float64 `json:"minY"`
|
||||||
|
MaxY float64 `json:"maxY"`
|
||||||
|
}
|
||||||
|
|
||||||
type trackOutlineResponse struct {
|
type trackOutlineResponse struct {
|
||||||
CircuitKey int `json:"circuit_key"`
|
CircuitKey int `json:"circuit_key"`
|
||||||
Points []trackPoint `json:"points"`
|
Points []trackPoint `json:"points"`
|
||||||
|
Bounds trackBounds `json:"bounds"`
|
||||||
}
|
}
|
||||||
|
|
||||||
func (s *Server) handleTrackOutline(w http.ResponseWriter, r *http.Request) {
|
func (s *Server) handleTrackOutline(w http.ResponseWriter, r *http.Request) {
|
||||||
circuitKey, err := strconv.Atoi(r.URL.Query().Get("circuit_key"))
|
|
||||||
if err != nil || circuitKey == 0 {
|
|
||||||
http.Error(w, "circuit_key required", http.StatusBadRequest)
|
|
||||||
return
|
|
||||||
}
|
|
||||||
year, _ := strconv.Atoi(r.URL.Query().Get("year"))
|
year, _ := strconv.Atoi(r.URL.Query().Get("year"))
|
||||||
if year == 0 {
|
if year == 0 {
|
||||||
year = time.Now().Year()
|
year = time.Now().Year()
|
||||||
}
|
}
|
||||||
|
circuitKey, err := strconv.Atoi(r.URL.Query().Get("circuit_key"))
|
||||||
|
if err != nil {
|
||||||
|
circuitKey = 0
|
||||||
|
}
|
||||||
|
if circuitKey == 0 {
|
||||||
|
circuitKey = s.resolveCircuitKey(year, r.URL.Query().Get("meeting_name"), r.URL.Query().Get("circuit_name"))
|
||||||
|
}
|
||||||
|
if circuitKey == 0 {
|
||||||
|
http.Error(w, "circuit_key or live meeting identity required", http.StatusBadRequest)
|
||||||
|
return
|
||||||
|
}
|
||||||
|
|
||||||
locs, ok := s.client.Cache().GetTrackOutline(circuitKey, year)
|
locs, ok := s.client.Cache().GetTrackOutline(circuitKey, year)
|
||||||
if !ok || len(locs) == 0 {
|
if !ok || len(locs) == 0 {
|
||||||
@@ -1110,7 +1124,85 @@ func (s *Server) handleTrackOutline(w http.ResponseWriter, r *http.Request) {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
writeJSON(w, trackOutlineResponse{CircuitKey: circuitKey, Points: points})
|
writeJSON(w, trackOutlineResponse{
|
||||||
|
CircuitKey: circuitKey,
|
||||||
|
Points: points,
|
||||||
|
Bounds: trackBounds{MinX: minX, MaxX: maxX, MinY: minY, MaxY: maxY},
|
||||||
|
})
|
||||||
|
}
|
||||||
|
|
||||||
|
func (s *Server) resolveCircuitKey(year int, meetingName, circuitName string) int {
|
||||||
|
if !s.hasLocalQuery() {
|
||||||
|
return 0
|
||||||
|
}
|
||||||
|
meetings, err := s.query.ListMeetingsByYear(year)
|
||||||
|
if err != nil {
|
||||||
|
return 0
|
||||||
|
}
|
||||||
|
wantMeeting := normalizeTrackIdentity(meetingName)
|
||||||
|
wantCircuit := normalizeTrackIdentity(circuitName)
|
||||||
|
bestScore := 0
|
||||||
|
bestCircuitKey := 0
|
||||||
|
for _, m := range meetings {
|
||||||
|
if m.CircuitKey == 0 {
|
||||||
|
continue
|
||||||
|
}
|
||||||
|
score := identityScore(wantMeeting, m.MeetingName, m.MeetingOfficialName, m.Location)
|
||||||
|
score += identityScore(wantCircuit, m.CircuitShortName, m.Location, m.MeetingName)
|
||||||
|
if score > bestScore {
|
||||||
|
bestScore = score
|
||||||
|
bestCircuitKey = m.CircuitKey
|
||||||
|
}
|
||||||
|
}
|
||||||
|
if bestScore == 0 {
|
||||||
|
return 0
|
||||||
|
}
|
||||||
|
return bestCircuitKey
|
||||||
|
}
|
||||||
|
|
||||||
|
func identityScore(want string, candidates ...string) int {
|
||||||
|
if want == "" {
|
||||||
|
return 0
|
||||||
|
}
|
||||||
|
best := 0
|
||||||
|
for _, candidate := range candidates {
|
||||||
|
got := normalizeTrackIdentity(candidate)
|
||||||
|
if got == "" {
|
||||||
|
continue
|
||||||
|
}
|
||||||
|
switch {
|
||||||
|
case got == want:
|
||||||
|
if best < 4 {
|
||||||
|
best = 4
|
||||||
|
}
|
||||||
|
case strings.Contains(got, want) || strings.Contains(want, got):
|
||||||
|
if best < 2 {
|
||||||
|
best = 2
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return best
|
||||||
|
}
|
||||||
|
|
||||||
|
func normalizeTrackIdentity(s string) string {
|
||||||
|
s = strings.ToLower(s)
|
||||||
|
replacer := strings.NewReplacer(
|
||||||
|
"grand prix", "",
|
||||||
|
" gp", "",
|
||||||
|
"circuit", "",
|
||||||
|
"autodromo", "",
|
||||||
|
"autódromo", "",
|
||||||
|
"international", "",
|
||||||
|
"street", "",
|
||||||
|
" ", "",
|
||||||
|
"-", "",
|
||||||
|
"_", "",
|
||||||
|
".", "",
|
||||||
|
",", "",
|
||||||
|
"'", "",
|
||||||
|
"’", "",
|
||||||
|
)
|
||||||
|
return strings.TrimSpace(replacer.Replace(s))
|
||||||
}
|
}
|
||||||
|
|
||||||
// --- /api/v1/strategy ---
|
// --- /api/v1/strategy ---
|
||||||
|
|||||||
@@ -29,9 +29,21 @@ type SSEHub struct {
|
|||||||
deregister chan *sseClient
|
deregister chan *sseClient
|
||||||
broadcast chan sseEvent
|
broadcast chan sseEvent
|
||||||
|
|
||||||
mu sync.RWMutex
|
mu sync.RWMutex
|
||||||
lastSnapshot *live.LiveStreamData
|
activeSnapshot *live.LiveStreamData
|
||||||
isLive bool
|
activePositions map[string]live.LivePositionData
|
||||||
|
lastSnapshot *live.LiveStreamData
|
||||||
|
lastPositions map[string]live.LivePositionData
|
||||||
|
lastSnapshotAt time.Time
|
||||||
|
isLive bool
|
||||||
|
}
|
||||||
|
|
||||||
|
type liveStatePayload struct {
|
||||||
|
IsLive bool `json:"is_live"`
|
||||||
|
Data *live.LiveStreamData `json:"data"`
|
||||||
|
LastSnapshot *live.LiveStreamData `json:"last_snapshot,omitempty"`
|
||||||
|
LastPositions map[string]live.LivePositionData `json:"last_positions,omitempty"`
|
||||||
|
LastSnapshotAt *time.Time `json:"last_snapshot_at,omitempty"`
|
||||||
}
|
}
|
||||||
|
|
||||||
func newSSEHub() *SSEHub {
|
func newSSEHub() *SSEHub {
|
||||||
@@ -50,18 +62,24 @@ func (h *SSEHub) run() {
|
|||||||
case c := <-h.register:
|
case c := <-h.register:
|
||||||
clients[c] = true
|
clients[c] = true
|
||||||
// Send catch-up snapshot so new clients see current state immediately.
|
// Send catch-up snapshot so new clients see current state immediately.
|
||||||
h.mu.RLock()
|
state := h.State()
|
||||||
snap := h.lastSnapshot
|
if state.Data != nil || state.LastSnapshot != nil {
|
||||||
live := h.isLive
|
if data, err := json.Marshal(state); err == nil {
|
||||||
h.mu.RUnlock()
|
|
||||||
if snap != nil {
|
|
||||||
if data, err := json.Marshal(map[string]any{"data": snap, "is_live": live}); err == nil {
|
|
||||||
select {
|
select {
|
||||||
case c.ch <- formatSSEFrame("snapshot", data):
|
case c.ch <- formatSSEFrame("snapshot", data):
|
||||||
default:
|
default:
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
positions := h.ActivePositions()
|
||||||
|
if len(positions) > 0 {
|
||||||
|
if data, err := json.Marshal(positions); err == nil {
|
||||||
|
select {
|
||||||
|
case c.ch <- formatSSEFrame("positions", data):
|
||||||
|
default:
|
||||||
|
}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
case c := <-h.deregister:
|
case c := <-h.deregister:
|
||||||
if clients[c] {
|
if clients[c] {
|
||||||
@@ -86,11 +104,125 @@ func formatSSEFrame(event string, data []byte) []byte {
|
|||||||
return []byte(fmt.Sprintf("event: %s\ndata: %s\n\n", event, data))
|
return []byte(fmt.Sprintf("event: %s\ndata: %s\n\n", event, data))
|
||||||
}
|
}
|
||||||
|
|
||||||
// Snapshot returns the latest live data snapshot and whether a session is active.
|
// State returns the active live snapshot and the retained in-memory archive.
|
||||||
func (h *SSEHub) Snapshot() (*live.LiveStreamData, bool) {
|
func (h *SSEHub) State() liveStatePayload {
|
||||||
h.mu.RLock()
|
h.mu.RLock()
|
||||||
defer h.mu.RUnlock()
|
defer h.mu.RUnlock()
|
||||||
return h.lastSnapshot, h.isLive
|
payload := liveStatePayload{
|
||||||
|
IsLive: h.isLive,
|
||||||
|
}
|
||||||
|
if h.isLive {
|
||||||
|
payload.Data = h.activeSnapshot
|
||||||
|
} else if h.lastSnapshot != nil {
|
||||||
|
payload.LastSnapshot = h.lastSnapshot
|
||||||
|
payload.LastPositions = cloneLivePositions(h.lastPositions)
|
||||||
|
if !h.lastSnapshotAt.IsZero() {
|
||||||
|
at := h.lastSnapshotAt
|
||||||
|
payload.LastSnapshotAt = &at
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return payload
|
||||||
|
}
|
||||||
|
|
||||||
|
func (h *SSEHub) ActivePositions() map[string]live.LivePositionData {
|
||||||
|
h.mu.RLock()
|
||||||
|
defer h.mu.RUnlock()
|
||||||
|
return cloneLivePositions(h.activePositions)
|
||||||
|
}
|
||||||
|
|
||||||
|
func (h *SSEHub) applySnapshot(data live.LiveStreamData, now time.Time) liveStatePayload {
|
||||||
|
h.mu.Lock()
|
||||||
|
defer h.mu.Unlock()
|
||||||
|
|
||||||
|
if live.SessionStatusIsActive(data.SessionStatus) {
|
||||||
|
h.isLive = true
|
||||||
|
h.activeSnapshot = &data
|
||||||
|
if data.PositionUpdated && len(data.Positions) > 0 {
|
||||||
|
h.activePositions = cloneLivePositions(data.Positions)
|
||||||
|
}
|
||||||
|
return liveStatePayload{IsLive: true, Data: h.activeSnapshot}
|
||||||
|
}
|
||||||
|
|
||||||
|
archivePositions := cloneLivePositions(h.activePositions)
|
||||||
|
if data.PositionUpdated && len(data.Positions) > 0 {
|
||||||
|
archivePositions = cloneLivePositions(data.Positions)
|
||||||
|
}
|
||||||
|
h.isLive = false
|
||||||
|
h.activeSnapshot = nil
|
||||||
|
h.activePositions = nil
|
||||||
|
if hasLiveSnapshotData(data) {
|
||||||
|
h.lastSnapshot = &data
|
||||||
|
h.lastSnapshotAt = now
|
||||||
|
h.lastPositions = archivePositions
|
||||||
|
}
|
||||||
|
return h.stateLocked()
|
||||||
|
}
|
||||||
|
|
||||||
|
func (h *SSEHub) applyPositions(data live.LiveStreamData) map[string]live.LivePositionData {
|
||||||
|
h.mu.Lock()
|
||||||
|
defer h.mu.Unlock()
|
||||||
|
|
||||||
|
if len(data.Positions) == 0 {
|
||||||
|
return nil
|
||||||
|
}
|
||||||
|
positions := cloneLivePositions(data.Positions)
|
||||||
|
if h.isLive {
|
||||||
|
h.activePositions = positions
|
||||||
|
return positions
|
||||||
|
}
|
||||||
|
if h.lastSnapshot != nil {
|
||||||
|
h.lastPositions = positions
|
||||||
|
}
|
||||||
|
return nil
|
||||||
|
}
|
||||||
|
|
||||||
|
func (h *SSEHub) deactivate(now time.Time) liveStatePayload {
|
||||||
|
h.mu.Lock()
|
||||||
|
defer h.mu.Unlock()
|
||||||
|
|
||||||
|
if h.activeSnapshot != nil {
|
||||||
|
h.lastSnapshot = h.activeSnapshot
|
||||||
|
h.lastPositions = cloneLivePositions(h.activePositions)
|
||||||
|
h.lastSnapshotAt = now
|
||||||
|
}
|
||||||
|
h.isLive = false
|
||||||
|
h.activeSnapshot = nil
|
||||||
|
h.activePositions = nil
|
||||||
|
return h.stateLocked()
|
||||||
|
}
|
||||||
|
|
||||||
|
func (h *SSEHub) stateLocked() liveStatePayload {
|
||||||
|
payload := liveStatePayload{IsLive: h.isLive}
|
||||||
|
if h.isLive {
|
||||||
|
payload.Data = h.activeSnapshot
|
||||||
|
return payload
|
||||||
|
}
|
||||||
|
if h.lastSnapshot != nil {
|
||||||
|
payload.LastSnapshot = h.lastSnapshot
|
||||||
|
payload.LastPositions = cloneLivePositions(h.lastPositions)
|
||||||
|
if !h.lastSnapshotAt.IsZero() {
|
||||||
|
at := h.lastSnapshotAt
|
||||||
|
payload.LastSnapshotAt = &at
|
||||||
|
}
|
||||||
|
}
|
||||||
|
return payload
|
||||||
|
}
|
||||||
|
|
||||||
|
func hasLiveSnapshotData(data live.LiveStreamData) bool {
|
||||||
|
return len(data.Drivers) > 0 ||
|
||||||
|
len(data.DriverInfo) > 0 ||
|
||||||
|
len(data.Tyres) > 0 ||
|
||||||
|
len(data.Telemetry) > 0 ||
|
||||||
|
len(data.RCMessages) > 0 ||
|
||||||
|
len(data.TeamRadio) > 0 ||
|
||||||
|
len(data.Stints) > 0 ||
|
||||||
|
data.Session.MeetingName != "" ||
|
||||||
|
data.Session.SessionName != "" ||
|
||||||
|
data.Session.SessionType != "" ||
|
||||||
|
data.TrackStatus != "" ||
|
||||||
|
data.CurrentLap != 0 ||
|
||||||
|
data.TotalLaps != 0 ||
|
||||||
|
data.Clock != ""
|
||||||
}
|
}
|
||||||
|
|
||||||
// runLiveFeeds launches background goroutines for the F1 SignalR feed and keepalive.
|
// runLiveFeeds launches background goroutines for the F1 SignalR feed and keepalive.
|
||||||
@@ -119,12 +251,8 @@ func (s *Server) signalRLoop() {
|
|||||||
log.Printf("web: live feed ended: %v", err)
|
log.Printf("web: live feed ended: %v", err)
|
||||||
}
|
}
|
||||||
|
|
||||||
s.hub.mu.Lock()
|
state := s.hub.deactivate(time.Now())
|
||||||
s.hub.isLive = false
|
if payload, err := json.Marshal(state); err == nil {
|
||||||
s.hub.lastSnapshot = nil
|
|
||||||
s.hub.mu.Unlock()
|
|
||||||
|
|
||||||
if payload, err := json.Marshal(map[string]any{"data": nil, "is_live": false}); err == nil {
|
|
||||||
s.hub.broadcast <- sseEvent{name: "snapshot", data: payload}
|
s.hub.broadcast <- sseEvent{name: "snapshot", data: payload}
|
||||||
}
|
}
|
||||||
|
|
||||||
@@ -150,17 +278,29 @@ func (s *Server) connectAndDrain() error {
|
|||||||
idleTimeout := 60 * time.Second
|
idleTimeout := 60 * time.Second
|
||||||
timer := time.NewTimer(idleTimeout)
|
timer := time.NewTimer(idleTimeout)
|
||||||
defer timer.Stop()
|
defer timer.Stop()
|
||||||
|
lastPositionBroadcast := time.Time{}
|
||||||
|
|
||||||
for {
|
for {
|
||||||
select {
|
select {
|
||||||
case data := <-dataChan:
|
case data := <-dataChan:
|
||||||
s.hub.mu.Lock()
|
now := time.Now()
|
||||||
s.hub.lastSnapshot = &data
|
if data.SnapshotUpdated {
|
||||||
s.hub.isLive = true
|
state := s.hub.applySnapshot(data, now)
|
||||||
s.hub.mu.Unlock()
|
if payload, err := json.Marshal(state); err == nil {
|
||||||
|
s.hub.broadcast <- sseEvent{name: "snapshot", data: payload}
|
||||||
|
}
|
||||||
|
}
|
||||||
|
|
||||||
if payload, err := json.Marshal(map[string]any{"data": data, "is_live": true}); err == nil {
|
if data.PositionUpdated && len(data.Positions) > 0 && now.Sub(lastPositionBroadcast) >= 250*time.Millisecond {
|
||||||
s.hub.broadcast <- sseEvent{name: "snapshot", data: payload}
|
positions := s.hub.applyPositions(data)
|
||||||
|
if len(positions) > 0 {
|
||||||
|
payload, err := json.Marshal(positions)
|
||||||
|
if err != nil {
|
||||||
|
continue
|
||||||
|
}
|
||||||
|
s.hub.broadcast <- sseEvent{name: "positions", data: payload}
|
||||||
|
lastPositionBroadcast = now
|
||||||
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
if !timer.Stop() {
|
if !timer.Stop() {
|
||||||
@@ -177,13 +317,20 @@ func (s *Server) connectAndDrain() error {
|
|||||||
}
|
}
|
||||||
}
|
}
|
||||||
|
|
||||||
|
func cloneLivePositions(in map[string]live.LivePositionData) map[string]live.LivePositionData {
|
||||||
|
if len(in) == 0 {
|
||||||
|
return nil
|
||||||
|
}
|
||||||
|
out := make(map[string]live.LivePositionData, len(in))
|
||||||
|
for k, v := range in {
|
||||||
|
out[k] = v
|
||||||
|
}
|
||||||
|
return out
|
||||||
|
}
|
||||||
|
|
||||||
// handleLiveState returns the current live data snapshot as JSON.
|
// handleLiveState returns the current live data snapshot as JSON.
|
||||||
func (s *Server) handleLiveState(w http.ResponseWriter, r *http.Request) {
|
func (s *Server) handleLiveState(w http.ResponseWriter, r *http.Request) {
|
||||||
snap, isLive := s.hub.Snapshot()
|
writeJSON(w, s.hub.State())
|
||||||
writeJSON(w, map[string]any{
|
|
||||||
"is_live": isLive,
|
|
||||||
"data": snap,
|
|
||||||
})
|
|
||||||
}
|
}
|
||||||
|
|
||||||
// handleSSEStream is the persistent SSE endpoint for live data.
|
// handleSSEStream is the persistent SSE endpoint for live data.
|
||||||
|
|||||||
Some files were not shown because too many files have changed in this diff Show More
Reference in New Issue
Block a user