@johnmorrisdotca/taisen-brackets 0.16.0 → 0.17.0

package/CHANGELOG.md

@@ -6,6 +6,17 @@ All notable changes to this project are written here. The format follows
 
 ## [Unreleased]
 
+## [0.17.0] - 2026-10-20
+
+Broadcast boards, step 3: the medal table.
+
+### Added
+
+- **`broadcastMedalTable({ title?, subtitle?, date?, source?, rows }, options)`**: the medal table in the manner of a television graphic, as one standalone SVG: a title band (the heading, with the date at its right), a sub bar with the three medal discs over their columns and the word total, and a row for each country or team with its rank, a 4:3 flag, its code or name (`labels`) and the gold, silver and bronze counts each beside its disc, and the total. The same source as `medalTable`, ranked and tied by the same rules (`sort`, `ties`, `top`, `skipEmpty`), so `tallyMedals` feeds it; `ranks: false`. Looks, icons, languages and `--bc-*` custom properties as for the other boards; up to 24 rows.
+- **`broadcastMedalSize(rowCount, { width })`**: the size before it is drawn: the width (1280 by default, 720 to 4000) and a height of 64 + 36 + 10 + 48 a row + 10, scaled.
+- The three boards now have a section on placing them over something: the size is read before drawing, nothing is drawn outside the panel, and the SVG scales as a picture. [docs/broadcast.md](docs/broadcast.md).
+- The demo's Broadcast boards section has the medal table, with the look, icon and width in the address.
+
 ## [0.16.0] - 2026-10-20
 
 Broadcast boards, step 2: the bout presentation board.

package/README.md

@@ -266,7 +266,7 @@ A judo contest is a tie with a `judo` result: ippon, waza-ari, yuko and shido as
 
 ## Broadcast boards
 
-`resultsBoard` draws a results board in the manner of a television graphic: a title band with an icon, a sub bar, and a row for each athlete with a rank in a box, the country code, a 4:3 flag, the name, a record badge (`OR`, `WR`, `NR`) and one or more columns of scores or times at the sport's own precision (a gymnastics final, an all-around, a swimming final, athletics, speed skating). It is one standalone SVG of a width you choose and a height that follows from the rows (`resultsBoardSize`), made to be placed over a picture, in three looks and with no mark of any games or broadcaster. `boutBoard` draws the bout presentation: the two athletes in a red and a blue band, the referee and the judges. [docs/broadcast.md](./docs/broadcast.md) · [try it in the demo](https://johnmorrisdotca.github.io/taisen-brackets/#boards)
+`resultsBoard` draws a results board in the manner of a television graphic: a title band with an icon, a sub bar, and a row for each athlete with a rank in a box, the country code, a 4:3 flag, the name, a record badge (`OR`, `WR`, `NR`) and one or more columns of scores or times at the sport's own precision (a gymnastics final, an all-around, a swimming final, athletics, speed skating). It is one standalone SVG of a width you choose and a height that follows from the rows (`resultsBoardSize`), made to be placed over a picture, in three looks and with no mark of any games or broadcaster. `boutBoard` draws the bout presentation: the two athletes in a red and a blue band, the referee and the judges. `broadcastMedalTable` draws the medal table with a disc for each medal. [docs/broadcast.md](./docs/broadcast.md) · [try it in the demo](https://johnmorrisdotca.github.io/taisen-brackets/#boards)
 
 <p align="center"><picture>
 <img alt="A results board in the blue look: a gymnastics apparatus final with a title band, a sub bar with three score columns, and eight rows with a red rank box, country code, flag, name and scores." src="https://raw.githubusercontent.com/johnmorrisdotca/taisen-brackets/main/docs/images/results-apparatus-blue.webp" width="640">
