${idx + 1}
- ${escapeHtml(row.displayName || row.driverName)}${row.personalTimeUp ? ` 🏁 ${t("timing.personal_time_up")}` : ""}${row.suspectPending ? ` ⚠` : ""}
+ ${escapeHtml(row.displayName || row.driverName)}${row.personalTimeUp ? ` 🏁 ${t("timing.personal_time_up")}` : ""}${row.suspectPending ? ` ⚠` : ""}${renderLiveMarkBadges(mark, { formatLap, escapeHtml, labels: markLabels })}
${row.heatCarName ? `🚗 ${escapeHtml(row.heatCarName)}` : `${escapeHtml(row.teamId ? `${t("overlay.active_member")}: ${formatTeamActiveMemberLabel(row)}` : row.subLabel || row.transponder || "-")}`}
${row.lastSplitMs || row.pitActive || row.pitStops ? `${row.lastSplitMs ? `${t("table.split")}: ${formatLap(row.lastSplitMs)}` : ""}${row.lastSplitMs && (row.pitActive || row.pitStops) ? " • " : ""}${row.pitActive ? t("timing.pit_active") : row.pitStops ? `${t("table.pit")}: ${row.pitStops} / ${formatLap(row.totalPitMs)}` : ""}` : ""}
${row.invalidPending ? `${escapeHtml(row.invalidLabel)}${row.invalidLapMs ? ` • ${formatLap(row.invalidLapMs)}` : ""}` : ""}
@@ -219,11 +224,14 @@ function renderObsBroadcast({ active, compactRows, startOrder, showStartGrid, fa
// With laps in their own column the result's "14/" prefix only repeats them.
const timeOnly = (value) => (obsConfig.showLaps ? String(value || "").replace(/^\d+\//, "") : String(value || ""));
const podium = (place) => (place <= 3 ? ` is-p${place}` : "");
+ const liveMarks = showStartGrid ? null : overlayLiveMarks.observe(compactRows);
const rows = showStartGrid
? getSessionGridEntries(active).slice(0, obsConfig.rows).map((entry, idx) => `
${cell("pos", entry.slot)}${cell("name", escapeHtml(entry.name))}
`)
: compactRows.map((row, idx) => {
const start = startOrder.indexOf(row.driverId) + 1;
+ const mark = liveMarks?.get(String(row.key ?? ""));
+ const badges = renderLiveMarkBadges(mark, { formatLap, escapeHtml, labels: { pit: t("table.pit"), split: t("table.split") } });
const values = {
pos: idx + 1,
start: start ? `/${start}` : "",
@@ -234,7 +242,11 @@ function renderObsBroadcast({ active, compactRows, startOrder, showStartGrid, fa
best: Number.isFinite(row.bestLapMs) ? escapeHtml(formatLap(row.bestLapMs)) : "-",
gap: escapeHtml(idx === 0 ? "" : row.gapDisplay || row.gapAhead || ""),
};
- return `${columns.map(([key]) => cell(key, values[key])).join("")}
`;
+ // Pit clock and split at the end of the name column, the one flexible column - in
+ // the time columns they would push every other column out of line.
+ if (badges) values.name = `${values.name}${badges}`;
+ const flash = passingFlashAttrs(mark);
+ return `${columns.map(([key]) => cell(key, values[key])).join("")}
`;
});
const eventName = String(getEventName(active.eventId) || "").trim();
return `
diff --git a/src/styles.css b/src/styles.css
index 366904d..b9ce443 100644
--- a/src/styles.css
+++ b/src/styles.css
@@ -4992,3 +4992,40 @@ tr:has(> td > .medal-3) { background: linear-gradient(90deg, rgba(205, 127, 60,
.stint-lap.is-excluded { opacity: 0.55; }
.stint-laps-empty { color: var(--muted); }
.stint-laps-title { margin: 12px 0 2px; }
+
+/* Overlay live marks (src/overlay_live_marks.js): flash on a new time, pit clock, split. */
+.overlay-race-row.is-passing, .obs-tv-row.is-passing { animation: overlay-pass 700ms ease-out var(--pass-delay, 0ms) both; }
+@keyframes overlay-pass {
+ 0% { box-shadow: inset 4px 0 0 #ffe066, inset 0 0 0 999px rgb(255 224 102 / 34%); }
+ 100% { box-shadow: inset 4px 0 0 transparent, inset 0 0 0 999px transparent; }
+}
+@media (prefers-reduced-motion: reduce) {
+ .overlay-race-row.is-passing, .obs-tv-row.is-passing { animation: none; box-shadow: inset 4px 0 0 #ffe066; }
+}
+.overlay-live-marks { display: inline-flex; flex-wrap: wrap; gap: 4px; margin-left: 6px; vertical-align: middle; }
+.overlay-race-driver .overlay-live-marks { margin-left: 8px; }
+/* The driver cell styles its spans as tiny grey labels; the marks keep their own look. */
+.overlay-race-driver .overlay-live-marks span { font-size: 0.72rem; letter-spacing: 0; text-transform: none; }
+.overlay-race-driver .overlay-pit-badge { color: #2a1a00; }
+.overlay-race-driver .overlay-pit-badge.is-done { color: #ffd28a; }
+.overlay-race-driver .overlay-split-chip { color: #bfe8ff; }
+body[data-theme="light"] .overlay-race-driver .overlay-split-chip { color: #075985; }
+body[data-theme="light"] .overlay-race-driver .overlay-pit-badge.is-done { color: #7a4a00; }
+.overlay-pit-badge, .overlay-split-chip { display: inline-flex; align-items: center; gap: 3px; padding: 1px 6px; border-radius: 999px; font-size: 0.78em; font-weight: 800; line-height: 1.4; font-variant-numeric: tabular-nums; white-space: nowrap; }
+.overlay-pit-badge { background: #f5a623; color: #2a1a00; }
+.overlay-pit-badge.is-active { animation: overlay-pit-pulse 1s ease-in-out infinite; }
+.overlay-pit-badge.is-done { background: color-mix(in srgb, #f5a623 30%, transparent); color: #ffd28a; }
+.overlay-fuel-icon { width: 1.05em; height: 1.05em; flex: none; }
+@keyframes overlay-pit-pulse { 50% { background: #ffc65c; } }
+.overlay-split-chip { background: rgb(14 165 233 / 22%); color: #bfe8ff; }
+.overlay-split-chip i { font-style: normal; }
+.overlay-split-chip .is-faster { color: #4ade80; }
+.overlay-split-chip .is-slower { color: #f87171; }
+/* Hung outside the tower's left edge, over the video: it covers no name and the tower
+ (sized to its content) never changes width. */
+.obs-tv-row:has(.overlay-live-marks) { position: relative; overflow: visible; }
+.obs-tv-name:has(.overlay-live-marks) { overflow: visible; }
+.obs-tv-cell .overlay-live-marks { position: absolute; top: 50%; right: calc(100% + 0.35em); transform: translateY(-50%); flex-wrap: nowrap; margin: 0; font-size: 0.85em; text-transform: none; filter: drop-shadow(0 0.1em 0.3em rgb(0 0 0 / 60%)); }
+.obs-tv-cell .overlay-split-chip { background: #0b4a6b; }
+body[data-theme="light"] .overlay-split-chip { color: #075985; }
+body[data-theme="light"] .overlay-pit-badge.is-done { color: #7a4a00; }
diff --git a/tests/browser_overlay_live_marks.js b/tests/browser_overlay_live_marks.js
new file mode 100644
index 0000000..bbbc95e
--- /dev/null
+++ b/tests/browser_overlay_live_marks.js
@@ -0,0 +1,62 @@
+import assert from "node:assert/strict";
+
+// Overlay live marks in a real browser: a new time flashes the row, a car in the pits gets a
+// ticking clock with a fuel pump next to its time, and a new split shows - on the regular
+// leaderboard and the OBS tower.
+export async function runOverlayLiveMarksSmoke({ evaluate }) {
+ const result = await evaluate(`(async () => {
+ const { renderOverlayLeaderboard, renderObsOverlay } = await import('/src/overlays.js');
+ const { refreshLiveMarkNodes } = await import('/src/overlay_live_marks.js');
+ const { escapeHtml } = await import('/src/html_escape.js');
+ const frame = document.createElement('iframe');
+ frame.style.cssText = 'position:fixed;left:0;top:0;width:1200px;height:700px;border:0;z-index:99999';
+ document.body.append(frame);
+ const doc = frame.contentDocument;
+ const style = doc.createElement('link'); style.rel = 'stylesheet'; style.href = '/src/styles.css';
+ const loaded = new Promise((resolve, reject) => { style.onload = resolve; style.onerror = reject; });
+ doc.head.append(style); await loaded;
+ const wait = (ms) => new Promise((resolve) => setTimeout(resolve, ms));
+ const deps = { t: (key) => key, escapeHtml, formatLap: (ms) => (ms / 1000).toFixed(3), formatTeamActiveMemberLabel: () => '', formatPredictedLapDelta: () => '-', getVisiblePassings: () => [], getEventName: () => 'Club', getSessionTypeLabel: () => 'Practice', getStartModeLabel: () => '', getStatusLabel: () => '', getObsOverlayConfig: () => ({ layout: 'broadcast', rows: 10, showClock: true, showLaps: true, showResult: true, showBest: true, showGap: true }), normalizeStartMode: (v) => v, renderPositionGrid: () => '', getSessionGridEntries: () => [], getSessionGridOrder: () => [] };
+ const now = Date.now();
+ let rows = [{ key: 'lm_a', displayName: 'Anna', laps: 3, resultDisplay: '3/0:41.000', bestLapMs: 13500, lastTimestamp: now - 5000 }, { key: 'lm_b', displayName: 'Bo', laps: 3, resultDisplay: '3/0:42.000', bestLapMs: 13700, lastTimestamp: now - 4000 }];
+ const out = {};
+ try {
+ doc.body.innerHTML = '';
+ const board = doc.querySelector('.overlay-board');
+ const draw = () => { board.innerHTML = renderOverlayLeaderboard(rows, deps, { sortable: false }); };
+ draw();
+ out.flashOnOpen = board.querySelectorAll('.is-passing').length;
+ rows = rows.map((row) => row.key === 'lm_a' ? { ...row, laps: 4, lastTimestamp: now + 1 } : row);
+ draw();
+ const flashed = board.querySelector('.overlay-race-row.is-passing');
+ out.flashed = flashed?.dataset.overlayCompetitor || '';
+ out.animation = flashed ? getComputedStyle(flashed).animationName : '';
+ rows = rows.map((row) => row.key === 'lm_b' ? { ...row, pitActive: true, pitEnteredAt: now } : row);
+ draw();
+ const clock = () => board.querySelector('[data-overlay-competitor="lm_b"] [data-pit-clock] b')?.textContent || '';
+ out.pitIcon = Boolean(board.querySelector('[data-overlay-competitor="lm_b"] .overlay-pit-badge svg'));
+ const before = clock();
+ await wait(450);
+ refreshLiveMarkNodes(doc);
+ out.pitTicks = before !== clock() && /^0:00\\.[0-9]$/.test(clock());
+ rows = rows.map((row) => row.key === 'lm_a' ? { ...row, lastSplitTimestamp: now + 2, lastSplitMs: 5123, lastSplitDeltaMs: -120 } : row);
+ draw();
+ out.split = board.querySelector('[data-overlay-competitor="lm_a"] .overlay-split-chip')?.textContent.trim() || '';
+ doc.body.innerHTML = '';
+ rows = rows.map((row) => row.key === 'lm_a' ? { ...row, laps: 5, lastTimestamp: now + 3 } : row);
+ doc.body.firstElementChild.innerHTML = renderObsOverlay({ name: 'Practice', eventId: 'e', status: 'running', type: 'open_practice' }, rows, {}, { remainingMs: 300000 }, {}, deps);
+ out.obsFlash = doc.querySelectorAll('.obs-tv-row.is-passing').length;
+ out.obsPit = Boolean(doc.querySelector('.obs-tv-row [data-pit-clock]'));
+ } finally { frame.remove(); }
+ return out;
+ })()`);
+ assert.equal(result.flashOnOpen, 0, "nothing flashes when the overlay opens");
+ assert.equal(result.flashed, "lm_a", "the driver with the new time flashes");
+ assert.equal(result.animation, "overlay-pass");
+ assert.equal(result.pitIcon, true, "fuel pump next to the time");
+ assert.equal(result.pitTicks, true, "the pit clock ticks without a redraw");
+ assert.match(result.split, /^S 5\.123 −0\.120$/);
+ assert.equal(result.obsFlash, 1, "the OBS tower flashes too");
+ assert.equal(result.obsPit, true, "and shows the pit clock");
+ console.log("PASS overlay live marks: a new time flashes the row, the pit clock ticks with a fuel pump, a new split shows - leaderboard and OBS tower");
+}
diff --git a/tests/browser_smoke.js b/tests/browser_smoke.js
index bfc60e0..7b87e7d 100644
--- a/tests/browser_smoke.js
+++ b/tests/browser_smoke.js
@@ -1,4 +1,5 @@
import { runOverlaySmoke } from "./browser_overlays.js";
+import { runOverlayLiveMarksSmoke } from "./browser_overlay_live_marks.js";
import { runRaceSetupSmoke } from "./browser_race_setup.js";
import { runRaceDaySmoke } from "./browser_race_day.js";
import { runRaceDayFinalsSmoke } from "./browser_race_day_finals.js";
@@ -222,6 +223,7 @@ try {
})()`);
console.log("PASS decoder diagnostics update without resetting settings draft");
await runOverlaySmoke({ evaluate });
+ await runOverlayLiveMarksSmoke({ evaluate });
const mobileState = await savedState();
const mobileToken = "browser-mobile-profile-token-1234567890";
mobileState.training ||= {};
diff --git a/tests/overlay_live_marks.test.js b/tests/overlay_live_marks.test.js
new file mode 100644
index 0000000..0a55e34
--- /dev/null
+++ b/tests/overlay_live_marks.test.js
@@ -0,0 +1,64 @@
+import test from "node:test";
+import assert from "node:assert/strict";
+import { createOverlayLiveMarks, formatPitClock, passingFlashAttrs, renderLiveMarkBadges, PASSING_FLASH_MS } from "../src/overlay_live_marks.js";
+
+const escapeHtml = (value) => String(value);
+const formatLap = (ms) => `${Math.floor(ms / 60000)}:${String(Math.floor(ms % 60000 / 1000)).padStart(2, "0")}.${String(ms % 1000).padStart(3, "0")}`;
+
+test("a new time flashes the row for a moment, but nothing flashes when the overlay first opens", () => {
+ let clock = 1_000_000;
+ const marks = createOverlayLiveMarks({ now: () => clock });
+ const row = { key: "d1", lastTimestamp: 500 };
+ assert.equal(marks.observe([row]).get("d1").passingAgeMs, null, "first sight: no flash");
+ clock += 100;
+ assert.equal(marks.observe([row]).get("d1").passingAgeMs, null, "same time again: no flash");
+ clock += 100;
+ assert.equal(marks.observe([{ ...row, lastTimestamp: 14_000 }]).get("d1").passingAgeMs, 0);
+ clock += 250;
+ const mark = marks.observe([{ ...row, lastTimestamp: 14_000 }]).get("d1");
+ assert.equal(mark.passingAgeMs, 250, "a re-render keeps the flash going");
+ assert.deepEqual(passingFlashAttrs(mark), { className: " is-passing", style: ' style="--pass-delay:-250ms"' });
+ clock += PASSING_FLASH_MS;
+ assert.equal(marks.observe([{ ...row, lastTimestamp: 14_000 }]).get("d1").passingAgeMs, null);
+});
+
+test("pit: a running clock from this computer's time, then the stop time for a few seconds", () => {
+ let clock = 2_000_000;
+ const marks = createOverlayLiveMarks({ now: () => clock });
+ marks.observe([{ key: "d1", lastTimestamp: 1, pitStops: 0 }]);
+ clock += 1000;
+ const inPit = marks.observe([{ key: "d1", lastTimestamp: 1, pitActive: true, pitEnteredAt: 42, pitStops: 0 }]).get("d1");
+ assert.deepEqual(inPit.pit, { active: true, startAt: clock }, "the decoder's entry time is not used once the overlay saw the entry");
+ assert.match(renderLiveMarkBadges(inPit, { formatLap, escapeHtml, nowMs: clock + 12_400 }), /data-pit-clock="\d+".*0:12\.4/s);
+ clock += 24_000;
+ const out = marks.observe([{ key: "d1", lastTimestamp: 1, pitActive: false, pitStops: 1, lastPitStopMs: 24_512 }]).get("d1");
+ assert.equal(out.pit.stopMs, 24_512);
+ assert.match(renderLiveMarkBadges(out, { formatLap, escapeHtml }), /is-done.*0:24\.512/s);
+ clock += 5000;
+ assert.equal(marks.observe([{ key: "d1", lastTimestamp: 1, pitStops: 1, lastPitStopMs: 24_512 }]).get("d1").pit, null);
+});
+
+test("a car already in the pits when the overlay opens gets its clock from the entry time", () => {
+ const clock = 3_000_000;
+ const marks = createOverlayLiveMarks({ now: () => clock });
+ assert.equal(marks.observe([{ key: "d1", pitActive: true, pitEnteredAt: clock - 8000 }]).get("d1").pit.startAt, clock - 8000);
+ const odd = createOverlayLiveMarks({ now: () => clock });
+ assert.equal(odd.observe([{ key: "d1", pitActive: true, pitEnteredAt: clock + 60_000 }]).get("d1").pit.startAt, clock, "a decoder clock ahead of ours starts at 0");
+});
+
+test("a new split shows for a few seconds with its gain against the previous lap", () => {
+ let clock = 4_000_000;
+ const marks = createOverlayLiveMarks({ now: () => clock });
+ marks.observe([{ key: "d1", lastSplitTimestamp: 10 }]);
+ clock += 50;
+ const mark = marks.observe([{ key: "d1", lastSplitTimestamp: 20, lastSplitMs: 5123, lastSplitDeltaMs: -120 }]).get("d1");
+ assert.match(renderLiveMarkBadges(mark, { formatLap, escapeHtml }), /S 0:05\.123 −0\.120/);
+ clock += 4000;
+ assert.equal(marks.observe([{ key: "d1", lastSplitTimestamp: 20, lastSplitMs: 5123 }]).get("d1").split, null);
+});
+
+test("formatPitClock", () => {
+ assert.equal(formatPitClock(12_480), "0:12.4");
+ assert.equal(formatPitClock(75_000), "1:15.0");
+ assert.equal(formatPitClock(-5), "0:00.0");
+});
diff --git a/tests/run.js b/tests/run.js
index 757d67b..f49574d 100644
--- a/tests/run.js
+++ b/tests/run.js
@@ -2,6 +2,7 @@ import "./auth.test.js";
import "./backend_url.test.js";
import "./houseofrc_logic.test.js";
import "./stint_laps_view.test.js";
+import "./overlay_live_marks.test.js";
import "./judging_penalties.test.js";
import "./practice_rank.test.js";
import "./team_race_logic.test.js";