@wral/hsot-data 0.3.0 → 0.4.0

package/README.md

@@ -10,9 +10,9 @@ 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-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` |
@@ -119,6 +119,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-Bqk0gI3J.js";
 const l = {
   "hsot-scores": h,
   "hsot-standings": r,