@johnmorrisdotca/taisen-brackets 0.1.1 → 0.2.1

package/dist/matchup.d.ts

@@ -1,11 +1,14 @@
-import type { Matchup, SideId, Team, Tie, Words } from "./types.ts";
+import type { Matchup, SideId, Team, Tie } from "./types.ts";
+import { type Voice } from "./locales.ts";
 /** A bracket's teams: the list given, plus a team made from every id that a matchup names and the list does not. */
 export declare function collectTeams(matchups: readonly Matchup[], given?: readonly Team[]): Map<SideId, Team>;
 /** One matchup as a tie: sides resolved to teams, the winner and the result worked out. The round is set by the layout. */
 export declare function resolveMatchup(m: Matchup, index: number, teams: ReadonlyMap<SideId, Team>): Tie;
 /** The short name of a team for a small box. */
-export declare const abbrOf: (team: Team | null, words: Words) => string;
-/** The pieces of a note under a tie's score: "a.e.t.", "pens", "in 7", "agg.". */
-export declare function noteParts(tie: Tie, words: Words): string[];
-/** A tie in a sentence, for a tooltip, a table and a description: "Argentina 3, France 3 (a.e.t., pens 4-2). Winner: Argentina". */
-export declare function describeTie(tie: Tie, words: Words): string;
+export declare const abbrOf: (team: Team | null, v: Voice) => string;
+/** The pieces of a note under a tie's score, short: "a.e.t.", "pens", "in 7", "agg.". */
+export declare function noteParts(tie: Tie, v: Voice): string[];
+/** The notes of a tie written out, for a sentence or a table: "after extra time", "4–2 on penalties". */
+export declare function noteLong(tie: Tie, v: Voice): string[];
+/** A tie in a sentence, for a tooltip, a table and a description: "Argentina 3, France 3 (after extra time, 4–2 on penalties). Winner: Argentina". */
+export declare function describeTie(tie: Tie, v: Voice): string;

package/dist/matchup.js

@@ -1,5 +1,5 @@
 import { abbreviate } from "./text.js";
