@wral/hsot-data 0.3.0 → 0.5.0

package/README.md

@@ -9,10 +9,10 @@ exactly one of these elements.
 
 | Component | Page | Key attributes |
 |---|---|---|
-| `<hsot-scores>` | Scores/Schedules (the scoreboard; future dates are schedules) | `sport`, `date` (YYYY-MM-DD, deep-linkable via `?date=`; defaults to the closest matchday: today when games are on, otherwise the previous one), `season`, `refresh-interval` |
-| `<hsot-standings>` | Standings, every conference for a sport | `sport`, `season` |
+| `<hsot-scores>` | Scores/Schedules (the scoreboard; future dates are schedules): an All Games list or a Conferences view, filterable by area code | `sport`, `date` (YYYY-MM-DD, deep-linkable via `?date=`; defaults to the closest matchday: today when games are on, otherwise the previous one), `view` (`all` or `conferences`, `?view=`), `area-code` (`?area=`), `season`, `refresh-interval` |
+| `<hsot-standings>` | Standings, every conference for a sport | `sport`, `gender` (one side of a gendered sport), `season` |
 | `<hsot-rankings>` | The weekly Top 25 with movement + rank history | `sport`, `gender` (poll family), `season`, deep link `?poll=YYYY-MM-DD` |
-| `<hsot-school>` | School hub: hero, team tabs, schedule, roster (headed by the season's roster photo when one is set; positions render as a list, "WR/CB"; a College column appears when a player carries a commitment), honors | `school-id`, `sport` (initial tab, deep link `?sport=`), `season` |
+| `<hsot-school>` | School hub: hero, team tabs, schedule, roster (headed by the season's roster photo when one is set; positions render as a list, "WR/CB"; a College column appears when a player carries a commitment), honors | `school-id`, `sport` + `gender` (initial tab, deep links `?sport=` / `?gender=`), `season` |
 | `<hsot-boxscore>` | Game detail: line score (stored `periodScores`, or derived from the scoring plays when nothing wrote one — `src/lib/line-score.mjs`, shown only when it reconciles with the score), the desk's scoring-play log when a game carries one (period, clock, play, running score), coverage, season context; game notes keep their line breaks | `game-id`, `refresh-interval` |
 | `<hsot-brackets>` | Playoff brackets: a sport's tournaments for the season, rounds as columns laid out from the winner edges (seedings place round one; `GET /tournaments/{id}/edges` is the tree), group tabs for split brackets (East / West / Championship), scores and the champion once played | `sport`, `season`, `tournament-id` (pin one; otherwise `?tournament=` or the bracket in play), `refresh-interval` |
 | `<hsot-school-search>` | "Find Your School" typeahead for the right rail (standalone: fetches `GET /schools?q=` itself, no injected client) | `api`, `school-href`, `limit`, `placeholder` |
@@ -20,9 +20,25 @@ exactly one of these elements.
 The live status pill on every component reads the game clock beside the
 period when the desk has typed one ("Live · 3Q 6:54", api-hsot v1.13.0-draft).
 
-`hsot-scores` lists live games first, then matchups featuring ranked teams
-(#1 at the top, using the poll in effect on the game date), then the rest in
-schedule order.
+`hsot-scores` has two views of a date's games (DEV-1303,
+`src/lib/scoreboard.mjs`):
+
+- **All Games** (the default): one list, matchups featuring ranked teams
+  first (#1 at the top, using the poll in effect on the game date), then
+  every other game A → Z by the road team's school. The order ignores game
+  state, so the alphabetical list doesn't reshuffle as games go live and
+  final through the night.
+- **Conferences view**: grouped by conference (Nonconference, Playoffs and
+  Scrimmages as their own groups), live games first, then ranked matchups,
+  then the rest in schedule order.
+
+Area-code chips (the `areaCode` on each school profile) narrow either view
+to games where **either** school is in that area, so a 919-at-704 game shows
+under both. The chips list the codes the sport's schools carry; a school
+with no area code set matches no area. Picking a view or an area writes
+`?view=` / `?area=` back to the URL (`history.replaceState`), so a filtered
+scoreboard can be shared; the date is not written back, so a bookmarked page
+still opens on the closest matchday.
 
 Shared attributes on every data component (`hsot-school-search` takes only
 `api` and `school-href`):
@@ -119,6 +135,33 @@ That logic is `src/lib/records.mjs` and `src/lib/polls.mjs`, unit-tested with
 `node --test`. If api-hsot ever grows derived read endpoints, those two files
 are what they replace.
 
+## Sport is not gender
+
+Most sports HSOT covers are **gendered**: soccer, basketball, lacrosse, cross
+country, swimming, track and the rest field a boys and a girls team per
+school. Both teams carry the same `sport` — the side is a separate `gender`
+field on Team — and a Game carries no gender at all (it inherits one from the
+teams playing it). So **scoping a view by sport alone merges the two halves of
+the sport**, which is exactly what shipped: the standings table listed every
+school twice, once for each side, sorted into one order.
+
+Any view that stands for "the teams of a sport" therefore needs a gender too:
+
+- `src/lib/teams.mjs` holds the rule — `teamsOfGender()` for the filter,
+  `splitsByGender()` for "does this sport have two sides". The family rule
+  matches the gendered polls: a side includes coed teams, and a team with no
+  gender belongs to no side.
+- `<hsot-standings>` takes `gender`; the section sub-nav links
+  `/{sport}/{gender}/standings/` whenever the sport fields both, and an
+  un-pinned mount offers a Boys/Girls switch instead of merging.
+- `<hsot-school>` selects its tab by **team id**, not sport: two of a school's
+  tabs answer to "soccer", and its conference-place tile counts only the
+  team's own side.
+
+Records themselves are safe either way — `computeRecords()` keys off team ids,
+and a team only appears in its own side's games — so the merge shows up in the
+team **lists** a view builds, not in the numbers on a row.
+
 ## Development
 
 Requires Node 18+.

package/dist/define.mjs

@@ -1,4 +1,4 @@
-import { a as e, d as c, H as n, c as a, b as i, f as r, e as h } from "./hsot-brackets-Cc0zj07F.js";
+import { a as e, d as c, H as n, c as a, b as i, f as r, e as h } from "./hsot-brackets-D3mrvZfC.js";
 const l = {
   "hsot-scores": h,
   "hsot-standings": r,