@@ -322,7 +322,7 @@ Put the string in a page (`element.innerHTML = svg`), write it to a file, or sen
 - **Judo screens for the hall**: `judoContestCard` (the category, the round, the white athlete over the blue one) and `judoMatQueue` (per mat, a big number and colour and the contests to come in order, with flags and codes), on a TV or a tablet, in five languages.
 - **Rankings**: `rankingList` draws a ranking from your data, text first: rank, flag (a country or a Canadian province), name, club, points, movement arrows, a podium, a champion row, ties and paging; `rankingNumberOnes` the number one of each category and `rankingEntryList` an event's entry list with each athlete's ranking and `rankingMatchup` a head-to-head card ([docs/rankings.md](./docs/rankings.md)).
 - **A medal table for any sport**: `medalTable` ranks countries or teams gold first or by the total, with shared ranks, flags or badges, filters by sport, weight class and Games through `tallyMedals`, and former countries as rows of their own ([docs/medals.md](./docs/medals.md)).
-- **Broadcast boards**: `resultsBoard` draws a results graphic (title band, rank boxes, 4:3 flags, record badges, columns of scores) and `boutBoard` the bout presentation (the two athletes, the referee and the judges) as a standalone SVG that follows from its rows, to place over a picture, in three looks and with no mark of any games ([docs/broadcast.md](./docs/broadcast.md)).
+- **Broadcast boards**: `resultsBoard` draws a results graphic (title band, rank boxes, 4:3 flags, record badges, columns of scores) and `boutBoard` the bout presentation (the two athletes, the referee and the judges) and `broadcastMedalTable` the medal table as a standalone SVG that follows from its rows, to place over a picture, in three looks and with no mark of any games ([docs/broadcast.md](./docs/broadcast.md)).
 - **Judo scoring**: `Matchup.judo` takes ippon, waza-ari, yuko, shido, hansoku-make, golden score and the contest time, checked against the IJF rules (`judoOutcome`); a box shows the marks, the shido cards and how the contest was won, and `judoBracket` adds the repechage and the two bronze medal contests ([docs/judo.md](./docs/judo.md)).
 - **Formats by era**: NHL, NBA, MLB, NFL, CFL, MLS and FIFA World Cup round names, series lengths and byes.
 - **Five languages**: English, French, Japanese, Spanish and German, for every word the drawing, the tooltips, the description and the table write, with the football terms of each language; countries named by `Intl` from their ISO code; numbers and dates by `Intl`. Add a language of your own.
@@ -686,7 +686,7 @@ Everything is exported from `@johnmorrisdotca/taisen-brackets`; the layout part
 - `judoOutcome(result, winner?)`, `judoBracket(athletes, options?)`, `judoPodium(input)`, `judoCategoryLabel(category, locale?)`, `JUDO_WEIGHT_CLASSES`, `judoSeconds(time)`, `judoClock(seconds)`: judo results checked against the IJF rules, the bracket with its repechage and two bronze medal contests, the medallists, a weight category as a heading ([docs/judo.md](./docs/judo.md)). `judoScoreboard(contest, options?)`, `describeJudoContest(contest, options?)`, `JUDO_BOARD_SIZES`: the scoreboard of a contest as SVG and as a sentence. `judoContestCard(contest, options?)`, `judoMatQueue(mats, options?)`, `describeJudoCard`, `describeJudoQueue`, `JUDO_MAT_COLORS`: the contest card and the mat queue board as SVG and as sentences. `judoWins(bracket, athlete, options?)`, `judoRoadPanel(source, options?)`, `describeJudoRoad`: an athlete's wins on the road to the final, and the panel. `Matchup.judo` and `Matchup.stage` (`"repechage"`, `"bronze"`) carry them into `drawBracket`.
 - `rankingList(source, options?)`, `rankingRanks(entries, options?)`, `rankingCategoryLabel(category, locale?)`, `describeRanking(source, options?)`, `BOARD_SIZES`: a ranking list as SVG, its ranks as data, a category as a heading and the drawing as a sentence. `rankingNumberOnes(source, options?)`, `describeNumberOnes`, `NUMBER_ONE_COLORS`: the number one of each category as cards. `rankingEntryList(source, options?)`, `describeEntryList`: an event's entry list with each athlete's ranking. `rankingMatchup(source, options?)`, `describeMatchup`, `matchupRecord(meetings)`: the head-to-head card of two athletes and their meetings ([docs/rankings.md](./docs/rankings.md)).
 - `medalTable(source, options?)`, `medalRanks(rows, options?)`, `tallyMedals(awards, filter?)`, `describeMedalTable(source, options?)`: a medal table as SVG, its ranks as data, a list of medals added up and filtered, and the table as a sentence ([docs/medals.md](./docs/medals.md)).
