@johnmorrisdotca/kyogijo-stadiums 0.18.1 → 0.20.0

package/dist/budo/types.d.ts

@@ -1,5 +1,7 @@
 /** The sports of the budō family. */
-export type BudoKind = "judo" | "karate" | "kendo" | "sumo" | "kyudo" | "dojo";
+export type BudoKind = "judo" | "karate" | "kendo" | "sumo" | "kyudo" | "dojo" | CombatKind;
+/** The combat sports the engine of the budō also draws: the MMA cage. */
+export type CombatKind = "mma";
 /** The sides of a hall, as a plan has them: north is the top of the drawing. `top`, `bottom`, `left` and `right` say the same. */
 export type Compass = "north" | "south" | "east" | "west";
 export type Side4 = Compass | "top" | "bottom" | "left" | "right";
@@ -19,7 +21,7 @@ export interface BudoStyle {
     hall?: "budokan";
     /** Judo: `shiai` (the contest area, the default) or `kata` (the IJF's kata area, `league: "ijf-kata"`: a centre tape, two white tapes 3 m from it either side, a safety area of 2 m; with `officials`, the five judges' seats on the shomen side and the coach's chair opposite). */
     style?: "shiai" | "kata";
-    /** Judo: the contest area's side, 8 m to 10 m. Kendo: the shiai-jo's side, 9 m to 11 m. In metres. */
+    /** Judo: the contest area's side, 8 m to 10 m. Kendo: the shiai-jo's side, 9 m to 11 m. MMA cage: the width across the flats, 6.096 m to 9.754 m (20 to 32 feet), 9.144 m (30 feet) by default; 7.62 m is the smaller cage of 25 feet. In metres. */
     size?: number;
     /** Judo: the width of the safety area, 3 m or more (4 m by default). In metres. */
     safety?: number;
@@ -37,12 +39,18 @@ export interface BudoStyle {
     texture?: "weave" | "none";
     /** Karate: the referee's and the judges' places. On by default. */
     judges?: boolean;
-    /** Sumo: the height of the clay square in metres, 0.34 to 0.60. 0.55 by default. Seen in 3D. */
+    /** Sumo: the height of the clay square in metres, 0.34 to 0.60. 0.55 by default. MMA cage: the platform's height over the floor of the building, 0 to 1.219 m (4 feet), 1.219 m by default. Seen in 3D. */
     height?: number;
     /** Sumo: the four tassels of the roof, in the colours of the four quarters (green east, red south, white west, black north). Off by default. */
     tassels?: boolean;
     /** Sumo: the tawara, the shikiri-sen and the sand of the jano-me. On by default. */
     tawara?: boolean;
+    /** MMA cage: the fence's height over the canvas, 1.524 m to 2.134 m (5 to 7 feet), 1.829 m (6 feet) by default. Seen in 3D. */
+    fence?: number;
+    /** MMA cage: the two gates, opposite each other (the fence is whole without them). On by default. */
+    gates?: boolean;
+    /** MMA cage: the steps up to the platform at each gate, three treads. On by default. */
+    steps?: boolean;
     /** Kyūdō: the number of shooters in a line, 1 to 12 (5 by default). */
     shooters?: number;
     /** Kyūdō: the kind of range, `kinteki` (28 m, the default) or `enteki` (60 m); `league` says it too. */

package/dist/budo-entry.d.ts

@@ -3,7 +3,7 @@ export type { Dojo, Tatami } from "./budo/dojo.api.ts";
 export { DOJO_SIZES, floorOf, shapeOfJo } from "./budo/dojo.ts";
 export { dojoGallery, dojoRoom, ROOM_HEIGHTS } from "./budo/room.ts";
 export type { DojoGallery, DojoRoom, RoomBalcony, RoomBasis, RoomOpening, RoomWall } from "./budo/room.ts";
-export { budoLeague, budoPlan, BUDO_SPORTS, BUDOKAN_ARENA, isBudoSport } from "./budo/plan.ts";
+export { budoLeague, budoPlan, BUDO_SPORTS, BUDOKAN_ARENA, COMBAT_SPORTS, isBudoSport, isCombatSport, isMatSport } from "./budo/plan.ts";
 export type { BudoPlan, MBox, MMark, MRange } from "./budo/plan.ts";
 export { checker, fourCorners, kindOf, lay, matCount, tint } from "./budo/tatami.ts";
 export type { MatSize, Piece, PieceKind } from "./budo/tatami.ts";

package/dist/budo-entry.js

@@ -2,7 +2,7 @@
 export { DOJO_STANDARDS, dojo, drawDojo } from "./budo/dojo.api.js";
 export { DOJO_SIZES, floorOf, shapeOfJo } from "./budo/dojo.js";
 export { dojoGallery, dojoRoom, ROOM_HEIGHTS } from "./budo/room.js";
-export { budoLeague, budoPlan, BUDO_SPORTS, BUDOKAN_ARENA, isBudoSport } from "./budo/plan.js";
+export { budoLeague, budoPlan, BUDO_SPORTS, BUDOKAN_ARENA, COMBAT_SPORTS, isBudoSport, isCombatSport, isMatSport } from "./budo/plan.js";
 export { checker, fourCorners, kindOf, lay, matCount, tint } from "./budo/tatami.js";
 export { TATAMI } from "./budo/judo.js";
 export { KIMARITE, KIMARITE_COUNT, KIMARITE_OTHERS, kimariteName, kimariteOf } from "./budo/kimarite.js";

package/dist/budo.style.js

@@ -37,6 +37,11 @@ const CLASSES = `
 .kyogijo .ky-bud-tassel-s{fill:#d23b32;stroke:var(--ky-ink);stroke-opacity:.5;stroke-width:.03}
 .kyogijo .ky-bud-tassel-w{fill:#f4f1e8;stroke:var(--ky-ink);stroke-opacity:.5;stroke-width:.03}
 .kyogijo .ky-bud-tassel-n{fill:#232323;stroke:var(--ky-ink);stroke-opacity:.5;stroke-width:.03}`.trim();
+/** The rules of the combat sports' classes, added to a combat drawing only, so that the budō drawings are the text they were: the steps up to a platform and the padding of a post. */
+const COMBAT_CLASSES = `
+.kyogijo .ky-bud-step{fill:color-mix(in srgb,var(--ky-bud-floor,#43484e) 76%,#fff);stroke:var(--ky-ink);stroke-opacity:.35;stroke-width:.03}
+.kyogijo .ky-bud-pad{fill:var(--ky-ink);fill-opacity:.82}`.trim();
+const COMBAT = ["mma"];
 /** The custom properties of a look. */
 const vars = (l) => `--ky-surface:${l.surface};--ky-surface-alt:${l.alt};--ky-red:${l.red};--ky-apron:${l.apron};--ky-free:${l.free};--ky-bud-floor:${l.floor};--ky-boards:${l.boards}${l.dirt === undefined ? "" : `;--ky-dirt:${l.dirt}`}${l.sand === undefined ? "" : `;--ky-sand:${l.sand}`}${l.straw === undefined ? "" : `;--ky-bud-straw:${l.straw}`}`;
 /** The three rules of one look: light, dark by the device's setting, and dark by the page's `data-theme`. */
@@ -64,7 +69,7 @@ export function budoStyle(sport, look) {
     const kind = sport;
     if (BUDO_LOOKS[kind] === undefined)
         return "";
-    return `${CLASSES}\n${look === undefined ? lookRules(kind, Object.keys(BUDO_LOOKS[kind])[0]) : lookRules(kind, look)}`;
+    return `${CLASSES}${COMBAT.includes(sport) ? `\n${COMBAT_CLASSES}` : ""}\n${look === undefined ? lookRules(kind, Object.keys(BUDO_LOOKS[kind])[0]) : lookRules(kind, look)}`;
 }
 /** Every budō sport's rules and every look, for a page that draws with `style: "none"` and supplies the stylesheet itself. */
-export const KYOGIJO_BUDO_STYLE = `${CLASSES}${KYOGIJO_BUDO_GALLERY_STYLE}\n${Object.keys(BUDO_LOOKS).flatMap((sport) => Object.keys(BUDO_LOOKS[sport]).map((name) => lookRules(sport, name))).join("\n")}`;
+export const KYOGIJO_BUDO_STYLE = `${CLASSES}\n${COMBAT_CLASSES}${KYOGIJO_BUDO_GALLERY_STYLE}\n${Object.keys(BUDO_LOOKS).flatMap((sport) => Object.keys(BUDO_LOOKS[sport]).map((name) => lookRules(sport, name))).join("\n")}`;

package/dist/common.d.ts

@@ -2,6 +2,11 @@ import type { SurfaceOptions } from "./types.ts";
 import { type Unit } from "./units.ts";
 /** Text made safe for a class name or an id: letters, digits, underscores, spaces and hyphens. */
 export declare const safeClass: (text: string | undefined) => string;
+/**
+ * The title and the description of a drawing, as the first thing in it: the accessible name (`aria-labelledby` points at them). They sit in a `<defs>` so that they are never a tooltip: a `<title>` that is a direct child of
+ * the root makes the browser pop a box with its words up wherever the pointer is over the drawing, which on a mat reads as a label drawn on top of it.
+ */
+export declare const metaMarkup: (titleId: string, title: string, descId: string, description: string) => string;
 /** The prefix of the ids inside a drawing: the `id` option, or a hash of the options, so that the same call gives the same drawing. */
 export declare const drawingId: (o: SurfaceOptions) => string;
 /** True when a drawing with these options lies in portrait. */

package/dist/common.js

@@ -1,10 +1,15 @@
 // What the drawing and the data layers both need: the drawing's id, whether it lies tall, and the unit its lengths are in.
 // Kept apart from draw.ts so that layers.ts need not import the file that imports it.
-import { hash } from "./format.js";
+import { esc, hash } from "./format.js";
 import { convertLength, isUnit } from "./units.js";
 import { VERSION } from "./version.js";
 /** Text made safe for a class name or an id: letters, digits, underscores, spaces and hyphens. */
 export const safeClass = (text) => (text ?? "").replace(/[^\w -]/g, "").trim();
+/**
+ * The title and the description of a drawing, as the first thing in it: the accessible name (`aria-labelledby` points at them). They sit in a `<defs>` so that they are never a tooltip: a `<title>` that is a direct child of
+ * the root makes the browser pop a box with its words up wherever the pointer is over the drawing, which on a mat reads as a label drawn on top of it.
+ */
+export const metaMarkup = (titleId, title, descId, description) => `<defs><title id="${titleId}">${esc(title)}</title><desc id="${descId}">${esc(description)}</desc></defs>`;
 /** The prefix of the ids inside a drawing: the `id` option, or a hash of the options, so that the same call gives the same drawing. */
 export const drawingId = (o) => safeClass(o.id).replace(/ /g, "-") || `ky-${hash(JSON.stringify([o, VERSION]))}`;
 /** True when a drawing with these options lies in portrait. */

package/dist/crowd.js

@@ -100,6 +100,8 @@ const PROFILES = {
     sumo: { shape: "bowl", side: 58, end: 58, bench: 0, corner: 56, tiers: [{ id: "lower", from: 0, to: 54, height: [1, 8], fill: 1 }, upper(62, 128, 26, 62)], away: "corner" },
     kyudo: { shape: "sides", side: 10, end: 8, bench: 0, corner: 6, tiers: [lower(24, 2, 8), upper(30, 52, 12, 22)], away: "corner" },
     dojo: { shape: "bowl", side: 5, end: 5, bench: 0, corner: 8, tiers: [lower(26, 2, 14), upper(32, 58, 20, 36)], away: "corner" },
+    // An MMA cage stands in the middle of an arena, with the seats rising from the ring of the floor.
+    mma: { shape: "bowl", side: 40, end: 40, bench: 0, corner: 56, tiers: [lower(60, 3, 24), upper(67, 120, 32, 60)], away: "corner" },
 };
 /** The grounds of the package that are the home of an NFL or a CFL club, where a soccer pitch stands inside a gridiron's stands. From each ground's article. */
 export const GRIDIRON_GROUNDS = Object.freeze({

package/dist/draw.js

@@ -17,7 +17,7 @@ import { athleticsPlan } from "./athletics/plan.js";
 import { skatingPlan } from "./skating/plan.js";
 import { skatingAbout, skatingSentences } from "./skating/describe.js";
 import { skatingStyle } from "./skating.style.js";
-import { budoPlan, isBudoSport } from "./budo/plan.js";
+import { budoPlan, isBudoSport, isMatSport } from "./budo/plan.js";
 import { dojoSpecOf } from "./budo/dojo.js";
 import { dojoGallery } from "./budo/room.js";
 import { budoAbout, budoScoreSentences, budoSentences } from "./budo/describe.js";
@@ -91,7 +91,7 @@ import { abbreviate, capitals } from "./text.js";
 import { VERSION } from "./version.js";
 export { isPortrait };
 /** The sports that can be drawn, in the order a menu lists them. */
-export const SPORTS = ["nfl", "cfl", "ifaf", "nhl", "nba", "mlb", "soccer", "curling", "tennis", "volleyball", "badminton", "pickleball", "tabletennis", "padel", "squash", "racquetball", "sepaktakraw", "teqball", "roundnet", "netball", "swimming", "waterpolo", "diving", "artisticswimming", "athletics", "skating", "judo", "karate", "kendo", "sumo", "kyudo", "dojo", "lacrosse", "rugby", "afl", "gaelic", "cricket", "fieldhockey", "handball"];
+export const SPORTS = ["nfl", "cfl", "ifaf", "nhl", "nba", "mlb", "soccer", "curling", "tennis", "volleyball", "badminton", "pickleball", "tabletennis", "padel", "squash", "racquetball", "sepaktakraw", "teqball", "roundnet", "netball", "swimming", "waterpolo", "diving", "artisticswimming", "athletics", "skating", "judo", "karate", "kendo", "sumo", "kyudo", "dojo", "mma", "lacrosse", "rugby", "afl", "gaelic", "cricket", "fieldhockey", "handball"];
 /** The CSS custom property each colour of `Colors` sets. */
 export const COLOR_PROPERTIES = {
     apron: "--ky-apron",
@@ -265,7 +265,7 @@ function buildSkating(o, common) {
 /** The budō surface: its plan, drawn as it lies. A hall, a kyūdōjō and a range of mats have little ground round them. */
 function buildBudo(o, common) {
     const plan = budoPlan({ ...o, detail: common.detail });
-    return budoSurface(common, plan, common.margin ?? (o.range === undefined ? 12 : 4));
+    return budoSurface(common, plan, common.margin ?? (o.range === undefined ? (plan.mma === undefined ? 12 : 5) : 4));
 }
 /** One text for both ends or sides, or a pair of them. */
 const pair = (text) => (text === undefined ? undefined : typeof text === "string" ? [text, text] : text);
@@ -373,6 +373,7 @@ function buildWhole(o, portrait, id, score, scored, extra) {
         case "sumo":
         case "kyudo":
         case "dojo":
+        case "mma":
             return buildBudo({ ...o, sport }, common);
         default:
             throw new Error(`Unknown sport "${String(o.sport)}": use one of ${SPORTS.join(", ")}`);
@@ -608,7 +609,7 @@ function leagueAbout(league, year, language, sheet) {
     const words = KYOGIJO_STRINGS[language].league;
     if (league.family === "skating")
         return skatingAbout({ sport: "skating", league: league.id }, language);
-    if (league.family === "judo" || league.family === "karate" || league.family === "kendo" || league.family === "sumo" || league.family === "kyudo" || league.family === "dojo")
+    if (league.family === "judo" || league.family === "karate" || league.family === "kendo" || league.family === "sumo" || league.family === "kyudo" || league.family === "dojo" || league.family === "mma")
         return budoAbout({ sport: league.family, league: league.id }, language);
     if (league.family === "athletics")
         return athleticsAbout({ sport: "athletics", league: league.id, athletics: sheet === undefined ? undefined : undefined }, language);
@@ -697,8 +698,8 @@ export function describe(o) {
     const poolLine = pools === undefined ? "" : pools.after.map((line) => `${gap}${line}`).join("");
     // An arena of a size of its own says what it is at that size.
     const arenaAbout = arenaSize === undefined ? undefined : fill(sport === "nhl" ? words.said.arenaRinkAbout : words.said.arenaCourtAbout, { length: metres(arenaSize.length), width: metres(arenaSize.width), lengthM: metres(arenaSize.length * 0.3048), widthM: metres(arenaSize.width * 0.3048) });
-    const aboutText = arenaAbout !== undefined ? arenaAbout : pools !== undefined ? pools.about : isBudoSport(sport) ? budoAbout(o, language) : sport === "skating" ? skatingAbout(o, language) : sport === "athletics" ? athleticsAbout(o, language) : field !== undefined ? leagueAbout(league ?? LEAGUES[sport][0], o.year, language, { length: field.length, width: field.width }) : plan !== undefined ? leagueAbout(plan.league, o.year, language, plan.spec) : league !== undefined ? leagueAbout(league, o.year, language) : pitch === undefined ? words.about[sport] : fill(pitch.format === "futsal" ? words.soccer.aboutFutsal : words.about.soccer, { length: metres(pitch.length), width: metres(pitch.width) });
-    const about = `${words.said.on}${colon}${aboutText}${stop}${sport === "athletics" ? athleticsSentences(o, language) : sport === "skating" ? skatingSentences(o, language) : isBudoSport(sport) ? budoSentences(o, language) : ""}`;
+    const aboutText = arenaAbout !== undefined ? arenaAbout : pools !== undefined ? pools.about : isMatSport(sport) ? budoAbout(o, language) : sport === "skating" ? skatingAbout(o, language) : sport === "athletics" ? athleticsAbout(o, language) : field !== undefined ? leagueAbout(league ?? LEAGUES[sport][0], o.year, language, { length: field.length, width: field.width }) : plan !== undefined ? leagueAbout(plan.league, o.year, language, plan.spec) : league !== undefined ? leagueAbout(league, o.year, language) : pitch === undefined ? words.about[sport] : fill(pitch.format === "futsal" ? words.soccer.aboutFutsal : words.about.soccer, { length: metres(pitch.length), width: metres(pitch.width) });
+    const about = `${words.said.on}${colon}${aboutText}${stop}${sport === "athletics" ? athleticsSentences(o, language) : sport === "skating" ? skatingSentences(o, language) : isMatSport(sport) ? budoSentences(o, language) : ""}`;
     const halfLine = pitch !== undefined && !isScore(o) && (o.half === "left" || o.half === "right") ? `${gap}${words.soccer.half}` : "";
     // What the ground says about the size: that it is the published one, or that the ground has none and the international pitch is drawn.
     const year = typeof o.year === "number" && Number.isFinite(o.year) ? o.year : undefined;
@@ -889,7 +890,7 @@ function drawnKyogijo(o) {
     const crowded = crowdOf(o) !== undefined;
     const style = colourStyle(o, { left: leftTeam, right: rightTeam, home: isScore(o) ? o.home : undefined, away: isScore(o) ? o.away : undefined }, featured);
     const palette = isLook(o.look) ? o.look : undefined;
-    const budoLook = isBudoSport(sport) ? budoLookOf(sport, o.budo?.look ?? (sport === "dojo" ? dojoSpecOf(o.dojo).look : undefined)) : undefined;
+    const budoLook = isMatSport(sport) ? budoLookOf(sport, o.budo?.look ?? (sport === "dojo" ? dojoSpecOf(o.dojo).look : undefined)) : undefined;
     let notes;
     const theme = o.theme === "light" || o.theme === "dark" ? o.theme : undefined;
     let viewBox;

package/dist/features.js

@@ -128,6 +128,15 @@ const SUMO = [
     f("tawara", "--ky-bud-straw", "The tawara of the ring."),
     f("shikiri-sen", "--ky-line", "The two shikiri-sen."),
 ];
+const MMA = [
+    f("apron", "--ky-apron", "The floor of the hall round the platform."),
+    f("platform", "--ky-bud-floor", "The platform the cage stands on."),
+    f("steps", "--ky-bud-floor", "The steps up to the platform."),
+    f("canvas", "--ky-surface", "The canvas inside the fence."),
+    f("fence", "--ky-ink", "The fence, one line on each flat."),
+    f("gates", "--ky-ink", "The swing of the two gates."),
+    f("posts", "--ky-ink", "The eight padded posts."),
+];
 const KYUDO = [
     f("apron", "--ky-apron", "The ground round the range."),
     f("shajo", "--ky-bud-floor", "The floor of the shajō."),
@@ -435,6 +444,7 @@ export const FEATURE_INFO = Object.freeze({
     sumo: SUMO,
     kyudo: KYUDO,
     dojo: DOJO,
+    mma: MMA,
 });
 /**
  * The names of the features of each sport: the keys `featureColors` takes. Football's three fields have the same, and so have the five net sports.

package/dist/fields.types.d.ts

@@ -95,7 +95,7 @@ export type Shape = LineShape | ArcShape | RingShape | BoxShape | PolyShape | Do
 /** The areas of a skating rink: the ice, the floor of the infield, the warm-up lane, the padding and the furniture. */
 export type SkatingArea = "ky-ska-ice" | "ky-ska-floor" | "ky-ska-warm" | "ky-ska-pad" | "ky-ska-desk" | "ky-ska-kiss";
 /** The areas of a budō surface: the mats in three tones, the heri of a mat, the floor, the walls, the platform and the furniture, the clay and the sand and the straw of a dohyō, the azuchi and the yamichi. */
-export type BudoArea = "ky-bud-t1" | "ky-bud-t2" | "ky-bud-t3" | "ky-bud-heri" | "ky-bud-floor" | "ky-bud-wall" | "ky-bud-window" | "ky-bud-door" | "ky-bud-platform" | "ky-bud-free" | "ky-bud-desk" | "ky-bud-clay" | "ky-bud-sand" | "ky-bud-tawara" | "ky-bud-azuchi" | "ky-bud-roof" | "ky-bud-yamichi" | "ky-bud-shrine" | "ky-bud-dais" | "ky-bud-banner" | "ky-bud-lane" | "ky-bud-mato" | "ky-bud-tassel-e" | "ky-bud-tassel-s" | "ky-bud-tassel-w" | "ky-bud-tassel-n" | "ky-bud-seat";
+export type BudoArea = "ky-bud-t1" | "ky-bud-t2" | "ky-bud-t3" | "ky-bud-heri" | "ky-bud-floor" | "ky-bud-wall" | "ky-bud-window" | "ky-bud-door" | "ky-bud-platform" | "ky-bud-free" | "ky-bud-desk" | "ky-bud-clay" | "ky-bud-sand" | "ky-bud-tawara" | "ky-bud-azuchi" | "ky-bud-roof" | "ky-bud-yamichi" | "ky-bud-shrine" | "ky-bud-dais" | "ky-bud-banner" | "ky-bud-lane" | "ky-bud-mato" | "ky-bud-tassel-e" | "ky-bud-tassel-s" | "ky-bud-tassel-w" | "ky-bud-tassel-n" | "ky-bud-seat" | "ky-bud-step" | "ky-bud-pad";
 export type AthleticsArea = "ky-ath-track" | "ky-ath-grass" | "ky-ath-sand" | "ky-ath-mat" | "ky-ath-water" | "ky-ath-concrete" | "ky-ath-pad" | "ky-ath-board" | "ky-ath-bank";
 /** A painted area, under the lines: a rectangle or an ellipse filled with a class of the stylesheet (`ky-area`, the tint of a goal area, or `ky-zone`). */
 export interface Area extends Named {

package/dist/heat.zones.js

@@ -37,7 +37,7 @@ export const ZONE_SETS = Object.freeze({
     "pool-lanes": { sports: ["swimming"], title: "Lanes: each lane of the pool, the whole length of it", source: "docs/sources.md#zone-sets" },
     "water-polo-areas": { sports: ["waterpolo"], title: "The goal area, the ground from 2 to 6 m, and the rest of the field, at each end", source: "docs/sources.md#zone-sets" },
     "pool-thirds": { sports: ["diving", "artisticswimming"], title: "Thirds along the pool, from the wall the boards or the judges stand at", source: "docs/sources.md#zone-sets" },
-    "budo-areas": { sports: ["judo", "karate", "kendo", "sumo", "kyudo", "dojo"], title: "The surface in its areas: the contest and the safety areas, the boundary band, the clay and the ring of a dohyō, the shajō, the yamichi and the azuchi, a dojo's floor", source: "docs/sources.md#zone-sets" },
+    "budo-areas": { sports: ["judo", "karate", "kendo", "sumo", "kyudo", "dojo", "mma"], title: "The surface in its areas: the contest and the safety areas, the boundary band, the clay and the ring of a dohyō, the shajō, the yamichi and the azuchi, a dojo's floor", source: "docs/sources.md#zone-sets" },
     "field-thirds": { sports: ["lacrosse", "rugby", "afl", "gaelic", "fieldhockey", "handball", "netball"], title: "Thirds: defensive, middle and attacking", source: "docs/sources.md#zone-sets" },
     "skating-track": { sports: ["skating"], title: "The rink in parts: the finish straight, the first curve, the crossing straight, the second curve and the infield (a figure skating rink in thirds)", source: "docs/sources.md#zone-sets" },
     "athletics-track": { sports: ["athletics"], title: "The track in parts: the finish straight, the first bend, the back straight, the second bend, and the infield", source: "docs/sources.md#zone-sets" },

package/dist/homeside.js

@@ -49,6 +49,8 @@ export const HOME_FIRST = Object.freeze({
     sumo: false,
     kyudo: false,
     dojo: false,
+    // A cage fight is between a red corner and a blue corner: no home side.
+    mma: false,
 });
 /** The leagues whose convention is not their sport's: the international federation's lacrosse lists the home team first. */
 export const HOME_FIRST_LEAGUES = Object.freeze({

package/dist/judging-entry.d.ts

@@ -1,9 +1,14 @@
+export { judgingBoard, boardFoot, BOARD_BASE } from "./judging.board.ts";
+export { JUDGING_PAPER, judgingPrint, judgingPrintSheets, judgingPrintStyle } from "./judging.print.ts";
+export type { JudgingPrintOptions } from "./judging.print.ts";
+export { KYOGIJO_JUDGING_BROADCAST_STYLE, mountJudgingBroadcast } from "./judging.mount.ts";
+export { BROADCAST_RATIO } from "./judging.broadcast.ts";
 export { drawJudging, judgingChart, judgingDrawing, judgingTable, judgingText } from "./judging.draw.ts";
 export { JUDGING_HEIGHTS, JUDGING_PRESETS, buildJudgingTurn, judgingTurnMarkup, mountJudgingTurn } from "./judging.turn.ts";
 export { JUDGING_LEAGUE, JUDGING_MATS_MAX, JUDGING_SEATS, JUDGING_SEAT_COUNT, JUDGING_SEAT_WORDS, JUDGING_STYLES } from "./judging.data.ts";
 export { JUDGING_LIMITS, benchOf, judgingPlan, judgingSetting, matLabel, seatIn, seatOf, seatsOf } from "./judging.ts";
 export { fitCard, fitChart, fitSeats, wrapText } from "./judging.fit.ts";
-export { KYOGIJO_JUDGING_STYLE } from "./judging.style.ts";
+export { KYOGIJO_JUDGING_BOARD_STYLE, KYOGIJO_JUDGING_STYLE } from "./judging.style.ts";
 export { JUDGING_WORDS } from "./judging.words.ts";
 export type { JudgingWords } from "./judging.words.ts";
 export type { JudgingAssignment, JudgingMat, JudgingOfficial, JudgingOptions, JudgingResolved, JudgingSeat, JudgingStyle } from "./judging.types.ts";

package/dist/judging-entry.js

@@ -1,8 +1,12 @@
 // A judging assignment: the officials of each mat area of a judo tournament, by seat, with their names and IDs, in the seat where they fit and in a chart where they do not; in 2D and in 3D.
+export { judgingBoard, boardFoot, BOARD_BASE } from "./judging.board.js";
+export { JUDGING_PAPER, judgingPrint, judgingPrintSheets, judgingPrintStyle } from "./judging.print.js";
+export { KYOGIJO_JUDGING_BROADCAST_STYLE, mountJudgingBroadcast } from "./judging.mount.js";
+export { BROADCAST_RATIO } from "./judging.broadcast.js";
 export { drawJudging, judgingChart, judgingDrawing, judgingTable, judgingText } from "./judging.draw.js";
 export { JUDGING_HEIGHTS, JUDGING_PRESETS, buildJudgingTurn, judgingTurnMarkup, mountJudgingTurn } from "./judging.turn.js";
 export { JUDGING_LEAGUE, JUDGING_MATS_MAX, JUDGING_SEATS, JUDGING_SEAT_COUNT, JUDGING_SEAT_WORDS, JUDGING_STYLES } from "./judging.data.js";
 export { JUDGING_LIMITS, benchOf, judgingPlan, judgingSetting, matLabel, seatIn, seatOf, seatsOf } from "./judging.js";
 export { fitCard, fitChart, fitSeats, wrapText } from "./judging.fit.js";
-export { KYOGIJO_JUDGING_STYLE } from "./judging.style.js";
+export { KYOGIJO_JUDGING_BOARD_STYLE, KYOGIJO_JUDGING_STYLE } from "./judging.style.js";
 export { JUDGING_WORDS } from "./judging.words.js";

package/dist/judging.board.d.ts

@@ -0,0 +1,26 @@
+import { type JudgingSetting } from "./judging.ts";
+import type { JudgingOptions, JudgingResolved } from "./judging.types.ts";
+/** The width a board is laid out in before it is scaled to the picture: every other figure here is a share of it. */
+export declare const BOARD_BASE = 480;
+/** One board as markup at (x, y), `width` wide, and how tall it came out. */
+export interface BoardPlace {
+    markup: string;
+    width: number;
+    height: number;
+}
+/** The line at the board's foot: the mat's own line (`Round 2`) and the style (`Kata, 5 judges`). */
+export declare function boardFoot(mat: JudgingResolved, setting: Pick<JudgingSetting, "language" | "style">): string;
+/** The board of one mat at (x, y), `width` wide. */
+export declare function boardMarkup(mat: JudgingResolved, setting: Pick<JudgingSetting, "language" | "style">, x: number, y: number, width: number): BoardPlace;
+/**
+ * The board of an assignment on its own, as an SVG with nothing round it: the plate is the only thing that is drawn, semi-transparent, so that a page can lay it over a picture of the mat (the 3D view's). With several
+ * mats and no `mat`, their boards stand one under another.
+ * @example
+ * ```ts
+ * import { judgingBoard } from "@johnmorrisdotca/kyogijo-stadiums/judging";
+ * const svg = judgingBoard({ style: "kata", mats: [{ label: "Mat 1", officials: [{ seat: 1, name: "Aiko Mori", id: "J-1042" }] }] });
+ * console.log(svg.includes("ky-ju-board"), svg.includes("Aiko Mori"));
+ * // true true
+ * ```
+ */
+export declare function judgingBoard(options: JudgingOptions, resolved?: JudgingSetting): string;

package/dist/judging.board.js

@@ -0,0 +1,125 @@
+// The board of a broadcast picture: the officials of one mat listed like a score panel on a television graphic. It is the package's own score panel drawn for officials (`budo.board.ts`): the same dark rounded plate, the
+// mat's name where a score panel has the competition, the column heads, a row for each seat with its number on the round badge the seats on the mat wear and the name on a coloured chip as a team's is, the ID where a
+// score would be, and the style under it where the foot is. Same classes, so the same colours, faces and light and dark; a seat with nobody in it is a hollow badge and a dashed chip. Every size is in the picture's own
+// units and proportional to its width, and text is only ever set at a size: it is never stretched. Nothing here decides where the board goes.
+import { el, esc, hash, num } from "./format.js";
+import { PLAN_CARD, badge } from "./judging.card.js";
+import { fitChart } from "./judging.fit.js";
+import { JUDGING_LEAGUE } from "./judging.data.js";
+import { judgingSetting } from "./judging.js";
+import { KYOGIJO_JUDGING_BOARD_STYLE, KYOGIJO_JUDGING_STYLE } from "./judging.style.js";
+import { judgingText } from "./judging.text.js";
+import { JUDGING_WORDS } from "./judging.words.js";
+import { fill } from "./strings.js";
+import { metaMarkup, safeClass } from "./common.js";
+import { LINE_HEIGHT, fitLines, textWidth } from "./text.js";
+import { VERSION } from "./version.js";
+/** The width a board is laid out in before it is scaled to the picture: every other figure here is a share of it. */
+export const BOARD_BASE = 480;
+/** The line at the board's foot: the mat's own line (`Round 2`) and the style (`Kata, 5 judges`). */
+export function boardFoot(mat, setting) {
+    const style = fill(JUDGING_WORDS[setting.language].styleName[setting.style], { count: mat.seats.length });
+    return [mat.line, style].filter((part) => part !== "").join(" · ");
+}
+/** The text of a board's lines, centred on x: each line `size` tall, the first one's middle at `top`. */
+function lines(rows, size, x, top, cls) {
+    return rows.map((row, i) => el("text", { class: cls, x, y: top + (i + 0.5) * size * LINE_HEIGHT + size * 0.3, "font-size": size, "text-anchor": "middle" }, esc(row))).join("");
+}
+/** A name on its chip: on one line where it stays at a size that reads (21 and up on a board 480 wide), else wrapped at its spaces, or broken inside a word, at a size no smaller than 17: the row grows to hold it. */
+function nameFit(name, room, k) {
+    const size = Math.min(27 * k, room / Math.max(1, textWidth(name)));
+    if (size >= 21 * k)
+        return { name: [name], nameSize: size, id: [], idSize: 0, width: textWidth(name) * size, height: size * LINE_HEIGHT };
+    return fitChart({ name, id: "", idLabel: "", width: room, max: 27 * k, min: 17 * k });
+}
+/** The board of one mat at (x, y), `width` wide. */
+export function boardMarkup(mat, setting, x, y, width) {
+    const words = JUDGING_WORDS[setting.language];
+    const k = width / BOARD_BASE;
+    const pad = 18 * k;
+    const badgeR = 21 * k;
+    const chipX = pad + 56 * k;
+    const chipW = 244 * k;
+    const idX = chipX + chipW + 12 * k;
+    const idW = width - pad - idX;
+    const rowMin = 60 * k;
+    const headH = 30 * k;
+    let out = "";
+    let cursor = 0;
+    // The title: the mat's name, where a score panel has the competition.
+    const title = fitLines(mat.label, width - 2 * pad, 52 * k, 42 * k);
+    const titleH = Math.max(64 * k, title.lines.length * title.size * LINE_HEIGHT + 26 * k);
+    out += lines(title.lines, title.size, width / 2, (titleH - title.lines.length * title.size * LINE_HEIGHT) / 2, "ky-text ky-comp ky-ju-board-title");
+    cursor += titleH;
+    // The column heads.
+    const head = (text, cx, room) => el("text", { class: "ky-text ky-foot", x: cx, y: cursor + headH / 2 + 5 * k, "font-size": Math.max(1, Math.min(15 * k, room / Math.max(1, textWidth(text)))), "text-anchor": "middle" }, esc(text));
+    out += head(words.chart.name, chipX + chipW / 2, chipW * 0.9) + head(words.chart.id, idX + idW / 2, idW * 0.9);
+    cursor += headH;
+    // A row for each seat, as tall as its name and its ID need.
+    for (const a of mat.seats) {
+        const name = a.assigned && a.name !== "" ? nameFit(a.name, chipW - 22 * k, k) : undefined;
+        const id = a.id === "" ? undefined : fitChart({ name: a.id, id: "", idLabel: "", width: idW - 8 * k, max: 25 * k, min: 15 * k });
+        const rowH = Math.max(rowMin, (name?.height ?? 0) + 22 * k, (id?.height ?? 0) + 22 * k);
+        const cy = cursor + rowH / 2;
+        let row = "";
+        row += badge(PLAN_CARD, pad + 26 * k, cy, badgeR, a.seat.n, a.assigned);
+        const chipH = rowH - 10 * k;
+        row += el("rect", { class: a.assigned ? "ky-panel-left ky-ju-chip" : "ky-ju-chip-empty", x: chipX, y: cursor + 5 * k, width: chipW, height: chipH, rx: Math.min(chipH * 0.22, 14 * k) });
+        if (name === undefined) {
+            row += el("text", { class: "ky-text ky-ju-board-vacant", x: chipX + chipW / 2, y: cy + 19 * k * 0.36, "font-size": 19 * k, "text-anchor": "middle" }, esc(words.chart.vacant));
+        }
+        else {
+            row += lines(name.name, name.nameSize, chipX + chipW / 2, cy - (name.name.length * name.nameSize * LINE_HEIGHT) / 2, "ky-text ky-ink-left");
+        }
+        if (id !== undefined)
+            row += lines(id.name, id.nameSize, idX + idW / 2, cy - (id.name.length * id.nameSize * LINE_HEIGHT) / 2, "ky-text ky-score ky-ju-board-id");
+        out += el("g", { class: "ky-ju-board-row", "data-mat": mat.n, "data-seat": a.seat.id }, row);
+        cursor += rowH;
+    }
+    // The foot: the line and the style.
+    const foot = boardFoot(mat, setting);
+    const footSize = Math.max(1, Math.min(21 * k, ((width - 2 * pad) * 0.98) / Math.max(1, textWidth(foot))));
+    const footH = 48 * k;
+    out += el("text", { class: "ky-text ky-foot", x: width / 2, y: cursor + footH / 2 + footSize * 0.34, "font-size": footSize, "text-anchor": "middle" }, esc(foot));
+    cursor += footH;
+    const plate = el("rect", { class: "ky-plate-bg", x: 0, y: 0, width, height: cursor, rx: Math.min(30 * k, width * 0.05) });
+    return { markup: el("g", { class: "ky-plate ky-ju-board", "data-mat": mat.n, transform: `translate(${num(x)} ${num(y)})` }, plate + out), width, height: cursor };
+}
+/**
+ * The board of an assignment on its own, as an SVG with nothing round it: the plate is the only thing that is drawn, semi-transparent, so that a page can lay it over a picture of the mat (the 3D view's). With several
+ * mats and no `mat`, their boards stand one under another.
+ * @example
+ * ```ts
+ * import { judgingBoard } from "@johnmorrisdotca/kyogijo-stadiums/judging";
+ * const svg = judgingBoard({ style: "kata", mats: [{ label: "Mat 1", officials: [{ seat: 1, name: "Aiko Mori", id: "J-1042" }] }] });
+ * console.log(svg.includes("ky-ju-board"), svg.includes("Aiko Mori"));
+ * // true true
+ * ```
+ */
+export function judgingBoard(options, resolved) {
+    const setting = resolved ?? judgingSetting(options);
+    const width = setting.width;
+    const gid = safeClass(options.id).replace(/ /g, "-") || `ky-jb-${hash(JSON.stringify([options, VERSION]))}`;
+    let y = 0;
+    let body = "";
+    for (const mat of setting.mats) {
+        const placed = boardMarkup(mat, setting, 0, y, width);
+        body += placed.markup;
+        y += placed.height + 24 * (width / BOARD_BASE);
+    }
+    const height = Math.ceil(y - 24 * (width / BOARD_BASE));
+    const { title, description } = judgingText(setting, options, false, "broadcast");
+    const css = options.css === "none" ? "" : `<style>${KYOGIJO_JUDGING_BOARD_STYLE}\n${KYOGIJO_JUDGING_STYLE}</style>`;
+    return el("svg", {
+        xmlns: "http://www.w3.org/2000/svg",
+        class: `kyogijo ky-judging ky-judging-board${safeClass(options.className) === "" ? "" : ` ${safeClass(options.className)}`}`,
+        viewBox: `0 0 ${num(width)} ${num(height)}`,
+        role: "img",
+        "aria-labelledby": `${gid}-t ${gid}-d`,
+        "data-judging": setting.style,
+        "data-league": JUDGING_LEAGUE[setting.style].league,
+        "data-view": "board",
+        "data-theme": options.theme === "light" || options.theme === "dark" ? options.theme : undefined,
+        "data-version": VERSION,
+    }, metaMarkup(`${gid}-t`, title, `${gid}-d`, description) + css + body);
+}

package/dist/judging.broadcast.d.ts

@@ -0,0 +1,6 @@
+import type { JudgingDrawing } from "./judging.draw.ts";
+import { type JudgingSetting } from "./judging.ts";
+import type { JudgingOptions } from "./judging.types.ts";
+/** The picture's shape: a television's. */
+export declare const BROADCAST_RATIO: number;
+export declare function broadcastDrawing(options: JudgingOptions, setting: JudgingSetting): JudgingDrawing;

package/dist/judging.broadcast.js

@@ -0,0 +1,72 @@
+// The broadcast picture of an assignment: the mat large, as a television would show it, 16:9, with the officials on a board at its side like a graphic and the seats' number badges where the officials sit. The board
+// is the score panel's own look (`judging.board.ts`) and never lies over the contest area: the mat is fitted into the room the board leaves, so the middle of the contest area is clear whatever the names are. The whole
+// picture scales evenly when it is shown, type and all; no text in it is stretched. The same options always give the same string.
+import { metaMarkup, safeClass } from "./common.js";
+import { el, hash, num } from "./format.js";
+import { boardMarkup } from "./judging.board.js";
+import { metricsOf, planMarkup, surfacesOf } from "./judging.plan.js";
+import { judgingPlan } from "./judging.js";
+import { KYOGIJO_JUDGING_STYLE } from "./judging.style.js";
+import { judgingText } from "./judging.text.js";
+import { VERSION } from "./version.js";
+/** The picture's shape: a television's. */
+export const BROADCAST_RATIO = 16 / 9;
+/** The board's share of the picture's width, where it stands (from the right edge) and how far down. */
+const BOARD = { width: 0.32, margin: 0.025, top: 0.03 };
+export function broadcastDrawing(options, setting) {
+    const width = setting.width;
+    const frameH = Math.round(width / BROADCAST_RATIO);
+    const gap = 0.02 * width;
+    const m = metricsOf(width);
+    const geom = judgingPlan(setting.style);
+    // The camera is close: the tatami and the seats with a little round them, not the whole free zone of the plan, so that the mat fills the picture's height.
+    const near = [geom.plan.judo.tatami, geom.table, ...geom.places.flatMap((p) => [p.card, p.chair])];
+    const away = 0.6;
+    const region = setting.focus === "bench" ? geom.bench : { x0: Math.min(...near.map((b) => b.x0)) - away, y0: Math.min(...near.map((b) => b.y0)) - away, x1: Math.max(...near.map((b) => b.x1)) + away, y1: Math.max(...near.map((b) => b.y1)) + away };
+    const gid = safeClass(options.id).replace(/ /g, "-") || `ky-ju-${hash(JSON.stringify([options, "broadcast", VERSION]))}`;
+    const { surfaces, style, look } = surfacesOf(setting, options, gid);
+    const cards = [];
+    const boards = [];
+    let body = "";
+    let y = 0;
+    setting.mats.forEach((mat, i) => {
+        // The board first: as wide as its share, narrowed when a tall list would not fit the picture's height.
+        let bw = BOARD.width * width;
+        let placed = boardMarkup(mat, setting, 0, 0, bw);
+        for (let tries = 0; tries < 4 && placed.height > 0.94 * frameH; tries += 1) {
+            bw *= (0.94 * frameH) / placed.height * 0.99;
+            placed = boardMarkup(mat, setting, 0, 0, bw);
+        }
+        const bx = width - bw - BOARD.margin * width;
+        const by = y + Math.min(BOARD.top * width, (frameH - placed.height) / 2);
+        const board = boardMarkup(mat, setting, bx, by, bw);
+        // The mat in the room to the left of the board, as large as it will go.
+        const room = { x: 0, y, w: bx - 0.02 * width, h: frameH };
+        const plan = planMarkup(mat, surfaces[i], geom, region, room, m, setting, `${gid}-c${mat.n}`, false);
+        const contest = geom.plan.judo.contests[Math.min(i, geom.plan.judo.contests.length - 1)];
+        const centre = { x: plan.x + (((contest.x0 + contest.x1) / 2) - region.x0) * plan.scale, y: plan.y + (((contest.y0 + contest.y1) / 2) - region.y0) * plan.scale };
+        mat.seats.forEach((a, k) => cards.push({ mat: mat.n, seat: a.seat.id, fits: plan.fits[k] }));
+        boards.push({ mat: mat.n, x: bx, y: by, width: board.width, height: board.height, plan: { x: plan.x, y: plan.y, width: plan.width, height: plan.height }, centre });
+        body += el("g", { class: "ky-ju-panel ky-ju-frame", "data-mat": mat.n }, el("rect", { class: "ky-apron", x: 0, y, width, height: frameH }) + plan.markup + board.markup);
+        y += frameH + gap;
+    });
+    const height = Math.round(y - gap);
+    const { title, description } = judgingText(setting, options, false, "broadcast");
+    const css = options.css === "none" ? "" : `<style>${style}\n${KYOGIJO_JUDGING_STYLE}</style>`;
+    const root = el("svg", {
+        xmlns: "http://www.w3.org/2000/svg",
+        class: `kyogijo ky-judging ky-judo${safeClass(options.className) === "" ? "" : ` ${safeClass(options.className)}`}`,
+        viewBox: `0 0 ${num(width)} ${num(height)}`,
+        role: "img",
+        "aria-labelledby": `${gid}-t ${gid}-d`,
+        "data-sport": "judo",
+        "data-judging": setting.style,
+        "data-view": "broadcast",
+        "data-look": look ?? "yellow-red",
+        "data-mats": setting.total,
+        "data-chart": "no",
+        "data-theme": options.theme === "light" || options.theme === "dark" ? options.theme : undefined,
+        "data-version": VERSION,
+    }, metaMarkup(`${gid}-t`, title, `${gid}-d`, description) + css + body);
+    return { svg: root, width, height, chart: false, cards, title, description, boards };
+}

package/dist/judging.d.ts

@@ -6,6 +6,7 @@ export declare const JUDGING_LIMITS: Readonly<{
     name: 120;
     id: 64;
     label: 40;
+    line: 60;
 }>;
 /** The seats of a style: every one, or without the optional ones (the side judges of a contest). @throws TypeError for a style that is not one. */
 export declare function seatsOf(style: unknown, only?: "all" | "listed"): readonly JudgingSeat[];
@@ -16,6 +17,8 @@ export declare function seatsOf(style: unknown, only?: "all" | "listed"): readon
 export declare function seatOf(style: JudgingStyle, seat: unknown): JudgingSeat;
 /** The label of a mat: the caller's, held to its length, else the language's `Mat {n}`. */
 export declare function matLabel(mat: JudgingMat, n: number, language: Language): string;
+/** The line of a mat's broadcast board: the caller's, held to its length, or nothing. */
+export declare function matLine(mat: JudgingMat): string;
 /** What `drawJudging` and the 3D view work from: the options held to what they may be, and every mat with all of its seats. */
 export interface JudgingSetting {
     style: JudgingStyle;
@@ -25,6 +28,8 @@ export interface JudgingSetting {
     /** How many mats the assignment has altogether. */
     total: number;
     chart: "auto" | "always" | "never";
+    /** `plan`: the plan with its chart; `broadcast`: the mat large with the board at its side. */
+    view: "plan" | "broadcast";
     orientation: "landscape" | "portrait";
     focus: "mat" | "bench";
     width: number;

package/dist/judging.draw.d.ts

@@ -1,4 +1,4 @@
-import { type JudgingSetting } from "./judging.ts";
+export { judgingText } from "./judging.text.ts";
 import type { JudgingOptions } from "./judging.types.ts";
 /** What a drawing of an assignment is, and what was worked out to make it. */
 export interface JudgingDrawing {
@@ -16,12 +16,25 @@ export interface JudgingDrawing {
     }[];
     title: string;
     description: string;
+    /** The broadcast view: where each mat's board is and where the part of the mat that is shown is and where the middle of its contest area is, in the picture's units (the board lies over neither). Empty for the plan view. */
+    boards: {
+        mat: number;
+        x: number;
+        y: number;
+        width: number;
+        height: number;
+        plan: {
+            x: number;
+            y: number;
+            width: number;
+            height: number;
+        };
+        centre: {
+            x: number;
+            y: number;
+        };
+    }[];
 }
-/** The title and the description of an assignment: each mat with each seat and who is in it. */
-export declare function judgingText(setting: JudgingSetting, options: Pick<JudgingOptions, "title" | "description">, chart: boolean): {
-    title: string;
-    description: string;
-};
 /** The picture of an assignment and what was worked out to make it. `mode` `chart` is the chart alone (for beside a 3D view). */
 export declare function judgingDrawing(options: JudgingOptions, mode?: "full" | "chart"): JudgingDrawing;
 /**