-import { fill } from "./words.js";
+import { fill } from "./locales.js";
 /** A bracket's teams: the list given, plus a team made from every id that a matchup names and the list does not. */
 export function collectTeams(matchups, given = []) {
     const teams = new Map();
@@ -34,8 +34,10 @@ function settle(m, kind) {
     const byPens = (pens) => (pens ? byScore(pens[0], pens[1]) : null);
     if (kind === "series") {
         let wins = null;
+        // A game level at the end of play but settled by a shoot-out is won by the side that won the shoot-out (MLS's best-of-three round).
+        const won = (g) => byScore(g.score[0], g.score[1]) ?? byPens(g.pens ?? null);
         if (games.length)
-            wins = [games.filter((g) => g.score[0] > g.score[1]).length, games.filter((g) => g.score[1] > g.score[0]).length];
+            wins = [games.filter((g) => won(g) === 0).length, games.filter((g) => won(g) === 1).length];
         else if (m.score)
             wins = m.score;
         const need = bestOf ? Math.ceil(bestOf / 2) : null;
@@ -98,50 +100,79 @@ export function resolveMatchup(m, index, teams) {
         date: m.date ?? m.games?.[0]?.date ?? m.legs?.[0]?.date ?? "",
         no: m.no ?? null,
         third: !!m.third,
+        walkover: !!m.walkover,
         note: m.note ?? null,
     };
 }
 /** The short name of a team for a small box. */
-export const abbrOf = (team, words) => (team ? team.abbr ?? abbreviate(team.name) : words.tbd);
-/** The pieces of a note under a tie's score: "a.e.t.", "pens", "in 7", "agg.". */
-export function noteParts(tie, words) {
+export const abbrOf = (team, v) => (team ? team.abbr ?? abbreviate(v.team(team)) : v.words.tbd);
+/** The pieces of a note under a tie's score, short: "a.e.t.", "pens", "in 7", "agg.". */
+export function noteParts(tie, v) {
     const r = tie.result;
+    const w = v.words;
     const out = [];
     if (r.kind === "series") {
         if (r.decided && r.played > 0)
-            out.push(fill(words.inGames, { n: r.played }));
+            out.push(fill(w.inGames, { n: v.number(r.played) }));
         else if (r.bestOf)
-            out.push(fill(words.bestOf, { n: r.bestOf }));
+            out.push(fill(w.bestOf, { n: v.number(r.bestOf), w: v.number(Math.ceil(r.bestOf / 2)) }));
     }
     else {
         if (r.kind === "aggregate")
-            out.push(words.aggregate);
+            out.push(w.aggregate);
         if (r.kind === "replay")
-            out.push(words.replay);
+            out.push(w.replay);
         if (r.extraTime)
-            out.push(words.aet);
+            out.push(w.aet);
         if (r.pens)
-            out.push(words.pens);
+            out.push(w.pens);
     }
+    if (tie.walkover)
+        out.push(w.walkover);
     if (tie.note)
         out.push(tie.note);
     return out;
 }
-/** A tie in a sentence, for a tooltip, a table and a description: "Argentina 3, France 3 (a.e.t., pens 4-2). Winner: Argentina". */
-export function describeTie(tie, words) {
-    const name = (t) => (t ? t.name : words.tbd);
-    const [a, b] = tie.sides;
+/** The notes of a tie written out, for a sentence or a table: "after extra time", "4–2 on penalties". */
+export function noteLong(tie, v) {
     const r = tie.result;
-    let text;
-    if (!r.score)
-        text = `${name(a)} ${words.versus} ${name(b)}`;
+    const w = v.words;
+    const out = [];
+    if (r.kind === "series") {
+        if (r.decided && r.played > 0)
+            out.push(fill(w.inGames, { n: v.number(r.played) }));
+        else if (r.bestOf)
+            out.push(fill(w.bestOf, { n: v.number(r.bestOf), w: v.number(Math.ceil(r.bestOf / 2)) }));
+    }
     else {
-        text = `${name(a)} ${r.score[0]}, ${name(b)} ${r.score[1]}`;
-        const extra = noteParts(tie, words).map((part) => (part === words.pens && r.pens ? `${words.pens} ${r.pens[0]}-${r.pens[1]}` : part));
-        if (extra.length)
-            text += ` (${extra.join(", ")})`;
+        if (r.kind === "aggregate")
+            out.push(w.aggregateLong);
+        if (r.kind === "replay")
+            out.push(w.replay);
+        if (r.extraTime)
+            out.push(w.aetLong);
+        if (r.pens)
+            out.push(fill(w.pensScore, { a: v.number(r.pens[0]), b: v.number(r.pens[1]) }));
     }
+    if (tie.walkover)
+        out.push(w.walkover);
+    if (tie.note)
+        out.push(tie.note);
+    return out;
+}
+/** A tie in a sentence, for a tooltip, a table and a description: "Argentina 3, France 3 (after extra time, 4–2 on penalties). Winner: Argentina". */
+export function describeTie(tie, v) {
+    const w = v.words;
+    const name = (t) => (t ? v.team(t) : w.tbd);
+    const [a, b] = tie.sides;
+    const r = tie.result;
+    let text = r.score
+        ? fill(w.tieScore, { a: name(a), b: name(b), sa: v.number(r.score[0]), sb: v.number(r.score[1]) })
+        : fill(w.tieVs, { a: name(a), b: name(b) });
+    const notes = noteLong(tie, v);
+    if (notes.length)
+        text += fill(w.note, { notes: notes.join(w.noteJoin) });
     if (tie.winner !== null)
-        text += `. ${words.winner}: ${name(tie.sides[tie.winner])}`;
+        text += `${w.sep}${fill(w.winnerIs, { name: name(tie.sides[tie.winner]) })}`;
     return text;
 }

package/dist/presets.d.ts

@@ -2,9 +2,9 @@
  * Playoff formats by era: the round names, the length of each round's series and who has a bye, for the five North
  * American leagues and the FIFA World Cup. Data only; nothing here draws. Each era was checked against the English
  * Wikipedia articles in its `sources` (2026-10-13); where a season did something of its own (a strike, a pandemic) it has
- * its own entry. The year is the year the playoffs are played in: the NHL's 2024 is the 2023-24 season.
+ * its own entry. The year is the year the playoffs are played in (the NHL's and the NBA's 2024 are the 2024 playoffs, of the 2023-24 season), except for the NFL, whose year is its season's: 2024 is the season played in 2024, with playoffs in January and February 2025.
  */
-export type League = "nhl" | "nba" | "mlb" | "nfl" | "cfl" | "worldcup";
+export type League = "nhl" | "nba" | "mlb" | "nfl" | "cfl" | "mls" | "worldcup";
 export interface PlayoffRound {
     /** The round's name as the league calls it. */
     name: string;

package/dist/presets.js

@@ -2,7 +2,7 @@
  * Playoff formats by era: the round names, the length of each round's series and who has a bye, for the five North
  * American leagues and the FIFA World Cup. Data only; nothing here draws. Each era was checked against the English
  * Wikipedia articles in its `sources` (2026-10-13); where a season did something of its own (a strike, a pandemic) it has
- * its own entry. The year is the year the playoffs are played in: the NHL's 2024 is the 2023-24 season.
+ * its own entry. The year is the year the playoffs are played in (the NHL's and the NBA's 2024 are the 2024 playoffs, of the 2023-24 season), except for the NFL, whose year is its season's: 2024 is the season played in 2024, with playoffs in January and February 2025.
  */
 /** The address of English Wikipedia articles, by title. */
 const wiki = (...titles) => titles.map((t) => `https://en.wikipedia.org/wiki/${t.replace(/ /g, "_")}`);
@@ -47,6 +47,9 @@ const ERAS = {
     cfl: [
         { league: "cfl", from: 1996, to: 2026, label: "division semi-finals and finals, with a crossover", teams: 6, byes: 1, groups: ["West", "East"], rounds: [r("Division Semi-Final", 1), r("Division Final", 1), r("Grey Cup", 1)], note: "Three teams of each division qualify and the first-placed team has a bye. A fourth-placed team with a better record than the third-placed team of the other division takes that place (the crossover, since 1996). The league has announced an eight-team format from 2027.", sources: wiki("1996 CFL season", "2012 CFL season", "2019 CFL season", "CFL playoffs") },
     ],
+    mls: [
+        { league: "mls", from: 2023, to: null, label: "18 teams, nine a conference: a wild card match, then best of three", teams: 18, byes: 7, groups: WEST_EAST, rounds: [r("Wild Card Round", 1), r("Round One", 3), r("Conference Semifinals", 1), r("Conference Finals", 1), r("MLS Cup", 1)], note: "The teams ranked 8th and 9th of each conference play one wild card match (settled by a shoot-out if level); the other seven teams skip it. Round One is a best-of-three series (a game level after play is settled by a shoot-out, and counts as a win); the rest are single matches. Earlier seasons had other formats and are not covered.", sources: wiki("MLS Cup Playoffs", "2024 MLS Cup Playoffs") },
+    ],
     worldcup: [
         { league: "worldcup", from: 1930, to: 1930, label: "four group winners, straight to the semi-finals", teams: 4, byes: 0, groups: null, rounds: [r("Semi-finals", 1), r("Final", 1)], years: [1930], sources: wiki("1930 FIFA World Cup") },
         { league: "worldcup", from: 1934, to: 1938, label: "16 teams, straight knockout, drawn matches replayed", teams: 16, byes: 0, groups: null, rounds: [r("Round of 16", 1), r("Quarter-finals", 1), r("Semi-finals", 1), r("Final", 1)], years: [1934, 1938], note: "A match still level after extra time was replayed (1934, 1938). There was a third-place match in both. In 1938 Austria withdrew, so 15 teams played.", sources: wiki("1934 FIFA World Cup", "FIFA World Cup") },

package/dist/render.d.ts

@@ -1,11 +1,11 @@
-import type { BracketInput, BracketLayout, DrawOptions, Matchup, Size, SizeName, Words } from "./types.ts";
+import type { BracketInput, BracketLayout, DrawOptions, Matchup, Size, SizeName } from "./types.ts";
+import { type Voice } from "./locales.ts";
 /** The sizes by name. A phone's drawing is 390 wide and as tall as the bracket needs. */
 export declare const SIZES: Readonly<Record<SizeName, Size>>;
-/** The text a screen reader gets for the drawing as a whole. */
-export declare function describeBracket(input: BracketLayout | readonly Matchup[] | BracketInput, options?: {
-    words?: Partial<Words>;
-    roundNames?: DrawOptions["roundNames"];
-}): string;
+/** The layout with each team's name in the language: what the drawing, the table and the description are written from. */
+export declare function localizedLayout(layout: BracketLayout, v: Voice): BracketLayout;
+/** The text a screen reader gets for the drawing as a whole, in the language of `locale`. */
+export declare function describeBracket(input: BracketLayout | readonly Matchup[] | BracketInput, options?: Pick<DrawOptions, "locale" | "words" | "teamName" | "roundNames">): string;
 /**
  * Draws a bracket as an SVG string. `input` is a list of matchups, `{ matchups, teams }` or a layout from `layoutBracket`.
  * The same input and options always give the same string: no clock, no random number, no counter.

package/dist/render.js

@@ -4,7 +4,7 @@ import { cleanSvg, clipId, drawMark, safeUrl } from "./marks.js";
 import { roundLabel } from "./rounds.js";
 import { styleFor } from "./theme.js";
 import { esc, fit, hash, num, textWidth } from "./text.js";
-import { fill, wordsWith } from "./words.js";
+import { fill, voiceOf } from "./locales.js";
 /** The sizes by name. A phone's drawing is 390 wide and as tall as the bracket needs. */
 export const SIZES = Object.freeze({
     wide: { width: 1200, height: 675 },
@@ -13,34 +13,41 @@ export const SIZES = Object.freeze({
 });
 const clamp = (v, lo, hi) => Math.min(hi, Math.max(lo, v));
 const isLayout = (x) => typeof x === "object" && x !== null && "ties" in x && "sides" in x && "rounds" in x;
-/** The text a screen reader gets for the drawing as a whole. */
+/** The layout with each team's name in the language: what the drawing, the table and the description are written from. */
+export function localizedLayout(layout, v) {
+    const named = new Map(layout.teams.map((t) => [t.id, { ...t, name: v.team(t) }]));
+    const swap = (t) => (t ? (named.get(t.id) ?? t) : t);
+    return { ...layout, ties: layout.ties.map((t) => ({ ...t, sides: [swap(t.sides[0]), swap(t.sides[1])] })), champion: swap(layout.champion), teams: [...named.values()] };
+}
+/** The text a screen reader gets for the drawing as a whole, in the language of `locale`. */
 export function describeBracket(input, options = {}) {
-    const layout = isLayout(input) ? input : layoutBracket(input);
-    const words = wordsWith(options.words);
-    const parts = [fill(layout.rounds === 1 ? words.summaryOne : words.summary, { n: layout.teams.length, r: layout.rounds })];
+    const v = voiceOf(options);
+    const layout = localizedLayout(isLayout(input) ? input : layoutBracket(input), v);
+    const w = v.words;
+    const parts = [fill(layout.rounds === 1 ? w.summaryOne : w.summary, { n: v.number(layout.teams.length), r: v.number(layout.rounds) })];
     const finalTie = layout.finalIndex !== null ? layout.ties[layout.finalIndex] : null;
     if (finalTie)
-        parts.push(`${roundLabel(layout, layout.rounds, options.roundNames, words)}: ${describeTie(finalTie, words)}`);
+        parts.push(fill(w.finalLine, { round: roundLabel(layout, layout.rounds, options.roundNames, v), tie: describeTie(finalTie, v) }));
     if (layout.champion)
-        parts.push(`${words.champion}: ${layout.champion.name}`);
-    return `${parts.join(". ")}.`;
+        parts.push(fill(w.championIs, { name: layout.champion.name }));
+    return `${parts.join(w.sep)}${w.end}`;
 }
 /**
  * Draws a bracket as an SVG string. `input` is a list of matchups, `{ matchups, teams }` or a layout from `layoutBracket`.
  * The same input and options always give the same string: no clock, no random number, no counter.
  */
 export function drawBracket(input, options = {}) {
-    const layout = isLayout(input) ? input : layoutBracket(input, options);
-    const words = wordsWith(options.words);
+    const v = voiceOf(options);
+    const layout = localizedLayout(isLayout(input) ? input : layoutBracket(input, options), v);
     const theme = options.theme ?? "auto";
     const sizeName = typeof options.size === "string" || options.size === undefined ? options.size ?? "wide" : null;
     const size = sizeName ? SIZES[sizeName] : { width: options.size.width, height: options.size.height ?? null };
     const orientation = options.orientation && options.orientation !== "auto" ? options.orientation : sizeName === "phone" || (size.height !== null && size.width < size.height * 0.8) ? "vertical" : "horizontal";
-    const prefix = options.id ?? `tb-${hash(JSON.stringify([layout.ties.map((t) => [t.id, t.sides.map((s) => s?.id ?? null), t.winner, t.result.score, t.round]), options.size, orientation, options.detail, theme, options.title, options.subtitle, options.seeds, options.scores, options.champion, options.markShape, options.roundLabels, options.thirdPlace, options.trophy ? 1 : 0]))}`;
+    const prefix = options.id ?? `tb-${hash(JSON.stringify([v.locale.code, layout.teams.map((t) => t.name), layout.ties.map((t) => [t.id, t.sides.map((s) => s?.id ?? null), t.winner, t.result.score, t.round]), options.size, orientation, options.detail, theme, options.title, options.subtitle, options.seeds, options.scores, options.champion, options.markShape, options.roundLabels, options.thirdPlace, options.trophy ? 1 : 0]))}`;
     const ctx = { radii: new Set(), symbols: new Map(), prefix, shape: options.markShape ?? "round" };
-    const plan = planBracket(layout, options, words, size, orientation === "vertical", ctx);
-    const drawn = plan.boxes.map((b) => drawBox(b, plan, options, words, ctx)); // draws the marks, so before the defs are written
-    const title = options.title ?? words.title;
+    const plan = planBracket(layout, options, v, size, orientation === "vertical", ctx);
+    const drawn = plan.boxes.map((b) => drawBox(b, plan, options, v, ctx)); // draws the marks, so before the defs are written
+    const title = options.title ?? v.words.title;
     const desc = describeBracket(layout, options);
     const defs = [
         ...[...ctx.radii].sort((a, b) => a - b).map((r) => `<clipPath id="${clipId(prefix, r)}"><circle r="${num(r)}"/></clipPath>`),
@@ -49,7 +56,7 @@ export function drawBracket(input, options = {}) {
     const style = theme === "none" ? "" : `<style>${styleFor(`.${prefix}`, theme)}</style>`;
     const bg = options.background === false ? "" : `<rect class="tb-bg" width="${num(plan.width)}" height="${num(plan.height)}"${theme === "none" ? ' fill="none"' : ""}/>`;
     return [
-        `<svg xmlns="http://www.w3.org/2000/svg" class="taisen ${prefix}${options.className ? ` ${esc(options.className)}` : ""}" viewBox="0 0 ${num(plan.width)} ${num(plan.height)}" width="${num(plan.width)}" height="${num(plan.height)}" style="max-width:100%;height:auto" role="img" aria-labelledby="${prefix}-t ${prefix}-d">`,
+        `<svg xmlns="http://www.w3.org/2000/svg" lang="${esc(v.locale.code)}" class="taisen ${prefix}${options.className ? ` ${esc(options.className)}` : ""}" viewBox="0 0 ${num(plan.width)} ${num(plan.height)}" width="${num(plan.width)}" height="${num(plan.height)}" style="max-width:100%;height:auto" role="img" aria-labelledby="${prefix}-t ${prefix}-d">`,
         `<title id="${prefix}-t">${esc(title)}</title><desc id="${prefix}-d">${esc(desc)}</desc>`,
         style,
         defs ? `<defs>${defs}</defs>` : "",
@@ -62,7 +69,7 @@ export function drawBracket(input, options = {}) {
     ].filter(Boolean).join("\n");
 }
 // ---------------------------------------------------------------------------------------------- the plan
-function planBracket(layout, o, words, size, vertical, ctx) {
+function planBracket(layout, o, v, size, vertical, ctx) {
     const pad = vertical ? 14 : 22;
     const showLabels = o.roundLabels ?? true;
     const poster = o.theme === "poster";
@@ -130,7 +137,11 @@ function planBracket(layout, o, words, size, vertical, ctx) {
         const rowH = h / 2;
         const font = clamp(rowH * 0.5, 8.5, 16);
         const md = clamp(rowH * 0.7, 10, 28);
-        const needed = 6 + md + 5 + longest * (font / 13) + 8 + textWidth("00", font + 1) + 14;
+        // Room for the score, and for the words some boxes carry beside it: a bye, a shoot-out's score.
+        const anyBye = layout.sides.some((sd) => sd.boxes.some((b) => b.byes.length > 0));
+        const anyPens = layout.ties.some((t) => t.result.pens !== null);
+        const extra = (anyBye ? textWidth(v.words.bye, Math.max(font - 2, 8)) + 8 : 0) + (anyPens ? textWidth("(00)", Math.max(font - 2, 8)) + 3 : 0);
+        const needed = 6 + md + 5 + longest * (font / 13) + 8 + textWidth("00", font + 1) + extra + 14;
         const named = o.detail && o.detail !== "auto" ? o.detail : w >= needed && h >= 36 ? "full" : w >= 76 && h >= 28 ? "compact" : "mark";
         return named === "mark" && o.markShape === "none" ? "compact" : named;
     };
@@ -181,24 +192,24 @@ function planBracket(layout, o, words, size, vertical, ctx) {
             for (const b of sd.boxes) {
                 const rect = place(sd.key, b);
                 rects.set(b.i, rect);
-                boxes.push({ rect, tie: layout.ties[b.i], order: b.order, bye: b.bye, final: false, champion: false });
+                boxes.push({ rect, tie: layout.ties[b.i], order: b.order, bye: b.bye, byes: b.byes, final: false, champion: false });
             }
         const midX = (halves ? starts[nc] : starts[nc] ?? 0) + (halves ? centreT : 0) / 2;
         if (halves && layout.final) {
             const fy = treeY0 + layout.final.y * rowStep + rowStep / 2;
             const rect = { x: midX - finalW / 2, y: fy - finalH / 2, w: finalW, h: finalH };
             rects.set(layout.final.i, rect);
-            boxes.push({ rect, tie: layout.ties[layout.final.i], order: layout.final.order, bye: null, final: true, champion: champ });
+            boxes.push({ rect, tie: layout.ties[layout.final.i], order: layout.final.order, bye: null, byes: [], final: true, champion: champ });
             if (showLabels)
-                texts.push(label(roundLabel(layout, layout.rounds, o.roundNames, words), midX, rect.y - 7, poster, "middle"));
+                texts.push(label(v, roundLabel(layout, layout.rounds, o.roundNames, v), midX, rect.y - 7, "middle"));
             if (champ)
-                extras.push(...championBlock(layout.champion, midX, rect.y - 22 - champH, champMark, trophyH, nameFont, o, words, ctx, poster));
+                extras.push(...championBlock(layout.champion, midX, rect.y - 22 - champH, champMark, trophyH, nameFont, o, v, ctx, poster));
             if (withThird) {
                 const t3 = layout.ties[layout.third];
                 const r3 = { x: midX - finalW / 2, y: rect.y + rect.h + 14 + 18, w: finalW, h: boxH };
                 rects.set(layout.third, r3);
-                texts.push(label(words.thirdPlace, midX, r3.y - 6, poster, "middle"));
-                boxes.push({ rect: r3, tie: t3, order: [0, 1], bye: null, final: false, champion: false });
+                texts.push(label(v, v.words.thirdPlace, midX, r3.y - 6, "middle"));
+                boxes.push({ rect: r3, tie: t3, order: [0, 1], bye: null, byes: [], final: false, champion: false });
             }
         }
         else if (!halves) {
@@ -208,17 +219,17 @@ function planBracket(layout, o, words, size, vertical, ctx) {
             if (fb && champ) {
                 const cx = starts[k] + sizes[k] / 2;
                 const fy = rects.get(fi).y + S / 2;
-                extras.push(...championBlock(layout.champion, cx, fy - champH / 2, champMark, trophyH, nameFont, o, words, ctx, poster));
+                extras.push(...championBlock(layout.champion, cx, fy - champH / 2, champMark, trophyH, nameFont, o, v, ctx, poster));
             }
         }
         if (showLabels) {
             for (const c of layout.columns) {
-                const name = roundLabel(layout, c, o.roundNames, words);
+                const name = roundLabel(layout, c, o.roundNames, v);
                 const ci = layout.columns.indexOf(c);
                 const ks = halves ? [slotOfColumn("l", ci), slotOfColumn("r", ci)] : [ci];
                 const used = layout.sides.length > 1 || !halves ? (halves ? [0, 1] : [0]) : [0];
                 ks.forEach((k, n) => { if (used.includes(n) && (!halves || n < layout.sides.length))
-                    texts.push(label(name, starts[k] + D / 2, top - 9, poster, "middle", D + gapT * 0.8)); });
+                    texts.push(label(v, name, starts[k] + D / 2, top - 9, "middle", D + gapT * 0.8)); });
             }
         }
         if (hasGroups) {
@@ -227,7 +238,7 @@ function planBracket(layout, o, words, size, vertical, ctx) {
                     return;
                 const ks = layout.columns.map((_, ci) => slotOfColumn(sd.key, ci));
                 const x0 = Math.min(...ks.map((k) => starts[k])), x1 = Math.max(...ks.map((k) => starts[k] + D));
-                texts.push(`<text class="tb-half" x="${num((x0 + x1) / 2)}" y="${num(top - (showLabels ? 36 : 14))}" font-size="${poster ? 16 : 15}" font-weight="700" letter-spacing=".1em" text-anchor="middle">${esc(poster ? sd.label.toUpperCase() : sd.label)}</text>`);
+                texts.push(`<text class="tb-half" x="${num((x0 + x1) / 2)}" y="${num(top - (showLabels ? 36 : 14))}" font-size="${poster ? 16 : 15}" font-weight="700" letter-spacing=".1em" text-anchor="middle">${esc(poster ? v.upper(sd.label) : sd.label)}</text>`);
             });
         }
         // lines
@@ -245,9 +256,9 @@ function planBracket(layout, o, words, size, vertical, ctx) {
             links.push(`<path class="tb-line" d="M${num(x0)} ${num(y0)}H${num(xm)}V${num(y1)}H${num(x1)}"${lineAttrs(o)}/>`);
         }
         if (bottomThird)
-            thirdAtFoot(layout, height - pad - extraH0 + 6, width / 2, ow, OTHER_H, words, poster, boxes, texts);
-        othersBlock(layout, others, height - pad - extraH0 + thirdBlock + 6, width, pad, ow, OTHER_H, words, poster, boxes, texts);
-        texts.push(...headings(o, width, pad, poster));
+            thirdAtFoot(layout, height - pad - extraH0 + 6, width / 2, ow, OTHER_H, v, boxes, texts);
+        othersBlock(layout, others, height - pad - extraH0 + thirdBlock + 6, width, pad, ow, OTHER_H, v, boxes, texts);
+        texts.push(...headings(v, o, width, pad, poster));
         return { width, height, boxes, links, texts, extras, detail, vertical };
     }
     // ----- vertical: the rounds are rows. The left half is the top; the final is a band in the middle.
@@ -280,32 +291,32 @@ function planBracket(layout, o, words, size, vertical, ctx) {
             const c = layout.columns.indexOf(b.round);
             const rect = { x: xOf(b.y), y: bandStart(sd.key, c), w: S, h: D };
             rects.set(b.i, rect);
-            boxes.push({ rect, tie: layout.ties[b.i], order: b.order, bye: b.bye, final: false, champion: false });
+            boxes.push({ rect, tie: layout.ties[b.i], order: b.order, bye: b.bye, byes: b.byes, final: false, champion: false });
         }
     const midX = W0 / 2;
     if (halves && layout.final) {
         const cy0 = topT + bandsPerSide * bandT;
         let y = cy0;
         if (champ)
-            extras.push(...championBlock(layout.champion, midX, pad + titleH + 4, champMark, trophyH, nameFont, o, words, ctx, poster));
+            extras.push(...championBlock(layout.champion, midX, pad + titleH + 4, champMark, trophyH, nameFont, o, v, ctx, poster));
         if (showLabels) {
-            texts.push(label(roundLabel(layout, layout.rounds, o.roundNames, words), midX, y + 12, poster, "middle"));
+            texts.push(label(v, roundLabel(layout, layout.rounds, o.roundNames, v), midX, y + 12, "middle"));
             y += 16;
         }
         const rect = { x: midX - finalW / 2, y: y + 6, w: finalW, h: finalH };
         rects.set(layout.final.i, rect);
-        boxes.push({ rect, tie: layout.ties[layout.final.i], order: layout.final.order, bye: null, final: true, champion: champ });
+        boxes.push({ rect, tie: layout.ties[layout.final.i], order: layout.final.order, bye: null, byes: [], final: true, champion: champ });
     }
     else if (!halves && champ && layout.finalIndex !== null) {
         const fr = rects.get(layout.finalIndex);
-        extras.push(...championBlock(layout.champion, fr.x + fr.w / 2, fr.y + fr.h + 12, champMark, trophyH, nameFont, o, words, ctx, poster));
+        extras.push(...championBlock(layout.champion, fr.x + fr.w / 2, fr.y + fr.h + 12, champMark, trophyH, nameFont, o, v, ctx, poster));
     }
     if (showLabels) {
         layout.columns.forEach((c, ci) => {
-            const name = roundLabel(layout, c, o.roundNames, words);
+            const name = roundLabel(layout, c, o.roundNames, v);
             const sides = halves ? (layout.sides.length > 1 ? ["l", "r"] : ["l"]) : ["l"];
             for (const sd of sides)
-                texts.push(`<text class="tb-round tb-halo" x="${num(pad)}" y="${num(bandStart(sd, ci) - 8)}" font-size="11" font-weight="600" letter-spacing=".08em">${esc(poster ? name.toUpperCase() : name.toUpperCase())}</text>`);
+                texts.push(`<text class="tb-round tb-halo" x="${num(pad)}" y="${num(bandStart(sd, ci) - 8)}" font-size="11" font-weight="600" letter-spacing=".08em">${esc(v.upper(name))}</text>`);
         });
     }
     if (hasGroups) {
@@ -313,7 +324,7 @@ function planBracket(layout, o, words, size, vertical, ctx) {
             if (!sd.label)
                 return;
             const y = sd.key === "l" ? pad + titleH + champTop + 16 : totalT - pad - 2;
-            texts.push(`<text class="tb-half" x="${num(midX)}" y="${num(y)}" font-size="14" font-weight="700" letter-spacing=".1em" text-anchor="middle">${esc(sd.label.toUpperCase())}</text>`);
+            texts.push(`<text class="tb-half" x="${num(midX)}" y="${num(y)}" font-size="14" font-weight="700" letter-spacing=".1em" text-anchor="middle">${esc(v.upper(sd.label))}</text>`);
         });
     }
     for (const t of layout.ties) {
@@ -330,9 +341,9 @@ function planBracket(layout, o, words, size, vertical, ctx) {
         links.push(`<path class="tb-line" d="M${num(x0c)} ${num(y0)}V${num(ym)}H${num(x1c)}V${num(y1)}"${lineAttrs(o)}/>`);
     }
     if (bottomThird)
-        thirdAtFoot(layout, totalT - pad + 6, W0 / 2, Math.min(W0 - 2 * pad, 200), 52, words, poster, boxes, texts);
-    othersBlock(layout, others, totalT - pad + thirdBlock + 6, W0, pad, ow, OTHER_H, words, poster, boxes, texts);
-    texts.push(...headings(o, W0, pad, poster));
+        thirdAtFoot(layout, totalT - pad + 6, W0 / 2, Math.min(W0 - 2 * pad, 200), 52, v, boxes, texts);
+    othersBlock(layout, others, totalT - pad + thirdBlock + 6, W0, pad, ow, OTHER_H, v, boxes, texts);
+    texts.push(...headings(v, o, W0, pad, poster));
     return { width: W0, height, boxes, links, texts, extras, detail, vertical };
 }
 const OTHER_H = 50;
@@ -340,16 +351,14 @@ const centreMinLtr = (d) => d * 1.1;
 function lineAttrs(o) {
     return o.theme === "none" ? ' fill="none" stroke="currentColor" stroke-opacity=".5"' : "";
 }
-function label(text, x, y, poster, anchor, maxWidth = 1e9) {
-    void poster;
-    const up = text.toUpperCase();
-    return `<text class="tb-round" x="${num(x)}" y="${num(y)}" font-size="11" font-weight="600" letter-spacing=".08em" text-anchor="${anchor}">${esc(fit(up, 11 * 1.18, maxWidth))}</text>`;
+function label(v, text, x, y, anchor, maxWidth = 1e9) {
+    return `<text class="tb-round" x="${num(x)}" y="${num(y)}" font-size="11" font-weight="600" letter-spacing=".08em" text-anchor="${anchor}">${esc(fit(v.upper(text), 11 * 1.18, maxWidth))}</text>`;
 }
-function headings(o, width, pad, poster) {
+function headings(v, o, width, pad, poster) {
     const out = [];
     let y = pad + 24;
     if (o.title) {
-        const text = poster ? o.title.toUpperCase() : o.title;
+        const text = poster ? v.upper(o.title) : o.title;
         out.push(`<text class="tb-title" x="${num(width / 2)}" y="${num(y)}" font-size="${poster ? 26 : 24}" font-weight="800" ${poster ? 'letter-spacing=".14em" ' : ""}text-anchor="middle">${esc(text)}</text>`);
         y += poster ? 24 : 22;
     }
@@ -358,7 +367,7 @@ function headings(o, width, pad, poster) {
     return out;
 }
 /** The champion, centred on `cx`, its top at `top`: a trophy if there is one, a large mark, the name and the word. */
-function championBlock(team, cx, top, mark, trophyH, nameFont, o, words, ctx, poster) {
+function championBlock(team, cx, top, mark, trophyH, nameFont, o, v, ctx, poster) {
     const out = [];
     let y = top;
     if (o.trophy && trophyH) {
@@ -375,8 +384,8 @@ function championBlock(team, cx, top, mark, trophyH, nameFont, o, words, ctx, po
     if (ctx.shape !== "none")
         out.push(`<g class="tb-champ">${drawMark(team, cx, cy, mark, ctx)}</g>`);
     const nameY = cy + mark / 2 + 8 + nameFont * 0.8;
-    out.push(`<text class="tb-name" x="${num(cx)}" y="${num(nameY)}" font-size="${num(nameFont)}" font-weight="800" text-anchor="middle">${esc(poster ? name.toUpperCase() : name)}</text>`);
-    out.push(`<text class="tb-champ-label" x="${num(cx)}" y="${num(nameY + 6 + 11)}" font-size="11" font-weight="700" letter-spacing=".16em" text-anchor="middle">${esc(words.champion.toUpperCase())}</text>`);
+    out.push(`<text class="tb-name" x="${num(cx)}" y="${num(nameY)}" font-size="${num(nameFont)}" font-weight="800" text-anchor="middle">${esc(poster ? v.upper(name) : name)}</text>`);
+    out.push(`<text class="tb-champ-label" x="${num(cx)}" y="${num(nameY + 6 + 11)}" font-size="11" font-weight="700" letter-spacing=".16em" text-anchor="middle">${esc(v.upper(v.words.champion))}</text>`);
     return out;
 }
 /** The ties that are not part of the tree (they lead nowhere near the final, or are round-robin games), drawn in a grid below it. */
@@ -389,24 +398,24 @@ function othersHeight(count, width, pad, ow, oh) {
     const cols = Math.max(1, Math.floor((width - 2 * pad + 10) / (ow + 10)));
     return 26 + Math.ceil(count / cols) * (oh + 10) + 6;
 }
-function othersBlock(layout, list, y0, width, pad, ow, oh, words, poster, boxes, texts) {
+function othersBlock(layout, list, y0, width, pad, ow, oh, v, boxes, texts) {
     if (!list.length)
         return;
     const cols = Math.max(1, Math.floor((width - 2 * pad + 10) / (ow + 10)));
     const x0 = pad + (width - 2 * pad - (Math.min(cols, list.length) * (ow + 10) - 10)) / 2;
-    texts.push(label(words.other, width / 2, y0 + 12, poster, "middle"));
+    texts.push(label(v, v.words.other, width / 2, y0 + 12, "middle"));
     list.forEach((i, n) => {
         const rect = { x: x0 + (n % cols) * (ow + 10), y: y0 + 24 + Math.floor(n / cols) * (oh + 10), w: ow, h: oh };
-        boxes.push({ rect, tie: layout.ties[i], order: [0, 1], bye: null, final: false, champion: false });
+        boxes.push({ rect, tie: layout.ties[i], order: [0, 1], bye: null, byes: [], final: false, champion: false });
     });
 }
 /** The third-place match with its label, centred on `cx`, its label at `y0`. */
-function thirdAtFoot(layout, y0, cx, w, h, words, poster, boxes, texts) {
-    texts.push(label(words.thirdPlace, cx, y0 + 12, poster, "middle"));
-    boxes.push({ rect: { x: cx - w / 2, y: y0 + 18, w, h }, tie: layout.ties[layout.third], order: [0, 1], bye: null, final: false, champion: false });
+function thirdAtFoot(layout, y0, cx, w, h, v, boxes, texts) {
+    texts.push(label(v, v.words.thirdPlace, cx, y0 + 12, "middle"));
+    boxes.push({ rect: { x: cx - w / 2, y: y0 + 18, w, h }, tie: layout.ties[layout.third], order: [0, 1], bye: null, byes: [], final: false, champion: false });
 }
 // ---------------------------------------------------------------------------------------------- one box
-function drawBox(p, plan, o, words, ctx) {
+function drawBox(p, plan, o, v, ctx) {
     const { rect, tie } = p;
     const { x, y, w, h } = rect;
     const detail = plan.detail;
@@ -416,7 +425,7 @@ function drawBox(p, plan, o, words, ctx) {
     const parts = [];
     parts.push(`<rect class="tb-box" x="${num(x)}" y="${num(y)}" width="${num(w)}" height="${num(h)}" rx="${num(Math.min(7, h / 4))}"${o.theme === "none" ? ' fill="none" stroke="currentColor" stroke-opacity=".4"' : ""}/>`);
     const r = tie.result;
-    const notes = noteParts(tie, words);
+    const notes = noteParts(tie, v);
     const noteH = detail !== "mark" && h >= 50 && notes.length ? 13 : 0;
     const rowH = (h - noteH) / 2;
     const rowsOrder = p.order;
@@ -446,19 +455,25 @@ function drawBox(p, plan, o, words, ctx) {
                 rowParts.push(drawMark(team, x + 6 + md / 2, cy, md, ctx));
                 tx = x + 6 + md + 5;
             }
-            const score = scoresOn && r.score ? String(r.score[k]) : "";
-            const pensText = scoresOn && r.pens ? `(${r.pens[k]})` : "";
-            const bye = p.bye === k;
+            const score = scoresOn && r.score ? v.number(r.score[k]) : "";
+            const pensText = scoresOn && r.pens ? `(${v.number(r.pens[k])})` : "";
+            const bye = p.byes.includes(k);
             const right = x + w - 6;
             const scoreW = score ? textWidth(score, font + 1) : 0;
             const pensW = pensText ? textWidth(pensText, font - 2) + 3 : 0;
-            const byeText = bye ? words.bye : "";
+            const seed = seedsOn && team?.seed !== undefined ? `${v.number(team.seed)} ` : "";
+            const nm = team ? (detail === "full" ? team.name : abbrOf(team, v)) : v.words.tbd;
+            // The word for a bye goes beside the score only where the name still fits beside it.
+            const byeFits = bye && right - tx - (scoreW + pensW) - (textWidth(v.words.bye, Math.max(font - 2, 8)) + 6) - 6 >= textWidth(`${seed}${nm}`, font);
+            const byeText = byeFits ? v.words.bye : "";
             const byeW = byeText ? textWidth(byeText, Math.max(font - 2, 8)) : 0;
             const avail = right - tx - (scoreW + pensW) - (byeW ? byeW + 6 : 0) - 6;
-            const seed = seedsOn && team?.seed !== undefined ? `${team.seed} ` : "";
-            const nm = team ? (detail === "full" ? team.name : abbrOf(team, words)) : words.tbd;
-            const text = fit(`${seed}${nm}`, font, Math.max(avail, 8));
-            rowParts.push(`<text class="tb-name${team ? "" : " tb-muted"}" x="${num(tx)}" y="${num(cy + font * 0.35)}" font-size="${num(font)}">${esc(text)}</text>`);
+            // A name that does not fit is set a little smaller before it is cut.
+            let nameFont = font;
+            while (nameFont > 9.5 && textWidth(`${seed}${nm}`, nameFont) > avail)
+                nameFont -= 0.5;
+            const text = fit(`${seed}${nm}`, nameFont, Math.max(avail, 8));
+            rowParts.push(`<text class="tb-name${team ? "" : " tb-muted"}" x="${num(tx)}" y="${num(cy + nameFont * 0.35)}" font-size="${num(nameFont)}">${esc(text)}</text>`);
             if (score)
                 rowParts.push(`<text class="tb-score" x="${num(right)}" y="${num(cy + (font + 1) * 0.35)}" font-size="${num(font + 1)}" text-anchor="end" font-variant-numeric="tabular-nums">${esc(score)}</text>`);
             if (pensText)
@@ -474,5 +489,5 @@ function drawBox(p, plan, o, words, ctx) {
         }
     }
     const cls2 = `tb-tie${p.final ? " tb-final" : ""}${p.champion ? " tb-has-champ" : ""}`;
-    return `<g class="${cls2}"><title>${esc(describeTie(tie, words))}</title>${parts.join("")}</g>`;
+    return `<g class="${cls2}"><title>${esc(describeTie(tie, v))}</title>${parts.join("")}</g>`;
 }

package/dist/rounds.d.ts

@@ -1,8 +1,8 @@
 import type { BracketLayout, DrawOptions } from "./types.ts";
-import type { Words } from "./types.ts";
+import { type Voice } from "./locales.ts";
 /** The name of a round that has `remaining` teams left in it, counting from the final: Final, Semi-finals, Quarter-finals, Round of 16… */
 export declare function roundName(remaining: number): string;
 /** The generic names of `count` rounds, first round first: `roundNamesFor(3)` is Quarter-finals, Semi-finals, Final. */
 export declare function roundNamesFor(count: number): string[];
 /** The name of round `round` (1 is the first) of a layout, from the names given (which may be only the last rounds) or the generic ones. */
-export declare function roundLabel(layout: BracketLayout, round: number, names: DrawOptions["roundNames"], words: Words): string;
+export declare function roundLabel(layout: BracketLayout, round: number, names: DrawOptions["roundNames"], v: Voice): string;

package/dist/rounds.js

@@ -1,4 +1,4 @@
-import { fill } from "./words.js";
+import { fill } from "./locales.js";
 /** The name of a round that has `remaining` teams left in it, counting from the final: Final, Semi-finals, Quarter-finals, Round of 16… */
 export function roundName(remaining) {
     if (remaining <= 2)
@@ -14,13 +14,13 @@ export function roundNamesFor(count) {
     return Array.from({ length: count }, (_, i) => roundName(2 ** (count - i)));
 }
 /** The name of round `round` (1 is the first) of a layout, from the names given (which may be only the last rounds) or the generic ones. */
-export function roundLabel(layout, round, names, words) {
+export function roundLabel(layout, round, names, v) {
     const list = names ? ("rounds" in names ? names.rounds.map((r) => r.name) : names) : null;
     const from = layout.rounds - round; // 0 for the final
     const named = list?.[list.length - 1 - from];
     if (named)
-        return named;
+        return v.round(named);
     const generic = 2 ** (from + 1);
     const remaining = layout.rounds > 7 ? 0 : generic;
-    return remaining ? roundName(remaining) : fill(words.round, { n: round });
+    return remaining ? v.round(roundName(remaining)) : fill(v.words.round, { n: v.number(round) });
 }

package/dist/table.d.ts

@@ -1,7 +1,5 @@
-import type { BracketInput, BracketLayout, DrawOptions, Matchup, Words } from "./types.ts";
-export interface TableOptions {
-    words?: Partial<Words>;
-    roundNames?: DrawOptions["roundNames"];
+import type { BracketInput, BracketLayout, DrawOptions, Matchup } from "./types.ts";
+export interface TableOptions extends Pick<DrawOptions, "locale" | "words" | "teamName" | "roundNames"> {
     /** The table's caption. Default: the summary ("16 teams, 4 rounds"). */
     caption?: string;
     /** A class for the `<table>`. Default `tb-table`. */
@@ -9,6 +7,7 @@ export interface TableOptions {
 }
 /**
  * The bracket as an HTML table, for a reader the drawing does not serve: one row for every tie, round by round, with the
- * two sides, the score, the winner in bold and a note. It is a plain, valid `<table>` with a caption and header cells.
+ * two sides, the score, the winner in bold, the date where the tie has one (written as the language writes dates) and a note.
+ * It is a plain, valid `<table>` with a caption and header cells, in the language of `locale`.
  */
 export declare function bracketTable(input: BracketLayout | readonly Matchup[] | BracketInput, options?: TableOptions): string;