-- `resultsBoard(source, options?)`, `resultsBoardSize(rowCount, options?)`, `describeResultsBoard(source, options?)`, `BROADCAST_LOOKS`: a broadcast-style results board as a standalone SVG, its size from its rows, and the board as a sentence. `boutBoard(source, options?)`, `boutBoardSize(officialCount, options?)`, `describeBoutBoard(source, options?)`: the bout presentation board, its size and its description ([docs/broadcast.md](./docs/broadcast.md)).
+- `resultsBoard(source, options?)`, `resultsBoardSize(rowCount, options?)`, `describeResultsBoard(source, options?)`, `BROADCAST_LOOKS`: a broadcast-style results board as a standalone SVG, its size from its rows, and the board as a sentence. `boutBoard(source, options?)`, `boutBoardSize(officialCount, options?)`, `describeBoutBoard(source, options?)`: the bout presentation board, its size and its description. `broadcastMedalTable(source, options?)`, `broadcastMedalSize(rowCount, options?)`: the medal table in the broadcast style and its size ([docs/broadcast.md](./docs/broadcast.md)).
 - `playoffFormat(league, year)`, `playoffEras(league)`, `LEAGUES`: the formats by era (`nhl`, `nba`, `mlb`, `nfl`, `cfl`, `mls`, `worldcup`). `LEAGUE_EMBLEMS`: each league's default emblem id.
 - `isEmblemId(value)`, and the types `EmblemRenderer`, `EmblemRequest`, `EmblemStyle`: the trophy emblems (see "Emblems for the trophy").
 - `roundName(remaining)`, `roundNamesFor(count)`, `roundLabel(layout, round, names, words)`: round names.

package/dist/broadcast-kit.js

