@johnmorrisdotca/kyogijo-stadiums 0.6.2 → 0.7.0

package/CHANGELOG.md

@@ -7,6 +7,13 @@ All notable changes to this project are written here. The format follows
 
 ## [Unreleased]
 
+## [0.7.0] - 2026-10-14
+
+### Removed
+
+- **`roadToFinal` and the road-to-the-final chart moved to [`@johnmorrisdotca/taisen-brackets`](https://www.npmjs.com/package/@johnmorrisdotca/taisen-brackets)** (0.4.0 and later; its `/road` entry), where it is built on the bracket package and shares its look. There is no shim here: import it from taisen. Gone from `@johnmorrisdotca/kyogijo-stadiums/charts`: `roadToFinal`, `ROAD_SIZES`, `KYOGIJO_ROAD_STYLE` (and from `KYOGIJO_STYLE`) and the types `RoadChart`, `RoadDecided`, `RoadFinal`, `RoadFinalist`, `RoadGroupMatch`, `RoadMatch`, `RoadOptions`, `RoadRecord`, `RoadScore`, `RoadSize`, `RoadSizeInfo` and `RoadTotals`. The `road` words are gone from `KYOGIJO_STRINGS` (a custom set of words no longer has to give them), and the docs' section, the demo's "Road to the final" section, its gallery items and its tests went with it.
+- **The round mark stays.** `Team.mark`, `markShape` and `KYOGIJO_MARK_STYLE` are for surfaces and are unchanged. The demo's section for them is now "Round marks" (a pitch wide and tall, and a badge), with its own sixteen made-up nations in `demo/nations.js`, the same flags as before.
+
 ## [0.6.2] - 2026-10-14
 
 ### Fixed

package/README.md

@@ -98,7 +98,7 @@ console.log(svg.startsWith("<svg"), svg.includes("Northern Owls 3, Lakeshore Anc
 - **Wide, tall or fit the box.** Every surface lies wide or tall: tall turns it a quarter, keeps every word upright and puts the teams top and bottom. With `orientation: "auto"` the browser helpers follow the box.
 - **Where a point lies, by the rules, and a click as a place.** `zoneAt("nhl", [69, 22], { frame: "nhl-api" })` names the zone and the area in it from the rink's, court's, pitch's, park's or field's own figures (the offensive zone and its face-off circle, the frontcourt and the corner three, the attacking third and the six-yard box, the infield and the warning track, the red zone and between the hashes), with `isThreePointer`, `inSlot`, `inPenaltyArea`, `isFair`, `overWall` and the like, and `isHomeRun(park, point, { height })` from the park's fence and wall; `clientPointToField(svg, x, y, { provider })` is a pointer's place in any of the frames, with the zone, and `fieldPointToClient` the way back. `marks: true` writes `data-mark-id`, `data-index` and `data-zone` on every mark of a layer, for one listener to link it to a table. [Zones](./docs/zones.md), [pointing](./docs/pointer.md).
 - **Goals, the strike zone and the stumps, end-on.** A goal mouth for hockey (6 by 4 feet), soccer, handball, water polo, lacrosse (6 by 6) and field hockey with the shots laid on it and its zones (the top shelf, the five-hole, the corners), the catcher's view of the strike zone with its nine and thirteen zones and the pitches numbered, and the wicket from the bowler's end with its line and length zones. [Targets](./docs/targets.md).
-- **Data on the surface.** Points, lines, arrows, text, heat maps, hexagons, zone charts and density contours over any surface, in its feet or a data provider's frame, cut to its outline, with a table for each layer; ready-made shot and pass charts, and the road to a tournament's final (`roadToFinal`: the two finalists' matches as round flags with the scores, in four sizes). [Data layers](./docs/layers.md), [charts](./docs/charts.md).
+- **Data on the surface.** Points, lines, arrows, text, heat maps, hexagons, zone charts and density contours over any surface, in its feet or a data provider's frame, cut to its outline, with a table for each layer; ready-made shot and pass charts (the road to a tournament's final moved to [`@johnmorrisdotca/taisen-brackets`](https://www.npmjs.com/package/@johnmorrisdotca/taisen-brackets), its `/road` entry). [Data layers](./docs/layers.md), [charts](./docs/charts.md).
 - **Small multiples and backgrounds.** `drawGrid` puts many drawings in one SVG, under a title and a subtitle, over a credit line, with a key they share, in a size for a social card, a square post or a phone; `background` lays a quiet pattern (felt, grass, wood, ice, paper, a grid, dots) or a photograph behind a drawing or a grid. [Layouts and backgrounds](./docs/layouts.md).
 - **Replay.** Tracking data played on any surface: the players with their numbers, the ball and its trail, and the passes, shots and goals as they happen, with controls, the keyboard and a live region, steps for a reader who prefers reduced motion, and a pause when the page is hidden. [Replay](./docs/replay.md).
 - **A 3D view.** Any surface as a floor that turns by mouse, touch, wheel or keys, with four viewpoints (overhead, broadcast, end-on, low corner) and a reset, and what the rulebook stands on it at its height: the net and antennae of volleyball, the nets of tennis, badminton, pickleball and table tennis, baskets and stanchions, rink boards and glass, goals, the posts of football, rugby, Gaelic and Australian football, stumps, a ballpark's fence, the walls of padel, squash and racquetball (cut away on the side nearest the eye), a swimming pool's blocks and flags, a diving well's boards and platforms, a water polo goal, a jump's uprights and bar, a throwing cage, the hurdles, and the padding of a skating track. Plain DOM and CSS over the same SVG, flat where 3D is not drawn. [The 3D view](./docs/turn.md).

package/dist/charts-entry.d.ts

@@ -10,6 +10,3 @@ export type { SplitRow, SplitsOptions, SplitsTotals, SwimmerSplits } from "./cha
 export { passNetwork } from "./charts.network.ts";
 export type { PassNetworkOptions, PassNetworkPass, PassNetworkTotals } from "./charts.network.ts";
 export type { Ball, Chart, ChartOptions, CurlingHeatOptions, CurlingHeatTotals, CurlingOptions, CurlingStone, CurlingStoneResult, CurlingTotals, GoalMouth, GoalMouthOptions, KeyItem, MlbSprayOptions, MlbTotals, NbaShot, NbaShotOptions, NbaTotals, NflPass, NflPassOptions, NflTotals, NhlShot, NhlShotOptions, NhlTotals, SoccerChart, SoccerShot, SoccerShotOptions, SoccerTotals, ZoneTotal } from "./charts.types.ts";
-export { ROAD_SIZES, roadToFinal } from "./road.ts";
-export { KYOGIJO_ROAD_STYLE } from "./road.style.ts";
-export type { RoadChart, RoadDecided, RoadFinal, RoadFinalist, RoadGroupMatch, RoadMatch, RoadOptions, RoadRecord, RoadScore, RoadSize, RoadSizeInfo, RoadTotals } from "./road.types.ts";

package/dist/charts-entry.js

@@ -1,4 +1,4 @@
-// The ready-made charts: shot charts, shot maps, spray charts and pass charts built on the data layers, and the road to a final.
+// The ready-made charts: shot charts, shot maps, spray charts and pass charts built on the data layers.
 export { nbaShotChart, nflPassChart, nhlShotMap } from "./charts.js";
 export { mlbSprayChart } from "./charts.baseball.js";
 export { soccerGoalMouth, soccerShotMap } from "./charts.soccer.js";
@@ -7,5 +7,3 @@ export { curlingHeat } from "./charts.curling.heat.js";
 export { CURLING_HIT_TYPES, curlingEndStats, curlingFreeGuards, curlingGuardScores, curlingHammers, curlingInPlay, curlingIsHit, curlingShotStats } from "./curling.stats.js";
 export { splitsChart } from "./charts.pool.js";
 export { passNetwork } from "./charts.network.js";
-export { ROAD_SIZES, roadToFinal } from "./road.js";
-export { KYOGIJO_ROAD_STYLE } from "./road.style.js";

package/dist/layout.js

@@ -8,7 +8,6 @@ import { drawKyogijo } from "./draw.js";
 import { el, esc, hash, num } from "./format.js";
 import { KYOGIJO_GRID_STYLE } from "./layout.style.js";
 import { KYOGIJO_MARK_STYLE } from "./mark.js";
-import { KYOGIJO_ROAD_STYLE } from "./road.style.js";
 import { isPolygon, shapePath } from "./layers.marks.js";
 import { elements, parseSvg, textOf, writeSvg } from "./scene.xml.js";
 import { KYOGIJO_STRINGS, fill } from "./strings.js";
@@ -134,7 +133,7 @@ function renamed(root, prefix) {
     return { styles };
 }
 /** The rules the package writes into a drawing, in the order it writes them: peeled off the front of a style so that each is said once however many drawings carry it. */
-const KNOWN = [KYOGIJO_BASE_STYLE, KYOGIJO_CURLING_STYLE, KYOGIJO_HEAT_STYLE, KYOGIJO_TEAM_STYLE, KYOGIJO_NOTE_STYLE, KYOGIJO_BACKGROUND_STYLE, KYOGIJO_MARK_STYLE, KYOGIJO_ROAD_STYLE];
+const KNOWN = [KYOGIJO_BASE_STYLE, KYOGIJO_CURLING_STYLE, KYOGIJO_HEAT_STYLE, KYOGIJO_TEAM_STYLE, KYOGIJO_NOTE_STYLE, KYOGIJO_BACKGROUND_STYLE, KYOGIJO_MARK_STYLE];
 /** A drawing's stylesheet as the pieces it is made of. */
 function pieces(css) {
     const out = [];

package/dist/mark.d.ts

@@ -28,7 +28,7 @@ export interface RoundMark {
     ring?: number;
     /** The mark's group is turned back by this many degrees: pass the turn of the group the mark is in to hold it upright there. The score does not use it: its mark turns with the zone's words. */
     upright?: number;
-    /** A class added to the mark's group (the road chart's `ky-r-dim` for a team that did not advance). */
+    /** A class added to the mark's group. */
     className?: string;
 }
 /** The markup of one round mark. */

package/dist/mark.js

@@ -1,5 +1,5 @@
 // The round team mark: a flag or a logo clipped to a circle with a thin ring, or, when a team has no picture, its initials on its colour. One function draws it for the
-// score on a surface (a banner at each end, the badge and the strip under a compact card) and for the road-to-the-final chart, so a country has the same mark everywhere.
+// score on a surface (a banner at each end, the badge and the strip under a compact card), so a country has the same mark everywhere.
 import { inkOn, safeColour } from "./colour.js";
 import { el, esc, num } from "./format.js";
 import { textWidth } from "./text.js";

package/dist/strings.d.ts

@@ -901,34 +901,6 @@ export interface KyogijoWords {
         cell: string;
         listSep: string;
     };
-    /**
-     * The words of the road-to-the-final chart (`roadToFinal`): its title when the caller gives none, the names of the soccer knockout rounds (any other round is named by
-     * the caller, or by its own key), how a match was decided (`ft`, `aet`, `pens` with {a} and {b}), the results, the table's headings and caption, and the summary.
-     */
-    road: {
-        title: string;
-        vs: string;
-        group: string;
-        rounds: Record<"round-of-32" | "round-of-16" | "quarter-final" | "semi-final" | "final", string>;
-        ft: string;
-        aet: string;
-        pens: string;
-        won: string;
-        lost: string;
-        drew: string;
-        tableTeam: string;
-        tableRound: string;
-        tableOpponent: string;
-        tableScore: string;
-        tableDecided: string;
-        tableResult: string;
-        caption: string;
-        name: string;
-        summary: string;
-        final: string;
-        champion: string;
-        toPlay: string;
-    };
     /** The words of a replay: its summary, its marks, what is announced when something happens, and the controls under it. */
     replay: {
         /** The first sentence of the summary: {time} is the length. */

package/dist/strings.js

@@ -414,16 +414,6 @@ export const KYOGIJO_STRINGS = {
             },
         },
         grid: { title: "A grid of drawings ({n})", drawings: "Drawings ({n}): {list}.", key: "Key: {list}.", cell: "Drawing {n} of {total}", listSep: "; " },
-        road: {
-            title: "Road to the final", vs: "v", group: "Group stage",
-            rounds: { "round-of-32": "Round of 32", "round-of-16": "Round of 16", "quarter-final": "Quarter-final", "semi-final": "Semi-final", final: "Final" },
-            ft: "FT", aet: "AET", pens: "{a}-{b} pens", won: "Won", lost: "Lost", drew: "Drew",
-            tableTeam: "Team", tableRound: "Round", tableOpponent: "Opponent", tableScore: "Score", tableDecided: "Decided", tableResult: "Result",
-            caption: "{a} and {b}: every match on the way to the final. Scores are written with the team in the first column first.",
-            name: "{a} and {b}: {title}",
-            summary: "{a} played {an} matches on the way to the final and {b} played {bn}.",
-            final: "The final: {a} {score} {b} ({how}).", champion: "{name} won the final.", toPlay: "The final is still to be played.",
-        },
         replay: {
             title: "Replay, {time}", objects: "{n} tracked objects", objectsOne: "{n} tracked object", events: "{n} events", eventsOne: "{n} event", players: "Players", others: "Ball, puck and officials", trail: "Trail of the last {s} seconds", numbers: "Shirt numbers", eventLines: "Passes and shots",
             home: "home", away: "away", ball: "ball", puck: "puck", official: "official", pass: "Pass", shot: "Shot", goal: "Goal", whistle: "Whistle",
@@ -959,16 +949,6 @@ export const KYOGIJO_STRINGS = {
             },
         },
         grid: { title: "図のグリッド（{n}枚）", drawings: "図（{n}枚）：{list}。", key: "凡例：{list}。", cell: "{total}枚中{n}枚目の図", listSep: "；" },
-        road: {
-            title: "決勝への道", vs: "対", group: "グループステージ",
-            rounds: { "round-of-32": "ラウンド32", "round-of-16": "ラウンド16", "quarter-final": "準々決勝", "semi-final": "準決勝", final: "決勝" },
-            ft: "90分", aet: "延長", pens: "PK {a}-{b}", won: "勝ち", lost: "負け", drew: "引き分け",
-            tableTeam: "チーム", tableRound: "ラウンド", tableOpponent: "対戦相手", tableScore: "スコア", tableDecided: "決着", tableResult: "結果",
-            caption: "{a}と{b}：決勝までの全試合。スコアは「チーム」列のチームの得点を先に書いています。",
-            name: "{a}と{b}：{title}",
-            summary: "{a}は決勝までに{an}試合、{b}は{bn}試合を戦いました。",
-            final: "決勝は{a} {score} {b}（{how}）でした。", champion: "{name}が優勝しました。", toPlay: "決勝はまだ行われていません。",
-        },
         replay: {
             title: "リプレイ（再生時間{time}）", objects: "追跡対象は{n}個", objectsOne: "追跡対象は{n}個", events: "イベント{n}件", eventsOne: "イベント{n}件", players: "選手", others: "ボール・パック・審判", trail: "直近{s}秒の軌跡", numbers: "背番号", eventLines: "パスとシュート",
             home: "ホーム", away: "アウェイ", ball: "ボール", puck: "パック", official: "審判", pass: "パス", shot: "シュート", goal: "ゴール", whistle: "ホイッスル",

package/dist/style.js

@@ -12,7 +12,6 @@ import { KYOGIJO_LOOK_STYLE } from "./look.js";
 import { KYOGIJO_MARK_STYLE } from "./mark.js";
 import { KYOGIJO_PAGEANT_MOTION, KYOGIJO_PAGEANT_STYLE } from "./pageant.style.js";
 import { KYOGIJO_POOL_STYLE } from "./pool.style.js";
-import { KYOGIJO_ROAD_STYLE } from "./road.style.js";
 import { KYOGIJO_SITUATION_STYLE } from "./situation.style.js";
 import { KYOGIJO_SPECIAL_STYLE } from "./special.style.js";
 /**
@@ -191,4 +190,4 @@ export const KYOGIJO_NOTE_STYLE = `
 .kyogijo .ky-an-ar{stroke:var(--c);fill:none}
 .kyogijo .ky-an-hd{fill:var(--c)}`.trim();
 /** Every rule of the package, for a page that draws with `style: "none"` and supplies the stylesheet itself. */
-export const KYOGIJO_STYLE = `${KYOGIJO_BASE_STYLE}\n${KYOGIJO_HEAT_STYLE}\n${KYOGIJO_TEAM_STYLE}\n${KYOGIJO_CURLING_STYLE}\n${KYOGIJO_FOLD_STYLE}\n${KYOGIJO_WALLS_STYLE}\n${KYOGIJO_COURTS_STYLE}\n${KYOGIJO_FIELDS_STYLE}\n${KYOGIJO_POOL_STYLE}\n${KYOGIJO_ATHLETICS_STYLE}\n${KYOGIJO_SKATING_STYLE}\n${KYOGIJO_BUDO_STYLE}\n${KYOGIJO_LOOK_STYLE}\n${KYOGIJO_HARDWOOD_STYLE}\n${KYOGIJO_TRACK_STYLE}\n${KYOGIJO_FEATURE_STYLE}\n${KYOGIJO_NOTE_STYLE}\n${KYOGIJO_SPECIAL_STYLE}\n${KYOGIJO_BACKGROUND_STYLE}\n${KYOGIJO_CROWD_STYLE}\n${KYOGIJO_GRID_STYLE}\n${KYOGIJO_MARK_STYLE}\n${KYOGIJO_PAGEANT_STYLE}\n${KYOGIJO_PAGEANT_MOTION}\n${KYOGIJO_SITUATION_STYLE}\n${KYOGIJO_ROAD_STYLE}`;
+export const KYOGIJO_STYLE = `${KYOGIJO_BASE_STYLE}\n${KYOGIJO_HEAT_STYLE}\n${KYOGIJO_TEAM_STYLE}\n${KYOGIJO_CURLING_STYLE}\n${KYOGIJO_FOLD_STYLE}\n${KYOGIJO_WALLS_STYLE}\n${KYOGIJO_COURTS_STYLE}\n${KYOGIJO_FIELDS_STYLE}\n${KYOGIJO_POOL_STYLE}\n${KYOGIJO_ATHLETICS_STYLE}\n${KYOGIJO_SKATING_STYLE}\n${KYOGIJO_BUDO_STYLE}\n${KYOGIJO_LOOK_STYLE}\n${KYOGIJO_HARDWOOD_STYLE}\n${KYOGIJO_TRACK_STYLE}\n${KYOGIJO_FEATURE_STYLE}\n${KYOGIJO_NOTE_STYLE}\n${KYOGIJO_SPECIAL_STYLE}\n${KYOGIJO_BACKGROUND_STYLE}\n${KYOGIJO_CROWD_STYLE}\n${KYOGIJO_GRID_STYLE}\n${KYOGIJO_MARK_STYLE}\n${KYOGIJO_PAGEANT_STYLE}\n${KYOGIJO_PAGEANT_MOTION}\n${KYOGIJO_SITUATION_STYLE}`;

package/dist/version.d.ts

@@ -1,2 +1,2 @@
 /** The package's version: the same as package.json's, and a test holds them to each other. */
-export declare const VERSION = "0.6.2";
+export declare const VERSION = "0.7.0";

package/dist/version.js

@@ -1,2 +1,2 @@
 /** The package's version: the same as package.json's, and a test holds them to each other. */
-export const VERSION = "0.6.2";
+export const VERSION = "0.7.0";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@johnmorrisdotca/kyogijo-stadiums",
-  "version": "0.6.2",
+  "version": "0.7.0",
   "description": "Kyogijo Stadiums 競技場, 39 sports' surfaces as SVG, drawn to scale from the rulebooks: NFL, CFL and IFAF football fields, an NHL rink, an NBA court, MLB ballparks, soccer pitches, curling sheets, athletics stadiums, speed skating, short track and figure skating rinks, swimming pools, water polo fields, diving wells, artistic swimming areas, and the courts and fields of tennis, volleyball (indoor, beach and sitting), badminton, pickleball, table tennis, padel, squash, racquetball, sepak takraw, teqball, roundnet, netball, lacrosse, rugby, Australian football, Gaelic games, cricket, field hockey and handball, and the budo of judo, karate, kendo, sumo and kyudo with a dojo of tatami laid as real units, with each team's name and logo on its side and the score in the middle, stands and a crowd, a pageant of flags, and a 3D view. Light and dark, accessible, a compact badge for lists, a helper for React and a custom element. Zero dependencies.",
   "keywords": [
     "sports",

package/dist/road.d.ts

@@ -1,26 +0,0 @@
-import type { RoadChart, RoadFinalist, RoadOptions } from "./road.types.ts";
-export { ROAD_SIZES } from "./road.draw.ts";
-/**
- * The road to the final: the two finalists as large round marks with their names at the top, each one's matches on its side (the round mark of both teams with the
- * score between them, and FT, AET or the shoot-out under it), the round names down the middle, and the group stage as a compact row of small marks, codes and scores.
- * A finalist is a team (`name`, `abbr`, `logo` for the flag or the crest, `color`) with its `path`, the matches before the final, the earliest first, and optionally its
- * `group`. A match is `{ round, opponent, score: [for, against], decidedBy, pens }`; a round is a key (`quarter-final`) with words in English and Japanese, or any
- * key you name in `labels`, so a series (`First round`, `4-2`) draws as well as a knockout. A team with no `logo` is drawn as its initials on its colour. The side that won
- * each match is brighter; the sizes are `card` (1080 by 1350), `square`, `wide` (1200 by 675) and `phone` (390 wide). `table()` lists every match as text.
- * @example
- * ```ts
- * import { roadToFinal, type RoadFinalist } from "@johnmorrisdotca/kyogijo-stadiums/charts";
- * const owls: RoadFinalist = { name: "Northern Owls", abbr: "NOW", color: "#3a2d6b", path: [
- *   { round: "quarter-final", opponent: { name: "Coastal Pines", abbr: "CPN" }, score: [2, 0] },
- *   { round: "semi-final", opponent: { name: "Valley Stars", abbr: "VAL" }, score: [1, 1], decidedBy: "pens", pens: [4, 3] },
- * ] };
- * const gulls: RoadFinalist = { name: "Harbour City Gulls", abbr: "HCG", color: "#1d4f91", path: [
- *   { round: "quarter-final", opponent: { name: "Summit Peaks", abbr: "SMT" }, score: [3, 1] },
- *   { round: "semi-final", opponent: { name: "Metro Bolts", abbr: "MTB" }, score: [2, 1], decidedBy: "aet" },
- * ] };
- * const chart = roadToFinal([owls, gulls], { title: "Northern Cup 2030", size: "square" });
- * console.log(chart.totals.rounds.join(" "), chart.draw().startsWith("<svg"), chart.table().includes("Semi-final"));
- * // quarter-final semi-final true true
- * ```
- */
-export declare function roadToFinal(finalists: readonly [RoadFinalist, RoadFinalist], options?: RoadOptions): RoadChart;

package/dist/road.draw.d.ts

@@ -1,6 +0,0 @@
-import { type Model } from "./road.model.ts";
-import type { RoadOptions, RoadSize, RoadSizeInfo } from "./road.types.ts";
-/** The sizes in pixels: `card` 1080 by 1350, `square` 1080 by 1080, `wide` 1200 by 675 and `phone` 390 wide and as tall as the rounds need. */
-export declare const ROAD_SIZES: Readonly<Record<RoadSize, RoadSizeInfo>>;
-/** Draw the chart as an SVG string. `gid` is the prefix of its ids. */
-export declare function drawRoad(model: Model, o: RoadOptions, gid: string): string;

package/dist/road.draw.js

@@ -1,270 +0,0 @@
-// The road chart, drawn: the two finalists' big round marks with their names, the round names down the middle on a dotted road, each finalist's matches on its side as
-// the round marks of both teams with the score between them, and the group stage as a compact row at the foot. Each size has its own arrangement: `card`, `square` and
-// `phone` stack the finalists over the rounds; `wide` puts them at the two ends. Nothing is measured in a browser: type is set by estimates (`textWidth`).
-import { safeColour } from "./colour.js";
-import { safeLogo } from "./logo.js";
-import { safeClass } from "./common.js";
-import { el, esc, num } from "./format.js";
-import { KYOGIJO_MARK_STYLE, roundMarkup } from "./mark.js";
-import { codeOf, decidedWords, nameOf, summaryOf } from "./road.model.js";
-import { KYOGIJO_ROAD_STYLE } from "./road.style.js";
-import { capitals, fitLines, textWidth } from "./text.js";
-import { VERSION } from "./version.js";
-/** The sizes in pixels: `card` 1080 by 1350, `square` 1080 by 1080, `wide` 1200 by 675 and `phone` 390 wide and as tall as the rounds need. */
-export const ROAD_SIZES = Object.freeze({
-    card: { width: 1080, height: 1350, about: "1080 by 1350, a tall post" },
-    square: { width: 1080, height: 1080, about: "1080 by 1080, a square post" },
-    wide: { width: 1200, height: 675, about: "1200 by 675, a wide card with the finalists at the two ends" },
-    phone: { width: 390, height: undefined, about: "390 wide, as tall as the rounds need" },
-});
-const clamp = (v, lo, hi) => Math.min(hi, Math.max(lo, v));
-/** A text centred on `y`, `size` high. */
-const text = (cls, x, y, size, content, anchor = "middle") => el("text", { class: cls, x: num(x), y: num(y + size * 0.36), "font-size": num(size), "text-anchor": anchor }, esc(content));
-/** The width of a match's score block in ems of its number size: the two numbers and the dash. */
-const scoreEms = (v) => (v.whole !== undefined ? textWidth(v.whole) : textWidth(v.mine) + textWidth(v.theirs) + 1.1);
-/** The group stage's score as one text. */
-const sub0 = (v) => v.note !== undefined ? v.note !== "" : v.says;
-const groupScore = (v) => v.whole ?? `${v.mine}–${v.theirs}`;
-/** Draw the chart as an SVG string. `gid` is the prefix of its ids. */
-export function drawRoad(model, o, gid) {
-    const size = o.size !== undefined && Object.prototype.hasOwnProperty.call(ROAD_SIZES, o.size) ? o.size : "card";
-    const info = ROAD_SIZES[size];
-    const w = model.words.road;
-    const W = info.width;
-    const phone = size === "phone";
-    const wide = size === "wide";
-    const [fa, fb] = model.finalists;
-    const rounds = [...model.rounds].reverse();
-    const R = rounds.length;
-    const nGroup = Math.max(model.group[0].length, model.group[1].length);
-    const emphasis = o.winner !== "none";
-    const codes = o.codes !== false;
-    const theme = o.theme === "light" || o.theme === "dark" ? o.theme : undefined;
-    let marks = 0;
-    const markOf = (team, cx, cy, r, cls) => roundMarkup({
-        id: `${gid}-m${marks++}`,
-        cx,
-        cy,
-        r,
-        href: safeLogo(team.logo, { color: team.color, accent: team.textColor, initials: codeOf(team).slice(0, 3), theme }),
-        fit: team.markFit === "contain" ? "contain" : undefined,
-        initials: codeOf(team).slice(0, 3),
-        color: safeColour(team.color),
-        ink: safeColour(team.textColor),
-        title: team.name,
-        className: cls,
-    });
-    // ---- The type and the room round the edge. ----
-    const tall = info.height ?? 1e9;
-    const pad = phone ? 16 : Math.round(Math.min(W * 0.045, tall * 0.05));
-    const ts = clamp(Math.min(W * 0.044, tall * 0.056), 17, 48);
-    const es = clamp(Math.min(W * 0.0185, tall * 0.022), 9, 20);
-    const room = W - 2 * pad;
-    const titleFit = fitLines(model.title, room * 0.94, ts * 2.3, ts);
-    const subSize = model.subtitle === undefined ? 0 : Math.min(ts * 0.5, (room * 0.94) / Math.max(1, textWidth(model.subtitle)));
-    const headH = titleFit.height + (model.subtitle === undefined ? 0 : subSize * 1.5) + ts * 0.45;
-    const note = o.endnote === undefined ? "" : String(o.endnote).trim();
-    const endSize = note === "" ? 0 : Math.min(es, room / Math.max(1, textWidth(note, false)));
-    const footH = endSize === 0 ? 0 : endSize * 2.4;
-    // ---- The columns: the middle one holds the rounds' names; a wide chart has a column for each finalist at its end. ----
-    const cl = phone ? 70 : wide ? W * 0.12 : W * 0.175;
-    const fc = wide ? W * 0.17 : 0;
-    const sideW = (W - 2 * pad - cl - 2 * fc) / 2;
-    const lanes = [
-        { x0: pad + fc, x1: pad + fc + sideW },
-        { x0: W - pad - fc - sideW, x1: W - pad - fc },
-    ];
-    const cx = W / 2;
-    // ---- The group stage: how many marks in a row, and how large. ----
-    const maxCols = Math.max(1, Math.floor(sideW / (phone ? 46 : W * 0.062)));
-    const cols = nGroup === 0 ? 1 : Math.min(maxCols, nGroup <= 4 ? nGroup : Math.ceil(nGroup / 2));
-    const groupRows = nGroup === 0 ? 0 : Math.ceil(nGroup / cols);
-    const cw = sideW / cols;
-    const dm = Math.min(cw * 0.56, phone ? 36 : Math.min(W * 0.052, tall * 0.065));
-    const cellH = dm * 2.08;
-    const groupBlock = nGroup === 0 ? 0 : groupRows * cellH + (groupRows - 1) * dm * 0.2 + (phone ? 26 : dm * 0.1);
-    // ---- The big marks, the rows and the vertical room. ----
-    const rowLabelH = phone ? 22 : 0;
-    let H = info.height ?? 0;
-    let D = wide ? Math.min(fc * 0.8, H * 0.36) : Math.min(sideW * 0.68, (info.height ?? 1e9) * 0.19);
-    const names = (d) => [fa, fb].map((t) => fitLines(capitals(t.name), (wide ? fc : sideW) * 0.96, d * 0.17 * 2.3, d * 0.17));
-    const slots = wide ? R + 1 : R;
-    const minRow = W * 0.085;
-    let rowH = phone ? 76 : 0;
-    let bandH = 0;
-    let regionTop = 0;
-    let regionBottom = 0;
-    const gapS = phone ? 14 : (info.height ?? 1000) * 0.016;
-    for (let attempt = 0; attempt < 6; attempt += 1) {
-        bandH = D + D * 0.08 + Math.max(...names(D).map((n) => n.height));
-        if (phone) {
-            regionTop = pad + headH + bandH + gapS;
-            regionBottom = regionTop + R * (rowH + rowLabelH);
-            H = regionBottom + (nGroup > 0 ? gapS + groupBlock : 0) + footH + pad;
-            break;
-        }
-        regionTop = pad + headH + (wide ? 0 : bandH + gapS);
-        regionBottom = H - pad - footH - (nGroup > 0 ? groupBlock + gapS : 0);
-        rowH = slots > 0 ? (regionBottom - regionTop) / slots : 0;
-        if (wide || rowH >= minRow || D < sideW * 0.25)
-            break;
-        D *= 0.86;
-    }
-    rowH = Math.min(rowH, W * 0.2);
-    // ---- The pieces of a row: the marks, the numbers, the gaps. ----
-    const subRatio = 0.42;
-    let ns = rowH * 0.34;
-    let d = rowH * 0.58;
-    let ems = 2.2;
-    for (const key of rounds) {
-        for (const i of [0, 1]) {
-            const v = model.path[i].get(key);
-            if (v !== undefined)
-                ems = Math.max(ems, scoreEms(v), textWidth(decidedWords(v, w, true), false) * subRatio);
-        }
-    }
-    const fit = Math.min(1, (sideW * 0.97) / (2 * d + 2 * d * 0.14 + ems * ns));
-    ns *= fit;
-    d *= fit;
-    const pair = 2 * d + 2 * d * 0.14 + ems * ns;
-    // The top of a row, the first being the last round. A wide chart's first slot is the final.
-    const rowTop = (i) => {
-        if (phone)
-            return regionTop + i * (rowH + rowLabelH) + rowLabelH;
-        return regionTop + (regionBottom - regionTop - slots * rowH) / 2 + (wide ? i + 1 : i) * rowH;
-    };
-    const dimOf = (result, forFinalist) => (emphasis && ((forFinalist && result === "loss") || (!forFinalist && result === "win")) ? " ky-r-dim" : "");
-    // The round's name: a panel in the middle column, or a line over the row on a phone.
-    const panel = (words, yc, height, width) => {
-        const fitted = fitLines(words, width * 0.88, height * 0.74, height * 0.54);
-        const lines = fitted.lines.map((line, i) => text("ky-r-lab", cx, yc + (i - (fitted.lines.length - 1) / 2) * fitted.size * 1.1, fitted.size, line));
-        return el("rect", { class: "ky-r-panel", x: num(cx - width / 2), y: num(yc - height / 2), width: num(width), height: num(height), rx: num(height / 2) }) + lines.join("");
-    };
-    const label = (key, yc) => {
-        const words = model.label(key);
-        if (!phone)
-            return panel(words, yc, Math.min(rowH * 0.34, cl * 0.2), cl * 0.94);
-        const y = yc - rowH / 2 - rowLabelH / 2;
-        const width = textWidth(words) * 11.5 + 20;
-        return el("rect", { class: "ky-r-panel", x: num(cx - width / 2), y: num(y - 9), width: num(width), height: 18, rx: 9 }) + text("ky-r-lab", cx, y, 11.5, words);
-    };
-    // One finalist's match in a row: the two marks and the score between them.
-    const matchMarkup = (lane, side, yc, v) => {
-        const left = v.homeFirst !== undefined ? v.homeFirst : side === 0;
-        const xc = (lane.x0 + lane.x1) / 2;
-        const y = yc - rowH * 0.04;
-        const lx = xc - pair / 2 + d / 2;
-        const rx = xc + pair / 2 - d / 2;
-        let out = markOf(model.finalists[side], left ? lx : rx, y, d / 2, `${side === 0 ? "ky-r-left" : "ky-r-right"}${dimOf(v.result, true)}`);
-        out += markOf(v.opponent, left ? rx : lx, y, d / 2, `ky-r-plain${dimOf(v.result, false)}`);
-        if (codes)
-            out += text(`ky-r-code${dimOf(v.result, false)}`, left ? rx : lx, y + d / 2 + d * 0.2, d * 0.2, codeOf(v.opponent));
-        out += scoreMarkup(v, xc, y, ns, left);
-        const sub = decidedWords(v, w, left);
-        return sub === "" ? out : out + text("ky-r-sub", xc, y + ns * 0.82, ns * subRatio, sub);
-    };
-    // The score: the two numbers either side of a dash, the loser's quiet. The first side's number is on the left when `left`.
-    const scoreMarkup = (v, x, y, n, left) => {
-        if (v.whole !== undefined)
-            return text("ky-r-n", x, y, n * 0.9, v.whole);
-        const [a, b, lowA, lowB] = left ? [v.mine, v.theirs, v.result === "loss", v.result === "win"] : [v.theirs, v.mine, v.result === "win", v.result === "loss"];
-        return (text(`ky-r-n${emphasis && lowA ? " ky-r-low" : ""}`, x - n * 0.4, y, n, a, "end") +
-            text("ky-r-dash", x, y, n * 0.8, "–") +
-            text(`ky-r-n${emphasis && lowB ? " ky-r-low" : ""}`, x + n * 0.4, y, n, b, "start"));
-    };
-    let body = "";
-    for (const [i, key] of rounds.entries()) {
-        const yc = rowTop(i) + rowH / 2;
-        body += label(key, yc);
-        for (const side of [0, 1]) {
-            const v = model.path[side].get(key);
-            if (v !== undefined)
-                body += matchMarkup(lanes[side], side, yc, v);
-        }
-    }
-    // ---- The finalists. ----
-    const final = model.final;
-    const lost = (side) => emphasis && final !== undefined && (side === 0 ? final.result === "loss" : final.result === "win");
-    const named = names(D);
-    const flagX = wide ? [pad + fc / 2, W - pad - fc / 2] : [(lanes[0].x0 + lanes[0].x1) / 2, (lanes[1].x0 + lanes[1].x1) / 2];
-    const flagY = wide ? (regionTop + regionBottom) / 2 - (D * 0.08 + Math.max(...named.map((n) => n.height))) / 2 : pad + headH + (phone ? 0 : (info.height ?? 1000) * 0.008) + D / 2;
-    let band = "";
-    for (const side of [0, 1]) {
-        const dim = lost(side) ? " ky-r-dim" : "";
-        band += markOf(model.finalists[side], flagX[side], flagY, D / 2, `${side === 0 ? "ky-r-left" : "ky-r-right"}${dim}`);
-        const nb = named[side];
-        const top = flagY + D / 2 + D * 0.08;
-        band += nb.lines.map((line, k) => text(`ky-r-name${dim}`, flagX[side], top + nb.size * 0.55 + k * nb.size * 1.1, nb.size, line)).join("");
-    }
-    // The final between them: its name over its score, or "v" when it is not played.
-    const fy = wide ? rowTop(-1) + rowH / 2 : flagY;
-    const labelSize = clamp(cl * 0.13, 9, 26);
-    const fs = wide ? Math.min(clamp(cl * 0.27, 14, 58), rowH * 0.36) : clamp(cl * 0.27, 14, 58);
-    let middle = text("ky-r-sub", cx, fy - (wide ? fs * 0.95 : Math.min(D * 0.3, cl * 0.34)), labelSize, model.label("final"));
-    if (final === undefined)
-        middle += text("ky-r-vs", cx, fy + labelSize * 0.2, fs * 0.9, w.vs);
-    else {
-        middle += scoreMarkup(final, cx, fy, fs, true);
-        const sub = decidedWords(final, w, true);
-        if (sub !== "")
-            middle += text("ky-r-sub", cx, fy + fs * 0.85, fs * 0.4, sub);
-    }
-    // ---- The road: a dotted line down the middle, behind the round names, from the final down to the group stage. ----
-    const groupTop = phone ? regionBottom + gapS : H - pad - footH - groupBlock;
-    const roadTop = wide ? fy + rowH * 0.42 : fy + (final === undefined ? labelSize * 1.6 : fs * (sub0(final) ? 1.5 : 1.0));
-    const roadEnd = nGroup > 0 ? groupTop + (phone ? 0 : cellH / 2) : R > 0 ? rowTop(R - 1) + rowH / 2 : roadTop;
-    const spine = R > 0 && roadEnd > roadTop
-        ? el("path", { class: "ky-r-spine", d: `M${num(cx)} ${num(roadTop)}V${num(roadEnd)}`, "stroke-width": num(clamp(W * 0.004, 1.5, 4)), "stroke-dasharray": `0.1 ${num(clamp(W * 0.014, 5, 16))}`, fill: "none" })
-        : "";
-    // ---- The group stage: small round marks with their codes and scores. ----
-    let groupMarkup = "";
-    if (nGroup > 0) {
-        const gy = groupTop + (phone ? 26 : 0);
-        if (phone) {
-            const width = textWidth(model.groupLabel) * 11.5 + 20;
-            groupMarkup += el("rect", { class: "ky-r-panel", x: num(cx - width / 2), y: num(groupTop + 1), width: num(width), height: 18, rx: 9 }) + text("ky-r-lab", cx, groupTop + 10, 11.5, model.groupLabel);
-        }
-        else
-            groupMarkup += panel(model.groupLabel, gy + cellH / 2, Math.min(cellH * 0.42, cl * 0.2), cl * 0.94);
-        for (const side of [0, 1]) {
-            const lane = lanes[side];
-            model.group[side].forEach((v, k) => {
-                const row = Math.floor(k / cols);
-                const inRow = Math.min(cols, model.group[side].length - row * cols);
-                const x = (lane.x0 + lane.x1) / 2 - (inRow * cw) / 2 + (k % cols) * cw + cw / 2;
-                const y = gy + row * (cellH + dm * 0.2);
-                const dim = dimOf(v.result, false);
-                groupMarkup += markOf(v.opponent, x, y + dm / 2, dm / 2, `ky-r-plain${dim}`);
-                if (codes)
-                    groupMarkup += text(`ky-r-code${dim}`, x, y + dm * 1.27, dm * 0.3, codeOf(v.opponent));
-                groupMarkup += text(`ky-r-n${emphasis && v.result === "loss" ? " ky-r-low" : ""}`, x, y + dm * 1.78, dm * 0.44, groupScore(v));
-            });
-        }
-    }
-    // ---- The head and the foot. ----
-    let head = titleFit.lines.map((line, k) => text("ky-r-t", cx, pad + titleFit.size * 0.55 + k * titleFit.size * 1.1, titleFit.size, line)).join("");
-    if (model.subtitle !== undefined)
-        head += text("ky-r-s", cx, pad + titleFit.height + subSize * 0.7, subSize, model.subtitle);
-    const foot = endSize === 0 ? "" : text("ky-r-e", cx, H - pad - endSize * 0.2, endSize, note);
-    const sheet = o.style === "none" ? "" : `${KYOGIJO_MARK_STYLE}\n${KYOGIJO_ROAD_STYLE}`;
-    const extra = safeClass(o.className);
-    return el("svg", {
-        xmlns: "http://www.w3.org/2000/svg",
-        class: `kyogijo kyogijo-road${extra === "" ? "" : ` ${extra}`}`,
-        viewBox: `0 0 ${num(W)} ${num(H)}`,
-        role: "img",
-        "aria-labelledby": `${gid}-t ${gid}-d`,
-        "data-size": size,
-        "data-theme": theme,
-        "data-version": VERSION,
-    }, `<title id="${gid}-t">${esc(nameOf(model))}</title><desc id="${gid}-d">${esc(summaryOf(model))}</desc>` +
-        (sheet === "" ? "" : `<style>${sheet}</style>`) +
-        el("rect", { class: "ky-r-bg", x: 0, y: 0, width: num(W), height: num(H) }) +
-        head +
-        spine +
-        band +
-        middle +
-        body +
-        groupMarkup +
-        foot);
-}

package/dist/road.js

@@ -1,60 +0,0 @@
-// The road-to-the-final chart: the two finalists of a tournament with the matches each played on the way, as round flags (or crests) of both teams with the score between
-// them, the rounds named down the middle, and the group stage as a compact row at the foot. The idea is that of the "road to the final" graphics that sports sites post
-// for a World Cup or a Stanley Cup; the arrangement, the type and the code are this package's own, and no one's artwork is used: the marks are the caller's flags and
-// logos, or the team's initials on its colour.
-import { withEmblems } from "./emblems-source.js";
-import { hash } from "./format.js";
-import { safeClass } from "./common.js";
-import { drawRoad } from "./road.draw.js";
-import { nameOf, readModel, summaryOf, tableOf, totalsOf } from "./road.model.js";
-import { VERSION } from "./version.js";
-export { ROAD_SIZES } from "./road.draw.js";
-const SIZES = ["card", "square", "wide", "phone"];
-/**
- * The road to the final: the two finalists as large round marks with their names at the top, each one's matches on its side (the round mark of both teams with the
- * score between them, and FT, AET or the shoot-out under it), the round names down the middle, and the group stage as a compact row of small marks, codes and scores.
- * A finalist is a team (`name`, `abbr`, `logo` for the flag or the crest, `color`) with its `path`, the matches before the final, the earliest first, and optionally its
- * `group`. A match is `{ round, opponent, score: [for, against], decidedBy, pens }`; a round is a key (`quarter-final`) with words in English and Japanese, or any
- * key you name in `labels`, so a series (`First round`, `4-2`) draws as well as a knockout. A team with no `logo` is drawn as its initials on its colour. The side that won
- * each match is brighter; the sizes are `card` (1080 by 1350), `square`, `wide` (1200 by 675) and `phone` (390 wide). `table()` lists every match as text.
- * @example
- * ```ts
- * import { roadToFinal, type RoadFinalist } from "@johnmorrisdotca/kyogijo-stadiums/charts";
- * const owls: RoadFinalist = { name: "Northern Owls", abbr: "NOW", color: "#3a2d6b", path: [
- *   { round: "quarter-final", opponent: { name: "Coastal Pines", abbr: "CPN" }, score: [2, 0] },
- *   { round: "semi-final", opponent: { name: "Valley Stars", abbr: "VAL" }, score: [1, 1], decidedBy: "pens", pens: [4, 3] },
- * ] };
- * const gulls: RoadFinalist = { name: "Harbour City Gulls", abbr: "HCG", color: "#1d4f91", path: [
- *   { round: "quarter-final", opponent: { name: "Summit Peaks", abbr: "SMT" }, score: [3, 1] },
- *   { round: "semi-final", opponent: { name: "Metro Bolts", abbr: "MTB" }, score: [2, 1], decidedBy: "aet" },
- * ] };
- * const chart = roadToFinal([owls, gulls], { title: "Northern Cup 2030", size: "square" });
- * console.log(chart.totals.rounds.join(" "), chart.draw().startsWith("<svg"), chart.table().includes("Semi-final"));
- * // quarter-final semi-final true true
- * ```
- */
-export function roadToFinal(finalists, options = {}) {
-    if (typeof options !== "object" || options === null)
-        throw new TypeError("options is an object");
-    const check = (o) => {
-        if (o.size !== undefined && !SIZES.includes(o.size))
-            throw new RangeError(`Unknown size "${String(o.size)}": use one of ${SIZES.join(", ")}`);
-    };
-    check(options);
-    const model = readModel(finalists, options);
-    const build = (extra = {}) => {
-        const merged = { ...options, ...extra };
-        check(merged);
-        const m = readModel(finalists, merged);
-        const gid = safeClass(merged.id).replace(/ /g, "-") || `kr-${hash(JSON.stringify([finalists, merged, VERSION]))}`;
-        return withEmblems(merged.emblems, () => drawRoad(m, merged, gid));
-    };
-    return {
-        options: { ...options },
-        title: nameOf(model),
-        summary: summaryOf(model),
-        totals: totalsOf(model),
-        draw: build,
-        table: (tableOptions = {}) => tableOf(tableOptions.language === undefined ? model : readModel(finalists, { ...options, language: tableOptions.language }), tableOptions),
-    };
-}

package/dist/road.model.d.ts

@@ -1,63 +0,0 @@
-import { type KyogijoWords } from "./strings.ts";
-import type { RoadDecided, RoadFinalist, RoadOptions, RoadTotals } from "./road.types.ts";
-import type { Language, Team } from "./types.ts";
-/** Who won a match, from the finalist's side. `unknown` when the score is not a pair of numbers. */
-export type Result = "win" | "loss" | "draw" | "unknown";
-/** A match as it is drawn: the two scores written, who won, and how it was decided. */
-export interface MatchView {
-    /** The round's key; empty for a match of the group stage. */
-    round: string;
-    opponent: Team;
-    /** The finalist's score and the opponent's, written. For a score that is one text that could not be split, `whole` is that text and the two are empty. */
-    mine: string;
-    theirs: string;
-    whole?: string;
-    result: Result;
-    decided: RoadDecided;
-    pens?: [string, string];
-    /** The words that replace the usual ones under the score, or undefined. */
-    note?: string;
-    /** Whether the usual words (FT, AET, the shoot-out) are written: always for a knockout match, only when asked for a group match. */
-    says: boolean;
-    homeFirst?: boolean;
-}
-/** The chart's data, ready to draw. */
-export interface Model {
-    language: Language;
-    words: KyogijoWords;
-    finalists: [Team, Team];
-    /** The matches of the group stage, for each finalist. */
-    group: [MatchView[], MatchView[]];
-    /** The knockout matches for each finalist, by round key. */
-    path: [Map<string, MatchView>, Map<string, MatchView>];
-    /** The rounds, the earliest first. */
-    rounds: string[];
-    /** The final, if played: the scores of the first finalist and the second. */
-    final?: MatchView;
-    label(key: string): string;
-    groupLabel: string;
-    title: string;
-    subtitle: string | undefined;
-}
-/** A number from a number or from text that is one, else undefined. */
-export declare function numeric(value: unknown): number | undefined;
-/** The rounds of two paths, the earliest first: a round both have is once, and a round only one has stays after the round before it. */
-export declare function mergeRounds(paths: readonly (readonly string[])[]): string[];
-/** Read and check what `roadToFinal` was given. */
-export declare function readModel(finalists: readonly RoadFinalist[], options: RoadOptions): Model;
-/** The words under a score: FT, AET or the shoot-out (the first side's numbers first), a note in their place, or nothing. */
-export declare function decidedWords(view: MatchView, w: KyogijoWords["road"], mineFirst: boolean): string;
-/** The score of a match as one text, the first side's first. */
-export declare function scoreText(view: MatchView, mineFirst?: boolean): string;
-/** The abbreviation written under a mark: the team's own, else made from its name. */
-export declare function codeOf(team: Team): string;
-/** The numbers behind the chart. */
-export declare function totalsOf(model: Model): RoadTotals;
-/** The chart's accessible name. */
-export declare function nameOf(model: Model): string;
-/** What the chart shows, in a sentence or two. */
-export declare function summaryOf(model: Model): string;
-/** One HTML table with a row for every match: the group stage, the knockout rounds in order, and the final. */
-export declare function tableOf(model: Model, options?: {
-    className?: string;
-}): string;

package/dist/road.model.js

@@ -1,215 +0,0 @@
-// The road chart's data, read and checked: the scores split into the two sides, who won each match, the words under each score, the rounds in the order played, and
-// the sentences and the table that say the same in words. Nothing here draws.
-import { esc } from "./format.js";
-import { safeClass } from "./common.js";
-import { KYOGIJO_STRINGS, fill } from "./strings.js";
-import { abbreviate } from "./text.js";
-const own = (object, key) => object !== undefined && Object.prototype.hasOwnProperty.call(object, key);
-/** A number from a number or from text that is one, else undefined. */
-export function numeric(value) {
-    if (typeof value === "number")
-        return Number.isFinite(value) ? value : undefined;
-    if (typeof value === "string" && /^\s*-?\d+(?:\.\d+)?\s*$/.test(value))
-        return Number(value);
-    return undefined;
-}
-const written = (value) => (value === undefined || value === null ? "" : String(value).trim());
-/** The two sides of a score. */
-function split(score) {
-    if (Array.isArray(score) && score.length === 2)
-        return { mine: written(score[0]), theirs: written(score[1]) };
-    const text = written(score);
-    const parts = /^(\S+?)\s*[-–—:]\s*(\S+)$/.exec(text);
-    if (parts !== null)
-        return { mine: parts[1], theirs: parts[2] };
-    return { mine: "", theirs: "", whole: text };
-}
-function resultOf(mine, theirs, pens) {
-    const a = numeric(mine);
-    const b = numeric(theirs);
-    if (a === undefined || b === undefined)
-        return "unknown";
-    if (a !== b)
-        return a > b ? "win" : "loss";
-    const p = pens === undefined ? undefined : [numeric(pens[0]), numeric(pens[1])];
-    if (p !== undefined && p[0] !== undefined && p[1] !== undefined && p[0] !== p[1])
-        return p[0] > p[1] ? "win" : "loss";
-    return "draw";
-}
-function pensOf(value) {
-    return Array.isArray(value) && value.length === 2 && written(value[0]) !== "" && written(value[1]) !== "" ? [written(value[0]), written(value[1])] : undefined;
-}
-function viewOf(m, opponent, round, knockout) {
-    const { mine, theirs, whole } = split(m.score);
-    const pens = pensOf(m.pens);
-    const decided = m.decidedBy === "aet" || m.decidedBy === "pens" || m.decidedBy === "ft" ? m.decidedBy : pens !== undefined ? "pens" : "ft";
-    const note = typeof m.note === "string" ? m.note.trim() : undefined;
-    return {
-        round,
-        opponent,
-        mine,
-        theirs,
-        ...(whole === undefined ? {} : { whole }),
-        result: resultOf(mine, theirs, pens),
-        decided,
-        ...(pens === undefined ? {} : { pens }),
-        ...(note === undefined ? {} : { note }),
-        says: knockout || m.decidedBy !== undefined || pens !== undefined,
-        ...("homeFirst" in m && typeof m.homeFirst === "boolean" ? { homeFirst: m.homeFirst } : {}),
-    };
-}
-/** The rounds of two paths, the earliest first: a round both have is once, and a round only one has stays after the round before it. */
-export function mergeRounds(paths) {
-    const out = [];
-    for (const path of paths) {
-        let at = 0;
-        for (const key of path) {
-            const found = out.indexOf(key);
-            if (found >= 0)
-                at = found + 1;
-            else {
-                out.splice(at, 0, key);
-                at += 1;
-            }
-        }
-    }
-    return out;
-}
-const isTeam = (value) => typeof value === "object" && value !== null && !Array.isArray(value) && typeof value.name === "string";
-/** Read and check what `roadToFinal` was given. */
-export function readModel(finalists, options) {
-    if (!Array.isArray(finalists) || finalists.length !== 2)
-        throw new TypeError("roadToFinal takes the two finalists as a list of two teams, each with a path");
-    const language = options.language === "ja" ? "ja" : "en";
-    const words = KYOGIJO_STRINGS[language];
-    const w = words.road;
-    const teams = finalists;
-    for (const [i, f] of teams.entries()) {
-        if (!isTeam(f))
-            throw new TypeError(`Finalist ${i + 1} is a team with a name`);
-        if (!Array.isArray(f.path))
-            throw new TypeError(`Finalist ${i + 1} (${f.name}) needs a path: the list of its matches before the final`);
-        if (f.group !== undefined && !Array.isArray(f.group))
-            throw new TypeError(`The group of ${f.name} is a list of matches`);
-        for (const m of [...f.path, ...(f.group ?? [])]) {
-            if (typeof m !== "object" || m === null || !isTeam(m.opponent) || m.score === undefined || m.score === null)
-                throw new TypeError(`Every match of ${f.name} has an opponent (a team with a name) and a score`);
-        }
-        for (const m of f.path)
-            if (typeof m.round !== "string" || m.round.trim() === "")
-                throw new TypeError(`Every match of the path of ${f.name} has a round`);
-    }
-    const path = teams.map((f) => {
-        const map = new Map();
-        for (const m of f.path)
-            map.set(m.round.trim(), viewOf(m, m.opponent, m.round.trim(), true));
-        return map;
-    });
-    const group = teams.map((f) => (f.group ?? []).map((m) => viewOf(m, m.opponent, "", false)));
-    const rounds = mergeRounds(teams.map((f) => f.path.map((m) => m.round.trim())));
-    const labels = options.labels;
-    const model = {
-        language,
-        words,
-        finalists: teams,
-        group,
-        path,
-        rounds,
-        label: (key) => (own(labels, key) && typeof labels?.[key] === "string" ? labels[key] : own(w.rounds, key) ? w.rounds[key] : key),
-        groupLabel: typeof options.groupLabel === "string" && options.groupLabel.trim() !== "" ? options.groupLabel.trim() : w.group,
-        title: typeof options.title === "string" && options.title.trim() !== "" ? options.title.trim() : w.title,
-        subtitle: typeof options.subtitle === "string" && options.subtitle.trim() !== "" ? options.subtitle.trim() : typeof options.title === "string" && options.title.trim() !== "" ? w.title : undefined,
-    };
-    if (options.final !== undefined) {
-        if (typeof options.final !== "object" || options.final === null || options.final.score === undefined || options.final.score === null)
-            throw new TypeError("The final is { score }: the first finalist's score first");
-        model.final = viewOf(options.final, teams[1], "final", true);
-    }
-    return model;
-}
-/** The words under a score: FT, AET or the shoot-out (the first side's numbers first), a note in their place, or nothing. */
-export function decidedWords(view, w, mineFirst) {
-    if (view.note !== undefined)
-        return view.note;
-    if (!view.says)
-        return "";
-    if (view.decided === "aet")
-        return w.aet;
-    if (view.decided === "pens" && view.pens !== undefined)
-        return fill(w.pens, mineFirst ? { a: view.pens[0], b: view.pens[1] } : { a: view.pens[1], b: view.pens[0] });
-    return view.decided === "pens" ? w.aet : w.ft;
-}
-/** The score of a match as one text, the first side's first. */
-export function scoreText(view, mineFirst = true) {
-    if (view.whole !== undefined)
-        return view.whole;
-    return mineFirst ? `${view.mine}-${view.theirs}` : `${view.theirs}-${view.mine}`;
-}
-/** The abbreviation written under a mark: the team's own, else made from its name. */
-export function codeOf(team) {
-    return (typeof team.abbr === "string" && team.abbr.trim() !== "" ? team.abbr.trim() : abbreviate(String(team.name ?? ""))).slice(0, 5).toLocaleUpperCase("en");
-}
-function record(f, group, path) {
-    const all = [...group, ...path.values()];
-    let scored = 0;
-    let conceded = 0;
-    for (const v of all) {
-        const a = numeric(v.mine);
-        const b = numeric(v.theirs);
-        if (a !== undefined && b !== undefined) {
-            scored += a;
-            conceded += b;
-        }
-    }
-    return { name: f.name, matches: all.length, won: all.filter((v) => v.result === "win").length, drawn: all.filter((v) => v.result === "draw").length, lost: all.filter((v) => v.result === "loss").length, scored, conceded };
-}
-/** The numbers behind the chart. */
-export function totalsOf(model) {
-    const [a, b] = model.finalists;
-    const final = model.final;
-    const champion = final === undefined || final.result === "unknown" || final.result === "draw" ? null : final.result === "win" ? a.name : b.name;
-    return { finalists: [record(a, model.group[0], model.path[0]), record(b, model.group[1], model.path[1])], rounds: [...model.rounds], played: final !== undefined, champion };
-}
-/** The chart's accessible name. */
-export function nameOf(model) {
-    const heading = [model.title, model.subtitle].filter((part) => part !== undefined).join(model.words.said.sep);
-    return fill(model.words.road.name, { a: model.finalists[0].name, b: model.finalists[1].name, title: heading });
-}
-/** What the chart shows, in a sentence or two. */
-export function summaryOf(model) {
-    const w = model.words.road;
-    const [a, b] = model.finalists;
-    const t = totalsOf(model);
-    const parts = [fill(w.summary, { a: a.name, b: b.name, an: t.finalists[0].matches, bn: t.finalists[1].matches })];
-    const final = model.final;
-    if (final === undefined)
-        parts.push(w.toPlay);
-    else {
-        parts.push(fill(w.final, { a: a.name, b: b.name, score: scoreText(final), how: decidedWords(final, w, true) || w.ft }));
-        if (t.champion !== null)
-            parts.push(fill(w.champion, { name: t.champion }));
-    }
-    return parts.join(model.words.said.gap);
-}
-/** One HTML table with a row for every match: the group stage, the knockout rounds in order, and the final. */
-export function tableOf(model, options = {}) {
-    const w = model.words.road;
-    const cls = safeClass(options.className) || "ky-table";
-    const [a, b] = model.finalists;
-    const result = (r) => (r === "win" ? w.won : r === "loss" ? w.lost : r === "draw" ? w.drew : "");
-    const row = (team, round, v) => `<tr><th scope="row">${esc(team.name)}</th><td>${esc(round)}</td><td>${esc(v.opponent.name)}</td><td>${esc(scoreText(v))}</td><td>${esc(decidedWords(v, w, true))}</td><td>${esc(result(v.result))}</td></tr>`;
-    const rows = [];
-    for (const [i, team] of [a, b].entries()) {
-        for (const v of model.group[i])
-            rows.push(row(team, model.groupLabel, v));
-        for (const key of model.rounds) {
-            const v = model.path[i].get(key);
-            if (v !== undefined)
-                rows.push(row(team, model.label(key), v));
-        }
-    }
-    if (model.final !== undefined)
-        rows.push(row(a, model.label("final"), { ...model.final, opponent: b }));
-    const head = [w.tableTeam, w.tableRound, w.tableOpponent, w.tableScore, w.tableDecided, w.tableResult].map((name) => `<th scope="col">${esc(name)}</th>`).join("");
-    return `<table class="${cls}" data-kind="road"><caption>${esc(fill(w.caption, { a: a.name, b: b.name }))}</caption><thead><tr>${head}</tr></thead><tbody>${rows.join("")}</tbody></table>`;
-}

package/dist/road.style.d.ts

@@ -1,7 +0,0 @@
-/**
- * The rules of the road-to-the-final chart (`roadToFinal`): the ground, the ink and the quiet ink in light and dark, the panel behind a round's name, the road down the
- * middle, and the classes of the title, the names, the scores and the small words under them. The colours are custom properties on the chart (`--ky-road-bg`,
- * `--ky-road-ink`, `--ky-road-muted`, `--ky-road-panel`, `--ky-road-spine`, `--ky-road-left`, `--ky-road-right`), so a page can set them. A chart writes these rules in,
- * with the round mark's (`KYOGIJO_MARK_STYLE`); `KYOGIJO_STYLE` has them for a page that draws with `style: "none"`.
- */
-export declare const KYOGIJO_ROAD_STYLE: string;

package/dist/road.style.js

@@ -1,26 +0,0 @@
-/**
- * The rules of the road-to-the-final chart (`roadToFinal`): the ground, the ink and the quiet ink in light and dark, the panel behind a round's name, the road down the
- * middle, and the classes of the title, the names, the scores and the small words under them. The colours are custom properties on the chart (`--ky-road-bg`,
- * `--ky-road-ink`, `--ky-road-muted`, `--ky-road-panel`, `--ky-road-spine`, `--ky-road-left`, `--ky-road-right`), so a page can set them. A chart writes these rules in,
- * with the round mark's (`KYOGIJO_MARK_STYLE`); `KYOGIJO_STYLE` has them for a page that draws with `style: "none"`.
- */
-export const KYOGIJO_ROAD_STYLE = `
-:where(.kyogijo-road){--ky-road-bg:#f6f4ee;--ky-road-ink:#1d2421;--ky-road-muted:#5a655f;--ky-road-panel:#e7e3d6;--ky-road-spine:#c4bfae;--ky-road-left:#2f6db0;--ky-road-right:#b5452c;--ky-road-plain:#8b948f;--ky-mark-ring:#fff;--ky-mark-edge:rgba(0,0,0,.3);--ky-mark-plain:#fff;--ky-font:system-ui,-apple-system,"Segoe UI","Hiragino Sans","Noto Sans JP",sans-serif;display:block;width:100%;height:auto;font-family:var(--ky-font)}
-@media (prefers-color-scheme:dark){:where(html:not([data-theme=light]) .kyogijo-road:not([data-theme=light])){--ky-road-bg:#131716;--ky-road-ink:#ece8dc;--ky-road-muted:#a9b2ac;--ky-road-panel:#252b28;--ky-road-spine:#3d4541;--ky-road-left:#6aa9f0;--ky-road-right:#f59a5b;--ky-mark-ring:#e9ece6;--ky-mark-edge:rgba(0,0,0,.6);--ky-mark-plain:#2a302d}}
-:where(html[data-theme=dark] .kyogijo-road,.kyogijo-road[data-theme=dark]){--ky-road-bg:#131716;--ky-road-ink:#ece8dc;--ky-road-muted:#a9b2ac;--ky-road-panel:#252b28;--ky-road-spine:#3d4541;--ky-road-left:#6aa9f0;--ky-road-right:#f59a5b;--ky-mark-ring:#e9ece6;--ky-mark-edge:rgba(0,0,0,.6);--ky-mark-plain:#2a302d}
-.kyogijo-road .ky-r-bg{fill:var(--ky-road-bg)}
-.kyogijo-road text{font-family:var(--ky-font);font-variant-numeric:tabular-nums}
-.kyogijo-road .ky-r-t{fill:var(--ky-road-ink);font-weight:800}
-.kyogijo-road .ky-r-s,.kyogijo-road .ky-r-e{fill:var(--ky-road-muted);font-weight:600}
-.kyogijo-road .ky-r-name{fill:var(--ky-road-ink);font-weight:800}
-.kyogijo-road .ky-r-panel{fill:var(--ky-road-panel)}
-.kyogijo-road .ky-r-lab{fill:var(--ky-road-ink);font-weight:700}
-.kyogijo-road .ky-r-spine{stroke:var(--ky-road-spine);fill:none;stroke-linecap:round}
-.kyogijo-road .ky-r-n{fill:var(--ky-road-ink);font-weight:800}
-.kyogijo-road .ky-r-n.ky-r-low,.kyogijo-road .ky-r-dash{fill:var(--ky-road-muted);font-weight:700}
-.kyogijo-road .ky-r-sub,.kyogijo-road .ky-r-code{fill:var(--ky-road-muted);font-weight:700}
-.kyogijo-road .ky-r-vs{fill:var(--ky-road-muted);font-weight:700}
-.kyogijo-road .ky-r-dim{opacity:.5}
-.kyogijo-road .ky-r-left{--c:var(--ky-road-left)}
-.kyogijo-road .ky-r-right{--c:var(--ky-road-right)}
-.kyogijo-road .ky-r-plain{--c:var(--ky-road-plain)}`.trim();

package/dist/road.types.d.ts

@@ -1,125 +0,0 @@
-import type { EmblemRenderer } from "./emblems-source.ts";
-import type { Language, Team } from "./types.ts";
-/** A match's score from the finalist's side: `[for, against]` (numbers, or text such as a series' `4`), or one text, `"4-2"`, that is split at its dash. */
-export type RoadScore = readonly [number | string, number | string] | string;
-/** How a match was decided: `ft` (full time, the default), `aet` (after extra time) or `pens` (a shoot-out after extra time). */
-export type RoadDecided = "ft" | "aet" | "pens";
-/** One match on a finalist's way. */
-export interface RoadMatch {
-    /** The round, as a key. `round-of-32`, `round-of-16`, `quarter-final` and `semi-final` have words in English and Japanese; any other key is written as it is, or as `options.labels` names it. */
-    round: string;
-    /** The team it played: its name, abbreviation, `logo` (the flag or the crest) and `color`. */
-    opponent: Team;
-    /** The score, the finalist's first: `[2, 1]` is a 2-1 win. */
-    score: RoadScore;
-    /** How it was decided: `ft` by default, or `pens` when `pens` is given. Written under the score: FT, AET, or the shoot-out. */
-    decidedBy?: RoadDecided;
-    /** The shoot-out, the finalist's first: `[4, 3]`. */
-    pens?: readonly [number | string, number | string];
-    /** The order of the pair, left to right: `true` the finalist first, `false` its opponent first. By default the finalist is at the outer edge of its side, so that the two paths mirror each other. */
-    homeFirst?: boolean;
-    /** Words to write under the score in place of FT, AET or the shoot-out (`Game 6`, `OT`). An empty text writes nothing. */
-    note?: string;
-}
-/** One match of the group stage: as a knockout match, without a round. */
-export type RoadGroupMatch = Omit<RoadMatch, "round"> & {
-    round?: string;
-};
-/** A finalist: a team and the matches it played on the way, the earliest first. */
-export interface RoadFinalist extends Team {
-    /** The knockout matches before the final, the earliest first. */
-    path: readonly RoadMatch[];
-    /** The group stage, in the order played. A row of small marks, codes and scores at the foot. */
-    group?: readonly RoadGroupMatch[];
-}
-/** The final, when it has been played. */
-export interface RoadFinal {
-    /** The score, the first finalist's first. */
-    score: RoadScore;
-    decidedBy?: RoadDecided;
-    /** The shoot-out, the first finalist's first. */
-    pens?: readonly [number | string, number | string];
-    note?: string;
-}
-/** The sizes of the chart: `card` 1080 by 1350 (a tall post), `square` 1080 by 1080, `wide` 1200 by 675 (the finalists at the two ends) and `phone` 390 wide and as tall as it needs. */
-export type RoadSize = "card" | "square" | "wide" | "phone";
-/** What `roadToFinal` takes besides the finalists. */
-export interface RoadOptions {
-    /** The words of the chart: its title, the rounds' names, how a match was decided and the table. English by default. */
-    language?: Language;
-    /** A prefix for the ids inside the drawing. Made from the chart when missing, so that two charts on a page do not share ids. */
-    id?: string;
-    /** A renderer of ready-made emblems for this chart alone, so that a finalist's `logo` may be an emblem's id. Over the one the page plugged in with `useEmblems`. */
-    emblems?: EmblemRenderer;
-    /** The tournament, set large at the top. "Road to the final" when missing. */
-    title?: string;
-    /** The line under it. "Road to the final" when a `title` is given. */
-    subtitle?: string;
-    /** The final, if it has been played: its score is written between the two big marks, the winner is brighter, and the table has a row for it. */
-    final?: RoadFinal;
-    /** The names of the rounds, by key, over the package's own words. Any key a match uses may be named here: `{ "first-round": "First round" }`. */
-    labels?: Readonly<Record<string, string>>;
-    /** The group stage's name, over the package's own. */
-    groupLabel?: string;
-    /** `card` (the default), `square`, `wide` or `phone`. */
-    size?: RoadSize;
-    /** `light` or `dark` to force one; `auto` (the default) follows the device and the page. */
-    theme?: "auto" | "light" | "dark";
-    /** Who is brighter: `auto` (the default) the side that won each match, `none` nobody. */
-    winner?: "auto" | "none";
-    /** Write the opponent's three-letter code under its mark. On by default. */
-    codes?: boolean;
-    /** A line at the foot: a source, a credit, "Made-up results". */
-    endnote?: string;
-    /** A class for the root. */
-    className?: string;
-    /** `none` leaves the stylesheet to the page (`KYOGIJO_STYLE` has every rule). */
-    style?: "embed" | "none";
-}
-/** One finalist's record on the way. */
-export interface RoadRecord {
-    name: string;
-    /** Matches played in the group and the knockout rounds (not the final), and how many it won, drew and lost. */
-    matches: number;
-    won: number;
-    drawn: number;
-    lost: number;
-    /** The goals it scored and let in over the matches whose score is a pair of numbers. */
-    scored: number;
-    conceded: number;
-}
-/** The numbers behind a road chart. */
-export interface RoadTotals {
-    finalists: [RoadRecord, RoadRecord];
-    /** The rounds of the chart, the earliest first, as keys. */
-    rounds: string[];
-    /** The final has a score. */
-    played: boolean;
-    /** The winner of the final, or null when it has not been played or is level. */
-    champion: string | null;
-}
-/** The size in pixels a size draws at, and what it is for. */
-export interface RoadSizeInfo {
-    readonly width: number;
-    /** `undefined` for a size that is as tall as the rounds need. */
-    readonly height: number | undefined;
-    readonly about: string;
-}
-/** What `roadToFinal` gives back. */
-export interface RoadChart {
-    /** The options the chart was made with, with the finalists: pass changes to `draw`. */
-    options: RoadOptions;
-    /** The chart's accessible name, in the chart's language. */
-    title: string;
-    /** What the chart shows, in a sentence or two, for a caption. */
-    summary: string;
-    /** The numbers behind it. */
-    totals: RoadTotals;
-    /** The drawing as an SVG string. `extra` is laid over the options (`size`, `theme`, `language`, `labels`, `final`...). */
-    draw(extra?: Partial<RoadOptions>): string;
-    /** One HTML table with a row for every match: the table that stands for the drawing for a screen reader. */
-    table(options?: {
-        className?: string;
-        language?: Language;
-    }): string;
-}

package/dist/road.types.js

@@ -1 +0,0 @@
-export {};