@johnmorrisdotca/kyogijo-stadiums 0.6.2 → 0.8.0

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();