@@ -79,6 +79,7 @@ export function broadcastStyle(scope, look, fixed = "") {
         s(".bc-ink", `fill:${v("ink", p.ink)}`), s(".bc-sub", `fill:${v("sub", p.sub)}`),
         s(".bc-rank", `fill:${v("rank", p.rank)};stroke:${v("rank-edge", p.rankEdge)};stroke-width:1.5`), s(".bc-rankink", `fill:${v("rank-ink", p.rankInk)}`),
         s(".bc-g1", `fill:${v("gold", p.gold)};stroke:none`), s(".bc-g2", `fill:${v("silver", p.silver)};stroke:none`), s(".bc-g3", `fill:${v("bronze", p.bronze)};stroke:none`), s(".bc-medalink", `fill:${v("medal-ink", p.medalInk)}`),
+        s(".bc-discrim", "fill:none;stroke:rgba(255,255,255,.55);stroke-width:1.5"),
         s(".bc-badge", `fill:${v("badge", p.badge)}`), s(".bc-badgeink", `fill:${v("badge-ink", p.badgeInk)}`),
         s(".bc-red", `fill:${v("red", p.red)}`), s(".bc-blue", `fill:${v("blue", p.blue)}`),
         s(".bc-band", `fill:${v("band", p.band)}`), s(".bc-bandink", `fill:${v("band-ink", p.bandInk)}`),

package/dist/broadcast-medals.d.ts

@@ -0,0 +1,23 @@
+/**
+ * The medal table in the manner of a television graphic: a title band (the heading, with the date at its right), a sub bar with the three medal discs and the total over their columns, and a row
+ * for each country or team with its rank, a 4:3 flag, the country code (or the name) and the gold, silver and bronze counts, each beside its disc, and the total. The rows are ranked and tied as
+ * `medalTable` ranks them. One standalone SVG of a width you choose and a height that follows from the rows (`broadcastMedalSize`), made to be placed over a picture.
+ */
+import { type BroadcastOptions } from "./broadcast-kit.ts";
+import { type MedalTableOptions, type MedalTableSource } from "./medals.ts";
+export interface BroadcastMedalOptions extends BroadcastOptions, Pick<MedalTableOptions, "sort" | "ties" | "top" | "skipEmpty"> {
+    /** Write each row's `code` (the default where every row has one) or its `name`. */
+    labels?: "code" | "name";
+    /** Write the rank before each row. Default true. */
+    ranks?: boolean;
+}
+/** The width and the height of a broadcast medal table of `rowCount` rows: the width given (1280 by default) and a height of 64 + 36 + 10 + 48 a row + 10, in units of the width over 1280. */
+export declare function broadcastMedalSize(rowCount: number, options?: Pick<BroadcastOptions, "width">): {
+    width: number;
+    height: number;
+};
+/**
+ * The broadcast-style medal table as a standalone SVG. Throws a `RangeError` for what `medalTable` refuses, more than 24 rows after `top` and `skipEmpty`, a `labels` that is not `code` or `name`,
+ * a look or icon that is not one of its values, or a width outside 720 to 4000.
+ */
+export declare function broadcastMedalTable(source: MedalTableSource, options?: BroadcastMedalOptions): string;

package/dist/broadcast-medals.js

@@ -0,0 +1,109 @@
+/**
+ * The medal table in the manner of a television graphic: a title band (the heading, with the date at its right), a sub bar with the three medal discs and the total over their columns, and a row
+ * for each country or team with its rank, a 4:3 flag, the country code (or the name) and the gold, silver and bronze counts, each beside its disc, and the total. The rows are ranked and tied as
+ * `medalTable` ranks them. One standalone SVG of a width you choose and a height that follows from the rows (`broadcastMedalSize`), made to be placed over a picture.
+ */
+import { BC, box, broadcastFrame, broadcastWrap, bw, fitSize, gloss, panel, t, titleBand } from "./broadcast-kit.js";
+import { chosenMedalRows, describeMedalTable, validateMedalSource } from "./medals.js";
+import { drawMark } from "./marks.js";
+import { abbreviate, esc, fit, num } from "./text.js";
+const MAX_ROWS = 24;
+/** The height of a row of this table, in units of the width over 1280. */
+const ROW = 46;
+/** The width and the height of a broadcast medal table of `rowCount` rows: the width given (1280 by default) and a height of 64 + 36 + 10 + 48 a row + 10, in units of the width over 1280. */
+export function broadcastMedalSize(rowCount, options = {}) {
+    const width = options.width ?? 1280;
+    const u = width / 1280;
+    return { width, height: Math.round((BC.title + BC.sub + BC.pad + rowCount * (ROW + BC.gap) + BC.pad) * u) };
+}
+const count = (n) => n ?? 0;
+/** A medal disc: a filled circle in the medal's colour with a lighter rim and a highlight. */
+function disc(cx, cy, r, kind) {
+    return `<circle class="bc-g${kind}" cx="${num(cx)}" cy="${num(cy)}" r="${num(r)}"/><circle class="bc-discrim" cx="${num(cx)}" cy="${num(cy)}" r="${num(r * 0.72)}"/>`;
+}
+/**
+ * The broadcast-style medal table as a standalone SVG. Throws a `RangeError` for what `medalTable` refuses, more than 24 rows after `top` and `skipEmpty`, a `labels` that is not `code` or `name`,
+ * a look or icon that is not one of its values, or a width outside 720 to 4000.
+ */
+export function broadcastMedalTable(source, options = {}) {
+    const rule = { ...(options.sort !== undefined ? { sort: options.sort } : {}), ...(options.ties !== undefined ? { ties: options.ties } : {}), ...(options.top !== undefined ? { top: options.top } : {}), ...(options.skipEmpty !== undefined ? { skipEmpty: options.skipEmpty } : {}) };
+    validateMedalSource(source, rule);
+    if (options.labels !== undefined && options.labels !== "code" && options.labels !== "name")
+        throw new RangeError(`taisen-brackets: labels is "code" or "name", not ${JSON.stringify(options.labels)}`);
+    if (options.width !== undefined && options.width < 720)
+        throw new RangeError("taisen-brackets: a board's width is from 720 to 4000");
+    const rows = chosenMedalRows(source, rule);
+    if (rows.length > MAX_ROWS)
+        throw new RangeError(`taisen-brackets: a broadcast medal table has at most ${MAX_ROWS} rows (it is a screen graphic): cut the list with top`);
+    const size = broadcastMedalSize(rows.length, options);
+    const f = broadcastFrame(options, [source, options.sort, options.ties, options.top, options.skipEmpty, options.labels, options.ranks], size.height / (size.width / 1280));
+    const { W, u, v } = f;
+    const w = v.words;
+    const body = [panel(f)];
+    const title = titleBand(f, 0, source.title ?? w.medalTitle, source.date);
+    body.push(title.svg);
+    // The columns, from the right: a disc and a count for each medal, then the total.
+    const ns = 28 * u;
+    const maxMedal = Math.max(1, ...rows.map(({ row }) => Math.max(count(row.gold), count(row.silver), count(row.bronze))));
+    const maxTotal = Math.max(1, ...rows.map(({ row }) => count(row.gold) + count(row.silver) + count(row.bronze)));
+    const discR = 11 * u;
+    const medalW = discR * 2 + 12 * u + bw(v.number(maxMedal), ns) + 22 * u;
+    const totalLabel = v.upper(w.medalTotal);
+    const totalW = Math.max(bw(v.number(maxTotal), ns), bw(totalLabel, 18 * u * 1.07)) + 30 * u;
+    const right = W - 16 * u;
+    const totalX = right - totalW / 2;
+    const medalX = [0, 1, 2].map((k) => right - totalW - (2 - k) * medalW - medalW / 2);
+    const left = medalX[0] - medalW / 2;
+    // The sub bar: the subtitle at the left, the discs over their columns and the word total.
+    const sub = { svg: "", h: BC.sub * u };
+    const sy = title.h;
+    const subParts = [box(0, sy, W, sub.h, "", 0, ` fill="url(#${esc(f.scope)}-gs)"`)];
+    const fs = 20 * u;
+    const subText = v.upper(source.subtitle ?? "");
+    if (subText) {
+        const room = (left - 20 * u - 14 * u) / 1.07;
+        const z = fitSize(subText, fs, room, 0.6);
+        subParts.push(t(20 * u, sy + sub.h / 2 + z * 0.36, z, fit(subText, z, room, bw), "bc-subink", "start", 800, ' letter-spacing=".02em"'));
+    }
+    [1, 2, 3].forEach((k, i) => {
+        const name = [w.medalGold, w.medalSilver, w.medalBronze][i];
+        subParts.push(`<g class="bc-medalhead"><title>${esc(name)}</title>${disc(medalX[i] - medalW / 2 + discR + 4 * u, sy + sub.h / 2, 12 * u, k)}</g>`);
+    });
+    const tz = fitSize(totalLabel, 18 * u, (totalW - 8 * u) / 1.07, 0.6);
+    subParts.push(t(totalX, sy + sub.h / 2 + tz * 0.36, tz, fit(totalLabel, tz, (totalW - 8 * u) / 1.07, bw), "bc-subink", "middle", 800, ' letter-spacing=".02em"'));
+    body.push(subParts.join(""));
+    const top = title.h + sub.h + BC.pad * u;
+    const h = ROW * u;
+    const showRank = options.ranks ?? true;
+    const useCode = (options.labels ?? (rows.every(({ row }) => row.code) ? "code" : "name")) === "code";
+    const labelOf = (r) => (useCode ? r.code ?? abbreviate(r.name).slice(0, 3).toUpperCase() : r.name);
+    const rankTexts = rows.map(({ rank }) => String(v.number(rank)));
+    const rankW = showRank ? Math.max(...rankTexts.map((x) => bw(x, ns))) + 18 * u : 0;
+    const flagH = 28 * u, flagW = flagH * (4 / 3);
+    rows.forEach(({ row }, i) => {
+        const y = top + i * (h + BC.gap * u);
+        const cy = y + h / 2;
+        const g = [box(0, y, W, h, i % 2 === 0 ? "bc-rowa" : "bc-rowb"), gloss(f, 0, y, W, h)];
+        let x = 14 * u;
+        if (showRank) {
+            g.push(t(x + rankW / 2 - 6 * u, cy + ns * 0.36, ns * 0.9, rankTexts[i], "bc-ink", "middle", 800));
+            x += rankW;
+        }
+        g.push(drawMark({ id: `m${i}`, name: row.name, abbr: (row.code ?? abbreviate(row.name)).slice(0, 3).toUpperCase(), ...(row.flag ? { flag: row.flag } : {}), ...(row.mark ? { mark: row.mark } : {}) }, x + flagW / 2, cy, flagH, f.ctx));
+        x += flagW + 14 * u;
+        const label = labelOf(row);
+        const avail = Math.max(40 * u, left - 12 * u - x);
+        const lz = fitSize(label, 28 * u, avail, 0.6);
+        g.push(t(x, cy + lz * 0.36, lz, fit(label, lz, avail + 1, bw), "bc-ink", "start", 700));
+        [row.gold, row.silver, row.bronze].forEach((c, k) => {
+            const cx = medalX[k];
+            g.push(disc(cx - medalW / 2 + discR + 4 * u, cy, discR, (k + 1)));
+            g.push(t(cx + medalW / 2 - 14 * u, cy + ns * 0.36, ns, v.number(count(c)), "bc-ink", "end", 700));
+        });
+        g.push(t(totalX + totalW / 2 - 14 * u, cy + ns * 0.36 * 1.05, ns * 1.05, v.number(count(row.gold) + count(row.silver) + count(row.bronze)), "bc-ink", "end", 800));
+        body.push(`<g class="bc-row">${g.join("")}</g>`);
+    });
+    if (rows.length === 0)
+        body.push(t(20 * u, top + 30 * u, 24 * u, w.medalNone, "bc-sub", "start", 700));
+    return broadcastWrap(f, options.title ?? source.title ?? w.medalTitle, describeMedalTable(source, { ...rule, ...(options.locale !== undefined ? { locale: options.locale } : {}), ...(options.words !== undefined ? { words: options.words } : {}) }), body, "broadcast-medal-table");
+}

package/dist/index.d.ts

@@ -41,3 +41,5 @@ export { BROADCAST_LOOKS } from "./broadcast-kit.ts";
 export type { BroadcastIcon, BroadcastLook, BroadcastOptions } from "./broadcast-kit.ts";
 export { boutBoard, boutBoardSize, describeBoutBoard } from "./bout-board.ts";
 export type { BoutAthlete, BoutBoardOptions, BoutBoardSource, BoutOfficial } from "./bout-board.ts";
+export { broadcastMedalTable, broadcastMedalSize } from "./broadcast-medals.ts";
+export type { BroadcastMedalOptions } from "./broadcast-medals.ts";

package/dist/index.js

@@ -22,3 +22,4 @@ export { medalTable, medalRanks, tallyMedals, describeMedalTable } from "./medal
 export { resultsBoard, resultsBoardSize, describeResultsBoard } from "./results-board.js";
 export { BROADCAST_LOOKS } from "./broadcast-kit.js";
 export { boutBoard, boutBoardSize, describeBoutBoard } from "./bout-board.js";
+export { broadcastMedalTable, broadcastMedalSize } from "./broadcast-medals.js";

package/dist/medals.d.ts

@@ -76,6 +76,13 @@ export interface MedalFilter {
 export declare function tallyMedals(awards: readonly MedalAward[], filter?: MedalFilter): MedalRow[];
 /** The ranks of a list of rows, as `medalTable` draws them (`[1, 2, 2, 4]`), in the order they are drawn. */
 export declare function medalRanks(rows: readonly MedalRow[], options?: Pick<MedalTableOptions, "sort" | "ties">): number[];
+/** Checks a medal table's source and options (shared by the broadcast-style table). */
+export declare function validateMedalSource(source: MedalTableSource, options: MedalTableOptions): void;
+/** The rows that are drawn: sorted, ranked, with the empty ones and all but the top N left out when asked. */
+export declare function chosenMedalRows(source: MedalTableSource, options: Pick<MedalTableOptions, "sort" | "ties" | "skipEmpty" | "top">): {
+    row: MedalRow;
+    rank: number;
+}[];
 /** The table as a sentence, the drawing's description. */
 export declare function describeMedalTable(source: MedalTableSource, options?: Pick<MedalTableOptions, "locale" | "words" | "sort" | "ties" | "top" | "skipEmpty">): string;
 /**

package/dist/medals.js

@@ -54,7 +54,8 @@ function ordered(rows, sort, ties) {
 export function medalRanks(rows, options = {}) {
     return ordered(rows, options.sort ?? "gold", options.ties ?? true).map((x) => x.rank);
 }
-function validate(source, options) {
+/** Checks a medal table's source and options (shared by the broadcast-style table). */
+export function validateMedalSource(source, options) {
     if (!source || !Array.isArray(source.rows))
         throw new RangeError("taisen-brackets: a medal table needs a list of rows");
     source.rows.forEach((r, i) => {
@@ -79,7 +80,7 @@ function validate(source, options) {
         throw new RangeError("taisen-brackets: page is a whole number from 0");
 }
 /** The rows that are drawn: sorted, ranked, with the empty ones and all but the top N left out when asked. */
-function chosen(source, options) {
+export function chosenMedalRows(source, options) {
     let list = ordered(source.rows, options.sort ?? "gold", options.ties ?? true);
     if (options.skipEmpty)
         list = list.filter((x) => totalOf(x.row) > 0);
@@ -94,7 +95,7 @@ export function describeMedalTable(source, options = {}) {
         parts.push(source.subtitle);
     if (source.date)
         parts.push(source.date);
-    const list = chosen(source, options);
+    const list = chosenMedalRows(source, options);
     if (list.length === 0)
         parts.push(w.medalNone);
     for (const { row, rank } of list)
@@ -106,13 +107,13 @@ const teamFor = (r, id) => ({ id, name: r.name, abbr: (r.code ?? abbreviate(r.na
  * The medal table as an SVG. Throws a `RangeError` for a row with no name, a medal count that is not a whole number from 0, an option that is not one of its values, or a bad size or theme.
  */
 export function medalTable(source, options = {}) {
-    validate(source, options);
+    validateMedalSource(source, options);
     const f = boardFrame(options, [source, options.sort, options.ties, options.rankStyle, options.top, options.rows, options.page, options.columns, options.highlight, options.skipEmpty]);
     const { W, H, v } = f;
     const w = v.words;
     const unit = Math.min(W, H);
     const pad = Math.round(unit * 0.035);
-    const all = chosen(source, options);
+    const all = chosenMedalRows(source, options);
     const columns = options.columns ?? (W / H >= 1.5 && all.length > 10 ? 2 : 1);
     const head = heading(f, source.title ?? w.medalTitle, source.subtitle, source.date, pad, columns === 2 ? W - pad * 2 : Math.min(W - pad * 2, unit * 1.3), source.source);
     const body = [...head.svg];

package/dist/version.d.ts

@@ -1 +1 @@
-export declare const VERSION = "0.16.0";
+export declare const VERSION = "0.17.0";

package/dist/version.js

@@ -1 +1 @@
-export const VERSION = "0.16.0";
+export const VERSION = "0.17.0";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@johnmorrisdotca/taisen-brackets",
-  "version": "0.16.0",
+  "version": "0.17.0",
   "description": "Taisen Brackets 対戦, knockout brackets as SVG: from a list of ties (games, best-of series, two legs, replays, byes, a third-place match) it works out the rounds and halves and draws the bracket with the halves meeting at the final, or left to right, wide, square, as a tall card or for a phone, in a classic or a road look (large round flags, big scores, a team's dotted path, a link on every box), in light, dark or a gold-on-navy poster look, in eight layouts (the tree, rows, shields, a score-update card, tall columns, the NBA's play-in, a series card and group tables), on one of twenty-five poster backgrounds (the playing surfaces of five sports among them) or your own, with each team's logo or round flag, the champion in the centre, and an accessible table; and the road to the final of either finalist. NHL, NBA, MLB, NFL, CFL, MLS and World Cup formats by era, in English, French, Japanese, Spanish and German. Zero dependencies.",
   "keywords": [
     "bracket",