@wral/hsot-data 0.2.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` |
@@ -32,8 +32,10 @@ Shared attributes on every data component (`hsot-school-search` takes only
   Alternatively set the `.client` **property** to any object with the client
   method surface (see `src/lib/client.mjs`) — the demo client, a test double,
   or the future `@wral/sdk-hsot`. The property wins over the attribute.
-- `game-href`, `school-href`, `section-href` — link templates with `{sport}`,
-  `{id}` and `{view}` tokens for cross-page links. Defaults follow the
+- `game-href`, `school-href`, `section-href`, `report-href` — link templates
+  with `{sport}`, `{id}` and `{view}` tokens for cross-page links
+  (`report-href` is the "Report a Score" page, default
+  `/report-a-score/?game={id}`). Defaults follow the
   sport-first hierarchy: `/{sport}/game/{id}/`, `/school/{id}/`,
   `/{sport}/{view}/`. The site's URL space belongs to Studio publications, so
   these are overridable per mount.
@@ -88,6 +90,16 @@ so the components never know what lives there:
 
 Without slotted rail content the view renders full width, unchanged.
 
+## Reporting a score
+
+The "Report a Score" page is its own package,
+[web-components.hsot-score-report](https://bitbucket.org/cbcnm/web-components.hsot-score-report)
+(`<hsot-score-report>`), with no dependency on this one. These components
+only link to it: `hsot-boxscore` renders "Report a score for this game" and
+`hsot-scores` renders "report a score" in its toolbar, both from the
+`report-href` template (default `/report-a-score/?game={id}`; `reportHref()`
+in `src/lib/hrefs.mjs` drops the parameter when there is no game).
+
 ## Derivation lives here, for now
 
 Standings, records, streaks and rank badges are **derived client-side** from
@@ -107,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/client.mjs

@@ -0,0 +1,49 @@
+function m(l = {}) {
+  const i = Object.entries(l).filter(([, r]) => r != null && r !== "");
+  if (!i.length) return "";
+  const c = new URLSearchParams();
+  return i.forEach(([r, u]) => c.set(r, String(u))), `?${c.toString()}`;
+}
+function $({ baseUrl: l, token: i = "", fetchFn: c } = {}) {
+  if (!l) throw new Error("createClient requires a baseUrl");
+  const r = l.replace(/\/+$/, ""), u = c || ((...t) => fetch(...t));
+  async function a(t) {
+    const s = { Accept: "application/json" };
+    i && (s.Authorization = `Bearer ${i}`);
+    const n = await u(`${r}${t}`, { headers: s });
+    if (!n.ok) {
+      const o = new Error(`api-hsot ${n.status} on ${t}`);
+      throw o.status = n.status, o;
+    }
+    return n.json();
+  }
+  async function e(t, s = {}) {
+    const n = [];
+    let o = null;
+    for (let f = 0; f < 50; f += 1) {
+      const h = m(o ? { ...s, cursor: o } : s), g = await a(`${t}${h}`);
+      if (n.push(...g.items || []), o = g.nextCursor || null, !o) break;
+    }
+    return { items: n, total: n.length, nextCursor: null };
+  }
+  return {
+    listSchools: (t) => e("/schools", t),
+    getSchool: (t) => a(`/schools/${t}`),
+    listTeams: (t) => e("/teams", t),
+    getTeam: (t) => a(`/teams/${t}`),
+    listConferences: (t) => e("/conferences", t),
+    listPlayers: (t) => e("/players", t),
+    listRosters: (t) => e("/rosters", t),
+    listGames: (t) => e("/games", t),
+    getGame: (t) => a(`/games/${t}`),
+    listTournaments: (t) => e("/tournaments", t),
+    listSeedings: (t, s) => e(`/tournaments/${t}/seedings`, s),
+    listEdges: (t, s) => e(`/tournaments/${t}/edges`, s),
+    listRankings: (t) => e("/rankings", t),
+    listSports: () => a("/sports")
+  };
+}
+export {
+  $ as createClient,
+  $ as default
+};

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-D5cwGage.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,