@sensiblestats/widget-sdk 0.24.0 → 0.25.0

package/CHANGELOG.md

@@ -1,5 +1,50 @@
 # @sensiblestats/widget-sdk
 
+## 0.25.0
+
+### Minor Changes
+
+- f3f845c: Auto-transition the club fan dashboard from preMatch to live without a reload.
+
+  Widget SDK: mirror the live dashboard's server contracts — `LiveScoreData` gains
+  `minute`/`clockRunning`/crest URLs, `LiveEventLine` gains a typed `minute`/`type`/`side`
+  (plus optional `player`/`playerOff`), `LiveStatRow` gains numeric `clubNum`/`oppNum`,
+  and `LiveStatsData` gains a typed `momentum: MomentumPoint[]` series plus a
+  `clubIsHome`/`homeName`/`awayName` venue signal (mirroring the existing `ClubIsHome`
+  pattern on `RestingNextData`/`PostMatchNextData`).
+
+  Widget React: adds a `useLiveClock` hook that ticks the displayed live minute forward
+  once per real minute between 60s polls, so the clock doesn't look frozen. The tick is
+  capped at minute+15 so a stuck `clockRunning:true` (no live→postMatch transition landed)
+  holds instead of climbing past stoppage time.
+
+  Widget React: redesigns the live score card — team crests (falling back to a coloured
+  initials chip when a crest URL is missing or fails to load), a pulsing Live pill wired
+  to the ticking clock, and a scorers line derived from the timeline's goal events.
+  Introduces the shared `--ss-w-home`/`--ss-w-away`/`--ss-w-track` colour tokens the
+  timeline and stats cards will also use.
+
+  Widget React: redesigns the live events timeline into a compact two-sided view — each
+  club's events sit on their own side of a centre spine, most-recent 3 shown with a "See
+  more" toggle for the rest. Goals get a bold name and an accented minute badge, yellow/red
+  cards get a coloured card mark, substitutions show both players, and unrecognised event
+  types fall back to a neutral dot instead of breaking.
+
+  Widget React: redesigns the live stats card — every row is now a home/away split bar
+  (guarded against a 0/0 stat, which renders an even split rather than a NaN width) plus
+  a new `MomentumWave` component that plots the per-minute momentum series as a filled
+  area wave with a dashed baseline and a "now" dot, falling back to the plain-text
+  momentum label when no series is available. Both the split bars and the wave now
+  colour by VENUE (`--ss-w-home`/`--ss-w-away`, keyed off the new `clubIsHome` field) so
+  the same team reads as the same colour across the score, timeline, and stats cards —
+  club-positive momentum fills with the club's own venue colour rather than always
+  painting the club as "home". The colour legend uses the real home/away team names.
+
+  Widget React: the 60s live poll now refreshes the dashboard's greeting/lead line
+  alongside its cards, so it no longer goes stale (e.g. reading "0–0" while the score
+  card already shows "0–2"). A poll response without a greeting leaves the existing
+  one in place rather than clearing it.
+
 ## 0.24.0
 
 ### Minor Changes

package/dist/index.d.cts

@@ -322,11 +322,20 @@ interface LiveScoreData {
     competition?: string | null;
     minuteLabel: string;
     statusLabel: string;
+    minute: number;
+    clockRunning: boolean;
+    homeCrestUrl?: string | null;
+    awayCrestUrl?: string | null;
 }
 interface LiveEventLine {
     minuteLabel: string;
     text: string;
     scoredByClub: boolean;
+    minute: number;
+    type: 'goal' | 'yellow' | 'red' | 'sub' | 'other';
+    side: 'home' | 'away';
+    player?: string | null;
+    playerOff?: string | null;
 }
 interface LiveTimelineData {
     events: LiveEventLine[];
@@ -335,10 +344,20 @@ interface LiveStatRow {
     label: string;
     clubValue: string;
     oppValue: string;
+    clubNum: number;
+    oppNum: number;
+}
+interface MomentumPoint {
+    minute: number;
+    value: number;
 }
 interface LiveStatsData {
     rows: LiveStatRow[];
     momentumLabel?: string | null;
+    momentum: MomentumPoint[];
+    clubIsHome: boolean;
+    homeName: string;
+    awayName: string;
 }
 interface LiveScoreCard extends ClubFanDashboardCardBase {
     cardType: 'liveScore';

package/dist/index.d.ts

@@ -322,11 +322,20 @@ interface LiveScoreData {
     competition?: string | null;
     minuteLabel: string;
     statusLabel: string;
+    minute: number;
+    clockRunning: boolean;
+    homeCrestUrl?: string | null;
+    awayCrestUrl?: string | null;
 }
 interface LiveEventLine {
     minuteLabel: string;
     text: string;
     scoredByClub: boolean;
+    minute: number;
+    type: 'goal' | 'yellow' | 'red' | 'sub' | 'other';
+    side: 'home' | 'away';
+    player?: string | null;
+    playerOff?: string | null;
 }
 interface LiveTimelineData {
     events: LiveEventLine[];
@@ -335,10 +344,20 @@ interface LiveStatRow {
     label: string;
     clubValue: string;
     oppValue: string;
+    clubNum: number;
+    oppNum: number;
+}
+interface MomentumPoint {
+    minute: number;
+    value: number;
 }
 interface LiveStatsData {
     rows: LiveStatRow[];
     momentumLabel?: string | null;
+    momentum: MomentumPoint[];
+    clubIsHome: boolean;
+    homeName: string;
+    awayName: string;
 }
 interface LiveScoreCard extends ClubFanDashboardCardBase {
     cardType: 'liveScore';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sensiblestats/widget-sdk",
-  "version": "0.24.0",
+  "version": "0.25.0",
   "description": "Headless browser SDK for the SensibleStats chat widget gateway.",
   "type": "module",
   "main": "./dist/index.cjs",