@johnmorrisdotca/taisen-brackets 0.1.0 → 0.2.0

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();
@@ -98,50 +98,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,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.
  */
 export type League = "nhl" | "nba" | "mlb" | "nfl" | "cfl" | "worldcup";
 export interface PlayoffRound {

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, "_")}`);

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";
@@ -190,14 +197,14 @@ function planBracket(layout, o, words, size, vertical, ctx) {
             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 });
             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"));
+                texts.push(label(v, v.words.thirdPlace, midX, r3.y - 6, "middle"));
                 boxes.push({ rect: r3, tie: t3, order: [0, 1], bye: null, final: false, champion: false });
             }
         }
@@ -208,17 +215,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 +234,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 +252,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.
@@ -287,9 +294,9 @@ function planBracket(layout, o, words, size, vertical, ctx) {
         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 };
@@ -298,14 +305,14 @@ function planBracket(layout, o, words, size, vertical, ctx) {
     }
     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 +320,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 +337,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 +347,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 +363,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 +380,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 +394,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 });
     });
 }
 /** 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"));
+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, 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 +421,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,17 +451,17 @@ 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 score = scoresOn && r.score ? v.number(r.score[k]) : "";
+            const pensText = scoresOn && r.pens ? `(${v.number(r.pens[k])})` : "";
             const bye = p.bye === 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 byeText = bye ? 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 seed = seedsOn && team?.seed !== undefined ? `${v.number(team.seed)} ` : "";
+            const nm = team ? (detail === "full" ? team.name : abbrOf(team, v)) : v.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>`);
             if (score)
@@ -474,5 +479,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;

package/dist/table.js

@@ -1,34 +1,38 @@
 import { layoutBracket } from "./layout.js";
-import { noteParts } from "./matchup.js";
+import { noteLong } from "./matchup.js";
+import { fill, voiceOf } from "./locales.js";
+import { localizedLayout } from "./render.js";
 import { roundLabel } from "./rounds.js";
 import { esc } from "./text.js";
-import { fill, wordsWith } from "./words.js";
 /**
  * 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 function bracketTable(input, options = {}) {
-    const layout = "ties" in input && "rounds" in input ? input : layoutBracket(input);
-    const words = wordsWith(options.words);
-    const caption = options.caption ?? fill(layout.rounds === 1 ? words.summaryOne : words.summary, { n: layout.teams.length, r: layout.rounds });
+    const v = voiceOf(options);
+    const layout = localizedLayout("ties" in input && "rounds" in input ? input : layoutBracket(input), v);
+    const w = v.words;
+    const caption = options.caption ?? fill(layout.rounds === 1 ? w.summaryOne : w.summary, { n: v.number(layout.teams.length), r: v.number(layout.rounds) });
     const order = layout.ties
         .filter((t) => t.round > 0 || layout.robin.includes(t.index))
         .sort((a, b) => Number(a.third) - Number(b.third) || a.round - b.round || (a.date < b.date ? -1 : a.date > b.date ? 1 : a.index - b.index));
+    const dated = order.some((t) => v.date(t.date) !== null);
     const name = (t, k) => {
         const team = t.sides[k];
-        const text = team ? esc(team.name) : esc(words.tbd);
+        const text = team ? esc(team.name) : esc(w.tbd);
         return t.winner === k ? `<strong>${text}</strong>` : text;
     };
-    const score = (t) => (t.result.score ? `${t.result.score[0]}–${t.result.score[1]}` : "");
+    const score = (t) => (t.result.score ? fill(w.scoreText, { a: v.number(t.result.score[0]), b: v.number(t.result.score[1]) }) : "");
     const rows = order.map((t) => {
-        const roundText = t.third ? words.thirdPlace : t.round === 0 ? "" : roundLabel(layout, t.round, options.roundNames, words);
-        const note = noteParts(t, words).map((part) => (part === words.pens && t.result.pens ? `${words.pens} ${t.result.pens[0]}–${t.result.pens[1]}` : part)).join(", ");
-        return `<tr><th scope="row">${esc(roundText)}</th><td>${name(t, 0)}</td><td>${esc(score(t))}</td><td>${name(t, 1)}</td><td>${esc(note)}</td></tr>`;
+        const roundText = t.third ? w.thirdPlace : t.round === 0 ? "" : roundLabel(layout, t.round, options.roundNames, v);
+        const date = dated ? `<td>${esc(v.date(t.date) ?? "")}</td>` : "";
+        return `<tr><th scope="row">${esc(roundText)}</th>${date}<td>${name(t, 0)}</td><td>${esc(score(t))}</td><td>${name(t, 1)}</td><td>${esc(noteLong(t, v).join(w.noteJoin))}</td></tr>`;
     });
     return [
-        `<table class="${esc(options.className ?? "tb-table")}">`,
+        `<table class="${esc(options.className ?? "tb-table")}" lang="${esc(v.locale.code)}">`,
         `<caption>${esc(caption)}</caption>`,
-        `<thead><tr><th scope="col">${esc(words.columnRound)}</th><th scope="col" colspan="3">${esc(words.columnTie)}</th><th scope="col">${esc(words.columnNote)}</th></tr></thead>`,
+        `<thead><tr><th scope="col">${esc(w.columnRound)}</th>${dated ? `<th scope="col">${esc(w.columnDate)}</th>` : ""}<th scope="col" colspan="3">${esc(w.columnTie)}</th><th scope="col">${esc(w.columnNote)}</th></tr></thead>`,
         `<tbody>${rows.join("")}</tbody>`,
         "</table>",
     ].join("\n");

package/dist/theme.js

@@ -4,7 +4,7 @@ export const THEMES = Object.freeze({
     dark: { bg: "#141614", ink: "#ece8dc", muted: "#9aa095", line: "#6c7168", box: "#1e211d", edge: "#3b403a", win: "#e0705a", gold: "#e0b43b", plain: "#3b403a" },
     poster: { bg: "#0a1130", ink: "#f6f1e3", muted: "#a9b2d3", line: "#d9b24c", box: "#111b47", edge: "#8e7632", win: "#f0c64a", gold: "#f0c64a", plain: "#26336b" },
 });
-const FONT = 'system-ui, -apple-system, "Segoe UI", Roboto, "Helvetica Neue", Arial, sans-serif';
+const FONT = 'system-ui, -apple-system, "Segoe UI", Roboto, "Helvetica Neue", Arial, "Hiragino Sans", "Yu Gothic UI", "Noto Sans CJK JP", Meiryo, sans-serif';
 /** The rules for one palette, each colour read from its custom property with the palette's value as the fallback. */
 function rules(p, poster, withFont) {
     const v = (name) => `var(--tb-${name}, ${p[name]})`;