@wral/hsot-data 0.1.4 → 0.1.6

package/README.md

@@ -9,13 +9,19 @@ exactly one of these elements.
 
 | Component | Page | Key attributes |
 |---|---|---|
-| `<hsot-scores>` | Scores/Schedules (the scoreboard; future dates are schedules) | `sport`, `date` (YYYY-MM-DD, default today, deep-linkable via `?date=`), `season`, `refresh-interval` |
+| `<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-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, honors | `school-id`, `sport` (initial tab, deep link `?sport=`), `season` |
 | `<hsot-boxscore>` | Game detail: line score, coverage, season context | `game-id`, `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` |
 
-Shared attributes on every component:
+`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.
+
+Shared attributes on every data component (`hsot-school-search` takes only
+`api` and `school-href`):
 
 - `api` — base URL of the api-hsot **public read surface** (tokenless):
   `https://api.highschoolot.com/hsot/v1/public`.
@@ -28,6 +34,55 @@ Shared attributes on every component:
   `/{sport}/{view}/`. The site's URL space belongs to Studio publications, so
   these are overridable per mount.
 - `refresh-interval` — milliseconds between reloads (live surfaces). 0 = off.
+- `promo-image`, `promo-href`, `promo-alt` — a sponsor banner across the top
+  of the view content. The image is required; without an href it renders
+  unlinked. Links open in a new tab with `rel="sponsored noopener"`.
+
+## The section band
+
+`hsot-scores`, `hsot-standings` and `hsot-rankings` open with the section-front
+band from the public site (`hsot-section-header`): the sport title on the dark
+red-baselined header, with the section sub-nav beneath it. The sub-nav row
+renders only when the current URL is one of the sport's general section pages —
+the component matches `location.pathname` (or a `#/…` hash route, as in the
+demo harness) against its own `section-href` template, and school or game
+detail URLs (per `school-href` / `game-href`) never qualify — so the section
+front's sub-nav persists across the data pages it links to without appearing
+on a page scoped to one team or game.
+
+The default links are Home, Scores/Schedule, Playoff Brackets, Standings
+(split into Boys/Girls when the sport's teams field both sides) and
+Polls &amp; Rankings, filled from `section-href`. To reproduce a section
+front's custom items exactly, slot the same anchors its `hsot-section-header`
+takes; `aria-current="page"` is kept in sync from the URL either way:
+
+```html
+<hsot-scores sport="football" api="…">
+  <a slot="nav" href="/football/">Football News</a>
+  <a slot="nav" href="/football/scores/">Scores/Schedules</a>
+  <a slot="nav" href="/football/rankings/">Polls &amp; Rankings</a>
+  <a slot="nav" href="/football/page/14674638/">Football Friday</a>
+</hsot-scores>
+```
+
+## The right rail
+
+Every data component accepts light-DOM children with `slot="rail"`. When any
+are present the view content and the rail share a divided two-column layout
+(300px rail at 1200px and up; stacked beneath the content below that). The
+data-page template supplies the rail units — promo, school search, ad slots —
+so the components never know what lives there:
+
+```html
+<hsot-standings sport="football" api="…"
+    promo-image="https://…/sponsor.png" promo-href="https://sponsor.example" promo-alt="Presented by …">
+  <div slot="rail">
+    <hsot-school-search api="…" school-href="/school/{id}/"></hsot-school-search>
+  </div>
+</hsot-standings>
+```
+
+Without slotted rail content the view renders full width, unchanged.
 
 ## Derivation lives here, for now
 
@@ -84,7 +139,7 @@ alias (`/hsot-data/v0/`) rather than `latest`.
 From an app:
 
 ```js
-import '@wral/hsot-data/define';           // defines all five elements
+import '@wral/hsot-data/define';           // defines all six elements
 // or
 import { HsotStandings } from '@wral/hsot-data';
 ```

package/dist/define.mjs

@@ -1,18 +1,19 @@
-import { H as e, b as n, a as c, d as i, c as a } from "./hsot-boxscore-HfW4EnqW.js";
+import { c as e, H as n, b as c, a, e as i, d as h } from "./hsot-school-search-DTqWAryB.js";
 const r = {
-  "hsot-scores": a,
+  "hsot-scores": h,
   "hsot-standings": i,
-  "hsot-rankings": c,
-  "hsot-school": n,
-  "hsot-boxscore": e
+  "hsot-rankings": a,
+  "hsot-school": c,
+  "hsot-boxscore": n,
+  "hsot-school-search": e
 };
-function f() {
+function l() {
   const s = globalThis?.customElements;
   if (s)
     for (const [o, t] of Object.entries(r))
       s.get(o) || s.define(o, t);
 }
-typeof window < "u" && globalThis.customElements && f();
+typeof window < "u" && globalThis.customElements && l();
 export {
-  f as defineAll
+  l as defineAll
 };